feat: new featueres

src/__snapshots__/examples/array.test.ts.snap

@@ -0,0 +1,231 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`openapi project with examples renders example field 1`] = `
+"<div class="openapi">
+
+# example.array
+
+## Request
+
+<div class="openapi__request__wrapper">
+
+<div class="openapi__request" style="--method: var(--dc-openapi-methods-post)">
+
+POST {.openapi__method}
+
+
+\`\`\`
+http://localhost:8080/test
+\`\`\`
+
+
+</div>
+
+</div>
+
+Generated server url{.openapi__request__description}
+
+#### Body
+
+{% cut "application/json" %}
+
+
+\`\`\`json
+[
+    {
+        "test": 1
+    },
+    {
+        "test": 2
+    }
+]
+\`\`\`
+
+
+{% endcut %}
+
+
+any[]
+
+## Responses
+
+<div class="openapi__response__code__200">
+
+## 200 OK
+
+Base 200 response
+
+#### Body
+
+{% cut "application/json" %}
+
+
+\`\`\`json
+{}
+\`\`\`
+
+
+{% endcut %}
+
+
+</div>
+<!-- markdownlint-disable-file -->
+
+</div>"
+`;
+
+exports[`openapi project with examples renders infered example 1`] = `
+"<div class="openapi">
+
+# example.array
+
+## Request
+
+<div class="openapi__request__wrapper">
+
+<div class="openapi__request" style="--method: var(--dc-openapi-methods-post)">
+
+POST {.openapi__method}
+
+
+\`\`\`
+http://localhost:8080/test
+\`\`\`
+
+
+</div>
+
+</div>
+
+Generated server url{.openapi__request__description}
+
+#### Body
+
+{% cut "application/json" %}
+
+
+\`\`\`json
+[
+    {
+        "name": "string"
+    }
+]
+\`\`\`
+
+
+{% endcut %}
+
+
+[Cat](#cat)[]
+
+### Cat
+
+#||| **Name** | **Type** | **Description** ||
+
+|| name | string |  |||#
+
+## Responses
+
+<div class="openapi__response__code__200">
+
+## 200 OK
+
+Base 200 response
+
+#### Body
+
+{% cut "application/json" %}
+
+
+\`\`\`json
+{}
+\`\`\`
+
+
+{% endcut %}
+
+
+</div>
+<!-- markdownlint-disable-file -->
+
+</div>"
+`;
+
+exports[`openapi project with examples renders nested arrays exmaple 1`] = `
+"<div class="openapi">
+
+# example.array
+
+## Request
+
+<div class="openapi__request__wrapper">
+
+<div class="openapi__request" style="--method: var(--dc-openapi-methods-post)">
+
+POST {.openapi__method}
+
+
+\`\`\`
+http://localhost:8080/test
+\`\`\`
+
+
+</div>
+
+</div>
+
+Generated server url{.openapi__request__description}
+
+#### Body
+
+{% cut "application/json" %}
+
+
+\`\`\`json
+[
+    [
+        {
+            "name": "string"
+        }
+    ]
+]
+\`\`\`
+
+
+{% endcut %}
+
+
+[Cat](#cat)[][]
+
+### Cat
+
+#||| **Name** | **Type** | **Description** ||
+
+|| name | string |  |||#
+
+## Responses
+
+<div class="openapi__response__code__200">
+
+## 200 OK
+
+Base 200 response
+
+#### Body
+
+{% cut "application/json" %}
+
+
+\`\`\`json
+{}
+\`\`\`
+
+
+{% endcut %}
+
+
+</div>
+<!-- markdownlint-disable-file -->
+
+</div>"
+`;

src/__tests__/examples/array.test.ts

