vocs 2.0.17 → 2.1.1

package/dist/internal/openapi/app.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Shared types for the prebuilt OpenAPI app (the `Handler.openApi` server
+ * handler and the static browser bundle it serves).
+ *
+ * This module is intentionally free of Node and DOM dependencies so it can be
+ * imported by both the server handler and the client entry.
+ */
+import type { Config } from '../config.js';
+import type { SidebarItem } from '../sidebar.js';
+import type { Ir } from './parser.js';
+/**
+ * A block of rendered page content. Guide/override pages are compiled on the
+ * server into an ordered list of blocks so embedded `<OpenApi.Endpoints />`
+ * components can be re-hydrated as real React on the client (rather than
+ * inlined as static HTML).
+ */
+export type PageBlock = {
+    type: 'html';
+    html: string;
+} | {
+    type: 'endpoints';
+    path?: string | undefined;
+};
+/**
+ * A compiled consumer-authored page, keyed by its section-relative route.
+ *
+ * - `path === '/'` overrides the landing/intro content.
+ * - `path === '/<group>'` overrides a category header.
+ * - any other `path` is a standalone guide page.
+ */
+export type CompiledPage = {
+    /** Section-relative route (normalized, leading slash, no trailing slash). */
+    path: string;
+    /** Document title (frontmatter `title` or first `# heading`). */
+    title?: string | undefined;
+    /** Subtitle Markdown rendered below the title on guide pages. */
+    description?: string | undefined;
+    /**
+     * Render `title`/`description` as an on-page header above the content. Set for
+     * trait pages (`x-traitTag`), whose title comes from the tag name and subtitle
+     * from `x-subtitle` (their Markdown body has no heading). Authored guide pages
+     * leave this unset because their MDX owns its own headings.
+     */
+    header?: boolean | undefined;
+    /** Ordered content blocks. */
+    blocks: PageBlock[];
+    /**
+     * Raw authored Markdown (frontmatter + ESM import/export lines stripped), used
+     * to serve the page's `.md` / agent-facing version. Absent for trait pages
+     * compiled from a description that is already the body.
+     */
+    markdown?: string | undefined;
+};
+/**
+ * The JSON payload embedded in the standalone HTML shell and consumed by the
+ * browser bundle to render the reference entirely client-side.
+ */
+export type Payload = {
+    /** Parsed OpenAPI IR. */
+    ir: Ir;
+    /** Document title (spec `info.title`). */
+    title: string;
+    /** Computed sidebar (extras + generated items). */
+    sidebar: SidebarItem<true>[];
+    /** Compiled override/guide pages. */
+    pages: CompiledPage[];
+    /**
+     * Serialized Vocs config that backs `virtual:vocs/config` in the browser
+     * bundle, so the prebuilt app renders the real Vocs layout/chrome. Functions
+     * are serialized via {@link file://../config-serializer.ts config-serializer};
+     * the client deserializes them on load.
+     */
+    config: Config;
+};
+/** Joins a section base path with a section-relative sub-path. */
+export declare function join(base: string, sub: string): string;
+/**
+ * The set of known section routes for a payload: the intro (the spec `path`),
+ * one per category, and one per compiled page.
+ */
+export declare function knownRoutes(payload: Payload): string[];
+/**
+ * Infers the host mount prefix from a request pathname: the longest known
+ * section route that is a path-suffix of `pathname` is stripped; whatever
+ * precedes it is the mount (e.g. `/docs/pets` with route `/pets` → `/docs`).
+ * Falls back to treating the whole pathname as the mount (the intro page).
+ */
+export declare function inferMount(pathname: string, routes: string[]): string;
+//# sourceMappingURL=app.d.ts.map

package/dist/internal/openapi/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../src/internal/openapi/app.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAErC;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAEpD;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAA;IACZ,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC5B,8BAA8B;IAC9B,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC9B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,yBAAyB;IACzB,EAAE,EAAE,EAAE,CAAA;IACN,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAA;IACb,mDAAmD;IACnD,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,CAAA;IAC5B,qCAAqC;IACrC,KAAK,EAAE,YAAY,EAAE,CAAA;IACrB;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,kEAAkE;AAClE,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAItD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAOtD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAoBrE"}

package/dist/internal/openapi/app.js

