@wix/himalaya-cli 0.1210.0 → 0.1211.0

package/templates/community-club/tier5-src/_shared/engine-intl.ts

@@ -48,6 +48,36 @@ const MONTHS_LONG = [
   "July", "August", "September", "October", "November", "December",
 ] as const;
 
+/**
+ * A DateTimeFormat for `timeZone` when one is given and this engine knows it. An unknown or
+ * malformed IANA id is a RangeError in ECMA-402; these helpers never throw, so it degrades to
+ * the device zone rather than killing the screen. Without Intl there is no zone database at all,
+ * and the fallbacks below render in the device zone for the same reason.
+ *
+ * Formatters are memoised per (locale, zone, options): a management page formats several dates
+ * per row, and building a DateTimeFormat (or throwing on a bad zone) each time is not free on
+ * JSC or QuickJS. Only call it where `hasIntl()` holds — every caller does.
+ */
+const FORMATTERS = new Map<string, Intl.DateTimeFormat>();
+function dateFormat(locale: string, options: Intl.DateTimeFormatOptions, timeZone?: string): Intl.DateTimeFormat {
+  const key = `${locale}|${timeZone ?? ""}|${JSON.stringify(options)}`;
+  let formatter = FORMATTERS.get(key);
+  if (!formatter) {
+    if (hasIntl()) {
+      if (timeZone) {
+        try {
+          formatter = new Intl.DateTimeFormat(locale, { ...options, timeZone });
+        } catch {
+          /* unknown zone: device zone below, remembered under this key */
+        }
+      }
+      formatter ??= new Intl.DateTimeFormat(locale, options);
+      FORMATTERS.set(key, formatter);
+    }
+  }
+  return formatter as Intl.DateTimeFormat;
+}
+
 // The four shapes below are not invented — they are the option bags this corpus actually uses,
 // counted across every bundle: "Jan 5, 2026" (33 sites), "Jan 5" (11), "Mon, Jan 5, 3:07 PM" (8)
 // 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 = [
 // ECMA-402 in engine-intl-fallback.test.ts.
 
 /** `{ month: "short", day: "numeric", year: "numeric" }` — "Jan 5, 2026". */
