@wix/himalaya-cli 0.1450.0 → 0.1452.0

package/dist/cli.mjs

@@ -8059,6 +8059,7 @@ function buttonVariant(style) {
 var SYSTEM_FONT_FAMILY, TONAL_ELEVATION_ALPHA, BUTTON_MIN_HIT_TARGET, nonNegative, nonEmpty2, own, COLOR_TOKEN_PROPS, TYPOGRAPHY_TOKEN_PROPS, BUTTON_VARIANTS;
 var init_tokens = __esm({
   "../../core/ts/src/tokens.ts"() {
+    "use strict";
     SYSTEM_FONT_FAMILY = "$system";
     TONAL_ELEVATION_ALPHA = [0, 0.05, 0.08, 0.11, 0.12, 0.14];
     BUTTON_MIN_HIT_TARGET = 44;
@@ -8114,6 +8115,7 @@ function resolveTranslation(value, catalog3, sourceCatalog) {
 var BINDING_SIGILS, BINDING_SIGIL_RE, TRANSLATION_PREFIX, TRANSLATION_KEY_RE;
 var init_bindings = __esm({
   "../../core/ts/src/bindings.ts"() {
+    "use strict";
     BINDING_SIGILS = ["service", "flag", "item", "t"];
     BINDING_SIGIL_RE = new RegExp(
       `^\\$(?:${BINDING_SIGILS.filter((s2) => s2 !== "t").join("|")})\\b|^\\$t:`
@@ -20256,6 +20258,11 @@ function roleOf(name) {
   if (n2.includes("accent") || n2.includes("primary") || n2.includes("link")) return "accent";
   return "other";
 }
+function isLegacyLightOnly(colors) {
+  if (!colors) return true;
+  for (const v2 of Object.values(colors)) if (v2 != null && typeof v2 === "object") return false;
+  return true;
+}
 function synthScheme(hex2, name, scheme) {
   if (scheme === "light") return hex2;
   const hsl = hexToHsl(hex2);
@@ -20330,6 +20337,7 @@ function baseKitMotionDefaults(resolved2, source) {
 }
 function makeTokenResolvers(source, scheme, idiom = WEB_IDIOM_CONTEXT) {
   const tokens2 = baseKitMotionDefaults(resolveIdiom(source, idiom), source);
+  const synthesize = isLegacyLightOnly(tokens2.colors);
   const color = (name, fallback = "#1a1a1a") => {
     if (name == null) return fallback;
     if (typeof name !== "string") {
@@ -20347,7 +20355,7 @@ function makeTokenResolvers(source, scheme, idiom = WEB_IDIOM_CONTEXT) {
       const direct = resolveSchemeColor(v2, scheme);
       return typeof direct === "string" ? direct : fallback;
     }
-    return synthScheme(v2, name, scheme);
+    return synthesize ? synthScheme(v2, name, scheme) : v2;
   };
   const font = (style = "body") => {
     const t2 = tokens2.typography?.[style] ?? tokens2.fonts?.[style] ?? tokens2.typography?.body ?? tokens2.fonts?.body;
@@ -38214,6 +38222,12 @@ function browserIsRTL() {
   }
   return false;
 }
+function ambientIsRTL(isRTL) {
+  return isRTL ?? browserIsRTL();
+}
+function layoutIsRTL(ctx) {
+  return ctx.layoutRTL ?? ambientIsRTL(ctx.isRTL);
+}
 function ctxEnv(ctx) {
   return {
     scheme: ctx.scheme,
@@ -38501,7 +38515,7 @@ function variantStyle(variant, tk, baseBackground) {
       return {};
   }
 }
-function makeModStyle(tk) {
+function makeModStyle(tk, isRTL = () => false) {
   return function modStyle(mods) {
     if (!mods) return {};
     if (mods.hidden === true) return { display: "none" };
@@ -38594,7 +38608,8 @@ function makeModStyle(tk) {
     const ox = pick(mods.offsetX, mods.offset_x);
     const oy = pick(mods.offsetY, mods.offset_y);
     if (ox != null && ox !== 0 || oy != null && oy !== 0) {
-      const tr2 = `translate(${ox ?? 0}px, ${oy ?? 0}px)`;
+      const tx = ox != null && ox !== 0 && isRTL() ? -ox : ox ?? 0;
+      const tr2 = `translate(${tx}px, ${oy ?? 0}px)`;
       s2.transform = s2.transform ? `${s2.transform} ${tr2}` : tr2;
     }
     const maskCss = gradientCss(mods.mask, tk);
@@ -123101,7 +123116,7 @@ function makeCtx(tokens2, scheme = "light", opts = {}) {
     sizeClass: opts.sizeClass,
     isRTL: opts.isRTL,
     containerWidth: opts.containerWidth,
-    modStyle: makeModStyle(tk),
+    modStyle: makeModStyle(tk, () => ambientIsRTL(opts.isRTL)),
     catalog: opts.catalog,
     localeTag: opts.localeTag,
     provider,
@@ -123147,7 +123162,7 @@ function withTheme(ctx, theme) {
     spacing: { ...base.spacing ?? {}, ...theme.spacing ?? {} }
   };
   const tk = makeTokenResolvers(merged, ctx.scheme, ctx.idiomContext);
-  return { ...ctx, ...tk, modStyle: makeModStyle(tk) };
+  return { ...ctx, ...tk, modStyle: makeModStyle(tk, () => layoutIsRTL(ctx)) };
 }
 function ensureValueSwapKeyframes() {
   ensureTransitionKeyframes();
@@ -125295,6 +125310,11 @@ function renderInner(node, ctx) {
   const hListItem = ctx.hListItem === true;
   if (modifiers?.theme) ctx = withTheme(ctx, resolveItemDeep2(modifiers.theme, ctx));
   if (ctx.hListItem) ctx = { ...ctx, hListItem: false };
+  const ld = modifiers?.layoutDirection ?? modifiers?.layout_direction;
+  if ((ld === "ltr" || ld === "rtl") && layoutIsRTL(ctx) !== (ld === "rtl")) {
+    const pinnedRTL = ld === "rtl";
+    ctx = { ...ctx, layoutRTL: pinnedRTL, modStyle: makeModStyle(ctx, () => pinnedRTL) };
+  }
   const pkg = node.body?.package;
   const C2 = ctx.color;
   const wrap = ctx.modStyle(resolveModBindings(modifiers, ctx));
@@ -126993,6 +127013,7 @@ var init_renderNode = __esm({
         submit();
       };
       const inputBase = { flex: 1, minWidth: 0, minHeight: multilineBox ? 44 : void 0, alignSelf: "stretch", border: "none", outline: "none", background: "transparent", padding: multilineBox ? 0 : "11px 0", margin: 0, width: "100%", boxSizing: "border-box", fontFamily: bodyFont(ctx), fontSize: pxToRem(15), color: C2("textPrimary", "#13171e"), resize: "none" };
+      const fieldDir = layoutIsRTL(ctx) ? "auto" : void 0;
       const accIcon = (name) => /* @__PURE__ */ jsx10("span", { style: { display: "inline-grid", placeItems: "center", width: 18, height: 18, flex: "none" }, children: iconSvg(name, { size: 17, color: muted }) });
       const box = borderless ? { display: "flex", alignItems: "center", gap: 8, width: "100%", boxSizing: "border-box", ...wrap } : { display: "flex", alignItems: "center", gap: 8, width: "100%", background: C2("surfacePrimary", "#fff"), border: `1px solid ${errored ? C2("danger", "#E62214") : C2("border", "#e3e3e3")}`, borderRadius: ctx.radius("md", 8), padding: multilineBox ? "11px 14px" : "0 14px", boxSizing: "border-box", minHeight: multilineBox ? 48 : 44, ...wrap };
       const composedBox = addIntrinsicPadding(box, wrap) ?? box;
@@ -127001,7 +127022,7 @@ var init_renderNode = __esm({
         /* @__PURE__ */ jsxs7("div", { style: composedBox, children: [
           props.leadingIcon && accIcon(props.leadingIcon),
           prefixText && /* @__PURE__ */ jsx10("span", { style: { color: muted, flex: "none" }, children: prefixText }),
-          multilineBox ? /* @__PURE__ */ jsx10("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, 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__ */ jsx10("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, "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 }),
+          multilineBox ? /* @__PURE__ */ jsx10("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__ */ jsx10("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__ */ jsx10("span", { style: { color: muted, flex: "none" }, children: suffixText }),
           props.clearButton && local && /* @__PURE__ */ jsx10("span", { onClick: () => {
             setLocal("");
@@ -128118,6 +128139,7 @@ var init_renderNode = __esm({
           "input",
           {
             value: local,
+            dir: layoutIsRTL(ctx) ? "auto" : void 0,
             onChange: (e2) => onInput(e2.currentTarget.value),
             onKeyDown: (e2) => {
               if (e2.key === "Enter") {
@@ -128490,8 +128512,9 @@ var init_renderNode = __esm({
       const revealMarkdown = props.markdown === true && revealSource != null ? mdSource ?? revealSource : null;
       const content = countContent != null ? countContent : revealSource != null && revealSource !== "" ? /* @__PURE__ */ jsx10(RevealText, { text: revealSource, reduce: ctx.reduceMotion(), markdownHtml: revealMarkdown != null ? mdInline(revealMarkdown, accentTextColor(ctx)).__html : void 0 }) : icuPattern != null ? /* @__PURE__ */ jsx10(InterpolatedTextView, { pattern: icuPattern, params: props.template?.params ?? {}, ctx }) : mdSource != null ? /* @__PURE__ */ jsx10("span", { dangerouslySetInnerHTML: mdInline(mdSource, accentTextColor(ctx)) }) : txt(props.text, ctx);
       const authoredDirection = props.textDirection === "auto" || props.textDirection === "ltr" || props.textDirection === "rtl";
+      const layoutRTL = !authoredDirection && layoutIsRTL(ctx);
       const dir = authoredDirection ? props.textDirection : "auto";
-      const tAlign = props.textAlign === "center" ? "center" : props.textAlign === "trailing" ? authoredDirection ? "end" : "right" : props.textAlign === "justify" ? "justify" : props.textAlign === "leading" ? authoredDirection ? "start" : "left" : void 0;
+      const tAlign = props.textAlign === "center" ? "center" : props.textAlign === "trailing" ? authoredDirection ? "end" : layoutRTL ? "left" : "right" : props.textAlign === "justify" ? "justify" : props.textAlign === "leading" ? authoredDirection ? "start" : layoutRTL ? "right" : "left" : layoutRTL ? "right" : void 0;
       const tDecor = props.decoration === "strikethrough" ? "line-through" : props.decoration === "underline" ? "underline" : void 0;
       const ln2 = typeof props.lineSpacing === "number" ? pxToRem((f2.line ?? 1.4) * f2.size + props.lineSpacing) : f2.line;
       const swapped = textSwap > 0 && content != null && content !== "" ? (ensureValueSwapKeyframes(), /* @__PURE__ */ jsx10("span", { style: { animation: `himalaya-enter-fade ${motionDefaultsDuration(ctx.kit, 200)}ms cubic-bezier(0.2,0,0,1) both` }, children: content }, textSwap)) : content;
@@ -129385,7 +129408,7 @@ var init_renderNode = __esm({
             ctx.onAction({ ...action, args: { ...action.args, value: v2, index: i2 } });
           }, style: { minWidth: 44, minHeight: 44, border: 0, background: "transparent", color: "inherit", opacity: 0.6, cursor: props.disabled ? "default" : "pointer", fontSize: pxToRem(13) }, children: "\xD7" })
         ] }, i2)),
-        props.onAdd ? /* @__PURE__ */ jsx10("input", { "aria-label": placeholderText || "Add a chip", placeholder: placeholderText || "Add\u2026", value: draft, disabled: !!props.disabled || !ctx.onAction, onChange: (event) => setDraft(event.currentTarget.value), onKeyDown: (event) => {
+        props.onAdd ? /* @__PURE__ */ jsx10("input", { "aria-label": placeholderText || "Add a chip", placeholder: placeholderText || "Add\u2026", dir: layoutIsRTL(ctx) ? "auto" : void 0, value: draft, disabled: !!props.disabled || !ctx.onAction, onChange: (event) => setDraft(event.currentTarget.value), onKeyDown: (event) => {
           if (event.key !== "Enter" || event.nativeEvent.isComposing || props.disabled || !ctx.onAction) return;
           event.preventDefault();
           const value = draft.trim();
@@ -129598,8 +129621,9 @@ var init_renderNode = __esm({
       const W2 = 100;
       const H2 = 100;
       const all = drawable.flatMap((sr2) => sr2.values);
-      const min = Math.min(...all);
-      const max = Math.max(...all);
+      const hasBars = drawable.some((sr2) => sr2.kind === "bar");
+      const min = hasBars ? Math.min(0, ...all) : Math.min(...all);
+      const max = hasBars ? Math.max(0, ...all) : Math.max(...all);
       const span = max - min || 1;
       const yAt = (v2) => H2 - (v2 - min) / span * H2;
       const xAt = (i2, n2) => n2 === 1 ? W2 / 2 : i2 / (n2 - 1) * W2;
@@ -129612,13 +129636,14 @@ var init_renderNode = __esm({
           const w2 = Math.max(barGeom.width, 0.5);
           return /* @__PURE__ */ jsx10("g", { "data-series": sr2.label || si2, children: sr2.values.map((v2, i2) => {
             const top = yAt(v2);
+            const base = yAt(0);
             return /* @__PURE__ */ jsx10(
               "rect",
               {
                 x: barGeom.lefts[lane]?.[i2] ?? 0,
-                y: top,
+                y: Math.min(top, base),
                 width: w2,
-                height: Math.max(H2 - top, 0.5),
+                height: Math.max(Math.abs(base - top), 0.5),
                 fill: sr2.color
               },
               i2
@@ -161521,32 +161546,32 @@ var init_preview_assets_generated = __esm({
   "../../packages/serve/src/preview-assets.generated.ts"() {
     init_preview_assets_format();
     PREVIEW_ASSET_MANIFEST = [
-      { key: "assets/DashboardHost-C0zY6LXc.js", contentType: "application/javascript; charset=utf-8", offset: 8, length: 2916, sha256: "2ae0514356f33d624fbdea4f37763d9485585ae8c47efda81e9fd4976134aa66" },
-      { key: "assets/DevDrawer--HNffqm4.js", contentType: "application/javascript; charset=utf-8", offset: 2924, length: 16744, sha256: "bc1aa20ec7d0244b30ee071da75acf380ebc7087013247c78a6a4f813ee42658" },
-      { key: "assets/IdiomCompare-BcPm59UD.js", contentType: "application/javascript; charset=utf-8", offset: 19668, length: 1892, sha256: "e47795d60a59d872dc9d1a31cf166940f4eeb1683e2bc858b62da24f1d7835b2" },
-      { key: "assets/LightboxViewer-B3iMQPin.js", contentType: "application/javascript; charset=utf-8", offset: 21560, length: 8132, sha256: "7a035923df5986b7775d3398725f9234d1d7ddf46e0a5af8e9f6bd74d771590d" },
-      { key: "assets/PhonePreviewControl-CRKLF95b.js", contentType: "application/javascript; charset=utf-8", offset: 29692, length: 37729, sha256: "e65e0be6f821b3fd13c847c5ae7fff2880a39bf603a3bd426878af78e3d814a7" },
-      { key: "assets/SchemeCompare-Bn99KkCH.js", contentType: "application/javascript; charset=utf-8", offset: 67421, length: 1824, sha256: "7f2f13e931a686d80e03ce3673dc16e93619c93326fb447d216ee2e5bffc4807" },
-      { key: "assets/index-DFazEEqa.js", contentType: "application/javascript; charset=utf-8", offset: 69245, length: 1268538, sha256: "3718cafcaf0cdc962f5d1c5d6bc3cf5e9ee2b1f11e918fb7e9c629e5b0a49576" },
-      { key: "assets/pdf-NnG-NcU-.js", contentType: "application/javascript; charset=utf-8", offset: 1337783, length: 488199, sha256: "f60ce93a839789588474a844c60da2ebc210efbd3f50f04cc4e44eb8e127cddc" },
-      { key: "assets/pdf.worker.min-BQa_JDET.js", contentType: "application/javascript; charset=utf-8", offset: 1825982, length: 73, sha256: "41bcfda4f3c8c0a81c785ea87c69afc8e7d0ed8c333324aee94c273d881bb6aa" },
-      { key: "assets/pdf.worker.min-BmVo14Nb.mjs", contentType: "application/javascript; charset=utf-8", offset: 1826055, length: 1317034, sha256: "a33cfe728c584fdba4fcc1fd54bcdc2f9f2f13889ddbb5b2bd1d0f8cbe49b84e" },
-      { key: "assets/pdfDocument-MaeR1HVD.js", contentType: "application/javascript; charset=utf-8", offset: 3143089, length: 2868, sha256: "2752019f5f58a8818f6471de600ccfb647cfab7577501d19d0eface21e7820dc" },
-      { key: "fonts/Roboto-LICENSE.txt", contentType: "application/octet-stream", offset: 3145957, length: 4610, sha256: "994062dd7af4186a739de55dd9e151c63b6301f8e2cbafc608d35c2e87da0cd2" },
-      { key: "fonts/Roboto-Variable.ttf", contentType: "font/ttf", offset: 3150567, length: 488584, sha256: "d7598e12c5dbef095ff8272cfc55da0250bd07fbdecbac8a530b9b277872a134" },
-      { key: "fonts/WixMadeforDisplay-Bold.ttf", contentType: "font/ttf", offset: 3639151, length: 90924, sha256: "ec4c7d63772d980d6e147b2df6215fd2737e4b04cebe0cf7e11dc695fb63cdcf" },
-      { key: "fonts/WixMadeforDisplay-ExtraBold.ttf", contentType: "font/ttf", offset: 3730075, length: 90984, sha256: "bf4c16a2774edd38a921edf3099469866cd74c094fd596f3fa4e81f54a04dfaa" },
-      { key: "fonts/WixMadeforDisplay-Medium.ttf", contentType: "font/ttf", offset: 3821059, length: 90980, sha256: "368faca44fb9f7207e4af784e94750b1ee59c1098b8689e0f4a918926f244fb5" },
-      { key: "fonts/WixMadeforDisplay-Regular.ttf", contentType: "font/ttf", offset: 3912039, length: 90872, sha256: "97ed8f1a6772abe26e3d8af5cecfc4b02faa94497d585b0398b5053b739a70c1" },
-      { key: "fonts/WixMadeforDisplay-SemiBold.ttf", contentType: "font/ttf", offset: 4002911, length: 90980, sha256: "642feab8a48ddf6c7a89d7c2a7c0edfa0e6e773f671287e460e222703563191e" },
-      { key: "fonts/WixMadeforText-Bold.ttf", contentType: "font/ttf", offset: 4093891, length: 108636, sha256: "37c179b4fefb63ea9637322b84583a2df53aa226c150294eea1675c14b1b8e29" },
-      { key: "fonts/WixMadeforText-ExtraBold.ttf", contentType: "font/ttf", offset: 4202527, length: 109084, sha256: "62e2fe4718129f36ecdb0ae4de385bd6b81ecc876146447167c6c140fad699a9" },
-      { key: "fonts/WixMadeforText-Medium.ttf", contentType: "font/ttf", offset: 4311611, length: 109048, sha256: "4ecf270136af928612c76fe4ebade91d8156975e5ea4c0cf9225501dd1788e02" },
-      { key: "fonts/WixMadeforText-Regular.ttf", contentType: "font/ttf", offset: 4420659, length: 107700, sha256: "dee56f09fd3efc127c1ea95557edc74110c1460a46287da36e0af25efd341ef5" },
-      { key: "fonts/WixMadeforText-SemiBold.ttf", contentType: "font/ttf", offset: 4528359, length: 88108, sha256: "dced97a77624bc5f8b1ae65850360908297f4588e09feb6f22792d29dc7e765b" },
-      { key: "himi-sw.js", contentType: "application/javascript; charset=utf-8", offset: 4616467, length: 6748, sha256: "4a92459977d7cefa1a6a7e020c3a63509737f083b3f2773557c1a5771665811a" },
-      { key: "index.html", contentType: "text/html; charset=utf-8", offset: 4623215, length: 4947, sha256: "31e294c8a2eff7f23f4b24e1696713854eb517ad048ef9cc6967c90b9abca5ba" },
-      { key: "t5-frame.html", contentType: "text/html; charset=utf-8", offset: 4628162, length: 17786, sha256: "084107ca997628c248f1b0ba3a7494744850df39fad813546ab8bdb82a6058da" }
+      { key: "assets/DashboardHost-DHg737_J.js", contentType: "application/javascript; charset=utf-8", offset: 8, length: 2916, sha256: "ba02376a739002a2cfdddf2171a88943fefe3c96d891acaffdaf7a6269a21c7f" },
+      { key: "assets/DevDrawer-Dv0jOOVg.js", contentType: "application/javascript; charset=utf-8", offset: 2924, length: 16744, sha256: "6f2432ca864fd12307ebe508972896f80b939688049261b810c20677cdf47aeb" },
+      { key: "assets/IdiomCompare-B3ygKWWA.js", contentType: "application/javascript; charset=utf-8", offset: 19668, length: 1892, sha256: "e0c2f6385823c78ca9ebafbc6ad1a6911429afaf4e672e8c0806760f872d22bf" },
+      { key: "assets/LightboxViewer-dk9y5AXX.js", contentType: "application/javascript; charset=utf-8", offset: 21560, length: 8132, sha256: "1f1fc6d36e57b8ad8737abf7a275b5d42c1e8448b32a6a1f40abd2ff580f1faf" },
+      { key: "assets/PhonePreviewControl-DG7jCSLI.js", contentType: "application/javascript; charset=utf-8", offset: 29692, length: 37729, sha256: "de51e874734effc34cf7ccf8fe6ea87fb831fdaa87af947456fa5b2852c5eda4" },
+      { key: "assets/SchemeCompare-CAIZvnUI.js", contentType: "application/javascript; charset=utf-8", offset: 67421, length: 1824, sha256: "0557f704437af69e3ff81ea229379ecbb1e25acb321e34c67feae6026e7f0277" },
+      { key: "assets/index-tRKXWUtH.js", contentType: "application/javascript; charset=utf-8", offset: 69245, length: 1269195, sha256: "a3c8a7d117e9057a19bd0e1e162df14bd67d783dad938fa18c0b46c128e491c3" },
+      { key: "assets/pdf-BGZQFD3z.js", contentType: "application/javascript; charset=utf-8", offset: 1338440, length: 488199, sha256: "45778957c20ba1348ec582d28916eadaad6808aa9d7c6244e3d29ad7d72ff14e" },
+      { key: "assets/pdf.worker.min-BQa_JDET.js", contentType: "application/javascript; charset=utf-8", offset: 1826639, length: 73, sha256: "41bcfda4f3c8c0a81c785ea87c69afc8e7d0ed8c333324aee94c273d881bb6aa" },
+      { key: "assets/pdf.worker.min-BmVo14Nb.mjs", contentType: "application/javascript; charset=utf-8", offset: 1826712, length: 1317034, sha256: "a33cfe728c584fdba4fcc1fd54bcdc2f9f2f13889ddbb5b2bd1d0f8cbe49b84e" },
+      { key: "assets/pdfDocument-BK3iUf4H.js", contentType: "application/javascript; charset=utf-8", offset: 3143746, length: 2868, sha256: "b6af1f9159b81971953dc0d06431ccb130b2ecbf473459332db6de4cc4cbbbb7" },
+      { key: "fonts/Roboto-LICENSE.txt", contentType: "application/octet-stream", offset: 3146614, length: 4610, sha256: "994062dd7af4186a739de55dd9e151c63b6301f8e2cbafc608d35c2e87da0cd2" },
+      { key: "fonts/Roboto-Variable.ttf", contentType: "font/ttf", offset: 3151224, length: 488584, sha256: "d7598e12c5dbef095ff8272cfc55da0250bd07fbdecbac8a530b9b277872a134" },
+      { key: "fonts/WixMadeforDisplay-Bold.ttf", contentType: "font/ttf", offset: 3639808, length: 90924, sha256: "ec4c7d63772d980d6e147b2df6215fd2737e4b04cebe0cf7e11dc695fb63cdcf" },
+      { key: "fonts/WixMadeforDisplay-ExtraBold.ttf", contentType: "font/ttf", offset: 3730732, length: 90984, sha256: "bf4c16a2774edd38a921edf3099469866cd74c094fd596f3fa4e81f54a04dfaa" },
+      { key: "fonts/WixMadeforDisplay-Medium.ttf", contentType: "font/ttf", offset: 3821716, length: 90980, sha256: "368faca44fb9f7207e4af784e94750b1ee59c1098b8689e0f4a918926f244fb5" },
+      { key: "fonts/WixMadeforDisplay-Regular.ttf", contentType: "font/ttf", offset: 3912696, length: 90872, sha256: "97ed8f1a6772abe26e3d8af5cecfc4b02faa94497d585b0398b5053b739a70c1" },
+      { key: "fonts/WixMadeforDisplay-SemiBold.ttf", contentType: "font/ttf", offset: 4003568, length: 90980, sha256: "642feab8a48ddf6c7a89d7c2a7c0edfa0e6e773f671287e460e222703563191e" },
+      { key: "fonts/WixMadeforText-Bold.ttf", contentType: "font/ttf", offset: 4094548, length: 108636, sha256: "37c179b4fefb63ea9637322b84583a2df53aa226c150294eea1675c14b1b8e29" },
+      { key: "fonts/WixMadeforText-ExtraBold.ttf", contentType: "font/ttf", offset: 4203184, length: 109084, sha256: "62e2fe4718129f36ecdb0ae4de385bd6b81ecc876146447167c6c140fad699a9" },
+      { key: "fonts/WixMadeforText-Medium.ttf", contentType: "font/ttf", offset: 4312268, length: 109048, sha256: "4ecf270136af928612c76fe4ebade91d8156975e5ea4c0cf9225501dd1788e02" },
+      { key: "fonts/WixMadeforText-Regular.ttf", contentType: "font/ttf", offset: 4421316, length: 107700, sha256: "dee56f09fd3efc127c1ea95557edc74110c1460a46287da36e0af25efd341ef5" },
+      { key: "fonts/WixMadeforText-SemiBold.ttf", contentType: "font/ttf", offset: 4529016, length: 88108, sha256: "dced97a77624bc5f8b1ae65850360908297f4588e09feb6f22792d29dc7e765b" },
+      { key: "himi-sw.js", contentType: "application/javascript; charset=utf-8", offset: 4617124, length: 6748, sha256: "4a92459977d7cefa1a6a7e020c3a63509737f083b3f2773557c1a5771665811a" },
+      { key: "index.html", contentType: "text/html; charset=utf-8", offset: 4623872, length: 4947, sha256: "54a5febec3be66748da191dc685e0007e5b7dbfc29c110b39f39244b1446139e" },
+      { key: "t5-frame.html", contentType: "text/html; charset=utf-8", offset: 4628819, length: 17786, sha256: "084107ca997628c248f1b0ba3a7494744850df39fad813546ab8bdb82a6058da" }
     ];
   }
 });

package/guides/sdk-reference.json

@@ -4743,6 +4743,12 @@
     "source": "core/sdk/webview/src/index.ts",
     "description": "Tier-5 typed binding for the page ↔ worker message channel of a worker-backed webview screen (Part 2 / RFC 0025 composition).",
     "api": [
+      {
+        "name": "\"./dispatcher.js\"",
+        "kind": "reexport",
+        "jsdoc": "",
+        "decl": "export {\n  PAGE_HANDSHAKE_CAPABILITY,\n  PAGE_HANDSHAKE_METHOD,\n  type ExposedPageCapability,\n  type PageCapabilityRequest,\n  type PageCapabilityResponse,\n  type PageConsoleEvent,\n  type PageCtx,\n  type PageLifecycleEvent,\n  type PageRequestHandler,\n  type PageStream,\n} from \"./dispatcher.js\";"
+      },
       {
         "name": "postToPage",
         "kind": "function",
@@ -4752,43 +4758,43 @@
       {
         "name": "onPageMessage",
         "kind": "function",
-        "jsdoc": "/**\n * Register a handler for messages the page posts via `window.HimalayaWorker.post(msg)`.\n * The latest registered handler wins. Call this once during the bundle's setup.\n */",
-        "decl": "export function onPageMessage(cb: (msg: unknown) => void): void;"
+        "jsdoc": "/**\n * Register a handler for messages the page posts via `window.HimalayaWorker.post(msg)` that no\n * responder (`exposeCapabilitiesToPage`, `onPageRequest`) claims. The latest registered handler\n * wins. `instanceId` is the embedded WebView the host says the message came from (`\"\"` for the\n * full-screen page). Call this once during the bundle's setup.\n */",
+        "decl": "export function onPageMessage(cb: (msg: unknown, instanceId: string) => void): void;"
       },
       {
-        "name": "PageCapabilityRequest",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface PageCapabilityRequest {\n  v: 1;\n  id: string;\n  capability: string;\n  method: string;\n  args: unknown[];\n}"
+        "name": "onPageRequest",
+        "kind": "function",
+        "jsdoc": "/**\n * Answer page requests `call(namespace, method, args)` from `@wix/himalaya/webview-page` (or\n * `himalaya.<namespace>.<method>(…)`) with worker code. A handler gets `(args, ctx)` and returns a value or a promise; a throw answers\n * `ok: false`. To stream, return `openPageStream(ctx.instanceId, ctx.requestId)`.\n *\n * Throws when `namespace` is `\"himalaya\"`, already registered, already exposed, or not\n * `/^[a-z][a-z0-9_]{0,63}$/`. A method the namespace lacks answers `code: \"unknown_method\"`.\n */",
+        "decl": "export function onPageRequest(namespace: string, handlers: Readonly<Record<string, PageRequestHandler>>): void;"
       },
       {
-        "name": "PageCapabilityResponse",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface PageCapabilityResponse {\n  v: 1;\n  id: string;\n  ok: boolean;\n  result?: unknown;\n  error?: { message: string; code?: string };\n}"
+        "name": "emitToPage",
+        "kind": "function",
+        "jsdoc": "/**\n * Push an event to one page instance, or `\"*\"` for every instance that has sent a message or\n * mounted and not unmounted. `event` is `\"<namespace>.<event>\"`, split on the first dot; the page\n * receives it through `himalaya.<namespace>.on(\"<event>\", cb)`.\n */",
+        "decl": "export function emitToPage(instanceId: string, event: `${string}.${string}`, data: unknown): void;"
       },
       {
-        "name": "PAGE_HANDSHAKE_CAPABILITY",
-        "kind": "const",
-        "jsdoc": "/** `call(\"himalaya\", \"capabilities\")` answers `{ v: 1, capabilities: { <id>: [<method>…] } }`:\n *  exactly the allowlist this worker was given. Reserved, so no real capability can take it. */",
-        "decl": "export const PAGE_HANDSHAKE_CAPABILITY = \"himalaya\";"
+        "name": "openPageStream",
+        "kind": "function",
+        "jsdoc": "/**\n * Open a stream answer for an in-flight `onPageRequest` call. Return the handle from the handler;\n * the page then iterates the chunks. After `end`, `error`, or a page cancel, `next` is a no-op.\n */",
+        "decl": "export function openPageStream(instanceId: string, requestId: string): PageStream;"
       },
       {
-        "name": "PAGE_HANDSHAKE_METHOD",
-        "kind": "const",
-        "jsdoc": "",
-        "decl": "export const PAGE_HANDSHAKE_METHOD = \"capabilities\";"
+        "name": "onPageLifecycle",
+        "kind": "function",
+        "jsdoc": "/**\n * Observe host lifecycle envelopes (`mounted | loaded | active | inactive | crashed | reloaded |\n * navBlocked | unmounted`). They arrive only on the host's lifecycle primitive, never from a page.\n * On a runtime without instance support, nothing is delivered. Returns an unsubscribe function.\n */",
+        "decl": "export function onPageLifecycle(cb: (e: PageLifecycleEvent) => void): () => void;"
       },
       {
-        "name": "ExposedPageCapability",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface ExposedPageCapability {\n  module: Record<string, unknown>;\n  methods: readonly string[];\n}"
+        "name": "onPageConsole",
+        "kind": "function",
+        "jsdoc": "/**\n * Observe `console_forwarding` output of the embedded pages. UNTRUSTED page data: a page can forge\n * these, so never treat them as host events. Returns an unsubscribe function.\n */",
+        "decl": "export function onPageConsole(cb: (e: PageConsoleEvent) => void): () => void;"
       },
       {
         "name": "exposeCapabilitiesToPage",
         "kind": "function",
-        "jsdoc": "/**\n * Expose selected typed @himalaya/* modules to the hosting page.\n *\n * The worker author must pass both the imported module and its explicit verb allowlist:\n *\n *   import * as health from \"@himalaya/health\";\n *   exposeCapabilitiesToPage({\n *     health: { module: health, methods: [\"availability\", \"query\"] },\n *   });\n *\n * The bundle still has to declare `webview` plus every exposed capability. Importing only\n * selected modules keeps native permissions and `himi dist` additions opt-in.\n */",
+        "jsdoc": "/**\n * Expose selected typed @himalaya/* modules to the hosting page.\n *\n * The worker author must pass both the imported module and its explicit verb allowlist:\n *\n *   import * as health from \"@himalaya/health\";\n *   exposeCapabilitiesToPage({\n *     health: { module: health, methods: [\"availability\", \"query\"] },\n *   });\n *\n * The bundle still has to declare `webview` plus every exposed capability. Importing only\n * selected modules keeps native permissions and `himi dist` additions opt-in. The page handshake\n * (`call(\"himalaya\", \"capabilities\")`) answers this allowlist plus every `onPageRequest` namespace.\n */",
         "decl": "export function exposeCapabilitiesToPage(\n  capabilities: Readonly<Record<string, ExposedPageCapability>>,\n): void;"
       },
       {
@@ -4811,52 +4817,46 @@
         "decl": "export type { HimalayaPageCapabilities, HimalayaPageSdk } from \"./capabilities.generated.js\";"
       },
       {
-        "name": "WebViewPageRequest",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WebViewPageRequest {\n  v: 1;\n  id: string;\n  capability: string;\n  method: string;\n  args: unknown[];\n}"
-      },
-      {
-        "name": "WebViewPageError",
-        "kind": "interface",
-        "jsdoc": "",
-        "decl": "export interface WebViewPageError {\n  message: string;\n  code?: string;\n}"
-      },
-      {
-        "name": "WebViewPageResponse",
-        "kind": "interface",
+        "name": "\"./client.js\"",
+        "kind": "reexport",
         "jsdoc": "",
-        "decl": "export interface WebViewPageResponse {\n  v: 1;\n  id: string;\n  ok: boolean;\n  result?: unknown;\n  error?: WebViewPageError;\n}"
+        "decl": "export type {\n  PageEventHandler,\n  WebViewPageError,\n  WebViewPageEvent,\n  WebViewPageRequest,\n  WebViewPageResponse,\n  WebViewPageStreamEnvelope,\n} from \"./client.js\";"
       },
       {
         "name": "call",
         "kind": "function",
-        "jsdoc": "/** Invoke one method through the companion worker. Primarily useful to generated bindings.\n *  A call that shows native UI (a permission prompt, the share sheet) answers only when the user\n *  is done with it: pass a long `timeoutMs` (e.g. 120_000) rather than the 30-second default. */",
+        "jsdoc": "/** Invoke one method through the companion worker. Primarily useful to generated bindings.\n *  A call that shows native UI (a permission prompt, the share sheet) answers only when the user\n *  is done with it: pass a long `timeoutMs` (e.g. 120_000) rather than the 30-second default.\n *  A method the worker answers as a stream resolves to an `AsyncIterable` of its chunks:\n *  `for await (const chunk of await call(…))`; `break` cancels it on the worker. */",
         "decl": "export function call<T>(\n  capability: string,\n  method: string,\n  args: unknown[] = [],\n  timeoutMs = 30_000,\n): Promise<T>;"
       },
+      {
+        "name": "on",
+        "kind": "function",
+        "jsdoc": "/** Subscribe to `namespace.event`, pushed by the worker's `emitToPage(iid, \"<namespace>.<event>\", data)`.\n *  Same as `himalaya.<namespace>.on(event, handler)`. Returns the unsubscribe function. */",
+        "decl": "export function on(namespace: string, event: string, handler: PageEventHandler): () => void;"
+      },
       {
         "name": "enabledCapabilities",
         "kind": "function",
         "jsdoc": "/**\n * The capabilities and methods this page's companion worker answers, as `{ <id>: [<method>…] }`;\n * `null` outside the app, when the app is older than the handshake, or nothing answered in\n * `timeoutMs`. A list is remembered (and returned at once, whatever `timeoutMs`); a miss is not,\n * because a worker that is still booting drops the first messages.\n */",
-        "decl": "export async function enabledCapabilities(timeoutMs = 3_000): Promise<Record<string, string[]> | null>;"
+        "decl": "export function enabledCapabilities(timeoutMs = 3_000): Promise<Record<string, string[]> | null>;"
       },
       {
         "name": "isEnabled",
         "kind": "function",
         "jsdoc": "/** Whether the companion worker lets this page call `capability.method`, read from\n *  enabledCapabilities() — nothing is called. `false` when there is no list. */",
-        "decl": "export async function isEnabled(capability: string, method: string, timeoutMs = 3_000): Promise<boolean>;"
+        "decl": "export function isEnabled(capability: string, method: string, timeoutMs = 3_000): Promise<boolean>;"
       },
       {
         "name": "probe",
         "kind": "function",
-        "jsdoc": "/** For an app older than the handshake: CALL `capability.method` and report whether it answered\n *  (even with an error). It runs the method, so pass only a read-only one. */",
-        "decl": "export async function probe(capability: string, method: string, args: unknown[] = [], timeoutMs = 3_000): Promise<boolean>;"
+        "jsdoc": "/** For an app older than the handshake: CALL `capability.method` and report whether it answered\n *  (even with an error other than `unknown_method`). It runs the method, so pass only a read-only one. */",
+        "decl": "export function probe(capability: string, method: string, args: unknown[] = [], timeoutMs = 3_000): Promise<boolean>;"
       },
       {
         "name": "himalaya",
         "kind": "const",
-        "jsdoc": "/**\n * Typed SDK proxy for every request/response capability in CAPABILITY_REGISTRY.\n * A namespace is usable only when this screen's companion worker explicitly imported and\n * exposed it and the bundle + host both declared it.\n */",
-        "decl": "export const himalaya = new Proxy({ version: 1 as const }, {\n  get(target, property) {\n    if (property === \"version\") return target.version;\n    if (typeof property !== \"string\" || property === \"then\") return undefined;\n    return pageMember(property, []);\n  },\n}) as HimalayaPageSdk;"
+        "jsdoc": "/**\n * Typed SDK proxy for every request/response capability in CAPABILITY_REGISTRY.\n * A namespace is usable only when this screen's companion worker explicitly imported and\n * exposed it and the bundle + host both declared it. Built by the same `merge` a host uses for the\n * injected client, so `himalaya.call/on/probe/…` are the client's members here too.\n */",
+        "decl": "export const himalaya = client.merge({}) as HimalayaPageSdk;"
       },
       {
         "name": "health",

package/guides/web-page-native-sdk.md

@@ -79,7 +79,7 @@ type Bridge = { post(message: unknown): boolean; onMessage(handler: (message: un
 type Reply = { v: 1; id: string; ok: boolean; result?: unknown; error?: { message: string; code?: string } };
 
 export class HimalayaError extends Error {
-  /** "not_in_app" | "bridge_refused" | "timeout", or the capability's own code (e.g. "not_authorized"). */
+  /** "not_in_app" | "bridge_refused" | "timeout" | "unknown_method", or the capability's own code (e.g. "not_authorized"). */
   readonly code: string;
   constructor(message: string, code: string) {
     super(message);
@@ -224,8 +224,9 @@ export async function probe(capability: string, method: string, args: unknown[]
     await call(capability, method, args, timeoutMs);
     return true;
   } catch (error) {
-    // Only an answer from the app (even an error) proves the method is enabled.
-    return !(error instanceof HimalayaError && ["timeout", "not_in_app", "bridge_refused"].includes(error.code));
+    // Only an answer from the app (even an error) proves the method is enabled — except the app
+    // saying it has no such method.
+    return !(error instanceof HimalayaError && ["timeout", "not_in_app", "bridge_refused", "unknown_method"].includes(error.code));
   }
 }
 

package/guides/webview-page-sdk.md

@@ -85,6 +85,104 @@ Do not build one worker that imports every SDK. Static bundle scanning would cor
 that the release uses every capability, forcing unrelated permissions and native modules into the
 binary. One app-specific worker imports exactly the app’s selected subset.
 
+## Custom namespaces, events and streams
+
+One worker can serve any number of embedded pages at once. Beside `exposeCapabilitiesToPage`, the
+worker answers its own namespaces, pushes events and streams results; all of them share one
+internal dispatcher, so registering one never replaces another (and `onPageMessage` still receives
+every message none of them claims, including a handler registered directly on
+`himalaya.webview.onPageMessage` after `@himalaya/webview` loaded).
+
+```ts
+import { emitToPage, onPageLifecycle, onPageRequest, openPageStream } from "@himalaya/webview";
+
+onPageRequest("nano", {
+  // (args, ctx) → value | promise. ctx = { instanceId, requestId, active }.
+  "location.getCurrentLocation": async () => ({ lat: 32.08, lng: 34.78 }),
+  // Return a stream handle to answer with many chunks.
+  "steps.watch": (_args, ctx) => {
+    const stream = openPageStream(ctx.instanceId, ctx.requestId);
+    const timer = setInterval(() => stream.next({ steps: Math.random() }), 1000);
+    stream.onCancel(() => clearInterval(timer)); // the page broke out of its loop
+    return stream;
+  },
+});
+
+emitToPage("*", "nano.theme.changed", { dark: true }); // or one instance id
+const off = onPageLifecycle(({ instanceId, state }) => console.log(instanceId, state)); // mounted … unmounted
+```
+
+- `ctx.instanceId` is the WebView the **host** says the request came from; a page-sent `iid` is
+  ignored. `ctx.active` is live: `false` between `inactive` and `active` lifecycle events.
+- A namespace — and an exposed capability id — follows the capability-id pattern
+  (`/^[a-z][a-z0-9_]{0,63}$/`). Registering it twice, registering `himalaya`, or a name already
+  exposed throws. So do names the page's `himalaya.<name>` cannot reach: `call`, `on`, `probe`,
+  `version`, `then`, `constructor` and `general`, a method named `on`, and a method with a `then`,
+  `toString` or `valueOf` segment. The handshake lists custom namespaces beside exposed capabilities.
+- A request whose page unmounted, reloaded or crashed before it answered is not answered at all:
+  the instance id may already belong to a new document. A `reloaded` right after `crashed` counts
+  as one boundary; a `mounted` or `loaded` in between ends that pair (so a host that remounts after
+  a crash delivers `reloaded` before the new document's `loaded`). A message still queued when
+  its instance unmounted reaches `onPageMessage` but revives nothing, and its request is not
+  answered; the instance is back once it mounts again.
+- A method a registered namespace lacks answers at once with
+  `{ ok: false, error: { code: "unknown_method" } }` — the page does not wait out a timeout, and
+  `probe()` reads it as "not enabled". A request for a capability that is neither exposed nor
+  registered is not the dispatcher's: it reaches `onPageMessage` (the bundle's own protocol) and is
+  otherwise unanswered, because pages built against an older `probe()` read any answer as
+  "enabled". A method outside an allowlist and unknown methods on the reserved `himalaya` name also
+  stay unanswered.
+- `emitToPage(iid, "<ns>.<event>", data)` splits on the first dot; `"*"` reaches every instance
+  that has sent a message or mounted and has not unmounted (on a single-page runtime, its page).
+- A stream answers `{ v: 1, id, ok: true, stream: true }`, then `{ v: 1, sid, chunk }`… and
+  `{ v: 1, sid, end: true }` or `{ v: 1, sid, error }`; `sid` is the request id. After `end`,
+  `error`, a page cancel, or the instance unmounting, reloading or crashing, `next` is a no-op.
+  `onCancel` also runs when a handler opens a stream and then returns something else or throws,
+  and at once if it is registered after the stream was abandoned. `next(undefined)` sends `null`.
+- `onPageLifecycle` envelopes come only from the host's lifecycle primitive; one arriving as a page
+  message is never treated as lifecycle. Of the page's `{ v: 1, sys }` messages the dispatcher keeps
+  only `cancel` and `console`; any other `sys` reaches `onPageMessage`. `onPageConsole` surfaces `console_forwarding` output — **untrusted** page
+  data the page can forge; never treat it as a host event.
+- On a runtime without instance support (`himalaya.webview.onPageLifecycle` absent) every message
+  is instance `""`, lifecycle never fires, and posts to any other instance are dropped. Such a host
+  does not report a page reload either, so a stream there stops only when the page cancels it:
+  bound the producer (a count or a deadline) rather than relying on `onCancel` alone.
+- A page `probe()` of a streamed method cancels the stream it started.
+
+On the page:
+
+```ts
+import { call, on } from "@wix/himalaya/webview-page";
+
+declare function applyTheme(theme: unknown): void;
+declare function render(reading: { steps: number }): void;
+
+// A typed capability has the same method: himalaya.<capability>.on("<event>", cb).
+const off = on("nano", "theme.changed", (data) => applyTheme(data));
+let readings = 0;
+for await (const reading of await call<AsyncIterable<{ steps: number }>>("nano", "steps.watch")) {
+  render(reading);
+  if (++readings === 10) break; // sends { v: 1, sys: "cancel", sid } — the worker's onCancel runs
+}
+off();
+```
+
+A stream `error` envelope throws from the loop. The page accepts only `v: 1` envelopes, and
+responses only for a request id it sent.
+
+**Injected client (planned host behaviour).** No host injects it yet: today a page imports
+`@wix/himalaya/webview-page`. The native and web hosts are planned to inject the same client at
+document start for worker-bridged WebViews, so inline HTML will need no import.
+`PAGE_CLIENT_SOURCE` (`@himalaya/webview-page/page-client`, generated from `src/client.ts` by
+`scripts/generate-page-client.ts`) is a script that defines no global and evaluates to
+`createPageClient(getBridge)`. The host's bridge shim defines `window.himalaya` non-writable, so
+the client is to be merged into the shim's own object before it is frozen:
+`client.merge({ general: … })` adds `call`, `on`, `enabledCapabilities`, `isEnabled`, `probe` and
+`version`, freezes the object, and resolves any other name to a namespace proxy
+(`himalaya.nano.on(…)`, `himalaya.nano.location.getCurrentLocation()`). The package's own
+`himalaya` export is built the same way, so both surfaces have the same members. Coercing a
+namespace to a string (`` `${himalaya.nano}` ``) sends nothing to the worker.
+
 ## Brandy
 
 Name the capabilities; Brandy supplies the companion worker, so neither the page author nor the
@@ -135,9 +233,10 @@ Base44 is accepted only when the same Brandy contract contains a Base44 binding.
 - Errors preserve a typed `code` when the SDK provides one.
 - The page cannot use raw `capability.*` messages: Brandy site descriptors keep
   `capabilitiesRequired: []`; native calls go through the companion worker.
-- v1 is request/response. SDK helpers returning `AsyncIterable`, accepting JavaScript callbacks,
-  or depending on worker action names need a page-specific adapter built from their lower-level
-  start/next/stop verbs. Do not expose such a helper unchanged.
+- `exposeCapabilitiesToPage` is request/response. SDK helpers returning `AsyncIterable`, accepting
+  JavaScript callbacks, or depending on worker action names need an `onPageRequest` adapter
+  (a stream or `emitToPage` events) built from their lower-level start/next/stop verbs. Do not
+  expose such a helper unchanged.
 
 The package source includes complete `health-page.ts` and `health-worker.ts` examples matching the
 snippets above.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1450.0",
+  "version": "0.1452.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": [
@@ -71,5 +71,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "9e4b4eed20568576a872a08d2eebfc47562e413465af5dbaa19c3902"
+  "falconPackageHash": "c345fa006ed03ed32be63ed23a653016d907cbd352ccb6171b77e23e"
 }