@@ -0,0 +1,62 @@
+/**
+ * Shared types for the prebuilt OpenAPI app (the `Handler.openApi` server
+ * handler and the static browser bundle it serves).
+ *
+ * This module is intentionally free of Node and DOM dependencies so it can be
+ * imported by both the server handler and the client entry.
+ */
+import { normalizePath } from './openapi.js';
+/** Joins a section base path with a section-relative sub-path. */
+export function join(base, sub) {
+    const b = base === '/' ? '' : base;
+    if (!sub || sub === '/')
+        return b || '/';
+    return `${b}${sub.startsWith('/') ? sub : `/${sub}`}`;
+}
+/**
+ * The set of known section routes for a payload: the intro (the spec `path`),
+ * one per category, and one per compiled page.
+ */
+export function knownRoutes(payload) {
+    const base = payload.ir.path || '/';
+    const routes = new Set();
+    routes.add(base === '/' ? '/' : normalizePath(base));
+    for (const group of payload.ir.groups)
+        routes.add(join(base, `/${group.id}`));
+    for (const page of payload.pages)
+        routes.add(join(base, page.path));
+    return [...routes];
+}
+/**
+ * Infers the host mount prefix from a request pathname: the longest known
+ * section route that is a path-suffix of `pathname` is stripped; whatever
+ * precedes it is the mount (e.g. `/docs/pets` with route `/pets` → `/docs`).
+ * Falls back to treating the whole pathname as the mount (the intro page).
+ */
+export function inferMount(pathname, routes) {
+    const path = stripTrailingSlash(pathname);
+    let mount = '';
+    let best = -1;
+    for (const route of routes) {
+        if (route === '/')
+            continue;
+        if (path === route || path.endsWith(route)) {
+            const prefix = path.slice(0, path.length - route.length);
+            if (route.length > best && (prefix === '' || prefix.startsWith('/'))) {
+                best = route.length;
+                mount = prefix;
+            }
+        }
+    }
+    // No group/page route matched: we're on the intro/landing page, so the whole
+    // pathname is the mount. A root mount (`/`) has no prefix, though — return ''
+    // so callers build `/group` rather than `//group` (a protocol-relative URL the
+    // browser reads as `http://group/`).
+    if (best === -1)
+        return path === '/' ? '' : path;
+    return mount;
+}
+function stripTrailingSlash(value) {
+    return value.length > 1 && value.endsWith('/') ? value.slice(0, -1) : value;
+}
+//# sourceMappingURL=app.js.map

package/dist/internal/openapi/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../../src/internal/openapi/app.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAkE5C,kEAAkE;AAClE,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,GAAW;IAC5C,MAAM,CAAC,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IAClC,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,CAAC,IAAI,GAAG,CAAA;IACxC,OAAO,GAAG,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAA;AACvD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC,IAAI,IAAI,GAAG,CAAA;IACnC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAA;IAChC,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAA;IACpD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,EAAE,CAAC,MAAM;QAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;IAC7E,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK;QAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IACnE,OAAO,CAAC,GAAG,MAAM,CAAC,CAAA;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,MAAgB;IAC3D,MAAM,IAAI,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAA;IACzC,IAAI,KAAK,GAAG,EAAE,CAAA;IACd,IAAI,IAAI,GAAG,CAAC,CAAC,CAAA;IACb,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,KAAK,GAAG;YAAE,SAAQ;QAC3B,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;YACxD,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,KAAK,EAAE,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBACrE,IAAI,GAAG,KAAK,CAAC,MAAM,CAAA;gBACnB,KAAK,GAAG,MAAM,CAAA;YAChB,CAAC;QACH,CAAC;IACH,CAAC;IACD,6EAA6E;IAC7E,8EAA8E;IAC9E,+EAA+E;IAC/E,qCAAqC;IACrC,IAAI,IAAI,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IAChD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa;IACvC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;AAC7E,CAAC"}

package/dist/internal/openapi/index.d.ts

@@ -0,0 +1,8 @@
+export type { SchemaPath } from './anchors.js';
+export { mediaIdBase, requestBodyIdBase, responseIdBase, schemaPropertyId, slug, } from './anchors.js';
+export * from './openapi.js';
+export type { Ir, IrBody, IrGroup, IrMediaType, IrOperation, IrParameter, IrResponse, IrSecurityScheme, IrServer, Method, } from './parser.js';
+export { methods, parse } from './parser.js';
+export type { CodeSample, ResponseSample } from './sample.js';
+export { codeSamples, harRequest, responseSamples } from './sample.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/internal/openapi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internal/openapi/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,IAAI,GACL,MAAM,cAAc,CAAA;AACrB,cAAc,cAAc,CAAA;AAC5B,YAAY,EACV,EAAE,EACF,MAAM,EACN,OAAO,EACP,WAAW,EACX,WAAW,EACX,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,QAAQ,EACR,MAAM,GACP,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAC5C,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC7D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA"}

