@teardown/navigation-metro 2.0.69 → 2.0.71

package/dist/generator/route-generator.d.ts

@@ -34,4 +34,21 @@ export declare function generateLinkingFileContent(routes: RouteNode[], prefixes
  * Generates the register.d.ts file content
  */
 export declare function generateRegisterFileContent(): string;
+export interface RouteTreeEntry {
+    importName: string;
+    importPath: string;
+    path: string;
+    isLayout: boolean;
+    layoutType: string;
+    parentLayoutImportName: string | null;
+}
+/**
+ * Builds route tree entries for import generation
+ */
+export declare function buildRouteTreeEntries(routes: RouteNode[], routesDir: string, generatedDir: string): RouteTreeEntry[];
+/**
+ * Generates the routeTree.generated.ts file content
+ * Outputs a hierarchical navigator structure for nested navigation
+ */
+export declare function generateRouteTreeFileContent(routes: RouteNode[], routesDir: string, generatedDir: string): string;
 //# sourceMappingURL=route-generator.d.ts.map

package/dist/generator/route-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route-generator.d.ts","sourceRoot":"","sources":["../../src/generator/route-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAiB,KAAK,eAAe,EAAE,KAAK,SAAS,EAAuB,MAAM,yBAAyB,CAAC;AAEnH,MAAM,WAAW,eAAe;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CA8BpE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,eAAe,EAAE,CAwBhF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAgDrE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAkC1F;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAepD"}
+{"version":3,"file":"route-generator.d.ts","sourceRoot":"","sources":["../../src/generator/route-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAiB,KAAK,eAAe,EAAE,KAAK,SAAS,EAAuB,MAAM,yBAAyB,CAAC;AAEnH,MAAM,WAAW,eAAe;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAiCpE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,eAAe,EAAE,CAwBhF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAgDrE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAkC1F;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAepD;AA4ED,MAAM,WAAW,cAAc;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED;;GAEG;AAEH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,cAAc,EAAE,CAqDpH;AA+JD;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CA4EjH"}

package/dist/generator/route-generator.js

@@ -9,6 +9,8 @@ exports.buildRouteParamsInterface = buildRouteParamsInterface;
 exports.generateRoutesFileContent = generateRoutesFileContent;
 exports.generateLinkingFileContent = generateLinkingFileContent;
 exports.generateRegisterFileContent = generateRegisterFileContent;
+exports.buildRouteTreeEntries = buildRouteTreeEntries;
+exports.generateRouteTreeFileContent = generateRouteTreeFileContent;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const file_scanner_1 = require("../scanner/file-scanner");
@@ -33,6 +35,8 @@ function generateAllRouteFiles(options) {
     (0, node_fs_1.writeFileSync)((0, node_path_1.join)(generatedDir, "register.d.ts"), registerContent);
     const manifestContent = generateManifestContent(routes);
     (0, node_fs_1.writeFileSync)((0, node_path_1.join)(generatedDir, "manifest.json"), JSON.stringify(manifestContent, null, 2));
+    const routeTreeContent = generateRouteTreeFileContent(routes, routesDir, generatedDir);
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(generatedDir, "routeTree.generated.ts"), routeTreeContent);
     if (verbose) {
         const count = countRoutes(routes);
         console.log(`[teardown/navigation] Generated ${count} routes`);
@@ -177,3 +181,275 @@ function generateManifestContent(routes) {
 function countRoutes(routes) {
     return (0, file_scanner_1.flattenRoutes)(routes).filter((r) => !r.isLayout).length;
 }
+/**
+ * Converts a relative path to a valid import variable name
+ */
+function pathToImportName(relativePath) {
+    // Remove extension
+    const withoutExt = relativePath.replace(/\.(ts|tsx)$/, "");
+    // Convert to valid identifier
+    return withoutExt
+        .replace(/\//g, "_") // Replace slashes with underscores
+        .replace(/\[\.\.\.([^\]]+)\]/g, "CatchAll_$1") // [...slug] -> CatchAll_slug
+        .replace(/\[\[([^\]]+)\]\]/g, "Optional_$1") // [[id]] -> Optional_id
+        .replace(/\[([^\]]+)\]/g, "Param_$1") // [userId] -> Param_userId
+        .replace(/[^a-zA-Z0-9_]/g, "_") // Replace other special chars
+        .replace(/^_+/, "") // Remove leading underscores
+        .replace(/_+$/g, "") // Remove trailing underscores
+        .replace(/_+/g, "_"); // Collapse multiple underscores
+}
+/**
+ * Generates the relative import path from generated dir to route file
+ */
+function getImportPath(routesDir, generatedDir, routeRelativePath) {
+    const routeAbsolutePath = (0, node_path_1.join)(routesDir, routeRelativePath);
+    const generatedAbsoluteDir = generatedDir;
+    // Get relative path from generated dir to route file
+    let importPath = (0, node_path_1.relative)(generatedAbsoluteDir, routeAbsolutePath);
+    // Remove extension for import
+    importPath = importPath.replace(/\.(ts|tsx)$/, "");
+    // Ensure it starts with ./ or ../
+    if (!importPath.startsWith(".")) {
+        importPath = `./${importPath}`;
+    }
+    return importPath;
+}
+/**
+ * Builds route tree entries for import generation
+ */
+// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: route tree traversal and layout assignment
+function buildRouteTreeEntries(routes, routesDir, generatedDir) {
+    const allRoutes = (0, file_scanner_1.flattenRoutes)(routes);
+    const entries = [];
+    // Create a map to find layouts by directory
+    const layoutsByDir = new Map();
+    for (const route of allRoutes) {
+        const importName = pathToImportName(route.relativePath);
+        const importPath = getImportPath(routesDir, generatedDir, route.relativePath);
+        const entry = {
+            importName,
+            importPath,
+            path: route.path,
+            isLayout: route.isLayout,
+            layoutType: route.layoutType,
+            parentLayoutImportName: null,
+        };
+        entries.push(entry);
+        if (route.isLayout) {
+            // Store layout by its directory
+            const layoutDir = (0, node_path_1.dirname)(route.relativePath);
+            layoutsByDir.set(layoutDir === "." ? "" : layoutDir, entry);
+        }
+    }
+    // Second pass: assign parent layouts
+    for (const entry of entries) {
+        if (!entry.isLayout) {
+            // Find the relative path's directory
+            const routePath = allRoutes.find((r) => pathToImportName(r.relativePath) === entry.importName);
+            if (routePath) {
+                const routeDir = (0, node_path_1.dirname)(routePath.relativePath);
+                // Look for layout in same directory or parent directories
+                let currentDir = routeDir === "." ? "" : routeDir;
+                while (currentDir !== undefined) {
+                    const layout = layoutsByDir.get(currentDir);
+                    if (layout) {
+                        entry.parentLayoutImportName = layout.importName;
+                        break;
+                    }
+                    if (currentDir === "")
+                        break;
+                    currentDir = (0, node_path_1.dirname)(currentDir);
+                    if (currentDir === ".")
+                        currentDir = "";
+                }
+            }
+        }
+    }
+    return entries;
+}
+/**
+ * Builds a hierarchical navigator structure from route nodes
+ */
+function buildNavigatorHierarchy(routes, routesDir, generatedDir) {
+    const allImports = [];
+    // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: builds nested navigator hierarchy
+    function processNode(nodes, parentName) {
+        // Find layout in this group
+        const layoutNode = nodes.find((n) => n.isLayout);
+        // Default to stack if no layout or layout type is "none"
+        const layoutType = layoutNode?.layoutType && layoutNode.layoutType !== "none" ? layoutNode.layoutType : "stack";
+        const layoutImportName = layoutNode ? pathToImportName(layoutNode.relativePath) : null;
+        if (layoutNode) {
+            allImports.push({
+                name: pathToImportName(layoutNode.relativePath),
+                path: getImportPath(routesDir, generatedDir, layoutNode.relativePath),
+            });
+        }
+        const navigatorInfo = {
+            name: parentName,
+            type: layoutType,
+            layoutImportName,
+            screens: [],
+            nestedNavigators: [],
+        };
+        // Process children
+        for (const node of nodes) {
+            if (node.isLayout)
+                continue;
+            const importName = pathToImportName(node.relativePath);
+            const importPath = getImportPath(routesDir, generatedDir, node.relativePath);
+            allImports.push({ name: importName, path: importPath });
+            // Check if this node has children with a layout (nested navigator)
+            const childLayout = node.children.find((c) => c.isLayout);
+            if (childLayout) {
+                // This is a nested navigator
+                const nestedNav = processNode(node.children, importName);
+                navigatorInfo.nestedNavigators.push(nestedNav);
+            }
+            else if (node.children.length > 0) {
+                // Has children but no layout - process as screens in current navigator
+                navigatorInfo.screens.push({
+                    name: node.name.split("/").pop() || node.name,
+                    importName,
+                    path: node.path,
+                });
+                // Recursively add children as screens
+                const childScreens = collectScreens(node.children, routesDir, generatedDir, allImports);
+                navigatorInfo.screens.push(...childScreens);
+            }
+            else {
+                // Regular screen
+                navigatorInfo.screens.push({
+                    name: node.name.split("/").pop() || node.name,
+                    importName,
+                    path: node.path,
+                });
+            }
+        }
+        return navigatorInfo;
+    }
+    function collectScreens(nodes, rDir, gDir, imports) {
+        const screens = [];
+        for (const node of nodes) {
+            if (node.isLayout)
+                continue;
+            const importName = pathToImportName(node.relativePath);
+            const importPath = getImportPath(rDir, gDir, node.relativePath);
+            imports.push({ name: importName, path: importPath });
+            screens.push({
+                name: node.name.split("/").pop() || node.name,
+                importName,
+                path: node.path,
+            });
+            if (node.children.length > 0) {
+                screens.push(...collectScreens(node.children, rDir, gDir, imports));
+            }
+        }
+        return screens;
+    }
+    const rootNavigator = processNode(routes, "_root");
+    return { rootNavigator, allImports };
+}
+/**
+ * Generates the navigator tree as TypeScript code
+ */
+function generateNavigatorCode(nav, indent) {
+    const lines = [];
+    lines.push(`${indent}{`);
+    lines.push(`${indent}\ttype: "${nav.type}",`);
+    if (nav.layoutImportName) {
+        lines.push(`${indent}\tlayout: ${nav.layoutImportName},`);
+    }
+    // Screens
+    lines.push(`${indent}\tscreens: {`);
+    for (const screen of nav.screens) {
+        lines.push(`${indent}\t\t"${screen.name}": {`);
+        lines.push(`${indent}\t\t\tscreen: ${screen.importName},`);
+        lines.push(`${indent}\t\t\tpath: "${screen.path}",`);
+        lines.push(`${indent}\t\t},`);
+    }
+    lines.push(`${indent}\t},`);
+    // Nested navigators
+    if (nav.nestedNavigators.length > 0) {
+        lines.push(`${indent}\tnavigators: {`);
+        for (const nestedNav of nav.nestedNavigators) {
+            lines.push(`${indent}\t\t"${nestedNav.name}":`);
+            const nestedLines = generateNavigatorCode(nestedNav, `${indent}\t\t`);
+            lines.push(...nestedLines.map((l) => l.replace(/^/, "")));
+            lines[lines.length - 1] += ",";
+        }
+        lines.push(`${indent}\t},`);
+    }
+    lines.push(`${indent}}`);
+    return lines;
+}
+/**
+ * Generates the routeTree.generated.ts file content
+ * Outputs a hierarchical navigator structure for nested navigation
+ */
+function generateRouteTreeFileContent(routes, routesDir, generatedDir) {
+    const { rootNavigator, allImports } = buildNavigatorHierarchy(routes, routesDir, generatedDir);
+    const lines = [
+        "/* eslint-disable */",
+        "// @ts-nocheck",
+        "",
+        "// Auto-generated by @teardown/navigation",
+        "// Do not edit this file directly",
+        `// Generated at: ${new Date().toISOString()}`,
+        "",
+        'import type { NavigatorNode } from "@teardown/navigation";',
+        "",
+    ];
+    // Generate unique imports
+    const uniqueImports = new Map();
+    for (const imp of allImports) {
+        if (!uniqueImports.has(imp.name)) {
+            uniqueImports.set(imp.name, imp.path);
+        }
+    }
+    for (const [name, path] of uniqueImports) {
+        lines.push(`import ${name} from "${path}";`);
+    }
+    lines.push("");
+    // Generate the hierarchical routeTree
+    lines.push("export const routeTree: NavigatorNode =");
+    const treeLines = generateNavigatorCode(rootNavigator, "");
+    lines.push(...treeLines);
+    lines[lines.length - 1] += ";";
+    lines.push("");
+    // Also export flat screens for backwards compatibility
+    const entries = buildRouteTreeEntries(routes, routesDir, generatedDir);
+    const screenEntries = entries.filter((e) => !e.isLayout);
+    lines.push("// Flat screens export for backwards compatibility");
+    lines.push("export const screens = {");
+    for (const entry of screenEntries) {
+        lines.push(`\t"${entry.path}": ${entry.importName},`);
+    }
+    lines.push("} as const;");
+    lines.push("");
+    // Export layouts
+    const layoutEntries = entries.filter((e) => e.isLayout);
+    lines.push("export const layouts = {");
+    for (const entry of layoutEntries) {
+        const layoutDir = (0, node_path_1.dirname)(entry.importPath.replace(/^\.\//, "").replace(/^\.\.\//, ""));
+        const layoutKey = layoutDir === "." ? "_root" : layoutDir.replace(/\//g, "_");
+        lines.push(`\t"${layoutKey}": ${entry.importName},`);
+    }
+    lines.push("} as const;");
+    lines.push("");
+    // Export types
+    lines.push("export type Screens = typeof screens;");
+    lines.push("export type Layouts = typeof layouts;");
+    lines.push("export type RouteTreeType = typeof routeTree;");
+    lines.push("");
+    // Export route paths array
+    lines.push("export const routePaths = [");
+    for (const entry of screenEntries) {
+        lines.push(`\t"${entry.path}",`);
+    }
+    lines.push("] as const;");
+    lines.push("");
+    lines.push("export type RoutePath = (typeof routePaths)[number];");
+    lines.push("");
+    return lines.join("\n");
+}

package/dist/index.d.ts

@@ -26,6 +26,11 @@ export interface TeardownNavigationOptions {
      * @default false
      */
     verbose?: boolean;
+    /**
+     * Auto-populate new route files with template content
+     * @default true
+     */
+    autoTemplate?: boolean;
 }
 /**
  * Metro configuration type (simplified)
@@ -76,6 +81,7 @@ export type { GenerateOptions, RouteParamEntry } from "./generator/route-generat
 export { generateAllRouteFiles } from "./generator/route-generator";
 export type { ParamDefinition, RouteNode, ScanError, ScanResult } from "./scanner/file-scanner";
 export { buildUrlPath, extractParams, filePathToScreenName, flattenRoutes, scanRoutesDirectory, } from "./scanner/file-scanner";
+export { extractParamsFromPath, fileNameToScreenName, generateLayoutTemplate, generateRouteTemplate, generateScreenTemplate, getTemplateType, isFileEmpty, screenNameToTitle, } from "./templates/route-templates";
 export type { ValidationError } from "./validator/route-validator";
 export { validateRoutes } from "./validator/route-validator";
 export type { WatcherOptions } from "./watcher/file-watcher";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmCH;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACzC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE;QACV,cAAc,CAAC,EAAE,CAChB,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,KACnB;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC;QAC/C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACvB,CAAC;IACF,WAAW,CAAC,EAAE;QACb,4BAA4B,CAAC,EAAE,OAAO,CAAC;QACvC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACvB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,yBAA8B,GAAG,WAAW,CAqEhH;AAED,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,EACN,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,mBAAmB,GACnB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmCH;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACzC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE;QACV,cAAc,CAAC,EAAE,CAChB,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,KACnB;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC;QAC/C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACvB,CAAC;IACF,WAAW,CAAC,EAAE;QACb,4BAA4B,CAAC,EAAE,OAAO,CAAC;QACvC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACvB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,yBAA8B,GAAG,WAAW,CAsEhH;AAED,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,EACN,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,mBAAmB,GACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACN,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EACf,WAAW,EACX,iBAAiB,GACjB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -4,7 +4,7 @@
  * Metro plugin for type-safe file-based navigation
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.stopRouteWatcher = exports.startRouteWatcher = exports.isWatcherRunning = exports.validateRoutes = exports.scanRoutesDirectory = exports.flattenRoutes = exports.filePathToScreenName = exports.extractParams = exports.buildUrlPath = exports.generateAllRouteFiles = void 0;
+exports.stopRouteWatcher = exports.startRouteWatcher = exports.isWatcherRunning = exports.validateRoutes = exports.screenNameToTitle = exports.isFileEmpty = exports.getTemplateType = exports.generateScreenTemplate = exports.generateRouteTemplate = exports.generateLayoutTemplate = exports.fileNameToScreenName = exports.extractParamsFromPath = exports.scanRoutesDirectory = exports.flattenRoutes = exports.filePathToScreenName = exports.extractParams = exports.buildUrlPath = exports.generateAllRouteFiles = void 0;
 exports.withTeardownNavigation = withTeardownNavigation;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
@@ -62,7 +62,7 @@ function readSlugFromConfig(projectRoot) {
  * ```
  */
 function withTeardownNavigation(config, options = {}) {
-    const { routesDir = "./src/routes", generatedDir = "./.teardown", verbose = false } = options;
+    const { routesDir = "./src/routes", generatedDir = "./.teardown", verbose = false, autoTemplate = true } = options;
     const projectRoot = config.projectRoot ?? process.cwd();
     const absoluteRoutesDir = (0, node_path_1.resolve)(projectRoot, routesDir);
     const absoluteGeneratedDir = (0, node_path_1.resolve)(projectRoot, generatedDir);
@@ -99,6 +99,7 @@ function withTeardownNavigation(config, options = {}) {
             generatedDir: absoluteGeneratedDir,
             prefixes,
             verbose,
+            autoTemplate,
             onRegenerate: () => {
                 if (verbose) {
                     console.log("[teardown/navigation] Routes regenerated");
@@ -134,6 +135,15 @@ Object.defineProperty(exports, "extractParams", { enumerable: true, get: functio
 Object.defineProperty(exports, "filePathToScreenName", { enumerable: true, get: function () { return file_scanner_1.filePathToScreenName; } });
 Object.defineProperty(exports, "flattenRoutes", { enumerable: true, get: function () { return file_scanner_1.flattenRoutes; } });
 Object.defineProperty(exports, "scanRoutesDirectory", { enumerable: true, get: function () { return file_scanner_1.scanRoutesDirectory; } });
+var route_templates_1 = require("./templates/route-templates");
+Object.defineProperty(exports, "extractParamsFromPath", { enumerable: true, get: function () { return route_templates_1.extractParamsFromPath; } });
+Object.defineProperty(exports, "fileNameToScreenName", { enumerable: true, get: function () { return route_templates_1.fileNameToScreenName; } });
+Object.defineProperty(exports, "generateLayoutTemplate", { enumerable: true, get: function () { return route_templates_1.generateLayoutTemplate; } });
+Object.defineProperty(exports, "generateRouteTemplate", { enumerable: true, get: function () { return route_templates_1.generateRouteTemplate; } });
+Object.defineProperty(exports, "generateScreenTemplate", { enumerable: true, get: function () { return route_templates_1.generateScreenTemplate; } });
+Object.defineProperty(exports, "getTemplateType", { enumerable: true, get: function () { return route_templates_1.getTemplateType; } });
+Object.defineProperty(exports, "isFileEmpty", { enumerable: true, get: function () { return route_templates_1.isFileEmpty; } });
+Object.defineProperty(exports, "screenNameToTitle", { enumerable: true, get: function () { return route_templates_1.screenNameToTitle; } });
 var route_validator_1 = require("./validator/route-validator");
 Object.defineProperty(exports, "validateRoutes", { enumerable: true, get: function () { return route_validator_1.validateRoutes; } });
 var file_watcher_2 = require("./watcher/file-watcher");

package/dist/templates/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Template module exports for @teardown/navigation-metro
+ */
+export { extractParamsFromPath, fileNameToScreenName, generateLayoutTemplate, generateRouteTemplate, generateScreenTemplate, getTemplateType, isFileEmpty, screenNameToTitle, } from "./route-templates";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACN,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EACf,WAAW,EACX,iBAAiB,GACjB,MAAM,mBAAmB,CAAC"}

package/dist/templates/index.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Template module exports for @teardown/navigation-metro
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.screenNameToTitle = exports.isFileEmpty = exports.getTemplateType = exports.generateScreenTemplate = exports.generateRouteTemplate = exports.generateLayoutTemplate = exports.fileNameToScreenName = exports.extractParamsFromPath = void 0;
+var route_templates_1 = require("./route-templates");
+Object.defineProperty(exports, "extractParamsFromPath", { enumerable: true, get: function () { return route_templates_1.extractParamsFromPath; } });
+Object.defineProperty(exports, "fileNameToScreenName", { enumerable: true, get: function () { return route_templates_1.fileNameToScreenName; } });
+Object.defineProperty(exports, "generateLayoutTemplate", { enumerable: true, get: function () { return route_templates_1.generateLayoutTemplate; } });
+Object.defineProperty(exports, "generateRouteTemplate", { enumerable: true, get: function () { return route_templates_1.generateRouteTemplate; } });
+Object.defineProperty(exports, "generateScreenTemplate", { enumerable: true, get: function () { return route_templates_1.generateScreenTemplate; } });
+Object.defineProperty(exports, "getTemplateType", { enumerable: true, get: function () { return route_templates_1.getTemplateType; } });
+Object.defineProperty(exports, "isFileEmpty", { enumerable: true, get: function () { return route_templates_1.isFileEmpty; } });
+Object.defineProperty(exports, "screenNameToTitle", { enumerable: true, get: function () { return route_templates_1.screenNameToTitle; } });

package/dist/templates/route-templates.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Route templates for @teardown/navigation-metro
+ * Generates template content for new route files
+ */
+import type { ParamDefinition } from "../scanner/file-scanner";
+/**
+ * Checks if a file is empty or has minimal content (less than 10 bytes)
+ */
+export declare function isFileEmpty(filePath: string): boolean;
+/**
+ * Converts a filename to a PascalCase screen name
+ * e.g., "user-profile" -> "UserProfile", "[userId]" -> "UserId"
+ */
+export declare function fileNameToScreenName(fileName: string): string;
+/**
+ * Converts a PascalCase name to a human-readable title
+ * e.g., "UserProfile" -> "User Profile"
+ */
+export declare function screenNameToTitle(screenName: string): string;
+/**
+ * Generates the template content for a screen file
+ */
+export declare function generateScreenTemplate(routeName: string, params?: ParamDefinition[]): string;
+/**
+ * Generates the template content for a layout file
+ */
+export declare function generateLayoutTemplate(layoutType?: "stack" | "tabs" | "drawer"): string;
+/**
+ * Determines the appropriate template type from a file path
+ */
+export declare function getTemplateType(relativePath: string): "screen" | "layout";
+/**
+ * Extracts dynamic parameters from a filename
+ * Mirrors the logic from file-scanner.ts
+ */
+export declare function extractParamsFromPath(fileName: string): ParamDefinition[];
+/**
+ * Generates the appropriate template for a route file
+ */
+export declare function generateRouteTemplate(relativePath: string): string;
+//# sourceMappingURL=route-templates.d.ts.map

package/dist/templates/route-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-templates.d.ts","sourceRoot":"","sources":["../../src/templates/route-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAarD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgB7D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,GAAE,eAAe,EAAO,GAAG,MAAM,CA2ChG;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,GAAE,OAAO,GAAG,MAAM,GAAG,QAAkB,GAAG,MAAM,CA0BhG;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAIzE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE,CAoBzE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CASlE"}

package/dist/templates/route-templates.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * Route templates for @teardown/navigation-metro
+ * Generates template content for new route files
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isFileEmpty = isFileEmpty;
+exports.fileNameToScreenName = fileNameToScreenName;
+exports.screenNameToTitle = screenNameToTitle;
+exports.generateScreenTemplate = generateScreenTemplate;
+exports.generateLayoutTemplate = generateLayoutTemplate;
+exports.getTemplateType = getTemplateType;
+exports.extractParamsFromPath = extractParamsFromPath;
+exports.generateRouteTemplate = generateRouteTemplate;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/**
+ * Checks if a file is empty or has minimal content (less than 10 bytes)
+ */
+function isFileEmpty(filePath) {
+    try {
+        const stats = (0, node_fs_1.statSync)(filePath);
+        if (stats.size < 10) {
+            return true;
+        }
+        // Also check if file only contains whitespace
+        const content = (0, node_fs_1.readFileSync)(filePath, "utf-8").trim();
+        return content.length === 0;
+    }
+    catch {
+        // If we can't read the file, assume it's not empty
+        return false;
+    }
+}
+/**
+ * Converts a filename to a PascalCase screen name
+ * e.g., "user-profile" -> "UserProfile", "[userId]" -> "UserId"
+ */
+function fileNameToScreenName(fileName) {
+    const ext = (0, node_path_1.extname)(fileName);
+    const baseName = (0, node_path_1.basename)(fileName, ext);
+    // Remove param brackets and special characters
+    const cleanName = baseName
+        .replace(/\[\.\.\.([^\]]+)\]/g, "$1") // [...slug] -> slug
+        .replace(/\[\[([^\]]+)\]\]/g, "$1") // [[id]] -> id
+        .replace(/\[([^\]]+)\]/g, "$1") // [userId] -> userId
+        .replace(/\?/g, ""); // Remove optional markers
+    // Convert to PascalCase
+    return cleanName
+        .split(/[-_]/)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join("");
+}
+/**
+ * Converts a PascalCase name to a human-readable title
+ * e.g., "UserProfile" -> "User Profile"
+ */
+function screenNameToTitle(screenName) {
+    return screenName.replace(/([A-Z])/g, " $1").trim();
+}
+/**
+ * Generates the template content for a screen file
+ */
+function generateScreenTemplate(routeName, params = []) {
+    const screenName = fileNameToScreenName(routeName);
+    const title = screenNameToTitle(screenName);
+    // Build params type annotation if there are params
+    let paramsImport = "";
+    let paramsType = "";
+    let paramsUsage = "";
+    if (params.length > 0) {
+        const paramEntries = params.map((p) => {
+            const type = p.isCatchAll ? "string[]" : "string";
+            return `${p.name}${p.isOptional ? "?" : ""}: ${type}`;
+        });
+        paramsType = `{ ${paramEntries.join("; ")} }`;
+        paramsImport = '\nimport { useTypedParams } from "@teardown/navigation";';
+        paramsUsage = `
+	const params = useTypedParams<${paramsType}>();`;
+    }
+    return `/**
+ * ${title} Screen
+ */
+
+import { defineScreen } from "@teardown/navigation/primitives";${paramsImport}
+import type React from "react";
+import { View, Text } from "react-native";
+
+function ${screenName}Screen(): React.JSX.Element {${paramsUsage}
+	return (
+		<View className="flex-1 bg-background p-6">
+			<Text className="text-foreground">${title}</Text>
+		</View>
+	);
+}
+
+export default defineScreen({
+	component: ${screenName}Screen,
+	options: {
+		title: "${title}",
+	},
+});
+`;
+}
+/**
+ * Generates the template content for a layout file
+ */
+function generateLayoutTemplate(layoutType = "stack") {
+    const screenOptionsMap = {
+        stack: `{
+		headerShown: true,
+	}`,
+        tabs: `{
+		headerShown: false,
+		tabBarActiveTintColor: "#007AFF",
+	}`,
+        drawer: `{
+		headerShown: true,
+		drawerType: "front",
+	}`,
+    };
+    return `/**
+ * Layout Configuration
+ */
+
+import { defineLayout } from "@teardown/navigation/primitives";
+
+export default defineLayout({
+	type: "${layoutType}",
+	screenOptions: ${screenOptionsMap[layoutType]},
+});
+`;
+}
+/**
+ * Determines the appropriate template type from a file path
+ */
+function getTemplateType(relativePath) {
+    const ext = (0, node_path_1.extname)(relativePath);
+    const fileName = (0, node_path_1.basename)(relativePath, ext);
+    return fileName === "_layout" ? "layout" : "screen";
+}
+/**
+ * Extracts dynamic parameters from a filename
+ * Mirrors the logic from file-scanner.ts
+ */
+function extractParamsFromPath(fileName) {
+    const params = [];
+    // Match patterns: [param], [param]?, [...param], [[param]]
+    const regex = /\[\[([^\]]+)\]\]|\[(?:\.\.\.)?([^\]]+)\]\??/g;
+    let match;
+    // biome-ignore lint/suspicious/noAssignInExpressions: standard regex iteration pattern
+    while ((match = regex.exec(fileName)) !== null) {
+        const fullMatch = match[0];
+        // match[1] is for [[param]] syntax, match[2] is for [param] syntax
+        const paramName = (match[1] || match[2]).replace("?", "");
+        params.push({
+            name: paramName,
+            isOptional: fullMatch.endsWith("?") || fullMatch.startsWith("[["),
+            isCatchAll: fullMatch.startsWith("[..."),
+        });
+    }
+    return params;
+}
+/**
+ * Generates the appropriate template for a route file
+ */
+function generateRouteTemplate(relativePath) {
+    const templateType = getTemplateType(relativePath);
+    if (templateType === "layout") {
+        return generateLayoutTemplate("stack");
+    }
+    const params = extractParamsFromPath(relativePath);
+    return generateScreenTemplate(relativePath, params);
+}

package/dist/watcher/file-watcher.d.ts

@@ -8,6 +8,11 @@ export interface WatcherOptions {
     generatedDir: string;
     prefixes: string[];
     verbose: boolean;
+    /**
+     * Auto-populate new route files with template content
+     * @default true
+     */
+    autoTemplate?: boolean;
     onRegenerate?: () => void;
     onError?: (errors: ValidationError[]) => void;
 }

package/dist/watcher/file-watcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../src/watcher/file-watcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,KAAK,eAAe,EAAkB,MAAM,8BAA8B,CAAC;AAEpF,MAAM,WAAW,cAAc;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,IAAI,CAAC;CAC9C;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,IAAI,CAyFrE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAKvC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C"}
+{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../src/watcher/file-watcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAAE,KAAK,eAAe,EAAkB,MAAM,8BAA8B,CAAC;AAEpF,MAAM,WAAW,cAAc;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,IAAI,CAAC;CAC9C;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,IAAI,CA+GrE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAKvC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C"}

package/dist/watcher/file-watcher.js

@@ -7,9 +7,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.startRouteWatcher = startRouteWatcher;
 exports.stopRouteWatcher = stopRouteWatcher;
 exports.isWatcherRunning = isWatcherRunning;
+const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const chokidar_1 = require("chokidar");
 const route_generator_1 = require("../generator/route-generator");
+const route_templates_1 = require("../templates/route-templates");
 const route_validator_1 = require("../validator/route-validator");
 let watcherInstance = null;
 /**
@@ -17,7 +19,7 @@ let watcherInstance = null;
  * Returns a cleanup function to stop watching
  */
 function startRouteWatcher(options) {
-    const { routesDir, generatedDir, prefixes, verbose, onRegenerate, onError } = options;
+    const { routesDir, generatedDir, prefixes, verbose, autoTemplate = true, onRegenerate, onError } = options;
     // Close existing watcher if any
     if (watcherInstance) {
         watcherInstance.close();
@@ -67,10 +69,31 @@ function startRouteWatcher(options) {
         }, 100);
     };
     watcher.on("add", (filePath) => {
+        const relativePath = (0, node_path_1.relative)(routesDir, filePath);
         if (verbose) {
-            console.log(`[teardown/navigation] File added: ${(0, node_path_1.relative)(routesDir, filePath)}`);
+            console.log(`[teardown/navigation] File added: ${relativePath}`);
         }
-        regenerate();
+        // Add delay to let filesystem settle before checking if file is empty
+        // This prevents race conditions where the file hasn't finished being created
+        // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: template generation with error handling
+        setTimeout(() => {
+            // Auto-populate empty files with template content
+            if (autoTemplate && (0, route_templates_1.isFileEmpty)(filePath)) {
+                try {
+                    const templateContent = (0, route_templates_1.generateRouteTemplate)(relativePath);
+                    (0, node_fs_1.writeFileSync)(filePath, templateContent);
+                    if (verbose) {
+                        console.log(`[teardown/navigation] Generated template for: ${relativePath}`);
+                    }
+                }
+                catch (error) {
+                    if (verbose) {
+                        console.error(`[teardown/navigation] Failed to generate template for ${relativePath}:`, error);
+                    }
+                }
+            }
+            regenerate();
+        }, 50);
     });
     watcher.on("unlink", (filePath) => {
         if (verbose) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@teardown/navigation-metro",
-	"version": "2.0.69",
+	"version": "2.0.71",
 	"description": "Metro plugin for @teardown/navigation type generation",
 	"private": false,
 	"publishConfig": {
@@ -42,7 +42,7 @@
 	},
 	"devDependencies": {
 		"@biomejs/biome": "2.3.11",
-		"@teardown/tsconfig": "2.0.69",
+		"@teardown/tsconfig": "2.0.71",
 		"@types/node": "24.10.1",
 		"typescript": "5.9.3"
 	}