OpenAPI: Change default value of per to operation

.changeset/tough-phones-approve.md

@@ -0,0 +1,5 @@
+---
+'fumadocs-openapi': minor
+---
+
+Change default value of `per` to `operation`

apps/docs/content/docs/ui/(integrations)/openapi/configurations.mdx

@@ -46,7 +46,7 @@ void generateFiles({
 
 ### Per
 
-Customise how the page is generated, default to `file`.
+Customise how the page is generated, default to `operation`.
 
 | mode      | Generate a page for                 |
 | --------- | ----------------------------------- |
@@ -185,7 +185,7 @@ import { createOpenAPI } from 'fumadocs-openapi/server';
 
 export const openapi = createOpenAPI({
   renderer: {
-    Root(props, child) {
+    Root(props) {
       // your own (server) component
     },
   },

packages/openapi/src/generate-file.ts

@@ -17,10 +17,10 @@ export interface Config extends GenerateOptions {
 
   /**
    * 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';
 
@@ -50,7 +50,7 @@ export async function generateFiles(options: Config): Promise<void> {
     input,
     output,
     name: nameFn,
-    per = 'file',
+    per = 'operation',
     groupBy = 'none',
     cwd = process.cwd(),
   } = options;

packages/openapi/test/index.test.ts

@@ -66,6 +66,7 @@ describe('Generate documents', () => {
     await generateFiles({
       input: ['./fixtures/*.yaml'],
       output: './out',
+      per: 'file',
       cwd,
     });