package/dist/internal/openapi/index.js

@@ -0,0 +1,5 @@
+export { mediaIdBase, requestBodyIdBase, responseIdBase, schemaPropertyId, slug, } from './anchors.js';
+export * from './openapi.js';
+export { methods, parse } from './parser.js';
+export { codeSamples, harRequest, responseSamples } from './sample.js';
+//# sourceMappingURL=index.js.map

package/dist/internal/openapi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/internal/openapi/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,IAAI,GACL,MAAM,cAAc,CAAA;AACrB,cAAc,cAAc,CAAA;AAa5B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAE5C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA"}

package/dist/internal/openapi/markdown.d.ts

@@ -0,0 +1,42 @@
+import type { Config } from '../config.js';
+import type { Ir, IrGroup } from './parser.js';
+/**
+ * A generated Markdown page for an OpenAPI route, ready to be served verbatim by
+ * the `.md` router / written as an `/assets/md` asset.
+ */
+export type Page = {
+    path: string;
+    title: string;
+    description?: string | undefined;
+    /** Final Markdown, used verbatim (no MDX reprocessing). */
+    content: string;
+};
+/**
+ * Builds Markdown pages for every configured OpenAPI section.
+ *
+ * Produces one page per mount (the section overview, listing every category and
+ * its endpoints) plus one page per category (`${mount}/${group.id}`), rendering
+ * each operation's parameters, request body, responses, and an example request.
+ *
+ * These mirror the routes created in the Waku router so `/<mount>.md` and
+ * `/<mount>/<group>.md` resolve to a readable, agent-friendly version of the
+ * same reference shown in the browser.
+ */
+export declare function toPages(config: Config): Promise<Page[]>;
+/**
+ * Builds the Markdown pages for a single parsed spec: the section overview plus
+ * one page per category. Pure (no registry/network), so it's the unit-testable
+ * seam under {@link toPages}.
+ */
+export declare function fromIr(ir: Ir): Page[];
+/**
+ * Markdown for the section overview: API metadata + every category's endpoints.
+ *
+ * `linkBase` is prepended to operation anchors so the endpoint links resolve to
+ * wherever the section is mounted (the site uses the configured spec path; the
+ * standalone handler passes the live host mount).
+ */
+export declare function renderOverview(ir: Ir, linkBase: string): string;
+/** Markdown for a single category: full detail for each of its operations. */
+export declare function renderGroup(ir: Ir, group: IrGroup): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/internal/openapi/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../../src/internal/openapi/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,EAAE,EAAE,EAAE,OAAO,EAAwC,MAAM,aAAa,CAAA;AAKpF;;;GAGG;AACH,MAAM,MAAM,IAAI,GAAG;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAK7D;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,CAErC;AAYD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA4B/D;AAYD,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAQ1D"}

package/dist/internal/openapi/markdown.js

