@wix/himalaya-cli 0.1606.0 → 0.1608.0

package/dist/cli.mjs

@@ -15065,6 +15065,7 @@ function webViewOriginAllowed(url, origins) {
 }
 var init_webview_origin = __esm({
   "../../core/ts/src/webview-origin.ts"() {
+    "use strict";
     init_define_HHP_CATALOG();
   }
 });
@@ -37624,6 +37625,17 @@ function formIsValid(bag) {
   }
   return true;
 }
+function hasWorkerFormSubmit(node) {
+  if (!node || typeof node !== "object") return false;
+  const n2 = node;
+  const props2 = n2.body?.props ?? n2.props;
+  if (!props2) return false;
+  const action = props2.action ?? props2.onTap;
+  if (typeof action === "string") return action.startsWith("$service:") || action.startsWith("$app:");
+  if (typeof action?.actionId === "string" && action.actionId.startsWith("tier5.")) return true;
+  const child = (value2) => Array.isArray(value2) ? value2.some(child) : !!value2 && typeof value2 === "object" && ("body" in value2 || "type" in value2) && hasWorkerFormSubmit(value2);
+  return Object.values(props2).some(child);
+}
 var validity, formValidityProbe, FormValuesContext;
 var init_formBag = __esm({
   "../../core/web-renderer/src/formBag.ts"() {
@@ -37927,7 +37939,7 @@ var init_actionParams = __esm({
 });
 
 // ../../core/web-renderer/src/workerTapBusy.ts
-import React7, { useEffect as useEffect3, useRef, useState as useState3 } from "react";
+import React7, { useContext as useContext2, useEffect as useEffect3, useRef, useState as useState3 } from "react";
 function tracksWorkerTap(action) {
   if (!action || typeof action !== "object") return false;
   const a2 = action;
@@ -37935,21 +37947,22 @@ function tracksWorkerTap(action) {
 }
 function useWorkerTap(action) {
   const actionId = tracksWorkerTap(action) ? action.actionId : null;
+  const owned = useContext2(WorkerTapScopeContext);
   const [busy, setBusy] = useState3(false);
   const tap = useRef(null);
   useEffect3(() => {
-    const current = new WorkerTap(actionId, setBusy);
+    setBusy(false);
+    const current = new WorkerTap(actionId, setBusy, owned);
     tap.current = current;
     return () => {
       current.dispose();
       tap.current = null;
     };
-  }, [actionId]);
-  return { busy, tapped: () => tap.current?.tapped() };
+  }, [actionId, owned]);
+  return { busy, tapped: (action2) => tap.current?.tapped(action2) ?? action2 };
 }
 function workerTapGateRef() {
-  return { busy: false, tapped: () => {
-  } };
+  return { busy: false, tapped: (action) => action };
 }
 function WorkerTapGate({ gate, action, children, ...forwarded }) {
   const { busy, tapped } = useWorkerTap(action);
@@ -37962,18 +37975,21 @@ function WorkerTapGate({ gate, action, children, ...forwarded }) {
   if (busy) next["aria-disabled"] = "true";
   return React7.cloneElement(children, next);
 }
-var WORKER_TAP_DELAY_MS, WORKER_TAP_CAP_MS, listeners, WorkerTap;
+var WORKER_TAP_DELAY_MS, WORKER_TAP_CAP_MS, listeners, TAP_FINISHED, WorkerTapScopeContext, WorkerTap;
 var init_workerTapBusy = __esm({
   "../../core/web-renderer/src/workerTapBusy.ts"() {
     init_define_HHP_CATALOG();
     WORKER_TAP_DELAY_MS = 150;
     WORKER_TAP_CAP_MS = 15e3;
     listeners = /* @__PURE__ */ new Set();
+    TAP_FINISHED = Symbol();
+    WorkerTapScopeContext = React7.createContext(false);
     WorkerTap = class {
-      constructor(actionId, onChange) {
+      constructor(actionId, onChange, owned = false) {
         this.actionId = actionId;
         this.onChange = onChange;
-        if (actionId) {
+        this.owned = owned;
+        if (actionId && !owned) {
           const listener = (id) => {
             if (id === actionId) this.settle();
           };
@@ -37986,16 +38002,30 @@ var init_workerTapBusy = __esm({
       busy = false;
       timers = [];
       stop = null;
+      pending;
+      disposed = false;
       /** Call BEFORE dispatching the tap's action, so a fast finish cannot arrive first. */
-      tapped() {
-        if (!this.actionId) return;
+      tapped(action) {
+        if (!this.actionId) return action;
         this.clear();
         this.timers = [
           setTimeout(() => this.set(true), WORKER_TAP_DELAY_MS),
-          setTimeout(() => this.set(false), WORKER_TAP_CAP_MS)
+          setTimeout(() => {
+            this.pending?.clear();
+            this.set(false);
+          }, WORKER_TAP_CAP_MS)
         ];
+        if (!this.owned || !action || typeof action !== "object") return action;
+        this.pending ??= /* @__PURE__ */ new Set();
+        const finished = () => {
+          if (this.pending?.delete(finished) && !this.pending.size) this.settle();
+        };
+        this.pending.add(finished);
+        return { ...action, [TAP_FINISHED]: finished };
       }
       dispose() {
+        this.disposed = true;
+        this.pending?.clear();
         this.clear();
         this.stop?.();
         this.stop = null;
@@ -38009,7 +38039,7 @@ var init_workerTapBusy = __esm({
         this.timers = [];
       }
       set(busy) {
-        if (this.busy === busy) return;
+        if (this.disposed || this.busy === busy) return;
         this.busy = busy;
         this.onChange(busy);
       }
@@ -122866,6 +122896,7 @@ function makeCtx(tokens2, scheme = "light", opts = {}) {
     localeTag: opts.localeTag,
     provider,
     workerReady: opts.workerReady,
+    formReadiness: opts.formReadiness,
     // `$service:` bindings in a NON-worker action's params resolve against the
     // live provider at DISPATCH (tap) time — here, the one seam every renderer
     // dispatch point flows through and where the provider is in scope (see
@@ -125330,15 +125361,15 @@ function renderNodeInner(node, ctx) {
       const nestedControl = tapActivator && typeof target.closest === "function" ? target.closest(NESTED_CONTROL_SELECTOR) : null;
       if (nestedControl && nestedControl !== e2.currentTarget && !nestedControl.hasAttribute(TAP_ACTIVATOR_ATTR)) return;
       if (busyGate?.busy) return;
-      busyGate?.tapped();
       prevOnClick?.(e2);
-      ctx.onAction(resolveItemDeep2(tap, ctx));
+      const action = resolveItemDeep2(tap, ctx);
+      ctx.onAction(busyGate ? busyGate.tapped(action) : action);
     };
     giveControlContract((e2) => {
       if (busyGate?.busy) return;
-      busyGate?.tapped();
       prevOnClick?.(e2);
-      ctx.onAction(resolveItemDeep2(tap, ctx));
+      const action = resolveItemDeep2(tap, ctx);
+      ctx.onAction(busyGate ? busyGate.tapped(action) : action);
     });
     ensurePressStyles();
     extra["data-himalaya-tap"] = "1";
@@ -127000,9 +127031,18 @@ var init_renderNode = __esm({
       const [touched, setTouched] = React16.useState(false);
       const [isFocused, setIsFocused] = React16.useState(false);
       const pendingEdits = React16.useRef([]);
+      const previousBoundBinding = React16.useRef(binding2);
       const previousBoundText = React16.useRef(boundText);
       const previousBoundRawText = React16.useRef(boundRawText);
+      const deferredExternalText = React16.useRef(false);
       React16.useEffect(() => {
+        const bindingChanged = previousBoundBinding.current !== binding2;
+        previousBoundBinding.current = binding2;
+        if (bindingChanged) {
+          changes.current?.drop();
+          pendingEdits.current = [];
+          deferredExternalText.current = true;
+        }
         if (!isBound || boundText === void 0) return;
         const boundTextChanged = previousBoundText.current !== boundText;
         const boundRawTextChanged = previousBoundRawText.current !== boundRawText;
@@ -127011,11 +127051,13 @@ var init_renderNode = __esm({
         pendingEdits.current = pendingEdits.current.filter((edit) => Date.now() - edit.at < 3e4);
         const acknowledged = pendingEdits.current.findIndex((edit) => edit.value === boundRawText);
         if (acknowledged >= 0) {
+          deferredExternalText.current = false;
           pendingEdits.current.splice(0, acknowledged + 1);
           if (pendingEdits.current.length > 0 || changes.current?.pending != null) return;
         }
         if (boundText === "") {
-          if (boundTextChanged || serializeRichText && boundRawTextChanged) {
+          deferredExternalText.current = false;
+          if (bindingChanged || boundTextChanged || serializeRichText && boundRawTextChanged) {
             changes.current?.drop();
             if (local !== "") setLocal("");
             if (serializeRichText) {
@@ -127032,8 +127074,12 @@ var init_renderNode = __esm({
           }
           return;
         }
-        if (!focused.current && boundText !== local && changes.current?.pending == null) setLocal(boundText);
-      }, [boundText, serializeRichText ? boundRawText : void 0, isFocused, serializeRichText ? edited : false]);
+        if (boundTextChanged && acknowledged < 0) deferredExternalText.current = true;
+        if (!focused.current && changes.current?.pending == null && deferredExternalText.current) {
+          if (boundText !== local) setLocal(boundText);
+          deferredExternalText.current = false;
+        }
+      }, [binding2, boundText, serializeRichText ? boundRawText : void 0, isFocused, serializeRichText ? edited : false]);
       const formBag = React16.useContext(FormValuesContext);
       const fieldId = props2.__formFieldId;
       const previousBinding = React16.useRef(binding2);
@@ -127054,11 +127100,15 @@ var init_renderNode = __esm({
         if (previousBinding.current === binding2) return;
         previousBinding.current = binding2;
         pendingEdits.current = [];
-        if (!serializeRichText) return;
-        if (fieldId) formBag?.clearValue(fieldId);
+        previousBoundText.current = boundText;
+        previousBoundRawText.current = boundRawText;
+        deferredExternalText.current = false;
+        if (fieldId && (serializeRichText || isBound && boundText === void 0)) formBag?.clearValue(fieldId);
         const nextPristineValue = isBound ? boundRawText : typeof valueBinding === "string" ? valueBinding : void 0;
-        if (fieldId && nextPristineValue) formBag?.set(fieldId, nextPristineValue);
-        setLocal(isBound ? boundText ?? "" : literalText);
+        const nextLocal = isBound ? boundText ?? "" : literalText;
+        if (fieldId && !serializeRichText) formBag?.set(fieldId, nextLocal);
+        else if (fieldId && nextPristineValue) formBag?.set(fieldId, nextPristineValue);
+        setLocal(nextLocal);
         setEdited(false);
         setPristineRichValue(nextPristineValue);
         setTouched(false);
@@ -127218,7 +127268,7 @@ var init_renderNode = __esm({
           prefixText && /* @__PURE__ */ jsx11("span", { style: { color: muted, flex: "none" }, children: prefixText }),
           multilineBox ? /* @__PURE__ */ jsx11("textarea", { "data-component-id": componentId, id: fieldDomId, "data-component-type": componentType, ...a11yFwd, ref: inputRef, value: local, onChange: onInput, onKeyDown, onFocus: onFieldFocus, onBlur: onFieldBlur, placeholder: placeholder3, dir: fieldDir, rows: 2, "aria-label": ariaLabelProp ?? placeholderName, "aria-labelledby": labelledBy, "aria-required": required3, "aria-invalid": errored || void 0, "aria-describedby": [errorId, describedByProp].filter(Boolean).join(" ") || void 0, inputMode, autoCapitalize, maxLength, autoCorrect: suggestOff ? "off" : suggestOn ? "on" : void 0, spellCheck: suggestOff ? false : suggestOn ? true : void 0, autoComplete: suggestOff ? "off" : void 0, style: inputBase }) : /* @__PURE__ */ jsx11("input", { "data-component-id": componentId, id: htmlId, "data-component-type": componentType, ...a11yFwd, ref: inputRef, type: secure && !(visibilityToggle && valueVisible) ? "password" : "text", value: local, onChange: onInput, onKeyDown, onFocus: onFieldFocus, onBlur: onFieldBlur, placeholder: placeholder3, dir: fieldDir, "aria-label": ariaLabelProp ?? placeholderName, "aria-labelledby": labelledBy, "aria-required": required3, "aria-invalid": errored || void 0, "aria-describedby": [errorId, describedByProp].filter(Boolean).join(" ") || void 0, inputMode, autoCapitalize, maxLength, autoCorrect: suggestOff ? "off" : suggestOn ? "on" : void 0, spellCheck: suggestOff ? false : suggestOn ? true : void 0, autoComplete: suggestOff ? "off" : void 0, enterKeyHint, style: inputBase }),
           suffixText && /* @__PURE__ */ jsx11("span", { style: { color: muted, flex: "none" }, children: suffixText }),
-          props2.clearButton && local && /* @__PURE__ */ jsx11("span", { onClick: () => {
+          props2.clearButton && local && !(ctx.formReadiness && ctx.formReadiness !== "ready" && !ctx.onAction) && /* @__PURE__ */ jsx11("span", { onClick: () => {
             setLocal("");
             setEdited(true);
             emitNow("");
@@ -127565,8 +127615,7 @@ var init_renderNode = __esm({
         const io2 = new IntersectionObserver((entries) => {
           if (!live3 || !entries[entries.length - 1]?.isIntersecting) return;
           if (pages2.claim(cycle)) {
-            workerTap.tapped();
-            ctx.onAction?.(firedWithoutTap(action));
+            ctx.onAction?.(workerTap.tapped(firedWithoutTap(action)));
           }
         }, { root, rootMargin: "0px 0px 320px 0px" });
         io2.observe(el2);
@@ -127592,7 +127641,12 @@ var init_renderNode = __esm({
         text13
       ] });
     });
-    FormView = withExtras("FormView", ({ props: props2, ctx, wrap }) => {
+    FormView = withExtras("FormView", ({ props: props2, ctx: inputCtx, wrap }) => {
+      const needsWorker = hasWorkerFormSubmit(props2.submitButton);
+      const unavailable = needsWorker && inputCtx.formReadiness === "unavailable";
+      const refreshing = needsWorker && inputCtx.formReadiness === "refreshing";
+      const waiting = needsWorker && !unavailable && (refreshing || inputCtx.formReadiness === "pending" || inputCtx.formReadiness === void 0 && inputCtx.workerReady === false);
+      const ctx = waiting || unavailable ? { ...inputCtx, onAction: null } : inputCtx;
       const bagRef = React16.useRef(null);
       if (!bagRef.current) bagRef.current = createFormBag();
       const bag = bagRef.current;
@@ -127616,14 +127670,18 @@ var init_renderNode = __esm({
       };
       const submitNode = React16.useMemo(() => {
         const node = props2.submitButton;
-        if (!node || valid) return node;
+        if (!node || valid && !waiting && !unavailable) return node;
         if (node.body) return { ...node, body: { ...node.body, props: { ...node.body.props ?? {}, disabled: true } } };
         return { ...node, props: { ...node.props ?? {}, disabled: true } };
-      }, [props2.submitButton, valid]);
-      return /* @__PURE__ */ jsx11("div", { style: { display: "flex", flexDirection: "column", gap: 14, width: "100%", ...wrap }, children: /* @__PURE__ */ jsxs9(FormValuesContext.Provider, { value: bag, children: [
-        kids2(props2.fields, ctx),
-        submitNode && renderNode(submitNode, submitCtx)
-      ] }) });
+      }, [props2.submitButton, valid, waiting, unavailable]);
+      return /* @__PURE__ */ jsxs9("div", { "aria-busy": waiting || void 0, style: { display: "flex", flexDirection: "column", gap: 14, width: "100%", ...wrap }, children: [
+        waiting && /* @__PURE__ */ jsx11("span", { role: "status", children: refreshing ? "Refreshing form\u2026" : "Loading form\u2026" }),
+        unavailable && /* @__PURE__ */ jsx11("span", { role: "status", children: "Form unavailable. Please try again." }),
+        /* @__PURE__ */ jsxs9(FormValuesContext.Provider, { value: bag, children: [
+          /* @__PURE__ */ jsx11("fieldset", { disabled: waiting || unavailable, style: { display: waiting && !refreshing ? "none" : "contents", border: 0, padding: 0, margin: 0, minWidth: 0 }, children: kids2(props2.fields, ctx) }),
+          submitNode && renderNode(submitNode, submitCtx)
+        ] })
+      ] });
     });
     MediaSlotProvider = class {
       constructor(state) {
@@ -129323,8 +129381,7 @@ var init_renderNode = __esm({
       const disabled = props2.disabled === true || loading || hiddenBool(boundDisabled);
       const onClick = ctx.onAction && props2.action && !disabled ? (e2) => {
         e2?.stopPropagation?.();
-        workerTap.tapped();
-        ctx.onAction(resolveItemDeep2(props2.action, ctx));
+        ctx.onAction(workerTap.tapped(resolveItemDeep2(props2.action, ctx)));
       } : void 0;
       const builtInFg = primary ? C2("textOnAccent", "#fff") : destructive ? C2("danger", "#E62214") : accentTextColor(ctx);
       const fg = bt2.label != null ? C2(bt2.label, builtInFg) : builtInFg;
@@ -129428,7 +129485,7 @@ var init_renderNode = __esm({
             ...wrap
           }, rowStretch, "fit-content"),
           children: [
-            loading && /* @__PURE__ */ jsx11("span", { style: { width: glyph, height: glyph, borderRadius: "50%", border: `2px solid ${rgba(fg, primary ? 0.4 : 0.35)}`, borderTopColor: fg, animation: ctx.empty ? void 0 : "himalaya-spin .7s linear infinite" } }),
+            loading && /* @__PURE__ */ jsx11("span", { style: { width: glyph, height: glyph, boxSizing: "border-box", borderRadius: "50%", border: `2px solid ${rgba(fg, primary ? 0.4 : 0.35)}`, borderTopColor: fg, animation: ctx.empty ? void 0 : "himalaya-spin .7s linear infinite" } }),
             !loading && resolvedLeadingIcon && ic(String(resolvedLeadingIcon)),
             !props2.iconOnly && (resolvedTitle != null && resolvedTitle !== "" ? String(resolvedTitle) : txt(props2.title, ctx) || "Button"),
             !loading && !props2.iconOnly && resolvedTrailingIcon && ic(String(resolvedTrailingIcon))
@@ -183810,44 +183867,44 @@ var init_preview_assets_generated = __esm({
     init_define_HHP_CATALOG();
     init_preview_assets_format();
     PREVIEW_ASSET_MANIFEST = [
-      { key: "assets/DashboardHost-CJ5nUJvd.js", contentType: "application/javascript; charset=utf-8", offset: 8, length: 2971, sha256: "2c79a4e0eebd2818290eddc68977b66f8b9c002ef5394da129b0c39c2241b146" },
-      { key: "assets/DevDrawer-D5vDBKOO.js", contentType: "application/javascript; charset=utf-8", offset: 2979, length: 16783, sha256: "cc7bea1bba3b1ca0b289ad2ba1f6cf707c9cb8b7b3793cd688d4f13b438161b0" },
-      { key: "assets/IdiomCompare-B_JqFhqI.js", contentType: "application/javascript; charset=utf-8", offset: 19762, length: 1926, sha256: "9a67e56e8be14212317c37ddbad01f45abc8d067035d36a7ac09ea9b18ed66a8" },
-      { key: "assets/LightboxViewer-DMmNCE-4.js", contentType: "application/javascript; charset=utf-8", offset: 21688, length: 8171, sha256: "741d887005f4ca57fb4eaf6d888928ac88e55c6c75822511e91d27696d697905" },
-      { key: "assets/OfflineReadingBar-B9oxjdFO.js", contentType: "application/javascript; charset=utf-8", offset: 29859, length: 1707, sha256: "29f6dcfe9ce5ca8895179480704a0c179f4bbdbe3450965acb7cda2c0fbb82e6" },
-      { key: "assets/PhonePreviewControl-C9x15i_a.js", contentType: "application/javascript; charset=utf-8", offset: 31566, length: 37768, sha256: "e4b919af05e8d6af965680b1bde5d22742075eef94b099a0c3cf7442fda1cb0d" },
-      { key: "assets/SchemeCompare-BF1gYB8o.js", contentType: "application/javascript; charset=utf-8", offset: 69334, length: 1858, sha256: "4338755b3c59a46715e28829f95bfa14d9c5c0671c98fc993777d78de97fdd8a" },
-      { key: "assets/WixFrogTelemetrySink-LsIa2qSg.js", contentType: "application/javascript; charset=utf-8", offset: 71192, length: 3165, sha256: "f20c33c7d781b52b677758aa9eab6b928a9c97265ddba5fcbd126116f792f5ed" },
+      { key: "assets/DashboardHost-BlHG_7xw.js", contentType: "application/javascript; charset=utf-8", offset: 8, length: 2971, sha256: "a98873322f4a9c7ff349cf63c6be21ba1267f3819892d8c868c26eaad85b7f53" },
+      { key: "assets/DevDrawer-DWVwEc0w.js", contentType: "application/javascript; charset=utf-8", offset: 2979, length: 16783, sha256: "f786eeeeeadb90b7f7bec65790b881aac4aec8141a1afcc715093aae232415da" },
+      { key: "assets/IdiomCompare-q7oMoKQ4.js", contentType: "application/javascript; charset=utf-8", offset: 19762, length: 1926, sha256: "51092198c8c0d1105908bddbe634998ce6ec1bf6095ed6a5e0c4baaaa69443c5" },
+      { key: "assets/LightboxViewer-CC4HCCbi.js", contentType: "application/javascript; charset=utf-8", offset: 21688, length: 8171, sha256: "c2dc12514f3e757992022b636d0e918699d4a0ae1bca30eb474c33ed97e75e66" },
+      { key: "assets/OfflineReadingBar-CcDoAnjr.js", contentType: "application/javascript; charset=utf-8", offset: 29859, length: 1707, sha256: "123e8008ddf241a3b3eb56588c6ec6915344db05846f6bc1e45132a9f63bfd40" },
+      { key: "assets/PhonePreviewControl-DphdrcOd.js", contentType: "application/javascript; charset=utf-8", offset: 31566, length: 37768, sha256: "4518e7541d329710acdf9a3586e461bdb39e2f1f4bef1324336245c70b93219d" },
+      { key: "assets/SchemeCompare-CTWZfu6o.js", contentType: "application/javascript; charset=utf-8", offset: 69334, length: 1858, sha256: "ef99c41a4b18efe70122116bd4f3981d98585efb6c938f0bcc877483b8ea9b35" },
+      { key: "assets/WixFrogTelemetrySink-Co0Yr3kA.js", contentType: "application/javascript; charset=utf-8", offset: 71192, length: 3165, sha256: "555afbed68e08a39b950ce0c3ff0a4e62f5e95a1cba63d67f142813b262c24e1" },
       { key: "assets/calendar-ics-BvfIYWjG.js", contentType: "application/javascript; charset=utf-8", offset: 74357, length: 2192, sha256: "1636167041e9829ceccd3544297b86b8475c38bd2f759c4dbc17c813dc6e9254" },
-      { key: "assets/files-transfer-DdfDiTU7.js", contentType: "application/javascript; charset=utf-8", offset: 76549, length: 6446, sha256: "71bc00e35b4e995994e4cb611cb8dd9736b78596f6fa3f6f2bf0dcd0b851ec0b" },
+      { key: "assets/files-transfer-Cz8o5H76.js", contentType: "application/javascript; charset=utf-8", offset: 76549, length: 6446, sha256: "8f1661e16d93d8a7eaca2e68dd955b8eea3e0d9959f28e3d3c1730d7ea3d1777" },
       { key: "assets/glassPreviewBrowser-DONaOehd.js", contentType: "application/javascript; charset=utf-8", offset: 82995, length: 6578, sha256: "4402c4cddd2a564e7466cdf1e12a0e0277c0400b288e1e5eda1d23e797599d31" },
       { key: "assets/image-preparation-Cj4gldm6.js", contentType: "application/javascript; charset=utf-8", offset: 89573, length: 2704, sha256: "32944ea587c2f3b84389b66b50a850437560238f1c8d33b6275973ee04eee865" },
-      { key: "assets/index-O9hDihry.js", contentType: "application/javascript; charset=utf-8", offset: 92277, length: 1495275, sha256: "65d5fb61d736220dffb2e31aa4eabbef963d5799fc346b8eeb11a53343071ea0" },
-      { key: "assets/jsx-runtime-CY_jTiqj.js", contentType: "application/javascript; charset=utf-8", offset: 1587552, length: 7624, sha256: "29dfba5b56f79a0b84d6b04d84d87617454baeba03c225f682ab2ab7ae2d5016" },
-      { key: "assets/pdf-VfhzBa6N.js", contentType: "application/javascript; charset=utf-8", offset: 1595176, length: 488215, sha256: "cef689a3d399e3c071f78bd48d66724f0564ea2614683378d74c2f6a6477e0d3" },
-      { key: "assets/pdf.worker.min-BGnVRhRG.js", contentType: "application/javascript; charset=utf-8", offset: 2083391, length: 90, sha256: "521a0e528916d678d7588b2cddf3dadd3bb959a6d62426382f61c77a82017e35" },
-      { key: "assets/pdf.worker.min-BmVo14Nb.mjs", contentType: "application/javascript; charset=utf-8", offset: 2083481, length: 1317034, sha256: "a33cfe728c584fdba4fcc1fd54bcdc2f9f2f13889ddbb5b2bd1d0f8cbe49b84e" },
-      { key: "assets/pdfDocument-DNqUWMY0.js", contentType: "application/javascript; charset=utf-8", offset: 3400515, length: 3470, sha256: "285ae36db1d3af09cae93108278a83e2388d104aeb1317717ab0b223bac6e737" },
-      { key: "assets/pdfFetch-Cc8i1I1h.js", contentType: "application/javascript; charset=utf-8", offset: 3403985, length: 2266, sha256: "1d21ad008921942217c9eac0c35b1713773b9d89c71e3ab4412781f7bb88f463" },
-      { key: "assets/webviewBridgeHost-DBpkiSiL.js", contentType: "application/javascript; charset=utf-8", offset: 3406251, length: 9888, sha256: "08c093827a52bdfc381ba0a73dc7a5d5ac6681637db4a8b57ab00aa0e4ab3f1f" },
-      { key: "fonts/Roboto-LICENSE.txt", contentType: "application/octet-stream", offset: 3416139, length: 4610, sha256: "994062dd7af4186a739de55dd9e151c63b6301f8e2cbafc608d35c2e87da0cd2" },
-      { key: "fonts/Roboto-Variable.ttf", contentType: "font/ttf", offset: 3420749, length: 488584, sha256: "d7598e12c5dbef095ff8272cfc55da0250bd07fbdecbac8a530b9b277872a134" },
-      { key: "fonts/WixMadeforDisplay-Bold.ttf", contentType: "font/ttf", offset: 3909333, length: 90924, sha256: "ec4c7d63772d980d6e147b2df6215fd2737e4b04cebe0cf7e11dc695fb63cdcf" },
-      { key: "fonts/WixMadeforDisplay-ExtraBold.ttf", contentType: "font/ttf", offset: 4000257, length: 90984, sha256: "bf4c16a2774edd38a921edf3099469866cd74c094fd596f3fa4e81f54a04dfaa" },
-      { key: "fonts/WixMadeforDisplay-Medium.ttf", contentType: "font/ttf", offset: 4091241, length: 90980, sha256: "368faca44fb9f7207e4af784e94750b1ee59c1098b8689e0f4a918926f244fb5" },
-      { key: "fonts/WixMadeforDisplay-Regular.ttf", contentType: "font/ttf", offset: 4182221, length: 90872, sha256: "97ed8f1a6772abe26e3d8af5cecfc4b02faa94497d585b0398b5053b739a70c1" },
-      { key: "fonts/WixMadeforDisplay-SemiBold.ttf", contentType: "font/ttf", offset: 4273093, length: 90980, sha256: "642feab8a48ddf6c7a89d7c2a7c0edfa0e6e773f671287e460e222703563191e" },
-      { key: "fonts/WixMadeforText-Bold.ttf", contentType: "font/ttf", offset: 4364073, length: 108636, sha256: "37c179b4fefb63ea9637322b84583a2df53aa226c150294eea1675c14b1b8e29" },
-      { key: "fonts/WixMadeforText-ExtraBold.ttf", contentType: "font/ttf", offset: 4472709, length: 109084, sha256: "62e2fe4718129f36ecdb0ae4de385bd6b81ecc876146447167c6c140fad699a9" },
-      { key: "fonts/WixMadeforText-Medium.ttf", contentType: "font/ttf", offset: 4581793, length: 109048, sha256: "4ecf270136af928612c76fe4ebade91d8156975e5ea4c0cf9225501dd1788e02" },
-      { key: "fonts/WixMadeforText-Regular.ttf", contentType: "font/ttf", offset: 4690841, length: 107700, sha256: "dee56f09fd3efc127c1ea95557edc74110c1460a46287da36e0af25efd341ef5" },
-      { key: "fonts/WixMadeforText-SemiBold.ttf", contentType: "font/ttf", offset: 4798541, length: 88108, sha256: "dced97a77624bc5f8b1ae65850360908297f4588e09feb6f22792d29dc7e765b" },
-      { key: "himi-sw.js", contentType: "application/javascript; charset=utf-8", offset: 4886649, length: 6818, sha256: "835250c3d8004f27c2b67f9b471984351ba6df07b916d97e33b43c691200a18c" },
-      { key: "index.html", contentType: "text/html; charset=utf-8", offset: 4893467, length: 4924, sha256: "b314df7501aac4f7ef691f44e29e5bfa323924474d3e0d1fc566f7a2003a9e76" },
-      { key: "ios-glass-preview.css", contentType: "text/css; charset=utf-8", offset: 4898391, length: 11457, sha256: "6cb2b75264fa5fa2b4d28851878a5eab0712900e8b3a6c2370cc661d6d820805" },
-      { key: "kit-tab-bar.css", contentType: "text/css; charset=utf-8", offset: 4909848, length: 1171, sha256: "9e2c3a0faaf05d5471badf167a4d3bdf1c4e6dd65c432eea6d254158bfd99585" },
-      { key: "t5-frame.html", contentType: "text/html; charset=utf-8", offset: 4911019, length: 23047, sha256: "20d1459e3f896f344e478e613d0c979a0de02e81a929a45d3a0ef6a53af36441" },
-      { key: "t5-worker-frame.html", contentType: "text/html; charset=utf-8", offset: 4934066, length: 23064, sha256: "8655cfe9c74212ec5dafecb49d2fdeb48b19f1bd8a710091e3e55631f9b4ab06" }
+      { key: "assets/index-D32TnChd.js", contentType: "application/javascript; charset=utf-8", offset: 92277, length: 1502718, sha256: "edbcdb28b09baeba4bdf5a7a45e9053c0a70970994d236161862a503423d8363" },
+      { key: "assets/jsx-runtime-CY_jTiqj.js", contentType: "application/javascript; charset=utf-8", offset: 1594995, length: 7624, sha256: "29dfba5b56f79a0b84d6b04d84d87617454baeba03c225f682ab2ab7ae2d5016" },
+      { key: "assets/pdf-mTl-i7am.js", contentType: "application/javascript; charset=utf-8", offset: 1602619, length: 488215, sha256: "18af3f1aeb2867464a4d53a332c7a6b1b5791d2f2558a681de0f785860f30090" },
+      { key: "assets/pdf.worker.min-BGnVRhRG.js", contentType: "application/javascript; charset=utf-8", offset: 2090834, length: 90, sha256: "521a0e528916d678d7588b2cddf3dadd3bb959a6d62426382f61c77a82017e35" },
+      { key: "assets/pdf.worker.min-BmVo14Nb.mjs", contentType: "application/javascript; charset=utf-8", offset: 2090924, length: 1317034, sha256: "a33cfe728c584fdba4fcc1fd54bcdc2f9f2f13889ddbb5b2bd1d0f8cbe49b84e" },
+      { key: "assets/pdfDocument-BokqqgsB.js", contentType: "application/javascript; charset=utf-8", offset: 3407958, length: 3470, sha256: "e28160bf73bb8ec7adafa888693a7f50befe46b125cc22415d066599e8d6dfb3" },
+      { key: "assets/pdfFetch-Cc8i1I1h.js", contentType: "application/javascript; charset=utf-8", offset: 3411428, length: 2266, sha256: "1d21ad008921942217c9eac0c35b1713773b9d89c71e3ab4412781f7bb88f463" },
+      { key: "assets/webviewBridgeHost-DBdQALYU.js", contentType: "application/javascript; charset=utf-8", offset: 3413694, length: 9888, sha256: "6b4a160189b882d826c9c7aa962e5119a694f3519688c4069c1b7d44f1a487c6" },
+      { key: "fonts/Roboto-LICENSE.txt", contentType: "application/octet-stream", offset: 3423582, length: 4610, sha256: "994062dd7af4186a739de55dd9e151c63b6301f8e2cbafc608d35c2e87da0cd2" },
+      { key: "fonts/Roboto-Variable.ttf", contentType: "font/ttf", offset: 3428192, length: 488584, sha256: "d7598e12c5dbef095ff8272cfc55da0250bd07fbdecbac8a530b9b277872a134" },
+      { key: "fonts/WixMadeforDisplay-Bold.ttf", contentType: "font/ttf", offset: 3916776, length: 90924, sha256: "ec4c7d63772d980d6e147b2df6215fd2737e4b04cebe0cf7e11dc695fb63cdcf" },
+      { key: "fonts/WixMadeforDisplay-ExtraBold.ttf", contentType: "font/ttf", offset: 4007700, length: 90984, sha256: "bf4c16a2774edd38a921edf3099469866cd74c094fd596f3fa4e81f54a04dfaa" },
+      { key: "fonts/WixMadeforDisplay-Medium.ttf", contentType: "font/ttf", offset: 4098684, length: 90980, sha256: "368faca44fb9f7207e4af784e94750b1ee59c1098b8689e0f4a918926f244fb5" },
+      { key: "fonts/WixMadeforDisplay-Regular.ttf", contentType: "font/ttf", offset: 4189664, length: 90872, sha256: "97ed8f1a6772abe26e3d8af5cecfc4b02faa94497d585b0398b5053b739a70c1" },
+      { key: "fonts/WixMadeforDisplay-SemiBold.ttf", contentType: "font/ttf", offset: 4280536, length: 90980, sha256: "642feab8a48ddf6c7a89d7c2a7c0edfa0e6e773f671287e460e222703563191e" },
+      { key: "fonts/WixMadeforText-Bold.ttf", contentType: "font/ttf", offset: 4371516, length: 108636, sha256: "37c179b4fefb63ea9637322b84583a2df53aa226c150294eea1675c14b1b8e29" },
+      { key: "fonts/WixMadeforText-ExtraBold.ttf", contentType: "font/ttf", offset: 4480152, length: 109084, sha256: "62e2fe4718129f36ecdb0ae4de385bd6b81ecc876146447167c6c140fad699a9" },
+      { key: "fonts/WixMadeforText-Medium.ttf", contentType: "font/ttf", offset: 4589236, length: 109048, sha256: "4ecf270136af928612c76fe4ebade91d8156975e5ea4c0cf9225501dd1788e02" },
+      { key: "fonts/WixMadeforText-Regular.ttf", contentType: "font/ttf", offset: 4698284, length: 107700, sha256: "dee56f09fd3efc127c1ea95557edc74110c1460a46287da36e0af25efd341ef5" },
+      { key: "fonts/WixMadeforText-SemiBold.ttf", contentType: "font/ttf", offset: 4805984, length: 88108, sha256: "dced97a77624bc5f8b1ae65850360908297f4588e09feb6f22792d29dc7e765b" },
+      { key: "himi-sw.js", contentType: "application/javascript; charset=utf-8", offset: 4894092, length: 6818, sha256: "835250c3d8004f27c2b67f9b471984351ba6df07b916d97e33b43c691200a18c" },
+      { key: "index.html", contentType: "text/html; charset=utf-8", offset: 4900910, length: 4924, sha256: "baa64161cf90267f8f942d1223c742ffb441330a3372f53e52496517961c829f" },
+      { key: "ios-glass-preview.css", contentType: "text/css; charset=utf-8", offset: 4905834, length: 11457, sha256: "6cb2b75264fa5fa2b4d28851878a5eab0712900e8b3a6c2370cc661d6d820805" },
+      { key: "kit-tab-bar.css", contentType: "text/css; charset=utf-8", offset: 4917291, length: 1171, sha256: "9e2c3a0faaf05d5471badf167a4d3bdf1c4e6dd65c432eea6d254158bfd99585" },
+      { key: "t5-frame.html", contentType: "text/html; charset=utf-8", offset: 4918462, length: 23047, sha256: "20d1459e3f896f344e478e613d0c979a0de02e81a929a45d3a0ef6a53af36441" },
+      { key: "t5-worker-frame.html", contentType: "text/html; charset=utf-8", offset: 4941509, length: 23064, sha256: "8655cfe9c74212ec5dafecb49d2fdeb48b19f1bd8a710091e3e55631f9b4ab06" }
     ];
   }
 });
@@ -206590,7 +206647,8 @@ function parseFlags(argv) {
       } else {
         const next = argv[i2 + 1];
         const optionalNativeWithoutValue = a2 === "--native" && next !== "ios" && next !== "android";
-        const booleanOnly = BOOLEAN_FLAGS.has(a2.slice(2));
+        const numericDepth = a2 === "--deep" && next !== void 0 && /^(?:[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?|[+-]?Infinity|NaN)$/i.test(next);
+        const booleanOnly = BOOLEAN_FLAGS.has(a2.slice(2)) && !numericDepth;
         if (!optionalNativeWithoutValue && !booleanOnly && next !== void 0 && !next.startsWith("--")) {
           assign(flags, a2.slice(2), next);
           i2++;
@@ -209291,8 +209349,8 @@ async function testCommand(ctx) {
   let deep;
   if (flags.deep !== void 0) {
     deep = flags.deep === true ? 3 : Number(str3(flags.deep));
-    if (!Number.isFinite(deep) || deep < 2 || deep > 6) {
-      io2.error(JSON.stringify({ error: `--deep takes a chain depth between 2 and 6 (got "${String(flags.deep)}") \u2014 bare --deep means 3` }));
+    if (!Number.isInteger(deep) || deep < 2 || deep > 6) {
+      io2.error(JSON.stringify({ code: "invalid_usage", error: `--deep takes an integer chain depth between 2 and 6 (got "${String(flags.deep)}") \u2014 bare --deep means 3` }));
       return 2;
     }
   }

package/guides/himi-json-output.md

@@ -87,6 +87,12 @@ The check reads built descriptors, not every possible runtime string. A passing
 result does not verify dynamic live data, translations, branding images or device
 appearance. It does not change publication or coverage policy.
 
+## `himi test` depth codes
+
+Invalid `--deep` values emit `code: "invalid_usage"` on stderr and exit 2.
+Depth must be an integer from 2 through 6. A nonnumeric word after bare `--deep`
+is a positional screen ID; use `--deep=<value>` to diagnose a nonnumeric depth.
+
 ## Push codes
 
 | Code | Meaning |

package/guides/himi-test.md

@@ -478,7 +478,7 @@ behavior. This instruction does not add an automatic suppression or retry gate t
 | `himi test` | The whole loop. Hermetic data + hostile passes. Exit 1 on any error. |
 | `--json` | Machine envelope — the surface an agent reads. |
 | `--content <dir>` | The content package to crawl (default: cwd). |
-| `--deep [n]` | BFS over action chains (depth 3; range 2–6). Sequence-only bugs. |
+| `--deep [n]` | BFS over action chains (default depth 3; integer range 2–6). Both `--deep 4` and `--deep=4` select depth 4; bare `--deep home` keeps `home` as a screen ID. To target a numeric screen ID, disambiguate with `--deep=3 4`. Sequence-only bugs. |
 | `--record` | Refresh `dev/net-mocks.json` from live reads. QA site, read-path-only. |
 | `--offline` | Strip every data layer — see the failure UI head-on. (Excludes `--net`.) |
 | `--no-hostile` | Skip the empty-list / all-500 passes. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1606.0",
+  "version": "0.1608.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": [
@@ -72,5 +72,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "d39364e0b5bb8ee230970f6ee80476f872e1b56e4cccfe4d76dbc4c3"
+  "falconPackageHash": "1bec846ad5466a0b26a35a61f3e2e514b5c39c2f5376641b9ae23195"
 }