@buzola/codegen 0.0.1

package/dist/conventions.d.ts

@@ -0,0 +1,53 @@
+/**
+ * File naming conventions for page-centric routing.
+ *
+ * _layout.tsx   → Layout wrapper (renders children via <Outlet />)
+ * _404.tsx      → Not-found catch-all (auto-assigned catch-all pattern within parent scope)
+ * index.tsx     → Index route (renders at parent's exact path)
+ * about.tsx     → Named page file (page ID derived from file name)
+ * (group)/      → Pathless group (no URL segment)
+ *
+ * Files prefixed with `_` are special convention files, not regular pages.
+ * Route patterns (URL paths) come exclusively from `.route()` on `createPage()`.
+ * File names only determine page IDs and layout nesting.
+ */
+export declare const ROUTE_FILE_EXTENSIONS: string[];
+export interface ParsedRouteFile {
+    /** The route segment this file contributes. */
+    segment: string;
+    /** Whether this is a layout file. */
+    isLayout: boolean;
+    /** Whether this is an index file. */
+    isIndex: boolean;
+    /** Whether this is a not-found catch-all file. */
+    isNotFound: boolean;
+    /** Whether this directory is a pathless group. */
+    isPathlessGroup: boolean;
+    /** Original file path relative to routes dir. */
+    relativePath: string;
+}
+/**
+ * Check if a file is a route file based on extension.
+ */
+export declare function isRouteFile(filePath: string): boolean;
+/**
+ * Parse a directory name for routing conventions.
+ */
+export declare function parseDirName(name: string): {
+    segment: string;
+    isPathlessGroup: boolean;
+};
+/**
+ * Parse a route file name (without extension) into routing info.
+ */
+export declare function parseFileName(nameWithoutExt: string): {
+    segment: string;
+    isLayout: boolean;
+    isIndex: boolean;
+    isNotFound: boolean;
+};
+/**
+ * Parse a route file path relative to the routes directory.
+ */
+export declare function parseRouteFile(relativePath: string): ParsedRouteFile;
+//# sourceMappingURL=conventions.d.ts.map

package/dist/conventions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conventions.d.ts","sourceRoot":"","sources":["../src/conventions.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,qBAAqB,UAAiC,CAAA;AAEnE,MAAM,WAAW,eAAe;IAC/B,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAA;IACf,qCAAqC;IACrC,QAAQ,EAAE,OAAO,CAAA;IACjB,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAA;IAChB,kDAAkD;IAClD,UAAU,EAAE,OAAO,CAAA;IACnB,kDAAkD;IAClD,eAAe,EAAE,OAAO,CAAA;IACxB,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAOxF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG;IACtD,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;CACnB,CAcA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,eAAe,CAoCpE"}

package/dist/conventions.js

