aaex-file-router 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 TmRAaEx
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,270 @@
+# AAEX File Router
+
+A file-based routing system for React projects that automatically generates routes from your file structure. Similar to Next.js App Router or Remix file conventions.
+
+## Features
+
+- **Automatic Route Generation**: Routes are generated based on your file and folder structure
+- **Layout Support**: Create `layout.tsx` files to wrap nested routes
+- **Static & Lazy Loading**: Top-level routes use static imports, nested routes use lazy loading
+- **Hot Reload**: Vite plugin watches for file changes and regenerates routes automatically
+- **TypeScript Support**: Full TypeScript support with generated route types
+
+## Installation
+
+```bash
+npm install aaex-file-router
+```
+
+## Quick Start
+
+### 1. Create your pages structure
+
+```
+src/pages/
+├── index.tsx          # Root page "/"
+├── about.tsx          # Route "/about"
+└── test/
+    ├── layout.tsx     # Layout wrapper for /test/* routes
+    ├── index.tsx      # Route "/test"
+    └── hello.tsx      # Route "/test/hello"
+```
+
+### 2. Configure Vite
+
+```typescript
+// vite.config.ts
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+import { aaexFileRouter } from 'aaex-file-router';
+
+export default defineConfig({
+  plugins: [
+    react(),
+    aaexFileRouter({
+      pagesDir: './src/pages', //page files location(optional: default ./src/pages)
+      outputFile: './src/routes.ts', //generated routes (default: ./src/routes.ts)
+    }),
+  ],
+});
+```
+
+### 3. Use in your app
+
+```typescript
+// src/main.tsx
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+import { RouterProvider, createBrowserRouter } from 'react-router-dom';
+import routes from './routes';
+
+const router = createBrowserRouter(routes);
+
+ReactDOM.createRoot(document.getElementById('root')!).render(
+  <React.StrictMode>
+    <RouterProvider router={router} />
+  </React.StrictMode>
+);
+```
+
+## File Conventions
+
+### `index.tsx`
+Renders at the parent route path.
+```
+pages/index.tsx       → "/"
+pages/about/index.tsx → "/about"
+```
+
+### `layout.tsx`
+Wraps all sibling and nested routes. Children are rendered in an `<Outlet />`.
+```typescript
+// pages/admin/layout.tsx
+import { Outlet } from 'react-router-dom';
+
+export default function AdminLayout() {
+  return (
+    <div>
+      <nav>Admin Navigation</nav>
+      <Outlet /> {/* Nested routes render here */}
+    </div>
+  );
+}
+```
+
+### Named files
+Any other `.tsx` file becomes a route based on its filename.
+```
+pages/about.tsx       → "/about"
+pages/blog/post.tsx   → "/blog/post"
+```
+
+## Generated Routes File
+
+The plugin generates a `routes.ts` file with all your routes:
+
+```typescript
+// src/routes.ts
+// AUTO GENERATED: DO NOT EDIT
+import React from 'react';
+import Index from './pages/index.tsx';
+import AdminLayout from './pages/admin/layout.tsx';
+import type { RouteObject } from 'react-router-dom';
+
+const routes: RouteObject[] = [
+  {
+    path: '/',
+    element: React.createElement(Index),
+  },
+  {
+    path: 'admin',
+    element: React.createElement(AdminLayout),
+    children: [
+      // nested routes...
+    ],
+  },
+];
+
+export default routes;
+```
+
+## Route Resolution Examples
+
+| File Structure | Route Path |
+|---|---|
+| `pages/index.tsx` | `/` |
+| `pages/about.tsx` | `/about` |
+| `pages/blog/index.tsx` | `/blog` |
+| `pages/blog/post.tsx` | `/blog/post` |
+| `pages/admin/layout.tsx` + children | `/admin/*` (grouped) |
+
+## Layouts
+
+Layouts wrap their child routes and provide shared UI:
+
+```typescript
+// pages/dashboard/layout.tsx
+import { Outlet } from 'react-router-dom';
+
+export default function DashboardLayout() {
+  return (
+    <div className="dashboard">
+      <Sidebar />
+      <main>
+        <Outlet />
+      </main>
+    </div>
+  );
+}
+```
+
+All routes in `pages/dashboard/*` will render inside this layout.
+
+## API Reference
+
+### FileScanner
+Scans the file system and converts files into a structured format.
+
+```typescript
+import { FileScanner } from 'aaex-file-router';
+
+const scanner = new FileScanner('./src/pages');
+const fileData = await scanner.get_file_data();
+```
+
+### RouteGenerator
+Converts file structure into React Router route configuration.
+
+```typescript
+import { RouteGenerator } from 'aaex-file-router';
+
+const generator = new RouteGenerator();
+const routesCode = await generator.generateComponentsMap(fileData);
+```
+
+### aaexFileRouter (Vite Plugin)
+Automatically watches for file changes and regenerates routes.
+
+```typescript
+import { aaexFileRouter } from 'aaex-file-router';
+
+export default defineConfig({
+  plugins: [
+    aaexFileRouter({
+      pagesDir: './src/pages',
+      outputFile: './src/routes.ts',
+    }),
+  ],
+});
+```
+
+## How It Works
+
+1. **File Scanning**: Recursively scans your pages directory and builds a file tree
+2. **Route Generation**: Converts the file structure into React Router `RouteObject` format
+3. **Smart Importing**: 
+   - Top-level files use static imports for faster initial load
+   - Nested/grouped routes use lazy loading for code splitting
+   - Layout files are statically imported as route wrappers
+4. **Auto-Regeneration**: Vite plugin watches for changes and automatically regenerates `routes.ts`
+
+## Performance Considerations
+
+- **Static Imports**: Top-level routes are statically imported, included in the main bundle
+- **Code Splitting**: Routes nested in layout groups are lazy-loaded, improving initial bundle size
+- **Watch Mode**: File watching only runs in development (`vite serve`), not in production builds
+
+## Common Patterns
+
+### Shared Layout
+```
+pages/
+├── layout.tsx         # Wraps entire app
+├── index.tsx
+└── about.tsx
+```
+
+### Nested Layouts
+```
+pages/
+├── layout.tsx                 # Root layout
+├── admin/
+│   ├── layout.tsx            # Admin layout (inherits from root)
+│   ├── index.tsx
+│   └── users.tsx
+```
+
+### Route Groups Without Layout
+```
+pages/
+├── blog/
+│   ├── post.tsx              # Routes as /blog/post (no grouping)
+│   └── author.tsx            # Routes as /blog/author
+```
+
+## Troubleshooting
+
+### Routes not updating on file change
+- Ensure Vite dev server is running (`npm run dev`)
+- Check that `pagesDir` in vite config matches your actual pages directory
+
+### Duplicate imports in generated file
+- This shouldn't happen, but if it does, try restarting the dev server
+- Check for files with the same name in different directories
+
+### Unexpected route paths
+- Remember: `index.tsx` files inherit their parent's path
+- Directories without `layout.tsx` flatten their children into absolute routes
+- File names are converted to lowercase for routes
+
+<!-- ## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request. -->
+
+## License
+
+MIT
+
+<!-- ## Support
+
+For issues, questions, or suggestions, please open an issue on GitHub. -->

