@venizia/ignis-helpers 0.2.2-1 → 0.2.2-3

package/dist/esm/modules/temporal/calendar/calendar.d.ts

@@ -0,0 +1,56 @@
+import type { TTemporalUnit } from '../common/constants.js';
+import type { ITemporalParts, IZonedTemporalParts } from '../common/types.js';
+/**
+ * Calendar arithmetic on wall-clock fields, at a fixed offset or none at all - never a time zone,
+ * never the host's. `TemporalHelper` brings the zone.
+ */
+export declare class TemporalCalendar {
+    /** The years a four-digit `YYYY` spells - the range every method reads and writes. */
+    static readonly MIN_YEAR = 1;
+    static readonly MAX_YEAR = 9999;
+    /** Units that measure elapsed time rather than the calendar - 24 hours is not always a day. */
+    static readonly EXACT_UNIT_MILLISECONDS: Partial<Record<TTemporalUnit, number>>;
+    /** A UTC scratch date - `Date.UTC` maps years 0-99 onto 1900-1999, `setUTCFullYear` does not. */
+    private static scratch;
+    static isSupportedYear(opts: {
+        year: number;
+    }): boolean;
+    static daysInMonth(opts: {
+        year: number;
+        month: number;
+    }): number;
+    /** Whether the fields name a day and a time the calendar has - Feb 30, 24:00 and year 0 do not. */
+    static isRealDateTime(opts: {
+        parts: ITemporalParts;
+    }): boolean;
+    /** Epoch milliseconds of wall-clock fields read at a fixed offset. */
+    static epochAtOffset(opts: {
+        parts: ITemporalParts;
+        offsetMilliseconds: number;
+    }): number;
+    /** The wall clock an instant shows at a fixed offset - pure arithmetic, never the host's zone. */
+    static wallClockAt(opts: {
+        epoch: number;
+        offsetMilliseconds: number;
+    }): IZonedTemporalParts;
+    /** The wall-clock fields alone, without the weekday and the offset. */
+    static wallClockOf(opts: {
+        parts: ITemporalParts;
+    }): ITemporalParts;
+    /** The wall-clock start of the unit holding `parts`. Weeks start on Monday; quarters in Jan, Apr, Jul, Oct. */
+    static truncate(opts: {
+        parts: IZonedTemporalParts;
+        unit: TTemporalUnit;
+    }): ITemporalParts;
+    /**
+     * `parts` moved by whole units on the wall clock - no time zone involved. Hours and smaller move
+     * elapsed time; days and weeks move the calendar date, wall time untouched; months, quarters and
+     * years move the month, the day clamped to the target month: Jan 31 + 1 month is Feb 28.
+     */
+    static shift(opts: {
+        parts: ITemporalParts;
+        amount: number;
+        unit: TTemporalUnit;
+    }): ITemporalParts;
+}
+//# sourceMappingURL=calendar.d.ts.map

package/dist/esm/modules/temporal/calendar/calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../../../../src/modules/temporal/calendar/calendar.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAM3E;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,sFAAsF;IACtF,MAAM,CAAC,QAAQ,CAAC,QAAQ,KAAK;IAC7B,MAAM,CAAC,QAAQ,CAAC,QAAQ,QAAQ;IAEhC,+FAA+F;IAC/F,MAAM,CAAC,QAAQ,CAAC,uBAAuB,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAK7E;IAEF,iGAAiG;IACjG,OAAO,CAAC,MAAM,CAAC,OAAO;IAMtB,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO;IAIvD,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAQjE,mGAAmG;IACnG,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,cAAc,CAAA;KAAE,GAAG,OAAO;IAoB/D,sEAAsE;IACtE,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,cAAc,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAWzF,kGAAkG;IAClG,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,GAAG,mBAAmB;IAkB5F,uEAAuE;IACvE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,cAAc,CAAA;KAAE,GAAG,cAAc;IAKnE,+GAA+G;IAC/G,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,mBAAmB,CAAC;QAAC,IAAI,EAAE,aAAa,CAAA;KAAE,GAAG,cAAc;IAqC1F;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;QACjB,KAAK,EAAE,cAAc,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,aAAa,CAAC;KACrB,GAAG,cAAc;CAwCnB"}

package/dist/esm/modules/temporal/calendar/calendar.js

