fumadocs-openapi 10.3.3 → 10.3.5

package/css/generated/shared.css

@@ -610,6 +610,7 @@
 @source inline("red");
 @source inline("redirect_uri");
 @source inline("ref");
+@source inline("reference");
 @source inline("references");
 @source inline("refs");
 @source inline("registered");
@@ -854,6 +855,7 @@
 @source inline("typeVariants");
 @source inline("typeof");
 @source inline("types");
+@source inline("unchanged");
 @source inline("undefined");
 @source inline("under");
 @source inline("underline");
@@ -880,6 +882,7 @@
 @source inline("useRef");
 @source inline("useResolvedSchema");
 @source inline("useSchemaScope");
+@source inline("useServerContext");
 @source inline("useServerSelectContext");
 @source inline("useState");
 @source inline("useStf");

package/dist/playground/client.js

@@ -2,7 +2,7 @@
 
 import { joinURL, resolveRequestData, resolveServerUrl, withBase } from "../utils/url.js";
 import { useStorageKey } from "../ui/client/storage-key.js";
-import { useApiContext } from "../ui/contexts/api.js";
+import { useApiContext, useServerContext } from "../ui/contexts/api.js";
 import { getStatusInfo } from "./status-info.js";
 import { cn } from "../utils/cn.js";
 import { MethodLabel } from "../ui/components/method-label.js";