package/dist/core/FileScanner.d.ts

@@ -0,0 +1,28 @@
+export interface FileData {
+    name: string;
+    relative_path: string;
+    parent_path: string;
+    isDirectory: boolean;
+    children?: FileData[];
+}
+export declare class FileScanner {
+    page_dir: string;
+    topLevelImports: string[];
+    constructor(pages_dir: string);
+    /**
+     * Recursively scan directory and flatten all files/folders
+     * Adds a parentPath property to each entry to track hierarchy
+     */
+    private scan_files;
+    /**
+     * Convert flat Dirent array into nested FileData structure
+     * Rebuilds directory hierarchy and filters children by parent path
+     */
+    private build_file_data;
+    /**
+     * Public entry point: scans pages directory and returns nested FileData structure
+     * Handles both flat scanning and hierarchical rebuilding
+     */
+    get_file_data(): Promise<FileData[]>;
+}
+//# sourceMappingURL=FileScanner.d.ts.map

package/dist/core/FileScanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileScanner.d.ts","sourceRoot":"","sources":["../../src/core/FileScanner.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,qBAAa,WAAW;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,EAAE,CAAM;gBAEnB,SAAS,EAAE,MAAM;IAI7B;;;OAGG;YACW,UAAU;IAmBxB;;;OAGG;YACW,eAAe;IA+C7B;;;OAGG;IACU,aAAa,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;CAKlD"}

