@bromscandium/vite-plugin 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bromscandium
+
+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,71 @@
+# @bromscandium/vite-plugin
+
+Vite plugin for BromiumJS with file-based routing and HMR support.
+
+## Installation
+
+```bash
+npm install @bromscandium/vite-plugin -D
+```
+
+## Usage
+
+```ts
+// vite.config.ts
+import { defineConfig } from 'vite';
+import bromium from '@bromscandium/vite-plugin';
+
+export default defineConfig({
+  plugins: [
+    bromium({
+      pagesDir: 'src/pages',
+      routesOutput: 'src/routes.generated.ts',
+      generateTypes: true,
+    })
+  ],
+  esbuild: {
+    jsx: 'automatic',
+    jsxImportSource: 'bromium'
+  }
+});
+```
+
+## File-based Routing
+
+```
+src/pages/
+├── page.tsx              → /
+├── about.tsx             → /about
+├── users/
+│   ├── page.tsx          → /users
+│   ├── [id].tsx          → /users/:id
+│   └── [id]/
+│       └── settings.tsx  → /users/:id/settings
+├── posts/
+│   └── [...slug].tsx     → /posts/:slug* (catch-all)
+└── (auth)/               → Route group (no URL segment)
+    ├── login.tsx         → /login
+    └── register.tsx      → /register
+```
+
+| Pattern | Example | Description |
+|---------|---------|-------------|
+| `page.tsx` | `/` | Index route |
+| `about.tsx` | `/about` | Static route |
+| `[id].tsx` | `/users/:id` | Dynamic segment |
+| `[...slug].tsx` | `/posts/:slug*` | Catch-all route |
+| `(folder)/` | - | Route group |
+| `layout.tsx` | - | Layout component |
+
+## Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `pagesDir` | `'src/pages'` | Pages directory |
+| `routesOutput` | `'src/routes.generated.ts'` | Output file |
+| `base` | `''` | Base path for routes |
+| `generateTypes` | `true` | Generate TypeScript types |
+
+## License
+
+MIT

