@farm.js/core 0.1.49 → 0.1.50

package/dist/app-markdown.d.ts

@@ -1,11 +1,10 @@
-import { g as FarmMdxComponents, h as FarmMdxResolvedConfig, i as RouteModule } from './client-plugins-DFDQUI9Q.js';
-export { j as FARM_MARKDOWN_CONTENT_TYPE, m as FarmMdxComponent, n as FarmMdxUserConfig, k as createFarmMarkdownErrorBody, l as farmRequestWantsMarkdown, r as resolveFarmMdxComponentsModulePath, o as resolveMdxConfig } from './client-plugins-DFDQUI9Q.js';
+import { g as FarmMdxComponents, h as FarmMdxResolvedConfig, i as RouteModule } from './client-plugins-BPfltM5m.js';
+export { j as FARM_MARKDOWN_CONTENT_TYPE, m as FarmMdxComponent, n as FarmMdxUserConfig, k as createFarmMarkdownErrorBody, l as farmRequestWantsMarkdown, r as resolveFarmMdxComponentsModulePath, o as resolveMdxConfig } from './client-plugins-BPfltM5m.js';
 export { FARM_MARKDOWN_ANONYMOUS_CLIENT_ADDRESS, FarmMarkdownPageModuleInput, FarmMarkdownPageSource, createFarmMarkdownRouteModule, createFarmMarkdownSourceResponse, createMarkdownMetadata, isFarmMarkdownPageFile, isFarmMarkdownPublicSourceResponse, normalizeFarmMarkdownRoutePath, parseMarkdownFrontmatter, titleFromMarkdown } from './internal/app-markdown-runtime.js';
-import './lifecycle-DK06VuKP.js';
+import './lifecycle-C2aLBOwu.js';
 import './route-DFhZj6jN.js';
 import './endpoint-BgHn0lhl.js';
 import './cache.js';
-import './cache-invalidation-BD0z_lfu.js';
 import './renderer.js';
 import './deployment.js';
 import 'http';
@@ -22,15 +21,16 @@ import '@farming-labs/docs';
 import './observability-B2363jB6.js';
 import '@opentelemetry/api';
 import 'vite';
-import './workflows-Df1C_7OG.js';
+import './workflows-CRMzQZ3k.js';
 import './cron.js';
 import './env.js';
 import './server-action-security.js';
-import './layers-D9fbe-rz.js';
+import './layers-CcS42OGR.js';
 import 'rolldown/utils';
 import 'rolldown';
 import './image-config-CeDgNyX4.js';
-import './types--Wh02r5_.js';
+import './types-C41ePjvP.js';
+import './config-CnhyvvmT.js';
 import './types-DQnyD3VD.js';
 import './font.js';
 

package/dist/cache.d.mts

@@ -1,5 +1,3 @@
-export { a as applyFarmCacheInvalidations } from './cache-invalidation-BD0z_lfu.mjs';
-
 /**
  * Cache key serialization, kept free of server imports: browser code such as
  * the client data cache builds the same keys, and importing `./cache` would
@@ -9,6 +7,9 @@ type RouteDataCacheKey = string | readonly unknown[];
 declare function createRouteDataCacheKey(key: RouteDataCacheKey): string;
 declare function createFarmCacheKey(parts: readonly unknown[]): string;
 
+type FarmCacheInvalidationSource = "local" | "broadcast" | "live";
+declare function applyFarmCacheInvalidations(keys: unknown, source?: FarmCacheInvalidationSource): void;
+
 interface FarmCacheInvalidationStreamOptions {
     /** Stop the stream when the owning request is aborted. */
     signal?: AbortSignal;
@@ -329,4 +330,4 @@ declare function createPathCacheTag(routePath: string): string;
 declare function createRouteDataCacheTag(key: RouteDataCacheKey): string;
 declare function normalizeRevalidatePath(routePath: string): string;
 
