@venizia/ignis-helpers 0.2.2-0 → 0.2.2-10

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

@@ -0,0 +1,56 @@
+import type { TTemporalUnit } from '../common/constants';
+import type { ITemporalParts, IZonedTemporalParts } from '../common/types';
+/**
+ * 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/cjs/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/cjs/modules/temporal/calendar/calendar.js

@@ -0,0 +1,166 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemporalCalendar = void 0;
+const constants_1 = require("../common/constants");
+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.
+ */
+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 = {
+        [constants_1.TemporalUnits.MILLISECOND]: 1,
+        [constants_1.TemporalUnits.SECOND]: 1_000,
+        [constants_1.TemporalUnits.MINUTE]: 60_000,
+        [constants_1.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 constants_1.TemporalUnits.SECOND: {
+                return { ...wall, millisecond: 0 };
+            }
+            case constants_1.TemporalUnits.MINUTE: {
+                return { ...wall, second: 0, millisecond: 0 };
+            }
+            case constants_1.TemporalUnits.HOUR: {
+                return { ...wall, minute: 0, second: 0, millisecond: 0 };
+            }
+            case constants_1.TemporalUnits.DAY: {
+                return midnight;
+            }
+            case constants_1.TemporalUnits.WEEK: {
+                return TemporalCalendar.shift({
+                    parts: midnight,
+                    amount: 1 - parts.dayOfWeek,
+                    unit: constants_1.TemporalUnits.DAY,
+                });
+            }
+            case constants_1.TemporalUnits.MONTH: {
+                return { ...midnight, day: 1 };
+            }
+            case constants_1.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 === constants_1.TemporalUnits.DAY || unit === constants_1.TemporalUnits.WEEK) {
+            const days = unit === constants_1.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 === constants_1.TemporalUnits.QUARTER ? 3 : unit === constants_1.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 })),
+        };
+    }
+}
+exports.TemporalCalendar = TemporalCalendar;
+//# sourceMappingURL=calendar.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.js","sourceRoot":"","sources":["../../../../../src/modules/temporal/calendar/calendar.ts"],"names":[],"mappings":";;;AAAA,mDAAoD;AAIpD,MAAM,uBAAuB,GAAG,MAAM,CAAC;AACvC,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,MAAM,aAAa,GAAG,CAAC,CAAC;AAExB;;;GAGG;AACH,MAAa,gBAAgB;IAC3B,sFAAsF;aACtE,aAAQ,GAAG,CAAC,CAAC;aACb,aAAQ,GAAG,IAAI,CAAC;IAEhC,+FAA+F;aAC/E,4BAAuB,GAA2C;QAChF,CAAC,yBAAa,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9B,CAAC,yBAAa,CAAC,MAAM,CAAC,EAAE,KAAK;QAC7B,CAAC,yBAAa,CAAC,MAAM,CAAC,EAAE,MAAM;QAC9B,CAAC,yBAAa,CAAC,IAAI,CAAC,EAAE,SAAS;KAChC,CAAC;IAEF,iGAAiG;IACzF,MAAM,CAAC,OAAO,CAAC,IAAkD;QACvE,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,eAAe,CAAC,IAAsB;QAC3C,OAAO,IAAI,CAAC,IAAI,IAAI,gBAAgB,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,IAAI,gBAAgB,CAAC,QAAQ,CAAC;IAC1F,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAAqC;QACtD,OAAO,gBAAgB,CAAC,OAAO,CAAC;YAC9B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC;YACrB,GAAG,EAAE,CAAC;SACP,CAAC,CAAC,UAAU,EAAE,CAAC;IAClB,CAAC;IAED,mGAAmG;IACnG,MAAM,CAAC,cAAc,CAAC,IAA+B;QACnD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QAE3E,OAAO,CACL,gBAAgB,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,CAAC;YAC1C,KAAK,IAAI,CAAC;YACV,KAAK,IAAI,EAAE;YACX,GAAG,IAAI,CAAC;YACR,GAAG,IAAI,gBAAgB,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YACpD,IAAI,IAAI,CAAC;YACT,IAAI,IAAI,EAAE;YACV,MAAM,IAAI,CAAC;YACX,MAAM,IAAI,EAAE;YACZ,MAAM,IAAI,CAAC;YACX,MAAM,IAAI,EAAE;YACZ,WAAW,IAAI,CAAC;YAChB,WAAW,IAAI,GAAG,CACnB,CAAC;IACJ,CAAC;IAED,sEAAsE;IACtE,MAAM,CAAC,aAAa,CAAC,IAA2D;QAC9E,MAAM,EAAE,KAAK,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;QAC3C,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC;YACpC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,GAAG,EAAE,KAAK,CAAC,GAAG;SACf,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;QAC5E,OAAO,IAAI,CAAC,OAAO,EAAE,GAAG,kBAAkB,CAAC;IAC7C,CAAC;IAED,kGAAkG;IAClG,MAAM,CAAC,WAAW,CAAC,IAAmD;QACpE,MAAM,EAAE,KAAK,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;QAC3C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,GAAG,kBAAkB,CAAC,CAAC;QAElD,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE;YAC3B,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC;YAC7B,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE;YACtB,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE;YACxB,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE;YAC5B,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE;YAC5B,WAAW,EAAE,IAAI,CAAC,kBAAkB,EAAE;YACtC,0EAA0E;YAC1E,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC;YAC3C,aAAa,EAAE,kBAAkB,GAAG,uBAAuB;SAC5D,CAAC;IACJ,CAAC;IAED,uEAAuE;IACvE,MAAM,CAAC,WAAW,CAAC,IAA+B;QAChD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QAC3E,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACjE,CAAC;IAED,+GAA+G;IAC/G,MAAM,CAAC,QAAQ,CAAC,IAAyD;QACvE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAC7B,MAAM,IAAI,GAAG,gBAAgB,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;QAE5E,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,yBAAa,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC1B,OAAO,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;YACrC,CAAC;YACD,KAAK,yBAAa,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC1B,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;YAChD,CAAC;YACD,KAAK,yBAAa,CAAC,IAAI,CAAC,CAAC,CAAC;gBACxB,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;YAC3D,CAAC;YACD,KAAK,yBAAa,CAAC,GAAG,CAAC,CAAC,CAAC;gBACvB,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,KAAK,yBAAa,CAAC,IAAI,CAAC,CAAC,CAAC;gBACxB,OAAO,gBAAgB,CAAC,KAAK,CAAC;oBAC5B,KAAK,EAAE,QAAQ;oBACf,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,SAAS;oBAC3B,IAAI,EAAE,yBAAa,CAAC,GAAG;iBACxB,CAAC,CAAC;YACL,CAAC;YACD,KAAK,yBAAa,CAAC,KAAK,CAAC,CAAC,CAAC;gBACzB,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;YACjC,CAAC;YACD,KAAK,yBAAa,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC3B,OAAO,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;YAClF,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,OAAO,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,IAIZ;QACC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAErC,MAAM,KAAK,GAAG,gBAAgB,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC;QAC7D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,KAAK,GACT,gBAAgB,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,EAAE,CAAC,GAAG,MAAM,GAAG,KAAK,CAAC;YACpF,OAAO,gBAAgB,CAAC,WAAW,CAAC;gBAClC,KAAK,EAAE,gBAAgB,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,EAAE,CAAC;aACtE,CAAC,CAAC;QACL,CAAC;QAED,IAAI,IAAI,KAAK,yBAAa,CAAC,GAAG,IAAI,IAAI,KAAK,yBAAa,CAAC,IAAI,EAAE,CAAC;YAC9D,MAAM,IAAI,GAAG,IAAI,KAAK,yBAAa,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC;YAC3E,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC;gBACpC,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,GAAG,EAAE,KAAK,CAAC,GAAG,GAAG,IAAI;aACtB,CAAC,CAAC;YACH,OAAO;gBACL,GAAG,KAAK;gBACR,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE;gBAC3B,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC;gBAC7B,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE;aACvB,CAAC;QACJ,CAAC;QAED,MAAM,aAAa,GACjB,IAAI,KAAK,yBAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,yBAAa,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QACzF,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,GAAG,eAAe,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,MAAM,GAAG,aAAa,CAAC;QACxF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,eAAe,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,eAAe,GAAG,CAAC,CAAC;QAEjD,OAAO;YACL,GAAG,KAAK;YACR,IAAI;YACJ,KAAK;YACL,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,gBAAgB,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;SACxE,CAAC;IACJ,CAAC;;AAhLH,4CAiLC"}

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

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

