fumadocs-openapi 10.8.6 → 10.9.0

package/css/generated/shared.css

@@ -328,7 +328,6 @@
 @source inline("flex-col-reverse");
 @source inline("flex-row");
 @source inline("flex-wrap");
-@source inline("flow");
 @source inline("flows");
 @source inline("focus-visible:outline-none");
 @source inline("focus-visible:ring-1");
@@ -355,6 +354,7 @@
 @source inline("fromServer");
 @source inline("fs");
 @source inline("full");
+@source inline("fumadocs-core/i18n");
 @source inline("fumadocs-core/source");
 @source inline("fumadocs-core/toc");
 @source inline("fumadocs-ui/mdx");
@@ -675,7 +675,6 @@
 @source inline("place");
 @source inline("placeholder");
 @source inline("placeholder:text-fd-muted-foreground");
-@source inline("placeholders");
 @source inline("playground");
 @source inline("playgroundEnabled");
 @source inline("playgrounds");
@@ -761,6 +760,7 @@
 @source inline("renderRequestTabsDefault");
 @source inline("renderResponseTabs");
 @source inline("renderResponseTabsDefault");
+@source inline("renderTranslation");
 @source inline("renderTrigger");
 @source inline("renderWebhookLayout");
 @source inline("rendered");
@@ -961,6 +961,7 @@
 @source inline("tab");
 @source inline("tabs");
 @source inline("tag");
+@source inline("test");
 @source inline("testQuery");
 @source inline("text");
 @source inline("text-[0.8125rem]");
@@ -1027,7 +1028,6 @@
 @source inline("transition-colors");
 @source inline("transition-transform");
 @source inline("translated");
-@source inline("translation");
 @source inline("tree");
 @source inline("trigger");
 @source inline("true");
@@ -1064,7 +1064,6 @@
 @source inline("useAuth");
 @source inline("useCopyButton");
 @source inline("useFieldValue");
-@source inline("useI18n");
 @source inline("useMemo");
 @source inline("useNamespace");
 @source inline("useObject");
@@ -1080,6 +1079,7 @@
 @source inline("useStorageKey");
 @source inline("useTheme");
 @source inline("useTranslations");
+@source inline("useTranslationsBase");
 @source inline("useTypeText");
 @source inline("used");
 @source inline("username");
@@ -1114,7 +1114,6 @@
 @source inline("will");
 @source inline("with");
 @source inline("withBase");
-@source inline("withReplacements");
 @source inline("without");
 @source inline("wrap");
 @source inline("wrap-break-word");

package/dist/i18n.d.ts

@@ -1,3 +1,4 @@
+import { TranslationValue, TranslationsAPIExtension } from "fumadocs-core/i18n";
 import { I18nUIConfig } from "fumadocs-ui/i18n";
 
 //#region src/i18n.d.ts
