@rangojs/router 0.0.0-experimental.2 → 0.0.0-experimental.21

package/dist/build/generate-manifest.js

@@ -0,0 +1,276 @@
+/**
+ * Build-time manifest generation for @rangojs/router
+ *
+ * Extracts the prefix tree and route manifest from UrlPatterns at build time.
+ * This enables:
+ * - Pre-computed prefix tree for fast short-circuit checks
+ * - Complete route manifest for href() without runtime evaluation
+ * - Support for nested includes
+ */
+import { extractStaticPrefix } from "../router/pattern-matching.js";
+import { RSCRouterContext, runWithPrefixes } from "../server/context.js";
+import { createRouteHelpers } from "../route-definition.js";
+import MapRootLayout from "../server/root-layout.js";
+/**
+ * Build prefix tree node by running the patterns with proper context.
+ * Uses a visited set to detect circular includes and prevent infinite recursion.
+ */
+function buildPrefixTreeNode(urlPrefix, namePrefix, patterns, routeManifest, routeAncestry, // internal: feeds trie building, not exported
+mountIndex, visited = new Set(), routeTrailingSlash, prerenderRoutes, prerenderDefs, passthroughRoutes, responseTypeRoutes, routeSearchSchemas) {
+    if (visited.has(patterns)) {
+        console.warn(`[@rangojs/router] Circular include detected at prefix "${urlPrefix}". Skipping.`);
+        return {
+            staticPrefix: extractStaticPrefix(urlPrefix),
+            fullPrefix: urlPrefix,
+            namePrefix: namePrefix || undefined,
+            children: {},
+            routes: [],
+        };
+    }
+    visited.add(patterns);
+    // Create context for running patterns with include tracking
+    const manifest = new Map();
+    const patternsMap = new Map();
+    const patternsByPrefix = new Map();
+    const trailingSlashMap = new Map();
+    const searchSchemasMap = new Map();
+    const trackedIncludes = [];
+    RSCRouterContext.run({
+        manifest,
+        patterns: patternsMap,
+        patternsByPrefix,
+        trailingSlash: trailingSlashMap,
+        searchSchemas: searchSchemasMap,
+        namespace: "build",
+        parent: null,
+        counters: {},
+        mountIndex,
+        trackedIncludes, // Enable nested include tracking
+    }, () => {
+        const helpers = createRouteHelpers();
+        // Wrap in root layout for correct parent hierarchy (matches runtime)
+        helpers.layout(MapRootLayout, () => {
+            if (urlPrefix || namePrefix) {
+                return runWithPrefixes(urlPrefix, namePrefix, () => {
+                    return patterns.handler();
+                });
+            }
+            return patterns.handler();
+        });
+    });
+    // Collect route names defined in this include (routes have prefixes applied)
+    const routes = [];
+    for (const [name, pattern] of patternsMap.entries()) {
+        routes.push(name);
+        routeManifest[name] = pattern;
+    }
+    // Collect trailing slash config
+    if (routeTrailingSlash) {
+        for (const [name, mode] of trailingSlashMap.entries()) {
+            routeTrailingSlash[name] = mode;
+        }
+    }
+    if (routeSearchSchemas) {
+        for (const [name, schema] of searchSchemasMap.entries()) {
+            routeSearchSchemas[name] = schema;
+        }
+    }
+    // Capture ancestry from manifest entries' parent chains
+    captureAncestry(manifest, routeAncestry);
+    // Collect prerender route names and handler definitions from manifest entries
+    if (prerenderRoutes) {
+        for (const [name, entry] of manifest) {
+            if (entry.type === "route" && entry.isPrerender) {
+                prerenderRoutes.push(name);
+                if (prerenderDefs && entry.prerenderDef) {
+                    prerenderDefs[name] = entry.prerenderDef;
+                }
+                if (passthroughRoutes && entry.prerenderDef?.options?.passthrough === true) {
+                    passthroughRoutes.push(name);
+                }
+            }
+        }
+    }
+    // Collect response type routes from manifest entries
+    if (responseTypeRoutes) {
+        for (const [name, entry] of manifest) {
+            if (entry.type === "route" && entry.responseType) {
+                responseTypeRoutes[name] = entry.responseType;
+            }
+        }
+    }
+    // Build children from tracked nested includes.
+    // Multiple includes can share the same fullPrefix (e.g., include("/", patternsA),
+    // include("/", patternsB)). Merge their routes instead of overwriting.
+    const children = {};
+    for (const include of trackedIncludes) {
+        const childNode = buildPrefixTreeNode(include.fullPrefix, include.namePrefix, include.patterns, routeManifest, routeAncestry, mountIndex, visited, routeTrailingSlash, prerenderRoutes, prerenderDefs, passthroughRoutes, responseTypeRoutes, routeSearchSchemas);
+        const existing = children[include.fullPrefix];
+        if (existing) {
+            existing.routes.push(...childNode.routes);
+            Object.assign(existing.children, childNode.children);
+        }
+        else {
+            children[include.fullPrefix] = childNode;
+        }
+    }
+    return {
+        staticPrefix: extractStaticPrefix(urlPrefix),
+        fullPrefix: urlPrefix,
+        namePrefix: namePrefix || undefined,
+        children,
+        routes,
+    };
+}
+/**
+ * Walk parent chains of route entries to extract ancestry shortCodes.
+ */
+function captureAncestry(manifest, routeAncestry) {
+    for (const [routeName, entry] of manifest) {
+        if (entry.type === "route") {
+            const ancestry = [];
+            let current = entry;
+            while (current) {
+                ancestry.unshift(current.shortCode);
+                current = current.parent;
+            }
+            routeAncestry[routeName] = ancestry;
+        }
+    }
+}
+/**
+ * Generate manifest from UrlPatterns
+ *
+ * This runs all patterns (including lazy ones) at build time to extract:
+ * - The complete prefix tree for short-circuit optimization
+ * - The complete route manifest for href()
+ *
+ * @example
+ * ```typescript
+ * import { generateManifest } from "@rangojs/router/build";
+ * import { urlpatterns } from "./urls";
+ *
+ * const manifest = generateManifest(urlpatterns);
+ * // Write to file for runtime use
+ * fs.writeFileSync(
+ *   "src/generated/route-manifest.json",
+ *   JSON.stringify(manifest, null, 2)
+ * );
+ * ```
+ */
+export function generateManifest(urlpatterns, mountIndex = 0) {
+    const routeManifest = {};
+    const routeAncestry = {};
+    const prefixTree = {};
+    // Run the root patterns handler with tracking enabled
+    const manifest = new Map();
+    const patternsMap = new Map();
+    const patternsByPrefix = new Map();
+    const trailingSlashMap = new Map();
+    const searchSchemasMap = new Map();
+    const trackedIncludes = [];
+    RSCRouterContext.run({
+        manifest,
+        patterns: patternsMap,
+        patternsByPrefix,
+        trailingSlash: trailingSlashMap,
+        searchSchemas: searchSchemasMap,
+        namespace: "build",
+        parent: null,
+        counters: {},
+        mountIndex,
+        trackedIncludes, // Enable include tracking
+    }, () => {
+        const helpers = createRouteHelpers();
+        // Wrap in root layout for correct parent hierarchy (matches runtime)
+        helpers.layout(MapRootLayout, () => {
+            return urlpatterns.handler();
+        });
+    });
+    // Collect root-level routes and trailing slash config
+    const routeTrailingSlash = {};
+    for (const [name, pattern] of patternsMap.entries()) {
+        routeManifest[name] = pattern;
+    }
+    for (const [name, mode] of trailingSlashMap.entries()) {
+        routeTrailingSlash[name] = mode;
+    }
+    const routeSearchSchemas = {};
+    for (const [name, schema] of searchSchemasMap.entries()) {
+        routeSearchSchemas[name] = schema;
+    }
+    // Capture ancestry from manifest entries' parent chains
+    captureAncestry(manifest, routeAncestry);
+    // Collect prerender route names and handler definitions across all levels
+    const prerenderRoutes = [];
+    const prerenderDefs = {};
+    const passthroughRoutes = [];
+    const responseTypeRoutes = {};
+    for (const [name, entry] of manifest) {
+        if (entry.type === "route" && entry.isPrerender) {
+            prerenderRoutes.push(name);
+            if (entry.prerenderDef) {
+                prerenderDefs[name] = entry.prerenderDef;
+            }
+            if (entry.prerenderDef?.options?.passthrough === true) {
+                passthroughRoutes.push(name);
+            }
+        }
+        if (entry.type === "route" && entry.responseType) {
+            responseTypeRoutes[name] = entry.responseType;
+        }
+    }
+    // Build prefix tree from tracked includes (shared visited set for cycle detection).
+    // Multiple includes can share the same fullPrefix (e.g., include("/", patternsA),
+    // include("/", patternsB)). Merge their routes instead of overwriting.
+    const visited = new Set();
+    for (const include of trackedIncludes) {
+        const node = buildPrefixTreeNode(include.fullPrefix, include.namePrefix, include.patterns, routeManifest, routeAncestry, mountIndex, visited, routeTrailingSlash, prerenderRoutes, prerenderDefs, passthroughRoutes, responseTypeRoutes, routeSearchSchemas);
+        const existing = prefixTree[include.fullPrefix];
+        if (existing) {
+            existing.routes.push(...node.routes);
+            Object.assign(existing.children, node.children);
+        }
+        else {
+            prefixTree[include.fullPrefix] = node;
+        }
+    }
+    return {
+        prefixTree,
+        routeManifest,
+        routeTrailingSlash: Object.keys(routeTrailingSlash).length > 0 ? routeTrailingSlash : undefined,
+        prerenderRoutes: prerenderRoutes.length > 0 ? prerenderRoutes : undefined,
+        passthroughRoutes: passthroughRoutes.length > 0 ? passthroughRoutes : undefined,
+        responseTypeRoutes: Object.keys(responseTypeRoutes).length > 0 ? responseTypeRoutes : undefined,
+        routeSearchSchemas: Object.keys(routeSearchSchemas).length > 0 ? routeSearchSchemas : undefined,
+        generatedAt: new Date().toISOString(),
+        // Internal: routeAncestry is used only for trie building, not exported
+        _routeAncestry: routeAncestry,
+        // Internal: prerender handler definitions for build-time getParams() access
+        _prerenderDefs: Object.keys(prerenderDefs).length > 0 ? prerenderDefs : undefined,
+    };
+}
+/**
+ * Generate TypeScript code for the manifest
+ *
+ * @example
+ * ```typescript
+ * const code = generateManifestCode(urlpatterns);
+ * fs.writeFileSync("src/generated/route-manifest.ts", code);
+ * ```
+ */
+export function generateManifestCode(urlpatterns) {
+    const manifest = generateManifest(urlpatterns);
+    return `/**
+ * Auto-generated route manifest
+ * Generated at: ${manifest.generatedAt}
+ *
+ * DO NOT EDIT - This file is generated by @rangojs/router
+ */
+
+export const routeManifest = ${JSON.stringify(manifest.routeManifest, null, 2)} as const;
+
+export type RouteNames = keyof typeof routeManifest;
+`;
+}
+//# sourceMappingURL=generate-manifest.js.map

