@wix/himalaya-cli 0.1588.0 → 0.1590.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (220) hide show
  1. package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/sdk/sdk-types/src/capabilities.generated.d.ts +2 -1
  2. package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/sdk/torch/src/index.d.ts +39 -0
  3. package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/sdk/webview-page/src/capabilities.generated.d.ts +2 -0
  4. package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/ts/src/define-app.d.ts +13 -2
  5. package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/groups/src/extensions.d.ts +28 -0
  6. package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/members-v1/src/index.d.ts +9 -5
  7. package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/audio-record.mjs +1 -0
  8. package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/calendar.mjs +1 -0
  9. package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/calls.mjs +1 -0
  10. package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/contacts.mjs +1 -0
  11. package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/location.mjs +1 -0
  12. package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/motion.mjs +1 -0
  13. package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/photos.mjs +1 -0
  14. package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/sdk-types.mjs +1 -0
  15. package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/tasks.mjs +1 -0
  16. package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/torch.mjs +78 -0
  17. package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-groups.mjs +14 -0
  18. package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-members.mjs +9 -8
  19. package/dist/authoring-runtime/node_modules/@wix/himalaya/package.json +4 -0
  20. package/dist/cli.mjs +121 -50
  21. package/dist/preview-assets.generated.bin +0 -0
  22. package/fixtures/wix-canned.json +16 -0
  23. package/guides/app-config.md +1 -1
  24. package/guides/importable-sdks.md +1 -0
  25. package/guides/one-app-to-himi-app.md +18 -4
  26. package/guides/qa-builds.md +12 -0
  27. package/guides/sdk-reference.json +101 -2
  28. package/guides/web-page-sdk-reference.md +1 -0
  29. package/package.json +2 -2
  30. package/templates/beauty-salon/tier5-src/_shared/app-locale.ts +61 -0
  31. package/templates/beauty-salon/tier5-src/_shared/branded-lite-hosted.ts +1 -0
  32. package/templates/beauty-salon/tier5-src/_shared/engine-intl.ts +5 -3
  33. package/templates/beauty-salon/tier5-src/_shared/group-member-count.ts +15 -0
  34. package/templates/beauty-salon/tier5-src/_shared/himi-bookings.ts +54 -13
  35. package/templates/beauty-salon/tier5-src/_shared/himi-copy.ts +10 -2
  36. package/templates/beauty-salon/tier5-src/_shared/himi-restaurants.ts +2 -2
  37. package/templates/beauty-salon/tier5-src/_shared/restaurant-ordering.ts +1 -1
  38. package/templates/beauty-salon/tier5-src/_shared/wix-service-price.ts +2 -2
  39. package/templates/beauty-salon/tier5-src/himi-booking-services/index.ts +8 -3
  40. package/templates/beauty-salon/tier5-src/himi-branded-lite-cart/index.ts +1 -1
  41. package/templates/beauty-salon/tier5-src/himi-branded-lite-home/index.ts +2 -1
  42. package/templates/beauty-salon/tier5-src/himi-branded-lite-plans/index.ts +1 -1
  43. package/templates/beauty-salon-owner/tier5-src/_shared/app-locale.ts +61 -0
  44. package/templates/beauty-salon-owner/tier5-src/_shared/engine-intl.ts +5 -3
  45. package/templates/beauty-salon-owner/tier5-src/_shared/himi-copy.ts +10 -2
  46. package/templates/branded-lite/config.ts +7 -0
  47. package/templates/branded-lite/dev/index.ts +469 -0
  48. package/templates/branded-lite/himalaya.content.json +3 -0
  49. package/templates/branded-lite/tier5-src/_shared/app-locale.ts +61 -0
  50. package/templates/branded-lite/tier5-src/_shared/branded-lite-hosted.ts +1 -0
  51. package/templates/branded-lite/tier5-src/_shared/engine-intl.ts +5 -3
  52. package/templates/branded-lite/tier5-src/_shared/group-member-count.ts +15 -0
  53. package/templates/branded-lite/tier5-src/_shared/himi-bookings.ts +54 -13
  54. package/templates/branded-lite/tier5-src/_shared/himi-copy.ts +10 -2
  55. package/templates/branded-lite/tier5-src/_shared/himi-restaurants.ts +2 -2
  56. package/templates/branded-lite/tier5-src/_shared/restaurant-ordering.ts +1 -1
  57. package/templates/branded-lite/tier5-src/_shared/wix-service-price.ts +2 -2
  58. package/templates/branded-lite/tier5-src/himi-booking-services/index.ts +8 -3
  59. package/templates/branded-lite/tier5-src/himi-branded-lite-cart/index.ts +1 -1
  60. package/templates/branded-lite/tier5-src/himi-branded-lite-group/index.ts +9 -3
  61. package/templates/branded-lite/tier5-src/himi-branded-lite-group-about/index.ts +2 -1
  62. package/templates/branded-lite/tier5-src/himi-branded-lite-groups/index.ts +6 -2
  63. package/templates/branded-lite/tier5-src/himi-branded-lite-home/index.ts +2 -1
  64. package/templates/branded-lite/tier5-src/himi-branded-lite-loyalty/index.ts +3 -2
  65. package/templates/branded-lite/tier5-src/himi-branded-lite-my-groups/index.ts +237 -0
  66. package/templates/branded-lite/tier5-src/himi-branded-lite-plans/index.ts +1 -1
  67. package/templates/branded-lite/tier5-src/himi-branded-lite-program/index.ts +1 -1
  68. package/templates/branded-lite/tier5-src/himi-events-detail/index.ts +5 -5
  69. package/templates/branded-lite/tier5-src/wix-spaces-member-detail/index.ts +5 -1
  70. package/templates/brandy/tier5-src/_shared/app-locale.ts +61 -0
  71. package/templates/brandy/tier5-src/_shared/himi-copy.ts +10 -2
  72. package/templates/community-club/config.ts +7 -0
  73. package/templates/community-club/dev/index.ts +469 -0
  74. package/templates/community-club/himalaya.content.json +3 -0
  75. package/templates/community-club/tier5-src/_shared/app-locale.ts +61 -0
  76. package/templates/community-club/tier5-src/_shared/branded-lite-hosted.ts +1 -0
  77. package/templates/community-club/tier5-src/_shared/engine-intl.ts +5 -3
  78. package/templates/community-club/tier5-src/_shared/group-member-count.ts +15 -0
  79. package/templates/community-club/tier5-src/_shared/himi-copy.ts +10 -2
  80. package/templates/community-club/tier5-src/_shared/himi-restaurants.ts +2 -2
  81. package/templates/community-club/tier5-src/_shared/wix-service-price.ts +2 -2
  82. package/templates/community-club/tier5-src/himi-branded-lite-group/index.ts +9 -3
  83. package/templates/community-club/tier5-src/himi-branded-lite-group-about/index.ts +2 -1
  84. package/templates/community-club/tier5-src/himi-branded-lite-groups/index.ts +6 -2
  85. package/templates/community-club/tier5-src/himi-branded-lite-home/index.ts +2 -1
  86. package/templates/community-club/tier5-src/himi-branded-lite-my-groups/index.ts +237 -0
  87. package/templates/community-club/tier5-src/himi-events-detail/index.ts +5 -5
  88. package/templates/community-club-owner/tier5-src/_shared/app-locale.ts +61 -0
  89. package/templates/community-club-owner/tier5-src/_shared/engine-intl.ts +5 -3
  90. package/templates/community-club-owner/tier5-src/_shared/himi-copy.ts +10 -2
  91. package/templates/events-meetups/config.ts +7 -0
  92. package/templates/events-meetups/dev/index.ts +469 -0
  93. package/templates/events-meetups/himalaya.content.json +3 -0
  94. package/templates/events-meetups/tier5-src/_shared/app-locale.ts +61 -0
  95. package/templates/events-meetups/tier5-src/_shared/branded-lite-hosted.ts +1 -0
  96. package/templates/events-meetups/tier5-src/_shared/engine-intl.ts +5 -3
  97. package/templates/events-meetups/tier5-src/_shared/group-member-count.ts +15 -0
  98. package/templates/events-meetups/tier5-src/_shared/himi-copy.ts +10 -2
  99. package/templates/events-meetups/tier5-src/_shared/himi-restaurants.ts +2 -2
  100. package/templates/events-meetups/tier5-src/_shared/wix-service-price.ts +2 -2
  101. package/templates/events-meetups/tier5-src/himi-branded-lite-group/index.ts +9 -3
  102. package/templates/events-meetups/tier5-src/himi-branded-lite-group-about/index.ts +2 -1
  103. package/templates/events-meetups/tier5-src/himi-branded-lite-groups/index.ts +6 -2
  104. package/templates/events-meetups/tier5-src/himi-branded-lite-home/index.ts +2 -1
  105. package/templates/events-meetups/tier5-src/himi-branded-lite-my-groups/index.ts +237 -0
  106. package/templates/events-meetups/tier5-src/himi-events-detail/index.ts +5 -5
  107. package/templates/events-meetups-owner/tier5-src/_shared/app-locale.ts +61 -0
  108. package/templates/events-meetups-owner/tier5-src/_shared/engine-intl.ts +5 -3
  109. package/templates/events-meetups-owner/tier5-src/_shared/himi-copy.ts +10 -2
  110. package/templates/gym-fitness/tier5-src/_shared/app-locale.ts +61 -0
  111. package/templates/gym-fitness/tier5-src/_shared/branded-lite-hosted.ts +1 -0
  112. package/templates/gym-fitness/tier5-src/_shared/engine-intl.ts +5 -3
  113. package/templates/gym-fitness/tier5-src/_shared/group-member-count.ts +15 -0
  114. package/templates/gym-fitness/tier5-src/_shared/himi-bookings.ts +54 -13
  115. package/templates/gym-fitness/tier5-src/_shared/himi-copy.ts +10 -2
  116. package/templates/gym-fitness/tier5-src/_shared/himi-restaurants.ts +2 -2
  117. package/templates/gym-fitness/tier5-src/_shared/restaurant-ordering.ts +1 -1
  118. package/templates/gym-fitness/tier5-src/_shared/wix-service-price.ts +2 -2
  119. package/templates/gym-fitness/tier5-src/himi-booking-services/index.ts +8 -3
  120. package/templates/gym-fitness/tier5-src/himi-branded-lite-cart/index.ts +1 -1
  121. package/templates/gym-fitness/tier5-src/himi-branded-lite-home/index.ts +2 -1
  122. package/templates/gym-fitness/tier5-src/himi-branded-lite-plans/index.ts +1 -1
  123. package/templates/gym-fitness/tier5-src/himi-events-detail/index.ts +5 -5
  124. package/templates/gym-fitness-owner/tier5-src/_shared/app-locale.ts +61 -0
  125. package/templates/gym-fitness-owner/tier5-src/_shared/engine-intl.ts +5 -3
  126. package/templates/gym-fitness-owner/tier5-src/_shared/himi-copy.ts +10 -2
  127. package/templates/himi-chat/tier5-src/_shared/app-locale.ts +61 -0
  128. package/templates/himi-chat/tier5-src/_shared/himi-copy.ts +10 -2
  129. package/templates/nonprofit-cause/config.ts +7 -0
  130. package/templates/nonprofit-cause/dev/index.ts +469 -0
  131. package/templates/nonprofit-cause/himalaya.content.json +3 -0
  132. package/templates/nonprofit-cause/tier5-src/_shared/app-locale.ts +61 -0
  133. package/templates/nonprofit-cause/tier5-src/_shared/branded-lite-hosted.ts +1 -0
  134. package/templates/nonprofit-cause/tier5-src/_shared/engine-intl.ts +5 -3
  135. package/templates/nonprofit-cause/tier5-src/_shared/group-member-count.ts +15 -0
  136. package/templates/nonprofit-cause/tier5-src/_shared/himi-copy.ts +10 -2
  137. package/templates/nonprofit-cause/tier5-src/_shared/himi-restaurants.ts +2 -2
  138. package/templates/nonprofit-cause/tier5-src/_shared/wix-service-price.ts +2 -2
  139. package/templates/nonprofit-cause/tier5-src/himi-branded-lite-group/index.ts +9 -3
  140. package/templates/nonprofit-cause/tier5-src/himi-branded-lite-group-about/index.ts +2 -1
  141. package/templates/nonprofit-cause/tier5-src/himi-branded-lite-groups/index.ts +6 -2
  142. package/templates/nonprofit-cause/tier5-src/himi-branded-lite-home/index.ts +2 -1
  143. package/templates/nonprofit-cause/tier5-src/himi-branded-lite-my-groups/index.ts +237 -0
  144. package/templates/nonprofit-cause/tier5-src/himi-branded-lite-plans/index.ts +1 -1
  145. package/templates/nonprofit-cause/tier5-src/himi-events-detail/index.ts +5 -5
  146. package/templates/nonprofit-cause-owner/tier5-src/_shared/app-locale.ts +61 -0
  147. package/templates/nonprofit-cause-owner/tier5-src/_shared/engine-intl.ts +5 -3
  148. package/templates/nonprofit-cause-owner/tier5-src/_shared/himi-copy.ts +10 -2
  149. package/templates/owner-lite/tier5-src/_shared/app-locale.ts +61 -0
  150. package/templates/owner-lite/tier5-src/_shared/engine-intl.ts +5 -3
  151. package/templates/owner-lite/tier5-src/_shared/himi-copy.ts +10 -2
  152. package/templates/podcast-creator/tier5-src/_shared/app-locale.ts +61 -0
  153. package/templates/podcast-creator/tier5-src/_shared/branded-lite-hosted.ts +1 -0
  154. package/templates/podcast-creator/tier5-src/_shared/engine-intl.ts +5 -3
  155. package/templates/podcast-creator/tier5-src/_shared/group-member-count.ts +15 -0
  156. package/templates/podcast-creator/tier5-src/_shared/himi-copy.ts +10 -2
  157. package/templates/podcast-creator/tier5-src/_shared/himi-restaurants.ts +2 -2
  158. package/templates/podcast-creator/tier5-src/_shared/wix-service-price.ts +2 -2
  159. package/templates/podcast-creator/tier5-src/himi-branded-lite-home/index.ts +2 -1
  160. package/templates/podcast-creator/tier5-src/himi-branded-lite-plans/index.ts +1 -1
  161. package/templates/podcast-creator/tier5-src/himi-events-detail/index.ts +5 -5
  162. package/templates/podcast-creator-owner/tier5-src/_shared/app-locale.ts +61 -0
  163. package/templates/podcast-creator-owner/tier5-src/_shared/engine-intl.ts +5 -3
  164. package/templates/podcast-creator-owner/tier5-src/_shared/himi-copy.ts +10 -2
  165. package/templates/portfolio-creative/tier5-src/_shared/app-locale.ts +61 -0
  166. package/templates/portfolio-creative/tier5-src/_shared/branded-lite-hosted.ts +1 -0
  167. package/templates/portfolio-creative/tier5-src/_shared/engine-intl.ts +5 -3
  168. package/templates/portfolio-creative/tier5-src/_shared/group-member-count.ts +15 -0
  169. package/templates/portfolio-creative/tier5-src/_shared/himi-copy.ts +10 -2
  170. package/templates/portfolio-creative/tier5-src/_shared/himi-restaurants.ts +2 -2
  171. package/templates/portfolio-creative/tier5-src/_shared/restaurant-ordering.ts +1 -1
  172. package/templates/portfolio-creative/tier5-src/_shared/wix-service-price.ts +2 -2
  173. package/templates/portfolio-creative/tier5-src/himi-branded-lite-cart/index.ts +1 -1
  174. package/templates/portfolio-creative/tier5-src/himi-branded-lite-home/index.ts +2 -1
  175. package/templates/portfolio-creative/tier5-src/himi-events-detail/index.ts +5 -5
  176. package/templates/portfolio-creative-owner/tier5-src/_shared/app-locale.ts +61 -0
  177. package/templates/portfolio-creative-owner/tier5-src/_shared/engine-intl.ts +5 -3
  178. package/templates/portfolio-creative-owner/tier5-src/_shared/himi-copy.ts +10 -2
  179. package/templates/restaurant/tier5-src/_shared/app-locale.ts +61 -0
  180. package/templates/restaurant/tier5-src/_shared/branded-lite-hosted.ts +1 -0
  181. package/templates/restaurant/tier5-src/_shared/engine-intl.ts +5 -3
  182. package/templates/restaurant/tier5-src/_shared/group-member-count.ts +15 -0
  183. package/templates/restaurant/tier5-src/_shared/himi-copy.ts +10 -2
  184. package/templates/restaurant/tier5-src/_shared/himi-restaurants.ts +2 -2
  185. package/templates/restaurant/tier5-src/_shared/restaurant-ordering.ts +1 -1
  186. package/templates/restaurant/tier5-src/_shared/wix-service-price.ts +2 -2
  187. package/templates/restaurant/tier5-src/himi-branded-lite-home/index.ts +2 -1
  188. package/templates/restaurant/tier5-src/himi-events-detail/index.ts +5 -5
  189. package/templates/restaurant-owner/tier5-src/_shared/app-locale.ts +61 -0
  190. package/templates/restaurant-owner/tier5-src/_shared/engine-intl.ts +5 -3
  191. package/templates/restaurant-owner/tier5-src/_shared/himi-copy.ts +10 -2
  192. package/templates/retail-store/tier5-src/_shared/app-locale.ts +61 -0
  193. package/templates/retail-store/tier5-src/_shared/branded-lite-hosted.ts +1 -0
  194. package/templates/retail-store/tier5-src/_shared/engine-intl.ts +5 -3
  195. package/templates/retail-store/tier5-src/_shared/group-member-count.ts +15 -0
  196. package/templates/retail-store/tier5-src/_shared/himi-copy.ts +10 -2
  197. package/templates/retail-store/tier5-src/_shared/himi-restaurants.ts +2 -2
  198. package/templates/retail-store/tier5-src/_shared/restaurant-ordering.ts +1 -1
  199. package/templates/retail-store/tier5-src/_shared/wix-service-price.ts +2 -2
  200. package/templates/retail-store/tier5-src/himi-branded-lite-cart/index.ts +1 -1
  201. package/templates/retail-store/tier5-src/himi-branded-lite-home/index.ts +2 -1
  202. package/templates/retail-store-owner/tier5-src/_shared/app-locale.ts +61 -0
  203. package/templates/retail-store-owner/tier5-src/_shared/engine-intl.ts +5 -3
  204. package/templates/retail-store-owner/tier5-src/_shared/himi-copy.ts +10 -2
  205. package/templates/yoga-studio/tier5-src/_shared/app-locale.ts +61 -0
  206. package/templates/yoga-studio/tier5-src/_shared/branded-lite-hosted.ts +1 -0
  207. package/templates/yoga-studio/tier5-src/_shared/engine-intl.ts +5 -3
  208. package/templates/yoga-studio/tier5-src/_shared/group-member-count.ts +15 -0
  209. package/templates/yoga-studio/tier5-src/_shared/himi-bookings.ts +54 -13
  210. package/templates/yoga-studio/tier5-src/_shared/himi-copy.ts +10 -2
  211. package/templates/yoga-studio/tier5-src/_shared/himi-restaurants.ts +2 -2
  212. package/templates/yoga-studio/tier5-src/_shared/wix-service-price.ts +2 -2
  213. package/templates/yoga-studio/tier5-src/himi-booking-services/index.ts +8 -3
  214. package/templates/yoga-studio/tier5-src/himi-branded-lite-home/index.ts +2 -1
  215. package/templates/yoga-studio/tier5-src/himi-branded-lite-plans/index.ts +1 -1
  216. package/templates/yoga-studio/tier5-src/himi-branded-lite-program/index.ts +1 -1
  217. package/templates/yoga-studio/tier5-src/himi-events-detail/index.ts +5 -5
  218. package/templates/yoga-studio-owner/tier5-src/_shared/app-locale.ts +61 -0
  219. package/templates/yoga-studio-owner/tier5-src/_shared/engine-intl.ts +5 -3
  220. package/templates/yoga-studio-owner/tier5-src/_shared/himi-copy.ts +10 -2