@@ -14,6 +15,7 @@ declare const defaultTranslations: {
   body: string;
   deprecated: string;
   submit: string;
+  test: string;
   unsupported: string;
   close: string;
   inputPlaceholder: string;
@@ -32,7 +34,7 @@ declare const defaultTranslations: {
   authTokenIn: string;
   authScope: string;
   typeScriptDefinitions: string;
-  useTypeInTypeScript: string;
+  useTypeInTypeScript: TranslationValue<"name">;
   schemaDefault: string;
   schemaMatch: string;
   schemaFormat: string;
@@ -43,7 +45,7 @@ declare const defaultTranslations: {
   schemaItems: string;
   schemaValueIn: string;
   schemaExample: string;
-  responseTabName: string;
+  responseTabName: TranslationValue<"key">;
   responseTabNameDefault: string;
   closeJsonEditor: string;
   openJsonEditor: string;
@@ -58,7 +60,8 @@ declare const defaultTranslations: {
   statusSuccessful: string;
   statusError: string;
   statusClientError: string;
-  statusBinaryBody: string;
+  statusBinaryBody: TranslationValue<"length">;
+  oauthFlowPlaceholder: string;
   obtainAccessToken: string;
   resourceOwnerPassword: string;
   resourceOwnerPasswordDesc: string;
@@ -96,6 +99,8 @@ declare const defaultTranslations: {
   playgroundInputUnset: string;
 };
 type Translations = typeof defaultTranslations;
+declare function openapiTranslations(): TranslationsAPIExtension<'openapi', Translations>;
+/** @deprecated use `i18n.translations()` & `openapiTranslations()` instead */
 declare function defineI18nOpenAPI<Languages extends string>(config: I18nUIConfig<Languages>, translations: Partial<Record<NoInfer<Languages>, Partial<Translations>>>): I18nUIConfig<Languages>;
 //#endregion
-export { Translations, defaultTranslations, defineI18nOpenAPI };
+export { Translations, defaultTranslations, defineI18nOpenAPI, openapiTranslations };

package/dist/i18n.js

@@ -1,6 +1,4 @@
-import { require_deepmerge } from "./node_modules/.pnpm/@fastify_deepmerge@3.2.1/node_modules/@fastify/deepmerge/index.js";
 //#region src/i18n.ts
-var import_deepmerge = require_deepmerge();
 const defaultTranslations = {
 	loading: "loading...",
 	empty: "Empty",
@@ -14,6 +12,7 @@ const defaultTranslations = {
 	body: "Body",
 	deprecated: "Deprecated",
 	submit: "Submit",
+	test: "Test",
 	unsupported: "Unsupported",
 	close: "Close",
 	inputPlaceholder: "Enter value",
@@ -59,6 +58,7 @@ const defaultTranslations = {
 	statusError: "Error",
 	statusClientError: "Client Error",
 	statusBinaryBody: "Binary response body, {length} bytes",
+	oauthFlowPlaceholder: "Select a flow",
 	obtainAccessToken: "Obtain the access token for API.",
 	resourceOwnerPassword: "Resource Owner Password Flow",
 	resourceOwnerPasswordDesc: "Authenticate using username and password.",
@@ -95,8 +95,14 @@ const defaultTranslations = {
 	playgroundInputUpload: "Upload",
 	playgroundInputUnset: "Unset"
 };
+function openapiTranslations() {
+	return {
+		namespace: "openapi",
+		defaultValue: defaultTranslations
+	};
+}
+/** @deprecated use `i18n.translations()` & `openapiTranslations()` instead */
 function defineI18nOpenAPI(config, translations) {
-	const dm = (0, import_deepmerge.deepmerge)();
 	return {
 		...config,
 		provider(locale = config.defaultLanguage) {
@@ -104,11 +110,14 @@ function defineI18nOpenAPI(config, translations) {
 			const data = translations[locale];
 			if (data) {
 				out.translations ??= {};
-				out.translations.openapi = dm(defaultTranslations, data);
+				out.translations.openapi = {
+					...defaultTranslations,
+					...data
+				};
 			}
 			return out;
 		}
 	};
 }
 //#endregion
-export { defaultTranslations, defineI18nOpenAPI };
+export { defaultTranslations, defineI18nOpenAPI, openapiTranslations };

package/dist/playground/components/oauth-dialog.js

@@ -138,7 +138,7 @@ function Content({ schemeId, scopes, setToken, setOpen }) {
 			/* @__PURE__ */ jsxs(Select, {
 				value: type ?? "",
 				onValueChange: setType,
-				children: [/* @__PURE__ */ jsx(SelectTrigger, { children: /* @__PURE__ */ jsx(SelectValue, { placeholder: "Select a flow" }) }), /* @__PURE__ */ jsx(SelectContent, { children: Object.keys(scheme.flows).map((key) => {
+				children: [/* @__PURE__ */ jsx(SelectTrigger, { children: /* @__PURE__ */ jsx(SelectValue, { placeholder: t.oauthFlowPlaceholder }) }), /* @__PURE__ */ jsx(SelectContent, { children: Object.keys(scheme.flows).map((key) => {
 					const { name, description } = allFlows[key];
 					return /* @__PURE__ */ jsxs(SelectItem, {
 						value: key,

package/dist/playground/components/result-display.js

@@ -1,5 +1,5 @@
 "use client";
-import { useTranslations, withReplacements } from "../../ui/client/i18n.js";
+import { useTranslations } from "../../ui/client/i18n.js";
 import { useStatusInfo } from "../status-info.js";
 import { cn } from "../../utils/cn.js";
 import { ClientCodeBlock } from "../../ui/components/codeblock.js";
@@ -7,6 +7,7 @@ import { require_fast_content_type_parse } from "../../node_modules/.pnpm/fast-c
 import { useEffect, useMemo, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { CircleX } from "lucide-react";
+import { renderTranslation } from "fumadocs-core/i18n";
 import { buttonVariants } from "fumadocs-ui/components/ui/button";
 import { cva } from "class-variance-authority";
 //#region src/playground/components/result-display.tsx
@@ -76,7 +77,7 @@ function ResponseResult({ data, reset, ...rest }) {
 		});
 		else content = /* @__PURE__ */ jsx("p", {
 			className: "p-2 border rounded-lg bg-fd-card text-fd-card-foreground",
-			children: withReplacements(t.statusBinaryBody, { length: String(data.body.byteLength) })
+			children: renderTranslation(t.statusBinaryBody, { length: String(data.body.byteLength) })
 		});
 	}
 	return /* @__PURE__ */ jsxs("div", {

package/dist/playground/components/spinner.js

@@ -1,3 +1,4 @@
+import { useTranslations } from "../../ui/client/i18n.js";
 import { cn } from "../../utils/cn.js";
 import { jsx } from "react/jsx-runtime";
 import { Loader2Icon } from "lucide-react";
@@ -5,7 +6,7 @@ import { Loader2Icon } from "lucide-react";
 function Spinner({ className, ...props }) {
 	return /* @__PURE__ */ jsx(Loader2Icon, {
 		role: "status",
-		"aria-label": "Loading",
+		"aria-label": useTranslations().loading,
 		className: cn("size-4 animate-spin", className),
 		...props
 	});

package/dist/scalar/client.js

@@ -1,4 +1,5 @@
 "use client";
+import { I18nLabel } from "../ui/client/i18n.js";
 import { cn } from "../utils/cn.js";
 import { MethodLabel } from "../ui/components/method-label.js";
 import { useEffect, useState } from "react";
@@ -39,7 +40,7 @@ function ScalarPlayground({ path, method, spec }) {
 					path,
 					method
 				}),
-				children: "Test"
+				children: /* @__PURE__ */ jsx(I18nLabel, { label: "test" })
 			})
 		]
 	});

package/dist/ui/client/i18n.js

@@ -1,19 +1,16 @@
 "use client";
 import { defaultTranslations } from "../../i18n.js";
-import { useI18n } from "fumadocs-ui/contexts/i18n";
+import { renderTranslation } from "fumadocs-core/i18n";
+import { useTranslations } from "fumadocs-ui/contexts/i18n";
 //#region src/ui/client/i18n.ts
-function useTranslations() {
-	return useI18n().text.openapi ?? defaultTranslations;
+function useTranslations$1() {
+	return useTranslations("openapi") ?? defaultTranslations;
 }
 /**
 * Renders a translated string. Use in server components so the label is resolved on the client from the current locale.
 */
-function I18nLabel({ label, replacements = {} }) {
-	return withReplacements(useTranslations()[label], replacements);
-}
-function withReplacements(t, replacements) {
-	for (const [k, v] of Object.entries(replacements)) t = t.replaceAll(`{${k}}`, v);
-	return t;
+function I18nLabel({ label, replacements }) {
+	return renderTranslation(useTranslations$1()[label], replacements);
 }
 //#endregion
-export { I18nLabel, useTranslations, withReplacements };
+export { I18nLabel, useTranslations$1 as useTranslations };

package/dist/utils/schema/sample.js

@@ -1,5 +1,5 @@
-import { require_deepmerge } from "../../node_modules/.pnpm/@fastify_deepmerge@3.2.1/node_modules/@fastify/deepmerge/index.js";
 import { isPlainObject } from "../is-plain-object.js";
+import { require_deepmerge } from "../../node_modules/.pnpm/@fastify_deepmerge@3.2.1/node_modules/@fastify/deepmerge/index.js";
 import { resolveRefSync } from "./resolve-ref.js";
 const mergeDeep = (0, require_deepmerge().deepmerge)({
 	all: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-openapi",
-  "version": "10.8.6",
+  "version": "10.9.0",
   "description": "Generate MDX docs for your OpenAPI spec",
   "keywords": [
     "Docs",
@@ -72,15 +72,15 @@
     "tailwindcss": "^4.3.0",
     "tsdown": "0.22.0",
     "xml-js": "^1.6.11",
-    "fumadocs-core": "16.8.12",
-    "fumadocs-ui": "16.8.12",
+    "fumadocs-core": "16.9.0",
+    "fumadocs-ui": "16.9.0",
     "tsconfig": "0.0.0"
   },
   "peerDependencies": {
     "@scalar/api-client-react": "2.0.1",
     "@types/react": "*",
-    "fumadocs-core": "^16.7.15",
-    "fumadocs-ui": "^16.7.15",
+    "fumadocs-core": "^16.9.0",
+    "fumadocs-ui": "^16.9.0",
     "json-schema-typed": "*",
     "react": "^19.2.0",
     "react-dom": "^19.2.0"