fumadocs-openapi 10.3.14 → 10.3.16

package/dist/utils/pages/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","names":[],"sources":["../../../src/utils/pages/builder.ts"],"sourcesContent":["import type { ProcessedDocument } from '@/utils/process-document';\nimport type { OpenAPIServer } from '@/server';\nimport type { OperationItem, WebhookItem } from '@/ui/api-page';\nimport type { Document, OperationObject, PathItemObject, TagObject } from '@/types';\nimport { getTagDisplayName, methodKeys, type NoReference } from '@/utils/schema';\nimport { idToTitle } from '@/utils/id-to-title';\n\ninterface BaseEntry {\n  path: string;\n  schemaId: string;\n  info: {\n    title: string;\n    description?: string;\n  };\n}\n\nexport interface OperationOutput extends BaseEntry {\n  type: 'operation';\n  item: OperationItem;\n}\n\nexport interface WebhookOutput extends BaseEntry {\n  type: 'webhook';\n  item: WebhookItem;\n}\n\nexport interface TagOutput extends BaseEntry {\n  type: 'tag';\n  tag: string;\n  rawTag: TagObject;\n  operations: OperationItem[];\n  webhooks: WebhookItem[];\n}\n\nexport interface OutputGroup extends BaseEntry {\n  type: 'group';\n  operations: OperationItem[];\n  webhooks: WebhookItem[];\n}\n\nexport type OutputEntry = TagOutput | OperationOutput | WebhookOutput | OutputGroup;\n\nexport interface PagesBuilderConfig {\n  toPages: (builder: PagesBuilder) => void;\n}\n\nexport interface PagesBuilder {\n  /**\n   * the input ID in OpenAPI server\n   */\n  id: string;\n  document: ProcessedDocument;\n  /**\n   * add output entry.\n   *\n   * When the `path` property is unspecified, it will generate one.\n   */\n  create: (entry: OutputEntry) => void;\n\n  /**\n   * get file path from operation path, useful for generating output paths.\n   */\n  routePathToFilePath: (path: string) => string;\n\n  /**\n   * Extract useful info for rendering\n   */\n  extract: () => ExtractedInfo;\n  fromExtractedWebhook: (item: WebhookItem) =>\n    | {\n        get displayName(): string;\n        pathItem: NoReference<PathItemObject>;\n        operation: NoReference<OperationObject>;\n      }\n    | undefined;\n  fromExtractedOperation: (item: OperationItem) =>\n    | {\n        get displayName(): string;\n        pathItem: NoReference<PathItemObject>;\n        operation: NoReference<OperationObject>;\n      }\n    | undefined;\n  fromTag: (tag: TagObject) => {\n    get displayName(): string;\n  };\n  fromTagName: (tag: string) =>\n    | {\n        info: TagObject;\n        get displayName(): string;\n      }\n    | undefined;\n}\n\ninterface ExtractedInfo {\n  webhooks: (WebhookItem & { tags?: string[] })[];\n  operations: (OperationItem & {\n    tags?: string[];\n  })[];\n}\n\nexport async function fromServer(\n  server: OpenAPIServer,\n  config: PagesBuilderConfig,\n): Promise<Record<string, OutputEntry[]>> {\n  const schemas = await server.getSchemas();\n  const generated: Record<string, OutputEntry[]> = {};\n\n  const entries = Object.entries(schemas);\n  if (entries.length === 0) {\n    throw new Error('No input files found.');\n  }\n\n  for (const [id, schema] of entries) {\n    generated[id] = fromSchema(id, schema, config);\n  }\n\n  return generated;\n}\n\nexport function fromSchema(\n  schemaId: string,\n  processed: ProcessedDocument,\n  config: PagesBuilderConfig,\n): OutputEntry[] {\n  const files: OutputEntry[] = [];\n  const { toPages } = config;\n  const { dereferenced } = processed;\n\n  toPages({\n    id: schemaId,\n    document: processed,\n    create(entry) {\n      files.push(entry);\n    },\n    extract: () => extractInfo(dereferenced),\n    routePathToFilePath(path) {\n      return path\n        .toLowerCase()\n        .replaceAll('.', '-')\n        .split('/')\n        .flatMap((v) => {\n          if (v.startsWith('{') && v.endsWith('}')) return v.slice(1, -1);\n          if (v.length === 0) return [];\n          return v;\n        })\n        .join('/');\n    },\n    fromExtractedWebhook(item) {\n      const pathItem = dereferenced.webhooks?.[item.name];\n      if (!pathItem) return;\n      const operation = pathItem?.[item.method];\n      if (!operation) return;\n      return {\n        pathItem,\n        operation,\n        get displayName() {\n          return operation.summary || pathItem.summary || idToTitle(item.name);\n        },\n      };\n    },\n    fromExtractedOperation(item) {\n      const pathItem = dereferenced.paths?.[item.path];\n      if (!pathItem) return;\n      const operation = pathItem?.[item.method];\n      if (!operation) return;\n      return {\n        pathItem,\n        operation,\n        get displayName() {\n          return (\n            operation.summary ||\n            pathItem.summary ||\n            (operation.operationId ? idToTitle(operation.operationId) : item.path)\n          );\n        },\n      };\n    },\n    fromTag(tag) {\n      return {\n        get displayName() {\n          return getTagDisplayName(tag);\n        },\n      };\n    },\n    fromTagName(name) {\n      const tag = dereferenced.tags?.find((item) => item.name === name);\n      if (!tag) return;\n\n      return {\n        info: tag,\n        ...this.fromTag(tag),\n      };\n    },\n  });\n\n  return files;\n}\n\nfunction extractInfo(document: NoReference<Document>): ExtractedInfo {\n  const result: ExtractedInfo = { webhooks: [], operations: [] };\n\n  for (const [path, pathItem] of Object.entries(document.paths ?? {})) {\n    if (!pathItem) continue;\n\n    for (const methodKey of methodKeys) {\n      if (!pathItem[methodKey]) continue;\n\n      result.operations.push({\n        method: methodKey,\n        path,\n        tags: pathItem[methodKey]?.tags,\n      });\n    }\n  }\n\n  for (const [name, pathItem] of Object.entries(document.webhooks ?? {})) {\n    if (!pathItem) continue;\n\n    for (const methodKey of methodKeys) {\n      if (!pathItem[methodKey]) continue;\n\n      result.webhooks.push({\n        method: methodKey,\n        name,\n        tags: pathItem[methodKey]?.tags,\n      });\n    }\n  }\n\n  return result;\n}\n"],"mappings":";;;;AAoGA,eAAsB,WACpB,QACA,QACwC;CACxC,MAAM,UAAU,MAAM,OAAO,YAAY;CACzC,MAAM,YAA2C,EAAE;CAEnD,MAAM,UAAU,OAAO,QAAQ,QAAQ;AACvC,KAAI,QAAQ,WAAW,EACrB,OAAM,IAAI,MAAM,wBAAwB;AAG1C,MAAK,MAAM,CAAC,IAAI,WAAW,QACzB,WAAU,MAAM,WAAW,IAAI,QAAQ,OAAO;AAGhD,QAAO;;AAGT,SAAgB,WACd,UACA,WACA,QACe;CACf,MAAM,QAAuB,EAAE;CAC/B,MAAM,EAAE,YAAY;CACpB,MAAM,EAAE,iBAAiB;AAEzB,SAAQ;EACN,IAAI;EACJ,UAAU;EACV,OAAO,OAAO;AACZ,SAAM,KAAK,MAAM;;EAEnB,eAAe,YAAY,aAAa;EACxC,oBAAoB,MAAM;AACxB,UAAO,KACJ,aAAa,CACb,WAAW,KAAK,IAAI,CACpB,MAAM,IAAI,CACV,SAAS,MAAM;AACd,QAAI,EAAE,WAAW,IAAI,IAAI,EAAE,SAAS,IAAI,CAAE,QAAO,EAAE,MAAM,GAAG,GAAG;AAC/D,QAAI,EAAE,WAAW,EAAG,QAAO,EAAE;AAC7B,WAAO;KACP,CACD,KAAK,IAAI;;EAEd,qBAAqB,MAAM;GACzB,MAAM,WAAW,aAAa,WAAW,KAAK;AAC9C,OAAI,CAAC,SAAU;GACf,MAAM,YAAY,WAAW,KAAK;AAClC,OAAI,CAAC,UAAW;AAChB,UAAO;IACL;IACA;IACA,IAAI,cAAc;AAChB,YAAO,UAAU,WAAW,SAAS,WAAW,UAAU,KAAK,KAAK;;IAEvE;;EAEH,uBAAuB,MAAM;GAC3B,MAAM,WAAW,aAAa,QAAQ,KAAK;AAC3C,OAAI,CAAC,SAAU;GACf,MAAM,YAAY,WAAW,KAAK;AAClC,OAAI,CAAC,UAAW;AAChB,UAAO;IACL;IACA;IACA,IAAI,cAAc;AAChB,YACE,UAAU,WACV,SAAS,YACR,UAAU,cAAc,UAAU,UAAU,YAAY,GAAG,KAAK;;IAGtE;;EAEH,QAAQ,KAAK;AACX,UAAO,EACL,IAAI,cAAc;AAChB,WAAO,kBAAkB,IAAI;MAEhC;;EAEH,YAAY,MAAM;GAChB,MAAM,MAAM,aAAa,MAAM,MAAM,SAAS,KAAK,SAAS,KAAK;AACjE,OAAI,CAAC,IAAK;AAEV,UAAO;IACL,MAAM;IACN,GAAG,KAAK,QAAQ,IAAI;IACrB;;EAEJ,CAAC;AAEF,QAAO;;AAGT,SAAS,YAAY,UAAgD;CACnE,MAAM,SAAwB;EAAE,UAAU,EAAE;EAAE,YAAY,EAAE;EAAE;AAE9D,MAAK,MAAM,CAAC,MAAM,aAAa,OAAO,QAAQ,SAAS,SAAS,EAAE,CAAC,EAAE;AACnE,MAAI,CAAC,SAAU;AAEf,OAAK,MAAM,aAAa,YAAY;AAClC,OAAI,CAAC,SAAS,WAAY;AAE1B,UAAO,WAAW,KAAK;IACrB,QAAQ;IACR;IACA,MAAM,SAAS,YAAY;IAC5B,CAAC;;;AAIN,MAAK,MAAM,CAAC,MAAM,aAAa,OAAO,QAAQ,SAAS,YAAY,EAAE,CAAC,EAAE;AACtE,MAAI,CAAC,SAAU;AAEf,OAAK,MAAM,aAAa,YAAY;AAClC,OAAI,CAAC,SAAS,WAAY;AAE1B,UAAO,SAAS,KAAK;IACnB,QAAQ;IACR;IACA,MAAM,SAAS,YAAY;IAC5B,CAAC;;;AAIN,QAAO"}