-export { type CacheKeyFactory, type DefinedCacheKey, type FarmCacheAdapter, type FarmCacheEntry, type FarmCacheInvalidationStreamOptions, type FarmCacheInvalidationTarget, type FarmCacheOptions, type FarmCacheSetOptions, type FarmCacheStorage, type FarmCacheUserConfig, type FarmClientCacheUserConfig, FarmDataCache, type GetFarmCacheEntryOptions, type InferCacheKeyData, PPR_SHELL_ADAPTER_TTL_SECONDS, type RevalidateTagProfile, type RouteDataCacheKey, type StorageFarmCacheAdapterOptions, applyFarmCacheInvalidationTargets, configureFarmCache, createFarmCacheInvalidationStream, createFarmCacheKey, createPathCacheTag, createRouteDataCacheKey, createRouteDataCacheTag, defineCacheKey, getFarmDataCache, invalidate, invalidateRouteData, normalizeRevalidatePath, revalidatePath, revalidateTag, storageCacheAdapter, unstable_cache, updateTag };
+export { type CacheKeyFactory, type DefinedCacheKey, type FarmCacheAdapter, type FarmCacheEntry, type FarmCacheInvalidationStreamOptions, type FarmCacheInvalidationTarget, type FarmCacheOptions, type FarmCacheSetOptions, type FarmCacheStorage, type FarmCacheUserConfig, type FarmClientCacheUserConfig, FarmDataCache, type GetFarmCacheEntryOptions, type InferCacheKeyData, PPR_SHELL_ADAPTER_TTL_SECONDS, type RevalidateTagProfile, type RouteDataCacheKey, type StorageFarmCacheAdapterOptions, applyFarmCacheInvalidationTargets, applyFarmCacheInvalidations, configureFarmCache, createFarmCacheInvalidationStream, createFarmCacheKey, createPathCacheTag, createRouteDataCacheKey, createRouteDataCacheTag, defineCacheKey, getFarmDataCache, invalidate, invalidateRouteData, normalizeRevalidatePath, revalidatePath, revalidateTag, storageCacheAdapter, unstable_cache, updateTag };

package/dist/cache.d.ts

@@ -1,5 +1,3 @@
-export { a as applyFarmCacheInvalidations } from './cache-invalidation-BD0z_lfu.js';
-
 /**
  * Cache key serialization, kept free of server imports: browser code such as
  * the client data cache builds the same keys, and importing `./cache` would
@@ -9,6 +7,9 @@ type RouteDataCacheKey = string | readonly unknown[];
 declare function createRouteDataCacheKey(key: RouteDataCacheKey): string;
 declare function createFarmCacheKey(parts: readonly unknown[]): string;
 
+type FarmCacheInvalidationSource = "local" | "broadcast" | "live";
+declare function applyFarmCacheInvalidations(keys: unknown, source?: FarmCacheInvalidationSource): void;
+
 interface FarmCacheInvalidationStreamOptions {
     /** Stop the stream when the owning request is aborted. */
     signal?: AbortSignal;
@@ -329,4 +330,4 @@ declare function createPathCacheTag(routePath: string): string;
 declare function createRouteDataCacheTag(key: RouteDataCacheKey): string;
 declare function normalizeRevalidatePath(routePath: string): string;
 
-export { type CacheKeyFactory, type DefinedCacheKey, type FarmCacheAdapter, type FarmCacheEntry, type FarmCacheInvalidationStreamOptions, type FarmCacheInvalidationTarget, type FarmCacheOptions, type FarmCacheSetOptions, type FarmCacheStorage, type FarmCacheUserConfig, type FarmClientCacheUserConfig, FarmDataCache, type GetFarmCacheEntryOptions, type InferCacheKeyData, PPR_SHELL_ADAPTER_TTL_SECONDS, type RevalidateTagProfile, type RouteDataCacheKey, type StorageFarmCacheAdapterOptions, applyFarmCacheInvalidationTargets, configureFarmCache, createFarmCacheInvalidationStream, createFarmCacheKey, createPathCacheTag, createRouteDataCacheKey, createRouteDataCacheTag, defineCacheKey, getFarmDataCache, invalidate, invalidateRouteData, normalizeRevalidatePath, revalidatePath, revalidateTag, storageCacheAdapter, unstable_cache, updateTag };
+export { type CacheKeyFactory, type DefinedCacheKey, type FarmCacheAdapter, type FarmCacheEntry, type FarmCacheInvalidationStreamOptions, type FarmCacheInvalidationTarget, type FarmCacheOptions, type FarmCacheSetOptions, type FarmCacheStorage, type FarmCacheUserConfig, type FarmClientCacheUserConfig, FarmDataCache, type GetFarmCacheEntryOptions, type InferCacheKeyData, PPR_SHELL_ADAPTER_TTL_SECONDS, type RevalidateTagProfile, type RouteDataCacheKey, type StorageFarmCacheAdapterOptions, applyFarmCacheInvalidationTargets, applyFarmCacheInvalidations, configureFarmCache, createFarmCacheInvalidationStream, createFarmCacheKey, createPathCacheTag, createRouteDataCacheKey, createRouteDataCacheTag, defineCacheKey, getFarmDataCache, invalidate, invalidateRouteData, normalizeRevalidatePath, revalidatePath, revalidateTag, storageCacheAdapter, unstable_cache, updateTag };

