@astryxdesign/core 0.7.7 → 0.7.8-canary.0588a13

package/dist/TimeInput/timeWheelRules.d.ts

@@ -0,0 +1,124 @@
+/**
+ * @file timeWheelRules.ts
+ * @input A time of day, the hour format and the bounds
+ * @output Pure rules of UIDatePicker's time wheels: the columns' rows, the
+ *   time a turned column makes, and which other columns turn with it
+ * @position Internal helper of the TimeInput and DateTimeInput sheets: the
+ *   rows of both their finger and their mouse wheels
+ *
+ * The columns do not loop. Each rule follows a leaf of motion/uikit/
+ * datePicker.ts `wheels`. Pure functions keep the rules testable without a
+ * layout engine.
+ *
+ * SYNC: When modified, update timeWheelRules.test.ts and TimeWheels.tsx.
+ */
+import { type ISOTimeString } from '../utils/timeParser.js';
+/** A time of day, 24-hour. */
+export interface TimeParts {
+    hour: number;
+    minute: number;
+    second: number;
+}
+/** A time wheel column. */
+export type TimeColumn = 'hour' | 'minute' | 'second' | 'meridiem';
+/** One row of a column: the value it stands for and its label. */
+export interface TimeRow {
+    value: number;
+    label: string;
+    isDisabled: boolean;
+    /**
+     * Where the row falls when a key steps the column. An hour row holds the hour
+     * it stands for, so a key follows the full time: 12 PM comes before 1 PM.
+     */
+    order?: number;
+}
+/** Inclusive bounds in seconds since midnight; `null` is unbounded. */
+export interface TimeBounds {
+    min: number | null;
+    max: number | null;
+}
+/** The bounds of a field's `min` and `max` times. */
+export declare function wheelBounds(min: ISOTimeString | undefined, max: ISOTimeString | undefined): TimeBounds;
+/** Whether the hour falls in the PM half (1) or the AM half (0). */
+export declare function meridiemOf(hour: number): 0 | 1;
+/** The 12-hour clock's label for a 24-hour hour: 0 → 12, 13 → 1. */
+export declare function hour12From24(hour: number): number;
+/** The 24-hour hour for a 12-hour hour in a half of the day: 12 AM → 0. */
+export declare function hour24From12(hour: number, meridiem: number): number;
+/**
+ * The time the wheels show for `time`: its seconds kept when the picker has a
+ * seconds column and dropped when it has none. A time outside the bounds is
+ * shown as it is, on its disabled rows: opening the sheet never moves an
+ * untouched value.
+ */
+export declare function displayedTime(time: TimeParts, hasSeconds: boolean): TimeParts;
+/**
+ * The time a column's rest commits when it would make `time`: the nearest
+ * time inside the bounds that the columns have a row for. Past a bound, that
+ * is the bound itself, or, with no seconds column, the nearest whole minute
+ * inside it (a 16:55:30 maximum: 16:55). Inside the bounds, `time` itself.
+ */
+export declare function restingTime(time: TimeParts, hasSeconds: boolean, bounds: TimeBounds): TimeParts;
+/**
+ * The hour the hour column makes when it comes to rest on `row` from the row
+ * that showed `from` (24-hour). In 24-hour time the row is the hour. In 12-hour
+ * time the half of the day changes only when the move passes between 11 and 12.
+ * The column (1 … 12) does not loop, so 12 counts as next to 1. A move between
+ * 12 and 1 to 6 keeps the half of the day. A move between 12 and 7 to 11
+ * changes it.
+ *
+ * @example
+ * ```
+ * hourAfterTurn(11, 12, '12h'); // 12: 11 AM → 12 PM
+ * hourAfterTurn(12, 1, '12h'); // 13: 12 PM → 1 PM
+ * hourAfterTurn(13, 9, '12h'); // 21: 1 PM → 9 PM
+ * ```
+ */
+export declare function hourAfterTurn(from: number, row: number, hourFormat: '12h' | '24h'): number;
+/**
+ * The hour column under a finger. In 24-hour time its rows are 00 … 23. In
+ * 12-hour time they are 1 … 12, each row standing for the hour a turn onto it
+ * from `from` makes (`hourAfterTurn`). A row is disabled when no minute of that
+ * hour is inside the bounds.
+ */
+export declare function hourRows(from: number, hourFormat: '12h' | '24h', bounds: TimeBounds): TimeRow[];
+/**
+ * The hour column under a mouse, whose columns turn one at a time. A 12-hour
+ * row stands for its hour in the half of the day that `from` is in.
+ */
+export declare function hourRowsInHalf(from: number, hourFormat: '12h' | '24h', bounds: TimeBounds): TimeRow[];
+/**
+ * The minute column for `hour`: every minute. A row is disabled when it is
+ * outside the bounds (its whole minute, when the picker shows seconds).
+ */
+export declare function minuteRows(hour: number, hasSeconds: boolean, bounds: TimeBounds): TimeRow[];
+/** The second column for `hour`:`minute`. */
+export declare function secondRows(hour: number, minute: number, bounds: TimeBounds): TimeRow[];
+/** The AM/PM column: a half is disabled when none of its hours is in bounds. */
+export declare function meridiemRows(labels: {
+    am: string;
+    pm: string;
+}, bounds: TimeBounds): TimeRow[];
+/**
+ * The time made by turning `column` to `value` (its row's value) from `from`
+ * (the time the wheels show). Only that column changes, and the AM/PM column
+ * moves the hour by twelve.
+ */
+export declare function turnColumn(from: TimeParts, column: TimeColumn, value: number, hourFormat: '12h' | '24h'): TimeParts;
+/** What a column shows for a time: its row's value. */
+export declare function columnValue(time: TimeParts, column: TimeColumn, hourFormat: '12h' | '24h'): number;
+/**
+ * The columns that must turn after `column` came to rest on `value`. That is
+ * every column whose row for the committed time differs from the row it shows
+ * now. The column that moved shows `value`; the others show `from`. An hour
+ * that crossed 11 ↔ 12 turns the AM/PM column; a time brought back onto a bound
+ * turns every column whose row changed.
+ */
+export declare function columnsToTurn(from: TimeParts, column: TimeColumn, value: number, committed: TimeParts, options: {
+    hourFormat: '12h' | '24h';
+    hasSeconds: boolean;
+}): {
+    column: TimeColumn;
+    value: number;
+}[];
+//# sourceMappingURL=timeWheelRules.d.ts.map

