fumadocs-openapi 10.3.14 → 10.3.15

package/dist/ui/operation/request-tabs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-tabs.js","names":[],"sources":["../../../src/ui/operation/request-tabs.tsx"],"sourcesContent":["import type { MethodInformation, RenderContext } from '@/types';\nimport { getPreferredType, type NoReference, pickExample } from '@/utils/schema';\nimport {\n  AccordionContent,\n  AccordionHeader,\n  AccordionItem,\n  Accordions,\n  AccordionTrigger,\n} from '@/ui/components/accordion';\nimport { sample } from 'openapi-sampler';\nimport type { ReactNode } from 'react';\nimport type { RawRequestData, RequestData } from '@/requests/types';\nimport { encodeRequestData } from '@/requests/media/encode';\nimport { Tabs, TabsContent, TabsList, TabsTrigger } from 'fumadocs-ui/components/tabs';\nimport { resolveRequestData } from '@/utils/url';\nimport { MethodLabel } from '../components/method-label';\n\nexport interface ExampleRequestItem {\n  id: string;\n  name: string;\n  description?: string;\n  data: RawRequestData;\n  encoded: RequestData;\n}\n\nexport function getExampleRequests(\n  path: string,\n  operation: NoReference<MethodInformation>,\n  ctx: RenderContext,\n): ExampleRequestItem[] {\n  const requestBody = operation.requestBody;\n  const media = requestBody?.content ? getPreferredType(requestBody.content) : null;\n  const bodyOfType = media ? requestBody!.content![media] : null;\n\n  if (bodyOfType?.examples) {\n    const result: ExampleRequestItem[] = [];\n\n    for (const [key, value] of Object.entries(bodyOfType.examples)) {\n      const data = getRequestData(path, operation, key, ctx);\n\n      result.push({\n        id: key,\n        name: value.summary || key,\n        description: value.description,\n        data,\n        encoded: encodeRequestData(data, ctx.mediaAdapters, operation.parameters ?? []),\n      });\n    }\n\n    if (result.length > 0) return result;\n  }\n\n  const data = getRequestData(path, operation, null, ctx);\n  return [\n    {\n      id: '_default',\n      name: 'Default',\n      description:\n        typeof bodyOfType?.schema === 'object' ? bodyOfType.schema.description : undefined,\n      data,\n      encoded: encodeRequestData(data, ctx.mediaAdapters, operation.parameters ?? []),\n    },\n  ];\n}\n\nfunction getRequestData(\n  path: string,\n  method: NoReference<MethodInformation>,\n  sampleKey: string | null,\n  _ctx: RenderContext,\n): RawRequestData {\n  const result: RawRequestData = {\n    path: {},\n    cookie: {},\n    header: {},\n    query: {},\n    method: method.method,\n  };\n\n  for (const param of method.parameters ?? []) {\n    let value = pickExample(param as never);\n\n    if (value === undefined && param.required) {\n      if (param.schema) {\n        value = sample(param.schema as object);\n      } else if (param.content) {\n        const type = getPreferredType(param.content);\n        const content = type ? param.content[type] : undefined;\n        if (!content || !content.schema)\n          throw new Error(\n            `Cannot find \"${param.name}\" parameter info for media type \"${type}\" in ${path} ${method.method}`,\n          );\n\n        value = sample(content.schema as object);\n      }\n    }\n\n    switch (param.in) {\n      case 'cookie':\n        result.cookie[param.name!] = value;\n        break;\n      case 'header':\n        result.header[param.name!] = value;\n        break;\n      case 'query':\n        result.query[param.name!] = value;\n        break;\n      default:\n        result.path[param.name!] = value;\n    }\n  }\n\n  if (method.requestBody?.content) {\n    const body = method.requestBody.content;\n    const type = getPreferredType(body);\n    if (!type)\n      throw new Error(`Cannot find body schema for ${path} ${method.method}: missing media type`);\n    result.bodyMediaType = type as RawRequestData['bodyMediaType'];\n    const bodyOfType = body[type];\n\n    if (bodyOfType.examples && sampleKey) {\n      result.body = bodyOfType.examples[sampleKey].value;\n    } else if (bodyOfType.example) {\n      result.body = bodyOfType.example;\n    } else {\n      result.body = sample((bodyOfType?.schema ?? {}) as object, {\n        skipReadOnly: method.method !== 'GET',\n        skipWriteOnly: method.method === 'GET',\n        skipNonRequired: true,\n      });\n    }\n  }\n\n  return result;\n}\n\nexport async function RequestTabs({\n  path,\n  operation,\n  ctx,\n}: {\n  path: string;\n  operation: NoReference<MethodInformation>;\n  ctx: RenderContext;\n}) {\n  if (!operation.requestBody) return null;\n  const { renderRequestTabs = renderRequestTabsDefault } = ctx.content ?? {};\n\n  return renderRequestTabs(getExampleRequests(path, operation, ctx), {\n    ...ctx,\n    route: path,\n    operation,\n  });\n}\n\nfunction renderRequestTabsDefault(\n  items: ExampleRequestItem[],\n  ctx: RenderContext & {\n    route: string;\n    operation: NoReference<MethodInformation>;\n  },\n) {\n  function renderItem(item: ExampleRequestItem) {\n    const requestData = item.data;\n    const displayNames: Partial<Record<keyof RawRequestData, ReactNode>> = {\n      body: (\n        <>\n          Body\n          <code className=\"text-xs text-fd-muted-foreground ms-auto\">\n            {requestData.bodyMediaType}\n          </code>\n        </>\n      ),\n      cookie: 'Cookie',\n      header: 'Header',\n      query: 'Query Parameters',\n      path: 'Path Parameters',\n    };\n\n    return (\n      <>\n        {item.description && ctx.renderMarkdown(item.description)}\n        <div className=\"flex flex-row gap-2 items-center justify-between\">\n          <MethodLabel>{requestData.method}</MethodLabel>\n          <code>{resolveRequestData(ctx.route, item.encoded)}</code>\n        </div>\n\n        <Accordions type=\"multiple\" className=\"mt-2\">\n          {Object.entries(displayNames).map(([k, v]) => {\n            const data = requestData[k as keyof RawRequestData];\n            if (!data || Object.keys(data).length === 0) return;\n\n            return (\n              <AccordionItem key={k} value={k}>\n                <AccordionHeader>\n                  <AccordionTrigger>{v}</AccordionTrigger>\n                </AccordionHeader>\n                <AccordionContent className=\"prose-no-margin\">\n                  {ctx.renderCodeBlock('json', JSON.stringify(data, null, 2))}\n                </AccordionContent>\n              </AccordionItem>\n            );\n          })}\n        </Accordions>\n      </>\n    );\n  }\n\n  let children: ReactNode;\n  if (items.length > 1) {\n    children = (\n      <Tabs defaultValue={items[0].id}>\n        <TabsList>\n          {items.map((item) => (\n            <TabsTrigger key={item.id} value={item.id}>\n              {item.name}\n            </TabsTrigger>\n          ))}\n        </TabsList>\n        {items.map((item) => (\n          <TabsContent key={item.id} value={item.id}>\n            {renderItem(item)}\n          </TabsContent>\n        ))}\n      </Tabs>\n    );\n  } else if (items.length === 1) {\n    children = renderItem(items[0]);\n  } else {\n    children = <p className=\"text-fd-muted-foreground text-xs\">Empty</p>;\n  }\n\n  return (\n    <div className=\"p-3 rounded-xl border prose-no-margin bg-fd-card text-fd-card-foreground shadow-md\">\n      <p className=\"font-semibold border-b pb-2\">Example Requests</p>\n      {children}\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/ui/operation/response-tabs.d.ts

@@ -27,4 +27,5 @@ interface ResponseExample {
   description?: string;
 }
 //#endregion
-export { ResponseTab };
+export { ResponseTab };
+//# sourceMappingURL=response-tabs.d.ts.map

package/dist/ui/operation/response-tabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-tabs.d.ts","names":[],"sources":["../../../src/ui/operation/response-tabs.tsx"],"mappings":";;;;;UAaiB,WAAA;;AAAjB;;EAIE,IAAA;EAEA,QAAA,EAAU,WAAA,CAAY,cAAA;EAAZ;;;EAIV,SAAA;EAEA,QAAA,GAAW,eAAA;AAAA;AAAA,UAGH,eAAA;EATc;;;EAatB,MAAA;EAEA,KAAA;EAT0B;AAC3B;;EAaC,WAAA;AAAA"}

package/dist/ui/operation/response-tabs.js

@@ -72,4 +72,5 @@ function renderResponseTabsDefault(tabs, ctx) {
 }
 
 //#endregion
-export { ResponseTabs };
+export { ResponseTabs };
+//# sourceMappingURL=response-tabs.js.map

package/dist/ui/operation/response-tabs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-tabs.js","names":[],"sources":["../../../src/ui/operation/response-tabs.tsx"],"sourcesContent":["import type { MethodInformation, RenderContext, ResponseObject } from '@/types';\nimport { getPreferredType, type NoReference } from '@/utils/schema';\nimport {\n  AccordionContent,\n  AccordionHeader,\n  AccordionItem,\n  Accordions,\n  AccordionTrigger,\n} from '@/ui/components/accordion';\nimport { Tab, Tabs } from 'fumadocs-ui/components/tabs';\nimport { sample } from 'openapi-sampler';\nimport type { ReactNode } from 'react';\n\nexport interface ResponseTab {\n  /**\n   * HTTP response code\n   */\n  code: string;\n\n  response: NoReference<ResponseObject>;\n  /**\n   * media type of response\n   */\n  mediaType: string | null;\n\n  examples?: ResponseExample[];\n}\n\ninterface ResponseExample {\n  /**\n   * generated/defined example data\n   */\n  sample: unknown;\n\n  label: string;\n\n  /**\n   * description (in Markdown)\n   */\n  description?: string;\n}\n\nexport function ResponseTabs({\n  operation,\n  ctx,\n}: {\n  operation: NoReference<MethodInformation>;\n  ctx: RenderContext;\n}) {\n  if (!operation.responses) return null;\n  const tabs: ResponseTab[] = [];\n\n  for (const [code, response] of Object.entries(operation.responses)) {\n    const media = response.content ? getPreferredType(response.content) : null;\n    const responseOfType = media ? response.content?.[media] : null;\n\n    const tab: ResponseTab = {\n      code,\n      response,\n      mediaType: media as string | null,\n    };\n\n    if (responseOfType?.examples) {\n      tab.examples ??= [];\n\n      for (const [key, sample] of Object.entries(responseOfType.examples)) {\n        const title = sample?.summary || `Example ${key}`;\n\n        tab.examples.push({\n          label: title,\n          sample: sample.value,\n          description: sample?.description,\n        });\n      }\n    } else if (responseOfType?.example || responseOfType?.schema) {\n      tab.examples ??= [];\n      tab.examples.push({\n        label: 'Example',\n        sample: responseOfType.example ?? sample(responseOfType.schema as object),\n      });\n    }\n\n    tabs.push(tab);\n  }\n  const { renderResponseTabs = renderResponseTabsDefault } = ctx.content ?? {};\n\n  return renderResponseTabs(tabs, ctx);\n}\n\nfunction renderResponseTabsDefault(\n  tabs: ResponseTab[],\n  ctx: RenderContext,\n): ReactNode | Promise<ReactNode> {\n  function renderExampleContent(example: ResponseExample) {\n    return (\n      <>\n        {example.description && ctx.renderMarkdown(example.description)}\n        {ctx.renderCodeBlock('json', JSON.stringify(example.sample, null, 2))}\n      </>\n    );\n  }\n\n  async function renderResponse(tab: ResponseTab) {\n    const { examples = [] } = tab;\n\n    let slot: ReactNode = 'Empty';\n    if (examples.length > 1) {\n      slot = (\n        <Accordions type=\"single\" className=\"pt-2\" defaultValue={examples[0].label}>\n          {examples.map((example, i) => (\n            <AccordionItem key={i} value={example.label}>\n              <AccordionHeader>\n                <AccordionTrigger>{example.label}</AccordionTrigger>\n              </AccordionHeader>\n              <AccordionContent className=\"prose-no-margin\">\n                {renderExampleContent(example)}\n              </AccordionContent>\n            </AccordionItem>\n          ))}\n        </Accordions>\n      );\n    } else if (examples.length === 1) {\n      slot = renderExampleContent(examples[0]);\n    }\n\n    return <Tab value={tab.code}>{slot}</Tab>;\n  }\n\n  if (tabs.length === 0) return null;\n\n  return (\n    <Tabs groupId=\"fumadocs_openapi_responses\" items={tabs.map((tab) => tab.code)}>\n      {tabs.map(renderResponse)}\n    </Tabs>\n  );\n}\n"],"mappings":";;;;;;;AA0CA,SAAgB,aAAa,EAC3B,WACA,OAIC;AACD,KAAI,CAAC,UAAU,UAAW,QAAO;CACjC,MAAM,OAAsB,EAAE;AAE9B,MAAK,MAAM,CAAC,MAAM,aAAa,OAAO,QAAQ,UAAU,UAAU,EAAE;EAClE,MAAM,QAAQ,SAAS,UAAU,iBAAiB,SAAS,QAAQ,GAAG;EACtE,MAAM,iBAAiB,QAAQ,SAAS,UAAU,SAAS;EAE3D,MAAM,MAAmB;GACvB;GACA;GACA,WAAW;GACZ;AAED,MAAI,gBAAgB,UAAU;AAC5B,OAAI,aAAa,EAAE;AAEnB,QAAK,MAAM,CAAC,KAAK,WAAW,OAAO,QAAQ,eAAe,SAAS,EAAE;IACnE,MAAM,QAAQ,QAAQ,WAAW,WAAW;AAE5C,QAAI,SAAS,KAAK;KAChB,OAAO;KACP,QAAQ,OAAO;KACf,aAAa,QAAQ;KACtB,CAAC;;aAEK,gBAAgB,WAAW,gBAAgB,QAAQ;AAC5D,OAAI,aAAa,EAAE;AACnB,OAAI,SAAS,KAAK;IAChB,OAAO;IACP,QAAQ,eAAe,WAAW,OAAO,eAAe,OAAiB;IAC1E,CAAC;;AAGJ,OAAK,KAAK,IAAI;;CAEhB,MAAM,EAAE,qBAAqB,8BAA8B,IAAI,WAAW,EAAE;AAE5E,QAAO,mBAAmB,MAAM,IAAI;;AAGtC,SAAS,0BACP,MACA,KACgC;CAChC,SAAS,qBAAqB,SAA0B;AACtD,SACE,4CACG,QAAQ,eAAe,IAAI,eAAe,QAAQ,YAAY,EAC9D,IAAI,gBAAgB,QAAQ,KAAK,UAAU,QAAQ,QAAQ,MAAM,EAAE,CAAC,IACpE;;CAIP,eAAe,eAAe,KAAkB;EAC9C,MAAM,EAAE,WAAW,EAAE,KAAK;EAE1B,IAAI,OAAkB;AACtB,MAAI,SAAS,SAAS,EACpB,QACE,oBAAC;GAAW,MAAK;GAAS,WAAU;GAAO,cAAc,SAAS,GAAG;aAClE,SAAS,KAAK,SAAS,MACtB,qBAAC;IAAsB,OAAO,QAAQ;eACpC,oBAAC,6BACC,oBAAC,8BAAkB,QAAQ,QAAyB,GACpC,EAClB,oBAAC;KAAiB,WAAU;eACzB,qBAAqB,QAAQ;MACb;MAND,EAOJ,CAChB;IACS;WAEN,SAAS,WAAW,EAC7B,QAAO,qBAAqB,SAAS,GAAG;AAG1C,SAAO,oBAAC;GAAI,OAAO,IAAI;aAAO;IAAW;;AAG3C,KAAI,KAAK,WAAW,EAAG,QAAO;AAE9B,QACE,oBAAC;EAAK,SAAQ;EAA6B,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK;YAC1E,KAAK,IAAI,eAAe;GACpB"}

package/dist/ui/operation/usage-tabs/client.js

@@ -131,4 +131,5 @@ function UsageTab({ id, lang, _client }) {
 }
 
 //#endregion
-export { UsageTab, UsageTabsProvider, UsageTabsSelector, useExampleRequests };
+export { UsageTab, UsageTabsProvider, UsageTabsSelector, useExampleRequests };
+//# sourceMappingURL=client.js.map

package/dist/ui/operation/usage-tabs/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":[],"sources":["../../../../src/ui/operation/usage-tabs/client.tsx"],"sourcesContent":["'use client';\nimport { useApiContext, useServerSelectContext } from '@/ui/contexts/api';\nimport { joinURL, withBase, resolveServerUrl, resolveRequestData } from '@/utils/url';\nimport {\n  Select,\n  SelectTrigger,\n  SelectValue,\n  SelectContent,\n  SelectItem,\n} from '@/ui/components/select';\nimport { DynamicCodeBlock } from 'fumadocs-ui/components/dynamic-codeblock.core';\nimport { useState, useEffect, useMemo, createContext, ReactNode, useRef, use } from 'react';\nimport type { ExampleRequestItem } from '../request-tabs';\nimport type { RawRequestData, RequestData } from '@/requests/types';\nimport type { CodeUsageGenerator } from '@/requests/generators';\n\nexport type ExampleUpdateListener = (data: RawRequestData, encoded: RequestData) => void;\n\nconst Context = createContext<{\n  route: string;\n  examples: ExampleRequestItem[];\n  example: string | undefined;\n  setExample: (id: string) => void;\n  setExampleData: (data: RawRequestData, encoded: RequestData) => void;\n\n  addListener: (listener: ExampleUpdateListener) => void;\n  removeListener: (listener: ExampleUpdateListener) => void;\n} | null>(null);\n\nexport function UsageTabsProvider({\n  route,\n  examples,\n  defaultExampleId,\n  children,\n}: {\n  route: string;\n  examples: ExampleRequestItem[];\n  defaultExampleId?: string;\n  children: ReactNode;\n}) {\n  const [example, setExample] = useState(() => defaultExampleId ?? examples.at(0)?.id);\n  const listeners = useRef<ExampleUpdateListener[]>([]);\n\n  return (\n    <Context\n      value={useMemo(\n        () => ({\n          example,\n          route,\n          setExample(newKey: string) {\n            const example = examples.find((example) => example.id === newKey);\n            if (!example) return;\n\n            setExample(newKey);\n            for (const listener of listeners.current) {\n              listener(example.data, example.encoded);\n            }\n          },\n          examples,\n          setExampleData(data, encoded) {\n            for (const item of examples) {\n              if (item.id === example) {\n                // persistent changes\n                item.data = data;\n                item.encoded = encoded;\n                break;\n              }\n            }\n\n            for (const listener of listeners.current) {\n              listener(data, encoded);\n            }\n          },\n          removeListener(listener) {\n            listeners.current = listeners.current.filter((item) => item !== listener);\n          },\n          addListener(listener) {\n            // initial call to listeners to ensure their data is the latest\n            // this is necessary to avoid race conditions between `useEffect()`\n            const active = examples.find((item) => item.id === example)!;\n\n            listener(active.data, active.encoded);\n            listeners.current.push(listener);\n          },\n        }),\n        [example, route, examples],\n      )}\n    >\n      {children}\n    </Context>\n  );\n}\n\nexport function useExampleRequests() {\n  return use(Context)!;\n}\n\nexport function UsageTabsSelector() {\n  const { example: key, setExample: setKey, examples } = useExampleRequests();\n  const { APIExampleSelector: Override } = useApiContext().client.operation ?? {};\n\n  if (Override) {\n    return <Override items={examples} value={key} onValueChange={setKey} />;\n  }\n\n  function renderItem(item: ExampleRequestItem) {\n    return (\n      <div>\n        <span className=\"font-medium text-sm\">{item.name}</span>\n        <span className=\"text-fd-muted-foreground\">{item.description}</span>\n      </div>\n    );\n  }\n\n  if (examples.length === 1) return null;\n  const selected = examples.find((item) => item.id === key);\n  return (\n    <Select value={key} onValueChange={setKey}>\n      <SelectTrigger className=\"not-prose mb-2\">\n        {selected && <SelectValue asChild>{renderItem(selected)}</SelectValue>}\n      </SelectTrigger>\n      <SelectContent>\n        {examples.map((item) => (\n          <SelectItem key={item.id} value={item.id}>\n            {renderItem(item)}\n          </SelectItem>\n        ))}\n      </SelectContent>\n    </Select>\n  );\n}\n\nexport function UsageTab({\n  id,\n  lang,\n  _client,\n}: Pick<CodeUsageGenerator, 'lang' | '_client'> & { id: string }) {\n  const { shikiOptions, mediaAdapters, codeUsages } = useApiContext();\n  const {\n    examples,\n    example: selectedExampleId,\n    route,\n    addListener,\n    removeListener,\n  } = useExampleRequests();\n  const { server } = useServerSelectContext();\n  const [data, setData] = useState(\n    () => examples.find((example) => example.id === selectedExampleId)?.encoded,\n  );\n\n  useEffect(() => {\n    const listener: ExampleUpdateListener = (_, encoded) => setData(encoded);\n\n    addListener(listener);\n    return () => {\n      removeListener(listener);\n    };\n  }, [addListener, removeListener]);\n\n  const code = useMemo(() => {\n    if (!data) return;\n    const url = joinURL(\n      withBase(\n        server ? resolveServerUrl(server.url, server.variables) : '/',\n        typeof window !== 'undefined' ? window.location.origin : 'https://loading',\n      ),\n      resolveRequestData(route, data),\n    );\n\n    if (_client) {\n      const { generate, serverContext } = _client;\n      if (typeof generate === 'string') return generate;\n      return generate(url, data, {\n        mediaAdapters,\n        server: serverContext,\n      });\n    }\n\n    const codegen = codeUsages.get(id);\n    if (!codegen) return;\n    return codegen.generate(url, data, {\n      mediaAdapters,\n      server: null,\n    });\n  }, [data, server, route, _client, codeUsages, id, mediaAdapters]);\n\n  if (!code) return null;\n\n  return <DynamicCodeBlock lang={lang} code={code} options={shikiOptions} />;\n}\n"],"mappings":"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"}

package/dist/ui/operation/usage-tabs/index.js

@@ -56,4 +56,5 @@ async function UsageTabs({ method, ctx }) {
 }
 
 //#endregion
-export { UsageTabs };
+export { UsageTabs };
+//# sourceMappingURL=index.js.map

package/dist/ui/operation/usage-tabs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/ui/operation/usage-tabs/index.tsx"],"sourcesContent":["import type { MethodInformation, RenderContext } from '@/types';\nimport type { CodeUsageGeneratorFn } from '@/requests/generators';\nimport {\n  type CodeUsageGeneratorRegistry,\n  createCodeUsageGeneratorRegistry,\n} from '@/requests/generators';\nimport {\n  CodeBlockTab,\n  CodeBlockTabs,\n  CodeBlockTabsList,\n  CodeBlockTabsTrigger,\n} from 'fumadocs-ui/components/codeblock';\nimport { UsageTabsSelectorLazy, UsageTabLazy } from './lazy';\nimport { ResponseTabs } from '../response-tabs';\nimport { registerDefault } from '@/requests/generators/all';\n\n/**\n * Generate code example for given programming language\n */\nexport interface CodeUsageGenerator<T = unknown> {\n  id: string;\n  lang: string;\n  label?: string;\n  /**\n   * either:\n   * - code\n   * - a function imported from a file with \"use client\" directive\n   * - false (disabled)\n   */\n  source?: string | CodeUsageGeneratorFn<T> | false;\n\n  /**\n   * Pass extra context to client-side source generator\n   */\n  serverContext?: T;\n}\n\nexport async function UsageTabs({\n  method,\n  ctx,\n}: {\n  method: MethodInformation;\n  ctx: RenderContext;\n}) {\n  let { renderAPIExampleUsageTabs, renderAPIExampleLayout } = ctx.content ?? {};\n\n  renderAPIExampleLayout ??= (slots) => {\n    return (\n      <div className=\"prose-no-margin\">\n        {slots.selector}\n        {slots.usageTabs}\n        {slots.responseTabs}\n      </div>\n    );\n  };\n\n  renderAPIExampleUsageTabs ??= (registry) => {\n    const map = Array.from(registry.map().entries());\n    if (map.length === 0) return null;\n\n    return (\n      <CodeBlockTabs groupId=\"fumadocs_openapi_requests\" defaultValue={map[0][0]}>\n        <CodeBlockTabsList>\n          {map.map(([id, item]) => (\n            <CodeBlockTabsTrigger key={id} value={id}>\n              {item.label ?? item.lang}\n            </CodeBlockTabsTrigger>\n          ))}\n        </CodeBlockTabsList>\n        {map.map(([id, item]) => (\n          <CodeBlockTab key={id} value={id}>\n            <UsageTabLazy id={id} lang={item.lang} _client={item._client} />\n          </CodeBlockTab>\n        ))}\n      </CodeBlockTabs>\n    );\n  };\n\n  let registry: CodeUsageGeneratorRegistry;\n  if (ctx.codeUsages) {\n    registry = createCodeUsageGeneratorRegistry(ctx.codeUsages);\n  } else {\n    registry = createCodeUsageGeneratorRegistry();\n    registerDefault(registry);\n  }\n\n  for (const gen of (await ctx.generateCodeSamples?.(method)) ?? []) {\n    registry.addInline(gen);\n  }\n\n  if (method['x-codeSamples']) {\n    for (const sample of method['x-codeSamples']) {\n      registry.addInline(sample);\n    }\n  }\n\n  return renderAPIExampleLayout(\n    {\n      selector: method['x-exclusiveCodeSample'] ? null : <UsageTabsSelectorLazy />,\n      usageTabs: await renderAPIExampleUsageTabs(registry, ctx),\n      responseTabs: <ResponseTabs operation={method} ctx={ctx} />,\n    },\n    ctx,\n  );\n}\n"],"mappings":";;;;;;;;AAqCA,eAAsB,UAAU,EAC9B,QACA,OAIC;CACD,IAAI,EAAE,2BAA2B,2BAA2B,IAAI,WAAW,EAAE;AAE7E,6BAA4B,UAAU;AACpC,SACE,qBAAC;GAAI,WAAU;;IACZ,MAAM;IACN,MAAM;IACN,MAAM;;IACH;;AAIV,gCAA+B,aAAa;EAC1C,MAAM,MAAM,MAAM,KAAK,SAAS,KAAK,CAAC,SAAS,CAAC;AAChD,MAAI,IAAI,WAAW,EAAG,QAAO;AAE7B,SACE,qBAAC;GAAc,SAAQ;GAA4B,cAAc,IAAI,GAAG;cACtE,oBAAC,+BACE,IAAI,KAAK,CAAC,IAAI,UACb,oBAAC;IAA8B,OAAO;cACnC,KAAK,SAAS,KAAK;MADK,GAEJ,CACvB,GACgB,EACnB,IAAI,KAAK,CAAC,IAAI,UACb,oBAAC;IAAsB,OAAO;cAC5B,oBAAC;KAAiB;KAAI,MAAM,KAAK;KAAM,SAAS,KAAK;MAAW;MAD/C,GAEJ,CACf;IACY;;CAIpB,IAAI;AACJ,KAAI,IAAI,WACN,YAAW,iCAAiC,IAAI,WAAW;MACtD;AACL,aAAW,kCAAkC;AAC7C,kBAAgB,SAAS;;AAG3B,MAAK,MAAM,OAAQ,MAAM,IAAI,sBAAsB,OAAO,IAAK,EAAE,CAC/D,UAAS,UAAU,IAAI;AAGzB,KAAI,OAAO,iBACT,MAAK,MAAM,UAAU,OAAO,iBAC1B,UAAS,UAAU,OAAO;AAI9B,QAAO,uBACL;EACE,UAAU,OAAO,2BAA2B,OAAO,oBAAC,0BAAwB;EAC5E,WAAW,MAAM,0BAA0B,UAAU,IAAI;EACzD,cAAc,oBAAC;GAAa,WAAW;GAAa;IAAO;EAC5D,EACD,IACD"}

package/dist/ui/operation/usage-tabs/lazy.js

@@ -8,4 +8,5 @@ const UsageTabLazy = wrapLazy(() => import("./client.js").then((mod) => ({ defau
 const UsageTabsProviderLazy = wrapLazy(() => import("./client.js").then((mod) => ({ default: mod.UsageTabsProvider })));
 
 //#endregion
-export { UsageTabLazy, UsageTabsProviderLazy, UsageTabsSelectorLazy };
+export { UsageTabLazy, UsageTabsProviderLazy, UsageTabsSelectorLazy };
+//# sourceMappingURL=lazy.js.map

package/dist/ui/operation/usage-tabs/lazy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.js","names":[],"sources":["../../../../src/ui/operation/usage-tabs/lazy.tsx"],"sourcesContent":["'use client';\nimport { wrapLazy } from '../../../utils/lazy';\n\nexport const UsageTabsSelectorLazy = wrapLazy(() =>\n  import('./client').then((mod) => ({ default: mod.UsageTabsSelector })),\n);\n\nexport const UsageTabLazy = wrapLazy(() =>\n  import('./client').then((mod) => ({ default: mod.UsageTab })),\n);\n\nexport const UsageTabsProviderLazy = wrapLazy(() =>\n  import('./client').then((mod) => ({ default: mod.UsageTabsProvider })),\n);\n"],"mappings":";;;;;AAGA,MAAa,wBAAwB,eACnC,OAAO,eAAY,MAAM,SAAS,EAAE,SAAS,IAAI,mBAAmB,EAAE,CACvE;AAED,MAAa,eAAe,eAC1B,OAAO,eAAY,MAAM,SAAS,EAAE,SAAS,IAAI,UAAU,EAAE,CAC9D;AAED,MAAa,wBAAwB,eACnC,OAAO,eAAY,MAAM,SAAS,EAAE,SAAS,IAAI,mBAAmB,EAAE,CACvE"}

package/dist/ui/schema/client.d.ts

@@ -9,4 +9,5 @@ interface SchemaUIProps {
   generated: SchemaUIGeneratedData;
 }
 //#endregion
-export { SchemaUIProps };
+export { SchemaUIProps };
+//# sourceMappingURL=client.d.ts.map

package/dist/ui/schema/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","names":[],"sources":["../../../src/ui/schema/client.tsx"],"mappings":";;;;UA4DiB,aAAA;EACf,IAAA;EACA,QAAA;EACA,EAAA;EAEA,SAAA,EAAW,qBAAA;AAAA"}

package/dist/ui/schema/client.js

@@ -337,4 +337,5 @@ function Property({ name, type, required, deprecated, nested = false, className,
 }
 
 //#endregion
-export { SchemaUI };
+export { SchemaUI };
+//# sourceMappingURL=client.js.map

package/dist/ui/schema/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":[],"sources":["../../../src/ui/schema/client.tsx"],"sourcesContent":["'use client';\nimport {\n  type ComponentProps,\n  createContext,\n  Fragment,\n  type ReactNode,\n  type RefObject,\n  Suspense,\n  use,\n  useCallback,\n  useDeferredValue,\n  useEffect,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { Tabs, TabsContent, TabsList, TabsTrigger } from 'fumadocs-ui/components/tabs';\nimport type { InfoTag, SchemaDataObjectProperty, SchemaUIGeneratedData } from '@/ui/schema';\nimport {\n  Collapsible,\n  CollapsibleContent,\n  CollapsibleTrigger,\n} from 'fumadocs-ui/components/ui/collapsible';\nimport { buttonVariants } from 'fumadocs-ui/components/ui/button';\nimport { ChevronDown, FilterIcon } from 'lucide-react';\nimport { Badge } from '@/ui/components/method-label';\nimport { Popover, PopoverContent, PopoverTrigger } from 'fumadocs-ui/components/ui/popover';\nimport { cn } from '@/utils/cn';\nimport { cva } from 'class-variance-authority';\n\ntype DataContextType = SchemaUIGeneratedData;\n\ninterface PopoverContextType {\n  renderTrigger: (props: { pathName: ReactNode; $ref: string; children: ReactNode }) => ReactNode;\n}\n\nconst typeVariants = cva('text-sm text-start text-fd-muted-foreground font-mono', {\n  variants: {\n    variant: {\n      trigger:\n        'underline hover:text-fd-accent-foreground data-[state=open]:text-fd-accent-foreground',\n    },\n  },\n});\n\nconst PopoverContext = createContext<PopoverContextType>({\n  renderTrigger: (props) => <RootPopoverTrigger {...props} />,\n});\n\nconst DataContext = createContext<DataContextType | null>(null);\n\nfunction useData() {\n  return use(DataContext)!;\n}\n\nfunction usePopover() {\n  return use(PopoverContext);\n}\n\nexport interface SchemaUIProps {\n  name: string;\n  required?: boolean;\n  as?: 'property' | 'body';\n\n  generated: SchemaUIGeneratedData;\n}\n\nexport function SchemaUI({ name, required = false, as = 'property', generated }: SchemaUIProps) {\n  return (\n    <DataContext value={generated}>\n      <SchemaUIProperty\n        name={name}\n        $type={generated.$root}\n        overrides={{\n          required,\n        }}\n        variant={\n          as === 'property' || generated.refs[generated.$root].type === 'primitive'\n            ? 'default'\n            : 'expand'\n        }\n      />\n    </DataContext>\n  );\n}\n\nfunction SchemaUIProperty({\n  name,\n  $type,\n  variant = 'default',\n  overrides,\n  objectSearchOverrides,\n}: {\n  name: ReactNode;\n  $type: string;\n  variant?: 'default' | 'expand';\n  overrides?: Partial<PropertyProps>;\n  objectSearchOverrides?: Partial<ObjectSearchProps>;\n}) {\n  const { refs } = useData();\n  const schema = refs[$type];\n  const renderRef = useRenderRef();\n  let type: ReactNode = schema.typeName;\n\n  if ((schema.type === 'or' || schema.type === 'and') && schema.items.length > 0) {\n    if (variant === 'expand')\n      return (\n        <Tabs defaultValue={schema.items[0].$type}>\n          <TabsList>\n            {schema.items.map((item) => (\n              <TabsTrigger key={item.$type} value={item.$type}>\n                {item.name}\n              </TabsTrigger>\n            ))}\n          </TabsList>\n          {schema.items.map((item) => (\n            <TabsContent\n              key={item.$type}\n              value={item.$type}\n              forceMount={undefined}\n              className=\"pt-2 pb-0\"\n            >\n              <SchemaUIProperty {...item} variant=\"expand\" />\n            </TabsContent>\n          ))}\n        </Tabs>\n      );\n    type = renderRef({\n      pathName: name,\n      $ref: $type,\n    });\n  } else if (schema.type === 'object' && schema.props.length > 0) {\n    if (variant === 'expand')\n      return <ObjectSearch properties={schema.props} {...objectSearchOverrides} />;\n\n    type = renderRef({\n      pathName: name,\n      $ref: $type,\n    });\n  } else if (schema.type === 'array') {\n    if (variant === 'expand')\n      return (\n        <Collapsible className=\"my-2\">\n          <CollapsibleTrigger\n            className={cn(\n              buttonVariants({ color: 'secondary', size: 'sm' }),\n              'group px-3 py-2 data-[state=open]:rounded-b-none',\n            )}\n          >\n            Array Item\n            <ChevronDown className=\"size-4 text-fd-muted-foreground group-data-[state=open]:rotate-180\" />\n          </CollapsibleTrigger>\n          <CollapsibleContent className=\"-mt-px bg-fd-card px-3 rounded-lg rounded-tl-none border shadow-sm\">\n            <SchemaUIProperty name=\"\" $type={schema.item.$type} variant=\"expand\" />\n          </CollapsibleContent>\n        </Collapsible>\n      );\n\n    type = renderRef({\n      pathName: name,\n      $ref: $type,\n    });\n  }\n\n  const child = (\n    <>\n      {schema.description}\n      {schema.infoTags && schema.infoTags.length > 0 && (\n        <div className=\"flex flex-row gap-2 flex-wrap my-2 not-prose empty:hidden\">\n          {schema.infoTags.map((tag) => (\n            <InfoTag key={tag.label} tag={tag} />\n          ))}\n        </div>\n      )}\n    </>\n  );\n  if (variant === 'expand') return child;\n  return (\n    <Property name={name} type={type} deprecated={schema.deprecated} {...overrides}>\n      {child}\n    </Property>\n  );\n}\n\ninterface ObjectSearchProps {\n  properties: SchemaDataObjectProperty[];\n  container?: ComponentProps<'div'>;\n  open?: (item: SchemaDataObjectProperty) => void;\n}\n\nfunction ObjectSearch({ properties, container, open }: ObjectSearchProps) {\n  const [search, setSearch] = useState('');\n  const deferredValue = useDeferredValue(search);\n  const firstItemRef = useRef<SchemaDataObjectProperty>(null);\n  const prevProperties = useRef(properties);\n\n  if (prevProperties.current !== properties) {\n    prevProperties.current = properties;\n    setSearch('');\n  }\n\n  return (\n    <>\n      <div\n        {...container}\n        className={cn(\n          'flex items-center border my-2 rounded-md bg-fd-secondary text-fd-secondary-foreground transition-colors shadow-sm focus-within:ring-2 focus-within:ring-fd-ring',\n          container?.className,\n        )}\n      >\n        <FilterIcon className=\"text-fd-muted-foreground ms-2 size-3.5\" />\n        <input\n          value={search}\n          data-object-search-input=\"\"\n          onChange={(e) => setSearch(e.target.value)}\n          placeholder=\"Filter Properties\"\n          className=\"text-sm ps-2 py-2 flex-1 outline-none placeholder:text-fd-muted-foreground\"\n          onKeyDown={(e) => {\n            if (e.key === 'Enter' && open) {\n              if (firstItemRef.current) open(firstItemRef.current);\n              e.preventDefault();\n            }\n          }}\n        />\n      </div>\n      <Suspense>\n        <ObjectSearchContent\n          search={deferredValue}\n          properties={properties}\n          firstItemRef={firstItemRef}\n        />\n      </Suspense>\n    </>\n  );\n}\n\nfunction ObjectSearchContent({\n  search: rawSearch,\n  firstItemRef,\n  properties,\n}: {\n  search: string;\n  firstItemRef: RefObject<SchemaDataObjectProperty | null>;\n  properties: SchemaDataObjectProperty[];\n}) {\n  const filtered = useMemo(() => {\n    const search = rawSearch.trim().toLowerCase();\n    return search.length > 0\n      ? properties.filter((prop) => prop.name.toLowerCase().includes(search))\n      : properties;\n  }, [properties, rawSearch]);\n\n  firstItemRef.current = filtered.length > 0 ? filtered[0] : null;\n\n  if (filtered.length === 0)\n    return (\n      <p className=\"text-fd-muted-foreground text-sm px-2\">\n        No property matching{' '}\n        <span className=\"text-fd-foreground font-medium\">{`\"${rawSearch}\"`}</span>\n      </p>\n    );\n\n  return filtered.map((prop) => (\n    <SchemaUIProperty\n      key={prop.name}\n      name={prop.name}\n      $type={prop.$type}\n      overrides={{ required: prop.required }}\n    />\n  ));\n}\n\nfunction InfoTag({ tag }: { tag: InfoTag }) {\n  const ref = useRef<HTMLElement>(null);\n  const [isTruncated, setTruncated] = useState(false);\n  const [open, setOpen] = useState(false);\n  useEffect(() => {\n    const element = ref.current;\n    if (!element) return;\n    // assume the tag width will never change\n    setTruncated(element.scrollWidth !== element.offsetWidth);\n  }, []);\n\n  return (\n    <div className=\"flex flex-row items-start gap-2 bg-fd-secondary border rounded-lg text-xs p-1.5 shadow-md max-w-full\">\n      <span className=\"font-medium\">{tag.label}</span>\n      <code\n        ref={ref}\n        className={cn(\n          'min-w-0 flex-1 text-fd-muted-foreground',\n          open ? 'wrap-break-word' : 'truncate',\n        )}\n      >\n        {tag.value}\n      </code>\n      {isTruncated && (\n        <button\n          className={cn(buttonVariants({ size: 'icon-xs', variant: 'ghost' }))}\n          onClick={() => setOpen((prev) => !prev)}\n        >\n          <ChevronDown />\n        </button>\n      )}\n    </div>\n  );\n}\n\ninterface PathItemType {\n  name: ReactNode;\n  $ref?: string;\n  scrollTop?: number;\n}\n\nfunction SchemaUIPopover({\n  containerRef,\n  initialPath,\n}: {\n  containerRef: RefObject<HTMLDivElement | null>;\n  initialPath: PathItemType[];\n}) {\n  const [path, setPath] = useState(initialPath);\n\n  useLayoutEffect(() => {\n    const last = path[0];\n    const element = containerRef.current;\n    if (!element || !last || !element.parentElement) return;\n\n    // recover scroll\n    element.parentElement.scrollTop = last.scrollTop ?? 0;\n    return () => {\n      if (element.parentElement) last.scrollTop = element.parentElement.scrollTop;\n    };\n  }, [containerRef, path]);\n\n  const context: PopoverContextType = useMemo(\n    () => ({\n      renderTrigger: ({ $ref, pathName, children }) => (\n        <button\n          className={cn(typeVariants({ variant: 'trigger' }))}\n          onClick={() => setPath((path) => [...path, { name: pathName, $ref }])}\n        >\n          {children}\n        </button>\n      ),\n    }),\n    [],\n  );\n\n  const currentRef = path.findLast((item) => item.$ref !== undefined);\n\n  return (\n    <>\n      <div className=\"sticky top-0 -mx-2 flex flex-row flex-wrap items-center text-sm font-medium font-mono bg-fd-popover px-2 h-8 border-b\">\n        {path.map((item, i) => {\n          const isDuplicated = path.some((other, j) => j < i && other.$ref === item.$ref);\n          const className = cn(\n            isDuplicated && 'text-orange-400',\n            item.$ref && 'hover:underline hover:text-fd-accent-foreground',\n          );\n          const node = item.$ref ? (\n            <button onClick={() => setPath((path) => path.slice(0, i + 1))} className={className}>\n              {item.name}\n            </button>\n          ) : (\n            <span className={className}>{item.name}</span>\n          );\n\n          return (\n            <Fragment key={i}>\n              {i > 0 && '.'}\n              {node}\n            </Fragment>\n          );\n        })}\n      </div>\n      <PopoverContext value={context}>\n        {currentRef?.$ref && (\n          <SchemaUIProperty\n            name=\"\"\n            $type={currentRef.$ref}\n            variant=\"expand\"\n            objectSearchOverrides={{\n              container: {\n                className: 'sticky top-10',\n              },\n              open(item) {\n                setPath((path) => [...path, { name: item.name, $ref: item.$type }]);\n              },\n            }}\n          />\n        )}\n      </PopoverContext>\n    </>\n  );\n}\n\nfunction useRenderRef() {\n  const { refs } = useData();\n  const { renderTrigger } = usePopover();\n  return function renderRef({\n    pathName,\n    $ref,\n    text,\n  }: {\n    pathName: ReactNode;\n    $ref: string;\n    text?: ReactNode;\n  }) {\n    const schema = refs[$ref];\n\n    if (schema.type === 'and' || schema.type === 'or') {\n      const sep = schema.type === 'and' ? '&' : '|';\n      return (\n        <span className={cn(typeVariants(), 'flex flex-row gap-2 items-center flex-wrap')}>\n          {schema.items.map((item, i) => (\n            <Fragment key={item.$type}>\n              {i > 0 && <span>{sep}</span>}\n              {renderRef({ pathName, text: item.name, $ref: item.$type })}\n            </Fragment>\n          ))}\n        </span>\n      );\n    }\n\n    if (schema.type === 'array') {\n      return (\n        <span className={cn(typeVariants(), 'flex flex-row items-center flex-wrap')}>\n          {'array<'}\n          {renderRef({ pathName: <>{pathName}[]</>, $ref: schema.item.$type })}\n          {'>'}\n        </span>\n      );\n    }\n\n    return renderTrigger({ $ref, pathName, children: text ?? schema.aliasName });\n  };\n}\n\nfunction RootPopoverTrigger({\n  $ref,\n  pathName,\n  children,\n}: {\n  pathName: ReactNode;\n  $ref: string;\n  children: ReactNode;\n}) {\n  const ref = useRef<HTMLDivElement>(null);\n  const refCallback = useCallback((element: HTMLDivElement | null) => {\n    ref.current = element;\n    if (!element || element.style.getPropertyValue('--initial-height')) return;\n\n    element.style.setProperty('--initial-height', `${element.clientHeight + 2}px`);\n  }, []);\n\n  return (\n    <Popover>\n      <PopoverTrigger className={cn(typeVariants({ variant: 'trigger' }))}>\n        {children}\n      </PopoverTrigger>\n      <PopoverContent\n        ref={refCallback}\n        onOpenAutoFocus={(e) => {\n          if (!ref.current) return;\n          const input = ref.current.querySelector('input[data-object-search-input]');\n          if (!(input instanceof HTMLInputElement)) return;\n          input.focus({ preventScroll: true });\n          e.preventDefault();\n        }}\n        className=\"w-[600px] min-h-(--initial-height,0) max-h-[460px] px-2 py-0\"\n      >\n        <SchemaUIPopover\n          containerRef={ref}\n          initialPath={[\n            {\n              name: pathName,\n              $ref: $ref,\n            },\n          ]}\n        />\n      </PopoverContent>\n    </Popover>\n  );\n}\n\ninterface PropertyProps {\n  name: ReactNode;\n  type: ReactNode;\n  required?: boolean;\n  deprecated?: boolean;\n  nested?: boolean;\n\n  children?: ReactNode;\n  className?: string;\n}\n\nfunction Property({\n  name,\n  type,\n  required,\n  deprecated,\n  nested = false,\n  className,\n  ...props\n}: PropertyProps) {\n  return (\n    <div\n      className={cn(\n        'text-sm border-t',\n        nested\n          ? 'p-3 border-x bg-fd-card last:rounded-b-xl first:rounded-tr-xl last:border-b'\n          : 'py-4 first:border-t-0',\n        className,\n      )}\n    >\n      <div className=\"flex flex-wrap items-center gap-3 not-prose\">\n        <span className=\"font-medium font-mono text-fd-primary\">\n          {name}\n          {required ? (\n            <span className=\"text-red-400\">*</span>\n          ) : (\n            <span className=\"text-fd-muted-foreground\">?</span>\n          )}\n        </span>\n        {typeof type === 'string' ? (\n          <span className=\"text-sm font-mono text-fd-muted-foreground\">{type}</span>\n        ) : (\n          type\n        )}\n        {deprecated && (\n          <Badge color=\"yellow\" className=\"ms-auto text-xs\">\n            Deprecated\n          </Badge>\n        )}\n      </div>\n      <div className=\"prose-no-margin pt-2.5 empty:hidden\">{props.children}</div>\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/ui/schema/index.d.ts

@@ -61,4 +61,5 @@ interface SchemaUIGeneratedData {
   refs: Record<string, SchemaData>;
 }
 //#endregion
-export { SchemaUIGeneratedData, SchemaUIOptions };
+export { SchemaUIGeneratedData, SchemaUIOptions };
+//# sourceMappingURL=index.d.ts.map

package/dist/ui/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/ui/schema/index.tsx"],"mappings":";;;;;;;UAQiB,SAAA;EACf,WAAA,GAAc,SAAA;EACd,QAAA,GAAW,OAAA;EAEX,QAAA;EACA,SAAA;EAEA,UAAA;AAAA;AAAA,UAGe,OAAA;EACf,KAAA;EACA,KAAA;AAAA;AAAA,UAGe,wBAAA;EACf,IAAA;EACA,KAAA;EACA,QAAA;AAAA;AAAA,KAGU,UAAA,GAAa,SAAA;EAGjB,IAAA;AAAA;EAGA,IAAA;EACA,KAAA,EAAO,wBAAA;AAAA;EAGP,IAAA;EACA,IAAA;IACE,KAAA;EAAA;AAAA;EAIF,IAAA;EACA,KAAA;IACE,IAAA;IACA,KAAA;EAAA;AAAA;EAIF,IAAA;EACA,KAAA;IACE,IAAA;IACA,KAAA;EAAA;AAAA;AAAA,UAKO,eAAA;EACf,IAAA,EAAM,cAAA;EACN,MAAA,EAAQ,IAAA,CAAK,aAAA;EAjBP;;;EAsBN,QAAA;EAfM;;;EAmBN,SAAA;AAAA;AAAA,UAGe,qBAAA;EACf,KAAA;EACA,IAAA,EAAM,MAAA,SAAe,UAAA;AAAA"}

package/dist/ui/schema/index.js

@@ -243,4 +243,5 @@ function formatRange(value, min, exclusiveMin, max, exclusiveMax) {
 }
 
 //#endregion
-export { Schema };
+export { Schema };
+//# sourceMappingURL=index.js.map

package/dist/ui/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/ui/schema/index.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\nimport type { ResolvedSchema } from '@/utils/schema';\nimport type { RenderContext } from '@/types';\nimport { FormatFlags, schemaToString } from '@/utils/schema-to-string';\nimport { mergeAllOf } from '@/utils/merge-schema';\nimport type { SchemaUIProps } from '@/ui/schema/client';\nimport { SchemaUILazy } from '@/ui/schema/lazy';\n\nexport interface FieldBase {\n  description?: ReactNode;\n  infoTags?: InfoTag[];\n\n  typeName: string;\n  aliasName: string;\n\n  deprecated?: boolean;\n}\n\nexport interface InfoTag {\n  label: string;\n  value: string;\n}\n\nexport interface SchemaDataObjectProperty {\n  name: string;\n  $type: string;\n  required: boolean;\n}\n\nexport type SchemaData = FieldBase &\n  (\n    | {\n        type: 'primitive';\n      }\n    | {\n        type: 'object';\n        props: SchemaDataObjectProperty[];\n      }\n    | {\n        type: 'array';\n        item: {\n          $type: string;\n        };\n      }\n    | {\n        type: 'or';\n        items: {\n          name: string;\n          $type: string;\n        }[];\n      }\n    | {\n        type: 'and';\n        items: {\n          name: string;\n          $type: string;\n        }[];\n      }\n  );\n\nexport interface SchemaUIOptions {\n  root: ResolvedSchema;\n  client: Omit<SchemaUIProps, 'generated'>;\n\n  /**\n   * include read only props\n   */\n  readOnly?: boolean;\n  /**\n   * include write only props\n   */\n  writeOnly?: boolean;\n}\n\nexport interface SchemaUIGeneratedData {\n  $root: string;\n  refs: Record<string, SchemaData>;\n}\n\nexport function Schema({\n  ctx,\n  ...options\n}: SchemaUIOptions & {\n  ctx: RenderContext;\n}) {\n  if (ctx.schemaUI?.render) {\n    return ctx.schemaUI.render(options, ctx);\n  }\n\n  return <SchemaUILazy {...options.client} generated={generateSchemaUI(options, ctx)} />;\n}\n\nexport function generateSchemaUI(\n  { root, readOnly, writeOnly }: SchemaUIOptions,\n  ctx: RenderContext,\n): SchemaUIGeneratedData {\n  const refs: Record<string, SchemaData> = {};\n  const { showExample = false } = ctx.schemaUI ?? {};\n\n  function generateInfoTags(schema: Exclude<ResolvedSchema, boolean>) {\n    const fields: InfoTag[] = [];\n\n    if (schema.default !== undefined) {\n      fields.push({ label: 'Default', value: JSON.stringify(schema.default) });\n    }\n\n    if (schema.pattern) {\n      fields.push({ label: 'Match', value: schema.pattern });\n    }\n\n    if (schema.format) {\n      fields.push({ label: 'Format', value: schema.format });\n    }\n\n    if (schema.multipleOf) {\n      fields.push({ label: 'Multiple Of', value: schema.multipleOf.toString() });\n    }\n\n    let range = formatRange(\n      'value',\n      schema.minimum,\n      schema.exclusiveMinimum,\n      schema.maximum,\n      schema.exclusiveMaximum,\n    );\n    if (range) fields.push({ label: 'Range', value: range });\n\n    range = formatRange('length', schema.minLength, undefined, schema.maxLength, undefined);\n    if (range) fields.push({ label: 'Length', value: range });\n\n    range = formatRange(\n      'properties',\n      schema.minProperties,\n      undefined,\n      schema.maxProperties,\n      undefined,\n    );\n    if (range) fields.push({ label: 'Properties', value: range });\n\n    range = formatRange('items', schema.minItems, undefined, schema.maxItems, undefined);\n    if (range) fields.push({ label: 'Items', value: range });\n\n    if (schema.enum) {\n      fields.push({\n        label: 'Value in',\n        value: schema.enum.map((value) => JSON.stringify(value)).join(' | '),\n      });\n    }\n\n    if (showExample && schema.examples) {\n      for (const example of schema.examples) {\n        fields.push({ label: 'Example', value: JSON.stringify(example, null, 2) });\n      }\n    }\n\n    return fields;\n  }\n\n  let _counter = 0;\n  const autoIds = new WeakMap<Exclude<ResolvedSchema, boolean>, string>();\n  function getSchemaId(schema: ResolvedSchema): string {\n    if (typeof schema === 'boolean') return String(schema);\n    const raw = ctx.schema.getRawRef(schema);\n    if (raw) return raw;\n\n    const prev = autoIds.get(schema);\n    if (prev) return prev;\n\n    const generated = `__${_counter++}`;\n    autoIds.set(schema, generated);\n    return generated;\n  }\n\n  function isVisible(schema: ResolvedSchema): boolean {\n    if (typeof schema === 'boolean') return true;\n    if (schema.writeOnly) return writeOnly ?? false;\n    if (schema.readOnly) return readOnly ?? false;\n    return true;\n  }\n\n  function base(schema: ResolvedSchema): FieldBase {\n    if (typeof schema === 'boolean') {\n      const name = schema ? 'any' : 'never';\n      return {\n        typeName: name,\n        aliasName: name,\n      };\n    }\n\n    return {\n      description: schema.description && ctx.renderMarkdown(schema.description),\n      infoTags: generateInfoTags(schema),\n      typeName: schemaToString(schema, ctx.schema),\n      aliasName: schemaToString(schema, ctx.schema, FormatFlags.UseAlias),\n      deprecated: schema.deprecated,\n    };\n  }\n\n  function scanRefs(id: string, schema: ResolvedSchema) {\n    if (id in refs) return;\n    if (typeof schema === 'boolean') {\n      refs[id] = {\n        type: 'primitive',\n        ...base(schema),\n      };\n      return;\n    }\n\n    if (Array.isArray(schema.type)) {\n      const out: SchemaData = {\n        type: 'or',\n        items: [],\n        ...base(schema),\n      };\n      refs[id] = out;\n\n      for (const type of schema.type) {\n        const key = `${id}_type:${type}`;\n        scanRefs(key, {\n          ...schema,\n          type,\n        });\n        out.items.push({\n          name: type,\n          $type: key,\n        });\n      }\n      return;\n    }\n\n    if (schema.oneOf && schema.anyOf) {\n      const out: SchemaData = {\n        type: 'and',\n        items: [],\n        ...base(schema),\n      };\n      refs[id] = out;\n      for (const omit of ['anyOf', 'oneOf'] as const) {\n        const $type = `${id}_omit:${omit}`;\n        scanRefs($type, { ...schema, [omit]: undefined });\n\n        out.items.push({\n          name: refs[$type].aliasName,\n          $type,\n        });\n      }\n      return;\n    }\n\n    // display both `oneOf` & `anyOf` as OR for simplified overview\n    const union = schema.oneOf ?? schema.anyOf;\n    if (union) {\n      const out: SchemaData = {\n        type: 'or',\n        items: [],\n        ...base(schema),\n      };\n      refs[id] = out;\n\n      for (const item of union) {\n        if (!item || typeof item !== 'object' || !isVisible(item)) continue;\n        const itemId = getSchemaId(item);\n        const key = `${id}_extends:${itemId}`;\n\n        scanRefs(key, {\n          ...schema,\n          oneOf: undefined,\n          anyOf: undefined,\n          ...item,\n          properties: {\n            ...schema.properties,\n            ...item.properties,\n          },\n        });\n        out.items.push({\n          $type: key,\n          name: refs[itemId]?.aliasName ?? schemaToString(item, ctx.schema, FormatFlags.UseAlias),\n        });\n      }\n      return;\n    }\n\n    if (schema.allOf) {\n      scanRefs(id, mergeAllOf(schema));\n      return;\n    }\n\n    if (schema.type === 'object') {\n      const out: SchemaData = {\n        type: 'object',\n        props: [],\n        ...base(schema),\n      };\n      refs[id] = out;\n\n      const { properties = {}, patternProperties, additionalProperties } = schema;\n      const props = Object.entries(properties);\n      if (patternProperties) props.push(...Object.entries(patternProperties));\n\n      for (const [key, prop] of props) {\n        if (!prop || !isVisible(prop)) continue;\n        const $type = getSchemaId(prop);\n        scanRefs($type, prop);\n        out.props.push({\n          $type,\n          name: key,\n          required: schema.required?.includes(key) ?? false,\n        });\n      }\n\n      if (additionalProperties && isVisible(additionalProperties)) {\n        const $type = getSchemaId(additionalProperties);\n        scanRefs($type, additionalProperties);\n\n        out.props.push({\n          $type,\n          name: '[key: string]',\n          required: false,\n        });\n      }\n      return;\n    }\n\n    if (schema.type === 'array') {\n      const items = schema.items ?? true;\n      const $type = getSchemaId(items);\n\n      refs[id] = {\n        type: 'array',\n        item: {\n          $type,\n        },\n        ...base(schema),\n      };\n      scanRefs($type, items);\n      return;\n    }\n\n    refs[id] = {\n      type: 'primitive',\n      ...base(schema),\n    };\n  }\n\n  const $root = getSchemaId(root);\n  scanRefs($root, root);\n  return {\n    refs,\n    $root,\n  };\n}\n\nfunction formatRange(\n  value: string,\n  min: number | undefined,\n  exclusiveMin: number | undefined,\n  max: number | undefined,\n  exclusiveMax: number | undefined,\n) {\n  const out: string[] = [];\n  if (min !== undefined) {\n    out.push(`${min} <=`);\n  } else if (exclusiveMin !== undefined) {\n    out.push(`${exclusiveMin} <`);\n  }\n\n  out.push(value);\n  if (max !== undefined) {\n    out.push(`<= ${max}`);\n  } else if (exclusiveMax !== undefined) {\n    out.push(`< ${exclusiveMax}`);\n  }\n  if (out.length > 1) return out.join(' ');\n}\n"],"mappings":"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"}

package/dist/ui/schema/lazy.js

@@ -6,4 +6,5 @@ import { wrapLazy } from "../../utils/lazy.js";
 const SchemaUILazy = wrapLazy(() => import("./client.js").then((mod) => ({ default: mod.SchemaUI })));
 
 //#endregion
-export { SchemaUILazy };
+export { SchemaUILazy };
+//# sourceMappingURL=lazy.js.map

package/dist/ui/schema/lazy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.js","names":[],"sources":["../../../src/ui/schema/lazy.ts"],"sourcesContent":["'use client';\nimport { wrapLazy } from '../../utils/lazy';\n\nexport const SchemaUILazy = wrapLazy(() =>\n  import('./client').then((mod) => ({ default: mod.SchemaUI })),\n);\n"],"mappings":";;;;;AAGA,MAAa,eAAe,eAC1B,OAAO,eAAY,MAAM,SAAS,EAAE,SAAS,IAAI,UAAU,EAAE,CAC9D"}

package/dist/utils/deep-equal.js

@@ -15,4 +15,5 @@ function deepEqual(a, b) {
 }
 
 //#endregion
-export { deepEqual };
+export { deepEqual };
+//# sourceMappingURL=deep-equal.js.map

package/dist/utils/deep-equal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-equal.js","names":[],"sources":["../../src/utils/deep-equal.ts"],"sourcesContent":["export function deepEqual(a: unknown, b: unknown): boolean {\n  if (a === b) {\n    return true;\n  }\n\n  if (a == null || b == null) {\n    return false;\n  }\n\n  if (typeof a !== 'object' || typeof b !== 'object') {\n    return false;\n  }\n\n  if (Array.isArray(a) && Array.isArray(b)) {\n    if (a.length !== b.length) {\n      return false;\n    }\n    return a.every((item, index) => deepEqual(item, b[index]));\n  }\n\n  if (Array.isArray(a) || Array.isArray(b)) {\n    return false;\n  }\n\n  const keysA = Object.keys(a as object);\n  const keysB = Object.keys(b as object);\n\n  if (keysA.length !== keysB.length) {\n    return false;\n  }\n\n  return keysA.every(\n    (key) =>\n      Object.prototype.hasOwnProperty.call(b, key) &&\n      deepEqual((a as Record<string, unknown>)[key], (b as Record<string, unknown>)[key]),\n  );\n}\n"],"mappings":";AAAA,SAAgB,UAAU,GAAY,GAAqB;AACzD,KAAI,MAAM,EACR,QAAO;AAGT,KAAI,KAAK,QAAQ,KAAK,KACpB,QAAO;AAGT,KAAI,OAAO,MAAM,YAAY,OAAO,MAAM,SACxC,QAAO;AAGT,KAAI,MAAM,QAAQ,EAAE,IAAI,MAAM,QAAQ,EAAE,EAAE;AACxC,MAAI,EAAE,WAAW,EAAE,OACjB,QAAO;AAET,SAAO,EAAE,OAAO,MAAM,UAAU,UAAU,MAAM,EAAE,OAAO,CAAC;;AAG5D,KAAI,MAAM,QAAQ,EAAE,IAAI,MAAM,QAAQ,EAAE,CACtC,QAAO;CAGT,MAAM,QAAQ,OAAO,KAAK,EAAY;CACtC,MAAM,QAAQ,OAAO,KAAK,EAAY;AAEtC,KAAI,MAAM,WAAW,MAAM,OACzB,QAAO;AAGT,QAAO,MAAM,OACV,QACC,OAAO,UAAU,eAAe,KAAK,GAAG,IAAI,IAC5C,UAAW,EAA8B,MAAO,EAA8B,KAAK,CACtF"}

package/dist/utils/id-to-title.js

@@ -10,4 +10,5 @@ function idToTitle(id) {
 }
 
 //#endregion
-export { idToTitle };
+export { idToTitle };
+//# sourceMappingURL=id-to-title.js.map

package/dist/utils/id-to-title.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-to-title.js","names":[],"sources":["../../src/utils/id-to-title.ts"],"sourcesContent":["export function idToTitle(id: string): string {\n  let result: string[] = [];\n\n  for (const c of id) {\n    if (result.length === 0) result.push(c.toLocaleUpperCase());\n    // ignore the other parts surrounded with '.', like 'migrations.dev' -> 'dev'\n    else if (c === '.') result = [];\n    else if (/^[A-Z]$/.test(c) && result.at(-1) !== ' ') result.push(' ', c);\n    else if (c === '-') result.push(' ');\n    else result.push(c);\n  }\n\n  return result.join('');\n}\n"],"mappings":";AAAA,SAAgB,UAAU,IAAoB;CAC5C,IAAI,SAAmB,EAAE;AAEzB,MAAK,MAAM,KAAK,GACd,KAAI,OAAO,WAAW,EAAG,QAAO,KAAK,EAAE,mBAAmB,CAAC;UAElD,MAAM,IAAK,UAAS,EAAE;UACtB,UAAU,KAAK,EAAE,IAAI,OAAO,GAAG,GAAG,KAAK,IAAK,QAAO,KAAK,KAAK,EAAE;UAC/D,MAAM,IAAK,QAAO,KAAK,IAAI;KAC/B,QAAO,KAAK,EAAE;AAGrB,QAAO,OAAO,KAAK,GAAG"}

package/dist/utils/lazy.js

@@ -10,4 +10,5 @@ function wrapLazy(load) {
 }
 
 //#endregion
-export { wrapLazy };
+export { wrapLazy };
+//# sourceMappingURL=lazy.js.map

package/dist/utils/lazy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.js","names":[],"sources":["../../src/utils/lazy.tsx"],"sourcesContent":["import { type ComponentType, lazy } from 'react';\n\n// Waku wraps all export functions of a \"use client\" file in `React.lazy`, but `lazy(lazy(() => ...))` causes error.\n// we wrap another layer of component such that it is valid\n// TODO: perhaps we can remove it once Waku migrated to vite-rsc\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- type infer\nexport function wrapLazy<T extends ComponentType<any>>(load: () => Promise<{ default: T }>): T {\n  const V = lazy(load);\n\n  return function wrapper(props) {\n    return <V {...props} />;\n  } as T;\n}\n"],"mappings":";;;;AAMA,SAAgB,SAAuC,MAAwC;CAC7F,MAAM,IAAI,KAAK,KAAK;AAEpB,QAAO,SAAS,QAAQ,OAAO;AAC7B,SAAO,oBAAC,KAAE,GAAI,QAAS"}

package/dist/utils/merge-schema.js

@@ -20,6 +20,16 @@ function intersection(a, b, options) {
 	if (typeof a === "boolean" && typeof b === "boolean") return a && b;
 	if (typeof a === "boolean") return a;
 	if (typeof b === "boolean") return b;
+	for (const unionField of ["anyOf", "oneOf"]) {
+		if (a[unionField] === void 0 && b[unionField] !== void 0) return {
+			...b,
+			[unionField]: b[unionField].map((item) => intersection(item, a, options))
+		};
+		if (a[unionField] !== void 0 && b[unionField] === void 0) return {
+			...a,
+			[unionField]: a[unionField].map((item) => intersection(item, b, options))
+		};
+	}
 	const result = { ...a };
 	for (const _k in b) {
 		const key = _k;
@@ -27,7 +37,6 @@ function intersection(a, b, options) {
 			case "$id":
 			case "$comment":
 			case "description":
-			case "additionalItems":
 			case "examples":
 			case "allOf":
 			case "writeOnly":
@@ -61,14 +70,18 @@ function intersection(a, b, options) {
 				result[key] = result[key] === void 0 ? value : Math.min(result[key], value);
 				break;
 			}
-			case "enum":
-			case "anyOf":
-			case "oneOf": {
+			case "enum": {
 				const value = b[key];
 				if (value === void 0) break;
 				result[key] = result[key] === void 0 ? value : intersectArray(result[key], value);
 				break;
 			}
+			case "anyOf":
+			case "oneOf": {
+				const value = b[key];
+				if (value !== void 0 && result[key] !== void 0) result[key] = intersectArray(result[key], value);
+				break;
+			}
 			case "format":
 			case "const":
 			case "type": {
@@ -107,6 +120,7 @@ function intersection(a, b, options) {
 				break;
 			}
 			case "additionalProperties":
+			case "additionalItems":
 			case "contains":
 			case "items": {
 				const value = b[key];
@@ -134,4 +148,5 @@ function intersectArray(a, b) {
 }
 
 //#endregion
-export { mergeAllOf };
+export { mergeAllOf };
+//# sourceMappingURL=merge-schema.js.map

package/dist/utils/merge-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-schema.js","names":[],"sources":["../../src/utils/merge-schema.ts"],"sourcesContent":["import { type ParsedSchema } from '@/utils/schema';\nimport { deepEqual } from './deep-equal';\n\ninterface Options {\n  dereference?: (schema: ParsedSchema) => ParsedSchema | undefined;\n}\n\n/**\n * Merge `allOf` object schema\n */\nexport function mergeAllOf(schema: ParsedSchema, options: Options = {}): ParsedSchema {\n  if (typeof schema === 'boolean') return schema;\n\n  const { dereference } = options;\n  if (dereference && '$ref' in schema && typeof schema.$ref === 'string') {\n    schema = dereference(schema) ?? schema;\n  }\n\n  if (typeof schema === 'boolean' || !schema.allOf) return schema;\n\n  const { allOf, ...rest } = schema;\n  let result: ParsedSchema = rest;\n  for (const item of allOf) {\n    result = intersection(result, item, options);\n  }\n  return result;\n}\n\nfunction intersection(a: ParsedSchema, b: ParsedSchema, options: Options): ParsedSchema {\n  a = mergeAllOf(a, options);\n  b = mergeAllOf(b, options);\n  if (typeof a === 'boolean' && typeof b === 'boolean') return a && b;\n  if (typeof a === 'boolean') return a;\n  if (typeof b === 'boolean') return b;\n\n  for (const unionField of ['anyOf', 'oneOf'] as const) {\n    if (a[unionField] === undefined && b[unionField] !== undefined) {\n      return {\n        ...b,\n        [unionField]: b[unionField].map((item) => intersection(item, a, options)),\n      };\n    }\n    if (a[unionField] !== undefined && b[unionField] === undefined) {\n      return {\n        ...a,\n        [unionField]: a[unionField].map((item) => intersection(item, b, options)),\n      };\n    }\n  }\n\n  const result: ParsedSchema = { ...a };\n  for (const _k in b) {\n    const key = _k as keyof typeof b;\n\n    switch (key) {\n      case '$id':\n      case '$comment':\n      case 'description':\n      case 'examples':\n      case 'allOf':\n      case 'writeOnly':\n      case 'readOnly':\n        // ignored\n        break;\n      case 'title': {\n        const value = b[key];\n        if (value === undefined) break;\n        if (result[key]) {\n          result[key] = `${result[key]} & ${value}`;\n        } else {\n          result[key] = value;\n        }\n        break;\n      }\n      case 'minItems':\n      case 'minimum':\n      case 'exclusiveMinimum':\n      case 'minProperties':\n      case 'minContains':\n      case 'minLength': {\n        const value = b[key];\n        if (value === undefined) break;\n        result[key] = result[key] === undefined ? value : Math.max(result[key], value);\n        break;\n      }\n      case 'maxContains':\n      case 'maxItems':\n      case 'maxLength':\n      case 'maxProperties':\n      case 'maximum':\n      case 'exclusiveMaximum': {\n        const value = b[key];\n        if (value === undefined) break;\n        result[key] = result[key] === undefined ? value : Math.min(result[key], value);\n        break;\n      }\n      case 'enum': {\n        const value = b[key];\n        if (value === undefined) break;\n\n        result[key] = result[key] === undefined ? value : intersectArray(result[key], value);\n        break;\n      }\n      case 'anyOf':\n      case 'oneOf': {\n        const value = b[key];\n        if (value !== undefined && result[key] !== undefined) {\n          result[key] = intersectArray(result[key], value);\n        }\n        break;\n      }\n      // require same\n      case 'format':\n      case 'const':\n      case 'type': {\n        const value = b[key];\n        if (value === undefined) break;\n        result[key] ??= value;\n\n        if (!deepEqual(result[key], value)) return false;\n        break;\n      }\n      // add\n      case 'required': {\n        const value = b[key];\n        if (value === undefined) break;\n        result[key] = [...(result[key] ?? []), ...value];\n        break;\n      }\n      case 'properties':\n      case 'patternProperties': {\n        const value = b[key];\n        if (value === undefined) break;\n\n        if (result[key] === undefined) {\n          result[key] = value;\n          break;\n        }\n\n        const out: Record<string, ParsedSchema> = {};\n        const allProps = new Set<string>();\n        for (const k in result[key]) allProps.add(k);\n        for (const k in value) allProps.add(k);\n\n        for (const prop of allProps) {\n          const aProp = result[key][prop];\n          const bProp = value[prop];\n          if (aProp === undefined) {\n            out[prop] = bProp;\n          } else if (bProp === undefined) {\n            out[prop] = aProp;\n          } else {\n            out[prop] = intersection(aProp, bProp, options);\n          }\n        }\n\n        result[key] = out;\n        break;\n      }\n      case 'additionalProperties':\n      case 'additionalItems':\n      case 'contains':\n      case 'items': {\n        const value = b[key];\n        if (value === undefined) break;\n\n        result[key] = result[key] === undefined ? value : intersection(result[key], value, options);\n        break;\n      }\n      case 'not': {\n        const value = b[key];\n        if (value === undefined) break;\n\n        if (result[key] && value) {\n          result.not = { anyOf: [result[key], value] };\n        } else if (value) {\n          result.not = value;\n        }\n        break;\n      }\n      default:\n        result[key] = b[key];\n    }\n  }\n\n  return result;\n}\n\nfunction intersectArray<T>(a: readonly T[], b: readonly T[]): T[] {\n  const out = new Set<T>();\n  for (const item of a) {\n    if (b.includes(item)) out.add(item);\n  }\n  for (const item of b) {\n    if (a.includes(item)) out.add(item);\n  }\n  return Array.from(out);\n}\n"],"mappings":"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"}

package/dist/utils/pages/builder.d.ts

@@ -87,4 +87,5 @@ interface ExtractedInfo {
 declare function fromServer(server: OpenAPIServer, config: PagesBuilderConfig): Promise<Record<string, OutputEntry[]>>;
 declare function fromSchema(schemaId: string, processed: ProcessedDocument, config: PagesBuilderConfig): OutputEntry[];
 //#endregion
-export { OperationOutput, OutputEntry, OutputGroup, PagesBuilder, PagesBuilderConfig, TagOutput, WebhookOutput, fromSchema, fromServer };
+export { OperationOutput, OutputEntry, OutputGroup, PagesBuilder, PagesBuilderConfig, TagOutput, WebhookOutput, fromSchema, fromServer };
+//# sourceMappingURL=builder.d.ts.map

package/dist/utils/pages/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","names":[],"sources":["../../../src/utils/pages/builder.ts"],"mappings":";;;;;;;;UAOU,SAAA;EACR,IAAA;EACA,QAAA;EACA,IAAA;IACE,KAAA;IACA,WAAA;EAAA;AAAA;AAAA,UAIa,eAAA,SAAwB,SAAA;EACvC,IAAA;EACA,IAAA,EAAM,aAAA;AAAA;AAAA,UAGS,aAAA,SAAsB,SAAA;EACrC,IAAA;EACA,IAAA,EAAM,WAAA;AAAA;AAAA,UAGS,SAAA,SAAkB,SAAA;EACjC,IAAA;EACA,GAAA;EACA,MAAA,EAAQ,SAAA;EACR,UAAA,EAAY,aAAA;EACZ,QAAA,EAAU,WAAA;AAAA;AAAA,UAGK,WAAA,SAAoB,SAAA;EACnC,IAAA;EACA,UAAA,EAAY,aAAA;EACZ,QAAA,EAAU,WAAA;AAAA;AAAA,KAGA,WAAA,GAAc,SAAA,GAAY,eAAA,GAAkB,aAAA,GAAgB,WAAA;AAAA,UAEvD,kBAAA;EACf,OAAA,GAAU,OAAA,EAAS,YAAA;AAAA;AAAA,UAGJ,YAAA;EAvBE;AAGnB;;EAwBE,EAAA;EACA,QAAA,EAAU,iBAAA;EArBE;;;;;EA2BZ,MAAA,GAAS,KAAA,EAAO,WAAA;EA9BhB;;;EAmCA,mBAAA,GAAsB,IAAA;EAhCtB;;;EAqCA,OAAA,QAAe,aAAA;EACf,oBAAA,GAAuB,IAAA,EAAM,WAAA;IAAA,IAEnB,WAAA;IACJ,QAAA,EAAU,WAAA,CAAY,cAAA;IACtB,SAAA,EAAW,WAAA,CAAY,eAAA;EAAA;EAG7B,sBAAA,GAAyB,IAAA,EAAM,aAAA;IAAA,IAErB,WAAA;IACJ,QAAA,EAAU,WAAA,CAAY,cAAA;IACtB,SAAA,EAAW,WAAA,CAAY,eAAA;EAAA;EAG7B,OAAA,GAAU,GAAA,EAAK,SAAA;IAAA,IACT,WAAA;EAAA;EAEN,WAAA,GAAc,GAAA;IAER,IAAA,EAAM,SAAA;IAAA,IACF,WAAA;EAAA;AAAA;AAAA,UAKF,aAAA;EACR,QAAA,GAAW,WAAA;IAAgB,IAAA;EAAA;EAC3B,UAAA,GAAa,aAAA;IACX,IAAA;EAAA;AAAA;AAAA,iBAIkB,UAAA,CACpB,MAAA,EAAQ,aAAA,EACR,MAAA,EAAQ,kBAAA,GACP,OAAA,CAAQ,MAAA,SAAe,WAAA;AAAA,iBAgBV,UAAA,CACd,QAAA,UACA,SAAA,EAAW,iBAAA,EACX,MAAA,EAAQ,kBAAA,GACP,WAAA"}

package/dist/utils/pages/builder.js

@@ -101,4 +101,5 @@ function extractInfo(document) {
 }
 
 //#endregion
-export { fromSchema, fromServer };
+export { fromSchema, fromServer };
+//# sourceMappingURL=builder.js.map

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":";;;;AA+FA,SAAgB,iBAAiB,SAAmD;AAClF,KAAI,QAAQ,QAAQ,SAAU,QAAO;CACrC,MAAM,EACJ,WAAW,MAAM;AACf,SAAO,EAAE,QAAQ,QAAQ,IAAI,CAAC,aAAa;OAE3C;CACJ,IAAI;AAEJ,KAAI,OAAO,QAAQ,SAAS,WAC1B,UAAS,QAAQ;MACZ;EACL,MAAM,EAAE,YAAY,SAAS,QAAQ,QAAQ,EAAE;AAE/C,WAAS,SAAU,QAAQ,UAAU;AACnC,OAAI,OAAO,SAAS,MAClB,QAAO,QAAQ,OAAO,IAAI;AAG5B,OAAI,OAAO,SAAS,SAAS;IAC3B,MAAM,WAAW,OAAO;AAExB,WAAO,MAAM,SAAS,GAAG,UAAU,KAAK,SAAS,UAAU,KAAK,QAAQ,SAAS,CAAC;;AAGpF,OAAI,OAAO,SAAS,aAAa;IAC/B,MAAM,YAAY,SAAS,MAAO,OAAO,KAAK,MAAO,OAAO,KAAK;AAEjE,QAAI,cAAc,QAAQ,UAAU,YAClC,QAAO,UAAU;AAGnB,WAAO,KAAK,KACV,KAAK,oBAAoB,OAAO,KAAK,KAAK,EAC1C,OAAO,KAAK,OAAO,aAAa,CACjC;;GAGH,MAAM,OAAO,SAAS,SAAU,OAAO,KAAK,MAAM,OAAO,KAAK;AAE9D,OAAI,cAAc,QAAQ,KAAK,YAC7B,QAAO,KAAK;AAGd,UAAO,QAAQ,OAAO,KAAK,KAAK;;;CAIpC,SAAS,YAAY,SAAuB,OAAkD;EAC5F,MAAM,EAAE,iBAAiB,QAAQ;EACjC,MAAM,EAAE,UAAU,WAAW;AAE7B,MAAI,YAAY,QACd,QAAO,CACL,KAAK,KACH,QAAQ,oBACN,MAAM,SAAS,cAAc,MAAM,KAAK,OAAO,MAAM,KAAK,KAC3D,EACD,GAAG,MAAM,KAAK,OAAO,aAAa,CAAC,MACpC,CACF;EAGH,MAAM,OAAO,OAAO,KAAK,SAAS,OAAO,aAAa;AACtD,MAAI,YAAY,OAAO;GACrB,IAAI,OACF,MAAM,SAAS,cACX,aAAa,MAAO,MAAM,KAAK,MAAO,MAAM,KAAK,QAAS,OAC1D,aAAa,SAAU,MAAM,KAAK,MAAM,MAAM,KAAK,QAAS;AAElE,OAAI,CAAC,QAAQ,KAAK,WAAW,GAAG;AAC9B,YAAQ,KACN,4FACD;AAED,WAAO,CAAC,UAAU;;AAGpB,UAAO,KAAK,KAAK,QAAQ,KAAK,KAAK,QAAQ,IAAI,EAAE,GAAG,KAAK,MAAM,CAAC;;AAGlE,MAAI,OAAO,YAAY,WACrB,QAAO,CAAC,KAAK,KAAK,QAAQ,QAAQ,MAAM,CAAC,EAAE,GAAG,KAAK,MAAM,CAAC;AAG5D,SAAO,CAAC,GAAG,KAAK,MAAM;;AAGxB,QAAO,EACL,QAAQ,SAAS;EACf,MAAM,EAAE,iBAAiB,QAAQ;EACjC,MAAM,QAAQ,QAAQ,SAAS;AAE/B,MAAI,QAAQ,QAAQ,QAAQ;GAC1B,MAAM,QAAqB;IACzB,MAAM;IACN,UAAU,QAAQ;IAClB,MAAM;IACN,MAAM;KACJ,OAAO,aAAa,MAAM,SAAS;KACnC,aAAa,aAAa,MAAM;KACjC;IACD,GAAG;IACJ;AACD,SAAM,OAAO,OAAO,KAAK,SAAS,OAAO,aAAa,GAAG;AACzD,WAAQ,OAAO,MAAM;AACrB;;AAGF,MAAI,QAAQ,QAAQ,OAAO;GACzB,MAAM,OAAO,aAAa,QAAQ,EAAE;AACpC,QAAK,MAAM,OAAO,MAAM;IACtB,MAAM,EAAE,gBAAgB,QAAQ,QAAQ,IAAI;IAC5C,MAAM,QAAmB;KACvB,MAAM;KACN,MAAM;KACN,UAAU,QAAQ;KAClB,MAAM;MACJ,OAAO;MACP,aAAa,IAAI;MAClB;KACD,UAAU,MAAM,SAAS,QAAQ,YAAY,QAAQ,MAAM,SAAS,IAAI,KAAM,CAAC;KAC/E,YAAY,MAAM,WAAW,QAAQ,OAAO,GAAG,MAAM,SAAS,IAAI,KAAM,CAAC;KACzE,KAAK,IAAI;KACT,QAAQ;KACT;AAED,UAAM,OAAO,OAAO,KAAK,SAAS,OAAO,aAAa,GAAG;AACzD,YAAQ,OAAO,MAAM;;AAGvB;;AAGF,OAAK,MAAM,MAAM,MAAM,YAAY;GACjC,MAAM,EAAE,UAAU,WAAW,gBAAgB,QAAQ,uBAAuB,GAAG;GAE/E,MAAM,QAAyB;IAC7B,MAAM;IACN,UAAU,QAAQ;IAClB,MAAM;IACN,MAAM;IACN,MAAM;KACJ,OAAO;KACP,aAAa,UAAU,eAAe,SAAS;KAChD;IACF;AAED,QAAK,MAAM,cAAc,YAAY,SAAS,MAAM,CAClD,SAAQ,OAAO;IAAE,GAAG;IAAO,MAAM;IAAY,CAAC;;AAIlD,OAAK,MAAM,WAAW,MAAM,UAAU;GACpC,MAAM,EAAE,UAAU,WAAW,gBAAgB,QAAQ,qBAAqB,QAAQ;GAElF,MAAM,QAAuB;IAC3B,MAAM;IACN,UAAU,QAAQ;IAClB,MAAM;KACJ,OAAO;KACP,aAAa,UAAU,eAAe,SAAS;KAChD;IACD,MAAM;IACN,MAAM;IACP;AAED,QAAK,MAAM,cAAc,YAAY,SAAS,MAAM,CAClD,SAAQ,OAAO;IAAE,GAAG;IAAO,MAAM;IAAY,CAAC;;IAIrD"}

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

@@ -44,4 +44,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