@@ -0,0 +1,162 @@
+import { TemporalUnits } from '../common/constants.js';
+const MILLISECONDS_PER_MINUTE = 60_000;
+const MONTHS_PER_YEAR = 12;
+const DAYS_PER_WEEK = 7;
+/**
+ * Calendar arithmetic on wall-clock fields, at a fixed offset or none at all - never a time zone,
+ * never the host's. `TemporalHelper` brings the zone.
+ */
+export class TemporalCalendar {
+    /** The years a four-digit `YYYY` spells - the range every method reads and writes. */
+    static { this.MIN_YEAR = 1; }
+    static { this.MAX_YEAR = 9999; }
+    /** Units that measure elapsed time rather than the calendar - 24 hours is not always a day. */
+    static { this.EXACT_UNIT_MILLISECONDS = {
+        [TemporalUnits.MILLISECOND]: 1,
+        [TemporalUnits.SECOND]: 1_000,
+        [TemporalUnits.MINUTE]: 60_000,
+        [TemporalUnits.HOUR]: 3_600_000,
+    }; }
+    /** A UTC scratch date - `Date.UTC` maps years 0-99 onto 1900-1999, `setUTCFullYear` does not. */
+    static scratch(opts) {
+        const date = new Date(0);
+        date.setUTCFullYear(opts.year, opts.month - 1, opts.day);
+        return date;
+    }
+    static isSupportedYear(opts) {
+        return opts.year >= TemporalCalendar.MIN_YEAR && opts.year <= TemporalCalendar.MAX_YEAR;
+    }
+    static daysInMonth(opts) {
+        return TemporalCalendar.scratch({
+            year: opts.year,
+            month: opts.month + 1,
+            day: 0,
+        }).getUTCDate();
+    }
+    /** Whether the fields name a day and a time the calendar has - Feb 30, 24:00 and year 0 do not. */
+    static isRealDateTime(opts) {
+        const { year, month, day, hour, minute, second, millisecond } = opts.parts;
+        return (TemporalCalendar.isSupportedYear({ year }) &&
+            month >= 1 &&
+            month <= 12 &&
+            day >= 1 &&
+            day <= TemporalCalendar.daysInMonth({ year, month }) &&
+            hour >= 0 &&
+            hour <= 23 &&
+            minute >= 0 &&
+            minute <= 59 &&
+            second >= 0 &&
+            second <= 59 &&
+            millisecond >= 0 &&
+            millisecond <= 999);
+    }
+    /** Epoch milliseconds of wall-clock fields read at a fixed offset. */
+    static epochAtOffset(opts) {
+        const { parts, offsetMilliseconds } = opts;
+        const date = TemporalCalendar.scratch({
+            year: parts.year,
+            month: parts.month,
+            day: parts.day,
+        });
+        date.setUTCHours(parts.hour, parts.minute, parts.second, parts.millisecond);
+        return date.getTime() - offsetMilliseconds;
+    }
+    /** The wall clock an instant shows at a fixed offset - pure arithmetic, never the host's zone. */
+    static wallClockAt(opts) {
+        const { epoch, offsetMilliseconds } = opts;
+        const date = new Date(epoch + offsetMilliseconds);
+        return {
+            year: date.getUTCFullYear(),
+            month: date.getUTCMonth() + 1,
+            day: date.getUTCDate(),
+            hour: date.getUTCHours(),
+            minute: date.getUTCMinutes(),
+            second: date.getUTCSeconds(),
+            millisecond: date.getUTCMilliseconds(),
+            // `getUTCDay` counts Sunday as 0; ISO counts Monday as 1 and Sunday as 7.
+            dayOfWeek: ((date.getUTCDay() + 6) % 7) + 1,
+            offsetMinutes: offsetMilliseconds / MILLISECONDS_PER_MINUTE,
+        };
+    }
+    /** The wall-clock fields alone, without the weekday and the offset. */
+    static wallClockOf(opts) {
+        const { year, month, day, hour, minute, second, millisecond } = opts.parts;
+        return { year, month, day, hour, minute, second, millisecond };
+    }
+    /** The wall-clock start of the unit holding `parts`. Weeks start on Monday; quarters in Jan, Apr, Jul, Oct. */
+    static truncate(opts) {
+        const { parts, unit } = opts;
+        const wall = TemporalCalendar.wallClockOf({ parts });
+        const midnight = { ...wall, hour: 0, minute: 0, second: 0, millisecond: 0 };
+        switch (unit) {
+            case TemporalUnits.SECOND: {
+                return { ...wall, millisecond: 0 };
+            }
+            case TemporalUnits.MINUTE: {
+                return { ...wall, second: 0, millisecond: 0 };
+            }
+            case TemporalUnits.HOUR: {
+                return { ...wall, minute: 0, second: 0, millisecond: 0 };
+            }
+            case TemporalUnits.DAY: {
+                return midnight;
+            }
+            case TemporalUnits.WEEK: {
+                return TemporalCalendar.shift({
+                    parts: midnight,
+                    amount: 1 - parts.dayOfWeek,
+                    unit: TemporalUnits.DAY,
+                });
+            }
+            case TemporalUnits.MONTH: {
+                return { ...midnight, day: 1 };
+            }
+            case TemporalUnits.QUARTER: {
+                return { ...midnight, month: Math.floor((wall.month - 1) / 3) * 3 + 1, day: 1 };
+            }
+            default: {
+                return { ...midnight, month: 1, day: 1 };
+            }
+        }
+    }
+    /**
+     * `parts` moved by whole units on the wall clock - no time zone involved. Hours and smaller move
+     * elapsed time; days and weeks move the calendar date, wall time untouched; months, quarters and
+     * years move the month, the day clamped to the target month: Jan 31 + 1 month is Feb 28.
+     */
+    static shift(opts) {
+        const { parts, amount, unit } = opts;
+        const exact = TemporalCalendar.EXACT_UNIT_MILLISECONDS[unit];
+        if (exact !== undefined) {
+            const epoch = TemporalCalendar.epochAtOffset({ parts, offsetMilliseconds: 0 }) + amount * exact;
+            return TemporalCalendar.wallClockOf({
+                parts: TemporalCalendar.wallClockAt({ epoch, offsetMilliseconds: 0 }),
+            });
+        }
+        if (unit === TemporalUnits.DAY || unit === TemporalUnits.WEEK) {
+            const days = unit === TemporalUnits.WEEK ? amount * DAYS_PER_WEEK : amount;
+            const date = TemporalCalendar.scratch({
+                year: parts.year,
+                month: parts.month,
+                day: parts.day + days,
+            });
+            return {
+                ...parts,
+                year: date.getUTCFullYear(),
+                month: date.getUTCMonth() + 1,
+                day: date.getUTCDate(),
+            };
+        }
+        const monthsPerUnit = unit === TemporalUnits.QUARTER ? 3 : unit === TemporalUnits.YEAR ? MONTHS_PER_YEAR : 1;
+        const total = parts.year * MONTHS_PER_YEAR + (parts.month - 1) + amount * monthsPerUnit;
+        const year = Math.floor(total / MONTHS_PER_YEAR);
+        const month = total - year * MONTHS_PER_YEAR + 1;
+        return {
+            ...parts,
+            year,
+            month,
+            day: Math.min(parts.day, TemporalCalendar.daysInMonth({ year, month })),
+        };
+    }
+}
+//# sourceMappingURL=calendar.js.map