package/dist/cjs/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/cjs/modules/temporal/calendar/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./calendar"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/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,6CAA2B"}

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

@@ -1,5 +1,5 @@
 import type { TConstValue } from '../../../common/types';
-/** 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/cjs/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/cjs/modules/temporal/common/constants.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TemporalDurationStyles = exports.DEFAULT_TEMPORAL_LOCALE = exports.DEFAULT_TEMPORAL_PATTERN = exports.DEFAULT_TEMPORAL_TIME_ZONE = exports.TemporalUnits = void 0;
-/** Units `add`, `subtract`, `startOf` and `endOf` accept. Weeks are ISO weeks - they start on Monday. */
+exports.TemporalInclusivities = exports.TemporalDurationStyles = exports.DEFAULT_TEMPORAL_LOCALE = exports.DEFAULT_TEMPORAL_PATTERN = exports.DEFAULT_TEMPORAL_TZ = exports.TemporalUnits = void 0;
+/** 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. */
 class TemporalUnits {
     static { this.MILLISECOND = 'millisecond'; }
     static { this.SECOND = 'second'; }
@@ -10,6 +10,7 @@ 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,
@@ -19,6 +20,7 @@ class TemporalUnits {
         this.DAY,
         this.WEEK,
         this.MONTH,
+        this.QUARTER,
         this.YEAR,
     ]); }
     static isValid(input) {
@@ -26,8 +28,8 @@ class TemporalUnits {
     }
 }
 exports.TemporalUnits = TemporalUnits;
