@sixthshift/design-system 0.2.1 → 0.4.0

package/dist/date-time/index.js

@@ -28,6 +28,15 @@
  * const display = formatDateShort(tomorrow); // 'Jan 16'
  */
 export { Temporal } from "@js-temporal/polyfill";
+export { adaptDisabledDates, 
+// ISO-native arithmetic (no Temporal needed at the call site)
+addDaysISO, addHoursISO, addMinutesISO, addMonthsISO, compareISO, endOfMonthISO, endOfWeekISO, endOfYearISO, 
+// Widening: ISO string -> Temporal
+fromISODate, fromISODateOrUndefined, fromISODateRange, fromISOInstant, fromISOInstantOrUndefined, fromISOInstantRange, fromISOTime, fromISOTimeOrUndefined, 
+// Strict boundary guards
+isDateString, isInstantString, isTimeString, isWeekendISO, startOfMonthISO, startOfWeekISO, startOfYearISO, 
+// Narrowing: string | Temporal -> canonical ISO
+toISODate, toISODateOrUndefined, toISODateRange, toISOInstant, toISOInstantOrUndefined, toISOInstantRange, toISOTime, toISOTimeOrUndefined, weekdayISO, } from "./iso.js";
 // =============================================================================
 // Parsing: ISO 8601 string → Temporal
 // =============================================================================
