@wix/himalaya-cli 0.1589.0 → 0.1590.0

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/members-v1/src/index.d.ts

@@ -200,8 +200,9 @@ export interface WixActivityCountersQueryResponse {
     activityCounters?: WixActivityCounter[];
 }
 export interface WixFollowCounts {
-    followers: number;
-    following: number;
+    /** `null` when Wix returned no total for this direction: unavailable, never an assumed 0. */
+    followers: number | null;
+    following: number | null;
 }
 export interface WixMemberConnection {
     memberId?: string;
@@ -212,9 +213,12 @@ export interface WixMyConnectionsResponse {
     connectedMembers?: WixMemberConnection[];
 }
 /** Followers / following totals for a member — POST
- *  /members/v1/activity-counters/query. Requires explicit nonnegative safe integer
- *  totals for this member's Followers-app entry. Missing/invalid totals reject,
- *  as do permission failures; callers should hide unavailable counts, never invent zero. */
+ *  /members/v1/activity-counters/query. Wix keeps ONE counter per direction and creates it on the
+ *  first change (live, amit1: a followed member's entry holds only `followerCount`, the follower's
+ *  only `followingCount`), so each direction is reported on its own: an explicit nonnegative safe
+ *  integer, or `null` when Wix returned none. A counter that is present but malformed makes the
+ *  whole answer untrusted and rejects, as does an entry with neither counter or a permission
+ *  failure. Callers hide an unavailable counter; a missing one is never shown as zero. */
 export declare function getFollowCounts(memberId: string, options?: WixCallOptions): Promise<WixFollowCounts>;
 /** Whether the signed-in member follows `targetId` — POST
  *  /members/v3/followers/my/connections. Returns false on any miss. May 403 →

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-members.mjs

@@ -87,15 +87,16 @@ async function getFollowCounts(memberId, options) {
   const entry = (res.activityCounters ?? []).find((c) => c.appId === MEMBERS_FOLLOWERS_APP_ID && c.memberId === memberId);
   const counters = entry?.counters;
   const value = (key) => Array.isArray(counters) ? counters.find((counter) => counter?.key === key)?.count : counters?.[key]?.count;
-  const followers = value("followerCount");
-  const following = value("followingCount");
-  if (typeof followers !== "number" || !Number.isSafeInteger(followers) || followers < 0 || typeof following !== "number" || !Number.isSafeInteger(following) || following < 0) {
-    throw new Error("getFollowCounts: explicit member totals are unavailable");
-  }
-  return {
-    followers,
-    following
+  const total = (key) => {
+    const count = value(key);
+    if (count === void 0 || count === null) return null;
+    if (typeof count !== "number" || !Number.isSafeInteger(count) || count < 0) throw new Error("getFollowCounts: a member total is malformed");
+    return count;
   };
+  const followers = total("followerCount");
+  const following = total("followingCount");
+  if (followers === null && following === null) throw new Error("getFollowCounts: explicit member totals are unavailable");
+  return { followers, following };
 }
 async function isFollowingMember(targetId) {
   if (!targetId) throw new Error("isFollowingMember: targetId is required");

package/dist/cli.mjs

@@ -27515,7 +27515,6 @@ function resolveIdiom(tokens2, ctx = {}) {
 var IDIOM_CONTEXTS, UNSAFE_KEYS;
 var init_idiom = __esm({
   "../../core/ts/src/idiom.ts"() {
-    "use strict";
     init_define_HHP_CATALOG();
     IDIOM_CONTEXTS = {
       ios: { native: ["ios"] },
@@ -142292,6 +142291,7 @@ async function buildFromLoaded(preloaded, dest, opts = {}) {
   const renders = [];
   const baked = [];
   const linkable = /* @__PURE__ */ new Set();
+  let bakedAppConfig;
   const lintTokens = collect2?.lint || collect2?.render ? readTokensForLint(preloaded) : void 0;
   const renderTokens = lintTokens && withServedFontFaces(lintTokens, preloaded.dir);
   const allowedComponents = await loadAllowedComponents(preloaded.dir);
@@ -143021,7 +143021,11 @@ async function buildFromLoaded(preloaded, dest, opts = {}) {
       await store.putAppConfig(app, text13);
       appConfigHash = sha2563(text13);
       minBinaryVersion = maximumBinaryVersion(minBinaryVersion, navBundleMinBinaryVersion(text13));
-      if (collect2?.descriptors) for (const id of linkableScreenIdsFrom(text13)) linkable.add(id);
+      if (collect2?.descriptors) {
+        for (const id of linkableScreenIdsFrom(text13)) linkable.add(id);
+        const parsed = JSON.parse(text13);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) bakedAppConfig = parsed;
+      }
     }
     const ahRes = await devFetch(`${base}/v1/action-handlers/${encodeURIComponent(app)}`, { headers: { "X-Himalaya-App": app } });
     if (ahRes.ok) {
@@ -143163,7 +143167,7 @@ async function buildFromLoaded(preloaded, dest, opts = {}) {
     capabilityUsage,
     ...collect2?.lint ? { lint, workers } : {},
     ...collect2?.render ? { renders } : {},
-    ...collect2?.descriptors ? { descriptors: baked, linkableScreenIds: [...linkable] } : {},
+    ...collect2?.descriptors ? { descriptors: baked, linkableScreenIds: [...linkable], ...bakedAppConfig ? { appConfig: bakedAppConfig } : {} } : {},
     ...typeof preloaded.meta.homeScreenId === "string" && preloaded.meta.homeScreenId ? { homeScreenId: preloaded.meta.homeScreenId } : {},
     ...renderTokens !== void 0 ? { tokens: renderTokens } : {},
     ...preloaded.meta.surfaces ? { surfaceNav: preloaded.meta.surfaces } : {},
@@ -194790,6 +194794,25 @@ var init_business_address = __esm({
   }
 });
 
+// ../../core/dev-server/tier5-bundles-src/_shared/app-locale.ts
+function isIanaTimeZone(value2) {
+  if (typeof value2 !== "string" || !/^(?:UTC|[A-Za-z]+(?:\/[A-Za-z0-9_+-]+)+)$/.test(value2)) return false;
+  if (typeof Intl === "object" && typeof Intl.DateTimeFormat === "function") {
+    try {
+      new Intl.DateTimeFormat("en-US", { timeZone: value2 });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  return false;
+}
+var init_app_locale = __esm({
+  "../../core/dev-server/tier5-bundles-src/_shared/app-locale.ts"() {
+    init_define_HHP_CATALOG();
+  }
+});
+
 // ../../stdlib/wix-sdk/rich-content/src/display.ts
 function trimAscii(s2) {
   return s2.replace(/^[\t\n\v\f\r ]+|[\t\n\v\f\r ]+$/g, "");
@@ -195570,10 +195593,12 @@ async function collectOneApp(input, deps = {}) {
   });
   const wantsContact = definitions2.some((id) => CONTACT_SECTIONS.has(id));
   const wantsLoyalty = definitions2.some((id) => LOYALTY_SECTIONS.has(id));
-  if (wantsContact || wantsLoyalty) {
-    const requiredVisitor = internalBusinessRead ? await visitorAuthorization("enrichment_session") : void 0;
+  const wantsTimeZone = definitions2.some((id) => SERVICES_SECTIONS.has(id));
+  if (wantsContact || wantsLoyalty || wantsTimeZone) {
+    const optionalOnly = !wantsContact && !wantsLoyalty;
+    const requiredVisitor = internalBusinessRead && !optionalOnly ? await visitorAuthorization("enrichment_session") : void 0;
     try {
-      const authorization2 = requiredVisitor ?? await visitorAuthorization("business_contact_session");
+      const authorization2 = requiredVisitor ?? await visitorAuthorization(internalBusinessRead ? "enrichment_session" : "business_contact_session");
       const properties = await request(PUBLIC_CONTACT, "business_contact", void 0, { authorization: authorization2, siteScoped: false });
       if (!isObject2(properties) || typeof properties.metaSiteId !== "string" || !isObject2(properties.properties)) throw invalidResponse("business_contact");
       if (properties.metaSiteId.toLowerCase() !== input.metaSiteId.toLowerCase()) {
@@ -195585,8 +195610,14 @@ async function collectOneApp(input, deps = {}) {
         if (typeof currency === "string" && /^[A-Z]{3}$/.test(currency)) businessContext.paymentCurrency = currency;
         else contextWarnings.push({ code: "loyalty_currency_unavailable", message: "Payment currency is unverified. Keep currency-based Loyalty earning details unresolved." });
       }
+      if (wantsTimeZone) {
+        const zone = properties.properties.timeZone;
+        if (isIanaTimeZone(zone)) businessContext.timeZone = zone;
+        else contextWarnings.push({ code: "business_time_zone_unavailable", message: TIME_ZONE_UNAVAILABLE });
+      }
     } catch (error) {
-      if (!(error instanceof OneAppError) || ![
+      if (!(error instanceof OneAppError)) throw error;
+      if (!optionalOnly && ![
         "source_not_found",
         "source_request_failed",
         "source_timeout",
@@ -195602,6 +195633,7 @@ async function collectOneApp(input, deps = {}) {
         failureCode: error.code,
         message: "Payment currency is unavailable. Keep currency-based Loyalty earning details unresolved."
       });
+      if (wantsTimeZone) contextWarnings.push({ code: "business_time_zone_unavailable", failureCode: error.code, message: TIME_ZONE_UNAVAILABLE });
     }
   }
   if (Object.values(buildSourceGraph(rawStructure).sections).some((section3) => {
@@ -195721,12 +195753,13 @@ async function collectOneApp(input, deps = {}) {
     ]
   };
 }
-var MIDDLEWARE, BUSINESS, TOKEN_INFO, IS_PERMITTED, INTERNAL_PERMISSION, VISITOR_SESSION, PUBLIC_CONTACT, PUBLIC_MEMBERS, MEMBER_WIDGETS, LOYALTY_SECTIONS, CONTACT_SECTIONS, MAX_RESPONSE_BYTES, TIMEOUT_MS3, UUID, LIFECYCLE_FIELDS;
+var MIDDLEWARE, BUSINESS, TOKEN_INFO, IS_PERMITTED, INTERNAL_PERMISSION, VISITOR_SESSION, PUBLIC_CONTACT, PUBLIC_MEMBERS, MEMBER_WIDGETS, LOYALTY_SECTIONS, CONTACT_SECTIONS, SERVICES_SECTIONS, TIME_ZONE_UNAVAILABLE, MAX_RESPONSE_BYTES, TIMEOUT_MS3, UUID, LIFECYCLE_FIELDS;
 var init_collect = __esm({
   "src/one-app/collect.ts"() {
     init_define_HHP_CATALOG();
     init_locale();
     init_business_address();
+    init_app_locale();
     init_errors2();
     init_graph();
     init_pages();
@@ -195741,6 +195774,8 @@ var init_collect = __esm({
     MEMBER_WIDGETS = /* @__PURE__ */ new Set(["platform_general_members_section", "platform_general_members_section_bp"]);
     LOYALTY_SECTIONS = /* @__PURE__ */ new Set(["loyalty_offering_section", "loyalty_status_section"]);
     CONTACT_SECTIONS = /* @__PURE__ */ new Set(["platform_general_contact_section", "platform_general_contact_section_bp"]);
+    SERVICES_SECTIONS = /* @__PURE__ */ new Set(["bookings_services_list_section"]);
+    TIME_ZONE_UNAVAILABLE = "Business time zone is unverified. Leave `businessTimeZone` out of provisioning: a course whose session times carry no offset then shows no Ended label, and no zone is guessed.";
     MAX_RESPONSE_BYTES = 8e6;
     TIMEOUT_MS3 = 3e4;
     UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
@@ -198660,7 +198695,8 @@ function mergeCustomerOwned(committed, overlay) {
     "site",
     "goals",
     "businessContact",
-    "loyalty"
+    "loyalty",
+    "businessTimeZone"
   ];
   const customer = {};
   for (const key3 of CUSTOMER_OWNED) {
@@ -198683,13 +198719,16 @@ function mergeCustomerOwned(committed, overlay) {
     if (typeof value2 === "string" && value2.trim() === "") delete overlayIdentity[key3];
   }
   if (customer.identity !== void 0) customer.identity = overlayIdentity;
-  const { goals: _shellGoals, businessContact: previousContact, loyalty: previousLoyalty, ...shell } = committed;
+  const { goals: _shellGoals, businessContact: previousContact, loyalty: previousLoyalty, businessTimeZone: previousZone, ...shell } = committed;
   if (customer.businessContact === void 0 && sameKnownSite(committed, overlay)) {
     customer.businessContact = previousContact;
   }
   if (customer.loyalty === void 0 && sameKnownSite(committed, overlay)) {
     customer.loyalty = previousLoyalty;
   }
+  if (customer.businessTimeZone === void 0 && sameKnownSite(committed, overlay)) {
+    customer.businessTimeZone = previousZone;
+  }
   return deepMerge4(shell, customer);
 }
 function carryOverGoals(previousOverlayJson, overlay) {
@@ -198720,14 +198759,15 @@ function buildMergedContract(options) {
   const committed = JSON.parse(readFileSync134(committedPath, "utf8"));
   const previousPath = join127(appDir3, LOCAL_CONTRACT_REL);
   let evidenceOverlay = overlay;
-  if ((overlay.businessContact === void 0 || overlay.loyalty === void 0) && existsSync115(previousPath)) {
+  if ((overlay.businessContact === void 0 || overlay.loyalty === void 0 || overlay.businessTimeZone === void 0) && existsSync115(previousPath)) {
     try {
       const previous = JSON.parse(readFileSync134(previousPath, "utf8"));
       if (previous && typeof previous === "object" && !Array.isArray(previous) && sameKnownSite(previous, overlay)) {
         evidenceOverlay = {
           ...overlay,
           ...overlay.businessContact === void 0 ? { businessContact: previous.businessContact } : {},
-          ...overlay.loyalty === void 0 ? { loyalty: previous.loyalty } : {}
+          ...overlay.loyalty === void 0 ? { loyalty: previous.loyalty } : {},
+          ...overlay.businessTimeZone === void 0 ? { businessTimeZone: previous.businessTimeZone } : {}
         };
       }
     } catch {
@@ -198930,6 +198970,8 @@ async function applyOverlays(input) {
     else if (!sameKnownSite(cur, overlay)) delete merged.businessContact;
     if (overlay.loyalty !== void 0) merged.loyalty = overlay.loyalty;
     else if (!sameKnownSite(cur, overlay)) delete merged.loyalty;
+    if (overlay.businessTimeZone !== void 0) merged.businessTimeZone = overlay.businessTimeZone;
+    else if (!sameKnownSite(cur, overlay)) delete merged.businessTimeZone;
     packageFaq = merged.faq;
     packageGalleries = merged.galleries;
     syncViewNames(cur.site, merged.site);

package/guides/one-app-to-himi-app.md

@@ -232,10 +232,14 @@ private/all-members total.
 Member-profile follower/following totals are separate runtime reads, not the
 directory total or this collected snapshot. The shared member-detail worker keeps
 the public profile readable when its activity counters are forbidden, missing or
-invalid, and hides the count line. `getFollowCounts` accepts only explicit
-nonnegative safe integers from the requested member's Followers-app entry,
-reading the source's keyed counter array (and compatible older map responses);
-unavailable totals reject rather than becoming zero. A real zero remains visible.
+invalid, and hides the count line. Wix keeps one counter per direction and creates
+it on the first change, so a member can have only `followerCount` or only
+`followingCount`: `getFollowCounts` reports each direction on its own, as an
+explicit nonnegative safe integer from the requested member's Followers-app entry
+or `null` when Wix returned none, reading the source's keyed counter array (and
+compatible older map responses). A missing counter is hidden and never becomes
+zero; a real zero remains visible; a malformed counter, an entry with neither
+counter or a permission failure rejects and hides the line.
 Following a member does not turn an unknown aggregate into a fabricated total.
 Late Follow results cannot restore counters from an earlier load, identity or site.
 Directory search metadata, activity and viewed-member program progress require
@@ -394,6 +398,16 @@ Apply these interpretation rules:
   conversion details; locale, device settings and permission failures are not currency
   evidence. Require recorded live Visitor catalog and signed-in own-account responses
   for acceptance; mocked member balances prove implementation behavior only.
+- **Bookings: bake the business time zone.** A course's session times (`firstSessionStart`,
+  `lastSessionEnd`) may arrive without an offset, and only the business's own zone places them
+  (the "Ended" label). A `bookings_services_list_section` collection reads the same public,
+  site-bound Visitor properties and allowlists `businessContext.timeZone`, kept only when it is an
+  IANA zone ("Asia/Jerusalem"). When verified, bake it into Branded provisioning
+  `businessTimeZone` (the source value, never an example, a locale guess or the device zone). The
+  worker cannot read it itself: `site-properties/v4` is owner-scoped. Omit an unverified zone: the
+  list then shows no Ended label for a time without an offset, which is correct, and a
+  `business_time_zone_unavailable` warning says so. A re-apply keeps the zone for the same site and
+  drops it for another.
 - **Native navigation is the migration target.** Use the shell's native top bar
   and, for bottom-tab navigation, `navigation.tabBar.presentation: "native"`.
   Do not recreate the source Detailed header, call `detailedHeader`, or insert a

package/guides/sdk-reference.json

@@ -23911,7 +23911,7 @@
         "name": "WixFollowCounts",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixFollowCounts {\n  followers: number;\n  following: number;\n}"
+        "decl": "export interface WixFollowCounts {\n  /** `null` when Wix returned no total for this direction: unavailable, never an assumed 0. */\n  followers: number | null;\n  following: number | null;\n}"
       },
       {
         "name": "WixMemberConnection",
@@ -23928,7 +23928,7 @@
       {
         "name": "getFollowCounts",
         "kind": "function",
-        "jsdoc": "/** Followers / following totals for a member — POST\n *  /members/v1/activity-counters/query. Requires explicit nonnegative safe integer\n *  totals for this member's Followers-app entry. Missing/invalid totals reject,\n *  as do permission failures; callers should hide unavailable counts, never invent zero. */",
+        "jsdoc": "/** Followers / following totals for a member — POST\n *  /members/v1/activity-counters/query. Wix keeps ONE counter per direction and creates it on the\n *  first change (live, amit1: a followed member's entry holds only `followerCount`, the follower's\n *  only `followingCount`), so each direction is reported on its own: an explicit nonnegative safe\n *  integer, or `null` when Wix returned none. A counter that is present but malformed makes the\n *  whole answer untrusted and rejects, as does an entry with neither counter or a permission\n *  failure. Callers hide an unavailable counter; a missing one is never shown as zero. */",
         "decl": "export async function getFollowCounts(memberId: string, options?: WixCallOptions): Promise<WixFollowCounts>;",
         "http": "POST /members/v1/activity-counters/query"
       },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1589.0",
+  "version": "0.1590.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": "90984a6109a8a7bcdc2b514a13a5abda6d5b9967765e6606d2254b68"
+  "falconPackageHash": "0c09c9f148ea94e2a39a974ed0254bee503aa232427deadb20e27979"
 }

package/templates/beauty-salon/tier5-src/_shared/app-locale.ts

@@ -0,0 +1,61 @@
+// The language a worker formats numbers, money and plurals in, and the business's time zone. A worker has no host locale to read,
+// so the screen's `onAppear` hands it over: `appear()` adds `locale` to the load params when the app
+// pins its language, and `stashCopy` stores it here. Absent, every formatter stays on "en" — the
+// house pattern every English app was approved with — so an unpinned app is unchanged.
+//
+// The business time zone comes the same way, from the app's provisioning (`businessTimeZone`, collected
+// at migration time while the site's properties are readable): a worker cannot read it itself, because
+// the site-properties route is owner-scoped. Absent, it is "" and no worker guesses one.
+//
+// Pure, no host globals: bundled into every worker that formats, copied into generated templates.
+
+const TAG = /^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/;
+let tag = "en";
+
+/** Set from a load argument's `locale`; anything that is not a language tag resets to "en". */
+export function setAppLocale(value: unknown): void {
+  tag = typeof value === "string" && TAG.test(value) ? value : "en";
+}
+
+export function appLocale(): string {
+  return tag;
+}
+
+/** An IANA zone such as "Asia/Jerusalem" (or "UTC") that this engine knows. A bare offset, a lowercase
+ *  alias or an engine without ECMA-402 is not one: a zone is never guessed. */
+export function isIanaTimeZone(value: unknown): value is string {
+  if (typeof value !== "string" || !/^(?:UTC|[A-Za-z]+(?:\/[A-Za-z0-9_+-]+)+)$/.test(value)) return false;
+  // An engine without ECMA-402 has no zone database: nothing it holds is a zone it knows.
+  if (typeof Intl === "object" && typeof Intl.DateTimeFormat === "function") {
+    try {
+      new Intl.DateTimeFormat("en-US", { timeZone: value });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  return false;
+}
+
+let zone = "";
+
+/** Set from a load argument's `businessTimeZone`; anything that is not an IANA zone clears it. */
+export function setBusinessTimeZone(value: unknown): void {
+  zone = isIanaTimeZone(value) ? value : "";
+}
+
+/** The business's IANA zone, or "" when the app has none provisioned. */
+export function businessTimeZone(): string {
+  return zone;
+}
+
+/** Does `count` take the singular form in the app language? CLDR plural rules, so French "0 point"
+ *  and "1,5 point" are singular and Hebrew "2" is not. An engine without PluralRules keeps the
+ *  English rule (exactly one). */
+export function isSingular(count: number, locale = appLocale()): boolean {
+  try {
+    // An engine without ECMA-402 has no `Intl` at all: it keeps the English rule.
+    if (typeof Intl === "object" && typeof Intl.PluralRules === "function") return new Intl.PluralRules(locale).select(count) === "one";
+  } catch { /* malformed tag — use the English rule */ }
+  return count === 1;
+}

package/templates/beauty-salon/tier5-src/_shared/engine-intl.ts

@@ -20,6 +20,8 @@
 // These helpers are the sanctioned way to format across the whole fleet: real ECMA-402 where it
 // exists, a deterministic en-US-shaped fallback where it does not, and never a throw.
 
+import { appLocale } from "./app-locale.js";
+
 /** Is ECMA-402 actually present in THIS engine? Cheap, and safe in a realm without `Intl`. */
 export function hasIntl(): boolean {
   return typeof Intl !== "undefined";
@@ -189,7 +191,7 @@ const CURRENCY_DIGITS: Record<string, number> = {
 export function formatCurrency(
   amount: number,
   currency = "USD",
-  locale = "en",
+  locale = appLocale(),
   /** Omit for the currency's natural digits. Pass 0 to render a whole amount as "$25" rather
    *  than "$25.00" — Intl clamps the minimum down to match, so max<min does not throw here. */
   maximumFractionDigits?: number,
@@ -258,7 +260,7 @@ function groupThousands(fixed: string): string {
  *     inserted commas into the exponent — `1e21` came out as "1e,+21" and `1e-7` as "1,e-7".
  *     Garbage, and silently so, because nothing in the corpus's tidy test numbers reached it.
  */
-export function formatNumber(value: number, locale = "en"): string {
+export function formatNumber(value: number, locale = appLocale()): string {
   if (!Number.isFinite(value)) return "";
   if (hasIntl()) return new Intl.NumberFormat(locale).format(value);
   // `toFixed` itself returns exponential notation at >=1e21, so anything that big keeps the
@@ -409,7 +411,7 @@ export function compareDateDesc(a: string, b: string): number {
 // Customers read that as sloppiness, and a whole "₪70" beside "₪69.50" reads as a different
 // kind of number. So: one money pattern, one clock, one range.
 
-// Money uses `formatCurrency(amount, currency, "en")` — the currency's NATURAL decimals
+// Money uses `formatCurrency(amount, currency)` — English unless the app pins another language, see app-locale — the currency's NATURAL decimals
 // ("₪70.00", "¥500") — for Shop, Menu and every other price. The one exception is a Bookings
 // SERVICE price (`_shared/wix-service-price.ts`): it drops the cents of a whole amount ("₪70",
 // "₪69.50"), the format the redesigned service screen and services list were approved with. It

package/templates/beauty-salon/tier5-src/_shared/group-member-count.ts

@@ -0,0 +1,15 @@
+import { copyPlural } from "./himi-copy.js";
+
+/** "840 members" / "1 member" for a group, through the copy pack so a translated app reads its own
+ *  language. One key for every worker that shows the count: a screen that renders it must list the
+ *  `groups.` prefix in its `appear()` so the pack carries the key. */
+export function groupMemberCount(count: number): string {
+  return copyPlural("groups.memberCount", "{n, plural, one {# member} other {# members}}", count);
+}
+
+/** The label for a group read back from the offline cache. A cached row keeps the raw `count`, never
+ *  the formatted label, so a pinned app reads it in its own language. A row written before that (label
+ *  only) has no count and shows none, instead of a label in the wrong language. */
+export function cachedMemberCount(count: unknown): string {
+  return typeof count === "number" && Number.isFinite(count) ? groupMemberCount(count) : "";
+}

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

@@ -17,6 +17,7 @@ export function categoryName(value: unknown): string {
   return typeof name === "string" ? name.trim() : "";
 }
 
+import { businessTimeZone } from "./app-locale.js";
 import { formatDateMedium, formatMonthDay, zoneOffsetAt } from "./engine-intl.js";
 import { formatServiceMoney, formatServicePrice, serviceCurrency } from "./wix-service-price.js";
 
@@ -72,7 +73,8 @@ export function slotIdAt(slots: Iterable<[string, { startDate?: string; timezone
 // the button never offers a course that the booking step then refuses.
 
 type CoursePolicyShape = {
-  schedule?: { id?: string; firstSessionStart?: string; lastSessionEnd?: string };
+  /** `timeZone`: the business's IANA zone, for a session time Wix lists as a bare local wall time. */
+  schedule?: { id?: string; firstSessionStart?: string; lastSessionEnd?: string; timeZone?: string };
   bookingPolicy?: {
     bookAfterStartPolicy?: { enabled?: boolean };
     limitEarlyBookingPolicy?: { enabled?: boolean; earliestBookingInMinutes?: number };
@@ -80,25 +82,63 @@ type CoursePolicyShape = {
   };
 };
 
+/** A bare local wall time placed in `timeZone`, as an instant (ms). NaN when the value is not a bare local
+ *  time, has an impossible calendar day, or the engine does not know the zone. */
+function placedInstant(value: string, timeZone: string | undefined): number {
+  const local = LOCAL_TIME.exec(value);
+  if (HAS_OFFSET.test(value) || !local || !timeZone || !validDate(value)) return NaN;
+  const wall = Date.UTC(+local[1], +local[2] - 1, +local[3], +local[4], +local[5], +(local[6] ?? 0));
+  const offset = zoneOffsetAt(wall, timeZone);
+  if (!Number.isFinite(offset)) return NaN;
+  // Once more at the corrected instant, so a wall time beside a DST change lands on the right side.
+  const again = zoneOffsetAt(wall - offset, timeZone);
+  return wall - (Number.isFinite(again) ? again : offset);
+}
+
+/** The zone that places a course's bare local session times: the schedule's own, else the app's
+ *  provisioned business zone. "" when there is none: a zone is never guessed. */
+const courseZone = (schedule: { timeZone?: string } | undefined): string => schedule?.timeZone || businessTimeZone();
+
+/** The instant (ms) of a course session time, for the "Ended" label. A time with an offset is exact. A
+ *  bare local wall time is the BUSINESS's wall time, so it is placed in its zone — never in the device's,
+ *  which would present another zone's clock as a confirmed instant. No zone, a date-only value, an
+ *  impossible calendar day or an engine that does not know the zone: unknown (NaN). */
+function sessionInstant(value: string, timeZone: string | undefined): number {
+  return HAS_OFFSET.test(value) ? validDate(value)?.getTime() ?? NaN : placedInstant(value, timeZone);
+}
+
+/** The same instant for the booking rules (window, read range): a bare local time the business zone can
+ *  place is placed there, so the list label, the service screen and the time screen agree. Everything else
+ *  keeps the read they always had (`Date.parse`), so an app with no provisioned zone is unchanged. */
+function courseInstant(value: string | undefined, timeZone: string | undefined): number {
+  const text = value ?? "";
+  const placed = placedInstant(text, timeZone);
+  return Number.isFinite(placed) ? placed : Date.parse(text);
+}
+
 /** A completed course, independent of whether bookings are currently allowed. Missing,
- *  invalid or reversed dates are unknown, never evidence that a course has ended. */
+ *  invalid or reversed dates are unknown, never evidence that a course has ended. A session time
+ *  without an offset counts only when the schedule names the business's `timeZone`. */
 export function courseHasEnded(service: CoursePolicyShape, now: number): boolean {
-  const start = service.schedule?.firstSessionStart ?? "";
-  const end = service.schedule?.lastSessionEnd ?? "";
-  // The schedule has no zone beside these fields. A local wall time must not be interpreted
-  // in the device's zone and presented as a confirmed business end instant.
-  if (!HAS_OFFSET.test(start) || !HAS_OFFSET.test(end)) return false;
-  const first = validDate(start)?.getTime() ?? NaN;
-  const last = validDate(end)?.getTime() ?? NaN;
+  const zone = courseZone(service.schedule);
+  const first = sessionInstant(service.schedule?.firstSessionStart ?? "", zone);
+  const last = sessionInstant(service.schedule?.lastSessionEnd ?? "", zone);
   return Number.isFinite(now) && Number.isFinite(first) && Number.isFinite(last) && first <= last && last <= now;
 }
 
+/** Does this course schedule hold a session time that is a bare local wall time, which only the
+ *  business's zone can place? A caller reads the zone only when this is true. */
+export function courseNeedsZone(schedule: { firstSessionStart?: string; lastSessionEnd?: string } | undefined): boolean {
+  return [schedule?.firstSessionStart, schedule?.lastSessionEnd].some((value) => !!value && !HAS_OFFSET.test(value) && LOCAL_TIME.test(value));
+}
+
 /** Whether the business takes course bookings at `now` (ms): the course has not ended, has not
  *  started (unless the policy lets people join late), and `now` is inside its booking window —
  *  which the early and late limits count from the first session. */
 export function courseWindowOpen(service: CoursePolicyShape, now: number): boolean {
-  const first = Date.parse(service.schedule?.firstSessionStart ?? "");
-  const last = Date.parse(service.schedule?.lastSessionEnd ?? "");
+  const zone = courseZone(service.schedule);
+  const first = courseInstant(service.schedule?.firstSessionStart, zone);
+  const last = courseInstant(service.schedule?.lastSessionEnd, zone);
   if (!Number.isFinite(first) || !Number.isFinite(last) || last <= now) return false;
   const policy = service.bookingPolicy;
   if (first < now && policy?.bookAfterStartPolicy?.enabled !== true) return false;
@@ -119,8 +159,9 @@ const DAY = 86_400_000;
  *  its last session (`complete`) and start at its first (`fromFirst`, so a count is the whole
  *  course). Empty when the course has no usable dates or has ended. */
 export function courseReadWindows(service: CoursePolicyShape, now: number, chunkDays = 14): { windows: Array<[number, number]>; complete: boolean; fromFirst: boolean } {
-  const first = Date.parse(service.schedule?.firstSessionStart ?? "");
-  const last = Date.parse(service.schedule?.lastSessionEnd ?? "");
+  const zone = courseZone(service.schedule);
+  const first = courseInstant(service.schedule?.firstSessionStart, zone);
+  const last = courseInstant(service.schedule?.lastSessionEnd, zone);
   if (!Number.isFinite(first) || !Number.isFinite(last)) return { windows: [], complete: false, fromFirst: false };
   const from = Math.max(first, now);
   const courseEnd = last + DAY;

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

@@ -12,10 +12,12 @@
 // and every read returns `fallback` verbatim — routing a worker string through
 // copyParam is byte-for-byte behavior-preserving.
 //
-// Pure + Hermes-safe (no host globals, no Node APIs, no imports): bundled into
+// Pure + Hermes-safe (no host globals, no Node APIs; its only import is the pure `app-locale` sibling): bundled into
 // every worker that emits user-facing copy, and copied verbatim into the
 // generated templates' tier5-src/_shared/.
 
+import { isSingular, setAppLocale, setBusinessTimeZone } from "./app-locale.js";
+
 /** Customer strings override every read; translated stock is valid only for its
  * original English fallback. Some existing keys serve more than one message. */
 export type CopyPackValue = string | { source: string; translation: string };
@@ -29,6 +31,12 @@ let copyReceived = false;
  *  stock fallbacks keep rendering. */
 export function stashCopy(arg: unknown): void {
   if (!arg || typeof arg !== "object") return;
+  // A param-carrying dispatch names the app language and business zone too (absent: the English house
+  // pattern, and no zone).
+  if ("copy" in arg || "locale" in arg || "businessTimeZone" in arg) {
+    setAppLocale((arg as Record<string, unknown>).locale);
+    setBusinessTimeZone((arg as Record<string, unknown>).businessTimeZone);
+  }
   const raw = (arg as Record<string, unknown>).copy;
   if (typeof raw !== "string" || !raw) return;
   try {
@@ -77,5 +85,5 @@ export function copyPlural(key: string, fallback: string, count: number): string
   const pattern = copyParam(key, fallback);
   const match = /^\{n, plural, one \{([^{}]*)\} other \{([^{}]*)\}\}$/.exec(pattern);
   if (!match) return copyTemplate(key, fallback, { n: count });
-  return (count === 1 ? match[1] : match[2])!.replace(/#/g, String(count));
+  return (isSingular(count) ? match[1] : match[2])!.replace(/#/g, String(count));
 }

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

@@ -104,7 +104,7 @@ export function itemPriceLine(item: WixItem): string {
   const currency = typeof info?.currency === "string" ? info.currency : "";
   if (!currency) return `${price}`;
   try {
-    return formatCurrency(Number(price), currency, "en");
+    return formatCurrency(Number(price), currency);
   } catch {
     return `${price}`;
   }
@@ -153,7 +153,7 @@ export function itemPriceVariants(item: WixItem): Array<{ id: string; variantId:
     let priceLine = `${price}`;
     if (currency) {
       try {
-        priceLine = formatCurrency(Number(price), currency, "en");
+        priceLine = formatCurrency(Number(price), currency);
       } catch { /* keep the bare amount */ }
     }
     const formatted = typeof node.priceInfo?.formattedPrice === "string" ? node.priceInfo.formattedPrice.trim() : "";

package/templates/beauty-salon/tier5-src/_shared/restaurant-ordering.ts

@@ -74,7 +74,7 @@ export function decimal(value: unknown): number {
 
 /** Cart V2 money carries no formatted string: format the decimal with the cart's currency. */
 export function money(amount: unknown, currency: string | undefined): string {
-  return formatCurrency(decimal(amount), (currency ?? "").trim() || "USD", "en");
+  return formatCurrency(decimal(amount), (currency ?? "").trim() || "USD");
 }
 
 export function cartCurrency(cart: WixCartV2 | undefined): string {

package/templates/beauty-salon/tier5-src/_shared/wix-service-price.ts

@@ -111,7 +111,7 @@ export function formatServiceMoney(money: unknown, fallbackCurrency = "USD"): st
   if (amount == null) return "";
   const currency = stringOf(m.currency) || fallbackCurrency;
   try {
-    return formatCurrency(amount, currency, "en", Number.isInteger(amount) ? 0 : undefined);
+    return formatCurrency(amount, currency, undefined, Number.isInteger(amount) ? 0 : undefined);
   } catch {
     return `${amount}`;
   }
@@ -139,7 +139,7 @@ export function formatServicePrice(service: unknown): string {
   try {
     // A whole amount drops its cents ("₪70", not "₪70.00"), as formatServiceMoney and the service
     // screen show it, so the same service reads the same price on every screen.
-    return formatCurrency(amount, currency, "en", Number.isInteger(amount) ? 0 : undefined);
+    return formatCurrency(amount, currency, undefined, Number.isInteger(amount) ? 0 : undefined);
   } catch {
     return `${amount}`;
   }