-export function formatDateMedium(date: Date, locale = "en-US"): string {
+export function formatDateMedium(date: Date, locale = "en-US", timeZone?: string): string {
   if (hasIntl()) {
-    return new Intl.DateTimeFormat(locale, { month: "short", day: "numeric", year: "numeric" }).format(date);
+    return dateFormat(locale, { month: "short", day: "numeric", year: "numeric" }, timeZone).format(date);
   }
   return `${MONTHS_SHORT[date.getMonth()]} ${date.getDate()}, ${date.getFullYear()}`;
 }
 
 /** `{ month: "short", day: "numeric" }` — "Jan 5". */
-export function formatMonthDay(date: Date, locale = "en-US"): string {
+export function formatMonthDay(date: Date, locale = "en-US", timeZone?: string): string {
   if (hasIntl()) {
-    return new Intl.DateTimeFormat(locale, { month: "short", day: "numeric" }).format(date);
+    return dateFormat(locale, { month: "short", day: "numeric" }, timeZone).format(date);
   }
   return `${MONTHS_SHORT[date.getMonth()]} ${date.getDate()}`;
 }
 
 /** `{ month: "long", day: "numeric" }` — "January 5". */
-export function formatMonthDayLong(date: Date, locale = "en-US"): string {
+export function formatMonthDayLong(date: Date, locale = "en-US", timeZone?: string): string {
   if (hasIntl()) {
-    return new Intl.DateTimeFormat(locale, { month: "long", day: "numeric" }).format(date);
+    return dateFormat(locale, { month: "long", day: "numeric" }, timeZone).format(date);
   }
   return `${MONTHS_LONG[date.getMonth()]} ${date.getDate()}`;
 }
 
 /** `{ weekday: "short", month: "short", day: "numeric", hour: "numeric", minute: "2-digit" }`
  *  — "Mon, Jan 5, 3:07 PM". */
-export function formatWeekdayDateTime(date: Date, locale = "en-US"): string {
+export function formatWeekdayDateTime(date: Date, locale = "en-US", timeZone?: string): string {
   if (hasIntl()) {
-    return new Intl.DateTimeFormat(locale, {
+    return dateFormat(locale, {
       weekday: "short", month: "short", day: "numeric", hour: "numeric", minute: "2-digit",
-    }).format(date);
+    }, timeZone).format(date);
   }
   return `${WEEKDAYS_SHORT[date.getDay()]}, ${MONTHS_SHORT[date.getMonth()]} ${date.getDate()}, ${clock12(date)}`;
 }
 
 /** `{ month: "short", day: "numeric", hour: "numeric", minute: "2-digit" }` — "Jan 5, 3:07 PM". */
-export function formatMonthDayTime(date: Date, locale = "en-US"): string {
+export function formatMonthDayTime(date: Date, locale = "en-US", timeZone?: string): string {
   if (hasIntl()) {
-    return new Intl.DateTimeFormat(locale, {
+    return dateFormat(locale, {
       month: "short", day: "numeric", hour: "numeric", minute: "2-digit",
-    }).format(date);
+    }, timeZone).format(date);
   }
   return `${MONTHS_SHORT[date.getMonth()]} ${date.getDate()}, ${clock12(date)}`;
 }
@@ -380,9 +410,9 @@ export function normalizeFormattedPrice(formatted: string): string {
   return `${m[1]}${m[3]}${m[2]}`;
 }
 
-function clockParts(d: Date, locale: string): { time: string; meridiem: string } {
+function clockParts(d: Date, locale: string, timeZone?: string): { time: string; meridiem: string } {
   const full = hasIntl()
-    ? new Intl.DateTimeFormat(locale, { hour: "numeric", minute: "2-digit", hour12: true }).format(d)
+    ? dateFormat(locale, { hour: "numeric", minute: "2-digit", hour12: true }, timeZone).format(d)
     : clock12(d);
   // ICU puts a narrow no-break space before the meridiem; normalize so callers can split on it.
   const clean = full.replace(/[  ]/g, " ");
@@ -391,8 +421,8 @@ function clockParts(d: Date, locale: string): { time: string; meridiem: string }
 }
 
 /** "8:00 PM" — the one clock every customer screen uses (12-hour, en-US shape). */
-export function formatClock(date: Date, locale = "en-US"): string {
-  const { time, meridiem } = clockParts(date, locale);
+export function formatClock(date: Date, locale = "en-US", timeZone?: string): string {
+  const { time, meridiem } = clockParts(date, locale, timeZone);
   return meridiem ? `${time} ${meridiem}` : time;
 }
 
@@ -403,3 +433,14 @@ export function isPastDate(iso: string | undefined | null, now: number = Date.no
   const t = Date.parse(iso);
   return !Number.isNaN(t) && t < now;
 }
+
+/** The calendar day `date` falls on in `timeZone` (device zone when absent, unknown, or when
+ *  the engine has no Intl), as `YYYY-MM-DD`. For "is this today / this year" comparisons. */
+export function calendarDay(date: Date, timeZone?: string): string {
+  if (hasIntl()) {
+    const parts = dateFormat("en-CA", { year: "numeric", month: "2-digit", day: "2-digit" }, timeZone).formatToParts(date);
+    const get = (type: string) => parts.find((p) => p.type === type)?.value ?? "";
+    return `${get("year")}-${get("month")}-${get("day")}`;
+  }
+  return `${date.getFullYear()}-${pad2(date.getMonth() + 1)}-${pad2(date.getDate())}`;
+}

package/templates/community-club-owner/dev/index.ts

@@ -48953,7 +48953,7 @@ const SCREENS = runtimeSetting({
                 }
               },
               "modifiers": {
-                "hiddenPath": "$service:himiOwnerLiteHome.hideContent"
+                "hiddenPath": "$service:himiOwnerLiteHome.hideSourceFailures"
               }
             },
             {
@@ -50969,7 +50969,8 @@ const SCREENS = runtimeSetting({
                                   "props": {
                                     "text": "$service:himiOwnerLiteManage.summary",
                                     "style": "caption",
-                                    "color": "textSecondary"
+                                    "color": "textSecondary",
+                                    "collapseWhenEmpty": true
                                   }
                                 }
                               },
@@ -51564,6 +51565,9 @@ const SCREENS = runtimeSetting({
                                       }
                                     ]
                                   }
+                                },
+                                "modifiers": {
+                                  "hiddenPath": "$service:himiOwnerLiteManage.noSections"
                                 }
                               },
                               {
@@ -56403,7 +56407,7 @@ const SCREENS = runtimeSetting({
                 "package": "himalaya",
                 "type": "HStack",
                 "props": {
-                  "spacing": 16,
+                  "spacing": 0,
                   "children": [
                     {
                       "id": "",
@@ -56414,43 +56418,57 @@ const SCREENS = runtimeSetting({
                       }
                     },
                     {
-                      "id": "himi_owner_lite_aria.history",
-                      "body": {
-                        "package": "himalaya",
-                        "type": "Text",
-                        "props": {
-                          "text": "History",
-                          "style": "bodyEmphasis",
-                          "color": "accentPrimary",
-                          "maxLines": 1
-                        }
-                      },
-                      "modifiers": {
-                        "onTap": {
-                          "actionId": "himi.open",
-                          "params": {
-                            "screenId": "himi_owner_lite_aria_history"
-                          }
-                        }
-                      }
-                    },
-                    {
-                      "id": "himi_owner_lite_aria.newchat",
+                      "id": "",
                       "body": {
                         "package": "himalaya",
-                        "type": "Icon",
+                        "type": "HStack",
                         "props": {
-                          "name": "edit",
-                          "size": 22,
-                          "tint": "accentPrimary"
+                          "spacing": 16,
+                          "children": [
+                            {
+                              "id": "himi_owner_lite_aria.history",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "Text",
+                                "props": {
+                                  "text": "History",
+                                  "style": "bodyEmphasis",
+                                  "color": "accentPrimary",
+                                  "maxLines": 1
+                                }
+                              },
+                              "modifiers": {
+                                "onTap": {
+                                  "actionId": "himi.open",
+                                  "params": {
+                                    "screenId": "himi_owner_lite_aria_history"
+                                  }
+                                }
+                              }
+                            },
+                            {
+                              "id": "himi_owner_lite_aria.newchat",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "Icon",
+                                "props": {
+                                  "name": "edit",
+                                  "size": 22,
+                                  "tint": "accentPrimary"
+                                }
+                              },
+                              "modifiers": {
+                                "onTap": {
+                                  "actionId": "tier5.himiOwnerLiteAria.newChat"
+                                },
+                                "accessibilityLabel": "New chat",
+                                "accessibilityRole": "button",
+                                "width": 44,
+                                "height": 44
+                              }
+                            }
+                          ]
                         }
-                      },
-                      "modifiers": {
-                        "onTap": {
-                          "actionId": "tier5.himiOwnerLiteAria.newChat"
-                        },
-                        "accessibilityLabel": "New chat",
-                        "accessibilityRole": "button"
                       }
                     }
                   ]
@@ -56811,6 +56829,9 @@ const SCREENS = runtimeSetting({
                     }
                   ]
                 }
+              },
+              "modifiers": {
+                "hiddenPath": "$service:himiOwnerLiteAria.messagesHidden"
               }
             },
             {
@@ -57109,7 +57130,8 @@ const SCREENS = runtimeSetting({
                   "text": "$service:himiOwnerLiteAria.error",
                   "style": "footnote",
                   "color": "danger",
-                  "maxLines": 3
+                  "maxLines": 3,
+                  "collapseWhenEmpty": true
                 }
               },
               "modifiers": {
@@ -61346,6 +61368,9 @@ const SCREENS = runtimeSetting({
                     }
                   ]
                 }
+              },
+              "modifiers": {
+                "hiddenPath": "$service:himiOwnerLiteAriaHistory.itemsHidden"
               }
             }
           ]

package/templates/community-club-owner/tier5-src/_shared/aria-chat.ts

@@ -79,6 +79,7 @@ import { MENTION_PAGE_SIZE, allowlisted, emptyMentionModel, mentionView,
   type MentionItemRow, type MentionLabels, type MentionModel, type MentionProvider, type MentionView } from "./aria-mentions.js";
 import { isTransportFailure, ownerTransportFailureText } from "./owner-load-error.js";
 import { LOCAL_ID_PREFIX, createRowMemo, mintLocalId, transcriptKeys, type RowMemo } from "./aria-hot-path.js";
+import { calendarDay, formatClock, formatDateMedium, formatMonthDay } from "./engine-intl.js";
 
 // ---------------------------------------------------------------------------
 // Shapes
@@ -166,6 +167,9 @@ export interface AriaChatState {
    *  is computed once in `gated` rather than maintained by every reducer. */
   replyActionsHidden: boolean;
   messages: AriaBubble[];
+  /** Collapses the transcript list while it is empty — an empty list still costs
+   *  its parent stack a gap. Derived in `gated`, like `stopHidden`. */
+  messagesHidden: boolean;
   /** Non-empty ONLY on the greeting-only empty state. */
   prompts: AriaPromptChip[];
   _convId: string;
@@ -1499,7 +1503,7 @@ export function createAriaChat(o: AriaChatOptions): AriaChatCore {
 
   const initialState: AriaChatState = {
     status: "loading", statusText: "", error: "", input: "", copyNote: "", replyActionsHidden: true,
-    messages: [], prompts: [], _convId: "", _siteId: "", _pending: "", _pendingRefs: "", _pendingAttach: [],
+    messages: [], messagesHidden: true, prompts: [], _convId: "", _siteId: "", _pending: "", _pendingRefs: "", _pendingAttach: [],
     _pendingAfter: 0, _pendingId: "", _replyAfter: 0, _srvUsers: 0, _srvAssistants: 0,
     _abortId: "", _turnId: "", stopHidden: true, ok: false,
     listening: false, micHidden: !o.dictation, listeningHidden: true,
@@ -2460,10 +2464,12 @@ export function createAriaChat(o: AriaChatOptions): AriaChatCore {
     const listening = s.listening === true;
     const micHidden = !o.dictation || dictationAvailable === false || listening;
     const listeningHidden = !listening;
+    // And the transcript list: hidden while empty, so it costs its stack no gap.
+    const messagesHidden = s.messages.length === 0;
     const actioned = s.stopHidden === hidden && s.replyActionsHidden === replyActionsHidden
-      && s.micHidden === micHidden && s.listeningHidden === listeningHidden
+      && s.micHidden === micHidden && s.listeningHidden === listeningHidden && s.messagesHidden === messagesHidden
       ? s
-      : { ...s, stopHidden: hidden, replyActionsHidden, micHidden, listeningHidden };
+      : { ...s, stopHidden: hidden, replyActionsHidden, micHidden, listeningHidden, messagesHidden };
     // The attachment projection rides the same exit, for the same reason: one
     // place that every action's result passes through, so no reducer can hand
     // back a stale copy of the chips. Seeded first, so the very first action of
@@ -3493,6 +3499,9 @@ export interface AriaHistoryState {
   items: AriaHistoryRow[];
   /** Non-empty ONLY when the list is empty (collapses otherwise). */
   emptyText: string;
+  /** Collapses the (empty) row list, which would otherwise still cost its parent
+   *  stack a gap. True until a load lands rows. */
+  itemsHidden: boolean;
   /** The business the rows in `items` belong to. A kept list is only safe to
    *  keep while this still matches, so it is state rather than a closure — the
    *  chat service tracks its own `_siteId` for the same reason. */
@@ -3512,6 +3521,8 @@ export interface AriaHistoryLabels {
   last7?: Resolvable<string>;
   last30?: Resolvable<string>;
   older?: Resolvable<string>;
+  /** Prefix for a conversation from today: "Today · 9:12 AM". */
+  today?: Resolvable<string>;
 }
 
 export interface AriaHistoryOptions {
@@ -3525,8 +3536,8 @@ export interface AriaHistoryOptions {
   localHistory?: boolean;
 }
 
-interface BucketLabels { last7: string; last30: string; older: string; }
-const STOCK_BUCKETS: BucketLabels = { last7: "Last 7 days", last30: "Last 30 days", older: "Older" };
+interface BucketLabels { last7: string; last30: string; older: string; today: string; }
+const STOCK_BUCKETS: BucketLabels = { last7: "Last 7 days", last30: "Last 30 days", older: "Older", today: "Today" };
 
 /** Parse an ISO-8601 string (serialized Timestamp) or epoch-ms into ms. 0 when
  *  absent or unparseable. */
@@ -3539,15 +3550,17 @@ export function toMs(v: unknown): number {
   return 0;
 }
 
-function formatTs(ms: number): string {
+/** A history card's date, through the shared engine-intl shapes: "Today · 9:12 AM" for today,
+ *  "Sep 21" earlier this year, "Sep 21, 2025" before that. It was `toLocaleString()` —
+ *  "9/24/2026, 9:12:00 AM", seconds and all. These are the owner's own
+ *  conversations, so the device's calendar is the right one. */
+function formatTs(ms: number, now: number, today: string): string {
   if (!ms) return "";
-  try {
-    const d = new Date(ms);
-    if (isNaN(d.getTime())) return "";
-    return d.toLocaleString();
-  } catch {
-    return "";
-  }
+  const d = new Date(ms);
+  if (isNaN(d.getTime())) return "";
+  const day = calendarDay(d), current = calendarDay(new Date(now));
+  if (day === current) return `${today} · ${formatClock(d)}`;
+  return day.slice(0, 4) === current.slice(0, 4) ? formatMonthDay(d) : formatDateMedium(d);
 }
 
 const DAY = 24 * 60 * 60 * 1000;
@@ -3568,7 +3581,7 @@ export function bucketRows(entries: Array<{ id: string; title: string; ms: numbe
     const b = bucketOf(e.ms, now, labels);
     const section = b === lastBucket ? "" : b;
     lastBucket = b;
-    return { id: e.id, title: e.title, subtitle: formatTs(e.ms), section };
+    return { id: e.id, title: e.title, subtitle: formatTs(e.ms, now, labels.today), section };
   });
 }
 
@@ -3601,9 +3614,10 @@ export function createAriaHistory(o: AriaHistoryOptions) {
     last7: res(o.labels?.last7 ?? STOCK_BUCKETS.last7),
     last30: res(o.labels?.last30 ?? STOCK_BUCKETS.last30),
     older: res(o.labels?.older ?? STOCK_BUCKETS.older),
+    today: res(o.labels?.today ?? STOCK_BUCKETS.today),
   });
   const initialState: AriaHistoryState = {
-    status: "loading", items: [], emptyText: "", _siteId: "", failed: false,
+    status: "loading", items: [], itemsHidden: true, emptyText: "", _siteId: "", failed: false,
   };
   return {
     initialState,
@@ -3631,7 +3645,7 @@ export function createAriaHistory(o: AriaHistoryOptions) {
       // owner the previous business's conversation titles, which is precisely
       // the leak `localHistory: false` is set to avoid.
       if (fetched === null && s.items.length && s._siteId === site) {
-        return { ...s, status: "ready", failed: true };
+        return { ...s, status: "ready", itemsHidden: false, failed: true };
       }
 
       // A SUCCESSFUL empty answer is authoritative and DOES clear. The tempting
@@ -3651,6 +3665,7 @@ export function createAriaHistory(o: AriaHistoryOptions) {
         ...s,
         status: "ready",
         items,
+        itemsHidden: items.length === 0,
         emptyText: items.length ? "" : emptyText(),
         _siteId: site,
         failed: fetched === null,

package/templates/community-club-owner/tier5-src/_shared/engine-intl.ts

@@ -48,6 +48,36 @@ const MONTHS_LONG = [
   "July", "August", "September", "October", "November", "December",
 ] as const;
 
+/**
+ * A DateTimeFormat for `timeZone` when one is given and this engine knows it. An unknown or
+ * malformed IANA id is a RangeError in ECMA-402; these helpers never throw, so it degrades to
+ * the device zone rather than killing the screen. Without Intl there is no zone database at all,
+ * and the fallbacks below render in the device zone for the same reason.
+ *
+ * Formatters are memoised per (locale, zone, options): a management page formats several dates
+ * per row, and building a DateTimeFormat (or throwing on a bad zone) each time is not free on
+ * JSC or QuickJS. Only call it where `hasIntl()` holds — every caller does.
+ */
+const FORMATTERS = new Map<string, Intl.DateTimeFormat>();
+function dateFormat(locale: string, options: Intl.DateTimeFormatOptions, timeZone?: string): Intl.DateTimeFormat {
+  const key = `${locale}|${timeZone ?? ""}|${JSON.stringify(options)}`;
+  let formatter = FORMATTERS.get(key);
+  if (!formatter) {
+    if (hasIntl()) {
+      if (timeZone) {
+        try {
+          formatter = new Intl.DateTimeFormat(locale, { ...options, timeZone });
+        } catch {
+          /* unknown zone: device zone below, remembered under this key */
+        }
+      }
+      formatter ??= new Intl.DateTimeFormat(locale, options);
+      FORMATTERS.set(key, formatter);
+    }
+  }
+  return formatter as Intl.DateTimeFormat;
+}
+
 // The four shapes below are not invented — they are the option bags this corpus actually uses,
 // counted across every bundle: "Jan 5, 2026" (33 sites), "Jan 5" (11), "Mon, Jan 5, 3:07 PM" (8)
 // 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 = [
 // ECMA-402 in engine-intl-fallback.test.ts.
 
 /** `{ month: "short", day: "numeric", year: "numeric" }` — "Jan 5, 2026". */
-export function formatDateMedium(date: Date, locale = "en-US"): string {
+export function formatDateMedium(date: Date, locale = "en-US", timeZone?: string): string {
   if (hasIntl()) {
-    return new Intl.DateTimeFormat(locale, { month: "short", day: "numeric", year: "numeric" }).format(date);
+    return dateFormat(locale, { month: "short", day: "numeric", year: "numeric" }, timeZone).format(date);
   }
   return `${MONTHS_SHORT[date.getMonth()]} ${date.getDate()}, ${date.getFullYear()}`;
 }
 
 /** `{ month: "short", day: "numeric" }` — "Jan 5". */
-export function formatMonthDay(date: Date, locale = "en-US"): string {
+export function formatMonthDay(date: Date, locale = "en-US", timeZone?: string): string {
   if (hasIntl()) {
-    return new Intl.DateTimeFormat(locale, { month: "short", day: "numeric" }).format(date);
+    return dateFormat(locale, { month: "short", day: "numeric" }, timeZone).format(date);
   }
   return `${MONTHS_SHORT[date.getMonth()]} ${date.getDate()}`;
 }
 
 /** `{ month: "long", day: "numeric" }` — "January 5". */
-export function formatMonthDayLong(date: Date, locale = "en-US"): string {
+export function formatMonthDayLong(date: Date, locale = "en-US", timeZone?: string): string {
   if (hasIntl()) {
-    return new Intl.DateTimeFormat(locale, { month: "long", day: "numeric" }).format(date);
+    return dateFormat(locale, { month: "long", day: "numeric" }, timeZone).format(date);
   }
   return `${MONTHS_LONG[date.getMonth()]} ${date.getDate()}`;
 }
 
 /** `{ weekday: "short", month: "short", day: "numeric", hour: "numeric", minute: "2-digit" }`
  *  — "Mon, Jan 5, 3:07 PM". */
-export function formatWeekdayDateTime(date: Date, locale = "en-US"): string {
+export function formatWeekdayDateTime(date: Date, locale = "en-US", timeZone?: string): string {
   if (hasIntl()) {
-    return new Intl.DateTimeFormat(locale, {
+    return dateFormat(locale, {
       weekday: "short", month: "short", day: "numeric", hour: "numeric", minute: "2-digit",
-    }).format(date);
+    }, timeZone).format(date);
   }
   return `${WEEKDAYS_SHORT[date.getDay()]}, ${MONTHS_SHORT[date.getMonth()]} ${date.getDate()}, ${clock12(date)}`;
 }
 
 /** `{ month: "short", day: "numeric", hour: "numeric", minute: "2-digit" }` — "Jan 5, 3:07 PM". */
-export function formatMonthDayTime(date: Date, locale = "en-US"): string {
+export function formatMonthDayTime(date: Date, locale = "en-US", timeZone?: string): string {
   if (hasIntl()) {
-    return new Intl.DateTimeFormat(locale, {
+    return dateFormat(locale, {
       month: "short", day: "numeric", hour: "numeric", minute: "2-digit",
-    }).format(date);
+    }, timeZone).format(date);
   }
   return `${MONTHS_SHORT[date.getMonth()]} ${date.getDate()}, ${clock12(date)}`;
 }
@@ -380,9 +410,9 @@ export function normalizeFormattedPrice(formatted: string): string {
   return `${m[1]}${m[3]}${m[2]}`;
 }
 
-function clockParts(d: Date, locale: string): { time: string; meridiem: string } {
+function clockParts(d: Date, locale: string, timeZone?: string): { time: string; meridiem: string } {
   const full = hasIntl()
-    ? new Intl.DateTimeFormat(locale, { hour: "numeric", minute: "2-digit", hour12: true }).format(d)
+    ? dateFormat(locale, { hour: "numeric", minute: "2-digit", hour12: true }, timeZone).format(d)
     : clock12(d);
   // ICU puts a narrow no-break space before the meridiem; normalize so callers can split on it.
   const clean = full.replace(/[  ]/g, " ");
@@ -391,8 +421,8 @@ function clockParts(d: Date, locale: string): { time: string; meridiem: string }
 }
 
 /** "8:00 PM" — the one clock every customer screen uses (12-hour, en-US shape). */
-export function formatClock(date: Date, locale = "en-US"): string {
-  const { time, meridiem } = clockParts(date, locale);
+export function formatClock(date: Date, locale = "en-US", timeZone?: string): string {
+  const { time, meridiem } = clockParts(date, locale, timeZone);
   return meridiem ? `${time} ${meridiem}` : time;
 }
 
@@ -403,3 +433,14 @@ export function isPastDate(iso: string | undefined | null, now: number = Date.no
   const t = Date.parse(iso);
   return !Number.isNaN(t) && t < now;
 }
+
+/** The calendar day `date` falls on in `timeZone` (device zone when absent, unknown, or when
+ *  the engine has no Intl), as `YYYY-MM-DD`. For "is this today / this year" comparisons. */
+export function calendarDay(date: Date, timeZone?: string): string {
+  if (hasIntl()) {
+    const parts = dateFormat("en-CA", { year: "numeric", month: "2-digit", day: "2-digit" }, timeZone).formatToParts(date);
+    const get = (type: string) => parts.find((p) => p.type === type)?.value ?? "";
+    return `${get("year")}-${get("month")}-${get("day")}`;
+  }
+  return `${date.getFullYear()}-${pad2(date.getMonth() + 1)}-${pad2(date.getDate())}`;
+}