package/dist/{chunk-VJXLUTBM.mjs → chunk-2DEPNLXK.mjs}

@@ -48,30 +48,30 @@ import {
   loadFarmConfigFile,
   resolveFarmLayers
 } from "./chunk-52Y3C3HG.mjs";
+import {
+  resolveMdxConfig
+} from "./chunk-UIJOLBUL.mjs";
 import {
   bundleNodeModule
 } from "./chunk-VFXE6NWR.mjs";
 import {
   resolveWorkflowsConfig
-} from "./chunk-ATHPRVP2.mjs";
+} from "./chunk-5V4KZOZO.mjs";
 import {
   resolveCronConfig
 } from "./chunk-UCQ52TJY.mjs";
 import {
   resolveServerActionsConfig
-} from "./chunk-JOHXK4BB.mjs";
+} from "./chunk-BW6SCVYX.mjs";
 import {
   resolveFarmThemeConfig
 } from "./chunk-YWPNIYUP.mjs";
-import {
-  resolveMdxConfig
-} from "./chunk-UIJOLBUL.mjs";
 import {
   resolveMarkdownConfig
 } from "./chunk-N77JBPLC.mjs";
 import {
   resolveIntegrationPlugins
-} from "./chunk-NW2BKDVT.mjs";
+} from "./chunk-HHFMECFO.mjs";
 import {
   compileMiddlewareConfig
 } from "./chunk-EDPENAVO.mjs";
@@ -83,7 +83,7 @@ import {
 } from "./chunk-2SVJGOAX.mjs";
 import {
   resolveFarmServerConfig
-} from "./chunk-C6U66WWF.mjs";
+} from "./chunk-GFT5AHAT.mjs";
 import {
   resolveFarmAPIConfig
 } from "./chunk-BLD5GVCG.mjs";

package/dist/chunk-2G63BIRL.mjs