package/dist/TimeInput/timeWheelRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeWheelRules.d.ts","sourceRoot":"","sources":["../../src/TimeInput/timeWheelRules.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAE7B,8BAA8B;AAC9B,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2BAA2B;AAC3B,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEnE,kEAAkE;AAClE,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAcD,qDAAqD;AACrD,wBAAgB,WAAW,CACzB,GAAG,EAAE,aAAa,GAAG,SAAS,EAC9B,GAAG,EAAE,aAAa,GAAG,SAAS,GAC7B,UAAU,CAEZ;AAED,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,CAAC,CAE9C;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnE;AAmBD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,GAAG,SAAS,CAE7E;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,SAAS,EACf,UAAU,EAAE,OAAO,EACnB,MAAM,EAAE,UAAU,GACjB,SAAS,CAUX;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,KAAK,GAAG,KAAK,GACxB,MAAM,CAYR;AAsBD;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,KAAK,GAAG,KAAK,EACzB,MAAM,EAAE,UAAU,GACjB,OAAO,EAAE,CAMX;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,KAAK,GAAG,KAAK,EACzB,MAAM,EAAE,UAAU,GACjB,OAAO,EAAE,CAOX;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,OAAO,EACnB,MAAM,EAAE,UAAU,GACjB,OAAO,EAAE,CASX;AAED,6CAA6C;AAC7C,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,UAAU,GACjB,OAAO,EAAE,CASX;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAC1B,MAAM,EAAE;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAC,EAChC,MAAM,EAAE,UAAU,GACjB,OAAO,EAAE,CAaX;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,KAAK,GAAG,KAAK,GACxB,SAAS,CAWX;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CACzB,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,KAAK,GAAG,KAAK,GACxB,MAAM,CAWR;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE;IAAC,UAAU,EAAE,KAAK,GAAG,KAAK,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAC,GACxD;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,EAAE,CAkBvC"}

