/**
 * Render bundled docs for the install server.
 *
 * Supports three output modes:
 *
 * - `text/html`  — full standalone page with site-wide noindex meta and a
 *   canonical link back to the marketing SPA. The HTML shell, base tokenised
 *   styles, and palette are sourced from
 *   {@link ../bundled_pages/html_shell.ts | html_shell.ts} and
 *   {@link ../bundled_pages/tokens.ts | tokens.ts}, the same modules
 *   `src/services/root_landing/html_template.ts` consumes — code coupling, not
 *   comment coupling.
 * - `text/markdown` — raw body (no front-matter, no decoration). Lets agents
 *   pipe a doc straight into another tool.
 * - `application/json` — `{ frontmatter, body, slug, canonical }` for
 *   programmatic consumers.
 *
 * Pages flagged `interactive: true` in front-matter render an
 * "open the canonical page" notice instead of trying to render MDX-only
 * components from the install runtime.
 */
import type { DocSource } from "../docs_bundle/types.js";
export interface DocRenderContext {
    /** Marketing site origin used for canonical links, e.g. `https://neotoma.io`. */
    publicDocsUrl: string;
    /** Inspector base URL (optional) — surfaced as a sibling link in the page header. */
    inspectorUrl: string | null;
}
/**
 * Render a `DocSource` as a complete HTML document suitable for serving from
 * the install at `/docs/<slug>`.
 */
export declare function renderDocAsHtml(doc: DocSource, ctx: DocRenderContext): string;
/**
 * Render an index page listing every bundled doc, grouped by `nav_category`.
 */
export declare function renderDocIndexHtml(docs: DocSource[], ctx: DocRenderContext): string;
export declare function renderDocAsJson(doc: DocSource, ctx: DocRenderContext): Record<string, unknown>;
export declare function renderDocIndexJson(docs: DocSource[], ctx: DocRenderContext): Record<string, unknown>;
//# sourceMappingURL=renderer.d.ts.map