package/dist/core/FileScanner.js

@@ -0,0 +1,80 @@
+import { promises as fs } from "fs";
+import path from "path";
+export class FileScanner {
+    page_dir;
+    topLevelImports = [];
+    constructor(pages_dir) {
+        this.page_dir = pages_dir;
+    }
+    /**
+     * Recursively scan directory and flatten all files/folders
+     * Adds a parentPath property to each entry to track hierarchy
+     */
+    async scan_files(dir) {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        let result = [];
+        for (const entry of entries) {
+            // Store parent directory path for later reference
+            entry.parentPath = dir;
+            result.push(entry);
+            // Recursively scan subdirectories and flatten results
+            if (entry.isDirectory()) {
+                const subFiles = await this.scan_files(path.join(dir, entry.name));
+                result = result.concat(subFiles);
+            }
+        }
+        return result;
+    }
+    /**
+     * Convert flat Dirent array into nested FileData structure
+     * Rebuilds directory hierarchy and filters children by parent path
+     */
+    async build_file_data(files) {
+        const result = [];
+        for (const file of files) {
+            const fullpath = path.join(file.parentPath, file.name);
+            // Convert backslashes to forward slashes for cross-platform path consistency
+            const relative = path
+                .relative(process.cwd(), fullpath)
+                .replace(/\\/g, "/")
+                .trim();
+            if (file.isDirectory()) {
+                // Filter files to find only direct children of this directory
+                const children = files.filter((file) => file.parentPath === fullpath);
+                result.push({
+                    name: file.name,
+                    parent_path: 
+                    // Normalize parent path with forward slashes and trailing slash
+                    path
+                        .relative(process.cwd(), file.parentPath)
+                        .replace(/\\/g, "/") + "/",
+                    relative_path: relative,
+                    isDirectory: true,
+                    children: await this.build_file_data(children),
+                });
+                continue;
+            }
+            result.push({
+                name: file.name,
+                parent_path: 
+                // Normalize parent path with forward slashes and trailing slash
+                path
+                    .relative(process.cwd(), file.parentPath)
+                    .replace(/\\/g, "/") + "/",
+                relative_path: relative,
+                isDirectory: false,
+            });
+        }
+        return result;
+    }
+    /**
+     * Public entry point: scans pages directory and returns nested FileData structure
+     * Handles both flat scanning and hierarchical rebuilding
+     */
+    async get_file_data() {
+        const raw = await this.scan_files(path.join(process.cwd(), this.page_dir));
+        const result = await this.build_file_data(raw);
+        return result;
+    }
+}
+//# sourceMappingURL=FileScanner.js.map

package/dist/core/FileScanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileScanner.js","sourceRoot":"","sources":["../../src/core/FileScanner.ts"],"names":[],"mappings":"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"}

package/dist/core/RouteGenerator.d.ts

@@ -0,0 +1,22 @@
+import { FileData } from "./FileScanner";
+export declare class RouteGenerator {
+    private topLevelImports;
+    private importSet;
+    private processedFiles;
+    private clearImports;
+    /**
+     * Recursively converts FileData tree into React Router RouteConfig array
+     * Handles layout files, index files, and nested routes with proper pathing
+     * @param fileData - Array of files/folders to process
+     * @param parentPath - Current path context for nested routes (empty for root)
+     */
+    private fileDataToRoutes;
+    /**
+     * Generates a complete routes configuration file as a string
+     * Includes all imports and route definitions in valid TypeScript/React code
+     * @param fileData - FileData tree from FileScanner
+     * @returns Complete routes file content ready to be written to disk
+     */
+    generateComponentsMap(fileData: FileData[]): Promise<string>;
+}
+//# sourceMappingURL=RouteGenerator.d.ts.map

