@bromscandium/vite-plugin 1.0.0

package/dist/scanner.js

@@ -0,0 +1,205 @@
+/**
+ * File system scanner for discovering page routes.
+ * @module
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+const VALID_EXTENSIONS = ['.tsx', '.jsx', '.ts', '.js'];
+const IGNORED_FILES = ['_app', '_document', '_error', '404', '500'];
+const IGNORED_PREFIXES = ['_', '.'];
+const layoutsMap = new Map();
+/**
+ * Scans a pages directory and returns all discovered routes.
+ * Supports Next.js-style file-based routing conventions including:
+ * - `page.tsx` files for page components
+ * - `layout.tsx` files for layout wrappers
+ * - `[param]` for dynamic route segments
+ * - `[...slug]` for catch-all routes
+ * - `(group)` folders for route grouping without URL segments
+ *
+ * @param pagesDir - The directory to scan for pages
+ * @returns An array of scanned route information, sorted by priority
+ *
+ * @example
+ * ```ts
+ * const routes = scanPages('./src/pages');
+ * // Returns routes sorted: static > dynamic > catch-all
+ * ```
+ */
+export function scanPages(pagesDir) {
+    if (!fs.existsSync(pagesDir)) {
+        return [];
+    }
+    layoutsMap.clear();
+    scanForLayouts(pagesDir, '');
+    const routes = [];
+    scanDirectory(pagesDir, '', '', routes);
+    for (const route of routes) {
+        const layout = findLayoutForRoute(route.fsPath);
+        if (layout) {
+            route.layoutPath = layout;
+        }
+    }
+    return routes.sort((a, b) => {
+        if (a.isCatchAll !== b.isCatchAll) {
+            return a.isCatchAll ? 1 : -1;
+        }
+        if (a.isDynamic !== b.isDynamic) {
+            return a.isDynamic ? 1 : -1;
+        }
+        const aSegments = a.routePath.split('/').filter(Boolean).length;
+        const bSegments = b.routePath.split('/').filter(Boolean).length;
+        if (aSegments !== bSegments) {
+            return aSegments - bSegments;
+        }
+        return a.routePath.localeCompare(b.routePath);
+    });
+}
+function scanForLayouts(dir, fsRelativePath) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const name = entry.name;
+        if (IGNORED_PREFIXES.some(prefix => name.startsWith(prefix))) {
+            continue;
+        }
+        const fullPath = path.join(dir, name);
+        if (entry.isDirectory()) {
+            const newFsPath = fsRelativePath ? `${fsRelativePath}/${name}` : name;
+            scanForLayouts(fullPath, newFsPath);
+        }
+        else if (entry.isFile()) {
+            const ext = path.extname(name);
+            if (!VALID_EXTENSIONS.includes(ext))
+                continue;
+            const baseName = path.basename(name, ext);
+            if (baseName === 'layout' || baseName === '_layout') {
+                const fsPath = '/' + fsRelativePath.replace(/\\/g, '/');
+                layoutsMap.set(fsPath.replace(/\/+/g, '/') || '/', fullPath.replace(/\\/g, '/'));
+            }
+        }
+    }
+}
+function findLayoutForRoute(fsPath) {
+    let current = fsPath;
+    while (current) {
+        const layout = layoutsMap.get(current);
+        if (layout)
+            return layout;
+        const lastSlash = current.lastIndexOf('/');
+        if (lastSlash <= 0)
+            break;
+        current = current.substring(0, lastSlash);
+    }
+    return layoutsMap.get('/');
+}
+function isRouteGroup(name) {
+    return name.startsWith('(') && name.endsWith(')');
+}
+function scanDirectory(dir, routeRelativePath, fsRelativePath, routes) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const name = entry.name;
+        if (IGNORED_PREFIXES.some(prefix => name.startsWith(prefix))) {
+            continue;
+        }
+        const fullPath = path.join(dir, name);
+        if (entry.isDirectory()) {
+            const routeSegment = isRouteGroup(name) ? '' : name;
+            const newRoutePath = routeSegment
+                ? (routeRelativePath ? `${routeRelativePath}/${routeSegment}` : routeSegment)
+                : routeRelativePath;
+            const newFsPath = fsRelativePath ? `${fsRelativePath}/${name}` : name;
+            scanDirectory(fullPath, newRoutePath, newFsPath, routes);
+        }
+        else if (entry.isFile()) {
+            const ext = path.extname(name);
+            if (!VALID_EXTENSIONS.includes(ext)) {
+                continue;
+            }
+            const baseName = path.basename(name, ext);
+            if (IGNORED_FILES.includes(baseName)) {
+                continue;
+            }
+            if (baseName === '_layout' || baseName === 'layout') {
+                continue;
+            }
+            const route = parseRoute(fullPath, routeRelativePath, fsRelativePath, baseName);
+            if (route) {
+                routes.push(route);
+            }
+        }
+    }
+}
+function parseRoute(filePath, routeRelativePath, fsRelativePath, baseName) {
+    const isPage = baseName === 'page';
+    const isLayout = baseName === '_layout' || baseName === 'layout';
+    let routePath = '/' + routeRelativePath.replace(/\\/g, '/');
+    if (!isPage) {
+        routePath = routePath === '/'
+            ? `/${baseName}`
+            : `${routePath}/${baseName}`;
+    }
+    const fsPath = '/' + fsRelativePath.replace(/\\/g, '/');
+    const params = [];
+    let isDynamic = false;
+    let isCatchAll = false;
+    routePath = routePath.replace(/\[\.\.\.(\w+)]/g, (_, paramName) => {
+        params.push(paramName);
+        isDynamic = true;
+        isCatchAll = true;
+        return `:${paramName}*`;
+    });
+    routePath = routePath.replace(/\[(\w+)]/g, (_, paramName) => {
+        params.push(paramName);
+        isDynamic = true;
+        return `:${paramName}`;
+    });
+    routePath = routePath.replace(/\/+/g, '/');
+    if (routePath.length > 1 && routePath.endsWith('/')) {
+        routePath = routePath.slice(0, -1);
+    }
+    const segments = routePath.split('/').filter(Boolean);
+    return {
+        filePath: filePath.replace(/\\/g, '/'),
+        routePath,
+        isDynamic,
+        params,
+        isPage,
+        isLayout,
+        isCatchAll,
+        segments,
+        fsPath: fsPath.replace(/\/+/g, '/') || '/',
+    };
+}
+/**
+ * Watches a pages directory for changes and invokes a callback when files change.
+ *
+ * @param pagesDir - The directory to watch
+ * @param onChange - Callback invoked when a page file changes
+ * @returns A function to stop watching
+ *
+ * @example
+ * ```ts
+ * const stop = watchPages('./src/pages', () => {
+ *   console.log('Pages changed, regenerating routes...');
+ * });
+ *
+ * // Later: stop watching
+ * stop();
+ * ```
+ */
+export function watchPages(pagesDir, onChange) {
+    if (!fs.existsSync(pagesDir)) {
+        fs.mkdirSync(pagesDir, { recursive: true });
+    }
+    const watcher = fs.watch(pagesDir, { recursive: true }, (_eventType, filename) => {
+        if (!filename)
+            return;
+        const ext = path.extname(filename);
+        if (VALID_EXTENSIONS.includes(ext)) {
+            onChange();
+        }
+    });
+    return () => watcher.close();
+}
+//# sourceMappingURL=scanner.js.map

