@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
  {
@@ -50601,7 +50601,8 @@ const SCREENS = runtimeSetting({
50601
50601
  "props": {
50602
50602
  "text": "$service:himiOwnerLiteManage.summary",
50603
50603
  "style": "caption",
50604
- "color": "textSecondary"
50604
+ "color": "textSecondary",
50605
+ "collapseWhenEmpty": true
50605
50606
  }
50606
50607
  }
50607
50608
  },
@@ -51196,6 +51197,9 @@ const SCREENS = runtimeSetting({
51196
51197
  }
51197
51198
  ]
51198
51199
  }
51200
+ },
51201
+ "modifiers": {
51202
+ "hiddenPath": "$service:himiOwnerLiteManage.noSections"
51199
51203
  }
51200
51204
  },
51201
51205
  {
@@ -56035,7 +56039,7 @@ const SCREENS = runtimeSetting({
56035
56039
  "package": "himalaya",
56036
56040
  "type": "HStack",
56037
56041
  "props": {
56038
- "spacing": 16,
56042
+ "spacing": 0,
56039
56043
  "children": [
56040
56044
  {
56041
56045
  "id": "",
@@ -56046,43 +56050,57 @@ const SCREENS = runtimeSetting({
56046
56050
  }
56047
56051
  },
56048
56052
  {
56049
- "id": "himi_owner_lite_aria.history",
56050
- "body": {
56051
- "package": "himalaya",
56052
- "type": "Text",
56053
- "props": {
56054
- "text": "History",
56055
- "style": "bodyEmphasis",
56056
- "color": "accentPrimary",
56057
- "maxLines": 1
56058
- }
56059
- },
56060
- "modifiers": {
56061
- "onTap": {
56062
- "actionId": "himi.open",
56063
- "params": {
56064
- "screenId": "himi_owner_lite_aria_history"
56065
- }
56066
- }
56067
- }
56068
- },
56069
- {
56070
- "id": "himi_owner_lite_aria.newchat",
56053
+ "id": "",
56071
56054
  "body": {
56072
56055
  "package": "himalaya",
56073
- "type": "Icon",
56056
+ "type": "HStack",
56074
56057
  "props": {
56075
- "name": "edit",
56076
- "size": 22,
56077
- "tint": "accentPrimary"
56058
+ "spacing": 16,
56059
+ "children": [
56060
+ {
56061
+ "id": "himi_owner_lite_aria.history",
56062
+ "body": {
56063
+ "package": "himalaya",
56064
+ "type": "Text",
56065
+ "props": {
56066
+ "text": "History",
56067
+ "style": "bodyEmphasis",
56068
+ "color": "accentPrimary",
56069
+ "maxLines": 1
56070
+ }
56071
+ },
56072
+ "modifiers": {
56073
+ "onTap": {
56074
+ "actionId": "himi.open",
56075
+ "params": {
56076
+ "screenId": "himi_owner_lite_aria_history"
56077
+ }
56078
+ }
56079
+ }
56080
+ },
56081
+ {
56082
+ "id": "himi_owner_lite_aria.newchat",
56083
+ "body": {
56084
+ "package": "himalaya",
56085
+ "type": "Icon",
56086
+ "props": {
56087
+ "name": "edit",
56088
+ "size": 22,
56089
+ "tint": "accentPrimary"
56090
+ }
56091
+ },
56092
+ "modifiers": {
56093
+ "onTap": {
56094
+ "actionId": "tier5.himiOwnerLiteAria.newChat"
56095
+ },
56096
+ "accessibilityLabel": "New chat",
56097
+ "accessibilityRole": "button",
56098
+ "width": 44,
56099
+ "height": 44
56100
+ }
56101
+ }
56102
+ ]
56078
56103
  }
56079
- },
56080
- "modifiers": {
56081
- "onTap": {
56082
- "actionId": "tier5.himiOwnerLiteAria.newChat"
56083
- },
56084
- "accessibilityLabel": "New chat",
56085
- "accessibilityRole": "button"
56086
56104
  }
56087
56105
  }
56088
56106
  ]
@@ -56443,6 +56461,9 @@ const SCREENS = runtimeSetting({
56443
56461
  }
56444
56462
  ]
56445
56463
  }
56464
+ },
56465
+ "modifiers": {
56466
+ "hiddenPath": "$service:himiOwnerLiteAria.messagesHidden"
56446
56467
  }
56447
56468
  },
56448
56469
  {
@@ -56741,7 +56762,8 @@ const SCREENS = runtimeSetting({
56741
56762
  "text": "$service:himiOwnerLiteAria.error",
56742
56763
  "style": "footnote",
56743
56764
  "color": "danger",
56744
- "maxLines": 3
56765
+ "maxLines": 3,
56766
+ "collapseWhenEmpty": true
56745
56767
  }
56746
56768
  },
56747
56769
  "modifiers": {
@@ -60978,6 +61000,9 @@ const SCREENS = runtimeSetting({
60978
61000
  }
60979
61001
  ]
60980
61002
  }
61003
+ },
61004
+ "modifiers": {
61005
+ "hiddenPath": "$service:himiOwnerLiteAriaHistory.itemsHidden"
60981
61006
  }
60982
61007
  }
60983
61008
  ]
@@ -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
+ }