@@ -0,0 +1,227 @@
+import {
+  writeFileIfChanged
+} from "./chunk-Q5B4LNON.mjs";
+import {
+  resolveFarmComponentExtensions
+} from "./chunk-ES2LD2YD.mjs";
+import {
+  parseRouteSlotFile
+} from "./chunk-CBJKDB6F.mjs";
+import {
+  discoverProgrammaticRoutePaths
+} from "./chunk-2H3FJYY6.mjs";
+import {
+  parseRoutePath
+} from "./chunk-2SVJGOAX.mjs";
+
+// src/routing/generate-route-types.ts
+import * as path from "path";
+import * as fs from "fs";
+function routeSegmentsToTsTypeLiteral(segments) {
+  if (segments.length === 0) return '"/"';
+  const hasDynamic = segments.some((s) => s.startsWith("["));
+  if (!hasDynamic) return JSON.stringify("/" + segments.join("/"));
+  const parts = segments.map((s) => {
+    if (s.startsWith("[[...") || s.startsWith("[...")) return "${string}";
+    if (s.startsWith("[")) return "${string}";
+    return s;
+  });
+  return "`/" + parts.join("/") + "`";
+}
+function routePatternToTsTypeLiterals(pattern) {
+  if (pattern === "/") return ['"/"'];
+  let variants = [[]];
+  for (const segment of pattern.slice(1).split("/").filter(Boolean)) {
+    if (segment.startsWith("[[...") && segment.endsWith("]]")) {
+      variants = variants.flatMap((parts) => [parts, [...parts, segment]]);
+    } else {
+      variants = variants.map((parts) => [...parts, segment]);
+    }
+  }
+  return variants.map(routeSegmentsToTsTypeLiteral);
+}
+function routePatternToRouteLiteral(pattern) {
+  return JSON.stringify(pattern);
+}
+function renderTypeUnion(values) {
+  return values.length <= 1 ? values[0] || "never" : `
+  | ${values.join("\n  | ")}`;
+}
+function renderTypeAlias(name, value) {
+  return `export type ${name} =${value.startsWith("\n") ? "" : " "}${value};`;
+}
+function createRoutePattern(route) {
+  if (route.segments.length === 0) return "/";
+  return "/" + route.segments.map((seg) => {
+    if (!seg.isDynamic) return seg.segment;
+    if (seg.isCatchAll) return seg.isOptional ? `[[...${seg.segment}]]` : `[...${seg.segment}]`;
+    return `[${seg.segment}]`;
+  }).join("/");
+}
+var DEFAULT_OUT_FILE = "farm-routes.d.ts";
+async function generateRouteTypes(options) {
+  const root = path.resolve(options.root);
+  const srcDir = options.srcDir || "src";
+  const outFile = options.outFile || DEFAULT_OUT_FILE;
+  const outPath = path.isAbsolute(outFile) ? outFile : path.join(root, srcDir, outFile);
+  const content = await createRouteTypeDeclarations(options, outPath);
+  fs.mkdirSync(path.dirname(outPath), { recursive: true });
+  writeFileIfChanged(outPath, content);
+  return outPath;
+}
+async function createRouteTypeDeclarations(options, outPath) {
+  const { extraRoutes = [], suppressLintOnLink = false } = options;
+  const { pages: patterns, modules: routeModulePatterns } = await scanRoutePatterns(options);
+  for (const route of extraRoutes) {
+    if (route.startsWith("/")) {
+      patterns.add(route);
+      routeModulePatterns.add(route);
+    }
+  }
+  const sortedPatterns = Array.from(patterns).sort();
+  const typeLiterals = Array.from(new Set(sortedPatterns.flatMap(routePatternToTsTypeLiterals)));
+  const patternLiterals = sortedPatterns.map(routePatternToRouteLiteral);
+  const routeModulePatternLiterals = Array.from(routeModulePatterns).sort().map(routePatternToRouteLiteral);
+  const routePathType = suppressLintOnLink ? "string" : renderTypeUnion(typeLiterals);
+  const routePatternType = suppressLintOnLink ? "string" : renderTypeUnion(patternLiterals);
+  const routeModulePatternType = renderTypeUnion(routeModulePatternLiterals);
+  const routeTypesImportPath = `./${path.basename(outPath).replace(/\.d\.ts$/, "")}`;
+  const linkAugmentationBlock = suppressLintOnLink ? "" : `
+declare module "@farm.js/core/client" {
+  interface LinkDefaultRoute {
+    _: import(${JSON.stringify(routeTypesImportPath)}).RoutePath;
+    pattern: import(${JSON.stringify(routeTypesImportPath)}).RoutePattern;
+  }
+}
+
+declare module "@farm.js/core" {
+  interface LinkDefaultRoute {
+    _: import(${JSON.stringify(routeTypesImportPath)}).RoutePath;
+    pattern: import(${JSON.stringify(routeTypesImportPath)}).RoutePattern;
+  }
+  // Ensure root import ("@farm.js/core") uses the same typed Link signature as client entry.
+  const Link: typeof import("@farm.js/core/client").Link;
+}
+
+// Internal declaration path used by @farm.js/core root type re-exports.
+declare module "@farm.js/core/dist/client.js" {
+  interface LinkDefaultRoute {
+    _: import(${JSON.stringify(routeTypesImportPath)}).RoutePath;
+    pattern: import(${JSON.stringify(routeTypesImportPath)}).RoutePattern;
+  }
+}
+`;
+  const routeModuleAugmentationBlock = `
+declare global {
+  namespace FarmJS {
+    interface RouteRegistry {
+      pattern: import(${JSON.stringify(routeTypesImportPath)}).RouteModulePattern;
+    }
+  }
+}
+`;
+  const content = `/**
+ * Auto-generated route types from src/app.
+ * Link href and route component props are typed automatically from generated declarations.
+ * Regenerated on dev start and when routes change.
+ * Set suppressLintOnLink: true in farm.config.ts to accept any string on Link href.
+ */
+${renderTypeAlias("RoutePath", routePathType)}
+${renderTypeAlias("RoutePattern", routePatternType)}
+${renderTypeAlias("RouteModulePattern", routeModulePatternType)}${linkAugmentationBlock}${routeModuleAugmentationBlock}
+`;
+  return content;
+}
+var PLATFORM_FILE = /^(?:(page|layout)\.(native|ios|android)\.(?:tsx|ts|jsx|js)|page\.(kt|swift))$/;
+async function scanRoutePatterns(options) {
+  const { root, srcDir = "src" } = options;
+  const sourceRoots = options.sourceRoots ?? [{ name: "project", root, srcDir, layer: false }];
+  const componentExtensions = resolveFarmComponentExtensions(options.componentExtensions).map(
+    (extension) => extension.slice(1)
+  );
+  const pages = /* @__PURE__ */ new Set();
+  const modules = /* @__PURE__ */ new Set();
+  const pageFiles = /* @__PURE__ */ new Map();
+  const nativePages = /* @__PURE__ */ new Map();
+  const nativeLayouts = /* @__PURE__ */ new Map();
+  const glob = await import("fast-glob");
+  for (const source of sourceRoots) {
+    const appDir = path.join(source.root, source.srcDir, "app");
+    if (fs.existsSync(appDir)) {
+      const routeModuleFiles = await glob.default(
+        `**/{page,layout,loading,error}.{${componentExtensions.join(",")},md,mdx}`,
+        {
+          cwd: appDir,
+          absolute: false
+        }
+      );
+      for (const file of routeModuleFiles) {
+        if (parseRouteSlotFile(file)) continue;
+        const route = parseRoutePath(file);
+        const pattern = createRoutePattern(route);
+        modules.add(pattern);
+        if (route.type === "page") {
+          pages.add(pattern);
+          if (options.platformFiles) pageFiles.set(pattern, path.join(appDir, file));
+        }
+      }
+      if (options.platformFiles) {
+        scanPlatformRouteFiles(
+          appDir,
+          await glob.default(
+            ["**/{page,layout}.{native,ios,android}.{tsx,ts,jsx,js}", "**/page.{kt,swift}"],
+            { cwd: appDir, absolute: false }
+          ),
+          nativePages,
+          nativeLayouts
+        );
+      }
+    }
+    for (const route of await discoverProgrammaticRoutePaths(source.root, source.srcDir)) {
+      pages.add(route);
+      modules.add(route);
+    }
+  }
+  if (!options.platformFiles) return { pages, modules };
+  for (const [pattern, files] of nativePages) {
+    if (!pages.has(pattern)) {
+      const file = path.relative(root, Object.values(files)[0]);
+      throw new Error(
+        `${file.replace(/\\/g, "/")} has no web page next to it. Add ${path.join(path.dirname(file), "page.tsx").replace(/\\/g, "/")}: it is the route's web screen and the fallback on every platform.`
+      );
+    }
+  }
+  return { pages, modules, pageFiles, nativePages, nativeLayouts };
+}
+function scanPlatformRouteFiles(appDir, files, nativePages, nativeLayouts) {
+  const seen = /* @__PURE__ */ new Map();
+  for (const file of [...files].sort()) {
+    const normalized = file.replace(/\\/g, "/");
+    const match = PLATFORM_FILE.exec(path.posix.basename(normalized));
+    if (!match) continue;
+    const kind = match[1] ?? "page";
+    const platform = match[2] ?? match[3];
+    const twin = path.posix.join(path.posix.dirname(normalized), `${kind}.tsx`);
+    if (kind === "page" && parseRouteSlotFile(twin)) continue;
+    const dir = path.posix.dirname(normalized);
+    const pattern = kind === "page" ? createRoutePattern(parseRoutePath(twin)) : dir === "." ? "/" : `/${dir}`;
+    const key = `${kind}\0${pattern}\0${platform}`;
+    const previous = seen.get(key);
+    if (previous) {
+      throw new Error(
+        `Duplicate ${platform} ${kind} for "${pattern}": found ${previous} and ${normalized} in ${appDir}. Keep one.`
+      );
+    }
+    seen.set(key, normalized);
+    const target = kind === "page" ? nativePages : nativeLayouts;
+    const entry = { ...target.get(pattern) };
+    entry[platform] = path.join(appDir, normalized);
+    target.set(pattern, entry);
+  }
+}
+
+export {
+  generateRouteTypes,
+  createRouteTypeDeclarations,
+  scanRoutePatterns
+};

