@farm.js/core 0.1.51-beta.2 → 0.1.60

package/dist/{chunk-NXBHYO7S.cjs → chunk-JBK7UJOI.cjs}

@@ -1,20 +1,20 @@
 "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 _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } async function _asyncNullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return await rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } async function _asyncOptionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = await fn(value); } else if (op === 'call' || op === 'optionalCall') { value = await fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
 
-var _chunkSJ23LJ3Ncjs = require('./chunk-SJ23LJ3N.cjs');
+var _chunkVVTJTMGQcjs = require('./chunk-VVTJTMGQ.cjs');
 
 
-var _chunkXPMC4E2Gcjs = require('./chunk-XPMC4E2G.cjs');
+var _chunkXVSBALOYcjs = require('./chunk-XVSBALOY.cjs');
 
 
-var _chunkNPQLMP7Mcjs = require('./chunk-NPQLMP7M.cjs');
+var _chunkNQJDO7K7cjs = require('./chunk-NQJDO7K7.cjs');
 
 
 
 var _chunk65Y5SIBHcjs = require('./chunk-65Y5SIBH.cjs');
 
 
-var _chunkLNM57D3Hcjs = require('./chunk-LNM57D3H.cjs');
+var _chunkR53QDV6Tcjs = require('./chunk-R53QDV6T.cjs');
 
 
 var _chunkAQLHD6HZcjs = require('./chunk-AQLHD6HZ.cjs');
@@ -54,7 +54,7 @@ function pickImportTarget(entry) {
   return void 0;
 }
 async function importFromApp(root, packageName, subpath = ".") {
-  const packageDir = _chunkSJ23LJ3Ncjs.findFarmAppPackageDir.call(void 0, root, packageName);
+  const packageDir = _chunkVVTJTMGQcjs.findFarmAppPackageDir.call(void 0, root, packageName);
   if (!packageDir) return void 0;
   const manifest = JSON.parse(_fs.readFileSync.call(void 0, _path2.default.join(packageDir, "package.json"), "utf8"));
   const exportsMap = manifest.exports;
@@ -81,9 +81,9 @@ async function createFarmRscViteConfig(userConfig, options) {
     importFromApp(root, "@vitejs/plugin-rsc"),
     importFromApp(root, "@vitejs/plugin-react")
   ]);
