@wix/himalaya-cli 0.1208.0 → 0.1210.0

package/dist/cli.mjs

@@ -6818,6 +6818,7 @@ function walk(node, registry, path2, out2) {
 var SYSTEM_FONT_FAMILY, TONAL_ELEVATION_ALPHA, COLOR_TOKEN_PROPS, TYPOGRAPHY_TOKEN_PROPS;
 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];
     COLOR_TOKEN_PROPS = {
@@ -6868,7 +6869,6 @@ function resolveTranslation(value, catalog, sourceCatalog) {
 var BINDING_SIGILS, BINDING_SIGIL_RE, TRANSLATION_PREFIX, TRANSLATION_KEY_RE;
 var init_bindings = __esm({
   "../../core/ts/src/bindings.ts"() {
-    "use strict";
     BINDING_SIGILS = ["service", "flag", "item", "t"];
     BINDING_SIGIL_RE = new RegExp(
       `^\\$(?:${BINDING_SIGILS.filter((s) => s !== "t").join("|")})\\b|^\\$t:`
@@ -9324,7 +9324,7 @@ async function bootBundleWorker(bundleJs, opts) {
     input: opts.input ?? {},
     wixApi,
     // v1 best-effort stubs — a visitor-scoped load() reads Wix, not device-local state.
-    storage: { get: () => "", set: () => {
+    storage: opts.storage ? { get: (k) => opts.storage.getItem(k) ?? "", set: (k, v) => opts.storage.setItem(k, v), getItem: (k) => opts.storage.getItem(k), setItem: (k, v) => opts.storage.setItem(k, v) } : { get: () => "", set: () => {
     }, getItem: () => null, setItem: () => {
     } },
     dispatch: dispatchHost,
@@ -9499,7 +9499,12 @@ async function bootBundleWorker(bundleJs, opts) {
           if (typeof v === "string" && k !== "screenId") args[k] = v;
         }
       }
-      navDirectives.push({ screenId: nav.screenId, args });
+      const verb = nav.presentation;
+      navDirectives.push({
+        screenId: nav.screenId,
+        args,
+        ...verb === "push" || verb === "replace" ? { presentation: verb } : {}
+      });
     }
     if ("_nav" in rec || "_stream" in rec || "_poll" in rec || "_error" in rec) {
       const stripped = {};
@@ -25293,7 +25298,6 @@ function shouldRevealError(args) {
 var EMAIL_RE, URL_HOST_RE, INTEGER_RE, NUMBER_RE;
 var init_validation = __esm({
   "../../core/ts/src/validation.ts"() {
-    "use strict";
     EMAIL_RE = /^[A-Za-z0-9._%+-]+@[A-Za-z0-9-]+(\.[A-Za-z0-9-]+)*\.[A-Za-z]{2,}$/;
     URL_HOST_RE = /^[A-Za-z0-9-]+(\.[A-Za-z0-9-]+)*(:[0-9]+)?$/;
     INTEGER_RE = /^[+-]?[0-9]+$/;
@@ -25953,7 +25957,6 @@ function validateWorkerSubtree(raw, slotId, policy, actionCatalog) {
 var WORKER_SUBTREE_CEILINGS, ID_PART, ACTION_ID;
 var init_worker_subtree = __esm({
   "../../core/ts/src/worker-subtree.ts"() {
-    "use strict";
     init_worker_subtree_safe_types_generated();
     WORKER_SUBTREE_CEILINGS = Object.freeze({
       maxEncodedBytes: 65536,
@@ -35419,6 +35422,89 @@ function hasInteractiveDescendant(node) {
   };
   return Object.values(normalize(node).props ?? {}).some(visit);
 }
+function nameFromOwnContent(root) {
+  const parts = [];
+  const walk2 = (n) => {
+    for (const child of Array.from(n.childNodes)) {
+      if (child.nodeType === 3) {
+        const t = child.textContent?.trim();
+        if (t) parts.push(t);
+      } else if (child.nodeType === 1 && !child.matches(NAME_SKIP_SELECTOR)) {
+        const own3 = child.getAttribute("aria-label")?.trim() || (child.tagName === "IMG" ? child.getAttribute("alt")?.trim() : void 0);
+        if (own3) parts.push(own3);
+        else walk2(child);
+      }
+    }
+  };
+  walk2(root);
+  return parts.join(" ").replace(/\s+/g, " ").trim();
+}
+function trackActivatorName(activator) {
+  const host = activator.parentElement;
+  if (!host) return;
+  const apply = () => {
+    const name = nameFromOwnContent(host);
+    if (name) {
+      if (activator.getAttribute("aria-label") !== name) activator.setAttribute("aria-label", name);
+    } else if (activator.hasAttribute("aria-label")) {
+      activator.removeAttribute("aria-label");
+    }
+  };
+  apply();
+  if (activatorNameObservers.has(activator) || typeof MutationObserver === "undefined") return;
+  const observer = new MutationObserver((records) => {
+    if (records.every((r) => r.target === activator)) return;
+    apply();
+  });
+  observer.observe(host, {
+    subtree: true,
+    childList: true,
+    characterData: true,
+    // A name can come from a nested image's bound alt / aria-label, or change when content is
+    // hidden or shown — all patched in place as attributes.
+    attributes: true,
+    attributeFilter: ["aria-label", "aria-labelledby", "alt", "title", "hidden", "aria-hidden", "style"]
+  });
+  activatorNameObservers.set(activator, observer);
+}
+function TapActivator({ label: label2, state, tabIndex = 0, role = "button", hint, initialFocus }) {
+  const ref = React7.useRef(null);
+  const hintId = `hm-tap-hint${React7.useId()}`;
+  useIsomorphicLayoutEffect(() => {
+    const el = ref.current;
+    if (!el || label2) return;
+    trackActivatorName(el);
+    return () => {
+      activatorNameObservers.get(el)?.disconnect();
+      activatorNameObservers.delete(el);
+    };
+  }, [label2]);
+  const activator = /* @__PURE__ */ jsx8(
+    "span",
+    {
+      ref,
+      ...{ [TAP_ACTIVATOR_ATTR]: "" },
+      role,
+      tabIndex,
+      "aria-label": label2 || void 0,
+      "aria-describedby": hint ? hintId : void 0,
+      ...initialFocus !== void 0 ? { "data-himalaya-initial-focus": initialFocus } : {},
+      ...state,
+      style: VISUALLY_HIDDEN,
+      onKeyDown: (e) => {
+        if (e.defaultPrevented || e.target !== e.currentTarget || e.repeat) return;
+        if (e.key !== "Enter" && e.key !== " ") return;
+        e.preventDefault();
+        e.stopPropagation();
+        e.currentTarget.click();
+      }
+    }
+  );
+  return hint ? /* @__PURE__ */ jsxs5(Fragment4, { children: [
+    activator,
+    /* @__PURE__ */ jsx8("span", { id: hintId, hidden: true, "data-hm-a11y-hint": "", children: hint })
+  ] }) : activator;
+}
 function withExtras(name, render) {
   const Wrapped = ({ props, ctx, wrap, nodeId, gap, ...pass }) => {
     const el = render({ props, ctx, wrap, nodeId, gap });
@@ -36276,8 +36362,43 @@ function renderNodeInner(node, ctx) {
   const a11yHidden = extra["aria-hidden"] === "true";
   const tap = node?.modifiers?.onTap ?? node?.modifiers?.on_tap;
   const tapDisabled = normalize(node).props?.disabled === true || normalize(node).props?.loading === true || node?.modifiers?.disabled === true || node?.modifiers?.hitTestable === false || node?.modifiers?.hit_testable === false;
+  let tapActivator = null;
   const giveControlContract = (activate) => {
-    if (a11yHidden || isNativeInteractiveElement(el) || hasInteractiveDescendant(node)) return;
+    if (a11yHidden || isNativeInteractiveElement(el)) return;
+    if (hasInteractiveDescendant(node)) {
+      if (typeof el.type === "string" && normalize(node).type !== "ListItem") {
+        const authored2 = extra["aria-label"];
+        const state = {};
+        for (const k of ACTIVATOR_STATE_ATTRS) {
+          if (typeof extra[k] === "string") {
+            state[k] = extra[k];
+            delete extra[k];
+          }
+        }
+        const authoredOrder = typeof extra.tabIndex === "number" && extra.tabIndex > 0 ? extra.tabIndex : void 0;
+        if (authoredOrder != null) delete extra.tabIndex;
+        const role = typeof extra.role === "string" && INTERACTIVE_ROLES.has(extra.role) ? extra.role : void 0;
+        if (role != null) delete extra.role;
+        const initialFocus = extra["data-himalaya-initial-focus"];
+        if (initialFocus !== void 0) {
+          delete extra["data-himalaya-initial-focus"];
+          if (extra.tabIndex === -1) delete extra.tabIndex;
+        }
+        tapActivator = /* @__PURE__ */ jsx8(
+          TapActivator,
+          {
+            label: typeof authored2 === "string" ? authored2 : void 0,
+            state,
+            tabIndex: authoredOrder,
+            role,
+            hint: a11yHint ?? void 0,
+            initialFocus
+          }
+        );
+        extra[TAP_GROUP_ATTR] = "";
+      }
+      return;
+    }
     if (extra.role == null) {
       extra.role = "button";
       if (typeof el.type !== "string") extra[SYNTHETIC_TAP_ROLE] = true;
@@ -36358,8 +36479,12 @@ function renderNodeInner(node, ctx) {
     delete extra[SYNTHETIC_TABINDEX];
     delete extra[AUTHORED_ROLE];
   }
-  let out2 = Object.keys(extra).length ? React7.cloneElement(el, extra) : el;
-  if (a11yHint) {
+  if (tapActivator) {
+    const finalStyle = extra.style ?? el.props.style;
+    if (!finalStyle?.position) extra.style = { ...finalStyle ?? {}, position: "relative" };
+  }
+  let out2 = tapActivator ? React7.cloneElement(el, extra, tapActivator, el.props.children) : Object.keys(extra).length ? React7.cloneElement(el, extra) : el;
+  if (a11yHint && !tapActivator) {
     out2 = /* @__PURE__ */ jsx8(A11yHintDescription, { hint: a11yHint, idBase: componentId, children: out2 });
   }
   const sd = node?.modifiers?.swipeDismiss ?? node?.modifiers?.swipe_dismiss;
@@ -37116,7 +37241,7 @@ function renderInner(node, ctx) {
     }
   }
 }
-var useIsomorphicLayoutEffect, ResponsiveGrid, SPLIT_EXPANDED_MIN_WIDTH, SPLIT_COLUMN_GAP, ResponsiveSplitView, ABSOLUTE_URL_RE, appearKeyframesInjected, pressStylesInjected, FOCUS_RING_CSS, focusStylesInjected, HLIST_CHILD_CSS, hListStylesInjected, listAnimateRuntimeInstalled, transitionKeyframesInjected, countUpRuntimeInjected, MEASURE_PREFIX, measureRuntimeInjected, revealRuntimeInjected, vectorAnimStylesInjected, scrollProgressRuntimeInjected, confettiRuntimeInjected, lottieRuntimeInjected, riveRuntimeInjected, gradientKeyframesInjected, parallaxRuntimeInjected, spinKeyframesInjected, marqueeKeyframesInjected, alignItems, zJustifyItems, hAlignItems, bodyFont, kids2, rowKidCtx, rowKids, staggeredKids, asTextL10n, asFinalTextL10n, asBoundText, useBoundString, InterpolatedTextView, txt, selectFragmentCase, fragmentValueHash, fragmentSlotContent, FragmentSlotNode, RichContentEditorNode, MediaFieldNode, WorkerSubtreeNode, RichContentNode, resolveItemDeep2, resolveSwipeActions, resolveModBindings, resolvedComponentId, directServiceBindings, withRootStyle, ReactiveDirectScalars, HiddenGate, KEYBOARD_INPUT_MODES, AUTOCAPITALIZE_VALUES, ENTER_KEY_HINTS, AUTOGROW_CEILING, EditableField, MenuNode, LoadMoreSentinel, FieldErrorNode, FormView, MediaSlotProvider, MEDIA_ITEM_BINDABLE, MediaPlayerView, VideoNode, PdfViewNode, WebViewNode, InteractivePicker, InteractiveDatePicker, InteractiveSearchField, InteractiveStepper, SYNTHETIC_TAP_ROLE, SYNTHETIC_TABINDEX, INFERRED_DECORATIVE, SELF_RENDERED_LEAF, ROLE_WHEN_NAMED, AUTHORED_ROLE, PENDING_RANGE, RANGE_ROLES, NODE_A11Y_ATTRS, INTERACTIVE_ROLES, ALWAYS_INTERACTIVE_COMPONENT_TYPES, controlNode, ToggleNode, SliderNode, SelectionControlNode, TabsNode, SegmentedControlNode, DisclosureGroupNode, GridNode, SplitViewNode, TextNode, ImageNode, ANIMATION_LEAF, LottieNode, RiveNode, AvatarNode, IconNode, ButtonNode, OtpInputNode, ProgressBarNode, ACTIVITY_DEFAULT_NAME, ActivityIndicatorNode, NATIVELY_TABBABLE, BottomSheetNode, PRESENTED_OVERLAY_ATTR, PopoverNode, ChipsInputNode, ChipNode, TableNode, GaugeRing, GaugeNode, RATING_METRICS, ratingMetrics, RatingNode, AvatarStripNode, CHART_STROKE_CYCLE, chartStrokeAt, chartBarCenter, ChartNode, donutSliceOpacity, DonutChartNode, LegendMarker, LegendNode, cellAlign, DataTableNode, voiceNoteState, voiceNoteDelivery, VOICE_NOTE_DEFAULT_BARS, clampBarCount, VoiceNoteNode, TimelineNode, WheelPickerNode, ColorPickerNode, FilterChipsNode, TILE_PX, MAX_MERCATOR_LAT, DEFAULT_TILE_MAX_ZOOM, CIRCLE_SEGMENTS, METRES_PER_DEG_LAT, MARKER_HIT_RADIUS, SHAPE_HIT_RADIUS, MapNode, CollapsingHeaderNode, UnsupportedOnSurface, CALENDAR_DATE_ONLY_RE, CAL_DEFAULT_MAX_DOTS, CAL_AGENDA_INITIAL_DAYS, CAL_AGENDA_PAGE_DAYS, CAL_DEFAULT_SNAP_MINUTES, CAL_UNASSIGNED_LANE_ID, MonthCalendarNode, TimeGridNode, AgendaNode, ARIA_ROLE, initialFocusScheduled, PRESENTED_SCOPE, focusRoots, A11yHintDescription, WebRenderer;
+var useIsomorphicLayoutEffect, ResponsiveGrid, SPLIT_EXPANDED_MIN_WIDTH, SPLIT_COLUMN_GAP, ResponsiveSplitView, ABSOLUTE_URL_RE, appearKeyframesInjected, pressStylesInjected, FOCUS_RING_CSS, focusStylesInjected, HLIST_CHILD_CSS, hListStylesInjected, listAnimateRuntimeInstalled, transitionKeyframesInjected, countUpRuntimeInjected, MEASURE_PREFIX, measureRuntimeInjected, revealRuntimeInjected, vectorAnimStylesInjected, scrollProgressRuntimeInjected, confettiRuntimeInjected, lottieRuntimeInjected, riveRuntimeInjected, gradientKeyframesInjected, parallaxRuntimeInjected, spinKeyframesInjected, marqueeKeyframesInjected, alignItems, zJustifyItems, hAlignItems, bodyFont, kids2, rowKidCtx, rowKids, staggeredKids, asTextL10n, asFinalTextL10n, asBoundText, useBoundString, InterpolatedTextView, txt, selectFragmentCase, fragmentValueHash, fragmentSlotContent, FragmentSlotNode, RichContentEditorNode, MediaFieldNode, WorkerSubtreeNode, RichContentNode, resolveItemDeep2, resolveSwipeActions, resolveModBindings, resolvedComponentId, directServiceBindings, withRootStyle, ReactiveDirectScalars, HiddenGate, KEYBOARD_INPUT_MODES, AUTOCAPITALIZE_VALUES, ENTER_KEY_HINTS, AUTOGROW_CEILING, EditableField, MenuNode, LoadMoreSentinel, FieldErrorNode, FormView, MediaSlotProvider, MEDIA_ITEM_BINDABLE, MediaPlayerView, VideoNode, PdfViewNode, WebViewNode, InteractivePicker, InteractiveDatePicker, InteractiveSearchField, InteractiveStepper, SYNTHETIC_TAP_ROLE, SYNTHETIC_TABINDEX, INFERRED_DECORATIVE, SELF_RENDERED_LEAF, ROLE_WHEN_NAMED, AUTHORED_ROLE, PENDING_RANGE, RANGE_ROLES, NODE_A11Y_ATTRS, INTERACTIVE_ROLES, ALWAYS_INTERACTIVE_COMPONENT_TYPES, TAP_ACTIVATOR_ATTR, TAP_GROUP_ATTR, VISUALLY_HIDDEN, NAME_SKIP_SELECTOR, activatorNameObservers, ACTIVATOR_STATE_ATTRS, controlNode, ToggleNode, SliderNode, SelectionControlNode, TabsNode, SegmentedControlNode, DisclosureGroupNode, GridNode, SplitViewNode, TextNode, ImageNode, ANIMATION_LEAF, LottieNode, RiveNode, AvatarNode, IconNode, ButtonNode, OtpInputNode, ProgressBarNode, ACTIVITY_DEFAULT_NAME, ActivityIndicatorNode, NATIVELY_TABBABLE, BottomSheetNode, PRESENTED_OVERLAY_ATTR, PopoverNode, ChipsInputNode, ChipNode, TableNode, GaugeRing, GaugeNode, RATING_METRICS, ratingMetrics, RatingNode, AvatarStripNode, CHART_STROKE_CYCLE, chartStrokeAt, chartBarCenter, ChartNode, donutSliceOpacity, DonutChartNode, LegendMarker, LegendNode, cellAlign, DataTableNode, voiceNoteState, voiceNoteDelivery, VOICE_NOTE_DEFAULT_BARS, clampBarCount, VoiceNoteNode, TimelineNode, WheelPickerNode, ColorPickerNode, FilterChipsNode, TILE_PX, MAX_MERCATOR_LAT, DEFAULT_TILE_MAX_ZOOM, CIRCLE_SEGMENTS, METRES_PER_DEG_LAT, MARKER_HIT_RADIUS, SHAPE_HIT_RADIUS, MapNode, CollapsingHeaderNode, UnsupportedOnSurface, CALENDAR_DATE_ONLY_RE, CAL_DEFAULT_MAX_DOTS, CAL_AGENDA_INITIAL_DAYS, CAL_AGENDA_PAGE_DAYS, CAL_DEFAULT_SNAP_MINUTES, CAL_UNASSIGNED_LANE_ID, MonthCalendarNode, TimeGridNode, AgendaNode, ARIA_ROLE, initialFocusScheduled, PRESENTED_SCOPE, focusRoots, A11yHintDescription, WebRenderer;
 var init_renderNode = __esm({
   "../../core/web-renderer/src/renderNode.tsx"() {
     "use strict";
@@ -37211,7 +37336,7 @@ var init_renderNode = __esm({
     ABSOLUTE_URL_RE = /^([a-zA-Z][a-zA-Z0-9+.-]*:|\/\/)/;
     appearKeyframesInjected = false;
     pressStylesInjected = false;
-    FOCUS_RING_CSS = ':where(button,a,[href],input,select,textarea,[role="button"],[tabindex]):focus-visible{outline:2px solid var(--himi-accent,#116DFF);outline-offset:2px;border-radius:4px}';
+    FOCUS_RING_CSS = ':where(button,a,[href],input,select,textarea,[role="button"],[tabindex]):focus-visible{outline:2px solid var(--himi-accent,#116DFF);outline-offset:2px;border-radius:4px}[data-himalaya-tap-group]:has(>[data-himalaya-tap-activator]:focus-visible){outline:2px solid var(--himi-accent,#116DFF);outline-offset:2px}';
     focusStylesInjected = false;
     HLIST_CHILD_CSS = "[data-himalaya-hlist]>*{flex:0 0 auto}";
     hListStylesInjected = false;
@@ -38923,6 +39048,7 @@ var init_renderNode = __esm({
       "menuitem",
       "option",
       "radio",
+      "searchbox",
       "slider",
       "spinbutton",
       "switch",
@@ -38952,6 +39078,23 @@ var init_renderNode = __esm({
       "SegmentedControl",
       "DisclosureGroup"
     ]);
+    TAP_ACTIVATOR_ATTR = "data-himalaya-tap-activator";
+    TAP_GROUP_ATTR = "data-himalaya-tap-group";
+    VISUALLY_HIDDEN = {
+      position: "absolute",
+      width: 1,
+      height: 1,
+      padding: 0,
+      margin: -1,
+      overflow: "hidden",
+      clip: "rect(0 0 0 0)",
+      clipPath: "inset(50%)",
+      whiteSpace: "nowrap",
+      border: 0
+    };
+    NAME_SKIP_SELECTOR = `[${TAP_ACTIVATOR_ATTR}],[aria-hidden="true"],[hidden],[style*="display: none"],button,a[href],input,select,textarea,` + [...INTERACTIVE_ROLES].map((r) => `[role="${r}"]`).join(",") + `,[tabindex]:not([tabindex="-1"])`;
+    activatorNameObservers = /* @__PURE__ */ new WeakMap();
+    ACTIVATOR_STATE_ATTRS = ["aria-valuetext", "aria-selected", "aria-disabled"];
     controlNode = (name, Inner) => withExtras(name, ({ props, ctx, wrap }) => Inner({ props, ctx, wrap, renderChild: (n) => renderNode(n, ctx) }));
     ToggleNode = controlNode("ToggleNode", A11ySwitch);
     SliderNode = controlNode("SliderNode", A11ySlider);
@@ -62406,21 +62549,21 @@ var init_preview_assets_generated = __esm({
   "../../packages/serve/src/preview-assets.generated.ts"() {
     init_preview_assets_format();
     PREVIEW_ASSET_MANIFEST = [
-      { key: "assets/index-CEgZpjAi.js", contentType: "application/javascript; charset=utf-8", offset: 8, length: 1181649, sha256: "c5f3f0ca309d185ac0f7d7fcde9da23cf10308699c09765d697ef8ed8be9dbdb" },
-      { key: "fonts/Roboto-LICENSE.txt", contentType: "application/octet-stream", offset: 1181657, length: 4610, sha256: "994062dd7af4186a739de55dd9e151c63b6301f8e2cbafc608d35c2e87da0cd2" },
-      { key: "fonts/Roboto-Variable.ttf", contentType: "font/ttf", offset: 1186267, length: 488584, sha256: "d7598e12c5dbef095ff8272cfc55da0250bd07fbdecbac8a530b9b277872a134" },
-      { key: "fonts/WixMadeforDisplay-Bold.ttf", contentType: "font/ttf", offset: 1674851, length: 90924, sha256: "ec4c7d63772d980d6e147b2df6215fd2737e4b04cebe0cf7e11dc695fb63cdcf" },
-      { key: "fonts/WixMadeforDisplay-ExtraBold.ttf", contentType: "font/ttf", offset: 1765775, length: 90984, sha256: "bf4c16a2774edd38a921edf3099469866cd74c094fd596f3fa4e81f54a04dfaa" },
-      { key: "fonts/WixMadeforDisplay-Medium.ttf", contentType: "font/ttf", offset: 1856759, length: 90980, sha256: "368faca44fb9f7207e4af784e94750b1ee59c1098b8689e0f4a918926f244fb5" },
-      { key: "fonts/WixMadeforDisplay-Regular.ttf", contentType: "font/ttf", offset: 1947739, length: 90872, sha256: "97ed8f1a6772abe26e3d8af5cecfc4b02faa94497d585b0398b5053b739a70c1" },
-      { key: "fonts/WixMadeforDisplay-SemiBold.ttf", contentType: "font/ttf", offset: 2038611, length: 90980, sha256: "642feab8a48ddf6c7a89d7c2a7c0edfa0e6e773f671287e460e222703563191e" },
-      { key: "fonts/WixMadeforText-Bold.ttf", contentType: "font/ttf", offset: 2129591, length: 108636, sha256: "37c179b4fefb63ea9637322b84583a2df53aa226c150294eea1675c14b1b8e29" },
-      { key: "fonts/WixMadeforText-ExtraBold.ttf", contentType: "font/ttf", offset: 2238227, length: 109084, sha256: "62e2fe4718129f36ecdb0ae4de385bd6b81ecc876146447167c6c140fad699a9" },
-      { key: "fonts/WixMadeforText-Medium.ttf", contentType: "font/ttf", offset: 2347311, length: 109048, sha256: "4ecf270136af928612c76fe4ebade91d8156975e5ea4c0cf9225501dd1788e02" },
-      { key: "fonts/WixMadeforText-Regular.ttf", contentType: "font/ttf", offset: 2456359, length: 107700, sha256: "dee56f09fd3efc127c1ea95557edc74110c1460a46287da36e0af25efd341ef5" },
-      { key: "fonts/WixMadeforText-SemiBold.ttf", contentType: "font/ttf", offset: 2564059, length: 88108, sha256: "dced97a77624bc5f8b1ae65850360908297f4588e09feb6f22792d29dc7e765b" },
-      { key: "index.html", contentType: "text/html; charset=utf-8", offset: 2652167, length: 4947, sha256: "4c0783bf65b94ef6193c32aaa03a367fdf11415c89edbe14840eda14fa5c0a17" },
-      { key: "t5-frame.html", contentType: "text/html; charset=utf-8", offset: 2657114, length: 17344, sha256: "d057298d75e7373e5e2c4d11b7d1bcbea88e03af555ba63d97641c78509c58e4" }
+      { key: "assets/index-CRDm5E9l.js", contentType: "application/javascript; charset=utf-8", offset: 8, length: 1184658, sha256: "e00b8e526ebcd4dd07db3a03ee7bb81e401575c162498b42bb9aca49d60a6918" },
+      { key: "fonts/Roboto-LICENSE.txt", contentType: "application/octet-stream", offset: 1184666, length: 4610, sha256: "994062dd7af4186a739de55dd9e151c63b6301f8e2cbafc608d35c2e87da0cd2" },
+      { key: "fonts/Roboto-Variable.ttf", contentType: "font/ttf", offset: 1189276, length: 488584, sha256: "d7598e12c5dbef095ff8272cfc55da0250bd07fbdecbac8a530b9b277872a134" },
+      { key: "fonts/WixMadeforDisplay-Bold.ttf", contentType: "font/ttf", offset: 1677860, length: 90924, sha256: "ec4c7d63772d980d6e147b2df6215fd2737e4b04cebe0cf7e11dc695fb63cdcf" },
+      { key: "fonts/WixMadeforDisplay-ExtraBold.ttf", contentType: "font/ttf", offset: 1768784, length: 90984, sha256: "bf4c16a2774edd38a921edf3099469866cd74c094fd596f3fa4e81f54a04dfaa" },
+      { key: "fonts/WixMadeforDisplay-Medium.ttf", contentType: "font/ttf", offset: 1859768, length: 90980, sha256: "368faca44fb9f7207e4af784e94750b1ee59c1098b8689e0f4a918926f244fb5" },
+      { key: "fonts/WixMadeforDisplay-Regular.ttf", contentType: "font/ttf", offset: 1950748, length: 90872, sha256: "97ed8f1a6772abe26e3d8af5cecfc4b02faa94497d585b0398b5053b739a70c1" },
+      { key: "fonts/WixMadeforDisplay-SemiBold.ttf", contentType: "font/ttf", offset: 2041620, length: 90980, sha256: "642feab8a48ddf6c7a89d7c2a7c0edfa0e6e773f671287e460e222703563191e" },
+      { key: "fonts/WixMadeforText-Bold.ttf", contentType: "font/ttf", offset: 2132600, length: 108636, sha256: "37c179b4fefb63ea9637322b84583a2df53aa226c150294eea1675c14b1b8e29" },
+      { key: "fonts/WixMadeforText-ExtraBold.ttf", contentType: "font/ttf", offset: 2241236, length: 109084, sha256: "62e2fe4718129f36ecdb0ae4de385bd6b81ecc876146447167c6c140fad699a9" },
+      { key: "fonts/WixMadeforText-Medium.ttf", contentType: "font/ttf", offset: 2350320, length: 109048, sha256: "4ecf270136af928612c76fe4ebade91d8156975e5ea4c0cf9225501dd1788e02" },
+      { key: "fonts/WixMadeforText-Regular.ttf", contentType: "font/ttf", offset: 2459368, length: 107700, sha256: "dee56f09fd3efc127c1ea95557edc74110c1460a46287da36e0af25efd341ef5" },
+      { key: "fonts/WixMadeforText-SemiBold.ttf", contentType: "font/ttf", offset: 2567068, length: 88108, sha256: "dced97a77624bc5f8b1ae65850360908297f4588e09feb6f22792d29dc7e765b" },
+      { key: "index.html", contentType: "text/html; charset=utf-8", offset: 2655176, length: 4947, sha256: "094afa56a8e94767674ee8fd7ca3290f67f64930f8e2c6cc874d6d101e35fd7d" },
+      { key: "t5-frame.html", contentType: "text/html; charset=utf-8", offset: 2660123, length: 17344, sha256: "d057298d75e7373e5e2c4d11b7d1bcbea88e03af555ba63d97641c78509c58e4" }
     ];
   }
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1208.0",
+  "version": "0.1210.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": [
@@ -67,5 +67,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "931e520dae97dfc8c6e9266c985badd9241bdfb86f20a6b06b2e79c9"
+  "falconPackageHash": "506ed6e4b472a5634a05b0f8e7709afbd371c022b52be11874929da7"
 }

package/templates/beauty-salon-owner/dev/index.ts

@@ -48568,7 +48568,7 @@ const SCREENS = runtimeSetting({
                                 "package": "himalaya",
                                 "type": "Text",
                                 "props": {
-                                  "text": "__HIMI_APP_NAME__",
+                                  "text": "$service:himiOwnerLiteHome.businessName",
                                   "style": "footnote",
                                   "color": "textSecondary",
                                   "collapseWhenEmpty": true
@@ -50706,7 +50706,8 @@ const SCREENS = runtimeSetting({
           "params": {
             "copy": "{\"ownerHome.acrossBusiness\":\"Across the salon\",\"ownerHome.briefCta\":\"Show me the chair\",\"ownerHome.briefSubtitle\":\"Who’s in the chair, where the gaps are, and which retail lines are down to the last tube.\",\"ownerHome.briefTitle\":\"Today at the salon\",\"ownerHome.errorLabel\":\"Couldn’t load today’s chair\",\"ownerHome.headerSubtitle\":\"Salon owner · today’s chair\",\"ownerHome.openManage\":\"Open the salon\",\"ownerHome.ordersDaily\":\"Retail sales · daily\",\"ownerHome.statAppointments\":\"Booked in\",\"ownerHome.statOrders\":\"Retail orders\",\"ownerHome.statPosts\":\"Salon notes\",\"ownerHome.statProducts\":\"Retail lines\",\"ownerHome.statRevenue\":\"Takings\",\"ownerHome.statSites\":\"Salons\",\"ownerHome.switchBusiness\":\"Switch salon\"}",
             "homeModules": "[{\"id\":\"attention\",\"label\":\"Needs attention\",\"dataSource\":\"owner-today\",\"emptyWhen\":[\"hideContent\"]},{\"id\":\"schedule\",\"label\":\"Up next\",\"dataSource\":\"owner-schedule\",\"emptyWhen\":[\"hideContent\"]},{\"id\":\"shortcuts\",\"label\":\"Quick actions\",\"dataSource\":\"owner-actions\"},{\"id\":\"metrics\",\"label\":\"Business overview\",\"dataSource\":\"dashboard\",\"emptyWhen\":[\"hideContent\"]},{\"id\":\"brief\",\"label\":\"Daily brief\",\"dataSource\":\"brief\"}]",
-            "enabledSources": "[\"products\",\"posts\",\"sites\",\"orders\",\"bookings\",\"members\",\"reviews\",\"reservations\"]"
+            "enabledSources": "[\"products\",\"posts\",\"sites\",\"orders\",\"bookings\",\"members\",\"reviews\",\"reservations\"]",
+            "businessName": "__HIMI_APP_NAME__"
           }
         }
       }
@@ -50775,7 +50776,7 @@ const SCREENS = runtimeSetting({
                                 "package": "himalaya",
                                 "type": "Text",
                                 "props": {
-                                  "text": "__HIMI_APP_NAME__",
+                                  "text": "$service:himiOwnerLiteManage.businessName",
                                   "style": "footnote",
                                   "color": "textSecondary",
                                   "collapseWhenEmpty": true
@@ -51946,7 +51947,8 @@ const SCREENS = runtimeSetting({
           "actionId": "tier5.himiOwnerLiteManage.load",
           "params": {
             "areas": "[{\"id\":\"store\",\"title\":\"Retail\",\"subtitle\":\"Products, inventory and sales\",\"groupId\":\"commerce\",\"group\":\"Commerce\",\"screenId\":\"himi_owner_lite_products\",\"icon\":\"bag\",\"metricKey\":\"products\",\"countLabel\":\"products\",\"createScreenId\":\"himi_owner_lite_product_new\",\"createLabel\":\"Create product\"},{\"id\":\"himi_owner_lite_orders\",\"title\":\"Retail orders\",\"subtitle\":\"Review and complete customer orders\",\"groupId\":\"commerce\",\"group\":\"Commerce\",\"screenId\":\"himi_owner_lite_orders\",\"icon\":\"cart\",\"metricKey\":\"orders\",\"countLabel\":\"orders\"},{\"id\":\"bookings\",\"title\":\"Treatments\",\"subtitle\":\"Services and your schedule\",\"groupId\":\"scheduling\",\"group\":\"Scheduling\",\"screenId\":\"himi_owner_lite_services\",\"icon\":\"calendar\",\"metricKey\":\"services\",\"countLabel\":\"services\"},{\"id\":\"himi_owner_lite_appointments\",\"title\":\"The chair\",\"subtitle\":\"Your upcoming appointments\",\"groupId\":\"scheduling\",\"group\":\"Scheduling\",\"screenId\":\"himi_owner_lite_appointments\",\"icon\":\"clock\",\"metricKey\":\"appointments\",\"countLabel\":\"appointments\"},{\"id\":\"blog\",\"title\":\"Salon notes\",\"subtitle\":\"Stories and publishing\",\"groupId\":\"content\",\"group\":\"Content\",\"screenId\":\"himi_owner_lite_posts\",\"icon\":\"newspaper\",\"metricKey\":\"posts\",\"countLabel\":\"posts\",\"createScreenId\":\"himi_owner_lite_post_new\",\"createLabel\":\"Write post\"},{\"id\":\"coupons\",\"title\":\"Coupons\",\"subtitle\":\"Offers, codes and usage\",\"groupId\":\"commerce\",\"group\":\"Commerce\",\"screenId\":\"himi_owner_lite_module_coupons\",\"icon\":\"tag\",\"metricKey\":\"module:coupons\",\"countLabel\":\"coupons\"},{\"id\":\"invoices\",\"title\":\"Invoices\",\"subtitle\":\"Customers, balances and payment status\",\"groupId\":\"commerce\",\"group\":\"Commerce\",\"screenId\":\"himi_owner_lite_module_invoices\",\"icon\":\"document\",\"metricKey\":\"module:invoices\",\"countLabel\":\"invoices\"},{\"id\":\"giftCards\",\"title\":\"Gift cards\",\"subtitle\":\"Balances, recipients and expiration\",\"groupId\":\"commerce\",\"group\":\"Commerce\",\"screenId\":\"himi_owner_lite_module_giftCards\",\"icon\":\"ticket\",\"metricKey\":\"module:giftCards\",\"countLabel\":\"gift cards\"},{\"id\":\"contacts\",\"title\":\"Contacts\",\"subtitle\":\"Your customer relationships\",\"groupId\":\"people-and-community\",\"group\":\"People and community\",\"screenId\":\"himi_owner_lite_module_contacts\",\"icon\":\"person\",\"metricKey\":\"module:contacts\",\"countLabel\":\"contacts\"},{\"id\":\"members\",\"title\":\"Members\",\"subtitle\":\"Membership access and profiles\",\"groupId\":\"people-and-community\",\"group\":\"People and community\",\"screenId\":\"himi_owner_lite_module_members\",\"icon\":\"person\",\"metricKey\":\"module:members\",\"countLabel\":\"members\"},{\"id\":\"groups\",\"title\":\"Groups\",\"subtitle\":\"Communities and conversations\",\"groupId\":\"people-and-community\",\"group\":\"People and community\",\"screenId\":\"himi_owner_lite_module_groups\",\"icon\":\"person\",\"metricKey\":\"module:groups\",\"countLabel\":\"groups\"},{\"id\":\"reviews\",\"title\":\"Reviews\",\"subtitle\":\"Published and pending customer feedback\",\"groupId\":\"people-and-community\",\"group\":\"People and community\",\"screenId\":\"himi_owner_lite_module_reviews\",\"icon\":\"star\",\"metricKey\":\"module:reviews\",\"countLabel\":\"reviews\"},{\"id\":\"plans\",\"title\":\"Plans\",\"subtitle\":\"Pricing, benefits and visibility\",\"groupId\":\"membership-and-learning\",\"group\":\"Membership and learning\",\"screenId\":\"himi_owner_lite_module_plans\",\"icon\":\"bookmark\",\"metricKey\":\"module:plans\",\"countLabel\":\"plans\"},{\"id\":\"subscriptions\",\"title\":\"Subscriptions\",\"subtitle\":\"Member plans and subscription status\",\"groupId\":\"membership-and-learning\",\"group\":\"Membership and learning\",\"screenId\":\"himi_owner_lite_module_subscriptions\",\"icon\":\"bookmark\",\"metricKey\":\"module:subscriptions\",\"countLabel\":\"subscriptions\"},{\"id\":\"programs\",\"title\":\"Programs\",\"subtitle\":\"Learning experiences and participation\",\"groupId\":\"membership-and-learning\",\"group\":\"Membership and learning\",\"screenId\":\"himi_owner_lite_module_programs\",\"icon\":\"play\",\"metricKey\":\"module:programs\",\"countLabel\":\"programs\"},{\"id\":\"badges\",\"title\":\"Badges\",\"subtitle\":\"Recognition, access and member badges\",\"groupId\":\"membership-and-learning\",\"group\":\"Membership and learning\",\"screenId\":\"himi_owner_lite_module_badges\",\"icon\":\"star\",\"metricKey\":\"module:badges\",\"countLabel\":\"badges\"},{\"id\":\"reservations\",\"title\":\"Reservations\",\"subtitle\":\"Guests, tables and arrival times\",\"groupId\":\"scheduling\",\"group\":\"Scheduling\",\"screenId\":\"himi_owner_lite_module_reservations\",\"icon\":\"calendar\",\"metricKey\":\"module:reservations\",\"countLabel\":\"reservations\"},{\"id\":\"forms\",\"title\":\"Forms\",\"subtitle\":\"Forms and their configuration\",\"groupId\":\"content\",\"group\":\"Content\",\"screenId\":\"himi_owner_lite_module_forms\",\"icon\":\"document\",\"metricKey\":\"module:forms\",\"countLabel\":\"forms\"},{\"id\":\"portfolio\",\"title\":\"Portfolio\",\"subtitle\":\"Projects, stories and galleries\",\"groupId\":\"content\",\"group\":\"Content\",\"screenId\":\"himi_owner_lite_module_portfolio\",\"icon\":\"image\",\"metricKey\":\"module:portfolio\",\"countLabel\":\"portfolio\"},{\"id\":\"donationCampaigns\",\"title\":\"Donation campaigns\",\"subtitle\":\"Campaign goals, status and fundraising\",\"groupId\":\"content\",\"group\":\"Content\",\"screenId\":\"himi_owner_lite_module_donationCampaigns\",\"icon\":\"heart\",\"metricKey\":\"module:donationCampaigns\",\"countLabel\":\"donation campaigns\"}]",
-            "copy": "{\"ownerManage.blogLabel\":\"Salon notes\",\"ownerManage.bookingsLabel\":\"Treatments\",\"ownerManage.storeLabel\":\"Retail\",\"ownerManage.title\":\"Salon\"}"
+            "copy": "{\"ownerManage.blogLabel\":\"Salon notes\",\"ownerManage.bookingsLabel\":\"Treatments\",\"ownerManage.storeLabel\":\"Retail\",\"ownerManage.title\":\"Salon\"}",
+            "businessName": "__HIMI_APP_NAME__"
           }
         }
       }
@@ -52065,7 +52067,7 @@ const SCREENS = runtimeSetting({
                                 "package": "himalaya",
                                 "type": "Text",
                                 "props": {
-                                  "text": "__HIMI_APP_NAME__",
+                                  "text": "$service:himiOwnerLiteAccount.businessName",
                                   "style": "bodyEmphasis",
                                   "maxLines": 1
                                 }
@@ -52328,6 +52330,7 @@ const SCREENS = runtimeSetting({
             "supportUrl": "https://www.wix.com/support",
             "privacyUrl": "https://www.wix.com/about/privacy",
             "termsUrl": "https://www.wix.com/about/terms-of-use",
+            "businessName": "__HIMI_APP_NAME__",
             "copy": "{\"ownerAccount.roleValue\":\"Salon owner\",\"ownerAccount.subtitle\":\"Salon owner\"}"
           }
         }
@@ -52875,7 +52878,10 @@ const SCREENS = runtimeSetting({
         },
         "fillMaxWidth": true,
         "onAppear": {
-          "actionId": "tier5.drawer.syncActive"
+          "actionId": "tier5.drawer.refresh",
+          "params": {
+            "businessName": "__HIMI_APP_NAME__"
+          }
         }
       }
     },
@@ -61846,10 +61852,10 @@ const SCREENS = runtimeSetting({
                                 },
                                 "fillMaxWidth": true,
                                 "onTap": {
-                                  "actionId": "himi.open",
+                                  "actionId": "tier5.himiOwnerLiteSites.pick",
                                   "params": {
-                                    "screenId": "himi_owner_lite_home",
-                                    "business": "$item.id"
+                                    "id": "$item.id",
+                                    "name": "$item.name"
                                   }
                                 },
                                 "pressFeedback": "scale",
@@ -61946,7 +61952,6 @@ const SCREENS = runtimeSetting({
       "contentType": "application/javascript+ts-bundle",
       "declaredCapabilities": [
         "wix_api",
-        "wix_platform",
         "local_database"
       ],
       "minBinaryVersion": "0.1.0",
@@ -62407,10 +62412,10 @@ const SCREENS = runtimeSetting({
                                 },
                                 "fillMaxWidth": true,
                                 "onTap": {
-                                  "actionId": "himi.open",
+                                  "actionId": "tier5.himiOwnerLiteOverview.pick",
                                   "params": {
-                                    "screenId": "himi_owner_lite_home",
-                                    "business": "$item.id"
+                                    "id": "$item.id",
+                                    "name": "$item.name"
                                   }
                                 },
                                 "pressFeedback": "scale",

package/templates/beauty-salon-owner/tier5-src/_shared/himi-text.ts

@@ -0,0 +1,24 @@
+// Shared display-text helpers for himi cards: trim catalog artifacts from titles and
+// derive up-to-two-letter placeholder initials so same-first-letter lists still vary.
+
+/** Trim trailing artifact markers (stray asterisks / footnote daggers) and whitespace
+ *  that leak from test/seed catalogs, without touching interior punctuation. Falls back
+ *  to the original when trimming would empty the string. */
+export function cleanTitle(value?: string): string {
+  const raw = (value ?? "").trim();
+  const cleaned = raw.replace(/[\s*†‡]+$/u, "").trim();
+  return cleaned || raw;
+}
+
+/** Up to two significant initials for a placeholder avatar. Two-plus words → first
+ *  letter of the first two; a single word → its first two alphanumerics. Keeps a list
+ *  of similar names (e.g. many "Booking…") from collapsing to one identical glyph. */
+export function initials(value?: string): string {
+  const words = (value ?? "").trim().split(/\s+/).filter(Boolean);
+  if (words.length === 0) return "#";
+  if (words.length === 1) {
+    const alnum = words[0].replace(/[^\p{L}\p{N}]/gu, "");
+    return (alnum.slice(0, 2) || "#").toUpperCase();
+  }
+  return ((words[0][0] ?? "") + (words[1][0] ?? "")).toUpperCase();
+}

package/templates/beauty-salon-owner/tier5-src/_shared/owner-account.ts

@@ -3,6 +3,9 @@
 
 export interface AccountState {
   status: "loading" | "ready";
+  /** The business the "Business" row names: the one picked on Sites, else the
+   *  build-time fallback (see `owner-selected-site.ts`). */
+  businessName: string;
   /** "Name · email", the email alone, or "" (the line collapses). */
   ownerLine: string;
   /** "Version 1.2.0 (34)", or "" when the host cannot say. */
@@ -36,6 +39,7 @@ export function shapeAccount(s: Partial<AccountState>): AccountState {
   const supportUrl = safeUrl(s.supportUrl), privacyUrl = safeUrl(s.privacyUrl), termsUrl = safeUrl(s.termsUrl);
   return {
     status: s.status ?? "loading",
+    businessName: s.businessName ?? "",
     ownerLine: s.ownerLine ?? "",
     versionLine: s.versionLine ?? "",
     error: s.error ?? "",

package/templates/beauty-salon-owner/tier5-src/_shared/owner-selected-site.ts

@@ -0,0 +1,103 @@
+// The business the owner is managing RIGHT NOW, shared by every __HIMI_APP_NAME__ worker.
+//
+// Home, Manage, Account and the drawer used to name the business from the build-time
+// `provisioning.json` (`identity.businessName`), so after picking another site on the
+// Sites list the chrome still named the provisioning one — three different names for
+// "the current business" in one session, none of them the site actually picked.
+//
+// The picker (`owner-site-pick.ts`) is the one place that knows both the id and the
+// display name of the business being switched to, so it records them here; every
+// other worker reads them back. The channel is `himalaya.storage` — the app-scoped KV
+// every worker of the app shares on every host (UserDefaults / SharedPreferences / one
+// localStorage namespace) and that needs no capability.
+//
+// ONE key, not one per owner: the host only tells a worker who the owner is once a
+// business is scoped, so the picker (which runs before that) and the screens after it
+// would otherwise land on different keys. The owner is recorded INSIDE the entry
+// instead, and an entry written for a different owner is never shown.
+//
+// The build-time name is only ever the cold-start fallback, passed in by the
+// descriptor: a worker never hardcodes it.
+
+import { initials } from "./himi-text.js";
+
+type StorageLike = { getItem(key: string): string | null; setItem(key: string, value: string): void };
+type Host = typeof globalThis & { himalaya?: { storage?: StorageLike; input?: Record<string, unknown> } };
+
+export interface SelectedSite {
+  id: string;
+  name: string;
+}
+
+const KEY = "himi.ownerLite.selectedSite.v1";
+
+function host(): Host["himalaya"] {
+  return (globalThis as Host).himalaya;
+}
+
+function inputString(key: string): string {
+  const v = host()?.input?.[key];
+  return typeof v === "string" && v !== "default" ? v.trim() : "";
+}
+
+/** The business the owner last picked, or null when none has been picked, the host
+ *  has no storage, or the entry does not apply to this worker. Never throws. */
+export function readSelectedSite(): SelectedSite | null {
+  try {
+    const raw = host()?.storage?.getItem(KEY);
+    if (!raw) return null;
+    const parsed = JSON.parse(raw) as Partial<SelectedSite> & { account?: unknown };
+    const id = typeof parsed?.id === "string" ? parsed.id.trim() : "";
+    const name = typeof parsed?.name === "string" ? parsed.name.trim() : "";
+    if (!id || !name) return null;
+    // Another owner's pick on a shared device is never this owner's business. Fail
+    // CLOSED: an owner-tagged entry is shown only to a worker that knows it IS that
+    // owner. A worker that cannot tell who the owner is (the account-level flow before
+    // a business is scoped, or a host that cannot supply the identity) gets the
+    // fallback, never a name that may be another owner's.
+    const account = typeof parsed.account === "string" ? parsed.account : "";
+    const me = inputString("__himiPreferenceAccount");
+    if (account && account !== me) return null;
+    // An entry the picker wrote before the host knew the owner is CLAIMED by the first
+    // worker that does know it, so from then on no other owner on the device reads it.
+    if (!account && me) host()?.storage?.setItem(KEY, JSON.stringify({ id, name, account: me }));
+    // A screen opened FOR a specific business (a deep link or push carrying
+    // `business`) names that business's data; a name recorded for another one would
+    // sit over the wrong numbers, so it falls back instead.
+    const opened = inputString("business");
+    if (opened && opened !== id) return null;
+    return { id, name };
+  } catch {
+    return null; // a corrupt entry reads as "nothing picked", never as a crash
+  }
+}
+
+/** Record the business the owner just picked. Best-effort: a host without storage
+ *  simply keeps showing the fallback. */
+export function rememberSelectedSite(site: SelectedSite): void {
+  const id = site.id.trim();
+  const name = site.name.trim();
+  if (!id || !name) return;
+  const account = inputString("__himiPreferenceAccount");
+  try {
+    host()?.storage?.setItem(KEY, JSON.stringify(account ? { id, name, account } : { id, name }));
+  } catch {
+    // Quota / storage disabled: the chrome falls back to the build-time name.
+  }
+}
+
+/** Display name for "the current business": the picked one, else `fallback`. */
+export function selectedSiteName(fallback: string): string {
+  return readSelectedSite()?.name || fallback;
+}
+
+/** Badge letters for a business name ("Riverbend Market" → "RM"); Unicode-aware. */
+export function siteInitials(name: string): string {
+  return initials(name);
+}
+
+/** The fallback name a descriptor passes in its `onAppear` params (`businessName`). */
+export function fallbackNameFrom(arg: unknown, current = ""): string {
+  const v = (arg as { businessName?: unknown } | undefined)?.businessName;
+  return typeof v === "string" && v.trim() ? v.trim() : current;
+}