-/** A helper built without a `timeZone` computes in UTC - never in the host's zone, which differs per machine. */
-exports.DEFAULT_TEMPORAL_TIME_ZONE = 'UTC';
+/** A helper built without a `tz` computes in UTC - never in the host's zone, which differs per machine. */
+exports.DEFAULT_TEMPORAL_TZ = 'UTC';
 /** `format` with no pattern writes ISO 8601 with the zone's offset: `2026-09-19T12:00:00.000+07:00`. */
 exports.DEFAULT_TEMPORAL_PATTERN = 'YYYY-MM-DDTHH:mm:ss.SSSZ';
 /** The locale name tokens and `formatIntl` write in when a helper is built without one. */
@@ -44,4 +46,21 @@ class TemporalDurationStyles {
     }
 }
 exports.TemporalDurationStyles = TemporalDurationStyles;
+/** Which ends of the range `isBetween` counts: `[` includes an end, `(` leaves it out. */
+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);
+    }
+}
+exports.TemporalInclusivities = TemporalInclusivities;
 //# sourceMappingURL=constants.js.map

package/dist/cjs/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,MAAa,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;;AAvBH,sCAwBC;AAID,iHAAiH;AACpG,QAAA,0BAA0B,GAAG,KAAK,CAAC;AAEhD,wGAAwG;AAC3F,QAAA,wBAAwB,GAAG,0BAA0B,CAAC;AAEnE,2FAA2F;AAC9E,QAAA,uBAAuB,GAAG,OAAO,CAAC;AAE/C,uGAAuG;AACvG,MAAa,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;;AAVH,wDAWC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/modules/temporal/common/constants.ts"],"names":[],"mappings":";;;AAEA,kLAAkL;AAClL,MAAa,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;;AAzBH,sCA0BC;AAID,2GAA2G;AAC9F,QAAA,mBAAmB,GAAG,KAAK,CAAC;AAEzC,wGAAwG;AAC3F,QAAA,wBAAwB,GAAG,0BAA0B,CAAC;AAEnE,2FAA2F;AAC9E,QAAA,uBAAuB,GAAG,OAAO,CAAC;AAE/C,uGAAuG;AACvG,MAAa,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;;AAVH,wDAWC;AAID,0FAA0F;AAC1F,MAAa,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;;AAfH,sDAgBC"}