vocs 2.0.17 → 2.1.2

package/dist/waku/internal/middleware/md-router.js

@@ -1,50 +1,4 @@
-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',
-];
-export const searchEngineUserAgents = [
-    'Googlebot',
-    'Bingbot',
-    'Amazonbot',
-    'Applebot',
-    'Applebot-Extended',
-    'DuckAssistBot',
-    'YouBot',
-];
-export const terminalUserAgents = ['curl/', 'Wget/', 'HTTPie/', 'httpie-go/', 'xh/'];
-export const ogBotUserAgents = [
-    'Discordbot',
-    'Embedly',
-    'Facebot',
-    'Iframely',
-    'LinkedInBot',
-    'Pinterestbot',
-    'Slackbot',
-    'Slurp',
-    'TelegramBot',
-    'Twitterbot',
-    'WhatsApp',
-    'facebookexternalhit',
-];
+import { aiUserAgents, ogBotUserAgents, searchEngineUserAgents, terminalUserAgents, } from '../../../internal/markdown-negotiation.js';
 const isDev = process.env['NODE_ENV'] !== 'production';
 async function resolveContent() {
     const path = await import('node:path');
@@ -55,8 +9,9 @@ async function resolveContent() {
     const { rehypePlugins, remarkPlugins } = Mdx.getCompileOptions('txt', config);
     const pagesDir = path.resolve(config.rootDir, config.srcDir, config.pagesDir);
     const pages = await Llms.getPagesFromDir(pagesDir);
+    const openapiPages = await Llms.getOpenApiPages(config);
     return Llms.buildLlmsContent({
-        pages,
+        pages: [...openapiPages, ...pages],
         title: config.title,
         description: config.description,
         rehypePlugins,

package/dist/waku/internal/middleware/md-router.js.map

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

package/dist/waku/internal/patches/adapters/vercel-build-enhancer.js

@@ -1,6 +1,6 @@
 import { cpSync, existsSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
-import { aiUserAgents, terminalUserAgents } from '../../middleware/md-router.js';
+import { aiUserAgents, terminalUserAgents } from '../../../../internal/markdown-negotiation.js';
 function escapeRegExp(value) {
     return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }

package/dist/waku/internal/patches/adapters/vercel-build-enhancer.js.map

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

package/dist/waku/internal/patches/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../../src/waku/internal/patches/router.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAUhD,KAAK,KAAK,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAA;AAwC3C,wBAAgB,MAAM;AACpB;;;;;;;;;;GAUG;AACH,OAAO,EAAE;IAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,EACnD,OAAO,CAAC,EAAE;IACR;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0FAA0F;IAC1F,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAA;CACpD,GACA,KAAK,CAkLP"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../../src/waku/internal/patches/router.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAUhD,KAAK,KAAK,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAA;AAwC3C,wBAAgB,MAAM;AACpB;;;;;;;;;;GAUG;AACH,OAAO,EAAE;IAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,EACnD,OAAO,CAAC,EAAE;IACR;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0FAA0F;IAC1F,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAA;CACpD,GACA,KAAK,CAoTP"}

package/dist/waku/internal/patches/router.js

@@ -1,4 +1,4 @@
-import { lazy } from 'react';
+import { createElement, lazy } from 'react';
 import { createPages } from 'waku/router/server';
 import * as DedupeHead from '../dedupe-head.js';
 import { getApiHandlers, hasInvalidStaticApiExports, } from './api-routes.js';
@@ -59,12 +59,49 @@ modules, options) {
         module,
     ]));
     const consumerPaths = new Set();
+    // Consumer page modules keyed by their final route path (e.g.
+    // `/api/activities`). Used to compose OpenAPI "override" pages: a consumer
+    // page mounted at an OpenAPI route supplies the intro content while the
+    // generated reference body still renders below it.
+    const consumerModules = new Map();
     for (const file in modules) {
         const srcPath = toSrcPath(file);
         consumerPaths.add(srcPath.slice(pagesDirPrefix.length).replace(/\.\w+$/, ''));
+        const importFn = modules[file];
+        if (importFn) {
+            const items = srcPath
+                .slice(pagesDirPrefix.length)
+                .replace(/\.\w+$/, '')
+                .split('/')
+                .filter(Boolean);
+            const last = items.at(-1);
+            const route = '/' +
+                (last && (['_layout', 'index', '_root'].includes(last) || last.startsWith('_part'))
+                    ? items.slice(0, -1)
+                    : items).join('/');
+            consumerModules.set(route, importFn);
+        }
     }
     const allModules = { ...defaultPages, ...modules };
     return wrapPages(createPages(async ({ createPage, createLayout, createRoot, createApi, createSlice }) => {
+        // OpenAPI config/specs (data-only virtual modules, safe to import
+        // eagerly). The set of OpenAPI route paths lets the page loop below skip
+        // creating a standalone page for any consumer override mounted at one of
+        // them — the OpenAPI loop owns that route and renders the override as the
+        // page intro.
+        const { config } = await import('virtual:vocs/config');
+        const { specs } = await import('virtual:vocs/openapi');
+        const openapiRoutePaths = new Set();
+        for (const entry of config.openapi ?? []) {
+            openapiRoutePaths.add(entry.path);
+            for (const group of specs[entry.path]?.groups ?? [])
+                openapiRoutePaths.add(`${entry.path}/${group.id}`);
+        }
+        // A consumer page mounted under a section path (e.g. `/api/auth`) that
+        // isn't a generated route — a "guide" page rendered with the section
+        // layout (see the OpenAPI loop below).
+        const isOpenApiGuidePath = (path) => !openapiRoutePaths.has(path) &&
+            (config.openapi ?? []).some((entry) => path.startsWith(`${entry.path}/`));
         for (const file in allModules) {
             const importFn = allModules[file];
             if (!importFn)
@@ -91,6 +128,17 @@ modules, options) {
                     pathItems.at(-1)?.startsWith('_part')
                     ? pathItems.slice(0, -1)
                     : pathItems).join('/');
+            // A consumer page mounted at an OpenAPI route is an "override": skip
+            // creating a standalone page here so the OpenAPI loop can mount it
+            // with the generated reference body (it reads the same module as the
+            // page intro).
+            if (openapiRoutePaths.has(path))
+                continue;
+            // A consumer page mounted *under* an OpenAPI section path (e.g.
+            // `/api/auth`) but not at a generated route is a "guide" page. Skip it
+            // here so the OpenAPI loop can mount it with the section layout.
+            if (isOpenApiGuidePath(path))
+                continue;
             const sourceFile = isBuiltIn ? undefined : srcPath;
             const sourceFileProperty = sourceFile ? { unstable_sourceFile: sourceFile } : {};
             const mdxRegex = /\.mdx?$/;
@@ -198,6 +246,71 @@ modules, options) {
                 }); // FIXME avoid as never
             }
         }
