fumadocs-openapi 10.4.1 → 10.6.0

package/dist/playground/components/server-select.js.map

@@ -1 +1 @@
-{"version":3,"file":"server-select.js","names":[],"sources":["../../../src/playground/components/server-select.tsx"],"sourcesContent":["'use client';\nimport { useServerContext, useServerSelectContext } from '@/ui/contexts/api';\nimport {\n  Select,\n  SelectContent,\n  SelectItem,\n  SelectTrigger,\n  SelectValue,\n} from '@/ui/components/select';\nimport { Input, labelVariants } from '@/ui/components/input';\nimport { useEffect, useState, useRef, type ComponentProps } from 'react';\nimport { cn } from '@/utils/cn';\nimport {\n  Dialog,\n  DialogContent,\n  DialogDescription,\n  DialogHeader,\n  DialogTitle,\n  DialogTrigger,\n} from '@/ui/components/dialog';\nimport { resolveServerUrl, withBase } from '@/utils/url';\nimport type { ServerVariableObject } from '@/types';\nimport type { NoReference } from '@/utils/schema';\nimport { StfProvider, useFieldValue, useListener, useStf } from '@fumari/stf';\nimport { EditIcon } from 'lucide-react';\nimport { useTranslations } from '@/ui/client/i18n';\n\nexport default function ServerSelect(props: ComponentProps<typeof DialogTrigger>) {\n  const { servers } = useServerContext();\n  const { server, setServer, setServerVariables } = useServerSelectContext();\n  const [open, setOpen] = useState(false);\n  const [isMounted, setIsMounted] = useState(false);\n  const t = useTranslations();\n\n  useEffect(() => {\n    setIsMounted(true);\n  }, []);\n\n  if (servers.length <= 0) return;\n  const serverSchema = server ? servers.find((obj) => obj.url === server.url) : null;\n\n  return (\n    <Dialog open={open} onOpenChange={setOpen}>\n      <DialogTrigger\n        {...props}\n        className={cn(\n          'flex items-center gap-2 text-sm text-start px-3 py-2 bg-fd-muted text-fd-muted-foreground transition-colors hover:bg-fd-accent hover:text-fd-accent-foreground',\n          props.className,\n        )}\n      >\n        <span className=\"px-2 py-0.5 -ms-2 font-medium rounded-lg border bg-fd-secondary text-fd-secondary-foreground shadow-sm\">\n          {server?.name ?? t.serverUrl}\n        </span>\n        <code className=\"truncate min-w-0 flex-1\">\n          {isMounted\n            ? withBase(\n                server ? resolveServerUrl(server.url, server.variables) : '/',\n                window.location.origin,\n              )\n            : t.loading}\n        </code>\n        <EditIcon className=\"size-4\" />\n      </DialogTrigger>\n      <DialogContent>\n        <DialogHeader>\n          <DialogTitle>{t.serverUrl}</DialogTitle>\n          <DialogDescription>{t.serverUrlDescription}</DialogDescription>\n        </DialogHeader>\n        <Select value={server?.url} onValueChange={setServer}>\n          <SelectTrigger>\n            <SelectValue />\n          </SelectTrigger>\n          <SelectContent>\n            {servers.map((item) => (\n              <SelectItem key={item.url} value={item.url!}>\n                <code className=\"text-[0.8125rem]\">{item.url}</code>\n                <p className=\"text-fd-muted-foreground\">{item.description}</p>\n              </SelectItem>\n            ))}\n          </SelectContent>\n        </Select>\n        {server?.variables && serverSchema?.variables && (\n          <ServerSelectContent\n            key={server.url}\n            defaultValues={server.variables}\n            schema={serverSchema.variables}\n            onChange={setServerVariables}\n          />\n        )}\n      </DialogContent>\n    </Dialog>\n  );\n}\n\nfunction ServerSelectContent({\n  defaultValues,\n  onChange,\n  schema,\n}: {\n  defaultValues: Record<string, string>;\n  onChange: (values: Record<string, string>) => void;\n  schema: Record<string, NoReference<ServerVariableObject>>;\n}) {\n  const stf = useStf({\n    defaultValues: () => structuredClone(defaultValues),\n  });\n  const timerRef = useRef<number | null>(null);\n  useListener({\n    stf,\n    onUpdate() {\n      if (timerRef.current !== null) window.clearTimeout(timerRef.current);\n\n      timerRef.current = window.setTimeout(\n        () => onChange(stf.dataEngine.getData() as Record<string, string>),\n        500,\n      );\n    },\n  });\n\n  return (\n    <StfProvider value={stf}>\n      <div className=\"flex flex-col gap-4\">\n        {Object.entries(schema).map(([key, variable]) => {\n          return (\n            <fieldset key={key} className=\"flex flex-col gap-1\">\n              <label className={cn(labelVariants())} htmlFor={key}>\n                {key}\n              </label>\n              <p className=\"text-xs text-fd-muted-foreground empty:hidden\">\n                {variable.description}\n              </p>\n              <Field fieldName={key} variable={variable} />\n            </fieldset>\n          );\n        })}\n      </div>\n    </StfProvider>\n  );\n}\n\nfunction Field({\n  fieldName,\n  variable,\n}: {\n  variable: NoReference<ServerVariableObject>;\n  fieldName: string;\n}) {\n  const t = useTranslations();\n  const [value, setValue] = useFieldValue([fieldName], {\n    compute(currentValue) {\n      return typeof currentValue === 'string' ? currentValue : undefined;\n    },\n  });\n\n  if (variable.enum) {\n    return (\n      <Select value={value} onValueChange={setValue}>\n        <SelectTrigger id={fieldName}>\n          <SelectValue />\n        </SelectTrigger>\n        <SelectContent>\n          {variable.enum.map((value) => (\n            <SelectItem key={value} value={String(value)}>\n              {value}\n            </SelectItem>\n          ))}\n        </SelectContent>\n      </Select>\n    );\n  }\n\n  return (\n    <Input\n      id={fieldName}\n      value={value}\n      onChange={(e) => setValue(e.target.value)}\n      placeholder={t.serverUrlFieldPlaceholder}\n    />\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"server-select.js","names":[],"sources":["../../../src/playground/components/server-select.tsx"],"sourcesContent":["'use client';\nimport { useServerContext } from '@/ui/contexts/api';\nimport {\n  Select,\n  SelectContent,\n  SelectItem,\n  SelectTrigger,\n  SelectValue,\n} from '@/ui/components/select';\nimport { Input, labelVariants } from '@/ui/components/input';\nimport { useEffect, useState, useRef, type ComponentProps } from 'react';\nimport { cn } from '@/utils/cn';\nimport {\n  Dialog,\n  DialogContent,\n  DialogDescription,\n  DialogHeader,\n  DialogTitle,\n  DialogTrigger,\n} from '@/ui/components/dialog';\nimport { resolveServerUrl, withBase } from '@/utils/url';\nimport type { ServerVariableObject } from '@/types';\nimport type { NoReference } from '@/utils/schema';\nimport { StfProvider, useFieldValue, useListener, useStf } from '@fumari/stf';\nimport { EditIcon } from 'lucide-react';\nimport { useTranslations } from '@/ui/client/i18n';\n\nexport default function ServerSelect(props: ComponentProps<typeof DialogTrigger>) {\n  const { servers, server, setServer, setServerVariables } = useServerContext();\n  const [open, setOpen] = useState(false);\n  const [isMounted, setIsMounted] = useState(false);\n  const t = useTranslations();\n\n  useEffect(() => {\n    setIsMounted(true);\n  }, []);\n\n  if (!servers || servers.length <= 0) return;\n  const serverSchema = server ? servers.find((obj) => obj.url === server.url) : null;\n\n  return (\n    <Dialog open={open} onOpenChange={setOpen}>\n      <DialogTrigger\n        {...props}\n        className={cn(\n          'flex items-center gap-2 text-sm text-start px-3 py-2 bg-fd-muted text-fd-muted-foreground transition-colors hover:bg-fd-accent hover:text-fd-accent-foreground',\n          props.className,\n        )}\n      >\n        <span className=\"px-2 py-0.5 -ms-2 font-medium rounded-lg border bg-fd-secondary text-fd-secondary-foreground shadow-sm\">\n          {server?.name ?? t.serverUrl}\n        </span>\n        <code className=\"truncate min-w-0 flex-1\">\n          {isMounted\n            ? withBase(\n                server ? resolveServerUrl(server.url, server.variables) : '/',\n                window.location.origin,\n              )\n            : t.loading}\n        </code>\n        <EditIcon className=\"size-4\" />\n      </DialogTrigger>\n      <DialogContent>\n        <DialogHeader>\n          <DialogTitle>{t.serverUrl}</DialogTitle>\n          <DialogDescription>{t.serverUrlDescription}</DialogDescription>\n        </DialogHeader>\n        <Select value={server?.url} onValueChange={setServer}>\n          <SelectTrigger>\n            <SelectValue />\n          </SelectTrigger>\n          <SelectContent>\n            {servers.map((item) => (\n              <SelectItem key={item.url} value={item.url!}>\n                <code className=\"text-[0.8125rem]\">{item.url}</code>\n                <p className=\"text-fd-muted-foreground\">{item.description}</p>\n              </SelectItem>\n            ))}\n          </SelectContent>\n        </Select>\n        {server?.variables && serverSchema?.variables && (\n          <ServerSelectContent\n            key={server.url}\n            defaultValues={server.variables}\n            schema={serverSchema.variables}\n            onChange={setServerVariables}\n          />\n        )}\n      </DialogContent>\n    </Dialog>\n  );\n}\n\nfunction ServerSelectContent({\n  defaultValues,\n  onChange,\n  schema,\n}: {\n  defaultValues: Record<string, string>;\n  onChange: (values: Record<string, string>) => void;\n  schema: Record<string, NoReference<ServerVariableObject>>;\n}) {\n  const stf = useStf({\n    defaultValues: () => structuredClone(defaultValues),\n  });\n  const timerRef = useRef<number | null>(null);\n  useListener({\n    stf,\n    onUpdate() {\n      if (timerRef.current !== null) window.clearTimeout(timerRef.current);\n\n      timerRef.current = window.setTimeout(\n        () => onChange(stf.dataEngine.getData() as Record<string, string>),\n        500,\n      );\n    },\n  });\n\n  return (\n    <StfProvider value={stf}>\n      <div className=\"flex flex-col gap-4\">\n        {Object.entries(schema).map(([key, variable]) => {\n          return (\n            <fieldset key={key} className=\"flex flex-col gap-1\">\n              <label className={cn(labelVariants())} htmlFor={key}>\n                {key}\n              </label>\n              <p className=\"text-xs text-fd-muted-foreground empty:hidden\">\n                {variable.description}\n              </p>\n              <Field fieldName={key} variable={variable} />\n            </fieldset>\n          );\n        })}\n      </div>\n    </StfProvider>\n  );\n}\n\nfunction Field({\n  fieldName,\n  variable,\n}: {\n  variable: NoReference<ServerVariableObject>;\n  fieldName: string;\n}) {\n  const t = useTranslations();\n  const [value, setValue] = useFieldValue([fieldName], {\n    compute(currentValue) {\n      return typeof currentValue === 'string' ? currentValue : undefined;\n    },\n  });\n\n  if (variable.enum) {\n    return (\n      <Select value={value} onValueChange={setValue}>\n        <SelectTrigger id={fieldName}>\n          <SelectValue />\n        </SelectTrigger>\n        <SelectContent>\n          {variable.enum.map((value) => (\n            <SelectItem key={value} value={String(value)}>\n              {value}\n            </SelectItem>\n          ))}\n        </SelectContent>\n      </Select>\n    );\n  }\n\n  return (\n    <Input\n      id={fieldName}\n      value={value}\n      onChange={(e) => setValue(e.target.value)}\n      placeholder={t.serverUrlFieldPlaceholder}\n    />\n  );\n}\n"],"mappings":"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"}

package/dist/playground/index.d.ts

@@ -16,7 +16,7 @@ declare function APIPlayground({
   path,
   method,
   ctx
-}: APIPlaygroundProps): Promise<string | number | bigint | boolean | react_jsx_runtime0.JSX.Element | Iterable<react.ReactNode> | null | undefined>;
+}: APIPlaygroundProps): string | number | bigint | boolean | react_jsx_runtime0.JSX.Element | Iterable<react.ReactNode> | Promise<react.ReactNode> | null | undefined;
 //#endregion
 export { APIPlayground, APIPlaygroundProps, SecurityEntry };
 //# sourceMappingURL=index.d.ts.map

