Services

Collects XML documentation from C# source files under the specified root and produces DocNode entries containing titles, relative file paths with anchors, and HTML-formatted content.

Computes the safe ID for a method to be used in HTML content and stub nodes.

Computes the safe ID for a property to be used in HTML content and stub nodes.

Generates a syntax-highlighted HTML string representing a method signature for display.

Generates a syntax-highlighted HTML string representing a property signature for display.

Computes the accessors (get/set/init) for a property as a string for inclusion in signatures.

Appends a syntax-highlighted parameter declaration to the provided StringBuilder.

Gets the display name for a type declaration, including generic type parameter placeholders (e.g., <T>).

Gets the type name for a qualified ID, appending backtick arity for generic types (e.g., MyType`1).

Determines whether a parameter is a compiler-generated caller information parameter (e.g., [CallerFilePath]).

Extracts XML documentation from the leading trivia of a syntax node and converts it into HTML fragments.

Appends a simple text section (like summary or remarks) to the HTML builder.

Appends a list of named entries (like parameters or exceptions) to the HTML builder.

Renders the content of an XElement as block-level HTML (wrapping in paragraphs if necessary).

Renders the content of an XElement as inline HTML.

Renders a collection of XML nodes into HTML strings.

Renders a single XML node into its corresponding HTML fragment.

Normalizes whitespace in the provided string by replacing all whitespace sequences with a single space.

Adds an outline item to a namespace page when the entry is complete and its target ID has not already been recorded.

Simplifies a "cref" attribute value by removing the type prefix (e.g., "M:", "T:").

Determines whether a parameter name corresponds to a compiler-generated caller information parameter.

Gets an existing NamespaceDocPage for the specified namespace name, or creates a new one if it doesn't exist.

Builds the hierarchical structure for namespaces, ensuring parent pages exist and child links are added back into the content. Rebuilds namespacePages in place keyed by NamespaceDocPage.Path.

Extracts the dotted namespace name for a given syntax node by traversing its ancestors.

Constructs the relative documentation route path for a given namespace name.

Derives a display title for a namespace name.

Gets the parent namespace name for a dotted namespace string.

Builds the dot-delimited qualified name for a type or enum declaration, including enclosing types and namespaces.

Creates normalized metadata for a Markdown documentation node without emitting normalization warnings.

Creates normalized metadata for a Markdown documentation node and optionally logs authored nav-group fallback warnings.

Creates canonical metadata for an API-reference documentation node.

Derives the owning AppSurface component name from a documentation path when possible.

Derives the owning AppSurface component name from a namespace.

Determines whether a documentation file should be excluded from harvesting based on its path segments.

Determines whether a file should be excluded based on shared hidden-directory rules and a caller-supplied set of explicitly excluded directory names.

Renders a code block as either highlighted token markup or escaped plaintext fallback.

Builds a resolver for a docs snapshot.

Resolves a path exactly as authored, using RazorDocs source and canonical matching rules.

Resolves a path by preserving authored source-relative matches before stripping known docs route roots from browser-facing inputs.

Normalizes a documentation path for lookup by trimming route separators and removing fragment anchors.

Normalizes a documentation path for canonical comparison by trimming route separators while preserving fragments.

Extracts a fragment from a documentation path after canonical normalization.

Removes the leading rendered Markdown h1 element when the details page shell already renders the page H1.

Returns the resolved version catalog for the current host.

Creates an enabled catalog result with no available versions because the backing catalog could not be used.

Attempts to serve the current request from one of the configured published trees.

Rewrites stable-root HTML so docs-local links, assets, and client config point at the supplied mount root.

Rewrites a published search-index payload so mounted document URLs stay inside the active docs surface.

Extracts inline Markdown front matter and returns the remaining Markdown with parsed metadata.

Extracts inline Markdown front matter and returns the remaining Markdown with diagnostics-aware metadata.

Parses a YAML metadata document into normalized documentation metadata.

Parses a YAML metadata document into a diagnostics-aware metadata result.

Checks harvest health during host startup when strict harvest failure is enabled.

Stops the preflight service.

Resolves whether the harvest health controller routes should be registered or allowed for the current host.

Resolves whether the sidebar should show harvest health chrome for the current host.

Creates the default TextMateSharp-backed RazorDocs highlighter.

Extracts the first language token from a fenced code block's info string.

Resolves grouped featured-page metadata from landingDoc against the harvested docs corpus.

Sanitizes rendered documentation HTML using the RazorDocs allowlist.

Builds the current live docs home URL.

Builds the current live docs search workspace URL.

Builds the current live docs search-index URL.

Builds the current live docs search-index refresh URL.

Builds the current live docs harvest health HTML URL.

Builds the current live docs harvest health JSON URL.

Builds a current-surface public section URL.

Builds a current-surface canonical document URL.

Builds a canonical document URL rooted at an explicit docs surface root.

Builds the current-surface search asset URL.

Builds the exact-version root URL for one published docs release.

Builds a canonical document URL rooted at a specific exact version.

Builds the public archive URL.

Determines whether the supplied request path is inside the current live docs surface.

Determines whether a request path belongs to the supplied docs root.

Joins a normalized docs root with a relative docs route segment.

Normalizes a configured docs root into the app-relative route contract RazorDocs uses at runtime.

Normalizes a configured route-family root into the app-relative route contract RazorDocs uses at runtime.

Deconstructs the original route set for callers that used the positional record contract.

Deconstructs all known routes.

Harvests Markdown files under the specified root directory and converts each into a DocNode containing a display title, relative path, generated HTML, metadata, and page outline.

Reads an optional paired sidecar metadata file for a Markdown source document.

Extracts page-local outline entries from Markdown heading blocks.

Extracts the document title from a leading Markdown H1 when one exists.

Extracts plain reader-facing text from a Markdig inline container for outline display.

Normalizes heading text by collapsing whitespace without introducing leading spaces.

Creates a manifest from harvested documentation nodes.

Creates a manifest from source or canonical documentation paths.

Determines whether the supplied path resolves to a harvested documentation target.

Constructs a legacy browser-facing path for a harvested non-Markdown documentation source path.

Sanitizes the provided HTML fragment.

Normalizes an authored language token into RazorDocs' stable language contract.

Converts arbitrary language input into a CSS-safe lowercase ASCII slug.

Loads the TextMate grammar for a normalized language, returning null when no grammar exists.

Appends a tokenized source line while preserving unclassified gaps and trailing text.

Maps TextMate scopes to RazorDocs' small semantic token vocabulary.

Retrieves all harvested documentation nodes sorted by their Path.

Returns structured health for the current RazorDocs harvest snapshot.

Retrieves a documentation node for a source path or canonical docs path.

Resolves a requested browser-facing docs route against the current snapshot route catalog.

Builds the typed details view model for the specified documentation page.

Returns the docs search-index payload generated during docs aggregation.

Returns the normalized public-section snapshots derived from the harvested docs corpus.

Returns one normalized public-section snapshot when the section is present in the current docs snapshot.

Invalidates the cached docs snapshot so docs and search-index are rebuilt on next access.

Retrieves the cached docs snapshot, harvesting docs and generating the search-index payload when absent.

Resolves the last committed UTC timestamp for a source path from local git history.

Builds the public-section snapshots from the harvested docs corpus.

Builds the search-index payload from the harvested documentation nodes.

Decodes HTML entities and normalizes whitespace in the provided text for search indexing.

Constructs a browser-facing URL for a documentation path.

Constructs a browser-facing URL for a documentation path rooted at a specific docs surface.

Truncates a text snippet at the last word boundary before the maximum length is exceeded.

Merges README content into the corresponding namespace overview pages.

Inserts README content into a namespace overview page after the auto-generated namespace groups.

Finds the index of the closing </section> tag that matches a <section> tag starting at the specified index.

Determines whether the specified path points to a documentation README file.

Extracts the dotted namespace name from a documentation path under the "Namespaces/" directory.

Attempts to extract a namespace name from a README path by looking at the parent directory name.

Extracts a namespace name from a README path, optionally matching against a list of known namespaces.

Determines whether the matched namespace folder appears in one of the supported namespace README locations.

Normalizes a documentation path for lookup by trimming slashes and removing fragment anchors.

Extracts the fragment anchor (after the '#') from a documentation path.

Rewrites internal documentation anchors in rendered HTML so they point at canonical RazorDocs routes and carry Turbo navigation attributes that keep browser history aligned with frame navigation.

Prefixes request PathBase for rooted docs-local anchor hrefs in rendered HTML content.