@wix/himalaya-cli 0.1210.0 → 0.1211.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 (91) hide show
  1. package/dist/cli.mjs +91 -1
  2. package/package.json +2 -2
  3. package/templates/beauty-salon/tier5-src/_shared/engine-intl.ts +57 -16
  4. package/templates/beauty-salon-owner/dev/index.ts +62 -37
  5. package/templates/beauty-salon-owner/tier5-src/_shared/aria-chat.ts +31 -16
  6. package/templates/beauty-salon-owner/tier5-src/_shared/engine-intl.ts +57 -16
  7. package/templates/beauty-salon-owner/tier5-src/_shared/owner-module-data.ts +105 -37
  8. package/templates/beauty-salon-owner/tier5-src/himi-owner-lite-aria-history/index.ts +1 -0
  9. package/templates/beauty-salon-owner/tier5-src/himi-owner-lite-home/index.ts +5 -0
  10. package/templates/beauty-salon-owner/tier5-src/himi-owner-lite-manage/index.ts +4 -2
  11. package/templates/branded-lite/tier5-src/_shared/engine-intl.ts +57 -16
  12. package/templates/community-club/tier5-src/_shared/engine-intl.ts +57 -16
  13. package/templates/community-club-owner/dev/index.ts +62 -37
  14. package/templates/community-club-owner/tier5-src/_shared/aria-chat.ts +31 -16
  15. package/templates/community-club-owner/tier5-src/_shared/engine-intl.ts +57 -16
  16. package/templates/community-club-owner/tier5-src/_shared/owner-module-data.ts +105 -37
  17. package/templates/community-club-owner/tier5-src/himi-owner-lite-aria-history/index.ts +1 -0
  18. package/templates/community-club-owner/tier5-src/himi-owner-lite-home/index.ts +5 -0
  19. package/templates/community-club-owner/tier5-src/himi-owner-lite-manage/index.ts +4 -2
  20. package/templates/events-meetups/tier5-src/_shared/engine-intl.ts +57 -16
  21. package/templates/events-meetups-owner/dev/index.ts +62 -37
  22. package/templates/events-meetups-owner/tier5-src/_shared/aria-chat.ts +31 -16
  23. package/templates/events-meetups-owner/tier5-src/_shared/engine-intl.ts +57 -16
  24. package/templates/events-meetups-owner/tier5-src/_shared/owner-module-data.ts +105 -37
  25. package/templates/events-meetups-owner/tier5-src/himi-owner-lite-aria-history/index.ts +1 -0
  26. package/templates/events-meetups-owner/tier5-src/himi-owner-lite-home/index.ts +5 -0
  27. package/templates/events-meetups-owner/tier5-src/himi-owner-lite-manage/index.ts +4 -2
  28. package/templates/gym-fitness/tier5-src/_shared/engine-intl.ts +57 -16
  29. package/templates/gym-fitness-owner/dev/index.ts +62 -37
  30. package/templates/gym-fitness-owner/tier5-src/_shared/aria-chat.ts +31 -16
  31. package/templates/gym-fitness-owner/tier5-src/_shared/engine-intl.ts +57 -16
  32. package/templates/gym-fitness-owner/tier5-src/_shared/owner-module-data.ts +105 -37
  33. package/templates/gym-fitness-owner/tier5-src/himi-owner-lite-aria-history/index.ts +1 -0
  34. package/templates/gym-fitness-owner/tier5-src/himi-owner-lite-home/index.ts +5 -0
  35. package/templates/gym-fitness-owner/tier5-src/himi-owner-lite-manage/index.ts +4 -2
  36. package/templates/nonprofit-cause/tier5-src/_shared/engine-intl.ts +57 -16
  37. package/templates/nonprofit-cause-owner/dev/index.ts +62 -37
  38. package/templates/nonprofit-cause-owner/tier5-src/_shared/aria-chat.ts +31 -16
  39. package/templates/nonprofit-cause-owner/tier5-src/_shared/engine-intl.ts +57 -16
  40. package/templates/nonprofit-cause-owner/tier5-src/_shared/owner-module-data.ts +105 -37
  41. package/templates/nonprofit-cause-owner/tier5-src/himi-owner-lite-aria-history/index.ts +1 -0
  42. package/templates/nonprofit-cause-owner/tier5-src/himi-owner-lite-home/index.ts +5 -0
  43. package/templates/nonprofit-cause-owner/tier5-src/himi-owner-lite-manage/index.ts +4 -2
  44. package/templates/owner-lite/dev/index.ts +62 -37
  45. package/templates/owner-lite/tier5-src/_shared/aria-chat.ts +31 -16
  46. package/templates/owner-lite/tier5-src/_shared/engine-intl.ts +57 -16
  47. package/templates/owner-lite/tier5-src/_shared/owner-module-data.ts +105 -37
  48. package/templates/owner-lite/tier5-src/himi-owner-lite-aria-history/index.ts +1 -0
  49. package/templates/owner-lite/tier5-src/himi-owner-lite-faq/index.ts +8 -2
  50. package/templates/owner-lite/tier5-src/himi-owner-lite-home/index.ts +5 -0
  51. package/templates/owner-lite/tier5-src/himi-owner-lite-manage/index.ts +4 -2
  52. package/templates/podcast-creator/tier5-src/_shared/engine-intl.ts +57 -16
  53. package/templates/podcast-creator-owner/dev/index.ts +62 -37
  54. package/templates/podcast-creator-owner/tier5-src/_shared/aria-chat.ts +31 -16
  55. package/templates/podcast-creator-owner/tier5-src/_shared/engine-intl.ts +57 -16
  56. package/templates/podcast-creator-owner/tier5-src/_shared/owner-module-data.ts +105 -37
  57. package/templates/podcast-creator-owner/tier5-src/himi-owner-lite-aria-history/index.ts +1 -0
  58. package/templates/podcast-creator-owner/tier5-src/himi-owner-lite-home/index.ts +5 -0
  59. package/templates/podcast-creator-owner/tier5-src/himi-owner-lite-manage/index.ts +4 -2
  60. package/templates/portfolio-creative/tier5-src/_shared/engine-intl.ts +57 -16
  61. package/templates/portfolio-creative-owner/dev/index.ts +62 -37
  62. package/templates/portfolio-creative-owner/tier5-src/_shared/aria-chat.ts +31 -16
  63. package/templates/portfolio-creative-owner/tier5-src/_shared/engine-intl.ts +57 -16
  64. package/templates/portfolio-creative-owner/tier5-src/_shared/owner-module-data.ts +105 -37
  65. package/templates/portfolio-creative-owner/tier5-src/himi-owner-lite-aria-history/index.ts +1 -0
  66. package/templates/portfolio-creative-owner/tier5-src/himi-owner-lite-home/index.ts +5 -0
  67. package/templates/portfolio-creative-owner/tier5-src/himi-owner-lite-manage/index.ts +4 -2
  68. package/templates/restaurant/tier5-src/_shared/engine-intl.ts +57 -16
  69. package/templates/restaurant-owner/dev/index.ts +62 -37
  70. package/templates/restaurant-owner/tier5-src/_shared/aria-chat.ts +31 -16
  71. package/templates/restaurant-owner/tier5-src/_shared/engine-intl.ts +57 -16
  72. package/templates/restaurant-owner/tier5-src/_shared/owner-module-data.ts +105 -37
  73. package/templates/restaurant-owner/tier5-src/himi-owner-lite-aria-history/index.ts +1 -0
  74. package/templates/restaurant-owner/tier5-src/himi-owner-lite-home/index.ts +5 -0
  75. package/templates/restaurant-owner/tier5-src/himi-owner-lite-manage/index.ts +4 -2
  76. package/templates/retail-store/tier5-src/_shared/engine-intl.ts +57 -16
  77. package/templates/retail-store-owner/dev/index.ts +62 -37
  78. package/templates/retail-store-owner/tier5-src/_shared/aria-chat.ts +31 -16
  79. package/templates/retail-store-owner/tier5-src/_shared/engine-intl.ts +57 -16
  80. package/templates/retail-store-owner/tier5-src/_shared/owner-module-data.ts +105 -37
  81. package/templates/retail-store-owner/tier5-src/himi-owner-lite-aria-history/index.ts +1 -0
  82. package/templates/retail-store-owner/tier5-src/himi-owner-lite-home/index.ts +5 -0
  83. package/templates/retail-store-owner/tier5-src/himi-owner-lite-manage/index.ts +4 -2
  84. package/templates/yoga-studio/tier5-src/_shared/engine-intl.ts +57 -16
  85. package/templates/yoga-studio-owner/dev/index.ts +62 -37
  86. package/templates/yoga-studio-owner/tier5-src/_shared/aria-chat.ts +31 -16
  87. package/templates/yoga-studio-owner/tier5-src/_shared/engine-intl.ts +57 -16
  88. package/templates/yoga-studio-owner/tier5-src/_shared/owner-module-data.ts +105 -37
  89. package/templates/yoga-studio-owner/tier5-src/himi-owner-lite-aria-history/index.ts +1 -0
  90. package/templates/yoga-studio-owner/tier5-src/himi-owner-lite-home/index.ts +5 -0
  91. package/templates/yoga-studio-owner/tier5-src/himi-owner-lite-manage/index.ts +4 -2