package/dist/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AA4B7B,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AACxD,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AACpE,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAEpC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;AAE7C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,UAAU,CAAC,KAAK,EAAE,CAAC;IAEnB,cAAc,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAE7B,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,aAAa,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;IAExC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC1B,IAAI,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC;YAClC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,CAAC;QAED,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS,EAAE,CAAC;YAChC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC;QAED,MAAM,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QAChE,MAAM,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QAChE,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,SAAS,GAAG,SAAS,CAAC;QAC/B,CAAC;QAED,OAAO,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CAAC,GAAW,EAAE,cAAsB;IACzD,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QAExB,IAAI,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YAC7D,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAEtC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACtE,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACtC,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,SAAS;YAE9C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC1C,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACpD,MAAM,MAAM,GAAG,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBACxD,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAc;IACxC,IAAI,OAAO,GAAG,MAAM,CAAC;IAErB,OAAO,OAAO,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAE1B,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,SAAS,IAAI,CAAC;YAAE,MAAM;QAC1B,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,aAAa,CACpB,GAAW,EACX,iBAAyB,EACzB,cAAsB,EACtB,MAAsB;IAEtB,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QAExB,IAAI,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YAC7D,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAEtC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACpD,MAAM,YAAY,GAAG,YAAY;gBAC/B,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,iBAAiB,IAAI,YAAY,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;gBAC7E,CAAC,CAAC,iBAAiB,CAAC;YACtB,MAAM,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACtE,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAC3D,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpC,SAAS;YACX,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAE1C,IAAI,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACrC,SAAS;YACX,CAAC;YAED,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACpD,SAAS;YACX,CAAC;YAED,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;YAChF,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CACjB,QAAgB,EAChB,iBAAyB,EACzB,cAAsB,EACtB,QAAgB;IAEhB,MAAM,MAAM,GAAG,QAAQ,KAAK,MAAM,CAAC;IACnC,MAAM,QAAQ,GAAG,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,QAAQ,CAAC;IAEjE,IAAI,SAAS,GAAG,GAAG,GAAG,iBAAiB,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAE5D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,SAAS,GAAG,SAAS,KAAK,GAAG;YAC3B,CAAC,CAAC,IAAI,QAAQ,EAAE;YAChB,CAAC,CAAC,GAAG,SAAS,IAAI,QAAQ,EAAE,CAAC;IACjC,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAExD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,UAAU,GAAG,KAAK,CAAC;IAEvB,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE;QAChE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACvB,SAAS,GAAG,IAAI,CAAC;QACjB,UAAU,GAAG,IAAI,CAAC;QAClB,OAAO,IAAI,SAAS,GAAG,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE;QAC1D,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACvB,SAAS,GAAG,IAAI,CAAC;QACjB,OAAO,IAAI,SAAS,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3C,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACpD,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEtD,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;QACtC,SAAS;QACT,SAAS;QACT,MAAM;QACN,MAAM;QACN,QAAQ;QACR,UAAU;QACV,QAAQ;QACR,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,GAAG;KAC3C,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,UAAU,CACxB,QAAgB,EAChB,QAAoB;IAEpB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,EAAE;QAC/E,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEtB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACnC,QAAQ,EAAE,CAAC;QACb,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;AAC/B,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@bromscandium/vite-plugin",
+  "version": "1.0.0",
+  "description": "Vite plugin for BromiumJS file-based routing",
+  "author": "bromscandium",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bromscandium/bromiumjs.git",
+    "directory": "packages/vite-plugin"
+  },
+  "homepage": "https://github.com/bromscandium/bromiumjs#readme",
+  "bugs": {
+    "url": "https://github.com/bromscandium/bromiumjs/issues"
+  },
+  "keywords": ["bromium", "bromiumjs", "vite", "vite-plugin", "file-based-routing"],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "peerDependencies": {
+    "vite": "^5.0.0 || ^6.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.9",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1"
+  }
+}

