fumadocs-openapi 5.1.0 → 5.2.1

package/dist/index.d.ts

@@ -155,7 +155,7 @@ interface ParameterSample {
 interface CodeSample {
     lang: string;
     label: string;
-    source: string;
+    source?: string;
 }
 
 interface RouteInformation {
@@ -247,10 +247,10 @@ interface Config extends GenerateOptions {
     output: string;
     /**
      * tag: Generate a page for each tag
-     *
      * file: Generate a page for each schema
+     * operation: Generate a page for each API endpoint/operation
      *
-     * @defaultValue file
+     * @defaultValue 'operation'
      */
     per?: 'tag' | 'file' | 'operation';
     /**

package/dist/index.js

@@ -95,7 +95,7 @@ function generateDocument(options) {
     if (imports) {
         out.push(imports);
     }
-    out.push(pageContent(data, options.page));
+    out.push(pageContent(options.page));
     return out.join('\n\n');
 }
 function generateStaticData(dereferenced, props) {
@@ -131,26 +131,8 @@ function generateStaticData(dereferenced, props) {
         structuredData
     };
 }
-function pageContent(data, props) {
-    // modify toc and structured data if possible
-    // it may not be compatible with other content sources except Fumadocs MDX
-    // TODO: Maybe add to frontmatter and let developers to handle them?
-    return `<APIPage document={${JSON.stringify(props.document)}} operations={${JSON.stringify(props.operations)}} hasHead={${JSON.stringify(props.hasHead)}} />
-
-export function startup() {
-    if (typeof toc !== 'undefined') {
-        // toc might be immutable
-        while (toc.length > 0) toc.pop()
-        toc.push(...${JSON.stringify(data.toc)})
-    }
-    
-    if (typeof structuredData !== 'undefined') {
-        structuredData.headings = ${JSON.stringify(data.structuredData.headings)}
-        structuredData.contents = ${JSON.stringify(data.structuredData.contents)}
-    }
-}
-
-{startup()}`;
+function pageContent(props) {
+    return `<APIPage document={${JSON.stringify(props.document)}} operations={${JSON.stringify(props.operations)}} hasHead={${JSON.stringify(props.hasHead)}} />`;
 }
 
 async function dereference(pathOrDocument, options) {
@@ -257,7 +239,7 @@ async function generateTags(pathOrDocument, options = {}) {
 }
 
 async function generateFiles(options) {
-    const { input, output, name: nameFn, per = 'file', groupBy = 'none', cwd = process.cwd() } = options;
+    const { input, output, name: nameFn, per = 'operation', groupBy = 'none', cwd = process.cwd() } = options;
     const outputDir = join(cwd, output);
     const urlInputs = [];
     const fileInputs = [];

package/dist/server/index.d.ts

@@ -156,7 +156,7 @@ interface ParameterSample {
 interface CodeSample {
     lang: string;
     label: string;
-    source: string;
+    source?: string;
 }
 
 type Awaitable<T> = T | Promise<T>;

package/dist/server/index.js

@@ -765,7 +765,7 @@ async function APIExample({ method, endpoint, ctx }) {
         },
         ...ctx.generateCodeSamples ? await ctx.generateCodeSamples(endpoint) : [],
         ...method['x-codeSamples'] ?? []
-    ]);
+    ]).filter((item)=>item.source !== undefined);
     children.push(/*#__PURE__*/ jsx(renderer.Requests, {
         items: samples.map((s)=>s.label),
         children: samples.map((s)=>/*#__PURE__*/ jsx(renderer.Request, {
@@ -1090,8 +1090,6 @@ function getBadgeColor(method) {
     if ('_openapi' in data && typeof data._openapi === 'object') {
         const meta = data._openapi;
         method = meta.method;
-    } else if ('method' in data && typeof data.method === 'string') {
-        method = data.method;
     }
     if (method) {
         const color = getBadgeColor(method);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-openapi",
-  "version": "5.1.0",
+  "version": "5.2.1",
   "description": "Generate MDX docs for your OpenAPI spec",
   "keywords": [
     "NextJs",
@@ -54,18 +54,18 @@
     "github-slugger": "^2.0.0",
     "js-yaml": "^4.1.0",
     "json-schema-to-typescript": "^15.0.0",
-    "lucide-react": "^0.427.0",
+    "lucide-react": "^0.428.0",
     "openapi-sampler": "^1.5.1",
     "react-hook-form": "^7.52.2",
     "remark": "^15.0.0",
-    "shiki": "^1.12.1",
+    "shiki": "^1.13.0",
     "swr": "^2.2.5",
-    "fumadocs-core": "13.2.1",
-    "fumadocs-ui": "13.2.1"
+    "fumadocs-core": "13.3.0",
+    "fumadocs-ui": "13.3.0"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "20.14.12",
+    "@types/node": "22.3.0",
     "@types/openapi-sampler": "^1.0.3",
     "@types/react": "^18.3.3",
     "bunchee": "^5.3.2",