package/dist/TimeInput/timeWheelRules.js

@@ -0,0 +1,277 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file timeWheelRules.ts
+ * @input A time of day, the hour format and the bounds
+ * @output Pure rules of UIDatePicker's time wheels: the columns' rows, the
+ *   time a turned column makes, and which other columns turn with it
+ * @position Internal helper of the TimeInput and DateTimeInput sheets: the
+ *   rows of both their finger and their mouse wheels
+ *
+ * The columns do not loop. Each rule follows a leaf of motion/uikit/
+ * datePicker.ts `wheels`. Pure functions keep the rules testable without a
+ * layout engine.
+ *
+ * SYNC: When modified, update timeWheelRules.test.ts and TimeWheels.tsx.
+ */
+
+import { clampTime, formatISOTime, parseISOTime } from "../utils/timeParser.js";
+
+/** A time of day, 24-hour. */
+
+/** A time wheel column. */
+
+/** One row of a column: the value it stands for and its label. */
+
+/** Inclusive bounds in seconds since midnight; `null` is unbounded. */
+
+const SECONDS_PER_DAY = 24 * 3600;
+function secondsOfISO(time) {
+  if (time == null) {
+    return null;
+  }
+  const parsed = parseISOTime(time);
+  return parsed == null ? null : parsed.hour * 3600 + parsed.minute * 60 + parsed.second;
+}
+
+/** The bounds of a field's `min` and `max` times. */
+export function wheelBounds(min, max) {
+  return {
+    min: secondsOfISO(min),
+    max: secondsOfISO(max)
+  };
+}
+
+/** Whether the hour falls in the PM half (1) or the AM half (0). */
+export function meridiemOf(hour) {
+  return hour < 12 ? 0 : 1;
+}
+
+/** The 12-hour clock's label for a 24-hour hour: 0 → 12, 13 → 1. */
+export function hour12From24(hour) {
+  const h = hour % 12;
+  return h === 0 ? 12 : h;
+}
+
+/** The 24-hour hour for a 12-hour hour in a half of the day: 12 AM → 0. */
+export function hour24From12(hour, meridiem) {
+  return hour % 12 + (meridiem === 1 ? 12 : 0);
+}
+function partsOf(seconds) {
+  const s = (seconds % SECONDS_PER_DAY + SECONDS_PER_DAY) % SECONDS_PER_DAY;
+  return {
+    hour: Math.floor(s / 3600),
+    minute: Math.floor(s % 3600 / 60),
+    second: s % 60
+  };
+}
+
+/** Whether [start, end] (seconds) overlaps the bounds. */
+function overlaps(start, end, bounds) {
+  return (bounds.min == null || end >= bounds.min) && (bounds.max == null || start <= bounds.max);
+}
+
+/**
+ * The time the wheels show for `time`: its seconds kept when the picker has a
+ * seconds column and dropped when it has none. A time outside the bounds is
+ * shown as it is, on its disabled rows: opening the sheet never moves an
+ * untouched value.
+ */
+export function displayedTime(time, hasSeconds) {
+  return {
+    ...time,
+    second: hasSeconds ? time.second : 0
+  };
+}
+
+/**
+ * The time a column's rest commits when it would make `time`: the nearest
+ * time inside the bounds that the columns have a row for. Past a bound, that
+ * is the bound itself, or, with no seconds column, the nearest whole minute
+ * inside it (a 16:55:30 maximum: 16:55). Inside the bounds, `time` itself.
+ */
+export function restingTime(time, hasSeconds, bounds) {
+  const boundAt = seconds => seconds == null ? undefined : formatISOTime(partsOf(seconds), true);
+  const resting = clampTime(formatISOTime(time, hasSeconds), boundAt(bounds.min), boundAt(bounds.max), hasSeconds);
+  return parseISOTime(resting) ?? time;
+}
+
+/**
+ * The hour the hour column makes when it comes to rest on `row` from the row
+ * that showed `from` (24-hour). In 24-hour time the row is the hour. In 12-hour
+ * time the half of the day changes only when the move passes between 11 and 12.
+ * The column (1 … 12) does not loop, so 12 counts as next to 1. A move between
+ * 12 and 1 to 6 keeps the half of the day. A move between 12 and 7 to 11
+ * changes it.
+ *
+ * @example
+ * ```
+ * hourAfterTurn(11, 12, '12h'); // 12: 11 AM → 12 PM
+ * hourAfterTurn(12, 1, '12h'); // 13: 12 PM → 1 PM
+ * hourAfterTurn(13, 9, '12h'); // 21: 1 PM → 9 PM
+ * ```
+ */
+export function hourAfterTurn(from, row, hourFormat) {
+  if (hourFormat === '24h') {
+    return row;
+  }
+  const shown = hour12From24(from);
+  if (row === shown) {
+    return from;
+  }
+  const half = meridiemOf(from);
+  const passes11And12 = shown === 12 && row >= 7 || row === 12 && shown >= 7;
+  return hour24From12(row, passes11And12 ? 1 - half : half);
+}
+function hourRowsFor(hourFormat, hourOf, bounds) {
+  const rows = hourFormat === '24h' ? Array.from({
+    length: 24
+  }, (_, hour) => hour) : Array.from({
+    length: 12
+  }, (_, index) => index + 1);
+  return rows.map(row => {
+    const hour = hourOf(row);
+    return {
+      value: row,
+      label: hourFormat === '24h' ? String(row).padStart(2, '0') : String(row),
+      isDisabled: !overlaps(hour * 3600, hour * 3600 + 3599, bounds),
+      order: hour
+    };
+  });
+}
+
+/**
+ * The hour column under a finger. In 24-hour time its rows are 00 … 23. In
+ * 12-hour time they are 1 … 12, each row standing for the hour a turn onto it
+ * from `from` makes (`hourAfterTurn`). A row is disabled when no minute of that
+ * hour is inside the bounds.
+ */
+export function hourRows(from, hourFormat, bounds) {
+  return hourRowsFor(hourFormat, row => hourAfterTurn(from, row, hourFormat), bounds);
+}
+
+/**
+ * The hour column under a mouse, whose columns turn one at a time. A 12-hour
+ * row stands for its hour in the half of the day that `from` is in.
+ */
+export function hourRowsInHalf(from, hourFormat, bounds) {
+  const half = meridiemOf(from);
+  return hourRowsFor(hourFormat, row => hourFormat === '24h' ? row : hour24From12(row, half), bounds);
+}
+
+/**
+ * The minute column for `hour`: every minute. A row is disabled when it is
+ * outside the bounds (its whole minute, when the picker shows seconds).
+ */
+export function minuteRows(hour, hasSeconds, bounds) {
+  return Array.from({
+    length: 60
+  }, (_, minute) => {
+    const start = hour * 3600 + minute * 60;
+    return {
+      value: minute,
+      label: String(minute).padStart(2, '0'),
+      isDisabled: !overlaps(start, start + (hasSeconds ? 59 : 0), bounds)
+    };
+  });
+}
+
+/** The second column for `hour`:`minute`. */
+export function secondRows(hour, minute, bounds) {
+  return Array.from({
+    length: 60
+  }, (_, second) => {
+    const at = hour * 3600 + minute * 60 + second;
+    return {
+      value: second,
+      label: String(second).padStart(2, '0'),
+      isDisabled: !overlaps(at, at, bounds)
+    };
+  });
+}
+
+/** The AM/PM column: a half is disabled when none of its hours is in bounds. */
+export function meridiemRows(labels, bounds) {
+  return [{
+    value: 0,
+    label: labels.am,
+    isDisabled: !overlaps(0, 12 * 3600 - 1, bounds)
+  }, {
+    value: 1,
+    label: labels.pm,
+    isDisabled: !overlaps(12 * 3600, SECONDS_PER_DAY - 1, bounds)
+  }];
+}
+
+/**
+ * The time made by turning `column` to `value` (its row's value) from `from`
+ * (the time the wheels show). Only that column changes, and the AM/PM column
+ * moves the hour by twelve.
+ */
+export function turnColumn(from, column, value, hourFormat) {
+  switch (column) {
+    case 'hour':
+      return {
+        ...from,
+        hour: hourAfterTurn(from.hour, value, hourFormat)
+      };
+    case 'minute':
+      return {
+        ...from,
+        minute: value
+      };
+    case 'second':
+      return {
+        ...from,
+        second: value
+      };
+    case 'meridiem':
+      return {
+        ...from,
+        hour: hour24From12(hour12From24(from.hour), value)
+      };
+  }
+}
+
+/** What a column shows for a time: its row's value. */
+export function columnValue(time, column, hourFormat) {
+  switch (column) {
+    case 'hour':
+      return hourFormat === '24h' ? time.hour : hour12From24(time.hour);
+    case 'minute':
+      return time.minute;
+    case 'second':
+      return time.second;
+    case 'meridiem':
+      return meridiemOf(time.hour);
+  }
+}
+
+/**
+ * The columns that must turn after `column` came to rest on `value`. That is
+ * every column whose row for the committed time differs from the row it shows
+ * now. The column that moved shows `value`; the others show `from`. An hour
+ * that crossed 11 ↔ 12 turns the AM/PM column; a time brought back onto a bound
+ * turns every column whose row changed.
+ */
+export function columnsToTurn(from, column, value, committed, options) {
+  const columns = ['hour', 'minute'];
+  if (options.hasSeconds) {
+    columns.push('second');
+  }
+  if (options.hourFormat === '12h') {
+    columns.push('meridiem');
+  }
+  const turns = [];
+  for (const each of columns) {
+    const shown = each === column ? value : columnValue(from, each, options.hourFormat);
+    const target = columnValue(committed, each, options.hourFormat);
+    if (shown !== target) {
+      turns.push({
+        column: each,
+        value: target
+      });
+    }
+  }
+  return turns;
+}