@@ -12,10 +12,12 @@
12
12
  // and every read returns `fallback` verbatim — routing a worker string through
13
13
  // copyParam is byte-for-byte behavior-preserving.
14
14
  //
15
- // Pure + Hermes-safe (no host globals, no Node APIs, no imports): bundled into
15
+ // Pure + Hermes-safe (no host globals, no Node APIs; its only import is the pure `app-locale` sibling): bundled into
16
16
  // every worker that emits user-facing copy, and copied verbatim into the
17
17
  // generated templates' tier5-src/_shared/.
18
18
 
19
+ import { isSingular, setAppLocale, setBusinessTimeZone } from "./app-locale.js";
20
+
19
21
  /** Customer strings override every read; translated stock is valid only for its
20
22
  * original English fallback. Some existing keys serve more than one message. */
21
23
  export type CopyPackValue = string | { source: string; translation: string };
@@ -29,6 +31,12 @@ let copyReceived = false;
29
31
  * stock fallbacks keep rendering. */
30
32
  export function stashCopy(arg: unknown): void {
31
33
  if (!arg || typeof arg !== "object") return;
34
+ // A param-carrying dispatch names the app language and business zone too (absent: the English house
35
+ // pattern, and no zone).
36
+ if ("copy" in arg || "locale" in arg || "businessTimeZone" in arg) {
37
+ setAppLocale((arg as Record<string, unknown>).locale);
38
+ setBusinessTimeZone((arg as Record<string, unknown>).businessTimeZone);
39
+ }
32
40
  const raw = (arg as Record<string, unknown>).copy;
33
41
  if (typeof raw !== "string" || !raw) return;
34
42
  try {
@@ -77,5 +85,5 @@ export function copyPlural(key: string, fallback: string, count: number): string
77
85
  const pattern = copyParam(key, fallback);
78
86
  const match = /^\{n, plural, one \{([^{}]*)\} other \{([^{}]*)\}\}$/.exec(pattern);
79
87
  if (!match) return copyTemplate(key, fallback, { n: count });
80
- return (count === 1 ? match[1] : match[2])!.replace(/#/g, String(count));
88
+ return (isSingular(count) ? match[1] : match[2])!.replace(/#/g, String(count));
81
89
  }
@@ -0,0 +1,61 @@
1
+ // The language a worker formats numbers, money and plurals in, and the business's time zone. A worker has no host locale to read,
2
+ // so the screen's `onAppear` hands it over: `appear()` adds `locale` to the load params when the app
3
+ // pins its language, and `stashCopy` stores it here. Absent, every formatter stays on "en" — the
4
+ // house pattern every English app was approved with — so an unpinned app is unchanged.
5
+ //
6
+ // The business time zone comes the same way, from the app's provisioning (`businessTimeZone`, collected
7
+ // at migration time while the site's properties are readable): a worker cannot read it itself, because
8
+ // the site-properties route is owner-scoped. Absent, it is "" and no worker guesses one.
9
+ //
10
+ // Pure, no host globals: bundled into every worker that formats, copied into generated templates.
11
+
12
+ const TAG = /^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/;
13
+ let tag = "en";
14
+
15
+ /** Set from a load argument's `locale`; anything that is not a language tag resets to "en". */
16
+ export function setAppLocale(value: unknown): void {
17
+ tag = typeof value === "string" && TAG.test(value) ? value : "en";
18
+ }
19
+
20
+ export function appLocale(): string {
21
+ return tag;
22
+ }
23
+
24
+ /** An IANA zone such as "Asia/Jerusalem" (or "UTC") that this engine knows. A bare offset, a lowercase
25
+ * alias or an engine without ECMA-402 is not one: a zone is never guessed. */
26
+ export function isIanaTimeZone(value: unknown): value is string {
27
+ if (typeof value !== "string" || !/^(?:UTC|[A-Za-z]+(?:\/[A-Za-z0-9_+-]+)+)$/.test(value)) return false;
28
+ // An engine without ECMA-402 has no zone database: nothing it holds is a zone it knows.
29
+ if (typeof Intl === "object" && typeof Intl.DateTimeFormat === "function") {
30
+ try {
31
+ new Intl.DateTimeFormat("en-US", { timeZone: value });
32
+ return true;
33
+ } catch {
34
+ return false;
35
+ }
36
+ }
37
+ return false;
38
+ }
39
+
40
+ let zone = "";
41
+
42
+ /** Set from a load argument's `businessTimeZone`; anything that is not an IANA zone clears it. */
43
+ export function setBusinessTimeZone(value: unknown): void {
44
+ zone = isIanaTimeZone(value) ? value : "";
45
+ }
46
+
47
+ /** The business's IANA zone, or "" when the app has none provisioned. */
48
+ export function businessTimeZone(): string {
49
+ return zone;
50
+ }
51
+
52
+ /** Does `count` take the singular form in the app language? CLDR plural rules, so French "0 point"
53
+ * and "1,5 point" are singular and Hebrew "2" is not. An engine without PluralRules keeps the
54
+ * English rule (exactly one). */
55
+ export function isSingular(count: number, locale = appLocale()): boolean {
56
+ try {
57
+ // An engine without ECMA-402 has no `Intl` at all: it keeps the English rule.
58
+ if (typeof Intl === "object" && typeof Intl.PluralRules === "function") return new Intl.PluralRules(locale).select(count) === "one";
59
+ } catch { /* malformed tag — use the English rule */ }
60
+ return count === 1;
61
+ }
@@ -98,6 +98,7 @@ export const HOSTED_SCREEN_VERTICALS: Readonly<Record<string, readonly BrandedLi
98
98
  himi_gift_cards: ["giftCards"],
99
99
  himi_groups: ["groups"],
100
100
  himi_group_about: ["groups"],
101
+ himi_my_groups: ["groups"],
101
102
  himi_invoice: ["invoices"],
102
103
  himi_invoices: ["invoices"],
103
104
  himi_loyalty: ["loyalty"],
@@ -20,6 +20,8 @@
20
20
  // These helpers are the sanctioned way to format across the whole fleet: real ECMA-402 where it
21
21
  // exists, a deterministic en-US-shaped fallback where it does not, and never a throw.
22
22
 
23
+ import { appLocale } from "./app-locale.js";
24
+
23
25
  /** Is ECMA-402 actually present in THIS engine? Cheap, and safe in a realm without `Intl`. */
24
26
  export function hasIntl(): boolean {
25
27
  return typeof Intl !== "undefined";
@@ -189,7 +191,7 @@ const CURRENCY_DIGITS: Record<string, number> = {
189
191
  export function formatCurrency(
190
192
  amount: number,
191
193
  currency = "USD",
192
- locale = "en",
194
+ locale = appLocale(),
193
195
  /** Omit for the currency's natural digits. Pass 0 to render a whole amount as "$25" rather
194
196
  * than "$25.00" — Intl clamps the minimum down to match, so max<min does not throw here. */
195
197
  maximumFractionDigits?: number,
@@ -258,7 +260,7 @@ function groupThousands(fixed: string): string {
258
260
  * inserted commas into the exponent — `1e21` came out as "1e,+21" and `1e-7` as "1,e-7".
259
261
  * Garbage, and silently so, because nothing in the corpus's tidy test numbers reached it.
260
262
  */
261
- export function formatNumber(value: number, locale = "en"): string {
263
+ export function formatNumber(value: number, locale = appLocale()): string {
262
264
  if (!Number.isFinite(value)) return "";
263
265
  if (hasIntl()) return new Intl.NumberFormat(locale).format(value);
264
266
  // `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 {
409
411
  // Customers read that as sloppiness, and a whole "₪70" beside "₪69.50" reads as a different
410
412
  // kind of number. So: one money pattern, one clock, one range.
411
413
 
412
- // Money uses `formatCurrency(amount, currency, "en")` — the currency's NATURAL decimals
414
+ // Money uses `formatCurrency(amount, currency)` — English unless the app pins another language, see app-locale — the currency's NATURAL decimals
413
415
  // ("₪70.00", "¥500") — for Shop, Menu and every other price. The one exception is a Bookings
414
416
  // SERVICE price (`_shared/wix-service-price.ts`): it drops the cents of a whole amount ("₪70",
415
417
  // "₪69.50"), the format the redesigned service screen and services list were approved with. It
@@ -0,0 +1,15 @@
1
+ import { copyPlural } from "./himi-copy.js";
2
+
3
+ /** "840 members" / "1 member" for a group, through the copy pack so a translated app reads its own
4
+ * language. One key for every worker that shows the count: a screen that renders it must list the
5
+ * `groups.` prefix in its `appear()` so the pack carries the key. */
6
+ export function groupMemberCount(count: number): string {
7
+ return copyPlural("groups.memberCount", "{n, plural, one {# member} other {# members}}", count);
8
+ }
9
+
10
+ /** The label for a group read back from the offline cache. A cached row keeps the raw `count`, never
11
+ * the formatted label, so a pinned app reads it in its own language. A row written before that (label
12
+ * only) has no count and shows none, instead of a label in the wrong language. */
13
+ export function cachedMemberCount(count: unknown): string {
14
+ return typeof count === "number" && Number.isFinite(count) ? groupMemberCount(count) : "";
15
+ }
@@ -12,10 +12,12 @@
12
12
  // and every read returns `fallback` verbatim — routing a worker string through
13
13
  // copyParam is byte-for-byte behavior-preserving.
14
14
  //
15
- // Pure + Hermes-safe (no host globals, no Node APIs, no imports): bundled into
15
+ // Pure + Hermes-safe (no host globals, no Node APIs; its only import is the pure `app-locale` sibling): bundled into
16
16
  // every worker that emits user-facing copy, and copied verbatim into the
17
17
  // generated templates' tier5-src/_shared/.
18
18
 
19
+ import { isSingular, setAppLocale, setBusinessTimeZone } from "./app-locale.js";
20
+
19
21
  /** Customer strings override every read; translated stock is valid only for its
20
22
  * original English fallback. Some existing keys serve more than one message. */
21
23
  export type CopyPackValue = string | { source: string; translation: string };
@@ -29,6 +31,12 @@ let copyReceived = false;
29
31
  * stock fallbacks keep rendering. */
30
32
  export function stashCopy(arg: unknown): void {
31
33
  if (!arg || typeof arg !== "object") return;
34
+ // A param-carrying dispatch names the app language and business zone too (absent: the English house
35
+ // pattern, and no zone).
36
+ if ("copy" in arg || "locale" in arg || "businessTimeZone" in arg) {
37
+ setAppLocale((arg as Record<string, unknown>).locale);
38
+ setBusinessTimeZone((arg as Record<string, unknown>).businessTimeZone);
39
+ }
32
40
  const raw = (arg as Record<string, unknown>).copy;
33
41
  if (typeof raw !== "string" || !raw) return;
34
42
  try {
@@ -77,5 +85,5 @@ export function copyPlural(key: string, fallback: string, count: number): string
77
85
  const pattern = copyParam(key, fallback);
78
86
  const match = /^\{n, plural, one \{([^{}]*)\} other \{([^{}]*)\}\}$/.exec(pattern);
79
87
  if (!match) return copyTemplate(key, fallback, { n: count });
80
- return (count === 1 ? match[1] : match[2])!.replace(/#/g, String(count));
88
+ return (isSingular(count) ? match[1] : match[2])!.replace(/#/g, String(count));
81
89
  }
@@ -104,7 +104,7 @@ export function itemPriceLine(item: WixItem): string {
104
104
  const currency = typeof info?.currency === "string" ? info.currency : "";
105
105
  if (!currency) return `${price}`;
106
106
  try {
107
- return formatCurrency(Number(price), currency, "en");
107
+ return formatCurrency(Number(price), currency);
108
108
  } catch {
109
109
  return `${price}`;
110
110
  }
@@ -153,7 +153,7 @@ export function itemPriceVariants(item: WixItem): Array<{ id: string; variantId:
153
153
  let priceLine = `${price}`;
154
154
  if (currency) {
155
155
  try {
156
- priceLine = formatCurrency(Number(price), currency, "en");
156
+ priceLine = formatCurrency(Number(price), currency);
157
157
  } catch { /* keep the bare amount */ }
158
158
  }
159
159
  const formatted = typeof node.priceInfo?.formattedPrice === "string" ? node.priceInfo.formattedPrice.trim() : "";
@@ -74,7 +74,7 @@ export function decimal(value: unknown): number {
74
74
 
75
75
  /** Cart V2 money carries no formatted string: format the decimal with the cart's currency. */
76
76
  export function money(amount: unknown, currency: string | undefined): string {
77
- return formatCurrency(decimal(amount), (currency ?? "").trim() || "USD", "en");
77
+ return formatCurrency(decimal(amount), (currency ?? "").trim() || "USD");
78
78
  }
79
79
 
80
80
  export function cartCurrency(cart: WixCartV2 | undefined): string {
@@ -111,7 +111,7 @@ export function formatServiceMoney(money: unknown, fallbackCurrency = "USD"): st
111
111
  if (amount == null) return "";
112
112
  const currency = stringOf(m.currency) || fallbackCurrency;
113
113
  try {
114
- return formatCurrency(amount, currency, "en", Number.isInteger(amount) ? 0 : undefined);
114
+ return formatCurrency(amount, currency, undefined, Number.isInteger(amount) ? 0 : undefined);
115
115
  } catch {
116
116
  return `${amount}`;
117
117
  }
@@ -139,7 +139,7 @@ export function formatServicePrice(service: unknown): string {
139
139
  try {
140
140
  // A whole amount drops its cents ("₪70", not "₪70.00"), as formatServiceMoney and the service
141
141
  // screen show it, so the same service reads the same price on every screen.
142
- return formatCurrency(amount, currency, "en", Number.isInteger(amount) ? 0 : undefined);
142
+ return formatCurrency(amount, currency, undefined, Number.isInteger(amount) ? 0 : undefined);
143
143
  } catch {
144
144
  return `${amount}`;
145
145
  }
@@ -364,7 +364,7 @@ function calculatedDiscount(result: unknown, currency: string): string {
364
364
  const discount = (result as { summary?: { priceSummary?: { discount?: { amount?: string; convertedAmount?: string } } } } | null)?.summary?.priceSummary?.discount;
365
365
  const amount = Number(discount?.amount);
366
366
  if (!Number.isFinite(amount) || amount === 0 || !currency) return "";
367
- return formattedDiscount(formatCurrency(Math.abs(amount), currency, "en"));
367
+ return formattedDiscount(formatCurrency(Math.abs(amount), currency));
368
368
  }
369
369
 
370
370
  function invalidCouponFailure(error: unknown): boolean {
@@ -19,6 +19,7 @@ import { formatServicePrice } from "../_shared/wix-service-price.js";
19
19
  import { cleanTitle, initials } from "../_shared/himi-text.js";
20
20
  import { LAYOUT_KEY, type LayoutId, recommendLayout, resolveLayout } from "../_shared/himi-layouts.js";
21
21
  import { copyParam, copyTemplate, stashCopy } from "../_shared/himi-copy.js";
22
+ import { groupMemberCount } from "../_shared/group-member-count.js";
22
23
  import { parseWeeklyGoal, weeklyGoalProgress, weeklySessionsFromPages } from "../_shared/weekly-goal.js";
23
24
  import { isBridgeUnavailable } from "../_shared/owner-load-error.js";
24
25
  import { formatDateMedium } from "../_shared/engine-intl.js";
@@ -736,7 +737,7 @@ function groupCard(group: WixGroup): GroupCard {
736
737
  return {
737
738
  id: group.id || title,
738
739
  title,
739
- meta: count == null ? "" : `${count} ${count === 1 ? "member" : "members"}`,
740
+ meta: count == null ? "" : groupMemberCount(count),
740
741
  image,
741
742
  initial: (title[0] || "G").toUpperCase(),
742
743
  hasImage: !!image,
@@ -0,0 +1,61 @@
1
+ // The language a worker formats numbers, money and plurals in, and the business's time zone. A worker has no host locale to read,
2
+ // so the screen's `onAppear` hands it over: `appear()` adds `locale` to the load params when the app
3
+ // pins its language, and `stashCopy` stores it here. Absent, every formatter stays on "en" — the
4
+ // house pattern every English app was approved with — so an unpinned app is unchanged.
5
+ //
6
+ // The business time zone comes the same way, from the app's provisioning (`businessTimeZone`, collected
7
+ // at migration time while the site's properties are readable): a worker cannot read it itself, because
8
+ // the site-properties route is owner-scoped. Absent, it is "" and no worker guesses one.
9
+ //
10
+ // Pure, no host globals: bundled into every worker that formats, copied into generated templates.
11
+
12
+ const TAG = /^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/;
13
+ let tag = "en";
14
+
15
+ /** Set from a load argument's `locale`; anything that is not a language tag resets to "en". */
16
+ export function setAppLocale(value: unknown): void {
17
+ tag = typeof value === "string" && TAG.test(value) ? value : "en";
18
+ }
19
+
20
+ export function appLocale(): string {
21
+ return tag;
22
+ }
23
+
24
+ /** An IANA zone such as "Asia/Jerusalem" (or "UTC") that this engine knows. A bare offset, a lowercase
25
+ * alias or an engine without ECMA-402 is not one: a zone is never guessed. */
26
+ export function isIanaTimeZone(value: unknown): value is string {
27
+ if (typeof value !== "string" || !/^(?:UTC|[A-Za-z]+(?:\/[A-Za-z0-9_+-]+)+)$/.test(value)) return false;
28
+ // An engine without ECMA-402 has no zone database: nothing it holds is a zone it knows.
29
+ if (typeof Intl === "object" && typeof Intl.DateTimeFormat === "function") {
30
+ try {
31
+ new Intl.DateTimeFormat("en-US", { timeZone: value });
32
+ return true;
33
+ } catch {
34
+ return false;
35
+ }
36
+ }
37
+ return false;
38
+ }
39
+
40
+ let zone = "";
41
+
42
+ /** Set from a load argument's `businessTimeZone`; anything that is not an IANA zone clears it. */
43
+ export function setBusinessTimeZone(value: unknown): void {
44
+ zone = isIanaTimeZone(value) ? value : "";
45
+ }
46
+
47
+ /** The business's IANA zone, or "" when the app has none provisioned. */
48
+ export function businessTimeZone(): string {
49
+ return zone;
50
+ }
51
+
52
+ /** Does `count` take the singular form in the app language? CLDR plural rules, so French "0 point"
53
+ * and "1,5 point" are singular and Hebrew "2" is not. An engine without PluralRules keeps the
54
+ * English rule (exactly one). */
55
+ export function isSingular(count: number, locale = appLocale()): boolean {
56
+ try {
57
+ // An engine without ECMA-402 has no `Intl` at all: it keeps the English rule.
58
+ if (typeof Intl === "object" && typeof Intl.PluralRules === "function") return new Intl.PluralRules(locale).select(count) === "one";
59
+ } catch { /* malformed tag — use the English rule */ }
60
+ return count === 1;
61
+ }
@@ -20,6 +20,8 @@
20
20
  // These helpers are the sanctioned way to format across the whole fleet: real ECMA-402 where it
21
21
  // exists, a deterministic en-US-shaped fallback where it does not, and never a throw.
22
22
 
23
+ import { appLocale } from "./app-locale.js";
24
+
23
25
  /** Is ECMA-402 actually present in THIS engine? Cheap, and safe in a realm without `Intl`. */
24
26
  export function hasIntl(): boolean {
25
27
  return typeof Intl !== "undefined";
@@ -189,7 +191,7 @@ const CURRENCY_DIGITS: Record<string, number> = {
189
191
  export function formatCurrency(
190
192
  amount: number,
191
193
  currency = "USD",
192
- locale = "en",
194
+ locale = appLocale(),
193
195
  /** Omit for the currency's natural digits. Pass 0 to render a whole amount as "$25" rather
194
196
  * than "$25.00" — Intl clamps the minimum down to match, so max<min does not throw here. */
195
197
  maximumFractionDigits?: number,
@@ -258,7 +260,7 @@ function groupThousands(fixed: string): string {
258
260
  * inserted commas into the exponent — `1e21` came out as "1e,+21" and `1e-7` as "1,e-7".
259
261
  * Garbage, and silently so, because nothing in the corpus's tidy test numbers reached it.
260
262
  */
261
- export function formatNumber(value: number, locale = "en"): string {
263
+ export function formatNumber(value: number, locale = appLocale()): string {
262
264
  if (!Number.isFinite(value)) return "";
263
265
  if (hasIntl()) return new Intl.NumberFormat(locale).format(value);
264
266
  // `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 {
409
411
  // Customers read that as sloppiness, and a whole "₪70" beside "₪69.50" reads as a different
410
412
  // kind of number. So: one money pattern, one clock, one range.
411
413
 
412
- // Money uses `formatCurrency(amount, currency, "en")` — the currency's NATURAL decimals
414
+ // Money uses `formatCurrency(amount, currency)` — English unless the app pins another language, see app-locale — the currency's NATURAL decimals
413
415
  // ("₪70.00", "¥500") — for Shop, Menu and every other price. The one exception is a Bookings
414
416
  // SERVICE price (`_shared/wix-service-price.ts`): it drops the cents of a whole amount ("₪70",
415
417
  // "₪69.50"), the format the redesigned service screen and services list were approved with. It
@@ -12,10 +12,12 @@
12
12
  // and every read returns `fallback` verbatim — routing a worker string through
13
13
  // copyParam is byte-for-byte behavior-preserving.
14
14
  //
15
- // Pure + Hermes-safe (no host globals, no Node APIs, no imports): bundled into
15
+ // Pure + Hermes-safe (no host globals, no Node APIs; its only import is the pure `app-locale` sibling): bundled into
16
16
  // every worker that emits user-facing copy, and copied verbatim into the
17
17
  // generated templates' tier5-src/_shared/.
18
18
 
19
+ import { isSingular, setAppLocale, setBusinessTimeZone } from "./app-locale.js";
20
+
19
21
  /** Customer strings override every read; translated stock is valid only for its
20
22
  * original English fallback. Some existing keys serve more than one message. */
21
23
  export type CopyPackValue = string | { source: string; translation: string };
@@ -29,6 +31,12 @@ let copyReceived = false;
29
31
  * stock fallbacks keep rendering. */
30
32
  export function stashCopy(arg: unknown): void {
31
33
  if (!arg || typeof arg !== "object") return;
34
+ // A param-carrying dispatch names the app language and business zone too (absent: the English house
35
+ // pattern, and no zone).
36
+ if ("copy" in arg || "locale" in arg || "businessTimeZone" in arg) {
37
+ setAppLocale((arg as Record<string, unknown>).locale);
38
+ setBusinessTimeZone((arg as Record<string, unknown>).businessTimeZone);
39
+ }
32
40
  const raw = (arg as Record<string, unknown>).copy;
33
41
  if (typeof raw !== "string" || !raw) return;
34
42
  try {
@@ -77,5 +85,5 @@ export function copyPlural(key: string, fallback: string, count: number): string
77
85
  const pattern = copyParam(key, fallback);
78
86
  const match = /^\{n, plural, one \{([^{}]*)\} other \{([^{}]*)\}\}$/.exec(pattern);
79
87
  if (!match) return copyTemplate(key, fallback, { n: count });
80
- return (count === 1 ? match[1] : match[2])!.replace(/#/g, String(count));
88
+ return (isSingular(count) ? match[1] : match[2])!.replace(/#/g, String(count));
81
89
  }
@@ -0,0 +1,61 @@
1
+ // The language a worker formats numbers, money and plurals in, and the business's time zone. A worker has no host locale to read,
2
+ // so the screen's `onAppear` hands it over: `appear()` adds `locale` to the load params when the app
3
+ // pins its language, and `stashCopy` stores it here. Absent, every formatter stays on "en" — the
4
+ // house pattern every English app was approved with — so an unpinned app is unchanged.
5
+ //
6
+ // The business time zone comes the same way, from the app's provisioning (`businessTimeZone`, collected
7
+ // at migration time while the site's properties are readable): a worker cannot read it itself, because
8
+ // the site-properties route is owner-scoped. Absent, it is "" and no worker guesses one.
9
+ //
10
+ // Pure, no host globals: bundled into every worker that formats, copied into generated templates.
11
+
12
+ const TAG = /^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/;
13
+ let tag = "en";
14
+
15
+ /** Set from a load argument's `locale`; anything that is not a language tag resets to "en". */
16
+ export function setAppLocale(value: unknown): void {
17
+ tag = typeof value === "string" && TAG.test(value) ? value : "en";
18
+ }
19
+
20
+ export function appLocale(): string {
21
+ return tag;
22
+ }
23
+
24
+ /** An IANA zone such as "Asia/Jerusalem" (or "UTC") that this engine knows. A bare offset, a lowercase
25
+ * alias or an engine without ECMA-402 is not one: a zone is never guessed. */
26
+ export function isIanaTimeZone(value: unknown): value is string {
27
+ if (typeof value !== "string" || !/^(?:UTC|[A-Za-z]+(?:\/[A-Za-z0-9_+-]+)+)$/.test(value)) return false;
28
+ // An engine without ECMA-402 has no zone database: nothing it holds is a zone it knows.
29
+ if (typeof Intl === "object" && typeof Intl.DateTimeFormat === "function") {
30
+ try {
31
+ new Intl.DateTimeFormat("en-US", { timeZone: value });
32
+ return true;
33
+ } catch {
34
+ return false;
35
+ }
36
+ }
37
+ return false;
38
+ }
39
+
40
+ let zone = "";
41
+
42
+ /** Set from a load argument's `businessTimeZone`; anything that is not an IANA zone clears it. */
43
+ export function setBusinessTimeZone(value: unknown): void {
44
+ zone = isIanaTimeZone(value) ? value : "";
45
+ }
46
+
47
+ /** The business's IANA zone, or "" when the app has none provisioned. */
48
+ export function businessTimeZone(): string {
49
+ return zone;
50
+ }
51
+
52
+ /** Does `count` take the singular form in the app language? CLDR plural rules, so French "0 point"
53
+ * and "1,5 point" are singular and Hebrew "2" is not. An engine without PluralRules keeps the
54
+ * English rule (exactly one). */
55
+ export function isSingular(count: number, locale = appLocale()): boolean {
56
+ try {
57
+ // An engine without ECMA-402 has no `Intl` at all: it keeps the English rule.
58
+ if (typeof Intl === "object" && typeof Intl.PluralRules === "function") return new Intl.PluralRules(locale).select(count) === "one";
59
+ } catch { /* malformed tag — use the English rule */ }
60
+ return count === 1;
61
+ }
@@ -98,6 +98,7 @@ export const HOSTED_SCREEN_VERTICALS: Readonly<Record<string, readonly BrandedLi
98
98
  himi_gift_cards: ["giftCards"],
99
99
  himi_groups: ["groups"],
100
100
  himi_group_about: ["groups"],
101
+ himi_my_groups: ["groups"],
101
102
  himi_invoice: ["invoices"],
102
103
  himi_invoices: ["invoices"],
103
104
  himi_loyalty: ["loyalty"],
@@ -20,6 +20,8 @@
20
20
  // These helpers are the sanctioned way to format across the whole fleet: real ECMA-402 where it
21
21
  // exists, a deterministic en-US-shaped fallback where it does not, and never a throw.
22
22
 
23
+ import { appLocale } from "./app-locale.js";
24
+
23
25
  /** Is ECMA-402 actually present in THIS engine? Cheap, and safe in a realm without `Intl`. */
24
26
  export function hasIntl(): boolean {
25
27
  return typeof Intl !== "undefined";
@@ -189,7 +191,7 @@ const CURRENCY_DIGITS: Record<string, number> = {
189
191
  export function formatCurrency(
190
192
  amount: number,
191
193
  currency = "USD",
192
- locale = "en",
194
+ locale = appLocale(),
193
195
  /** Omit for the currency's natural digits. Pass 0 to render a whole amount as "$25" rather
194
196
  * than "$25.00" — Intl clamps the minimum down to match, so max<min does not throw here. */
195
197
  maximumFractionDigits?: number,
@@ -258,7 +260,7 @@ function groupThousands(fixed: string): string {
258
260
  * inserted commas into the exponent — `1e21` came out as "1e,+21" and `1e-7` as "1,e-7".
259
261
  * Garbage, and silently so, because nothing in the corpus's tidy test numbers reached it.
260
262
  */
261
- export function formatNumber(value: number, locale = "en"): string {
263
+ export function formatNumber(value: number, locale = appLocale()): string {
262
264
  if (!Number.isFinite(value)) return "";
263
265
  if (hasIntl()) return new Intl.NumberFormat(locale).format(value);
264
266
  // `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 {
409
411
  // Customers read that as sloppiness, and a whole "₪70" beside "₪69.50" reads as a different
410
412
  // kind of number. So: one money pattern, one clock, one range.
411
413
 
412
- // Money uses `formatCurrency(amount, currency, "en")` — the currency's NATURAL decimals
414
+ // Money uses `formatCurrency(amount, currency)` — English unless the app pins another language, see app-locale — the currency's NATURAL decimals
413
415
  // ("₪70.00", "¥500") — for Shop, Menu and every other price. The one exception is a Bookings
414
416
  // SERVICE price (`_shared/wix-service-price.ts`): it drops the cents of a whole amount ("₪70",
415
417
  // "₪69.50"), the format the redesigned service screen and services list were approved with. It
@@ -0,0 +1,15 @@
1
+ import { copyPlural } from "./himi-copy.js";
2
+
3
+ /** "840 members" / "1 member" for a group, through the copy pack so a translated app reads its own
4
+ * language. One key for every worker that shows the count: a screen that renders it must list the
5
+ * `groups.` prefix in its `appear()` so the pack carries the key. */
6
+ export function groupMemberCount(count: number): string {
7
+ return copyPlural("groups.memberCount", "{n, plural, one {# member} other {# members}}", count);
8
+ }
9
+
10
+ /** The label for a group read back from the offline cache. A cached row keeps the raw `count`, never
11
+ * the formatted label, so a pinned app reads it in its own language. A row written before that (label
12
+ * only) has no count and shows none, instead of a label in the wrong language. */
13
+ export function cachedMemberCount(count: unknown): string {
14
+ return typeof count === "number" && Number.isFinite(count) ? groupMemberCount(count) : "";
15
+ }
@@ -17,6 +17,7 @@ export function categoryName(value: unknown): string {
17
17
  return typeof name === "string" ? name.trim() : "";
18
18
  }
19
19
 
20
+ import { businessTimeZone } from "./app-locale.js";
20
21
  import { formatDateMedium, formatMonthDay, zoneOffsetAt } from "./engine-intl.js";
21
22
  import { formatServiceMoney, formatServicePrice, serviceCurrency } from "./wix-service-price.js";
22
23
 
@@ -72,7 +73,8 @@ export function slotIdAt(slots: Iterable<[string, { startDate?: string; timezone
72
73
  // the button never offers a course that the booking step then refuses.
73
74
 
74
75
  type CoursePolicyShape = {
75
- schedule?: { id?: string; firstSessionStart?: string; lastSessionEnd?: string };
76
+ /** `timeZone`: the business's IANA zone, for a session time Wix lists as a bare local wall time. */
77
+ schedule?: { id?: string; firstSessionStart?: string; lastSessionEnd?: string; timeZone?: string };
76
78
  bookingPolicy?: {
77
79
  bookAfterStartPolicy?: { enabled?: boolean };
78
80
  limitEarlyBookingPolicy?: { enabled?: boolean; earliestBookingInMinutes?: number };
@@ -80,25 +82,63 @@ type CoursePolicyShape = {
80
82
  };
81
83
  };
82
84
 
85
+ /** A bare local wall time placed in `timeZone`, as an instant (ms). NaN when the value is not a bare local
86
+ * time, has an impossible calendar day, or the engine does not know the zone. */
87
+ function placedInstant(value: string, timeZone: string | undefined): number {
88
+ const local = LOCAL_TIME.exec(value);
89
+ if (HAS_OFFSET.test(value) || !local || !timeZone || !validDate(value)) return NaN;
90
+ const wall = Date.UTC(+local[1], +local[2] - 1, +local[3], +local[4], +local[5], +(local[6] ?? 0));
91
+ const offset = zoneOffsetAt(wall, timeZone);
92
+ if (!Number.isFinite(offset)) return NaN;
93
+ // Once more at the corrected instant, so a wall time beside a DST change lands on the right side.
94
+ const again = zoneOffsetAt(wall - offset, timeZone);
95
+ return wall - (Number.isFinite(again) ? again : offset);
96
+ }
97
+
98
+ /** The zone that places a course's bare local session times: the schedule's own, else the app's
99
+ * provisioned business zone. "" when there is none: a zone is never guessed. */
100
+ const courseZone = (schedule: { timeZone?: string } | undefined): string => schedule?.timeZone || businessTimeZone();
101
+
102
+ /** The instant (ms) of a course session time, for the "Ended" label. A time with an offset is exact. A
103
+ * bare local wall time is the BUSINESS's wall time, so it is placed in its zone — never in the device's,
104
+ * which would present another zone's clock as a confirmed instant. No zone, a date-only value, an
105
+ * impossible calendar day or an engine that does not know the zone: unknown (NaN). */
106
+ function sessionInstant(value: string, timeZone: string | undefined): number {
107
+ return HAS_OFFSET.test(value) ? validDate(value)?.getTime() ?? NaN : placedInstant(value, timeZone);
108
+ }
109
+
110
+ /** The same instant for the booking rules (window, read range): a bare local time the business zone can
111
+ * place is placed there, so the list label, the service screen and the time screen agree. Everything else
112
+ * keeps the read they always had (`Date.parse`), so an app with no provisioned zone is unchanged. */
113
+ function courseInstant(value: string | undefined, timeZone: string | undefined): number {
114
+ const text = value ?? "";
115
+ const placed = placedInstant(text, timeZone);
116
+ return Number.isFinite(placed) ? placed : Date.parse(text);
117
+ }
118
+
83
119
  /** A completed course, independent of whether bookings are currently allowed. Missing,
84
- * invalid or reversed dates are unknown, never evidence that a course has ended. */
120
+ * invalid or reversed dates are unknown, never evidence that a course has ended. A session time
121
+ * without an offset counts only when the schedule names the business's `timeZone`. */
85
122
  export function courseHasEnded(service: CoursePolicyShape, now: number): boolean {
86
- const start = service.schedule?.firstSessionStart ?? "";
87
- const end = service.schedule?.lastSessionEnd ?? "";
88
- // The schedule has no zone beside these fields. A local wall time must not be interpreted
89
- // in the device's zone and presented as a confirmed business end instant.
90
- if (!HAS_OFFSET.test(start) || !HAS_OFFSET.test(end)) return false;
91
- const first = validDate(start)?.getTime() ?? NaN;
92
- const last = validDate(end)?.getTime() ?? NaN;
123
+ const zone = courseZone(service.schedule);
124
+ const first = sessionInstant(service.schedule?.firstSessionStart ?? "", zone);
125
+ const last = sessionInstant(service.schedule?.lastSessionEnd ?? "", zone);
93
126
  return Number.isFinite(now) && Number.isFinite(first) && Number.isFinite(last) && first <= last && last <= now;
94
127
  }
95
128
 
129
+ /** Does this course schedule hold a session time that is a bare local wall time, which only the
130
+ * business's zone can place? A caller reads the zone only when this is true. */
131
+ export function courseNeedsZone(schedule: { firstSessionStart?: string; lastSessionEnd?: string } | undefined): boolean {
132
+ return [schedule?.firstSessionStart, schedule?.lastSessionEnd].some((value) => !!value && !HAS_OFFSET.test(value) && LOCAL_TIME.test(value));
133
+ }
134
+
96
135
  /** Whether the business takes course bookings at `now` (ms): the course has not ended, has not
97
136
  * started (unless the policy lets people join late), and `now` is inside its booking window —
98
137
  * which the early and late limits count from the first session. */
99
138
  export function courseWindowOpen(service: CoursePolicyShape, now: number): boolean {
100
- const first = Date.parse(service.schedule?.firstSessionStart ?? "");
101
- const last = Date.parse(service.schedule?.lastSessionEnd ?? "");
139
+ const zone = courseZone(service.schedule);
140
+ const first = courseInstant(service.schedule?.firstSessionStart, zone);
141
+ const last = courseInstant(service.schedule?.lastSessionEnd, zone);
102
142
  if (!Number.isFinite(first) || !Number.isFinite(last) || last <= now) return false;
103
143
  const policy = service.bookingPolicy;
104
144
  if (first < now && policy?.bookAfterStartPolicy?.enabled !== true) return false;
@@ -119,8 +159,9 @@ const DAY = 86_400_000;
119
159
  * its last session (`complete`) and start at its first (`fromFirst`, so a count is the whole
120
160
  * course). Empty when the course has no usable dates or has ended. */
121
161
  export function courseReadWindows(service: CoursePolicyShape, now: number, chunkDays = 14): { windows: Array<[number, number]>; complete: boolean; fromFirst: boolean } {
122
- const first = Date.parse(service.schedule?.firstSessionStart ?? "");
123
- const last = Date.parse(service.schedule?.lastSessionEnd ?? "");
162
+ const zone = courseZone(service.schedule);
163
+ const first = courseInstant(service.schedule?.firstSessionStart, zone);
164
+ const last = courseInstant(service.schedule?.lastSessionEnd, zone);
124
165
  if (!Number.isFinite(first) || !Number.isFinite(last)) return { windows: [], complete: false, fromFirst: false };
125
166
  const from = Math.max(first, now);
126
167
  const courseEnd = last + DAY;