@rangojs/router 0.10.0 → 0.11.0

package/dist/build/generate-route-types.js

@@ -1,740 +0,0 @@
-import { readFileSync, writeFileSync, existsSync, readdirSync, unlinkSync } from "node:fs";
-import { join, dirname, resolve, relative, basename as pathBasename } from "node:path";
-// @ts-ignore -- picomatch ships no .d.ts; types are trivial
-import picomatch from "picomatch";
-import ts from "typescript";
-// ---------------------------------------------------------------------------
-// AST helpers
-// ---------------------------------------------------------------------------
-function getStringValue(node) {
-    if (ts.isStringLiteral(node))
-        return node.text;
-    if (ts.isNoSubstitutionTemplateLiteral(node))
-        return node.text;
-    return null;
-}
-function extractObjectStringProperties(node) {
-    const result = {};
-    for (const prop of node.properties) {
-        if (!ts.isPropertyAssignment(prop))
-            continue;
-        const key = ts.isIdentifier(prop.name) ? prop.name.text
-            : ts.isStringLiteral(prop.name) ? prop.name.text
-                : null;
-        if (!key)
-            continue;
-        const val = getStringValue(prop.initializer);
-        if (val !== null)
-            result[key] = val;
-    }
-    return result;
-}
-// ---------------------------------------------------------------------------
-// Param extraction from route patterns
-// ---------------------------------------------------------------------------
-/**
- * Extract typed params from a route pattern string.
- * Matches `:paramName` and `:paramName?` (optional).
- * Custom regex constraints like `:id(\d+)` are ignored for type purposes.
- */
-export function extractParamsFromPattern(pattern) {
-    const params = {};
-    const regex = /:([a-zA-Z_$][\w$]*)(?:\([^)]+\))?(\?)?/g;
-    let match;
-    while ((match = regex.exec(pattern)) !== null) {
-        params[match[1]] = match[2] ? "string?" : "string";
-    }
-    return Object.keys(params).length > 0 ? params : undefined;
-}
-// ---------------------------------------------------------------------------
-// Shared route entry formatter
-// ---------------------------------------------------------------------------
-/**
- * Format a single route entry for codegen output.
- * Routes without search remain plain strings (params are extracted from
- * the pattern at the type level by ExtractParams).
- * Routes with search become objects with path and search fields.
- */
-export function formatRouteEntry(key, pattern, _params, search) {
-    const hasSearch = search && Object.keys(search).length > 0;
-    if (!hasSearch) {
-        return `  ${key}: "${pattern}",`;
-    }
-    const searchBody = Object.entries(search)
-        .map(([k, v]) => `${k}: "${v}"`)
-        .join(", ");
-    return `  ${key}: { path: "${pattern}", search: { ${searchBody} } },`;
-}
-// ---------------------------------------------------------------------------
-// AST-based route extraction
-// ---------------------------------------------------------------------------
-/**
- * Extract route definitions from source code by walking the TypeScript AST.
- * Finds path() and path.json(), path.md(), etc. call expressions and extracts
- * the pattern, name, params, and optional search schema from each.
- * Skips unnamed paths (no { name: "..." }).
- */
-export function extractRoutesFromSource(code) {
-    const sourceFile = ts.createSourceFile("input.tsx", code, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
-    const routes = [];
-    function visit(node) {
-        if (ts.isCallExpression(node)) {
-            const callee = node.expression;
-            const isPath = (ts.isIdentifier(callee) && callee.text === "path") ||
-                (ts.isPropertyAccessExpression(callee) &&
-                    ts.isIdentifier(callee.expression) && callee.expression.text === "path");
-            if (isPath && node.arguments.length >= 1) {
-                const route = extractRouteFromCallExpression(node);
-                if (route)
-                    routes.push(route);
-            }
-        }
-        ts.forEachChild(node, visit);
-    }
-    visit(sourceFile);
-    return routes;
-}
-function extractRouteFromCallExpression(node) {
-    const patternNode = node.arguments[0];
-    const pattern = getStringValue(patternNode);
-    if (pattern === null)
-        return null;
-    let name = null;
-    let search;
-    for (let i = 1; i < node.arguments.length; i++) {
-        const arg = node.arguments[i];
-        if (ts.isObjectLiteralExpression(arg)) {
-            for (const prop of arg.properties) {
-                if (!ts.isPropertyAssignment(prop))
-                    continue;
-                const propName = ts.isIdentifier(prop.name) ? prop.name.text : null;
-                if (propName === "name") {
-                    name = getStringValue(prop.initializer);
-                }
-                else if (propName === "search" && ts.isObjectLiteralExpression(prop.initializer)) {
-                    search = extractObjectStringProperties(prop.initializer);
-                }
-            }
-        }
-    }
-    if (!name)
-        return null;
-    const params = extractParamsFromPattern(pattern);
-    return {
-        name,
-        pattern,
-        ...(params ? { params } : {}),
-        ...(search && Object.keys(search).length > 0 ? { search } : {}),
-    };
-}
-// ---------------------------------------------------------------------------
-// Code generation
-// ---------------------------------------------------------------------------
-/**
- * Generate a per-module types file from extracted routes.
- * Output has zero imports, preventing circular references.
- */
-export function generatePerModuleTypesSource(routes) {
-    const valid = routes.filter(({ name }) => {
-        if (!name || /["'\\`\n\r]/.test(name)) {
-            console.warn(`[rsc-router] Skipping route with invalid name: ${JSON.stringify(name)}`);
-            return false;
-        }
-        return true;
-    });
-    // Deduplicate by name (first definition wins — primary route before variants)
-    const deduped = new Map();
-    for (const { name, pattern, params, search } of valid) {
-        if (deduped.has(name)) {
-            console.warn(`[rsc-router] Duplicate route name "${name}" — keeping first definition`);
-            continue;
-        }
-        deduped.set(name, { pattern, params, search });
-    }
-    const sorted = [...deduped.entries()]
-        .sort(([a], [b]) => a.localeCompare(b));
-    const body = sorted
-        .map(([name, { pattern, params, search }]) => {
-        const key = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name) ? name : `"${name}"`;
-        return formatRouteEntry(key, pattern, params, search);
-    })
-        .join("\n");
-    return `// Auto-generated by @rangojs/router - do not edit\nexport const routes = {\n${body}\n} as const;\nexport type routes = typeof routes;\n`;
-}
-/**
- * Generates a .ts file that augments RSCRouter.GeneratedRouteMap
- * with route name -> pattern mappings. This enables Handler<"routeName">
- * without circular references since the file has no imports from the app.
- */
-export function generateRouteTypesSource(routeManifest, searchSchemas) {
-    const entries = Object.entries(routeManifest).sort(([a], [b]) => a.localeCompare(b));
-    const objectBody = entries
-        .map(([name, pattern]) => {
-        const key = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name) ? name : `"${name}"`;
-        const params = extractParamsFromPattern(pattern);
-        const search = searchSchemas?.[name];
-        return formatRouteEntry(key, pattern, params, search);
-    })
-        .join("\n");
-    return `// Auto-generated by @rangojs/router - do not edit
-export const NamedRoutes = {
-${objectBody}
-} as const;
-
-declare global {
-  namespace RSCRouter {
-    interface GeneratedRouteMap extends Readonly<typeof NamedRoutes> {}
-  }
-}
-`;
-}
-/** Default exclude patterns for route type scanning. */
-export const DEFAULT_EXCLUDE_PATTERNS = [
-    "**/__tests__/**",
-    "**/__mocks__/**",
-    "**/dist/**",
-    "**/coverage/**",
-    "**/*.test.{ts,tsx}",
-    "**/*.spec.{ts,tsx}",
-];
-/**
- * Compile include/exclude glob patterns into a single predicate.
- * Paths are made root-relative before matching.
- * Returns undefined when no filtering is needed (no include, default exclude).
- */
-export function createScanFilter(root, opts) {
-    const { include, exclude } = opts;
-    const hasInclude = include && include.length > 0;
-    const hasCustomExclude = exclude !== undefined;
-    if (!hasInclude && !hasCustomExclude)
-        return undefined;
-    const effectiveExclude = exclude ?? DEFAULT_EXCLUDE_PATTERNS;
-    const includeMatcher = hasInclude ? picomatch(include) : null;
-    const excludeMatcher = effectiveExclude.length > 0 ? picomatch(effectiveExclude) : null;
-    return (absolutePath) => {
-        const rel = relative(root, absolutePath);
-        if (excludeMatcher && excludeMatcher(rel))
-            return false;
-        if (includeMatcher)
-            return includeMatcher(rel);
-        return true;
-    };
-}
-/**
- * Recursively find .ts/.tsx files under a directory, skipping node_modules
- * and .gen. files.
- */
-export function findTsFiles(dir, filter) {
-    const results = [];
-    let entries;
-    try {
-        entries = readdirSync(dir, { withFileTypes: true });
-    }
-    catch (err) {
-        console.warn(`[rsc-router] Failed to scan directory ${dir}: ${err.message}`);
-        return results;
-    }
-    for (const entry of entries) {
-        const fullPath = join(dir, entry.name);
-        if (entry.isDirectory()) {
-            if (entry.name === "node_modules" || entry.name.startsWith("."))
-                continue;
-            results.push(...findTsFiles(fullPath, filter));
-        }
-        else if ((entry.name.endsWith(".ts") || entry.name.endsWith(".tsx")) &&
-            !entry.name.includes(".gen.")) {
-            if (filter && !filter(fullPath))
-                continue;
-            results.push(fullPath);
-        }
-    }
-    return results;
-}
-/**
- * Generate per-module route type files by statically parsing url module source.
- * Scans for files containing `urls(` and writes a sibling `.gen.ts` with the
- * extracted route name/pattern pairs. Only writes when content has changed.
- */
-export function writePerModuleRouteTypes(root, filter) {
-    const files = findTsFiles(root, filter);
-    for (const filePath of files) {
-        writePerModuleRouteTypesForFile(filePath);
-    }
-}
-/**
- * Find all variable names assigned to urls() calls in source code.
- * e.g. `export const patterns = urls(...)` → ["patterns"]
- */
-function findUrlsVariableNames(code) {
-    const sourceFile = ts.createSourceFile("input.tsx", code, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
-    const names = [];
-    function visit(node) {
-        if (ts.isVariableDeclaration(node) &&
-            ts.isIdentifier(node.name) &&
-            node.initializer &&
-            ts.isCallExpression(node.initializer)) {
-            const callee = node.initializer.expression;
-            if (ts.isIdentifier(callee) && callee.text === "urls") {
-                names.push(node.name.text);
-            }
-        }
-        ts.forEachChild(node, visit);
-    }
-    visit(sourceFile);
-    return names;
-}
-/**
- * Generate per-module route types for a single url module file.
- * Follows include() calls recursively to produce the full route tree.
- * No-ops if the file doesn't contain `urls(` or has no named routes.
- */
-export function writePerModuleRouteTypesForFile(filePath) {
-    try {
-        const source = readFileSync(filePath, "utf-8");
-        if (!source.includes("urls("))
-            return;
-        const varNames = findUrlsVariableNames(source);
-        let routes;
-        if (varNames.length > 0) {
-            // Follow includes recursively via the combined route map builder.
-            // The visited set in buildCombinedRouteMapWithSearch prevents infinite loops.
-            routes = [];
-            for (const varName of varNames) {
-                const { routes: routeMap, searchSchemas } = buildCombinedRouteMapWithSearch(filePath, varName);
-                for (const [name, pattern] of Object.entries(routeMap)) {
-                    const params = extractParamsFromPattern(pattern);
-                    routes.push({
-                        name,
-                        pattern,
-                        ...(params ? { params } : {}),
-                        ...(searchSchemas[name] ? { search: searchSchemas[name] } : {}),
-                    });
-                }
-            }
-        }
-        else {
-            // Fallback: no urls() variable found, extract path() calls directly
-            routes = extractRoutesFromSource(source);
-        }
-        if (routes.length === 0)
-            return;
-        const genPath = filePath.replace(/\.(tsx?)$/, ".gen.ts");
-        const genSource = generatePerModuleTypesSource(routes);
-        const existing = existsSync(genPath) ? readFileSync(genPath, "utf-8") : null;
-        if (existing !== genSource) {
-            writeFileSync(genPath, genSource);
-            console.log(`[rsc-router] Generated route types -> ${genPath}`);
-        }
-    }
-    catch (err) {
-        console.warn(`[rsc-router] Failed to generate route types for ${filePath}: ${err.message}`);
-    }
-}
-// ---------------------------------------------------------------------------
-// AST-based include() parsing
-// ---------------------------------------------------------------------------
-/**
- * Extract include() calls from source code by walking the TypeScript AST.
- * Returns the path prefix, variable name, and optional name prefix for each.
- */
-export function extractIncludesFromSource(code) {
-    const sourceFile = ts.createSourceFile("input.tsx", code, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
-    const results = [];
-    function visit(node) {
-        if (ts.isCallExpression(node)) {
-            const callee = node.expression;
-            if (ts.isIdentifier(callee) && callee.text === "include") {
-                const result = extractIncludeFromCallExpression(node);
-                if (result)
-                    results.push(result);
-            }
-        }
-        ts.forEachChild(node, visit);
-    }
-    visit(sourceFile);
-    return results;
-}
-function extractIncludeFromCallExpression(node) {
-    if (node.arguments.length < 2)
-        return null;
-    const pathPrefix = getStringValue(node.arguments[0]);
-    if (pathPrefix === null)
-        return null;
-    const secondArg = node.arguments[1];
-    if (!ts.isIdentifier(secondArg))
-        return null;
-    const variableName = secondArg.text;
-    let namePrefix = null;
-    if (node.arguments.length >= 3) {
-        const thirdArg = node.arguments[2];
-        if (ts.isObjectLiteralExpression(thirdArg)) {
-            for (const prop of thirdArg.properties) {
-                if (!ts.isPropertyAssignment(prop))
-                    continue;
-                const propName = ts.isIdentifier(prop.name) ? prop.name.text : null;
-                if (propName === "name") {
-                    namePrefix = getStringValue(prop.initializer);
-                }
-            }
-        }
-    }
-    return { pathPrefix, variableName, namePrefix };
-}
-// ---------------------------------------------------------------------------
-// Import resolution
-// ---------------------------------------------------------------------------
-/**
- * Find the import statement for a local variable name.
- * Returns the import specifier and the exported name from the source module.
- */
-function resolveImportedVariable(code, localName) {
-    const importRegex = /import\s*\{([^}]+)\}\s*from\s*["']([^"']+)["']/g;
-    let match;
-    while ((match = importRegex.exec(code)) !== null) {
-        const imports = match[1];
-        const specifier = match[2];
-        const parts = imports
-            .split(",")
-            .map((s) => s.trim())
-            .filter(Boolean);
-        for (const part of parts) {
-            const asMatch = part.match(/^(\w+)\s+as\s+(\w+)$/);
-            if (asMatch && asMatch[2] === localName)
-                return { specifier, exportedName: asMatch[1] };
-            if (part === localName)
-                return { specifier, exportedName: localName };
-        }
-    }
-    return null;
-}
-/**
- * Resolve an import specifier relative to the importing file.
- * Strips .js/.mjs extensions and tries .ts/.tsx candidates.
- */
-function resolveImportPath(importSpec, fromFile) {
-    if (!importSpec.startsWith("."))
-        return null;
-    const dir = dirname(fromFile);
-    let base = importSpec;
-    if (base.endsWith(".js"))
-        base = base.slice(0, -3);
-    else if (base.endsWith(".mjs"))
-        base = base.slice(0, -4);
-    const candidates = [
-        resolve(dir, base + ".ts"),
-        resolve(dir, base + ".tsx"),
-        resolve(dir, base + "/index.ts"),
-        resolve(dir, base + "/index.tsx"),
-    ];
-    for (const candidate of candidates) {
-        if (existsSync(candidate))
-            return candidate;
-    }
-    return null;
-}
-// ---------------------------------------------------------------------------
-// urls() block extraction for same-file variables
-// ---------------------------------------------------------------------------
-/**
- * Extract the source of a specific `const varName = urls(...)` call using
- * the TypeScript AST. Returns the full text of the urls() call expression.
- */
-function extractUrlsBlockForVariable(code, varName) {
-    const sourceFile = ts.createSourceFile("input.tsx", code, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
-    let result = null;
-    function visit(node) {
-        if (result)
-            return;
-        if (ts.isVariableDeclaration(node) &&
-            ts.isIdentifier(node.name) &&
-            node.name.text === varName &&
-            node.initializer &&
-            ts.isCallExpression(node.initializer)) {
-            const callee = node.initializer.expression;
-            if (ts.isIdentifier(callee) && callee.text === "urls") {
-                result = node.initializer.getText(sourceFile);
-                return;
-            }
-        }
-        ts.forEachChild(node, visit);
-    }
-    visit(sourceFile);
-    return result;
-}
-// ---------------------------------------------------------------------------
-// Combined route map building
-// ---------------------------------------------------------------------------
-/**
- * Recursively build a route map from a urls module file.
- * Extracts local path() routes and follows include() calls to sub-modules.
- * Handles both imported and same-file variables.
- */
-export function buildCombinedRouteMap(filePath, variableName, visited) {
-    visited = visited ?? new Set();
-    const realPath = resolve(filePath);
-    const key = variableName ? `${realPath}:${variableName}` : realPath;
-    if (visited.has(key)) {
-        console.warn(`[rsc-router] Circular include detected, skipping: ${key}`);
-        return {};
-    }
-    visited.add(key);
-    let source;
-    try {
-        source = readFileSync(realPath, "utf-8");
-    }
-    catch {
-        return {};
-    }
-    // If a specific variable is requested, extract just its urls() block
-    let block;
-    if (variableName) {
-        const extracted = extractUrlsBlockForVariable(source, variableName);
-        if (!extracted)
-            return {};
-        block = extracted;
-    }
-    else {
-        block = source;
-    }
-    return buildRouteMapFromBlock(block, source, realPath, visited);
-}
-function buildRouteMapFromBlock(block, fullSource, filePath, visited, searchSchemasOut) {
-    const routeMap = {};
-    // Extract local path() routes
-    const localRoutes = extractRoutesFromSource(block);
-    for (const { name, pattern, search } of localRoutes) {
-        routeMap[name] = pattern;
-        if (search && searchSchemasOut) {
-            searchSchemasOut[name] = search;
-        }
-    }
-    // Extract include() calls
-    const includes = extractIncludesFromSource(block);
-    for (const { pathPrefix, variableName, namePrefix } of includes) {
-        let childResult;
-        // Try import resolution first
-        const imported = resolveImportedVariable(fullSource, variableName);
-        if (imported) {
-            const targetFile = resolveImportPath(imported.specifier, filePath);
-            if (!targetFile)
-                continue;
-            childResult = buildCombinedRouteMapWithSearch(targetFile, imported.exportedName, visited);
-        }
-        else {
-            // Same-file variable
-            childResult = buildCombinedRouteMapWithSearch(filePath, variableName, visited);
-        }
-        // Apply prefixes
-        for (const [name, pattern] of Object.entries(childResult.routes)) {
-            const prefixedName = namePrefix ? `${namePrefix}.${name}` : name;
-            let prefixedPattern;
-            if (pattern === "/") {
-                prefixedPattern = pathPrefix || "/";
-            }
-            else if (pathPrefix.endsWith("/") && pattern.startsWith("/")) {
-                prefixedPattern = pathPrefix + pattern.slice(1);
-            }
-            else {
-                prefixedPattern = pathPrefix + pattern;
-            }
-            routeMap[prefixedName] = prefixedPattern;
-            // Propagate search schemas with prefix
-            if (childResult.searchSchemas[name] && searchSchemasOut) {
-                searchSchemasOut[prefixedName] = childResult.searchSchemas[name];
-            }
-        }
-    }
-    return routeMap;
-}
-/**
- * Build route map and search schemas together.
- * Internal helper used by the include resolution path.
- */
-function buildCombinedRouteMapWithSearch(filePath, variableName, visited) {
-    visited = visited ?? new Set();
-    const realPath = resolve(filePath);
-    const key = variableName ? `${realPath}:${variableName}` : realPath;
-    if (visited.has(key)) {
-        console.warn(`[rsc-router] Circular include detected, skipping: ${key}`);
-        return { routes: {}, searchSchemas: {} };
-    }
-    visited.add(key);
-    let source;
-    try {
-        source = readFileSync(realPath, "utf-8");
-    }
-    catch {
-        return { routes: {}, searchSchemas: {} };
-    }
-    let block;
-    if (variableName) {
-        const extracted = extractUrlsBlockForVariable(source, variableName);
-        if (!extracted)
-            return { routes: {}, searchSchemas: {} };
-        block = extracted;
-    }
-    else {
-        block = source;
-    }
-    const searchSchemas = {};
-    const routes = buildRouteMapFromBlock(block, source, realPath, visited, searchSchemas);
-    return { routes, searchSchemas };
-}
-// ---------------------------------------------------------------------------
-// Router file URL extraction
-// ---------------------------------------------------------------------------
-/**
- * Extract the url patterns variable from a router file.
- * Looks for patterns like:
- *   .routes(variableName)
- *   urls: variableName
- * Returns the local variable name and optional import info.
- */
-function extractUrlsVariableFromRouter(code) {
-    // Pattern 1: .routes(variableName) where variableName is an identifier (not a string)
-    const routesCallMatch = code.match(/\.routes\s*\(\s*([a-zA-Z_$][\w$]*)\s*\)/);
-    if (routesCallMatch)
-        return routesCallMatch[1];
-    // Pattern 2: urls: variableName in createRouter options
-    const urlsOptionMatch = code.match(/urls\s*:\s*([a-zA-Z_$][\w$]*)/);
-    if (urlsOptionMatch)
-        return urlsOptionMatch[1];
-    return null;
-}
-/**
- * Resolve routes and search schemas from a router source file by following the
- * variable passed to `.routes(...)` or `urls: ...` in createRouter options.
- */
-export function buildCombinedRouteMapForRouterFile(routerFilePath) {
-    let routerSource;
-    try {
-        routerSource = readFileSync(routerFilePath, "utf-8");
-    }
-    catch {
-        return { routes: {}, searchSchemas: {} };
-    }
-    const urlsVarName = extractUrlsVariableFromRouter(routerSource);
-    if (!urlsVarName) {
-        return { routes: {}, searchSchemas: {} };
-    }
-    const imported = resolveImportedVariable(routerSource, urlsVarName);
-    if (imported) {
-        const targetFile = resolveImportPath(imported.specifier, routerFilePath);
-        if (!targetFile) {
-            return { routes: {}, searchSchemas: {} };
-        }
-        return buildCombinedRouteMapWithSearch(targetFile, imported.exportedName);
-    }
-    return buildCombinedRouteMapWithSearch(routerFilePath, urlsVarName);
-}
-// ---------------------------------------------------------------------------
-// Per-router named-routes.gen.ts writer
-// ---------------------------------------------------------------------------
-/**
- * Scan for files containing createRouter() and return their paths.
- * Call once at startup; the result can be reused on subsequent watcher triggers.
- */
-export function findRouterFiles(root, filter) {
-    const files = findTsFiles(root, filter);
-    const result = [];
-    for (const filePath of files) {
-        if (filePath.includes(".gen."))
-            continue;
-        try {
-            const source = readFileSync(filePath, "utf-8");
-            if (/\bcreateRouter\s*[<(]/.test(source)) {
-                result.push(filePath);
-            }
-        }
-        catch {
-            continue;
-        }
-    }
-    return result;
-}
-/**
- * Generate per-router named-routes.gen.ts files from known router file paths.
- * Re-reads each router file and resolves url patterns via static source parsing.
- *
- * Pass `knownRouterFiles` from a previous `findRouterFiles()` call to skip the
- * full directory scan. If omitted, falls back to scanning (startup path).
- */
-/**
- * Write named-routes.gen.ts files from static source parsing.
- * Dev-only: provides initial .gen.ts files for IDE types before runtime
- * discovery runs. Must NOT be called during production builds — runtime
- * discovery in buildStart produces the definitive file.
- */
-export function writeCombinedRouteTypes(root, knownRouterFiles, opts) {
-    // Delete old combined named-routes.gen.ts if it exists (stale from older versions)
-    try {
-        const oldCombinedPath = join(root, "src", "named-routes.gen.ts");
-        if (existsSync(oldCombinedPath)) {
-            unlinkSync(oldCombinedPath);
-            console.log(`[rsc-router] Removed stale combined route types: ${oldCombinedPath}`);
-        }
-    }
-    catch { }
-    const routerFilePaths = knownRouterFiles ?? findRouterFiles(root);
-    if (routerFilePaths.length === 0)
-        return;
-    for (const routerFilePath of routerFilePaths) {
-        let routerSource;
-        try {
-            routerSource = readFileSync(routerFilePath, "utf-8");
-        }
-        catch {
-            continue;
-        }
-        // Extract the urls variable name from .routes(varName) or urls: varName
-        const urlsVarName = extractUrlsVariableFromRouter(routerSource);
-        if (!urlsVarName)
-            continue;
-        // Resolve the variable to its source module
-        let result;
-        const imported = resolveImportedVariable(routerSource, urlsVarName);
-        if (imported) {
-            // Variable is imported from another module
-            const targetFile = resolveImportPath(imported.specifier, routerFilePath);
-            if (!targetFile)
-                continue;
-            result = buildCombinedRouteMapWithSearch(targetFile, imported.exportedName);
-        }
-        else {
-            // Variable is defined in the same file
-            result = buildCombinedRouteMapWithSearch(routerFilePath, urlsVarName);
-        }
-        const routerBasename = pathBasename(routerFilePath).replace(/\.(tsx?|jsx?)$/, "");
-        const outPath = join(dirname(routerFilePath), `${routerBasename}.named-routes.gen.ts`);
-        const existing = existsSync(outPath) ? readFileSync(outPath, "utf-8") : null;
-        // When the static parser can't extract routes (e.g. callback-style urls()),
-        // write an empty placeholder so the build-time transform's injected import
-        // resolves. Runtime discovery will overwrite this with the real routes.
-        if (Object.keys(result.routes).length === 0) {
-            if (!existing) {
-                const emptySource = generateRouteTypesSource({});
-                writeFileSync(outPath, emptySource);
-            }
-            continue;
-        }
-        const hasSearchSchemas = Object.keys(result.searchSchemas).length > 0;
-        const source = generateRouteTypesSource(result.routes, hasSearchSchemas ? result.searchSchemas : undefined);
-        if (existing !== source) {
-            // On initial dev startup, don't overwrite a file from runtime discovery
-            // (which has all dynamic routes) with a smaller set from the static
-            // parser. The static parser can't see routes generated by Array.from()
-            // or other dynamic code. During HMR (file watcher), always write so
-            // newly added routes appear immediately.
-            if (opts?.preserveIfLarger && existing) {
-                const existingCount = (existing.match(/^\s+["a-zA-Z_$][^:]*:\s*["{]/gm) || []).length;
-                const newCount = Object.keys(result.routes).length;
-                if (existingCount > newCount) {
-                    continue;
-                }
-            }
-            writeFileSync(outPath, source);
-            console.log(`[rsc-router] Generated route types (${Object.keys(result.routes).length} routes) -> ${outPath}`);
-        }
-    }
-}
-//# sourceMappingURL=generate-route-types.js.map