@@ -0,0 +1,235 @@
+import * as Registry from './registry.js';
+import { codeSamples } from './sample.js';
+import { unwrapSingleVariant } from './union.js';
+/**
+ * Builds Markdown pages for every configured OpenAPI section.
+ *
+ * Produces one page per mount (the section overview, listing every category and
+ * its endpoints) plus one page per category (`${mount}/${group.id}`), rendering
+ * each operation's parameters, request body, responses, and an example request.
+ *
+ * These mirror the routes created in the Waku router so `/<mount>.md` and
+ * `/<mount>/<group>.md` resolve to a readable, agent-friendly version of the
+ * same reference shown in the browser.
+ */
+export async function toPages(config) {
+    if (!config.openapi?.length)
+        return [];
+    const specs = await Registry.build(config);
+    return Object.values(specs).flatMap(fromIr);
+}
+/**
+ * Builds the Markdown pages for a single parsed spec: the section overview plus
+ * one page per category. Pure (no registry/network), so it's the unit-testable
+ * seam under {@link toPages}.
+ */
+export function fromIr(ir) {
+    return [overviewPage(ir), ...ir.groups.map((group) => groupPage(ir, group))];
+}
+/** Section overview page: API metadata + every category's endpoints. */
+function overviewPage(ir) {
+    return {
+        path: ir.path,
+        title: ir.info.title,
+        description: ir.info.description ? oneLine(ir.info.description) : undefined,
+        content: renderOverview(ir, normalizeMount(ir.path)),
+    };
+}
+/**
+ * Markdown for the section overview: API metadata + every category's endpoints.
+ *
+ * `linkBase` is prepended to operation anchors so the endpoint links resolve to
+ * wherever the section is mounted (the site uses the configured spec path; the
+ * standalone handler passes the live host mount).
+ */
+export function renderOverview(ir, linkBase) {
+    const base = normalizeMount(linkBase);
+    const lines = [`# ${ir.info.title}`, ''];
+    if (ir.info.version)
+        lines.push(`Version: \`${ir.info.version}\``, '');
+    if (ir.info.description)
+        lines.push(ir.info.description.trim(), '');
+    if (ir.servers.length > 0) {
+        lines.push('## Servers', '');
+        for (const server of ir.servers)
+            lines.push(`- \`${server.url}\`${server.description ? `: ${oneLine(server.description)}` : ''}`);
+        lines.push('');
+    }
+    lines.push('## Endpoints', '');
+    for (const group of ir.groups) {
+        lines.push(`### ${group.name}`, '');
+        if (group.description)
+            lines.push(oneLine(group.description), '');
+        for (const operation of group.operations) {
+            const href = `${base}/${group.id}#${operation.id}`;
+            const label = operation.summary ? `: ${oneLine(operation.summary)}` : '';
+            lines.push(`- [\`${operation.method} ${operation.path}\`](${href})${label}`);
+        }
+        lines.push('');
+    }
+    return `${lines.join('\n').trimEnd()}\n`;
+}
+/** Category page: full detail for each operation in the group. */
+function groupPage(ir, group) {
+    return {
+        path: `${normalizeMount(ir.path)}/${group.id}`,
+        title: group.name,
+        description: group.description ? oneLine(group.description) : undefined,
+        content: renderGroup(ir, group),
+    };
+}
+/** Markdown for a single category: full detail for each of its operations. */
+export function renderGroup(ir, group) {
+    const lines = [`# ${group.name}`, ''];
+    if (group.description)
+        lines.push(group.description.trim(), '');
+    const server = ir.servers[0]?.url;
+    for (const operation of group.operations)
+        lines.push(...operationLines(operation, server));
+    return `${lines.join('\n').trimEnd()}\n`;
+}
+function operationLines(operation, server) {
+    const lines = [];
+    const title = operation.summary ?? `${operation.method} ${operation.path}`;
+    lines.push(`## ${title}`, '');
+    lines.push(`\`${operation.method} ${operation.path}\``, '');
+    if (operation.deprecated)
+        lines.push('> **Deprecated**', '');
+    if (operation.description)
+        lines.push(operation.description.trim(), '');
+    const byLocation = (location) => operation.parameters.filter((parameter) => parameter.in === location && !parameter.deprecated);
+    for (const [location, heading] of [
+        ['path', 'Path parameters'],
+        ['query', 'Query parameters'],
+        ['header', 'Header parameters'],
+        ['rpc', 'Parameters'],
+    ]) {
+        const params = byLocation(location);
+        if (params.length === 0)
+            continue;
+        lines.push(`### ${heading}`, '');
+        for (const parameter of params)
+            lines.push(...parameterLines(parameter));
+        lines.push('');
+    }
+    if (operation.requestBody && !operation.requestBody.hidden) {
+        const body = operation.requestBody;
+        const media = body.content[0];
+        const mediaType = media ? ` (\`${media.mediaType}\`)` : '';
+        lines.push(`### Request body${body.required ? ' (required)' : ''}${mediaType}`, '');
+        if (body.description)
+            lines.push(oneLine(body.description), '');
+        if (media?.schema) {
+            const props = schemaLines(media.schema, 0);
+            if (props.length > 0)
+                lines.push(...props, '');
+        }
+    }
+    if (operation.responses.length > 0) {
+        lines.push('### Responses', '');
+        for (const response of operation.responses)
+            lines.push(...responseLines(response));
+    }
+    const samples = codeSamples(operation, server);
+    if (samples.length > 0) {
+        lines.push('### Example request', '');
+        for (const sample of samples) {
+            lines.push(`\`\`\`${sample.lang}`, sample.code.trim(), '```', '');
+        }
+    }
+    return lines;
+}
+function parameterLines(parameter) {
+    // Unwrap a nullable single-variant union so an object param's member type and
+    // nested properties surface (e.g. an RPC `Transaction` object's fields).
+    const schema = parameter.schema
+        ? (unwrapSingleVariant(parameter.schema) ?? parameter.schema)
+        : parameter.schema;
+    const required = parameter.required ? ' _(required)_' : '';
+    const type = `\`${typeLabel(schema)}\``;
+    const description = parameter.description ? `: ${oneLine(parameter.description)}` : '';
+    return [`- \`${parameter.name}\` ${type}${required}${description}`, ...schemaLines(schema, 1)];
+}
+function responseLines(response) {
+    const lines = [];
+    const description = response.description ? `: ${oneLine(response.description)}` : '';
+    lines.push(`#### \`${response.status}\`${description}`, '');
+    if (response.headers.length > 0) {
+        lines.push('Headers:', '');
+        for (const header of response.headers)
+            lines.push(`- \`${header.name}\` \`${typeLabel(header.schema)}\`${header.description ? `: ${oneLine(header.description)}` : ''}`);
+        lines.push('');
+    }
+    const media = response.content[0];
+    if (media?.schema) {
+        const props = schemaLines(media.schema, 0);
+        if (props.length > 0) {
+            if (media.mediaType)
+                lines.push(`Body (\`${media.mediaType}\`):`, '');
+            lines.push(...props, '');
+        }
+    }
+    return lines;
+}
+const maxDepth = 4;
+/**
+ * Renders an object schema's properties as an indented Markdown bullet list,
+ * recursing into nested objects (and array-of-object items) up to {@link
+ * maxDepth}. Returns an empty array for non-object schemas.
+ */
+function schemaLines(rawSchema, depth) {
+    if (!rawSchema || depth > maxDepth)
+        return [];
+    // Unwrap a nullable single-variant union (e.g. `oneOf: [null, X]`) so the
+    // member's properties are listed instead of nothing.
+    const schema = unwrapSingleVariant(rawSchema) ?? rawSchema;
+    const target = schema['type'] === 'array' ? schema['items'] : schema;
+    const properties = target?.['properties'];
+    if (!properties)
+        return [];
+    const required = new Set(target?.['required'] ?? []);
+    const indent = '  '.repeat(depth);
+    const lines = [];
+    for (const [name, rawProperty] of Object.entries(properties)) {
+        const property = unwrapSingleVariant(rawProperty) ?? rawProperty;
+        const requiredFlag = required.has(name) ? ' _(required)_' : '';
+        const description = property['description']
+            ? `: ${oneLine(String(property['description']))}`
+            : '';
+        lines.push(`${indent}- \`${name}\` \`${typeLabel(property)}\`${requiredFlag}${description}`);
+        lines.push(...schemaLines(property, depth + 1));
+    }
+    return lines;
+}
+/** Compact, human-readable type label for a JSON Schema (post-dereference). */
+function typeLabel(schema) {
+    if (!schema)
+        return 'unknown';
+    if (Array.isArray(schema['type']))
+        return schema['type'].join(' | ');
+    const composite = (schema['oneOf'] ?? schema['anyOf']);
+    if (composite)
+        return [...new Set(composite.map(typeLabel))].join(' | ');
+    if (Array.isArray(schema['allOf']))
+        return schema['allOf'].map(typeLabel).join(' & ');
+    if (schema['type'] === 'array')
+        return `${typeLabel(schema['items'])}[]`;
+    if (typeof schema['type'] === 'string') {
+        const format = schema['format'] ? ` <${schema['format']}>` : '';
+        return `${schema['type']}${format}`;
+    }
+    if (Array.isArray(schema['enum']))
+        return 'enum';
+    if (schema['properties'])
+        return 'object';
+    return 'unknown';
+}
+/** Collapse Markdown/whitespace to a single readable line (for summaries). */
+function oneLine(value) {
+    return value.replace(/\s+/g, ' ').trim();
+}
+/** Mount path without a trailing slash (e.g. `/` -> ``, `/api/` -> `/api`). */
+function normalizeMount(path) {
+    return path === '/' ? '' : path.replace(/\/$/, '');
+}
+//# sourceMappingURL=markdown.js.map

package/dist/internal/openapi/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../../src/internal/openapi/markdown.ts"],"names":[],"mappings":"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"}