@@ -0,0 +1,82 @@
+import * as path from 'node:path';
+/**
+ * File naming conventions for page-centric routing.
+ *
+ * _layout.tsx   → Layout wrapper (renders children via <Outlet />)
+ * _404.tsx      → Not-found catch-all (auto-assigned catch-all pattern within parent scope)
+ * index.tsx     → Index route (renders at parent's exact path)
+ * about.tsx     → Named page file (page ID derived from file name)
+ * (group)/      → Pathless group (no URL segment)
+ *
+ * Files prefixed with `_` are special convention files, not regular pages.
+ * Route patterns (URL paths) come exclusively from `.route()` on `createPage()`.
+ * File names only determine page IDs and layout nesting.
+ */
+export const ROUTE_FILE_EXTENSIONS = ['.tsx', '.jsx', '.ts', '.js'];
+/**
+ * Check if a file is a route file based on extension.
+ */
+export function isRouteFile(filePath) {
+    return ROUTE_FILE_EXTENSIONS.some(ext => filePath.endsWith(ext));
+}
+/**
+ * Parse a directory name for routing conventions.
+ */
+export function parseDirName(name) {
+    // Pathless group: (auth)
+    if (name.startsWith('(') && name.endsWith(')')) {
+        return { segment: '', isPathlessGroup: true };
+    }
+    return { segment: name, isPathlessGroup: false };
+}
+/**
+ * Parse a route file name (without extension) into routing info.
+ */
+export function parseFileName(nameWithoutExt) {
+    if (nameWithoutExt === '_layout') {
+        return { segment: '', isLayout: true, isIndex: false, isNotFound: false };
+    }
+    if (nameWithoutExt === '_404') {
+        return { segment: '', isLayout: false, isIndex: false, isNotFound: true };
+    }
+    if (nameWithoutExt === 'index') {
+        return { segment: '', isLayout: false, isIndex: true, isNotFound: false };
+    }
+    return { segment: nameWithoutExt, isLayout: false, isIndex: false, isNotFound: false };
+}
+/**
+ * Parse a route file path relative to the routes directory.
+ */
+export function parseRouteFile(relativePath) {
+    const ext = path.extname(relativePath);
+    const withoutExt = relativePath.slice(0, -ext.length);
+    const parts = withoutExt.split(path.sep);
+    const fileName = parts.pop();
+    const dirs = parts;
+    const fileInfo = parseFileName(fileName);
+    // Build segment from directory path + file
+    const segments = [];
+    let isPathlessGroup = false;
+    for (const dir of dirs) {
+        const dirInfo = parseDirName(dir);
+        if (dirInfo.isPathlessGroup) {
+            isPathlessGroup = true;
+        }
+        else {
+            segments.push(dirInfo.segment);
+        }
+    }
+    if (fileInfo.segment) {
+        segments.push(fileInfo.segment);
+    }
+    const segment = segments.length > 0 ? segments.join('/') : '';
+    return {
+        segment,
+        isLayout: fileInfo.isLayout,
+        isIndex: fileInfo.isIndex,
+        isNotFound: fileInfo.isNotFound,
+        isPathlessGroup,
+        relativePath,
+    };
+}
+//# sourceMappingURL=conventions.js.map

package/dist/conventions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conventions.js","sourceRoot":"","sources":["../src/conventions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC;;;;;;;;;;;;GAYG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;AAiBnE;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC3C,OAAO,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAA;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACxC,yBAAyB;IACzB,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAChD,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,CAAA;IAC9C,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,CAAA;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,cAAsB;IAMnD,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;IAC1E,CAAC;IAED,IAAI,cAAc,KAAK,MAAM,EAAE,CAAC;QAC/B,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAA;IAC1E,CAAC;IAED,IAAI,cAAc,KAAK,OAAO,EAAE,CAAC;QAChC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;IAC1E,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;AACvF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,YAAoB;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;IACtC,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACrD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,EAAG,CAAA;IAC7B,MAAM,IAAI,GAAG,KAAK,CAAA;IAElB,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAA;IAExC,2CAA2C;IAC3C,MAAM,QAAQ,GAAa,EAAE,CAAA;IAC7B,IAAI,eAAe,GAAG,KAAK,CAAA;IAE3B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA;QACjC,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAC7B,eAAe,GAAG,IAAI,CAAA;QACvB,CAAC;aAAM,CAAC;YACP,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAC/B,CAAC;IACF,CAAC;IAED,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IAChC,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAE7D,OAAO;QACN,OAAO;QACP,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,eAAe;QACf,YAAY;KACZ,CAAA;AACF,CAAC"}

package/dist/generate.d.ts

@@ -0,0 +1,28 @@
+import type { ModuleLoader } from './generator/page-extractor.js';
+export interface GenerateOptions {
+    /** Absolute path to the routes directory. */
+    routesDir: string;
+    /** Absolute path to the output file. */
+    outputPath: string;
+    /** Parameter names that should be persistent across navigations. */
+    persistentParams?: string[];
+    /** Custom module loader. Defaults to native `import()`. */
+    moduleLoader?: ModuleLoader;
+    /** When true, return `false` instead of throwing if `routesDir` is missing. */
+    optional?: boolean;
+}
+/**
+ * Generate the `buzola.gen.ts` route module from a routes directory.
+ *
+ * Works standalone (no Vite required) — uses native `import()` as the
+ * default module loader. Pass a custom `moduleLoader` to integrate with
+ * Vite's `ssrLoadModule` or other bundlers.
+ *
+ * Note: The default module loader uses native `import()`, which can load
+ * `.ts`/`.tsx` files with Bun but not with Node.js. For Node.js, provide
+ * a custom `moduleLoader` (e.g. via Vite's `ssrLoadModule`).
+ *
+ * @returns `true` if the output file was written (content changed), `false` otherwise.
+ */
+export declare function generate(options: GenerateOptions): Promise<boolean>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAIjE,MAAM,WAAW,eAAe;IAC/B,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAA;IACjB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAA;IAClB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,2DAA2D;IAC3D,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAazE"}

