fumadocs-openapi 10.4.1 → 10.6.0

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

@@ -1,73 +1,76 @@
-import { getPreferredType } from "../../utils/schema.js";
+import { getPreferredType } from "../../utils/schema/index.js";
 import { I18nLabel } from "../client/i18n.js";
 import { AccordionContent, AccordionHeader, AccordionItem, AccordionTrigger, Accordions } from "../components/accordion.js";
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useMemo } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { sample } from "openapi-sampler";
 import { Tab, Tabs } from "fumadocs-ui/components/tabs";
 //#region src/ui/operation/response-tabs.tsx
 function ResponseTabs({ operation, ctx }) {
-	if (!operation.responses) return null;
-	const tabs = [];
-	for (const [code, response] of Object.entries(operation.responses)) {
-		const media = response.content ? getPreferredType(response.content) : null;
-		const responseOfType = media ? response.content?.[media] : null;
-		const tab = {
-			code,
-			response,
-			mediaType: media
-		};
-		if (responseOfType?.examples) {
-			tab.examples ??= [];
-			for (const [key, sample] of Object.entries(responseOfType.examples)) tab.examples.push({
-				label: sample?.summary ?? /* @__PURE__ */ jsx(I18nLabel, {
-					label: "responseTabName",
-					replacements: { key }
-				}),
-				sample: sample.value,
-				description: sample?.description
-			});
-		} else if (responseOfType?.example || responseOfType?.schema) {
-			tab.examples ??= [];
-			tab.examples.push({
-				label: /* @__PURE__ */ jsx(I18nLabel, { label: "responseTabNameDefault" }),
-				sample: responseOfType.example ?? sample(responseOfType.schema)
-			});
+	const tabs = useMemo(() => {
+		const tabs = [];
+		if (!operation.responses) return tabs;
+		for (const [code, response] of Object.entries(operation.responses)) {
+			const media = response.content ? getPreferredType(response.content) : null;
+			const responseOfType = media ? response.content?.[media] : null;
+			const tab = {
+				code,
+				response,
+				mediaType: media
+			};
+			if (responseOfType?.examples) {
+				tab.examples ??= [];
+				for (const [key, sample] of Object.entries(responseOfType.examples)) tab.examples.push({
+					label: sample?.summary ?? /* @__PURE__ */ jsx(I18nLabel, {
+						label: "responseTabName",
+						replacements: { key }
+					}),
+					sample: sample.value,
+					description: sample?.description
+				});
+			} else if (responseOfType?.example || responseOfType?.schema) {
+				tab.examples ??= [];
+				tab.examples.push({
+					label: /* @__PURE__ */ jsx(I18nLabel, { label: "responseTabNameDefault" }),
+					sample: responseOfType.example ?? sample(responseOfType.schema)
+				});
+			}
+			tabs.push(tab);
 		}
-		tabs.push(tab);
-	}
+		return tabs;
+	}, [operation.responses]);
+	if (tabs.length === 0) return null;
 	const { renderResponseTabs = renderResponseTabsDefault } = ctx.content ?? {};
 	return renderResponseTabs(tabs, ctx);
 }
 function renderResponseTabsDefault(tabs, ctx) {
 	function renderExampleContent(example) {
-		return /* @__PURE__ */ jsxs(Fragment, { children: [example.description && ctx.renderMarkdown(example.description), ctx.renderCodeBlock("json", JSON.stringify(example.sample, null, 2))] });
+		return /* @__PURE__ */ jsxs(Fragment$1, { children: [example.description && ctx.renderMarkdown(example.description), ctx.renderCodeBlock("json", JSON.stringify(example.sample, null, 2))] });
 	}
-	async function renderResponse(tab) {
-		const { examples = [] } = tab;
-		let slot = /* @__PURE__ */ jsx(I18nLabel, { label: "empty" });
-		if (examples.length > 1) slot = /* @__PURE__ */ jsx(Accordions, {
-			type: "single",
-			className: "pt-2",
-			defaultValue: "0",
-			children: examples.map((example, i) => /* @__PURE__ */ jsxs(AccordionItem, {
-				value: i.toString(),
-				children: [/* @__PURE__ */ jsx(AccordionHeader, { children: /* @__PURE__ */ jsx(AccordionTrigger, { children: example.label }) }), /* @__PURE__ */ jsx(AccordionContent, {
-					className: "prose-no-margin",
-					children: renderExampleContent(example)
-				})]
-			}, i))
-		});
-		else if (examples.length === 1) slot = renderExampleContent(examples[0]);
-		return /* @__PURE__ */ jsx(Tab, {
-			value: tab.code,
-			children: slot
-		});
-	}
-	if (tabs.length === 0) return null;
 	return /* @__PURE__ */ jsx(Tabs, {
 		groupId: "fumadocs_openapi_responses",
 		items: tabs.map((tab) => tab.code),
-		children: tabs.map(renderResponse)
+		children: tabs.map((tab) => {
+			const { examples = [] } = tab;
+			let slot = /* @__PURE__ */ jsx(I18nLabel, { label: "empty" });
+			if (examples.length > 1) slot = /* @__PURE__ */ jsx(Accordions, {
+				type: "single",
+				className: "pt-2",
+				defaultValue: "0",
+				children: examples.map((example, i) => /* @__PURE__ */ jsxs(AccordionItem, {
+					value: i.toString(),
+					children: [/* @__PURE__ */ jsx(AccordionHeader, { children: /* @__PURE__ */ jsx(AccordionTrigger, { children: example.label }) }), /* @__PURE__ */ jsx(AccordionContent, {
+						className: "prose-no-margin",
+						children: renderExampleContent(example)
+					})]
+				}, i))
+			});
+			else if (examples.length === 1) slot = renderExampleContent(examples[0]);
+			return /* @__PURE__ */ jsx(Tab, {
+				value: tab.code,
+				children: slot
+			}, tab.code);
+		})
 	});
 }
 //#endregion

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

@@ -1 +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';\nimport { I18nLabel } from '@/ui/client/i18n';\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: ReactNode;\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        tab.examples.push({\n          label: sample?.summary ?? <I18nLabel label=\"responseTabName\" replacements={{ key }} />,\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: <I18nLabel label=\"responseTabNameDefault\" />,\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 = <I18nLabel label=\"empty\" />;\n    if (examples.length > 1) {\n      slot = (\n        <Accordions type=\"single\" className=\"pt-2\" defaultValue=\"0\">\n          {examples.map((example, i) => (\n            <AccordionItem key={i} value={i.toString()}>\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":";;;;;;;AA2CA,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,CACjE,KAAI,SAAS,KAAK;IAChB,OAAO,QAAQ,WAAW,oBAAC,WAAD;KAAW,OAAM;KAAkB,cAAc,EAAE,KAAK;KAAI,CAAA;IACtF,QAAQ,OAAO;IACf,aAAa,QAAQ;IACtB,CAAC;aAEK,gBAAgB,WAAW,gBAAgB,QAAQ;AAC5D,OAAI,aAAa,EAAE;AACnB,OAAI,SAAS,KAAK;IAChB,OAAO,oBAAC,WAAD,EAAW,OAAM,0BAA2B,CAAA;IACnD,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,qBAAA,UAAA,EAAA,UAAA,CACG,QAAQ,eAAe,IAAI,eAAe,QAAQ,YAAY,EAC9D,IAAI,gBAAgB,QAAQ,KAAK,UAAU,QAAQ,QAAQ,MAAM,EAAE,CAAC,CACpE,EAAA,CAAA;;CAIP,eAAe,eAAe,KAAkB;EAC9C,MAAM,EAAE,WAAW,EAAE,KAAK;EAE1B,IAAI,OAAkB,oBAAC,WAAD,EAAW,OAAM,SAAU,CAAA;AACjD,MAAI,SAAS,SAAS,EACpB,QACE,oBAAC,YAAD;GAAY,MAAK;GAAS,WAAU;GAAO,cAAa;aACrD,SAAS,KAAK,SAAS,MACtB,qBAAC,eAAD;IAAuB,OAAO,EAAE,UAAU;cAA1C,CACE,oBAAC,iBAAD,EAAA,UACE,oBAAC,kBAAD,EAAA,UAAmB,QAAQ,OAAyB,CAAA,EACpC,CAAA,EAClB,oBAAC,kBAAD;KAAkB,WAAU;eACzB,qBAAqB,QAAQ;KACb,CAAA,CACL;MAPI,EAOJ,CAChB;GACS,CAAA;WAEN,SAAS,WAAW,EAC7B,QAAO,qBAAqB,SAAS,GAAG;AAG1C,SAAO,oBAAC,KAAD;GAAK,OAAO,IAAI;aAAO;GAAW,CAAA;;AAG3C,KAAI,KAAK,WAAW,EAAG,QAAO;AAE9B,QACE,oBAAC,MAAD;EAAM,SAAQ;EAA6B,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK;YAC1E,KAAK,IAAI,eAAe;EACpB,CAAA"}
+{"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 { useMemo, type ReactNode } from 'react';\nimport { I18nLabel } from '@/ui/client/i18n';\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: ReactNode;\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  const tabs = useMemo(() => {\n    const tabs: ResponseTab[] = [];\n    if (!operation.responses) return tabs;\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          tab.examples.push({\n            label: sample?.summary ?? <I18nLabel label=\"responseTabName\" replacements={{ key }} />,\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: <I18nLabel label=\"responseTabNameDefault\" />,\n          sample: responseOfType.example ?? sample(responseOfType.schema as object),\n        });\n      }\n\n      tabs.push(tab);\n    }\n\n    return tabs;\n  }, [operation.responses]);\n\n  if (tabs.length === 0) return null;\n\n  const { renderResponseTabs = renderResponseTabsDefault } = ctx.content ?? {};\n\n  return renderResponseTabs(tabs, ctx);\n}\n\nfunction renderResponseTabsDefault(tabs: ResponseTab[], ctx: RenderContext): 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  return (\n    <Tabs groupId=\"fumadocs_openapi_responses\" items={tabs.map((tab) => tab.code)}>\n      {tabs.map((tab) => {\n        const { examples = [] } = tab;\n\n        let slot: ReactNode = <I18nLabel label=\"empty\" />;\n        if (examples.length > 1) {\n          slot = (\n            <Accordions type=\"single\" className=\"pt-2\" defaultValue=\"0\">\n              {examples.map((example, i) => (\n                <AccordionItem key={i} value={i.toString()}>\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 (\n          <Tab key={tab.code} value={tab.code}>\n            {slot}\n          </Tab>\n        );\n      })}\n    </Tabs>\n  );\n}\n"],"mappings":";;;;;;;;AA2CA,SAAgB,aAAa,EAC3B,WACA,OAIC;CACD,MAAM,OAAO,cAAc;EACzB,MAAM,OAAsB,EAAE;AAC9B,MAAI,CAAC,UAAU,UAAW,QAAO;AAEjC,OAAK,MAAM,CAAC,MAAM,aAAa,OAAO,QAAQ,UAAU,UAAU,EAAE;GAClE,MAAM,QAAQ,SAAS,UAAU,iBAAiB,SAAS,QAAQ,GAAG;GACtE,MAAM,iBAAiB,QAAQ,SAAS,UAAU,SAAS;GAE3D,MAAM,MAAmB;IACvB;IACA;IACA,WAAW;IACZ;AAED,OAAI,gBAAgB,UAAU;AAC5B,QAAI,aAAa,EAAE;AAEnB,SAAK,MAAM,CAAC,KAAK,WAAW,OAAO,QAAQ,eAAe,SAAS,CACjE,KAAI,SAAS,KAAK;KAChB,OAAO,QAAQ,WAAW,oBAAC,WAAD;MAAW,OAAM;MAAkB,cAAc,EAAE,KAAK;MAAI,CAAA;KACtF,QAAQ,OAAO;KACf,aAAa,QAAQ;KACtB,CAAC;cAEK,gBAAgB,WAAW,gBAAgB,QAAQ;AAC5D,QAAI,aAAa,EAAE;AACnB,QAAI,SAAS,KAAK;KAChB,OAAO,oBAAC,WAAD,EAAW,OAAM,0BAA2B,CAAA;KACnD,QAAQ,eAAe,WAAW,OAAO,eAAe,OAAiB;KAC1E,CAAC;;AAGJ,QAAK,KAAK,IAAI;;AAGhB,SAAO;IACN,CAAC,UAAU,UAAU,CAAC;AAEzB,KAAI,KAAK,WAAW,EAAG,QAAO;CAE9B,MAAM,EAAE,qBAAqB,8BAA8B,IAAI,WAAW,EAAE;AAE5E,QAAO,mBAAmB,MAAM,IAAI;;AAGtC,SAAS,0BAA0B,MAAqB,KAA+B;CACrF,SAAS,qBAAqB,SAA0B;AACtD,SACE,qBAAA,YAAA,EAAA,UAAA,CACG,QAAQ,eAAe,IAAI,eAAe,QAAQ,YAAY,EAC9D,IAAI,gBAAgB,QAAQ,KAAK,UAAU,QAAQ,QAAQ,MAAM,EAAE,CAAC,CACpE,EAAA,CAAA;;AAIP,QACE,oBAAC,MAAD;EAAM,SAAQ;EAA6B,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK;YAC1E,KAAK,KAAK,QAAQ;GACjB,MAAM,EAAE,WAAW,EAAE,KAAK;GAE1B,IAAI,OAAkB,oBAAC,WAAD,EAAW,OAAM,SAAU,CAAA;AACjD,OAAI,SAAS,SAAS,EACpB,QACE,oBAAC,YAAD;IAAY,MAAK;IAAS,WAAU;IAAO,cAAa;cACrD,SAAS,KAAK,SAAS,MACtB,qBAAC,eAAD;KAAuB,OAAO,EAAE,UAAU;eAA1C,CACE,oBAAC,iBAAD,EAAA,UACE,oBAAC,kBAAD,EAAA,UAAmB,QAAQ,OAAyB,CAAA,EACpC,CAAA,EAClB,oBAAC,kBAAD;MAAkB,WAAU;gBACzB,qBAAqB,QAAQ;MACb,CAAA,CACL;OAPI,EAOJ,CAChB;IACS,CAAA;YAEN,SAAS,WAAW,EAC7B,QAAO,qBAAqB,SAAS,GAAG;AAG1C,UACE,oBAAC,KAAD;IAAoB,OAAO,IAAI;cAC5B;IACG,EAFI,IAAI,KAER;IAER;EACG,CAAA"}

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

