@wow-two-beta/ui-vue 0.0.4 → 0.0.6

package/dist/foundation/datetime/TemporalCodecs.d.ts

@@ -0,0 +1,26 @@
+import { Temporal } from 'temporal-polyfill';
+import { Result } from '../results';
+/** Decodes one declared wire field and encodes its corresponding Temporal value. */
+export interface TemporalFieldCodec<T> {
+    readonly decode: (value: unknown) => Result<T>;
+    readonly encode: (value: T) => Result<string>;
+}
+declare function decodeTimeSpan(value: unknown): Result<Temporal.Duration>;
+declare function encodeTimeSpan(value: Temporal.Duration): Result<string>;
+/** Explicit, field-scoped Temporal wire encodings. Ordinary JSON strings are never inspected globally. */
+export declare const TemporalCodecs: {
+    /** An ISO instant with seconds and an explicit UTC offset; emits canonical UTC. */
+    readonly instant: TemporalFieldCodec<Temporal.Instant>;
+    /** An ISO-calendar date without a timezone or time-of-day. */
+    readonly plainDate: TemporalFieldCodec<Temporal.PlainDate>;
+    /** A clock time without a timezone, retaining up to nanosecond precision. */
+    readonly plainTime: TemporalFieldCodec<Temporal.PlainTime>;
+    /** An ISO duration; calendar years and months retain their calendar meaning. */
+    readonly isoDuration: TemporalFieldCodec<Temporal.Duration>;
+    /** CLR constant TimeSpan encoding, exact signed 64-bit ticks at 100 ns; days mean 24 elapsed hours. */
+    readonly clrTimeSpan: {
+        decode: typeof decodeTimeSpan;
+        encode: typeof encodeTimeSpan;
+    };
+};
+export {};

package/dist/foundation/datetime/index.d.ts

@@ -2,5 +2,6 @@ export { addDays, subDays, addWeeks, subWeeks, addMonths, subMonths, addYears, s
 export { startOfDay, endOfDay, startOfWeek, endOfWeek, startOfMonth, endOfMonth, startOfYear, endOfYear, type WeekStartsOn, } from './Boundaries';
 export { isSameDay, isSameWeek, isSameMonth, isSameYear, isBefore, isAfter, isBetween, isToday, isPast, isFuture, minDate, maxDate, clampDate, type BetweenOptions, } from './Comparison';
 export { differenceInSeconds, differenceInMinutes, differenceInHours, differenceInDays, differenceInWeeks, differenceInMonths, differenceInYears, } from './Difference';
-export { eachDayOfInterval, isWithinInterval, overlaps, type DateInterval, type OverlapOptions, } from './Interval';
+export { eachDayOfInterval, isWithinInterval, overlaps, type DateInterval, type OverlapOptions } from './Interval';
 export { isValidDate, parseIsoDate, toIsoDateString } from './IsoDate';
+export { TemporalCodecs, type TemporalFieldCodec } from './TemporalCodecs';

package/dist/foundation/datetime/index.js

@@ -1,7 +1,10 @@
-const MS_PER_SECOND = 1e3;
-const MS_PER_MINUTE = 6e4;
-const MS_PER_HOUR = 36e5;
-const MS_PER_DAY = 864e5;
+import { Temporal } from "temporal-polyfill";
+import { A as AppErrorFactory } from "../../chunks/AppErrorFactory-DCdNbVfv.js";
+import { R as ResultExtensions } from "../../chunks/ResultExtensions-B7dWH0FZ.js";
+const MsPerSecond = 1e3;
+const MsPerMinute = 6e4;
+const MsPerHour = 36e5;
+const MsPerDay = 864e5;
 function cloneDate(date) {
   return new Date(date.getTime());
 }
@@ -43,7 +46,7 @@ function subYears(date, amount) {
 }
 function addHours(date, amount) {
   const result = cloneDate(date);
-  result.setTime(result.getTime() + amount * MS_PER_HOUR);
+  result.setTime(result.getTime() + amount * MsPerHour);
   return result;
 }
 function subHours(date, amount) {
@@ -51,7 +54,7 @@ function subHours(date, amount) {
 }
 function addMinutes(date, amount) {
   const result = cloneDate(date);
-  result.setTime(result.getTime() + amount * MS_PER_MINUTE);
+  result.setTime(result.getTime() + amount * MsPerMinute);
   return result;
 }
 function subMinutes(date, amount) {
@@ -59,7 +62,7 @@ function subMinutes(date, amount) {
 }
 function addSeconds(date, amount) {
   const result = cloneDate(date);
-  result.setTime(result.getTime() + amount * MS_PER_SECOND);
+  result.setTime(result.getTime() + amount * MsPerSecond);
   return result;
 }
 function subSeconds(date, amount) {
@@ -106,8 +109,8 @@ function endOfYear(date) {
   result.setHours(23, 59, 59, 999);
   return result;
 }
-const DATE_ONLY = /^(\d{4})-(\d{2})-(\d{2})$/;
-const DATE_TIME = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2})?(\.\d{1,9})?(Z|[+-]\d{2}:?\d{2})?$/;
+const DateOnly = /^(\d{4})-(\d{2})-(\d{2})$/;
+const DateTime = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2})?(\.\d{1,9})?(Z|[+-]\d{2}:?\d{2})?$/;
 function isValidDate(value) {
   return value instanceof Date && !Number.isNaN(value.getTime());
 }