@@ -108,7 +117,6 @@ export { changeTimezone, plainDateTimeToZonedDateTime, plainDateToZonedDateTime,
 //     until: dateRange?.to ? serialize(dateRange.to) : undefined,
 //   };
 //
-// See: packages/web/src/api/activity-log/useActivityLog.ts for reference implementation
 // =============================================================================
 // =============================================================================
 // Duration

package/dist/date-time/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/date-time/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/date-time/index.ts"],"names":[],"mappings":"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"}

package/dist/date-time/iso.d.ts

@@ -0,0 +1,261 @@
+/**
+ * ISO 8601 string types — the public boundary of every date/time component.
+ *
+ * Components accept and emit canonical ISO strings, never Temporal objects. That
+ * keeps the engine (Temporal today, native Temporal or something else tomorrow)
+ * an implementation detail, and it means a consumer never has to adopt a date
+ * library to render a date picker.
+ *
+ * Two properties this module guarantees, which the components rely on:
+ *
+ * 1. **Canonical form.** Every value produced by `toISO*` is normalised via
+ *    Temporal, so precision is fixed: dates are `YYYY-MM-DD`, times are
+ *    `HH:MM:SS`, instants are `YYYY-MM-DDTHH:MM:SSZ`. Consumer input is *not*
+ *    canonical — `"10:30"` and `"10:30:00"` are both valid input — so always
+ *    normalise on entry rather than comparing raw props.
+ *
+ * 2. **Lexicographic order == chronological order**, but only once canonical.
+ *    `"2026-08-26T00:30:00.250Z" < "2026-08-26T00:30Z"` sorts wrong as raw
+ *    strings; both normalise to a form where `<` is correct. Compare with
+ *    {@link compareISO}, never with `<` on a raw prop.
+ */
+import { Temporal } from "@js-temporal/polyfill";
+import type { WeekStartsOn } from "./boundaries.js";
+/** Any numeric segment of an ISO string. */
+type N = `${number}`;
+/**
+ * An ISO 8601 calendar date: `YYYY-MM-DD`.
+ *
+ * The template literal rejects the obvious mistakes at compile time for literal
+ * values (a datetime passed where a date belongs, or outright garbage). It
+ * cannot check a value that arrives as a plain `string` — use
+ * {@link toISODate} for those.
+ *
+ * @example
+ * const d: ISODate = "2026-08-26";       // ok
+ * const d: ISODate = "2026-08-26T10:00"; // Error
+ */
+export type ISODate = `${N}-${N}-${N}`;
+/**
+ * An ISO 8601 wall-clock time: `HH:MM` or `HH:MM:SS`.
+ *
+ * Both precisions are accepted as input; components always emit `HH:MM:SS`.
+ */
+export type ISOTime = `${N}:${N}` | `${N}:${N}:${N}`;
+/** An ISO 8601 timezone-naive datetime: `YYYY-MM-DDTHH:MM:SS`. */
+export type ISODateTime = `${ISODate}T${ISOTime}`;
+/**
+ * An ISO 8601 absolute instant in UTC: `YYYY-MM-DDTHH:MM:SSZ`.
+ *
+ * The trailing `Z` is required. A numeric offset (`+10:00`) is a valid instant
+ * to Temporal but is rejected here, so that one instant has exactly one
+ * representation and string comparison stays meaningful.
+ */
+export type ISOInstant = `${ISODate}T${string}Z`;
+/** A date range, either end of which may be unset. */
+export type ISODateRange = {
+    from: ISODate | undefined;
+    to: ISODate | undefined;
+};
+/** An instant range, either end of which may be unset. */
+export type ISOInstantRange = {
+    from: ISOInstant | undefined;
+    to: ISOInstant | undefined;
+};
+/**
+ * Day of week by name.
+ *
+ * Named rather than numbered on purpose: `weekStartsOn` counts from 0 = Sunday
+ * while ISO-8601 `dayOfWeek` counts from 1 = Monday, and two numeric day props
+ * with different origins in the same object is a bug waiting to be filed.
+ */
+export type Weekday = "mon" | "tue" | "wed" | "thu" | "fri" | "sat" | "sun";
+/**
+ * Which dates a calendar should refuse.
+ *
+ * The declarative forms cover the cases that would otherwise force a consumer
+ * to do date arithmetic; the predicate remains as an escape hatch.
+ *
+ * @example
+ * disabled="2026-08-26"                        // one date
+ * disabled={["2026-08-26", "2026-08-27"]}      // several
+ * disabled={{ before: "2026-01-01" }}          // everything earlier
+ * disabled={{ from: "2026-08-01", to: "2026-08-07" }}  // an inclusive span
+ * disabled={{ dayOfWeek: ["sat", "sun"] }}     // weekends
+ * disabled={(date) => date.endsWith("-01")}    // anything else
+ */
+export type DisabledDates = ISODate | readonly ISODate[] | {
+    before: ISODate;
+} | {
+    after: ISODate;
+} | {
+    from: ISODate;
+    to: ISODate;
+} | {
+    dayOfWeek: readonly Weekday[];
+} | ((date: ISODate) => boolean);
+/**
+ * Normalise a date to canonical `YYYY-MM-DD`.
+ *
+ * Accepts an ISO date string or a `Temporal.PlainDate`. Throws on anything that
+ * is not a valid date, and on a datetime string — a value carrying a time is a
+ * caller mistake here, not something to silently truncate.
+ */
+export declare function toISODate(value: string | Temporal.PlainDate): ISODate;
+/** {@link toISODate}, passing `undefined` through. */
+export declare function toISODateOrUndefined(value: string | Temporal.PlainDate | null | undefined): ISODate | undefined;
+/**
+ * Normalise a time to canonical `HH:MM:SS`.
+ *
+ * Accepts `HH:MM`, `HH:MM:SS`, or a `Temporal.PlainTime`. Rejects a datetime,
+ * which `Temporal.PlainTime.from` would otherwise happily accept.
+ */
+export declare function toISOTime(value: string | Temporal.PlainTime): ISOTime;
+/** {@link toISOTime}, passing `undefined` through. */
+export declare function toISOTimeOrUndefined(value: string | Temporal.PlainTime | null | undefined): ISOTime | undefined;
+/**
+ * Normalise an instant to canonical `YYYY-MM-DDTHH:MM:SSZ` (UTC).
+ *
+ * Accepts any ISO instant — including one written with a numeric offset — and
+ * converts it to the `Z` form, so equal instants always compare equal as
+ * strings.
+ */
+export declare function toISOInstant(value: string | Temporal.Instant): ISOInstant;
+/** {@link toISOInstant}, passing `undefined` through. */
+export declare function toISOInstantOrUndefined(value: string | Temporal.Instant | null | undefined): ISOInstant | undefined;
+/** Normalise a date range, dropping ends that are unset. */
+export declare function toISODateRange(range: {
+    from?: string | Temporal.PlainDate | undefined;
+    to?: string | Temporal.PlainDate | undefined;
+} | null | undefined): ISODateRange | undefined;
+/** Normalise an instant range, dropping ends that are unset. */
+export declare function toISOInstantRange(range: {
+    from?: string | Temporal.Instant | undefined;
+    to?: string | Temporal.Instant | undefined;
+} | null | undefined): ISOInstantRange | undefined;
+/**
+ * Parse an {@link ISODate} to the `Temporal.PlainDate` the internals work in.
+ *
+ * Rejects a value carrying a time, exactly as {@link toISODate} does. The
+ * template literal type already catches that for a literal, but a value arriving
+ * as `string` from an API is unchecked — and `Temporal.PlainDate.from` would
+ * silently truncate `"2026-08-26T10:00:00"` to `2026-08-26`, which is the kind
+ * of quiet wrong answer this boundary exists to prevent.
+ */
+export declare function fromISODate(value: ISODate | string): Temporal.PlainDate;
+/** {@link fromISODate}, passing `undefined` through. */
+export declare function fromISODateOrUndefined(value: ISODate | string | null | undefined): Temporal.PlainDate | undefined;
+/**
+ * Parse an {@link ISOTime} to `Temporal.PlainTime`.
+ *
+ * Rejects a datetime, which `Temporal.PlainTime.from` would otherwise accept by
+ * discarding the date half.
+ */
+export declare function fromISOTime(value: ISOTime | string): Temporal.PlainTime;
+/** {@link fromISOTime}, passing `undefined` through. */
+export declare function fromISOTimeOrUndefined(value: ISOTime | string | null | undefined): Temporal.PlainTime | undefined;
+/** Parse an {@link ISOInstant} to `Temporal.Instant`. */
+export declare function fromISOInstant(value: ISOInstant | string): Temporal.Instant;
+/** {@link fromISOInstant}, passing `undefined` through. */
+export declare function fromISOInstantOrUndefined(value: ISOInstant | string | null | undefined): Temporal.Instant | undefined;
+/**
+ * A date range in Temporal terms.
+ *
+ * Structurally identical to each picker's internal `DateRangeValue`. Declared
+ * here so the widening helpers below can live alongside their narrowing
+ * counterparts without `date-time` importing from `components`.
+ */
+export type TemporalDateRange = {
+    from: Temporal.PlainDate | undefined;
+    to: Temporal.PlainDate | undefined;
+};
+/** An instant range in Temporal terms. */
+export type TemporalInstantRange = {
+    from: Temporal.Instant | undefined;
+    to: Temporal.Instant | undefined;
+};
+/** Widen an {@link ISODateRange} for the internals. Inverse of {@link toISODateRange}. */
+export declare function fromISODateRange(range: ISODateRange | undefined): TemporalDateRange | undefined;
+/** Widen an {@link ISOInstantRange} for the internals. Inverse of {@link toISOInstantRange}. */
+export declare function fromISOInstantRange(range: ISOInstantRange | undefined): TemporalInstantRange | undefined;
+/**
+ * Whether `value` is a canonical-parseable ISO date, with no time component.
+ *
+ * Stricter than `isISODate` from `./validate`, which accepts a datetime because
+ * `Temporal.PlainDate.from` does. Use this one at a boundary.
+ */
+export declare function isDateString(value: unknown): value is ISODate;
+/** Whether `value` is an ISO time, with no date component. */
+export declare function isTimeString(value: unknown): value is ISOTime;
+/** Whether `value` is an ISO instant (any offset form; `Z` not required). */
+export declare function isInstantString(value: unknown): value is ISOInstant;
+/**
+ * Compare two ISO strings of the same kind chronologically.
+ *
+ * Normalises first, so mixed input precision (`"10:30"` vs `"10:30:00"`) and
+ * mixed instant offsets compare correctly — which raw `<` does not.
+ *
+ * @returns negative if `a` is earlier, 0 if equal, positive if `a` is later.
+ */
+export declare function compareISO(a: string, b: string): number;
+/** Shift a date by whole days. Negative moves backwards. */
+export declare function addDaysISO(date: ISODate, days: number): ISODate;
+/** Shift a date by whole months, clamping the day to the target month's length. */
+export declare function addMonthsISO(date: ISODate, months: number): ISODate;
+/** The first day of `date`'s month. */
+export declare function startOfMonthISO(date: ISODate): ISODate;
+/** The last day of `date`'s month. */
+export declare function endOfMonthISO(date: ISODate): ISODate;
+/** The first day of `date`'s week. `weekStartsOn` counts from 0 = Sunday. */
+export declare function startOfWeekISO(date: ISODate, weekStartsOn?: WeekStartsOn): ISODate;
+/** The last day of `date`'s week. `weekStartsOn` counts from 0 = Sunday. */
+export declare function endOfWeekISO(date: ISODate, weekStartsOn?: WeekStartsOn): ISODate;
+/**
+ * Shift an instant by whole minutes. Negative moves backwards.
+ *
+ * Instant arithmetic, unlike the date helpers above, is exact — there are no
+ * calendar boundaries to clamp against.
+ */
+export declare function addMinutesISO(instant: ISOInstant, minutes: number): ISOInstant;
+/** Shift an instant by whole hours. Negative moves backwards. */
+export declare function addHoursISO(instant: ISOInstant, hours: number): ISOInstant;
+/** The first day of `date`'s year. */
+export declare function startOfYearISO(date: ISODate): ISODate;
+/** The last day of `date`'s year. */
+export declare function endOfYearISO(date: ISODate): ISODate;
+/**
+ * Which day of the week a date falls on, by name.
+ *
+ * The reason a consumer can filter dates without reaching for Temporal — see
+ * {@link isWeekendISO} for the common case.
+ *
+ * @example
+ * presets.filter((date) => weekdayISO(date) !== "sun")
+ */
+export declare function weekdayISO(date: ISODate): Weekday;
+/** Whether a date falls on a Saturday or Sunday. */
+export declare function isWeekendISO(date: ISODate): boolean;
+/**
+ * The Temporal-shaped matcher union consumed by `calendar.hooks`.
+ *
+ * Declared here rather than imported to keep `date-time` free of component
+ * imports; `calendar.types` re-exports it under its historical name.
+ */
+export type TemporalDisabledMatcher = Temporal.PlainDate | Temporal.PlainDate[] | ((date: Temporal.PlainDate) => boolean) | {
+    before: Temporal.PlainDate;
+} | {
+    after: Temporal.PlainDate;
+} | {
+    from: Temporal.PlainDate;
+    to: Temporal.PlainDate;
+};
+/**
+ * Convert the public `disabled` prop into internal matchers.
+ *
+ * Call this once per render behind a `useMemo` keyed on the prop — the result
+ * holds Temporal objects, which have no value identity, so recomputing it every
+ * render would invalidate every downstream `useCallback`.
+ */
+export declare function adaptDisabledDates(disabled: DisabledDates | DisabledDates[] | undefined): TemporalDisabledMatcher | TemporalDisabledMatcher[] | undefined;
+export {};
+//# sourceMappingURL=iso.d.ts.map

package/dist/date-time/iso.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iso.d.ts","sourceRoot":"","sources":["../../src/date-time/iso.ts"],"names":[],"mappings":"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"}

package/dist/date-time/iso.js

@@ -0,0 +1,358 @@
+/**
+ * ISO 8601 string types — the public boundary of every date/time component.
+ *
+ * Components accept and emit canonical ISO strings, never Temporal objects. That
+ * keeps the engine (Temporal today, native Temporal or something else tomorrow)
+ * an implementation detail, and it means a consumer never has to adopt a date
+ * library to render a date picker.
+ *
+ * Two properties this module guarantees, which the components rely on:
+ *
+ * 1. **Canonical form.** Every value produced by `toISO*` is normalised via
+ *    Temporal, so precision is fixed: dates are `YYYY-MM-DD`, times are
+ *    `HH:MM:SS`, instants are `YYYY-MM-DDTHH:MM:SSZ`. Consumer input is *not*
+ *    canonical — `"10:30"` and `"10:30:00"` are both valid input — so always
+ *    normalise on entry rather than comparing raw props.
+ *
+ * 2. **Lexicographic order == chronological order**, but only once canonical.
+ *    `"2026-08-26T00:30:00.250Z" < "2026-08-26T00:30Z"` sorts wrong as raw
+ *    strings; both normalise to a form where `<` is correct. Compare with
+ *    {@link compareISO}, never with `<` on a raw prop.
+ */
+import { Temporal } from "@js-temporal/polyfill";
+/** ISO-8601 day numbers, indexed by {@link Weekday}. 1 = Monday. */
+const WEEKDAY_NUMBER = {
+    mon: 1,
+    tue: 2,
+    wed: 3,
+    thu: 4,
+    fri: 5,
+    sat: 6,
+    sun: 7,
+};
+// =============================================================================
+// Narrowing: string | Temporal -> canonical branded ISO
+// =============================================================================
+/**
+ * Normalise a date to canonical `YYYY-MM-DD`.
+ *
+ * Accepts an ISO date string or a `Temporal.PlainDate`. Throws on anything that
+ * is not a valid date, and on a datetime string — a value carrying a time is a
+ * caller mistake here, not something to silently truncate.
+ */
+export function toISODate(value) {
+    if (value instanceof Temporal.PlainDate)
+        return value.toString();
+    if (/[T ]/.test(value)) {
+        throw new RangeError(`Expected an ISO date (YYYY-MM-DD), got a datetime: ${value}`);
+    }
+    return Temporal.PlainDate.from(value).toString();
+}
+/** {@link toISODate}, passing `undefined` through. */
+export function toISODateOrUndefined(value) {
+    return value === null || value === undefined ? undefined : toISODate(value);
+}
+/**
+ * Normalise a time to canonical `HH:MM:SS`.
+ *
+ * Accepts `HH:MM`, `HH:MM:SS`, or a `Temporal.PlainTime`. Rejects a datetime,
+ * which `Temporal.PlainTime.from` would otherwise happily accept.
+ */
+export function toISOTime(value) {
+    if (value instanceof Temporal.PlainTime)
+        return value.toString();
+    if (/[T ]/.test(value)) {
+        throw new RangeError(`Expected an ISO time (HH:MM or HH:MM:SS), got a datetime: ${value}`);
+    }
+    return Temporal.PlainTime.from(value).toString();
+}
+/** {@link toISOTime}, passing `undefined` through. */
+export function toISOTimeOrUndefined(value) {
+    return value === null || value === undefined ? undefined : toISOTime(value);
+}
+/**
+ * Normalise an instant to canonical `YYYY-MM-DDTHH:MM:SSZ` (UTC).
+ *
+ * Accepts any ISO instant — including one written with a numeric offset — and
+ * converts it to the `Z` form, so equal instants always compare equal as
+ * strings.
+ */
+export function toISOInstant(value) {
+    const instant = value instanceof Temporal.Instant ? value : Temporal.Instant.from(value);
+    return instant.toString();
+}
+/** {@link toISOInstant}, passing `undefined` through. */
+export function toISOInstantOrUndefined(value) {
+    return value === null || value === undefined ? undefined : toISOInstant(value);
+}
+/** Normalise a date range, dropping ends that are unset. */
+export function toISODateRange(range) {
+    if (!range)
+        return undefined;
+    return { from: toISODateOrUndefined(range.from), to: toISODateOrUndefined(range.to) };
+}
+/** Normalise an instant range, dropping ends that are unset. */
+export function toISOInstantRange(range) {
+    if (!range)
+        return undefined;
+    return { from: toISOInstantOrUndefined(range.from), to: toISOInstantOrUndefined(range.to) };
+}
+// =============================================================================
+// Widening: branded ISO -> Temporal (for component internals)
+// =============================================================================
+/**
+ * Parse an {@link ISODate} to the `Temporal.PlainDate` the internals work in.
+ *
+ * Rejects a value carrying a time, exactly as {@link toISODate} does. The
+ * template literal type already catches that for a literal, but a value arriving
+ * as `string` from an API is unchecked — and `Temporal.PlainDate.from` would
+ * silently truncate `"2026-08-26T10:00:00"` to `2026-08-26`, which is the kind
+ * of quiet wrong answer this boundary exists to prevent.
+ */
+export function fromISODate(value) {
+    if (/[T ]/.test(value)) {
+        throw new RangeError(`Expected an ISO date (YYYY-MM-DD), got a datetime: ${value}`);
+    }
+    return Temporal.PlainDate.from(value);
+}
+/** {@link fromISODate}, passing `undefined` through. */
+export function fromISODateOrUndefined(value) {
+    return value === null || value === undefined ? undefined : fromISODate(value);
+}
+/**
+ * Parse an {@link ISOTime} to `Temporal.PlainTime`.
+ *
+ * Rejects a datetime, which `Temporal.PlainTime.from` would otherwise accept by
+ * discarding the date half.
+ */
+export function fromISOTime(value) {
+    if (/[T ]/.test(value)) {
+        throw new RangeError(`Expected an ISO time (HH:MM or HH:MM:SS), got a datetime: ${value}`);
+    }
+    return Temporal.PlainTime.from(value);
+}
+/** {@link fromISOTime}, passing `undefined` through. */
+export function fromISOTimeOrUndefined(value) {
+    return value === null || value === undefined ? undefined : fromISOTime(value);
+}
+/** Parse an {@link ISOInstant} to `Temporal.Instant`. */
+export function fromISOInstant(value) {
+    return Temporal.Instant.from(value);
+}
+/** {@link fromISOInstant}, passing `undefined` through. */
+export function fromISOInstantOrUndefined(value) {
+    return value === null || value === undefined ? undefined : Temporal.Instant.from(value);
+}
+/** Widen an {@link ISODateRange} for the internals. Inverse of {@link toISODateRange}. */
+export function fromISODateRange(range) {
+    if (!range)
+        return undefined;
+    return { from: fromISODateOrUndefined(range.from), to: fromISODateOrUndefined(range.to) };
+}
+/** Widen an {@link ISOInstantRange} for the internals. Inverse of {@link toISOInstantRange}. */
+export function fromISOInstantRange(range) {
+    if (!range)
+        return undefined;
+    return { from: fromISOInstantOrUndefined(range.from), to: fromISOInstantOrUndefined(range.to) };
+}
+// =============================================================================
+// Validation
+// =============================================================================
+/**
+ * Whether `value` is a canonical-parseable ISO date, with no time component.
+ *
+ * Stricter than `isISODate` from `./validate`, which accepts a datetime because
+ * `Temporal.PlainDate.from` does. Use this one at a boundary.
+ */
+export function isDateString(value) {
+    if (typeof value !== "string" || /[T ]/.test(value))
+        return false;
+    try {
+        Temporal.PlainDate.from(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Whether `value` is an ISO time, with no date component. */
+export function isTimeString(value) {
+    if (typeof value !== "string" || /[T ]/.test(value))
+        return false;
+    try {
+        Temporal.PlainTime.from(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Whether `value` is an ISO instant (any offset form; `Z` not required). */
+export function isInstantString(value) {
+    if (typeof value !== "string")
+        return false;
+    try {
+        Temporal.Instant.from(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// =============================================================================
+// Comparison
+// =============================================================================
+/**
+ * Compare two ISO strings of the same kind chronologically.
+ *
+ * Normalises first, so mixed input precision (`"10:30"` vs `"10:30:00"`) and
+ * mixed instant offsets compare correctly — which raw `<` does not.
+ *
+ * @returns negative if `a` is earlier, 0 if equal, positive if `a` is later.
+ */
+export function compareISO(a, b) {
+    if (isDateString(a) && isDateString(b)) {
+        return Temporal.PlainDate.compare(fromISODate(a), fromISODate(b));
+    }
+    if (isTimeString(a) && isTimeString(b)) {
+        return Temporal.PlainTime.compare(fromISOTime(a), fromISOTime(b));
+    }
+    return Temporal.Instant.compare(fromISOInstant(a), fromISOInstant(b));
+}
+// =============================================================================
+// ISO-native arithmetic
+// =============================================================================
+//
+// Enough to build the `presets` and `disabled` values a consumer actually needs
+// without reaching for Temporal. Anything more involved is what
+// `@sixthshift/design-system/date-time` is for.
+//
+// `todayISO()` and `nowISO()` live in ./now alongside their Temporal siblings.
+/** Shift a date by whole days. Negative moves backwards. */
+export function addDaysISO(date, days) {
+    return fromISODate(date).add({ days }).toString();
+}
+/** Shift a date by whole months, clamping the day to the target month's length. */
+export function addMonthsISO(date, months) {
+    return fromISODate(date).add({ months }).toString();
+}
+/** The first day of `date`'s month. */
+export function startOfMonthISO(date) {
+    return fromISODate(date).with({ day: 1 }).toString();
+}
+/** The last day of `date`'s month. */
+export function endOfMonthISO(date) {
+    const plain = fromISODate(date);
+    return plain.with({ day: plain.daysInMonth }).toString();
+}
+/** The first day of `date`'s week. `weekStartsOn` counts from 0 = Sunday. */
+export function startOfWeekISO(date, weekStartsOn = 0) {
+    const plain = fromISODate(date);
+    // Temporal's dayOfWeek is 1 = Monday..7 = Sunday; shift into 0 = Sunday..6.
+    const currentDay = plain.dayOfWeek % 7;
+    const diff = (currentDay - weekStartsOn + 7) % 7;
+    return plain.subtract({ days: diff }).toString();
+}
+/** The last day of `date`'s week. `weekStartsOn` counts from 0 = Sunday. */
+export function endOfWeekISO(date, weekStartsOn = 0) {
+    return addDaysISO(startOfWeekISO(date, weekStartsOn), 6);
+}
+/**
+ * Shift an instant by whole minutes. Negative moves backwards.
+ *
+ * Instant arithmetic, unlike the date helpers above, is exact — there are no
+ * calendar boundaries to clamp against.
+ */
+export function addMinutesISO(instant, minutes) {
+    return fromISOInstant(instant).add({ minutes }).toString();
+}
+/** Shift an instant by whole hours. Negative moves backwards. */
+export function addHoursISO(instant, hours) {
+    return fromISOInstant(instant).add({ hours }).toString();
+}
+/** The first day of `date`'s year. */
+export function startOfYearISO(date) {
+    return fromISODate(date).with({ month: 1, day: 1 }).toString();
+}
+/** The last day of `date`'s year. */
+export function endOfYearISO(date) {
+    return fromISODate(date).with({ month: 12, day: 31 }).toString();
+}
+/** ISO-8601 day numbers to {@link Weekday} names. Index 0 is unused; 1 = Monday. */
+const WEEKDAY_NAME = ["mon", "tue", "wed", "thu", "fri", "sat", "sun"];
+/**
+ * Which day of the week a date falls on, by name.
+ *
+ * The reason a consumer can filter dates without reaching for Temporal — see
+ * {@link isWeekendISO} for the common case.
+ *
+ * @example
+ * presets.filter((date) => weekdayISO(date) !== "sun")
+ */
+export function weekdayISO(date) {
+    // Temporal's dayOfWeek is 1 = Monday..7 = Sunday.
+    return WEEKDAY_NAME[fromISODate(date).dayOfWeek - 1];
+}
+/** Whether a date falls on a Saturday or Sunday. */
+export function isWeekendISO(date) {
+    const day = weekdayISO(date);
+    return day === "sat" || day === "sun";
+}
+// =============================================================================
+// Disabled-date adaptation
+// =============================================================================
+/**
+ * Convert one public {@link DisabledDates} matcher into the Temporal-shaped
+ * matcher the calendar internals evaluate.
+ *
+ * `dayOfWeek` has no declarative Temporal equivalent, so it becomes a predicate.
+ */
+/**
+ * Narrow the array form out of {@link DisabledDates}.
+ *
+ * `Array.isArray` narrows to `any[]`, which does not remove a `readonly T[]`
+ * member from a union — so the object branches below would still see it.
+ */
+function isDateList(matcher) {
+    return Array.isArray(matcher);
+}
+function adaptMatcher(matcher) {
+    if (typeof matcher === "string")
+        return fromISODate(matcher);
+    if (isDateList(matcher))
+        return matcher.map((date) => fromISODate(date));
+    if (typeof matcher === "function") {
+        return (date) => matcher(date.toString());
+    }
+    if ("dayOfWeek" in matcher) {
+        const wanted = new Set(matcher.dayOfWeek.map((day) => WEEKDAY_NUMBER[day]));
+        return (date) => wanted.has(date.dayOfWeek);
+    }
+    if ("before" in matcher)
+        return { before: fromISODate(matcher.before) };
+    if ("after" in matcher)
+        return { after: fromISODate(matcher.after) };
+    return { from: fromISODate(matcher.from), to: fromISODate(matcher.to) };
+}
+/**
+ * Convert the public `disabled` prop into internal matchers.
+ *
+ * Call this once per render behind a `useMemo` keyed on the prop — the result
+ * holds Temporal objects, which have no value identity, so recomputing it every
+ * render would invalidate every downstream `useCallback`.
+ */
+export function adaptDisabledDates(disabled) {
+    if (disabled === undefined)
+        return undefined;
+    // A bare `ISODate[]` is itself one matcher, not a list of them. An array of
+    // anything else is a list. `["2026-08-26"]` is therefore adapted as a single
+    // array-matcher, which evaluates identically either way.
+    if (Array.isArray(disabled)) {
+        if (disabled.every((entry) => typeof entry === "string")) {
+            return adaptMatcher(disabled);
+        }
+        return disabled.map(adaptMatcher);
+    }
+    return adaptMatcher(disabled);
+}
+//# sourceMappingURL=iso.js.map