-  if (!pluginRsc || !viteRsc || !_chunkSJ23LJ3Ncjs.findFarmAppPackageDir.call(void 0, root, "react-server-dom-webpack")) {
+  if (!pluginRsc || !viteRsc || !_chunkVVTJTMGQcjs.findFarmAppPackageDir.call(void 0, root, "react-server-dom-webpack")) {
     throw new Error(
-      `[Farm.js] experimental.serverComponents runs on @farm.js/plugin and the official @vitejs/plugin-rsc. Install them: ${_chunkSJ23LJ3Ncjs.FARM_RSC_INSTALL_HINT}`
+      `[Farm.js] experimental.serverComponents runs on @farm.js/plugin and the official @vitejs/plugin-rsc. Install them: ${_chunkVVTJTMGQcjs.FARM_RSC_INSTALL_HINT}`
     );
   }
   const { plugins: vitePlugins = [], ...viteOptions } = _nullishCoalesce(userConfig.vite, () => ( {}));
@@ -92,13 +92,16 @@ async function createFarmRscViteConfig(userConfig, options) {
     if (userConfig[key] !== void 0) rscConfig[key] = userConfig[key];
   }
   const createReactPlugin = hasPluginNamed(vitePlugins, "vite:react") ? void 0 : await _asyncNullishCoalesce(await _asyncOptionalChain([viteReact, 'optionalAccess', async _2 => _2.default]), async () => ( (options.command === "serve" ? (await _chunk65Y5SIBHcjs.loadFarmReactPlugin.call(void 0, )).default : void 0)));
-  const tailwind = hasPluginNamed(vitePlugins, "@tailwindcss/vite") ? void 0 : await _chunkLNM57D3Hcjs.loadTailwindVitePlugin.call(void 0, );
+  const tailwind = hasPluginNamed(vitePlugins, "@tailwindcss/vite") ? void 0 : await _chunkR53QDV6Tcjs.loadTailwindVitePlugin.call(void 0, );
+  const platform = _chunkAQLHD6HZcjs.resolveFarmPlatform.call(void 0, );
+  const mobileClient = userConfig.mobile === void 0 || platform === "desktop" ? void 0 : options.command === "build" ? "entry" : platform === "mobile" ? "inline" : void 0;
   const farmConfig = pluginRsc.defineConfig({
     ...rscConfig,
+    ...mobileClient ? { mobileClient } : {},
     experimental: { ...userConfig.experimental, serverComponents: true },
     port: _nullishCoalesce(options.port, () => ( _optionalChain([userConfig, 'access', _3 => _3.server, 'optionalAccess', _4 => _4.port]))),
     plugins: [
-      ...options.command === "serve" && _chunkAQLHD6HZcjs.resolveFarmPlatform.call(void 0, ) === "desktop" ? [
+      ...options.command === "serve" && platform === "desktop" ? [
         _chunk65Y5SIBHcjs.farmDesktopDevGuardPlugin.call(void 0, 
           typeof userConfig.basePath === "string" ? userConfig.basePath : void 0
         )
@@ -111,7 +114,7 @@ async function createFarmRscViteConfig(userConfig, options) {
         server: { environmentName: "rsc" },
         config: {
           preset: options.preset,
-          outputDir: options.outputDir && _chunkNPQLMP7Mcjs.resolveDeployOutputPath.call(void 0, root, options.outputDir)
+          outputDir: options.outputDir && _chunkNQJDO7K7cjs.resolveDeployOutputPath.call(void 0, root, options.outputDir)
         }
       })
     ]
@@ -134,7 +137,7 @@ async function createFarmRscDevServer(userConfig, options) {
   const config = await createFarmRscViteConfig(userConfig, { ...configOptions, command: "serve" });
   return createServer({
     ...config,
-    plugins: [..._nullishCoalesce(config.plugins, () => ( [])), _chunkXPMC4E2Gcjs.createFarmDevLoopbackPlugin.call(void 0, )],
+    plugins: [..._nullishCoalesce(config.plugins, () => ( [])), _chunkXVSBALOYcjs.createFarmDevLoopbackPlugin.call(void 0, )],
     ...host === void 0 ? {} : { server: { ...config.server, host } }
   });
 }

package/dist/chunk-JI5D7MXY.mjs

@@ -0,0 +1,137 @@
+import {
+  _withFarmGuardedResponseCache
+} from "./chunk-EGVC4LIG.mjs";
+import {
+  _markFarmOwnedResponse,
+  _withFarmResponseHeaders
+} from "./chunk-LM55GS4R.mjs";
+
+// src/mobile/shell-response.ts
+var FARM_SHELL_HEADER = "X-Farm-Shell";
+function isFarmMobileShellRequest(request) {
+  const value = request.headers.get(FARM_SHELL_HEADER);
+  return value !== null && /^[a-z][a-z0-9-]{0,31}$/.test(value);
+}
+function isHtml(response) {
+  return response.headers.get("content-type")?.toLowerCase().includes("text/html") === true;
+}
+function appendVary(headers, name) {
+  const current = headers.get("Vary");
+  if (!current) {
+    headers.set("Vary", name);
+    return;
+  }
+  const names = current.split(",").map((value) => value.trim().toLowerCase());
+  if (names.includes("*") || names.includes(name.toLowerCase())) return;
+  headers.set("Vary", `${current}, ${name}`);
+}
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+var MAX_HELD_TAG = 4096;
+function createFarmMobileShellRewriter(client) {
+  const entry = new RegExp(`(["'])${escapeRegExp(client.webEntry)}\\1`, "g");
+  const webOnly = new Set(client.webOnly);
+  const preload = /<link rel="modulepreload" href="\/([^"]+)"[^>]*>/g;
+  let held = "";
+  return (text, final = false) => {
+    let input = held + text;
+    held = "";
+    if (!final) {
+      const open = input.lastIndexOf("<");
+      if (open !== -1 && input.indexOf(">", open) === -1 && input.length - open <= MAX_HELD_TAG) {
+        held = input.slice(open);
+        input = input.slice(0, open);
+      }
+    }
+    return input.replace(entry, (_match, quote) => `${quote}${client.entry}${quote}`).replace(preload, (tag, file) => webOnly.has(file) ? "" : tag);
+  };
+}
+function _applyFarmMobileShellClient(request, response, client, onPrivate) {
+  if (!client || !isHtml(response)) return response;
+  if (!isFarmMobileShellRequest(request) || !response.body) {
+    return _withFarmResponseHeaders(response, (headers2) => appendVary(headers2, FARM_SHELL_HEADER));
+  }
+  onPrivate?.();
+  const headers = new Headers(_withFarmGuardedResponseCache(response).headers);
+  appendVary(headers, FARM_SHELL_HEADER);
+  headers.delete("content-length");
+  headers.delete("etag");
+  const rewrite = createFarmMobileShellRewriter(client);
+  const decoder = new TextDecoder();
+  const encoder = new TextEncoder();
+  const body = response.body.pipeThrough(
+    new TransformStream({
+      transform(chunk, controller) {
+        const output = rewrite(decoder.decode(chunk, { stream: true }));
+        if (output) controller.enqueue(encoder.encode(output));
+      },
+      flush(controller) {
+        const output = rewrite(decoder.decode(), true);
+        if (output) controller.enqueue(encoder.encode(output));
+      }
+    })
+  );
+  return _markFarmOwnedResponse(
+    new Response(body, { status: response.status, statusText: response.statusText, headers })
+  );
+}
+
+// src/mobile/shell-render.ts
+var FARM_SHELL_RENDER_HEADER = "X-Farm-Shell-Render";
+var FARM_SHELL_ROUTE_HEADER = "X-Farm-Shell-Route";
+var FARM_SHELL_PARAM_SEGMENT = "__farm_shell__";
+function constantTimeEqual(left, right) {
+  if (left.length !== right.length) return false;
+  let difference = 0;
+  for (let index = 0; index < left.length; index += 1) {
+    difference |= left.charCodeAt(index) ^ right.charCodeAt(index);
+  }
+  return difference === 0;
+}
+function _isFarmMobileShellRenderRequest(request, token) {
+  const value = request.headers.get(FARM_SHELL_RENDER_HEADER);
+  return token.length > 0 && value !== null && constantTimeEqual(value, token);
+}
+function stripRouteGroups(pattern) {
+  const segments = pattern.split("/").filter((segment) => segment && !(segment.startsWith("(") && segment.endsWith(")")));
+  return segments.length === 0 ? "/" : `/${segments.join("/")}`;
+}
+function isDynamicPattern(pattern) {
+  return pattern.split("/").some((segment) => segment.startsWith("["));
+}
+function _checkFarmMobileShellRoute(check) {
+  const route = stripRouteGroups(check.route);
+  if (check.requested === null || stripRouteGroups(check.requested) !== route) {
+    return `the request matched ${route}, not ${check.requested ?? "a requested route"}`;
+  }
+  if (check.loading === null) return "it has no loading file";
+  if (isDynamicPattern(check.loading)) {
+    return `its loading file is in a dynamic folder (${stripRouteGroups(check.loading)})`;
+  }
+  const layout = check.layouts.find(isDynamicPattern);
+  if (layout !== void 0) {
+    return `a layout is in a dynamic folder (${stripRouteGroups(layout)})`;
+  }
+  return null;
+}
+function createFarmMobileShellRenderPath(route) {
+  const segments = [];
+  for (const segment of route.split("/")) {
+    if (!segment || segment.startsWith("(") && segment.endsWith(")")) continue;
+    if (segment.startsWith("[[...") && segment.endsWith("]]")) continue;
+    segments.push(segment.startsWith("[") ? FARM_SHELL_PARAM_SEGMENT : segment);
+  }
+  return `/${segments.join("/")}`;
+}
+
+export {
+  FARM_SHELL_HEADER,
+  _applyFarmMobileShellClient,
+  FARM_SHELL_RENDER_HEADER,
+  FARM_SHELL_ROUTE_HEADER,
+  FARM_SHELL_PARAM_SEGMENT,
+  _isFarmMobileShellRenderRequest,
+  _checkFarmMobileShellRoute,
+  createFarmMobileShellRenderPath
+};

package/dist/{chunk-QXJADAQB.cjs → chunk-JIBEFLQ7.cjs}

@@ -20,9 +20,12 @@ function delegateNavigation(delegate) {
     delegates.delete(delegate);
   };
 }
+function hasFarmNavigationDelegates() {
+  return Boolean(_optionalChain([globalThis, 'access', _ => _[DELEGATES], 'optionalAccess', _2 => _2.size]));
+}
 async function runFarmNavigationDelegates(context) {
   const delegates = globalThis[DELEGATES];
-  if (!_optionalChain([delegates, 'optionalAccess', _ => _.size])) return false;
+  if (!_optionalChain([delegates, 'optionalAccess', _3 => _3.size])) return false;
   for (const delegate of delegates) {
     try {
       if (await delegate(context) === true) return true;
@@ -37,4 +40,5 @@ async function runFarmNavigationDelegates(context) {
 
 
 
-exports.getHashTargetElement = getHashTargetElement; exports.delegateNavigation = delegateNavigation; exports.runFarmNavigationDelegates = runFarmNavigationDelegates;
+
+exports.getHashTargetElement = getHashTargetElement; exports.delegateNavigation = delegateNavigation; exports.hasFarmNavigationDelegates = hasFarmNavigationDelegates; exports.runFarmNavigationDelegates = runFarmNavigationDelegates;

package/dist/{chunk-LZ4SB57H.mjs → chunk-JPIUGDK4.mjs}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-YP7YO3S3.mjs";
 import {
   toPosixPath
-} from "./chunk-Y3N5BFRJ.mjs";
+} from "./chunk-JSDV2NUN.mjs";
 import {
   searchParamsToObject
 } from "./chunk-H3ASZDT7.mjs";

package/dist/{chunk-Y3N5BFRJ.mjs → chunk-JSDV2NUN.mjs}

@@ -173,7 +173,7 @@ async function fileExists(filePath) {
 }
 async function globFiles(pattern, cwd) {
   const { glob } = await import("tinyglobby");
-  return glob(pattern, { cwd, expandDirectories: false });
+  return (await glob(pattern, { cwd, expandDirectories: false })).sort();
 }
 function parseSearchParams(searchParams) {
   return searchParamsToObject(searchParams);

package/dist/{chunk-IRSS4HS4.mjs → chunk-K3RU5MOR.mjs}

@@ -1,6 +1,6 @@
 import {
   parseRoutePath
-} from "./chunk-Y3N5BFRJ.mjs";
+} from "./chunk-JSDV2NUN.mjs";
 
 // src/routing/route-slots.ts
 var SLOT_SEGMENT = /^@([A-Za-z][A-Za-z0-9_-]*)$/;

package/dist/chunk-KPOMS5RO.cjs

@@ -0,0 +1,237 @@
+"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(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+var _chunk3YMLUNL2cjs = require('./chunk-3YMLUNL2.cjs');
+
+
+
+var _chunkYKHRCY4Tcjs = require('./chunk-YKHRCY4T.cjs');
+
+// src/mobile/modules.ts
+var _fs = require('fs');
+var _path = require('path'); var path = _interopRequireWildcard(_path);
+var MODULE_KEYS = /* @__PURE__ */ new Set(["permissions", "usage", "web"]);
+var PERMISSION = /^[A-Za-z_][A-Za-z0-9_]*(?:\.[A-Za-z_][A-Za-z0-9_]*)+$/;
+var BARE_PERMISSION = /^[A-Z][A-Z0-9_]*$/;
+var USAGE_KEY = /^NS[A-Za-z0-9]+UsageDescription$/;
+var SPEC_FILE = /^Native[A-Za-z0-9_]+\.(?:ts|js)$/;
+var SPEC_NAME = /TurboModuleRegistry\s*\.\s*(?:getEnforcing|get)\s*(?:<[^>]*>)?\s*\(\s*(["'`])([A-Za-z_$][\w$]*)\1/;
+function relative2(root, file) {
+  return path.relative(root, file).split(path.sep).join("/");
+}
+function scanFarmMobileAppModules(options) {
+  const dir = path.resolve(options.root, _nullishCoalesce(options.srcDir, () => ( "src")), "native");
+  if (!_fs.existsSync.call(void 0, dir)) return void 0;
+  const entries = _fs.readdirSync.call(void 0, dir, { withFileTypes: true }).filter((entry) => entry.isFile()).map((entry) => entry.name).sort();
+  const specs = [];
+  const names = /* @__PURE__ */ new Map();
+  for (const name of entries.filter((entry) => SPEC_FILE.test(entry))) {
+    const file = path.join(dir, name);
+    const match = SPEC_NAME.exec(_fs.readFileSync.call(void 0, file, "utf8"));
+    const shown = relative2(options.root, file);
+    if (!match) {
+      throw new TypeError(
+        `${shown} is a native module spec (Native*.ts) without a registered name. Export TurboModuleRegistry.getEnforcing<Spec>("${name.replace(/^Native|\.\w+$/g, "")}") as its default, as in a React Native app.`
+      );
+    }
+    const other = names.get(match[2]);
+    if (other) {
+      throw new TypeError(
+        `${shown} and ${other} both register the native module "${match[2]}". Give each spec its own name.`
+      );
+    }
+    names.set(match[2], shown);
+    specs.push({ name: match[2], file });
+  }
+  const android = entries.filter((entry) => entry.endsWith(".kt")).map((entry) => path.join(dir, entry));
+  const ios = entries.filter((entry) => entry.endsWith(".swift")).map((entry) => path.join(dir, entry));
+  if (specs.length === 0 && android.length === 0 && ios.length === 0) return void 0;
+  return { dir, specs, android, ios };
+}
+function findPackage(name, from) {
+  let dir = from;
+  for (; ; ) {
+    const candidate = path.join(dir, "node_modules", name);
+    if (_fs.existsSync.call(void 0, path.join(candidate, "package.json"))) return _fs.realpathSync.call(void 0, candidate);
+    const parent = path.dirname(dir);
+    if (parent === dir) return void 0;
+    dir = parent;
+  }
+}
+function installedModuleProblem(name, root, dependencies) {
+  if (!(name in dependencies)) return "unknown";
+  const dir = findPackage(name, root);
+  if (!dir) return "missing";
+  try {
+    const pkg = JSON.parse(_fs.readFileSync.call(void 0, path.join(dir, "package.json"), "utf8"));
+    return _chunkYKHRCY4Tcjs.isPlainObject.call(void 0, pkg) && _chunkYKHRCY4Tcjs.isPlainObject.call(void 0, pkg.codegenConfig) ? void 0 : "not-a-module";
+  } catch (e) {
+    return "not-a-module";
+  }
+}
+function resolveFarmMobileModules(input, options, fail) {
+  if (input === void 0) return {};
+  if (!_chunkYKHRCY4Tcjs.isPlainObject.call(void 0, input)) {
+    fail(
+      'modules must be an object keyed by module name, such as { Device: { permissions: ["android.permission.VIBRATE"] } }.'
+    );
+  }
+  const issues = [];
+  const resolved = {};
+  const appModules = new Set(_nullishCoalesce(options.appModules, () => ( [])));
+  const usageOwners = /* @__PURE__ */ new Map();
+  let dependencies;
+  const specDir = relative2(
+    options.root,
+    path.resolve(options.root, _nullishCoalesce(options.srcDir, () => ( "src")), "native")
+  );
+  for (const name of Object.keys(input).sort()) {
+    const where = `modules[${JSON.stringify(name)}]`;
+    const entry = input[name];
+    if (!appModules.has(name)) {
+      _nullishCoalesce(dependencies, () => ( (dependencies = ((value) => _chunkYKHRCY4Tcjs.isPlainObject.call(void 0, value) ? value : {})(
+        _chunkYKHRCY4Tcjs.readAppPackageJson.call(void 0, options.root).dependencies
+      ))));
+      const problem = installedModuleProblem(name, options.root, dependencies);
+      if (problem === "unknown") {
+        issues.push(
+          `${where} is not one of the app's native modules or an installed React Native module. Use the name a ${specDir}/Native*.ts spec registers, or a package in dependencies in package.json.`
+        );
+      } else if (problem === "missing") {
+        issues.push(
+          `${where} is in dependencies but not installed. Install the app's dependencies, then run the command again.`
+        );
+      } else if (problem === "not-a-module") {
+        issues.push(
+          `${where} names a package with no "codegenConfig" in its package.json, so it is not a React Native module for the new architecture. Remove the entry, or upgrade the package.`
+        );
+      }
+    }
+    if (!_chunkYKHRCY4Tcjs.isPlainObject.call(void 0, entry)) {
+      issues.push(
+        `${where} must be an object, such as { permissions: ["android.permission.VIBRATE"] }.`
+      );
+      continue;
+    }
+    for (const key of Object.keys(entry)) {
+      if (!MODULE_KEYS.has(key)) {
+        issues.push(`unknown option ${where}.${key}. Supported: permissions, usage, web.`);
+      }
+    }
+    const permissions = [];
+    if (entry.permissions !== void 0) {
+      if (!Array.isArray(entry.permissions)) {
+        issues.push(
+          `${where}.permissions must be an array of Android permissions, such as ["android.permission.VIBRATE"].`
+        );
+      } else {
+        entry.permissions.forEach((permission, index) => {
+          const at = `${where}.permissions[${index}]`;
+          if (typeof permission !== "string" || !PERMISSION.test(permission)) {
+            const hint = typeof permission === "string" && BARE_PERMISSION.test(permission) ? ` Use "android.permission.${permission}".` : "";
+            issues.push(
+              `${at} must be a full Android permission name such as "android.permission.VIBRATE", got ${JSON.stringify(permission)}.${hint}`
+            );
+          } else if (!permissions.includes(permission)) {
+            permissions.push(permission);
+          }
+        });
+      }
+    }
+    const usage = {};
+    if (entry.usage !== void 0) {
+      if (!_chunkYKHRCY4Tcjs.isPlainObject.call(void 0, entry.usage)) {
+        issues.push(
+          `${where}.usage must be an object of iOS usage strings, such as { NSCameraUsageDescription: "Scans receipts." }.`
+        );
+      } else {
+        for (const [key, value] of Object.entries(entry.usage)) {
+          const at = `${where}.usage.${key}`;
+          if (!USAGE_KEY.test(key)) {
+            issues.push(
+              `${at} is not an iOS usage-description key. Keys are NS...UsageDescription, such as NSCameraUsageDescription.`
+            );
+          } else if (typeof value !== "string" || !value.trim()) {
+            issues.push(
+              `${at} must be a non-empty string: the sentence iOS shows when it asks for access.`
+            );
+          } else {
+            const owner = usageOwners.get(key);
+            if (owner && owner.value !== value.trim()) {
+              issues.push(
+                `${at} and modules[${JSON.stringify(owner.name)}].usage.${key} set different strings, and Info.plist has one per key. Set it on one module.`
+              );
+            }
+            usageOwners.set(key, { name, value: value.trim() });
+            usage[key] = value.trim();
+          }
+        }
+      }
+    }
+    let web = false;
+    if (entry.web !== void 0) {
+      if (typeof entry.web !== "boolean") {
+        issues.push(`${where}.web must be true or false.`);
+      } else if (entry.web && !appModules.has(name)) {
+        issues.push(
+          `${where}.web is true, but web screens reach only the app's own modules in ${specDir}. "${name}" needs the React Native JS runtime, which web screens do not have. Remove web, and call the module from a native screen (page.native.tsx).`
+        );
+      } else {
+        web = entry.web;
+      }
+    }
+    resolved[name] = { permissions, usage, web };
+  }
+  if (issues.length === 1) fail(issues[0]);
+  if (issues.length > 1) {
+    fail(
+      `modules has ${issues.length} problems:
+${issues.map((issue) => `  - ${issue}`).join("\n")}`
+    );
+  }
+  return resolved;
+}
+function readFarmMobileWebModules(appModules, modules, options) {
+  const issues = [];
+  const specs = appModules.specs.map((spec) => {
+    if (!_optionalChain([modules, 'access', _ => _[spec.name], 'optionalAccess', _2 => _2.web])) return spec;
+    const shown = relative2(options.root, spec.file);
+    const where = `modules[${JSON.stringify(spec.name)}].web`;
+    let web;
+    try {
+      web = _chunk3YMLUNL2cjs.readFarmNativeWebSpec.call(void 0, { root: options.root, file: spec.file });
+    } catch (error) {
+      issues.push(`${where}: ${error.message}`);
+      return spec;
+    }
+    for (const { method, reason } of web.unsupported) {
+      issues.push(
+        `${where}: ${shown} declares ${method}(), but ${reason}. Change the parameter to a string, number, boolean, object, or array, or remove web and call the module from a native screen (page.native.tsx).`
+      );
+    }
+    if (web.methods.some((method) => method.name === "available")) {
+      issues.push(
+        `${where}: ${shown} declares available(), which web screens use to check for the module (native.<module>.available()). Rename the method.`
+      );
+    }
+    if (web.methods.length === 0 && web.unsupported.length === 0) {
+      issues.push(
+        `${where}: ${shown} declares no method that returns a Promise, and web screens call only those. Remove web, or declare one, such as model(): Promise<string>.`
+      );
+    }
+    return { ...spec, web };
+  });
+  if (issues.length === 1) throw new TypeError(issues[0]);
+  if (issues.length > 1) {
+    throw new TypeError(
+      `modules has ${issues.length} problems:
+${issues.map((issue) => `  - ${issue}`).join("\n")}`
+    );
+  }
+  return { ...appModules, specs };
+}
+
+
+
+
+
+exports.scanFarmMobileAppModules = scanFarmMobileAppModules; exports.resolveFarmMobileModules = resolveFarmMobileModules; exports.readFarmMobileWebModules = readFarmMobileWebModules;

package/dist/{chunk-LAZK6UV7.mjs → chunk-KVW2M6PI.mjs}

@@ -3,7 +3,7 @@ import {
   getFarmMarkdownMirrorPath,
   isFarmMarkdownMirrorExposed,
   matchesFarmMarkdownRoutePattern
-} from "./chunk-N77JBPLC.mjs";
+} from "./chunk-YSXTNSXS.mjs";
 import {
   applyFarmBasePath
 } from "./chunk-SF3JB56B.mjs";