package/dist/playground/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/playground/index.tsx"],"mappings":";;;;;UAiBiB,kBAAA;EACf,IAAA;EACA,MAAA,EAAQ,iBAAA;EACR,GAAA,EAAK,aAAA;AAAA;AAAA,KAGK,aAAA,GAAgB,oBAAA;EAC1B,MAAA;EACA,EAAA;AAAA;AAAA,iBAGoB,aAAA,CAAA;EAAgB,IAAA;EAAM,MAAA;EAAQ;AAAA,GAAO,kBAAA,GAAkB,OAAA,sCAAA,kBAAA,CAAA,GAAA,CAAA,OAAA,GAAA,QAAA,CAAA,KAAA,CAAA,SAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/playground/index.tsx"],"mappings":";;;;;UAiBiB,kBAAA;EACf,IAAA;EACA,MAAA,EAAQ,iBAAA;EACR,GAAA,EAAK,aAAA;AAAA;AAAA,KAGK,aAAA,GAAgB,oBAAA;EAC1B,MAAA;EACA,EAAA;AAAA;AAAA,iBAGc,aAAA,CAAA;EAAgB,IAAA;EAAM,MAAA;EAAQ;AAAA,GAAO,kBAAA,wCAAkB,kBAAA,CAAA,GAAA,CAAA,OAAA,GAAA,QAAA,CAAA,KAAA,CAAA,SAAA,IAAA,OAAA,CAAA,KAAA,CAAA,SAAA"}

package/dist/playground/index.js

@@ -1,8 +1,8 @@
-import { getPreferredType } from "../utils/schema.js";
+import { getPreferredType } from "../utils/schema/index.js";
 import { ClientLazy } from "./lazy.js";
 import { jsx } from "react/jsx-runtime";
 //#region src/playground/index.tsx