package/dist/codegen.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Route code generation utilities.
+ * @module
+ */
+import { ScannedRoute } from './scanner.js';
+/**
+ * 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 declare function generateRouteConfig(routes: ScannedRoute[], options: CodegenOptions): string;
+/**
+ * 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 declare function generateRouteTypes(routes: ScannedRoute[]): string;
+//# sourceMappingURL=codegen.d.ts.map

package/dist/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAC,YAAY,EAAC,MAAM,cAAc,CAAC;AAG1C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EAAE,EACtB,OAAO,EAAE,cAAc,GACtB,MAAM,CAiDR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAoBjE"}

package/dist/codegen.js

@@ -0,0 +1,97 @@
+/**
+ * Route code generation utilities.
+ * @module
+ */
+import * as path from 'path';
+/**
+ * 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, options) {
+    const { outputPath } = options;
+    const outputDir = path.dirname(outputPath);
+    const routeObjects = [];
+    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) {
+    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>;"}
+}
+`;
+}
+//# sourceMappingURL=codegen.js.map

package/dist/codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.js","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAc7B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAsB,EACtB,OAAuB;IAEvB,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAE/B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAE3C,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACvB,IAAI,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC5D,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAEhD,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;QAE1D,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACnE,YAAY,GAAG,IAAI,GAAG,YAAY,CAAC;QACrC,CAAC;QAED,IAAI,YAAY,GAAG,EAAE,CAAC;QACtB,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,IAAI,kBAAkB,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;YACpE,kBAAkB,GAAG,kBAAkB,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC5D,kBAAkB,GAAG,kBAAkB,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;YACtE,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/E,kBAAkB,GAAG,IAAI,GAAG,kBAAkB,CAAC;YACjD,CAAC;YACD,YAAY,GAAG,gCAAgC,kBAAkB,IAAI,CAAC;QACxE,CAAC;QAED,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QAElC,MAAM,QAAQ,GAAG;aACR,SAAS;+BACS,YAAY,KAAK,YAAY;IACxD,CAAC;QAED,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,OAAO;;;;;;EAMP,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC;;;;CAIzB,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAsB;IACvD,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEtE,MAAM,UAAU,GAAG,MAAM;SACtB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;SAChC,GAAG,CAAC,CAAC,CAAC,EAAE;QACP,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjE,OAAO,MAAM,CAAC,CAAC,SAAS,SAAS,MAAM,QAAQ,CAAC;IAClD,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;;;EAGP,UAAU,IAAI,SAAS;;;EAGvB,UAAU,IAAI,+BAA+B;;CAE9C,CAAC;AACF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+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;
+//# 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":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAE5F,eAAe,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+// Vite plugin exports
+import { bromiumPlugin } from './plugin.js';
+export { bromiumPlugin } from './plugin.js';
+export { scanPages, watchPages } from './scanner.js';
+export { generateRouteConfig, generateRouteTypes } from './codegen.js';
+export default bromiumPlugin;
+//# 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,sBAAsB;AAEtB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,aAAa,EAA6B,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAqB,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAuB,MAAM,cAAc,CAAC;AAE5F,eAAe,aAAa,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Main Vite plugin for BromiumJS file-based routing.
+ * @module
+ */
+import type { Plugin } from 'vite';
+/**
+ * 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 declare function bromiumPlugin(options?: BromiumPluginOptions): Plugin;
+export default bromiumPlugin;
+//# 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;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiC,MAAM,MAAM,CAAC;AAMlE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAoFxE;AAED,eAAe,aAAa,CAAC"}

package/dist/plugin.js

@@ -0,0 +1,99 @@
+/**
+ * Main Vite plugin for BromiumJS file-based routing.
+ * @module
+ */
+import * as path from 'path';
+import * as fs from 'fs';
+import { scanPages, watchPages } from './scanner.js';
+import { generateRouteConfig, generateRouteTypes } from './codegen.js';
+/**
+ * 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 = {}) {
+    const { pagesDir = 'src/pages', routesOutput = 'src/routes.generated.ts', base = '', generateTypes = true, } = options;
+    let root;
+    let fullPagesDir;
+    let fullRoutesOutput;
+    let stopWatcher = null;
+    async function generateRoutes() {
+        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) {
+            root = config.root;
+            fullPagesDir = path.resolve(root, pagesDir);
+            fullRoutesOutput = path.resolve(root, routesOutput);
+        },
+        async buildStart() {
+            await generateRoutes();
+        },
+        configureServer(server) {
+            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, id) {
+            if (!id.endsWith('.tsx') && !id.endsWith('.jsx')) {
+                return null;
+            }
+            return null;
+        },
+    };
+}
+export default bromiumPlugin;
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/scanner.d.ts

@@ -0,0 +1,67 @@
+/**
+ * File system scanner for discovering page routes.
+ * @module
+ */
+/**
+ * Information about a scanned route from the file system.
+ */
+export interface ScannedRoute {
+    /** Absolute path to the page file */
+    filePath: string;
+    /** URL path for the route (e.g., '/users/:id') */
+    routePath: string;
+    /** Whether the route contains dynamic segments */
+    isDynamic: boolean;
+    /** Names of dynamic parameters in the route */
+    params: string[];
+    /** Whether this is a page component (page.tsx) */
+    isPage: boolean;
+    /** Whether this is a layout component */
+    isLayout: boolean;
+    /** Whether this is a catch-all route ([...slug]) */
+    isCatchAll: boolean;
+    /** URL path segments */
+    segments: string[];
+    /** Path to the layout file if one exists for this route */
+    layoutPath?: string;
+    /** File system relative path (includes route groups) */
+    fsPath: string;
+}
+/**
+ * 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 declare function scanPages(pagesDir: string): ScannedRoute[];
+/**
+ * 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 declare function watchPages(pagesDir: string, onChange: () => void): () => void;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,SAAS,EAAE,OAAO,CAAC;IACnB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kDAAkD;IAClD,MAAM,EAAE,OAAO,CAAC;IAChB,yCAAyC;IACzC,QAAQ,EAAE,OAAO,CAAC;IAClB,oDAAoD;IACpD,UAAU,EAAE,OAAO,CAAC;IACpB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;CAChB;AAQD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CAoC1D;AAyJD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,IAAI,GACnB,MAAM,IAAI,CAeZ"}