fumadocs-openapi 9.3.12 → 9.3.13

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

@@ -1,10 +1,17 @@
 import type { PageTree } from 'fumadocs-core/server';
-import type { PageFile, PageTreeTransformer } from 'fumadocs-core/source';
+import type { LoaderPlugin, PageFile, PageTreeTransformer } from 'fumadocs-core/source';
 /**
- * Source API Integration
+ * Fumadocs Source API integration, pass this to `plugins` array in `loader()`.
+ */
+export declare function openapiPlugin(): LoaderPlugin;
+/**
+ * Source API Integration, add this to page tree builder options.
  *
- * Add this to page tree builder options
+ * @deprecated use `openapiPlugin()`
  */
 export declare const attachFile: (node: PageTree.Item, file: PageFile | undefined) => PageTree.Item;
+/**
+ * @deprecated use `openapiPlugin()`
+ */
 export declare function transformerOpenAPI(): PageTreeTransformer;
 //# sourceMappingURL=source-api.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"source-api.d.ts","sourceRoot":"","sources":["../../src/server/source-api.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,UAAU,GACrB,MAAM,QAAQ,CAAC,IAAI,EACnB,MAAM,QAAQ,GAAG,SAAS,KACzB,QAAQ,CAAC,IA4BX,CAAC;AAEF,wBAAgB,kBAAkB,IAAI,mBAAmB,CASxD"}
+{"version":3,"file":"source-api.d.ts","sourceRoot":"","sources":["../../src/server/source-api.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EACV,YAAY,EACZ,QAAQ,EACR,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,wBAAgB,aAAa,IAAI,YAAY,CAkC5C;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,GACrB,MAAM,QAAQ,CAAC,IAAI,EACnB,MAAM,QAAQ,GAAG,SAAS,KACzB,QAAQ,CAAC,IA4BX,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,mBAAmB,CAExD"}

package/dist/server/source-api.js

@@ -1,9 +1,35 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { MethodLabel } from '../ui/components/method-label.js';
 /**
- * Source API Integration
+ * Fumadocs Source API integration, pass this to `plugins` array in `loader()`.
+ */
+export function openapiPlugin() {
+    return {
+        transformPageTree: {
+            file(node, filePath) {
+                if (!filePath)
+                    return node;
+                const file = this.storage.read(filePath);
+                if (!file || file.format !== 'page')
+                    return node;
+                const data = file.data;
+                let method;
+                if ('_openapi' in data && typeof data._openapi === 'object') {
+                    const meta = data._openapi;
+                    method = meta.method;
+                }
+                if (method) {
+                    node.name = (_jsxs(_Fragment, { children: [node.name, ' ', _jsx(MethodLabel, { className: "ms-auto text-xs text-nowrap", children: method })] }));
+                }
+                return node;
+            },
+        },
+    };
+}
+/**
+ * Source API Integration, add this to page tree builder options.
  *
- * Add this to page tree builder options
+ * @deprecated use `openapiPlugin()`
  */
 export const attachFile = (node, file) => {
     if (!file)
@@ -22,13 +48,9 @@ export const attachFile = (node, file) => {
     }
     return node;
 };
+/**
+ * @deprecated use `openapiPlugin()`
+ */
 export function transformerOpenAPI() {
-    return {
-        file(node, file) {
-            if (!file)
-                return node;
-            const content = this.storage.read(file);
-            return attachFile(node, content?.format === 'page' ? content : undefined);
-        },
-    };
+    return openapiPlugin().transformPageTree;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-openapi",
-  "version": "9.3.12",
+  "version": "9.3.13",
   "description": "Generate MDX docs for your OpenAPI spec",
   "keywords": [
     "NextJs",
@@ -50,8 +50,8 @@
     "@radix-ui/react-dialog": "^1.1.15",
     "@radix-ui/react-select": "^2.2.6",
     "@radix-ui/react-slot": "^1.2.3",
-    "@scalar/json-magic": "^0.5.1",
-    "@scalar/openapi-parser": "0.21.1",
+    "@scalar/json-magic": "^0.5.2",
+    "@scalar/openapi-parser": "0.21.2",
     "ajv": "^8.17.1",
     "class-variance-authority": "^0.7.1",
     "github-slugger": "^2.0.0",
@@ -65,15 +65,15 @@
     "remark-rehype": "^11.1.2",
     "tinyglobby": "^0.2.15",
     "xml-js": "^1.6.11",
-    "fumadocs-core": "15.8.0",
-    "fumadocs-ui": "15.8.0"
+    "fumadocs-core": "15.8.1",
+    "fumadocs-ui": "15.8.1"
   },
   "devDependencies": {
-    "@scalar/api-client-react": "^1.3.40",
+    "@scalar/api-client-react": "^1.3.41",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "24.5.2",
     "@types/openapi-sampler": "^1.0.3",
-    "@types/react": "^19.1.13",
+    "@types/react": "^19.1.14",
     "json-schema-typed": "^8.0.1",
     "openapi-types": "^12.1.3",
     "tailwindcss": "^4.1.13",