package/src/codegen.ts

@@ -0,0 +1,127 @@
+/**
+ * Route code generation utilities.
+ * @module
+ */
+
+import {ScannedRoute} from './scanner.js';
+import * as path from 'path';
+
+/**
+ * Options for route code generation.
+ */
+export interface CodegenOptions {
+  /** The pages directory path */
+  pagesDir: string;
+  /** The output file path for generated routes */
+  outputPath: string;
+  /** Optional base path for routes */
+  base?: string;
+}
+
+/**
+ * Generates TypeScript code for route configuration from scanned routes.
+ * The output exports a `routes` array compatible with the Bromium router.
+ *
+ * @param routes - Array of scanned route information
+ * @param options - Code generation options
+ * @returns Generated TypeScript source code
+ *
+ * @example
+ * ```ts
+ * const routes = scanPages('./src/pages');
+ * const code = generateRouteConfig(routes, {
+ *   pagesDir: './src/pages',
+ *   outputPath: './src/routes.generated.ts',
+ * });
+ * fs.writeFileSync('./src/routes.generated.ts', code);
+ * ```
+ */
+export function generateRouteConfig(
+  routes: ScannedRoute[],
+  options: CodegenOptions
+): string {
+  const { outputPath } = options;
+
+  const outputDir = path.dirname(outputPath);
+
+  const routeObjects: string[] = [];
+
+  routes.forEach((route) => {
+    let relativePath = path.relative(outputDir, route.filePath);
+    relativePath = relativePath.replace(/\\/g, '/');
+
+    relativePath = relativePath.replace(/\.(tsx?|jsx?)$/, '');
+
+    if (!relativePath.startsWith('.') && !relativePath.startsWith('/')) {
+      relativePath = './' + relativePath;
+    }
+
+    let layoutImport = '';
+    if (route.layoutPath) {
+      let layoutRelativePath = path.relative(outputDir, route.layoutPath);
+      layoutRelativePath = layoutRelativePath.replace(/\\/g, '/');
+      layoutRelativePath = layoutRelativePath.replace(/\.(tsx?|jsx?)$/, '');
+      if (!layoutRelativePath.startsWith('.') && !layoutRelativePath.startsWith('/')) {
+        layoutRelativePath = './' + layoutRelativePath;
+      }
+      layoutImport = `,\n    layout: () => import('${layoutRelativePath}')`;
+    }
+
+    const routePath = route.routePath;
+
+    const routeObj = `  {
+    path: '${routePath}',
+    component: () => import('${relativePath}')${layoutImport},
+  }`;
+
+    routeObjects.push(routeObj);
+  });
+
+  return `// Auto-generated by @bromscandium/vite-plugin
+// Do not edit manually - changes will be overwritten
+
+import type { Route } from '@bromscandium/router';
+
+export const routes: Route[] = [
+${routeObjects.join(',\n')}
+];
+
+export default routes;
+`;
+}
+
+/**
+ * Generates TypeScript type definitions for routes.
+ * Provides type-safe route paths and parameter types.
+ *
+ * @param routes - Array of scanned route information
+ * @returns Generated TypeScript declaration code
+ *
+ * @example
+ * ```ts
+ * const routes = scanPages('./src/pages');
+ * const types = generateRouteTypes(routes);
+ * fs.writeFileSync('./src/routes.generated.d.ts', types);
+ * ```
+ */
+export function generateRouteTypes(routes: ScannedRoute[]): string {
+  const routePaths = routes.map(r => `  | '${r.routePath}'`).join('\n');
+
+  const paramTypes = routes
+    .filter(r => r.params.length > 0)
+    .map(r => {
+      const params = r.params.map(p => `    ${p}: string;`).join('\n');
+      return `  '${r.routePath}': {\n${params}\n  };`;
+    })
+    .join('\n');
+
+  return `// Auto-generated route types
+
+export type RoutePath =
+${routePaths || "  | '/'"}
+
+export interface RouteParams {
+${paramTypes || "  '/': Record<string, never>;"}
+}
+`;
+}