package/dist/chunk-2GLQSIZD.mjs

@@ -0,0 +1,55 @@
+import {
+  logger
+} from "./chunk-2SVJGOAX.mjs";
+
+// src/server/dev-loopback.ts
+import net from "net";
+var OTHER_LOOPBACK = { "::1": "127.0.0.1", "127.0.0.1": "::1" };
+function createFarmDevLoopbackPlugin() {
+  return {
+    name: "farm:dev-loopback",
+    configureServer(server) {
+      const listen = server.listen.bind(server);
+      server.listen = async (...args) => {
+        const result = await listen(...args);
+        await listenOnOtherLoopback(server);
+        return result;
+      };
+    }
+  };
+}
+async function listenOnOtherLoopback(server) {
+  const host = server.config.server.host;
+  if (host !== void 0 && host !== false && host !== "localhost") return;
+  const httpServer = server.httpServer;
+  const address = httpServer?.address();
+  if (!httpServer || !address || typeof address !== "object") return;
+  const other = OTHER_LOOPBACK[address.address];
+  if (!other) return;
+  const loopback = net.createServer((socket) => httpServer.emit("connection", socket));
+  const listening = await new Promise((resolve) => {
+    const onError = (error) => {
+      if (error.code === "EADDRINUSE") {
+        logger.warn(
+          `Another process is listening on ${formatHost(other)}:${address.port}; the dev server answers on ${formatHost(address.address)}:${address.port} only.`
+        );
+      }
+      resolve(false);
+    };
+    loopback.once("error", onError);
+    loopback.listen({ port: address.port, host: other, ipv6Only: other === "::1" }, () => {
+      loopback.off("error", onError);
+      resolve(true);
+    });
+  });
+  if (!listening) return;
+  loopback.on("error", (error) => logger.warn(`Dev loopback listener failed: ${String(error)}`));
+  httpServer.once("close", () => loopback.close());
+}
+function formatHost(address) {
+  return address.includes(":") ? `[${address}]` : address;
+}
+
+export {
+  createFarmDevLoopbackPlugin
+};