package/dist/core/RouteGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteGenerator.d.ts","sourceRoot":"","sources":["../../src/core/RouteGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AASzC,qBAAa,cAAc;IACzB,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,cAAc,CAA0B;IAEhD,OAAO,CAAC,YAAY;IAGpB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IA6KxB;;;;;OAKG;IACU,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CA6B1E"}

package/dist/core/RouteGenerator.js

@@ -0,0 +1,170 @@
+export class RouteGenerator {
+    topLevelImports = [];
+    importSet = new Set();
+    processedFiles = new Set();
+    clearImports() {
+        this.topLevelImports = [];
+    }
+    /**
+     * Recursively converts FileData tree into React Router RouteConfig array
+     * Handles layout files, index files, and nested routes with proper pathing
+     * @param fileData - Array of files/folders to process
+     * @param parentPath - Current path context for nested routes (empty for root)
+     */
+    fileDataToRoutes(fileData, parentPath = "", flattenPrefix = "", inGroup = false) {
+        const routes = [];
+        const processedIndexes = new Set();
+        /**
+         * Utility function to safely join path segments
+         * - Filters out empty/falsy parts to avoid "///" in paths
+         * - Joins with "/" separator
+         * - Replaces all backslashes with forward slashes for cross-platform consistency
+         * Example: posixJoin("test", "", "hello") -> "test/hello"
+         * Example: posixJoin("pages\\test", "hello") -> "pages/test/hello"
+         */
+        const posixJoin = (...parts) => parts.filter(Boolean).join("/").replace(/\\/g, "/");
+        for (const file of fileData) {
+            // Skip files already emitted during this generation
+            if (!file.isDirectory && this.processedFiles.has(file.relative_path)) {
+                continue;
+            }
+            if (file.isDirectory && file.children && file.children.length > 0) {
+                const layoutChild = file.children.find((c) => !c.isDirectory && /^layout\.(tsx|jsx|ts|js)$/i.test(c.name));
+                if (!layoutChild) {
+                    // No layout -> flatten children into absolute routes
+                    const newFlatten = posixJoin(flattenPrefix, file.name.toLowerCase());
+                    routes.push(...this.fileDataToRoutes(file.children, parentPath, newFlatten, false));
+                    continue;
+                }
+                // Directory has layout -> import layout statically
+                const layoutPath = layoutChild.relative_path.replace(/^src[\/\\]/, "./");
+                const layoutImportName = `TestLayout`;
+                this.topLevelImports.push(`import ${layoutImportName} from '${layoutPath}';`);
+                this.processedFiles.add(layoutChild.relative_path); // Mark layout as processed
+                const childrenRoutes = [];
+                // Process children - filter out layout files
+                const nonLayoutChildren = file.children.filter((c) => !/^layout\.(tsx|jsx|ts|js)$/i.test(c.name));
+                for (const child of nonLayoutChildren) {
+                    if (child.isDirectory) {
+                        // Recursively handle child directories
+                        childrenRoutes.push(...this.fileDataToRoutes([child], posixJoin(parentPath, file.name), "", true));
+                    }
+                    else {
+                        const childNameWithoutExt = child.name.replace(/\.[jt]sx?$/, "");
+                        const childPath = child.relative_path.replace(/^src[\/\\]/, "./");
+                        const isIndexFile = childNameWithoutExt.toLowerCase() === "index";
+                        if (isIndexFile) {
+                            childrenRoutes.push({
+                                path: "",
+                                element: `React.createElement(React.lazy(() => import('${childPath}')))`,
+                            });
+                        }
+                        else {
+                            childrenRoutes.push({
+                                path: childNameWithoutExt.toLowerCase(),
+                                element: `React.createElement(React.lazy(() => import('${childPath}')))`,
+                            });
+                        }
+                        // Mark child as processed so it doesn't get added as top-level
+                        this.processedFiles.add(child.relative_path);
+                    }
+                }
+                routes.push({
+                    path: file.name.toLowerCase(),
+                    element: `React.createElement(${layoutImportName})`,
+                    children: childrenRoutes.length ? childrenRoutes : undefined,
+                });
+            }
+            else if (!file.isDirectory) {
+                const nameWithoutExt = file.name.replace(/\.[jt]sx?$/, "");
+                const isIndexFile = nameWithoutExt.toLowerCase() === "index";
+                // Skip if already processed
+                if (isIndexFile && processedIndexes.has(file.relative_path)) {
+                    continue;
+                }
+                // If a sibling directory with the same name exists, skip this file
+                const siblingDirExists = fileData.some((f) => f.isDirectory &&
+                    f.name.toLowerCase() === nameWithoutExt.toLowerCase());
+                if (siblingDirExists) {
+                    this.processedFiles.add(file.relative_path);
+                    continue;
+                }
+                // Skip layout files
+                if (/^layout\.(tsx|jsx|ts|js)$/i.test(file.name)) {
+                    this.processedFiles.add(file.relative_path);
+                    continue;
+                }
+                // Determine path
+                const fileSegment = isIndexFile ? "" : nameWithoutExt.toLowerCase();
+                let fullPath;
+                if (flattenPrefix) {
+                    fullPath = posixJoin(flattenPrefix, fileSegment);
+                }
+                else if (inGroup) {
+                    fullPath = fileSegment;
+                }
+                else if (parentPath) {
+                    fullPath = posixJoin(parentPath, fileSegment);
+                }
+                else {
+                    fullPath = isIndexFile ? "/" : fileSegment;
+                }
+                // Create import & avoid duplicates
+                const importNameBase = nameWithoutExt.replace(/[^a-zA-Z0-9]/g, "_");
+                const capitalized = importNameBase.charAt(0).toUpperCase() + importNameBase.slice(1);
+                const filePath = file.relative_path.replace(/^src[\/\\]/, "./");
+                if (inGroup) {
+                    // Lazy-load child component inside group
+                    routes.push({
+                        path: fullPath === "/" ? "" : fullPath.replace(/^\/+/, ""),
+                        element: `React.createElement(React.lazy(() => import('${filePath}')))`,
+                    });
+                }
+                else {
+                    // Top-level files use static imports
+                    if (!this.importSet.has(filePath)) {
+                        this.topLevelImports.push(`import ${capitalized} from '${filePath}';`);
+                        this.importSet.add(filePath);
+                    }
+                    routes.push({
+                        path: fullPath === "/" ? "/" : fullPath.replace(/^\/+/, ""),
+                        element: `React.createElement(${capitalized})`,
+                    });
+                }
+                this.processedFiles.add(file.relative_path);
+                if (isIndexFile)
+                    processedIndexes.add(file.relative_path);
+            }
+        }
+        return routes;
+    }
+    /**
+     * Generates a complete routes configuration file as a string
+     * Includes all imports and route definitions in valid TypeScript/React code
+     * @param fileData - FileData tree from FileScanner
+     * @returns Complete routes file content ready to be written to disk
+     */
+    async generateComponentsMap(fileData) {
+        // reset import & processed tracking each generation to avoid duplication across regen
+        this.topLevelImports = [];
+        this.importSet = new Set();
+        this.processedFiles = new Set();
+        const routes = this.fileDataToRoutes(fileData);
+        const routesString = JSON.stringify(routes, null, 2)
+            // lazy imports were serialized as strings, restore them to function calls
+            .replace(/"React\.createElement\(React\.lazy\(\(\) => import\('(.*)'\)\)\)"/g, "React.createElement(React.lazy(() => import('$1')))")
+            // React.createElement(Component) serialized as string, unquote it
+            .replace(/"React\.createElement\((\w+)\)"/g, "React.createElement($1)");
+        const mapString = `//* AUTO GENERATED: DO NOT EDIT
+import React from 'react';
+${this.topLevelImports.join("\n")}
+import type { RouteObject } from 'react-router-dom';
+
+const routes: RouteObject[] = ${routesString};
+
+export default routes;
+`;
+        return mapString;
+    }
+}
+//# sourceMappingURL=RouteGenerator.js.map