+        // Mount OpenAPI sections programmatically from config (no source files).
+        // `OpenApiPage` is imported lazily inside this RSC-only callback so the
+        // client-component chain (Layout) is never pulled into the shared/SSR
+        // module graph.
+        if (config.openapi?.length) {
+            const { OpenApiGuide, OpenApiPage } = await import('../../../react/internal/openapi/OpenApiPage.js');
+            // Resolves a consumer "override" page mounted at `routePath` into the
+            // props (`intro` content + frontmatter `title`) layered onto the
+            // generated `OpenApiPage`. Returns empty props when there is no
+            // override. Uses the MDX `default` export (raw content) — not `Page` —
+            // so the override is not wrapped in its own Layout.
+            const overrideProps = async (routePath) => {
+                const importFn = consumerModules.get(routePath);
+                if (!importFn)
+                    return {};
+                const mod = (await importFn());
+                if (!mod.default)
+                    return {};
+                const Content = mod.default;
+                return { intro: createElement(Content), title: mod.frontmatter?.title };
+            };
+            for (const entry of config.openapi) {
+                // Section root: overview listing every category.
+                const rootProps = await overrideProps(entry.path);
+                createPage({
+                    path: entry.path,
+                    component: () => createElement(OpenApiPage, {
+                        mount: entry.path,
+                        endpoints: !rootProps.intro,
+                        ...rootProps,
+                    }),
+                    render: 'static',
+                });
+                // Mount one page per category at `${path}/${group}`.
+                const ir = specs[entry.path];
+                for (const group of ir?.groups ?? []) {
+                    const groupRoute = `${entry.path}/${group.id}`;
+                    const groupProps = await overrideProps(groupRoute);
+                    createPage({
+                        path: groupRoute,
+                        component: () => createElement(OpenApiPage, { mount: entry.path, group: group.id, ...groupProps }),
+                        render: 'static',
+                    });
+                }
+                // Mount consumer "guide" pages under the section (e.g. `/api/auth`)
+                // with the section layout: a normal MDX page rendered full-bleed,
+                // content-width, and without the right gutter/TOC.
+                for (const [routePath, importFn] of consumerModules) {
+                    if (!routePath.startsWith(`${entry.path}/`))
+                        continue;
+                    if (openapiRoutePaths.has(routePath))
+                        continue;
+                    const mod = (await importFn());
+                    if (!mod.default)
+                        continue;
+                    const Content = mod.default;
+                    const title = mod.frontmatter?.title;
+                    createPage({
+                        path: routePath,
+                        component: () => createElement(OpenApiGuide, { title }, createElement(Content)),
+                        render: 'static',
+                    });
+                }
+            }
+        }
         // HACK: to satisfy the return type, unused at runtime
         return null;
     }, unstable_skipBuild ? { unstable_skipBuild } : undefined));

package/dist/waku/internal/patches/router.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vocs",
   "type": "module",
