@farm.js/plugin 0.1.0-beta.4 → 0.1.0-beta.42

package/dist/dev-static.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Route segments may legitimately contain dots (e.g. /kinfish/farm.js), so a
+ * dot alone cannot classify a dev request as a static asset. A dotted path is
+ * only treated as an asset when it maps to a real file under the project root
+ * or public dir, matching the filesystem-first behavior of production hosting.
+ */
+export declare function devServableFileExists(pathname: string, baseDirs: Array<string | false | undefined>): boolean;
+//# sourceMappingURL=dev-static.d.ts.map

package/dist/dev-static.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-static.d.ts","sourceRoot":"","sources":["../src/dev-static.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,KAAK,CAAC,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC,GAC1C,OAAO,CAuBT"}

package/dist/dev-static.js

@@ -0,0 +1,37 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+/**
+ * Route segments may legitimately contain dots (e.g. /kinfish/farm.js), so a
+ * dot alone cannot classify a dev request as a static asset. A dotted path is
+ * only treated as an asset when it maps to a real file under the project root
+ * or public dir, matching the filesystem-first behavior of production hosting.
+ */
+export function devServableFileExists(pathname, baseDirs) {
+    let decodedPathname;
+    try {
+        decodedPathname = decodeURIComponent(pathname);
+    }
+    catch {
+        return false;
+    }
+    const relativePathname = decodedPathname.replace(/^\/+/, "");
+    if (!relativePathname)
+        return false;
+    for (const baseDir of baseDirs) {
+        if (typeof baseDir !== "string" || baseDir.length === 0)
+            continue;
+        const resolvedBase = path.resolve(baseDir);
+        const candidate = path.resolve(resolvedBase, relativePathname);
+        if (!candidate.startsWith(resolvedBase + path.sep))
+            continue;
+        try {
+            if (fs.existsSync(candidate) && fs.statSync(candidate).isFile()) {
+                return true;
+            }
+        }
+        catch {
+            // Ignore filesystem errors and keep checking other base dirs.
+        }
+    }
+    return false;
+}

package/dist/index.d.ts

@@ -39,5 +39,5 @@
  * })
  * ```
  */
-export declare const version = "0.1.0-beta.4";
+export declare const version = "0.1.0-beta.42";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,eAAO,MAAM,OAAO,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,eAAO,MAAM,OAAO,kBAAkB,CAAC"}

package/dist/index.js

@@ -39,7 +39,7 @@
  * })
  * ```
  */
-export const version = "0.1.0-beta.4";
+export const version = "0.1.0-beta.42";
 // Note: Import plugins from their respective subpaths:
 // - @farm.js/plugin/rsc
 // - @farm.js/plugin/middleware

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

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

package/dist/middleware/index.js

@@ -15,6 +15,7 @@
  */
 import { createRequire } from "node:module";
 import { _withAfterNodeMiddleware } from "@farm.js/core/after";
+import { devServableFileExists } from "../dev-static.js";
 // Create require for ESM compatibility
 const require_ = createRequire(import.meta.url);
 // Get picocolors with forced color support (to handle NO_COLOR env being set)