package/dist/generate.js

@@ -0,0 +1,46 @@
+import * as fs from 'node:fs';
+import { generateRouteModule } from './generator/codegen.js';
+import { scanRouteFiles } from './generator/scanner.js';
+import { buildFileRouteTree } from './generator/tree-builder.js';
+/**
+ * Generate the `buzola.gen.ts` route module from a routes directory.
+ *
+ * Works standalone (no Vite required) — uses native `import()` as the
+ * default module loader. Pass a custom `moduleLoader` to integrate with
+ * Vite's `ssrLoadModule` or other bundlers.
+ *
+ * Note: The default module loader uses native `import()`, which can load
+ * `.ts`/`.tsx` files with Bun but not with Node.js. For Node.js, provide
+ * a custom `moduleLoader` (e.g. via Vite's `ssrLoadModule`).
+ *
+ * @returns `true` if the output file was written (content changed), `false` otherwise.
+ */
+export async function generate(options) {
+    const { routesDir, outputPath, persistentParams, moduleLoader = defaultModuleLoader, optional = false } = options;
+    if (!fs.existsSync(routesDir)) {
+        if (optional)
+            return false;
+        throw new Error(`Routes directory does not exist: ${routesDir}`);
+    }
+    const files = scanRouteFiles(routesDir);
+    const tree = await buildFileRouteTree(files, moduleLoader);
+    const code = generateRouteModule({ tree, routesDir, outputPath, persistentParams });
+    return writeIfChanged(outputPath, code);
+}
+async function defaultModuleLoader(absolutePath) {
+    try {
+        return await import(absolutePath);
+    }
+    catch (error) {
+        throw new Error(`Failed to load module "${absolutePath}". The default module loader uses native import() which `
+            + `supports .ts/.tsx files with Bun but not Node.js. For Node.js, provide a custom moduleLoader option.`, { cause: error });
+    }
+}
+function writeIfChanged(filePath, content) {
+    if (fs.existsSync(filePath) && fs.readFileSync(filePath, 'utf-8') === content) {
+        return false;
+    }
+    fs.writeFileSync(filePath, content, 'utf-8');
+    return true;
+}
+//# sourceMappingURL=generate.js.map

package/dist/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAehE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAwB;IACtD,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,GAAG,mBAAmB,EAAE,QAAQ,GAAG,KAAK,EAAE,GAAG,OAAO,CAAA;IAEjH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,IAAI,QAAQ;YAAE,OAAO,KAAK,CAAA;QAC1B,MAAM,IAAI,KAAK,CAAC,oCAAoC,SAAS,EAAE,CAAC,CAAA;IACjE,CAAC;IAED,MAAM,KAAK,GAAG,cAAc,CAAC,SAAS,CAAC,CAAA;IACvC,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAA;IAC1D,MAAM,IAAI,GAAG,mBAAmB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC,CAAA;IAEnF,OAAO,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;AACxC,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,YAAoB;IACtD,IAAI,CAAC;QACJ,OAAO,MAAM,MAAM,CAAC,YAAY,CAAC,CAAA;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACd,0BAA0B,YAAY,0DAA0D;cAC7F,sGAAsG,EACzG,EAAE,KAAK,EAAE,KAAK,EAAE,CAChB,CAAA;IACF,CAAC;AACF,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB,EAAE,OAAe;IACxD,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,OAAO,EAAE,CAAC;QAC/E,OAAO,KAAK,CAAA;IACb,CAAC;IAED,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IAC5C,OAAO,IAAI,CAAA;AACZ,CAAC"}

