vocs 2.0.17 → 2.1.2

package/dist/config.d.ts

@@ -2,5 +2,6 @@ export * as Changelog from './internal/changelog.js';
 export { type Config, define as defineConfig, resolve as resolveConfig, } from './internal/config.js';
 export * as Feedback from './internal/feedback.js';
 export * as McpSource from './internal/mcp-source.js';
+export * as OpenApi from './internal/openapi/index.js';
 export * as Twoslash from './internal/twoslash/index.js';
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,SAAS,MAAM,yBAAyB,CAAA;AACpD,OAAO,EACL,KAAK,MAAM,EACX,MAAM,IAAI,YAAY,EACtB,OAAO,IAAI,aAAa,GACzB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAA;AAClD,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAA"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,SAAS,MAAM,yBAAyB,CAAA;AACpD,OAAO,EACL,KAAK,MAAM,EACX,MAAM,IAAI,YAAY,EACtB,OAAO,IAAI,aAAa,GACzB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAA;AAClD,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,OAAO,MAAM,6BAA6B,CAAA;AACtD,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAA"}

package/dist/config.js

@@ -3,5 +3,6 @@ export * as Changelog from './internal/changelog.js';
 export { define as defineConfig, resolve as resolveConfig, } from './internal/config.js';
 export * as Feedback from './internal/feedback.js';
 export * as McpSource from './internal/mcp-source.js';
+export * as OpenApi from './internal/openapi/index.js';
 export * as Twoslash from './internal/twoslash/index.js';
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,OAAO,KAAK,SAAS,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAEL,MAAM,IAAI,YAAY,EACtB,OAAO,IAAI,aAAa,GACzB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAA;AAClD,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAA"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,OAAO,KAAK,SAAS,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAEL,MAAM,IAAI,YAAY,EACtB,OAAO,IAAI,aAAa,GACzB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAA;AAClD,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,OAAO,MAAM,6BAA6B,CAAA;AACtD,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAA"}

package/dist/globals.d.ts

@@ -20,6 +20,10 @@ declare module 'virtual:vocs/langs' {
   export const langs: import('shiki').LanguageRegistration[]
 }
 
+declare module 'virtual:vocs/openapi' {
+  export const specs: Record<string, import('./internal/openapi/index.js').Ir>
+}
+
 declare module 'virtual:vocs/search-index' {
   export function getSearchIndex(): Promise<string>
 }
@@ -46,11 +50,23 @@ declare module 'virtual:vocs/user-styles?inline' {
   export default css
 }
 
+declare module '*.css' {}
+
 declare module '*.css?url' {
   const url: string
   export default url
 }
 