@@ -384,11 +385,15 @@ export default function farmMiddleware(options = {}) {
                 server.middlewares.use(_withAfterNodeMiddleware(async (req, res, next) => {
                     const url = req.url || "/";
                     const pathname = url.split("?")[0];
-                    // Skip Vite internal requests
+                    // Skip Vite internal requests and real static assets. Dotted
+                    // paths that don't map to a file on disk are app routes (route
+                    // segments may contain dots) and must still run middleware.
                     if (pathname.startsWith("/@") ||
                         pathname.startsWith("/__") ||
                         pathname.startsWith("/node_modules") ||
-                        (pathname.includes(".") && !pathname.endsWith("/"))) {
+                        (pathname.includes(".") &&
+                            !pathname.endsWith("/") &&
+                            devServableFileExists(pathname, [server.config.publicDir, server.config.root]))) {
                         return next();
                     }
                     try {

package/dist/rsc/automatic-optimized-boundary.d.ts

@@ -0,0 +1,11 @@
+export interface AutomaticOptimizedBoundaryTransform {
+    code: string;
+    boundaryCount: number;
+}
+/**
+ * Wrap React JSX-runtime calls for native host boundaries with Farm's
+ * server-only optimizer. Eligibility is decided against the fully evaluated
+ * React element at runtime, so unsupported trees retain normal React behavior.
+ */
+export declare function transformAutomaticOptimizedBoundaries(code: string, id: string): AutomaticOptimizedBoundaryTransform | null;
+//# sourceMappingURL=automatic-optimized-boundary.d.ts.map

package/dist/rsc/automatic-optimized-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automatic-optimized-boundary.d.ts","sourceRoot":"","sources":["../../src/rsc/automatic-optimized-boundary.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,mCAAmC;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB;AAiGD;;;;GAIG;AACH,wBAAgB,qCAAqC,CACnD,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,mCAAmC,GAAG,IAAI,CA8C5C"}

package/dist/rsc/automatic-optimized-boundary.js

@@ -0,0 +1,162 @@
+import { parseAst } from "vite";
+const JSX_RUNTIME_MODULES = new Set(["react/jsx-runtime", "react/jsx-dev-runtime"]);
+const JSX_FACTORY_EXPORTS = new Set(["jsx", "jsxs", "jsxDEV"]);
+const AUTOMATIC_BOUNDARY_TAGS = new Set([
+    "article",
+    "aside",
+    "div",
+    "footer",
+    "header",
+    "main",
+    "nav",
+    "section",
+    "span",
+]);
+const AUTOMATIC_BOUNDARY_IMPORT = "@farm.js/plugin/rsc/optimized-boundary";
+function nodeName(node) {
+    if (!node || typeof node !== "object")
+        return undefined;
+    const candidate = node;
+    if (typeof candidate.name === "string")
+        return candidate.name;
+    if (typeof candidate.value === "string")
+        return candidate.value;
+    return undefined;
+}
+function isClientModule(body) {
+    for (const statement of body) {
+        if (statement.type === "ImportDeclaration")
+            return false;
+        if (statement.type !== "ExpressionStatement")
+            return false;
+        const expression = statement.expression;
+        if (expression?.type !== "Literal")
+            return false;
+        if (expression.value === "use client")
+            return true;
+    }
+    return false;
+}
+function collectJsxFactories(body) {
+    const factories = new Set();
+    for (const statement of body) {
+        if (statement.type !== "ImportDeclaration")
+            continue;
+        const source = nodeName(statement.source);
+        if (!source || !JSX_RUNTIME_MODULES.has(source))
+            continue;
+        for (const specifier of statement.specifiers || []) {
+            if (specifier.type !== "ImportSpecifier")
+                continue;
+            const imported = nodeName(specifier.imported);
+            const local = nodeName(specifier.local);
+            if (imported && local && JSX_FACTORY_EXPORTS.has(imported))
+                factories.add(local);
+        }
+    }
+    return factories;
+}
+function collectBoundaryCalls(node, factories, calls) {
+    if (!node || typeof node !== "object")
+        return;
+    if (Array.isArray(node)) {
+        for (const child of node)
+            collectBoundaryCalls(child, factories, calls);
+        return;
+    }
+    const candidate = node;
+    if (candidate.type === "CallExpression") {
+        const callee = candidate.callee;
+        const args = candidate.arguments || [];
+        const tag = args[0];
+        if (callee?.type === "Identifier" &&
+            factories.has(nodeName(callee) || "") &&
+            tag?.type === "Literal" &&
+            AUTOMATIC_BOUNDARY_TAGS.has(String(tag.value)) &&
+            typeof candidate.start === "number" &&
+            typeof candidate.end === "number") {
+            calls.push(candidate);
+        }
+    }
+    for (const [key, value] of Object.entries(candidate)) {
+        if (key === "start" || key === "end" || key === "loc")
+            continue;
+        collectBoundaryCalls(value, factories, calls);
+    }
+}
+function createHelperName(code) {
+    const base = "__farmOptimizeBoundary";
+    let name = base;
+    let suffix = 1;
+    while (new RegExp(`\\b${name}\\b`).test(code))
+        name = `${base}${suffix++}`;
+    return name;
+}
+function importInsertionPoint(body) {
+    let position = 0;
+    for (const statement of body) {
+        if (statement.type === "ImportDeclaration" && typeof statement.end === "number") {
+            position = statement.end;
+            continue;
+        }
+        if (statement.type === "ExpressionStatement") {
+            const expression = statement.expression;
+            if (expression?.type === "Literal" && typeof statement.end === "number") {
+                position = statement.end;
+                continue;
+            }
+        }
+        break;
+    }
+    return position;
+}
+/**
+ * Wrap React JSX-runtime calls for native host boundaries with Farm's
+ * server-only optimizer. Eligibility is decided against the fully evaluated
+ * React element at runtime, so unsupported trees retain normal React behavior.
+ */
+export function transformAutomaticOptimizedBoundaries(code, id) {
+    const cleanId = id.split("?", 1)[0].replace(/\\/g, "/");
+    if (!/\.[cm]?[jt]sx?$/.test(cleanId))
+        return null;
+    if (cleanId.includes("/node_modules/") || cleanId.includes("/.farm/"))
+        return null;
+    if (!code.includes("react/jsx-runtime") && !code.includes("react/jsx-dev-runtime"))
+        return null;
+    let ast;
+    try {
+        ast = parseAst(code);
+    }
+    catch {
+        return null;
+    }
+    const body = ast.body || [];
+    if (isClientModule(body))
+        return null;
+    const factories = collectJsxFactories(body);
+    if (factories.size === 0)
+        return null;
+    const calls = [];
+    collectBoundaryCalls(ast, factories, calls);
+    if (calls.length === 0)
+        return null;
+    const helperName = createHelperName(code);
+    const insertions = [];
+    for (const call of calls) {
+        insertions.push({ position: call.start, text: `${helperName}(`, order: 1 });
+        insertions.push({ position: call.end, text: ")", order: 0 });
+    }
+    insertions.push({
+        position: importInsertionPoint(body),
+        text: `${importInsertionPoint(body) === 0 ? "" : "\n"}import { _optimizeBoundary as ${helperName} } from ${JSON.stringify(AUTOMATIC_BOUNDARY_IMPORT)};\n`,
+        order: 2,
+    });
+    let transformed = code;
+    for (const insertion of insertions.sort((left, right) => right.position - left.position || left.order - right.order)) {
+        transformed =
+            transformed.slice(0, insertion.position) +
+                insertion.text +
+                transformed.slice(insertion.position);
+    }
+    return { code: transformed, boundaryCount: calls.length };
+}

package/dist/rsc/entries/client.d.ts

@@ -1,4 +1,5 @@
 import type { EntryContext } from "../types.js";
+export declare const serverFnTransportErrorClientRuntime = "function createFarmServerFnTransportError(value) {\n  const message = value && typeof value === 'object' && typeof value.message === 'string'\n    ? value.message\n    : 'Server function failed';\n  const error = new Error(message);\n\n  if (\n    value &&\n    typeof value === 'object' &&\n    value.name === 'ServerFnFailure' &&\n    typeof value.code === 'string' &&\n    Number.isInteger(value.status) &&\n    value.status >= 400 &&\n    value.status <= 599 &&\n    Object.prototype.hasOwnProperty.call(value, 'data')\n  ) {\n    error.name = 'ServerFnFailure';\n    error.code = value.code;\n    error.status = value.status;\n    error.data = value.data;\n    Object.defineProperty(error, Symbol.for('farm.server-fn.failure'), {\n      value: true,\n      enumerable: false,\n    });\n    return error;\n  }\n\n  error.name = 'ServerActionError';\n  return error;\n}";
 /**
  * Generates the browser entry file.
  *

package/dist/rsc/entries/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/rsc/entries/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAiR7D"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/rsc/entries/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,mCAAmC,62BA6B9C,CAAC;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAiR7D"}

package/dist/rsc/entries/client.js

@@ -1,3 +1,33 @@
+export const serverFnTransportErrorClientRuntime = `function createFarmServerFnTransportError(value) {
+  const message = value && typeof value === 'object' && typeof value.message === 'string'
+    ? value.message
+    : 'Server function failed';
+  const error = new Error(message);
+
+  if (
+    value &&
+    typeof value === 'object' &&
+    value.name === 'ServerFnFailure' &&
+    typeof value.code === 'string' &&
+    Number.isInteger(value.status) &&
+    value.status >= 400 &&
+    value.status <= 599 &&
+    Object.prototype.hasOwnProperty.call(value, 'data')
+  ) {
+    error.name = 'ServerFnFailure';
+    error.code = value.code;
+    error.status = value.status;
+    error.data = value.data;
+    Object.defineProperty(error, Symbol.for('farm.server-fn.failure'), {
+      value: true,
+      enumerable: false,
+    });
+    return error;
+  }
+
+  error.name = 'ServerActionError';
+  return error;
+}`;
 /**
  * Generates the browser entry file.
  *
@@ -45,6 +75,8 @@ import {
     let actionSetup = "";
     if (ctx.actionsEnabled) {
         actionSetup = `
+${serverFnTransportErrorClientRuntime}
+
 // Ref for payload setter (used by server action callback and refetch)
 const setPayloadRef = { current: null };
 
@@ -96,9 +128,7 @@ setServerCallback(async (id, args) => {
   applyFarmCacheInvalidations(p.returnValue?.invalidations);
   if (!p.returnValue || !p.returnValue.ok) {
     debug('Server action failed:', id);
-    const error = new Error(p.returnValue?.data?.message || 'Server function failed');
-    error.name = 'ServerActionError';
-    throw error;
+    throw createFarmServerFnTransportError(p.returnValue?.data);
   }
   return completeFarmServerQueryAction(serverQueryInvocation, p.returnValue.data);
 });

package/dist/rsc/entries/rsc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rsc.d.ts","sourceRoot":"","sources":["../../../src/rsc/entries/rsc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAg7B1D"}
+{"version":3,"file":"rsc.d.ts","sourceRoot":"","sources":["../../../src/rsc/entries/rsc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAs7B1D"}

package/dist/rsc/entries/rsc.js

@@ -642,8 +642,11 @@ async function handleFarmRequest(request) {
         if (request.signal.aborted) {
           return new Response(null, { status: 499, headers: { 'Cache-Control': 'no-store' } });
         }
-        console.error('[Farm.js] Server action failed:', e);
-        returnValue = { ok: false, data: sanitizeServerActionError(e) };
+        const actionError = sanitizeServerActionError(e);
+        if (actionError.name === 'ServerActionError') {
+          console.error('[Farm.js] Server action failed:', e);
+        }
+        returnValue = { ok: false, data: actionError };
         debug('Server action failed:', actionId, e);
       }
     } else {
@@ -674,10 +677,13 @@ async function handleFarmRequest(request) {
         if (request.signal.aborted) {
           return new Response(null, { status: 499, headers: { 'Cache-Control': 'no-store' } });
         }
-        console.error('[Farm.js] Form action failed:', e);
-        debug('Form action failed:', e);
-        return new Response('Server function failed', {
-          status: 500,
+        const actionError = sanitizeServerActionError(e);
+        if (actionError.name === 'ServerActionError') {
+          console.error('[Farm.js] Form action failed:', e);
+        }
+        debug('Form action failed:', actionError);
+        return new Response(actionError.message, {
+          status: actionError.name === 'ServerFnFailure' ? actionError.status : 500,
           headers: {
             'Cache-Control': 'no-store',
             'Content-Type': 'text/plain; charset=utf-8',

package/dist/rsc/index.d.ts

@@ -49,8 +49,9 @@ export interface FarmRscConfig {
          */
         serverActions?: boolean;
         /**
-         * Enable server-only optimized boundaries through
-         * `@farm.js/plugin/rsc/optimized-boundary`.
+         * Automatically optimize eligible server-only host-element subtrees with
+         * the native Strata renderer. Unsupported trees keep normal React
+         * rendering; application components do not need a boundary import.
          *
          * @experimental
          * @default false

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rsc/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAA4B,KAAK,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AAE9E,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AA2B9E,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAExF,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGjE,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACpC,MAAM,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE;QACb;;;WAGG;QACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B;;;WAGG;QACH,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB;;;;;;WAMG;QACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;KAC7B,CAAC;IACF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE;QACR,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,gHAAgH;IAChH,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,GAAE,aAAkB,GAAG,UAAU,CAiDnE;AA8TD;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,OAAO,GAAE,oBAAyB,GAAG,MAAM,EAAE,CAsnC5E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rsc/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAA4B,KAAK,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AAE9E,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AA8B9E,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAExF,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGjE,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACpC,MAAM,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE;QACb;;;WAGG;QACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B;;;WAGG;QACH,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB;;;;;;;WAOG;QACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;KAC7B,CAAC;IACF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE;QACR,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,gHAAgH;IAChH,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,GAAE,aAAkB,GAAG,UAAU,CAiDnE;AA8TD;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,OAAO,GAAE,oBAAyB,GAAG,MAAM,EAAE,CAgqC5E"}

package/dist/rsc/index.js

@@ -26,12 +26,15 @@ import { init as initModuleLexer, parse as parseModuleImports } from "es-module-
 import { farmEnvironmentFunctionsPlugin } from "@farm.js/core/environment/vite";
 import { generateRscEntry } from "./entries/rsc.js";
 import { generateSsrEntry } from "./entries/ssr.js";
-import { generateClientEntry } from "./entries/client.js";
+import { generateClientEntry, serverFnTransportErrorClientRuntime } from "./entries/client.js";
+import { transformFarmRouteActionClients } from "./route-action-transform.js";
 import { transformFarmServerFns } from "./server-fn-transform.js";
+import { transformAutomaticOptimizedBoundaries } from "./automatic-optimized-boundary.js";
 import { resolveRscBuildOutputPath } from "./build-paths.js";
 import { assertRscPackageCompatibility } from "./compatibility.js";
 import fs from "fs/promises";
 import path from "path";
+import { devServableFileExists } from "../dev-static.js";
 import { pathToFileURL } from "node:url";
 import { createRequire } from "node:module";
 // Use API and middleware plugins from @farm.js/core (require so CJS build resolves when ESM .mjs is missing)
@@ -710,6 +713,42 @@ export default function farmRsc(options = {}) {
                 return null;
             },
         },
+        {
+            name: "@farm.js/plugin/rsc:automatic-optimized-boundary",
+            enforce: "post",
+            transform(code, id) {
+                if (!rscEnabled || !optimizedBoundaryEnabled)
+                    return null;
+                const environmentName = this.environment?.name;
+                if (environmentName !== "rsc")
+                    return null;
+                const result = transformAutomaticOptimizedBoundaries(code, id);
+                if (!result)
+                    return null;
+                if (debug) {
+                    console.log(`[Farm.js] Added ${result.boundaryCount} automatic optimized-boundary candidate${result.boundaryCount === 1 ? "" : "s"} in ${id}`);
+                }
+                return { code: result.code, map: null };
+            },
+        },
+        {
+            name: "@farm.js/plugin/rsc:route-action-clients",
+            enforce: "pre",
+            transform(code, id) {
+                if (!rscEnabled || !actionsEnabled)
+                    return null;
+                const environmentName = this.environment?.name;
+                if (environmentName !== "client")
+                    return null;
+                const result = transformFarmRouteActionClients(code, id);
+                if (!result)
+                    return null;
+                return {
+                    code: result.code,
+                    map: null,
+                };
+            },
+        },
         {
             name: "@farm.js/plugin/rsc:server-fn-actions",
             enforce: "pre",
@@ -829,6 +868,7 @@ import {
   createFarmDeploymentRequestHeaders,
   isFarmDeploymentMismatchResponse,
 } from '@farm.js/core/deployment';
+${serverFnTransportErrorClientRuntime}
 const farmDeploymentId = ${JSON.stringify(entryContext.deploymentId)};
 setServerCallback(async (id, args) => {
   const refs = createTemporaryReferenceSet();
@@ -855,9 +895,7 @@ setServerCallback(async (id, args) => {
   if (!res.ok) throw new Error('Server action failed: ' + res.status);
   const p = await createFromReadableStream(res.body, { temporaryReferences: refs });
   if (p?.returnValue?.ok) return p.returnValue.data;
-  const error = new Error(p?.returnValue?.data?.message || 'Server function failed');
-  error.name = 'ServerActionError';
-  throw error;
+  throw createFarmServerFnTransportError(p?.returnValue?.data);
 });
 `
                         : "";
@@ -925,12 +963,16 @@ if (document.readyState === 'loading') {
                         const url = req.url || "/";
                         const pathname = url.split("?")[0];
                         const method = req.method || "GET";
+                        // Dotted paths only skip RSC rendering when they map to a real
+                        // file on disk — route segments may legitimately contain dots.
                         if (pathname.startsWith("/@") ||
                             pathname.startsWith("/__") ||
                             pathname.startsWith("/node_modules") ||
                             pathname.startsWith("/src/") ||
                             pathname.startsWith("/api/") ||
-                            (pathname.includes(".") && !pathname.endsWith("/"))) {
+                            (pathname.includes(".") &&
+                                !pathname.endsWith("/") &&
+                                devServableFileExists(pathname, [server.config.publicDir, server.config.root]))) {
                             return next();
                         }
                         const startTime = Date.now();

package/dist/rsc/optimized-boundary.d.ts

@@ -1,5 +1,6 @@
 import { type RenderOptions, type StrataDocument } from "@farming-labs/strata";
 import { type StaticFragmentBoundary, type StaticFragmentProps } from "@farming-labs/strata/react-server";
+import { type ReactElement } from "react";
 export type { RenderOptions, StrataDocument, StrataElement, StrataNode, StrataTag, StrataText, } from "@farming-labs/strata";
 export interface OptimizedBoundaryProps extends Omit<StaticFragmentProps, "content"> {
     /**
@@ -9,12 +10,20 @@ export interface OptimizedBoundaryProps extends Omit<StaticFragmentProps, "conte
     document: StrataDocument;
     renderOptions?: RenderOptions;
 }
+/**
+ * Internal compiler target for automatic optimized boundaries. This helper is
+ * deliberately fail-open: any unsupported or unsafe tree returns the original
+ * React element unchanged.
+ *
+ * @internal
+ */
+export declare function _optimizeBoundary(element: ReactElement): ReactElement;
 /**
  * Render a typed host-only document with the optimized native runtime and
  * place it inside an opaque React-owned boundary.
  *
  * Enable `experimental.optimizedBoundary` before importing this component.
  */
-export declare function OptimizedBoundary({ document, renderOptions, ...props }: OptimizedBoundaryProps): import("react").ReactElement<any, string | import("react").JSXElementConstructor<any>>;
+export declare function OptimizedBoundary({ document, renderOptions, ...props }: OptimizedBoundaryProps): ReactElement;
 export type OptimizedBoundaryTag = StaticFragmentBoundary;
 //# sourceMappingURL=optimized-boundary.d.ts.map

package/dist/rsc/optimized-boundary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"optimized-boundary.d.ts","sourceRoot":"","sources":["../../src/rsc/optimized-boundary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACvF,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACzB,MAAM,mCAAmC,CAAC;AAE3C,YAAY,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,UAAU,EACV,SAAS,EACT,UAAU,GACX,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC;IAClF;;;OAGG;IACH,QAAQ,EAAE,cAAc,CAAC;IACzB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,KAAK,EAAE,EAAE,sBAAsB,0FAM9F;AAED,MAAM,MAAM,oBAAoB,GAAG,sBAAsB,CAAC"}
+{"version":3,"file":"optimized-boundary.d.ts","sourceRoot":"","sources":["../../src/rsc/optimized-boundary.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,cAAc,EAIpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACzB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAA2C,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAEnF,YAAY,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,UAAU,EACV,SAAS,EACT,UAAU,GACX,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC;IAClF;;;OAGG;IACH,QAAQ,EAAE,cAAc,CAAC;IACzB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAiND;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CAsBrE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,aAAa,EACb,GAAG,KAAK,EACT,EAAE,sBAAsB,GAAG,YAAY,CAMvC;AAED,MAAM,MAAM,oBAAoB,GAAG,sBAAsB,CAAC"}

package/dist/rsc/optimized-boundary.js

@@ -1,5 +1,233 @@
-import { render } from "@farming-labs/strata";
+import { render, } from "@farming-labs/strata";
 import { StaticFragment, } from "@farming-labs/strata/react-server";
+import { createElement, Fragment, isValidElement } from "react";
+const AUTOMATIC_MIN_NODES = 8;
+const AUTOMATIC_MIN_BYTES = 256;
+const AUTOMATIC_BOUNDARIES = new Set([
+    "article",
+    "aside",
+    "div",
+    "footer",
+    "header",
+    "main",
+    "nav",
+    "section",
+    "span",
+]);
+const STRATA_TAGS = new Set([
+    "a",
+    "abbr",
+    "address",
+    "article",
+    "aside",
+    "b",
+    "blockquote",
+    "br",
+    "caption",
+    "cite",
+    "code",
+    "col",
+    "colgroup",
+    "dd",
+    "del",
+    "details",
+    "dfn",
+    "div",
+    "dl",
+    "dt",
+    "em",
+    "figcaption",
+    "figure",
+    "footer",
+    "h1",
+    "h2",
+    "h3",
+    "h4",
+    "h5",
+    "h6",
+    "header",
+    "hr",
+    "i",
+    "img",
+    "ins",
+    "kbd",
+    "li",
+    "main",
+    "mark",
+    "nav",
+    "ol",
+    "p",
+    "pre",
+    "q",
+    "s",
+    "samp",
+    "section",
+    "small",
+    "span",
+    "strong",
+    "sub",
+    "summary",
+    "sup",
+    "table",
+    "tbody",
+    "td",
+    "tfoot",
+    "th",
+    "thead",
+    "time",
+    "tr",
+    "u",
+    "ul",
+    "var",
+    "wbr",
+]);
+const BOOLEAN_ATTRIBUTES = new Set(["hidden", "reversed"]);
+const ATTRIBUTE_NAMES = {
+    className: "class",
+    colSpan: "colspan",
+    dateTime: "datetime",
+    rowSpan: "rowspan",
+};
+function AutomaticOptimizedBoundary({ document, fallback, ...props }) {
+    let content;
+    try {
+        content = render(document);
+    }
+    catch {
+        return fallback;
+    }
+    if (content.nodeCount < AUTOMATIC_MIN_NODES && content.bytes < AUTOMATIC_MIN_BYTES) {
+        return fallback;
+    }
+    return StaticFragment({ ...props, content });
+}
+function attributeValue(name, value) {
+    if (value === null || value === undefined)
+        return undefined;
+    if (typeof value === "string" || typeof value === "number" || typeof value === "bigint") {
+        return String(value);
+    }
+    if (typeof value !== "boolean")
+        return null;
+    if (name.startsWith("aria-") || name.startsWith("data-"))
+        return String(value);
+    if (BOOLEAN_ATTRIBUTES.has(name))
+        return value ? "" : undefined;
+    return null;
+}
+function convertAttributes(tag, props) {
+    const attributes = {};
+    for (const [reactName, rawValue] of Object.entries(props)) {
+        if (reactName === "children")
+            continue;
+        if (reactName === "dangerouslySetInnerHTML" ||
+            reactName === "ref" ||
+            reactName === "style" ||
+            reactName === "suppressHydrationWarning" ||
+            /^on[A-Z]/.test(reactName)) {
+            return null;
+        }
+        const name = ATTRIBUTE_NAMES[reactName] || reactName;
+        const value = attributeValue(name, rawValue);
+        if (value === null)
+            return null;
+        if (value !== undefined)
+            attributes[name] = value;
+    }
+    return Object.keys(attributes).length > 0 ? attributes : {};
+}
+function automaticDocumentFromElement(element) {
+    const rootProps = element.props;
+    const children = [];
+    if (!appendStrataNodes(rootProps.children, children))
+        return null;
+    return { type: "document", ...(children.length > 0 ? { children } : {}) };
+}
+function appendStrataNodes(value, output) {
+    if (value === null || value === undefined || typeof value === "boolean")
+        return true;
+    if (typeof value === "string" || typeof value === "number" || typeof value === "bigint") {
+        output.push({ type: "text", value: String(value) });
+        return true;
+    }
+    if (Array.isArray(value)) {
+        for (const child of value) {
+            if (!appendStrataNodes(child, output))
+                return false;
+        }
+        return true;
+    }
+    if (!isValidElement(value))
+        return false;
+    const element = value;
+    const props = element.props;
+    if (element.type === Fragment)
+        return appendStrataNodes(props.children, output);
+    if (element.type === OptimizedBoundary || element.type === AutomaticOptimizedBoundary) {
+        const boundary = props.as ?? "div";
+        if (typeof boundary !== "string" || !STRATA_TAGS.has(boundary))
+            return false;
+        const { as: _as, document: _document, fallback: _fallback, ...boundaryProps } = props;
+        const attributes = convertAttributes(boundary, boundaryProps);
+        if (!attributes)
+            return false;
+        const document = props.document;
+        if (!document || document.type !== "document")
+            return false;
+        output.push({
+            type: "element",
+            tag: boundary,
+            ...(Object.keys(attributes).length > 0 ? { attributes } : {}),
+            ...(document.children?.length ? { children: document.children } : {}),
+        });
+        return true;
+    }
+    if (typeof element.type !== "string" || !STRATA_TAGS.has(element.type)) {
+        return false;
+    }
+    const tag = element.type;
+    const attributes = convertAttributes(tag, props);
+    if (!attributes)
+        return false;
+    const children = [];
+    if (!appendStrataNodes(props.children, children))
+        return false;
+    output.push({
+        type: "element",
+        tag,
+        ...(Object.keys(attributes).length > 0 ? { attributes } : {}),
+        ...(children.length > 0 ? { children } : {}),
+    });
+    return true;
+}
+/**
+ * Internal compiler target for automatic optimized boundaries. This helper is
+ * deliberately fail-open: any unsupported or unsafe tree returns the original
+ * React element unchanged.
+ *
+ * @internal
+ */
+export function _optimizeBoundary(element) {
+    if (!isValidElement(element) ||
+        typeof element.type !== "string" ||
+        !AUTOMATIC_BOUNDARIES.has(element.type)) {
+        return element;
+    }
+    const props = element.props;
+    if (props.dangerouslySetInnerHTML !== undefined || props.ref !== undefined)
+        return element;
+    const document = automaticDocumentFromElement(element);
+    if (!document)
+        return element;
+    const { children: _children, ...boundaryProps } = props;
+    return createElement(AutomaticOptimizedBoundary, {
+        ...boundaryProps,
+        ...(element.key !== null ? { key: element.key } : {}),
+        as: element.type,
+        document,
+        fallback: element,
+    });
+}
 /**
  * Render a typed host-only document with the optimized native runtime and
  * place it inside an opaque React-owned boundary.

package/dist/rsc/route-action-transform.d.ts

@@ -0,0 +1,11 @@
+export type FarmRouteActionClientTransformResult = {
+    code: string;
+    routes: string[];
+};
+/**
+ * Replace a programmatic route imported by the browser with a small action-only
+ * proxy. Route loaders, components, database imports, and other server code do
+ * not enter the client graph.
+ */
+export declare function transformFarmRouteActionClients(code: string, id: string): FarmRouteActionClientTransformResult | null;
+//# sourceMappingURL=route-action-transform.d.ts.map

package/dist/rsc/route-action-transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-action-transform.d.ts","sourceRoot":"","sources":["../../src/rsc/route-action-transform.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,oCAAoC,GAAG;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAcF;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,oCAAoC,GAAG,IAAI,CAqC7C"}

package/dist/rsc/route-action-transform.js

@@ -0,0 +1,369 @@
+const ROUTE_FACTORY_IMPORT_RE = /\bimport\s+(?:type\s+)?(?:[A-Za-z_$][\w$]*\s*,\s*)?(\{[^}]*\})\s+from\s*["']@farm.js\/core(?:\/routes)?["']\s*;?/g;
+const EXPORTED_ROUTE_RE = /\bexport\s+(?:const|let|var)\s+([A-Za-z_$][\w$]*)\s*=\s*([A-Za-z_$][\w$]*)\s*\(/g;
+const IMPORT_RE = /\bimport\s+(?!type\b)([\s\S]*?)\s+from\s*(["'][^"']+["'])\s*;?/g;
+const IDENTIFIER_RE = /^[A-Za-z_$][\w$]*$/;
+const MODULE_EXT_RE = /\.[cm]?[jt]sx?$/;
+/**
+ * Replace a programmatic route imported by the browser with a small action-only
+ * proxy. Route loaders, components, database imports, and other server code do
+ * not enter the client graph.
+ */
+export function transformFarmRouteActionClients(code, id) {
+    if (!isTransformableModule(id) || !code.includes("createRoute") || !code.includes("actions")) {
+        return null;
+    }
+    const routeFactories = findRouteFactoryImportNames(code);
+    if (routeFactories.size === 0)
+        return null;
+    const routes = findActionRoutes(code, routeFactories, id);
+    if (routes.length === 0)
+        return null;
+    const importStatements = findRuntimeImports(code);
+    const requiredImports = new Set();
+    for (const route of routes) {
+        for (const action of route.actions) {
+            const statement = importStatements.get(action.local);
+            if (!statement) {
+                throw new Error(`[Farm.js] Route "${route.exportName}" action "${action.name}" in ${id} must reference ` +
+                    "a server function imported from another module. Define and export createServerFn in an actions module, then import it into the route.");
+            }
+            requiredImports.add(statement);
+        }
+    }
+    const output = [
+        ...requiredImports,
+        ...routes.map((route) => generateRouteActionProxy(route)),
+        ...findRouteDefaultExports(code, routes),
+    ].join("\n");
+    return {
+        code: `${output}\n`,
+        routes: routes.map((route) => route.exportName),
+    };
+}
+function findRouteFactoryImportNames(code) {
+    const names = new Set();
+    for (const match of code.matchAll(ROUTE_FACTORY_IMPORT_RE)) {
+        const namedImports = (match[1] ?? "").slice(1, -1).split(",");
+        for (const specifier of namedImports) {
+            const normalized = specifier.trim().replace(/^type\s+/, "");
+            const specifierMatch = normalized.match(/^createRoute(?:\s+as\s+([A-Za-z_$][\w$]*))?$/);
+            if (specifierMatch)
+                names.add(specifierMatch[1] ?? "createRoute");
+        }
+    }
+    return names;
+}
+function findActionRoutes(code, factories, id) {
+    const routes = [];
+    for (const match of code.matchAll(EXPORTED_ROUTE_RE)) {
+        const exportName = match[1];
+        const calleeName = match[2];
+        if (!exportName || !calleeName || !factories.has(calleeName))
+            continue;
+        const openParen = (match.index ?? 0) + match[0].length - 1;
+        const closeParen = findMatchingDelimiter(code, openParen, "(", ")");
+        if (closeParen === -1)
+            continue;
+        const args = splitTopLevel(code, openParen + 1, closeParen);
+        if (args.length < 2)
+            continue;
+        const pathSource = readSegment(code, args[0]);
+        if (!isQuotedString(pathSource)) {
+            throw new Error(`[Farm.js] Route "${exportName}" in ${id} must use a static string path before its actions can be imported by a Client Component.`);
+        }
+        const options = readSegment(code, args[1]);
+        if (!options.startsWith("{") || !options.endsWith("}"))
+            continue;
+        const properties = parseObjectProperties(options.slice(1, -1));
+        const actionsSource = properties.get("actions");
+        if (!actionsSource)
+            continue;
+        if (!actionsSource.startsWith("{") || !actionsSource.endsWith("}")) {
+            throw new Error(`[Farm.js] Route "${exportName}" actions in ${id} must be an object literal so Farm can generate its client proxy.`);
+        }
+        const actions = parseActionProperties(actionsSource.slice(1, -1), exportName, id);
+        if (actions.length === 0)
+            continue;
+        const defaultSource = properties.get("defaultAction");
+        const defaultAction = defaultSource
+            ? parseStringValue(defaultSource, exportName, id)
+            : actions[0].name;
+        if (!actions.some((action) => action.name === defaultAction)) {
+            throw new Error(`[Farm.js] Route "${exportName}" defaultAction "${defaultAction}" in ${id} does not match a declared action.`);
+        }
+        routes.push({ exportName, pathSource, actions, defaultAction });
+    }
+    return routes;
+}
+function parseActionProperties(source, routeName, id) {
+    const properties = parseObjectProperties(source, true);
+    const actions = [];
+    for (const [name, value] of properties) {
+        const local = value || name;
+        if (!IDENTIFIER_RE.test(name) || !IDENTIFIER_RE.test(local)) {
+            throw new Error(`[Farm.js] Route "${routeName}" actions in ${id} must use identifier entries such as { update } or { update: updateProduct }.`);
+        }
+        actions.push({ name, local });
+    }
+    return actions;
+}
+function parseObjectProperties(source, allowShorthand = false) {
+    const properties = new Map();
+    for (const segment of splitTopLevel(source, 0, source.length)) {
+        const entry = readSegment(source, segment);
+        if (!entry)
+            continue;
+        if (entry.startsWith("...")) {
+            properties.set(entry, "");
+            continue;
+        }
+        const colon = findTopLevelColon(entry);
+        if (colon === -1) {
+            if (allowShorthand)
+                properties.set(entry, "");
+            continue;
+        }
+        const keySource = entry.slice(0, colon).trim();
+        const value = entry.slice(colon + 1).trim();
+        const key = isQuotedString(keySource) ? unquote(keySource) : keySource;
+        properties.set(key, value);
+    }
+    return properties;
+}
+function findRuntimeImports(code) {
+    const imports = new Map();
+    for (const match of code.matchAll(IMPORT_RE)) {
+        const clause = (match[1] ?? "").trim();
+        const statement = match[0];
+        const namedStart = clause.indexOf("{");
+        const namedEnd = clause.lastIndexOf("}");
+        if (namedStart > -1 && namedEnd > namedStart) {
+            for (const specifier of clause.slice(namedStart + 1, namedEnd).split(",")) {
+                const normalized = specifier.trim().replace(/^type\s+/, "");
+                if (!normalized || specifier.trim().startsWith("type "))
+                    continue;
+                const parts = normalized.split(/\s+as\s+/);
+                const local = parts[1] ?? parts[0];
+                if (local && IDENTIFIER_RE.test(local))
+                    imports.set(local, statement);
+            }
+        }
+        const defaultImport = clause
+            .slice(0, namedStart === -1 ? clause.length : namedStart)
+            .replace(/,$/, "")
+            .trim();
+        if (IDENTIFIER_RE.test(defaultImport))
+            imports.set(defaultImport, statement);
+    }
+    return imports;
+}
+function generateRouteActionProxy(route) {
+    const actions = route.actions
+        .map((action) => `${JSON.stringify(action.name)}: ${action.local}`)
+        .join(", ");
+    const defaultAction = route.actions.find((action) => action.name === route.defaultAction);
+    return `export const ${route.exportName} = Object.freeze({
+  __farmRouteActionTarget: true,
+  path: ${route.pathSource},
+  actions: Object.freeze({ ${actions} }),
+  defaultAction: ${JSON.stringify(route.defaultAction)},
+  action: ${defaultAction.local},
+});`;
+}
+function findRouteDefaultExports(code, routes) {
+    const exports = [];
+    for (const route of routes) {
+        const defaultExport = new RegExp(`\\bexport\\s+default\\s+${escapeRegExp(route.exportName)}\\s*;?`);
+        if (defaultExport.test(code))
+            exports.push(`export default ${route.exportName};`);
+    }
+    return exports;
+}
+function splitTopLevel(source, start, end) {
+    const segments = [];
+    let segmentStart = start;
+    let parens = 0;
+    let braces = 0;
+    let brackets = 0;
+    let quote = null;
+    let escaped = false;
+    let lineComment = false;
+    let blockComment = false;
+    for (let index = start; index < end; index++) {
+        const char = source[index];
+        const next = source[index + 1];
+        if (lineComment) {
+            if (char === "\n" || char === "\r")
+                lineComment = false;
+            continue;
+        }
+        if (blockComment) {
+            if (char === "*" && next === "/") {
+                blockComment = false;
+                index++;
+            }
+            continue;
+        }
+        if (quote) {
+            if (escaped)
+                escaped = false;
+            else if (char === "\\")
+                escaped = true;
+            else if (char === quote)
+                quote = null;
+            continue;
+        }
+        if (char === "/" && next === "/") {
+            lineComment = true;
+            index++;
+            continue;
+        }
+        if (char === "/" && next === "*") {
+            blockComment = true;
+            index++;
+            continue;
+        }
+        if (char === "'" || char === '"' || char === "`") {
+            quote = char;
+            continue;
+        }
+        if (char === "(")
+            parens++;
+        else if (char === ")")
+            parens--;
+        else if (char === "{")
+            braces++;
+        else if (char === "}")
+            braces--;
+        else if (char === "[")
+            brackets++;
+        else if (char === "]")
+            brackets--;
+        else if (char === "," && parens === 0 && braces === 0 && brackets === 0) {
+            segments.push([segmentStart, index]);
+            segmentStart = index + 1;
+        }
+    }
+    segments.push([segmentStart, end]);
+    return segments;
+}
+function findTopLevelColon(source) {
+    const segments = splitTopLevel(source, 0, source.length);
+    if (segments.length !== 1)
+        return -1;
+    let parens = 0;
+    let braces = 0;
+    let brackets = 0;
+    let quote = null;
+    let escaped = false;
+    for (let index = 0; index < source.length; index++) {
+        const char = source[index];
+        if (quote) {
+            if (escaped)
+                escaped = false;
+            else if (char === "\\")
+                escaped = true;
+            else if (char === quote)
+                quote = null;
+            continue;
+        }
+        if (char === "'" || char === '"' || char === "`") {
+            quote = char;
+            continue;
+        }
+        if (char === "(")
+            parens++;
+        else if (char === ")")
+            parens--;
+        else if (char === "{")
+            braces++;
+        else if (char === "}")
+            braces--;
+        else if (char === "[")
+            brackets++;
+        else if (char === "]")
+            brackets--;
+        else if (char === ":" && parens === 0 && braces === 0 && brackets === 0)
+            return index;
+    }
+    return -1;
+}
+function findMatchingDelimiter(source, openIndex, open, close) {
+    let depth = 0;
+    let quote = null;
+    let lineComment = false;
+    let blockComment = false;
+    let escaped = false;
+    for (let index = openIndex; index < source.length; index++) {
+        const char = source[index];
+        const next = source[index + 1];
+        if (lineComment) {
+            if (char === "\n" || char === "\r")
+                lineComment = false;
+            continue;
+        }
+        if (blockComment) {
+            if (char === "*" && next === "/") {
+                blockComment = false;
+                index++;
+            }
+            continue;
+        }
+        if (quote) {
+            if (escaped)
+                escaped = false;
+            else if (char === "\\")
+                escaped = true;
+            else if (char === quote)
+                quote = null;
+            continue;
+        }
+        if (char === "/" && next === "/") {
+            lineComment = true;
+            index++;
+            continue;
+        }
+        if (char === "/" && next === "*") {
+            blockComment = true;
+            index++;
+            continue;
+        }
+        if (char === "'" || char === '"' || char === "`") {
+            quote = char;
+            continue;
+        }
+        if (char === open)
+            depth++;
+        else if (char === close && --depth === 0)
+            return index;
+    }
+    return -1;
+}
+function readSegment(source, segment) {
+    return source.slice(segment[0], segment[1]).trim();
+}
+function parseStringValue(source, routeName, id) {
+    if (!isQuotedString(source)) {
+        throw new Error(`[Farm.js] Route "${routeName}" defaultAction in ${id} must be a static string.`);
+    }
+    return unquote(source);
+}
+function isQuotedString(value) {
+    return (value.length >= 2 &&
+        ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))));
+}
+function unquote(value) {
+    const quote = value[0];
+    const body = value.slice(1, -1);
+    if (quote === '"')
+        return JSON.parse(value);
+    return body.replace(/\\'/g, "'").replace(/\\\\/g, "\\");
+}
+function isTransformableModule(id) {
+    const cleanId = id.split("?", 1)[0];
+    return MODULE_EXT_RE.test(cleanId) && !/\.d\.[cm]?ts$/.test(cleanId);
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farm.js/plugin",
-  "version": "0.1.0-beta.4",
+  "version": "0.1.0-beta.42",
   "description": "Official plugins for Farm.js framework",
   "license": "MIT",
   "author": "Farm.js Team",
@@ -61,7 +61,7 @@
     "nitro": "3.0.1-alpha.0",
     "picocolors": "^1.0.0",
     "rsc-html-stream": "^0.0.4",
-    "@farm.js/core": "0.1.0-beta.4"
+    "@farm.js/core": "0.1.0-beta.42"
   },
   "devDependencies": {
     "@types/node": "^20.19.21",
@@ -82,7 +82,7 @@
     "react-dom": "19.2.8",
     "react-server-dom-webpack": "19.2.8",
     "vite": ">=6.0.0",
-    "@farm.js/core": "0.1.0-beta.4"
+    "@farm.js/core": "0.1.0-beta.42"
   },
   "peerDependenciesMeta": {
     "@vitejs/plugin-rsc": {