fumadocs-openapi 10.2.4 → 10.2.6

package/dist/utils/pages/to-static-data.js.map

@@ -1 +1 @@
-{"version":3,"file":"to-static-data.js","names":["toc: TOCItemType[]","structuredData: StructuredData"],"sources":["../../../src/utils/pages/to-static-data.ts"],"sourcesContent":["import type { NoReference } from '@/utils/schema';\nimport type { Document, OperationObject } from '@/types';\nimport Slugger from 'github-slugger';\nimport { idToTitle } from '@/utils/id-to-title';\nimport type { TOCItemType } from 'fumadocs-core/toc';\nimport type { StructuredData } from 'fumadocs-core/mdx-plugins';\nimport type { ApiPageProps } from '@/ui';\n\nexport function toStaticData(\n  page: ApiPageProps,\n  dereferenced: NoReference<Document>,\n): {\n  toc: TOCItemType[];\n  structuredData: StructuredData;\n} {\n  const slugger = new Slugger();\n  const toc: TOCItemType[] = [];\n  const structuredData: StructuredData = { headings: [], contents: [] };\n\n  function pathItem(item: NoReference<OperationObject>, defaultTitle: string) {\n    if (page.showTitle && item.operationId) {\n      const title = item.summary || (item.operationId ? idToTitle(item.operationId) : defaultTitle);\n      const id = slugger.slug(title);\n\n      toc.push({\n        depth: 2,\n        title,\n        url: `#${id}`,\n      });\n      structuredData.headings.push({\n        content: title,\n        id,\n      });\n    }\n\n    if (item.description)\n      structuredData.contents.push({\n        content: item.description,\n        heading: structuredData.headings.at(-1)?.id,\n      });\n  }\n\n  for (const item of page.operations ?? []) {\n    const operation = dereferenced.paths?.[item.path]?.[item.method];\n    if (!operation) continue;\n\n    pathItem(operation, item.path);\n  }\n\n  for (const item of page.webhooks ?? []) {\n    const webhook = dereferenced.webhooks?.[item.name]?.[item.method];\n    if (!webhook) continue;\n\n    pathItem(webhook, item.name);\n  }\n\n  return { toc, structuredData };\n}\n"],"mappings":";;;;AAQA,SAAgB,aACd,MACA,cAIA;CACA,MAAM,UAAU,IAAI,SAAS;CAC7B,MAAMA,MAAqB,EAAE;CAC7B,MAAMC,iBAAiC;EAAE,UAAU,EAAE;EAAE,UAAU,EAAE;EAAE;CAErE,SAAS,SAAS,MAAoC,cAAsB;AAC1E,MAAI,KAAK,aAAa,KAAK,aAAa;GACtC,MAAM,QAAQ,KAAK,YAAY,KAAK,cAAc,UAAU,KAAK,YAAY,GAAG;GAChF,MAAM,KAAK,QAAQ,KAAK,MAAM;AAE9B,OAAI,KAAK;IACP,OAAO;IACP;IACA,KAAK,IAAI;IACV,CAAC;AACF,kBAAe,SAAS,KAAK;IAC3B,SAAS;IACT;IACD,CAAC;;AAGJ,MAAI,KAAK,YACP,gBAAe,SAAS,KAAK;GAC3B,SAAS,KAAK;GACd,SAAS,eAAe,SAAS,GAAG,GAAG,EAAE;GAC1C,CAAC;;AAGN,MAAK,MAAM,QAAQ,KAAK,cAAc,EAAE,EAAE;EACxC,MAAM,YAAY,aAAa,QAAQ,KAAK,QAAQ,KAAK;AACzD,MAAI,CAAC,UAAW;AAEhB,WAAS,WAAW,KAAK,KAAK;;AAGhC,MAAK,MAAM,QAAQ,KAAK,YAAY,EAAE,EAAE;EACtC,MAAM,UAAU,aAAa,WAAW,KAAK,QAAQ,KAAK;AAC1D,MAAI,CAAC,QAAS;AAEd,WAAS,SAAS,KAAK,KAAK;;AAG9B,QAAO;EAAE;EAAK;EAAgB"}
+{"version":3,"file":"to-static-data.js","names":[],"sources":["../../../src/utils/pages/to-static-data.ts"],"sourcesContent":["import type { NoReference } from '@/utils/schema';\nimport type { Document, OperationObject } from '@/types';\nimport Slugger from 'github-slugger';\nimport { idToTitle } from '@/utils/id-to-title';\nimport type { TOCItemType } from 'fumadocs-core/toc';\nimport type { StructuredData } from 'fumadocs-core/mdx-plugins';\nimport type { ApiPageProps } from '@/ui';\n\nexport function toStaticData(\n  page: ApiPageProps,\n  dereferenced: NoReference<Document>,\n): {\n  toc: TOCItemType[];\n  structuredData: StructuredData;\n} {\n  const slugger = new Slugger();\n  const toc: TOCItemType[] = [];\n  const structuredData: StructuredData = { headings: [], contents: [] };\n\n  function pathItem(item: NoReference<OperationObject>, defaultTitle: string) {\n    if (page.showTitle && item.operationId) {\n      const title = item.summary || (item.operationId ? idToTitle(item.operationId) : defaultTitle);\n      const id = slugger.slug(title);\n\n      toc.push({\n        depth: 2,\n        title,\n        url: `#${id}`,\n      });\n      structuredData.headings.push({\n        content: title,\n        id,\n      });\n    }\n\n    if (item.description)\n      structuredData.contents.push({\n        content: item.description,\n        heading: structuredData.headings.at(-1)?.id,\n      });\n  }\n\n  for (const item of page.operations ?? []) {\n    const operation = dereferenced.paths?.[item.path]?.[item.method];\n    if (!operation) continue;\n\n    pathItem(operation, item.path);\n  }\n\n  for (const item of page.webhooks ?? []) {\n    const webhook = dereferenced.webhooks?.[item.name]?.[item.method];\n    if (!webhook) continue;\n\n    pathItem(webhook, item.name);\n  }\n\n  return { toc, structuredData };\n}\n"],"mappings":";;;;AAQA,SAAgB,aACd,MACA,cAIA;CACA,MAAM,UAAU,IAAI,SAAS;CAC7B,MAAM,MAAqB,EAAE;CAC7B,MAAM,iBAAiC;EAAE,UAAU,EAAE;EAAE,UAAU,EAAE;EAAE;CAErE,SAAS,SAAS,MAAoC,cAAsB;AAC1E,MAAI,KAAK,aAAa,KAAK,aAAa;GACtC,MAAM,QAAQ,KAAK,YAAY,KAAK,cAAc,UAAU,KAAK,YAAY,GAAG;GAChF,MAAM,KAAK,QAAQ,KAAK,MAAM;AAE9B,OAAI,KAAK;IACP,OAAO;IACP;IACA,KAAK,IAAI;IACV,CAAC;AACF,kBAAe,SAAS,KAAK;IAC3B,SAAS;IACT;IACD,CAAC;;AAGJ,MAAI,KAAK,YACP,gBAAe,SAAS,KAAK;GAC3B,SAAS,KAAK;GACd,SAAS,eAAe,SAAS,GAAG,GAAG,EAAE;GAC1C,CAAC;;AAGN,MAAK,MAAM,QAAQ,KAAK,cAAc,EAAE,EAAE;EACxC,MAAM,YAAY,aAAa,QAAQ,KAAK,QAAQ,KAAK;AACzD,MAAI,CAAC,UAAW;AAEhB,WAAS,WAAW,KAAK,KAAK;;AAGhC,MAAK,MAAM,QAAQ,KAAK,YAAY,EAAE,EAAE;EACtC,MAAM,UAAU,aAAa,WAAW,KAAK,QAAQ,KAAK;AAC1D,MAAI,CAAC,QAAS;AAEd,WAAS,SAAS,KAAK,KAAK;;AAG9B,QAAO;EAAE;EAAK;EAAgB"}