@@ -48953,7 +48953,7 @@ const SCREENS = runtimeSetting({
48953
48953
  }
48954
48954
  },
48955
48955
  "modifiers": {
48956
- "hiddenPath": "$service:himiOwnerLiteHome.hideContent"
48956
+ "hiddenPath": "$service:himiOwnerLiteHome.hideSourceFailures"
48957
48957
  }
48958
48958
  },
48959
48959
  {
@@ -50969,7 +50969,8 @@ const SCREENS = runtimeSetting({
50969
50969
  "props": {
50970
50970
  "text": "$service:himiOwnerLiteManage.summary",
50971
50971
  "style": "caption",
50972
- "color": "textSecondary"
50972
+ "color": "textSecondary",
50973
+ "collapseWhenEmpty": true
50973
50974
  }
50974
50975
  }
50975
50976
  },
@@ -51564,6 +51565,9 @@ const SCREENS = runtimeSetting({
51564
51565
  }
51565
51566
  ]
51566
51567
  }
51568
+ },
51569
+ "modifiers": {
51570
+ "hiddenPath": "$service:himiOwnerLiteManage.noSections"
51567
51571
  }
51568
51572
  },
51569
51573
  {
@@ -56403,7 +56407,7 @@ const SCREENS = runtimeSetting({
56403
56407
  "package": "himalaya",
56404
56408
  "type": "HStack",
56405
56409
  "props": {
56406
- "spacing": 16,
56410
+ "spacing": 0,
56407
56411
  "children": [
56408
56412
  {
56409
56413
  "id": "",
@@ -56414,43 +56418,57 @@ const SCREENS = runtimeSetting({
56414
56418
  }
56415
56419
  },
56416
56420
  {
56417
- "id": "himi_owner_lite_aria.history",
56418
- "body": {
56419
- "package": "himalaya",
56420
- "type": "Text",
56421
- "props": {
56422
- "text": "History",
56423
- "style": "bodyEmphasis",
56424
- "color": "accentPrimary",
56425
- "maxLines": 1
56426
- }
56427
- },
56428
- "modifiers": {
56429
- "onTap": {
56430
- "actionId": "himi.open",
56431
- "params": {
56432
- "screenId": "himi_owner_lite_aria_history"
56433
- }
56434
- }
56435
- }
56436
- },
56437
- {
56438
- "id": "himi_owner_lite_aria.newchat",
56421
+ "id": "",
56439
56422
  "body": {
56440
56423
  "package": "himalaya",
56441
- "type": "Icon",
56424
+ "type": "HStack",
56442
56425
  "props": {
56443
- "name": "edit",
56444
- "size": 22,
56445
- "tint": "accentPrimary"
56426
+ "spacing": 16,
56427
+ "children": [
56428
+ {
56429
+ "id": "himi_owner_lite_aria.history",
56430
+ "body": {
56431
+ "package": "himalaya",
56432
+ "type": "Text",
56433
+ "props": {
56434
+ "text": "History",
56435
+ "style": "bodyEmphasis",
56436
+ "color": "accentPrimary",
56437
+ "maxLines": 1
56438
+ }
56439
+ },
56440
+ "modifiers": {
56441
+ "onTap": {
56442
+ "actionId": "himi.open",
56443
+ "params": {
56444
+ "screenId": "himi_owner_lite_aria_history"
56445
+ }
56446
+ }
56447
+ }
56448
+ },
56449
+ {
56450
+ "id": "himi_owner_lite_aria.newchat",
56451
+ "body": {
56452
+ "package": "himalaya",
56453
+ "type": "Icon",
56454
+ "props": {
56455
+ "name": "edit",
56456
+ "size": 22,
56457
+ "tint": "accentPrimary"
56458
+ }
56459
+ },
56460
+ "modifiers": {
56461
+ "onTap": {
56462
+ "actionId": "tier5.himiOwnerLiteAria.newChat"
56463
+ },
56464
+ "accessibilityLabel": "New chat",
56465
+ "accessibilityRole": "button",
56466
+ "width": 44,
56467
+ "height": 44
56468
+ }
56469
+ }
56470
+ ]
56446
56471
  }
56447
- },
56448
- "modifiers": {
56449
- "onTap": {
56450
- "actionId": "tier5.himiOwnerLiteAria.newChat"
56451
- },
56452
- "accessibilityLabel": "New chat",
56453
- "accessibilityRole": "button"
56454
56472
  }
56455
56473
  }
56456
56474
  ]
@@ -56811,6 +56829,9 @@ const SCREENS = runtimeSetting({
56811
56829
  }
56812
56830
  ]
56813
56831
  }
56832
+ },
56833
+ "modifiers": {
56834
+ "hiddenPath": "$service:himiOwnerLiteAria.messagesHidden"
56814
56835
  }
56815
56836
  },
56816
56837
  {
@@ -57109,7 +57130,8 @@ const SCREENS = runtimeSetting({
57109
57130
  "text": "$service:himiOwnerLiteAria.error",
57110
57131
  "style": "footnote",
57111
57132
  "color": "danger",
57112
- "maxLines": 3
57133
+ "maxLines": 3,
57134
+ "collapseWhenEmpty": true
57113
57135
  }
57114
57136
  },
57115
57137
  "modifiers": {
@@ -61346,6 +61368,9 @@ const SCREENS = runtimeSetting({
61346
61368
  }
61347
61369
  ]
61348
61370
  }
61371
+ },
61372
+ "modifiers": {
61373
+ "hiddenPath": "$service:himiOwnerLiteAriaHistory.itemsHidden"
61349
61374
  }
61350
61375
  }
61351
61376
  ]