-async function APIPlayground({ path, method, ctx }) {
+function APIPlayground({ path, method, ctx }) {
 	if (ctx.playground?.render) return ctx.playground.render({
 		path,
 		method,

package/dist/playground/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/playground/index.tsx"],"sourcesContent":["import type {\n  MediaTypeObject,\n  MethodInformation,\n  ParameterObject,\n  RenderContext,\n  SecuritySchemeObject,\n} from '@/types';\nimport { getPreferredType, NoReference, type ParsedSchema } from '@/utils/schema';\nimport { type PlaygroundClientProps } from './client';\nimport { ClientLazy } from './lazy';\n\ninterface Context {\n  references: Record<string, ParsedSchema>;\n  registered: WeakMap<Exclude<ParsedSchema, boolean>, string>;\n  id: (schema?: object) => string;\n}\n\nexport interface APIPlaygroundProps {\n  path: string;\n  method: MethodInformation;\n  ctx: RenderContext;\n}\n\nexport type SecurityEntry = SecuritySchemeObject & {\n  scopes: string[];\n  id: string;\n};\n\nexport async function APIPlayground({ path, method, ctx }: APIPlaygroundProps) {\n  if (ctx.playground?.render) {\n    return ctx.playground.render({ path, method, ctx });\n  }\n\n  const bodyContent = method.requestBody?.content;\n  const mediaType = bodyContent ? getPreferredType(bodyContent) : undefined;\n  const takenIds = new Map<string, number>();\n\n  const context: Context = {\n    references: {},\n    id(schema) {\n      let name = 'r';\n      if (schema) {\n        const ref = ctx.schema.getRawRef(schema)?.split('/');\n        if (ref && ref.length > 0) name = ref[ref.length - 1];\n      }\n\n      const count = takenIds.get(name) ?? 0;\n      takenIds.set(name, count + 1);\n      return count === 0 ? name : `${name}${count}`;\n    },\n    registered: new WeakMap(),\n  };\n\n  const props: PlaygroundClientProps = {\n    securities: parseSecurities(method, ctx),\n    method: method.method,\n    route: path,\n    parameters: method.parameters?.map((param: NoReference<ParameterObject>): ParameterObject => {\n      if (param.schema !== undefined) {\n        return {\n          ...param,\n          schema: writeReferences(param.schema, context),\n        } as ParameterObject;\n      }\n\n      if (param.content !== undefined) {\n        const content: Record<string, MediaTypeObject> = {};\n\n        for (const k in param.content) {\n          const original = param.content[k] as NoReference<MediaTypeObject>;\n          if (!original || original.schema === undefined) continue;\n\n          content[k] = {\n            ...original,\n            schema: writeReferences(original.schema, context),\n          } as MediaTypeObject;\n        }\n\n        return {\n          ...param,\n          content,\n        } as ParameterObject;\n      }\n\n      return param;\n    }),\n    body:\n      bodyContent && mediaType\n        ? ({\n            schema: writeReferences(bodyContent[mediaType].schema as ParsedSchema, context),\n            mediaType,\n          } as PlaygroundClientProps['body'])\n        : undefined,\n    references: context.references,\n    proxyUrl: ctx.proxyUrl,\n    writeOnly: true,\n    readOnly: false,\n  };\n\n  return <ClientLazy {...props} />;\n}\n\nfunction writeReferences(\n  schema: ParsedSchema,\n  ctx: Context,\n  stack: WeakMap<object, object> = new WeakMap(),\n): ParsedSchema {\n  if (typeof schema !== 'object' || !schema) return schema;\n  if (stack.has(schema)) {\n    const out = stack.get(schema)!;\n    const id = ctx.id(schema);\n    ctx.references[id] = out;\n\n    return {\n      $ref: `#/${id}`,\n    };\n  }\n\n  const output = { ...schema };\n  stack.set(schema, output);\n  for (const _n in output) {\n    const name = _n as keyof typeof output;\n    if (!output[name]) continue;\n\n    switch (name) {\n      case 'oneOf':\n      case 'allOf':\n      case 'anyOf':\n        output[name] = output[name].map((item) => writeReferences(item, ctx, stack));\n        continue;\n      case 'items':\n      case 'additionalProperties':\n      case 'not':\n        output[name] = writeReferences(output[name], ctx, stack);\n        continue;\n      case 'properties':\n      case 'patternProperties':\n        output[name] = { ...output[name] };\n\n        for (const key in output[name]) {\n          output[name][key] = writeReferences(output[name][key], ctx, stack);\n        }\n    }\n  }\n\n  return output;\n}\n\nfunction parseSecurities(\n  method: MethodInformation,\n  { schema: { dereferenced } }: RenderContext,\n): PlaygroundClientProps['securities'] {\n  const result: PlaygroundClientProps['securities'] = [];\n  const security = method.security ?? dereferenced.security ?? [];\n  if (security.length === 0) return result;\n\n  for (const map of security) {\n    const list: PlaygroundClientProps['securities'][number] = [];\n\n    for (const [key, scopes] of Object.entries(map)) {\n      const scheme = dereferenced.components?.securitySchemes?.[key];\n      if (!scheme) continue;\n\n      list.push({\n        ...scheme,\n        scopes,\n        id: key,\n      });\n    }\n\n    if (list.length > 0) result.push(list);\n  }\n\n  return result;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/playground/index.tsx"],"sourcesContent":["import type {\n  MediaTypeObject,\n  MethodInformation,\n  ParameterObject,\n  RenderContext,\n  SecuritySchemeObject,\n} from '@/types';\nimport { getPreferredType, NoReference, type ParsedSchema } from '@/utils/schema';\nimport { type PlaygroundClientProps } from './client';\nimport { ClientLazy } from './lazy';\n\ninterface Context {\n  references: Record<string, ParsedSchema>;\n  registered: WeakMap<Exclude<ParsedSchema, boolean>, string>;\n  id: (schema?: object) => string;\n}\n\nexport interface APIPlaygroundProps {\n  path: string;\n  method: MethodInformation;\n  ctx: RenderContext;\n}\n\nexport type SecurityEntry = SecuritySchemeObject & {\n  scopes: string[];\n  id: string;\n};\n\nexport function APIPlayground({ path, method, ctx }: APIPlaygroundProps) {\n  if (ctx.playground?.render) {\n    return ctx.playground.render({ path, method, ctx });\n  }\n\n  const bodyContent = method.requestBody?.content;\n  const mediaType = bodyContent ? getPreferredType(bodyContent) : undefined;\n  const takenIds = new Map<string, number>();\n\n  const context: Context = {\n    references: {},\n    id(schema) {\n      let name = 'r';\n      if (schema) {\n        const ref = ctx.schema.getRawRef(schema)?.split('/');\n        if (ref && ref.length > 0) name = ref[ref.length - 1];\n      }\n\n      const count = takenIds.get(name) ?? 0;\n      takenIds.set(name, count + 1);\n      return count === 0 ? name : `${name}${count}`;\n    },\n    registered: new WeakMap(),\n  };\n\n  const props: PlaygroundClientProps = {\n    securities: parseSecurities(method, ctx),\n    method: method.method,\n    route: path,\n    parameters: method.parameters?.map((param: NoReference<ParameterObject>): ParameterObject => {\n      if (param.schema !== undefined) {\n        return {\n          ...param,\n          schema: writeReferences(param.schema, context),\n        } as ParameterObject;\n      }\n\n      if (param.content !== undefined) {\n        const content: Record<string, MediaTypeObject> = {};\n\n        for (const k in param.content) {\n          const original = param.content[k] as NoReference<MediaTypeObject>;\n          if (!original || original.schema === undefined) continue;\n\n          content[k] = {\n            ...original,\n            schema: writeReferences(original.schema, context),\n          } as MediaTypeObject;\n        }\n\n        return {\n          ...param,\n          content,\n        } as ParameterObject;\n      }\n\n      return param;\n    }),\n    body:\n      bodyContent && mediaType\n        ? ({\n            schema: writeReferences(bodyContent[mediaType].schema as ParsedSchema, context),\n            mediaType,\n          } as PlaygroundClientProps['body'])\n        : undefined,\n    references: context.references,\n    proxyUrl: ctx.proxyUrl,\n    writeOnly: true,\n    readOnly: false,\n  };\n\n  return <ClientLazy {...props} />;\n}\n\nfunction writeReferences(\n  schema: ParsedSchema,\n  ctx: Context,\n  stack: WeakMap<object, object> = new WeakMap(),\n): ParsedSchema {\n  if (typeof schema !== 'object' || !schema) return schema;\n  if (stack.has(schema)) {\n    const out = stack.get(schema)!;\n    const id = ctx.id(schema);\n    ctx.references[id] = out;\n\n    return {\n      $ref: `#/${id}`,\n    };\n  }\n\n  const output = { ...schema };\n  stack.set(schema, output);\n  for (const _n in output) {\n    const name = _n as keyof typeof output;\n    if (!output[name]) continue;\n\n    switch (name) {\n      case 'oneOf':\n      case 'allOf':\n      case 'anyOf':\n        output[name] = output[name].map((item) => writeReferences(item, ctx, stack));\n        continue;\n      case 'items':\n      case 'additionalProperties':\n      case 'not':\n        output[name] = writeReferences(output[name], ctx, stack);\n        continue;\n      case 'properties':\n      case 'patternProperties':\n        output[name] = { ...output[name] };\n\n        for (const key in output[name]) {\n          output[name][key] = writeReferences(output[name][key], ctx, stack);\n        }\n    }\n  }\n\n  return output;\n}\n\nfunction parseSecurities(\n  method: MethodInformation,\n  { schema: { dereferenced } }: RenderContext,\n): PlaygroundClientProps['securities'] {\n  const result: PlaygroundClientProps['securities'] = [];\n  const security = method.security ?? dereferenced.security ?? [];\n  if (security.length === 0) return result;\n\n  for (const map of security) {\n    const list: PlaygroundClientProps['securities'][number] = [];\n\n    for (const [key, scopes] of Object.entries(map)) {\n      const scheme = dereferenced.components?.securitySchemes?.[key];\n      if (!scheme) continue;\n\n      list.push({\n        ...scheme,\n        scopes,\n        id: key,\n      });\n    }\n\n    if (list.length > 0) result.push(list);\n  }\n\n  return result;\n}\n"],"mappings":"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"}

package/dist/playground/schema.d.ts

@@ -1,5 +1,4 @@
 import { ReactNode } from "react";
-import { Ajv2020 } from "ajv/dist/2020";
 import { FieldKey } from "@fumari/stf";
 
 //#region src/playground/schema.d.ts

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","names":[],"sources":["../../src/playground/schema.tsx"],"mappings":";;;;;UAciB,WAAA;;;;EAIf,SAAA;;;;EAKA,QAAA;AAAA"}
+{"version":3,"file":"schema.d.ts","names":[],"sources":["../../src/playground/schema.tsx"],"mappings":";;;;UAeiB,WAAA;;;;EAIf,SAAA;;;;EAKA,QAAA;AAAA"}

package/dist/playground/schema.js

@@ -1,8 +1,9 @@
 import { mergeAllOf } from "../utils/merge-schema.js";
-import { schemaToString } from "../utils/schema-to-string.js";
+import { schemaToString } from "../utils/schema/to-string.js";
+import { resolveRefSync } from "../utils/schema/resolve-ref.js";
 import { createContext, use, useMemo } from "react";
 import { jsx } from "react/jsx-runtime";
-import { Ajv2020 } from "ajv/dist/2020";
+import { Ajv2020 } from "ajv/dist/2020.js";
 import { useDataEngine, useFieldValue, useNamespace } from "@fumari/stf";
 import { stringifyFieldKey } from "@fumari/stf/lib/utils";
 import { sample } from "openapi-sampler";
@@ -129,24 +130,21 @@ function useResolvedSchema(raw) {
 	return useMemo(() => {
 		const schema = dereference(raw, references);
 		if (typeof schema === "boolean") return anyFields;
-		if (schema.allOf) return fallbackAny(mergeAllOf(schema, { dereference(schema) {
-			return dereference(schema, references);
-		} }));
+		if (schema.allOf) {
+			const merged = mergeAllOf(schema, { dereference(schema) {
+				return dereference(schema, references);
+			} });
+			if (typeof merged === "boolean") return anyFields;
+			return merged;
+		}
 		return schema;
 	}, [raw, references]);
 }
 function dereference(schema, references) {
 	if (typeof schema === "boolean") return schema;
-	let ref = schema.$ref;
-	if (ref) {
-		if (ref.startsWith("#/")) ref = ref.slice(2);
-		if (ref in references) return references[ref];
-	}
+	if (schema.$ref) return resolveRefSync(schema.$ref, references);
 	return schema;
 }
-function fallbackAny(schema) {
-	return typeof schema === "boolean" ? anyFields : schema;
-}
 function getUnion(schema) {
 	if (schema.anyOf) return [schema.anyOf, "anyOf"];
 	if (schema.oneOf) return [schema.oneOf, "oneOf"];

package/dist/playground/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","names":[],"sources":["../../src/playground/schema.tsx"],"sourcesContent":["import { Ajv2020 } from 'ajv/dist/2020';\nimport { createContext, ReactNode, use, useMemo } from 'react';\nimport type { ParsedSchema, ResolvedSchema } from '@/utils/schema';\nimport { mergeAllOf } from '@/utils/merge-schema';\nimport { FieldKey, useDataEngine, useFieldValue, useNamespace } from '@fumari/stf';\nimport { stringifyFieldKey } from '@fumari/stf/lib/utils';\nimport { sample } from 'openapi-sampler';\nimport { FormatFlags, schemaToString } from '@/utils/schema-to-string';\n\ninterface SchemaContextType extends SchemaScope {\n  references: Record<string, ParsedSchema>;\n  ajv: Ajv2020;\n}\n\nexport interface SchemaScope {\n  /**\n   * show write only fields\n   */\n  writeOnly: boolean;\n\n  /**\n   * show read only fields\n   */\n  readOnly: boolean;\n}\n\ntype UnionField = 'anyOf' | 'oneOf';\n\nexport interface FieldInfo {\n  selectedType?: string;\n  oneOf: number;\n\n  /**\n   * The actual field that represents union members.\n   */\n  unionField?: UnionField;\n}\n\nconst SchemaContext = createContext<SchemaContextType | undefined>(undefined);\nexport const anyFields = {\n  type: ['string', 'number', 'boolean', 'array', 'object'],\n  items: true,\n  additionalProperties: true,\n} satisfies ParsedSchema;\n\nexport function SchemaProvider({\n  references,\n  readOnly,\n  writeOnly,\n  children,\n}: Omit<SchemaContextType, 'ajv'> & { children: ReactNode }) {\n  const ajv = useMemo(\n    () =>\n      new Ajv2020({\n        strict: false,\n        validateSchema: false,\n        validateFormats: false,\n      }),\n    [],\n  );\n\n  return (\n    <SchemaContext.Provider\n      value={useMemo(\n        () => ({ references, ajv, readOnly, writeOnly }),\n        [references, ajv, readOnly, writeOnly],\n      )}\n    >\n      {children}\n    </SchemaContext.Provider>\n  );\n}\n\nexport function useSchemaScope(): SchemaScope {\n  return use(SchemaContext)!;\n}\n\n/**\n * A hook to store dynamic info of a field, such as selected schema of `oneOf`.\n *\n * @param fieldName - field name of form.\n * @param schema - The **resolved** JSON Schema to generate initial values.\n * @param depth - The depth to avoid duplicated field name with same schema (e.g. nested `oneOf`).\n */\nexport function useFieldInfo(\n  fieldName: FieldKey,\n  schema: Exclude<ParsedSchema, boolean>,\n  depth = 0,\n): {\n  info: FieldInfo;\n  schema: Exclude<ParsedSchema, boolean>;\n  updateInfo: (value: Partial<FieldInfo>) => void;\n} {\n  const { ajv, references } = use(SchemaContext)!;\n  const engine = useDataEngine();\n  const { generateDefault } = useSchemaUtils();\n  const fieldData = useNamespace({\n    namespace: `field-info:${depth}:${stringifyFieldKey(fieldName)}`,\n    initial(): FieldInfo {\n      const value = engine.get(fieldName);\n      const out: FieldInfo = {\n        oneOf: -1,\n      };\n      const union = getUnion(schema);\n      if (union) {\n        const [members, field] = union;\n\n        out.oneOf = members.findIndex((item) =>\n          ajv.validate(typeof item === 'object' ? { ...item, ...references } : item, value),\n        );\n        if (out.oneOf === -1) out.oneOf = 0;\n        out.unionField = field;\n      }\n\n      if (Array.isArray(schema.type)) {\n        const types = schema.type;\n\n        out.selectedType =\n          types.find((type) => {\n            return ajv.validate({ ...schema, ...references, type }, value);\n          }) ?? types[0];\n      }\n\n      return out;\n    },\n  });\n  const [info, setInfo] = useFieldValue<FieldInfo>([], {\n    stf: fieldData,\n  });\n\n  return {\n    info,\n    schema,\n    updateInfo(value) {\n      const updated = {\n        ...info,\n        ...value,\n      };\n\n      if (updated.oneOf === info.oneOf && updated.selectedType === info.selectedType) return;\n\n      setInfo(updated);\n\n      let valueSchema: ParsedSchema = schema;\n      if (updated.unionField) {\n        valueSchema = schema[updated.unionField]![updated.oneOf];\n      } else if (updated.selectedType) {\n        // must remove to `examples` to avoid invalid default values\n        valueSchema = { ...schema, type: updated.selectedType, examples: undefined };\n      }\n\n      engine.update(fieldName, generateDefault(valueSchema));\n    },\n  };\n}\n\nexport function useSchemaUtils() {\n  const { references } = use(SchemaContext)!;\n\n  return {\n    generateDefault(schema: ParsedSchema): unknown {\n      return sample(\n        schema as never,\n        { skipNonRequired: true, skipReadOnly: true, quiet: true },\n        references,\n      );\n    },\n    schemaToString(value: ResolvedSchema, flags?: FormatFlags) {\n      return schemaToString(\n        value,\n        (s) => ({ dereferenced: dereference(s, references), raw: s }),\n        flags,\n      );\n    },\n  };\n}\n\n/**\n * resolve $ref & merge `allOf`.\n */\nexport function useResolvedSchema(raw: ParsedSchema): Exclude<ParsedSchema, boolean> {\n  const { references } = use(SchemaContext)!;\n\n  return useMemo(() => {\n    const schema = dereference(raw, references);\n    if (typeof schema === 'boolean') return anyFields;\n\n    if (schema.allOf) {\n      return fallbackAny(\n        mergeAllOf(schema, {\n          dereference(schema) {\n            return dereference(schema, references);\n          },\n        }),\n      );\n    }\n\n    return schema;\n  }, [raw, references]);\n}\n\nfunction dereference(schema: ParsedSchema, references: Record<string, ParsedSchema>): ParsedSchema {\n  if (typeof schema === 'boolean') return schema;\n\n  let ref = schema.$ref;\n  if (ref) {\n    // use swallow resolution as it is already preprocessed in `playground/index.tsx`\n    const prefix = '#/';\n    if (ref.startsWith(prefix)) ref = ref.slice(prefix.length);\n    if (ref in references) return references[ref];\n  }\n\n  return schema;\n}\n\nfunction fallbackAny(schema: ParsedSchema): Exclude<ParsedSchema, boolean> {\n  return typeof schema === 'boolean' ? anyFields : schema;\n}\n\nfunction getUnion(\n  schema: Exclude<ParsedSchema, boolean>,\n): [readonly ParsedSchema[], UnionField] | undefined {\n  if (schema.anyOf) {\n    return [schema.anyOf, 'anyOf'];\n  }\n\n  if (schema.oneOf) return [schema.oneOf, 'oneOf'];\n}\n"],"mappings":"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"}
+{"version":3,"file":"schema.js","names":[],"sources":["../../src/playground/schema.tsx"],"sourcesContent":["import { Ajv2020 } from 'ajv/dist/2020';\nimport { createContext, ReactNode, use, useMemo } from 'react';\nimport type { ParsedSchema, ResolvedSchema } from '@/utils/schema';\nimport { mergeAllOf } from '@/utils/merge-schema';\nimport { FieldKey, useDataEngine, useFieldValue, useNamespace } from '@fumari/stf';\nimport { stringifyFieldKey } from '@fumari/stf/lib/utils';\nimport { sample } from 'openapi-sampler';\nimport { FormatFlags, schemaToString } from '@/utils/schema/to-string';\nimport { resolveRefSync } from '@/utils/schema/resolve-ref';\n\ninterface SchemaContextType extends SchemaScope {\n  references: Record<string, ParsedSchema>;\n  ajv: Ajv2020;\n}\n\nexport interface SchemaScope {\n  /**\n   * show write only fields\n   */\n  writeOnly: boolean;\n\n  /**\n   * show read only fields\n   */\n  readOnly: boolean;\n}\n\ntype UnionField = 'anyOf' | 'oneOf';\n\nexport interface FieldInfo {\n  selectedType?: string;\n  oneOf: number;\n\n  /**\n   * The actual field that represents union members.\n   */\n  unionField?: UnionField;\n}\n\nconst SchemaContext = createContext<SchemaContextType | undefined>(undefined);\nexport const anyFields = {\n  type: ['string', 'number', 'boolean', 'array', 'object'],\n  items: true,\n  additionalProperties: true,\n} satisfies ParsedSchema;\n\nexport function SchemaProvider({\n  references,\n  readOnly,\n  writeOnly,\n  children,\n}: Omit<SchemaContextType, 'ajv'> & { children: ReactNode }) {\n  const ajv = useMemo(\n    () =>\n      new Ajv2020({\n        strict: false,\n        validateSchema: false,\n        validateFormats: false,\n      }),\n    [],\n  );\n\n  return (\n    <SchemaContext.Provider\n      value={useMemo(\n        () => ({ references, ajv, readOnly, writeOnly }),\n        [references, ajv, readOnly, writeOnly],\n      )}\n    >\n      {children}\n    </SchemaContext.Provider>\n  );\n}\n\nexport function useSchemaScope(): SchemaScope {\n  return use(SchemaContext)!;\n}\n\n/**\n * A hook to store dynamic info of a field, such as selected schema of `oneOf`.\n *\n * @param fieldName - field name of form.\n * @param schema - The **resolved** JSON Schema to generate initial values.\n * @param depth - The depth to avoid duplicated field name with same schema (e.g. nested `oneOf`).\n */\nexport function useFieldInfo(\n  fieldName: FieldKey,\n  schema: Exclude<ParsedSchema, boolean>,\n  depth = 0,\n): {\n  info: FieldInfo;\n  schema: Exclude<ParsedSchema, boolean>;\n  updateInfo: (value: Partial<FieldInfo>) => void;\n} {\n  const { ajv, references } = use(SchemaContext)!;\n  const engine = useDataEngine();\n  const { generateDefault } = useSchemaUtils();\n  const fieldData = useNamespace({\n    namespace: `field-info:${depth}:${stringifyFieldKey(fieldName)}`,\n    initial(): FieldInfo {\n      const value = engine.get(fieldName);\n      const out: FieldInfo = {\n        oneOf: -1,\n      };\n      const union = getUnion(schema);\n      if (union) {\n        const [members, field] = union;\n\n        out.oneOf = members.findIndex((item) =>\n          ajv.validate(typeof item === 'object' ? { ...item, ...references } : item, value),\n        );\n        if (out.oneOf === -1) out.oneOf = 0;\n        out.unionField = field;\n      }\n\n      if (Array.isArray(schema.type)) {\n        const types = schema.type;\n\n        out.selectedType =\n          types.find((type) => {\n            return ajv.validate({ ...schema, ...references, type }, value);\n          }) ?? types[0];\n      }\n\n      return out;\n    },\n  });\n  const [info, setInfo] = useFieldValue<FieldInfo>([], {\n    stf: fieldData,\n  });\n\n  return {\n    info,\n    schema,\n    updateInfo(value) {\n      const updated = {\n        ...info,\n        ...value,\n      };\n\n      if (updated.oneOf === info.oneOf && updated.selectedType === info.selectedType) return;\n\n      setInfo(updated);\n\n      let valueSchema: ParsedSchema = schema;\n      if (updated.unionField) {\n        valueSchema = schema[updated.unionField]![updated.oneOf];\n      } else if (updated.selectedType) {\n        // must remove to `examples` to avoid invalid default values\n        valueSchema = { ...schema, type: updated.selectedType, examples: undefined };\n      }\n\n      engine.update(fieldName, generateDefault(valueSchema));\n    },\n  };\n}\n\nexport function useSchemaUtils() {\n  const { references } = use(SchemaContext)!;\n\n  return {\n    generateDefault(schema: ParsedSchema): unknown {\n      return sample(\n        schema as never,\n        { skipNonRequired: true, skipReadOnly: true, quiet: true },\n        references,\n      );\n    },\n    schemaToString(value: ResolvedSchema, flags?: FormatFlags) {\n      return schemaToString(\n        value,\n        (s) => ({ dereferenced: dereference(s, references), raw: s }),\n        flags,\n      );\n    },\n  };\n}\n\n/**\n * resolve $ref & merge `allOf`.\n */\nexport function useResolvedSchema(raw: ParsedSchema): Exclude<ParsedSchema, boolean> {\n  const { references } = use(SchemaContext)!;\n\n  return useMemo(() => {\n    const schema = dereference(raw, references);\n    if (typeof schema === 'boolean') return anyFields;\n\n    if (schema.allOf) {\n      const merged = mergeAllOf(schema, {\n        dereference(schema) {\n          return dereference(schema, references);\n        },\n      });\n      if (typeof merged === 'boolean') return anyFields;\n      return merged;\n    }\n\n    return schema;\n  }, [raw, references]);\n}\n\nfunction dereference(schema: ParsedSchema, references: Record<string, ParsedSchema>): ParsedSchema {\n  if (typeof schema === 'boolean') return schema;\n  if (schema.$ref) {\n    return resolveRefSync(schema.$ref, references) as ParsedSchema;\n  }\n\n  return schema;\n}\n\nfunction getUnion(\n  schema: Exclude<ParsedSchema, boolean>,\n): [readonly ParsedSchema[], UnionField] | undefined {\n  if (schema.anyOf) {\n    return [schema.anyOf, 'anyOf'];\n  }\n\n  if (schema.oneOf) return [schema.oneOf, 'oneOf'];\n}\n"],"mappings":"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"}

package/dist/requests/generators/python.d.ts

@@ -2,6 +2,7 @@ import { CodeUsageGenerator } from "./index.js";
 
 //#region src/requests/generators/python.d.ts
 declare const python: CodeUsageGenerator;
+declare function generatePythonObject(v: unknown, imports: Set<string>): string;
 //#endregion
-export { python };
+export { generatePythonObject, python };
 //# sourceMappingURL=python.d.ts.map

package/dist/requests/generators/python.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"python.d.ts","names":[],"sources":["../../../src/requests/generators/python.ts"],"mappings":";;;cAIa,MAAA,EAAQ,kBAAA"}
+{"version":3,"file":"python.d.ts","names":[],"sources":["../../../src/requests/generators/python.ts"],"mappings":";;;cAGa,MAAA,EAAQ,kBAAA;AAAA,iBAuDL,oBAAA,CAAqB,CAAA,WAAY,OAAA,EAAS,GAAA"}

package/dist/requests/generators/python.js

@@ -1,6 +1,5 @@
 import { resolveMediaAdapter } from "../media/resolve-adapter.js";
 import "../media/adapter.js";
-import { generatePythonObject } from "../to-python-object.js";
 //#region src/requests/generators/python.ts
 const python = {
 	label: "Python",
@@ -34,7 +33,19 @@ response = requests.request(${params.join(", ")})
 print(response.text)`;
 	}
 };
+function generatePythonObject(v, imports) {
+	if (v === null) return "None";
+	else if (typeof v === "boolean") return v ? "True" : "False";
+	else if (typeof v === "string") return JSON.stringify(v);
+	else if (typeof v === "number") return v.toString();
+	else if (Array.isArray(v)) return `[${v.map((item) => generatePythonObject(item, imports)).join(", ")}]`;
+	else if (v instanceof Date) {
+		imports.add("datetime");
+		return `datetime.datetime(${v.getFullYear()}, ${v.getMonth() + 1}, ${v.getDate()}, ${v.getHours()}, ${v.getMinutes()}, ${v.getSeconds()}, ${v.getMilliseconds()})`;
+	} else if (typeof v === "object") return `{\n${Object.entries(v).map(([key, value]) => `  ${JSON.stringify(key)}: ${generatePythonObject(value, imports)}`).join(", \n")}\n}`;
+	else throw new Error(`Unsupported type: ${typeof v}`);
+}
 //#endregion
-export { python };
+export { generatePythonObject, python };
 
 //# sourceMappingURL=python.js.map

package/dist/requests/generators/python.js.map

@@ -1 +1 @@
-{"version":3,"file":"python.js","names":[],"sources":["../../../src/requests/generators/python.ts"],"sourcesContent":["import type { CodeUsageGenerator } from '@/requests/generators';\nimport { generatePythonObject } from '@/requests/to-python-object';\nimport { resolveMediaAdapter } from '@/requests/media/adapter';\n\nexport const python: CodeUsageGenerator = {\n  label: 'Python',\n  lang: 'python',\n  generate(url, data, { mediaAdapters }) {\n    const headers: Record<string, string> = {};\n    const imports = new Set<string>();\n    const params = [`\"${data.method}\"`, 'url'];\n    let body: string | undefined;\n\n    imports.add('requests');\n\n    if (data.body && data.bodyMediaType) {\n      const adapter = resolveMediaAdapter(data.bodyMediaType, mediaAdapters);\n      headers['Content-Type'] = data.bodyMediaType;\n\n      body = adapter?.generateExample(data as { body: unknown }, {\n        lang: 'python',\n      });\n\n      if (body) {\n        params.push('data = body');\n      }\n    }\n\n    for (const [k, v] of Object.entries(data.header)) {\n      headers[k] = v.value;\n    }\n\n    if (Object.keys(headers).length > 0) {\n      params.push(`headers = ${generatePythonObject(headers, imports)}`);\n    }\n\n    const inputCookies = Object.entries(data.cookie);\n    if (inputCookies.length > 0) {\n      const cookies: Record<string, string> = {};\n\n      for (const [k, v] of inputCookies) {\n        cookies[k] = v.value;\n      }\n\n      params.push(`cookies = ${generatePythonObject(cookies, imports)}`);\n    }\n\n    return `${Array.from(imports)\n      .map((name) => 'import ' + name)\n      .join('\\n')}\n\nurl = ${JSON.stringify(url)}\n${body ?? ''}\nresponse = requests.request(${params.join(', ')})\n\nprint(response.text)`;\n  },\n};\n"],"mappings":";;;;AAIA,MAAa,SAA6B;CACxC,OAAO;CACP,MAAM;CACN,SAAS,KAAK,MAAM,EAAE,iBAAiB;EACrC,MAAM,UAAkC,EAAE;EAC1C,MAAM,0BAAU,IAAI,KAAa;EACjC,MAAM,SAAS,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM;EAC1C,IAAI;AAEJ,UAAQ,IAAI,WAAW;AAEvB,MAAI,KAAK,QAAQ,KAAK,eAAe;GACnC,MAAM,UAAU,oBAAoB,KAAK,eAAe,cAAc;AACtE,WAAQ,kBAAkB,KAAK;AAE/B,UAAO,SAAS,gBAAgB,MAA2B,EACzD,MAAM,UACP,CAAC;AAEF,OAAI,KACF,QAAO,KAAK,cAAc;;AAI9B,OAAK,MAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,KAAK,OAAO,CAC9C,SAAQ,KAAK,EAAE;AAGjB,MAAI,OAAO,KAAK,QAAQ,CAAC,SAAS,EAChC,QAAO,KAAK,aAAa,qBAAqB,SAAS,QAAQ,GAAG;EAGpE,MAAM,eAAe,OAAO,QAAQ,KAAK,OAAO;AAChD,MAAI,aAAa,SAAS,GAAG;GAC3B,MAAM,UAAkC,EAAE;AAE1C,QAAK,MAAM,CAAC,GAAG,MAAM,aACnB,SAAQ,KAAK,EAAE;AAGjB,UAAO,KAAK,aAAa,qBAAqB,SAAS,QAAQ,GAAG;;AAGpE,SAAO,GAAG,MAAM,KAAK,QAAQ,CAC1B,KAAK,SAAS,YAAY,KAAK,CAC/B,KAAK,KAAK,CAAC;;QAEV,KAAK,UAAU,IAAI,CAAC;EAC1B,QAAQ,GAAG;8BACiB,OAAO,KAAK,KAAK,CAAC;;;;CAI/C"}
+{"version":3,"file":"python.js","names":[],"sources":["../../../src/requests/generators/python.ts"],"sourcesContent":["import type { CodeUsageGenerator } from '@/requests/generators';\nimport { resolveMediaAdapter } from '@/requests/media/adapter';\n\nexport const python: CodeUsageGenerator = {\n  label: 'Python',\n  lang: 'python',\n  generate(url, data, { mediaAdapters }) {\n    const headers: Record<string, string> = {};\n    const imports = new Set<string>();\n    const params = [`\"${data.method}\"`, 'url'];\n    let body: string | undefined;\n\n    imports.add('requests');\n\n    if (data.body && data.bodyMediaType) {\n      const adapter = resolveMediaAdapter(data.bodyMediaType, mediaAdapters);\n      headers['Content-Type'] = data.bodyMediaType;\n\n      body = adapter?.generateExample(data as { body: unknown }, {\n        lang: 'python',\n      });\n\n      if (body) {\n        params.push('data = body');\n      }\n    }\n\n    for (const [k, v] of Object.entries(data.header)) {\n      headers[k] = v.value;\n    }\n\n    if (Object.keys(headers).length > 0) {\n      params.push(`headers = ${generatePythonObject(headers, imports)}`);\n    }\n\n    const inputCookies = Object.entries(data.cookie);\n    if (inputCookies.length > 0) {\n      const cookies: Record<string, string> = {};\n\n      for (const [k, v] of inputCookies) {\n        cookies[k] = v.value;\n      }\n\n      params.push(`cookies = ${generatePythonObject(cookies, imports)}`);\n    }\n\n    return `${Array.from(imports)\n      .map((name) => 'import ' + name)\n      .join('\\n')}\n\nurl = ${JSON.stringify(url)}\n${body ?? ''}\nresponse = requests.request(${params.join(', ')})\n\nprint(response.text)`;\n  },\n};\n\nexport function generatePythonObject(v: unknown, imports: Set<string>): string {\n  if (v === null) {\n    return 'None';\n  } else if (typeof v === 'boolean') {\n    return v ? 'True' : 'False';\n  } else if (typeof v === 'string') {\n    return JSON.stringify(v);\n  } else if (typeof v === 'number') {\n    return v.toString();\n  } else if (Array.isArray(v)) {\n    const items = v.map((item) => generatePythonObject(item, imports));\n    return `[${items.join(', ')}]`;\n  } else if (v instanceof Date) {\n    imports.add('datetime');\n    return `datetime.datetime(${v.getFullYear()}, ${v.getMonth() + 1}, ${v.getDate()}, ${v.getHours()}, ${v.getMinutes()}, ${v.getSeconds()}, ${v.getMilliseconds()})`;\n  } else if (typeof v === 'object') {\n    const entries = Object.entries(v).map(\n      ([key, value]) => `  ${JSON.stringify(key)}: ${generatePythonObject(value, imports)}`,\n    );\n    return `{\\n${entries.join(', \\n')}\\n}`;\n  } else {\n    throw new Error(`Unsupported type: ${typeof v}`);\n  }\n}\n"],"mappings":";;;AAGA,MAAa,SAA6B;CACxC,OAAO;CACP,MAAM;CACN,SAAS,KAAK,MAAM,EAAE,iBAAiB;EACrC,MAAM,UAAkC,EAAE;EAC1C,MAAM,0BAAU,IAAI,KAAa;EACjC,MAAM,SAAS,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM;EAC1C,IAAI;AAEJ,UAAQ,IAAI,WAAW;AAEvB,MAAI,KAAK,QAAQ,KAAK,eAAe;GACnC,MAAM,UAAU,oBAAoB,KAAK,eAAe,cAAc;AACtE,WAAQ,kBAAkB,KAAK;AAE/B,UAAO,SAAS,gBAAgB,MAA2B,EACzD,MAAM,UACP,CAAC;AAEF,OAAI,KACF,QAAO,KAAK,cAAc;;AAI9B,OAAK,MAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,KAAK,OAAO,CAC9C,SAAQ,KAAK,EAAE;AAGjB,MAAI,OAAO,KAAK,QAAQ,CAAC,SAAS,EAChC,QAAO,KAAK,aAAa,qBAAqB,SAAS,QAAQ,GAAG;EAGpE,MAAM,eAAe,OAAO,QAAQ,KAAK,OAAO;AAChD,MAAI,aAAa,SAAS,GAAG;GAC3B,MAAM,UAAkC,EAAE;AAE1C,QAAK,MAAM,CAAC,GAAG,MAAM,aACnB,SAAQ,KAAK,EAAE;AAGjB,UAAO,KAAK,aAAa,qBAAqB,SAAS,QAAQ,GAAG;;AAGpE,SAAO,GAAG,MAAM,KAAK,QAAQ,CAC1B,KAAK,SAAS,YAAY,KAAK,CAC/B,KAAK,KAAK,CAAC;;QAEV,KAAK,UAAU,IAAI,CAAC;EAC1B,QAAQ,GAAG;8BACiB,OAAO,KAAK,KAAK,CAAC;;;;CAI/C;AAED,SAAgB,qBAAqB,GAAY,SAA8B;AAC7E,KAAI,MAAM,KACR,QAAO;UACE,OAAO,MAAM,UACtB,QAAO,IAAI,SAAS;UACX,OAAO,MAAM,SACtB,QAAO,KAAK,UAAU,EAAE;UACf,OAAO,MAAM,SACtB,QAAO,EAAE,UAAU;UACV,MAAM,QAAQ,EAAE,CAEzB,QAAO,IADO,EAAE,KAAK,SAAS,qBAAqB,MAAM,QAAQ,CAAC,CACjD,KAAK,KAAK,CAAC;UACnB,aAAa,MAAM;AAC5B,UAAQ,IAAI,WAAW;AACvB,SAAO,qBAAqB,EAAE,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,iBAAiB,CAAC;YACvJ,OAAO,MAAM,SAItB,QAAO,MAHS,OAAO,QAAQ,EAAE,CAAC,KAC/B,CAAC,KAAK,WAAW,KAAK,KAAK,UAAU,IAAI,CAAC,IAAI,qBAAqB,OAAO,QAAQ,GACpF,CACoB,KAAK,OAAO,CAAC;KAElC,OAAM,IAAI,MAAM,qBAAqB,OAAO,IAAI"}

package/dist/requests/media/adapter.js

@@ -1,6 +1,6 @@
 import { escapeString, inputToString } from "../string-utils.js";
 import "./resolve-adapter.js";
-import js2xml from "xml-js/lib/js2xml";
+import js2xml from "xml-js/lib/js2xml.js";
 //#region src/requests/media/adapter.ts
 const defaultAdapters = {
 	"application/json": {

package/dist/requests/string-utils.js

@@ -1,4 +1,4 @@
-import js2xml from "xml-js/lib/js2xml";
+import js2xml from "xml-js/lib/js2xml.js";
 //#region src/requests/string-utils.ts
 /**
 * Convert input value to hardcoded string (with quotes)

package/dist/scalar/index.d.ts

@@ -1,4 +1,5 @@
-import { CreateAPIPageOptions } from "../ui/full.js";
+import { CreateAPIPageOptions } from "../ui/index.js";
+
 //#region src/scalar/index.d.ts
 /**
  * Enable Scalar for API playgrounds by wrapping your options inside.

package/dist/scalar/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/scalar/index.tsx"],"mappings":";;;;;AAuBA;;iBAAgB,UAAA,CAAW,OAAA,GAAS,oBAAA,GAA4B,oBAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/scalar/index.tsx"],"mappings":";;;;;AAuBA;;;iBAAgB,UAAA,CAAW,OAAA,GAAS,oBAAA,GAA4B,oBAAA"}

package/dist/server/create.d.ts

@@ -27,6 +27,8 @@ interface OpenAPIServer {
   createProxy: typeof createProxy;
   getSchemas: () => Promise<ProcessedSchemaMap>;
   getSchema: (document: string) => Promise<ProcessedDocument>;
+  /** @private internal API */
+  _getWatchPaths: () => string[];
   readonly options: OpenAPIOptions;
 }
 declare function createOpenAPI(options?: OpenAPIOptions): OpenAPIServer;

package/dist/server/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","names":[],"sources":["../../src/server/create.ts"],"mappings":";;;;;;;;AAGsE;KAKjE,SAAA,GAAY,MAAA,kBAAwB,QAAA;AAAA,KACpC,kBAAA,GAAqB,MAAA,SAAe,iBAAA;AAAA,UAExB,cAAA;EAHgC;AAAA;;;;;EAU/C,KAAA,qBAA0B,SAAA,GAAY,OAAA,CAAQ,SAAA;EAE9C,YAAA;;;;EAKA,QAAA;AAAA;AAAA,UAGe,aAAA;EACf,WAAA,SAAoB,WAAA;EACpB,UAAA,QAAkB,OAAA,CAAQ,kBAAA;EAC1B,SAAA,GAAY,QAAA,aAAqB,OAAA,CAAQ,iBAAA;EAAA,SAChC,OAAA,EAAS,cAAA;AAAA;AAAA,iBAGJ,aAAA,CAAc,OAAA,GAAS,cAAA,GAAsB,aAAA;;;AAP7D;iBAuDgB,gBAAA,GAAA,CACd,OAAA,EAAS,wBAAA,CAAyB,CAAA,IACjC,wBAAA,CAAyB,CAAA"}
+{"version":3,"file":"create.d.ts","names":[],"sources":["../../src/server/create.ts"],"mappings":";;;;;;;;AAGsE;KAMjE,SAAA,GAAY,MAAA,kBAAwB,QAAA;AAAA,KACpC,kBAAA,GAAqB,MAAA,SAAe,iBAAA;AAAA,UAExB,cAAA;EAHgC;AAAA;;;;;EAU/C,KAAA,qBAA0B,SAAA,GAAY,OAAA,CAAQ,SAAA;EAE9C,YAAA;;;;EAKA,QAAA;AAAA;AAAA,UAGe,aAAA;EACf,WAAA,SAAoB,WAAA;EACpB,UAAA,QAAkB,OAAA,CAAQ,kBAAA;EAC1B,SAAA,GAAY,QAAA,aAAqB,OAAA,CAAQ,iBAAA;EAbK;EAe9C,cAAA;EAAA,SACS,OAAA,EAAS,cAAA;AAAA;AAAA,iBAGJ,aAAA,CAAc,OAAA,GAAS,cAAA,GAAsB,aAAA;AAT7D;;;AAAA,iBAuDgB,gBAAA,GAAA,CACd,OAAA,EAAS,wBAAA,CAAyB,CAAA,IACjC,wBAAA,CAAyB,CAAA"}

package/dist/server/create.js

@@ -1,22 +1,25 @@
 import { createProxy } from "./proxy.js";
 import { processDocument } from "../utils/process-document.js";
+import fs from "node:fs";
 //#region src/server/create.ts
 function createOpenAPI(options = {}) {
 	const { input = [], disableCache = false } = options;
 	let schemas;
 	async function getSchemas() {
-		const out = {};
-		if (Array.isArray(input)) await Promise.all(input.map(async (item) => {
-			out[item] = await processDocument(item);
-		}));
-		else await Promise.all(Object.entries(await input()).map(async ([k, v]) => {
-			out[k] = await processDocument(v);
-		}));
-		return out;
+		if (Array.isArray(input)) {
+			const entries = await Promise.all(input.map(async (item) => [item, await processDocument(item)]));
+			return Object.fromEntries(entries);
+		} else {
+			const entries = await Promise.all(Object.entries(await input()).map(async ([k, v]) => [k, await processDocument(v)]));
+			return Object.fromEntries(entries);
+		}
 	}
 	return {
 		options,
 		createProxy,
+		_getWatchPaths() {
+			return (Array.isArray(input) ? input : Object.keys(input)).filter((key) => !URL.canParse(key) && fs.existsSync(key));
+		},
 		async getSchema(document) {
 			const schemas = await this.getSchemas();
 			if (document in schemas) return schemas[document];

package/dist/server/create.js.map

@@ -1 +1 @@
-{"version":3,"file":"create.js","names":[],"sources":["../../src/server/create.ts"],"sourcesContent":["import { createProxy } from '@/server/proxy';\nimport { processDocument, type ProcessedDocument } from '@/utils/process-document';\nimport type { Document } from '@/types';\nimport type { InlineCodeUsageGenerator } from '@/requests/generators';\n\n/**\n * schema id -> file path, URL, or downloaded schema object\n */\ntype SchemaMap = Record<string, string | Document>;\ntype ProcessedSchemaMap = Record<string, ProcessedDocument>;\n\nexport interface OpenAPIOptions {\n  /**\n   * Schema files, can be:\n   * - URL\n   * - file path\n   * - a function returning records of downloaded schemas.\n   */\n  input?: string[] | (() => SchemaMap | Promise<SchemaMap>);\n\n  disableCache?: boolean;\n\n  /**\n   * The url of proxy to avoid CORS issues\n   */\n  proxyUrl?: string;\n}\n\nexport interface OpenAPIServer {\n  createProxy: typeof createProxy;\n  getSchemas: () => Promise<ProcessedSchemaMap>;\n  getSchema: (document: string) => Promise<ProcessedDocument>;\n  readonly options: OpenAPIOptions;\n}\n\nexport function createOpenAPI(options: OpenAPIOptions = {}): OpenAPIServer {\n  const { input = [], disableCache = false } = options;\n  let schemas: Promise<ProcessedSchemaMap> | undefined;\n\n  async function getSchemas() {\n    const out: ProcessedSchemaMap = {};\n\n    if (Array.isArray(input)) {\n      await Promise.all(\n        input.map(async (item) => {\n          out[item] = await processDocument(item);\n        }),\n      );\n    } else {\n      await Promise.all(\n        Object.entries(await input()).map(async ([k, v]) => {\n          out[k] = await processDocument(v);\n        }),\n      );\n    }\n\n    return out;\n  }\n\n  return {\n    options,\n    createProxy,\n    async getSchema(document) {\n      const schemas = await this.getSchemas();\n      if (document in schemas) return schemas[document];\n\n      console.warn(\n        `[Fumadocs OpenAPI] the document \"${document}\" is not listed in the input array, this may not be expected.`,\n      );\n      // do not cache unlisted documents\n      return processDocument(document);\n    },\n    async getSchemas() {\n      if (disableCache) return getSchemas();\n\n      return (schemas ??= getSchemas());\n    },\n  };\n}\n\n/**\n * @deprecated\n */\nexport function createCodeSample<T>(\n  options: InlineCodeUsageGenerator<T>,\n): InlineCodeUsageGenerator<T> {\n  return options;\n}\n"],"mappings":";;;AAmCA,SAAgB,cAAc,UAA0B,EAAE,EAAiB;CACzE,MAAM,EAAE,QAAQ,EAAE,EAAE,eAAe,UAAU;CAC7C,IAAI;CAEJ,eAAe,aAAa;EAC1B,MAAM,MAA0B,EAAE;AAElC,MAAI,MAAM,QAAQ,MAAM,CACtB,OAAM,QAAQ,IACZ,MAAM,IAAI,OAAO,SAAS;AACxB,OAAI,QAAQ,MAAM,gBAAgB,KAAK;IACvC,CACH;MAED,OAAM,QAAQ,IACZ,OAAO,QAAQ,MAAM,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,OAAO;AAClD,OAAI,KAAK,MAAM,gBAAgB,EAAE;IACjC,CACH;AAGH,SAAO;;AAGT,QAAO;EACL;EACA;EACA,MAAM,UAAU,UAAU;GACxB,MAAM,UAAU,MAAM,KAAK,YAAY;AACvC,OAAI,YAAY,QAAS,QAAO,QAAQ;AAExC,WAAQ,KACN,oCAAoC,SAAS,+DAC9C;AAED,UAAO,gBAAgB,SAAS;;EAElC,MAAM,aAAa;AACjB,OAAI,aAAc,QAAO,YAAY;AAErC,UAAQ,YAAY,YAAY;;EAEnC;;;;;AAMH,SAAgB,iBACd,SAC6B;AAC7B,QAAO"}
+{"version":3,"file":"create.js","names":[],"sources":["../../src/server/create.ts"],"sourcesContent":["import { createProxy } from '@/server/proxy';\nimport { processDocument, type ProcessedDocument } from '@/utils/process-document';\nimport type { Document } from '@/types';\nimport type { InlineCodeUsageGenerator } from '@/requests/generators';\nimport fs from 'node:fs';\n\n/**\n * schema id -> file path, URL, or downloaded schema object\n */\ntype SchemaMap = Record<string, string | Document>;\ntype ProcessedSchemaMap = Record<string, ProcessedDocument>;\n\nexport interface OpenAPIOptions {\n  /**\n   * Schema files, can be:\n   * - URL\n   * - file path\n   * - a function returning records of downloaded schemas.\n   */\n  input?: string[] | (() => SchemaMap | Promise<SchemaMap>);\n\n  disableCache?: boolean;\n\n  /**\n   * The url of proxy to avoid CORS issues\n   */\n  proxyUrl?: string;\n}\n\nexport interface OpenAPIServer {\n  createProxy: typeof createProxy;\n  getSchemas: () => Promise<ProcessedSchemaMap>;\n  getSchema: (document: string) => Promise<ProcessedDocument>;\n  /** @private internal API */\n  _getWatchPaths: () => string[];\n  readonly options: OpenAPIOptions;\n}\n\nexport function createOpenAPI(options: OpenAPIOptions = {}): OpenAPIServer {\n  const { input = [], disableCache = false } = options;\n  let schemas: Promise<ProcessedSchemaMap> | undefined;\n\n  async function getSchemas(): Promise<ProcessedSchemaMap> {\n    if (Array.isArray(input)) {\n      const entries = await Promise.all(\n        input.map(async (item) => [item, await processDocument(item)]),\n      );\n      return Object.fromEntries(entries);\n    } else {\n      const entries = await Promise.all(\n        Object.entries(await input()).map(async ([k, v]) => [k, await processDocument(v)]),\n      );\n      return Object.fromEntries(entries);\n    }\n  }\n\n  return {\n    options,\n    createProxy,\n    _getWatchPaths() {\n      const keys = Array.isArray(input) ? input : Object.keys(input);\n      return keys.filter((key) => !URL.canParse(key) && fs.existsSync(key));\n    },\n    async getSchema(document) {\n      const schemas = await this.getSchemas();\n      if (document in schemas) return schemas[document];\n\n      console.warn(\n        `[Fumadocs OpenAPI] the document \"${document}\" is not listed in the input array, this may not be expected.`,\n      );\n      // do not cache unlisted documents\n      return processDocument(document);\n    },\n    async getSchemas() {\n      if (disableCache) return getSchemas();\n\n      return (schemas ??= getSchemas());\n    },\n  };\n}\n\n/**\n * @deprecated\n */\nexport function createCodeSample<T>(\n  options: InlineCodeUsageGenerator<T>,\n): InlineCodeUsageGenerator<T> {\n  return options;\n}\n"],"mappings":";;;;AAsCA,SAAgB,cAAc,UAA0B,EAAE,EAAiB;CACzE,MAAM,EAAE,QAAQ,EAAE,EAAE,eAAe,UAAU;CAC7C,IAAI;CAEJ,eAAe,aAA0C;AACvD,MAAI,MAAM,QAAQ,MAAM,EAAE;GACxB,MAAM,UAAU,MAAM,QAAQ,IAC5B,MAAM,IAAI,OAAO,SAAS,CAAC,MAAM,MAAM,gBAAgB,KAAK,CAAC,CAAC,CAC/D;AACD,UAAO,OAAO,YAAY,QAAQ;SAC7B;GACL,MAAM,UAAU,MAAM,QAAQ,IAC5B,OAAO,QAAQ,MAAM,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,OAAO,CAAC,GAAG,MAAM,gBAAgB,EAAE,CAAC,CAAC,CACnF;AACD,UAAO,OAAO,YAAY,QAAQ;;;AAItC,QAAO;EACL;EACA;EACA,iBAAiB;AAEf,WADa,MAAM,QAAQ,MAAM,GAAG,QAAQ,OAAO,KAAK,MAAM,EAClD,QAAQ,QAAQ,CAAC,IAAI,SAAS,IAAI,IAAI,GAAG,WAAW,IAAI,CAAC;;EAEvE,MAAM,UAAU,UAAU;GACxB,MAAM,UAAU,MAAM,KAAK,YAAY;AACvC,OAAI,YAAY,QAAS,QAAO,QAAQ;AAExC,WAAQ,KACN,oCAAoC,SAAS,+DAC9C;AAED,UAAO,gBAAgB,SAAS;;EAElC,MAAM,aAAa;AACjB,OAAI,aAAc,QAAO,YAAY;AAErC,UAAQ,YAAY,YAAY;;EAEnC;;;;;AAMH,SAAgB,iBACd,SAC6B;AAC7B,QAAO"}

package/dist/server/source-api.d.ts

@@ -1,8 +1,9 @@
 import { OpenAPIServer } from "./create.js";
 import { ApiPageProps } from "../ui/api-page.js";
 import { SchemaToPagesOptions } from "../utils/pages/preset-auto.js";
+import { ClientApiPageProps } from "../ui/create-client.js";
 import { ProcessedDocument } from "../utils/process-document.js";
-import { LoaderPlugin, PageData, PageTreeTransformer, Source } from "fumadocs-core/source";
+import { LoaderPlugin, MetaData, PageData, PageTreeTransformer, Source } from "fumadocs-core/source";
 import { StructuredData } from "fumadocs-core/mdx-plugins";
 import { TOCItemType } from "fumadocs-core/toc";
 
@@ -28,16 +29,21 @@ interface OpenAPIPageData extends PageData {
   getSchema: () => {
     id: string;
   } & ProcessedDocument;
+  getClientAPIPageProps: () => Promise<ClientApiPageProps>;
   structuredData: StructuredData;
   toc: TOCItemType[];
 }
+interface MetaOptions {
+  folderStyle?: 'folder' | 'separator';
+}
 /**
  * Generate virtual pages for Fumadocs Source API
  */
 declare function openapiSource(server: OpenAPIServer, options?: SchemaToPagesOptions & {
-  baseDir?: string;
+  baseDir?: string; /** Generate `meta.json` files */
+  meta?: boolean | MetaOptions;
 }): Promise<Source<{
-  metaData: never;
+  metaData: MetaData;
   pageData: OpenAPIPageData;
 }>>;
 /**

package/dist/server/source-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-api.d.ts","names":[],"sources":["../../src/server/source-api.tsx"],"mappings":";;;;;;;;;;YAgBmB,QAAA;IAH+C;;;IAO9D,QAAA,GAAW,mBAAA;EAAA;AAAA;AAAA,UAIE,mBAAA;EACf,MAAA;EACA,OAAA;AAAA;AAFF;;;AAAA,iBAQgB,aAAA,CAAA,GAAiB,YAAA;AAAA,UAuCvB,eAAA,SAAwB,QAAA;EAChC,eAAA,QAAuB,YAAA;EACvB,SAAA;IAAmB,EAAA;EAAA,IAAe,iBAAA;EAClC,cAAA,EAAgB,cAAA;EAChB,GAAA,EAAK,WAAA;AAAA;;;;iBAMe,aAAA,CACpB,MAAA,EAAQ,aAAA,EACR,OAAA,GAAS,oBAAA;EACP,OAAA;AAAA,IAED,OAAA,CACD,MAAA;EACE,QAAA;EACA,QAAA,EAAU,eAAA;AAAA;;;;iBAuDE,kBAAA,CAAA,GAAsB,mBAAA"}
+{"version":3,"file":"source-api.d.ts","names":[],"sources":["../../src/server/source-api.tsx"],"mappings":";;;;;;;;;;;YA2BmB,QAAA;IAJ0C;;;IAQzD,QAAA,GAAW,mBAAA;EAAA;AAAA;AAAA,UAIE,mBAAA;EACf,MAAA;EACA,OAAA;AAAA;AAFF;;;AAAA,iBAQgB,aAAA,CAAA,GAAiB,YAAA;AAAA,UAuCvB,eAAA,SAAwB,QAAA;EAChC,eAAA,QAAuB,YAAA;EACvB,SAAA;IAAmB,EAAA;EAAA,IAAe,iBAAA;EAClC,qBAAA,QAA6B,OAAA,CAAQ,kBAAA;EACrC,cAAA,EAAgB,cAAA;EAChB,GAAA,EAAK,WAAA;AAAA;AAAA,UAGG,WAAA;EACR,WAAA;AAAA;;;;iBAMoB,aAAA,CACpB,MAAA,EAAQ,aAAA,EACR,OAAA,GAAS,oBAAA;EACP,OAAA,WAlBsC;EAoBtC,IAAA,aAAiB,WAAA;AAAA,IAElB,OAAA,CACD,MAAA;EACE,QAAA,EAAU,QAAA;EACV,QAAA,EAAU,eAAA;AAAA;;;;iBAqIE,kBAAA,CAAA,GAAsB,mBAAA"}

package/dist/server/source-api.js

@@ -1,4 +1,7 @@
+import { toStaticData } from "../utils/pages/to-static-data.js";
 import { MethodLabel } from "../ui/components/method-label.js";
+import path from "node:path";
+import { PathUtils } from "fumadocs-core/source";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 //#region src/server/source-api.tsx
 /**
@@ -38,18 +41,15 @@ function openapiPlugin() {
 * Generate virtual pages for Fumadocs Source API
 */
 async function openapiSource(server, options = {}) {
-	const { baseDir = "" } = options;
+	const { baseDir = "", meta = false } = options;
 	const { createAutoPreset } = await import("../utils/pages/preset-auto.js");
 	const { fromServer } = await import("../utils/pages/builder.js");
-	const { toBody } = await import("../utils/pages/to-body.js");
-	const { toStaticData } = await import("../utils/pages/to-static-data.js");
 	const files = [];
 	const entries = await fromServer(server, createAutoPreset(options));
 	for (const [schemaId, list] of Object.entries(entries)) {
 		const processed = await server.getSchema(schemaId);
-		for (const entry of list) {
-			const props = toBody(entry);
-			props.showDescription ??= true;
+		function onEntry(entry) {
+			const props = getProps(entry);
 			files.push({
 				type: "page",
 				path: `${baseDir}/${entry.path}`,
@@ -58,6 +58,15 @@ async function openapiSource(server, options = {}) {
 					getAPIPageProps() {
 						return props;
 					},
+					async getClientAPIPageProps() {
+						return {
+							payload: {
+								bundled: processed.bundled,
+								proxyUrl: server.options.proxyUrl
+							},
+							...props
+						};
+					},
 					getSchema() {
 						return {
 							id: schemaId,
@@ -72,9 +81,59 @@ async function openapiSource(server, options = {}) {
 				}
 			});
 		}
+		function onEntries(entries, parent) {
+			if (!meta) {
+				for (const entry of entries) if (entry.type === "group") onEntries(entry.entries, entry);
+				else onEntry(entry);
+				return;
+			}
+			const { folderStyle = "folder" } = meta === true ? {} : meta;
+			const pages = [];
+			for (const entry of entries) {
+				const relativePath = PathUtils.slash(parent ? path.relative(parent.path, entry.path) : entry.path);
+				if (entry.type === "group") {
+					onEntries(entry.entries, entry);
+					if (folderStyle === "folder") pages.push(relativePath);
+					else pages.push(`---${entry.info.title}---`, `...${relativePath}`);
+				} else {
+					onEntry(entry);
+					pages.push(relativePath.slice(0, -path.extname(entry.path).length));
+				}
+			}
+			if (pages.length === 0) return;
+			files.push({
+				type: "meta",
+				path: path.join(baseDir, parent?.path ?? "", "meta.json"),
+				data: {
+					title: parent?.info.title,
+					description: parent?.info.description,
+					pages
+				}
+			});
+		}
+		onEntries(list);
 	}
 	return { files };
 }
+function getProps(entry) {
+	if (entry.type === "operation") return {
+		document: entry.schemaId,
+		operations: [entry.item],
+		showDescription: true
+	};
+	if (entry.type === "webhook") return {
+		document: entry.schemaId,
+		webhooks: [entry.item],
+		showDescription: true
+	};
+	return {
+		showTitle: true,
+		showDescription: true,
+		document: entry.schemaId,
+		operations: entry.operations,
+		webhooks: entry.webhooks
+	};
+}
 /**
 * @deprecated use `openapiPlugin()`
 */

package/dist/server/source-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"source-api.js","names":[],"sources":["../../src/server/source-api.tsx"],"sourcesContent":["import { MethodLabel } from '@/ui/components/method-label';\nimport type {\n  LoaderPlugin,\n  PageData,\n  PageTreeTransformer,\n  Source,\n  VirtualFile,\n} from 'fumadocs-core/source';\nimport type { OpenAPIServer } from '@/server/create';\nimport type { SchemaToPagesOptions } from '@/utils/pages/preset-auto';\nimport type { ApiPageProps } from '@/ui/api-page';\nimport type { StructuredData } from 'fumadocs-core/mdx-plugins';\nimport type { TOCItemType } from 'fumadocs-core/toc';\nimport type { ProcessedDocument } from '@/utils/process-document';\n\ndeclare module 'fumadocs-core/source' {\n  export interface PageData {\n    /**\n     * Added by Fumadocs OpenAPI\n     */\n    _openapi?: InternalOpenAPIMeta;\n  }\n}\n\nexport interface InternalOpenAPIMeta {\n  method?: string;\n  webhook?: boolean;\n}\n\n/**\n * Fumadocs Source API integration, pass this to `plugins` array in `loader()`.\n */\nexport function openapiPlugin(): LoaderPlugin {\n  return {\n    name: 'fumadocs:openapi',\n    enforce: 'pre',\n    transformPageTree: {\n      file(node, filePath) {\n        if (!filePath) return node;\n        const file = this.storage.read(filePath);\n        if (!file || file.format !== 'page') return node;\n\n        const openApiData = file.data._openapi;\n        if (!openApiData || typeof openApiData !== 'object') return node;\n\n        if (openApiData.webhook) {\n          node.name = (\n            <>\n              {node.name}{' '}\n              <span className=\"ms-auto border border-current px-1 rounded-lg text-xs text-nowrap font-mono\">\n                Webhook\n              </span>\n            </>\n          );\n        } else if (openApiData.method) {\n          node.name = (\n            <>\n              {node.name}{' '}\n              <MethodLabel className=\"ms-auto text-xs text-nowrap\">\n                {openApiData.method}\n              </MethodLabel>\n            </>\n          );\n        }\n\n        return node;\n      },\n    },\n  };\n}\n\ninterface OpenAPIPageData extends PageData {\n  getAPIPageProps: () => ApiPageProps;\n  getSchema: () => { id: string } & ProcessedDocument;\n  structuredData: StructuredData;\n  toc: TOCItemType[];\n}\n\n/**\n * Generate virtual pages for Fumadocs Source API\n */\nexport async function openapiSource(\n  server: OpenAPIServer,\n  options: SchemaToPagesOptions & {\n    baseDir?: string;\n  } = {},\n): Promise<\n  Source<{\n    metaData: never;\n    pageData: OpenAPIPageData;\n  }>\n> {\n  const { baseDir = '' } = options;\n  const { createAutoPreset } = await import('@/utils/pages/preset-auto');\n  const { fromServer } = await import('@/utils/pages/builder');\n  const { toBody } = await import('@/utils/pages/to-body');\n  const { toStaticData } = await import('@/utils/pages/to-static-data');\n  const files: VirtualFile<{\n    pageData: OpenAPIPageData;\n    metaData: never;\n  }>[] = [];\n\n  const entries = await fromServer(server, createAutoPreset(options));\n  for (const [schemaId, list] of Object.entries(entries)) {\n    const processed = await server.getSchema(schemaId);\n    for (const entry of list) {\n      const props = toBody(entry);\n      props.showDescription ??= true;\n\n      files.push({\n        type: 'page',\n        path: `${baseDir}/${entry.path}`,\n        data: {\n          ...entry.info,\n          getAPIPageProps() {\n            return props;\n          },\n          getSchema() {\n            return {\n              id: schemaId,\n              ...processed,\n            };\n          },\n          ...toStaticData(props, processed.dereferenced),\n          _openapi: {\n            method:\n              entry.type === 'operation' || entry.type === 'webhook'\n                ? entry.item.method\n                : undefined,\n            webhook: entry.type === 'webhook',\n          },\n        },\n      });\n    }\n  }\n\n  return {\n    files,\n  };\n}\n\n/**\n * @deprecated use `openapiPlugin()`\n */\nexport function transformerOpenAPI(): PageTreeTransformer {\n  return openapiPlugin().transformPageTree!;\n}\n"],"mappings":";;;;;;AAgCA,SAAgB,gBAA8B;AAC5C,QAAO;EACL,MAAM;EACN,SAAS;EACT,mBAAmB,EACjB,KAAK,MAAM,UAAU;AACnB,OAAI,CAAC,SAAU,QAAO;GACtB,MAAM,OAAO,KAAK,QAAQ,KAAK,SAAS;AACxC,OAAI,CAAC,QAAQ,KAAK,WAAW,OAAQ,QAAO;GAE5C,MAAM,cAAc,KAAK,KAAK;AAC9B,OAAI,CAAC,eAAe,OAAO,gBAAgB,SAAU,QAAO;AAE5D,OAAI,YAAY,QACd,MAAK,OACH,qBAAA,UAAA,EAAA,UAAA;IACG,KAAK;IAAM;IACZ,oBAAC,QAAD;KAAM,WAAU;eAA8E;KAEvF,CAAA;IACN,EAAA,CAAA;YAEI,YAAY,OACrB,MAAK,OACH,qBAAA,UAAA,EAAA,UAAA;IACG,KAAK;IAAM;IACZ,oBAAC,aAAD;KAAa,WAAU;eACpB,YAAY;KACD,CAAA;IACb,EAAA,CAAA;AAIP,UAAO;KAEV;EACF;;;;;AAaH,eAAsB,cACpB,QACA,UAEI,EAAE,EAMN;CACA,MAAM,EAAE,UAAU,OAAO;CACzB,MAAM,EAAE,qBAAqB,MAAM,OAAO;CAC1C,MAAM,EAAE,eAAe,MAAM,OAAO;CACpC,MAAM,EAAE,WAAW,MAAM,OAAO;CAChC,MAAM,EAAE,iBAAiB,MAAM,OAAO;CACtC,MAAM,QAGC,EAAE;CAET,MAAM,UAAU,MAAM,WAAW,QAAQ,iBAAiB,QAAQ,CAAC;AACnE,MAAK,MAAM,CAAC,UAAU,SAAS,OAAO,QAAQ,QAAQ,EAAE;EACtD,MAAM,YAAY,MAAM,OAAO,UAAU,SAAS;AAClD,OAAK,MAAM,SAAS,MAAM;GACxB,MAAM,QAAQ,OAAO,MAAM;AAC3B,SAAM,oBAAoB;AAE1B,SAAM,KAAK;IACT,MAAM;IACN,MAAM,GAAG,QAAQ,GAAG,MAAM;IAC1B,MAAM;KACJ,GAAG,MAAM;KACT,kBAAkB;AAChB,aAAO;;KAET,YAAY;AACV,aAAO;OACL,IAAI;OACJ,GAAG;OACJ;;KAEH,GAAG,aAAa,OAAO,UAAU,aAAa;KAC9C,UAAU;MACR,QACE,MAAM,SAAS,eAAe,MAAM,SAAS,YACzC,MAAM,KAAK,SACX,KAAA;MACN,SAAS,MAAM,SAAS;MACzB;KACF;IACF,CAAC;;;AAIN,QAAO,EACL,OACD;;;;;AAMH,SAAgB,qBAA0C;AACxD,QAAO,eAAe,CAAC"}
+{"version":3,"file":"source-api.js","names":[],"sources":["../../src/server/source-api.tsx"],"sourcesContent":["import { MethodLabel } from '@/ui/components/method-label';\nimport {\n  PathUtils,\n  type LoaderPlugin,\n  type MetaData,\n  type PageData,\n  type PageTreeTransformer,\n  type Source,\n  type VirtualFile,\n} from 'fumadocs-core/source';\nimport type { OpenAPIServer } from '@/server/create';\nimport type { SchemaToPagesOptions } from '@/utils/pages/preset-auto';\nimport type { ApiPageProps } from '@/ui/api-page';\nimport type { StructuredData } from 'fumadocs-core/mdx-plugins';\nimport type { TOCItemType } from 'fumadocs-core/toc';\nimport type { ProcessedDocument } from '@/utils/process-document';\nimport type {\n  OperationOutput,\n  OutputEntry,\n  PageOutput,\n  WebhookOutput,\n} from '@/utils/pages/builder';\nimport path from 'node:path';\nimport type { ClientApiPageProps } from '@/ui/create-client';\nimport { toStaticData } from '@/utils/pages/to-static-data';\n\ndeclare module 'fumadocs-core/source' {\n  export interface PageData {\n    /**\n     * Added by Fumadocs OpenAPI\n     */\n    _openapi?: InternalOpenAPIMeta;\n  }\n}\n\nexport interface InternalOpenAPIMeta {\n  method?: string;\n  webhook?: boolean;\n}\n\n/**\n * Fumadocs Source API integration, pass this to `plugins` array in `loader()`.\n */\nexport function openapiPlugin(): LoaderPlugin {\n  return {\n    name: 'fumadocs:openapi',\n    enforce: 'pre',\n    transformPageTree: {\n      file(node, filePath) {\n        if (!filePath) return node;\n        const file = this.storage.read(filePath);\n        if (!file || file.format !== 'page') return node;\n\n        const openApiData = file.data._openapi;\n        if (!openApiData || typeof openApiData !== 'object') return node;\n\n        if (openApiData.webhook) {\n          node.name = (\n            <>\n              {node.name}{' '}\n              <span className=\"ms-auto border border-current px-1 rounded-lg text-xs text-nowrap font-mono\">\n                Webhook\n              </span>\n            </>\n          );\n        } else if (openApiData.method) {\n          node.name = (\n            <>\n              {node.name}{' '}\n              <MethodLabel className=\"ms-auto text-xs text-nowrap\">\n                {openApiData.method}\n              </MethodLabel>\n            </>\n          );\n        }\n\n        return node;\n      },\n    },\n  };\n}\n\ninterface OpenAPIPageData extends PageData {\n  getAPIPageProps: () => ApiPageProps;\n  getSchema: () => { id: string } & ProcessedDocument;\n  getClientAPIPageProps: () => Promise<ClientApiPageProps>;\n  structuredData: StructuredData;\n  toc: TOCItemType[];\n}\n\ninterface MetaOptions {\n  folderStyle?: 'folder' | 'separator';\n}\n\n/**\n * Generate virtual pages for Fumadocs Source API\n */\nexport async function openapiSource(\n  server: OpenAPIServer,\n  options: SchemaToPagesOptions & {\n    baseDir?: string;\n    /** Generate `meta.json` files */\n    meta?: boolean | MetaOptions;\n  } = {},\n): Promise<\n  Source<{\n    metaData: MetaData;\n    pageData: OpenAPIPageData;\n  }>\n> {\n  const { baseDir = '', meta = false } = options;\n  const { createAutoPreset } = await import('@/utils/pages/preset-auto');\n  const { fromServer } = await import('@/utils/pages/builder');\n  const files: VirtualFile<{\n    pageData: OpenAPIPageData;\n    metaData: MetaData;\n  }>[] = [];\n\n  const entries = await fromServer(server, createAutoPreset(options));\n  for (const [schemaId, list] of Object.entries(entries)) {\n    const processed = await server.getSchema(schemaId);\n\n    function onEntry(entry: PageOutput | OperationOutput | WebhookOutput) {\n      const props = getProps(entry);\n\n      files.push({\n        type: 'page',\n        path: `${baseDir}/${entry.path}`,\n        data: {\n          ...entry.info,\n          getAPIPageProps() {\n            return props;\n          },\n          async getClientAPIPageProps() {\n            return {\n              payload: {\n                bundled: processed.bundled,\n                proxyUrl: server.options.proxyUrl,\n              },\n              ...props,\n            };\n          },\n          getSchema() {\n            return {\n              id: schemaId,\n              ...processed,\n            };\n          },\n          ...toStaticData(props, processed.dereferenced),\n          _openapi: {\n            method:\n              entry.type === 'operation' || entry.type === 'webhook'\n                ? entry.item.method\n                : undefined,\n            webhook: entry.type === 'webhook',\n          },\n        },\n      });\n    }\n\n    function onEntries(entries: OutputEntry[], parent?: OutputEntry) {\n      if (!meta) {\n        for (const entry of entries) {\n          if (entry.type === 'group') {\n            onEntries(entry.entries, entry);\n          } else {\n            onEntry(entry);\n          }\n        }\n\n        return;\n      }\n\n      const { folderStyle = 'folder' } = meta === true ? {} : meta;\n      const pages: string[] = [];\n\n      for (const entry of entries) {\n        const relativePath = PathUtils.slash(\n          parent ? path.relative(parent.path, entry.path) : entry.path,\n        );\n\n        if (entry.type === 'group') {\n          onEntries(entry.entries, entry);\n          if (folderStyle === 'folder') {\n            pages.push(relativePath);\n          } else {\n            pages.push(`---${entry.info.title}---`, `...${relativePath}`);\n          }\n        } else {\n          onEntry(entry);\n          pages.push(relativePath.slice(0, -path.extname(entry.path).length));\n        }\n      }\n\n      if (pages.length === 0) return;\n      files.push({\n        type: 'meta',\n        path: path.join(baseDir, parent?.path ?? '', 'meta.json'),\n        data: {\n          title: parent?.info.title,\n          description: parent?.info.description,\n          pages,\n        },\n      });\n    }\n\n    onEntries(list);\n  }\n\n  return {\n    files,\n  };\n}\n\nfunction getProps(entry: PageOutput | OperationOutput | WebhookOutput): ApiPageProps {\n  if (entry.type === 'operation')\n    return {\n      document: entry.schemaId,\n      operations: [entry.item],\n      showDescription: true,\n    };\n  if (entry.type === 'webhook')\n    return {\n      document: entry.schemaId,\n      webhooks: [entry.item],\n      showDescription: true,\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\n/**\n * @deprecated use `openapiPlugin()`\n */\nexport function transformerOpenAPI(): PageTreeTransformer {\n  return openapiPlugin().transformPageTree!;\n}\n"],"mappings":"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"}

package/dist/types.d.ts

@@ -1,11 +1,10 @@
 import { OpenAPIV3, OpenAPIV3_2 } from "./_openapi/types.js";
-import { NoReference } from "./utils/schema.js";
+import { NoReference } from "./utils/schema/index.js";
 import { MediaAdapter } from "./requests/media/adapter.js";
 import { InlineCodeUsageGenerator } from "./requests/generators/index.js";
 import { OpenAPIOptions } from "./server/create.js";
 import { CreateAPIPageOptions } from "./ui/base.js";
 import { ProcessedDocument } from "./utils/process-document.js";
-import Slugger from "github-slugger";
 import { HTMLAttributes, ReactNode } from "react";
 
 //#region src/types.d.ts
@@ -32,8 +31,7 @@ type MethodInformation = NoReference<OperationObject> & {
   'x-exclusiveCodeSample'?: string;
 };
 type RequireKeys<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
-interface RenderContext extends Pick<OpenAPIOptions, 'proxyUrl'>, Omit<RequireKeys<CreateAPIPageOptions, 'generateTypeScriptDefinitions' | 'renderMarkdown'>, 'renderCodeBlock' | 'renderHeading'> {
-  slugger: Slugger;
+interface RenderContext extends Pick<OpenAPIOptions, 'proxyUrl'>, Omit<RequireKeys<CreateAPIPageOptions, 'renderMarkdown' | 'generateTypeScriptDefinitions'>, 'renderCodeBlock' | 'renderHeading' | 'generateTypeScriptSchema'> {
   /**
    * dereferenced schema
    */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;;;;;;;KAUY,QAAA,GAAW,WAAA,CAAY,QAAA;AAAA,KACvB,eAAA,GAAkB,WAAA,CAAY,eAAA;AAAA,KAC9B,eAAA,GAAkB,WAAA,CAAY,eAAA;AAAA,KAC9B,oBAAA,GAAuB,WAAA,CAAY,oBAAA;AAAA,KACnC,eAAA,GAAkB,WAAA,CAAY,eAAA;AAAA,KAC9B,cAAA,GAAiB,WAAA,CAAY,cAAA;AAAA,KAC7B,SAAA,GAAY,WAAA,CAAY,SAAA;AAAA,KACxB,YAAA,GAAe,WAAA,CAAY,YAAA;AAAA,KAC3B,cAAA,GAAiB,WAAA,CAAY,cAAA;AAAA,KAC7B,oBAAA,GAAuB,SAAA,CAAU,oBAAA;AAAA,KACjC,cAAA,GAAiB,WAAA,CAAY,cAAA;AAAA,KAC7B,oBAAA,GAAuB,WAAA,CAAY,oBAAA;AAAA,KACnC,WAAA,GAAc,WAAA,CAAY,WAAA;AAAA,KAC1B,aAAA,GAAgB,WAAA,CAAY,aAAA;AAAA,KAC5B,eAAA,GAAkB,WAAA,CAAY,eAAA;AAAA,KAC9B,iBAAA,GAAoB,WAAA,CAAY,iBAAA;AAAA,KAEhC,iBAAA,GAAoB,WAAA,CAAY,eAAA;EAC1C,MAAA;EACA,eAAA,GAAkB,wBAAA;EAClB,sBAAA;EACA,uBAAA;AAAA;AAAA,KAGG,WAAA,oBAA+B,CAAA,IAAK,IAAA,CAAK,CAAA,EAAG,CAAA,IAAK,QAAA,CAAS,IAAA,CAAK,CAAA,EAAG,CAAA;AAAA,UAEtD,aAAA,SAEb,IAAA,CAAK,cAAA,eACL,IAAA,CACE,WAAA,CAAY,oBAAA;EAGhB,OAAA,EAAS,OAAA;;;;EAKT,MAAA,EAAQ,iBAAA;EAER,aAAA,EAAe,MAAA,SAAe,YAAA;EAE9B,aAAA,GACE,KAAA,UACA,IAAA,WAAe,SAAA,EACf,KAAA,GAAQ,cAAA,CAAe,kBAAA;IAAwB,EAAA;EAAA,MAC5C,SAAA;EACL,eAAA,GAAkB,IAAA,UAAc,IAAA,aAAiB,SAAA;AAAA;AAAA,KAGvC,gBAAA,cAA8B,WAAA,IAAe,CAAA,mBAAoB,IAAA,CAAK,CAAA,EAAG,CAAA;AAAA,KACzE,SAAA,MAAe,CAAA,GAAI,OAAA,CAAQ,CAAA"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;;;;;;KASY,QAAA,GAAW,WAAA,CAAY,QAAA;AAAA,KACvB,eAAA,GAAkB,WAAA,CAAY,eAAA;AAAA,KAC9B,eAAA,GAAkB,WAAA,CAAY,eAAA;AAAA,KAC9B,oBAAA,GAAuB,WAAA,CAAY,oBAAA;AAAA,KACnC,eAAA,GAAkB,WAAA,CAAY,eAAA;AAAA,KAC9B,cAAA,GAAiB,WAAA,CAAY,cAAA;AAAA,KAC7B,SAAA,GAAY,WAAA,CAAY,SAAA;AAAA,KACxB,YAAA,GAAe,WAAA,CAAY,YAAA;AAAA,KAC3B,cAAA,GAAiB,WAAA,CAAY,cAAA;AAAA,KAC7B,oBAAA,GAAuB,SAAA,CAAU,oBAAA;AAAA,KACjC,cAAA,GAAiB,WAAA,CAAY,cAAA;AAAA,KAC7B,oBAAA,GAAuB,WAAA,CAAY,oBAAA;AAAA,KACnC,WAAA,GAAc,WAAA,CAAY,WAAA;AAAA,KAC1B,aAAA,GAAgB,WAAA,CAAY,aAAA;AAAA,KAC5B,eAAA,GAAkB,WAAA,CAAY,eAAA;AAAA,KAC9B,iBAAA,GAAoB,WAAA,CAAY,iBAAA;AAAA,KAEhC,iBAAA,GAAoB,WAAA,CAAY,eAAA;EAC1C,MAAA;EACA,eAAA,GAAkB,wBAAA;EAClB,sBAAA;EACA,uBAAA;AAAA;AAAA,KAGG,WAAA,oBAA+B,CAAA,IAAK,IAAA,CAAK,CAAA,EAAG,CAAA,IAAK,QAAA,CAAS,IAAA,CAAK,CAAA,EAAG,CAAA;AAAA,UAEtD,aAAA,SAEb,IAAA,CAAK,cAAA,eACL,IAAA,CACE,WAAA,CAAY,oBAAA;EA1BS;;;EAgCzB,MAAA,EAAQ,iBAAA;EAER,aAAA,EAAe,MAAA,SAAe,YAAA;EAE9B,aAAA,GACE,KAAA,UACA,IAAA,WAAe,SAAA,EACf,KAAA,GAAQ,cAAA,CAAe,kBAAA;IAAwB,EAAA;EAAA,MAC5C,SAAA;EACL,eAAA,GAAkB,IAAA,UAAc,IAAA,aAAiB,SAAA;AAAA;AAAA,KAGvC,gBAAA,cAA8B,WAAA,IAAe,CAAA,mBAAoB,IAAA,CAAK,CAAA,EAAG,CAAA;AAAA,KACzE,SAAA,MAAe,CAAA,GAAI,OAAA,CAAQ,CAAA"}

package/dist/ui/api-page.d.ts

@@ -1,8 +1,8 @@
 import { HttpMethods } from "../types.js";
-import { ProcessedDocument } from "../utils/process-document.js";
+
 //#region src/ui/api-page.d.ts
 interface ApiPageProps {
-  document: Promise<ProcessedDocument> | string | ProcessedDocument;
+  document: string;
   showTitle?: boolean;
   showDescription?: boolean;
   /**