package/dist/generator/codegen.d.ts

@@ -0,0 +1,19 @@
+import type { FileRouteNode } from './tree-builder.js';
+export interface CodegenOptions {
+    /** The route tree from file scanning. */
+    tree: FileRouteNode[];
+    /** Absolute path to the routes directory. */
+    routesDir: string;
+    /** Absolute path to the output file. */
+    outputPath: string;
+    /** Parameter names that should be persistent across navigations. */
+    persistentParams?: string[];
+}
+/**
+ * Generate the buzola.gen.ts file with:
+ * 1. Module augmentation for BuzolaPageMap (type safety)
+ * 2. Page registry (page ID → route pattern)
+ * 3. Route tree construction code
+ */
+export declare function generateRouteModule(options: CodegenOptions): string;
+//# sourceMappingURL=codegen.d.ts.map

package/dist/generator/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../src/generator/codegen.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEtD,MAAM,WAAW,cAAc;IAC9B,yCAAyC;IACzC,IAAI,EAAE,aAAa,EAAE,CAAA;IACrB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAA;IACjB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAA;IAClB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC3B;AASD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAgFnE"}

package/dist/generator/codegen.js

@@ -0,0 +1,162 @@
+import * as path from 'node:path';
+/**
+ * Quote a property key when it isn't a valid JS identifier (e.g. hyphenated).
+ */
+function formatPropertyKey(name) {
+    return /^[A-Za-z_$][\w$]*$/.test(name) ? name : `'${name}'`;
+}
+/**
+ * Generate the buzola.gen.ts file with:
+ * 1. Module augmentation for BuzolaPageMap (type safety)
+ * 2. Page registry (page ID → route pattern)
+ * 3. Route tree construction code
+ */
+export function generateRouteModule(options) {
+    const { tree, outputPath } = options;
+    const outputDir = path.dirname(outputPath);
+    let importCounter = 0;
+    const lines = [];
+    lines.push('// This file is auto-generated by @buzola/codegen. Do not edit.');
+    lines.push('/* eslint-disable */');
+    lines.push('');
+    lines.push(`import { lazy, type ComponentType } from 'react';`);
+    lines.push(`import { buildRouteTree } from '@buzola/router';`);
+    lines.push(`import type { RouteConfig } from '@buzola/router';`);
+    lines.push('');
+    const imports = [];
+    const importsByKey = new Map();
+    collectImports(tree, outputDir, imports, importsByKey, () => importCounter++);
+    for (const imp of imports) {
+        if (imp.isLazy) {
+            lines.push(`const ${imp.varName} = () => import('${imp.filePath}').then(m => ({ default: m.${imp.exportName}.component })) as Promise<{ default: ComponentType }>;`);
+        }
+        else {
+            if (imp.exportName !== 'default') {
+                lines.push(`import { ${imp.exportName} as ${imp.varName} } from '${imp.filePath}';`);
+            }
+            else {
+                lines.push(`import ${imp.varName} from '${imp.filePath}';`);
+            }
+        }
+    }
+    lines.push('');
+    const pages = collectPages(tree);
+    lines.push('// Module augmentation for type-safe page-centric routing');
+    lines.push(`declare module '@buzola/router' {`);
+    lines.push('  interface BuzolaPageMap {');
+    for (const page of pages) {
+        if (page.params.length === 0) {
+            lines.push(`    '${page.pageId}': {};`);
+        }
+        else {
+            const paramEntries = page.params.map(p => {
+                const type = p.array ? 'string[]' : 'string';
+                const key = formatPropertyKey(p.name);
+                return p.optional ? `${key}?: ${type}` : `${key}: ${type}`;
+            }).join('; ');
+            lines.push(`    '${page.pageId}': { ${paramEntries} };`);
+        }
+    }
+    lines.push('  }');
+    if (options.persistentParams && options.persistentParams.length > 0) {
+        lines.push('  interface BuzolaPersistentParams {');
+        for (const param of options.persistentParams) {
+            lines.push(`    ${formatPropertyKey(param)}: true;`);
+        }
+        lines.push('  }');
+    }
+    lines.push('}');
+    lines.push('');
+    lines.push('// Page registry — page ID → route pattern');
+    lines.push('export const pageRegistry: Record<string, string> = {');
+    for (const page of pages) {
+        lines.push(`  '${page.pageId}': '${page.routePattern}',`);
+    }
+    lines.push('};');
+    lines.push('');
+    lines.push('const routeConfigs: RouteConfig[] = [');
+    generateTreeConfig(tree, lines, importsByKey, 1);
+    lines.push('];');
+    lines.push('');
+    lines.push('export const routes = buildRouteTree(routeConfigs);');
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Collect page info from the file route tree for codegen.
+ */
+function collectPages(nodes) {
+    const result = [];
+    for (const node of nodes) {
+        if (node.filePath && !node.isLayout && !node.isNotFound) {
+            if (node.pageExports) {
+                for (const exp of node.pageExports) {
+                    result.push({
+                        pageId: exp.pageId,
+                        routePattern: exp.routePattern,
+                        params: exp.params,
+                    });
+                }
+            }
+        }
+        if (node.children.length > 0) {
+            result.push(...collectPages(node.children));
+        }
+    }
+    return result;
+}
+function importKey(filePath, exportName) {
+    return `${filePath}::${exportName ?? 'default'}`;
+}
+function collectImports(nodes, outputDir, imports, importsByKey, nextId) {
+    for (const node of nodes) {
+        if (node.filePath) {
+            const key = importKey(node.filePath, node.exportName);
+            if (!importsByKey.has(key)) {
+                const relativePath = path.relative(outputDir, node.filePath).replaceAll('\\', '/');
+                const importPath = relativePath.startsWith('.') ? relativePath : `./${relativePath}`;
+                const cleanPath = importPath.replace(/\.(tsx?|jsx?)$/, '');
+                const varName = `Route${nextId()}`;
+                const isLazy = !node.isLayout;
+                const exportName = node.exportName ?? 'default';
+                imports.push({ varName, filePath: cleanPath, isLazy, exportName });
+                importsByKey.set(key, { varName, isLazy });
+            }
+        }
+        collectImports(node.children, outputDir, imports, importsByKey, nextId);
+    }
+}
+function generateTreeConfig(nodes, lines, importsByKey, indent) {
+    const pad = '  '.repeat(indent);
+    for (const node of nodes) {
+        const imp = node.filePath ? importsByKey.get(importKey(node.filePath, node.exportName)) : undefined;
+        lines.push(`${pad}{`);
+        lines.push(`${pad}  path: '${node.segment ? `/${node.segment}` : '/'}',`);
+        // Emit matchPath when page has a custom route pattern that differs from file-hierarchy position
+        if (node.pageExports && node.pageExports.length > 0 && node.pageExports[0].routePattern !== node.fullPath) {
+            lines.push(`${pad}  matchPath: '${node.pageExports[0].routePattern}',`);
+        }
+        if (imp) {
+            if (imp.isLazy) {
+                lines.push(`${pad}  component: lazy(${imp.varName}),`);
+                lines.push(`${pad}  preload: ${imp.varName},`);
+            }
+            else {
+                lines.push(`${pad}  component: ${imp.varName},`);
+            }
+        }
+        if (node.isLayout)
+            lines.push(`${pad}  isLayout: true,`);
+        if (node.isIndex)
+            lines.push(`${pad}  isIndex: true,`);
+        if (node.isPathlessGroup)
+            lines.push(`${pad}  isPathlessGroup: true,`);
+        if (node.children.length > 0) {
+            lines.push(`${pad}  children: [`);
+            generateTreeConfig(node.children, lines, importsByKey, indent + 2);
+            lines.push(`${pad}  ],`);
+        }
+        lines.push(`${pad}},`);
+    }
+}
+//# sourceMappingURL=codegen.js.map

package/dist/generator/codegen.js.map

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

package/dist/generator/page-extractor.d.ts

@@ -0,0 +1,21 @@
+export interface ExtractedPage {
+    /** Export name (e.g., "detail", "list"). "default" for default exports. */
+    exportName: string;
+    /** Explicit route pattern from .route('...'), if present. */
+    route?: string;
+    /** Whether this is a default export. */
+    isDefault: boolean;
+    /** Extracted param info from .params(z.object({...})). */
+    params: ExtractedParam[];
+}
+export interface ExtractedParam {
+    name: string;
+    optional: boolean;
+    array: boolean;
+}
+export type ModuleLoader = (absolutePath: string) => Promise<Record<string, unknown>>;
+/**
+ * Extract createPage() metadata by loading the module and inspecting exports.
+ */
+export declare function extractPages(absolutePath: string, loadModule: ModuleLoader): Promise<ExtractedPage[]>;
+//# sourceMappingURL=page-extractor.d.ts.map

package/dist/generator/page-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-extractor.d.ts","sourceRoot":"","sources":["../../src/generator/page-extractor.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC7B,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAA;IAClB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wCAAwC;IACxC,SAAS,EAAE,OAAO,CAAA;IAClB,0DAA0D;IAC1D,MAAM,EAAE,cAAc,EAAE,CAAA;CACxB;AAED,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,CAAA;IACjB,KAAK,EAAE,OAAO,CAAA;CACd;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAUrF;;GAEG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAiB3G"}

package/dist/generator/page-extractor.js

@@ -0,0 +1,23 @@
+function isPageDefinition(value) {
+    return value != null && typeof value === 'object' && '__buzolaPage' in value && value.__buzolaPage === true;
+}
+/**
+ * Extract createPage() metadata by loading the module and inspecting exports.
+ */
+export async function extractPages(absolutePath, loadModule) {
+    const mod = await loadModule(absolutePath);
+    const pages = [];
+    for (const [key, value] of Object.entries(mod)) {
+        if (!isPageDefinition(value))
+            continue;
+        const exportName = key === 'default' ? 'default' : key;
+        pages.push({
+            exportName,
+            isDefault: key === 'default',
+            route: value.route,
+            params: value.paramsMeta ?? [],
+        });
+    }
+    return pages;
+}
+//# sourceMappingURL=page-extractor.js.map

package/dist/generator/page-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-extractor.js","sourceRoot":"","sources":["../../src/generator/page-extractor.ts"],"names":[],"mappings":"AAmBA,SAAS,gBAAgB,CAAC,KAAc;IAKvC,OAAO,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,cAAc,IAAI,KAAK,IAAK,KAAa,CAAC,YAAY,KAAK,IAAI,CAAA;AACrH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,YAAoB,EAAE,UAAwB;IAChF,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,YAAY,CAAC,CAAA;IAC1C,MAAM,KAAK,GAAoB,EAAE,CAAA;IAEjC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC;YAAE,SAAQ;QAEtC,MAAM,UAAU,GAAG,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAA;QACtD,KAAK,CAAC,IAAI,CAAC;YACV,UAAU;YACV,SAAS,EAAE,GAAG,KAAK,SAAS;YAC5B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE;SAC9B,CAAC,CAAA;IACH,CAAC;IAED,OAAO,KAAK,CAAA;AACb,CAAC"}

package/dist/generator/scanner.d.ts

@@ -0,0 +1,11 @@
+export interface ScannedFile {
+    /** Absolute path to the file. */
+    absolutePath: string;
+    /** Path relative to the routes directory. */
+    relativePath: string;
+}
+/**
+ * Scan a directory recursively for route files.
+ */
+export declare function scanRouteFiles(routesDir: string): ScannedFile[];
+//# sourceMappingURL=scanner.d.ts.map

package/dist/generator/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/generator/scanner.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC3B,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAA;IACpB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CA8B/D"}

package/dist/generator/scanner.js

@@ -0,0 +1,34 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { isRouteFile } from '../conventions.js';
+/**
+ * Scan a directory recursively for route files.
+ */
+export function scanRouteFiles(routesDir) {
+    const files = [];
+    function scan(dir) {
+        if (!fs.existsSync(dir))
+            return;
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                // Skip node_modules and hidden directories
+                if (entry.name.startsWith('.') || entry.name === 'node_modules')
+                    continue;
+                scan(fullPath);
+            }
+            else if (entry.isFile() && isRouteFile(entry.name)) {
+                files.push({
+                    absolutePath: fullPath,
+                    relativePath: path.relative(routesDir, fullPath),
+                });
+            }
+        }
+    }
+    scan(routesDir);
+    // Sort for deterministic output
+    files.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
+    return files;
+}
+//# sourceMappingURL=scanner.js.map

