fumadocs-openapi 10.9.0 → 10.10.0

package/dist/server/index.js

@@ -23,11 +23,12 @@ function createOpenAPI(options = {}) {
 	async function getVirtualFiles(server, options) {
 		const { baseDir = "", meta = false } = options;
 		const { createAutoPreset } = await import("../utils/pages/preset-auto.js");
-		const { fromServer } = await import("../utils/pages/builder.js");
+		const { fromSchema } = await import("../utils/pages/builder.js");
 		const files = [];
-		const entries = await fromServer(server, createAutoPreset(options));
-		for (const [schemaId, list] of Object.entries(entries)) {
-			const processed = await server.getSchema(schemaId);
+		const schemas = await server.getSchemas();
+		const builderOptions = createAutoPreset(options);
+		for (const [id, schema] of Object.entries(schemas)) {
+			onEntries(fromSchema(id, schema, builderOptions));
 			function onEntry(entry) {
 				const props = getPageProps(entry);
 				files.push({
@@ -41,7 +42,7 @@ function createOpenAPI(options = {}) {
 						async getClientAPIPageProps() {
 							return {
 								payload: {
-									bundled: processed.bundled,
+									bundled: schema.bundled,
 									proxyUrl: server.options.proxyUrl
 								},
 								...props
@@ -49,11 +50,11 @@ function createOpenAPI(options = {}) {
 						},
 						getSchema() {
 							return {
-								id: schemaId,
-								...processed
+								id,
+								...schema
 							};
 						},
-						...toStaticData(props, processed.dereferenced),
+						...toStaticData(props, schema.dereferenced),
 						_openapi: {
 							method: entry.type === "operation" || entry.type === "webhook" ? entry.item.method : void 0,
 							webhook: entry.type === "webhook",
@@ -92,7 +93,6 @@ function createOpenAPI(options = {}) {
 					}
 				});
 			}
-			onEntries(list);
 		}
 		return files;
 	}

package/dist/types.d.ts

@@ -6,7 +6,7 @@ import { CreateAPIPageOptions } from "./ui/base.js";
 import { OpenAPIOptions } from "./server/index.js";
 import { NoReference } from "./utils/schema/index.js";
 import { DereferencedDocument } from "./utils/document/dereference.js";
-import { HTMLAttributes, ReactNode } from "react";
+import { ReactNode } from "react";
 
 //#region src/types.d.ts
 type Document = OpenAPIV3_2.Document;
@@ -39,9 +39,6 @@ interface RenderContext extends Pick<OpenAPIOptions, 'proxyUrl'>, Omit<RequireKe
   schema: DereferencedDocument;
   clientBoundary: typeof boundary_d_exports;
   mediaAdapters: Record<string, MediaAdapter>;
-  renderHeading: (depth: number, text: string | ReactNode, props?: HTMLAttributes<HTMLHeadingElement> & {
-    id?: string;
-  }) => ReactNode;
   renderCodeBlock: (lang: string, code: string) => ReactNode;
 }
 type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;

package/dist/ui/base.d.ts

@@ -151,6 +151,7 @@ interface CreateAPIPageOptions {
      */
     render?: (props: APIPlaygroundProps) => ReactNode;
   };
+  /** @deprecated no longer used */
   renderHeading?: (props: HTMLAttributes<HTMLHeadingElement>, depth: number) => ReactNode;
   renderCodeBlock?: (props: {
     lang: string;

package/dist/ui/base.js

@@ -8,7 +8,6 @@ import { PlaygroundAuthProvider } from "./client/boundary.lazy.js";
 import Slugger from "github-slugger";
 import * as JsxRuntime from "react/jsx-runtime";
 import { jsx } from "react/jsx-runtime";
-import { Heading } from "fumadocs-ui/components/heading";
 import { createRehypeCode } from "fumadocs-core/mdx-plugins/rehype-code.core";
 import { remarkGfm } from "fumadocs-core/mdx-plugins/remark-gfm";
 import defaultMdxComponents from "fumadocs-ui/mdx";
@@ -62,7 +61,7 @@ function createAPIPage(server, options) {
 		let processed;
 		if (typeof document === "string") processed = await server.getSchema(document);
 		else processed = document;
-		const slugger = new Slugger();
+		new Slugger();
 		const { ApiProvider, PlaygroundClient, SchemaUI, ServerProvider, UsageTab, UsageTabsSelector } = await import("./client/boundary.lazy.js");
 		const ctx = {
 			schema: processed,
@@ -85,21 +84,6 @@ function createAPIPage(server, options) {
 				provider: options.playground?.provider ?? renderPlaygroundProviderDefault,
 				render: options.playground?.render ?? renderPlaygroundDefault
 			},
-			renderHeading(depth, text, props) {
-				const id = typeof text === "string" ? slugger.slug(text) : props?.id;
-				if (!id) throw new Error("missing 'id' for non-string children");
-				if (options.renderHeading) return options.renderHeading({
-					id,
-					children: text,
-					...props
-				}, depth);
-				return /* @__PURE__ */ jsx(Heading, {
-					id,
-					as: `h${depth}`,
-					...props,
-					children: text
-				}, id);
-			},
 			generateTypeScriptDefinitions: options.generateTypeScriptDefinitions ?? ((schema, ctx) => {
 				if (options.generateTypeScriptSchema && ctx._internal_legacy) {
 					const { statusCode, contentType } = ctx._internal_legacy;

package/dist/ui/components/accordion.js

@@ -1,27 +1,52 @@
 "use client";
 import { cn } from "../../utils/cn.js";
+import { anchorIdStartsWith } from "../../utils/auto-anchor.js";
+import { AnchorSection, useAnchorId } from "../../utils/auto-anchor.client.js";
+import { createContext, use, useEffect, useMemo, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { ChevronRight } from "lucide-react";
 import * as Primitive from "@radix-ui/react-accordion";
 //#region src/ui/components/accordion.tsx
-function Accordions(props) {
-	return /* @__PURE__ */ jsx(Primitive.Root, {
-		...props,
-		className: cn("divide-y divide-fd-border", props.className)
+const Context = createContext(null);
+function Accordions({ type, defaultValue, ...props }) {
+	const [value, setValue] = useState(() => type === "multiple" ? defaultValue ?? [] : defaultValue ?? "");
+	return /* @__PURE__ */ jsx(Context, {
+		value: useMemo(() => ({
+			type,
+			setValue
+		}), [type]),
+		children: /* @__PURE__ */ jsx(Primitive.Root, {
+			type,
+			value,
+			onValueChange: setValue,
+			...props
+		})
 	});
 }
-function AccordionItem(props) {
-	return /* @__PURE__ */ jsx(Primitive.Item, {
-		...props,
-		className: cn("scroll-m-20", props.className),
-		children: props.children
+function AccordionItem({ value, className, anchorSegments, ...props }) {
+	const ctx = use(Context);
+	const id = useAnchorId(anchorSegments ?? false);
+	useEffect(() => {
+		if (id && anchorIdStartsWith(window.location.hash.slice(1), id)) ctx.setValue(ctx.type === "single" ? value : [value]);
+	}, [
+		value,
+		id,
+		ctx
+	]);
+	const content = /* @__PURE__ */ jsx(Primitive.Item, {
+		value,
+		className: cn("scroll-m-20 border-b last:border-b-0", className),
+		...props
 	});
+	return anchorSegments ? /* @__PURE__ */ jsx(AnchorSection, {
+		segments: anchorSegments,
+		children: content
+	}) : content;
 }
 function AccordionContent(props) {
 	return /* @__PURE__ */ jsx(Primitive.Content, {
 		...props,
-		className: cn("overflow-hidden data-[state=closed]:animate-fd-accordion-up data-[state=open]:animate-fd-accordion-down", props.className),
-		children: props.children
+		className: cn("overflow-hidden data-[state=closed]:animate-fd-accordion-up data-[state=open]:animate-fd-accordion-down", props.className)
 	});
 }
 function AccordionHeader(props) {

package/dist/ui/components/dialog.js

@@ -1,7 +1,6 @@
 "use client";
 import { useTranslations } from "../client/i18n.js";
 import { cn } from "../../utils/cn.js";
-import * as React from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { X } from "lucide-react";
 import { buttonVariants } from "fumadocs-ui/components/ui/button";
@@ -10,13 +9,14 @@ import * as DialogPrimitive from "@radix-ui/react-dialog";
 const Dialog = DialogPrimitive.Root;
 const DialogTrigger = DialogPrimitive.Trigger;
 const DialogPortal = DialogPrimitive.Portal;
-const DialogOverlay = React.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(DialogPrimitive.Overlay, {
-	ref,
-	className: cn("fixed inset-0 z-50 bg-black/30 backdrop-blur-sm data-[state=open]:animate-fd-fade-in data-[state=closed]:animate-fd-fade-out", className),
-	...props
-}));
-DialogOverlay.displayName = DialogPrimitive.Overlay.displayName;
-const DialogContent = React.forwardRef(({ className, children, ...props }, ref) => {
+function DialogOverlay({ className, ref, ...props }) {
+	return /* @__PURE__ */ jsx(DialogPrimitive.Overlay, {
+		ref,
+		className: cn("fixed inset-0 z-50 bg-black/30 backdrop-blur-sm data-[state=open]:animate-fd-fade-in data-[state=closed]:animate-fd-fade-out", className),
+		...props
+	});
+}
+function DialogContent({ className, children, ref, ...props }) {
 	const t = useTranslations();
 	return /* @__PURE__ */ jsxs(DialogPortal, { children: [/* @__PURE__ */ jsx(DialogOverlay, {}), /* @__PURE__ */ jsxs(DialogPrimitive.Content, {
 		ref,
@@ -31,29 +31,26 @@ const DialogContent = React.forwardRef(({ className, children, ...props }, ref)
 			children: /* @__PURE__ */ jsx(X, {})
 		})]
 	})] });
-});
-DialogContent.displayName = DialogPrimitive.Content.displayName;
-const DialogHeader = ({ className, ...props }) => /* @__PURE__ */ jsx("div", {
-	className: cn("flex flex-col gap-1.5 text-center sm:text-start", className),
-	...props
-});
-DialogHeader.displayName = "DialogHeader";
-const DialogFooter = ({ className, ...props }) => /* @__PURE__ */ jsx("div", {
-	className: cn("flex flex-col-reverse sm:flex-row sm:justify-end sm:gap-2", className),
-	...props
-});
-DialogFooter.displayName = "DialogFooter";
-const DialogTitle = React.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(DialogPrimitive.Title, {
-	ref,
-	className: cn("text-lg font-semibold leading-none tracking-tight", className),
-	...props
-}));
-DialogTitle.displayName = DialogPrimitive.Title.displayName;
-const DialogDescription = React.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(DialogPrimitive.Description, {
-	ref,
-	className: cn("text-sm text-fd-muted-foreground", className),
-	...props
-}));
-DialogDescription.displayName = DialogPrimitive.Description.displayName;
+}
+function DialogHeader({ className, ...props }) {
+	return /* @__PURE__ */ jsx("div", {
+		className: cn("flex flex-col gap-1.5 text-center sm:text-start", className),
+		...props
+	});
+}
+function DialogTitle({ className, ref, ...props }) {
+	return /* @__PURE__ */ jsx(DialogPrimitive.Title, {
+		ref,
+		className: cn("text-lg font-semibold leading-none tracking-tight", className),
+		...props
+	});
+}
+function DialogDescription({ className, ref, ...props }) {
+	return /* @__PURE__ */ jsx(DialogPrimitive.Description, {
+		ref,
+		className: cn("text-sm text-fd-muted-foreground", className),
+		...props
+	});
+}
 //#endregion
 export { Dialog, DialogContent, DialogDescription, DialogHeader, DialogTitle, DialogTrigger };

package/dist/ui/components/heading.js

@@ -0,0 +1,14 @@
+"use client";
+import { useAnchorId } from "../../utils/auto-anchor.client.js";
+import { jsx } from "react/jsx-runtime";
+import { Heading } from "fumadocs-ui/components/heading";
+//#region src/ui/components/heading.tsx
+function Heading$1({ id: _id, depth, ...props }) {
+	return /* @__PURE__ */ jsx(Heading, {
+		id: useAnchorId([_id]),
+		as: `h${depth}`,
+		...props
+	});
+}
+//#endregion
+export { Heading$1 as Heading };

package/dist/ui/components/select-tab.js

@@ -1,7 +1,9 @@
 "use client";
 import { cn } from "../../utils/cn.js";
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "./select.js";
-import { createContext, use, useMemo, useState } from "react";
+import { anchorIdStartsWith } from "../../utils/auto-anchor.js";
+import { AnchorSection, useAnchorId } from "../../utils/auto-anchor.client.js";
+import { createContext, use, useEffect, useMemo, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/ui/components/select-tab.tsx
 const Context = createContext(null);
@@ -15,14 +17,24 @@ function SelectTabs({ defaultValue, children }) {
 		children
 	});
 }
-function SelectTab({ value, ...props }) {
-	if (value !== use(Context)?.value) return;
-	return /* @__PURE__ */ jsx("div", {
-		...props,
-		children: props.children
-	});
+function SelectTab({ value, anchorSegments, ...props }) {
+	const { value: currentValue, setValue } = use(Context);
+	const id = useAnchorId(anchorSegments ?? false);
+	useEffect(() => {
+		if (id && anchorIdStartsWith(window.location.hash.slice(1), id)) setValue(value);
+	}, [
+		id,
+		value,
+		setValue
+	]);
+	if (value !== currentValue) return;
+	const content = /* @__PURE__ */ jsx("div", { ...props });
+	return anchorSegments ? /* @__PURE__ */ jsx(AnchorSection, {
+		segments: anchorSegments,
+		children: content
+	}) : content;
 }
-function SelectTabTrigger({ items, className, ...props }) {
+function SelectTabTrigger({ items, className, placeholder, ...props }) {
 	const { value, setValue } = use(Context);
 	return /* @__PURE__ */ jsxs(Select, {
 		value: value ?? "",
@@ -30,7 +42,10 @@ function SelectTabTrigger({ items, className, ...props }) {
 		children: [/* @__PURE__ */ jsx(SelectTrigger, {
 			className: cn("not-prose w-fit min-w-0 *:min-w-0", className),
 			...props,
-			children: /* @__PURE__ */ jsx(SelectValue, { children: value && items.find((item) => item.value === value)?.label })
+			children: /* @__PURE__ */ jsx(SelectValue, {
+				placeholder,
+				children: value && items.find((item) => item.value === value)?.label
+			})
 		}), /* @__PURE__ */ jsx(SelectContent, { children: items.map(({ label, value }) => /* @__PURE__ */ jsx(SelectItem, {
 			value,
 			children: label

package/dist/ui/create-client.js

@@ -5,11 +5,9 @@ import { AuthProvider } from "../playground/auth.js";
 import { dereferenceDocument } from "../utils/document/dereference.js";
 import { APIPage } from "./api-page.js";
 import { boundary_exports } from "./client/boundary.js";
-import { slug } from "github-slugger";
 import { Children, useMemo } from "react";
 import * as JsxRuntime from "react/jsx-runtime";
 import { jsx } from "react/jsx-runtime";
-import { Heading } from "fumadocs-ui/components/heading";
 import { remarkGfm } from "fumadocs-core/mdx-plugins/remark-gfm";
 import defaultMdxComponents from "fumadocs-ui/mdx";
 import { remark } from "remark";
@@ -90,21 +88,6 @@ function createClientAPIPage({ shiki = defaultShikiFactory, shikiOptions = { the
 				provider: options.playground?.provider ?? renderPlaygroundProviderDefault,
 				render: options.playground?.render ?? renderPlaygroundDefault
 			},
-			renderHeading(depth, text, props) {
-				const id = typeof text === "string" ? slug(text) : props?.id;
-				if (!id) throw new Error("missing 'id' for non-string children");
-				if (options.renderHeading) return options.renderHeading({
-					id,
-					children: text,
-					...props
-				}, depth);
-				return /* @__PURE__ */ jsx(Heading, {
-					id,
-					as: `h${depth}`,
-					...props,
-					children: text
-				}, id);
-			},
 			renderMarkdown(text) {
 				if (options.renderMarkdown) return options.renderMarkdown(text);
 				processor ??= createMarkdownProcessor();

package/dist/ui/operation/client.js

@@ -56,7 +56,7 @@ function CopyTypeScriptPanel({ name, code, className }) {
 	const t = useTranslations();
 	const useTypeText = t.useTypeInTypeScript.replace("{name}", name);
 	return /* @__PURE__ */ jsxs("div", {
-		className: cn("flex items-start justify-between gap-2 bg-fd-card text-fd-card-foreground border rounded-xl p-3 not-prose mb-4 last:mb-0", className),
+		className: cn("flex items-start justify-between gap-2 bg-fd-card text-fd-card-foreground border rounded-xl p-3 not-prose", className),
 		children: [/* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("p", {
 			className: "font-medium text-sm mb-2",
 			children: t.typeScriptDefinitions