package/dist/utils/pages/preset-auto.d.ts

@@ -67,4 +67,5 @@ interface BaseConfig {
 }
 declare function createAutoPreset(options: SchemaToPagesOptions): PagesBuilderConfig;
 //#endregion
-export { SchemaToPagesOptions, createAutoPreset };
+export { SchemaToPagesOptions, createAutoPreset };
+//# sourceMappingURL=preset-auto.d.ts.map

package/dist/utils/pages/preset-auto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-auto.d.ts","names":[],"sources":["../../../src/utils/pages/preset-auto.ts"],"mappings":";;;;UAaU,eAAA,SAAwB,UAAA;;AAHH;;EAO7B,GAAA;EAW8C;;;;;;;;;EAA9C,OAAA,gCAAuC,KAAA,EAAO,eAAA,GAAkB,aAAA;EAXhE;;;EAgBA,IAAA,GAAO,MAAA,CAAO,eAAA,GAAkB,aAAA,IAAiB,aAAA;AAAA;AAAA,UAGzC,SAAA,SAAkB,UAAA;EAHnB;;;EAOP,GAAA;EAP8D;;AAAA;EAY9D,IAAA,GAAO,MAAA,CAAO,SAAA,IAAa,aAAA;AAAA;AAAA,UAGnB,YAAA,SAAqB,UAAA;EAHtB;;;EAOP,GAAA;EAhBoC;;;EAqBpC,IAAA,GAAO,MAAA,CAAO,WAAA,IAAe,aAAA;AAAA;AAAA,KAGnB,oBAAA,GACR,YAAA,GACA,SAAA,GACA,eAAA;EAEE,GAAA;AAAA,IACE,kBAAA;AAAA,KAEH,MAAA,WACH,IAAA,EAAM,YAAA,EACN,MAAA,EAAQ,KAAA,EACR,QAAA,EAAU,iBAAA;AAAA,UAGF,aAAA;EA1Ba;;;;;;;;EAmCrB,SAAA;AAAA;AAAA,UAGQ,UAAA;EA7BD;;;;;EAmCP,OAAA,IAAW,IAAA;AAAA;AAAA,iBAGG,gBAAA,CAAiB,OAAA,EAAS,oBAAA,GAAuB,kBAAA"}

package/dist/utils/pages/preset-auto.js

@@ -121,4 +121,5 @@ function createAutoPreset(options) {
 }
 
 //#endregion
-export { createAutoPreset };
+export { createAutoPreset };
+//# sourceMappingURL=preset-auto.js.map

