@wix/himalaya-cli 0.833.0 → 0.834.0

package/dist/cli.mjs

@@ -4593,6 +4593,7 @@ function resolveTranslation(value, catalog, sourceCatalog) {
 var BINDING_SIGILS, BINDING_SIGIL_RE, TRANSLATION_PREFIX, TRANSLATION_KEY_RE;
 var init_bindings = __esm({
   "../../core/ts/src/bindings.ts"() {
+    "use strict";
     BINDING_SIGILS = ["service", "flag", "item", "t"];
     BINDING_SIGIL_RE = new RegExp(
       `^\\$(?:${BINDING_SIGILS.filter((s) => s !== "t").join("|")})\\b|^\\$t:`
@@ -5690,8 +5691,8 @@ function unresolvedWixMediaReference(value, allowBareId = false) {
   if (reference.startsWith("wix:image://")) return reference;
   if (isBindingExpr(reference)) return null;
   if (!allowBareId && !DISTINCTIVE_WIX_MEDIA_ID.test(reference)) return null;
-  const resolved = wixMediaUrl(reference, null);
-  return resolved !== reference && resolved.startsWith(WIX_MEDIA_ORIGIN) ? reference : null;
+  const resolved2 = wixMediaUrl(reference, null);
+  return resolved2 !== reference && resolved2.startsWith(WIX_MEDIA_ORIGIN) ? reference : null;
 }
 var MEDIA_NAMED_PROPERTY, MEDIA_LOCATION_SUFFIX, MEDIA_PATH_SUFFIX, DISTINCTIVE_WIX_MEDIA_ID, WIX_MEDIA_ORIGIN;
 var init_media_value = __esm({
@@ -7000,13 +7001,13 @@ function validateScreenDescriptor(screenId, descriptor, opts = {}) {
       const p = body.props ?? {};
       const cases = Array.isArray(p.cases) ? p.cases : [];
       const ids = cases.map((c) => c?.id).filter((x) => typeof x === "string");
-      const resolved = resolveCaseValue(p.casePath);
-      if (resolved !== void 0 && ids.length > 0 && !ids.includes(resolved)) {
+      const resolved2 = resolveCaseValue(p.casePath);
+      if (resolved2 !== void 0 && ids.length > 0 && !ids.includes(resolved2)) {
         issues.push({
           severity: "warning",
           pass: "bindings",
           path: typeof o.id === "string" ? o.id : at,
-          message: `FragmentSlot casePath resolves to "${resolved}" which matches no case id (${ids.join(", ")}) \u2014 it renders the ${typeof p.defaultCase === "string" ? `defaultCase "${p.defaultCase}"` : "empty/first case"}. A case \`id\` must EQUAL the casePath value, not a component id.`
+          message: `FragmentSlot casePath resolves to "${resolved2}" which matches no case id (${ids.join(", ")}) \u2014 it renders the ${typeof p.defaultCase === "string" ? `defaultCase "${p.defaultCase}"` : "empty/first case"}. A case \`id\` must EQUAL the casePath value, not a component id.`
         });
       }
     }
@@ -19047,8 +19048,8 @@ function resolveFamilyName(input) {
   return void 0;
 }
 function addReport(appDir2, family) {
-  const resolved = resolveFamilyName(family);
-  if (!resolved) {
+  const resolved2 = resolveFamilyName(family);
+  if (!resolved2) {
     return {
       ok: false,
       count: 0,
@@ -19057,15 +19058,15 @@ function addReport(appDir2, family) {
       hint: "run `himi fonts list` to see every family, or add it to stdlib/fonts/catalog.source.json"
     };
   }
-  const fam = findFamily(resolved);
+  const fam = findFamily(resolved2);
   const bytes2 = fam?.faces.reduce((n, f) => n + f.bytes, 0) ?? 0;
   return {
     ok: true,
     count: 1,
     totalBytes: bytes2,
     problems: [],
-    families: [{ family: resolved, license: fam?.license.id ?? "system", copyright: fam?.license.copyright, kb: Math.round(bytes2 / 1024) }],
-    hint: `add "${resolved}" to ${join23(appDir2, "fonts.json")} under "families" (or name it in tokens.json typography), then run gen.sh. Licence: ${fam?.license.id ?? "system"}${fam?.license.copyright ? ` \u2014 ${fam.license.copyright}` : ""}`
+    families: [{ family: resolved2, license: fam?.license.id ?? "system", copyright: fam?.license.copyright, kb: Math.round(bytes2 / 1024) }],
+    hint: `add "${resolved2}" to ${join23(appDir2, "fonts.json")} under "families" (or name it in tokens.json typography), then run gen.sh. Licence: ${fam?.license.id ?? "system"}${fam?.license.copyright ? ` \u2014 ${fam.license.copyright}` : ""}`
   };
 }
 var DEFAULT_ASSET_BUDGET_BYTES;
@@ -24220,9 +24221,9 @@ function evalEnvExpr(raw, env) {
   return (parsed.op === "==" ? equal : !equal) ? "true" : "false";
 }
 function envHidden(raw, env) {
-  const resolved = evalEnvExpr(raw, env);
-  if (resolved === void 0) return void 0;
-  const l = resolved.trim().toLowerCase();
+  const resolved2 = evalEnvExpr(raw, env);
+  if (resolved2 === void 0) return void 0;
+  const l = resolved2.trim().toLowerCase();
   return l === "true" || l === "1";
 }
 var ENV_SENTINEL;
@@ -25257,6 +25258,7 @@ function shouldRevealError(args) {
 var EMAIL_RE, URL_HOST_RE, INTEGER_RE, NUMBER_RE;
 var init_validation = __esm({
   "../../core/ts/src/validation.ts"() {
+    "use strict";
     EMAIL_RE = /^[A-Za-z0-9._%+-]+@[A-Za-z0-9-]+(\.[A-Za-z0-9-]+)*\.[A-Za-z]{2,}$/;
     URL_HOST_RE = /^[A-Za-z0-9-]+(\.[A-Za-z0-9-]+)*(:[0-9]+)?$/;
     INTEGER_RE = /^[+-]?[0-9]+$/;
@@ -27788,17 +27790,17 @@ var init_controls = __esm({
     A11ySwitch = ({ props, ctx, wrap }) => {
       const C = ctx.color;
       const bound = useResolvedScalar(props.valuePath, ctx);
-      const resolved = ctx.empty ? false : props.valuePath != null ? encodeToggleFieldValue(bound) === "true" : encodeToggleFieldValue(props.value, props.on === true) === "true";
+      const resolved2 = ctx.empty ? false : props.valuePath != null ? encodeToggleFieldValue(bound) === "true" : encodeToggleFieldValue(props.value, props.on === true) === "true";
       const bag = React3.useContext(FormValuesContext);
       const fieldId = props.__formFieldId;
       const inForm = Boolean(bag && fieldId);
       const [formOn, setFormOn] = React3.useState(null);
       const touched = React3.useRef(false);
       React3.useEffect(() => {
-        if (touched.current && bag && fieldId) bag.set(fieldId, encodeToggleFieldValue(resolved));
+        if (touched.current && bag && fieldId) bag.set(fieldId, encodeToggleFieldValue(resolved2));
         setFormOn(null);
-      }, [resolved]);
-      const on3 = inForm && formOn !== null ? formOn : resolved;
+      }, [resolved2]);
+      const on3 = inForm && formOn !== null ? formOn : resolved2;
       const ruleKey = props.validation ? JSON.stringify(props.validation) : "";
       React3.useEffect(() => {
         if (!bag || !fieldId) return;
@@ -28646,6 +28648,7 @@ function validateWorkerSubtree(raw, slotId, policy, actionCatalog) {
 var WORKER_SUBTREE_CEILINGS, ID_PART, ACTION_ID;
 var init_worker_subtree = __esm({
   "../../core/ts/src/worker-subtree.ts"() {
+    "use strict";
     init_worker_subtree_safe_types_generated();
     WORKER_SUBTREE_CEILINGS = Object.freeze({
       maxEncodedBytes: 65536,
@@ -29339,9 +29342,9 @@ function useResolvedMediaItems(items, ctx) {
     for (const f of MEDIA_ITEM_BINDABLE) {
       const v = it[f];
       if (typeof v !== "string" || !isBinding(v)) continue;
-      const resolved = v.startsWith("$service:") ? ctx.provider ? values[servicePath(v)] ?? void 0 : void 0 : resolveScalarStatic(v, ctx);
+      const resolved2 = v.startsWith("$service:") ? ctx.provider ? values[servicePath(v)] ?? void 0 : void 0 : resolveScalarStatic(v, ctx);
       out = out ?? { ...it };
-      out[f] = resolved;
+      out[f] = resolved2;
     }
     return out ?? it;
   }), [items, values, ctx]);
@@ -29805,11 +29808,11 @@ function actionTextButton(ctx, action, label2, color, extra) {
 }
 function dispatchCalendarAction(ctx, action, extra) {
   if (!ctx.onAction || !action) return;
-  const resolved = resolveItemDeep2(action, ctx);
+  const resolved2 = resolveItemDeep2(action, ctx);
   ctx.onAction({
-    ...resolved,
-    args: { ...resolved?.args ?? {}, ...extra },
-    params: { ...resolved?.params ?? {}, ...Object.fromEntries(Object.entries(extra).map(([k, v]) => [k, String(v)])) }
+    ...resolved2,
+    args: { ...resolved2?.args ?? {}, ...extra },
+    params: { ...resolved2?.params ?? {}, ...Object.fromEntries(Object.entries(extra).map(([k, v]) => [k, String(v)])) }
   });
 }
 function calKeyActivate(enabled, activate) {
@@ -29913,8 +29916,8 @@ function renderNodeInner(node, ctx) {
     }
     const accessibilityLabel = node?.modifiers?.accessibilityLabel ?? node?.modifiers?.accessibility_label;
     if (accessibilityLabel != null) {
-      const resolved = resolveScalarStatic(accessibilityLabel, ctx);
-      if (resolved != null && String(resolved).trim()) extra["aria-label"] = String(resolved);
+      const resolved2 = resolveScalarStatic(accessibilityLabel, ctx);
+      if (resolved2 != null && String(resolved2).trim()) extra["aria-label"] = String(resolved2);
     }
     ensurePressStyles();
     extra["data-himalaya-tap"] = "1";
@@ -30282,8 +30285,8 @@ function renderInner(node, ctx) {
     case "Spacer": {
       if (props.collapseWhenEmpty === true) {
         const raw = props.value;
-        const resolved = typeof raw === "string" && isBinding(raw) ? resolveScalarStatic(raw, ctx) : raw;
-        const s = resolved == null ? "" : String(resolved);
+        const resolved2 = typeof raw === "string" && isBinding(raw) ? resolveScalarStatic(raw, ctx) : raw;
+        const s = resolved2 == null ? "" : String(resolved2);
         if (!s || s === "\u2014") return null;
       }
       return /* @__PURE__ */ jsx6("div", { style: { flex: 1 } });
@@ -30818,8 +30821,8 @@ var init_renderNode = __esm({
     asTextL10n = (v, ctx) => typeof v === "string" && v.startsWith(TRANSLATION_PREFIX) ? asText2(resolveTranslation(v, ctx.catalog)) : asText2(v);
     asBoundText = (v, ctx) => isBinding(v) ? asTextL10n(resolveScalarStatic(v, ctx) ?? "", ctx) : asText2(v);
     useBoundString = (v, ctx) => {
-      const resolved = useResolvedScalar(v, ctx);
-      return isBinding(v) ? asTextL10n(resolved ?? "", ctx) : asText2(v);
+      const resolved2 = useResolvedScalar(v, ctx);
+      return isBinding(v) ? asTextL10n(resolved2 ?? "", ctx) : asText2(v);
     };
     InterpolatedTextView = ({ pattern, params, ctx }) => {
       const bound = Object.entries(params).filter(
@@ -30839,19 +30842,19 @@ var init_renderNode = __esm({
         );
         return () => unsubs.forEach((u) => u());
       }, [ctx.provider, subKey]);
-      const resolved = { ...live2 };
+      const resolved2 = { ...live2 };
       for (const [k, v] of Object.entries(params)) {
-        if (typeof v === "string" && v.startsWith("$item")) resolved[k] = resolveScalarStatic(v, ctx);
+        if (typeof v === "string" && v.startsWith("$item")) resolved2[k] = resolveScalarStatic(v, ctx);
       }
-      return /* @__PURE__ */ jsx6(Fragment3, { children: formatInterpolated(pattern, params, resolved, ctx) });
+      return /* @__PURE__ */ jsx6(Fragment3, { children: formatInterpolated(pattern, params, resolved2, ctx) });
     };
     txt = (v, ctx) => {
       if (!isBinding(v)) return asText2(v);
       if (v.startsWith(TRANSLATION_PREFIX)) return asText2(resolveTranslation(v, ctx.catalog));
       if (v.startsWith("$item")) {
         const key2 = v.replace(/^\$item\.?/, "");
-        const resolved = ctx.itemScope ? key2 ? ctx.itemScope[key2] : ctx.itemScope : void 0;
-        return resolved != null ? asTextL10n(resolved, ctx) : bindingPlaceholder(v, ctx);
+        const resolved2 = ctx.itemScope ? key2 ? ctx.itemScope[key2] : ctx.itemScope : void 0;
+        return resolved2 != null ? asTextL10n(resolved2, ctx) : bindingPlaceholder(v, ctx);
       }
       if (ctx.provider) return /* @__PURE__ */ jsx6(Bound, { ctx, binding: v, render: (val) => asTextL10n(val, ctx) });
       return bindingPlaceholder(v, ctx);
@@ -31002,11 +31005,11 @@ var init_renderNode = __esm({
     };
     resolvedComponentId = (id, ctx) => {
       if (typeof id !== "string" || !id) return void 0;
-      const resolved = id.replace(/\$item(?:\.[A-Za-z0-9_]+)*/g, (binding2) => {
+      const resolved2 = id.replace(/\$item(?:\.[A-Za-z0-9_]+)*/g, (binding2) => {
         const value = resolveScalarStatic(binding2, ctx);
         return value == null ? binding2 : String(value);
       });
-      return resolved.includes("$item") ? void 0 : resolved;
+      return resolved2.includes("$item") ? void 0 : resolved2;
     };
     directServiceBindings = (node) => {
       const out = /* @__PURE__ */ new Set();
@@ -33118,12 +33121,12 @@ var init_renderNode = __esm({
         const cLat = userCam?.lat ?? baseLat;
         const cLng = userCam?.lng ?? baseLng;
         React5.useEffect(() => {
-          const resolved = resolveCamera(commandedCamera, cLat, cLng, z);
-          if (!resolved) return;
+          const resolved2 = resolveCamera(commandedCamera, cLat, cLng, z);
+          if (!resolved2) return;
           setUserCam({
-            lat: Math.max(-MAX_MERCATOR_LAT, Math.min(MAX_MERCATOR_LAT, resolved.latitude)),
-            lng: resolved.longitude,
-            z: Math.max(1, Math.min(19, resolved.zoom ?? z))
+            lat: Math.max(-MAX_MERCATOR_LAT, Math.min(MAX_MERCATOR_LAT, resolved2.latitude)),
+            lng: resolved2.longitude,
+            z: Math.max(1, Math.min(19, resolved2.zoom ?? z))
           });
         }, [commandedCamera]);
         const originX = mercatorX(cLng, z) - W / 2;
@@ -34095,17 +34098,17 @@ function collectResolvedMediaRecord(record2, path, context) {
   }
 }
 function collectResolvedMediaValues(value, path, context) {
-  const resolved = typeof value === "string" ? resolveTreeScalar(value, context.provider, context.itemScope) : value;
-  if (typeof resolved === "string") {
-    if (context.insideMediaProperty) context.values[path] = resolved;
+  const resolved2 = typeof value === "string" ? resolveTreeScalar(value, context.provider, context.itemScope) : value;
+  if (typeof resolved2 === "string") {
+    if (context.insideMediaProperty) context.values[path] = resolved2;
     return;
   }
-  if (Array.isArray(resolved)) {
-    resolved.forEach((item, index) => collectResolvedMediaValues(item, `${path}[${index}]`, context));
+  if (Array.isArray(resolved2)) {
+    resolved2.forEach((item, index) => collectResolvedMediaValues(item, `${path}[${index}]`, context));
     return;
   }
-  if (resolved && typeof resolved === "object") {
-    collectResolvedMediaRecord(resolved, path, context);
+  if (resolved2 && typeof resolved2 === "object") {
+    collectResolvedMediaRecord(resolved2, path, context);
   }
 }
 function collectComponentMediaValues(type, props, context) {
@@ -34734,8 +34737,8 @@ function endpointErrors(endpoint, index, options) {
   if (typeof endpoint.pathPrefix !== "string" || !endpoint.pathPrefix.startsWith("/") || endpoint.pathPrefix.startsWith("//")) {
     errors.push(`${at}.pathPrefix must be an absolute pathname boundary`);
   } else if (origin) {
-    const resolved = new URL(endpoint.pathPrefix, origin);
-    if (resolved.origin !== origin.origin || resolved.pathname !== endpoint.pathPrefix || resolved.search || resolved.hash) {
+    const resolved2 = new URL(endpoint.pathPrefix, origin);
+    if (resolved2.origin !== origin.origin || resolved2.pathname !== endpoint.pathPrefix || resolved2.search || resolved2.hash) {
       errors.push(`${at}.pathPrefix must not contain a query, fragment, host, or dot-segment`);
     }
   }
@@ -36281,9 +36284,9 @@ function effectiveAppTokens(req, state) {
     if (motionDefs.length) {
       const cfg = currentFlagConfig(state);
       const assignments = evaluateAll(motionDefs, evalContextFromReq(req, state.appName), cfg?.overrides);
-      const resolved = applyMotionFlagOverride(tokens, assignments);
-      tokens = resolved.tokens;
-      motionToggles = resolved.togglesApplied;
+      const resolved2 = applyMotionFlagOverride(tokens, assignments);
+      tokens = resolved2.tokens;
+      motionToggles = resolved2.togglesApplied;
     }
   } catch {
   }
@@ -38479,13 +38482,13 @@ function createDevServer(opts = {}) {
   const netMocksDisabled = opts.netMocks === false;
   const explicitNetMocksPath = typeof opts.netMocks === "string" ? opts.netMocks : process.env.HIMALAYA_NET_MOCKS;
   const netMocksPath = netMocksDisabled ? void 0 : explicitNetMocksPath ?? (state.app?.meta.devGateway?.enabled === false ? void 0 : state.app ? resolve28(state.app.dir, "dev/net-mocks.json") : void 0);
-  const resolved = netMocksDisabled ? null : resolveNetMocks(
+  const resolved2 = netMocksDisabled ? null : resolveNetMocks(
     netMocksPath ? readNetMocksFile(netMocksPath) : null,
     state.app?.meta.devGateway
   );
-  if (resolved) {
-    const seeded = applyNetMocks(state.wix, resolved.mocks);
-    const from = resolved.source === "file" ? netMocksPath : `${state.appName} devGateway.rules`;
+  if (resolved2) {
+    const seeded = applyNetMocks(state.wix, resolved2.mocks);
+    const from = resolved2.source === "file" ? netMocksPath : `${state.appName} devGateway.rules`;
     console.error(`[himalaya-dev] net-mocks: seeded ${seeded.rules} rule(s), mode=${seeded.mode} from ${from}`);
   }
   const appScenario = state.app?.meta.devGateway;
@@ -39483,15 +39486,15 @@ async function withStoreNavBundle(text2, address) {
     (r) => !!r && typeof r === "object" && typeof r.url === "string"
   );
   if (refs.length === 0) return text2;
-  const resolved = [];
+  const resolved2 = [];
   for (const ref of refs) {
     const name = bundleNameFromUrl(ref.url);
     if (!name) return text2;
     const addressed = await address(name);
     if (!addressed) return text2;
-    resolved.push({ ref, url: addressed.url, sri: addressed.sri });
+    resolved2.push({ ref, url: addressed.url, sri: addressed.sri });
   }
-  for (const { ref, url, sri: integrity2 } of resolved) {
+  for (const { ref, url, sri: integrity2 } of resolved2) {
     ref.url = url;
     ref.integrity = integrity2;
   }
@@ -40527,6 +40530,140 @@ var init_capability_fixtures = __esm({
   }
 });
 
+// ../../core/dev-server/src/crawl-input.ts
+function resolved(v, resolve41) {
+  if (typeof v === "string") return v.startsWith("$service:") ? resolve41(v) : v;
+  if (Array.isArray(v)) {
+    const out = v.flatMap((el) => {
+      if (typeof el !== "string" || !el.startsWith("$service:")) return [el];
+      const r = resolve41(el);
+      return Array.isArray(r) ? r : [r];
+    });
+    return out;
+  }
+  return v;
+}
+function hasRowBinding(props) {
+  const itemToken = (v) => typeof v === "string" && v.startsWith("$item");
+  return VALUE_PROPS.some((k) => {
+    const v = props[k];
+    return itemToken(v) || Array.isArray(v) && v.some(itemToken);
+  });
+}
+function declaredOptionIds(props, resolve41) {
+  const literal = props.options ?? props.tabs ?? props.chips;
+  const bound = props.optionsPath !== void 0 ? resolved(props.optionsPath, resolve41) : void 0;
+  const raw = Array.isArray(bound) ? bound : literal;
+  if (!Array.isArray(raw)) return [];
+  const out = [];
+  for (const o of raw) {
+    const id = o && typeof o === "object" ? o.id : o;
+    if (typeof id === "string" && id && !id.startsWith("$")) out.push(id);
+  }
+  return out;
+}
+function seedTokens(state, limit = 48) {
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  let budget = 4e3;
+  const take = (s) => {
+    for (const raw of s.split(/[^\p{L}'-]+/u)) {
+      if (out.length >= limit) return;
+      const tok = raw.replace(/^['-]+/, "").replace(/['-]+$/, "");
+      if (tok.length < 3 || tok.length > 24) continue;
+      if (!new RegExp("^\\p{L}[\\p{L}'-]*$", "u").test(tok)) continue;
+      if (NEVER_TYPED.has(tok)) continue;
+      if (seen.has(tok)) continue;
+      seen.add(tok);
+      out.push(tok);
+    }
+  };
+  const walk2 = (node, depth) => {
+    if (out.length >= limit || budget-- <= 0 || depth > 6) return;
+    if (typeof node === "string") {
+      if (node.length <= 200 && !node.includes("://") && !node.startsWith("$")) take(node);
+      return;
+    }
+    if (Array.isArray(node)) {
+      for (const el of node) walk2(el, depth + 1);
+      return;
+    }
+    if (node && typeof node === "object") {
+      for (const v of Object.values(node)) walk2(v, depth + 1);
+    }
+  };
+  walk2(state, 0);
+  return out;
+}
+function synthesizeInput(control, resolve41, tokens) {
+  const id = `${control.type}.${control.callback}`;
+  const row = SYNTHESIZED_CONTROLS[id];
+  if (!row) return null;
+  const props = control.props;
+  if (hasRowBinding(props)) return null;
+  if (row.from === "declared-options") {
+    const ids = declaredOptionIds(props, resolve41);
+    if (!ids.length) return null;
+    if (row.encoding === "string-array") {
+      const currentRaw2 = resolved(props.selectedIds, resolve41);
+      const current3 = (Array.isArray(currentRaw2) ? currentRaw2 : []).filter((x) => typeof x === "string");
+      const pick4 = ids.find((o) => !current3.includes(o));
+      if (pick4 === void 0) return null;
+      const value = props.multiSelect === true ? [...current3, pick4] : [pick4];
+      return { key: row.key, value, from: row.from, current: current3, control: id };
+    }
+    const currentRaw = resolved(props.selectedId, resolve41);
+    const current2 = typeof currentRaw === "string" ? currentRaw : void 0;
+    const pick3 = ids.find((o) => o !== current2);
+    if (pick3 === void 0) return null;
+    return { key: row.key, value: pick3, from: row.from, current: current2, control: id };
+  }
+  if (!acceptsWords(props) || !acceptsWords(control.wrapper ?? {})) return null;
+  const binding2 = typeof props.valuePath === "string" ? props.valuePath : typeof props.value === "string" && props.value.startsWith("$service:") ? props.value : void 0;
+  const bound = binding2 === void 0 ? void 0 : resolve41(binding2);
+  const literal = typeof props.value === "string" && !props.value.startsWith("$") ? props.value : void 0;
+  const current = typeof bound === "string" ? bound : typeof bound === "number" ? String(bound) : literal ?? "";
+  const max = typeof props.maxLength === "number" && props.maxLength > 0 ? props.maxLength : void 0;
+  const pick2 = tokens().find((t) => t !== current && (max === void 0 || t.length <= max));
+  if (pick2 === void 0) return null;
+  return { key: row.key, value: pick2, from: row.from, current, control: id };
+}
+function acceptsWords(props) {
+  if (props.secure === true) return false;
+  const keyboard = props.keyboard;
+  if (typeof keyboard === "string" && NON_WORD_KEYBOARDS.has(keyboard)) return false;
+  const v = props.validation;
+  if (v && typeof v === "object") {
+    const rules = v;
+    if (rules.type !== void 0 || rules.regex !== void 0) return false;
+    if (rules.minValue !== void 0 || rules.maxValue !== void 0) return false;
+  }
+  return true;
+}
+var SYNTHESIZED_CONTROLS, FORM_FIELD_CONTROL, VALUE_PROPS, NEVER_TYPED, NON_WORD_KEYBOARDS;
+var init_crawl_input = __esm({
+  "../../core/dev-server/src/crawl-input.ts"() {
+    SYNTHESIZED_CONTROLS = {
+      "TextField.onChange": { key: "value", encoding: "string", from: "seed-text" },
+      "SearchField.onChange": { key: "value", encoding: "string", from: "seed-text" },
+      "Picker.onChange": { key: "selectedId", encoding: "string", from: "declared-options" },
+      "SegmentedControl.onChange": { key: "selectedId", encoding: "string", from: "declared-options" },
+      "Tabs.onChange": { key: "selectedId", encoding: "string", from: "declared-options" },
+      "FilterChips.onChange": { key: "selectedIds", encoding: "string-array", from: "declared-options" }
+    };
+    FORM_FIELD_CONTROL = {
+      text: "TextField",
+      picker: "Picker",
+      toggle: "Toggle",
+      stepper: "Stepper",
+      date: "DatePicker"
+    };
+    VALUE_PROPS = ["valuePath", "value", "selectedId", "selectedIds", "optionsPath", "options", "tabs", "chips"];
+    NEVER_TYPED = /* @__PURE__ */ new Set(["NaN", "undefined", "null", "Infinity", "object", "Object"]);
+    NON_WORD_KEYBOARDS = /* @__PURE__ */ new Set(["number", "decimal", "email", "phone", "url"]);
+  }
+});
+
 // ../../core/dev-server/src/crawl-relations.ts
 function inversePartner(action, declared) {
   if (/^toggle/i.test(action)) return null;
@@ -40685,11 +40822,15 @@ __export(screen_crawl_exports, {
 });
 function actionSites(payload) {
   const out = [];
-  const visit = (node, ownerId, itemsPath) => {
-    if (Array.isArray(node)) return node.forEach((n) => visit(n, ownerId, itemsPath));
+  const visit = (node, ownerId, itemsPath, type, wrapper) => {
+    if (Array.isArray(node)) return node.forEach((n) => visit(n, ownerId, itemsPath, type, wrapper));
     if (!node || typeof node !== "object") return;
     const rec = node;
     const id = typeof rec.id === "string" ? rec.id : ownerId;
+    const body = rec.body;
+    const isComponent = body != null && typeof body === "object" && typeof body.type === "string";
+    const ownType = isComponent ? body.type : type;
+    const ownWrapper = isComponent ? void 0 : wrapper;
     const ownItems = typeof rec.itemsPath === "string" ? rec.itemsPath.startsWith("$service:") ? rec.itemsPath : rec.itemsPath.startsWith("$item.") && itemsPath && itemsPath !== UNTRACKED_ITEMS && !itemsPath.includes(NESTED_ITEMS_SEP) ? `${itemsPath}${NESTED_ITEMS_SEP}${rec.itemsPath.slice("$item.".length)}` : UNTRACKED_ITEMS : void 0;
     const ambient = ownItems ?? itemsPath;
     for (const [k, v] of Object.entries(rec)) {
@@ -40702,15 +40843,28 @@ function actionSites(payload) {
             actionId: a.actionId,
             params: a.params ?? {},
             ...a.args ? { args: a.args } : {},
-            ...ambient ? { itemsPath: ambient } : {}
+            ...ambient ? { itemsPath: ambient } : {},
+            // `rec` IS the prop bag that carries this callback — for a plain node that is
+            // `body.props`, and for a FormField variant the nested `text`/`picker`/… object, which
+            // is exactly where the option list or value binding lives.
+            ...ownType ? { control: { type: ownType, props: rec, ...ownWrapper ? { wrapper: ownWrapper } : {} } } : {}
           });
         }
         continue;
       }
-      visit(v, id, ambient);
+      const intoVariant = ownType === "FormField" && k in FORM_FIELD_CONTROL;
+      visit(
+        v,
+        id,
+        ambient,
+        intoVariant ? FORM_FIELD_CONTROL[k] : ownType,
+        // Descending into a FormField's variant: `rec` is the FormField's own props, and its
+        // `validation` constrains the control being rendered inside.
+        intoVariant ? rec : ownWrapper
+      );
     }
   };
-  visit(payload, null, void 0);
+  visit(payload, null, void 0, null, void 0);
   return out;
 }
 function actionSitesForDescriptor(descriptor) {
@@ -41248,15 +41402,16 @@ async function crawlScreenInner(opts) {
   const navEdges = [];
   const unobservedActions = [];
   let observations;
+  let seedWords = [];
   const harvestStaticEdges = (state) => {
     const provider = new FakeServiceProvider(state);
     for (const site of sites) {
       if (site.actionId !== "himi.open") continue;
-      const resolved = resolveActionServiceParams(
+      const resolved2 = resolveActionServiceParams(
         { actionId: site.actionId, params: site.params, args: site.args },
         provider
       );
-      const merged = { ...resolved.params ?? {}, ...resolved.args ?? {} };
+      const merged = { ...resolved2.params ?? {}, ...resolved2.args ?? {} };
       const row0 = firstRowFor(site.itemsPath, (p) => provider.value(p));
       const resolveItem = (v) => {
         if (typeof v !== "string" || !v.startsWith("$item")) return v;
@@ -41457,8 +41612,8 @@ async function crawlScreenInner(opts) {
       const before = { ...site.params ?? {}, ...site.args ?? {} };
       const bound = Object.entries(before).filter(([, v]) => typeof v === "string" && v.startsWith("$service:"));
       if (!bound.length) continue;
-      const resolved = resolveActionServiceParams({ actionId: site.actionId, params: site.params, args: site.args }, provider);
-      const after = { ...resolved.params ?? {}, ...resolved.args ?? {} };
+      const resolved2 = resolveActionServiceParams({ actionId: site.actionId, params: site.params, args: site.args }, provider);
+      const after = { ...resolved2.params ?? {}, ...resolved2.args ?? {} };
       for (const [k, v] of bound) {
         if (!(k in after)) {
           findings.push({
@@ -41493,6 +41648,7 @@ async function crawlScreenInner(opts) {
       if (first.deadLifecycle) reportDeadLifecycle(first.deadLifecycle);
       check("boot", first.state, first.errors, first.defects);
       observations = collectObservations(descriptor, first.state);
+      seedWords = seedTokens(first.state);
       harvestStaticEdges(first.state);
       drainWorkerEdges(first, "worker:boot");
       drainPollDirectives(first, "boot");
@@ -41571,16 +41727,19 @@ async function crawlScreenInner(opts) {
         continue;
       }
       const trigger = { tap: site.componentId, key: site.key, action: site.actionId };
-      const effective = effectiveSiteFor(site, snapshot(w).state);
+      const preState = snapshot(w).state;
+      const effective = effectiveSiteFor(site, preState);
       if (!effective) {
         actionsSkipped.push({ action: site.actionId, why: "no-row-value" });
         continue;
       }
-      const before = JSON.stringify(snapshot(w).state);
+      const typed = synthesizedFor(site, effective, preState, () => seedWords);
+      const dispatched = typed ? { ...effective, args: { ...effective.args ?? {}, [typed.key]: typed.value } } : effective;
+      const before = JSON.stringify(preState);
       const callsBefore = w.calls.length;
       const errors = [];
       try {
-        await handle.dispatch(parsed.action, ...workerArgs(effective));
+        await handle.dispatch(parsed.action, ...workerArgs(dispatched));
       } catch (e) {
         errors.push({ service: parsed.service, message: `${parsed.action}: ${errText(e)}`, ...e.stack ? { stack: e.stack } : {} });
       }
@@ -41591,11 +41750,25 @@ async function crawlScreenInner(opts) {
       drainWorkerEdges(w, `worker:${site.actionId}`);
       drainPollDirectives(w, trigger);
       if (!errors.length && navEdges.length === navCountBefore && w.calls.length === callsBefore && JSON.stringify(state) === before) {
+        if (typed) {
+          findings.push({
+            screen: screenId,
+            trigger,
+            invariant: "typed-value-ignored",
+            severity: "warning",
+            axis: "input",
+            ...site.componentId ? { at: site.componentId } : {},
+            field: typed.key,
+            actual: JSON.stringify(typed.value),
+            message: `${typed.control} carried ${typed.key}=${JSON.stringify(typed.value)} into ${site.actionId} and nothing changed \u2014 no state delta, no navigation, no request`,
+            hint: `core/schema/action-payload-contract.json declares ${typed.control} injects "${typed.key}", and every renderer sends it \u2014 a reducer whose result does not depend on it cannot work on device (check the key it reads off its payload). The value came from ${typed.from === "declared-options" ? "this control's own option list" : "the worker's own seeded state"}; the control currently shows ${JSON.stringify(typed.current)}. If the no-op is deliberate, silence it in himi-test.json: {"skip":[{"invariant":"typed-value-ignored","reason":"\u2026"}]}.`
+          });
+        }
         unobservedActions.push({
           action: site.actionId,
           componentId: site.componentId,
           key: site.key,
-          argless: workerArgs(effective).length === 0
+          argless: workerArgs(dispatched).length === 0
         });
       }
     } finally {
@@ -41945,6 +42118,23 @@ function effectiveSiteForRow(site, row) {
   }
   return { ...site, params: substituted, args: void 0 };
 }
+function synthesizedFor(site, effective, state, tokens) {
+  if (!site.control) return null;
+  const provider = new FakeServiceProvider(state);
+  const candidate = synthesizeInput(
+    {
+      type: site.control.type,
+      callback: site.key,
+      props: site.control.props,
+      ...site.control.wrapper ? { wrapper: site.control.wrapper } : {}
+    },
+    (p) => provider.value(p),
+    tokens
+  );
+  if (!candidate) return null;
+  const declared = { ...effective.params ?? {}, ...effective.args ?? {} };
+  return candidate.key in declared ? null : candidate;
+}
 function isRowBound(site) {
   const payload = { ...site.params ?? {}, ...site.args ?? {} };
   return Object.values(payload).some((v) => typeof v === "string" && (v === "$item" || v.startsWith("$item.")));
@@ -42151,6 +42341,7 @@ var init_screen_crawl = __esm({
     init_actionParams();
     init_implications();
     init_capability_fixtures();
+    init_crawl_input();
     init_crawl_relations();
     ACTION_KEYS = [
       "action",
@@ -45278,9 +45469,9 @@ function assertKey(key2) {
   if (typeof key2 !== "string" || key2.length < 1 || key2.length > 256) throw new Error("KV key must contain 1 to 256 characters");
 }
 function ttl(spec, value) {
-  const resolved = value ?? spec.defaultTtlSeconds;
-  if (resolved !== void 0 && (!Number.isInteger(resolved) || resolved < 1 || resolved > KV_MAX_TTL_SECONDS)) throw new Error(`KV ttlSeconds must be an integer from 1 to ${KV_MAX_TTL_SECONDS}`);
-  return resolved;
+  const resolved2 = value ?? spec.defaultTtlSeconds;
+  if (resolved2 !== void 0 && (!Number.isInteger(resolved2) || resolved2 < 1 || resolved2 > KV_MAX_TTL_SECONDS)) throw new Error(`KV ttlSeconds must be an integer from 1 to ${KV_MAX_TTL_SECONDS}`);
+  return resolved2;
 }
 function logicalCollection(spec, app) {
   return spec.wixId ?? ownedName(spec, app) ?? "";
@@ -47347,16 +47538,16 @@ ${releaseId}`;
         if (request.method !== "GET") return json3(405, { error: "method_not_allowed" });
         const cfg = await appConfigFor(app2, resolvePin(request, url));
         if (!cfg.ok) return cfg.response;
-        const resolved = wixMemberAuthOf(utf8Decode(cfg.bytes), callbackUrlFor(url));
-        if (!resolved.ok) return json3(501, { error: `member_auth_${resolved.error}`, app: app2 });
+        const resolved2 = wixMemberAuthOf(utf8Decode(cfg.bytes), callbackUrlFor(url));
+        if (!resolved2.ok) return json3(501, { error: `member_auth_${resolved2.error}`, app: app2 });
         const returnTo = safeReturnPath(url.searchParams.get("return"), `/preview/a/${encodeURIComponent(app2)}`);
         const state = randomToken(16);
         const pkce = await generatePkce();
         let authUrl;
         try {
-          const visitor = await webwixTokens.token(resolved.config.clientId);
+          const visitor = await webwixTokens.token(resolved2.config.clientId);
           authUrl = await hostedAuthUrl(
-            { ...resolved.config, mode: path.endsWith("/register") ? "signup" : "login", state, challenge: pkce.challenge },
+            { ...resolved2.config, mode: path.endsWith("/register") ? "signup" : "login", state, challenge: pkce.challenge },
             visitor,
             webwixFetch
           );
@@ -47371,7 +47562,7 @@ ${releaseId}`;
           verifier: pkce.verifier,
           state,
           returnTo,
-          auth: resolved.config,
+          auth: resolved2.config,
           expiresAt: Date.now() + PENDING_LOGIN_TTL_MS
         });
         return new Response(null, {
@@ -47462,9 +47653,9 @@ ${releaseId}`;
             return json3(502, { error: "webwix_bridge_upstream_failed", detail: msg.slice(0, 200) });
           }
         }
-        const resolved = wixClientIdOf(utf8Decode(cfgBytes));
-        if ("error" in resolved) {
-          return json3(501, { error: `webwix_bridge_${resolved.error}`, app: app2 });
+        const resolved2 = wixClientIdOf(utf8Decode(cfgBytes));
+        if ("error" in resolved2) {
+          return json3(501, { error: `webwix_bridge_${resolved2.error}`, app: app2 });
         }
         const memberStore = memberSessions();
         const memberBoundApp = memberApp(request);
@@ -47484,11 +47675,11 @@ ${releaseId}`;
           }
         }
         try {
-          const token = await webwixTokens.token(resolved.clientId);
+          const token = await webwixTokens.token(resolved2.clientId);
           const first = await wixVisitorCall(method, reqPath, body, token, webwixFetch, forwardedHeaders);
           if (first.status !== 401) return json3(200, first);
-          webwixTokens.invalidate(resolved.clientId);
-          const fresh = await webwixTokens.token(resolved.clientId);
+          webwixTokens.invalidate(resolved2.clientId);
+          const fresh = await webwixTokens.token(resolved2.clientId);
           return json3(200, await wixVisitorCall(method, reqPath, body, fresh, webwixFetch, forwardedHeaders));
         } catch (e) {
           const msg = String(e?.message ?? e);
@@ -48348,18 +48539,18 @@ function openBrowser(url) {
   }
 }
 async function runPackage(source, opts = {}) {
-  const resolved = await resolvePackage(source, opts.workDir);
+  const resolved2 = await resolvePackage(source, opts.workDir);
   const assets = opts.assets ?? (opts.spa ? /* @__PURE__ */ new Map() : await loadPreviewAssets());
   if (!opts.spa && assets.size === 0) {
-    if (resolved.temp) rmSync8(resolved.temp, { recursive: true, force: true });
+    if (resolved2.temp) rmSync8(resolved2.temp, { recursive: true, force: true });
     throw new Error(NO_SPA_MESSAGE);
   }
   const handler = makePackageRunHandler({
-    releaseRoot: resolved.releaseRoot,
-    app: resolved.app,
+    releaseRoot: resolved2.releaseRoot,
+    app: resolved2.app,
     assets,
     chrome: opts.chrome,
-    header: resolved.header
+    header: resolved2.header
   });
   const server = nodeAdapter(handler);
   const host = opts.host ?? "127.0.0.1";
@@ -48371,17 +48562,17 @@ async function runPackage(source, opts = {}) {
     });
   });
   const origin = `http://${host}:${port}`;
-  const url = opts.spa ? `${packageUrl(opts.spa, resolved.app, opts)}${opts.surface ? "&" : "?"}api=${encodeURIComponent(origin)}` : packageUrl(origin, resolved.app, opts);
+  const url = opts.spa ? `${packageUrl(opts.spa, resolved2.app, opts)}${opts.surface ? "&" : "?"}api=${encodeURIComponent(origin)}` : packageUrl(origin, resolved2.app, opts);
   if (opts.open) openBrowser(url);
   return {
-    app: resolved.app,
-    releaseId: resolved.releaseId,
+    app: resolved2.app,
+    releaseId: resolved2.releaseId,
     port,
     url,
-    warnings: resolved.warnings,
+    warnings: resolved2.warnings,
     close: () => new Promise((done) => {
       server.close(() => {
-        if (resolved.temp) rmSync8(resolved.temp, { recursive: true, force: true });
+        if (resolved2.temp) rmSync8(resolved2.temp, { recursive: true, force: true });
         done();
       });
     })
@@ -57933,9 +58124,9 @@ async function cmsIssues(dir, app, strict, opts) {
   try {
     const cfg = await loadAppConfigModule(dir);
     if (cfg) {
-      const resolved = mergeDataResources({ cms: cfg.cms, data: cfg.data });
-      data = { kv: resolved.kv, collections: resolved.collections, ...resolved.memberGated ? { memberGated: true } : {} };
-      cms = { collections: resolved.collections, ...resolved.memberGated ? { memberGated: true } : {} };
+      const resolved2 = mergeDataResources({ cms: cfg.cms, data: cfg.data });
+      data = { kv: resolved2.kv, collections: resolved2.collections, ...resolved2.memberGated ? { memberGated: true } : {} };
+      cms = { collections: resolved2.collections, ...resolved2.memberGated ? { memberGated: true } : {} };
       bootAsVisitor = bootsAsVisitor(cfg.auth);
       hasSignInSurface = !!cfg.screens && cfg.screens.signIn !== false;
     }
@@ -60012,8 +60203,8 @@ async function loadDataResources(dir) {
     try {
       const cfg = await loadAppConfigModule2(dir);
       if (!cfg?.cms && !cfg?.data) return void 0;
-      const resolved = mergeDataResources({ cms: cfg.cms, data: cfg.data });
-      return { kv: resolved.kv, collections: resolved.collections, ...resolved.memberGated ? { memberGated: true } : {} };
+      const resolved2 = mergeDataResources({ cms: cfg.cms, data: cfg.data });
+      return { kv: resolved2.kv, collections: resolved2.collections, ...resolved2.memberGated ? { memberGated: true } : {} };
     } catch (e) {
       throw new ConfigLoadError(p, e);
     }
@@ -62303,8 +62494,8 @@ default (no --glyph): ${DEFAULT_GLYPH2} \u2014 a mark that claims nothing, so th
           if (flags.browser === true) {
             const { runInBrowser: runInBrowser2 } = await Promise.resolve().then(() => (init_run_browser(), run_browser_exports));
             const { resolvePackage: resolvePackage2 } = await Promise.resolve().then(() => (init_run(), run_exports));
-            const resolved = await resolvePackage2(source);
-            const run2 = await runInBrowser2(resolved.releaseRoot, resolved.app, resolved.header, {
+            const resolved2 = await resolvePackage2(source);
+            const run2 = await runInBrowser2(resolved2.releaseRoot, resolved2.app, resolved2.header, {
               ...port !== void 0 ? { port } : {},
               chrome: chromeArg,
               open: flags["no-open"] !== true
@@ -63537,17 +63728,17 @@ ${label2}`);
         const target = str5(flags.target) ?? process.env.HIMI_SERVE_TARGET ?? "local";
         const timeoutMs = Number(str5(flags.timeout)) > 0 ? Number(str5(flags.timeout)) : DOCTOR_TIMEOUT_MS;
         const dataUrl = str5(flags["data-url"]) ?? process.env.HIMI_DATA_URL ?? PUBLIC_WIX_API_BASE;
-        let resolved;
+        let resolved2;
         let serveUrl = "";
         let targetError;
         try {
-          resolved = resolveTarget({
+          resolved2 = resolveTarget({
             target: str5(flags.target),
             serveUrl: str5(flags["serve-url"]),
             controlUrl: str5(flags["control-url"]),
             controlToken: str5(flags["control-token"])
           });
-          serveUrl = resolved.serve;
+          serveUrl = resolved2.serve;
         } catch (e) {
           targetError = e.message;
         }
@@ -63557,9 +63748,9 @@ ${label2}`);
           flags["skip-version-check"] === true ? Promise.resolve(void 0) : doctorVersionReport(cliVersion())
         ]);
         const dpxPath = dpxSessionTokenPath();
-        const tokenHealth = inspectControlToken(resolved?.controlToken);
-        if (tokenHealth.present && tokenHealth.valid && serve.reachable && resolved?.control && resolved.controlToken) {
-          const probed = await probeControlToken(resolved.control, resolved.controlToken, { timeoutMs });
+        const tokenHealth = inspectControlToken(resolved2?.controlToken);
+        if (tokenHealth.present && tokenHealth.valid && serve.reachable && resolved2?.control && resolved2.controlToken) {
+          const probed = await probeControlToken(resolved2.control, resolved2.controlToken, { timeoutMs });
           if (probed.unauthorized) {
             tokenHealth.valid = false;
             tokenHealth.hint = STALE_TOKEN_HINT;

package/guides/himi-test.md

@@ -66,9 +66,15 @@ CLI orchestration: `tools/himi-cli/src/test.ts`.
 
 ## Typed form journeys
 
-The automatic form axis intentionally dispatches the descriptor's default (often empty)
-value. For a flow where the real proof is **typed value → submit → visible completion**,
-add a short screen-local journey to `himi-test.json`:
+The crawl types into a control **only when it can read a legal value off the app itself** — an id
+from the control's own `options`/`optionsPath` that is not the one selected, or a word from the
+booted worker's own seeded state that is not what the field already shows — and only for a control
+the payload contract names. A `Slider`, `Stepper`, `Toggle` or `DatePicker` has no such source, so
+those still dispatch with the descriptor's default (often empty) value, and the gap ledger says so
+per screen.
+
+For a flow where the real proof is **typed value → submit → visible completion** — several fields,
+in order, ending in a rendered result — add a short screen-local journey to `himi-test.json`:
 
 ```json
 {
@@ -111,6 +117,7 @@ Only **unambiguous** defects, so a green run stays worth trusting:
 | `refresh-not-idempotent` | **warning** | `refresh` from a fresh boot settles somewhere other than the boot did, on identical data — usually a refresh that appends instead of replacing. |
 | `list-shrank-on-load-more` | **warning** | A "load more" returned FEWER rows than before it ran: the new page replaced the list instead of extending it. |
 | `list-grew-on-filter` | **warning** | A filter, search or sort made a list longer. Narrowing can reorder or remove, never add. |
+| `typed-value-ignored` | **warning** | The crawl typed the value a control really carries — the payload key every renderer injects for that control — and the dispatch changed **nothing**: no state, no navigation, no request. The value is read off the app itself (an id from the control's own options, or a word from the worker's seeded state) and is always one the control is *not* already showing, so a reducer that ignores it cannot work on device. A warning because the input is the crawl's: a reducer that legitimately no-ops on a value is possible, and `himi-test.json` `skip[]` takes the invariant. |
 
 **Deliberately never reported:** an empty collection · an `error` state (often the correct
 answer to empty input) · a `null` optional · whether a nav target *exists* (approximating

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.833.0",
+  "version": "0.834.0",
   "type": "module",
   "description": "himi — the Himalaya authoring CLI. Build a Tier-5 content package on your own machine, push it to the production serve as a draft, preview it on web + Himi Player, and read worker logs back — the remote dev loop. Wraps @himalaya/serve-cli for transport.",
   "keywords": [
@@ -63,5 +63,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "a2c1ef13eceb008115d02b8e16b9dd82c4a1040e822600be9b93647c"
+  "falconPackageHash": "893b5fd00f0e645919e4a81af83fe3b09ab87b1e966341010aedd5a8"
 }