@arikajs/docs 0.0.3 → 0.0.5

package/README.md

@@ -10,28 +10,35 @@ The goal of this package is to eliminate the manual work of keeping documentatio
 
 ### Status
 
-- **Stage**: Experimental / v0.x
-- **Scope (v0.x)**:
+- **Stage**: Beta / v0.x
+- **Extensibility**: Driver-based architecture (add your own documentation formats)
+- **Features**:
   - Route metadata extraction from `@arikajs/router`
   - Postman Collection (v2.1.0) generation
   - Arika-themed interactive HTML documentation
   - Markdown (DOCS.md) generation
   - OpenAPI 3.0 specification generation
+  - **New**: Route filtering by prefix (e.g., generate docs only for `api/v1`)
 
 ---
 
 ## Features
 
-- **Multi-Format Generation**
+- **🚀 Extensible architecture**
+  - Uses a **Driver Pattern** for all documentation formats.
+  - Easily add new drivers by implementing the `DocDriver` interface.
+
+- **🎨 Multi-Format Generation**
   - **HTML**: A premium, interactive web page for your API.
   - **Postman**: Ready-to-import JSON collection with pre-configured headers.
   - **OpenAPI**: Industry-standard Swagger/OpenAPI 3.0 specification.
   - **Markdown**: Clean, readable `DOCS.md` for GitHub or local documentation.
 
-- **Route Analysis**
+- **🔍 Intelligent Route Analysis**
+  - **Prefix Filtering**: Only document specific sections of your app.
   - Automatically groups endpoints by prefix (e.g., `api`, `admin`).
   - Captures route names, methods, and full path hierarchies.
-  - Displays middleware information for each endpoint.
+  - Displays middleware and parameter information.
 
 - **Environment Support**
   - Automatically generates Postman environment JSON with your `base_url`.

package/dist/Drivers/DocDriver.d.ts

@@ -0,0 +1,6 @@
+import { ParsedRoute } from '../types';
+export interface DocDriver {
+    generate(routes: ParsedRoute[], appName: string, baseUrl?: string): any;
+    getExtension(): string;
+    getFilename(appName: string): string;
+}

package/dist/Drivers/DocDriver.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/Generator.d.ts

@@ -1,12 +1,9 @@
-import { PostmanGenerator } from './PostmanGenerator';
-import { MarkdownGenerator } from './MarkdownGenerator';
-import { HtmlGenerator } from './HtmlGenerator';
-import { OpenApiGenerator } from './OpenApiGenerator';
+import { ParsedRoute } from './types';
 export declare class DocumentationGenerator {
-    protected postman: PostmanGenerator;
-    protected markdown: MarkdownGenerator;
-    protected html: HtmlGenerator;
-    protected openApi: OpenApiGenerator;
-    constructor();
-    generateAll(appName: string, outputDir: string): void;
+    /**
+     * Generate all documentation formats based on parsed routes.
+     */
+    generateAll(routes: ParsedRoute[], appName: string, outputDir: string, options?: {
+        baseUrl?: string;
+    }): void;
 }

package/dist/Generator.js

@@ -4,7 +4,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DocumentationGenerator = void 0;
-const router_1 = require("@arikajs/router");
 const PostmanGenerator_1 = require("./PostmanGenerator");
 const MarkdownGenerator_1 = require("./MarkdownGenerator");
 const HtmlGenerator_1 = require("./HtmlGenerator");