-  "version": "2.0.17",
+  "version": "2.1.2",
   "main": "./dist/index.js",
   "license": "MIT",
   "repository": {
@@ -26,6 +26,10 @@
     "@mdx-js/rollup": "^3.1.1",
     "@modelcontextprotocol/sdk": "^1.25.2",
     "@remix-run/node-fetch-server": "^0.13.0",
+    "@scalar/api-client": "^3.10.4",
+    "@scalar/openapi-parser": "^0.28.7",
+    "@scalar/snippetz": "^0.9.17",
+    "@scalar/workspace-store": "^0.54.4",
     "@shikijs/rehype": "^3.20.0",
     "@shikijs/transformers": "^3.20.0",
     "@shikijs/twoslash": "^3.20.0",

package/src/config.ts

@@ -8,4 +8,5 @@ export {
 } 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'

package/src/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/src/index.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/src/internal/config.ts

@@ -6,6 +6,8 @@ import type * as Feedback from './feedback.js'
 import * as Langs from './langs.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 { from as resolveOpenApi } from './openapi/openapi.js'
 import type * as Redirects from './redirects.js'
 import type * as Sidebar from './sidebar.js'
 import type * as TopNav from './topNav.js'
@@ -236,6 +238,20 @@ export type Config<partial extends boolean = false> = MaybePartial<
       | 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"
@@ -364,6 +380,21 @@ 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.
@@ -427,6 +458,7 @@ export function define(config: define.Options = {}): Config {
     markdown,
     mcp,
     ogImageUrl,
+    openapi,
     outDir = 'dist',
     redirects,
     renderStrategy = 'dynamic',
@@ -492,6 +524,7 @@ export function define(config: define.Options = {}): Config {
     markdown,
     mcp,
     ogImageUrl,
+    openapi: openapi?.map((entry) => resolveOpenApi(entry)),
     outDir,
     pagesDir,
     redirects,
@@ -574,7 +607,13 @@ export async function resolve(options: resolve.Options = {}): Promise<Config> {
   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,

package/src/internal/llms.ts

@@ -5,13 +5,41 @@ import remarkStringify from 'remark-stringify'
 import type { PluggableList } from 'unified'
 import { unified } from 'unified'
 import type * as Config from './config.js'
+import * as OpenApiMarkdown from './openapi/markdown.js'
 import type * as Sidebar from './sidebar.js'
 
 export async function buildLlmsContent(options: 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<string>()
+  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
@@ -68,9 +96,31 @@ export declare namespace buildLlmsContent {
   type Page = {
     path: string
     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 async function getOpenApiPages(config: Config.Config): Promise<buildLlmsContent.Page[]> {
+  const pages = await OpenApiMarkdown.toPages(config)
+  return pages.map((page) => ({
+    path: page.path,
+    content: page.content,
+    title: page.title,
+    description: page.description,
+  }))
+}
+
 function sortResults<result extends { path: string }>(
   results: result[],
   sidebar: Config.Config['sidebar'],

package/src/internal/markdown-negotiation.test.ts

@@ -0,0 +1,42 @@
+import { describe, expect, test } from 'vitest'
+import { prefersMarkdown } from './markdown-negotiation.js'
+
+describe('prefersMarkdown', () => {
+  test('serves Markdown for an explicit `.md` suffix', () => {
+    expect(prefersMarkdown({ pathname: '/api/pets.md' })).toBe(true)
+  })
+
+  test('serves Markdown for `Accept: text/markdown`', () => {
+    expect(prefersMarkdown({ pathname: '/api/pets', accept: 'text/markdown' })).toBe(true)
+  })
+
+  test('serves Markdown for terminal clients', () => {
+    expect(prefersMarkdown({ pathname: '/api/pets', userAgent: 'curl/8.4.0' })).toBe(true)
+  })
+
+  test('serves Markdown for AI agents', () => {
+    expect(prefersMarkdown({ pathname: '/api/pets', userAgent: 'ChatGPT-User/2.0' })).toBe(true)
+  })
+
+  test('serves HTML for search engines', () => {
+    expect(prefersMarkdown({ pathname: '/api/pets', userAgent: 'Googlebot/2.1' })).toBe(false)
+  })
+
+  test('serves HTML for Open Graph bots, even with a `.md` suffix', () => {
+    expect(prefersMarkdown({ pathname: '/api/pets.md', userAgent: 'Slackbot 1.0' })).toBe(false)
+  })
+
+  test('serves Markdown to search engines for an explicit `.md` suffix', () => {
+    expect(prefersMarkdown({ pathname: '/api/pets.md', userAgent: 'Googlebot/2.1' })).toBe(true)
+  })
+
+  test('serves HTML for ordinary browsers', () => {
+    expect(
+      prefersMarkdown({
+        pathname: '/api/pets',
+        userAgent: 'Mozilla/5.0 (Macintosh) AppleWebKit/537.36 Chrome/120 Safari/537.36',
+        accept: 'text/html',
+      }),
+    ).toBe(false)
+  })
+})