@@ -79,6 +79,7 @@ import { MENTION_PAGE_SIZE, allowlisted, emptyMentionModel, mentionView,
79
79
  type MentionItemRow, type MentionLabels, type MentionModel, type MentionProvider, type MentionView } from "./aria-mentions.js";
80
80
  import { isTransportFailure, ownerTransportFailureText } from "./owner-load-error.js";
81
81
  import { LOCAL_ID_PREFIX, createRowMemo, mintLocalId, transcriptKeys, type RowMemo } from "./aria-hot-path.js";
82
+ import { calendarDay, formatClock, formatDateMedium, formatMonthDay } from "./engine-intl.js";
82
83
 
83
84
  // ---------------------------------------------------------------------------
84
85
  // Shapes
@@ -166,6 +167,9 @@ export interface AriaChatState {
166
167
  * is computed once in `gated` rather than maintained by every reducer. */
167
168
  replyActionsHidden: boolean;
168
169
  messages: AriaBubble[];
170
+ /** Collapses the transcript list while it is empty — an empty list still costs
171
+ * its parent stack a gap. Derived in `gated`, like `stopHidden`. */
172
+ messagesHidden: boolean;
169
173
  /** Non-empty ONLY on the greeting-only empty state. */
170
174
  prompts: AriaPromptChip[];
171
175
  _convId: string;
@@ -1499,7 +1503,7 @@ export function createAriaChat(o: AriaChatOptions): AriaChatCore {
1499
1503
 
1500
1504
  const initialState: AriaChatState = {
1501
1505
  status: "loading", statusText: "", error: "", input: "", copyNote: "", replyActionsHidden: true,
1502
- messages: [], prompts: [], _convId: "", _siteId: "", _pending: "", _pendingRefs: "", _pendingAttach: [],
1506
+ messages: [], messagesHidden: true, prompts: [], _convId: "", _siteId: "", _pending: "", _pendingRefs: "", _pendingAttach: [],
1503
1507
  _pendingAfter: 0, _pendingId: "", _replyAfter: 0, _srvUsers: 0, _srvAssistants: 0,
1504
1508
  _abortId: "", _turnId: "", stopHidden: true, ok: false,
1505
1509
  listening: false, micHidden: !o.dictation, listeningHidden: true,
@@ -2460,10 +2464,12 @@ export function createAriaChat(o: AriaChatOptions): AriaChatCore {
2460
2464
  const listening = s.listening === true;
2461
2465
  const micHidden = !o.dictation || dictationAvailable === false || listening;
2462
2466
  const listeningHidden = !listening;
2467
+ // And the transcript list: hidden while empty, so it costs its stack no gap.
2468
+ const messagesHidden = s.messages.length === 0;
2463
2469
  const actioned = s.stopHidden === hidden && s.replyActionsHidden === replyActionsHidden
2464
- && s.micHidden === micHidden && s.listeningHidden === listeningHidden
2470
+ && s.micHidden === micHidden && s.listeningHidden === listeningHidden && s.messagesHidden === messagesHidden
2465
2471
  ? s
2466
- : { ...s, stopHidden: hidden, replyActionsHidden, micHidden, listeningHidden };
2472
+ : { ...s, stopHidden: hidden, replyActionsHidden, micHidden, listeningHidden, messagesHidden };
2467
2473
  // The attachment projection rides the same exit, for the same reason: one
2468
2474
  // place that every action's result passes through, so no reducer can hand
2469
2475
  // back a stale copy of the chips. Seeded first, so the very first action of
@@ -3493,6 +3499,9 @@ export interface AriaHistoryState {
3493
3499
  items: AriaHistoryRow[];
3494
3500
  /** Non-empty ONLY when the list is empty (collapses otherwise). */
3495
3501
  emptyText: string;
3502
+ /** Collapses the (empty) row list, which would otherwise still cost its parent
3503
+ * stack a gap. True until a load lands rows. */
3504
+ itemsHidden: boolean;
3496
3505
  /** The business the rows in `items` belong to. A kept list is only safe to
3497
3506
  * keep while this still matches, so it is state rather than a closure — the
3498
3507
  * chat service tracks its own `_siteId` for the same reason. */
@@ -3512,6 +3521,8 @@ export interface AriaHistoryLabels {
3512
3521
  last7?: Resolvable<string>;
3513
3522
  last30?: Resolvable<string>;
3514
3523
  older?: Resolvable<string>;
3524
+ /** Prefix for a conversation from today: "Today · 9:12 AM". */
3525
+ today?: Resolvable<string>;
3515
3526
  }
3516
3527
 
3517
3528
  export interface AriaHistoryOptions {
@@ -3525,8 +3536,8 @@ export interface AriaHistoryOptions {
3525
3536
  localHistory?: boolean;
3526
3537
  }
3527
3538
 
3528
- interface BucketLabels { last7: string; last30: string; older: string; }
3529
- const STOCK_BUCKETS: BucketLabels = { last7: "Last 7 days", last30: "Last 30 days", older: "Older" };
3539
+ interface BucketLabels { last7: string; last30: string; older: string; today: string; }
3540
+ const STOCK_BUCKETS: BucketLabels = { last7: "Last 7 days", last30: "Last 30 days", older: "Older", today: "Today" };
3530
3541
 
3531
3542
  /** Parse an ISO-8601 string (serialized Timestamp) or epoch-ms into ms. 0 when
3532
3543
  * absent or unparseable. */
@@ -3539,15 +3550,17 @@ export function toMs(v: unknown): number {
3539
3550
  return 0;
3540
3551
  }
3541
3552
 
3542
- function formatTs(ms: number): string {
3553
+ /** A history card's date, through the shared engine-intl shapes: "Today · 9:12 AM" for today,
3554
+ * "Sep 21" earlier this year, "Sep 21, 2025" before that. It was `toLocaleString()` —
3555
+ * "9/24/2026, 9:12:00 AM", seconds and all. These are the owner's own
3556
+ * conversations, so the device's calendar is the right one. */
3557
+ function formatTs(ms: number, now: number, today: string): string {
3543
3558
  if (!ms) return "";
3544
- try {
3545
- const d = new Date(ms);
3546
- if (isNaN(d.getTime())) return "";
3547
- return d.toLocaleString();
3548
- } catch {
3549
- return "";
3550
- }
3559
+ const d = new Date(ms);
3560
+ if (isNaN(d.getTime())) return "";
3561
+ const day = calendarDay(d), current = calendarDay(new Date(now));
3562
+ if (day === current) return `${today} · ${formatClock(d)}`;
3563
+ return day.slice(0, 4) === current.slice(0, 4) ? formatMonthDay(d) : formatDateMedium(d);
3551
3564
  }
3552
3565
 
3553
3566
  const DAY = 24 * 60 * 60 * 1000;
@@ -3568,7 +3581,7 @@ export function bucketRows(entries: Array<{ id: string; title: string; ms: numbe
3568
3581
  const b = bucketOf(e.ms, now, labels);
3569
3582
  const section = b === lastBucket ? "" : b;
3570
3583
  lastBucket = b;
3571
- return { id: e.id, title: e.title, subtitle: formatTs(e.ms), section };
3584
+ return { id: e.id, title: e.title, subtitle: formatTs(e.ms, now, labels.today), section };
3572
3585
  });
3573
3586
  }
3574
3587
 
@@ -3601,9 +3614,10 @@ export function createAriaHistory(o: AriaHistoryOptions) {
3601
3614
  last7: res(o.labels?.last7 ?? STOCK_BUCKETS.last7),
3602
3615
  last30: res(o.labels?.last30 ?? STOCK_BUCKETS.last30),
3603
3616
  older: res(o.labels?.older ?? STOCK_BUCKETS.older),
3617
+ today: res(o.labels?.today ?? STOCK_BUCKETS.today),
3604
3618
  });
3605
3619
  const initialState: AriaHistoryState = {
3606
- status: "loading", items: [], emptyText: "", _siteId: "", failed: false,
3620
+ status: "loading", items: [], itemsHidden: true, emptyText: "", _siteId: "", failed: false,
3607
3621
  };
3608
3622
  return {
3609
3623
  initialState,
@@ -3631,7 +3645,7 @@ export function createAriaHistory(o: AriaHistoryOptions) {
3631
3645
  // owner the previous business's conversation titles, which is precisely
3632
3646
  // the leak `localHistory: false` is set to avoid.
3633
3647
  if (fetched === null && s.items.length && s._siteId === site) {
3634
- return { ...s, status: "ready", failed: true };
3648
+ return { ...s, status: "ready", itemsHidden: false, failed: true };
3635
3649
  }
3636
3650
 
3637
3651
  // A SUCCESSFUL empty answer is authoritative and DOES clear. The tempting
@@ -3651,6 +3665,7 @@ export function createAriaHistory(o: AriaHistoryOptions) {
3651
3665
  ...s,
3652
3666
  status: "ready",
3653
3667
  items,
3668
+ itemsHidden: items.length === 0,
3654
3669
  emptyText: items.length ? "" : emptyText(),
3655
3670
  _siteId: site,
3656
3671
  failed: fetched === null,
@@ -48,6 +48,36 @@ const MONTHS_LONG = [
48
48
  "July", "August", "September", "October", "November", "December",
49
49
  ] as const;
50
50
 
51
+ /**
52
+ * A DateTimeFormat for `timeZone` when one is given and this engine knows it. An unknown or
53
+ * malformed IANA id is a RangeError in ECMA-402; these helpers never throw, so it degrades to
54
+ * the device zone rather than killing the screen. Without Intl there is no zone database at all,
55
+ * and the fallbacks below render in the device zone for the same reason.
56
+ *
57
+ * Formatters are memoised per (locale, zone, options): a management page formats several dates
58
+ * per row, and building a DateTimeFormat (or throwing on a bad zone) each time is not free on
59
+ * JSC or QuickJS. Only call it where `hasIntl()` holds — every caller does.
60
+ */
61
+ const FORMATTERS = new Map<string, Intl.DateTimeFormat>();
62
+ function dateFormat(locale: string, options: Intl.DateTimeFormatOptions, timeZone?: string): Intl.DateTimeFormat {
63
+ const key = `${locale}|${timeZone ?? ""}|${JSON.stringify(options)}`;
64
+ let formatter = FORMATTERS.get(key);
65
+ if (!formatter) {
66
+ if (hasIntl()) {
67
+ if (timeZone) {
68
+ try {
69
+ formatter = new Intl.DateTimeFormat(locale, { ...options, timeZone });
70
+ } catch {
71
+ /* unknown zone: device zone below, remembered under this key */
72
+ }
73
+ }
74
+ formatter ??= new Intl.DateTimeFormat(locale, options);
75
+ FORMATTERS.set(key, formatter);
76
+ }
77
+ }
78
+ return formatter as Intl.DateTimeFormat;
79
+ }
80
+
51
81
  // The four shapes below are not invented — they are the option bags this corpus actually uses,
52
82
  // counted across every bundle: "Jan 5, 2026" (33 sites), "Jan 5" (11), "Mon, Jan 5, 3:07 PM" (8)
53
83
  // and "Jan 5, 3:07 PM" (4). Naming them means a conversion is a one-line swap rather than a
@@ -55,46 +85,46 @@ const MONTHS_LONG = [
55
85
  // ECMA-402 in engine-intl-fallback.test.ts.
56
86
 
57
87
  /** `{ month: "short", day: "numeric", year: "numeric" }` — "Jan 5, 2026". */
58
- export function formatDateMedium(date: Date, locale = "en-US"): string {
88
+ export function formatDateMedium(date: Date, locale = "en-US", timeZone?: string): string {
59
89
  if (hasIntl()) {
60
- return new Intl.DateTimeFormat(locale, { month: "short", day: "numeric", year: "numeric" }).format(date);
90
+ return dateFormat(locale, { month: "short", day: "numeric", year: "numeric" }, timeZone).format(date);
61
91
  }
62
92
  return `${MONTHS_SHORT[date.getMonth()]} ${date.getDate()}, ${date.getFullYear()}`;
63
93
  }
64
94
 
65
95
  /** `{ month: "short", day: "numeric" }` — "Jan 5". */
66
- export function formatMonthDay(date: Date, locale = "en-US"): string {
96
+ export function formatMonthDay(date: Date, locale = "en-US", timeZone?: string): string {
67
97
  if (hasIntl()) {
68
- return new Intl.DateTimeFormat(locale, { month: "short", day: "numeric" }).format(date);
98
+ return dateFormat(locale, { month: "short", day: "numeric" }, timeZone).format(date);
69
99
  }
70
100
  return `${MONTHS_SHORT[date.getMonth()]} ${date.getDate()}`;
71
101
  }
72
102
 
73
103
  /** `{ month: "long", day: "numeric" }` — "January 5". */
74
- export function formatMonthDayLong(date: Date, locale = "en-US"): string {
104
+ export function formatMonthDayLong(date: Date, locale = "en-US", timeZone?: string): string {
75
105
  if (hasIntl()) {
76
- return new Intl.DateTimeFormat(locale, { month: "long", day: "numeric" }).format(date);
106
+ return dateFormat(locale, { month: "long", day: "numeric" }, timeZone).format(date);
77
107
  }
78
108
  return `${MONTHS_LONG[date.getMonth()]} ${date.getDate()}`;
79
109
  }
80
110
 
81
111
  /** `{ weekday: "short", month: "short", day: "numeric", hour: "numeric", minute: "2-digit" }`
82
112
  * — "Mon, Jan 5, 3:07 PM". */
83
- export function formatWeekdayDateTime(date: Date, locale = "en-US"): string {
113
+ export function formatWeekdayDateTime(date: Date, locale = "en-US", timeZone?: string): string {
84
114
  if (hasIntl()) {
85
- return new Intl.DateTimeFormat(locale, {
115
+ return dateFormat(locale, {
86
116
  weekday: "short", month: "short", day: "numeric", hour: "numeric", minute: "2-digit",
87
- }).format(date);
117
+ }, timeZone).format(date);
88
118
  }
89
119
  return `${WEEKDAYS_SHORT[date.getDay()]}, ${MONTHS_SHORT[date.getMonth()]} ${date.getDate()}, ${clock12(date)}`;
90
120
  }
91
121
 
92
122
  /** `{ month: "short", day: "numeric", hour: "numeric", minute: "2-digit" }` — "Jan 5, 3:07 PM". */
93
- export function formatMonthDayTime(date: Date, locale = "en-US"): string {
123
+ export function formatMonthDayTime(date: Date, locale = "en-US", timeZone?: string): string {
94
124
  if (hasIntl()) {
95
- return new Intl.DateTimeFormat(locale, {
125
+ return dateFormat(locale, {
96
126
  month: "short", day: "numeric", hour: "numeric", minute: "2-digit",
97
- }).format(date);
127
+ }, timeZone).format(date);
98
128
  }
99
129
  return `${MONTHS_SHORT[date.getMonth()]} ${date.getDate()}, ${clock12(date)}`;
100
130
  }
@@ -380,9 +410,9 @@ export function normalizeFormattedPrice(formatted: string): string {
380
410
  return `${m[1]}${m[3]}${m[2]}`;
381
411
  }
382
412
 
383
- function clockParts(d: Date, locale: string): { time: string; meridiem: string } {
413
+ function clockParts(d: Date, locale: string, timeZone?: string): { time: string; meridiem: string } {
384
414
  const full = hasIntl()
385
- ? new Intl.DateTimeFormat(locale, { hour: "numeric", minute: "2-digit", hour12: true }).format(d)
415
+ ? dateFormat(locale, { hour: "numeric", minute: "2-digit", hour12: true }, timeZone).format(d)
386
416
  : clock12(d);
387
417
  // ICU puts a narrow no-break space before the meridiem; normalize so callers can split on it.
388
418
  const clean = full.replace(/[  ]/g, " ");
@@ -391,8 +421,8 @@ function clockParts(d: Date, locale: string): { time: string; meridiem: string }
391
421
  }
392
422
 
393
423
  /** "8:00 PM" — the one clock every customer screen uses (12-hour, en-US shape). */
394
- export function formatClock(date: Date, locale = "en-US"): string {
395
- const { time, meridiem } = clockParts(date, locale);
424
+ export function formatClock(date: Date, locale = "en-US", timeZone?: string): string {
425
+ const { time, meridiem } = clockParts(date, locale, timeZone);
396
426
  return meridiem ? `${time} ${meridiem}` : time;
397
427
  }
398
428
 
@@ -403,3 +433,14 @@ export function isPastDate(iso: string | undefined | null, now: number = Date.no
403
433
  const t = Date.parse(iso);
404
434
  return !Number.isNaN(t) && t < now;
405
435
  }
436
+
437
+ /** The calendar day `date` falls on in `timeZone` (device zone when absent, unknown, or when
438
+ * the engine has no Intl), as `YYYY-MM-DD`. For "is this today / this year" comparisons. */
439
+ export function calendarDay(date: Date, timeZone?: string): string {
440
+ if (hasIntl()) {
441
+ const parts = dateFormat("en-CA", { year: "numeric", month: "2-digit", day: "2-digit" }, timeZone).formatToParts(date);
442
+ const get = (type: string) => parts.find((p) => p.type === type)?.value ?? "";
443
+ return `${get("year")}-${get("month")}-${get("day")}`;
444
+ }
445
+ return `${date.getFullYear()}-${pad2(date.getMonth() + 1)}-${pad2(date.getDate())}`;
446
+ }