@wix/himalaya-cli 0.830.0 → 0.832.0

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/ts/src/schema.d.ts

@@ -140,7 +140,16 @@ export interface Modifiers {
      *  Absent (or <= 0) keeps the node at its intrinsic size. Use this — not
      *  `fillMaxWidth` — when a node should claim the remaining space *beside* its
      *  siblings; a full-bleed fill grabs the whole axis and starves them. Ignored
-     *  outside an HStack/VStack. */
+     *  outside an HStack/VStack.
+     *  CAVEAT — row-sharing controls have NO intrinsic width to measure first: in an
+     *  HStack a `Button` and a `Toggle` are implicitly weighted, so they DIVIDE the
+     *  row with your weighted child instead of taking a width ahead of it —
+     *  `[VStack(weight:1), Button, Button]` is a three-way split, not "the VStack gets
+     *  the remainder". The RELIABLE opt-outs are `iconOnly` and `tertiary`/`link` with
+     *  `fullWidth` unset. `fullWidth: false` is NOT reliable here: only Android honors
+     *  it in a weighted row (`wantsRowStretch`); iOS (`WeightedStack`) and web still
+     *  hand the button a share. Otherwise give the actions their own row.
+     *  See `himi docs designing-himi-screens` §4. */
     weight?: number;
     /** RTL — pin the subtree's writing direction: `"ltr"` | `"rtl"` | `"locale"`
      *  (inherit). The common RTL pattern is the inverse of `Text.textDirection`: pin a

package/dist/cli.mjs

@@ -40331,6 +40331,205 @@ var init_net_scenario = __esm({
   }
 });
 
+// ../../core/dev-server/src/capability-fixtures.ts
+function capabilityIdsIn(bundleJs) {
+  const out = /* @__PURE__ */ new Set();
+  for (const m of bundleJs.matchAll(/["'`]capability\.([a-z_]+)\.([A-Za-z]+)["'`]/g)) {
+    if (m[1] === "local_database") continue;
+    out.add(`capability.${m[1]}.${m[2]}`);
+  }
+  return [...out].sort();
+}
+var decodeItem, MEDIA_EXT, MEDIA_MIME, FILE, CALL, MEDIA_STATUS, CAPABILITY_SUCCESS;
+var init_capability_fixtures = __esm({
+  "../../core/dev-server/src/capability-fixtures.ts"() {
+    decodeItem = (raw) => {
+      if (typeof raw !== "string") return {};
+      try {
+        const v = JSON.parse(raw);
+        return v && typeof v === "object" ? v : {};
+      } catch {
+        return {};
+      }
+    };
+    MEDIA_EXT = (url) => {
+      if (typeof url !== "string") return null;
+      let path;
+      try {
+        path = new URL(url).pathname;
+      } catch {
+        path = url.split("#")[0].split("?")[0];
+      }
+      const segment = path.split("/").pop() ?? "";
+      const m = /\.([a-z0-9]{2,5})$/i.exec(segment);
+      return m ? m[1].toLowerCase() : null;
+    };
+    MEDIA_MIME = {
+      mp4: "video/mp4",
+      m4v: "video/mp4",
+      mov: "video/quicktime",
+      webm: "video/webm",
+      mp3: "audio/mpeg",
+      m4a: "audio/mp4",
+      aac: "audio/aac",
+      wav: "audio/wav",
+      ogg: "audio/ogg"
+    };
+    FILE = (name) => ({ uri: `file:///crawl/${name}`, name, mimeType: "audio/m4a", sizeBytes: 4096 });
+    CALL = (peerId, state, clock) => ({
+      callId: "crawl-call-1",
+      kind: "audio",
+      state,
+      peerId,
+      muted: false,
+      route: "earpiece",
+      startedAtMs: clock
+    });
+    MEDIA_STATUS = (clock, autoplay = true) => ({
+      // A real host reports `paused` when a queue is set with `autoplay: false` — which is exactly what
+      // video-courses does. Always answering "playing" exercises the wrong branch and hides the
+      // paused-state behaviour the screen actually has.
+      state: autoplay ? "playing" : "paused",
+      currentIndex: 0,
+      positionMs: 1e3,
+      durationMs: 6e5,
+      rate: 1,
+      bufferedMs: 6e4,
+      queue: [{ id: "lesson-1", title: "Lesson one", url: "https://crawl.invalid/lesson-1.mp4", durationMs: 6e5 }],
+      currentItem: { id: "lesson-1", title: "Lesson one", url: "https://crawl.invalid/lesson-1.mp4", durationMs: 6e5 },
+      startedAtMs: clock
+    });
+    CAPABILITY_SUCCESS = {
+      // --- audio-record ---------------------------------------------------------------------------
+      "capability.audio_record.startSession": (p, ctx) => ({
+        session: {
+          id: "crawl-session-1",
+          mode: p.mode === "background" ? "background" : "foreground",
+          state: "recording",
+          startedAtMs: ctx.clock,
+          segmentCount: 1
+        }
+      }),
+      "capability.audio_record.getSession": (_p, ctx) => ({
+        session: { id: "crawl-session-1", mode: "foreground", state: "recording", startedAtMs: ctx.clock, segmentCount: 1 }
+      }),
+      "capability.audio_record.stopSession": (_p, ctx) => ({
+        session: { id: "crawl-session-1", mode: "foreground", state: "stopped", startedAtMs: ctx.clock, segmentCount: 1 }
+      }),
+      "capability.audio_record.listSegments": (_p, ctx) => ({
+        segments: [
+          { id: "seg-1", sequence: 0, file: FILE("segment-1.m4a"), startedAtMs: ctx.clock, endedAtMs: ctx.clock + 3e4, durationMs: 3e4, transcriptionState: "complete" }
+        ]
+      }),
+      "capability.audio_record.listSessions": (_p, ctx) => ({
+        sessions: [{ id: "crawl-session-1", mode: "foreground", state: "stopped", startedAtMs: ctx.clock, segmentCount: 1 }]
+      }),
+      "capability.audio_record.getPermissionStatus": () => ({ status: "granted" }),
+      "capability.audio_record.requestPermission": () => ({ status: "granted" }),
+      // --- speech ---------------------------------------------------------------------------------
+      "capability.speech.availability": () => ({ recognition: "full", synthesis: "full" }),
+      "capability.speech.transcribeFile": () => ({
+        complete: true,
+        language: "en-US",
+        segments: [{ id: "t-1", text: "crawl transcript", startMs: 0, endMs: 3e4 }]
+      }),
+      "capability.speech.recognizeOnce": () => ({ transcript: "crawl transcript", cancelled: false }),
+      // --- speaker-diarization --------------------------------------------------------------------
+      "capability.speaker_diarization.availability": () => ({ diarization: "full" }),
+      "capability.speaker_diarization.analyzeFile": () => ({
+        speakers: ["speaker-1", "speaker-2"],
+        segments: [
+          { id: "d-1", speakerId: "speaker-1", startMs: 0, endMs: 15e3 },
+          { id: "d-2", speakerId: "speaker-2", startMs: 15e3, endMs: 3e4 }
+        ],
+        complete: true,
+        deferred: false
+      }),
+      // --- on-device-ai ---------------------------------------------------------------------------
+      "capability.on_device_ai.availability": () => ({ textGeneration: "full" }),
+      "capability.on_device_ai.generateText": () => ({ success: true, text: "crawl summary" }),
+      // --- pdf / open-url / share (coach-lab, himi-social) ------------------------------------------
+      "capability.pdf.isAvailable": () => ({ availability: "full" }),
+      "capability.pdf.open": () => ({ opened: true }),
+      "capability.open_url.canOpen": () => ({ canOpen: true }),
+      "capability.open_url.open": () => ({ opened: true }),
+      "capability.share.availability": () => ({ availability: "full" }),
+      "capability.share.share": () => ({ completed: true }),
+      // --- photos (himi-social) ---------------------------------------------------------------------
+      "capability.photos.getSavePermissionStatus": () => ({ status: "granted" }),
+      "capability.photos.saveToLibrary": () => ({ saved: true }),
+      "capability.photos.pick": () => ({
+        items: [{ uri: "file:///crawl/photo-1.jpg", name: "photo-1.jpg", mimeType: "image/jpeg", sizeBytes: 20480 }]
+      }),
+      // --- calls (msgr) -----------------------------------------------------------------------------
+      //
+      // `callStateFrom` drops anything without a non-empty string `callId`, and coerces an unrecognised
+      // `state`/`route` to "failed"/"earpiece" rather than rejecting — so a wrong enum here would not
+      // throw, it would quietly put every call in a failed phase and look like an app bug.
+      "capability.calls.availability": () => ({ availability: "full" }),
+      "capability.calls.getPermissionStatus": () => ({ status: "granted" }),
+      "capability.calls.requestPermission": () => ({ status: "granted" }),
+      "capability.calls.listCalls": () => ({ calls: [] }),
+      "capability.calls.start": (p, ctx) => ({ call: CALL(String(p.peerId ?? "peer-1"), "dialing", ctx.clock) }),
+      "capability.calls.offer": (p, ctx) => ({ call: CALL(String(p.peerId ?? "peer-1"), "ringing", ctx.clock) }),
+      "capability.calls.answer": (_p, ctx) => ({ call: CALL("peer-1", "connected", ctx.clock) }),
+      "capability.calls.getState": (_p, ctx) => ({ call: CALL("peer-1", "connected", ctx.clock) }),
+      "capability.calls.reject": (_p, ctx) => ({ call: CALL("peer-1", "ended", ctx.clock) }),
+      "capability.calls.hangup": (_p, ctx) => ({ call: CALL("peer-1", "ended", ctx.clock) }),
+      "capability.calls.setMuted": (_p, ctx) => ({ call: { ...CALL("peer-1", "connected", ctx.clock), muted: true } }),
+      "capability.calls.setSpeaker": (_p, ctx) => ({ call: { ...CALL("peer-1", "connected", ctx.clock), route: "speaker" } }),
+      // --- media-playback / calendar (video-courses-preview) ----------------------------------------
+      "capability.media_playback.getCapabilities": () => ({ download: true, pictureInPicture: true }),
+      // `autoplay` arrives stringified — the binding sends `String(options.autoplay === true)`.
+      "capability.media_playback.setQueue": (p, ctx) => MEDIA_STATUS(ctx.clock, p.autoplay === true || p.autoplay === "true"),
+      "capability.media_playback.status": (_p, ctx) => MEDIA_STATUS(ctx.clock),
+      "capability.media_playback.getState": (_p, ctx) => MEDIA_STATUS(ctx.clock),
+      // `status` defaults to "failed" when absent and must be one of the MediaDownloadResult literals;
+      // `file` is the handle. Returning `state`/`localUri` modelled a FAILED download while intending
+      // completion, so video-courses took its failure-label branch under a fixture meant to succeed.
+      //
+      // ECHOES THE REQUESTED ITEM. Hard-coding `id: "lesson-1"` overrode the binding's `r?.id ?? item.id`
+      // fallback, so ANY other caller — the demo bundle downloads `demo-tone` — got a lesson-1 handle
+      // back and the crawl labelled the wrong download. A fixture that ignores its request and answers
+      // a constant is the same defect as a screen that renders one.
+      "capability.media_playback.download": (p, ctx) => {
+        const item = decodeItem(p.item);
+        const id = item.id ?? "crawl-item";
+        const ext = MEDIA_EXT(item.url);
+        const name = ext ? `${id}.${ext}` : id;
+        return {
+          id,
+          status: "downloaded",
+          progress: 1,
+          file: { uri: `file:///crawl/${name}`, name, mimeType: ext && MEDIA_MIME[ext] || "application/octet-stream", sizeBytes: 1048576, modifiedAt: ctx.clock }
+        };
+      },
+      "capability.calendar.getPermissionStatus": () => ({ status: "granted" }),
+      "capability.calendar.requestPermission": () => ({ status: "granted" }),
+      "capability.calendar.listEvents": () => ({ events: [] }),
+      "capability.calendar.createEvent": () => ({ id: "crawl-event-1" }),
+      // --- files ----------------------------------------------------------------------------------
+      // `list` reads `r.items` as FileStat[] — `{ handle, modifiedAt }`, not a bare handle — and `stat`
+      // reads `r.stat`. Returning `files`/`file` gave the binding an empty list and a null stat, so the
+      // file flow could not reach its read/remove paths at all. `write` returns the handle itself,
+      // which `toHandle` normalises, NOT an envelope.
+      "capability.files.list": (_p, ctx) => ({ items: [{ handle: FILE("segment-1.m4a"), modifiedAt: ctx.clock }] }),
+      "capability.files.stat": (_p, ctx) => ({ stat: { handle: FILE("segment-1.m4a"), modifiedAt: ctx.clock } }),
+      "capability.files.readText": () => ({ text: "crawl file contents" }),
+      // ECHOES THE REQUESTED PATH. `files.write` returns this object DIRECTLY to `toHandle`, whose
+      // fallback to the requested path only applies when a field is absent — so a hard-coded handle
+      // made every write resolve to the same file, and a consumer passing that handle onward (an export
+      // writing `exports/<id>.gpx`) referenced something that does not exist.
+      "capability.files.write": (p, ctx) => {
+        const path = typeof p.path === "string" && p.path ? p.path : "crawl/written.txt";
+        const name = path.split("/").pop() || path;
+        return { uri: `file:///${path.replace(/^\/+/, "")}`, name, mimeType: typeof p.mimeType === "string" ? p.mimeType : "application/octet-stream", sizeBytes: 1024, modifiedAt: ctx.clock };
+      },
+      "capability.files.remove": () => ({ removed: true })
+    };
+  }
+});
+
 // ../../core/dev-server/src/crawl-relations.ts
 function inversePartner(action, declared) {
   if (/^toggle/i.test(action)) return null;
@@ -40467,6 +40666,7 @@ __export(screen_crawl_exports, {
   bootAndSnapshotState: () => bootAndSnapshotState,
   bootScreenWorker: () => bootScreenWorker,
   crawlScreen: () => crawlScreen,
+  crawlScreenCapabilitySuccess: () => crawlScreenCapabilitySuccess,
   crawlScreenDeep: () => crawlScreenDeep,
   crawlScreenHostile: () => crawlScreenHostile,
   crawlScreenJourney: () => crawlScreenJourney,
@@ -40746,7 +40946,7 @@ function declaredCapabilitiesOf(descriptor) {
   const list = Array.isArray(lb?.declaredCapabilities) ? lb.declaredCapabilities : [];
   return new Set(list.filter((c) => typeof c === "string"));
 }
-function hostDispatch(localDbSchema, declaredCapabilities = /* @__PURE__ */ new Set()) {
+function hostDispatch(localDbSchema, declaredCapabilities = /* @__PURE__ */ new Set(), capabilitySuccess = false, clock = 0) {
   return async (action, params) => {
     if (/memberIdentity|member\.identity|currentMember/i.test(action)) {
       return { id: "crawl-member-0001", loggedIn: true, memberId: "crawl-member-0001" };
@@ -40759,6 +40959,10 @@ function hostDispatch(localDbSchema, declaredCapabilities = /* @__PURE__ */ new
         );
       }
       if (cap[1] === "local_database") return localDatabaseAnswer(localDbSchema, cap[2], params ?? {});
+      if (capabilitySuccess) {
+        const answer = CAPABILITY_SUCCESS[action];
+        if (answer) return answer(params ?? {}, { clock });
+      }
     }
     return null;
   };
@@ -40865,9 +41069,13 @@ async function bootScreenWorker(opts) {
     wixCall: opts.wixCall,
     input,
     budgetMs: opts.budgetMs ?? 2e3,
-    dispatch: hostDispatch(opts.localDbSchema, declaredCapabilitiesOf(opts.descriptor)),
+    // THE SAME CLOCK THE WORKER IS PINNED TO, one line below. `?? 0` gave the fixtures epoch 1970
+    // while the worker believed it was 2026, so a modelled session carried a timestamp fifty-six
+    // years before the "now" the app computes against — inconsistent rendered dates, and any
+    // time-dependent branch taking the wrong arm.
+    dispatch: hostDispatch(opts.localDbSchema, declaredCapabilitiesOf(opts.descriptor), opts.capabilitySuccess === true, opts.clock ?? CRAWL_CLOCK),
     deviceParity: true,
-    clock: opts.clock ?? Date.parse("2026-01-01T00:00:00.000Z"),
+    clock: opts.clock ?? CRAWL_CLOCK,
     seed: opts.seed ?? 1,
     skipLoad: !!(appear && parseWorkerAction(appear.actionId)),
     ...opts.evaluator ? { evaluator: opts.evaluator } : {}
@@ -40941,6 +41149,18 @@ async function withSwallowedRejections(fn) {
     else globalThis.removeEventListener?.("unhandledrejection", swallow);
   }
 }
+async function crawlScreenCapabilitySuccess(opts) {
+  return withSwallowedRejections(async () => {
+    const declared = declaredCapabilitiesOf(opts.descriptor);
+    const modelled = opts.bundleJs ? capabilityIdsIn(opts.bundleJs).filter((id) => CAPABILITY_SUCCESS[id] && grants(declared, id.split(".")[1])) : [];
+    if (!modelled.length) return { findings: [], modelled: 0 };
+    const r = await crawlScreenInner({ ...opts, capabilitySuccess: true });
+    return {
+      findings: r.findings.map((f) => ({ ...f, axis: f.axis ? `capability:success+${f.axis}` : "capability:success" })),
+      modelled: modelled.length
+    };
+  });
+}
 async function crawlScreen(opts) {
   return withSwallowedRejections(() => crawlScreenInner(opts));
 }
@@ -40972,6 +41192,7 @@ async function crawlScreenJourney(opts) {
       clock: opts.clock,
       seed: opts.seed,
       localDbSchema: opts.localDbSchema,
+      capabilitySuccess: opts.capabilitySuccess === true,
       ...opts.evaluator ? { evaluator: opts.evaluator } : {}
     });
     const sites = actionSitesForDescriptor(opts.descriptor);
@@ -41145,7 +41366,7 @@ async function crawlScreenInner(opts) {
     actionsSkipped.push({ action: s.actionId, why: "embedded-preview" });
     return false;
   });
-  const boot = (skipAppear = false) => bundleJs ? bootScreenWorker({ bundleJs, descriptor, wixCall, screenId, inputOverride: opts.inputOverride, budgetMs: opts.budgetMs, clock: opts.clock, seed: opts.seed, skipAppear, localDbSchema: opts.localDbSchema, ...opts.evaluator ? { evaluator: opts.evaluator } : {} }) : null;
+  const boot = (skipAppear = false) => bundleJs ? bootScreenWorker({ bundleJs, descriptor, wixCall, screenId, inputOverride: opts.inputOverride, budgetMs: opts.budgetMs, clock: opts.clock, seed: opts.seed, skipAppear, localDbSchema: opts.localDbSchema, capabilitySuccess: opts.capabilitySuccess === true, ...opts.evaluator ? { evaluator: opts.evaluator } : {} }) : null;
   const check = (trigger, state, errors, defects = {}) => {
     for (const [svc, paths] of Object.entries(defects)) {
       for (const p of paths) {
@@ -41422,7 +41643,7 @@ async function crawlScreenHostileInner(opts, variant5) {
   };
   let w;
   try {
-    w = await bootScreenWorker({ bundleJs, descriptor, wixCall, screenId, budgetMs: opts.budgetMs, clock: opts.clock, seed: opts.seed, localDbSchema: opts.localDbSchema, ...opts.evaluator ? { evaluator: opts.evaluator } : {} });
+    w = await bootScreenWorker({ bundleJs, descriptor, wixCall, screenId, budgetMs: opts.budgetMs, clock: opts.clock, seed: opts.seed, localDbSchema: opts.localDbSchema, capabilitySuccess: opts.capabilitySuccess === true, ...opts.evaluator ? { evaluator: opts.evaluator } : {} });
   } catch (e) {
     return [{
       screen: screenId,
@@ -41567,7 +41788,7 @@ async function bootAndSnapshotState(opts) {
     const { call: wixCall } = layeredTransport({ rules: opts.rules, cmsSeed: opts.cmsSeed, canned: opts.canned });
     let w;
     try {
-      w = await bootScreenWorker({ bundleJs, descriptor, wixCall, screenId, budgetMs: opts.budgetMs, localDbSchema: opts.localDbSchema, ...opts.evaluator ? { evaluator: opts.evaluator } : {} });
+      w = await bootScreenWorker({ bundleJs, descriptor, wixCall, screenId, budgetMs: opts.budgetMs, localDbSchema: opts.localDbSchema, capabilitySuccess: opts.capabilitySuccess === true, ...opts.evaluator ? { evaluator: opts.evaluator } : {} });
     } catch {
       return null;
     }
@@ -41618,7 +41839,8 @@ async function crawlScreenDeep(opts, deep) {
       budgetMs: opts.budgetMs,
       clock: opts.clock,
       seed: opts.seed,
-      localDbSchema: opts.localDbSchema
+      localDbSchema: opts.localDbSchema,
+      capabilitySuccess: opts.capabilitySuccess === true
     });
     const pathLabel = (path) => path.map((i) => sites[i].actionId.replace(/^tier5\./, "")).join(" \u2192 ");
     while (queue.length) {
@@ -41780,6 +42002,7 @@ async function crawlScreenRelations(opts) {
       clock: opts.clock,
       seed: opts.seed,
       localDbSchema: opts.localDbSchema,
+      capabilitySuccess: opts.capabilitySuccess === true,
       ...opts.evaluator ? { evaluator: opts.evaluator } : {}
     });
     const replay = async (path, rowFor = () => null) => {
@@ -41920,7 +42143,7 @@ async function crawlScreenRelations(opts) {
     return { findings: dedupe(findings), checked, byKind };
   });
 }
-var ACTION_KEYS, UNTRACKED_ITEMS, NESTED_ITEMS_SEP, REJECT_ALL_MESSAGE, VLQ, WIX_DATA_QUERY, WIX_DATA_ANY, CAPABILITY_ACTION, BLANK_WHEN_BOUND, UNBINDABLE_ROW;
+var ACTION_KEYS, UNTRACKED_ITEMS, NESTED_ITEMS_SEP, REJECT_ALL_MESSAGE, VLQ, WIX_DATA_QUERY, WIX_DATA_ANY, CAPABILITY_ACTION, CRAWL_CLOCK, BLANK_WHEN_BOUND, UNBINDABLE_ROW;
 var init_screen_crawl = __esm({
   "../../core/dev-server/src/screen-crawl.ts"() {
     init_validate_descriptor_core();
@@ -41930,6 +42153,7 @@ var init_screen_crawl = __esm({
     init_FakeServiceProvider();
     init_actionParams();
     init_implications();
+    init_capability_fixtures();
     init_crawl_relations();
     ACTION_KEYS = [
       "action",
@@ -41950,6 +42174,7 @@ var init_screen_crawl = __esm({
     WIX_DATA_QUERY = /\/wix-data\/v2\/items\/query$/;
     WIX_DATA_ANY = /\/wix-data\//;
     CAPABILITY_ACTION = /^capability\.([a-z0-9_]+)\.([A-Za-z0-9_]+)$/;
+    CRAWL_CLOCK = Date.parse("2026-01-01T00:00:00.000Z");
     BLANK_WHEN_BOUND = {
       Marquee: ["items", "itemsPath", "text"],
       MediaPlayer: ["items", "itemsPath"]
@@ -43530,6 +43755,7 @@ async function runCrawl(opts) {
   const hostileFindings = [];
   const relationFindings = [];
   let relationsChecked = 0;
+  let capabilityModelled = 0;
   const relationsByKind = { inverse: 0, refresh: 0, loadMore: 0, filter: 0 };
   const deepFindings = [];
   const journeyFindings = [];
@@ -43608,6 +43834,20 @@ async function runCrawl(opts) {
       const already = new Set(r.findings.map(keyOf));
       for (const f of rr.findings) if (!already.has(keyOf(f))) relationFindings.push(f);
     }
+    if (deps.crawlScreenCapabilitySuccess && baked.bundleJs) {
+      const cr = await deps.crawlScreenCapabilitySuccess(args);
+      capabilityModelled += cr.modelled;
+      const keyOfC = deps.findingKey ?? ((f) => `${f.invariant}|${f.at ?? ""}|${f.screen}|${f.message}`);
+      const seen = new Set([...r.findings, ...relationFindings].map(keyOfC));
+      for (const f of cr.findings) if (!seen.has(keyOfC(f))) relationFindings.push(f);
+      if (cr.modelled > 0 && deps.crawlScreenRelations) {
+        const rs = await deps.crawlScreenRelations({ ...args, capabilitySuccess: true });
+        const seen2 = new Set([...r.findings, ...relationFindings].map(keyOfC));
+        for (const f of rs.findings) {
+          if (!seen2.has(keyOfC(f))) relationFindings.push({ ...f, axis: f.axis ? `capability:success+${f.axis}` : "capability:success" });
+        }
+      }
+    }
     await finishScreenCoverage();
   }
   const keep = (f) => {
@@ -43748,6 +43988,7 @@ async function runCrawl(opts) {
     ...retired.length ? { retired } : {},
     ...opts.deep && opts.deep >= 2 ? { deep: { depth: opts.deep, ...deepTotals } } : {},
     ...deps.crawlScreenRelations ? { relations: { checked: relationsChecked, byKind: relationsByKind } } : {},
+    ...deps.crawlScreenCapabilitySuccess ? { capabilities: { modelled: capabilityModelled } } : {},
     ...journeyResults.length ? { journeys: journeyResults } : {},
     ...results.some((r) => r.observations) ? { observations: Object.fromEntries(results.filter((r) => r.observations).map((r) => [r.screen, r.observations])) } : {}
   };
@@ -45175,15 +45416,15 @@ function createFunctionDataCapability(options) {
         const decode = (result) => {
           if (!result || typeof result !== "object") return result;
           const output = structuredClone(result);
-          const decodeItem = (item) => {
+          const decodeItem2 = (item) => {
             if (!item || typeof item !== "object") return item;
             const record2 = item;
             if (!record2.data || typeof record2.data !== "object" || Array.isArray(record2.data)) return item;
             return { ...record2, data: Object.fromEntries(Object.entries(record2.data).map(([key2, value]) => [physicalFields.get(key2) ?? key2, value])) };
           };
-          if (Array.isArray(output.dataItems)) output.dataItems = output.dataItems.map(decodeItem);
-          if (Array.isArray(output.items)) output.items = output.items.map(decodeItem);
-          if (output.dataItem !== void 0) output.dataItem = decodeItem(output.dataItem);
+          if (Array.isArray(output.dataItems)) output.dataItems = output.dataItems.map(decodeItem2);
+          if (Array.isArray(output.items)) output.items = output.items.map(decodeItem2);
+          if (output.dataItem !== void 0) output.dataItem = decodeItem2(output.dataItem);
           return output;
         };
         return Object.freeze({
@@ -59976,6 +60217,7 @@ async function loadAuthoring() {
       crawlScreenJourney: crawl.crawlScreenJourney,
       crawlScreenHostile: crawl.crawlScreenHostile,
       crawlScreenRelations: crawl.crawlScreenRelations,
+      crawlScreenCapabilitySuccess: crawl.crawlScreenCapabilitySuccess,
       findingKey: crawl.findingKey,
       startWorkerCoverage: cov.startWorkerCoverage,
       uncoveredFunctions: cov.uncoveredFunctions,
@@ -60562,7 +60804,7 @@ himi v${cliVersion()} \u2014 run \`himi --version\`. If authoring commands fail
           return results.every((result2) => result2.ok) ? 0 : 1;
         }
         const app = await appId(dir);
-        const { buildContentBundles: buildContentBundles2, buildReleaseFromContent: buildReleaseFromContent2, bundleOutDir: bundleOutDir2, crawlScreen: crawlScreen2, crawlScreenJourney: crawlScreenJourney2, crawlScreenHostile: crawlScreenHostile2, crawlScreenRelations: crawlScreenRelations2, findingKey: findingKey2, startWorkerCoverage: startWorkerCoverage2, uncoveredFunctions: uncoveredFunctions2, crawlScreenDeep: crawlScreenDeep2, crawlSignature: crawlSignature2, recordScreenTraffic: recordScreenTraffic2, mintVisitor: mintVisitor2, webWixCall: webWixCall2, freezeTrafficToMocks: freezeTrafficToMocks2, bootAndSnapshotState: bootAndSnapshotState2, renderDescriptorWeb: renderDescriptorWeb2, renderPngBatch: renderPngBatch2, pngAvailable: pngAvailable2, crawlBlockingPasses } = await loadAuthoring();
+        const { buildContentBundles: buildContentBundles2, buildReleaseFromContent: buildReleaseFromContent2, bundleOutDir: bundleOutDir2, crawlScreen: crawlScreen2, crawlScreenJourney: crawlScreenJourney2, crawlScreenHostile: crawlScreenHostile2, crawlScreenRelations: crawlScreenRelations2, crawlScreenCapabilitySuccess: crawlScreenCapabilitySuccess2, findingKey: findingKey2, startWorkerCoverage: startWorkerCoverage2, uncoveredFunctions: uncoveredFunctions2, crawlScreenDeep: crawlScreenDeep2, crawlSignature: crawlSignature2, recordScreenTraffic: recordScreenTraffic2, mintVisitor: mintVisitor2, webWixCall: webWixCall2, freezeTrafficToMocks: freezeTrafficToMocks2, bootAndSnapshotState: bootAndSnapshotState2, renderDescriptorWeb: renderDescriptorWeb2, renderPngBatch: renderPngBatch2, pngAvailable: pngAvailable2, crawlBlockingPasses } = await loadAuthoring();
         const { readTestConfig: readTestConfig2, runCrawl: runCrawl2, formatReport: formatReport2, readCannedResponses: readCannedResponses2, makeRecordingWixCall: makeRecordingWixCall2, runRecordPass: runRecordPass2, runShotsPass: runShotsPass2, defaultNetRules: defaultNetRules2, readNetRules: readNetRules2, scopeDescriptors: scopeDescriptors2, writeRecordedMocks: writeRecordedMocks2 } = await Promise.resolve().then(() => (init_test(), test_exports));
         let config;
         try {
@@ -60800,7 +61042,7 @@ himi v${cliVersion()} \u2014 run \`himi --version\`. If authoring commands fail
             ...deep ? { deep } : {},
             ...offline ? { offline: true } : {},
             ...offline || flags["no-hostile"] === true ? { hostile: false } : {},
-            deps: { crawlScreen: crawlScreen2, crawlScreenJourney: crawlScreenJourney2, crawlScreenHostile: crawlScreenHostile2, crawlScreenRelations: crawlScreenRelations2, findingKey: findingKey2, startWorkerCoverage: startWorkerCoverage2, uncoveredFunctions: uncoveredFunctions2, crawlScreenDeep: crawlScreenDeep2, crawlSignature: crawlSignature2 }
+            deps: { crawlScreen: crawlScreen2, crawlScreenJourney: crawlScreenJourney2, crawlScreenHostile: crawlScreenHostile2, crawlScreenRelations: crawlScreenRelations2, crawlScreenCapabilitySuccess: crawlScreenCapabilitySuccess2, findingKey: findingKey2, startWorkerCoverage: startWorkerCoverage2, uncoveredFunctions: uncoveredFunctions2, crawlScreenDeep: crawlScreenDeep2, crawlSignature: crawlSignature2 }
           });
         } catch (e) {
           io.error(JSON.stringify({ error: e.message }));

package/guides/component-reference.json

@@ -881,7 +881,7 @@
     "ScreenDescriptor": "export interface ScreenDescriptor {\n  screenId: string;\n  renderer: RendererKind;\n  title?: string;\n  /** Present when `renderer` is `sdui_intent` or `sdui_layout`. */\n  payload?: Component;\n  /** A component pinned ABOVE the scrolling payload (sticky tab-header / toolbar).\n   *  Rendered by the host outside the screen scroll, so it stays put as content\n   *  scrolls. Optional; absent = no sticky header. */\n  stickyHeader?: Component;\n  /** A component pinned BELOW the scrolling payload (sticky footer — price/confirm\n   *  bar, peeking bottom-sheet). Rendered outside the screen scroll by the host. */\n  stickyFooter?: Component;\n  /** When true, the host wraps the screen in a scroll that starts pinned to the\n   *  bottom and shows a floating \"jump to latest\" button whenever the user scrolls\n   *  up (a chat transcript). Tapping it animates back to the bottom. Absent/false =\n   *  a normal top-anchored scroll. Honored by the app host (Router). */\n  scrollToBottom?: boolean;\n  /** Present when `renderer` is `webview_native_bridge` or `webview_ds`. */\n  url?: string;\n  capabilitiesRequired?: string[];\n  schemaVersion: number;\n  togglesApplied?: string[];\n  /** Per-session flag/experiment assignments baked in for this request. */\n  assignments?: import(\"./flags.js\").Assignment[];\n  /** Per-screen top bar (trailing actions +\n   *  leading/style override). Fully replaces `NavigationConfig.topBarDefault`. */\n  topBar?: TopBarConfig;\n  etag?: string;\n  cacheControl?: CacheControl;\n  telemetryScreenName?: string;\n  bundleSri?: string;\n  manifestVersion?: number;\n  /**\n   * Present on Tier-5 screens. The presence of this field is the tier-5\n   * signal — there is no separate `tier: 5` flag.\n   */\n  logicBundle?: LogicBundleRef;\n  /**\n   * Static per-screen input injected as `globalThis.himalaya.input` before the\n   * Tier-5 worker bundle evaluates — the worker reads it synchronously in `load()`\n   * (e.g. `himalaya.input.id` for a detail screen, or a baked catalog like\n   * `himalaya.input.cmsCollections`).\n   *\n   * A push merges its navigation parameters into this object on web, iOS, and Android.\n   * For example, `himi.open({ screenId: \"event\", id: \"$item.id\" })` makes the id\n   * available as `himalaya.input.id` in the pushed worker; static `input` remains the\n   * fallback for values baked into a descriptor or a templated route. The host also\n   * supplies `screenId`. See docs/tier-5-add-a-screen.md → \"Navigate to a detail screen\".\n   *\n   * Arbitrary JSON object; consumed by the web host (ScreenController) and the\n   * native JSWorker.\n   */\n  input?: Record<string, unknown>;\n  /**\n   * Tier 3 / Tier 4 — behavior of the hosted WebView. Ignored by SDUI tiers.\n   * Authored in the descriptor builder (git); served OTA verbatim.\n   */\n  webViewConfig?: WebViewConfig;\n}",
     "Component": "export interface Component {\n  id: string;\n  body: ComponentBody;\n  modifiers?: Modifiers;\n  minVersion?: number;\n}",
     "LogicBundleRef": "export interface LogicBundleRef {\n  url: string;\n  /** \"sha256-...\" SRI string. */\n  integrity: string;\n  contentType?: string;\n  /** SDK capability ids the bundle is permitted to import / invoke. */\n  declaredCapabilities: string[];\n  /** Bundle refuses to load on a binary older than this (semver). */\n  minBinaryVersion?: string;\n  /** Bundle's own semver. */\n  bundleVersion?: string;\n  /** Base64 detached publisher signature over the bundle bytes\n   *  (authenticity beyond SRI). Verified by a host-injected verifier when present;\n   *  unsigned bundles load as today. */\n  signature?: string;\n  /** The publisher key id a host pins, paired with `signature`. */\n  keyId?: string;\n  /** Ambient refresh (gap G2): the host invokes `action` (a `tier5.<svc>.<action>`\n   *  path) every `intervalMs` while the screen is visible — workers have no timer\n   *  of their own, so the host owns the cadence. */\n  refresh?: { intervalMs: number; action: string };\n}",
-    "Modifiers": "export interface Modifiers {\n  padding?: EdgeInsets;\n  background?: TokenRef;\n  cornerRadius?: number;\n  /** Fixed intrinsic width (pt/dp/px). Honored by iOS (`FrameIfPresent`), Android\n   *  (frame) and web (`modifiers.ts`). With no `ScrollView` in the vocabulary and\n   *  regions clipped at `maxHeight`, `width`/`height`/`fillMaxWidth` are the main\n   *  sizing tools for embed/host content. */\n  width?: number;\n  /** Fixed intrinsic height (pt/dp/px). See `width`. */\n  height?: number;\n  /** Fill the available cross-axis width (keeps any fixed `height`). Mirrors\n   *  Compose `fillMaxWidth` / SwiftUI `.frame(maxWidth: .infinity)`. See `width`. */\n  fillMaxWidth?: boolean;\n  /** CAP the node's laid-out width at this many points. It CONSTRAINS, it\n   *  does not SET: a node narrower than the cap keeps its intrinsic width, so a\n   *  short chat bubble stays short while a long one stops at the cap — the\n   *  asymmetry `width` cannot express and `weight` cannot either (weights divide\n   *  the *available* space, so every child lands on the same fraction).\n   *  The cap covers the node's TOTAL width, padding + border included (CSS\n   *  `max-width` under `box-sizing: border-box`). `fillMaxWidth` grabs the axis but\n   *  THE CAP WINS — fill + cap is exactly `maxWidth` wide; a literal `width` larger\n   *  than the cap is clamped to it too. POINTS, not a fraction: a modifier is\n   *  resolved with no portable notion of \"the row\" on any renderer — compose a\n   *  percentage from a weighted sibling gap instead. `0`/absent = no cap. */\n  maxWidth?: number;\n  /** Flex weight along the parent stack's MAIN axis (HStack = width, VStack =\n   *  height). The stack measures its intrinsic (unweighted) children first, then\n   *  divides what is LEFT among the weighted ones in proportion to their weights:\n   *  two children at `1` split the leftover equally, `2` and `1` split it 2:1.\n   *  Absent (or <= 0) keeps the node at its intrinsic size. Use this — not\n   *  `fillMaxWidth` — when a node should claim the remaining space *beside* its\n   *  siblings; a full-bleed fill grabs the whole axis and starves them. Ignored\n   *  outside an HStack/VStack. */\n  weight?: number;\n  /** RTL — pin the subtree's writing direction: `\"ltr\"` | `\"rtl\"` | `\"locale\"`\n   *  (inherit). The common RTL pattern is the inverse of `Text.textDirection`: pin a\n   *  container `ltr` (a logotype, an attachment-tile row, a composer button row)\n   *  inside an otherwise-RTL screen. Absent = inherit the ambient direction. #1060. */\n  layoutDirection?: \"ltr\" | \"rtl\" | \"locale\";\n  /** Absolute visual translation (pt/dp/px). Applied as the OUTERMOST transform so\n   *  it shifts the fully-styled node WITHOUT changing its layout footprint — lets a\n   *  ZStack place polar/absolute children (e.g. AgentOrbit). Negative allowed. */\n  offsetX?: number;\n  offsetY?: number;\n  onTap?: Action;\n  /** Double-tap gesture (e.g. Instagram double-tap-to-like). Distinct from onTap. */\n  onDoubleTap?: Action;\n  accessibilityLabel?: string;\n  hidden?: boolean;\n  /** Data-bound conditional visibility: a `\"$service:<svc>.<field>\"`\n   *  or `\"$item.<field>\"` sentinel resolving to a bool at render; when true the\n   *  subtree fully COLLAPSES (zero layout, like `hidden`), overriding the\n   *  literal `hidden`. */\n  hiddenPath?: string;\n  /** Long-press gesture modifier. */\n  onLongPress?: Action;\n  /** Fires once when the component first appears on screen. */\n  onAppear?: Action;\n  /** Scoped token overrides for the subtree. */\n  theme?: ThemeOverrides;\n  /** Names a token from the app's `shadows` registry. */\n  shadow?: TokenRef;\n  /** Names a token from the app's `gradients` registry (background fill). */\n  backgroundGradient?: TokenRef;\n  /** Value-driven gradient: a `$service:`/`$item.` path resolving to a gradient\n   *  TOKEN NAME used as the live background (e.g. weather sky day→night). */\n  backgroundGradientPath?: string;\n  /** Value-driven background COLOR: a `$service:`/`$item.` path resolving to a\n   *  color TOKEN NAME used as the live background. Honored on iOS + Android\n   *  (`BoundBackgroundIfPresent`); web render support is tracked in #1057. */\n  backgroundColorPath?: string;\n  /** Value-driven background IMAGE: a `$service:`/`$item.` path resolving to an\n   *  image URL used as the live background. Honored on iOS + Android; web render\n   *  support is tracked in #1057. */\n  backgroundImagePath?: string;\n  /** #1051 — MEASURE (publish): report this node's laid-out size into the renderer's\n   *  self-contained (worker-free) measure store under the named keys, so a SIBLING can\n   *  feed the number back into its own layout via a `$measure:<key>` binding. The SDUI\n   *  equivalent of SwiftUI `.onGeometryChange` / Compose `onGloballyPositioned`; the\n   *  canonical use is a pinned bottom bar whose measured height becomes a scroll view's\n   *  bottom inset (sticky-footer + scroll-inset, unrepresentable before — #1051). */\n  onMeasure?: Measure;\n  /** #1051 — bound height: a `\"$measure:<key>\"` (measure store) or\n   *  `\"$service:<svc>.<field>\"` / `\"$item.<field>\"` (worker/row state) sentinel resolving\n   *  to a NUMBER at render. Wins over the literal `height`. String path only, so a\n   *  binding can never blank the node (never overload the numeric `height`). */\n  heightPath?: string;\n  /** #1051 — bound width. See `heightPath`. Wins over the literal `width`. */\n  widthPath?: string;\n  /** #1051 — bound TOP inset (the header-height → top-inset idiom). A `$measure:`/\n   *  `$service:`/`$item.` sentinel resolving to a number; added as top padding. */\n  paddingTopPath?: string;\n  /** #1051 — bound BOTTOM inset (the sticky-footer-height → bottom-inset idiom). A\n   *  `$measure:`/`$service:`/`$item.` sentinel resolving to a number; added as bottom\n   *  padding so the last scroll row clears a pinned bottom bar. */\n  paddingBottomPath?: string;\n  /** #1053 — INLINE gradient background paint. Distinct from `backgroundGradient`\n   *  (which names a `gradients` registry token an embed host can't register): this\n   *  carries its stops/colours in the descriptor, so it works anywhere. Painted as\n   *  a surface (behind children), below `material`/`backgroundGradient` if those are\n   *  also set. */\n  gradient?: Gradient;\n  /** #1053 — gradient ALPHA MASK: the node shows through where the gradient is\n   *  opaque and fades where it's transparent (a transparent-token stop = fully\n   *  clear). The material-under-gradient-scrim / scroll-fade-out idiom. Mirrors iOS\n   *  `.mask()`, Android `BlendMode.DstIn`, web `mask-image`. */\n  mask?: Gradient;\n  /** Inline border/stroke. */\n  border?: Border;\n  /** Subtree alpha 0.0–1.0; absent = opaque. */\n  opacity?: number;\n  /** #433 — constrain the subtree to a width:height ratio (e.g. `1` = square,\n   *  `1.777` = 16:9). Width-driven: the height derives from the resolved width.\n   *  Lets a data-bound Grid cell / photo tile hold its shape at any width. */\n  aspectRatio?: number;\n  /** Names a token from the app's `motions` registry; the subtree\n   *  fades + slides up on first appearance. */\n  appear?: TokenRef;\n  /** Surface material token (flat/glass/frosted). */\n  material?: TokenRef;\n  /** Per-node construction-language override. */\n  variant?: string;\n  /** Per-node density / motion override. */\n  density?: string;\n  motion?: string;\n  /** Motion grammar (Batch 1) — press/tap feedback style\n   *  (auto|none|scale|highlight|scaleHighlight|lift); timing comes from `motion`.\n   *  Applied only when the node is interactive. Unknown degrades to `auto`. */\n  pressFeedback?: string;\n  /** Motion grammar (Batch 1) — press-coupled haptic\n   *  (none|selection|light|medium|heavy|success|warning|error); fires with onTap.\n   *  Default none (opt-in). Web is a no-op. */\n  haptic?: string;\n  /** Motion grammar (Batch 1) — animate this container's size changes instead of\n   *  snapping (iOS `.animation(value:)`, Android `animateContentSize`, web height\n   *  transition). Curve from the active `motion` personality. */\n  animateContentSize?: boolean;\n  /** Motion grammar (Batch 1) — enter/exit transition; supersedes `appear` when\n   *  both are present. */\n  transition?: Transition;\n  /** Motion grammar (Batch 2, scroll-driven) — defer the `transition` enter until\n   *  the node first crosses into the scroll viewport (reveal-on-scroll). Gated by\n   *  reduced motion (shown immediately when reduced). */\n  revealOnScroll?: boolean;\n  /** Motion grammar (Batch 2, scroll-driven) — parallax factor: the node drifts\n   *  vertically at this fraction of the scroll delta as it moves through the\n   *  viewport. Gated by reduced motion. Generalizes CollapsingHeader parallaxFactor. */\n  parallax?: number;\n  /** Motion grammar (Batch 4, rich visual) — when a backgroundGradient is present,\n   *  continuously drift/rotate it (animated gradient). Gated by reduced motion. */\n  animatedGradient?: boolean;\n  /** Motion grammar (Batch 3, hero/nav) — shared-element key: a matching\n   *  transitionId on the source + destination screen morphs that element across\n   *  navigation (web View Transitions / iOS matchedTransitionSource / Android\n   *  SharedTransitionLayout). Gated by reduced motion. */\n  transitionId?: string;\n  /** Motion grammar (Batch 4, rich visual) — render the backgroundGradient as a\n   *  mesh (overlapping multi-point blend) rather than a linear sweep; combine with\n   *  animatedGradient to drift it. */\n  meshGradient?: boolean;\n  /** Motion grammar (Batch 4, celebration) — burst a one-shot confetti overlay\n   *  within the node on appear. Gated by reduced motion. */\n  confetti?: boolean;\n  /** Motion grammar (Batch 2, scroll-driven) — pin this node to the top of its\n   *  scroll container (sticky section header). Functional positioning; not gated\n   *  by reduced motion. */\n  sticky?: boolean;\n  /** Motion grammar (Batch 2, scroll-driven) — turn this thin node into a\n   *  reading-progress bar that fills left→right with scroll (scaleX). web reads\n   *  window scroll; native reads the host scroll fraction. Functional. */\n  scrollProgress?: boolean;\n  /** Motion grammar (Batch 4, rich vector) — a named built-in vector animation\n   *  (\"loader\" | \"success\" | \"pulse\"), dependency-free. Gated by reduced motion.\n   *  Arbitrary Lottie/Rive JSON is the lib-backed superset follow-up. */\n  vectorAnim?: string;\n  /** Motion grammar (Batch 1, choreography) — delay this node's ENTER transition\n   *  by N ms so a screen can SEQUENCE its entrance beyond list stagger (\"title\n   *  fades, subtitle slides in 100ms later\"). Adds to any list `staggerMs`. Gated\n   *  by reduced motion. 0/absent = no extra delay. */\n  enterDelayMs?: number;\n  /** Motion grammar (Phase-3, per-node MotionSpec) — overrides the PRESS-feedback\n   *  curve with a `motions`-registry token, mirroring `Transition.motion` for the\n   *  enter curve. Absent → press uses the global `motion` personality. */\n  pressMotion?: TokenRef;\n  /** Motion grammar (Phase-3, gesture-driven) — finger-tracked drag-to-dismiss; past\n   *  threshold along `direction` it animates off and fires `action`, else springs back. */\n  swipeDismiss?: SwipeDismiss;\n  /** Motion grammar (Phase-4, reduced-motion) — per-node escape from the reduced-motion\n   *  gate. Default true (respect). false = \"must move anyway\" (transition/press animate\n   *  even when reduced motion is on). */\n  respectReducedMotion?: boolean;\n  /** #1052 — uniform scale (1 = no change). */\n  scale?: number;\n  /** #1052 — rotation in DEGREES. */\n  rotation?: number;\n  /** #1052 — stacking order within a ZStack/overlay. */\n  zIndex?: number;\n  /** #1052 — gaussian blur radius (pt/dp/px). */\n  blur?: number;\n  /** #1052 — `false` = decorative (ignores taps, unlike `hidden` which stays hit-testable);\n   *  `true` = force hit-testable (a clear tap target). */\n  hitTestable?: boolean;\n  /** #1052 — explicit drop shadow (colour + radius + offset), for upward / multi-layer\n   *  shadows the `shadow` token can't express. */\n  boxShadow?: Shadow;\n}",
+    "Modifiers": "export interface Modifiers {\n  padding?: EdgeInsets;\n  background?: TokenRef;\n  cornerRadius?: number;\n  /** Fixed intrinsic width (pt/dp/px). Honored by iOS (`FrameIfPresent`), Android\n   *  (frame) and web (`modifiers.ts`). With no `ScrollView` in the vocabulary and\n   *  regions clipped at `maxHeight`, `width`/`height`/`fillMaxWidth` are the main\n   *  sizing tools for embed/host content. */\n  width?: number;\n  /** Fixed intrinsic height (pt/dp/px). See `width`. */\n  height?: number;\n  /** Fill the available cross-axis width (keeps any fixed `height`). Mirrors\n   *  Compose `fillMaxWidth` / SwiftUI `.frame(maxWidth: .infinity)`. See `width`. */\n  fillMaxWidth?: boolean;\n  /** CAP the node's laid-out width at this many points. It CONSTRAINS, it\n   *  does not SET: a node narrower than the cap keeps its intrinsic width, so a\n   *  short chat bubble stays short while a long one stops at the cap — the\n   *  asymmetry `width` cannot express and `weight` cannot either (weights divide\n   *  the *available* space, so every child lands on the same fraction).\n   *  The cap covers the node's TOTAL width, padding + border included (CSS\n   *  `max-width` under `box-sizing: border-box`). `fillMaxWidth` grabs the axis but\n   *  THE CAP WINS — fill + cap is exactly `maxWidth` wide; a literal `width` larger\n   *  than the cap is clamped to it too. POINTS, not a fraction: a modifier is\n   *  resolved with no portable notion of \"the row\" on any renderer — compose a\n   *  percentage from a weighted sibling gap instead. `0`/absent = no cap. */\n  maxWidth?: number;\n  /** Flex weight along the parent stack's MAIN axis (HStack = width, VStack =\n   *  height). The stack measures its intrinsic (unweighted) children first, then\n   *  divides what is LEFT among the weighted ones in proportion to their weights:\n   *  two children at `1` split the leftover equally, `2` and `1` split it 2:1.\n   *  Absent (or <= 0) keeps the node at its intrinsic size. Use this — not\n   *  `fillMaxWidth` — when a node should claim the remaining space *beside* its\n   *  siblings; a full-bleed fill grabs the whole axis and starves them. Ignored\n   *  outside an HStack/VStack.\n   *  CAVEAT — row-sharing controls have NO intrinsic width to measure first: in an\n   *  HStack a `Button` and a `Toggle` are implicitly weighted, so they DIVIDE the\n   *  row with your weighted child instead of taking a width ahead of it —\n   *  `[VStack(weight:1), Button, Button]` is a three-way split, not \"the VStack gets\n   *  the remainder\". The RELIABLE opt-outs are `iconOnly` and `tertiary`/`link` with\n   *  `fullWidth` unset. `fullWidth: false` is NOT reliable here: only Android honors\n   *  it in a weighted row (`wantsRowStretch`); iOS (`WeightedStack`) and web still\n   *  hand the button a share. Otherwise give the actions their own row.\n   *  See `himi docs designing-himi-screens` §4. */\n  weight?: number;\n  /** RTL — pin the subtree's writing direction: `\"ltr\"` | `\"rtl\"` | `\"locale\"`\n   *  (inherit). The common RTL pattern is the inverse of `Text.textDirection`: pin a\n   *  container `ltr` (a logotype, an attachment-tile row, a composer button row)\n   *  inside an otherwise-RTL screen. Absent = inherit the ambient direction. #1060. */\n  layoutDirection?: \"ltr\" | \"rtl\" | \"locale\";\n  /** Absolute visual translation (pt/dp/px). Applied as the OUTERMOST transform so\n   *  it shifts the fully-styled node WITHOUT changing its layout footprint — lets a\n   *  ZStack place polar/absolute children (e.g. AgentOrbit). Negative allowed. */\n  offsetX?: number;\n  offsetY?: number;\n  onTap?: Action;\n  /** Double-tap gesture (e.g. Instagram double-tap-to-like). Distinct from onTap. */\n  onDoubleTap?: Action;\n  accessibilityLabel?: string;\n  hidden?: boolean;\n  /** Data-bound conditional visibility: a `\"$service:<svc>.<field>\"`\n   *  or `\"$item.<field>\"` sentinel resolving to a bool at render; when true the\n   *  subtree fully COLLAPSES (zero layout, like `hidden`), overriding the\n   *  literal `hidden`. */\n  hiddenPath?: string;\n  /** Long-press gesture modifier. */\n  onLongPress?: Action;\n  /** Fires once when the component first appears on screen. */\n  onAppear?: Action;\n  /** Scoped token overrides for the subtree. */\n  theme?: ThemeOverrides;\n  /** Names a token from the app's `shadows` registry. */\n  shadow?: TokenRef;\n  /** Names a token from the app's `gradients` registry (background fill). */\n  backgroundGradient?: TokenRef;\n  /** Value-driven gradient: a `$service:`/`$item.` path resolving to a gradient\n   *  TOKEN NAME used as the live background (e.g. weather sky day→night). */\n  backgroundGradientPath?: string;\n  /** Value-driven background COLOR: a `$service:`/`$item.` path resolving to a\n   *  color TOKEN NAME used as the live background. Honored on iOS + Android\n   *  (`BoundBackgroundIfPresent`); web render support is tracked in #1057. */\n  backgroundColorPath?: string;\n  /** Value-driven background IMAGE: a `$service:`/`$item.` path resolving to an\n   *  image URL used as the live background. Honored on iOS + Android; web render\n   *  support is tracked in #1057. */\n  backgroundImagePath?: string;\n  /** #1051 — MEASURE (publish): report this node's laid-out size into the renderer's\n   *  self-contained (worker-free) measure store under the named keys, so a SIBLING can\n   *  feed the number back into its own layout via a `$measure:<key>` binding. The SDUI\n   *  equivalent of SwiftUI `.onGeometryChange` / Compose `onGloballyPositioned`; the\n   *  canonical use is a pinned bottom bar whose measured height becomes a scroll view's\n   *  bottom inset (sticky-footer + scroll-inset, unrepresentable before — #1051). */\n  onMeasure?: Measure;\n  /** #1051 — bound height: a `\"$measure:<key>\"` (measure store) or\n   *  `\"$service:<svc>.<field>\"` / `\"$item.<field>\"` (worker/row state) sentinel resolving\n   *  to a NUMBER at render. Wins over the literal `height`. String path only, so a\n   *  binding can never blank the node (never overload the numeric `height`). */\n  heightPath?: string;\n  /** #1051 — bound width. See `heightPath`. Wins over the literal `width`. */\n  widthPath?: string;\n  /** #1051 — bound TOP inset (the header-height → top-inset idiom). A `$measure:`/\n   *  `$service:`/`$item.` sentinel resolving to a number; added as top padding. */\n  paddingTopPath?: string;\n  /** #1051 — bound BOTTOM inset (the sticky-footer-height → bottom-inset idiom). A\n   *  `$measure:`/`$service:`/`$item.` sentinel resolving to a number; added as bottom\n   *  padding so the last scroll row clears a pinned bottom bar. */\n  paddingBottomPath?: string;\n  /** #1053 — INLINE gradient background paint. Distinct from `backgroundGradient`\n   *  (which names a `gradients` registry token an embed host can't register): this\n   *  carries its stops/colours in the descriptor, so it works anywhere. Painted as\n   *  a surface (behind children), below `material`/`backgroundGradient` if those are\n   *  also set. */\n  gradient?: Gradient;\n  /** #1053 — gradient ALPHA MASK: the node shows through where the gradient is\n   *  opaque and fades where it's transparent (a transparent-token stop = fully\n   *  clear). The material-under-gradient-scrim / scroll-fade-out idiom. Mirrors iOS\n   *  `.mask()`, Android `BlendMode.DstIn`, web `mask-image`. */\n  mask?: Gradient;\n  /** Inline border/stroke. */\n  border?: Border;\n  /** Subtree alpha 0.0–1.0; absent = opaque. */\n  opacity?: number;\n  /** #433 — constrain the subtree to a width:height ratio (e.g. `1` = square,\n   *  `1.777` = 16:9). Width-driven: the height derives from the resolved width.\n   *  Lets a data-bound Grid cell / photo tile hold its shape at any width. */\n  aspectRatio?: number;\n  /** Names a token from the app's `motions` registry; the subtree\n   *  fades + slides up on first appearance. */\n  appear?: TokenRef;\n  /** Surface material token (flat/glass/frosted). */\n  material?: TokenRef;\n  /** Per-node construction-language override. */\n  variant?: string;\n  /** Per-node density / motion override. */\n  density?: string;\n  motion?: string;\n  /** Motion grammar (Batch 1) — press/tap feedback style\n   *  (auto|none|scale|highlight|scaleHighlight|lift); timing comes from `motion`.\n   *  Applied only when the node is interactive. Unknown degrades to `auto`. */\n  pressFeedback?: string;\n  /** Motion grammar (Batch 1) — press-coupled haptic\n   *  (none|selection|light|medium|heavy|success|warning|error); fires with onTap.\n   *  Default none (opt-in). Web is a no-op. */\n  haptic?: string;\n  /** Motion grammar (Batch 1) — animate this container's size changes instead of\n   *  snapping (iOS `.animation(value:)`, Android `animateContentSize`, web height\n   *  transition). Curve from the active `motion` personality. */\n  animateContentSize?: boolean;\n  /** Motion grammar (Batch 1) — enter/exit transition; supersedes `appear` when\n   *  both are present. */\n  transition?: Transition;\n  /** Motion grammar (Batch 2, scroll-driven) — defer the `transition` enter until\n   *  the node first crosses into the scroll viewport (reveal-on-scroll). Gated by\n   *  reduced motion (shown immediately when reduced). */\n  revealOnScroll?: boolean;\n  /** Motion grammar (Batch 2, scroll-driven) — parallax factor: the node drifts\n   *  vertically at this fraction of the scroll delta as it moves through the\n   *  viewport. Gated by reduced motion. Generalizes CollapsingHeader parallaxFactor. */\n  parallax?: number;\n  /** Motion grammar (Batch 4, rich visual) — when a backgroundGradient is present,\n   *  continuously drift/rotate it (animated gradient). Gated by reduced motion. */\n  animatedGradient?: boolean;\n  /** Motion grammar (Batch 3, hero/nav) — shared-element key: a matching\n   *  transitionId on the source + destination screen morphs that element across\n   *  navigation (web View Transitions / iOS matchedTransitionSource / Android\n   *  SharedTransitionLayout). Gated by reduced motion. */\n  transitionId?: string;\n  /** Motion grammar (Batch 4, rich visual) — render the backgroundGradient as a\n   *  mesh (overlapping multi-point blend) rather than a linear sweep; combine with\n   *  animatedGradient to drift it. */\n  meshGradient?: boolean;\n  /** Motion grammar (Batch 4, celebration) — burst a one-shot confetti overlay\n   *  within the node on appear. Gated by reduced motion. */\n  confetti?: boolean;\n  /** Motion grammar (Batch 2, scroll-driven) — pin this node to the top of its\n   *  scroll container (sticky section header). Functional positioning; not gated\n   *  by reduced motion. */\n  sticky?: boolean;\n  /** Motion grammar (Batch 2, scroll-driven) — turn this thin node into a\n   *  reading-progress bar that fills left→right with scroll (scaleX). web reads\n   *  window scroll; native reads the host scroll fraction. Functional. */\n  scrollProgress?: boolean;\n  /** Motion grammar (Batch 4, rich vector) — a named built-in vector animation\n   *  (\"loader\" | \"success\" | \"pulse\"), dependency-free. Gated by reduced motion.\n   *  Arbitrary Lottie/Rive JSON is the lib-backed superset follow-up. */\n  vectorAnim?: string;\n  /** Motion grammar (Batch 1, choreography) — delay this node's ENTER transition\n   *  by N ms so a screen can SEQUENCE its entrance beyond list stagger (\"title\n   *  fades, subtitle slides in 100ms later\"). Adds to any list `staggerMs`. Gated\n   *  by reduced motion. 0/absent = no extra delay. */\n  enterDelayMs?: number;\n  /** Motion grammar (Phase-3, per-node MotionSpec) — overrides the PRESS-feedback\n   *  curve with a `motions`-registry token, mirroring `Transition.motion` for the\n   *  enter curve. Absent → press uses the global `motion` personality. */\n  pressMotion?: TokenRef;\n  /** Motion grammar (Phase-3, gesture-driven) — finger-tracked drag-to-dismiss; past\n   *  threshold along `direction` it animates off and fires `action`, else springs back. */\n  swipeDismiss?: SwipeDismiss;\n  /** Motion grammar (Phase-4, reduced-motion) — per-node escape from the reduced-motion\n   *  gate. Default true (respect). false = \"must move anyway\" (transition/press animate\n   *  even when reduced motion is on). */\n  respectReducedMotion?: boolean;\n  /** #1052 — uniform scale (1 = no change). */\n  scale?: number;\n  /** #1052 — rotation in DEGREES. */\n  rotation?: number;\n  /** #1052 — stacking order within a ZStack/overlay. */\n  zIndex?: number;\n  /** #1052 — gaussian blur radius (pt/dp/px). */\n  blur?: number;\n  /** #1052 — `false` = decorative (ignores taps, unlike `hidden` which stays hit-testable);\n   *  `true` = force hit-testable (a clear tap target). */\n  hitTestable?: boolean;\n  /** #1052 — explicit drop shadow (colour + radius + offset), for upward / multi-layer\n   *  shadows the `shadow` token can't express. */\n  boxShadow?: Shadow;\n}",
     "TokenRef": "export interface TokenRef {\n  token: TokenName;\n}",
     "Action": "export interface Action {\n  actionId: string;\n  /** Backwards-compatible string-only params. Prefer `args` for typed payloads. */\n  params?: Record<string, string>;\n  /** Typed action args; nested objects/arrays preserved end-to-end. */\n  args?: Record<string, Value>;\n  /** Navigation hint for the router; ignored for non-nav actions. */\n  presentation?: Presentation;\n}",
     "Presentation": "export type Presentation =\n  | \"push\"\n  | \"sheet\"\n  | \"replace\"\n  | \"dismiss\"\n  | \"back\"\n  | \"full_screen\"\n  | \"alert\"\n  | \"snackbar\";",

package/guides/component-reference.md

@@ -1976,7 +1976,16 @@ export interface Modifiers {
    *  Absent (or <= 0) keeps the node at its intrinsic size. Use this — not
    *  `fillMaxWidth` — when a node should claim the remaining space *beside* its
    *  siblings; a full-bleed fill grabs the whole axis and starves them. Ignored
-   *  outside an HStack/VStack. */
+   *  outside an HStack/VStack.
+   *  CAVEAT — row-sharing controls have NO intrinsic width to measure first: in an
+   *  HStack a `Button` and a `Toggle` are implicitly weighted, so they DIVIDE the
+   *  row with your weighted child instead of taking a width ahead of it —
+   *  `[VStack(weight:1), Button, Button]` is a three-way split, not "the VStack gets
+   *  the remainder". The RELIABLE opt-outs are `iconOnly` and `tertiary`/`link` with
+   *  `fullWidth` unset. `fullWidth: false` is NOT reliable here: only Android honors
+   *  it in a weighted row (`wantsRowStretch`); iOS (`WeightedStack`) and web still
+   *  hand the button a share. Otherwise give the actions their own row.
+   *  See `himi docs designing-himi-screens` §4. */
   weight?: number;
   /** RTL — pin the subtree's writing direction: `"ltr"` | `"rtl"` | `"locale"`
    *  (inherit). The common RTL pattern is the inverse of `Text.textDirection`: pin a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.830.0",
+  "version": "0.832.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": "bdb0d9a1e6584ff150b26a219383712dd907441944ed2cc044ddb3f6"
+  "falconPackageHash": "e11f7e039210de169e2608faa2fcb6cdbd90f8df91336bcba6398dbe"
 }