@@ -0,0 +1,100 @@
+import {DocumentBuilder, run} from '../__helpers__/run';
+
+const name = 'example.array';
+describe('openapi project with examples', () => {
+    it('renders example field', async () => {
+        const spec = new DocumentBuilder(name)
+            .request({
+                schema: {
+                    example: [
+                        {
+                            test: 1,
+                        },
+                        {
+                            test: 2,
+                        },
+                    ],
+                    type: 'array',
+                    items: {},
+                },
+            })
+            .response(200, {
+                description: 'Base 200 response',
+                schema: {
+                    type: 'object',
+                },
+            })
+            .build();
+
+        const fs = await run(spec);
+
+        const page = fs.match(name);
+
+        expect(page).toMatchSnapshot();
+    });
+
+    it('renders infered example', async () => {
+        const spec = new DocumentBuilder(name)
+            .request({
+                schema: {
+                    type: 'array',
+                    items: DocumentBuilder.ref('Cat'),
+                },
+            })
+            .response(200, {
+                description: 'Base 200 response',
+                schema: {
+                    type: 'object',
+                },
+            })
+            .component('Cat', {
+                type: 'object',
+                properties: {
+                    name: {
+                        type: 'string',
+                    },
+                },
+            })
+            .build();
+
+        const fs = await run(spec);
+
+        const page = fs.match(name);
+
+        expect(page).toMatchSnapshot();
+    });
+
+    it('renders nested arrays exmaple', async () => {
+        const spec = new DocumentBuilder(name)
+            .request({
+                schema: {
+                    type: 'array',
+                    items: {
+                        type: 'array',
+                        items: DocumentBuilder.ref('Cat'),
+                    },
+                },
+            })
+            .response(200, {
+                description: 'Base 200 response',
+                schema: {
+                    type: 'object',
+                },
+            })
+            .component('Cat', {
+                type: 'object',
+                properties: {
+                    name: {
+                        type: 'string',
+                    },
+                },
+            })
+            .build();
+
+        const fs = await run(spec);
+
+        const page = fs.match(name);
+
+        expect(page).toMatchSnapshot();
+    });
+});

src/__tests__/example.test.ts → src/__tests__/examples/base.test.ts

@@ -1,4 +1,4 @@
-import {DocumentBuilder, run} from './__helpers__/run';
+import {DocumentBuilder, run} from '../__helpers__/run';
 
 const name = 'example';
 describe('openapi project with examples', () => {

src/includer/index.ts

@@ -164,14 +164,20 @@
             items: [],
         };
 
-        section.items = endpointsOfTag.map((endpoint) => handleEndpointRender(endpoint, id));
-
         const custom = ArgvService.tag(tag.name);
+        const customId = custom?.alias || id;
+
+        section.items = endpointsOfTag.map((endpoint) => handleEndpointRender(endpoint, customId));
 
         const customLeadingPageName = custom?.name || leadingPageName;
 
         if (!custom?.hidden) {
-            addLeadingPage(section, leadingPageMode, customLeadingPageName, join(id, 'index.md'));
+            addLeadingPage(
+                section,
+                leadingPageMode,
+                customLeadingPageName,
+                join(customId, 'index.md'),
+            );
         }
 
         toc.items.push(section);
@@ -199,7 +205,7 @@
             href: href,
         });
     } else {
         section.href = href;
     }
 }
 
@@ -229,11 +235,11 @@
 
     const filterContent = filterUsefullContent(filter, vars);
     const applyNoindex = matchFilter(noindex || {}, vars, (endpoint) => {
         endpoint.noindex = true;
     });
 
     const applyHidden = matchFilter(hidden || {}, vars, (endpoint) => {
         endpoint.hidden = true;
     });
 
     const leadingPageSpecRenderMode = leadingPage?.spec?.renderMode ?? SPEC_RENDER_MODE_DEFAULT;
@@ -270,12 +276,13 @@
     spec.tags.forEach((tag, id) => {
         const {endpoints} = tag;
 
+        const custom = ArgvService.tag(tag.name);
+        const customId = custom?.alias || id;
+
         endpoints.forEach((endpoint) => {
-            results.push(handleEndpointIncluder(endpoint, join(writePath, id), sandbox));
+            results.push(handleEndpointIncluder(endpoint, join(writePath, customId), sandbox));
         });
 
-        const custom = ArgvService.tag(tag.name);
-
         if (custom?.hidden) {
             return;
         }
@@ -285,7 +292,7 @@
             : generators.section(tag);
 
         results.push({
-            path: join(writePath, id, 'index.md'),
+            path: join(writePath, customId, 'index.md'),
             content,
         });
     });

src/includer/models.ts

@@ -281,6 +281,7 @@ export type CustomTag = {
     hidden?: boolean;
     name?: string;
     path?: string;
+    alias?: string;
 };
 
 export type OpenApiIncluderParams = {