package/dist/build/generate-manifest.js.map

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

package/dist/build/generate-route-types.d.ts

@@ -0,0 +1,115 @@
+/**
+ * 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 declare function extractParamsFromPattern(pattern: string): Record<string, string> | undefined;
+/**
+ * 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 declare function formatRouteEntry(key: string, pattern: string, _params?: Record<string, string>, search?: Record<string, string>): string;
+/**
+ * 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 declare function extractRoutesFromSource(code: string): Array<{
+    name: string;
+    pattern: string;
+    params?: Record<string, string>;
+    search?: Record<string, string>;
+}>;
+/**
+ * Generate a per-module types file from extracted routes.
+ * Output has zero imports, preventing circular references.
+ */
+export declare function generatePerModuleTypesSource(routes: Array<{
+    name: string;
+    pattern: string;
+    params?: Record<string, string>;
+    search?: Record<string, string>;
+}>): string;
+/**
+ * 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 declare function generateRouteTypesSource(routeManifest: Record<string, string>, searchSchemas?: Record<string, Record<string, string>>): string;
+/** Default exclude patterns for route type scanning. */
+export declare const DEFAULT_EXCLUDE_PATTERNS: string[];
+export type ScanFilter = (absolutePath: string) => boolean;
+/**
+ * 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 declare function createScanFilter(root: string, opts: {
+    include?: string[];
+    exclude?: string[];
+}): ScanFilter | undefined;
+/**
+ * Recursively find .ts/.tsx files under a directory, skipping node_modules
+ * and .gen. files.
+ */
+export declare function findTsFiles(dir: string, filter?: ScanFilter): string[];
+/**
+ * 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 declare function writePerModuleRouteTypes(root: string, filter?: ScanFilter): void;
+/**
+ * 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 declare function writePerModuleRouteTypesForFile(filePath: string): void;
+/**
+ * Extract include() calls from source code by walking the TypeScript AST.
+ * Returns the path prefix, variable name, and optional name prefix for each.
+ */
+export declare function extractIncludesFromSource(code: string): Array<{
+    pathPrefix: string;
+    variableName: string;
+    namePrefix: string | null;
+}>;
+/**
+ * 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 declare function buildCombinedRouteMap(filePath: string, variableName?: string, visited?: Set<string>): Record<string, string>;
+/**
+ * Resolve routes and search schemas from a router source file by following the
+ * variable passed to `.routes(...)` or `urls: ...` in createRouter options.
+ */
+export declare function buildCombinedRouteMapForRouterFile(routerFilePath: string): {
+    routes: Record<string, string>;
+    searchSchemas: Record<string, Record<string, string>>;
+};
+/**
+ * Scan for files containing createRouter() and return their paths.
+ * Call once at startup; the result can be reused on subsequent watcher triggers.
+ */
+export declare function findRouterFiles(root: string, filter?: ScanFilter): string[];
+/**
+ * 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 declare function writeCombinedRouteTypes(root: string, knownRouterFiles?: string[], opts?: {
+    preserveIfLarger?: boolean;
+}): void;
+//# sourceMappingURL=generate-route-types.d.ts.map

package/dist/build/generate-route-types.d.ts.map

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