@@ -115,20 +118,24 @@ function parseIsoDate(value) {
   if (typeof value !== "string") return null;
   const text = value.trim();
   if (text === "") return null;
-  const dateOnly = DATE_ONLY.exec(text);
+  const dateOnly = DateOnly.exec(text);
   if (dateOnly !== null) {
-    const year = Number(dateOnly[1]);
-    const month = Number(dateOnly[2]);
-    const day = Number(dateOnly[3]);
+    const year2 = Number(dateOnly[1]);
+    const month2 = Number(dateOnly[2]);
+    const day2 = Number(dateOnly[3]);
     const result = new Date(2e3, 0, 1, 12);
-    result.setFullYear(year, month - 1, day);
+    result.setFullYear(year2, month2 - 1, day2);
     result.setHours(0, 0, 0, 0);
-    if (result.getFullYear() !== year || result.getMonth() !== month - 1 || result.getDate() !== day) {
+    if (result.getFullYear() !== year2 || result.getMonth() !== month2 - 1 || result.getDate() !== day2) {
       return null;
     }
     return result;
   }
-  if (!DATE_TIME.test(text)) return null;
+  if (!DateTime.test(text)) return null;
+  const year = Number(text.slice(0, 4));
+  const month = Number(text.slice(5, 7));
+  const day = Number(text.slice(8, 10));
+  if (month < 1 || month > 12 || day < 1 || day > daysInMonth(year, month - 1)) return null;
   const parsed = new Date(text);
   return isValidDate(parsed) ? parsed : null;
 }
@@ -200,16 +207,16 @@ function clampDate(date, min, max) {
   return cloneDate(result);
 }
 function differenceInSeconds(from, to) {
-  return Math.trunc((to.getTime() - from.getTime()) / MS_PER_SECOND);
+  return Math.trunc((to.getTime() - from.getTime()) / MsPerSecond);
 }
 function differenceInMinutes(from, to) {
-  return Math.trunc((to.getTime() - from.getTime()) / MS_PER_MINUTE);
+  return Math.trunc((to.getTime() - from.getTime()) / MsPerMinute);
 }
 function differenceInHours(from, to) {
-  return Math.trunc((to.getTime() - from.getTime()) / MS_PER_HOUR);
+  return Math.trunc((to.getTime() - from.getTime()) / MsPerHour);
 }
 function differenceInDays(from, to) {
-  return Math.round((startOfDay(to).getTime() - startOfDay(from).getTime()) / MS_PER_DAY);
+  return Math.round((startOfDay(to).getTime() - startOfDay(from).getTime()) / MsPerDay);
 }
 function differenceInWeeks(from, to) {
   return Math.trunc(differenceInDays(from, to) / 7);
@@ -226,6 +233,7 @@ function differenceInYears(from, to) {
   return Math.trunc(differenceInMonths(from, to) / 12);
 }
 function eachDayOfInterval(start, end) {
+  if (start.getTime() > end.getTime()) return [];
   const last = startOfDay(end).getTime();
   const days = [];
   let cursor = startOfDay(start);
@@ -249,7 +257,126 @@ function overlaps(a, b, options) {
   if (aStart === aEnd || bStart === bEnd) return false;
   return aStart < bEnd && bStart < aEnd;
 }
+const IsoDatePattern = /^\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\d|3[01])$/;
+const IsoTimePattern = /^(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d{1,9})?$/;
+const IsoInstantPattern = /^\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\d|3[01])T(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d{1,9})?(?:Z|[+-](?:[01]\d|2[0-3]):[0-5]\d)$/;
+const IsoDurationPattern = /^-?P(?=\d|T\d)(?:\d+Y)?(?:\d+M)?(?:\d+W)?(?:\d+D)?(?:T(?=\d)(?:\d+(?:\.\d+)?H)?(?:\d+(?:\.\d+)?M)?(?:\d+(?:\.\d+)?S)?)?$/;
+const TimeSpanPattern = /^(-)?(?:(0|[1-9]\d{0,7})\.)?([01]\d|2[0-3]):([0-5]\d):([0-5]\d)(?:\.(\d{1,7}))?$/;
+const TicksPerSecond = 10000000n;
+const TicksPerDay = 86400n * TicksPerSecond;
+const MinTicks = -9223372036854775808n;
+const MaxTicks = 9223372036854775807n;
+function invalid() {
+  return ResultExtensions.fail(AppErrorFactory.validation());
+}
+function codec(pattern, parse, format) {
+  return {
+    decode: (value) => {
+      if (typeof value !== "string" || pattern.exec(value)?.[0] !== value) return invalid();
+      try {
+        const decoded = parse(value);
+        const text = format(decoded);
+        if (pattern.exec(text)?.[0] !== text) return invalid();
+        return ResultExtensions.ok(decoded);
+      } catch {
+        return invalid();
+      }
+    },
+    encode: (value) => {
+      try {
+        const text = format(value);
+        if (pattern.exec(text)?.[0] !== text) return invalid();
+        return ResultExtensions.ok(text);
+      } catch {
+        return invalid();
+      }
+    }
+  };
+}
+function decodeTimeSpan(value) {
+  if (typeof value !== "string") return invalid();
+  const match = TimeSpanPattern.exec(value);
+  if (!match || match[0] !== value) return invalid();
+  const sign = match[1] ? -1 : 1;
+  const days = BigInt(match[2] ?? "0");
+  const hours = Number(match[3]);
+  const minutes = Number(match[4]);
+  const seconds = Number(match[5]);
+  const fraction = BigInt((match[6] ?? "").padEnd(7, "0"));
+  const ticks = BigInt(sign) * (days * TicksPerDay + BigInt(hours * 3600 + minutes * 60 + seconds) * TicksPerSecond + fraction);
+  if (ticks < MinTicks || ticks > MaxTicks) return invalid();
+  return ResultExtensions.ok(
+    Temporal.Duration.from({
+      days: sign * Number(days),
+      hours: sign * hours,
+      minutes: sign * minutes,
+      seconds: sign * seconds,
+      milliseconds: sign * Number(fraction / 10000n),
+      microseconds: sign * Number(fraction % 10000n / 10n),
+      nanoseconds: sign * Number(fraction % 10n) * 100
+    })
+  );
+}
+function encodeTimeSpan(value) {
+  try {
+    if (value.years !== 0 || value.months !== 0) return invalid();
+    const fields = [
+      value.weeks,
+      value.days,
+      value.hours,
+      value.minutes,
+      value.seconds,
+      value.milliseconds,
+      value.microseconds,
+      value.nanoseconds
+    ];
+    if (fields.some((field) => !Number.isSafeInteger(field)) || value.nanoseconds % 100 !== 0) return invalid();
+    const ticks = (BigInt(value.weeks) * 7n + BigInt(value.days)) * TicksPerDay + BigInt(value.hours) * 3600n * TicksPerSecond + BigInt(value.minutes) * 60n * TicksPerSecond + BigInt(value.seconds) * TicksPerSecond + BigInt(value.milliseconds) * 10000n + BigInt(value.microseconds) * 10n + BigInt(value.nanoseconds) / 100n;
+    if (ticks < MinTicks || ticks > MaxTicks) return invalid();
+    const absolute = ticks < 0n ? -ticks : ticks;
+    const days = absolute / TicksPerDay;
+    const seconds = absolute / TicksPerSecond;
+    const pad = (part) => String(part).padStart(2, "0");
+    const fraction = absolute % TicksPerSecond;
+    const text = `${ticks < 0n ? "-" : ""}${days === 0n ? "" : `${days}.`}${pad(seconds / 3600n % 24n)}:${pad(seconds / 60n % 60n)}:${pad(seconds % 60n)}${fraction === 0n ? "" : `.${String(fraction).padStart(7, "0")}`}`;
+    return ResultExtensions.ok(text);
+  } catch {
+    return invalid();
+  }
+}
+const TemporalCodecs = {
+  /** An ISO instant with seconds and an explicit UTC offset; emits canonical UTC. */
+  instant: codec(
+    IsoInstantPattern,
+    (value) => Temporal.Instant.from(value),
+    (value) => value.toString()
+  ),
+  /** An ISO-calendar date without a timezone or time-of-day. */
+  plainDate: codec(
+    IsoDatePattern,
+    (value) => Temporal.PlainDate.from(value),
+    (value) => {
+      if (value.calendarId !== "iso8601") throw new RangeError("Expected ISO calendar");
+      return value.toString();
+    }
+  ),
+  /** A clock time without a timezone, retaining up to nanosecond precision. */
+  plainTime: codec(
+    IsoTimePattern,
+    (value) => Temporal.PlainTime.from(value),
+    (value) => value.toString()
+  ),
+  /** An ISO duration; calendar years and months retain their calendar meaning. */
+  isoDuration: codec(
+    IsoDurationPattern,
+    (value) => Temporal.Duration.from(value),
+    (value) => value.toString()
+  ),
+  /** CLR constant TimeSpan encoding, exact signed 64-bit ticks at 100 ns; days mean 24 elapsed hours. */
+  clrTimeSpan: { decode: decodeTimeSpan, encode: encodeTimeSpan }
+};
 export {
+  TemporalCodecs,
   addDays,
   addHours,
   addMinutes,

package/dist/foundation/datetime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/foundation/datetime/Internals.ts","../../../src/foundation/datetime/Arithmetic.ts","../../../src/foundation/datetime/Boundaries.ts","../../../src/foundation/datetime/IsoDate.ts","../../../src/foundation/datetime/Comparison.ts","../../../src/foundation/datetime/Difference.ts","../../../src/foundation/datetime/Interval.ts"],"sourcesContent":["// Private helpers shared across the datetime slice — deliberately absent from `index.ts` so the public\n// surface stays exactly the documented operation set.\n//\n// Two invariants live here:\n//  1. `cloneDate` is the ONLY producer of a result `Date`. Every public op clones first, then mutates the\n//     clone — \"never mutate the input\" is then structural, not a review convention. A new op that reaches\n//     for `new Date(...)` directly is the thing to catch in review.\n//  2. `daysInMonth` uses the day-0 trick (day `0` of month N+1 = last day of month N) driven through\n//     `setFullYear`, NOT the `new Date(year, month, day)` constructor — that constructor maps years 0-99\n//     to 1900+year, which would silently mis-length February for a year-0-99 date. The probe starts at\n//     local noon so a DST midnight-transition zone can't shift the probe onto an adjacent day.\n\n/** Milliseconds in one second. */\nexport const MS_PER_SECOND = 1000;\n\n/** Milliseconds in one minute. */\nexport const MS_PER_MINUTE = 60_000;\n\n/** Milliseconds in one hour. */\nexport const MS_PER_HOUR = 3_600_000;\n\n/** Milliseconds in one 24-hour period (nominal — a DST day is 23 or 25 hours). */\nexport const MS_PER_DAY = 86_400_000;\n\n/** Copies a `Date` by timestamp. An invalid input yields an equally-invalid copy (`NaN` time). */\nexport function cloneDate(date: Date): Date {\n  return new Date(date.getTime());\n}\n\n/** Returns the length in days of `monthIndex` (0-11) in `year`, leap years included. */\nexport function daysInMonth(year: number, monthIndex: number): number {\n  const probe = new Date(2000, 0, 1, 12);\n  probe.setFullYear(year, monthIndex + 1, 0);\n  return probe.getDate();\n}\n","// Date arithmetic — every op returns a NEW `Date`, the input is never mutated.\n//\n// Two families with deliberately different semantics; picking the wrong one is the usual source of\n// off-by-one-hour bugs:\n//\n//  - CALENDAR ops (`addDays`/`addWeeks`/`addMonths`/`addYears`) go through `setDate`/`setMonth`, which\n//    operate on local wall-clock fields. Adding 1 day across a DST boundary therefore keeps the wall-clock\n//    time (09:00 → 09:00) even though only 23 or 25 hours elapsed. This is what a calendar UI wants.\n//  - ELAPSED ops (`addHours`/`addMinutes`/`addSeconds`) add absolute milliseconds. Across a DST boundary\n//    the wall-clock time shifts by the offset delta, because the request was \"N hours later\", not\n//    \"the same time N days on\". This is what a timer/deadline wants.\n//\n// `addMonths` CLAMPS to the target month's last day: Jan 31 + 1 month = Feb 28 (Feb 29 in a leap year),\n// never Mar 3. The naive `setMonth(getMonth() + 1)` overflows instead, which is the classic bug — the\n// day-of-month is parked at 1 before the month shift and re-applied clamped afterwards to prevent it.\n// `addYears` routes through `addMonths`, so Feb 29 + 1 year = Feb 28 by the same rule.\n\nimport { cloneDate, daysInMonth, MS_PER_HOUR, MS_PER_MINUTE, MS_PER_SECOND } from './Internals';\n\n/** Adds `amount` calendar days (may be negative); preserves wall-clock time across a DST boundary. */\nexport function addDays(date: Date, amount: number): Date {\n  const result = cloneDate(date);\n  result.setDate(result.getDate() + amount);\n  return result;\n}\n\n/** Subtracts `amount` calendar days; preserves wall-clock time across a DST boundary. */\nexport function subDays(date: Date, amount: number): Date {\n  return addDays(date, -amount);\n}\n\n/** Adds `amount` weeks (7 calendar days each); preserves wall-clock time across a DST boundary. */\nexport function addWeeks(date: Date, amount: number): Date {\n  return addDays(date, amount * 7);\n}\n\n/** Subtracts `amount` weeks (7 calendar days each). */\nexport function subWeeks(date: Date, amount: number): Date {\n  return addDays(date, -amount * 7);\n}\n\n/**\n * Adds `amount` calendar months, clamping the day-of-month to the target month's length —\n * Jan 31 + 1 = Feb 28 (Feb 29 in a leap year), Mar 31 - 1 = Feb 28. Time-of-day is preserved.\n */\nexport function addMonths(date: Date, amount: number): Date {\n  const result = cloneDate(date);\n  const day = result.getDate();\n  // Park on the 1st so the month shift can never overflow into the following month, then re-apply\n  // the original day clamped to what the target month actually has.\n  result.setDate(1);\n  result.setMonth(result.getMonth() + amount);\n  result.setDate(Math.min(day, daysInMonth(result.getFullYear(), result.getMonth())));\n  return result;\n}\n\n/** Subtracts `amount` calendar months, clamping the day-of-month to the target month's length. */\nexport function subMonths(date: Date, amount: number): Date {\n  return addMonths(date, -amount);\n}\n\n/** Adds `amount` calendar years, clamping Feb 29 to Feb 28 when the target year isn't a leap year. */\nexport function addYears(date: Date, amount: number): Date {\n  return addMonths(date, amount * 12);\n}\n\n/** Subtracts `amount` calendar years, clamping Feb 29 to Feb 28 when the target year isn't a leap year. */\nexport function subYears(date: Date, amount: number): Date {\n  return addMonths(date, -amount * 12);\n}\n\n/** Adds `amount` hours of elapsed time; wall-clock time shifts across a DST boundary. */\nexport function addHours(date: Date, amount: number): Date {\n  const result = cloneDate(date);\n  result.setTime(result.getTime() + amount * MS_PER_HOUR);\n  return result;\n}\n\n/** Subtracts `amount` hours of elapsed time; wall-clock time shifts across a DST boundary. */\nexport function subHours(date: Date, amount: number): Date {\n  return addHours(date, -amount);\n}\n\n/** Adds `amount` minutes of elapsed time. */\nexport function addMinutes(date: Date, amount: number): Date {\n  const result = cloneDate(date);\n  result.setTime(result.getTime() + amount * MS_PER_MINUTE);\n  return result;\n}\n\n/** Subtracts `amount` minutes of elapsed time. */\nexport function subMinutes(date: Date, amount: number): Date {\n  return addMinutes(date, -amount);\n}\n\n/** Adds `amount` seconds of elapsed time. */\nexport function addSeconds(date: Date, amount: number): Date {\n  const result = cloneDate(date);\n  result.setTime(result.getTime() + amount * MS_PER_SECOND);\n  return result;\n}\n\n/** Subtracts `amount` seconds of elapsed time. */\nexport function subSeconds(date: Date, amount: number): Date {\n  return addSeconds(date, -amount);\n}\n","// Period boundaries — snapping a `Date` to the first/last instant of its day, week, month, or year.\n// Every op returns a NEW `Date`; the input is never mutated.\n//\n// All boundaries are LOCAL wall-clock, matching how a user reads a calendar: \"today\" ends at local\n// 23:59:59.999, not at UTC midnight. End-of-period is the last representable millisecond (…:59.999)\n// rather than the next period's start, so a closed `[start, end]` range covers the period exactly and\n// `isWithinInterval` needs no half-open special case.\n//\n// `startOfWeek` takes `weekStartsOn` because the first day of the week is locale-dependent and NOT\n// derivable from the `Date` itself. The default is 1 (Monday) = ISO-8601, which is also what the\n// majority of locales use; a US/CA/JP calendar passes 0 (Sunday). There is no \"detect it from the\n// locale\" path here on purpose — `Intl` exposes no stable week-start API across engines, so guessing\n// would be worse than an explicit argument. Locale-aware DISPLAY stays in `foundation/i18n`.\n//\n// DST note: in the handful of zones whose DST transition happens AT midnight (e.g. America/Santiago),\n// local 00:00 does not exist on transition day and `setHours(0, …)` yields 01:00. That is the correct\n// \"first instant of the day\" in that zone — the guarantee is first-instant, not literally 00:00.\n\nimport { addDays, subDays } from './Arithmetic';\nimport { cloneDate } from './Internals';\n\n/** Day index a week starts on: `0` Sunday … `6` Saturday. */\nexport type WeekStartsOn = 0 | 1 | 2 | 3 | 4 | 5 | 6;\n\n/** Returns the first instant of `date`'s local day (00:00:00.000). */\nexport function startOfDay(date: Date): Date {\n  const result = cloneDate(date);\n  result.setHours(0, 0, 0, 0);\n  return result;\n}\n\n/** Returns the last instant of `date`'s local day (23:59:59.999). */\nexport function endOfDay(date: Date): Date {\n  const result = cloneDate(date);\n  result.setHours(23, 59, 59, 999);\n  return result;\n}\n\n/**\n * Returns the first instant of `date`'s week. `weekStartsOn` defaults to `1` (Monday, ISO-8601);\n * pass `0` for a Sunday-first (US) calendar.\n */\nexport function startOfWeek(date: Date, weekStartsOn: WeekStartsOn = 1): Date {\n  const offset = (date.getDay() - weekStartsOn + 7) % 7;\n  return startOfDay(subDays(date, offset));\n}\n\n/**\n * Returns the last instant of `date`'s week (day 7 at 23:59:59.999). `weekStartsOn` defaults to `1`\n * (Monday, ISO-8601); pass `0` for a Sunday-first (US) calendar.\n */\nexport function endOfWeek(date: Date, weekStartsOn: WeekStartsOn = 1): Date {\n  return endOfDay(addDays(startOfWeek(date, weekStartsOn), 6));\n}\n\n/** Returns the first instant of the 1st of `date`'s month. */\nexport function startOfMonth(date: Date): Date {\n  const result = cloneDate(date);\n  result.setDate(1);\n  result.setHours(0, 0, 0, 0);\n  return result;\n}\n\n/** Returns the last instant of the last day of `date`'s month (28th-31st at 23:59:59.999). */\nexport function endOfMonth(date: Date): Date {\n  const result = cloneDate(date);\n  // Day `0` of the NEXT month is the last day of this one — avoids a `daysInMonth` lookup and the\n  // day-overflow that `setMonth(getMonth() + 1)` alone would cause on a 31st.\n  result.setMonth(result.getMonth() + 1, 0);\n  result.setHours(23, 59, 59, 999);\n  return result;\n}\n\n/** Returns the first instant of Jan 1 of `date`'s year. */\nexport function startOfYear(date: Date): Date {\n  const result = cloneDate(date);\n  result.setMonth(0, 1);\n  result.setHours(0, 0, 0, 0);\n  return result;\n}\n\n/** Returns the last instant of Dec 31 of `date`'s year. */\nexport function endOfYear(date: Date): Date {\n  const result = cloneDate(date);\n  result.setMonth(11, 31);\n  result.setHours(23, 59, 59, 999);\n  return result;\n}\n","// ISO-8601 parsing + serialization, and the validity guard the rest of the slice leans on.\n//\n// Two spec traps this file exists to neutralize:\n//\n//  1. `new Date('2026-03-15')` — a DATE-ONLY ISO string is parsed as UTC midnight per spec, while a\n//     date-TIME string without an offset is parsed as local. So the same-looking input lands on a\n//     different calendar day depending on which shape it had and which side of UTC the user sits on.\n//     `parseIsoDate` reads a date-only string field-by-field into LOCAL midnight, which is what a\n//     `<input type=\"date\">` value means to the person who typed it.\n//  2. `date.toISOString().slice(0, 10)` — serializes in UTC, so 2026-03-15 23:30 in New York comes back\n//     as `2026-03-16`, and 2026-03-15 00:30 in Tokyo as `2026-03-14`. The day silently shifts, usually\n//     only for users in a subset of timezones, which is why it survives review. `toIsoDateString` reads\n//     the LOCAL fields instead and never touches UTC.\n//\n// Parsing is strict + anchored: only the two accepted shapes parse, everything else returns `null`. No\n// `Invalid Date` is ever returned, so a `Date` that leaves this module is always safe to store in state.\n// The accepted shapes mirror `foundation/http/temporalReviver` (`T` separator, no space) so a value that\n// the API client would upgrade to a `Temporal.*` is exactly a value this module parses.\n\nconst DATE_ONLY = /^(\\d{4})-(\\d{2})-(\\d{2})$/;\nconst DATE_TIME = /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?(\\.\\d{1,9})?(Z|[+-]\\d{2}:?\\d{2})?$/;\n\n/**\n * Narrows `value` to a usable `Date` — a `Date` instance whose time is not `NaN`. Use it before any\n * op in this slice when the input came from outside (props, storage, a hand-built `new Date(input)`).\n */\nexport function isValidDate(value: unknown): value is Date {\n  return value instanceof Date && !Number.isNaN(value.getTime());\n}\n\n/**\n * Parses an ISO-8601 `YYYY-MM-DD` or `YYYY-MM-DDTHH:mm[:ss[.sss]][Z|±HH:mm]` string, returning `null`\n * for any other input — including a well-shaped but impossible date such as `2026-02-30`. Never returns\n * an `Invalid Date`.\n *\n * A date-only string resolves to LOCAL midnight (not UTC midnight, which is what `new Date(string)`\n * would give). A date-time string keeps standard semantics: with an offset it is that absolute instant,\n * without one it is local wall-clock.\n */\nexport function parseIsoDate(value: string): Date | null {\n  if (typeof value !== 'string') return null;\n\n  const text = value.trim();\n  if (text === '') return null;\n\n  const dateOnly = DATE_ONLY.exec(text);\n  if (dateOnly !== null) {\n    const year = Number(dateOnly[1]);\n    const month = Number(dateOnly[2]);\n    const day = Number(dateOnly[3]);\n\n    const result = new Date(2000, 0, 1, 12);\n    // `setFullYear` rather than the `new Date(y, m, d)` constructor: that constructor maps years 0-99\n    // to 1900+year. The probe starts at local noon so a midnight-DST zone can't shift the day.\n    result.setFullYear(year, month - 1, day);\n    result.setHours(0, 0, 0, 0);\n\n    // Round-trip check — the setters normalize out-of-range fields (Feb 30 → Mar 2) instead of failing,\n    // so comparing back is the only way to reject an impossible date.\n    if (result.getFullYear() !== year || result.getMonth() !== month - 1 || result.getDate() !== day) {\n      return null;\n    }\n    return result;\n  }\n\n  if (!DATE_TIME.test(text)) return null;\n\n  const parsed = new Date(text);\n  return isValidDate(parsed) ? parsed : null;\n}\n\n/**\n * Serializes `date` to `YYYY-MM-DD` using its LOCAL calendar fields — the day never shifts by timezone\n * the way `toISOString().slice(0, 10)` does. Round-trips exactly with {@link parseIsoDate}.\n *\n * Throws a `RangeError` on an invalid `Date`, or on a year outside `0000`-`9999` (which ISO-8601 can\n * only express with the extended `±YYYYYY` form this function does not emit). Guard with\n * {@link isValidDate} when the input is untrusted.\n */\nexport function toIsoDateString(date: Date): string {\n  if (!isValidDate(date)) {\n    throw new RangeError('toIsoDateString: expected a valid Date, got an invalid one');\n  }\n\n  const year = date.getFullYear();\n  if (year < 0 || year > 9999) {\n    throw new RangeError(`toIsoDateString: year ${year} is outside the representable range 0000-9999`);\n  }\n\n  const month = String(date.getMonth() + 1).padStart(2, '0');\n  const day = String(date.getDate()).padStart(2, '0');\n  return `${String(year).padStart(4, '0')}-${month}-${day}`;\n}\n","// Date comparison + selection. Predicates return `boolean`; selectors (`minDate`/`maxDate`/`clampDate`)\n// return a NEW `Date` and never mutate an input.\n//\n// NOW IS ALWAYS INJECTABLE. `isToday`/`isPast`/`isFuture` take `now` as their last parameter, defaulting\n// to `new Date()` in the SIGNATURE — never buried in the body. A test passes a fixed `now` and the result\n// is deterministic; a caller that omits it gets the obvious behavior. Any future now-dependent predicate\n// added here must follow the same shape, otherwise the test for it can only be flaky or clock-mocked.\n//\n// Two slice-wide rules encoded here:\n//  - An invalid `Date` makes every predicate `false` (a `NaN` timestamp compares false against\n//    everything, including itself). No predicate throws — callers filter with `isValidDate`.\n//  - A REVERSED range (`start` after `end`) is EMPTY, not auto-normalized: `isBetween` returns `false`.\n//    Silently swapping the bounds would hide a caller bug behind a plausible answer, and the same rule\n//    holds in `Interval.ts` so the whole slice reads one way.\n\nimport { startOfWeek, type WeekStartsOn } from './Boundaries';\nimport { cloneDate } from './Internals';\nimport { isValidDate } from './IsoDate';\n\n/** Tunes whether a range test counts its bounds. */\nexport interface BetweenOptions {\n  /** Count `start`/`end` themselves as inside the range. Defaults to `true`. */\n  readonly inclusive?: boolean;\n}\n\n/** True when both dates fall on the same local calendar day. */\nexport function isSameDay(a: Date, b: Date): boolean {\n  return (\n    a.getFullYear() === b.getFullYear() && a.getMonth() === b.getMonth() && a.getDate() === b.getDate()\n  );\n}\n\n/**\n * True when both dates fall in the same week. `weekStartsOn` defaults to `1` (Monday, ISO-8601) and\n * must match the value used elsewhere in the same calendar — Dec 31 and Jan 1 can share a week.\n */\nexport function isSameWeek(a: Date, b: Date, weekStartsOn: WeekStartsOn = 1): boolean {\n  return startOfWeek(a, weekStartsOn).getTime() === startOfWeek(b, weekStartsOn).getTime();\n}\n\n/** True when both dates fall in the same month of the same year. */\nexport function isSameMonth(a: Date, b: Date): boolean {\n  return a.getFullYear() === b.getFullYear() && a.getMonth() === b.getMonth();\n}\n\n/** True when both dates fall in the same calendar year. */\nexport function isSameYear(a: Date, b: Date): boolean {\n  return a.getFullYear() === b.getFullYear();\n}\n\n/** True when `date` is strictly earlier than `other` (millisecond precision). */\nexport function isBefore(date: Date, other: Date): boolean {\n  return date.getTime() < other.getTime();\n}\n\n/** True when `date` is strictly later than `other` (millisecond precision). */\nexport function isAfter(date: Date, other: Date): boolean {\n  return date.getTime() > other.getTime();\n}\n\n/**\n * True when `date` falls in `[start, end]` — bounds included by default, excluded with\n * `{ inclusive: false }`. Returns `false` for a reversed range (`start` after `end`) and for any\n * invalid input; the bounds are never swapped for you.\n */\nexport function isBetween(date: Date, start: Date, end: Date, options?: BetweenOptions): boolean {\n  const value = date.getTime();\n  const from = start.getTime();\n  const to = end.getTime();\n  if (Number.isNaN(value) || Number.isNaN(from) || Number.isNaN(to)) return false;\n  if (from > to) return false;\n  return options?.inclusive === false ? value > from && value < to : value >= from && value <= to;\n}\n\n/** True when `date` falls on the same local day as `now` (defaults to the current clock; inject for tests). */\nexport function isToday(date: Date, now: Date = new Date()): boolean {\n  return isSameDay(date, now);\n}\n\n/** True when `date` is strictly before `now` (defaults to the current clock; inject for tests). */\nexport function isPast(date: Date, now: Date = new Date()): boolean {\n  return isBefore(date, now);\n}\n\n/** True when `date` is strictly after `now` (defaults to the current clock; inject for tests). */\nexport function isFuture(date: Date, now: Date = new Date()): boolean {\n  return isAfter(date, now);\n}\n\n// Shared scan for `minDate`/`maxDate`. Invalid dates are skipped so one bad entry can't win by way of a\n// `NaN` comparison; if every input is invalid the (invalid) first one is returned so the arity contract\n// — \"at least one date in, exactly one date out\" — never degrades into `null`.\nfunction select(first: Date, rest: readonly Date[], keep: (candidate: number, best: number) => boolean): Date {\n  const candidates = [first, ...rest].filter(isValidDate);\n  let best = candidates.at(0) ?? first;\n  for (const candidate of candidates) {\n    if (keep(candidate.getTime(), best.getTime())) best = candidate;\n  }\n  return cloneDate(best);\n}\n\n/** Returns a copy of the earliest of the given dates. Invalid dates are ignored unless all of them are. */\nexport function minDate(first: Date, ...rest: readonly Date[]): Date {\n  return select(first, rest, (candidate, best) => candidate < best);\n}\n\n/** Returns a copy of the latest of the given dates. Invalid dates are ignored unless all of them are. */\nexport function maxDate(first: Date, ...rest: readonly Date[]): Date {\n  return select(first, rest, (candidate, best) => candidate > best);\n}\n\n/**\n * Returns a copy of `date` pulled inside `[min, max]`. Either bound may be omitted or `null` to leave\n * that side open. Bounds are applied low-then-high, so a caller-inverted pair (`min` after `max`)\n * resolves to `max`.\n */\nexport function clampDate(date: Date, min?: Date | null, max?: Date | null): Date {\n  let result = date;\n  if (min != null && isBefore(result, min)) result = min;\n  if (max != null && isAfter(result, max)) result = max;\n  return cloneDate(result);\n}\n","// Signed distance between two dates, in whole units.\n//\n// ARGUMENT ORDER is `(from, to)` and the result is POSITIVE when `to` is later — the same order the\n// existing `daysBetween`/`minutesBetween` helpers in `presentation/forms/DateExtensions` already use.\n// Note this is the REVERSE of `date-fns`, whose `differenceInDays(dateLeft, dateRight)` computes\n// left − right; the parameter names are the reminder.\n//\n// TRUNCATION, never rounding: a partial trailing unit does not count, and truncation is toward zero, so\n// `differenceInX(a, b) === -differenceInX(b, a)` holds for every unit. 25 hours apart = 1 day; 23 hours\n// apart = 0 days. The one exception is internal: the day/week calculation rounds the raw millisecond\n// quotient because a DST day is 23 or 25 hours long and would otherwise truncate to a day short — both\n// endpoints are snapped to local start-of-day first, so what is being rounded is a whole-day quantity\n// that only DST perturbed. That makes day differences CALENDAR-day differences: Mar 15 23:00 → Mar 16\n// 01:00 is 1 day apart, not 0, which is what a calendar UI means by \"1 day\".\n//\n// Month/year differences are calendar-based and agree with `addMonths` clamping: Jan 31 → Feb 28 is a\n// full 1 month, because `addMonths(Jan 31, 1)` lands exactly on Feb 28.\n\nimport { addMonths } from './Arithmetic';\nimport { startOfDay } from './Boundaries';\nimport { MS_PER_DAY, MS_PER_HOUR, MS_PER_MINUTE, MS_PER_SECOND } from './Internals';\n\n/** Signed whole SECONDS from `from` to `to`, truncated toward zero. Positive when `to` is later. */\nexport function differenceInSeconds(from: Date, to: Date): number {\n  return Math.trunc((to.getTime() - from.getTime()) / MS_PER_SECOND);\n}\n\n/** Signed whole MINUTES from `from` to `to`, truncated toward zero. Positive when `to` is later. */\nexport function differenceInMinutes(from: Date, to: Date): number {\n  return Math.trunc((to.getTime() - from.getTime()) / MS_PER_MINUTE);\n}\n\n/** Signed whole HOURS of elapsed time from `from` to `to`, truncated toward zero. Positive when `to` is later. */\nexport function differenceInHours(from: Date, to: Date): number {\n  return Math.trunc((to.getTime() - from.getTime()) / MS_PER_HOUR);\n}\n\n/**\n * Signed CALENDAR days from `from` to `to`. Both endpoints are snapped to local start-of-day first, so\n * the result counts date boundaries crossed rather than 24-hour blocks, and a DST transition never\n * produces an off-by-one. Positive when `to` is later.\n */\nexport function differenceInDays(from: Date, to: Date): number {\n  return Math.round((startOfDay(to).getTime() - startOfDay(from).getTime()) / MS_PER_DAY);\n}\n\n/**\n * Signed whole WEEKS from `from` to `to`, derived from {@link differenceInDays} and truncated toward\n * zero — 13 calendar days apart is 1 week. Positive when `to` is later.\n */\nexport function differenceInWeeks(from: Date, to: Date): number {\n  return Math.trunc(differenceInDays(from, to) / 7);\n}\n\n/**\n * Signed whole calendar MONTHS from `from` to `to`, truncated toward zero — a partial trailing month is\n * dropped, so Jan 15 → Feb 14 is 0. Agrees with `addMonths` clamping (Jan 31 → Feb 28 is 1). Positive\n * when `to` is later.\n */\nexport function differenceInMonths(from: Date, to: Date): number {\n  const target = to.getTime();\n  let months = (to.getFullYear() - from.getFullYear()) * 12 + (to.getMonth() - from.getMonth());\n  if (Number.isNaN(months) || Number.isNaN(target)) return NaN;\n\n  // The field arithmetic above overshoots whenever the day-of-month (or time-of-day) hasn't been\n  // reached yet; step back one month in that case so the count is whole units only.\n  if (months > 0 && addMonths(from, months).getTime() > target) months -= 1;\n  else if (months < 0 && addMonths(from, months).getTime() < target) months += 1;\n  return months;\n}\n\n/**\n * Signed whole calendar YEARS from `from` to `to`, derived from {@link differenceInMonths} and truncated\n * toward zero — the usual \"age in years\" calculation. Positive when `to` is later.\n */\nexport function differenceInYears(from: Date, to: Date): number {\n  return Math.trunc(differenceInMonths(from, to) / 12);\n}\n","// Date ranges — the primitives a calendar grid, a range picker, and a scheduling view are built from.\n//\n// A REVERSED range is EMPTY across this whole slice (same rule as `isBetween`): `eachDayOfInterval`\n// returns `[]`, `isWithinInterval` and `overlaps` return `false`. The bounds are never swapped for you —\n// a reversed range is a caller bug, and normalizing it would return a plausible answer that hides it.\n// Invalid dates behave the same way, so neither function can spin: the loop guard compares against `NaN`\n// and exits immediately.\n//\n// The two membership tests use DIFFERENT bound semantics on purpose, because they answer different\n// questions:\n//  - `isWithinInterval` is a POINT-in-range test → bounds INCLUSIVE. \"Is this day inside the selected\n//    range\" must count the first and last day of the selection.\n//  - `overlaps` is an INTERVAL-vs-INTERVAL test → bounds HALF-OPEN `[start, end)` by default. Two\n//    back-to-back meetings (09:00-10:00 and 10:00-11:00) do not conflict, which is the answer every\n//    scheduler wants. Pass `{ inclusive: true }` for closed-range semantics, where a shared endpoint\n//    does count as an overlap.\n\nimport { addDays } from './Arithmetic';\nimport { startOfDay } from './Boundaries';\nimport { isBetween } from './Comparison';\n\n/** A date range with inclusive bounds. A reversed range (`start` after `end`) is treated as empty. */\nexport interface DateInterval {\n  /** Lower bound of the range. */\n  readonly start: Date;\n\n  /** Upper bound of the range. */\n  readonly end: Date;\n}\n\n/** Tunes whether an overlap test counts a shared endpoint. */\nexport interface OverlapOptions {\n  /**\n   * Treat both ranges as closed `[start, end]`, so ranges that merely touch at an endpoint count as\n   * overlapping. Defaults to `false` (half-open `[start, end)` — touching ranges do not overlap).\n   */\n  readonly inclusive?: boolean;\n}\n\n/**\n * Returns one `Date` per calendar day from `start` to `end`, both ends INCLUSIVE, each snapped to local\n * start-of-day. Returns `[]` when the range is reversed or either bound is invalid.\n *\n * Day stepping is calendar-based (not `+24h`), so a DST transition inside the range neither duplicates\n * nor skips a day.\n */\nexport function eachDayOfInterval(start: Date, end: Date): Date[] {\n  const last = startOfDay(end).getTime();\n  const days: Date[] = [];\n  let cursor = startOfDay(start);\n\n  while (cursor.getTime() <= last) {\n    days.push(cursor);\n    cursor = addDays(cursor, 1);\n  }\n  return days;\n}\n\n/**\n * True when `date` falls inside `interval`, bounds INCLUSIVE. Returns `false` for a reversed interval or\n * any invalid date. Compares at millisecond precision — pass day boundaries\n * (`startOfDay`/`endOfDay`) when a whole-day test is meant.\n */\nexport function isWithinInterval(date: Date, interval: DateInterval): boolean {\n  return isBetween(date, interval.start, interval.end);\n}\n\n/**\n * True when ranges `a` and `b` share any time. Half-open by default, so ranges that only touch at an\n * endpoint do NOT overlap; pass `{ inclusive: true }` to count a shared endpoint as an overlap.\n * Returns `false` when either range is reversed or holds an invalid date.\n *\n * A zero-length range (`start` equal to `end`) never overlaps anything under the default half-open\n * semantics; it does under `{ inclusive: true }`.\n */\nexport function overlaps(a: DateInterval, b: DateInterval, options?: OverlapOptions): boolean {\n  const aStart = a.start.getTime();\n  const aEnd = a.end.getTime();\n  const bStart = b.start.getTime();\n  const bEnd = b.end.getTime();\n\n  if (Number.isNaN(aStart) || Number.isNaN(aEnd) || Number.isNaN(bStart) || Number.isNaN(bEnd)) return false;\n  if (aStart > aEnd || bStart > bEnd) return false;\n\n  if (options?.inclusive === true) return aStart <= bEnd && bStart <= aEnd;\n\n  // A zero-length range spans no time at all, so under half-open semantics it intersects nothing — the\n  // bare `aStart < bEnd && bStart < aEnd` test would otherwise report an overlap for a degenerate range\n  // that happens to sit strictly INSIDE the other, but not for one sitting on its boundary. Callers\n  // asking \"is this instant inside that range\" want `isWithinInterval`, which is inclusive by design.\n  if (aStart === aEnd || bStart === bEnd) return false;\n\n  return aStart < bEnd && bStart < aEnd;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../../src/foundation/datetime/Internals.ts","../../../src/foundation/datetime/Arithmetic.ts","../../../src/foundation/datetime/Boundaries.ts","../../../src/foundation/datetime/IsoDate.ts","../../../src/foundation/datetime/Comparison.ts","../../../src/foundation/datetime/Difference.ts","../../../src/foundation/datetime/Interval.ts","../../../src/foundation/datetime/TemporalCodecs.ts"],"sourcesContent":["// Private helpers shared across the datetime slice — deliberately absent from `index.ts` so the public\n// surface stays exactly the documented operation set.\n//\n// Two invariants live here:\n//  1. `cloneDate` is the ONLY producer of a result `Date`. Every public op clones first, then mutates the\n//     clone — \"never mutate the input\" is then structural, not a review convention. A new op that reaches\n//     for `new Date(...)` directly is the thing to catch in review.\n//  2. `daysInMonth` uses the day-0 trick (day `0` of month N+1 = last day of month N) driven through\n//     `setFullYear`, NOT the `new Date(year, month, day)` constructor — that constructor maps years 0-99\n//     to 1900+year, which would silently mis-length February for a year-0-99 date. The probe starts at\n//     local noon so a DST midnight-transition zone can't shift the probe onto an adjacent day.\n\n/** Milliseconds in one second. */\nexport const MsPerSecond = 1000;\n\n/** Milliseconds in one minute. */\nexport const MsPerMinute = 60_000;\n\n/** Milliseconds in one hour. */\nexport const MsPerHour = 3_600_000;\n\n/** Milliseconds in one 24-hour period (nominal — a DST day is 23 or 25 hours). */\nexport const MsPerDay = 86_400_000;\n\n/** Copies a `Date` by timestamp. An invalid input yields an equally-invalid copy (`NaN` time). */\nexport function cloneDate(date: Date): Date {\n  return new Date(date.getTime());\n}\n\n/** Returns the length in days of `monthIndex` (0-11) in `year`, leap years included. */\nexport function daysInMonth(year: number, monthIndex: number): number {\n  const probe = new Date(2000, 0, 1, 12);\n  probe.setFullYear(year, monthIndex + 1, 0);\n  return probe.getDate();\n}\n","// Date arithmetic — every op returns a NEW `Date`, the input is never mutated.\n//\n// Two families with deliberately different semantics; picking the wrong one is the usual source of\n// off-by-one-hour bugs:\n//\n//  - CALENDAR ops (`addDays`/`addWeeks`/`addMonths`/`addYears`) go through `setDate`/`setMonth`, which\n//    operate on local wall-clock fields. Adding 1 day across a DST boundary therefore keeps the wall-clock\n//    time (09:00 → 09:00) even though only 23 or 25 hours elapsed. This is what a calendar UI wants.\n//  - ELAPSED ops (`addHours`/`addMinutes`/`addSeconds`) add absolute milliseconds. Across a DST boundary\n//    the wall-clock time shifts by the offset delta, because the request was \"N hours later\", not\n//    \"the same time N days on\". This is what a timer/deadline wants.\n//\n// `addMonths` CLAMPS to the target month's last day: Jan 31 + 1 month = Feb 28 (Feb 29 in a leap year),\n// never Mar 3. The naive `setMonth(getMonth() + 1)` overflows instead, which is the classic bug — the\n// day-of-month is parked at 1 before the month shift and re-applied clamped afterwards to prevent it.\n// `addYears` routes through `addMonths`, so Feb 29 + 1 year = Feb 28 by the same rule.\n\nimport { cloneDate, daysInMonth, MsPerHour, MsPerMinute, MsPerSecond } from './Internals';\n\n/** Adds `amount` calendar days (may be negative); preserves wall-clock time across a DST boundary. */\nexport function addDays(date: Date, amount: number): Date {\n  const result = cloneDate(date);\n  result.setDate(result.getDate() + amount);\n  return result;\n}\n\n/** Subtracts `amount` calendar days; preserves wall-clock time across a DST boundary. */\nexport function subDays(date: Date, amount: number): Date {\n  return addDays(date, -amount);\n}\n\n/** Adds `amount` weeks (7 calendar days each); preserves wall-clock time across a DST boundary. */\nexport function addWeeks(date: Date, amount: number): Date {\n  return addDays(date, amount * 7);\n}\n\n/** Subtracts `amount` weeks (7 calendar days each). */\nexport function subWeeks(date: Date, amount: number): Date {\n  return addDays(date, -amount * 7);\n}\n\n/**\n * Adds `amount` calendar months, clamping the day-of-month to the target month's length —\n * Jan 31 + 1 = Feb 28 (Feb 29 in a leap year), Mar 31 - 1 = Feb 28. Time-of-day is preserved.\n */\nexport function addMonths(date: Date, amount: number): Date {\n  const result = cloneDate(date);\n  const day = result.getDate();\n  // Park on the 1st so the month shift can never overflow into the following month, then re-apply\n  // the original day clamped to what the target month actually has.\n  result.setDate(1);\n  result.setMonth(result.getMonth() + amount);\n  result.setDate(Math.min(day, daysInMonth(result.getFullYear(), result.getMonth())));\n  return result;\n}\n\n/** Subtracts `amount` calendar months, clamping the day-of-month to the target month's length. */\nexport function subMonths(date: Date, amount: number): Date {\n  return addMonths(date, -amount);\n}\n\n/** Adds `amount` calendar years, clamping Feb 29 to Feb 28 when the target year isn't a leap year. */\nexport function addYears(date: Date, amount: number): Date {\n  return addMonths(date, amount * 12);\n}\n\n/** Subtracts `amount` calendar years, clamping Feb 29 to Feb 28 when the target year isn't a leap year. */\nexport function subYears(date: Date, amount: number): Date {\n  return addMonths(date, -amount * 12);\n}\n\n/** Adds `amount` hours of elapsed time; wall-clock time shifts across a DST boundary. */\nexport function addHours(date: Date, amount: number): Date {\n  const result = cloneDate(date);\n  result.setTime(result.getTime() + amount * MsPerHour);\n  return result;\n}\n\n/** Subtracts `amount` hours of elapsed time; wall-clock time shifts across a DST boundary. */\nexport function subHours(date: Date, amount: number): Date {\n  return addHours(date, -amount);\n}\n\n/** Adds `amount` minutes of elapsed time. */\nexport function addMinutes(date: Date, amount: number): Date {\n  const result = cloneDate(date);\n  result.setTime(result.getTime() + amount * MsPerMinute);\n  return result;\n}\n\n/** Subtracts `amount` minutes of elapsed time. */\nexport function subMinutes(date: Date, amount: number): Date {\n  return addMinutes(date, -amount);\n}\n\n/** Adds `amount` seconds of elapsed time. */\nexport function addSeconds(date: Date, amount: number): Date {\n  const result = cloneDate(date);\n  result.setTime(result.getTime() + amount * MsPerSecond);\n  return result;\n}\n\n/** Subtracts `amount` seconds of elapsed time. */\nexport function subSeconds(date: Date, amount: number): Date {\n  return addSeconds(date, -amount);\n}\n","// Period boundaries — snapping a `Date` to the first/last instant of its day, week, month, or year.\n// Every op returns a NEW `Date`; the input is never mutated.\n//\n// All boundaries are LOCAL wall-clock, matching how a user reads a calendar: \"today\" ends at local\n// 23:59:59.999, not at UTC midnight. End-of-period is the last representable millisecond (…:59.999)\n// rather than the next period's start, so a closed `[start, end]` range covers the period exactly and\n// `isWithinInterval` needs no half-open special case.\n//\n// `startOfWeek` takes `weekStartsOn` because the first day of the week is locale-dependent and NOT\n// derivable from the `Date` itself. The default is 1 (Monday) = ISO-8601, which is also what the\n// majority of locales use; a US/CA/JP calendar passes 0 (Sunday). There is no \"detect it from the\n// locale\" path here on purpose — `Intl` exposes no stable week-start API across engines, so guessing\n// would be worse than an explicit argument. Locale-aware DISPLAY stays in `foundation/i18n`.\n//\n// DST note: in the handful of zones whose DST transition happens AT midnight (e.g. America/Santiago),\n// local 00:00 does not exist on transition day and `setHours(0, …)` yields 01:00. That is the correct\n// \"first instant of the day\" in that zone — the guarantee is first-instant, not literally 00:00.\n\nimport { addDays, subDays } from './Arithmetic';\nimport { cloneDate } from './Internals';\n\n/** Day index a week starts on: `0` Sunday … `6` Saturday. */\nexport type WeekStartsOn = 0 | 1 | 2 | 3 | 4 | 5 | 6;\n\n/** Returns the first instant of `date`'s local day (00:00:00.000). */\nexport function startOfDay(date: Date): Date {\n  const result = cloneDate(date);\n  result.setHours(0, 0, 0, 0);\n  return result;\n}\n\n/** Returns the last instant of `date`'s local day (23:59:59.999). */\nexport function endOfDay(date: Date): Date {\n  const result = cloneDate(date);\n  result.setHours(23, 59, 59, 999);\n  return result;\n}\n\n/**\n * Returns the first instant of `date`'s week. `weekStartsOn` defaults to `1` (Monday, ISO-8601);\n * pass `0` for a Sunday-first (US) calendar.\n */\nexport function startOfWeek(date: Date, weekStartsOn: WeekStartsOn = 1): Date {\n  const offset = (date.getDay() - weekStartsOn + 7) % 7;\n  return startOfDay(subDays(date, offset));\n}\n\n/**\n * Returns the last instant of `date`'s week (day 7 at 23:59:59.999). `weekStartsOn` defaults to `1`\n * (Monday, ISO-8601); pass `0` for a Sunday-first (US) calendar.\n */\nexport function endOfWeek(date: Date, weekStartsOn: WeekStartsOn = 1): Date {\n  return endOfDay(addDays(startOfWeek(date, weekStartsOn), 6));\n}\n\n/** Returns the first instant of the 1st of `date`'s month. */\nexport function startOfMonth(date: Date): Date {\n  const result = cloneDate(date);\n  result.setDate(1);\n  result.setHours(0, 0, 0, 0);\n  return result;\n}\n\n/** Returns the last instant of the last day of `date`'s month (28th-31st at 23:59:59.999). */\nexport function endOfMonth(date: Date): Date {\n  const result = cloneDate(date);\n  // Day `0` of the NEXT month is the last day of this one — avoids a `daysInMonth` lookup and the\n  // day-overflow that `setMonth(getMonth() + 1)` alone would cause on a 31st.\n  result.setMonth(result.getMonth() + 1, 0);\n  result.setHours(23, 59, 59, 999);\n  return result;\n}\n\n/** Returns the first instant of Jan 1 of `date`'s year. */\nexport function startOfYear(date: Date): Date {\n  const result = cloneDate(date);\n  result.setMonth(0, 1);\n  result.setHours(0, 0, 0, 0);\n  return result;\n}\n\n/** Returns the last instant of Dec 31 of `date`'s year. */\nexport function endOfYear(date: Date): Date {\n  const result = cloneDate(date);\n  result.setMonth(11, 31);\n  result.setHours(23, 59, 59, 999);\n  return result;\n}\n","// ISO-8601 parsing + serialization, and the validity guard the rest of the slice leans on.\n//\n// Two spec traps this file exists to neutralize:\n//\n//  1. `new Date('2026-03-15')` — a DATE-ONLY ISO string is parsed as UTC midnight per spec, while a\n//     date-TIME string without an offset is parsed as local. So the same-looking input lands on a\n//     different calendar day depending on which shape it had and which side of UTC the user sits on.\n//     `parseIsoDate` reads a date-only string field-by-field into LOCAL midnight, which is what a\n//     `<input type=\"date\">` value means to the person who typed it.\n//  2. `date.toISOString().slice(0, 10)` — serializes in UTC, so 2026-03-15 23:30 in New York comes back\n//     as `2026-03-16`, and 2026-03-15 00:30 in Tokyo as `2026-03-14`. The day silently shifts, usually\n//     only for users in a subset of timezones, which is why it survives review. `toIsoDateString` reads\n//     the LOCAL fields instead and never touches UTC.\n//\n// Parsing is strict + anchored: only the two accepted shapes parse, everything else returns `null`. No\n// `Invalid Date` is ever returned, so a `Date` that leaves this module is always safe to store in state.\n// Date-time input uses an ISO `T` separator (no space). These are local Date utilities;\n// declared API wire fields use TemporalCodecs and their separate validation contracts.\n\nimport { daysInMonth } from './Internals';\n\nconst DateOnly = /^(\\d{4})-(\\d{2})-(\\d{2})$/;\nconst DateTime = /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?(\\.\\d{1,9})?(Z|[+-]\\d{2}:?\\d{2})?$/;\n\n/**\n * Narrows `value` to a usable `Date` — a `Date` instance whose time is not `NaN`. Use it before any\n * op in this slice when the input came from outside (props, storage, a hand-built `new Date(input)`).\n */\nexport function isValidDate(value: unknown): value is Date {\n  return value instanceof Date && !Number.isNaN(value.getTime());\n}\n\n/**\n * Parses an ISO-8601 `YYYY-MM-DD` or `YYYY-MM-DDTHH:mm[:ss[.sss]][Z|±HH:mm]` string, returning `null`\n * for any other input — including a well-shaped but impossible date such as `2026-02-30`. Never returns\n * an `Invalid Date`.\n *\n * A date-only string resolves to LOCAL midnight (not UTC midnight, which is what `new Date(string)`\n * would give). A date-time string keeps standard semantics: with an offset it is that absolute instant,\n * without one it is local wall-clock.\n */\nexport function parseIsoDate(value: string): Date | null {\n  if (typeof value !== 'string') return null;\n\n  const text = value.trim();\n  if (text === '') return null;\n\n  const dateOnly = DateOnly.exec(text);\n  if (dateOnly !== null) {\n    const year = Number(dateOnly[1]);\n    const month = Number(dateOnly[2]);\n    const day = Number(dateOnly[3]);\n\n    const result = new Date(2000, 0, 1, 12);\n    // `setFullYear` rather than the `new Date(y, m, d)` constructor: that constructor maps years 0-99\n    // to 1900+year. The probe starts at local noon so a midnight-DST zone can't shift the day.\n    result.setFullYear(year, month - 1, day);\n    result.setHours(0, 0, 0, 0);\n\n    // Round-trip check — the setters normalize out-of-range fields (Feb 30 → Mar 2) instead of failing,\n    // so comparing back is the only way to reject an impossible date.\n    if (result.getFullYear() !== year || result.getMonth() !== month - 1 || result.getDate() !== day) {\n      return null;\n    }\n    return result;\n  }\n\n  if (!DateTime.test(text)) return null;\n  const year = Number(text.slice(0, 4));\n  const month = Number(text.slice(5, 7));\n  const day = Number(text.slice(8, 10));\n  if (month < 1 || month > 12 || day < 1 || day > daysInMonth(year, month - 1)) return null;\n\n  const parsed = new Date(text);\n  return isValidDate(parsed) ? parsed : null;\n}\n\n/**\n * Serializes `date` to `YYYY-MM-DD` using its LOCAL calendar fields — the day never shifts by timezone\n * the way `toISOString().slice(0, 10)` does. Round-trips exactly with {@link parseIsoDate}.\n *\n * Throws a `RangeError` on an invalid `Date`, or on a year outside `0000`-`9999` (which ISO-8601 can\n * only express with the extended `±YYYYYY` form this function does not emit). Guard with\n * {@link isValidDate} when the input is untrusted.\n */\nexport function toIsoDateString(date: Date): string {\n  if (!isValidDate(date)) {\n    throw new RangeError('toIsoDateString: expected a valid Date, got an invalid one');\n  }\n\n  const year = date.getFullYear();\n  if (year < 0 || year > 9999) {\n    throw new RangeError(`toIsoDateString: year ${year} is outside the representable range 0000-9999`);\n  }\n\n  const month = String(date.getMonth() + 1).padStart(2, '0');\n  const day = String(date.getDate()).padStart(2, '0');\n  return `${String(year).padStart(4, '0')}-${month}-${day}`;\n}\n","// Date comparison + selection. Predicates return `boolean`; selectors (`minDate`/`maxDate`/`clampDate`)\n// return a NEW `Date` and never mutate an input.\n//\n// NOW IS ALWAYS INJECTABLE. `isToday`/`isPast`/`isFuture` take `now` as their last parameter, defaulting\n// to `new Date()` in the SIGNATURE — never buried in the body. A test passes a fixed `now` and the result\n// is deterministic; a caller that omits it gets the obvious behavior. Any future now-dependent predicate\n// added here must follow the same shape, otherwise the test for it can only be flaky or clock-mocked.\n//\n// Two slice-wide rules encoded here:\n//  - An invalid `Date` makes every predicate `false` (a `NaN` timestamp compares false against\n//    everything, including itself). No predicate throws — callers filter with `isValidDate`.\n//  - A REVERSED range (`start` after `end`) is EMPTY, not auto-normalized: `isBetween` returns `false`.\n//    Silently swapping the bounds would hide a caller bug behind a plausible answer, and the same rule\n//    holds in `Interval.ts` so the whole slice reads one way.\n\nimport { startOfWeek, type WeekStartsOn } from './Boundaries';\nimport { cloneDate } from './Internals';\nimport { isValidDate } from './IsoDate';\n\n/** Tunes whether a range test counts its bounds. */\nexport interface BetweenOptions {\n  /** Count `start`/`end` themselves as inside the range. Defaults to `true`. */\n  readonly inclusive?: boolean;\n}\n\n/** True when both dates fall on the same local calendar day. */\nexport function isSameDay(a: Date, b: Date): boolean {\n  return a.getFullYear() === b.getFullYear() && a.getMonth() === b.getMonth() && a.getDate() === b.getDate();\n}\n\n/**\n * True when both dates fall in the same week. `weekStartsOn` defaults to `1` (Monday, ISO-8601) and\n * must match the value used elsewhere in the same calendar — Dec 31 and Jan 1 can share a week.\n */\nexport function isSameWeek(a: Date, b: Date, weekStartsOn: WeekStartsOn = 1): boolean {\n  return startOfWeek(a, weekStartsOn).getTime() === startOfWeek(b, weekStartsOn).getTime();\n}\n\n/** True when both dates fall in the same month of the same year. */\nexport function isSameMonth(a: Date, b: Date): boolean {\n  return a.getFullYear() === b.getFullYear() && a.getMonth() === b.getMonth();\n}\n\n/** True when both dates fall in the same calendar year. */\nexport function isSameYear(a: Date, b: Date): boolean {\n  return a.getFullYear() === b.getFullYear();\n}\n\n/** True when `date` is strictly earlier than `other` (millisecond precision). */\nexport function isBefore(date: Date, other: Date): boolean {\n  return date.getTime() < other.getTime();\n}\n\n/** True when `date` is strictly later than `other` (millisecond precision). */\nexport function isAfter(date: Date, other: Date): boolean {\n  return date.getTime() > other.getTime();\n}\n\n/**\n * True when `date` falls in `[start, end]` — bounds included by default, excluded with\n * `{ inclusive: false }`. Returns `false` for a reversed range (`start` after `end`) and for any\n * invalid input; the bounds are never swapped for you.\n */\nexport function isBetween(date: Date, start: Date, end: Date, options?: BetweenOptions): boolean {\n  const value = date.getTime();\n  const from = start.getTime();\n  const to = end.getTime();\n  if (Number.isNaN(value) || Number.isNaN(from) || Number.isNaN(to)) return false;\n  if (from > to) return false;\n  return options?.inclusive === false ? value > from && value < to : value >= from && value <= to;\n}\n\n/** True when `date` falls on the same local day as `now` (defaults to the current clock; inject for tests). */\nexport function isToday(date: Date, now: Date = new Date()): boolean {\n  return isSameDay(date, now);\n}\n\n/** True when `date` is strictly before `now` (defaults to the current clock; inject for tests). */\nexport function isPast(date: Date, now: Date = new Date()): boolean {\n  return isBefore(date, now);\n}\n\n/** True when `date` is strictly after `now` (defaults to the current clock; inject for tests). */\nexport function isFuture(date: Date, now: Date = new Date()): boolean {\n  return isAfter(date, now);\n}\n\n// Shared scan for `minDate`/`maxDate`. Invalid dates are skipped so one bad entry can't win by way of a\n// `NaN` comparison; if every input is invalid the (invalid) first one is returned so the arity contract\n// — \"at least one date in, exactly one date out\" — never degrades into `null`.\nfunction select(first: Date, rest: ReadonlyArray<Date>, keep: (candidate: number, best: number) => boolean): Date {\n  const candidates = [first, ...rest].filter(isValidDate);\n  let best = candidates.at(0) ?? first;\n  for (const candidate of candidates) {\n    if (keep(candidate.getTime(), best.getTime())) best = candidate;\n  }\n  return cloneDate(best);\n}\n\n/** Returns a copy of the earliest of the given dates. Invalid dates are ignored unless all of them are. */\nexport function minDate(first: Date, ...rest: ReadonlyArray<Date>): Date {\n  return select(first, rest, (candidate, best) => candidate < best);\n}\n\n/** Returns a copy of the latest of the given dates. Invalid dates are ignored unless all of them are. */\nexport function maxDate(first: Date, ...rest: ReadonlyArray<Date>): Date {\n  return select(first, rest, (candidate, best) => candidate > best);\n}\n\n/**\n * Returns a copy of `date` pulled inside `[min, max]`. Either bound may be omitted or `null` to leave\n * that side open. Bounds are applied low-then-high, so a caller-inverted pair (`min` after `max`)\n * resolves to `max`.\n */\nexport function clampDate(date: Date, min?: Date | null, max?: Date | null): Date {\n  let result = date;\n  if (min != null && isBefore(result, min)) result = min;\n  if (max != null && isAfter(result, max)) result = max;\n  return cloneDate(result);\n}\n","// Signed distance between two dates, in whole units.\n//\n// ARGUMENT ORDER is `(from, to)` and the result is POSITIVE when `to` is later — the same order the\n// existing `daysBetween`/`minutesBetween` helpers in `presentation/forms/DateExtensions` already use.\n// Note this is the REVERSE of `date-fns`, whose `differenceInDays(dateLeft, dateRight)` computes\n// left − right; the parameter names are the reminder.\n//\n// TRUNCATION, never rounding: a partial trailing unit does not count, and truncation is toward zero, so\n// `differenceInX(a, b) === -differenceInX(b, a)` holds for every unit. 25 hours apart = 1 day; 23 hours\n// apart = 0 days. The one exception is internal: the day/week calculation rounds the raw millisecond\n// quotient because a DST day is 23 or 25 hours long and would otherwise truncate to a day short — both\n// endpoints are snapped to local start-of-day first, so what is being rounded is a whole-day quantity\n// that only DST perturbed. That makes day differences CALENDAR-day differences: Mar 15 23:00 → Mar 16\n// 01:00 is 1 day apart, not 0, which is what a calendar UI means by \"1 day\".\n//\n// Month/year differences are calendar-based and agree with `addMonths` clamping: Jan 31 → Feb 28 is a\n// full 1 month, because `addMonths(Jan 31, 1)` lands exactly on Feb 28.\n\nimport { addMonths } from './Arithmetic';\nimport { startOfDay } from './Boundaries';\nimport { MsPerDay, MsPerHour, MsPerMinute, MsPerSecond } from './Internals';\n\n/** Signed whole SECONDS from `from` to `to`, truncated toward zero. Positive when `to` is later. */\nexport function differenceInSeconds(from: Date, to: Date): number {\n  return Math.trunc((to.getTime() - from.getTime()) / MsPerSecond);\n}\n\n/** Signed whole MINUTES from `from` to `to`, truncated toward zero. Positive when `to` is later. */\nexport function differenceInMinutes(from: Date, to: Date): number {\n  return Math.trunc((to.getTime() - from.getTime()) / MsPerMinute);\n}\n\n/** Signed whole HOURS of elapsed time from `from` to `to`, truncated toward zero. Positive when `to` is later. */\nexport function differenceInHours(from: Date, to: Date): number {\n  return Math.trunc((to.getTime() - from.getTime()) / MsPerHour);\n}\n\n/**\n * Signed CALENDAR days from `from` to `to`. Both endpoints are snapped to local start-of-day first, so\n * the result counts date boundaries crossed rather than 24-hour blocks, and a DST transition never\n * produces an off-by-one. Positive when `to` is later.\n */\nexport function differenceInDays(from: Date, to: Date): number {\n  return Math.round((startOfDay(to).getTime() - startOfDay(from).getTime()) / MsPerDay);\n}\n\n/**\n * Signed whole WEEKS from `from` to `to`, derived from {@link differenceInDays} and truncated toward\n * zero — 13 calendar days apart is 1 week. Positive when `to` is later.\n */\nexport function differenceInWeeks(from: Date, to: Date): number {\n  return Math.trunc(differenceInDays(from, to) / 7);\n}\n\n/**\n * Signed whole calendar MONTHS from `from` to `to`, truncated toward zero — a partial trailing month is\n * dropped, so Jan 15 → Feb 14 is 0. Agrees with `addMonths` clamping (Jan 31 → Feb 28 is 1). Positive\n * when `to` is later.\n */\nexport function differenceInMonths(from: Date, to: Date): number {\n  const target = to.getTime();\n  let months = (to.getFullYear() - from.getFullYear()) * 12 + (to.getMonth() - from.getMonth());\n  if (Number.isNaN(months) || Number.isNaN(target)) return NaN;\n\n  // The field arithmetic above overshoots whenever the day-of-month (or time-of-day) hasn't been\n  // reached yet; step back one month in that case so the count is whole units only.\n  if (months > 0 && addMonths(from, months).getTime() > target) months -= 1;\n  else if (months < 0 && addMonths(from, months).getTime() < target) months += 1;\n  return months;\n}\n\n/**\n * Signed whole calendar YEARS from `from` to `to`, derived from {@link differenceInMonths} and truncated\n * toward zero — the usual \"age in years\" calculation. Positive when `to` is later.\n */\nexport function differenceInYears(from: Date, to: Date): number {\n  return Math.trunc(differenceInMonths(from, to) / 12);\n}\n","// Date ranges — the primitives a calendar grid, a range picker, and a scheduling view are built from.\n//\n// A REVERSED range is EMPTY across this whole slice (same rule as `isBetween`): `eachDayOfInterval`\n// returns `[]`, `isWithinInterval` and `overlaps` return `false`. The bounds are never swapped for you —\n// a reversed range is a caller bug, and normalizing it would return a plausible answer that hides it.\n// Invalid dates behave the same way, so neither function can spin: the loop guard compares against `NaN`\n// and exits immediately.\n//\n// The two membership tests use DIFFERENT bound semantics on purpose, because they answer different\n// questions:\n//  - `isWithinInterval` is a POINT-in-range test → bounds INCLUSIVE. \"Is this day inside the selected\n//    range\" must count the first and last day of the selection.\n//  - `overlaps` is an INTERVAL-vs-INTERVAL test → bounds HALF-OPEN `[start, end)` by default. Two\n//    back-to-back meetings (09:00-10:00 and 10:00-11:00) do not conflict, which is the answer every\n//    scheduler wants. Pass `{ inclusive: true }` for closed-range semantics, where a shared endpoint\n//    does count as an overlap.\n\nimport { addDays } from './Arithmetic';\nimport { startOfDay } from './Boundaries';\nimport { isBetween } from './Comparison';\n\n/** A date range with inclusive bounds. A reversed range (`start` after `end`) is treated as empty. */\nexport interface DateInterval {\n  /** Lower bound of the range. */\n  readonly start: Date;\n\n  /** Upper bound of the range. */\n  readonly end: Date;\n}\n\n/** Tunes whether an overlap test counts a shared endpoint. */\nexport interface OverlapOptions {\n  /**\n   * Treat both ranges as closed `[start, end]`, so ranges that merely touch at an endpoint count as\n   * overlapping. Defaults to `false` (half-open `[start, end)` — touching ranges do not overlap).\n   */\n  readonly inclusive?: boolean;\n}\n\n/**\n * Returns one `Date` per calendar day from `start` to `end`, both ends INCLUSIVE, each snapped to local\n * start-of-day. Returns `[]` when the range is reversed or either bound is invalid.\n *\n * Day stepping is calendar-based (not `+24h`), so a DST transition inside the range neither duplicates\n * nor skips a day.\n */\nexport function eachDayOfInterval(start: Date, end: Date): Date[] {\n  if (start.getTime() > end.getTime()) return [];\n  const last = startOfDay(end).getTime();\n  const days: Date[] = [];\n  let cursor = startOfDay(start);\n\n  while (cursor.getTime() <= last) {\n    days.push(cursor);\n    cursor = addDays(cursor, 1);\n  }\n  return days;\n}\n\n/**\n * True when `date` falls inside `interval`, bounds INCLUSIVE. Returns `false` for a reversed interval or\n * any invalid date. Compares at millisecond precision — pass day boundaries\n * (`startOfDay`/`endOfDay`) when a whole-day test is meant.\n */\nexport function isWithinInterval(date: Date, interval: DateInterval): boolean {\n  return isBetween(date, interval.start, interval.end);\n}\n\n/**\n * True when ranges `a` and `b` share any time. Half-open by default, so ranges that only touch at an\n * endpoint do NOT overlap; pass `{ inclusive: true }` to count a shared endpoint as an overlap.\n * Returns `false` when either range is reversed or holds an invalid date.\n *\n * A zero-length range (`start` equal to `end`) never overlaps anything under the default half-open\n * semantics; it does under `{ inclusive: true }`.\n */\nexport function overlaps(a: DateInterval, b: DateInterval, options?: OverlapOptions): boolean {\n  const aStart = a.start.getTime();\n  const aEnd = a.end.getTime();\n  const bStart = b.start.getTime();\n  const bEnd = b.end.getTime();\n\n  if (Number.isNaN(aStart) || Number.isNaN(aEnd) || Number.isNaN(bStart) || Number.isNaN(bEnd)) return false;\n  if (aStart > aEnd || bStart > bEnd) return false;\n\n  if (options?.inclusive === true) return aStart <= bEnd && bStart <= aEnd;\n\n  // A zero-length range spans no time at all, so under half-open semantics it intersects nothing — the\n  // bare `aStart < bEnd && bStart < aEnd` test would otherwise report an overlap for a degenerate range\n  // that happens to sit strictly INSIDE the other, but not for one sitting on its boundary. Callers\n  // asking \"is this instant inside that range\" want `isWithinInterval`, which is inclusive by design.\n  if (aStart === aEnd || bStart === bEnd) return false;\n\n  return aStart < bEnd && bStart < aEnd;\n}\n","import { Temporal } from 'temporal-polyfill';\nimport { AppErrorFactory, ResultExtensions, type Result } from '../results';\n\n/** Decodes one declared wire field and encodes its corresponding Temporal value. */\nexport interface TemporalFieldCodec<T> {\n  readonly decode: (value: unknown) => Result<T>;\n  readonly encode: (value: T) => Result<string>;\n}\n\nconst IsoDatePattern = /^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])$/;\nconst IsoTimePattern = /^(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d{1,9})?$/;\nconst IsoInstantPattern =\n  /^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])T(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d{1,9})?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$/;\nconst IsoDurationPattern =\n  /^-?P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+W)?(?:\\d+D)?(?:T(?=\\d)(?:\\d+(?:\\.\\d+)?H)?(?:\\d+(?:\\.\\d+)?M)?(?:\\d+(?:\\.\\d+)?S)?)?$/;\nconst TimeSpanPattern = /^(-)?(?:(0|[1-9]\\d{0,7})\\.)?([01]\\d|2[0-3]):([0-5]\\d):([0-5]\\d)(?:\\.(\\d{1,7}))?$/;\nconst TicksPerSecond = 10_000_000n;\nconst TicksPerDay = 86400n * TicksPerSecond;\nconst MinTicks = -9223372036854775808n;\nconst MaxTicks = 9223372036854775807n;\n\nfunction invalid<T>(): Result<T> {\n  return ResultExtensions.fail(AppErrorFactory.validation());\n}\n\nfunction codec<T>(pattern: RegExp, parse: (text: string) => T, format: (value: T) => string): TemporalFieldCodec<T> {\n  return {\n    decode: (value) => {\n      if (typeof value !== 'string' || pattern.exec(value)?.[0] !== value) return invalid();\n      try {\n        const decoded = parse(value);\n        const text = format(decoded);\n        if (pattern.exec(text)?.[0] !== text) return invalid();\n        return ResultExtensions.ok(decoded);\n      } catch {\n        return invalid();\n      }\n    },\n    encode: (value) => {\n      try {\n        const text = format(value);\n        if (pattern.exec(text)?.[0] !== text) return invalid();\n        return ResultExtensions.ok(text);\n      } catch {\n        return invalid();\n      }\n    },\n  };\n}\n\nfunction decodeTimeSpan(value: unknown): Result<Temporal.Duration> {\n  if (typeof value !== 'string') return invalid();\n  const match = TimeSpanPattern.exec(value);\n  if (!match || match[0] !== value) return invalid();\n  const sign = match[1] ? -1 : 1;\n  const days = BigInt(match[2] ?? '0');\n  const hours = Number(match[3]);\n  const minutes = Number(match[4]);\n  const seconds = Number(match[5]);\n  const fraction = BigInt((match[6] ?? '').padEnd(7, '0'));\n  const ticks =\n    BigInt(sign) * (days * TicksPerDay + BigInt(hours * 3600 + minutes * 60 + seconds) * TicksPerSecond + fraction);\n  if (ticks < MinTicks || ticks > MaxTicks) return invalid();\n  return ResultExtensions.ok(\n    Temporal.Duration.from({\n      days: sign * Number(days),\n      hours: sign * hours,\n      minutes: sign * minutes,\n      seconds: sign * seconds,\n      milliseconds: sign * Number(fraction / 10000n),\n      microseconds: sign * Number((fraction % 10000n) / 10n),\n      nanoseconds: sign * Number(fraction % 10n) * 100,\n    }),\n  );\n}\n\nfunction encodeTimeSpan(value: Temporal.Duration): Result<string> {\n  try {\n    if (value.years !== 0 || value.months !== 0) return invalid();\n    const fields = [\n      value.weeks,\n      value.days,\n      value.hours,\n      value.minutes,\n      value.seconds,\n      value.milliseconds,\n      value.microseconds,\n      value.nanoseconds,\n    ];\n    if (fields.some((field) => !Number.isSafeInteger(field)) || value.nanoseconds % 100 !== 0) return invalid();\n    const ticks =\n      (BigInt(value.weeks) * 7n + BigInt(value.days)) * TicksPerDay +\n      BigInt(value.hours) * 3600n * TicksPerSecond +\n      BigInt(value.minutes) * 60n * TicksPerSecond +\n      BigInt(value.seconds) * TicksPerSecond +\n      BigInt(value.milliseconds) * 10000n +\n      BigInt(value.microseconds) * 10n +\n      BigInt(value.nanoseconds) / 100n;\n    if (ticks < MinTicks || ticks > MaxTicks) return invalid();\n    const absolute = ticks < 0n ? -ticks : ticks;\n    const days = absolute / TicksPerDay;\n    const seconds = absolute / TicksPerSecond;\n    const pad = (part: bigint): string => String(part).padStart(2, '0');\n    const fraction = absolute % TicksPerSecond;\n    const text = `${ticks < 0n ? '-' : ''}${days === 0n ? '' : `${days}.`}${pad((seconds / 3600n) % 24n)}:${pad((seconds / 60n) % 60n)}:${pad(seconds % 60n)}${fraction === 0n ? '' : `.${String(fraction).padStart(7, '0')}`}`;\n    return ResultExtensions.ok(text);\n  } catch {\n    return invalid();\n  }\n}\n\n/** Explicit, field-scoped Temporal wire encodings. Ordinary JSON strings are never inspected globally. */\nexport const TemporalCodecs = {\n  /** An ISO instant with seconds and an explicit UTC offset; emits canonical UTC. */\n  instant: codec(\n    IsoInstantPattern,\n    (value) => Temporal.Instant.from(value),\n    (value: Temporal.Instant) => value.toString(),\n  ),\n  /** An ISO-calendar date without a timezone or time-of-day. */\n  plainDate: codec(\n    IsoDatePattern,\n    (value) => Temporal.PlainDate.from(value),\n    (value: Temporal.PlainDate) => {\n      if (value.calendarId !== 'iso8601') throw new RangeError('Expected ISO calendar');\n      return value.toString();\n    },\n  ),\n  /** A clock time without a timezone, retaining up to nanosecond precision. */\n  plainTime: codec(\n    IsoTimePattern,\n    (value) => Temporal.PlainTime.from(value),\n    (value: Temporal.PlainTime) => value.toString(),\n  ),\n  /** An ISO duration; calendar years and months retain their calendar meaning. */\n  isoDuration: codec(\n    IsoDurationPattern,\n    (value) => Temporal.Duration.from(value),\n    (value: Temporal.Duration) => value.toString(),\n  ),\n  /** CLR constant TimeSpan encoding, exact signed 64-bit ticks at 100 ns; days mean 24 elapsed hours. */\n  clrTimeSpan: { decode: decodeTimeSpan, encode: encodeTimeSpan } satisfies TemporalFieldCodec<Temporal.Duration>,\n} as const;\n"],"names":["year","month","day"],"mappings":"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"}

package/dist/foundation/device/Breakpoints.d.ts

@@ -4,7 +4,7 @@ export type BreakpointScale = Readonly<Record<string, number>>;
  * Tailwind v4's default breakpoint scale, in CSS pixels. Opt-in: pass it to `useBreakpoint` explicitly. An app
  * that customised its `@theme` breakpoints must pass its own map instead, or JS and CSS will disagree.
  */
-export declare const TAILWIND_BREAKPOINTS: {
+export declare const TailwindBreakpoints: {
     /** ≥ 640px. */
     readonly sm: 640;
     /** ≥ 768px. */
@@ -16,12 +16,6 @@ export declare const TAILWIND_BREAKPOINTS: {
     /** ≥ 1536px. */
     readonly '2xl': 1536;
 };
-/**
- * How many breakpoints a scale may contain. `useBreakpoint` fans out to exactly this many `useMediaQuery` calls;
- * eight covers every mainstream scale with room to spare (Tailwind ships 5, Bootstrap 6). See `UseBreakpoint.ts`
- * for why the count has to be a compile-time constant at all.
- */
-export declare const MAX_BREAKPOINTS = 8;
 /** One breakpoint compiled to the media query that detects it. */
 export interface BreakpointQuery<TKey extends string = string> {
     /** The scale key this query stands for. */
@@ -41,14 +35,14 @@ export interface BreakpointQuery<TKey extends string = string> {
  * @param scale The caller's breakpoint map.
  * @returns The scale's valid entries as queries, widest first.
  */
-export declare function toBreakpointQueries<TScale extends BreakpointScale>(scale: TScale): readonly BreakpointQuery<Extract<keyof TScale, string>>[];
+export declare function toBreakpointQueries<TScale extends BreakpointScale>(scale: TScale): ReadonlyArray<BreakpointQuery<Extract<keyof TScale, string>>>;
 /**
  * Picks the active breakpoint from a widest-first query list and the match results for it.
  *
  * @param queries Compiled queries, widest first, as returned by {@link toBreakpointQueries}.
  * @param matches Match results positionally aligned with `queries`. A shorter array reads as "did not match" for
- * the missing tail, which is how a scale larger than {@link MAX_BREAKPOINTS} loses its narrowest entries.
+ * the missing tail.
  * @returns The key of the widest matching breakpoint, or `null` when the viewport is narrower than every entry —
  * the implicit mobile-first base band, which by definition has no key of its own.
  */
-export declare function resolveBreakpoint<TKey extends string>(queries: readonly BreakpointQuery<TKey>[], matches: readonly boolean[]): TKey | null;
+export declare function resolveBreakpoint<TKey extends string>(queries: ReadonlyArray<BreakpointQuery<TKey>>, matches: ReadonlyArray<boolean>): TKey | null;

package/dist/foundation/device/hooks/UseBreakpoint.d.ts

@@ -0,0 +1,4 @@
+import { ComputedRef, MaybeRefOrGetter } from 'vue';
+import { BreakpointScale } from '../Breakpoints';
+/** Tracks every valid breakpoint in the caller's scale and releases replaced subscriptions. */
+export declare function useBreakpoint<TScale extends BreakpointScale>(scale: MaybeRefOrGetter<TScale>): ComputedRef<Extract<keyof TScale, string> | null>;

package/dist/foundation/device/hooks/UseDisplayMode.d.ts

@@ -0,0 +1,23 @@
+import { ComputedRef } from 'vue';
+import { DisplayMode } from '../enums/DisplayMode';
+/**
+ * Reports how the document is being presented — its {@link DisplayMode}.
+ *
+ * Falls back to `'browser'` when no mode query matches, which is also what SSR and any browser without
+ * `display-mode` support produce. `'browser'` therefore means "an ordinary tab, as far as can be told", not a
+ * proof that the app is uninstalled.
+ *
+ * @returns The active {@link DisplayMode}.
+ */
+export declare function useDisplayMode(): ComputedRef<DisplayMode>;
+/**
+ * Whether the app is running as an installed app rather than in a browser tab — any display mode other than
+ * `'browser'`.
+ *
+ * Reads `false` under SSR and on iOS < 16.4 (see this file's header). Use it to ADD an installed-only affordance
+ * — suppressing an "Install app" prompt, showing a custom title bar — never to withhold functionality, because a
+ * `false` here can mean "installed, but undetectable".
+ *
+ * @returns `true` when the app is presented outside an ordinary browser tab.
+ */
+export declare function useIsInstalled(): ComputedRef<boolean>;

package/dist/foundation/device/hooks/UseMediaQuery.d.ts

@@ -0,0 +1,14 @@
+import { MaybeRefOrGetter, ShallowRef } from 'vue';
+/**
+ * Reactively follow a CSS media query. Pass a query string like
+ * `'(min-width: 768px)'` or `'(prefers-reduced-motion: reduce)'`, or a ref /
+ * getter when the query itself changes.
+ *
+ * SSR-safe — the ref holds `false` on the server and during the first render,
+ * then syncs to the real value once mounted. The subscription is the Vue
+ * counterpart of the original's `useSyncExternalStore`: subscribe on mount,
+ * unsubscribe when the scope is disposed.
+ */
+/** Subscribes to one media query and reports its initial browser value. */
+export declare function subscribeMediaQuery(query: string, onChange: (matches: boolean) => void): () => void;
+export declare function useMediaQuery(query: MaybeRefOrGetter<string>): Readonly<ShallowRef<boolean>>;

package/dist/foundation/device/hooks/UsePointer.d.ts

@@ -0,0 +1,25 @@
+import { ComputedRef } from 'vue';
+import { PointerType } from '../enums/PointerType';
+/**
+ * Reports the precision of the primary pointing device — `'fine'` (mouse, trackpad, stylus), `'coarse'` (finger),
+ * or `'none'`.
+ *
+ * Reactive: a tablet gaining a mouse flips `'coarse'` → `'fine'` without a reload.
+ *
+ * Under SSR this reads `'none'` (there are no media features to read) and corrects on hydration. Treat `'none'`
+ * as "no pointer known", not as a fact — never hide an essential affordance behind it.
+ *
+ * @returns The active {@link PointerType}.
+ */
+export declare function usePointerType(): ComputedRef<PointerType>;
+/**
+ * Whether the primary pointing device can hover — the `(hover: hover)` media feature.
+ *
+ * Gate hover-only affordances on this: a tooltip that opens on mouseover, a table row's hover-revealed actions. On
+ * a touchscreen a hover-only control is simply unreachable and needs a tap target or an always-visible equivalent.
+ *
+ * Reads `false` under SSR, so hover-revealed content must never be the only path to an action.
+ *
+ * @returns `true` when the primary pointer can hover.
+ */
+export declare function useHoverCapability(): ComputedRef<boolean>;

package/dist/foundation/device/index.d.ts

@@ -1,8 +1,10 @@
-export { PointerType } from './PointerType';
-export { usePointerType, useHoverCapability } from './UsePointer';
-export { useOnlineStatus } from './UseOnlineStatus';
-export { DisplayMode } from './DisplayMode';
-export { useDisplayMode, useIsInstalled } from './UseDisplayMode';
+export { PointerType } from './enums/PointerType';
+export { usePointerType, useHoverCapability } from './hooks/UsePointer';
+export { useOnlineStatus } from './hooks/UseOnlineStatus';
+export { DisplayMode } from './enums/DisplayMode';
+export { useDisplayMode, useIsInstalled } from './hooks/UseDisplayMode';
 export { Platform, getPlatform } from './Platform';
-export { type BreakpointScale, type BreakpointQuery, TAILWIND_BREAKPOINTS, MAX_BREAKPOINTS, toBreakpointQueries, resolveBreakpoint, } from './Breakpoints';
-export { useBreakpoint } from './UseBreakpoint';
+export { type BreakpointScale, type BreakpointQuery, TailwindBreakpoints, toBreakpointQueries, resolveBreakpoint, } from './Breakpoints';
+export { useBreakpoint } from './hooks/UseBreakpoint';
+export { useMediaQuery } from './hooks/UseMediaQuery';
+export * from './hooks/UseReducedMotion';