aaex-file-router 1.3.0 → 1.3.2

package/README.md

@@ -2,10 +2,34 @@
 
 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.
 
-## V. 1.3.0
-Routes are now able to be infinetly nested
-
-**Notice** Onlyt tested 3 levels deep but there is no reason i shouldnt work further
+## V. 1.3.2
+
+Routes are now able to be infinitely nested
+
+**Notice** Only tested 3 levels deep but there is no reason i shouldnt work further
+
+## Table of Contents
+
+- [Features](#features)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+  - [1. Create your pages structure](#1-create-your-pages-structure)
+  - [2. Configure Vite](#2-configure-vite)
+  - [3. Use in your app](#3-use-in-your-app)
+    - [Using createBrowserRouter](#1-using-createbrowserrouter-recommended-for-most-users)
+    - [Using nested Route elements](#2-using-nested-route-elements)
+- [File Conventions](#file-conventions)
+- [Generated Routes File](#generated-routes-file)
+- [Route Resolution Examples](#route-resolution-examples)
+- [Layouts](#layouts)
+- [FileLink component](#filelink-component)
+- [Usage](#usage)
+- [API Reference](#api-reference)
+- [How It Works](#how-it-works)
+- [Performance Considerations](#performance-considerations)
+- [Common Patterns](#common-patterns)
+- [Troubleshooting](#troubleshooting)
+- [License](#license)
 
 ## Features
 
@@ -44,7 +68,7 @@ src/pages/
 // vite.config.ts
 import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react";
-import { aaexFileRouter } from "aaex-file-router";
+import { aaexFileRouter } from "aaex-file-router/plugin";
 
 export default defineConfig({
   plugins: [
@@ -59,20 +83,66 @@ export default defineConfig({
 
 ### 3. Use in your app
 
+#### 1. Using createBrowserRouter (recommended for most users)
+
 ```typescript
-// src/main.tsx
-import React from "react";
-import ReactDOM from "react-dom/client";
-import { RouterProvider, createBrowserRouter } from "react-router-dom";
+// src/App.tsx
+import "./App.css";
 import routes from "./routes";
+import { createBrowserRouter, RouterProvider } from "react-router-dom";
+import { Suspense } from "react";
+
+function App() {
+  const router = createBrowserRouter(routes);
+
+  return (
+    <Suspense fallback={<div>Loading...</div>}>
+      <RouterProvider router={router} />
+    </Suspense>
+  );
+}
+
+export default App;
+```
+
+## **OR**
+
+### 2. using nested Route elements
 
-const router = createBrowserRouter(routes);
+**Note** I will probably create a custom route provider using this version later since this is the only solution that works with VITE-SSR if you wrap client in `<BrowserRouter/>` and server in `<StaticRouter/>`
+
+```tsx
+//src/App.tsx
+import {
+  BrowserRouter,
+  Routes,
+  Route,
+  type RouteObject,
+} from "react-router-dom";
+import routes from "./routes";
+import { Suspense } from "react";
+import "./App.css";
+
+//recursivly creates nested routes
+function createRoutes(route: RouteObject) {
+  return (
+    <Route key={route.path} path={route.path} element={route.element}>
+      {route.children?.map((child) => createRoutes(child))}
+    </Route>
+  );
+}
+
+function App() {
+  return (
+    <BrowserRouter>
+      <Suspense fallback={<div>Loading...</div>}>
+        <Routes>{routes.map((route) => createRoutes(route))}</Routes>
+      </Suspense>
+    </BrowserRouter>
+  );
+}
 
-ReactDOM.createRoot(document.getElementById("root")!).render(
-  <React.StrictMode>
-    <RouterProvider router={router} />
-  </React.StrictMode>
-);
+export default App;
 ```
 
 ## File Conventions
@@ -106,14 +176,14 @@ export default function AdminLayout() {
 
 ### Slug files
 
-Filenames wrapper in hardbrackets `[filename]` will resolve to a dynamic route
+Filenames wrapper in square brackets `[filename]` will resolve to a dynamic route
 
 ```
-pages/test/[<filename>].tsx → "/test/:<filename>"
+src/pages/test/[<filename>].tsx → "/test/:<filename>"
 ```
 
 ```tsx
-//pages/test/[slug].tsx
+// src/pages/test/[slug].tsx
 
 import { useParams } from "react-router-dom";
 
@@ -165,20 +235,20 @@ 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) |
+| File Structure                          | Route Path           |
+| --------------------------------------- | -------------------- |
+| `src/pages/index.tsx`                   | `/`                  |
+| `src/pages/about.tsx`                   | `/about`             |
+| `src/pages/blog/index.tsx`              | `/blog`              |
+| `src/pages/blog/post.tsx`               | `/blog/post`         |
+| `src/pages/admin/layout.tsx` + children | `/admin/*` (grouped) |
 
 ## Layouts
 
 Layouts wrap their child routes and provide shared UI:
 
 ```typescript
-// pages/dashboard/layout.tsx
+// src/pages/dashboard/layout.tsx
 import { Outlet } from "react-router-dom";
 
 export default function DashboardLayout() {
@@ -193,7 +263,7 @@ export default function DashboardLayout() {
 }
 ```
 
-All routes in `pages/dashboard/*` will render inside this layout.
+All routes in `src/pages/dashboard/*` will render inside this layout.
 
 ## FileLink component
 
@@ -215,7 +285,7 @@ export type FileRoutes = "/" | "test";
 ```
 
 ```tsx
-//src/pages/index.tsx
+// src/pages/index.tsx
 import { FileLink } from "aaex-file-router";
 import type { FileRoutes } from "../routeTypes";
 
@@ -225,7 +295,7 @@ export default function Home() {
       Hello Home!
       {/* FileRoutes is optional and not required it will work fine with any string if not passed */}
       <FileLink<FileRoutes> to="test">Test safe</FileLink>
-      //or //no type safety
+      {/* or without type safety */}
       <FileLink to="some-route">Non safe</FileLink>
     </>
   );
@@ -261,7 +331,7 @@ const routesCode = await generator.generateComponentsMap(fileData);
 Automatically watches for file changes and regenerates routes.
 
 ```typescript
-import { aaexFileRouter } from "aaex-file-router/core";
+import { aaexFileRouter } from "aaex-file-router/plugin";
 
 export default defineConfig({
   plugins: [

package/dist/core/FileScanner.d.ts

@@ -10,10 +10,20 @@ export declare class FileScanner {
     constructor(pages_dir: string);
     /**
      * Recursively scan directory and return nested FileData
+     * - Scans files of a given folder
+     * - converts and returns as usable data
+     * - Format:
+     * {name: string,
+     * relative_path: string,
+     * parent_path: string,
+     * isDirectory: string
+     * }
+     * @param dir string
+     * @returns FileData[]
      */
     private scan_files;
     /**
-     * Public entry point: returns nested FileData structure
+     * Public file point: returns nested FileData structure
      */
     get_file_data(): Promise<FileData[]>;
 }

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

@@ -1 +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;gBAEL,SAAS,EAAE,MAAM;IAI7B;;OAEG;YACW,UAAU;IA0BxB;;OAEG;IACU,aAAa,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;CAKlD"}
+{"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;gBAEL,SAAS,EAAE,MAAM;IAI7B;;;;;;;;;;;;OAYG;YACW,UAAU;IA+BxB;;OAEG;IACU,aAAa,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;CAKlD"}

package/dist/core/FileScanner.js

@@ -7,21 +7,36 @@ export class FileScanner {
     }
     /**
      * Recursively scan directory and return nested FileData
+     * - Scans files of a given folder
+     * - converts and returns as usable data
+     * - Format:
+     * {name: string,
+     * relative_path: string,
+     * parent_path: string,
+     * isDirectory: string
+     * }
+     * @param dir string
+     * @returns FileData[]
      */
     async scan_files(dir) {
-        const entries = await fs.readdir(dir, { withFileTypes: true });
+        //scans the parent folder and outputs an array of files
+        const files = await fs.readdir(dir, { withFileTypes: true });
         const result = [];
-        for (const entry of entries) {
-            const fullPath = path.join(dir, entry.name);
-            const relativePath = path.relative(process.cwd(), fullPath).replace(/\\/g, "/");
+        for (const file of files) {
+            const fullPath = path.join(dir, file.name);
+            const relativePath = path
+                .relative(process.cwd(), fullPath)
+                .replace(/\\/g, "/");
             const parentPath = path.relative(process.cwd(), dir).replace(/\\/g, "/") + "/";
+            // convert to usable data
             const fileData = {
-                name: entry.name,
+                name: file.name,
                 relative_path: relativePath,
                 parent_path: parentPath,
-                isDirectory: entry.isDirectory(),
+                isDirectory: file.isDirectory(),
             };
-            if (entry.isDirectory()) {
+            //recurivly scan directories for more files
+            if (file.isDirectory()) {
                 fileData.children = await this.scan_files(fullPath);
             }
             result.push(fileData);
@@ -29,7 +44,7 @@ export class FileScanner {
         return result;
     }
     /**
-     * Public entry point: returns nested FileData structure
+     * Public file point: returns nested FileData structure
      */
     async get_file_data() {
         const fullDir = path.join(process.cwd(), this.page_dir);

package/dist/core/FileScanner.js.map

@@ -1 +1 @@
-{"version":3,"file":"FileScanner.js","sourceRoot":"","sources":["../../src/core/FileScanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,IAAI,MAAM,MAAM,CAAC;AAUxB,MAAM,OAAO,WAAW;IACtB,QAAQ,CAAS;IAEjB,YAAY,SAAiB;QAC3B,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;IAC5B,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,UAAU,CAAC,GAAW;QAClC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,MAAM,MAAM,GAAe,EAAE,CAAC;QAE9B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAChF,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC;YAE/E,MAAM,QAAQ,GAAa;gBACzB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,aAAa,EAAE,YAAY;gBAC3B,WAAW,EAAE,UAAU;gBACvB,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE;aACjC,CAAC;YAEF,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,QAAQ,CAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACtD,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,aAAa;QACxB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
+{"version":3,"file":"FileScanner.js","sourceRoot":"","sources":["../../src/core/FileScanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,MAAM,CAAC;AAUxB,MAAM,OAAO,WAAW;IACtB,QAAQ,CAAS;IAEjB,YAAY,SAAiB;QAC3B,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;IAC5B,CAAC;IAED;;;;;;;;;;;;OAYG;IACK,KAAK,CAAC,UAAU,CAAC,GAAW;QAClC,uDAAuD;QACvD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAe,EAAE,CAAC;QAE9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3C,MAAM,YAAY,GAAG,IAAI;iBACtB,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC;iBACjC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACvB,MAAM,UAAU,GACd,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC;YAE9D,yBAAyB;YACzB,MAAM,QAAQ,GAAa;gBACzB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,aAAa,EAAE,YAAY;gBAC3B,WAAW,EAAE,UAAU;gBACvB,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE;aAChC,CAAC;YACF,2CAA2C;YAC3C,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACvB,QAAQ,CAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACtD,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,aAAa;QACxB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/core/RouteGenerator.d.ts

@@ -8,21 +8,21 @@ interface FileNode {
 export declare class RouteGenerator {
     private topLevelImports;
     private importSet;
-    /**
-     * Converts a FileData-like tree into React Router routes
-     * @param files - Array of file/folder objects passed externally
-     * @param parentPath - Current path for recursion
-     */
+    /** Converts filenames/folders to URL-friendly paths, e.g., [id] -> :id */
+    private normalizeSegment;
+    /** Converts string to PascalCase for React component names */
+    private toPascal;
+    /** Adds import statement for codegen, avoiding duplicates */
+    private addImport;
+    /** Generates PascalCase import name, handles nested index files */
+    private getImportName;
+    private createDirectoryRoute;
+    private createFileRoute;
+    /** Converts file tree to nested RouteConfig array */
     private fileDataToRoutes;
-    /**
-     * Generates a React Router routes file as a string
-     * @param fileData - FileData-like tree
-     */
+    /** Generates a TypeScript routes file as a string */
     generateRoutesFile(fileData: FileNode[]): Promise<string>;
-    /**
-     * Generates TypeScript type definition for all route paths
-     * @param fileData - FileData-like tree
-     */
+    /** Generates a TypeScript union type for all routes */
     generateRoutesTypeDef(fileData: FileNode[]): Promise<string>;
 }
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"RouteGenerator.d.ts","sourceRoot":"","sources":["../../src/core/RouteGenerator.ts"],"names":[],"mappings":"AAMA,UAAU,QAAQ;IAChB,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,cAAc;IACzB,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,SAAS,CAA0B;IAE3C;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAgGxB;;;OAGG;IACU,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAsBtE;;;OAGG;IACU,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CA8B1E"}
+{"version":3,"file":"RouteGenerator.d.ts","sourceRoot":"","sources":["../../src/core/RouteGenerator.ts"],"names":[],"mappings":"AAMA,UAAU,QAAQ;IAChB,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,cAAc;IACzB,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,SAAS,CAA0B;IAI3C,0EAA0E;IAC1E,OAAO,CAAC,gBAAgB;IAIxB,8DAA8D;IAC9D,OAAO,CAAC,QAAQ;IAMhB,6DAA6D;IAC7D,OAAO,CAAC,SAAS;IAQjB,mEAAmE;IACnE,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,oBAAoB;IA0B5B,OAAO,CAAC,eAAe;IAmBvB,qDAAqD;IACrD,OAAO,CAAC,gBAAgB;IAcxB,qDAAqD;IACxC,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAuBtE,uDAAuD;IAC1C,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CA6B1E"}

package/dist/core/RouteGenerator.js

@@ -1,87 +1,77 @@
 export class RouteGenerator {
     topLevelImports = [];
-    importSet = new Set();
-    /**
-     * Converts a FileData-like tree into React Router routes
-     * @param files - Array of file/folder objects passed externally
-     * @param parentPath - Current path for recursion
-     */
-    fileDataToRoutes(files, parentPath = "", isChild = false) {
-        const routes = [];
-        const normalizeSegment = (name) => name.replace(/\[([^\]]+)\]/g, ":$1").toLowerCase();
-        const toPascal = (str) => str
+    importSet = new Set(); // avoids duplicate imports
+    // ---------------- Helpers ----------------
+    /** Converts filenames/folders to URL-friendly paths, e.g., [id] -> :id */
+    normalizeSegment(name) {
+        return name.replace(/\[([^\]]+)\]/g, ":$1").toLowerCase();
+    }
+    /** Converts string to PascalCase for React component names */
+    toPascal(str) {
+        return str
             .replace(/\[|\]/g, "")
             .replace(/(^\w|[-_]\w)/g, (m) => m.replace(/[-_]/, "").toUpperCase());
-        const getImportName = (file, parentPath) => {
-            const nameWithoutExt = file.name.replace(/\.[jt]sx?$/, "");
-            if (nameWithoutExt.toLowerCase() === "index" && parentPath) {
-                // Use parent folder prefix for nested index
-                const segments = parentPath.split("/").filter(Boolean);
-                return toPascal(segments.join("")) + "Index";
-            }
-            return toPascal(nameWithoutExt);
-        };
-        for (const file of files) {
-            if (file.isDirectory) {
-                const layout = file.children?.find((f) => !f.isDirectory && /^layout\.(tsx|jsx|ts|js)$/i.test(f.name));
-                const route = {
-                    path: normalizeSegment(file.name),
-                };
-                if (layout) {
-                    const importName = `${toPascal(file.name)}Layout`;
-                    const importPath = `./${layout.relative_path.replace(/^src[\/\\]/, "")}`;
-                    if (!this.importSet.has(layout.relative_path)) {
-                        this.topLevelImports.push(`import ${importName} from '${importPath}';`);
-                        this.importSet.add(layout.relative_path);
-                    }
-                    route.element = `React.createElement(${importName})`;
-                }
-                if (file.children?.length) {
-                    const children = file.children.filter((f) => !/^layout\.(tsx|jsx|ts|js)$/i.test(f.name));
-                    if (children.length) {
-                        // Pass true for isChild to make children paths relative
-                        route.children = this.fileDataToRoutes(children, route.path, true);
-                    }
-                }
-                routes.push(route);
-            }
-            else {
-                const nameWithoutExt = file.name.replace(/\.[jt]sx?$/, "");
-                const isIndex = nameWithoutExt.toLowerCase() === "index";
-                // If child, path is relative; otherwise, top-level gets full path
-                let pathSegment = isIndex ? "" : normalizeSegment(nameWithoutExt);
-                if (isChild) {
-                    // Children always use relative paths
-                    pathSegment = pathSegment;
-                }
-                else {
-                    pathSegment = parentPath
-                        ? `${parentPath}/${pathSegment}`
-                        : pathSegment;
-                }
-                const importName = getImportName(file, parentPath);
-                ;
-                const importPath = `./${file.relative_path.replace(/^src[\/\\]/, "")}`;
-                if (!this.importSet.has(file.relative_path)) {
-                    this.topLevelImports.push(`import ${importName} from '${importPath}';`);
-                    this.importSet.add(file.relative_path);
-                }
-                routes.push({
-                    path: pathSegment,
-                    element: `React.createElement(${importName})`,
-                });
+    }
+    /** Adds import statement for codegen, avoiding duplicates */
+    addImport(file, importName) {
+        if (!this.importSet.has(file.relative_path)) {
+            const importPath = `./${file.relative_path.replace(/^src[\/\\]/, "")}`;
+            this.topLevelImports.push(`import ${importName} from '${importPath}';`);
+            this.importSet.add(file.relative_path);
+        }
+    }
+    /** Generates PascalCase import name, handles nested index files */
+    getImportName(file, parentPath) {
+        const nameWithoutExt = file.name.replace(/\.[jt]sx?$/, "");
+        if (nameWithoutExt.toLowerCase() === "index" && parentPath) {
+            const segments = parentPath.split("/").filter(Boolean);
+            return this.toPascal(segments.join("")) + "Index";
+        }
+        return this.toPascal(nameWithoutExt);
+    }
+    // ---------------- Route Creation ----------------
+    createDirectoryRoute(file) {
+        const route = { path: this.normalizeSegment(file.name) };
+        // Use layout if present
+        const layout = file.children?.find((f) => !f.isDirectory && /^layout\.(tsx|jsx|ts|js)$/i.test(f.name));
+        if (layout) {
+            const importName = `${this.toPascal(file.name)}Layout`;
+            this.addImport(layout, importName);
+            route.element = `React.createElement(${importName})`;
+        }
+        // Recursively add children routes
+        if (file.children?.length) {
+            const children = file.children.filter((f) => !/^layout\.(tsx|jsx|ts|js)$/i.test(f.name));
+            if (children.length) {
+                route.children = this.fileDataToRoutes(children, route.path, true);
             }
         }
-        return routes;
+        return route;
+    }
+    createFileRoute(file, parentPath, isChild) {
+        const nameWithoutExt = file.name.replace(/\.[jt]sx?$/, "");
+        const isIndex = nameWithoutExt.toLowerCase() === "index";
+        let pathSegment = isIndex ? "" : this.normalizeSegment(nameWithoutExt);
+        if (!isChild && parentPath)
+            pathSegment = `${parentPath}/${pathSegment}`;
+        const importName = this.getImportName(file, parentPath);
+        this.addImport(file, importName);
+        return { path: pathSegment, element: `React.createElement(${importName})` };
+    }
+    // ---------------- Recursion ----------------
+    /** Converts file tree to nested RouteConfig array */
+    fileDataToRoutes(files, parentPath = "", isChild = false) {
+        return files.map((file) => file.isDirectory
+            ? this.createDirectoryRoute(file)
+            : this.createFileRoute(file, parentPath, isChild));
     }
-    /**
-     * Generates a React Router routes file as a string
-     * @param fileData - FileData-like tree
-     */
+    // ---------------- Code Generation ----------------
+    /** Generates a TypeScript routes file as a string */
     async generateRoutesFile(fileData) {
         this.topLevelImports = [];
-        this.importSet = new Set();
+        this.importSet.clear();
         const routes = this.fileDataToRoutes(fileData);
+        // Replace quotes around element strings with actual React code
         const routesString = JSON.stringify(routes, null, 2).replace(/"React\.createElement\((\w+)\)"/g, "React.createElement($1)");
         return `//* AUTO GENERATED: DO NOT EDIT
 import React from 'react';
@@ -93,10 +83,7 @@ const routes: RouteObject[] = ${routesString};
 export default routes;
 `;
     }
-    /**
-     * Generates TypeScript type definition for all route paths
-     * @param fileData - FileData-like tree
-     */
+    /** Generates a TypeScript union type for all routes */
     async generateRoutesTypeDef(fileData) {
         const routes = this.fileDataToRoutes(fileData);
         const paths = [];

package/dist/core/RouteGenerator.js.map

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

package/dist/core/index.d.ts

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/core/index.js

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

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,gDAAgD;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,gDAAgD"}

package/dist/plugin/index.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/plugin/index.js

@@ -0,0 +1,2 @@
+export { aaexFileRouter } from '../plugin/plugin.js';
+//# sourceMappingURL=index.js.map

package/dist/plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/plugin/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/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/plugin/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,CAmDtE"}

package/dist/plugin/plugin.js

@@ -0,0 +1,48 @@
+import { promises as fs } from "node: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.generateRoutesFile(fileData);
+                        const routesType = await generator.generateRoutesTypeDef(fileData);
+                        // Write routes file
+                        await fs.writeFile(outputFile, routesCode, "utf-8");
+                        await fs.writeFile("src/routeTypes.ts", routesType, "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/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/plugin/plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAO3D;;;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,kBAAkB,CAAC,QAAQ,CAAC,CAAC;wBAChE,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;wBAEnE,oBAAoB;wBACpB,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;wBACpD,MAAM,EAAE,CAAC,SAAS,CAAC,mBAAmB,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;wBAE7D,OAAO,CAAC,GAAG,CACT,8CAA8C,UAAU,EAAE,CAC3D,CAAC;oBACJ,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,OAAO,CAAC,KAAK,CACX,iDAAiD,EACjD,KAAK,CACN,CAAC;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aaex-file-router",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "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": {
@@ -16,7 +16,8 @@
 
   "exports":{
       ".": "./dist/index.js",
-      "./core": "./dist/core/index.js"
+      "./core": "./dist/core/index.js",
+      "./plugin": "./dist/plugin/index.js"
   },
   "author": "TmRAaEx",
   "license": "MIT",