@@ -1,55 +1,14 @@
 "use client";
 import { joinURL, resolveRequestData, resolveServerUrl, withBase } from "../../../utils/url.js";
-import { useApiContext, useServerSelectContext } from "../../contexts/api.js";
+import { useApiContext, useServerContext } from "../../contexts/api.js";
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "../../components/select.js";
 import { ClientCodeBlock } from "../../components/codeblock.js";
-import { createContext, use, useEffect, useMemo, useRef, useState } from "react";
+import { useOperationContext } from "../client.js";
+import { useEffect, useMemo, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/ui/operation/usage-tabs/client.tsx
-const Context = createContext(null);
-function UsageTabsProvider({ route, examples, defaultExampleId, children }) {
-	const [example, setExample] = useState(() => defaultExampleId ?? examples.at(0)?.id);
-	const listeners = useRef([]);
-	return /* @__PURE__ */ jsx(Context, {
-		value: useMemo(() => ({
-			example,
-			route,
-			setExample(newKey) {
-				const example = examples.find((example) => example.id === newKey);
-				if (!example) return;
-				setExample(newKey);
-				for (const listener of listeners.current) listener(example.data, example.encoded);
-			},
-			examples,
-			setExampleData(data, encoded) {
-				for (const item of examples) if (item.id === example) {
-					item.data = data;
-					item.encoded = encoded;
-					break;
-				}
-				for (const listener of listeners.current) listener(data, encoded);
-			},
-			removeListener(listener) {
-				listeners.current = listeners.current.filter((item) => item !== listener);
-			},
-			addListener(listener) {
-				const active = examples.find((item) => item.id === example);
-				listener(active.data, active.encoded);
-				listeners.current.push(listener);
-			}
-		}), [
-			example,
-			route,
-			examples
-		]),
-		children
-	});
-}
-function useExampleRequests() {
-	return use(Context);
-}
 function UsageTabsSelector() {
-	const { example: key, setExample: setKey, examples } = useExampleRequests();
+	const { example: key, setExample: setKey, examples } = useOperationContext();
 	const { APIExampleSelector: Override } = useApiContext().client.operation ?? {};
 	if (Override) return /* @__PURE__ */ jsx(Override, {
 		items: examples,
@@ -84,8 +43,8 @@ function UsageTabsSelector() {
 }
 function UsageTab({ id, lang, _client }) {
 	const { mediaAdapters, codeUsages } = useApiContext();
-	const { examples, example: selectedExampleId, route, addListener, removeListener } = useExampleRequests();
-	const { server } = useServerSelectContext();
+	const { examples, example: selectedExampleId, route, addListener, removeListener } = useOperationContext();
+	const { server } = useServerContext();
 	const codegen = codeUsages.get(id);
 	const [data, setData] = useState(() => examples.find((example) => example.id === selectedExampleId)?.encoded);
 	useEffect(() => {
@@ -126,6 +85,6 @@ function UsageTab({ id, lang, _client }) {
 	});
 }
 //#endregion
-export { UsageTab, UsageTabsProvider, UsageTabsSelector, useExampleRequests };
+export { UsageTab, UsageTabsSelector };
 
 //# sourceMappingURL=client.js.map

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

@@ -1 +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 { 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';\nimport { ClientCodeBlock } from '@/ui/components/codeblock';\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 { mediaAdapters, codeUsages } = useApiContext();\n  const {\n    examples,\n    example: selectedExampleId,\n    route,\n    addListener,\n    removeListener,\n  } = useExampleRequests();\n  const { server } = useServerSelectContext();\n  const codegen = codeUsages.get(id);\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    if (!codegen) return;\n    return codegen.generate(url, data, {\n      mediaAdapters,\n      server: null,\n    });\n  }, [data, server, route, _client, codegen, mediaAdapters]);\n\n  if (!code) return null;\n\n  return <ClientCodeBlock lang={lang} code={code} />;\n}\n"],"mappings":"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"}
+{"version":3,"file":"client.js","names":[],"sources":["../../../../src/ui/operation/usage-tabs/client.tsx"],"sourcesContent":["'use client';\nimport { useApiContext, useServerContext } 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 { useState, useEffect, useMemo } from 'react';\nimport type { CodeUsageGenerator } from '@/requests/generators';\nimport { ClientCodeBlock } from '@/ui/components/codeblock';\nimport { type ExampleUpdateListener, useOperationContext } from '../client';\nimport type { ExampleRequestItem } from '../get-example-requests';\n\nexport function UsageTabsSelector() {\n  const { example: key, setExample: setKey, examples } = useOperationContext();\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 { mediaAdapters, codeUsages } = useApiContext();\n  const {\n    examples,\n    example: selectedExampleId,\n    route,\n    addListener,\n    removeListener,\n  } = useOperationContext();\n  const { server } = useServerContext();\n  const codegen = codeUsages.get(id);\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    if (!codegen) return;\n    return codegen.generate(url, data, {\n      mediaAdapters,\n      server: null,\n    });\n  }, [data, server, route, _client, codegen, mediaAdapters]);\n\n  if (!code) return null;\n\n  return <ClientCodeBlock lang={lang} code={code} />;\n}\n"],"mappings":";;;;;;;;;AAgBA,SAAgB,oBAAoB;CAClC,MAAM,EAAE,SAAS,KAAK,YAAY,QAAQ,aAAa,qBAAqB;CAC5E,MAAM,EAAE,oBAAoB,aAAa,eAAe,CAAC,OAAO,aAAa,EAAE;AAE/E,KAAI,SACF,QAAO,oBAAC,UAAD;EAAU,OAAO;EAAU,OAAO;EAAK,eAAe;EAAU,CAAA;CAGzE,SAAS,WAAW,MAA0B;AAC5C,SACE,qBAAC,OAAD,EAAA,UAAA,CACE,oBAAC,QAAD;GAAM,WAAU;aAAuB,KAAK;GAAY,CAAA,EACxD,oBAAC,QAAD;GAAM,WAAU;aAA4B,KAAK;GAAmB,CAAA,CAChE,EAAA,CAAA;;AAIV,KAAI,SAAS,WAAW,EAAG,QAAO;CAClC,MAAM,WAAW,SAAS,MAAM,SAAS,KAAK,OAAO,IAAI;AACzD,QACE,qBAAC,QAAD;EAAQ,OAAO;EAAK,eAAe;YAAnC,CACE,oBAAC,eAAD;GAAe,WAAU;aACtB,YAAY,oBAAC,aAAD;IAAa,SAAA;cAAS,WAAW,SAAS;IAAe,CAAA;GACxD,CAAA,EAChB,oBAAC,eAAD,EAAA,UACG,SAAS,KAAK,SACb,oBAAC,YAAD;GAA0B,OAAO,KAAK;aACnC,WAAW,KAAK;GACN,EAFI,KAAK,GAET,CACb,EACY,CAAA,CACT;;;AAIb,SAAgB,SAAS,EACvB,IACA,MACA,WACgE;CAChE,MAAM,EAAE,eAAe,eAAe,eAAe;CACrD,MAAM,EACJ,UACA,SAAS,mBACT,OACA,aACA,mBACE,qBAAqB;CACzB,MAAM,EAAE,WAAW,kBAAkB;CACrC,MAAM,UAAU,WAAW,IAAI,GAAG;CAClC,MAAM,CAAC,MAAM,WAAW,eAChB,SAAS,MAAM,YAAY,QAAQ,OAAO,kBAAkB,EAAE,QACrE;AAED,iBAAgB;EACd,MAAM,YAAmC,GAAG,YAAY,QAAQ,QAAQ;AAExE,cAAY,SAAS;AACrB,eAAa;AACX,kBAAe,SAAS;;IAEzB,CAAC,aAAa,eAAe,CAAC;CAEjC,MAAM,OAAO,cAAc;AACzB,MAAI,CAAC,KAAM;EACX,MAAM,MAAM,QACV,SACE,SAAS,iBAAiB,OAAO,KAAK,OAAO,UAAU,GAAG,KAC1D,OAAO,WAAW,cAAc,OAAO,SAAS,SAAS,kBAC1D,EACD,mBAAmB,OAAO,KAAK,CAChC;AAED,MAAI,SAAS;GACX,MAAM,EAAE,UAAU,kBAAkB;AACpC,OAAI,OAAO,aAAa,SAAU,QAAO;AACzC,UAAO,SAAS,KAAK,MAAM;IACzB;IACA,QAAQ;IACT,CAAC;;AAGJ,MAAI,CAAC,QAAS;AACd,SAAO,QAAQ,SAAS,KAAK,MAAM;GACjC;GACA,QAAQ;GACT,CAAC;IACD;EAAC;EAAM;EAAQ;EAAO;EAAS;EAAS;EAAc,CAAC;AAE1D,KAAI,CAAC,KAAM,QAAO;AAElB,QAAO,oBAAC,iBAAD;EAAuB;EAAY;EAAQ,CAAA"}

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

@@ -2,10 +2,11 @@ import { createCodeUsageGeneratorRegistry } from "../../../requests/generators/i
 import { registerDefault } from "../../../requests/generators/all.js";
 import { UsageTabLazy, UsageTabsSelectorLazy } from "./lazy.js";
 import { ResponseTabs } from "../response-tabs.js";
+import { useMemo } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger } from "fumadocs-ui/components/codeblock";
 //#region src/ui/operation/usage-tabs/index.tsx
-async function UsageTabs({ method, ctx }) {
+function UsageTabs({ method, ctx }) {
 	let { renderAPIExampleUsageTabs, renderAPIExampleLayout } = ctx.content ?? {};
 	renderAPIExampleLayout ??= (slots) => {
 		return /* @__PURE__ */ jsxs("div", {
@@ -36,17 +37,20 @@ async function UsageTabs({ method, ctx }) {
 			}, id))]
 		});
 	};
-	let registry;
-	if (ctx.codeUsages) registry = createCodeUsageGeneratorRegistry(ctx.codeUsages);
-	else {
-		registry = createCodeUsageGeneratorRegistry();
-		registerDefault(registry);
-	}
-	for (const gen of await ctx.generateCodeSamples?.(method) ?? []) registry.addInline(gen);
-	if (method["x-codeSamples"]) for (const sample of method["x-codeSamples"]) registry.addInline(sample);
+	const registry = useMemo(() => {
+		let registry;
+		if (ctx.codeUsages) registry = createCodeUsageGeneratorRegistry(ctx.codeUsages);
+		else {
+			registry = createCodeUsageGeneratorRegistry();
+			registerDefault(registry);
+		}
+		for (const gen of ctx.generateCodeSamples?.(method) ?? []) registry.addInline(gen);
+		if (method["x-codeSamples"]) for (const sample of method["x-codeSamples"]) registry.addInline(sample);
+		return registry;
+	}, [ctx, method]);
 	return renderAPIExampleLayout({
 		selector: method["x-exclusiveCodeSample"] ? null : /* @__PURE__ */ jsx(UsageTabsSelectorLazy, {}),
-		usageTabs: await renderAPIExampleUsageTabs(registry, ctx),
+		usageTabs: renderAPIExampleUsageTabs(registry, ctx),
 		responseTabs: /* @__PURE__ */ jsx(ResponseTabs, {
 			operation: method,
 			ctx

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

@@ -1 +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,OAAD;GAAK,WAAU;aAAf;IACG,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,eAAD;GAAe,SAAQ;GAA4B,cAAc,IAAI,GAAG;aAAxE,CACE,oBAAC,mBAAD,EAAA,UACG,IAAI,KAAK,CAAC,IAAI,UACb,oBAAC,sBAAD;IAA+B,OAAO;cACnC,KAAK,SAAS,KAAK;IACC,EAFI,GAEJ,CACvB,EACgB,CAAA,EACnB,IAAI,KAAK,CAAC,IAAI,UACb,oBAAC,cAAD;IAAuB,OAAO;cAC5B,oBAAC,cAAD;KAAkB;KAAI,MAAM,KAAK;KAAM,SAAS,KAAK;KAAW,CAAA;IACnD,EAFI,GAEJ,CACf,CACY;;;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,uBAAD,EAAyB,CAAA;EAC5E,WAAW,MAAM,0BAA0B,UAAU,IAAI;EACzD,cAAc,oBAAC,cAAD;GAAc,WAAW;GAAa;GAAO,CAAA;EAC5D,EACD,IACD"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/ui/operation/usage-tabs/index.tsx"],"sourcesContent":["import type { MethodInformation, RenderContext } from '@/types';\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';\nimport { useMemo } from 'react';\n\nexport function UsageTabs({ method, ctx }: { method: MethodInformation; ctx: RenderContext }) {\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  const registry = useMemo(() => {\n    let registry: CodeUsageGeneratorRegistry;\n\n    if (ctx.codeUsages) {\n      registry = createCodeUsageGeneratorRegistry(ctx.codeUsages);\n    } else {\n      registry = createCodeUsageGeneratorRegistry();\n      registerDefault(registry);\n    }\n\n    for (const gen of 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 registry;\n  }, [ctx, method]);\n\n  return renderAPIExampleLayout(\n    {\n      selector: method['x-exclusiveCodeSample'] ? null : <UsageTabsSelectorLazy />,\n      usageTabs: renderAPIExampleUsageTabs(registry, ctx),\n      responseTabs: <ResponseTabs operation={method} ctx={ctx} />,\n    },\n    ctx,\n  );\n}\n"],"mappings":";;;;;;;;AAgBA,SAAgB,UAAU,EAAE,QAAQ,OAA0D;CAC5F,IAAI,EAAE,2BAA2B,2BAA2B,IAAI,WAAW,EAAE;AAE7E,6BAA4B,UAAU;AACpC,SACE,qBAAC,OAAD;GAAK,WAAU;aAAf;IACG,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,eAAD;GAAe,SAAQ;GAA4B,cAAc,IAAI,GAAG;aAAxE,CACE,oBAAC,mBAAD,EAAA,UACG,IAAI,KAAK,CAAC,IAAI,UACb,oBAAC,sBAAD;IAA+B,OAAO;cACnC,KAAK,SAAS,KAAK;IACC,EAFI,GAEJ,CACvB,EACgB,CAAA,EACnB,IAAI,KAAK,CAAC,IAAI,UACb,oBAAC,cAAD;IAAuB,OAAO;cAC5B,oBAAC,cAAD;KAAkB;KAAI,MAAM,KAAK;KAAM,SAAS,KAAK;KAAW,CAAA;IACnD,EAFI,GAEJ,CACf,CACY;;;CAIpB,MAAM,WAAW,cAAc;EAC7B,IAAI;AAEJ,MAAI,IAAI,WACN,YAAW,iCAAiC,IAAI,WAAW;OACtD;AACL,cAAW,kCAAkC;AAC7C,mBAAgB,SAAS;;AAG3B,OAAK,MAAM,OAAO,IAAI,sBAAsB,OAAO,IAAI,EAAE,CACvD,UAAS,UAAU,IAAI;AAGzB,MAAI,OAAO,iBACT,MAAK,MAAM,UAAU,OAAO,iBAC1B,UAAS,UAAU,OAAO;AAI9B,SAAO;IACN,CAAC,KAAK,OAAO,CAAC;AAEjB,QAAO,uBACL;EACE,UAAU,OAAO,2BAA2B,OAAO,oBAAC,uBAAD,EAAyB,CAAA;EAC5E,WAAW,0BAA0B,UAAU,IAAI;EACnD,cAAc,oBAAC,cAAD;GAAc,WAAW;GAAa;GAAO,CAAA;EAC5D,EACD,IACD"}

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

@@ -3,8 +3,7 @@ import { wrapLazy } from "../../../utils/lazy.js";
 //#region src/ui/operation/usage-tabs/lazy.tsx
 const UsageTabsSelectorLazy = wrapLazy(() => import("./client.js").then((mod) => ({ default: mod.UsageTabsSelector })));
 const UsageTabLazy = wrapLazy(() => import("./client.js").then((mod) => ({ default: mod.UsageTab })));
-const UsageTabsProviderLazy = wrapLazy(() => import("./client.js").then((mod) => ({ default: mod.UsageTabsProvider })));
 //#endregion
-export { UsageTabLazy, UsageTabsProviderLazy, UsageTabsSelectorLazy };
+export { UsageTabLazy, UsageTabsSelectorLazy };
 
 //# sourceMappingURL=lazy.js.map

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

@@ -1 +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"}
+{"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"],"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"}

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

@@ -1,4 +1,5 @@
 import { SchemaUIGeneratedData } from "./index.js";
+
 //#region src/ui/schema/client.d.ts
 interface SchemaUIProps {
   name: string;

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

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

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

@@ -1,6 +1,7 @@
-import { ResolvedSchema } from "../../utils/schema.js";
+import { ResolvedSchema } from "../../utils/schema/index.js";
 import { SchemaUIProps } from "./client.js";
 import { ReactNode } from "react";
+
 //#region src/ui/schema/index.d.ts
 interface FieldBase {
   description?: ReactNode;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/ui/schema/index.tsx"],"mappings":";;;;UASiB,SAAA;EACf,WAAA,GAAc,SAAA;EACd,QAAA,GAAW,OAAA;EAEX,QAAA;EACA,SAAA;EAEA,UAAA;AAAA;AAAA,UAGe,OAAA;EACf,KAAA,EAAO,SAAA;EACP,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;EA1BA;;;EA+Bb,QAAA;EAtBM;;;EA0BN,SAAA;AAAA;AAAA,UAGe,qBAAA;EACf,KAAA;EACA,IAAA,EAAM,MAAA,SAAe,UAAA;AAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/ui/schema/index.tsx"],"mappings":";;;;;UASiB,SAAA;EACf,WAAA,GAAc,SAAA;EACd,QAAA,GAAW,OAAA;EAEX,QAAA;EACA,SAAA;EAEA,UAAA;AAAA;AAAA,UAGe,OAAA;EACf,KAAA,EAAO,SAAA;EACP,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;EAvBP;;;EA4BN,QAAA;EArBM;;;EAyBN,SAAA;AAAA;AAAA,UAGe,qBAAA;EACf,KAAA;EACA,IAAA,EAAM,MAAA,SAAe,UAAA;AAAA"}

package/dist/ui/schema/index.js

@@ -1,14 +1,16 @@
 import { mergeAllOf } from "../../utils/merge-schema.js";
-import { FormatFlags, schemaToString } from "../../utils/schema-to-string.js";
+import { FormatFlags, schemaToString } from "../../utils/schema/to-string.js";
 import { I18nLabel } from "../client/i18n.js";
 import { SchemaUILazy } from "./lazy.js";
+import { useMemo } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region src/ui/schema/index.tsx
 function Schema({ ctx, ...options }) {
 	if (ctx.schemaUI?.render) return ctx.schemaUI.render(options, ctx);
+	const generated = useMemo(() => generateSchemaUI(options, ctx), [ctx, options]);
 	return /* @__PURE__ */ jsx(SchemaUILazy, {
 		...options.client,
-		generated: generateSchemaUI(options, ctx)
+		generated
 	});
 }
 function generateSchemaUI({ root, readOnly, writeOnly }, ctx) {

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

@@ -1 +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';\nimport { I18nLabel } from '../client/i18n';\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: ReactNode;\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({\n        label: <I18nLabel label=\"schemaDefault\" />,\n        value: JSON.stringify(schema.default),\n      });\n    }\n\n    if (schema.pattern) {\n      fields.push({ label: <I18nLabel label=\"schemaMatch\" />, value: schema.pattern });\n    }\n\n    if (schema.format) {\n      fields.push({ label: <I18nLabel label=\"schemaFormat\" />, value: schema.format });\n    }\n\n    if (schema.multipleOf) {\n      fields.push({\n        label: <I18nLabel label=\"schemaMultipleOf\" />,\n        value: schema.multipleOf.toString(),\n      });\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: <I18nLabel label=\"schemaRange\" />, value: range });\n\n    range = formatRange('length', schema.minLength, undefined, schema.maxLength, undefined);\n    if (range) fields.push({ label: <I18nLabel label=\"schemaLength\" />, 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: <I18nLabel label=\"schemaProperties\" />, value: range });\n\n    range = formatRange('items', schema.minItems, undefined, schema.maxItems, undefined);\n    if (range) fields.push({ label: <I18nLabel label=\"schemaItems\" />, value: range });\n\n    if (schema.enum) {\n      fields.push({\n        label: <I18nLabel label=\"schemaValueIn\" />,\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({\n          label: <I18nLabel label=\"schemaExample\" />,\n          value: JSON.stringify(example, null, 2),\n        });\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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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/ui/schema/index.tsx"],"sourcesContent":["import { useMemo, 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';\nimport { I18nLabel } from '../client/i18n';\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: ReactNode;\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  // eslint-disable-next-line react-hooks/rules-of-hooks -- assume options unchanged\n  const generated = useMemo(() => generateSchemaUI(options, ctx), [ctx, options]);\n  return <SchemaUILazy {...options.client} generated={generated} />;\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({\n        label: <I18nLabel label=\"schemaDefault\" />,\n        value: JSON.stringify(schema.default),\n      });\n    }\n\n    if (schema.pattern) {\n      fields.push({ label: <I18nLabel label=\"schemaMatch\" />, value: schema.pattern });\n    }\n\n    if (schema.format) {\n      fields.push({ label: <I18nLabel label=\"schemaFormat\" />, value: schema.format });\n    }\n\n    if (schema.multipleOf) {\n      fields.push({\n        label: <I18nLabel label=\"schemaMultipleOf\" />,\n        value: schema.multipleOf.toString(),\n      });\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: <I18nLabel label=\"schemaRange\" />, value: range });\n\n    range = formatRange('length', schema.minLength, undefined, schema.maxLength, undefined);\n    if (range) fields.push({ label: <I18nLabel label=\"schemaLength\" />, 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: <I18nLabel label=\"schemaProperties\" />, value: range });\n\n    range = formatRange('items', schema.minItems, undefined, schema.maxItems, undefined);\n    if (range) fields.push({ label: <I18nLabel label=\"schemaItems\" />, value: range });\n\n    if (schema.enum) {\n      fields.push({\n        label: <I18nLabel label=\"schemaValueIn\" />,\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({\n          label: <I18nLabel label=\"schemaExample\" />,\n          value: JSON.stringify(example, null, 2),\n        });\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":";;;;;;;AAgFA,SAAgB,OAAO,EACrB,KACA,GAAG,WAGF;AACD,KAAI,IAAI,UAAU,OAChB,QAAO,IAAI,SAAS,OAAO,SAAS,IAAI;CAI1C,MAAM,YAAY,cAAc,iBAAiB,SAAS,IAAI,EAAE,CAAC,KAAK,QAAQ,CAAC;AAC/E,QAAO,oBAAC,cAAD;EAAc,GAAI,QAAQ;EAAmB;EAAa,CAAA;;AAGnE,SAAgB,iBACd,EAAE,MAAM,UAAU,aAClB,KACuB;CACvB,MAAM,OAAmC,EAAE;CAC3C,MAAM,EAAE,cAAc,UAAU,IAAI,YAAY,EAAE;CAElD,SAAS,iBAAiB,QAA0C;EAClE,MAAM,SAAoB,EAAE;AAE5B,MAAI,OAAO,YAAY,KAAA,EACrB,QAAO,KAAK;GACV,OAAO,oBAAC,WAAD,EAAW,OAAM,iBAAkB,CAAA;GAC1C,OAAO,KAAK,UAAU,OAAO,QAAQ;GACtC,CAAC;AAGJ,MAAI,OAAO,QACT,QAAO,KAAK;GAAE,OAAO,oBAAC,WAAD,EAAW,OAAM,eAAgB,CAAA;GAAE,OAAO,OAAO;GAAS,CAAC;AAGlF,MAAI,OAAO,OACT,QAAO,KAAK;GAAE,OAAO,oBAAC,WAAD,EAAW,OAAM,gBAAiB,CAAA;GAAE,OAAO,OAAO;GAAQ,CAAC;AAGlF,MAAI,OAAO,WACT,QAAO,KAAK;GACV,OAAO,oBAAC,WAAD,EAAW,OAAM,oBAAqB,CAAA;GAC7C,OAAO,OAAO,WAAW,UAAU;GACpC,CAAC;EAGJ,IAAI,QAAQ,YACV,SACA,OAAO,SACP,OAAO,kBACP,OAAO,SACP,OAAO,iBACR;AACD,MAAI,MAAO,QAAO,KAAK;GAAE,OAAO,oBAAC,WAAD,EAAW,OAAM,eAAgB,CAAA;GAAE,OAAO;GAAO,CAAC;AAElF,UAAQ,YAAY,UAAU,OAAO,WAAW,KAAA,GAAW,OAAO,WAAW,KAAA,EAAU;AACvF,MAAI,MAAO,QAAO,KAAK;GAAE,OAAO,oBAAC,WAAD,EAAW,OAAM,gBAAiB,CAAA;GAAE,OAAO;GAAO,CAAC;AAEnF,UAAQ,YACN,cACA,OAAO,eACP,KAAA,GACA,OAAO,eACP,KAAA,EACD;AACD,MAAI,MAAO,QAAO,KAAK;GAAE,OAAO,oBAAC,WAAD,EAAW,OAAM,oBAAqB,CAAA;GAAE,OAAO;GAAO,CAAC;AAEvF,UAAQ,YAAY,SAAS,OAAO,UAAU,KAAA,GAAW,OAAO,UAAU,KAAA,EAAU;AACpF,MAAI,MAAO,QAAO,KAAK;GAAE,OAAO,oBAAC,WAAD,EAAW,OAAM,eAAgB,CAAA;GAAE,OAAO;GAAO,CAAC;AAElF,MAAI,OAAO,KACT,QAAO,KAAK;GACV,OAAO,oBAAC,WAAD,EAAW,OAAM,iBAAkB,CAAA;GAC1C,OAAO,OAAO,KAAK,KAAK,UAAU,KAAK,UAAU,MAAM,CAAC,CAAC,KAAK,MAAM;GACrE,CAAC;AAGJ,MAAI,eAAe,OAAO,SACxB,MAAK,MAAM,WAAW,OAAO,SAC3B,QAAO,KAAK;GACV,OAAO,oBAAC,WAAD,EAAW,OAAM,iBAAkB,CAAA;GAC1C,OAAO,KAAK,UAAU,SAAS,MAAM,EAAE;GACxC,CAAC;AAIN,SAAO;;CAGT,IAAI,WAAW;CACf,MAAM,0BAAU,IAAI,SAAmD;CACvE,SAAS,YAAY,QAAgC;AACnD,MAAI,OAAO,WAAW,UAAW,QAAO,OAAO,OAAO;EACtD,MAAM,MAAM,IAAI,OAAO,UAAU,OAAO;AACxC,MAAI,IAAK,QAAO;EAEhB,MAAM,OAAO,QAAQ,IAAI,OAAO;AAChC,MAAI,KAAM,QAAO;EAEjB,MAAM,YAAY,KAAK;AACvB,UAAQ,IAAI,QAAQ,UAAU;AAC9B,SAAO;;CAGT,SAAS,UAAU,QAAiC;AAClD,MAAI,OAAO,WAAW,UAAW,QAAO;AACxC,MAAI,OAAO,UAAW,QAAO,aAAa;AAC1C,MAAI,OAAO,SAAU,QAAO,YAAY;AACxC,SAAO;;CAGT,SAAS,KAAK,QAAmC;AAC/C,MAAI,OAAO,WAAW,WAAW;GAC/B,MAAM,OAAO,SAAS,QAAQ;AAC9B,UAAO;IACL,UAAU;IACV,WAAW;IACZ;;AAGH,SAAO;GACL,aAAa,OAAO,eAAe,IAAI,eAAe,OAAO,YAAY;GACzE,UAAU,iBAAiB,OAAO;GAClC,UAAU,eAAe,QAAQ,IAAI,OAAO;GAC5C,WAAW,eAAe,QAAQ,IAAI,QAAQ,YAAY,SAAS;GACnE,YAAY,OAAO;GACpB;;CAGH,SAAS,SAAS,IAAY,QAAwB;AACpD,MAAI,MAAM,KAAM;AAChB,MAAI,OAAO,WAAW,WAAW;AAC/B,QAAK,MAAM;IACT,MAAM;IACN,GAAG,KAAK,OAAO;IAChB;AACD;;AAGF,MAAI,MAAM,QAAQ,OAAO,KAAK,EAAE;GAC9B,MAAM,MAAkB;IACtB,MAAM;IACN,OAAO,EAAE;IACT,GAAG,KAAK,OAAO;IAChB;AACD,QAAK,MAAM;AAEX,QAAK,MAAM,QAAQ,OAAO,MAAM;IAC9B,MAAM,MAAM,GAAG,GAAG,QAAQ;AAC1B,aAAS,KAAK;KACZ,GAAG;KACH;KACD,CAAC;AACF,QAAI,MAAM,KAAK;KACb,MAAM;KACN,OAAO;KACR,CAAC;;AAEJ;;AAGF,MAAI,OAAO,SAAS,OAAO,OAAO;GAChC,MAAM,MAAkB;IACtB,MAAM;IACN,OAAO,EAAE;IACT,GAAG,KAAK,OAAO;IAChB;AACD,QAAK,MAAM;AACX,QAAK,MAAM,QAAQ,CAAC,SAAS,QAAQ,EAAW;IAC9C,MAAM,QAAQ,GAAG,GAAG,QAAQ;AAC5B,aAAS,OAAO;KAAE,GAAG;MAAS,OAAO,KAAA;KAAW,CAAC;AAEjD,QAAI,MAAM,KAAK;KACb,MAAM,KAAK,OAAO;KAClB;KACD,CAAC;;AAEJ;;EAIF,MAAM,QAAQ,OAAO,SAAS,OAAO;AACrC,MAAI,OAAO;GACT,MAAM,MAAkB;IACtB,MAAM;IACN,OAAO,EAAE;IACT,GAAG,KAAK,OAAO;IAChB;AACD,QAAK,MAAM;AAEX,QAAK,MAAM,QAAQ,OAAO;AACxB,QAAI,CAAC,QAAQ,OAAO,SAAS,YAAY,CAAC,UAAU,KAAK,CAAE;IAC3D,MAAM,SAAS,YAAY,KAAK;IAChC,MAAM,MAAM,GAAG,GAAG,WAAW;AAE7B,aAAS,KAAK;KACZ,GAAG;KACH,OAAO,KAAA;KACP,OAAO,KAAA;KACP,GAAG;KACH,YAAY;MACV,GAAG,OAAO;MACV,GAAG,KAAK;MACT;KACF,CAAC;AACF,QAAI,MAAM,KAAK;KACb,OAAO;KACP,MAAM,KAAK,SAAS,aAAa,eAAe,MAAM,IAAI,QAAQ,YAAY,SAAS;KACxF,CAAC;;AAEJ;;AAGF,MAAI,OAAO,OAAO;AAChB,YAAS,IAAI,WAAW,OAAO,CAAC;AAChC;;AAGF,MAAI,OAAO,SAAS,UAAU;GAC5B,MAAM,MAAkB;IACtB,MAAM;IACN,OAAO,EAAE;IACT,GAAG,KAAK,OAAO;IAChB;AACD,QAAK,MAAM;GAEX,MAAM,EAAE,aAAa,EAAE,EAAE,mBAAmB,yBAAyB;GACrE,MAAM,QAAQ,OAAO,QAAQ,WAAW;AACxC,OAAI,kBAAmB,OAAM,KAAK,GAAG,OAAO,QAAQ,kBAAkB,CAAC;AAEvE,QAAK,MAAM,CAAC,KAAK,SAAS,OAAO;AAC/B,QAAI,CAAC,QAAQ,CAAC,UAAU,KAAK,CAAE;IAC/B,MAAM,QAAQ,YAAY,KAAK;AAC/B,aAAS,OAAO,KAAK;AACrB,QAAI,MAAM,KAAK;KACb;KACA,MAAM;KACN,UAAU,OAAO,UAAU,SAAS,IAAI,IAAI;KAC7C,CAAC;;AAGJ,OAAI,wBAAwB,UAAU,qBAAqB,EAAE;IAC3D,MAAM,QAAQ,YAAY,qBAAqB;AAC/C,aAAS,OAAO,qBAAqB;AAErC,QAAI,MAAM,KAAK;KACb;KACA,MAAM;KACN,UAAU;KACX,CAAC;;AAEJ;;AAGF,MAAI,OAAO,SAAS,SAAS;GAC3B,MAAM,QAAQ,OAAO,SAAS;GAC9B,MAAM,QAAQ,YAAY,MAAM;AAEhC,QAAK,MAAM;IACT,MAAM;IACN,MAAM,EACJ,OACD;IACD,GAAG,KAAK,OAAO;IAChB;AACD,YAAS,OAAO,MAAM;AACtB;;AAGF,OAAK,MAAM;GACT,MAAM;GACN,GAAG,KAAK,OAAO;GAChB;;CAGH,MAAM,QAAQ,YAAY,KAAK;AAC/B,UAAS,OAAO,KAAK;AACrB,QAAO;EACL;EACA;EACD;;AAGH,SAAS,YACP,OACA,KACA,cACA,KACA,cACA;CACA,MAAM,MAAgB,EAAE;AACxB,KAAI,QAAQ,KAAA,EACV,KAAI,KAAK,GAAG,IAAI,KAAK;UACZ,iBAAiB,KAAA,EAC1B,KAAI,KAAK,GAAG,aAAa,IAAI;AAG/B,KAAI,KAAK,MAAM;AACf,KAAI,QAAQ,KAAA,EACV,KAAI,KAAK,MAAM,MAAM;UACZ,iBAAiB,KAAA,EAC1B,KAAI,KAAK,KAAK,eAAe;AAE/B,KAAI,IAAI,SAAS,EAAG,QAAO,IAAI,KAAK,IAAI"}

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

@@ -1,4 +1,4 @@
-import { NoReference } from "../schema.js";
+import { NoReference } from "../schema/index.js";
 import { OpenAPIServer } from "../../server/create.js";
 import { OperationItem, WebhookItem } from "../../ui/api-page.js";
 import { OperationObject, PathItemObject, TagObject } from "../../types.js";
@@ -21,19 +21,20 @@ interface WebhookOutput extends BaseEntry {
   type: 'webhook';
   item: WebhookItem;
 }
-interface TagOutput extends BaseEntry {
-  type: 'tag';
-  tag: string;
-  rawTag: TagObject;
+interface PageOutput extends BaseEntry {
+  type: 'page';
   operations: OperationItem[];
   webhooks: WebhookItem[];
+  /** tag info if the page is generated from a tag. */
+  tag?: TagObject;
 }
 interface OutputGroup extends BaseEntry {
   type: 'group';
-  operations: OperationItem[];
-  webhooks: WebhookItem[];
+  entries: OutputEntry[];
+  /** tag info if the group is generated from a tag. */
+  tag?: TagObject;
 }
-type OutputEntry = TagOutput | OperationOutput | WebhookOutput | OutputGroup;
+type OutputEntry = PageOutput | OperationOutput | WebhookOutput | OutputGroup;
 interface PagesBuilderConfig {
   toPages: (builder: PagesBuilder) => void;
 }
@@ -45,8 +46,6 @@ interface PagesBuilder {
   document: ProcessedDocument;
   /**
    * add output entry.
-   *
-   * When the `path` property is unspecified, it will generate one.
    */
   create: (entry: OutputEntry) => void;
   /**
@@ -86,5 +85,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, PageOutput, PagesBuilder, PagesBuilderConfig, WebhookOutput, fromSchema, fromServer };
 //# sourceMappingURL=builder.d.ts.map

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

@@ -1 +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"}
+{"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,UAAA,SAAmB,SAAA;EAClC,IAAA;EACA,UAAA,EAAY,aAAA;EACZ,QAAA,EAAU,WAAA;EAXV;EAaA,GAAA,GAAM,SAAA;AAAA;AAAA,UAGS,WAAA,SAAoB,SAAA;EACnC,IAAA;EACA,OAAA,EAAS,WAAA;;EAET,GAAA,GAAM,SAAA;AAAA;AAAA,KAGI,WAAA,GAAc,UAAA,GAAa,eAAA,GAAkB,aAAA,GAAgB,WAAA;AAAA,UAExD,kBAAA;EACf,OAAA,GAAU,OAAA,EAAS,YAAA;AAAA;AAAA,UAGJ,YAAA;EArBA;;;EAyBf,EAAA;EACA,QAAA,EAAU,iBAAA;EArBJ;;;EAyBN,MAAA,GAAS,KAAA,EAAO,WAAA;EA9BkB;;;EAmClC,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"}