package/dist/utils/pages/to-text.js.map

@@ -1 +1 @@
-{"version":3,"file":"to-text.js","names":["out: string[]","page: ApiPageProps","meta: InternalOpenAPIMeta | undefined","content: string[]","propStrs: string[]"],"sources":["../../../src/utils/pages/to-text.ts"],"sourcesContent":["import type { ApiPageProps, OperationItem, WebhookItem } from '@/ui/api-page';\nimport type { ProcessedDocument } from '@/utils/process-document';\nimport type { TagObject } from '@/types';\nimport { dump } from 'js-yaml';\nimport { removeUndefined } from '@/utils/remove-undefined';\nimport type { OutputEntry } from '@/utils/pages/builder';\nimport type { InternalOpenAPIMeta } from '@/server/source-api';\nimport { toStaticData } from '@/utils/pages/to-static-data';\n\nexport interface PagesToTextOptions {\n  /**\n   * Additional imports of your MDX components.\n   */\n  imports?: {\n    names: string[];\n    from: string;\n  }[];\n\n  /**\n   * Customise frontmatter.\n   *\n   * A `full: true` property will be added by default.\n   */\n  frontmatter?: (\n    title: string,\n    description: string | undefined,\n    context: DocumentContext,\n  ) => Record<string, unknown>;\n\n  /**\n   * Add description to document body.\n   *\n   * We recommend but don't enable it by default because some OpenAPI schemas have invalid description that breaks MDX syntax.\n   *\n   * @defaultValue false\n   */\n  includeDescription?: boolean;\n\n  /**\n   * Add a comment to the top of generated files indicating they are auto-generated.\n   * - `true`: Adds a standardized comment\n   * - `false`: No comment is added\n   * - `string`: Adds the provided custom comment\n   *\n   * @defaultValue true\n   */\n  addGeneratedComment?: boolean | string;\n}\n\nexport function toText(\n  entry: OutputEntry,\n  processed: ProcessedDocument,\n  options: PagesToTextOptions = {},\n) {\n  switch (entry.type) {\n    case 'operation':\n      return generatePage(\n        entry.schemaId,\n        processed,\n        {\n          operations: [entry.item],\n        },\n        {\n          ...options,\n          ...entry.info,\n        },\n        {\n          type: 'operation',\n        },\n      );\n    case 'group':\n      return generatePage(\n        entry.schemaId,\n        processed,\n        {\n          operations: entry.operations,\n          webhooks: entry.webhooks,\n          showTitle: true,\n        },\n        {\n          ...options,\n          ...entry.info,\n        },\n        {\n          type: 'file',\n        },\n      );\n    case 'tag':\n      return generatePage(\n        entry.schemaId,\n        processed,\n        {\n          operations: entry.operations,\n          webhooks: entry.webhooks,\n          showTitle: true,\n        },\n        {\n          ...options,\n          ...entry.info,\n        },\n        {\n          type: 'tag',\n          tag: entry.rawTag,\n        },\n      );\n    case 'webhook':\n      return generatePage(\n        entry.schemaId,\n        processed,\n        {\n          webhooks: [entry.item],\n        },\n        {\n          ...options,\n          ...entry.info,\n        },\n        {\n          type: 'operation',\n        },\n      );\n  }\n}\n\nexport function generateDocument(\n  frontmatter: unknown,\n  content: string,\n  options: PagesToTextOptions,\n): string {\n  const { addGeneratedComment = true, imports } = options;\n  const out: string[] = [];\n  const banner = dump(removeUndefined(frontmatter as object)).trimEnd();\n  if (banner.length > 0) out.push(`---\\n${banner}\\n---`);\n\n  if (addGeneratedComment) {\n    let commentContent =\n      'This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again.';\n\n    if (typeof addGeneratedComment === 'string') {\n      commentContent = addGeneratedComment;\n    }\n\n    commentContent = commentContent.replaceAll('/', '\\\\/');\n    out.push(`{/* ${commentContent} */}`);\n  }\n\n  if (imports) {\n    out.push(\n      ...imports\n        .map((item) => `import { ${item.names.join(', ')} } from ${JSON.stringify(item.from)};`)\n        .join('\\n'),\n    );\n  }\n\n  out.push(content);\n  return out.join('\\n\\n');\n}\n\nexport type DocumentContext =\n  | {\n      type: 'tag';\n      tag: TagObject | undefined;\n    }\n  | {\n      type: 'operation';\n    }\n  | {\n      type: 'file';\n    };\n\nfunction generatePage(\n  schemaId: string,\n  processed: ProcessedDocument,\n  pageProps: Omit<ApiPageProps, 'document'>,\n  options: PagesToTextOptions & {\n    title: string;\n    description?: string;\n  },\n  context: DocumentContext,\n): string {\n  const { frontmatter, includeDescription = false } = options;\n  const extend = frontmatter?.(options.title, options.description, context);\n  const page: ApiPageProps = {\n    ...pageProps,\n    document: schemaId,\n  };\n\n  let meta: InternalOpenAPIMeta | undefined;\n  if (page.operations?.length === 1) {\n    const operation = page.operations[0];\n\n    meta = {\n      method: operation.method.toUpperCase(),\n    };\n  } else if (page.webhooks?.length === 1) {\n    const webhook = page.webhooks[0];\n\n    meta = {\n      method: webhook.method.toUpperCase(),\n      webhook: true,\n    };\n  }\n\n  const data = toStaticData(page, processed.dereferenced);\n  const content: string[] = [];\n\n  if (options.description && includeDescription) content.push(options.description);\n  content.push(pageContent(page));\n\n  return generateDocument(\n    {\n      title: options.title,\n      description: !includeDescription ? options.description : undefined,\n      full: true,\n      ...extend,\n      _openapi: {\n        ...meta,\n        ...data,\n        ...(extend?._openapi as object | undefined),\n      },\n    },\n    content.join('\\n\\n'),\n    options,\n  );\n}\n\nfunction pageContent({\n  showTitle,\n  showDescription,\n  document,\n  webhooks,\n  operations,\n}: ApiPageProps): string {\n  const propStrs: string[] = [`document={${JSON.stringify(document)}}`];\n\n  // filter extra properties in props\n  if (webhooks) {\n    propStrs.push(\n      `webhooks={${JSON.stringify(\n        webhooks.map(\n          (item) =>\n            ({\n              name: item.name,\n              method: item.method,\n            }) satisfies WebhookItem,\n        ),\n      )}}`,\n    );\n  }\n  if (operations) {\n    propStrs.push(\n      `operations={${JSON.stringify(\n        operations.map(\n          (item) =>\n            ({\n              path: item.path,\n              method: item.method,\n            }) satisfies OperationItem,\n        ),\n      )}}`,\n    );\n  }\n  if (showTitle) {\n    propStrs.push(`showTitle={${JSON.stringify(showTitle)}}`);\n  }\n  if (showDescription) {\n    propStrs.push(`showDescription={${JSON.stringify(showDescription)}}`);\n  }\n\n  return `<APIPage ${propStrs.join(' ')} />`;\n}\n"],"mappings":"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"}
+{"version":3,"file":"to-text.js","names":[],"sources":["../../../src/utils/pages/to-text.ts"],"sourcesContent":["import type { ApiPageProps, OperationItem, WebhookItem } from '@/ui/api-page';\nimport type { ProcessedDocument } from '@/utils/process-document';\nimport type { TagObject } from '@/types';\nimport { dump } from 'js-yaml';\nimport { removeUndefined } from '@/utils/remove-undefined';\nimport type { OutputEntry } from '@/utils/pages/builder';\nimport type { InternalOpenAPIMeta } from '@/server/source-api';\nimport { toStaticData } from '@/utils/pages/to-static-data';\n\nexport interface PagesToTextOptions {\n  /**\n   * Additional imports of your MDX components.\n   */\n  imports?: {\n    names: string[];\n    from: string;\n  }[];\n\n  /**\n   * Customise frontmatter.\n   *\n   * A `full: true` property will be added by default.\n   */\n  frontmatter?: (\n    title: string,\n    description: string | undefined,\n    context: DocumentContext,\n  ) => Record<string, unknown>;\n\n  /**\n   * Add description to document body.\n   *\n   * We recommend but don't enable it by default because some OpenAPI schemas have invalid description that breaks MDX syntax.\n   *\n   * @defaultValue false\n   */\n  includeDescription?: boolean;\n\n  /**\n   * Add a comment to the top of generated files indicating they are auto-generated.\n   * - `true`: Adds a standardized comment\n   * - `false`: No comment is added\n   * - `string`: Adds the provided custom comment\n   *\n   * @defaultValue true\n   */\n  addGeneratedComment?: boolean | string;\n}\n\nexport function toText(\n  entry: OutputEntry,\n  processed: ProcessedDocument,\n  options: PagesToTextOptions = {},\n) {\n  switch (entry.type) {\n    case 'operation':\n      return generatePage(\n        entry.schemaId,\n        processed,\n        {\n          operations: [entry.item],\n        },\n        {\n          ...options,\n          ...entry.info,\n        },\n        {\n          type: 'operation',\n        },\n      );\n    case 'group':\n      return generatePage(\n        entry.schemaId,\n        processed,\n        {\n          operations: entry.operations,\n          webhooks: entry.webhooks,\n          showTitle: true,\n        },\n        {\n          ...options,\n          ...entry.info,\n        },\n        {\n          type: 'file',\n        },\n      );\n    case 'tag':\n      return generatePage(\n        entry.schemaId,\n        processed,\n        {\n          operations: entry.operations,\n          webhooks: entry.webhooks,\n          showTitle: true,\n        },\n        {\n          ...options,\n          ...entry.info,\n        },\n        {\n          type: 'tag',\n          tag: entry.rawTag,\n        },\n      );\n    case 'webhook':\n      return generatePage(\n        entry.schemaId,\n        processed,\n        {\n          webhooks: [entry.item],\n        },\n        {\n          ...options,\n          ...entry.info,\n        },\n        {\n          type: 'operation',\n        },\n      );\n  }\n}\n\nexport function generateDocument(\n  frontmatter: unknown,\n  content: string,\n  options: PagesToTextOptions,\n): string {\n  const { addGeneratedComment = true, imports } = options;\n  const out: string[] = [];\n  const banner = dump(removeUndefined(frontmatter as object)).trimEnd();\n  if (banner.length > 0) out.push(`---\\n${banner}\\n---`);\n\n  if (addGeneratedComment) {\n    let commentContent =\n      'This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again.';\n\n    if (typeof addGeneratedComment === 'string') {\n      commentContent = addGeneratedComment;\n    }\n\n    commentContent = commentContent.replaceAll('/', '\\\\/');\n    out.push(`{/* ${commentContent} */}`);\n  }\n\n  if (imports) {\n    out.push(\n      ...imports\n        .map((item) => `import { ${item.names.join(', ')} } from ${JSON.stringify(item.from)};`)\n        .join('\\n'),\n    );\n  }\n\n  out.push(content);\n  return out.join('\\n\\n');\n}\n\nexport type DocumentContext =\n  | {\n      type: 'tag';\n      tag: TagObject | undefined;\n    }\n  | {\n      type: 'operation';\n    }\n  | {\n      type: 'file';\n    };\n\nfunction generatePage(\n  schemaId: string,\n  processed: ProcessedDocument,\n  pageProps: Omit<ApiPageProps, 'document'>,\n  options: PagesToTextOptions & {\n    title: string;\n    description?: string;\n  },\n  context: DocumentContext,\n): string {\n  const { frontmatter, includeDescription = false } = options;\n  const extend = frontmatter?.(options.title, options.description, context);\n  const page: ApiPageProps = {\n    ...pageProps,\n    document: schemaId,\n  };\n\n  let meta: InternalOpenAPIMeta | undefined;\n  if (page.operations?.length === 1) {\n    const operation = page.operations[0];\n\n    meta = {\n      method: operation.method.toUpperCase(),\n    };\n  } else if (page.webhooks?.length === 1) {\n    const webhook = page.webhooks[0];\n\n    meta = {\n      method: webhook.method.toUpperCase(),\n      webhook: true,\n    };\n  }\n\n  const data = toStaticData(page, processed.dereferenced);\n  const content: string[] = [];\n\n  if (options.description && includeDescription) content.push(options.description);\n  content.push(pageContent(page));\n\n  return generateDocument(\n    {\n      title: options.title,\n      description: !includeDescription ? options.description : undefined,\n      full: true,\n      ...extend,\n      _openapi: {\n        ...meta,\n        ...data,\n        ...(extend?._openapi as object | undefined),\n      },\n    },\n    content.join('\\n\\n'),\n    options,\n  );\n}\n\nfunction pageContent({\n  showTitle,\n  showDescription,\n  document,\n  webhooks,\n  operations,\n}: ApiPageProps): string {\n  const propStrs: string[] = [`document={${JSON.stringify(document)}}`];\n\n  // filter extra properties in props\n  if (webhooks) {\n    propStrs.push(\n      `webhooks={${JSON.stringify(\n        webhooks.map(\n          (item) =>\n            ({\n              name: item.name,\n              method: item.method,\n            }) satisfies WebhookItem,\n        ),\n      )}}`,\n    );\n  }\n  if (operations) {\n    propStrs.push(\n      `operations={${JSON.stringify(\n        operations.map(\n          (item) =>\n            ({\n              path: item.path,\n              method: item.method,\n            }) satisfies OperationItem,\n        ),\n      )}}`,\n    );\n  }\n  if (showTitle) {\n    propStrs.push(`showTitle={${JSON.stringify(showTitle)}}`);\n  }\n  if (showDescription) {\n    propStrs.push(`showDescription={${JSON.stringify(showDescription)}}`);\n  }\n\n  return `<APIPage ${propStrs.join(' ')} />`;\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-openapi",
-  "version": "10.2.4",
+  "version": "10.2.6",
   "description": "Generate MDX docs for your OpenAPI spec",
   "keywords": [
     "Docs",
@@ -57,8 +57,8 @@
     "@radix-ui/react-dialog": "^1.1.15",
     "@radix-ui/react-select": "^2.2.6",
     "@radix-ui/react-slot": "^1.2.4",
-    "@scalar/json-magic": "^0.8.8",
-    "@scalar/openapi-parser": "0.23.9",
+    "@scalar/json-magic": "^0.8.10",
+    "@scalar/openapi-parser": "0.23.11",
     "ajv": "^8.17.1",
     "class-variance-authority": "^0.7.1",
     "github-slugger": "^2.0.0",
@@ -71,21 +71,22 @@
     "remark": "^15.0.1",
     "remark-rehype": "^11.1.2",
     "tailwind-merge": "^3.4.0",
-    "xml-js": "^1.6.11"
+    "xml-js": "^1.6.11",
+    "@fumari/stf": "^0.0.1"
   },
   "devDependencies": {
-    "@scalar/api-client-react": "^1.3.59",
+    "@scalar/api-client-react": "^1.3.64",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "24.10.2",
+    "@types/node": "25.0.5",
     "@types/openapi-sampler": "^1.0.3",
-    "@types/react": "^19.2.7",
+    "@types/react": "^19.2.8",
     "json-schema-typed": "^8.0.2",
     "openapi-types": "^12.1.3",
     "tailwindcss": "^4.1.18",
-    "tsdown": "^0.18.4",
+    "tsdown": "^0.19.0",
     "eslint-config-custom": "0.0.0",
-    "fumadocs-core": "16.4.5",
-    "fumadocs-ui": "16.4.5",
+    "fumadocs-core": "16.4.7",
+    "fumadocs-ui": "16.4.7",
     "tsconfig": "0.0.0"
   },
   "peerDependencies": {