package/src/index.ts

@@ -0,0 +1,9 @@
+// Vite plugin exports
+
+import { bromiumPlugin } from './plugin.js';
+
+export { bromiumPlugin, type BromiumPluginOptions } from './plugin.js';
+export { scanPages, watchPages, type ScannedRoute } from './scanner.js';
+export { generateRouteConfig, generateRouteTypes, type CodegenOptions } from './codegen.js';
+
+export default bromiumPlugin;

package/src/plugin.ts

@@ -0,0 +1,151 @@
+/**
+ * Main Vite plugin for BromiumJS file-based routing.
+ * @module
+ */
+
+import type { Plugin, ResolvedConfig, ViteDevServer } from 'vite';
+import * as path from 'path';
+import * as fs from 'fs';
+import { scanPages, watchPages } from './scanner.js';
+import { generateRouteConfig, generateRouteTypes } from './codegen.js';
+
+/**
+ * Configuration options for the Bromium Vite plugin.
+ */
+export interface BromiumPluginOptions {
+  /**
+   * Directory containing page components.
+   * @default 'src/pages'
+   */
+  pagesDir?: string;
+
+  /**
+   * Output path for generated routes file.
+   * @default 'src/routes.generated.ts'
+   */
+  routesOutput?: string;
+
+  /**
+   * Base path for all routes (e.g., '/app/').
+   * @default ''
+   */
+  base?: string;
+
+  /**
+   * Generate TypeScript type definitions for routes.
+   * @default true
+   */
+  generateTypes?: boolean;
+}
+
+/**
+ * Creates the Bromium Vite plugin for file-based routing.
+ * Automatically scans the pages directory and generates route configuration.
+ *
+ * @param options - Plugin configuration options
+ * @returns A Vite plugin instance
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { defineConfig } from 'vite';
+ * import { bromiumPlugin } from '@bromscandium/vite-plugin';
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     bromiumPlugin({
+ *       pagesDir: 'src/pages',
+ *       base: '/app/',
+ *       generateTypes: true,
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+export function bromiumPlugin(options: BromiumPluginOptions = {}): Plugin {
+  const {
+    pagesDir = 'src/pages',
+    routesOutput = 'src/routes.generated.ts',
+    base = '',
+    generateTypes = true,
+  } = options;
+
+  let root: string;
+  let fullPagesDir: string;
+  let fullRoutesOutput: string;
+  let stopWatcher: (() => void) | null = null;
+
+  async function generateRoutes(): Promise<void> {
+    if (!fs.existsSync(fullPagesDir)) {
+      fs.mkdirSync(fullPagesDir, { recursive: true });
+    }
+
+    const routes = scanPages(fullPagesDir);
+
+    const code = generateRouteConfig(routes, {
+      pagesDir: fullPagesDir,
+      outputPath: fullRoutesOutput,
+      base,
+    });
+
+    const outputDir = path.dirname(fullRoutesOutput);
+    if (!fs.existsSync(outputDir)) {
+      fs.mkdirSync(outputDir, { recursive: true });
+    }
+
+    fs.writeFileSync(fullRoutesOutput, code, 'utf-8');
+
+    if (generateTypes) {
+      const typesPath = fullRoutesOutput.replace(/\.ts$/, '.d.ts');
+      const typesCode = generateRouteTypes(routes);
+      fs.writeFileSync(typesPath, typesCode, 'utf-8');
+    }
+
+    console.log(`[bromium] Generated routes from ${routes.length} pages`);
+  }
+
+  return {
+    name: 'bromium-plugin',
+
+    configResolved(config: ResolvedConfig) {
+      root = config.root;
+      fullPagesDir = path.resolve(root, pagesDir);
+      fullRoutesOutput = path.resolve(root, routesOutput);
+    },
+
+    async buildStart() {
+      await generateRoutes();
+    },
+
+    configureServer(server: ViteDevServer) {
+      stopWatcher = watchPages(fullPagesDir, async () => {
+        await generateRoutes();
+        const module = server.moduleGraph.getModuleById(fullRoutesOutput);
+        if (module) {
+          server.moduleGraph.invalidateModule(module);
+          server.ws.send({
+            type: 'full-reload',
+            path: '*',
+          });
+        }
+      });
+    },
+
+    buildEnd() {
+      if (stopWatcher) {
+        stopWatcher();
+        stopWatcher = null;
+      }
+    },
+
+    transform(_code: string, id: string) {
+      if (!id.endsWith('.tsx') && !id.endsWith('.jsx')) {
+        return null;
+      }
+
+      return null;
+    },
+  };
+}
+
+export default bromiumPlugin;