package/dist/generator/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../../src/generator/scanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAS/C;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC/C,MAAM,KAAK,GAAkB,EAAE,CAAA;IAE/B,SAAS,IAAI,CAAC,GAAW;QACxB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAM;QAE/B,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;QAE5D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;YAE3C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACzB,2CAA2C;gBAC3C,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;oBAAE,SAAQ;gBACzE,IAAI,CAAC,QAAQ,CAAC,CAAA;YACf,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtD,KAAK,CAAC,IAAI,CAAC;oBACV,YAAY,EAAE,QAAQ;oBACtB,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC;iBAChD,CAAC,CAAA;YACH,CAAC;QACF,CAAC;IACF,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,CAAA;IAEf,gCAAgC;IAChC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAA;IAElE,OAAO,KAAK,CAAA;AACb,CAAC"}

package/dist/generator/tree-builder.d.ts

@@ -0,0 +1,54 @@
+import type { ModuleLoader } from './page-extractor.js';
+import type { ScannedFile } from './scanner.js';
+/**
+ * Page export info attached to a file route node.
+ */
+export interface PageExportInfo {
+    /** Page ID (e.g., "project/detail"). */
+    pageId: string;
+    /** Export name (e.g., "default", "detail"). */
+    exportName: string;
+    /** Route pattern (e.g., "/project/:id"). */
+    routePattern: string;
+    /** Param info extracted from the page schema. */
+    params: {
+        name: string;
+        optional: boolean;
+        array: boolean;
+    }[];
+}
+/**
+ * A node in the route tree (before compilation into RouteNode).
+ */
+export interface FileRouteNode {
+    /** Route path segment (from file name, or derived from .route() pattern). */
+    segment: string;
+    /** Full path from root. */
+    fullPath: string;
+    /** Absolute file path to the component. */
+    filePath?: string;
+    /** Which export to use from the file ("default" or a named export). */
+    exportName?: string;
+    /** Whether this is a layout. */
+    isLayout: boolean;
+    /** Whether this is an index route. */
+    isIndex: boolean;
+    /** Whether this is a not-found catch-all. */
+    isNotFound: boolean;
+    /** Whether this is a pathless group. */
+    isPathlessGroup: boolean;
+    /** Page exports discovered in this file. */
+    pageExports?: PageExportInfo[];
+    /** Children nodes. */
+    children: FileRouteNode[];
+}
+/**
+ * Build a route tree from scanned files.
+ * Loads each module via moduleLoader to extract createPage() metadata.
+ *
+ * Two-phase approach:
+ * 1. Extract flat route entries from all files.
+ * 2. Build the tree using route-pattern prefix matching (not file hierarchy).
+ */
+export declare function buildFileRouteTree(files: ScannedFile[], moduleLoader: ModuleLoader): Promise<FileRouteNode[]>;
+//# sourceMappingURL=tree-builder.d.ts.map

package/dist/generator/tree-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-builder.d.ts","sourceRoot":"","sources":["../../src/generator/tree-builder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE/C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAA;IAClB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAA;IACpB,iDAAiD;IACjD,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;CAC7D;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAA;IACf,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gCAAgC;IAChC,QAAQ,EAAE,OAAO,CAAA;IACjB,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAA;IAChB,6CAA6C;IAC7C,UAAU,EAAE,OAAO,CAAA;IACnB,wCAAwC;IACxC,eAAe,EAAE,OAAO,CAAA;IACxB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,cAAc,EAAE,CAAA;IAC9B,sBAAsB;IACtB,QAAQ,EAAE,aAAa,EAAE,CAAA;CACzB;AAuBD;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAGnH"}