package/dist/{chunk-ACI52TCN.mjs → chunk-2VCC3GVC.mjs}

@@ -1,5 +1,5 @@
 // package.json
-var version = "0.1.49";
+var version = "0.1.50";
 
 // src/version.ts
 var FARM_VERSION = version;

package/dist/chunk-3ATXWZPH.cjs

@@ -0,0 +1,227 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+var _chunk5YPBFMBNcjs = require('./chunk-5YPBFMBN.cjs');
+
+
+var _chunkRD623KW4cjs = require('./chunk-RD623KW4.cjs');
+
+
+var _chunkJ2ZEVDEKcjs = require('./chunk-J2ZEVDEK.cjs');
+
+
+var _chunkJZMZKABScjs = require('./chunk-JZMZKABS.cjs');
+
+
+var _chunkXN2MB4QZcjs = require('./chunk-XN2MB4QZ.cjs');
+
+// src/routing/generate-route-types.ts
+var _path = require('path'); var path = _interopRequireWildcard(_path);
+var _fs = require('fs'); var fs = _interopRequireWildcard(_fs);
+function routeSegmentsToTsTypeLiteral(segments) {
+  if (segments.length === 0) return '"/"';
+  const hasDynamic = segments.some((s) => s.startsWith("["));
+  if (!hasDynamic) return JSON.stringify("/" + segments.join("/"));
+  const parts = segments.map((s) => {
+    if (s.startsWith("[[...") || s.startsWith("[...")) return "${string}";
+    if (s.startsWith("[")) return "${string}";
+    return s;
+  });
+  return "`/" + parts.join("/") + "`";
+}
+function routePatternToTsTypeLiterals(pattern) {
+  if (pattern === "/") return ['"/"'];
+  let variants = [[]];
+  for (const segment of pattern.slice(1).split("/").filter(Boolean)) {
+    if (segment.startsWith("[[...") && segment.endsWith("]]")) {
+      variants = variants.flatMap((parts) => [parts, [...parts, segment]]);
+    } else {
+      variants = variants.map((parts) => [...parts, segment]);
+    }
+  }
+  return variants.map(routeSegmentsToTsTypeLiteral);
+}
+function routePatternToRouteLiteral(pattern) {
+  return JSON.stringify(pattern);
+}
+function renderTypeUnion(values) {
+  return values.length <= 1 ? values[0] || "never" : `
+  | ${values.join("\n  | ")}`;
+}
+function renderTypeAlias(name, value) {
+  return `export type ${name} =${value.startsWith("\n") ? "" : " "}${value};`;
+}
+function createRoutePattern(route) {
+  if (route.segments.length === 0) return "/";
+  return "/" + route.segments.map((seg) => {
+    if (!seg.isDynamic) return seg.segment;
+    if (seg.isCatchAll) return seg.isOptional ? `[[...${seg.segment}]]` : `[...${seg.segment}]`;
+    return `[${seg.segment}]`;
+  }).join("/");
+}
+var DEFAULT_OUT_FILE = "farm-routes.d.ts";
+async function generateRouteTypes(options) {
+  const root = path.resolve(options.root);
+  const srcDir = options.srcDir || "src";
+  const outFile = options.outFile || DEFAULT_OUT_FILE;
+  const outPath = path.isAbsolute(outFile) ? outFile : path.join(root, srcDir, outFile);
+  const content = await createRouteTypeDeclarations(options, outPath);
+  fs.mkdirSync(path.dirname(outPath), { recursive: true });
+  _chunk5YPBFMBNcjs.writeFileIfChanged.call(void 0, outPath, content);
+  return outPath;
+}
+async function createRouteTypeDeclarations(options, outPath) {
+  const { extraRoutes = [], suppressLintOnLink = false } = options;
+  const { pages: patterns, modules: routeModulePatterns } = await scanRoutePatterns(options);
+  for (const route of extraRoutes) {
+    if (route.startsWith("/")) {
+      patterns.add(route);
+      routeModulePatterns.add(route);
+    }
+  }
+  const sortedPatterns = Array.from(patterns).sort();
+  const typeLiterals = Array.from(new Set(sortedPatterns.flatMap(routePatternToTsTypeLiterals)));
+  const patternLiterals = sortedPatterns.map(routePatternToRouteLiteral);
+  const routeModulePatternLiterals = Array.from(routeModulePatterns).sort().map(routePatternToRouteLiteral);
+  const routePathType = suppressLintOnLink ? "string" : renderTypeUnion(typeLiterals);
+  const routePatternType = suppressLintOnLink ? "string" : renderTypeUnion(patternLiterals);
+  const routeModulePatternType = renderTypeUnion(routeModulePatternLiterals);
+  const routeTypesImportPath = `./${path.basename(outPath).replace(/\.d\.ts$/, "")}`;
+  const linkAugmentationBlock = suppressLintOnLink ? "" : `
+declare module "@farm.js/core/client" {
+  interface LinkDefaultRoute {
+    _: import(${JSON.stringify(routeTypesImportPath)}).RoutePath;
+    pattern: import(${JSON.stringify(routeTypesImportPath)}).RoutePattern;
+  }
+}
+
+declare module "@farm.js/core" {
+  interface LinkDefaultRoute {
+    _: import(${JSON.stringify(routeTypesImportPath)}).RoutePath;
+    pattern: import(${JSON.stringify(routeTypesImportPath)}).RoutePattern;
+  }
+  // Ensure root import ("@farm.js/core") uses the same typed Link signature as client entry.
+  const Link: typeof import("@farm.js/core/client").Link;
+}
+
+// Internal declaration path used by @farm.js/core root type re-exports.
+declare module "@farm.js/core/dist/client.js" {
+  interface LinkDefaultRoute {
+    _: import(${JSON.stringify(routeTypesImportPath)}).RoutePath;
+    pattern: import(${JSON.stringify(routeTypesImportPath)}).RoutePattern;
+  }
+}
+`;
+  const routeModuleAugmentationBlock = `
+declare global {
+  namespace FarmJS {
+    interface RouteRegistry {
+      pattern: import(${JSON.stringify(routeTypesImportPath)}).RouteModulePattern;
+    }
+  }
+}
+`;
+  const content = `/**
+ * Auto-generated route types from src/app.
+ * Link href and route component props are typed automatically from generated declarations.
+ * Regenerated on dev start and when routes change.
+ * Set suppressLintOnLink: true in farm.config.ts to accept any string on Link href.
+ */
+${renderTypeAlias("RoutePath", routePathType)}
+${renderTypeAlias("RoutePattern", routePatternType)}
+${renderTypeAlias("RouteModulePattern", routeModulePatternType)}${linkAugmentationBlock}${routeModuleAugmentationBlock}
+`;
+  return content;
+}
+var PLATFORM_FILE = /^(?:(page|layout)\.(native|ios|android)\.(?:tsx|ts|jsx|js)|page\.(kt|swift))$/;
+async function scanRoutePatterns(options) {
+  const { root, srcDir = "src" } = options;
+  const sourceRoots = _nullishCoalesce(options.sourceRoots, () => ( [{ name: "project", root, srcDir, layer: false }]));
+  const componentExtensions = _chunkRD623KW4cjs.resolveFarmComponentExtensions.call(void 0, options.componentExtensions).map(
+    (extension) => extension.slice(1)
+  );
+  const pages = /* @__PURE__ */ new Set();
+  const modules = /* @__PURE__ */ new Set();
+  const pageFiles = /* @__PURE__ */ new Map();
+  const nativePages = /* @__PURE__ */ new Map();
+  const nativeLayouts = /* @__PURE__ */ new Map();
+  const glob = await import("fast-glob");
+  for (const source of sourceRoots) {
+    const appDir = path.join(source.root, source.srcDir, "app");
+    if (fs.existsSync(appDir)) {
+      const routeModuleFiles = await glob.default(
+        `**/{page,layout,loading,error}.{${componentExtensions.join(",")},md,mdx}`,
+        {
+          cwd: appDir,
+          absolute: false
+        }
+      );
+      for (const file of routeModuleFiles) {
+        if (_chunkJ2ZEVDEKcjs.parseRouteSlotFile.call(void 0, file)) continue;
+        const route = _chunkXN2MB4QZcjs.parseRoutePath.call(void 0, file);
+        const pattern = createRoutePattern(route);
+        modules.add(pattern);
+        if (route.type === "page") {
+          pages.add(pattern);
+          if (options.platformFiles) pageFiles.set(pattern, path.join(appDir, file));
+        }
+      }
+      if (options.platformFiles) {
+        scanPlatformRouteFiles(
+          appDir,
+          await glob.default(
+            ["**/{page,layout}.{native,ios,android}.{tsx,ts,jsx,js}", "**/page.{kt,swift}"],
+            { cwd: appDir, absolute: false }
+          ),
+          nativePages,
+          nativeLayouts
+        );
+      }
+    }
+    for (const route of await _chunkJZMZKABScjs.discoverProgrammaticRoutePaths.call(void 0, source.root, source.srcDir)) {
+      pages.add(route);
+      modules.add(route);
+    }
+  }
+  if (!options.platformFiles) return { pages, modules };
+  for (const [pattern, files] of nativePages) {
+    if (!pages.has(pattern)) {
+      const file = path.relative(root, Object.values(files)[0]);
+      throw new Error(
+        `${file.replace(/\\/g, "/")} has no web page next to it. Add ${path.join(path.dirname(file), "page.tsx").replace(/\\/g, "/")}: it is the route's web screen and the fallback on every platform.`
+      );
+    }
+  }
+  return { pages, modules, pageFiles, nativePages, nativeLayouts };
+}
+function scanPlatformRouteFiles(appDir, files, nativePages, nativeLayouts) {
+  const seen = /* @__PURE__ */ new Map();
+  for (const file of [...files].sort()) {
+    const normalized = file.replace(/\\/g, "/");
+    const match = PLATFORM_FILE.exec(path.posix.basename(normalized));
+    if (!match) continue;
+    const kind = _nullishCoalesce(match[1], () => ( "page"));
+    const platform = _nullishCoalesce(match[2], () => ( match[3]));
+    const twin = path.posix.join(path.posix.dirname(normalized), `${kind}.tsx`);
+    if (kind === "page" && _chunkJ2ZEVDEKcjs.parseRouteSlotFile.call(void 0, twin)) continue;
+    const dir = path.posix.dirname(normalized);
+    const pattern = kind === "page" ? createRoutePattern(_chunkXN2MB4QZcjs.parseRoutePath.call(void 0, twin)) : dir === "." ? "/" : `/${dir}`;
+    const key = `${kind}\0${pattern}\0${platform}`;
+    const previous = seen.get(key);
+    if (previous) {
+      throw new Error(
+        `Duplicate ${platform} ${kind} for "${pattern}": found ${previous} and ${normalized} in ${appDir}. Keep one.`
+      );
+    }
+    seen.set(key, normalized);
+    const target = kind === "page" ? nativePages : nativeLayouts;
+    const entry = { ...target.get(pattern) };
+    entry[platform] = path.join(appDir, normalized);
+    target.set(pattern, entry);
+  }
+}
+
+
+
+
+
+exports.generateRouteTypes = generateRouteTypes; exports.createRouteTypeDeclarations = createRouteTypeDeclarations; exports.scanRoutePatterns = scanRoutePatterns;