package/dist/core/RouteGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteGenerator.js","sourceRoot":"","sources":["../../src/core/RouteGenerator.ts"],"names":[],"mappings":"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"}

package/dist/core/types.d.ts

@@ -0,0 +1,8 @@
+export interface FileData {
+    name: string;
+    parent_path: string;
+    relative_path: string;
+    isDirectory: boolean;
+    children?: FileData[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAA;CACxB"}

package/dist/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { FileScanner } from './core/FileScanner.js';
+export { RouteGenerator } from './core/RouteGenerator.js';
+export { aaexFileRouter } from './plugin.js';
+export type { VitePluginOptions } from './plugin.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { FileScanner } from './core/FileScanner.js';
+export { RouteGenerator } from './core/RouteGenerator.js';
+// export type { FileData } from './core/types';
+export { aaexFileRouter } from './plugin.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,gDAAgD;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/pages/index.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

package/dist/pages/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pages/index.tsx"],"names":[],"mappings":""}

package/dist/pages/index.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=index.js.map

package/dist/pages/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pages/index.tsx"],"names":[],"mappings":""}

package/dist/pages/test/index.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

package/dist/pages/test/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pages/test/index.tsx"],"names":[],"mappings":""}

package/dist/pages/test/index.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=index.js.map

package/dist/pages/test/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/pages/test/index.tsx"],"names":[],"mappings":""}

package/dist/pages/test/layout.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=layout.d.ts.map

package/dist/pages/test/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/pages/test/layout.tsx"],"names":[],"mappings":""}

package/dist/pages/test/layout.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=layout.js.map

package/dist/pages/test/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../../src/pages/test/layout.tsx"],"names":[],"mappings":""}

package/dist/plugin.d.ts

@@ -0,0 +1,11 @@
+import { Plugin } from 'vite';
+export interface VitePluginOptions {
+    pagesDir?: string;
+    outputFile?: string;
+}
+/**
+ * Vite plugin that auto-generates routes when page files change
+ * Watches the pages directory and regenerates routes.ts on file create/delete
+ */
+export declare function aaexFileRouter(options?: VitePluginOptions): Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAM9B,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,iBAAsB,GAAG,MAAM,CA6CtE"}

package/dist/plugin.js

@@ -0,0 +1,46 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+import { FileScanner } from './core/FileScanner.js';
+import { RouteGenerator } from './core/RouteGenerator.js';
+/**
+ * Vite plugin that auto-generates routes when page files change
+ * Watches the pages directory and regenerates routes.ts on file create/delete
+ */
+export function aaexFileRouter(options = {}) {
+    const pagesDir = options.pagesDir || './src/pages';
+    const outputFile = options.outputFile || './src/routes.ts';
+    let scanner;
+    let generator;
+    return {
+        name: 'aaex-file-router',
+        apply: 'serve', // Only run in dev mode
+        configResolved() {
+            scanner = new FileScanner(pagesDir);
+            generator = new RouteGenerator();
+        },
+        async configureServer(server) {
+            // Watch the pages directory for changes
+            server.watcher.add(path.resolve(process.cwd(), pagesDir));
+            server.watcher.on('all', async (event, filePath) => {
+                // Only regenerate on file add/unlink events
+                if (event === 'add' || event === 'unlink') {
+                    try {
+                        console.log(`📄 [aaex-file-router] ${event}: ${filePath}`);
+                        // Regenerate routes
+                        scanner = new FileScanner(pagesDir);
+                        generator = new RouteGenerator();
+                        const fileData = await scanner.get_file_data();
+                        const routesCode = await generator.generateComponentsMap(fileData);
+                        // Write routes file
+                        await fs.writeFile(outputFile, routesCode, 'utf-8');
+                        console.log(`✅ [aaex-file-router] Routes regenerated at ${outputFile}`);
+                    }
+                    catch (error) {
+                        console.error('❌ [aaex-file-router] Error regenerating routes:', error);
+                    }
+                }
+            });
+        },
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAO1D;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,UAA6B,EAAE;IAC5D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,aAAa,CAAC;IACnD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,iBAAiB,CAAC;IAE3D,IAAI,OAAoB,CAAC;IACzB,IAAI,SAAyB,CAAC;IAE9B,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,OAAO,EAAE,uBAAuB;QAEvC,cAAc;YACZ,OAAO,GAAG,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;YACpC,SAAS,GAAG,IAAI,cAAc,EAAE,CAAC;QACnC,CAAC;QAED,KAAK,CAAC,eAAe,CAAC,MAAM;YAC1B,wCAAwC;YACxC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;YAE1D,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;gBACjD,4CAA4C;gBAC5C,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;oBAC1C,IAAI,CAAC;wBACH,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,KAAK,QAAQ,EAAE,CAAC,CAAC;wBAE3D,oBAAoB;wBACpB,OAAO,GAAG,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;wBACpC,SAAS,GAAG,IAAI,cAAc,EAAE,CAAC;wBAEjC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;wBAC/C,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;wBAGnE,oBAAoB;wBACpB,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;wBAEpD,OAAO,CAAC,GAAG,CAAC,8CAA8C,UAAU,EAAE,CAAC,CAAC;oBAC1E,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,OAAO,CAAC,KAAK,CAAC,iDAAiD,EAAE,KAAK,CAAC,CAAC;oBAC1E,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/test/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/test/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test/index.ts"],"names":[],"mappings":""}

package/dist/test/index.js

@@ -0,0 +1,26 @@
+import { fileURLToPath } from "url";
+import { FileScanner } from "../core/FileScanner.js";
+import { RouteGenerator } from "../core/RouteGenerator.js";
+import { promises as fs } from "fs";
+import path from "path";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const pagesDir = "/src/pages";
+async function generateRoutes() {
+    try {
+        const scanner = new FileScanner(pagesDir);
+        const fileData = await scanner.get_file_data();
+        const generator = new RouteGenerator();
+        const routeMap = await generator.generateComponentsMap(fileData);
+        // Go up from dist/test back to src/test
+        const srcTestDir = __dirname.replace(/dist[\\/]test/, "src/test");
+        const filePath = path.join(srcTestDir, "routes.ts");
+        await fs.writeFile(filePath, routeMap, "utf-8");
+        console.log(`Routes file created at: ${filePath}`);
+    }
+    catch (error) {
+        console.error("Error generating routes:", error);
+    }
+}
+generateRoutes();
+//# sourceMappingURL=index.js.map

package/dist/test/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/test/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAC3C,MAAM,QAAQ,GAAG,YAAY,CAAC;AAE9B,KAAK,UAAU,cAAc;IAC3B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;QAE/C,MAAM,SAAS,GAAG,IAAI,cAAc,EAAE,CAAC;QACvC,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAEjE,wCAAwC;QACxC,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;QAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QACpD,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAEhD,OAAO,CAAC,GAAG,CAAC,2BAA2B,QAAQ,EAAE,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED,cAAc,EAAE,CAAC"}

package/dist/test/routes.d.ts

@@ -0,0 +1,4 @@
+import type { RouteObject } from 'react-router-dom';
+declare const routes: RouteObject[];
+export default routes;
+//# sourceMappingURL=routes.d.ts.map

package/dist/test/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/test/routes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,QAAA,MAAM,MAAM,EAAE,WAAW,EAexB,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/test/routes.js

@@ -0,0 +1,20 @@
+import React from 'react';
+import Index from './pages/index.tsx';
+const routes = [
+    {
+        "path": "/",
+        "element": React.createElement(Index)
+    },
+    {
+        "path": "test",
+        "element": React.createElement(React.lazy(() => import('./pages/test/layout.tsx'))),
+        "children": [
+            {
+                "path": "",
+                "element": React.createElement(React.lazy(() => import('./pages/test/index.tsx')))
+            }
+        ]
+    }
+];
+export default routes;
+//# sourceMappingURL=routes.js.map

package/dist/test/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/test/routes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,MAAM,mBAAmB,CAAC;AAGtC,MAAM,MAAM,GAAkB;IAC5B;QACE,MAAM,EAAE,GAAG;QACX,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC;KACtC;IACD;QACE,MAAM,EAAE,MAAM;QACd,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC;QACnF,UAAU,EAAE;YACV;gBACE,MAAM,EAAE,EAAE;gBACV,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC,CAAC;aACnF;SACF;KACF;CACF,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/test/routes.ts

@@ -0,0 +1,26 @@
+
+import React from 'react';
+import Index from './/pages/index.tsx';
+import type { RouteObject } from 'react-router-dom';
+
+const routes: RouteObject[] = [
+  {
+    "path": "/",
+    "element": "<Index/>"
+  },
+  {
+    "path": "test",
+    "element": React.createElement(React.lazy(() => import('.//pages/test/layout.tsx'))),
+    "children": [
+      {
+        "path": "",
+        "element": React.createElement(React.lazy(() => import('.//pages/test/index.tsx')))
+      }
+    ]
+  }
+];
+
+// Convert stringified lazy imports back to actual function calls
+// Regex: "React.createElement(React.lazy(() => import('(.*)')))" - matches stringified lazy import wrappers
+// Replaces them with actual lazy import functions (removes surrounding quotes)
+export default routes;

package/dist/vite.config.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("vite").UserConfig;
+export default _default;
+//# sourceMappingURL=vite.config.d.ts.map

package/dist/vite.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.config.d.ts","sourceRoot":"","sources":["../src/vite.config.ts"],"names":[],"mappings":";AAGA,wBAkBG"}

package/dist/vite.config.js

@@ -0,0 +1,22 @@
+import { defineConfig } from 'vite';
+import dts from 'vite-plugin-dts';
+export default defineConfig({
+    build: {
+        lib: {
+            entry: 'src/index.ts',
+            name: 'AaexFileRouter',
+            fileName: (format) => `aaex-file-router.${format === 'es' ? 'js' : 'cjs'}`,
+        },
+        rollupOptions: {
+            external: ['react', 'react-router-dom', 'vite'],
+            output: {
+                globals: {
+                    react: 'React',
+                    'react-router-dom': 'ReactRouterDOM',
+                },
+            },
+        },
+    },
+    plugins: [dts()], // Generate TypeScript declarations
+});
+//# sourceMappingURL=vite.config.js.map

package/dist/vite.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.config.js","sourceRoot":"","sources":["../src/vite.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,GAAG,MAAM,iBAAiB,CAAC;AAElC,eAAe,YAAY,CAAC;IAC1B,KAAK,EAAE;QACL,GAAG,EAAE;YACH,KAAK,EAAE,cAAc;YACrB,IAAI,EAAE,gBAAgB;YACtB,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,oBAAoB,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE;SAC3E;QACD,aAAa,EAAE;YACb,QAAQ,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,MAAM,CAAC;YAC/C,MAAM,EAAE;gBACN,OAAO,EAAE;oBACP,KAAK,EAAE,OAAO;oBACd,kBAAkB,EAAE,gBAAgB;iBACrC;aACF;SACF;KACF;IACD,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,mCAAmC;CACtD,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "aaex-file-router",
+  "version": "1.0.0",
+  "description": "A file-based routing system for React projects that automatically generates routes from your file structure. Similar to Next.js App Router or Remix file conventions.",
+  "main": "dist/index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "npx tsc",
+    "dev": "npx tsc --watch"
+  },
+  "keywords": [
+    "react",
+    "router",
+    "vite-plugin"
+  ],
+  "author": "TmRAaEx",
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENCE"
+  ],
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "typescript": "^5.9.3",
+    "vite": "^7.2.4",
+    "vite-plugin-dts": "^4.5.4"
+  },
+  "dependencies": {
+    "fs": "^0.0.1-security"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0",
+    "react-router-dom": "^6.0.0",
+    "vite": "^4.0.0"
+  }
+}