@@ -29,7 +29,8 @@ const OauthDialogTrigger = lazy(() => import("./components/oauth-dialog.js").the
 function PlaygroundClient({ route, method = "GET", securities, parameters = [], body, references, proxyUrl, writeOnly, readOnly, ...rest }) {
 	const { example: exampleId, examples, setExampleData } = useExampleRequests();
 	const storageKeys = useStorageKey();
-	const { mediaAdapters, serverRef, client: { playground: { components: { ResultDisplay = DefaultResultDisplay } = {}, requestTimeout = 10, transformAuthInputs } = {} } } = useApiContext();
+	const { mediaAdapters, client: { playground: { components: { ResultDisplay = DefaultResultDisplay } = {}, requestTimeout = 10, transformAuthInputs } = {} } } = useApiContext();
+	const { serverRef } = useServerContext();
 	const [securityId, setSecurityId] = useState(0);
 	const { inputs, mapInputs, initAuthValues } = useAuthInputs(securities[securityId], transformAuthInputs);
 	const defaultValues = useMemo(() => {
@@ -77,9 +78,8 @@ function PlaygroundClient({ route, method = "GET", securities, parameters = [],
 		}
 	});
 	useEffect(() => {
-		return () => {
-			stf.dataEngine.reset(defaultValues);
-		};
+		if (stf.dataEngine.getData() === defaultValues) return;
+		stf.dataEngine.reset(defaultValues);
 	}, [defaultValues]);
 	useEffect(() => {
 		return initAuthValues(stf);

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

@@ -1,7 +1,7 @@
 'use client';
 
 import { resolveServerUrl, withBase } from "../../utils/url.js";
-import { useApiContext, useServerSelectContext } from "../../ui/contexts/api.js";
+import { useServerContext, useServerSelectContext } from "../../ui/contexts/api.js";
 import { cn } from "../../utils/cn.js";
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "../../ui/components/select.js";
 import { Input, labelVariants } from "../../ui/components/input.js";
@@ -12,7 +12,7 @@ import { StfProvider, useFieldValue, useListener, useStf } from "@fumari/stf";
 
 //#region src/playground/components/server-select.tsx
 function ServerSelect(props) {
-	const { servers } = useApiContext();
+	const { servers } = useServerContext();
 	const { server, setServer, setServerVariables } = useServerSelectContext();
 	const [open, setOpen] = useState(false);
 	const [isMounted, setIsMounted] = useState(false);

package/dist/types.d.ts

@@ -28,7 +28,6 @@ type MethodInformation = NoReference<OperationObject> & {
   'x-exclusiveCodeSample'?: string;
 };
 interface RenderContext extends Pick<OpenAPIOptions, 'proxyUrl'>, Omit<CreateAPIPageOptions, 'renderMarkdown'> {
-  servers: NoReference<ServerObject>[];
   slugger: Slugger;
   /**
    * dereferenced schema

package/dist/ui/api-page.js

@@ -1,6 +1,6 @@
 import { createMethod } from "../utils/schema.js";
+import { ApiProviderLazy, ServerProviderLazy } from "./contexts/api.lazy.js";
 import { Operation } from "./operation/index.js";
-import { ApiProviderLazy } from "./contexts/api.lazy.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 
 //#region src/ui/api-page.tsx
@@ -46,11 +46,15 @@ async function APIPage({ showTitle: hasHead = false, showDescription, operations
 			};
 		})
 	}, ctx);
+	let servers = ctx.schema.dereferenced.servers;
+	if (!servers || servers.length === 0) servers = [{ url: "/" }];
 	return /* @__PURE__ */ jsx(ApiProviderLazy, {
-		servers: ctx.servers,
 		shikiOptions: ctx.shikiOptions,
 		client: ctx.client ?? {},
-		children: content
+		children: /* @__PURE__ */ jsx(ServerProviderLazy, {
+			servers,
+			children: content
+		})
 	});
 }
 

package/dist/ui/base.js

@@ -36,14 +36,11 @@ function createAPIPage(server, options) {
 		let processed;
 		if (typeof document === "string") processed = await server.getSchema(document);
 		else processed = await document;
-		const { dereferenced } = processed;
-		const servers = dereferenced.servers && dereferenced.servers.length > 0 ? dereferenced.servers : [{ url: "/" }];
 		const slugger = new Slugger();
 		const ctx = {
 			schema: processed,
 			proxyUrl: server.options.proxyUrl,
 			...options,
-			servers,
 			mediaAdapters: {
 				...defaultAdapters,
 				...options.mediaAdapters

package/dist/ui/contexts/api.js

@@ -6,6 +6,7 @@ import { createContext, use, useEffect, useMemo, useRef, useState } from "react"
 import { jsx } from "react/jsx-runtime";
 
 //#region src/ui/contexts/api.tsx
+const ServerContext = createContext(null);
 const ApiContext = createContext(null);
 const ServerSelectContext = createContext(null);
 function useApiContext() {
@@ -13,28 +14,34 @@ function useApiContext() {
 	if (!ctx) throw new Error("Component must be used under <ApiProvider />");
 	return ctx;
 }
+function useServerContext() {
+	return use(ServerContext);
+}
 function useServerSelectContext() {
 	const ctx = use(ServerSelectContext);
 	if (!ctx) throw new Error("Component must be used under <ApiProvider />");
 	return ctx;
 }
-function ApiProvider({ defaultBaseUrl, children, servers, shikiOptions, client }) {
-	const serverRef = useRef(null);
+function ApiProvider({ children, shikiOptions, client }) {
 	return /* @__PURE__ */ jsx(ApiContext, {
 		value: useMemo(() => ({
-			serverRef,
 			shikiOptions,
 			client,
 			mediaAdapters: {
 				...defaultAdapters,
 				...client.mediaAdapters
-			},
-			servers
-		}), [
+			}
+		}), [client, shikiOptions]),
+		children
+	});
+}
+function ServerProvider({ servers, defaultBaseUrl, children }) {
+	const serverRef = useRef(null);
+	return /* @__PURE__ */ jsx(ServerContext, {
+		value: useMemo(() => ({
 			servers,
-			client,
-			shikiOptions
-		]),
+			serverRef
+		}), [servers]),
 		children: /* @__PURE__ */ jsx(ServerSelectProvider, {
 			defaultBaseUrl,
 			children
@@ -42,7 +49,7 @@ function ApiProvider({ defaultBaseUrl, children, servers, shikiOptions, client }
 	});
 }
 function ServerSelectProvider({ defaultBaseUrl, children }) {
-	const { servers, serverRef } = useApiContext();
+	const { servers, serverRef } = use(ServerContext);
 	const storageKeys = useStorageKey();
 	const [server, setServer] = useState(() => {
 		const defaultItem = defaultBaseUrl ? servers.find((item) => item.url === defaultBaseUrl) : servers[0];
@@ -101,4 +108,4 @@ function getDefaultValues(server) {
 }
 
 //#endregion
-export { ApiProvider, useApiContext, useServerSelectContext };
+export { ApiProvider, ServerProvider, useApiContext, useServerContext, useServerSelectContext };

package/dist/ui/contexts/api.lazy.js

@@ -4,6 +4,7 @@ import { wrapLazy } from "../../utils/lazy.js";
 
 //#region src/ui/contexts/api.lazy.ts
 const ApiProviderLazy = wrapLazy(() => import("./api.js").then((mod) => ({ default: mod.ApiProvider })));
+const ServerProviderLazy = wrapLazy(() => import("./api.js").then((mod) => ({ default: mod.ServerProvider })));
 
 //#endregion
-export { ApiProviderLazy };
+export { ApiProviderLazy, ServerProviderLazy };

package/dist/ui/operation/index.js

@@ -11,6 +11,7 @@ import { AccordionContent, AccordionHeader, AccordionItem, AccordionTrigger, Acc
 import { UsageTabs } from "./usage-tabs/index.js";
 import { CopyResponseTypeScript, SelectTab, SelectTabTrigger, SelectTabs } from "./client.js";
 import { RequestTabs, getExampleRequests } from "./request-tabs.js";
+import { ServerProviderLazy } from "../contexts/api.lazy.js";
 import { Fragment } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 
@@ -211,7 +212,7 @@ async function Operation({ type = "operation", path, method, ctx, showTitle, sho
 			});
 		};
 		const playgroundEnabled = ctx.playground?.enabled ?? true;
-		const content = await renderOperationLayout({
+		let content = await renderOperationLayout({
 			header: headNode,
 			description: descriptionNode,
 			authSchemes: authNode,
@@ -238,12 +239,17 @@ async function Operation({ type = "operation", path, method, ctx, showTitle, sho
 				ctx
 			})
 		}, ctx, method);
-		return /* @__PURE__ */ jsx(UsageTabsProviderLazy, {
+		content = /* @__PURE__ */ jsx(UsageTabsProviderLazy, {
 			defaultExampleId: method["x-exclusiveCodeSample"] ?? method["x-selectedCodeSample"],
 			route: path,
 			examples: getExampleRequests(path, method, ctx),
 			children: content
 		});
+		if (method.servers) content = /* @__PURE__ */ jsx(ServerProviderLazy, {
+			servers: method.servers,
+			children: content
+		});
+		return content;
 	} else {
 		renderWebhookLayout ??= (slots) => /* @__PURE__ */ jsxs("div", {
 			className: "flex flex-col-reverse gap-x-6 gap-y-4 @4xl:flex-row @4xl:items-start",

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

@@ -16,7 +16,7 @@ function UsageTabsProvider({ route, examples, defaultExampleId, children }) {
 		value: useMemo(() => ({
 			example,
 			route,
-			setExample: (newKey) => {
+			setExample(newKey) {
 				const example = examples.find((example) => example.id === newKey);
 				if (!example) return;
 				setExample(newKey);

package/dist/utils/schema.js

@@ -24,6 +24,7 @@ function createMethod(method, path, operation) {
 		description: path.description,
 		summary: path.summary,
 		...operation,
+		servers: operation.servers ?? path.servers,
 		parameters: [...operation.parameters ?? [], ...path.parameters ?? []],
 		method: method.toUpperCase()
 	};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-openapi",
-  "version": "10.3.3",
+  "version": "10.3.5",
   "description": "Generate MDX docs for your OpenAPI spec",
   "keywords": [
     "Docs",
@@ -76,7 +76,7 @@
     "remark-rehype": "^11.1.2",
     "tailwind-merge": "^3.4.0",
     "xml-js": "^1.6.11",
-    "@fumari/stf": "^0.0.2"
+    "@fumari/stf": "^0.0.3"
   },
   "devDependencies": {
     "@scalar/api-client-react": "^1.3.91",
@@ -90,8 +90,8 @@
     "tsdown": "^0.20.3",
     "@fumadocs/tailwind": "0.0.2",
     "eslint-config-custom": "0.0.0",
-    "fumadocs-core": "16.5.2",
-    "fumadocs-ui": "16.5.2",
+    "fumadocs-core": "16.6.0",
+    "fumadocs-ui": "16.6.0",
     "tsconfig": "0.0.0"
   },
   "peerDependencies": {
@@ -121,7 +121,7 @@
   "scripts": {
     "build": "tsdown --config-loader unrun",
     "clean": "rimraf dist",
-    "dev": "tsdown --watch",
+    "dev": "tsdown --watch --clean false",
     "lint": "eslint .",
     "types:check": "tsc --noEmit"
   }