@@ -12,41 +11,46 @@ const OpenApiGenerator_1 = require("./OpenApiGenerator");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 class DocumentationGenerator {
-    postman;
-    markdown;
-    html;
-    openApi;
-    constructor() {
-        this.postman = new PostmanGenerator_1.PostmanGenerator();
-        this.markdown = new MarkdownGenerator_1.MarkdownGenerator();
-        this.html = new HtmlGenerator_1.HtmlGenerator();
-        this.openApi = new OpenApiGenerator_1.OpenApiGenerator();
-    }
-    generateAll(appName, outputDir) {
-        const routes = router_1.RouteRegistry.getInstance().getRoutes();
+    /**
+     * Generate all documentation formats based on parsed routes.
+     */
+    generateAll(routes, appName, outputDir, options = {}) {
+        const baseUrl = options.baseUrl || 'http://localhost:3000';
         if (!fs_1.default.existsSync(outputDir)) {
             fs_1.default.mkdirSync(outputDir, { recursive: true });
         }
-        // Postman
-        const postmanJson = this.postman.generate(routes, appName);
-        fs_1.default.writeFileSync(path_1.default.join(outputDir, 'postman_collection.json'), JSON.stringify(postmanJson, null, 2));
-        // Environment
+        // Generate Postman Environment
         const envJson = {
             name: `${appName} Env`,
             values: [
-                { key: "base_url", value: "http://localhost:3000", enabled: true }
+                { key: "base_url", value: baseUrl, enabled: true },
+                { key: "token", value: "", enabled: true }
             ]
         };
-        fs_1.default.writeFileSync(path_1.default.join(outputDir, 'postman_environment.json'), JSON.stringify(envJson, null, 2));
-        // Markdown
-        const md = this.markdown.generate(routes, appName);
-        fs_1.default.writeFileSync(path_1.default.join(outputDir, 'DOCS.md'), md);
-        // HTML
-        const html = this.html.generate(routes, appName);
-        fs_1.default.writeFileSync(path_1.default.join(outputDir, 'api_docs.html'), html);
-        // OpenAPI
-        const openApiJson = this.openApi.generate(routes, appName);
-        fs_1.default.writeFileSync(path_1.default.join(outputDir, 'openapi.json'), JSON.stringify(openApiJson, null, 2));
+        const envContent = JSON.stringify(envJson, null, 2);
+        fs_1.default.writeFileSync(path_1.default.join(outputDir, 'postman_environment.json'), envContent);
+        // Generate Postman Collection
+        const postmanGenerator = new PostmanGenerator_1.PostmanGenerator();
+        const postmanJson = postmanGenerator.generate(routes, appName, baseUrl);
+        const postmanContent = JSON.stringify(postmanJson, null, 2);
+        fs_1.default.writeFileSync(path_1.default.join(outputDir, 'postman_collection.json'), postmanContent);
+        // Generate OpenAPI Spec
+        const openApiGenerator = new OpenApiGenerator_1.OpenApiGenerator();
+        const openApiJson = openApiGenerator.generate(routes, appName, baseUrl);
+        const openApiContent = JSON.stringify(openApiJson, null, 2);
+        fs_1.default.writeFileSync(path_1.default.join(outputDir, 'openapi.json'), openApiContent);
+        // Generate Markdown
+        const markdownGenerator = new MarkdownGenerator_1.MarkdownGenerator();
+        const markdownContent = markdownGenerator.generate(routes, appName, baseUrl);
+        fs_1.default.writeFileSync(path_1.default.join(outputDir, 'DOCS.md'), markdownContent);
+        // Generate HTML with embedded JSONs
+        const htmlGenerator = new HtmlGenerator_1.HtmlGenerator();
+        const htmlContent = htmlGenerator.generate(routes, appName, baseUrl, {
+            postmanContent,
+            envContent,
+            openApiContent
+        });
+        fs_1.default.writeFileSync(path_1.default.join(outputDir, 'api_docs.html'), htmlContent);
     }
 }
 exports.DocumentationGenerator = DocumentationGenerator;

package/dist/HtmlGenerator.d.ts

@@ -1,6 +1,9 @@
-import { RouteEntry } from '@arikajs/router';
+import { ParsedRoute } from './types';
 export declare class HtmlGenerator {
-    generate(routes: RouteEntry[], appName: string): string;
-    private renderGroup;
+    generate(routes: ParsedRoute[], appName: string, baseUrl: string, inlineData: {
+        postmanContent: string;
+        envContent: string;
+        openApiContent: string;
+    }): string;
     private groupByPrefix;
 }

package/dist/HtmlGenerator.js

@@ -2,112 +2,307 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HtmlGenerator = void 0;
 class HtmlGenerator {
-    generate(routes, appName) {
+    generate(routes, appName, baseUrl, inlineData) {
         const groups = this.groupByPrefix(routes);
-        const groupHtml = Object.entries(groups).map(([name, groupRoutes]) => this.renderGroup(name, groupRoutes)).join('');
+        const escapeJs = (s) => s.replace(/\\/g, '\\\\').replace(/`/g, '\\`').replace(/\$/g, '\\$');
+        const postmanEscaped = escapeJs(inlineData.postmanContent || '{}');
+        const envEscaped = escapeJs(inlineData.envContent || '{}');
+        const openapiEscaped = escapeJs(inlineData.openApiContent || '{}');
+        const methodColors = {
+            GET: '#10b981', POST: '#3b82f6', PUT: '#f59e0b', PATCH: '#a78bfa', DELETE: '#ef4444', OPTIONS: '#64748b'
+        };
+        const sidebarLinks = Object.keys(groups).map(g => {
+            const anchor = g.toLowerCase().replace(/[^a-z0-9]/g, '-');
+            return `<li><a href="#${anchor}" onclick="setActive(this)">${g}</a></li>`;
+        }).join('\n');
+        const groupHtml = Object.entries(groups).map(([groupName, groupRoutes]) => {
+            const anchor = groupName.toLowerCase().replace(/[^a-z0-9]/g, '-');
+            const routeCards = groupRoutes.map(r => {
+                const color = methodColors[r.method] || '#64748b';
+                const requiresAuth = r.middleware.includes('auth');
+                const mwHtml = r.middleware.map(m => `<span class="mw-badge">${m}</span>`).join('');
+                return `<div class="route-card">
+                    <div class="route-header">
+                        <span class="method-badge" style="background:${color}">${r.method}</span>
+                        <code class="route-path">${r.path}</code>
+                        ${requiresAuth ? '<span class="auth-badge">🔒 Auth</span>' : ''}
+                        ${r.name ? `<span class="route-name">${r.name}</span>` : ''}
+                    </div>
+                    ${(r.handler || r.middleware.length) ? `<div class="route-meta">
+                        ${r.handler ? `<span class="handler-label">⚙ ${r.handler}</span>` : ''}
+                        ${mwHtml}
+                    </div>` : ''}
+                </div>`;
+            }).join('\n');
+            return `<section class="route-group" id="${anchor}">
+                <h2>${groupName}</h2>
+                <div class="routes">${routeCards}</div>
+            </section>`;
+        }).join('\n');
         return `<!DOCTYPE html>
-<html lang="en">
+<html lang="en" data-theme="light">
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>${appName} API Documentation</title>
-    <link href="https://fonts.googleapis.com/css2?family=Plus+Jakarta+Sans:wght@300;400;600;700&display=swap" rel="stylesheet">
+    <title>${appName} | API Docs — ArikaJS</title>
+    <link rel="icon" type="image/png" href="./assets/img/favicon.png">
+    <link href="https://fonts.googleapis.com/css2?family=Outfit:wght@300;400;600;800&family=Plus+Jakarta+Sans:wght@300;400;600;800&family=JetBrains+Mono:wght@400;600&display=swap" rel="stylesheet">
     <style>
         :root {
             --primary: #8b5cf6;
+            --primary-glow: rgba(139, 92, 246, 0.4);
+            --secondary: #ec4899;
             --bg: #f8fafc;
-            --card: #ffffff;
+            --sidebar-bg: rgba(255,255,255,0.85);
+            --card-bg: rgba(255, 255, 255, 0.8);
+            --card-border: rgba(15, 23, 42, 0.08);
             --text-main: #0f172a;
             --text-muted: #64748b;
-            --border: #e2e8f0;
-            --get: #10b981;
-            --post: #3b82f6;
-            --put: #f59e0b;
-            --delete: #ef4444;
+            --border: rgba(15, 23, 42, 0.08);
+            --aurora-opacity: 0.3;
+            --btn-sec-bg: rgba(15, 23, 42, 0.05);
+            --h1-gradient: linear-gradient(135deg, #0f172a 30%, #334155 100%);
+            --sidebar-border: rgba(15, 23, 42, 0.08);
+            --route-path-bg: rgba(15, 23, 42, 0.05);
+            --route-path-color: #1e293b;
+            --handler-color: #64748b;
+            --mw-bg: rgba(15, 23, 42, 0.05);
+        }
+        [data-theme="dark"] {
+            --bg: #030712;
+            --sidebar-bg: rgba(10, 15, 30, 0.9);
+            --card-bg: rgba(17, 24, 39, 0.7);
+            --card-border: rgba(255, 255, 255, 0.08);
+            --text-main: #f8fafc;
+            --text-muted: #94a3b8;
+            --border: rgba(255, 255, 255, 0.08);
+            --aurora-opacity: 0.5;
+            --btn-sec-bg: rgba(255, 255, 255, 0.05);
+            --h1-gradient: linear-gradient(135deg, #fff 30%, rgba(255, 255, 255, 0.5) 100%);
+            --sidebar-border: rgba(255,255,255,0.08);
+            --route-path-bg: rgba(255, 255, 255, 0.06);
+            --route-path-color: #e2e8f0;
+            --handler-color: #475569;
+            --mw-bg: rgba(255, 255, 255, 0.06);
+        }
+        * { margin: 0; padding: 0; box-sizing: border-box; transition: background-color 0.3s ease, color 0.3s ease, border-color 0.3s ease; }
+        body { font-family: 'Plus Jakarta Sans', sans-serif; background: var(--bg); color: var(--text-main); display: block; min-height: 100vh; overflow-x: hidden; }
+
+        .aurora { position: fixed; top: 0; left: 0; width: 100%; height: 100%; z-index: 0; filter: blur(100px); opacity: var(--aurora-opacity); pointer-events: none; }
+        .aurora-blur { position: absolute; border-radius: 50%; animation: move 20s infinite alternate; }
+        .blur-1 { width: 50vw; height: 50vw; background: radial-gradient(circle, var(--primary) 0%, transparent 70%); top: -10%; left: -10%; }
+        .blur-2 { width: 40vw; height: 40vw; background: radial-gradient(circle, var(--secondary) 0%, transparent 70%); bottom: -10%; right: -10%; animation-duration: 25s; }
+        @keyframes move { from { transform: translate(0,0) scale(1); } to { transform: translate(10%,10%) scale(1.1); } }
+
+        /* Sidebar */
+        .sidebar {
+            width: 270px; min-height: 100vh; background: var(--sidebar-bg);
+            border-right: 1px solid var(--sidebar-border);
+            position: fixed; top: 0; left: 0; overflow-y: auto;
+            display: flex; flex-direction: column; z-index: 50;
+            backdrop-filter: blur(20px);
+        }
+        .sidebar-header { padding: 24px 20px 20px; border-bottom: 1px solid var(--sidebar-border); }
+        .logo-wrap { display: flex; align-items: center; gap: 10px; margin-bottom: 4px; }
+        .logo-wrap img { width: 110px; height: auto; }
+        [data-theme="dark"] .logo-wrap img { filter: invert(1) drop-shadow(0 2px 6px rgba(139,92,246,0.3)); }
+        .sidebar-subtitle { font-size: 11px; color: var(--text-muted); text-transform: uppercase; letter-spacing: 0.1em; font-weight: 600; margin-top: 6px; }
+
+        .sidebar nav { padding: 16px 0; flex: 1; }
+        .sidebar nav h3 { font-size: 10px; font-weight: 700; color: var(--text-muted); text-transform: uppercase; letter-spacing: .1em; padding: 0 20px 8px; }
+        .sidebar nav ul { list-style: none; }
+        .sidebar nav ul li a {
+            display: flex; align-items: center; gap: 8px; padding: 8px 20px;
+            font-size: 13px; color: var(--text-muted); text-decoration: none;
+            border-left: 3px solid transparent; transition: all .2s;
+        }
+        .sidebar nav ul li a:hover, .sidebar nav ul li a.active {
+            color: var(--primary); border-left-color: var(--primary); background: rgba(139,92,246,.06);
+        }
+        .sidebar-footer { padding: 16px 20px; border-top: 1px solid var(--sidebar-border); }
+        .sidebar-footer span { display: block; font-size: 11px; color: var(--text-muted); }
+        .sidebar-footer strong { color: var(--primary); }
+
+        /* Header */
+        header {
+            position: fixed; top: 0; left: 270px; right: 0; min-height: 64px;
+            display: flex; align-items: center; justify-content: space-between;
+            padding: 12px 32px; background: var(--sidebar-bg); backdrop-filter: blur(20px);
+            border-bottom: 1px solid var(--border); z-index: 40;
         }
+        .header-title { font-family: 'Outfit', sans-serif; font-size: 16px; font-weight: 700;
+            background: linear-gradient(135deg, var(--primary), var(--secondary));
+            -webkit-background-clip: text; -webkit-text-fill-color: transparent; }
+        .header-right { display: flex; align-items: center; gap: 12px; }
 
-        * { margin:0; padding:0; box-sizing:border-box; }
-        body { font-family: 'Plus Jakarta Sans', sans-serif; background: var(--bg); color: var(--text-main); line-height: 1.6; }
-        .container { max-width: 1000px; margin: 0 auto; padding: 4rem 2rem; }
-        header { margin-bottom: 4rem; }
-        h1 { font-size: 2.5rem; margin-bottom: 0.5rem; }
-        .badge { display: inline-block; padding: 0.25rem 0.75rem; background: var(--primary); color: white; border-radius: 99px; font-size: 0.8rem; font-weight: 600; }
-        
-        .group { margin-bottom: 3rem; }
-        .group-title { font-size: 1.5rem; margin-bottom: 1.5rem; border-bottom: 2px solid var(--border); padding-bottom: 0.5rem; text-transform: capitalize; }
-        
-        .route-card { background: var(--card); border: 1px solid var(--border); border-radius: 12px; padding: 1.5rem; margin-bottom: 1rem; transition: transform 0.2s; }
-        .route-card:hover { transform: translateY(-2px); box-shadow: 0 10px 20px rgba(0,0,0,0.05); }
-        
-        .route-header { display: flex; align-items: center; gap: 1rem; margin-bottom: 1rem; }
-        .method { padding: 0.25rem 0.75rem; border-radius: 6px; font-weight: 700; font-size: 0.8rem; min-width: 70px; text-align: center; color: white; }
-        .method.GET { background: var(--get); }
-        .method.POST { background: var(--post); }
-        .method.PUT { background: var(--put); }
-        .method.DELETE { background: var(--delete); }
-        .path { font-family: monospace; font-size: 1.1rem; font-weight: 600; color: var(--text-main); }
-        
-        .route-info { display: grid; grid-template-columns: 1fr 1fr; gap: 1rem; font-size: 0.9rem; }
-        .label { color: var(--text-muted); font-weight: 600; margin-bottom: 0.25rem; }
-        .value { color: var(--text-main); }
-        
-        .middleware-tag { display: inline-block; padding: 0.1rem 0.5rem; background: #f1f5f9; border: 1px solid var(--border); border-radius: 4px; font-size: 0.75rem; margin-right: 0.25rem; }
-        
-        footer { text-align: center; margin-top: 4rem; color: var(--text-muted); font-size: 0.8rem; }
+        /* Download Buttons */
+        .dl-btn {
+            display: inline-flex; align-items: center; gap: 6px;
+            padding: 7px 14px; border-radius: 8px; font-size: 12px; font-weight: 600;
+            cursor: pointer; border: 1px solid var(--border); text-decoration: none;
+            background: var(--btn-sec-bg); color: var(--text-main);
+            transition: all 0.2s cubic-bezier(0.4,0,0.2,1);
+        }
+        .dl-btn:hover { transform: translateY(-1px); box-shadow: 0 4px 12px rgba(139,92,246,0.2); border-color: var(--primary); color: var(--primary); }
+        .dl-btn svg { width: 14px; height: 14px; flex-shrink: 0; }
+        .dl-btn.postman { border-color: rgba(255,108,55,0.3); }
+        .dl-btn.postman:hover { border-color: #ff6c37; color: #ff6c37; box-shadow: 0 4px 12px rgba(255,108,55,0.2); }
+        .dl-btn.openapi { border-color: rgba(16,185,129,0.3); }
+        .dl-btn.openapi:hover { border-color: #10b981; color: #10b981; box-shadow: 0 4px 12px rgba(16,185,129,0.2); }
+
+        /* Theme Toggle */
+        .theme-toggle {
+            background: var(--card-bg); border: 1px solid var(--border);
+            padding: 7px; border-radius: 99px; cursor: pointer;
+            display: flex; align-items: center; gap: 4px;
+        }
+        .theme-toggle svg { width: 18px; height: 18px; color: var(--text-main); transition: color 0.3s; }
+
+        /* Main */
+        .main { margin-left: 270px; margin-top: 72px; padding: 40px; position: relative; z-index: 10; }
+
+        /* Route Group */
+        .route-group { width: 100%; margin-bottom: 56px; scroll-margin-top: 80px; }
+        .route-group h2 {
+            font-family: 'Outfit', sans-serif; font-size: 18px; font-weight: 700;
+            color: var(--text-main); margin-bottom: 16px;
+            display: flex; align-items: center; gap: 10px;
+        }
+        .route-group h2::before { content: ''; width: 4px; height: 20px; background: linear-gradient(var(--primary), var(--secondary)); border-radius: 2px; flex-shrink: 0; }
+        .routes { display: flex; flex-direction: column; gap: 10px; width: 100%; }
+
+        /* Route Card */
+        .route-card {
+            width: 100%; background: var(--card-bg); border: 1px solid var(--card-border);
+            border-radius: 14px; padding: 16px 20px;
+            transition: border-color .25s, transform .25s, box-shadow .25s;
+            backdrop-filter: blur(10px);
+        }
+        .route-card:hover { border-color: var(--primary); transform: translateX(4px); box-shadow: 0 8px 30px var(--primary-glow); }
+        .route-header { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; }
+        .method-badge {
+            padding: 4px 14px; border-radius: 6px; font-family: 'JetBrains Mono', monospace;
+            font-size: 11px; font-weight: 700; color: #fff; min-width: 72px; text-align: center; letter-spacing: .05em;
+        }
+        .route-path {
+            font-family: 'JetBrains Mono', monospace; font-size: 14px;
+            color: var(--route-path-color); background: var(--route-path-bg);
+            padding: 4px 10px; border-radius: 6px; border: 1px solid var(--border);
+        }
+        .auth-badge { font-size: 11px; color: #f59e0b; background: rgba(245,158,11,.1); padding: 3px 8px; border-radius: 4px; border: 1px solid rgba(245,158,11,.2); }
+        .route-name { font-size: 11px; color: var(--text-muted); margin-left: auto; font-family: 'JetBrains Mono', monospace; }
+        .route-meta { display: flex; align-items: center; gap: 8px; margin-top: 10px; flex-wrap: wrap; }
+        .handler-label { font-size: 12px; color: var(--handler-color); font-family: 'JetBrains Mono', monospace; }
+        .mw-badge { padding: 2px 8px; background: var(--mw-bg); border-radius: 4px; font-size: 11px; color: var(--text-muted); border: 1px solid var(--border); }
     </style>
 </head>
 <body>
-    <div class="container">
-        <header>
-            <div class="badge">ArikaJS Docs</div>
-            <h1>${appName}</h1>
-            <p>API documentation generated on ${new Date().toLocaleDateString()}</p>
-        </header>
-
-        ${groupHtml}
-
-        <footer>
-            Generated by @arikajs/docs &copy; 2026
-        </footer>
+
+<div class="aurora">
+    <div class="aurora-blur blur-1"></div>
+    <div class="aurora-blur blur-2"></div>
+</div>
+
+<aside class="sidebar">
+    <div class="sidebar-header">
+        <div class="logo-wrap">
+            <img src="./assets/img/logo.png" alt="ArikaJS">
+        </div>
+        <div class="sidebar-subtitle">API Documentation</div>
+    </div>
+    <nav>
+        <h3>Sections</h3>
+        <ul id="nav-links">
+            ${sidebarLinks}
+        </ul>
+    </nav>
+    <div class="sidebar-footer">
+        <span>Total Routes: <strong>${routes.length}</strong></span>
+        <span style="margin-top:4px">Generated: <strong>${new Date().toLocaleDateString()}</strong></span>
+    </div>
+</aside>
+
+<header>
+    <div class="header-left">
+        <div class="header-title">${appName} &mdash; API Reference</div>
+        <div style="font-size: 12px; color: var(--text-muted); margin-top: 4px;">Complete API documentation &mdash; auto-generated from your ArikaJS route definitions.</div>
     </div>
+    <div class="header-right">
+        <button class="dl-btn postman" id="btn-postman" title="Download Postman Collection">
+            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
+            Postman
+        </button>
+        <button class="dl-btn" id="btn-env" title="Download Postman Environment">
+            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
+            Environment
+        </button>
+        <button class="dl-btn openapi" id="btn-openapi" title="Download OpenAPI Spec">
+            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
+            OpenAPI
+        </button>
+        <button class="theme-toggle" id="theme-toggle" title="Toggle Theme">
+            <svg id="moon-icon" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M20.354 15.354A9 9 0 018.646 3.646 9.003 9.003 0 0012 21a9.003 9.003 0 008.354-5.646z"/>
+            </svg>
+            <svg id="sun-icon" style="display:none" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 3v1m0 16v1m9-9h-1M4 12H3m15.364 6.364l-.707-.707M6.343 6.343l-.707-.707m12.728 0l-.707.707M6.343 17.657l-.707.707M16 12a4 4 0 11-8 0 4 4 0 018 0z"/>
+            </svg>
+        </button>
+    </div>
+</header>
+
+<main class="main">
+    ${groupHtml}
+</main>
+
+<script>
+    const html = document.documentElement;
+    const toggle = document.getElementById('theme-toggle');
+    const sun = document.getElementById('sun-icon');
+    const moon = document.getElementById('moon-icon');
+
+    function setTheme(t) {
+        html.setAttribute('data-theme', t);
+        localStorage.setItem('arika_theme', t);
+        if (t === 'dark') { sun.style.display = 'block'; moon.style.display = 'none'; }
+        else               { sun.style.display = 'none';  moon.style.display = 'block'; }
+    }
+    setTheme(localStorage.getItem('arika_theme') || 'light');
+    toggle.addEventListener('click', () => setTheme(html.getAttribute('data-theme') === 'dark' ? 'light' : 'dark'));
+
+    function setActive(el) {
+        document.querySelectorAll('#nav-links a').forEach(a => a.classList.remove('active'));
+        el.classList.add('active');
+    }
+
+    function download(filename, content) {
+        const blob = new Blob([content], { type: 'application/json' });
+        const url = URL.createObjectURL(blob);
+        const a = document.createElement('a');
+        a.href = url; a.download = filename; a.click();
+        URL.revokeObjectURL(url);
+    }
+
+    const postmanData = \`${postmanEscaped}\`;
+    const envData     = \`${envEscaped}\`;
+    const openapiData = \`${openapiEscaped}\`;
+
+    document.getElementById('btn-postman').addEventListener('click', () => download('postman_collection.json', postmanData));
+    document.getElementById('btn-env').addEventListener('click',     () => download('postman_environment.json', envData));
+    document.getElementById('btn-openapi').addEventListener('click', () => download('openapi.json', openapiData));
+</script>
 </body>
 </html>`;
     }
-    renderGroup(name, routes) {
-        const routesHtml = routes.map(route => `
-            <div class="route-card">
-                <div class="route-header">
-                    <span class="method ${route.method}">${route.method}</span>
-                    <span class="path">${route.path}</span>
-                </div>
-                <div class="route-info">
-                    <div>
-                        <div class="label">Route Name</div>
-                        <div class="value">${route.name || '-'}</div>
-                    </div>
-                    <div>
-                        <div class="label">Middleware</div>
-                        <div class="value">
-                            ${route.middleware.map(m => `<span class="middleware-tag">${typeof m === 'string' ? m : m.name || 'Closure'}</span>`).join('') || '-'}
-                        </div>
-                    </div>
-                </div>
-            </div>
-        `).join('');
-        return `
-            <div class="group">
-                <h2 class="group-title">${name.replace('/', '')}</h2>
-                ${routesHtml}
-            </div>
-        `;
-    }
     groupByPrefix(routes) {
         const groups = {};
-        routes.forEach(route => {
-            const group = route.prefix || 'General';
+        routes.forEach(r => {
+            let group = r.prefix ? r.prefix.replace(/^\/+/, '').split('/').map(s => s.charAt(0).toUpperCase() + s.slice(1)).join(' / ') : 'General';
+            if (!group)
+                group = 'General';
             if (!groups[group])
                 groups[group] = [];
-            groups[group].push(route);
+            groups[group].push(r);
         });
         return groups;
     }

package/dist/MarkdownGenerator.d.ts

@@ -1,5 +1,5 @@
-import { RouteEntry } from '@arikajs/router';
+import { ParsedRoute } from './types';
 export declare class MarkdownGenerator {
-    generate(routes: RouteEntry[], appName: string): string;
+    generate(routes: ParsedRoute[], appName: string, baseUrl?: string): string;
     private groupByPrefix;
 }

package/dist/MarkdownGenerator.js

@@ -2,17 +2,20 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MarkdownGenerator = void 0;
 class MarkdownGenerator {
-    generate(routes, appName) {
+    generate(routes, appName, baseUrl) {
         let markdown = `# API Documentation: ${appName}\n\n`;
         markdown += `Generated on ${new Date().toLocaleDateString()}\n\n`;
+        markdown += `> **Total Routes:** ${routes.length}\n\n`;
         const groups = this.groupByPrefix(routes);
         for (const [group, groupRoutes] of Object.entries(groups)) {
             markdown += `## ${group}\n\n`;
-            markdown += `| Method | Path | Name | Middleware |\n`;
-            markdown += `| :--- | :--- | :--- | :--- |\n`;
+            markdown += `| Method | Path | Handler | Name | Middleware |\n`;
+            markdown += `| :--- | :--- | :--- | :--- | :--- |\n`;
             groupRoutes.forEach(route => {
-                const middleware = route.middleware.map(m => typeof m === 'string' ? m : m.name || 'Closure').join(', ') || '-';
-                markdown += `| **${route.method}** | \`${route.path}\` | ${route.name || '-'} | ${middleware} |\n`;
+                const middleware = route.middleware.length > 0 ? route.middleware.join(', ') : '-';
+                const handler = route.handler || '-';
+                const name = route.name || '-';
+                markdown += `| **${route.method}** | \`${route.path}\` | ${handler} | ${name} | ${middleware} |\n`;
             });
             markdown += `\n`;
         }
@@ -20,11 +23,13 @@ class MarkdownGenerator {
     }
     groupByPrefix(routes) {
         const groups = {};
-        routes.forEach(route => {
-            const group = route.prefix || 'General';
+        routes.forEach(r => {
+            let group = r.prefix ? r.prefix.replace(/^\/+/, '').split('/').map(s => s.charAt(0).toUpperCase() + s.slice(1)).join(' / ') : 'General';
+            if (!group)
+                group = 'General';
             if (!groups[group])
                 groups[group] = [];
-            groups[group].push(route);
+            groups[group].push(r);
         });
         return groups;
     }

package/dist/OpenApiGenerator.d.ts

@@ -1,6 +1,4 @@
-import { RouteEntry } from '@arikajs/router';
+import { ParsedRoute } from './types';
 export declare class OpenApiGenerator {
-    generate(routes: RouteEntry[], appName: string): any;
-    private formatPaths;
-    private extractParameters;
+    generate(routes: ParsedRoute[], appName: string, baseUrl: string): any;
 }

package/dist/OpenApiGenerator.js

@@ -2,63 +2,65 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpenApiGenerator = void 0;
 class OpenApiGenerator {
-    generate(routes, appName) {
+    generate(routes, appName, baseUrl) {
+        const paths = {};
+        routes.forEach(route => {
+            const rawPath = route.path.replace(/^\/+/, '');
+            const openApiPath = '/' + rawPath.replace(/:([a-zA-Z0-9_]+)|\{([a-zA-Z0-9_]+)\}/g, '{$1$2}');
+            if (!paths[openApiPath])
+                paths[openApiPath] = {};
+            const method = route.method.toLowerCase();
+            const group = route.prefix ? route.prefix.replace(/^\/+/, '').split('/').map(s => s.charAt(0).toUpperCase() + s.slice(1)).join(' / ') : 'General';
+            const routeName = route.name || `${method}_${rawPath.replace(/\//g, '_')}`;
+            const parameters = route.paramKeys.map(key => ({
+                name: key,
+                in: 'path',
+                required: true,
+                schema: { type: 'string' }
+            }));
+            const operation = {
+                summary: routeName,
+                tags: [group || 'General'],
+                parameters: parameters.length > 0 ? parameters : undefined,
+                responses: {
+                    '200': { description: 'Successful response' },
+                    '401': route.middleware.includes('auth') ? { description: 'Unauthorized' } : undefined,
+                }
+            };
+            if (route.middleware.includes('auth')) {
+                operation.security = [{ bearerAuth: [] }];
+            }
+            if (['post', 'put', 'patch'].includes(method)) {
+                operation.requestBody = {
+                    content: {
+                        'application/json': {
+                            schema: { type: 'object', properties: {} }
+                        }
+                    }
+                };
+            }
+            paths[openApiPath][method] = operation;
+        });
+        const servers = [{ url: baseUrl }];
         return {
-            openapi: "3.0.0",
+            openapi: '3.0.0',
             info: {
                 title: appName,
-                description: `API Specification for ${appName}`,
-                version: "1.0.0"
+                version: '1.0.0',
+                description: `API documentation for ${appName}`
             },
-            paths: this.formatPaths(routes),
+            servers,
+            paths,
             components: {
-                schemas: {},
                 securitySchemes: {
                     bearerAuth: {
-                        type: "http",
-                        scheme: "bearer",
-                        bearerFormat: "JWT"
+                        type: 'http',
+                        scheme: 'bearer',
+                        bearerFormat: 'JWT'
                     }
                 }
             }
         };
     }
-    formatPaths(routes) {
-        const paths = {};
-        routes.forEach(route => {
-            const path = route.path.replace(/:([a-zA-Z0-9_]+)|\{([a-zA-Z0-9_]+)\}/g, '{$1$2}');
-            if (!paths[path]) {
-                paths[path] = {};
-            }
-            paths[path][route.method.toLowerCase()] = {
-                summary: route.name || `Endpoint for ${path}`,
-                tags: [route.prefix || 'General'],
-                parameters: this.extractParameters(route),
-                responses: {
-                    "200": {
-                        description: "Successful response",
-                        content: {
-                            "application/json": {
-                                schema: {
-                                    type: "object"
-                                }
-                            }
-                        }
-                    }
-                }
-            };
-        });
-        return paths;
-    }
-    extractParameters(route) {
-        return route.paramKeys.map(key => ({
-            name: key,
-            in: "path",
-            required: true,
-            schema: {
-                type: "string"
-            }
-        }));
-    }
 }
 exports.OpenApiGenerator = OpenApiGenerator;

package/dist/PostmanGenerator.d.ts

@@ -1,5 +1,5 @@
-import { RouteEntry } from '@arikajs/router';
+import { ParsedRoute } from './types';
 export declare class PostmanGenerator {
-    generate(routes: RouteEntry[], appName: string): any;
-    private formatRoutes;
+    generate(routes: ParsedRoute[], appName: string, baseUrl: string): any;
+    private groupByPrefix;
 }

package/dist/PostmanGenerator.js

@@ -2,59 +2,83 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PostmanGenerator = void 0;
 class PostmanGenerator {
-    generate(routes, appName) {
+    generate(routes, appName, baseUrl) {
+        const groups = this.groupByPrefix(routes);
+        const item = [];
+        for (const [groupName, groupRoutes] of Object.entries(groups)) {
+            const groupItem = {
+                name: groupName,
+                item: []
+            };
+            groupRoutes.forEach(route => {
+                const requestName = route.name || `${route.method} ${route.path}`;
+                // Parse params out of path
+                const parts = route.path.replace(/^\/+/, '').split('/');
+                const urlPath = parts.map(p => {
+                    const match = p.match(/^:([a-zA-Z0-9_]+)$/) || p.match(/^\{([a-zA-Z0-9_]+)\}$/);
+                    if (match)
+                        return `:${match[1]}`;
+                    return p;
+                });
+                const variables = route.paramKeys.map(key => ({
+                    key, value: `<string>`
+                }));
+                const req = {
+                    name: requestName,
+                    request: {
+                        method: route.method,
+                        header: [
+                            { key: 'Accept', value: 'application/json', type: 'text' },
+                            { key: 'Content-Type', value: 'application/json', type: 'text' }
+                        ],
+                        url: {
+                            raw: `{{base_url}}/${urlPath.join('/')}`,
+                            host: ['{{base_url}}'],
+                            path: urlPath,
+                            variable: variables.length > 0 ? variables : undefined
+                        }
+                    },
+                    response: []
+                };
+                if (route.middleware.includes('auth')) {
+                    req.request.auth = {
+                        type: 'bearer',
+                        bearer: [
+                            { key: "token", value: "{{token}}", type: "string" }
+                        ]
+                    };
+                }
+                if (['POST', 'PUT', 'PATCH'].includes(route.method)) {
+                    req.request.body = {
+                        mode: 'raw',
+                        raw: JSON.stringify({}, null, 2),
+                        options: { raw: { language: 'json' } }
+                    };
+                }
+                groupItem.item.push(req);
+            });
+            item.push(groupItem);
+        }
         return {
             info: {
-                name: appName,
-                _postman_id: Math.random().toString(36).substring(7),
-                description: `API Collection for ${appName}`,
-                schema: "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
+                name: `${appName} API`,
+                description: `Auto-generated API collection for ${appName}`,
+                schema: 'https://schema.getpostman.com/json/collection/v2.1.0/collection.json'
             },
-            item: this.formatRoutes(routes),
-            variable: [
-                {
-                    key: "base_url",
-                    value: "http://localhost:3000",
-                    type: "string"
-                }
-            ]
+            item
         };
     }
-    formatRoutes(routes) {
-        // Group routes by prefix/module
+    groupByPrefix(routes) {
         const groups = {};
-        routes.forEach(route => {
-            const groupName = route.prefix || 'General';
-            if (!groups[groupName]) {
-                groups[groupName] = [];
-            }
-            groups[groupName].push({
-                name: route.name || route.path,
-                request: {
-                    method: route.method,
-                    header: [
-                        {
-                            key: "Content-Type",
-                            value: "application/json"
-                        },
-                        {
-                            key: "Accept",
-                            value: "application/json"
-                        }
-                    ],
-                    url: {
-                        raw: "{{base_url}}" + route.path,
-                        host: ["{{base_url}}"],
-                        path: route.path.split('/').filter(p => p !== '')
-                    }
-                },
-                response: []
-            });
+        routes.forEach(r => {
+            let group = r.prefix ? r.prefix.replace(/^\/+/, '').split('/').map(s => s.charAt(0).toUpperCase() + s.slice(1)).join(' / ') : 'General';
+            if (!group)
+                group = 'General';
+            if (!groups[group])
+                groups[group] = [];
+            groups[group].push(r);
         });
-        return Object.keys(groups).map(name => ({
-            name: name.charAt(0).toUpperCase() + name.slice(1).replace('/', ''),
-            item: groups[name]
-        }));
+        return groups;
     }
 }
 exports.PostmanGenerator = PostmanGenerator;

package/dist/RouteParser.d.ts

@@ -0,0 +1,9 @@
+export declare class RouteParser {
+    parseApplicationRoutes(appDir: string, routeFileName?: string | null): any[];
+    private extractRoutesFromContent;
+    private extractGroupRoutes;
+    private stripGroupBlocks;
+    private extractFlatRoutes;
+    private joinPaths;
+    private extractParamKeys;
+}

package/dist/RouteParser.js

@@ -0,0 +1,178 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RouteParser = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+class RouteParser {
+    parseApplicationRoutes(appDir, routeFileName = null) {
+        const routesDir = path_1.default.join(appDir, 'routes');
+        if (!fs_1.default.existsSync(routesDir))
+            return [];
+        const routes = [];
+        let filesToParse = [];
+        if (routeFileName) {
+            const specificFile = path_1.default.join(routesDir, routeFileName.endsWith('.ts') ? routeFileName : `${routeFileName}.ts`);
+            if (fs_1.default.existsSync(specificFile)) {
+                filesToParse = [specificFile];
+            }
+            else {
+                console.warn(`\n  ⚠ Route file not found: ${specificFile}\n`);
+                return [];
+            }
+        }
+        else {
+            const allFiles = fs_1.default.readdirSync(routesDir).filter(f => f.endsWith('.ts'));
+            if (allFiles.includes('api.ts')) {
+                filesToParse = [path_1.default.join(routesDir, 'api.ts')];
+            }
+            else if (allFiles.length > 0) {
+                filesToParse = [path_1.default.join(routesDir, allFiles[0])];
+            }
+        }
+        for (const file of filesToParse) {
+            const content = fs_1.default.readFileSync(file, 'utf8');
+            this.extractRoutesFromContent(content, routes);
+        }
+        return routes;
+    }
+    extractRoutesFromContent(content, routes) {
+        const strippedContent = this.extractGroupRoutes(content, routes);
+        this.extractFlatRoutes(strippedContent, routes, '', []);
+    }
+    extractGroupRoutes(content, routes) {
+        const groupRegex = /Route\.group\s*\(\s*\{([^}]+)\}\s*,\s*\(\s*\)\s*=>\s*\{([\s\S]*?)\}\s*\)/g;
+        let match;
+        let contentCopy = content;
+        while ((match = groupRegex.exec(content)) !== null) {
+            const groupConfig = match[1];
+            const groupBody = match[2];
+            let prefix = '';
+            let middleware = [];
+            const prefixMatch = groupConfig.match(/prefix\s*:\s*['"`]([^'"`]+)['"`]/);
+            if (prefixMatch)
+                prefix = prefixMatch[1];
+            const mwMatch = groupConfig.match(/middleware\s*:\s*(['"`][^'"`]+['"`]|\[[^\]]+\])/);
+            if (mwMatch) {
+                const mwStr = mwMatch[1];
+                if (mwStr.startsWith('[')) {
+                    const mws = mwStr.match(/['"`]([^'"`]+)['"`]/g);
+                    if (mws)
+                        middleware = mws.map(m => m.replace(/['"`]/g, ''));
+                }
+                else {
+                    middleware.push(mwStr.replace(/['"`]/g, ''));
+                }
+            }
+            this.extractFlatRoutes(groupBody, routes, prefix, middleware);
+        }
+        return this.stripGroupBlocks(contentCopy);
+    }
+    stripGroupBlocks(content) {
+        let result = content;
+        let changed = true;
+        while (changed) {
+            changed = false;
+            const groupStart = result.indexOf('Route.group(');
+            if (groupStart === -1)
+                break;
+            const arrowIdx = result.indexOf('=>', groupStart);
+            if (arrowIdx === -1)
+                break;
+            const braceStart = result.indexOf('{', arrowIdx);
+            if (braceStart === -1)
+                break;
+            let depth = 0;
+            let i = braceStart;
+            for (; i < result.length; i++) {
+                if (result[i] === '{')
+                    depth++;
+                else if (result[i] === '}') {
+                    depth--;
+                    if (depth === 0)
+                        break;
+                }
+            }
+            let endIdx = result.indexOf(';', i);
+            if (endIdx === -1)
+                endIdx = i + 1;
+            result = result.substring(0, groupStart) + result.substring(endIdx + 1);
+            changed = true;
+        }
+        return result;
+    }
+    extractFlatRoutes(content, routes, prefix, middleware) {
+        const normalized = content.replace(/\s+/g, ' ');
+        const routeRegex = /Route\.(get|post|put|patch|delete|options)\s*\(\s*['"`]([^'"`]*)['"`]\s*,\s*((?:[^\(\)]*|\([^\)]*\))*)\)\s*([^;]*)?;?/g;
+        let match;
+        while ((match = routeRegex.exec(normalized)) !== null) {
+            const method = match[1].toUpperCase();
+            const routePath = match[2];
+            const handlerStr = match[3]?.trim() || '';
+            const modifiersStr = match[4] || '';
+            const controllerMatch = handlerStr.match(/\[\s*(\w+)\s*,\s*['"`](\w+)['"`]\s*\]/);
+            const instanceMatch = handlerStr.match(/(\w+)\.(\w+)/);
+            let handlerLabel;
+            if (controllerMatch) {
+                handlerLabel = `${controllerMatch[1]}@${controllerMatch[2]}`;
+            }
+            else if (instanceMatch && !handlerStr.includes('=>')) {
+                handlerLabel = `${instanceMatch[1]}.${instanceMatch[2]}`;
+            }
+            else if (handlerStr.includes('=>')) {
+                handlerLabel = '[Closure]';
+            }
+            else {
+                handlerLabel = handlerStr.substring(0, 40);
+            }
+            const routeMiddleware = [...middleware];
+            const withMwRegex = /\.withMiddleware\s*\(\s*(['"`][^'"`]+['"`]|\[[^\]]+\])\s*\)/;
+            const withMwMatch = modifiersStr.match(withMwRegex);
+            if (withMwMatch) {
+                const mwStr = withMwMatch[1];
+                if (mwStr.startsWith('[')) {
+                    const mws = mwStr.match(/['"`]([^'"`]+)['"`]/g);
+                    if (mws)
+                        routeMiddleware.push(...mws.map(m => m.replace(/['"`]/g, '')));
+                }
+                else {
+                    routeMiddleware.push(mwStr.replace(/['"`]/g, ''));
+                }
+            }
+            let name;
+            const asRegex = /\.as\s*\(\s*['"`]([^'"`]+)['"`]\s*\)/;
+            const asMatch = modifiersStr.match(asRegex);
+            if (asMatch)
+                name = asMatch[1];
+            const fullPath = this.joinPaths(prefix, routePath);
+            const paramKeys = this.extractParamKeys(fullPath);
+            routes.push({
+                method,
+                path: fullPath,
+                handler: handlerLabel !== '[Closure]' && handlerLabel.length > 0 ? handlerLabel : undefined,
+                name,
+                middleware: routeMiddleware,
+                prefix,
+                paramKeys
+            });
+        }
+    }
+    joinPaths(prefix, path) {
+        const cleanPrefix = prefix.replace(/^\/+|\/+$/g, '');
+        const cleanPath = path.replace(/^\/+|\/+$/g, '');
+        const sep = cleanPrefix && cleanPath ? '/' : '';
+        return `/${cleanPrefix}${sep}${cleanPath}`;
+    }
+    extractParamKeys(pathStr) {
+        const keys = [];
+        const regex = /:([a-zA-Z0-9_]+)|\{([a-zA-Z0-9_]+)\}/g;
+        let match;
+        while ((match = regex.exec(pathStr)) !== null) {
+            keys.push(match[1] || match[2]);
+        }
+        return keys;
+    }
+}
+exports.RouteParser = RouteParser;

package/dist/index.d.ts

@@ -1,5 +1,7 @@
-export { DocumentationGenerator } from './Generator';
-export { PostmanGenerator } from './PostmanGenerator';
-export { MarkdownGenerator } from './MarkdownGenerator';
-export { HtmlGenerator } from './HtmlGenerator';
-export { OpenApiGenerator } from './OpenApiGenerator';
+export * from './types';
+export * from './RouteParser';
+export * from './Generator';
+export * from './MarkdownGenerator';
+export * from './PostmanGenerator';
+export * from './OpenApiGenerator';
+export * from './HtmlGenerator';

package/dist/index.js

@@ -1,13 +1,23 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OpenApiGenerator = exports.HtmlGenerator = exports.MarkdownGenerator = exports.PostmanGenerator = exports.DocumentationGenerator = void 0;
-var Generator_1 = require("./Generator");
-Object.defineProperty(exports, "DocumentationGenerator", { enumerable: true, get: function () { return Generator_1.DocumentationGenerator; } });
-var PostmanGenerator_1 = require("./PostmanGenerator");
-Object.defineProperty(exports, "PostmanGenerator", { enumerable: true, get: function () { return PostmanGenerator_1.PostmanGenerator; } });
-var MarkdownGenerator_1 = require("./MarkdownGenerator");
-Object.defineProperty(exports, "MarkdownGenerator", { enumerable: true, get: function () { return MarkdownGenerator_1.MarkdownGenerator; } });
-var HtmlGenerator_1 = require("./HtmlGenerator");
-Object.defineProperty(exports, "HtmlGenerator", { enumerable: true, get: function () { return HtmlGenerator_1.HtmlGenerator; } });
-var OpenApiGenerator_1 = require("./OpenApiGenerator");
-Object.defineProperty(exports, "OpenApiGenerator", { enumerable: true, get: function () { return OpenApiGenerator_1.OpenApiGenerator; } });
+__exportStar(require("./types"), exports);
+__exportStar(require("./RouteParser"), exports);
+__exportStar(require("./Generator"), exports);
+__exportStar(require("./MarkdownGenerator"), exports);
+__exportStar(require("./PostmanGenerator"), exports);
+__exportStar(require("./OpenApiGenerator"), exports);
+__exportStar(require("./HtmlGenerator"), exports);

package/dist/types.d.ts

@@ -0,0 +1,9 @@
+export interface ParsedRoute {
+    method: string;
+    path: string;
+    name?: string;
+    prefix?: string;
+    middleware: string[];
+    paramKeys: string[];
+    handler?: string;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arikajs/docs",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "API documentation and Postman collection generator for ArikaJS.",
   "license": "MIT",
   "main": "dist/index.js",
@@ -8,7 +8,8 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "clean": "rm -rf dist",
-    "test": "npm run build && node --test 'dist/tests/**/*.test.js'"
+    "test": "npm run build && node --test 'dist/tests/**/*.test.js'",
+    "dev": "tsc -p tsconfig.json --watch"
   },
   "files": [
     "dist"
@@ -22,11 +23,20 @@
     "documentation"
   ],
   "dependencies": {
-    "@arikajs/router": "file:../router"
+    "@arikajs/router": "*"
   },
   "devDependencies": {
     "@types/node": "^20.11.24",
     "typescript": "^5.3.3"
   },
-  "author": "Prakash Tank"
+  "author": "Prakash Tank",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ArikaJs/arikajs.git",
+    "directory": "packages/docs"
+  },
+  "bugs": {
+    "url": "https://github.com/ArikaJs/arikajs/issues"
+  },
+  "homepage": "https://github.com/ArikaJs/arikajs/tree/main/packages/docs#readme"
 }