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

package/dist/vite/expose-action-id.js

@@ -0,0 +1,250 @@
+import MagicString from "magic-string";
+import path from "node:path";
+import fs from "node:fs";
+import { normalizePath } from "./expose-id-utils.ts";
+/**
+ * Get the RSC plugin's API from Vite config
+ */
+function getRscPluginApi(config) {
+    // Try by name first
+    let plugin = config.plugins.find((p) => p.name === "rsc:minimal");
+    // Fallback: find by API structure if name lookup fails
+    if (!plugin) {
+        plugin = config.plugins.find((p) => p.api?.manager?.serverReferenceMetaMap !==
+            undefined);
+        if (plugin) {
+            console.warn(`[rsc-router:expose-action-id] RSC plugin found by API structure (name: "${plugin.name}"). ` +
+                `Consider updating the name lookup if the plugin was renamed.`);
+        }
+    }
+    return plugin?.api;
+}
+/**
+ * Check if a file is a "use server" module (has the directive at the module level).
+ * This distinguishes module-level server action files from files with inline actions.
+ *
+ * Module-level "use server" files should have their hash replaced with file paths
+ * for revalidation matching. Inline actions (defined in RSC components) should
+ * keep their hashed IDs for client security.
+ */
+function isUseServerModule(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        // Remove leading comments and whitespace to find the first meaningful content
+        const trimmed = content
+            .replace(/^\s*\/\/[^\n]*\n/gm, "") // Remove single-line comments
+            .replace(/^\s*\/\*[\s\S]*?\*\/\s*/gm, "") // Remove multi-line comments
+            .trimStart();
+        // Check if the file starts with "use server" directive
+        return (trimmed.startsWith('"use server"') || trimmed.startsWith("'use server'"));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Transform code to expose action IDs on createServerReference calls.
+ * Wraps each call with an IIFE that attaches $id to the returned function.
+ *
+ * @param code - The source code to transform
+ * @param sourceId - The source file identifier (for sourcemap)
+ * @param hashToFileMap - Optional mapping from hash to file path (for server bundles)
+ */
+function transformServerReferences(code, sourceId, hashToFileMap) {
+    if (!code.includes("createServerReference(")) {
+        return null;
+    }
+    // Match: createServerReference("hash#actionName", ...) or $$ReactClient.createServerReference(...)
+    // The RSC plugin uses $$ReactClient namespace in transformed code
+    const pattern = /((?:\$\$\w+\.)?createServerReference)\(("[^"]+#[^"]+")([^)]*)\)/g;
+    const s = new MagicString(code);
+    let hasChanges = false;
+    let match;
+    while ((match = pattern.exec(code)) !== null) {
+        hasChanges = true;
+        const [fullMatch, fnCall, idArg, rest] = match;
+        const start = match.index;
+        const end = start + fullMatch.length;
+        // Parse the ID to potentially replace hash with file path
+        let finalIdArg = idArg;
+        if (hashToFileMap) {
+            // idArg is like '"hash#actionName"', extract the parts
+            const idValue = idArg.slice(1, -1); // Remove quotes
+            const hashMatch = idValue.match(/^([^#]+)#(.+)$/);
+            if (hashMatch) {
+                const [, hash, actionName] = hashMatch;
+                const filePath = hashToFileMap.get(hash);
+                if (filePath) {
+                    // Replace hash with file path for server-side
+                    finalIdArg = `"${filePath}#${actionName}"`;
+                }
+            }
+        }
+        // Wrap the createServerReference call to attach $$id to the returned function
+        const replacement = `(function(fn) { fn.$$id = ${finalIdArg}; return fn; })(${fnCall}(${idArg}${rest}))`;
+        s.overwrite(start, end, replacement);
+    }
+    if (!hasChanges) {
+        return null;
+    }
+    return {
+        code: s.toString(),
+        map: s.generateMap({ source: sourceId, includeContent: true }),
+    };
+}
+/**
+ * Transform registerServerReference calls in server bundles to use file paths instead of hashes.
+ * Pattern: registerServerReference(fn, "hash", "exportName")
+ * React's registerServerReference sets $$id = hash + "#" + exportName
+ * By replacing the hash with file path, $$id will contain the file path for revalidation matching.
+ *
+ * Only actions from module-level "use server" files are transformed.
+ * Inline actions (defined in RSC components with "use server" inside a function) are NOT in
+ * hashToFileMap and keep their hashed IDs. This is intentional for client security:
+ * - Module-level "use server" files: shared action modules, file path helps revalidation
+ * - Inline actions: one-off actions in RSC, hash ID prevents file path exposure to client
+ *
+ * @param code - The source code to transform
+ * @param sourceId - The source file identifier (for sourcemap)
+ * @param hashToFileMap - Mapping from hash to file path (only module-level "use server" files)
+ */
+function transformRegisterServerReference(code, sourceId, hashToFileMap) {
+    if (!hashToFileMap || !code.includes("registerServerReference(")) {
+        return null;
+    }
+    // Match: registerServerReference(fn, "hash", "exportName")
+    // The hash is the second argument, exportName is the third
+    const pattern = /registerServerReference\(([^,]+),\s*"([^"]+)",\s*"([^"]+)"\)/g;
+    const s = new MagicString(code);
+    let hasChanges = false;
+    let match;
+    while ((match = pattern.exec(code)) !== null) {
+        const [fullMatch, fnArg, hash, exportName] = match;
+        const start = match.index;
+        const end = start + fullMatch.length;
+        // Look up the file path for this hash
+        const filePath = hashToFileMap.get(hash);
+        if (filePath) {
+            hasChanges = true;
+            // WRAP the call to add $id property with file path
+            // Keep the original hash for React's action registry (so loadServerAction works)
+            // Add $id (single dollar) with file path for revalidation matching
+            // Note: We use $id instead of $$id because React's registerServerReference
+            // sets $$id as a non-writable property
+            const filePathId = `${filePath}#${exportName}`;
+            const replacement = `(function(fn) { fn.$id = "${filePathId}"; return fn; })(registerServerReference(${fnArg}, "${hash}", "${exportName}"))`;
+            s.overwrite(start, end, replacement);
+        }
+    }
+    if (!hasChanges) {
+        return null;
+    }
+    return {
+        code: s.toString(),
+        map: s.generateMap({ source: sourceId, includeContent: true }),
+    };
+}
+/**
+ * Vite plugin that exposes action IDs on server reference functions.
+ *
+ * When React Server Components creates server references via createServerReference(),
+ * the action ID (format: "hash#actionName") is passed as the first argument but not
+ * exposed on the returned function. This plugin transforms the output to attach
+ * the $id property to each server reference function, enabling the router to
+ * identify which action was called during revalidation.
+ *
+ * Server bundles (RSC/SSR) get file paths in $id for filtering (e.g., "src/actions.ts#add").
+ * Client bundles keep hashed IDs for security (e.g., "ec387bc704d4#add").
+ *
+ * Works in:
+ * - Build mode: uses renderChunk to transform bundled chunks
+ * - Dev mode: uses transform with enforce:"post" to transform after RSC plugin
+ */
+export function exposeActionId() {
+    let config;
+    let isBuild = false;
+    let hashToFileMap;
+    let rscPluginApi;
+    return {
+        name: "@rangojs/router:expose-action-id",
+        // Run after all other plugins (including RSC plugin's transforms)
+        enforce: "post",
+        configResolved(resolvedConfig) {
+            config = resolvedConfig;
+            isBuild = config.command === "build";
+            // Get RSC plugin API - rsc-router requires @vitejs/plugin-rsc
+            rscPluginApi = getRscPluginApi(config);
+        },
+        buildStart() {
+            // Verify RSC plugin is present at build start (after all config hooks have run)
+            // This allows rsc-router:rsc-integration to dynamically add the RSC plugin
+            if (!rscPluginApi) {
+                rscPluginApi = getRscPluginApi(config);
+            }
+            if (!rscPluginApi) {
+                throw new Error("[rsc-router] Could not find @vitejs/plugin-rsc. " +
+                    "@rangojs/router requires the Vite RSC plugin.\n" +
+                    "The RSC plugin should be included automatically. If you disabled it with\n" +
+                    "rango({ rsc: false }), add rsc() before rango() in your config.");
+            }
+            if (!isBuild)
+                return;
+            hashToFileMap = new Map();
+            const { serverReferenceMetaMap } = rscPluginApi.manager;
+            for (const [absolutePath, meta] of Object.entries(serverReferenceMetaMap)) {
+                // Only include module-level "use server" files
+                // Inline actions (defined in RSC components) should keep hashed IDs for client security
+                if (!isUseServerModule(absolutePath)) {
+                    continue;
+                }
+                const relativePath = normalizePath(path.relative(config.root, absolutePath));
+                // The referenceKey in build mode is the hash
+                // Map hash -> relative file path
+                hashToFileMap.set(meta.referenceKey, relativePath);
+            }
+        },
+        // Dev mode only: transform hook runs after RSC plugin creates server references
+        // In dev mode, IDs already contain file paths, not hashes
+        transform(code, id) {
+            // Skip in build mode - renderChunk handles it
+            if (isBuild) {
+                return;
+            }
+            // Quick bail-out: only process if code has createServerReference
+            if (!code.includes("createServerReference(")) {
+                return;
+            }
+            // Skip node_modules
+            if (id.includes("/node_modules/")) {
+                return;
+            }
+            // Dev mode: no hash-to-file mapping needed (IDs are already file paths)
+            return transformServerReferences(code, id);
+        },
+        // Build mode: renderChunk runs after all transforms and bundling complete
+        renderChunk(code, chunk) {
+            // Only RSC bundle should get file paths for revalidation matching
+            // SSR bundle must NOT use file paths because client components run there
+            // and need to match the client bundle during hydration (otherwise: error #418)
+            const isRscEnv = this.environment?.name === "rsc";
+            // Only use file path mapping for RSC environment
+            const effectiveMap = isRscEnv ? hashToFileMap : undefined;
+            // Transform createServerReference calls (client-side)
+            const result = transformServerReferences(code, chunk.fileName, effectiveMap);
+            // For RSC bundles, also transform registerServerReference calls
+            // This replaces hashed IDs with file paths so $id contains the actual path
+            if (isRscEnv && hashToFileMap) {
+                const codeToTransform = result ? result.code : code;
+                const registerResult = transformRegisterServerReference(codeToTransform, chunk.fileName, hashToFileMap);
+                if (registerResult) {
+                    return { code: registerResult.code, map: registerResult.map };
+                }
+            }
+            if (result) {
+                return { code: result.code, map: result.map };
+            }
+            return null;
+        },
+    };
+}
+//# sourceMappingURL=expose-action-id.js.map

package/dist/vite/expose-action-id.js.map

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

package/dist/vite/expose-id-utils.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Normalize path to forward slashes.
+ */
+export declare function normalizePath(p: string): string;
+/**
+ * Generate a short hash for an ID.
+ * Uses first 8 chars of SHA-256 hash for uniqueness while keeping IDs short.
+ * Appends export name for easier debugging in production: "abc123#ExportName"
+ */
+export declare function hashId(filePath: string, exportName: string): string;
+/**
+ * Generate an 8-char hex hash for an inline static handler call site.
+ * Uses file path and line number (plus optional index for same-line collisions).
+ */
+export declare function hashInlineId(filePath: string, lineNumber: number, index?: number): string;
+export interface DetectedImports {
+    loader: boolean;
+    handle: boolean;
+    locationState: boolean;
+    prerenderHandler: boolean;
+    staticHandler: boolean;
+    router: boolean;
+    any: boolean;
+}
+/**
+ * Build a map from local binding name to exported names by walking
+ * ExportNamedDeclaration nodes. Handles `export const X`, `export { X }`,
+ * and `export { X as Y }`. Skips re-exports (`export { X } from "..."`).
+ */
+export declare function buildExportMap(program: any): Map<string, string[]>;
+/**
+ * Single-pass detection of all create* imports from @rangojs/router.
+ * Returns which create functions are imported so we can skip unnecessary transforms.
+ */
+export declare function detectImports(code: string): DetectedImports;
+/**
+ * Skip past a string literal, template literal, or comment starting at pos.
+ * Returns the index after the closing delimiter, or pos if not at a
+ * string/comment start. Handles escape sequences and nested ${} in templates.
+ */
+export declare function skipStringOrComment(code: string, pos: number): number;
+/**
+ * Find the matching closing paren starting after an already-opened paren.
+ * Skips strings, template literals, and comments so parens inside them
+ * don't affect depth tracking. Returns the index after the closing paren.
+ */
+export declare function findMatchingParen(code: string, startPos: number): number;
+/**
+ * Count the number of top-level arguments in a function call.
+ * Skips nested parens, brackets, braces, strings, and comments.
+ */
+export declare function countArgs(code: string, startPos: number, endPos: number): number;
+/**
+ * Find the end of a statement: skip whitespace and optional semicolon after
+ * a closing paren position.
+ */
+export declare function findStatementEnd(code: string, pos: number): number;
+/**
+ * Simple depth-counter paren matching. Does NOT skip strings/comments.
+ * Used by loader and handle transforms where the simpler approach suffices.
+ * Returns the index after the closing paren.
+ */
+export declare function findClosingParen(code: string, startPos: number): number;
+/**
+ * Count arguments using simple depth counting (no string/comment awareness).
+ * Used by the loader transform where the original code used this simpler approach.
+ */
+export declare function countArgsSimple(code: string, startPos: number, endPos: number): number;
+//# sourceMappingURL=expose-id-utils.d.ts.map

package/dist/vite/expose-id-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expose-id-utils.d.ts","sourceRoot":"","sources":["../../src/vite/expose-id-utils.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAInE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAMR;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAqClE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CA2C3D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAuDrE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAcxE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,MAAM,CA6BR;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CASlE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CASvE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,MAAM,CAoBR"}

package/dist/vite/expose-id-utils.js

@@ -0,0 +1,289 @@
+import path from "node:path";
+import crypto from "node:crypto";
+/**
+ * Normalize path to forward slashes.
+ */
+export function normalizePath(p) {
+    return p.split(path.sep).join("/");
+}
+/**
+ * Generate a short hash for an ID.
+ * Uses first 8 chars of SHA-256 hash for uniqueness while keeping IDs short.
+ * Appends export name for easier debugging in production: "abc123#ExportName"
+ */
+export function hashId(filePath, exportName) {
+    const input = `${filePath}#${exportName}`;
+    const hash = crypto.createHash("sha256").update(input).digest("hex");
+    return `${hash.slice(0, 8)}#${exportName}`;
+}
+/**
+ * Generate an 8-char hex hash for an inline static handler call site.
+ * Uses file path and line number (plus optional index for same-line collisions).
+ */
+export function hashInlineId(filePath, lineNumber, index) {
+    const input = index !== undefined && index > 0
+        ? `${filePath}:${lineNumber}:${index}`
+        : `${filePath}:${lineNumber}`;
+    return crypto.createHash("sha256").update(input).digest("hex").slice(0, 8);
+}
+/**
+ * Build a map from local binding name to exported names by walking
+ * ExportNamedDeclaration nodes. Handles `export const X`, `export { X }`,
+ * and `export { X as Y }`. Skips re-exports (`export { X } from "..."`).
+ */
+export function buildExportMap(program) {
+    const exportMap = new Map();
+    const pushExport = (local, exported) => {
+        const list = exportMap.get(local);
+        if (list) {
+            if (!list.includes(exported))
+                list.push(exported);
+            return;
+        }
+        exportMap.set(local, [exported]);
+    };
+    for (const node of program.body ?? []) {
+        if (node?.type !== "ExportNamedDeclaration")
+            continue;
+        if (node.declaration?.type === "VariableDeclaration") {
+            for (const decl of node.declaration.declarations ?? []) {
+                if (decl?.id?.type === "Identifier") {
+                    pushExport(decl.id.name, decl.id.name);
+                }
+            }
+        }
+        if (!node.source && Array.isArray(node.specifiers)) {
+            for (const spec of node.specifiers) {
+                if (spec?.type === "ExportSpecifier" &&
+                    spec.local?.type === "Identifier" &&
+                    spec.exported?.type === "Identifier") {
+                    pushExport(spec.local.name, spec.exported.name);
+                }
+            }
+        }
+    }
+    return exportMap;
+}
+/**
+ * Single-pass detection of all create* imports from @rangojs/router.
+ * Returns which create functions are imported so we can skip unnecessary transforms.
+ */
+export function detectImports(code) {
+    // Extract all import declarations from @rangojs/router in one scan
+    const importPattern = /import\s*\{([^}]*)\}\s*from\s*["']@rangojs\/router(?:\/[^"']*)?["']/g;
+    const result = {
+        loader: false,
+        handle: false,
+        locationState: false,
+        prerenderHandler: false,
+        staticHandler: false,
+        router: false,
+        any: false,
+    };
+    let match;
+    while ((match = importPattern.exec(code)) !== null) {
+        const imports = match[1];
+        if (/\bcreateLoader\b/.test(imports))
+            result.loader = true;
+        if (/\bcreateHandle\b/.test(imports))
+            result.handle = true;
+        if (/\bcreateLocationState\b/.test(imports))
+            result.locationState = true;
+        if (/\bPrerender\b/.test(imports))
+            result.prerenderHandler = true;
+        if (/\bStatic\b/.test(imports))
+            result.staticHandler = true;
+        if (/\bcreateRouter\b/.test(imports))
+            result.router = true;
+    }
+    // createRouter has a stricter check: only from "@rangojs/router" (not sub-paths)
+    if (result.router) {
+        result.router =
+            /import\s*\{[^}]*\bcreateRouter\b[^}]*\}\s*from\s*["']@rangojs\/router["']/.test(code);
+    }
+    result.any =
+        result.loader ||
+            result.handle ||
+            result.locationState ||
+            result.prerenderHandler ||
+            result.staticHandler ||
+            result.router;
+    return result;
+}
+/**
+ * Skip past a string literal, template literal, or comment starting at pos.
+ * Returns the index after the closing delimiter, or pos if not at a
+ * string/comment start. Handles escape sequences and nested ${} in templates.
+ */
+export function skipStringOrComment(code, pos) {
+    const ch = code[pos];
+    if (ch === '"' || ch === "'") {
+        for (let j = pos + 1; j < code.length; j++) {
+            if (code[j] === "\\") {
+                j++;
+                continue;
+            }
+            if (code[j] === ch)
+                return j + 1;
+        }
+        return code.length;
+    }
+    if (ch === "`") {
+        let j = pos + 1;
+        while (j < code.length) {
+            if (code[j] === "\\") {
+                j += 2;
+                continue;
+            }
+            if (code[j] === "`")
+                return j + 1;
+            if (code[j] === "$" && j + 1 < code.length && code[j + 1] === "{") {
+                j += 2;
+                let braceDepth = 1;
+                while (j < code.length && braceDepth > 0) {
+                    const inner = skipStringOrComment(code, j);
+                    if (inner > j) {
+                        j = inner;
+                        continue;
+                    }
+                    if (code[j] === "{")
+                        braceDepth++;
+                    else if (code[j] === "}")
+                        braceDepth--;
+                    if (braceDepth > 0)
+                        j++;
+                }
+                if (braceDepth === 0)
+                    j++;
+                continue;
+            }
+            j++;
+        }
+        return j;
+    }
+    if (ch === "/" && pos + 1 < code.length) {
+        if (code[pos + 1] === "/") {
+            const eol = code.indexOf("\n", pos + 2);
+            return eol === -1 ? code.length : eol + 1;
+        }
+        if (code[pos + 1] === "*") {
+            const end = code.indexOf("*/", pos + 2);
+            return end === -1 ? code.length : end + 2;
+        }
+    }
+    return pos;
+}
+/**
+ * Find the matching closing paren starting after an already-opened paren.
+ * Skips strings, template literals, and comments so parens inside them
+ * don't affect depth tracking. Returns the index after the closing paren.
+ */
+export function findMatchingParen(code, startPos) {
+    let depth = 1;
+    let i = startPos;
+    while (i < code.length && depth > 0) {
+        const skipped = skipStringOrComment(code, i);
+        if (skipped > i) {
+            i = skipped;
+            continue;
+        }
+        if (code[i] === "(")
+            depth++;
+        if (code[i] === ")")
+            depth--;
+        i++;
+    }
+    return i;
+}
+/**
+ * Count the number of top-level arguments in a function call.
+ * Skips nested parens, brackets, braces, strings, and comments.
+ */
+export function countArgs(code, startPos, endPos) {
+    let depth = 0;
+    let argCount = 0;
+    let hasContent = false;
+    let i = startPos;
+    while (i < endPos) {
+        const skipped = skipStringOrComment(code, i);
+        if (skipped > i) {
+            hasContent = true;
+            i = skipped;
+            continue;
+        }
+        const char = code[i];
+        if (char === "(" || char === "[" || char === "{") {
+            depth++;
+            hasContent = true;
+        }
+        else if (char === ")" || char === "]" || char === "}") {
+            depth--;
+        }
+        else if (char === "," && depth === 0) {
+            argCount++;
+        }
+        else if (!/\s/.test(char)) {
+            hasContent = true;
+        }
+        i++;
+    }
+    return hasContent ? argCount + 1 : 0;
+}
+/**
+ * Find the end of a statement: skip whitespace and optional semicolon after
+ * a closing paren position.
+ */
+export function findStatementEnd(code, pos) {
+    let i = pos;
+    while (i < code.length && /\s/.test(code[i])) {
+        i++;
+    }
+    if (i < code.length && code[i] === ";") {
+        i++;
+    }
+    return i;
+}
+/**
+ * Simple depth-counter paren matching. Does NOT skip strings/comments.
+ * Used by loader and handle transforms where the simpler approach suffices.
+ * Returns the index after the closing paren.
+ */
+export function findClosingParen(code, startPos) {
+    let depth = 1;
+    let i = startPos;
+    while (i < code.length && depth > 0) {
+        if (code[i] === "(")
+            depth++;
+        if (code[i] === ")")
+            depth--;
+        i++;
+    }
+    return i;
+}
+/**
+ * Count arguments using simple depth counting (no string/comment awareness).
+ * Used by the loader transform where the original code used this simpler approach.
+ */
+export function countArgsSimple(code, startPos, endPos) {
+    let depth = 0;
+    let argCount = 0;
+    let hasContent = false;
+    for (let i = startPos; i < endPos; i++) {
+        const char = code[i];
+        if (char === "(" || char === "[" || char === "{") {
+            depth++;
+            hasContent = true;
+        }
+        else if (char === ")" || char === "]" || char === "}") {
+            depth--;
+        }
+        else if (char === "," && depth === 0) {
+            argCount++;
+        }
+        else if (!/\s/.test(char)) {
+            hasContent = true;
+        }
+    }
+    return hasContent ? argCount + 1 : 0;
+}
+//# sourceMappingURL=expose-id-utils.js.map

package/dist/vite/expose-id-utils.js.map

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

package/dist/vite/expose-internal-ids.d.ts

@@ -0,0 +1,22 @@
+import type { Plugin } from "vite";
+export interface ExposeInternalIdsApi {
+    /** Tracks absolute module IDs that contain prerender handler exports.
+     *  key: absolute module ID (filesystem path)
+     *  value: array of export names (e.g., ["ArticlesIndex", "ArticleDetail"]) */
+    prerenderHandlerModules: Map<string, string[]>;
+    /** Tracks absolute module IDs that contain static handler exports.
+     *  key: absolute module ID (filesystem path)
+     *  value: array of export names (e.g., ["DocsNav", "DocShell"]) */
+    staticHandlerModules: Map<string, string[]>;
+}
+/**
+ * Inject stable $$id into createRouter() calls at compile time.
+ * This must be a separate plugin without enforce:"post" because running
+ * at "post" priority changes Vite's dep optimization timing and can cause
+ * ERR_OUTDATED_OPTIMIZED_DEP / React dual-instance issues.
+ */
+export declare function exposeRouterId(): Plugin;
+export declare function exposeInternalIds(options?: {
+    forceBuild?: boolean;
+}): Plugin;
+//# sourceMappingURL=expose-internal-ids.d.ts.map

package/dist/vite/expose-internal-ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expose-internal-ids.d.ts","sourceRoot":"","sources":["../../src/vite/expose-internal-ids.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,MAAM,CAAC;AA8VnD,MAAM,WAAW,oBAAoB;IACnC;;kFAE8E;IAC9E,uBAAuB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/C;;uEAEmE;IACnE,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC7C;AA0UD;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAuBvC;AAMD,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE;IAC1C,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,MAAM,CAwbT"}