package/dist/esm/modules/temporal/calendar/calendar.js.map

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

package/dist/esm/modules/temporal/calendar/index.d.ts

@@ -0,0 +1,2 @@
+export * from './calendar.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/modules/temporal/calendar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/temporal/calendar/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}

package/dist/esm/modules/temporal/calendar/index.js

@@ -0,0 +1,2 @@
+export * from './calendar.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/modules/temporal/calendar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/modules/temporal/calendar/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}

package/dist/esm/modules/temporal/common/constants.d.ts

@@ -1,5 +1,5 @@
 import type { TConstValue } from '../../../common/types/index.js';
-/** Units `add`, `subtract`, `startOf` and `endOf` accept. Weeks are ISO weeks - they start on Monday. */
+/** Units `add`, `subtract`, `startOf` and `endOf` accept. Weeks are ISO weeks - they start on Monday; a quarter is three calendar months from January, April, July or October. */
 export declare class TemporalUnits {
     static readonly MILLISECOND = "millisecond";
     static readonly SECOND = "second";
@@ -8,13 +8,14 @@ export declare class TemporalUnits {
     static readonly DAY = "day";
     static readonly WEEK = "week";
     static readonly MONTH = "month";
+    static readonly QUARTER = "quarter";
     static readonly YEAR = "year";
     static readonly SCHEME_SET: Set<string>;
     static isValid(input: string): input is TTemporalUnit;
 }
 export type TTemporalUnit = TConstValue<typeof TemporalUnits>;
-/** A helper built without a `timeZone` computes in UTC - never in the host's zone, which differs per machine. */
-export declare const DEFAULT_TEMPORAL_TIME_ZONE = "UTC";
+/** A helper built without a `tz` computes in UTC - never in the host's zone, which differs per machine. */
+export declare const DEFAULT_TEMPORAL_TZ = "UTC";
 /** `format` with no pattern writes ISO 8601 with the zone's offset: `2026-09-19T12:00:00.000+07:00`. */
 export declare const DEFAULT_TEMPORAL_PATTERN = "YYYY-MM-DDTHH:mm:ss.SSSZ";
 /** The locale name tokens and `formatIntl` write in when a helper is built without one. */
@@ -29,4 +30,14 @@ export declare class TemporalDurationStyles {
     static isValid(input: string): input is TTemporalDurationStyle;
 }
 export type TTemporalDurationStyle = TConstValue<typeof TemporalDurationStyles>;
+/** Which ends of the range `isBetween` counts: `[` includes an end, `(` leaves it out. */
+export declare class TemporalInclusivities {
+    static readonly EXCLUSIVE = "()";
+    static readonly INCLUSIVE = "[]";
+    static readonly START_ONLY = "[)";
+    static readonly END_ONLY = "(]";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(input: string): input is TTemporalInclusivity;
+}
+export type TTemporalInclusivity = TConstValue<typeof TemporalInclusivities>;
 //# sourceMappingURL=constants.d.ts.map

package/dist/esm/modules/temporal/common/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/modules/temporal/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,yGAAyG;AACzG,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAC5C,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS;IAC5B,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAE9B,MAAM,CAAC,QAAQ,CAAC,UAAU,cASvB;IAEH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,aAAa;CAGtD;AAED,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,aAAa,CAAC,CAAC;AAE9D,iHAAiH;AACjH,eAAO,MAAM,0BAA0B,QAAQ,CAAC;AAEhD,wGAAwG;AACxG,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AAEnE,2FAA2F;AAC3F,eAAO,MAAM,uBAAuB,UAAU,CAAC;AAE/C,uGAAuG;AACvG,qBAAa,sBAAsB;IACjC,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;IACpC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAE9B,MAAM,CAAC,QAAQ,CAAC,UAAU,cAA+D;IAEzF,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,sBAAsB;CAG/D;AAED,MAAM,MAAM,sBAAsB,GAAG,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/modules/temporal/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,kLAAkL;AAClL,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAC5C,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS;IAC5B,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;IACpC,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAE9B,MAAM,CAAC,QAAQ,CAAC,UAAU,cAUvB;IAEH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,aAAa;CAGtD;AAED,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,aAAa,CAAC,CAAC;AAE9D,2GAA2G;AAC3G,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAEzC,wGAAwG;AACxG,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AAEnE,2FAA2F;AAC3F,eAAO,MAAM,uBAAuB,UAAU,CAAC;AAE/C,uGAAuG;AACvG,qBAAa,sBAAsB;IACjC,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;IACpC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAE9B,MAAM,CAAC,QAAQ,CAAC,UAAU,cAA+D;IAEzF,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,sBAAsB;CAG/D;AAED,MAAM,MAAM,sBAAsB,GAAG,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEhF,0FAA0F;AAC1F,qBAAa,qBAAqB;IAChC,MAAM,CAAC,QAAQ,CAAC,SAAS,QAAQ;IACjC,MAAM,CAAC,QAAQ,CAAC,SAAS,QAAQ;IACjC,MAAM,CAAC,QAAQ,CAAC,UAAU,QAAQ;IAClC,MAAM,CAAC,QAAQ,CAAC,QAAQ,QAAQ;IAEhC,MAAM,CAAC,QAAQ,CAAC,UAAU,cAKvB;IAEH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,oBAAoB;CAG7D;AAED,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/esm/modules/temporal/common/constants.js

@@ -1,4 +1,4 @@
-/** Units `add`, `subtract`, `startOf` and `endOf` accept. Weeks are ISO weeks - they start on Monday. */
+/** Units `add`, `subtract`, `startOf` and `endOf` accept. Weeks are ISO weeks - they start on Monday; a quarter is three calendar months from January, April, July or October. */
 export class TemporalUnits {
     static { this.MILLISECOND = 'millisecond'; }
     static { this.SECOND = 'second'; }
@@ -7,6 +7,7 @@ export class TemporalUnits {
     static { this.DAY = 'day'; }
     static { this.WEEK = 'week'; }
     static { this.MONTH = 'month'; }
+    static { this.QUARTER = 'quarter'; }
     static { this.YEAR = 'year'; }
     static { this.SCHEME_SET = new Set([
         this.MILLISECOND,
@@ -16,14 +17,15 @@ export class TemporalUnits {
         this.DAY,
         this.WEEK,
         this.MONTH,
+        this.QUARTER,
         this.YEAR,
     ]); }
     static isValid(input) {
         return this.SCHEME_SET.has(input);
     }
 }
-/** A helper built without a `timeZone` computes in UTC - never in the host's zone, which differs per machine. */
-export const DEFAULT_TEMPORAL_TIME_ZONE = 'UTC';
+/** A helper built without a `tz` computes in UTC - never in the host's zone, which differs per machine. */
+export const DEFAULT_TEMPORAL_TZ = 'UTC';
 /** `format` with no pattern writes ISO 8601 with the zone's offset: `2026-09-19T12:00:00.000+07:00`. */
 export const DEFAULT_TEMPORAL_PATTERN = 'YYYY-MM-DDTHH:mm:ss.SSSZ';
 /** The locale name tokens and `formatIntl` write in when a helper is built without one. */
@@ -39,4 +41,20 @@ export class TemporalDurationStyles {
         return this.SCHEME_SET.has(input);
     }
 }
+/** Which ends of the range `isBetween` counts: `[` includes an end, `(` leaves it out. */
+export class TemporalInclusivities {
+    static { this.EXCLUSIVE = '()'; }
+    static { this.INCLUSIVE = '[]'; }
+    static { this.START_ONLY = '[)'; }
+    static { this.END_ONLY = '(]'; }
+    static { this.SCHEME_SET = new Set([
+        this.EXCLUSIVE,
+        this.INCLUSIVE,
+        this.START_ONLY,
+        this.END_ONLY,
+    ]); }
+    static isValid(input) {
+        return this.SCHEME_SET.has(input);
+    }
+}
 //# sourceMappingURL=constants.js.map

package/dist/esm/modules/temporal/common/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/modules/temporal/common/constants.ts"],"names":[],"mappings":"AAEA,yGAAyG;AACzG,MAAM,OAAO,aAAa;aACR,gBAAW,GAAG,aAAa,CAAC;aAC5B,WAAM,GAAG,QAAQ,CAAC;aAClB,WAAM,GAAG,QAAQ,CAAC;aAClB,SAAI,GAAG,MAAM,CAAC;aACd,QAAG,GAAG,KAAK,CAAC;aACZ,SAAI,GAAG,MAAM,CAAC;aACd,UAAK,GAAG,OAAO,CAAC;aAChB,SAAI,GAAG,MAAM,CAAC;aAEd,eAAU,GAAG,IAAI,GAAG,CAAC;QACnC,IAAI,CAAC,WAAW;QAChB,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,GAAG;QACR,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,IAAI;KACV,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAKH,iHAAiH;AACjH,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAC;AAEhD,wGAAwG;AACxG,MAAM,CAAC,MAAM,wBAAwB,GAAG,0BAA0B,CAAC;AAEnE,2FAA2F;AAC3F,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAC;AAE/C,uGAAuG;AACvG,MAAM,OAAO,sBAAsB;aACjB,YAAO,GAAG,SAAS,CAAC;aACpB,WAAM,GAAG,QAAQ,CAAC;aAClB,UAAK,GAAG,OAAO,CAAC;aAChB,SAAI,GAAG,MAAM,CAAC;aAEd,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAEzF,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/modules/temporal/common/constants.ts"],"names":[],"mappings":"AAEA,kLAAkL;AAClL,MAAM,OAAO,aAAa;aACR,gBAAW,GAAG,aAAa,CAAC;aAC5B,WAAM,GAAG,QAAQ,CAAC;aAClB,WAAM,GAAG,QAAQ,CAAC;aAClB,SAAI,GAAG,MAAM,CAAC;aACd,QAAG,GAAG,KAAK,CAAC;aACZ,SAAI,GAAG,MAAM,CAAC;aACd,UAAK,GAAG,OAAO,CAAC;aAChB,YAAO,GAAG,SAAS,CAAC;aACpB,SAAI,GAAG,MAAM,CAAC;aAEd,eAAU,GAAG,IAAI,GAAG,CAAC;QACnC,IAAI,CAAC,WAAW;QAChB,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,GAAG;QACR,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,OAAO;QACZ,IAAI,CAAC,IAAI;KACV,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAKH,2GAA2G;AAC3G,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAEzC,wGAAwG;AACxG,MAAM,CAAC,MAAM,wBAAwB,GAAG,0BAA0B,CAAC;AAEnE,2FAA2F;AAC3F,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAC;AAE/C,uGAAuG;AACvG,MAAM,OAAO,sBAAsB;aACjB,YAAO,GAAG,SAAS,CAAC;aACpB,WAAM,GAAG,QAAQ,CAAC;aAClB,UAAK,GAAG,OAAO,CAAC;aAChB,SAAI,GAAG,MAAM,CAAC;aAEd,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAEzF,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAKH,0FAA0F;AAC1F,MAAM,OAAO,qBAAqB;aAChB,cAAS,GAAG,IAAI,CAAC;aACjB,cAAS,GAAG,IAAI,CAAC;aACjB,eAAU,GAAG,IAAI,CAAC;aAClB,aAAQ,GAAG,IAAI,CAAC;aAEhB,eAAU,GAAG,IAAI,GAAG,CAAC;QACnC,IAAI,CAAC,SAAS;QACd,IAAI,CAAC,SAAS;QACd,IAAI,CAAC,UAAU;QACf,IAAI,CAAC,QAAQ;KACd,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC"}

package/dist/esm/modules/temporal/common/types.d.ts

@@ -1,3 +1,4 @@
+import type { TemporalUnits, TTemporalDurationStyle, TTemporalInclusivity, TTemporalUnit } from './constants.js';
 /** What a date-taking method accepts: a `Date`, epoch milliseconds, or an ISO 8601 string. */
 export type TTemporalInput = Date | number | string;
 /** Wall-clock fields. `month` is 1-12, `day` 1-31 - never zero-based. */
@@ -23,10 +24,10 @@ export interface IZonedTemporalParts extends ITemporalParts {
  * adapter shares one behaviour.
  */
 export interface ITemporalAdapter {
-    /** Milliseconds east of UTC that `timeZone` observes at `value`: `25_200_000` for `+07:00`. */
+    /** Milliseconds east of UTC that `tz` observes at `value`: `25_200_000` for `+07:00`. */
     getOffsetMilliseconds(opts: {
         value: Date;
-        timeZone: string;
+        tz: string;
     }): number;
 }
 /** The part of a `Temporal.ZonedDateTime` this adapter reads. */
@@ -40,19 +41,19 @@ export interface ITemporalZonedDateTime {
 export interface ITemporalNamespace {
     Instant: {
         fromEpochMilliseconds(epochMilliseconds: number): {
-            toZonedDateTimeISO(timeZone: string): ITemporalZonedDateTime;
+            toZonedDateTimeISO(tz: string): ITemporalZonedDateTime;
         };
     };
 }
 /** The part of a `Dayjs` object this adapter reads. */
 export interface IDayjsInstance {
     utcOffset(): number;
-    tz(timeZone: string): IDayjsInstance;
+    tz(tz: string): IDayjsInstance;
 }
 /** The part of the `dayjs` factory this adapter drives - with the `utc` and `timezone` plugins extended. */
 export interface IDayjsFactory {
     (value?: Date | number): IDayjsInstance;
-    tz: (value: string, timeZone: string) => IDayjsInstance;
+    tz: (value: string, tz: string) => IDayjsInstance;
 }
 /** The part of a Luxon `DateTime` this adapter reads. */
 export interface ILuxonDateTime {
@@ -75,4 +76,256 @@ export interface ITemporalDurationParts {
     seconds: number;
     milliseconds: number;
 }
+/**
+ * A locale's own wording, over what `Intl` writes for it: month names (January first), weekday
+ * names in ISO order (Monday first), and the AM and PM markers. Any list left out stays `Intl`'s.
+ */
+export interface ITemporalLocaleNames {
+    months?: ReadonlyArray<string>;
+    monthsShort?: ReadonlyArray<string>;
+    weekdays?: ReadonlyArray<string>;
+    weekdaysShort?: ReadonlyArray<string>;
+    weekdaysMin?: ReadonlyArray<string>;
+    meridiem?: readonly [string, string];
+}
+/** The fields `set` replaces on the wall clock: `month` is 1-12. */
+export type TTemporalFields = Partial<ITemporalParts>;
+/** The units `Intl.RelativeTimeFormat` speaks: every temporal unit but the millisecond. */
+export type TRelativeUnit = Exclude<TTemporalUnit, typeof TemporalUnits.MILLISECOND>;
+/** What a temporal helper does: dates in one time zone, through an adapter. `TemporalHelper` is the implementation. */
+export interface ITemporalHelper {
+    /**
+     * A date picker hands back a `Date` meaning "this wall clock in the host's zone". This returns the
+     * instant that shows the same year, month, day and time in the helper's zone. `sourceTz` defaults
+     * to the host's. A skipped wall time resolves forward, a repeated one to the earlier instant.
+     */
+    fromWallClock(opts: {
+        value: TTemporalInput;
+        sourceTz?: string;
+        tz?: string;
+    }): Date;
+    /**
+     * The reverse of `fromWallClock`, to feed a picker: a `Date` whose wall clock in `targetTz` (default:
+     * the host's) reads what the helper's zone reads for `value`.
+     */
+    toWallClock(opts: {
+        value: TTemporalInput;
+        targetTz?: string;
+        tz?: string;
+    }): Date;
+    /** A helper like this one, with another locale or zone: same adapter, same `names`. */
+    clone(opts: {
+        locale?: string;
+        tz?: string;
+    }): ITemporalHelper;
+    getTz(): string;
+    getLocale(): string;
+    now(): Date;
+    /** The instant a value names. An ISO string without an offset is read as wall clock in the zone. */
+    toDate(opts: {
+        value: TTemporalInput;
+        tz?: string;
+    }): Date;
+    /** `toDate`, answering `null` where `toDate` refuses the value: null, undefined, bad text, NaN. */
+    tryToDate(opts: {
+        value: TTemporalInput | null | undefined;
+        tz?: string;
+    }): Date | null;
+    /** The wall clock the value shows in the zone, with its ISO weekday and UTC offset. */
+    parts(opts: {
+        value: TTemporalInput;
+        tz?: string;
+    }): IZonedTemporalParts;
+    /**
+     * Reads a string. With a `pattern` (`YYYY YY MM M DD D HH H mm m ss s SSS Z ZZ`, text in
+     * `[brackets]`), the value must match it exactly; without one it must be ISO 8601. An offset in
+     * the value wins; otherwise the fields are wall clock in the zone.
+     */
+    parse(opts: {
+        value: string;
+        pattern?: string;
+        tz?: string;
+    }): Date;
+    /** `parse`, answering `null` where `parse` refuses the value. A pattern that does not compile still throws. */
+    tryParse(opts: {
+        value: string;
+        pattern?: string;
+        tz?: string;
+    }): Date | null;
+    /** Whether the value names an instant in years 1-9999 - a string read as `parse` reads it. */
+    isValid(opts: {
+        value: TTemporalInput | null | undefined;
+        pattern?: string;
+        tz?: string;
+    }): boolean;
+    /**
+     * Writes the value in the zone. Without a `pattern`: ISO 8601 with the zone's offset. The tokens
+     * `MMMM MMM dddd ddd dd A a hh h LL L` are spelled in `locale`. With a `fallback`, a value that is
+     * not a date - null included - writes the fallback; without one, it is a 400.
+     */
+    format(opts: {
+        value: TTemporalInput | null | undefined;
+        pattern?: string;
+        tz?: string;
+        locale?: string;
+        fallback?: string;
+    }): string;
+    /** Writes the value with `Intl.DateTimeFormat` options, in the zone - for what the pattern tokens cannot say. */
+    formatIntl(opts: {
+        value: TTemporalInput;
+        options?: Omit<Intl.DateTimeFormatOptions, 'timeZone'>;
+        tz?: string;
+        locale?: string;
+    }): string;
+    /**
+     * Moves the value by whole units. Hours and smaller are elapsed time; days and larger move the
+     * calendar in the zone, so a day across a daylight-saving jump keeps the wall time, and a month
+     * past a shorter month clamps to its last day.
+     */
+    add(opts: {
+        value: TTemporalInput;
+        amount: number;
+        unit: TTemporalUnit;
+        tz?: string;
+    }): Date;
+    subtract(opts: {
+        value: TTemporalInput;
+        amount: number;
+        unit: TTemporalUnit;
+        tz?: string;
+    }): Date;
+    /** The first instant of the unit containing the value, in the zone. Weeks start on Monday. */
+    startOf(opts: {
+        value: TTemporalInput;
+        unit: TTemporalUnit;
+        tz?: string;
+    }): Date;
+    /** The last millisecond of the unit containing the value, in the zone. */
+    endOf(opts: {
+        value: TTemporalInput;
+        unit: TTemporalUnit;
+        tz?: string;
+    }): Date;
+    /** Monday to Friday, read on the wall clock of the zone. */
+    isWeekday(opts: {
+        value: TTemporalInput;
+        tz?: string;
+    }): boolean;
+    nextWeekday(opts: {
+        value: TTemporalInput;
+        tz?: string;
+    }): Date;
+    previousWeekday(opts: {
+        value: TTemporalInput;
+        tz?: string;
+    }): Date;
+    /**
+     * The value with wall-clock fields replaced in the zone - `{ hour: 9, minute: 0 }` is 09:00 that day.
+     * `month` is 1-12. The day is clamped to the month's last day, so setting February on the 31st
+     * lands on the 28th or 29th. A wall time a daylight-saving jump skips resolves forward, as `parse` does.
+     */
+    set(opts: {
+        value: TTemporalInput;
+        tz?: string;
+    } & TTemporalFields): Date;
+    /** `value` is before `other` - at the unit's granularity in the zone when `unit` is given. */
+    isBefore(opts: {
+        value: TTemporalInput;
+        other: TTemporalInput;
+        unit?: TTemporalUnit;
+        tz?: string;
+    }): boolean;
+    isAfter(opts: {
+        value: TTemporalInput;
+        other: TTemporalInput;
+        unit?: TTemporalUnit;
+        tz?: string;
+    }): boolean;
+    /** In the same unit - `unit: 'day'` is the same calendar day in the zone. */
+    isSame(opts: {
+        value: TTemporalInput;
+        other: TTemporalInput;
+        unit?: TTemporalUnit;
+        tz?: string;
+    }): boolean;
+    isSameOrBefore(opts: {
+        value: TTemporalInput;
+        other: TTemporalInput;
+        unit?: TTemporalUnit;
+        tz?: string;
+    }): boolean;
+    isSameOrAfter(opts: {
+        value: TTemporalInput;
+        other: TTemporalInput;
+        unit?: TTemporalUnit;
+        tz?: string;
+    }): boolean;
+    /**
+     * Whether `value` lies between `from` and `to`, in either order. `inclusivity` says which ends count:
+     * `()` (the default) neither, `[]` both, `[)` the start, `(]` the end.
+     */
+    isBetween(opts: {
+        value: TTemporalInput;
+        from: TTemporalInput;
+        to: TTemporalInput;
+        unit?: TTemporalUnit;
+        inclusivity?: TTemporalInclusivity;
+        tz?: string;
+    }): boolean;
+    /**
+     * How many whole units `value` is past `other` - negative when it is before - truncated toward
+     * zero, counted as dayjs counts. Hours and smaller are elapsed time. Days and weeks are calendar
+     * days in the zone: the wall clocks' difference, so a 23-hour daylight-saving day is one day.
+     * Months, quarters and years are anchored on the date with the later day of the month, then
+     * truncated, so `diff(a, b)` is always `-diff(b, a)`.
+     */
+    diff(opts: {
+        value: TTemporalInput;
+        other: TTemporalInput;
+        unit: TTemporalUnit;
+        tz?: string;
+    }): number;
+    /**
+     * `-1`, `0` or `1` as `value` is before, in, or after the unit that holds `other`, in the zone.
+     * Without a unit the two instants are compared to the millisecond.
+     */
+    compare(opts: {
+        value: TTemporalInput;
+        other: TTemporalInput;
+        unit?: TTemporalUnit;
+        tz?: string;
+    }): -1 | 0 | 1;
+    /**
+     * `value` relative to `base` (default: now) in words, through `Intl.RelativeTimeFormat`:
+     * `3 hours ago`, `in 2 days`. With a `unit`, it counts the unit's boundaries in the zone, so
+     * 23:00 yesterday seen at 01:00 is `yesterday` under `numeric: 'auto'`. Without one it says the
+     * largest whole unit that has elapsed, from years down to seconds.
+     */
+    relative(opts: {
+        value: TTemporalInput;
+        base?: TTemporalInput;
+        unit?: TTemporalUnit;
+        numeric?: Intl.RelativeTimeFormatNumeric;
+        style?: Intl.RelativeTimeFormatStyle;
+        tz?: string;
+        locale?: string;
+    }): string;
+    /** A span of milliseconds as days, hours, minutes, seconds and milliseconds. A day is 24 hours. */
+    durationParts(opts: {
+        milliseconds: number;
+    }): ITemporalDurationParts;
+    /**
+     * A span of milliseconds written out: `compact` (the default) is `1d1h30m`; `narrow`, `short` and
+     * `long` use the locale's unit words. Zero units are left out and milliseconds dropped.
+     */
+    formatDuration(opts: {
+        milliseconds: number;
+        style?: TTemporalDurationStyle;
+        /** A clock face instead of words: `HH:mm:ss`, `mm:ss`, `D[d] HH:mm`. The largest token carries the rest. */
+        pattern?: string;
+        /** Only the largest units that are not zero: `1` writes `2 giờ` for 2 hours 5 minutes. */
+        maxUnits?: number;
+        locale?: string;
+    }): string;
+}
 //# sourceMappingURL=types.d.ts.map