package/dist/utils/pages/preset-auto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-auto.js","names":[],"sources":["../../../src/utils/pages/preset-auto.ts"],"sourcesContent":["import * as path from 'node:path';\nimport type { ProcessedDocument } from '@/utils/process-document';\nimport type {\n  OperationOutput,\n  OutputEntry,\n  OutputGroup,\n  PagesBuilder,\n  PagesBuilderConfig,\n  TagOutput,\n  WebhookOutput,\n} from '@/utils/pages/builder';\nimport { isUrl } from '@/utils/url';\n\ninterface OperationConfig extends BaseConfig {\n  /**\n   * Generate a page for each API endpoint/operation (default).\n   */\n  per?: 'operation';\n\n  /**\n   * Group output using folders (Only works on `operation` mode)\n   * - tag: `{tag}/{file}`\n   * - route: `{endpoint}/{method}` (it will ignore the `name` option)\n   * - none: `{file}` (default)\n   * - a function that aligns group name (folder path) to each entry\n   *\n   * @defaultValue 'none'\n   */\n  groupBy?: 'tag' | 'route' | 'none' | ((entry: OperationOutput | WebhookOutput) => string);\n\n  /**\n   * Specify name for output file\n   */\n  name?: NameFn<OperationOutput | WebhookOutput> | NameFnOptions;\n}\n\ninterface TagConfig extends BaseConfig {\n  /**\n   * Generate a page for each tag.\n   */\n  per: 'tag';\n\n  /**\n   * Specify name for output file\n   */\n  name?: NameFn<TagOutput> | NameFnOptions;\n}\n\ninterface SchemaConfig extends BaseConfig {\n  /**\n   * Generate a page for each schema file.\n   */\n  per: 'file';\n\n  /**\n   * Specify name for output file\n   */\n  name?: NameFn<OutputGroup> | NameFnOptions;\n}\n\nexport type SchemaToPagesOptions =\n  | SchemaConfig\n  | TagConfig\n  | OperationConfig\n  | ({\n      per: 'custom';\n    } & PagesBuilderConfig);\n\ntype NameFn<Entry> = (\n  this: PagesBuilder,\n  output: Entry,\n  document: ProcessedDocument['dereferenced'],\n) => string;\n\ninterface NameFnOptions {\n  /**\n   * The version of algorithm used to generate file paths.\n   *\n   * v1: Fumadocs OpenAPI v8\n   * v2: Fumadocs OpenAPI v9\n   *\n   * @defaultValue v2\n   */\n  algorithm?: 'v2' | 'v1';\n}\n\ninterface BaseConfig {\n  /**\n   * Custom function to convert names into file names.\n   *\n   * By default, it only escapes whitespaces and upper case (English) characters\n   */\n  slugify?: (name: string) => string;\n}\n\nexport function createAutoPreset(options: SchemaToPagesOptions): PagesBuilderConfig {\n  if (options.per === 'custom') return options;\n  const {\n    slugify = (s) => {\n      return s.replace(/\\s+/g, '-').toLowerCase();\n    },\n  } = options;\n  let nameFn: NameFn<OutputEntry>;\n\n  if (typeof options.name === 'function') {\n    nameFn = options.name as NameFn<OutputEntry>;\n  } else {\n    const { algorithm = 'v2' } = options.name ?? {};\n\n    nameFn = function (result, document) {\n      if (result.type === 'tag') {\n        return slugify(result.tag);\n      }\n\n      if (result.type === 'group') {\n        const schemaId = result.schemaId;\n\n        return isUrl(schemaId) ? 'index' : path.basename(schemaId, path.extname(schemaId));\n      }\n\n      if (result.type === 'operation') {\n        const operation = document.paths![result.item.path]![result.item.method]!;\n\n        if (algorithm === 'v2' && operation.operationId) {\n          return operation.operationId;\n        }\n\n        return path.join(\n          this.routePathToFilePath(result.item.path),\n          result.item.method.toLowerCase(),\n        );\n      }\n\n      const hook = document.webhooks![result.item.name][result.item.method]!;\n\n      if (algorithm === 'v2' && hook.operationId) {\n        return hook.operationId;\n      }\n\n      return slugify(result.item.name);\n    };\n  }\n\n  function groupOutput(builder: PagesBuilder, entry: OperationOutput | WebhookOutput): string[] {\n    const { dereferenced } = builder.document;\n    const { groupBy = 'none' } = options as OperationConfig;\n\n    if (groupBy === 'route') {\n      return [\n        path.join(\n          builder.routePathToFilePath(\n            entry.type === 'operation' ? entry.item.path : entry.item.name,\n          ),\n          `${entry.item.method.toLowerCase()}.mdx`,\n        ),\n      ];\n    }\n\n    const file = nameFn.call(builder, entry, dereferenced);\n    if (groupBy === 'tag') {\n      let tags =\n        entry.type === 'operation'\n          ? dereferenced.paths![entry.item.path]![entry.item.method]!.tags\n          : dereferenced.webhooks![entry.item.name][entry.item.method]!.tags;\n\n      if (!tags || tags.length === 0) {\n        console.warn(\n          'When `groupBy` is set to `tag`, make sure a `tags` is defined for every operation schema.',\n        );\n\n        tags = ['unknown'];\n      }\n\n      return tags.map((tag) => path.join(slugify(tag), `${file}.mdx`));\n    }\n\n    if (typeof groupBy === 'function') {\n      return [path.join(slugify(groupBy(entry)), `${file}.mdx`)];\n    }\n\n    return [`${file}.mdx`];\n  }\n\n  return {\n    toPages(builder) {\n      const { dereferenced } = builder.document;\n      const items = builder.extract();\n\n      if (options.per === 'file') {\n        const entry: OutputGroup = {\n          type: 'group',\n          schemaId: builder.id,\n          path: '',\n          info: {\n            title: dereferenced.info?.title ?? 'Unknown',\n            description: dereferenced.info?.description,\n          },\n          ...items,\n        };\n        entry.path = nameFn.call(builder, entry, dereferenced) + '.mdx';\n        builder.create(entry);\n        return;\n      }\n\n      if (options.per === 'tag') {\n        const tags = dereferenced.tags ?? [];\n        for (const tag of tags) {\n          const { displayName } = builder.fromTag(tag);\n          const entry: TagOutput = {\n            type: 'tag',\n            path: '',\n            schemaId: builder.id,\n            info: {\n              title: displayName,\n              description: tag.description,\n            },\n            webhooks: items.webhooks.filter((webhook) => webhook.tags?.includes(tag.name!)),\n            operations: items.operations.filter((op) => op.tags?.includes(tag.name!)),\n            tag: tag.name!,\n            rawTag: tag,\n          };\n\n          entry.path = nameFn.call(builder, entry, dereferenced) + '.mdx';\n          builder.create(entry);\n        }\n\n        return;\n      }\n\n      for (const op of items.operations) {\n        const { pathItem, operation, displayName } = builder.fromExtractedOperation(op)!;\n\n        const entry: OperationOutput = {\n          type: 'operation',\n          schemaId: builder.id,\n          item: op,\n          path: '',\n          info: {\n            title: displayName,\n            description: operation.description ?? pathItem.description,\n          },\n        };\n\n        for (const outputPath of groupOutput(builder, entry)) {\n          builder.create({ ...entry, path: outputPath });\n        }\n      }\n\n      for (const webhook of items.webhooks) {\n        const { pathItem, operation, displayName } = builder.fromExtractedWebhook(webhook)!;\n\n        const entry: WebhookOutput = {\n          type: 'webhook',\n          schemaId: builder.id,\n          info: {\n            title: displayName,\n            description: operation.description ?? pathItem.description,\n          },\n          item: webhook,\n          path: '',\n        };\n\n        for (const outputPath of groupOutput(builder, entry)) {\n          builder.create({ ...entry, path: outputPath });\n        }\n      }\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/utils/pages/to-body.js

@@ -18,4 +18,5 @@ function toBody(entry) {
 }
 
 //#endregion
-export { toBody };
+export { toBody };
+//# sourceMappingURL=to-body.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"to-body.js","names":[],"sources":["../../../src/utils/pages/to-body.ts"],"sourcesContent":["import type { ApiPageProps } from '@/ui/api-page';\nimport type { OutputEntry } from '@/utils/pages/builder';\n\nexport function toBody(entry: OutputEntry): ApiPageProps {\n  if (entry.type === 'operation')\n    return {\n      document: entry.schemaId,\n      operations: [entry.item],\n    };\n  if (entry.type === 'webhook')\n    return {\n      document: entry.schemaId,\n      webhooks: [entry.item],\n    };\n\n  return {\n    showTitle: true,\n    showDescription: true,\n    document: entry.schemaId,\n    operations: entry.operations,\n    webhooks: entry.webhooks,\n  };\n}\n"],"mappings":";AAGA,SAAgB,OAAO,OAAkC;AACvD,KAAI,MAAM,SAAS,YACjB,QAAO;EACL,UAAU,MAAM;EAChB,YAAY,CAAC,MAAM,KAAK;EACzB;AACH,KAAI,MAAM,SAAS,UACjB,QAAO;EACL,UAAU,MAAM;EAChB,UAAU,CAAC,MAAM,KAAK;EACvB;AAEH,QAAO;EACL,WAAW;EACX,iBAAiB;EACjB,UAAU,MAAM;EAChB,YAAY,MAAM;EAClB,UAAU,MAAM;EACjB"}

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

@@ -45,4 +45,5 @@ function toStaticData(page, dereferenced) {
 }
 
 //#endregion
-export { toStaticData };
+export { toStaticData };
+//# sourceMappingURL=to-static-data.js.map

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

@@ -0,0 +1 @@
+{"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.d.ts

@@ -1,7 +1,4 @@
-import "./builder.js";
 import { TagObject } from "../../types.js";
-import "../process-document.js";
-
 //#region src/utils/pages/to-text.d.ts
 interface PagesToTextOptions {
   /**
@@ -44,4 +41,5 @@ type DocumentContext = {
   type: 'file';
 };
 //#endregion
-export { PagesToTextOptions };
+export { PagesToTextOptions };
+//# sourceMappingURL=to-text.d.ts.map

package/dist/utils/pages/to-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-text.d.ts","names":[],"sources":["../../../src/utils/pages/to-text.ts"],"mappings":";;UASiB,kBAAA;;AAAjB;;EAIE,OAAA;IACE,KAAA;IACA,IAAA;EAAA;EAAA;;;;;EAQF,WAAA,IACE,KAAA,UACA,WAAA,sBACA,OAAA,EAAS,eAAA,KACN,MAAA;EAAA;;;;;AAkIP;;EAzHE,kBAAA;EA4HkB;;;;;;;;EAlHlB,mBAAA;AAAA;AAAA,KA+GU,eAAA;EAEN,IAAA;EACA,GAAA,EAAK,SAAA;AAAA;EAGL,IAAA;AAAA;EAGA,IAAA;AAAA"}

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

@@ -94,4 +94,5 @@ function pageContent({ showTitle, showDescription, document, webhooks, operation
 }
 
 //#endregion
-export { generateDocument, toText };
+export { generateDocument, toText };
+//# sourceMappingURL=to-text.js.map

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

@@ -0,0 +1 @@
+{"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/dist/utils/process-document.d.ts

@@ -14,4 +14,5 @@ interface ProcessedDocument {
   bundled: Document;
 }
 //#endregion
-export { ProcessedDocument };
+export { ProcessedDocument };
+//# sourceMappingURL=process-document.d.ts.map

package/dist/utils/process-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-document.d.ts","names":[],"sources":["../../src/utils/process-document.ts"],"mappings":";;;;UAQiB,iBAAA;;AAAjB;;EAIE,YAAA,EAAc,WAAA,CAAY,QAAA;EAAA;;;EAK1B,SAAA,GAAY,GAAA;EAEZ,OAAA,EAAS,QAAA;AAAA"}

package/dist/utils/process-document.js

@@ -61,4 +61,5 @@ function dereferenceSync(schema, onDereference) {
 }
 
 //#endregion
-export { processDocument };
+export { processDocument };
+//# sourceMappingURL=process-document.js.map

package/dist/utils/process-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-document.js","names":[],"sources":["../../src/utils/process-document.ts"],"sourcesContent":["import type { Document } from '@/types';\nimport type { NoReference } from '@/utils/schema';\nimport { bundle } from '@scalar/json-magic/bundle';\nimport { upgrade } from '@scalar/openapi-upgrader';\nimport { fetchUrls, readFiles } from '@scalar/json-magic/bundle/plugins/node';\nimport type { JSONSchema } from 'json-schema-typed/draft-2020-12';\nimport { resolveRefSync } from 'dereference-json-schema';\n\nexport interface ProcessedDocument {\n  /**\n   * dereferenced document\n   */\n  dereferenced: NoReference<Document>;\n\n  /**\n   * Get raw object from dereferenced object\n   */\n  getRawRef: (obj: object) => string | undefined;\n\n  bundled: Document;\n}\n\n/**\n * process & reference input document to a Fumadocs OpenAPI compatible format\n */\nexport async function processDocument(input: string | Document): Promise<ProcessedDocument> {\n  const bundled: Document = await bundle(input, {\n    plugins: [fetchUrls(), readFiles()],\n    treeShake: true,\n    hooks: {\n      onResolveError(node) {\n        throw new Error(`Failed to resolve ${node.$ref}`);\n      },\n    },\n  })\n    .then((v) => upgrade(v as never, '3.2') as Document)\n    .catch((e) => {\n      throw new Error(`[OpenAPI] Failed to resolve input: ${input}`, {\n        cause: e,\n      });\n    });\n\n  /**\n   * Dereferenced value and its original `$ref` value\n   */\n  const dereferenceMap = new WeakMap<object, string>();\n\n  return {\n    dereferenced: dereferenceSync(bundled as JSONSchema, (ref, schema) => {\n      dereferenceMap.set(schema as object, ref);\n    }) as NoReference<Document>,\n    getRawRef(obj) {\n      return dereferenceMap.get(obj);\n    },\n    bundled,\n  };\n}\n\n/**\n * Resolves all $ref pointers in a schema and returns a new schema without any $ref pointers.\n */\nfunction dereferenceSync(\n  schema: JSONSchema,\n  onDereference: (ref: string, schema: JSONSchema) => void,\n): JSONSchema {\n  if (typeof schema === 'boolean') return schema;\n  const visitedNodes = new Set<unknown>();\n  const cloned = structuredClone(schema);\n\n  function resolve(current: unknown, path: string): JSONSchema {\n    if (typeof current === 'object' && current !== null) {\n      // make sure we don't visit the same node twice\n      if (visitedNodes.has(current)) {\n        return current;\n      }\n      visitedNodes.add(current);\n\n      if (Array.isArray(current)) {\n        // array\n        for (let index = 0; index < current.length; index++) {\n          current[index] = resolve(current[index], `${path}/${index}`);\n        }\n      } else {\n        // object\n        if ('$ref' in current && typeof current['$ref'] === 'string') {\n          const ref = current['$ref'];\n          const out = resolveRefSync(cloned as never, ref) as JSONSchema;\n          onDereference(ref, out);\n          return out;\n        }\n\n        const obj = current as Record<string, unknown>;\n        for (const key in current) {\n          obj[key] = resolve(obj[key], `${path}/${key}`);\n        }\n      }\n    }\n\n    return current as JSONSchema;\n  }\n\n  return resolve(cloned, '#');\n}\n"],"mappings":";;;;;;;;;;AAyBA,eAAsB,gBAAgB,OAAsD;CAC1F,MAAM,UAAoB,MAAM,OAAO,OAAO;EAC5C,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC;EACnC,WAAW;EACX,OAAO,EACL,eAAe,MAAM;AACnB,SAAM,IAAI,MAAM,qBAAqB,KAAK,OAAO;KAEpD;EACF,CAAC,CACC,MAAM,MAAM,QAAQ,GAAY,MAAM,CAAa,CACnD,OAAO,MAAM;AACZ,QAAM,IAAI,MAAM,sCAAsC,SAAS,EAC7D,OAAO,GACR,CAAC;GACF;;;;CAKJ,MAAM,iCAAiB,IAAI,SAAyB;AAEpD,QAAO;EACL,cAAc,gBAAgB,UAAwB,KAAK,WAAW;AACpE,kBAAe,IAAI,QAAkB,IAAI;IACzC;EACF,UAAU,KAAK;AACb,UAAO,eAAe,IAAI,IAAI;;EAEhC;EACD;;;;;AAMH,SAAS,gBACP,QACA,eACY;AACZ,KAAI,OAAO,WAAW,UAAW,QAAO;CACxC,MAAM,+BAAe,IAAI,KAAc;CACvC,MAAM,SAAS,gBAAgB,OAAO;CAEtC,SAAS,QAAQ,SAAkB,MAA0B;AAC3D,MAAI,OAAO,YAAY,YAAY,YAAY,MAAM;AAEnD,OAAI,aAAa,IAAI,QAAQ,CAC3B,QAAO;AAET,gBAAa,IAAI,QAAQ;AAEzB,OAAI,MAAM,QAAQ,QAAQ,CAExB,MAAK,IAAI,QAAQ,GAAG,QAAQ,QAAQ,QAAQ,QAC1C,SAAQ,SAAS,QAAQ,QAAQ,QAAQ,GAAG,KAAK,GAAG,QAAQ;QAEzD;AAEL,QAAI,UAAU,WAAW,OAAO,QAAQ,YAAY,UAAU;KAC5D,MAAM,MAAM,QAAQ;KACpB,MAAM,yDAAqB,QAAiB,IAAI;AAChD,mBAAc,KAAK,IAAI;AACvB,YAAO;;IAGT,MAAM,MAAM;AACZ,SAAK,MAAM,OAAO,QAChB,KAAI,OAAO,QAAQ,IAAI,MAAM,GAAG,KAAK,GAAG,MAAM;;;AAKpD,SAAO;;AAGT,QAAO,QAAQ,QAAQ,IAAI"}

package/dist/utils/remove-undefined.js

@@ -15,4 +15,5 @@ function removeUndefined(value, deep = false) {
 }
 
 //#endregion
-export { removeUndefined };
+export { removeUndefined };
+//# sourceMappingURL=remove-undefined.js.map

package/dist/utils/remove-undefined.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-undefined.js","names":[],"sources":["../../src/utils/remove-undefined.ts"],"sourcesContent":["export function removeUndefined<T extends object>(value: T, deep = false): T {\n  const obj = value as Record<string, unknown>;\n\n  for (const key in obj) {\n    if (obj[key] === undefined) delete obj[key];\n    if (!deep) continue;\n\n    const entry = obj[key];\n\n    if (typeof entry === 'object' && entry !== null) {\n      removeUndefined(entry, deep);\n      continue;\n    }\n\n    if (Array.isArray(entry)) {\n      for (const item of entry) removeUndefined(item, deep);\n    }\n  }\n\n  return value;\n}\n"],"mappings":";AAAA,SAAgB,gBAAkC,OAAU,OAAO,OAAU;CAC3E,MAAM,MAAM;AAEZ,MAAK,MAAM,OAAO,KAAK;AACrB,MAAI,IAAI,SAAS,OAAW,QAAO,IAAI;AACvC,MAAI,CAAC,KAAM;EAEX,MAAM,QAAQ,IAAI;AAElB,MAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC/C,mBAAgB,OAAO,KAAK;AAC5B;;AAGF,MAAI,MAAM,QAAQ,MAAM,CACtB,MAAK,MAAM,QAAQ,MAAO,iBAAgB,MAAM,KAAK;;AAIzD,QAAO"}

package/dist/utils/schema-to-string.d.ts

@@ -1,2 +1 @@
-import "./schema.js";
-import "./process-document.js";
+export { };

package/dist/utils/schema-to-string.js

@@ -54,4 +54,5 @@ function schemaToString(value, _resolver, flags = FormatFlags.None) {
 }
 
 //#endregion
-export { FormatFlags, schemaToString };
+export { FormatFlags, schemaToString };
+//# sourceMappingURL=schema-to-string.js.map

package/dist/utils/schema-to-string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-to-string.js","names":[],"sources":["../../src/utils/schema-to-string.ts"],"sourcesContent":["import type { ParsedSchema, ResolvedSchema } from '@/utils/schema';\nimport type { ProcessedDocument } from '@/utils/process-document';\n\nexport enum FormatFlags {\n  None = 0,\n  UseAlias = 1 << 0,\n}\n\ntype Resolver = (schema: ResolvedSchema) => {\n  dereferenced: ResolvedSchema;\n  raw?: ParsedSchema;\n};\n\nexport function schemaToString(\n  value: ResolvedSchema,\n  _resolver?: ProcessedDocument | Resolver,\n  flags: FormatFlags = FormatFlags.None,\n): string {\n  const resolver: Resolver =\n    typeof _resolver === 'function'\n      ? _resolver\n      : (schema) => {\n          const ref =\n            _resolver && typeof schema === 'object' ? _resolver.getRawRef(schema) : undefined;\n\n          return {\n            dereferenced: schema,\n            raw: ref ? { $ref: ref } : undefined,\n          };\n        };\n  function union(union: readonly ResolvedSchema[], sep: string, flags: FormatFlags) {\n    const members = new Set();\n    let nullable = false;\n\n    for (const item of union) {\n      const result = run(item, flags | FormatFlags.UseAlias);\n\n      if (result === 'null') {\n        nullable = true;\n      } else if (result !== 'unknown') {\n        members.add(result);\n      }\n    }\n\n    const result = Array.from(members).join(sep);\n    return nullable ? `${result} | null` : result;\n  }\n\n  function run(schema: ResolvedSchema, flags: FormatFlags): string {\n    const resolved = resolver(schema);\n    schema = resolved.dereferenced;\n\n    if (schema === true) return 'any';\n    else if (schema === false) return 'never';\n\n    if ((flags & FormatFlags.UseAlias) === FormatFlags.UseAlias) {\n      if (schema.title) return schema.title;\n\n      if (typeof resolved.raw === 'object' && resolved.raw.$ref) {\n        const ref = resolved.raw.$ref.split('/');\n        if (ref.length > 0) return ref[ref.length - 1];\n      }\n    }\n\n    if (Array.isArray(schema.type)) {\n      return union(\n        schema.type.map((type) => ({\n          ...schema,\n          type,\n        })),\n        ' | ',\n        flags,\n      );\n    }\n\n    if (schema.type === 'array')\n      return `array<${schema.items ? run(schema.items, flags | FormatFlags.UseAlias) : 'unknown'}>`;\n\n    const or = schema.oneOf ?? schema.anyOf;\n    if (schema.oneOf && schema.anyOf) {\n      return `(${union(schema.oneOf, ' | ', flags)}) & (${union(schema.anyOf, ' | ', flags)})`;\n    } else if (or) {\n      return union(or, ' | ', flags);\n    }\n\n    if (schema.allOf) {\n      return union(schema.allOf, ' & ', flags);\n    }\n\n    if (schema.not) return `not ${run(schema.not, flags)}`;\n    if (schema.type === 'string' && schema.format === 'binary') return 'file';\n\n    if (schema.type && Array.isArray(schema.type)) {\n      return schema.type.filter((v) => v !== 'null').join(' | ');\n    }\n\n    if (schema.type) {\n      return schema.type as string;\n    }\n\n    return 'unknown';\n  }\n\n  return run(value, flags);\n}\n"],"mappings":";AAGA,IAAY,oDAAL;AACL;AACA;;;AAQF,SAAgB,eACd,OACA,WACA,QAAqB,YAAY,MACzB;CACR,MAAM,WACJ,OAAO,cAAc,aACjB,aACC,WAAW;EACV,MAAM,MACJ,aAAa,OAAO,WAAW,WAAW,UAAU,UAAU,OAAO,GAAG;AAE1E,SAAO;GACL,cAAc;GACd,KAAK,MAAM,EAAE,MAAM,KAAK,GAAG;GAC5B;;CAET,SAAS,MAAM,OAAkC,KAAa,OAAoB;EAChF,MAAM,0BAAU,IAAI,KAAK;EACzB,IAAI,WAAW;AAEf,OAAK,MAAM,QAAQ,OAAO;GACxB,MAAM,SAAS,IAAI,MAAM,QAAQ,YAAY,SAAS;AAEtD,OAAI,WAAW,OACb,YAAW;YACF,WAAW,UACpB,SAAQ,IAAI,OAAO;;EAIvB,MAAM,SAAS,MAAM,KAAK,QAAQ,CAAC,KAAK,IAAI;AAC5C,SAAO,WAAW,GAAG,OAAO,WAAW;;CAGzC,SAAS,IAAI,QAAwB,OAA4B;EAC/D,MAAM,WAAW,SAAS,OAAO;AACjC,WAAS,SAAS;AAElB,MAAI,WAAW,KAAM,QAAO;WACnB,WAAW,MAAO,QAAO;AAElC,OAAK,QAAQ,YAAY,cAAc,YAAY,UAAU;AAC3D,OAAI,OAAO,MAAO,QAAO,OAAO;AAEhC,OAAI,OAAO,SAAS,QAAQ,YAAY,SAAS,IAAI,MAAM;IACzD,MAAM,MAAM,SAAS,IAAI,KAAK,MAAM,IAAI;AACxC,QAAI,IAAI,SAAS,EAAG,QAAO,IAAI,IAAI,SAAS;;;AAIhD,MAAI,MAAM,QAAQ,OAAO,KAAK,CAC5B,QAAO,MACL,OAAO,KAAK,KAAK,UAAU;GACzB,GAAG;GACH;GACD,EAAE,EACH,OACA,MACD;AAGH,MAAI,OAAO,SAAS,QAClB,QAAO,SAAS,OAAO,QAAQ,IAAI,OAAO,OAAO,QAAQ,YAAY,SAAS,GAAG,UAAU;EAE7F,MAAM,KAAK,OAAO,SAAS,OAAO;AAClC,MAAI,OAAO,SAAS,OAAO,MACzB,QAAO,IAAI,MAAM,OAAO,OAAO,OAAO,MAAM,CAAC,OAAO,MAAM,OAAO,OAAO,OAAO,MAAM,CAAC;WAC7E,GACT,QAAO,MAAM,IAAI,OAAO,MAAM;AAGhC,MAAI,OAAO,MACT,QAAO,MAAM,OAAO,OAAO,OAAO,MAAM;AAG1C,MAAI,OAAO,IAAK,QAAO,OAAO,IAAI,OAAO,KAAK,MAAM;AACpD,MAAI,OAAO,SAAS,YAAY,OAAO,WAAW,SAAU,QAAO;AAEnE,MAAI,OAAO,QAAQ,MAAM,QAAQ,OAAO,KAAK,CAC3C,QAAO,OAAO,KAAK,QAAQ,MAAM,MAAM,OAAO,CAAC,KAAK,MAAM;AAG5D,MAAI,OAAO,KACT,QAAO,OAAO;AAGhB,SAAO;;AAGT,QAAO,IAAI,OAAO,MAAM"}

package/dist/utils/schema.d.ts

@@ -11,4 +11,5 @@ type ParsedSchema = (JSONSchema & {
 }) | boolean;
 type ResolvedSchema = NoReferenceJSONSchema<ParsedSchema>;
 //#endregion
-export { NoReference, ParsedSchema, ResolvedSchema };
+export { NoReference, ParsedSchema, ResolvedSchema };
+//# sourceMappingURL=schema.d.ts.map

package/dist/utils/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","names":[],"sources":["../../src/utils/schema.ts"],"mappings":";;;;KAcY,WAAA,MAAiB,CAAA,uBACzB,WAAA,CAAY,CAAA,MACZ,CAAA,SAAU,eAAA,GACR,OAAA,CAAQ,CAAA,EAAG,eAAA,IACX,CAAA,gCAEgB,CAAA,GAAI,WAAA,CAAY,CAAA,CAAE,CAAA,OAEhC,CAAA;AAAA,KAEH,qBAAA,MAA2B,CAAA,uBAC5B,WAAA,CAAY,CAAA,MACZ,CAAA;EAAY,IAAA;AAAA,IACV,IAAA,CAAK,CAAA,YACL,CAAA;AAAA,KAEM,YAAA,IACP,UAAA;EACC,mBAAA;AAAA;AAAA,KAGM,cAAA,GAAiB,qBAAA,CAAsB,YAAA"}

package/dist/utils/schema.js

@@ -48,4 +48,5 @@ function pickExample(value) {
 }
 
 //#endregion
-export { createMethod, getPreferredType, getTagDisplayName, methodKeys, pickExample };
+export { createMethod, getPreferredType, getTagDisplayName, methodKeys, pickExample };
+//# sourceMappingURL=schema.js.map

package/dist/utils/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","names":[],"sources":["../../src/utils/schema.ts"],"sourcesContent":["import type { JSONSchema } from 'json-schema-typed/draft-2020-12';\nimport type {\n  ExampleObject,\n  MediaTypeObject,\n  MethodInformation,\n  OperationObject,\n  PathItemObject,\n  ReferenceObject,\n  TagObject,\n} from '@/types';\nimport { idToTitle } from '@/utils/id-to-title';\n\nexport const methodKeys = ['get', 'post', 'patch', 'delete', 'head', 'put'] as const;\n\nexport type NoReference<T> = T extends (infer I)[]\n  ? NoReference<I>[]\n  : T extends ReferenceObject\n    ? Exclude<T, ReferenceObject>\n    : T extends object\n      ? {\n          [K in keyof T]: NoReference<T[K]>;\n        }\n      : T;\n\ntype NoReferenceJSONSchema<T> = T extends (infer I)[]\n  ? NoReference<I>[]\n  : T extends { $ref?: string }\n    ? Omit<T, '$ref'>\n    : T;\n\nexport type ParsedSchema =\n  | (JSONSchema & {\n      'x-playground-lazy'?: boolean;\n    })\n  | boolean;\nexport type ResolvedSchema = NoReferenceJSONSchema<ParsedSchema>;\n\nexport function getPreferredType(body: Record<string, unknown>): string | undefined {\n  if ('application/json' in body) return 'application/json';\n\n  return Object.keys(body)[0];\n}\n\nexport function getTagDisplayName(tag: TagObject): string {\n  if ('x-displayName' in tag && typeof tag['x-displayName'] === 'string')\n    return tag['x-displayName'];\n\n  if (tag.summary) return tag.summary;\n  return idToTitle(tag.name!);\n}\n\n/**\n * Summarize method endpoint information\n */\nexport function createMethod(\n  method: string,\n  path: NoReference<PathItemObject>,\n  operation: NoReference<OperationObject>,\n): MethodInformation {\n  return {\n    description: path.description,\n    summary: path.summary,\n    ...operation,\n    servers: operation.servers ?? path.servers,\n    parameters: [...(operation.parameters ?? []), ...(path.parameters ?? [])],\n    method: method.toUpperCase(),\n  };\n}\n\ninterface ExampleLike {\n  example?: unknown;\n  examples?: {\n    [media: string]: ExampleObject;\n  };\n  content?: {\n    [media: string]: MediaTypeObject;\n  };\n}\n\nexport function pickExample(value: ExampleLike): unknown | undefined {\n  if (value.example !== undefined) {\n    return value.example;\n  }\n\n  if (value.content) {\n    const type = getPreferredType(value.content);\n    const content = type ? value.content[type] : undefined;\n\n    if (type && content) {\n      const out = value.examples?.[type].value ?? pickExample(content);\n      if (out !== undefined) return out;\n    }\n  }\n\n  if (value.examples) {\n    const examples = Object.values(value.examples);\n    if (examples.length > 0) return examples[0].value;\n  }\n}\n"],"mappings":";;;AAYA,MAAa,aAAa;CAAC;CAAO;CAAQ;CAAS;CAAU;CAAQ;CAAM;AAyB3E,SAAgB,iBAAiB,MAAmD;AAClF,KAAI,sBAAsB,KAAM,QAAO;AAEvC,QAAO,OAAO,KAAK,KAAK,CAAC;;AAG3B,SAAgB,kBAAkB,KAAwB;AACxD,KAAI,mBAAmB,OAAO,OAAO,IAAI,qBAAqB,SAC5D,QAAO,IAAI;AAEb,KAAI,IAAI,QAAS,QAAO,IAAI;AAC5B,QAAO,UAAU,IAAI,KAAM;;;;;AAM7B,SAAgB,aACd,QACA,MACA,WACmB;AACnB,QAAO;EACL,aAAa,KAAK;EAClB,SAAS,KAAK;EACd,GAAG;EACH,SAAS,UAAU,WAAW,KAAK;EACnC,YAAY,CAAC,GAAI,UAAU,cAAc,EAAE,EAAG,GAAI,KAAK,cAAc,EAAE,CAAE;EACzE,QAAQ,OAAO,aAAa;EAC7B;;AAaH,SAAgB,YAAY,OAAyC;AACnE,KAAI,MAAM,YAAY,OACpB,QAAO,MAAM;AAGf,KAAI,MAAM,SAAS;EACjB,MAAM,OAAO,iBAAiB,MAAM,QAAQ;EAC5C,MAAM,UAAU,OAAO,MAAM,QAAQ,QAAQ;AAE7C,MAAI,QAAQ,SAAS;GACnB,MAAM,MAAM,MAAM,WAAW,MAAM,SAAS,YAAY,QAAQ;AAChE,OAAI,QAAQ,OAAW,QAAO;;;AAIlC,KAAI,MAAM,UAAU;EAClB,MAAM,WAAW,OAAO,OAAO,MAAM,SAAS;AAC9C,MAAI,SAAS,SAAS,EAAG,QAAO,SAAS,GAAG"}

package/dist/utils/url.js

@@ -29,7 +29,7 @@ function resolveRequestData(pathname, { path, query }) {
 	const searchParams = new URLSearchParams(existingQueryString || "");
 	for (const key in query) {
 		const param = query[key];
-		if (param.values.length === 0) continue;
+		if (!param || param.values.length === 0) continue;
 		searchParams.delete(key);
 		for (const item of param.values) searchParams.append(key, item);
 	}
@@ -37,4 +37,5 @@ function resolveRequestData(pathname, { path, query }) {
 }
 
 //#endregion
-export { isUrl, joinURL, resolveRequestData, resolveServerUrl, withBase };
+export { isUrl, joinURL, resolveRequestData, resolveServerUrl, withBase };
+//# sourceMappingURL=url.js.map

package/dist/utils/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","names":[],"sources":["../../src/utils/url.ts"],"sourcesContent":["import type { RequestData } from '@/requests/types';\n\nexport function isUrl(schemaId: string): boolean {\n  return schemaId.startsWith('https://') || schemaId.startsWith('http://');\n}\n\nexport function joinURL(base: string, pathname: string): string {\n  if (pathname.startsWith('/')) pathname = pathname.slice(1);\n  if (base.endsWith('/')) base = base.slice(0, -1);\n\n  if (pathname.length > 0) return base + '/' + pathname;\n  else return base;\n}\n\n/**\n * @param url - URL (can be relative)\n * @param base - the base URL (must be absolute)\n */\nexport function withBase(url: string, base: string): string {\n  if (!url.startsWith('https://') && !url.startsWith('http://')) {\n    return joinURL(base, url);\n  }\n\n  return url;\n}\n\nexport function resolveServerUrl(template: string, variables: Record<string, string>): string {\n  for (const [key, value] of Object.entries(variables)) {\n    template = template.replaceAll(`{${key}}`, value);\n  }\n\n  return template;\n}\n\nexport function resolveRequestData(pathname: string, { path, query }: RequestData): string {\n  // First, resolve path parameters in the pathname\n  for (const key in path) {\n    const param = path[key];\n\n    pathname = pathname.replace(`{${key}}`, param.value);\n  }\n\n  // Check if pathname already contains query parameters (legacy API support)\n  const [pathPart, existingQueryString] = pathname.split('?', 2);\n\n  // Parse existing query parameters from the pathname if they exist\n  const searchParams = new URLSearchParams(existingQueryString || '');\n\n  // Add new query parameters from the RequestData\n  for (const key in query) {\n    const param = query[key];\n    if (!param || param.values.length === 0) continue;\n\n    // Remove existing parameter first to avoid duplicates\n    searchParams.delete(key);\n    for (const item of param.values) {\n      searchParams.append(key, item);\n    }\n  }\n\n  // Return the reconstructed URL\n  return searchParams.size > 0 ? `${pathPart}?${searchParams}` : pathPart;\n}\n"],"mappings":";AAEA,SAAgB,MAAM,UAA2B;AAC/C,QAAO,SAAS,WAAW,WAAW,IAAI,SAAS,WAAW,UAAU;;AAG1E,SAAgB,QAAQ,MAAc,UAA0B;AAC9D,KAAI,SAAS,WAAW,IAAI,CAAE,YAAW,SAAS,MAAM,EAAE;AAC1D,KAAI,KAAK,SAAS,IAAI,CAAE,QAAO,KAAK,MAAM,GAAG,GAAG;AAEhD,KAAI,SAAS,SAAS,EAAG,QAAO,OAAO,MAAM;KACxC,QAAO;;;;;;AAOd,SAAgB,SAAS,KAAa,MAAsB;AAC1D,KAAI,CAAC,IAAI,WAAW,WAAW,IAAI,CAAC,IAAI,WAAW,UAAU,CAC3D,QAAO,QAAQ,MAAM,IAAI;AAG3B,QAAO;;AAGT,SAAgB,iBAAiB,UAAkB,WAA2C;AAC5F,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,UAAU,CAClD,YAAW,SAAS,WAAW,IAAI,IAAI,IAAI,MAAM;AAGnD,QAAO;;AAGT,SAAgB,mBAAmB,UAAkB,EAAE,MAAM,SAA8B;AAEzF,MAAK,MAAM,OAAO,MAAM;EACtB,MAAM,QAAQ,KAAK;AAEnB,aAAW,SAAS,QAAQ,IAAI,IAAI,IAAI,MAAM,MAAM;;CAItD,MAAM,CAAC,UAAU,uBAAuB,SAAS,MAAM,KAAK,EAAE;CAG9D,MAAM,eAAe,IAAI,gBAAgB,uBAAuB,GAAG;AAGnE,MAAK,MAAM,OAAO,OAAO;EACvB,MAAM,QAAQ,MAAM;AACpB,MAAI,CAAC,SAAS,MAAM,OAAO,WAAW,EAAG;AAGzC,eAAa,OAAO,IAAI;AACxB,OAAK,MAAM,QAAQ,MAAM,OACvB,cAAa,OAAO,KAAK,KAAK;;AAKlC,QAAO,aAAa,OAAO,IAAI,GAAG,SAAS,GAAG,iBAAiB"}

package/dist/utils/use-query.js

@@ -36,4 +36,5 @@ function useQuery(fn) {
 }
 
 //#endregion
-export { useQuery };
+export { useQuery };
+//# sourceMappingURL=use-query.js.map

package/dist/utils/use-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-query.js","names":[],"sources":["../../src/utils/use-query.ts"],"sourcesContent":["import { useMemo, useRef, useState } from 'react';\n\nexport function useQuery<I extends unknown[], T>(\n  fn: (...input: I) => Promise<T>,\n): {\n  start: (...input: I) => void;\n  reset: () => void;\n  data?: T;\n  error?: unknown;\n  isLoading: boolean;\n} {\n  const [loading, setLoading] = useState(false);\n  const [data, setData] = useState<T>();\n  const [error, setError] = useState<T>();\n  const fnRef = useRef(fn);\n  fnRef.current = fn;\n\n  return useMemo(\n    () => ({\n      isLoading: loading,\n      data,\n      error,\n      start(...input) {\n        setLoading(true);\n\n        void fnRef\n          .current(...input)\n          .then((res) => {\n            setData(res);\n            setError(undefined);\n          })\n          .catch((err) => {\n            setData(undefined);\n            setError(err);\n          })\n          .finally(() => {\n            setLoading(false);\n          });\n      },\n      reset() {\n        setData(undefined);\n        setError(undefined);\n        setLoading(false);\n      },\n    }),\n    [error, data, loading],\n  );\n}\n"],"mappings":";;;AAEA,SAAgB,SACd,IAOA;CACA,MAAM,CAAC,SAAS,cAAc,SAAS,MAAM;CAC7C,MAAM,CAAC,MAAM,WAAW,UAAa;CACrC,MAAM,CAAC,OAAO,YAAY,UAAa;CACvC,MAAM,QAAQ,OAAO,GAAG;AACxB,OAAM,UAAU;AAEhB,QAAO,eACE;EACL,WAAW;EACX;EACA;EACA,MAAM,GAAG,OAAO;AACd,cAAW,KAAK;AAEhB,GAAK,MACF,QAAQ,GAAG,MAAM,CACjB,MAAM,QAAQ;AACb,YAAQ,IAAI;AACZ,aAAS,OAAU;KACnB,CACD,OAAO,QAAQ;AACd,YAAQ,OAAU;AAClB,aAAS,IAAI;KACb,CACD,cAAc;AACb,eAAW,MAAM;KACjB;;EAEN,QAAQ;AACN,WAAQ,OAAU;AAClB,YAAS,OAAU;AACnB,cAAW,MAAM;;EAEpB,GACD;EAAC;EAAO;EAAM;EAAQ,CACvB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-openapi",
-  "version": "10.3.14",
+  "version": "10.3.16",
   "description": "Generate MDX docs for your OpenAPI spec",
   "keywords": [
     "Docs",
@@ -47,16 +47,16 @@
     "@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.11.5",
-    "@scalar/openapi-upgrader": "^0.1.9",
+    "@scalar/json-magic": "^0.12.0",
+    "@scalar/openapi-upgrader": "^0.2.0",
     "ajv": "^8.18.0",
     "class-variance-authority": "^0.7.1",
     "github-slugger": "^2.0.0",
     "hast-util-to-jsx-runtime": "^2.3.6",
     "js-yaml": "^4.1.1",
-    "lucide-react": "^0.575.0",
+    "lucide-react": "^0.577.0",
     "next-themes": "^0.4.6",
-    "openapi-sampler": "^1.7.0",
+    "openapi-sampler": "^1.7.1",
     "react-hook-form": "^7.71.2",
     "remark": "^15.0.1",
     "remark-rehype": "^11.1.2",
@@ -65,7 +65,7 @@
     "@fumari/stf": "1.0.3"
   },
   "devDependencies": {
-    "@scalar/api-client-react": "^1.3.104",
+    "@scalar/api-client-react": "^1.4.1",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "25.3.3",
     "@types/openapi-sampler": "^1.0.3",
@@ -74,10 +74,10 @@
     "json-schema-typed": "^8.0.2",
     "tailwindcss": "^4.2.1",
     "tsdown": "0.20.3",
-    "@fumadocs/tailwind": "0.0.3",
     "eslint-config-custom": "0.0.0",
-    "fumadocs-core": "16.6.8",
-    "fumadocs-ui": "16.6.8",
+    "fumadocs-core": "16.6.10",
+    "fumadocs-ui": "16.6.10",
+    "@fumadocs/tailwind": "0.0.3",
     "tsconfig": "0.0.0"
   },
   "peerDependencies": {