package/dist/Timer/Timer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Timer.d.ts","sourceRoot":"","sources":["../../src/Timer/Timer.tsx"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAG5C,OAAO,KAAK,EAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAC,MAAM,gBAAgB,CAAC;AAsB9E,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AA8E9C,MAAM,WAAW,UAAW,SAAQ,IAAI,CACtC,SAAS,CAAC,eAAe,CAAC,EAC1B,UAAU,CACX;IACC,sDAAsD;IACtD,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,mEAAmE;IACnE,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,EACpB,SAAS,EACT,MAAkB,EAClB,IAAmB,EACnB,IAAI,EACJ,KAAmB,EACnB,MAAM,EACN,GAAG,EACH,MAAM,EACN,SAAS,EACT,KAAK,EACL,GAAG,IAAI,EACR,EAAE,UAAU,+BA0EZ;yBAtFe,KAAK"}
+{"version":3,"file":"Timer.d.ts","sourceRoot":"","sources":["../../src/Timer/Timer.tsx"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAG5C,OAAO,KAAK,EAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAC,MAAM,gBAAgB,CAAC;AAsB9E,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AA8E9C,MAAM,WAAW,UAAW,SAAQ,IAAI,CACtC,SAAS,CAAC,eAAe,CAAC,EAC1B,UAAU,CACX;IACC,sDAAsD;IACtD,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,mEAAmE;IACnE,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,EACpB,SAAS,EACT,MAAkB,EAClB,IAAmB,EACnB,IAAI,EACJ,KAAmB,EACnB,MAAM,EACN,GAAG,EACH,MAAM,EACN,SAAS,EACT,KAAK,EACL,GAAG,IAAI,EACR,EAAE,UAAU,+BA2EZ;yBAvFe,KAAK"}

package/dist/Timer/Timer.js

@@ -104,6 +104,8 @@ export function Timer({
   const mergedRef = useMergedRefs(ref, timerRef);
   const resolvedFormat = resolveFormat(format);
   const initialPresentation = getPresentation(0, resolvedFormat);
+
+  // Syncs the elapsed-time text with a timer.
   useEffect(() => {
     const resolvedStartTime = startTime !== undefined && Number.isFinite(startTime) ? startTime : mountTime;
     let timeoutID;

package/dist/Timestamp/Timestamp.js

@@ -197,7 +197,7 @@ export function Timestamp({
     timeZoneNameStyle: 'long'
   }) : '';
 
-  // Live updates
+  // Syncs the relative time with an interval timer while the timestamp is live.
   useEffect(() => {
     if (!isLive || !isValidDate || !isRelativeFormat(effectiveFormat)) {
       return;

package/dist/Timestamp/formatInstant.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatInstant.d.ts","sourceRoot":"","sources":["../../src/Timestamp/formatInstant.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,aAAa,CAAC;AAMjD;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GACvB,OAAO,CAAC,eAAe,EAAE,UAAU,GAAG,gBAAgB,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;AAE5E,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;;;OAQG;IACH,iBAAiB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CACtC;AA6ED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EACd,EACE,QAAQ,EACR,eAAuB,EACvB,iBAA2B,GAC5B,GAAE,oBAAyB,GAC3B,MAAM,CAsER"}
+{"version":3,"file":"formatInstant.d.ts","sourceRoot":"","sources":["../../src/Timestamp/formatInstant.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,aAAa,CAAC;AAMjD;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GACvB,OAAO,CAAC,eAAe,EAAE,UAAU,GAAG,gBAAgB,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;AAE5E,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;;;OAQG;IACH,iBAAiB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CACtC;AA6CD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EACd,EACE,QAAQ,EACR,eAAuB,EACvB,iBAA2B,GAC5B,GAAE,oBAAyB,GAC3B,MAAM,CAsER"}

package/dist/Timestamp/formatInstant.js

@@ -29,7 +29,7 @@
  * - /packages/core/src/Timestamp/Timestamp.test.tsx
  */
 
-import { SHARED_DATE_FORMAT_OPTIONS, getTimeZoneParts } from "../utils/plainDate.js";
+import { SHARED_DATE_FORMAT_OPTIONS, getWallClock } from "../utils/plainDate.js";
 
 // =============================================================================
 // Types
@@ -87,28 +87,6 @@ function pad(n) {
   return String(n).padStart(2, '0');
 }
 
-/** The fields a `system_*` string is assembled from. */
-
-/**
- * Wall-clock fields for an instant: in the named zone, or — with no zone —
- * the viewer's own, read straight off the `Date`. The zone-less branch
- * deliberately stays on plain getters so the default rendering never gains a
- * dependency on `Intl` zone data it did not have before.
- *
- * The explicit return type is load-bearing: it is what forces the two branches
- * to keep producing the same shape.
- */
-function getWallClock(date, timeZone) {
-  return timeZone === undefined ? {
-    year: date.getFullYear(),
-    month: date.getMonth() + 1,
-    day: date.getDate(),
-    hour: date.getHours(),
-    minute: date.getMinutes(),
-    second: date.getSeconds()
-  } : getTimeZoneParts(date.getTime(), timeZone);
-}
-
 /**
  * Renders one instant in one absolute format.
  *

package/dist/Toast/Toast.d.ts

@@ -18,6 +18,16 @@ export interface ToastProps {
 }
 interface ToastSurfaceProps extends ToastProps {
     gestureDirection: ToastGestureDirection;
+    /**
+     * Changes when a uniqueID overwrite updates this card in place: the new
+     * toast's auto-hide timer starts over.
+     */
+    timerKey?: string;
+    /**
+     * False when the viewport announces the toast: the card then carries no
+     * live region of its own, so an update in place is announced once.
+     */
+    isLiveRegion?: boolean;
 }
 /**
  * Individual toast notification.
@@ -43,7 +53,7 @@ export declare function Toast(props: ToastProps): import("react").JSX.Element;
 export declare namespace Toast {
     var displayName: string;
 }
-export declare function ToastSurface({ type, body, endContent, isAutoHide, autoHideDuration, isExiting, onDismiss, renderContent, gestureDirection, }: ToastSurfaceProps): import("react").JSX.Element;
+export declare function ToastSurface({ type, body, endContent, isAutoHide, autoHideDuration, isExiting, onDismiss, renderContent, gestureDirection, timerKey, isLiveRegion, }: ToastSurfaceProps): import("react").JSX.Element;
 export declare namespace ToastSurface {
     var displayName: string;
 }

package/dist/Toast/Toast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Toast.d.ts","sourceRoot":"","sources":["../../src/Toast/Toast.tsx"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAa,SAAS,EAAY,MAAM,OAAO,CAAC;AAkB5D,OAAO,KAAK,EACV,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAkB,KAAK,qBAAqB,EAAC,MAAM,mBAAmB,CAAC;AA8F9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAChD;;;;OAIG;IACH,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACtC;AAED,UAAU,iBAAkB,SAAQ,UAAU;IAC5C,gBAAgB,EAAE,qBAAqB,CAAC;CACzC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,+BAEtC;yBAFe,KAAK;;;AAOrB,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,IAAI,EACJ,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,SAAiB,EACjB,SAAS,EACT,aAAa,EACb,gBAAgB,GACjB,EAAE,iBAAiB,+BA6NnB;yBAvOe,YAAY"}
+{"version":3,"file":"Toast.d.ts","sourceRoot":"","sources":["../../src/Toast/Toast.tsx"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAa,SAAS,EAAY,MAAM,OAAO,CAAC;AAkB5D,OAAO,KAAK,EACV,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAkB,KAAK,qBAAqB,EAAC,MAAM,mBAAmB,CAAC;AA8F9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAChD;;;;OAIG;IACH,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACtC;AAED,UAAU,iBAAkB,SAAQ,UAAU;IAC5C,gBAAgB,EAAE,qBAAqB,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,+BAEtC;yBAFe,KAAK;;;AAOrB,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,IAAI,EACJ,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,SAAiB,EACjB,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,QAAQ,EACR,YAAmB,GACpB,EAAE,iBAAiB,+BAqOnB;yBAjPe,YAAY"}

package/dist/Toast/Toast.js

@@ -85,7 +85,9 @@ export function ToastSurface({
   isExiting = false,
   onDismiss,
   renderContent,
-  gestureDirection
+  gestureDirection,
+  timerKey,
+  isLiveRegion = true
 }) {
   const t = useComponentTranslator();
   const timerRef = useRef(null);
@@ -117,10 +119,11 @@ export function ToastSurface({
       onDismissRef.current('auto');
     }, remainingRef.current);
   }, [isAutoHide]);
+
+  // Pointer, focus and gesture holds are tracked whatever isAutoHide is: an
+  // overwrite can turn a toast that does not auto-hide into one that does
+  // while a hold is in place. The window hold leaves with its listeners.
   const pauseTimer = useCallback(source => {
-    if (!isAutoHide) {
-      return;
-    }
     const sources = pauseSourcesRef.current;
     const wasRunning = sources.size === 0;
     sources.add(source);
@@ -135,11 +138,8 @@ export function ToastSurface({
       const elapsed = Date.now() - startTimeRef.current;
       remainingRef.current = Math.max(remainingRef.current - elapsed, 1000);
     }
-  }, [isAutoHide]);
+  }, []);
   const resumeTimer = useCallback(source => {
-    if (!isAutoHide) {
-      return;
-    }
     const sources = pauseSourcesRef.current;
     if (!sources.delete(source)) {
       return;
@@ -152,18 +152,25 @@ export function ToastSurface({
       return;
     }
     startTimer();
-  }, [isAutoHide, startTimer]);
+  }, [startTimer]);
   useEffect(() => {
     remainingRef.current = autoHideDuration;
+    // An update in place can remove the focused control, which fires no blur:
+    // a focus hold whose focus has left the card is stale.
+    const root = cardRootRef.current?.current;
+    if (pauseSourcesRef.current.has('focus') && root != null && !root.contains(root.ownerDocument.activeElement)) {
+      pauseSourcesRef.current.delete('focus');
+    }
     startTimer();
     return () => {
       if (timerRef.current) {
         clearTimeout(timerRef.current);
       }
     };
-    // startTimer's identity is stable per isAutoHide, so this runs on mount
-    // and on a genuine duration change — not on unrelated viewport renders.
-  }, [autoHideDuration, startTimer]);
+    // startTimer's identity is stable per isAutoHide, so this runs on mount,
+    // on a genuine duration change and on an overwrite (timerKey), not on
+    // unrelated viewport renders.
+  }, [autoHideDuration, startTimer, timerKey]);
 
   // Pause the auto-hide timer while the window is not focused, so a toast
   // doesn't silently expire while the user is in another window or tab.
@@ -171,6 +178,7 @@ export function ToastSurface({
     if (!isAutoHide) {
       return;
     }
+    const pauseSources = pauseSourcesRef.current;
     const pauseForWindow = () => pauseTimer('window');
     const resumeForWindow = () => resumeTimer('window');
     window.addEventListener('blur', pauseForWindow);
@@ -183,6 +191,8 @@ export function ToastSurface({
     return () => {
       window.removeEventListener('blur', pauseForWindow);
       window.removeEventListener('focus', resumeForWindow);
+      // With the listeners gone, no focus event would clear the window hold.
+      pauseSources.delete('window');
     };
   }, [isAutoHide, pauseTimer, resumeTimer]);
   const isGesturePausing = useCallback(() => pauseSourcesRef.current.has('gesture'), []);
@@ -229,9 +239,9 @@ export function ToastSurface({
   const fallbackMediaMode = isError || mode === 'light' ? 'dark' : 'light';
   return /*#__PURE__*/_jsx("div", {
     ref: rootRef,
-    role: isError ? 'alert' : 'status',
-    "aria-live": isError ? 'assertive' : 'polite',
-    "aria-atomic": "true",
+    role: isLiveRegion ? isError ? 'alert' : 'status' : undefined,
+    "aria-live": isLiveRegion ? isError ? 'assertive' : 'polite' : undefined,
+    "aria-atomic": isLiveRegion ? 'true' : undefined,
     onMouseEnter: pauseForPointer,
     onMouseLeave: resumeForPointer,
     onFocusCapture: pauseForFocus,

package/dist/Toast/ToastViewport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ToastViewport.d.ts","sourceRoot":"","sources":["../../src/Toast/ToastViewport.tsx"],"names":[],"mappings":"AA2CA,OAAO,KAAK,EAAa,aAAa,EAAqB,MAAM,SAAS,CAAC;AAE3E,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,uBAAuB,CAAC;AAwItD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC;IACtE;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAyGD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAsB,EACtB,UAAc,EACd,KAAK,EACL,UAAU,EACV,UAAiB,EACjB,QAAQ,GACT,EAAE,kBAAkB,+BAqhBpB;yBA5hBe,aAAa"}
+{"version":3,"file":"ToastViewport.d.ts","sourceRoot":"","sources":["../../src/Toast/ToastViewport.tsx"],"names":[],"mappings":"AAiDA,OAAO,KAAK,EAAa,aAAa,EAAqB,MAAM,SAAS,CAAC;AAE3E,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,uBAAuB,CAAC;AAwItD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC;IACtE;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAiHD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAsB,EACtB,UAAc,EACd,KAAK,EACL,UAAU,EACV,UAAiB,EACjB,QAAQ,GACT,EAAE,kBAAkB,+BA+lBpB;yBAtmBe,aAAa"}