+declare module '*.wasm?url' {
+  const url: string
+  export default url
+}
+
+declare module '*?arraybuffer' {
+  const data: ArrayBuffer
+  export default data
+}
+
 declare module 'virtual:vocs/slots' {
   import type { ComponentType } from 'react'
   export const Footer: ComponentType | undefined

package/dist/index.d.ts

@@ -11,6 +11,7 @@ export { Layout } from './react/Layout.js';
 export { Link } from './react/Link.js';
 export * as MdxPageContext from './react/MdxPageContext.js';
 export { Provider as MdxPageContextProvider } from './react/MdxPageContext.js';
+export * as OpenApi from './react/OpenApi.js';
 export { Sandbox } from './react/Sandbox/index.js';
 export { ScrollRestoration } from './react/ScrollRestoration.js';
 export { Tab, Tabs } from './react/Tabs.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAChC,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAA;AAClD,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAA;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,qCAAqC,CAAA;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,KAAK,cAAc,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,QAAQ,IAAI,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAChC,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAA;AAClD,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAA;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,qCAAqC,CAAA;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,KAAK,cAAc,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,QAAQ,IAAI,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AAC9E,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/index.js

@@ -11,6 +11,7 @@ export { Layout } from './react/Layout.js';
 export { Link } from './react/Link.js';
 export * as MdxPageContext from './react/MdxPageContext.js';
 export { Provider as MdxPageContextProvider } from './react/MdxPageContext.js';
+export * as OpenApi from './react/OpenApi.js';
 export { Sandbox } from './react/Sandbox/index.js';
 export { ScrollRestoration } from './react/ScrollRestoration.js';
 export { Tab, Tabs } from './react/Tabs.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAChC,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAA;AAClD,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAA;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,qCAAqC,CAAA;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,KAAK,cAAc,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,QAAQ,IAAI,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAChC,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAA;AAClD,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAA;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,qCAAqC,CAAA;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,KAAK,cAAc,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,QAAQ,IAAI,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AAC9E,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/internal/config.d.ts

@@ -3,6 +3,7 @@ import type * as Changelog from './changelog.js';
 import type * as Feedback from './feedback.js';
 import type * as McpSource from './mcp-source.js';
 import type * as Mdx from './mdx.js';
+import type * as OpenApi from './openapi/index.js';
 import type * as Redirects from './redirects.js';
 import type * as Sidebar from './sidebar.js';
 import type * as TopNav from './topNav.js';
@@ -215,6 +216,20 @@ export type Config<partial extends boolean = false> = MaybePartial<partial, {
     ogImageUrl?: string | ((path: string, context: {
         baseUrl?: string | undefined;
     }) => string) | undefined;
+    /**
+     * OpenAPI integrations. Each entry mounts an isolated, auto-generated API
+     * reference section (with its own sidebar) at the given `path`.
+     *
+     * @example
+     * ```ts
+     * export default defineConfig({
+     *   openapi: [
+     *     { spec: './openapi.yaml', path: '/api' },
+     *   ],
+     * })
+     * ```
+     */
+    openapi?: readonly OpenApi.SiteConfig[] | undefined;
     /**
      * The output directory relative to root.
      * @default "dist"
@@ -329,6 +344,19 @@ export type Frontmatter = {
      * @default "full"
      */
     layout?: Layout | undefined;
+    /**
+     * Content layout options.
+     */
+    content?: {
+        /**
+         * Content width.
+         * - `default`: centered and constrained to the readable measure (default)
+         * - `full`: spans the full available width (no centering gutter); used by
+         *   full-bleed pages such as the OpenAPI reference.
+         * @default "default"
+         */
+        width?: 'default' | 'full' | undefined;
+    } | undefined;
     /**
      * Whether to show the outline, or the depth of headings to show.
      * Set to `false` to hide the outline, or a number to limit depth.

package/dist/internal/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/internal/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,KAAK,QAAQ,MAAM,eAAe,CAAA;AAE9C,OAAO,KAAK,KAAK,SAAS,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,KAAK,GAAG,MAAM,UAAU,CAAA;AACpC,OAAO,KAAK,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,KAAK,OAAO,MAAM,cAAc,CAAA;AAC5C,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEzD,MAAM,MAAM,UAAU,CAAC,KAAK,IAAI;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,KAAK,CAAA;CAAE,CAAA;AAE7D,MAAM,MAAM,MAAM,CAAC,OAAO,SAAS,OAAO,GAAG,KAAK,IAAI,YAAY,CAChE,OAAO,EACP;IACE;;;;;;;;OAQG;IACH,WAAW,EAAE,cAAc,MAAM,KAAK,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;IAC/D;;OAEG;IACH,MAAM,CAAC,EACH,MAAM,GACN;QACE,gDAAgD;QAChD,OAAO,EAAE,MAAM,CAAA;QACf,2EAA2E;QAC3E,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACpC,mFAAmF;QACnF,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QACjC,wGAAwG;QACxG,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC9B,sDAAsD;QACtD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC3B,iFAAiF;QACjF,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACzB,qEAAqE;QACrE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC9B,iDAAiD;QACjD,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAA;KACjF,GACD,SAAS,CAAA;IACb;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC,OAAO,GAAG,SAAS,CAAA;IACzC;;;;;;;;OAQG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAQ5B;;;;;;;;;OASG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;;;;OAQG;IACH,cAAc,EAAE,OAAO,GAAG,MAAM,CAAA;IAChC;;OAEG;IACH,aAAa,EAAE,YAAY,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAA;IACpF;;;;;;;;OAQG;IACH,WAAW,EAAE,OAAO,GAAG,MAAM,GAAG,YAAY,CAAA;IAC5C;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC;;OAEG;IACH,QAAQ,CAAC,EACL;QACE;;;;WAIG;QACH,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,CAAA;QAC7C;;;WAGG;QACH,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC1B,GACD,SAAS,CAAA;IACb;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAA;IACjB;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,EAAE,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAA;IACxC;;;OAGG;IACH,UAAU,CAAC,EACP;QACE;;;;WAIG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;KACjD,GACD,SAAS,CAAA;IACb;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,SAAS,CAAA;IACjD;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,SAAS,CAAA;IACjD;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC,OAAO,GAAG,SAAS,CAAA;IACxC;;;;;;;;;;;;;;;;;OAiBG;IACH,GAAG,CAAC,EACA;QACE,gDAAgD;QAChD,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QAC7B,qDAAqD;QACrD,OAAO,CAAC,EAAE,SAAS,SAAS,CAAC,OAAO,EAAE,GAAG,SAAS,CAAA;KACnD,GACD,SAAS,CAAA;IACb;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,EACP,MAAM,GACN,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,KAAK,MAAM,CAAC,GACrE,SAAS,CAAA;IACb;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,SAAS,CAAA;IACxC;;;;;;;;OAQG;IACH,cAAc,EAAE,aAAa,GAAG,gBAAgB,GAAG,SAAS,CAAA;IAC5D;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,MAAM,EAAE,YAAY,CAClB,OAAO,EACP;QACE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC7B,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAA;QAC3F,WAAW,EAAE,KAAK,GAAG,IAAI,CAAA;QACzB,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;QACvB,MAAM,EAAE,OAAO,CAAA;KAChB,CACF,CAAA;IACD;;OAEG;IACH,OAAO,CAAC,EACJ,SAAS,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,GACpC;QACE,CAAC,IAAI,EAAE,MAAM,GACT,SAAS,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,GACpC;YAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAA;SAAE,CAAA;KAC/D,GACD,SAAS,CAAA;IACb;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,CAAA;IAK3C;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,MAAM,CAAC,IAAI,EAAE,GAAG,SAAS,CAAA;IAC3C;;OAEG;IACH,QAAQ,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,SAAS,CAAA;CAC3D,CACF,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,GAAG,CAAA;AAE1F,MAAM,MAAM,UAAU,GAAG;IACvB,gCAAgC;IAChC,IAAI,EAAE,UAAU,CAAA;IAChB,eAAe;IACf,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;AAEjD,MAAM,MAAM,WAAW,GAAG;IACxB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;IACtC,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC/B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAChC;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAChC;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAClC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC9B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACjC;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAChC,wCAAwC;IACxC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB,CAAA;AAED,wBAAgB,MAAM,CAAC,MAAM,GAAE,MAAM,CAAC,OAAY,GAAG,MAAM,CAkH1D;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,KAAY,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC,GAAG;QACrF;;;WAGG;QACH,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAA;KACxC,CAAA;CACF;AAED,wBAAgB,aAAa,CAAC,OAAO,GAAE,aAAa,CAAC,OAAY,GAAG,MAAM,GAAG,SAAS,CAIrF;AAeD,OAAO,WAAW,aAAa,CAAC;IAC9B,KAAY,OAAO,GAAG;QACpB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC7B,CAAA;CACF;AAED,wBAAsB,OAAO,CAAC,OAAO,GAAE,OAAO,CAAC,OAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAqB5E;AAED,OAAO,WAAW,OAAO,CAAC;IACxB,KAAY,OAAO,GAAG;QACpB,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC7B,CAAA;CACF;AAED,eAAO,IAAI,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;AAErC,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,QAEvC;AAED,wBAAgB,SAAS,IAAI,MAAM,CAGlC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/internal/config.ts"],"names":[],"mappings":"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"}

package/dist/internal/config.js

@@ -1,8 +1,9 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import * as Langs from './langs.js';
+import { from as resolveOpenApi } from './openapi/openapi.js';
 export function define(config = {}) {
-    const { accentColor = 'light-dark(black, white)', banner, basePath = '/', cacheDir, changelog, checkDeadlinks = true, codeHighlight, colorScheme = 'light dark', description, iconUrl, logoUrl, markdown, mcp, ogImageUrl, outDir = 'dist', redirects, renderStrategy = 'dynamic', rootDir = process.cwd(), search, sidebar, socials, srcDir = 'src', title = 'Docs', titleTemplate = `%s – ${title}`, topNav, twoslash, } = config;
+    const { accentColor = 'light-dark(black, white)', banner, basePath = '/', cacheDir, changelog, checkDeadlinks = true, codeHighlight, colorScheme = 'light dark', description, iconUrl, logoUrl, markdown, mcp, ogImageUrl, openapi, outDir = 'dist', redirects, renderStrategy = 'dynamic', rootDir = process.cwd(), search, sidebar, socials, srcDir = 'src', title = 'Docs', titleTemplate = `%s – ${title}`, topNav, twoslash, } = config;
     const pagesDir = 'pages';
     const baseUrl = (() => {
         if (!config.baseUrl)
@@ -53,6 +54,7 @@ export function define(config = {}) {
         markdown,
         mcp,
         ogImageUrl,
+        openapi: openapi?.map((entry) => resolveOpenApi(entry)),
         outDir,
         pagesDir,
         redirects,
@@ -113,7 +115,13 @@ export async function resolve(options = {}) {
     const configFile = getConfigFile({ rootDir });
     if (!configFile)
         return define({});
-    const vite = await import('vite');
+    // Resolved via a non-literal specifier so bundlers (esbuild/Wrangler) don't
+    // statically pull Vite (and its esbuild/lightningcss/rollup deps) into edge
+    // consumers that only import `Config.define` through `vocs/server`. This branch
+    // only ever runs in Node (dev/CLI/config loading), where the runtime import
+    // resolves normally.
+    const viteSpecifier = 'vite';
+    const vite = await import(/* @vite-ignore */ viteSpecifier);
     const result = await vite.loadConfigFromFile({ command: 'build', mode: 'development' }, configFile, rootDir);
     if (!result)
         return define({ rootDir });

package/dist/internal/config.js.map

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

package/dist/internal/llms.d.ts

@@ -2,13 +2,19 @@ import type { PluggableList } from 'unified';
 import type * as Config from './config.js';
 export declare function buildLlmsContent(options: buildLlmsContent.Options): Promise<{
     full: string;
-    results: {
+    results: NonNullable<{
+        content: string;
+        file: undefined;
+        title: string;
+        description: string | undefined;
+        path: string;
+    } | {
         content: string;
         file: import("vfile").VFile;
         title: string;
         description: string | undefined;
         path: string;
-    }[];
+    } | null>[];
     short: string;
 }>;
 export declare namespace buildLlmsContent {
@@ -25,7 +31,20 @@ export declare namespace buildLlmsContent {
         content: string | {
             path: string;
         };
+        /**
+         * When provided, `content` is treated as final Markdown and used verbatim
+         * (the MDX reprocessing and frontmatter-title requirement are skipped). Used
+         * for generated pages such as OpenAPI references.
+         */
+        title?: string | undefined;
+        description?: string | undefined;
     };
 }
+/**
+ * Generated Markdown pages for every configured OpenAPI section, in the
+ * {@link buildLlmsContent.Page} shape (pre-rendered, so they're served verbatim).
+ * Empty when no OpenAPI specs are configured.
+ */
+export declare function getOpenApiPages(config: Config.Config): Promise<buildLlmsContent.Page[]>;
 export declare function getPagesFromDir(pagesDir: string): Promise<buildLlmsContent.Page[]>;
 //# sourceMappingURL=llms.d.ts.map

package/dist/internal/llms.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llms.d.ts","sourceRoot":"","sources":["../../src/internal/llms.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAG1C,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,CAAC,OAAO;;;;;;;;;;GA8CvE;AAED,MAAM,CAAC,OAAO,WAAW,gBAAgB,CAAC;IACxC,KAAK,OAAO,GAAG;QACb,KAAK,EAAE,IAAI,EAAE,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAChC,aAAa,EAAE,aAAa,CAAA;QAC5B,aAAa,EAAE,aAAa,CAAA;QAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,SAAS,CAAA;KAC/C,CAAA;IAED,KAAK,IAAI,GAAG;QACV,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,GAAG;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KACnC,CAAA;CACF;AAiED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAUxF"}
+{"version":3,"file":"llms.d.ts","sourceRoot":"","sources":["../../src/internal/llms.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAI1C,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,CAAC,OAAO;;;;;;;;;;;;;;;;GAyEvE;AAED,MAAM,CAAC,OAAO,WAAW,gBAAgB,CAAC;IACxC,KAAK,OAAO,GAAG;QACb,KAAK,EAAE,IAAI,EAAE,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAChC,aAAa,EAAE,aAAa,CAAA;QAC5B,aAAa,EAAE,aAAa,CAAA;QAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,SAAS,CAAA;KAC/C,CAAA;IAED,KAAK,IAAI,GAAG;QACV,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,GAAG;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;QAClC;;;;WAIG;QACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC1B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KACjC,CAAA;CACF;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAQ7F;AAiED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAUxF"}

package/dist/internal/llms.js

@@ -3,9 +3,35 @@ import remarkMdx from 'remark-mdx';
 import remarkParse from 'remark-parse';
 import remarkStringify from 'remark-stringify';
 import { unified } from 'unified';
+import * as OpenApiMarkdown from './openapi/markdown.js';
 export async function buildLlmsContent(options) {
-    const { pages, title, description, rehypePlugins, remarkPlugins, sidebar } = options;
+    const { title, description, rehypePlugins, remarkPlugins, sidebar } = options;
+    // Dedupe by path (first occurrence wins), so consumer-authored source pages
+    // take precedence over generated pages (e.g. OpenAPI) mounted at the same path.
+    const seen = new Set();
+    const pages = options.pages.filter((page) => {
+        const key = normalizePath(page.path);
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
     const results = await Promise.all(pages.map(async (page) => {
+        // Pre-rendered pages (e.g. generated OpenAPI references) carry their own
+        // title and final Markdown, so they bypass the MDX reprocessing and the
+        // frontmatter-title requirement and are used verbatim.
+        if (page.title) {
+            const content = typeof page.content === 'string'
+                ? page.content
+                : await fs.readFile(page.content.path, 'utf-8');
+            return {
+                content,
+                file: undefined,
+                title: page.title,
+                description: page.description,
+                path: page.path,
+            };
+        }
         const content = typeof page.content === 'string'
             ? page.content
             : await fs.readFile(page.content.path, 'utf-8');
@@ -40,6 +66,20 @@ export async function buildLlmsContent(options) {
     const full = [...llmsTxtContent, sitemap, ...results.map((r) => r.content)];
     return { full: full.join('\n'), results, short: short.join('\n') };
 }
+/**
+ * Generated Markdown pages for every configured OpenAPI section, in the
+ * {@link buildLlmsContent.Page} shape (pre-rendered, so they're served verbatim).
+ * Empty when no OpenAPI specs are configured.
+ */
+export async function getOpenApiPages(config) {
+    const pages = await OpenApiMarkdown.toPages(config);
+    return pages.map((page) => ({
+        path: page.path,
+        content: page.content,
+        title: page.title,
+        description: page.description,
+    }));
+}
 function sortResults(results, sidebar) {
     const order = getSidebarOrder(sidebar);
     return results.sort((a, b) => {

package/dist/internal/llms.js.map

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

package/dist/internal/markdown-negotiation.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Shared user-agent lists and content negotiation used to decide whether a
+ * request for a documentation route should be served as Markdown instead of
+ * HTML. Consumed by the Waku `.md` router middleware and the standalone
+ * `Handler.openApi` server so both honor the same rules.
+ */
+/** AI crawlers/agents that should receive Markdown. */
+export declare const aiUserAgents: string[];
+/** Search engine crawlers that should always receive HTML. */
+export declare const searchEngineUserAgents: string[];
+/** Terminal HTTP clients that should receive Markdown. */
+export declare const terminalUserAgents: string[];
+/** Link-preview/Open Graph bots that must always receive HTML (for meta tags). */
+export declare const ogBotUserAgents: string[];
+/**
+ * Decides whether a route request should be served as Markdown.
+ *
+ * Resolution order (matches the `.md` router middleware):
+ * 1. Open Graph bots never get Markdown (they need HTML meta tags).
+ * 2. An explicit `.md` suffix always serves Markdown.
+ * 3. Search engines otherwise always get HTML.
+ * 4. AI agents, terminal clients, or `Accept: text/markdown` get Markdown.
+ * 5. Everything else gets HTML.
+ */
+export declare function prefersMarkdown(options: prefersMarkdown.Options): boolean;
+export declare namespace prefersMarkdown {
+    type Options = {
+        /** Request pathname (used to detect an explicit `.md` suffix). */
+        pathname: string;
+        /** Request `User-Agent` header. */
+        userAgent?: string | undefined;
+        /** Request `Accept` header. */
+        accept?: string | undefined;
+    };
+}
+//# sourceMappingURL=markdown-negotiation.d.ts.map

package/dist/internal/markdown-negotiation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-negotiation.d.ts","sourceRoot":"","sources":["../../src/internal/markdown-negotiation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uDAAuD;AACvD,eAAO,MAAM,YAAY,UAsBxB,CAAA;AAED,8DAA8D;AAC9D,eAAO,MAAM,sBAAsB,UAQlC,CAAA;AAED,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB,UAAqD,CAAA;AAEpF,kFAAkF;AAClF,eAAO,MAAM,eAAe,UAa3B,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,CAAC,OAAO,GAAG,OAAO,CAWzE;AAED,MAAM,CAAC,OAAO,WAAW,eAAe,CAAC;IACvC,KAAK,OAAO,GAAG;QACb,kEAAkE;QAClE,QAAQ,EAAE,MAAM,CAAA;QAChB,mCAAmC;QACnC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC9B,+BAA+B;QAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC5B,CAAA;CACF"}

package/dist/internal/markdown-negotiation.js

@@ -0,0 +1,81 @@
+/**
+ * Shared user-agent lists and content negotiation used to decide whether a
+ * request for a documentation route should be served as Markdown instead of
+ * HTML. Consumed by the Waku `.md` router middleware and the standalone
+ * `Handler.openApi` server so both honor the same rules.
+ */
+/** AI crawlers/agents that should receive Markdown. */
+export const aiUserAgents = [
+    'GPTBot',
+    'OAI-SearchBot',
+    'ChatGPT-User',
+    'ChatGPT-User/2.0',
+    'anthropic-ai',
+    'ClaudeBot',
+    'claude-web',
+    'PerplexityBot',
+    'Perplexity-User',
+    'Google-Extended',
+    'FacebookBot',
+    'meta-externalagent',
+    'Bytespider',
+    'cohere-ai',
+    'AI2Bot',
+    'CCBot',
+    'Diffbot',
+    'omgili',
+    'Timpibot',
+    'MistralAI-User',
+    'GoogleAgent-Mariner',
+];
+/** Search engine crawlers that should always receive HTML. */
+export const searchEngineUserAgents = [
+    'Googlebot',
+    'Bingbot',
+    'Amazonbot',
+    'Applebot',
+    'Applebot-Extended',
+    'DuckAssistBot',
+    'YouBot',
+];
+/** Terminal HTTP clients that should receive Markdown. */
+export const terminalUserAgents = ['curl/', 'Wget/', 'HTTPie/', 'httpie-go/', 'xh/'];
+/** Link-preview/Open Graph bots that must always receive HTML (for meta tags). */
+export const ogBotUserAgents = [
+    'Discordbot',
+    'Embedly',
+    'Facebot',
+    'Iframely',
+    'LinkedInBot',
+    'Pinterestbot',
+    'Slackbot',
+    'Slurp',
+    'TelegramBot',
+    'Twitterbot',
+    'WhatsApp',
+    'facebookexternalhit',
+];
+/**
+ * Decides whether a route request should be served as Markdown.
+ *
+ * Resolution order (matches the `.md` router middleware):
+ * 1. Open Graph bots never get Markdown (they need HTML meta tags).
+ * 2. An explicit `.md` suffix always serves Markdown.
+ * 3. Search engines otherwise always get HTML.
+ * 4. AI agents, terminal clients, or `Accept: text/markdown` get Markdown.
+ * 5. Everything else gets HTML.
+ */
+export function prefersMarkdown(options) {
+    const { pathname, userAgent = '', accept = '' } = options;
+    if (ogBotUserAgents.some((agent) => userAgent.includes(agent)))
+        return false;
+    if (pathname.endsWith('.md'))
+        return true;
+    if (searchEngineUserAgents.some((agent) => userAgent.includes(agent)))
+        return false;
+    const isAiAgent = aiUserAgents.some((agent) => userAgent.includes(agent));
+    const isTerminal = terminalUserAgents.some((agent) => userAgent.includes(agent));
+    const acceptsMarkdown = accept.includes('text/markdown');
+    return isAiAgent || isTerminal || acceptsMarkdown;
+}
+//# sourceMappingURL=markdown-negotiation.js.map

package/dist/internal/markdown-negotiation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-negotiation.js","sourceRoot":"","sources":["../../src/internal/markdown-negotiation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uDAAuD;AACvD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,QAAQ;IACR,eAAe;IACf,cAAc;IACd,kBAAkB;IAClB,cAAc;IACd,WAAW;IACX,YAAY;IACZ,eAAe;IACf,iBAAiB;IACjB,iBAAiB;IACjB,aAAa;IACb,oBAAoB;IACpB,YAAY;IACZ,WAAW;IACX,QAAQ;IACR,OAAO;IACP,SAAS;IACT,QAAQ;IACR,UAAU;IACV,gBAAgB;IAChB,qBAAqB;CACtB,CAAA;AAED,8DAA8D;AAC9D,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,WAAW;IACX,SAAS;IACT,WAAW;IACX,UAAU;IACV,mBAAmB;IACnB,eAAe;IACf,QAAQ;CACT,CAAA;AAED,0DAA0D;AAC1D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,CAAC,CAAA;AAEpF,kFAAkF;AAClF,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,YAAY;IACZ,SAAS;IACT,SAAS;IACT,UAAU;IACV,aAAa;IACb,cAAc;IACd,UAAU;IACV,OAAO;IACP,aAAa;IACb,YAAY;IACZ,UAAU;IACV,qBAAqB;CACtB,CAAA;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgC;IAC9D,MAAM,EAAE,QAAQ,EAAE,SAAS,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,OAAO,CAAA;IAEzD,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA;IAC5E,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACzC,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA;IAEnF,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;IACzE,MAAM,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;IAChF,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAA;IACxD,OAAO,SAAS,IAAI,UAAU,IAAI,eAAe,CAAA;AACnD,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/internal/markdown.ts"],"names":[],"mappings":"AAuKA;;GAEG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG/C"}
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/internal/markdown.ts"],"names":[],"mappings":"AA4KA;;GAEG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG/C"}

package/dist/internal/markdown.js

@@ -1,3 +1,4 @@
+import rehypeSlug from 'rehype-slug';
 import rehypeStringify from 'rehype-stringify';
 import remarkGfm from 'remark-gfm';
 import remarkParse from 'remark-parse';
@@ -142,6 +143,10 @@ const processor = unified()
     .use(remarkGfm)
     .use(remarkGitHubCallouts)
     .use(remarkRehype, { allowDangerousHtml: true })
+    // Add `id`s to headings so the outline (which scans `[data-v-content]
+    // :is(h2..h6)[id]`) and heading anchors work on guide/trait pages and on
+    // rendered spec descriptions, matching the MDX pipeline.
+    .use(rehypeSlug)
     .use(rehypeVocsAttrs)
     .use(rehypeTableWrapper)
     .use(rehypeCalloutIcons)

package/dist/internal/markdown.js.map

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

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

@@ -0,0 +1,25 @@
+/**
+ * Shared id/path helpers that keep the left-hand schema documentation rows and
+ * the right-hand response example lines pointing at the same anchor ids. Both
+ * sides derive an element id from a schema "path" (the chain of property names
+ * leading to a value, e.g. `['data', 'items', 'id']`) plus an `idBase` that
+ * scopes the path to a specific operation section (a request body or a single
+ * response status).
+ */
+/** A chain of property names identifying a value within a schema. */
+export type SchemaPath = readonly string[];
+/** Slugifies a path segment / title into a URL-safe id fragment. */
+export declare function slug(value: string): string;
+/** Id base for an operation's request body schema rows. */
+export declare function requestBodyIdBase(operationId: string): string;
+/** Id base for a single response status's schema rows. */
+export declare function responseIdBase(operationId: string, status: string): string;
+/**
+ * Qualifies an id base by media type when a section exposes more than one media
+ * type, so colliding paths across media types resolve to distinct ids. With a
+ * single media type the base is returned unchanged (shorter, stable ids).
+ */
+export declare function mediaIdBase(base: string, mediaType: string, mediaCount: number): string;
+/** The element id for a schema property at `path` within `idBase`. */
+export declare function schemaPropertyId(idBase: string, path: SchemaPath): string;
+//# sourceMappingURL=anchors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"anchors.d.ts","sourceRoot":"","sources":["../../../src/internal/openapi/anchors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qEAAqE;AACrE,MAAM,MAAM,UAAU,GAAG,SAAS,MAAM,EAAE,CAAA;AAE1C,oEAAoE;AACpE,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM1C;AAED,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvF;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAEzE"}

package/dist/internal/openapi/anchors.js

@@ -0,0 +1,37 @@
+/**
+ * Shared id/path helpers that keep the left-hand schema documentation rows and
+ * the right-hand response example lines pointing at the same anchor ids. Both
+ * sides derive an element id from a schema "path" (the chain of property names
+ * leading to a value, e.g. `['data', 'items', 'id']`) plus an `idBase` that
+ * scopes the path to a specific operation section (a request body or a single
+ * response status).
+ */
+/** Slugifies a path segment / title into a URL-safe id fragment. */
+export function slug(value) {
+    const result = value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return result || 'value';
+}
+/** Id base for an operation's request body schema rows. */
+export function requestBodyIdBase(operationId) {
+    return `${operationId}-request-body`;
+}
+/** Id base for a single response status's schema rows. */
+export function responseIdBase(operationId, status) {
+    return `${operationId}-response-${slug(status)}`;
+}
+/**
+ * Qualifies an id base by media type when a section exposes more than one media
+ * type, so colliding paths across media types resolve to distinct ids. With a
+ * single media type the base is returned unchanged (shorter, stable ids).
+ */
+export function mediaIdBase(base, mediaType, mediaCount) {
+    return mediaCount > 1 ? `${base}-${slug(mediaType)}` : base;
+}
+/** The element id for a schema property at `path` within `idBase`. */
+export function schemaPropertyId(idBase, path) {
+    return `${idBase}-${slug(path.join('.'))}`;
+}
+//# sourceMappingURL=anchors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"anchors.js","sourceRoot":"","sources":["../../../src/internal/openapi/anchors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,oEAAoE;AACpE,MAAM,UAAU,IAAI,CAAC,KAAa;IAChC,MAAM,MAAM,GAAG,KAAK;SACjB,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;IAC1B,OAAO,MAAM,IAAI,OAAO,CAAA;AAC1B,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,OAAO,GAAG,WAAW,eAAe,CAAA;AACtC,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,cAAc,CAAC,WAAmB,EAAE,MAAc;IAChE,OAAO,GAAG,WAAW,aAAa,IAAI,CAAC,MAAM,CAAC,EAAE,CAAA;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,SAAiB,EAAE,UAAkB;IAC7E,OAAO,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AAC7D,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,IAAgB;IAC/D,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAA;AAC5C,CAAC"}