@venizia/ignis-helpers 0.2.0-9 → 0.2.0

package/dist/cjs/modules/temporal/helper.js

@@ -0,0 +1,326 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemporalHelper = void 0;
+const http_1 = require("../../common/constants/http");
+const base_1 = require("../base");
+const error_1 = require("../error");
+const native_1 = require("./adapters/native");
+const calendar_1 = require("./calendar");
+const constants_1 = require("./common/constants");
+const pattern_1 = require("./pattern");
+/** `2026-09-19`, `2026-09-19T12:00`, `2026-09-19 12:00:00.021+07:00`, `...Z` - an offset only after a time. */
+const ISO_8601 = /^(\d{4})-(\d{2})-(\d{2})(?:[T ](\d{2}):(\d{2})(?::(\d{2})(?:\.(\d{1,9}))?)?(Z|[+-]\d{2}(?::?\d{2}(?::?\d{2})?)?)?)?$/i;
+/** The offset of an ISO 8601 value: `+07`, `+07:00`, `+0700`, `+07:06:40`. */
+const ISO_OFFSET = /^([+-])(\d{2})(?::?(\d{2})(?::?(\d{2}))?)?$/;
+const DAY_MILLISECONDS = 86_400_000;
+/** 0001-01-01T00:00:00.000Z and 9999-12-31T23:59:59.999Z. */
+const MIN_INSTANT = -62_135_596_800_000;
+const MAX_INSTANT = 253_402_300_799_999;
+const MAX_KNOWN_TIME_ZONES = 256;
+const OUT_OF_RANGE = `outside the years ${calendar_1.MIN_TEMPORAL_YEAR}-${calendar_1.MAX_TEMPORAL_YEAR}`;
+/**
+ * Dates in one time zone, through whichever library you choose: pass an adapter - the runtime's
+ * `Temporal` (the default), your own dayjs, your own Luxon. The adapter only reports a zone's UTC
+ * offset at an instant; the wall clock, daylight-saving gaps and repeats, and the calendar math all
+ * live here, so every adapter shares one behaviour.
+ *
+ * Values go in as a `Date`, epoch milliseconds or an ISO 8601 string, and come out as a `Date`, so
+ * swapping the adapter never touches a call site. The zone is yours to set: without one this helper
+ * computes in UTC, never in the host's zone. Years run from 1 to 9999.
+ */
+class TemporalHelper extends base_1.BaseHelper {
+    /** Validated once per process: `Intl` answers the same for a zone name every time. */
+    static { this.knownTimeZones = new Set(); }
+    constructor(opts) {
+        super({ scope: opts?.scope ?? TemporalHelper.name });
+        this.timeZone = TemporalHelper.ensureTimeZone({
+            timeZone: opts?.timeZone ?? constants_1.DEFAULT_TEMPORAL_TIME_ZONE,
+            statusCode: http_1.HTTP.ResultCodes.RS_5.InternalServerError,
+        });
+        this.adapter = opts?.adapter ?? new native_1.NativeTemporalAdapter();
+    }
+    static ensureTimeZone(opts) {
+        const { timeZone, statusCode } = opts;
+        if (TemporalHelper.knownTimeZones.has(timeZone)) {
+            return timeZone;
+        }
+        try {
+            new Intl.DateTimeFormat('en-US', { timeZone });
+        }
+        catch (error) {
+            throw (0, error_1.getError)({
+                statusCode,
+                message: `[TemporalHelper] unknown time zone '${timeZone}' | ${error instanceof Error ? error.message : String(error)}`,
+            });
+        }
+        if (TemporalHelper.knownTimeZones.size < MAX_KNOWN_TIME_ZONES) {
+            TemporalHelper.knownTimeZones.add(timeZone);
+        }
+        return timeZone;
+    }
+    static ensureUnit(opts) {
+        const { unit, amount } = opts;
+        if (!constants_1.TemporalUnits.isValid(unit)) {
+            throw (0, error_1.getError)({
+                statusCode: http_1.HTTP.ResultCodes.RS_4.BadRequest,
+                message: `[TemporalHelper] unknown unit '${unit}' | Supported: ${[...constants_1.TemporalUnits.SCHEME_SET].join(', ')}`,
+            });
+        }
+        if (amount !== undefined && !Number.isInteger(amount)) {
+            throw (0, error_1.getError)({
+                statusCode: http_1.HTTP.ResultCodes.RS_4.BadRequest,
+                message: `[TemporalHelper] amount must be an integer - received ${amount}`,
+            });
+        }
+    }
+    /** Every result passes here: an overflowing `add` is refused, never an Invalid Date. */
+    static ensureInstant(opts) {
+        const { epoch } = opts;
+        if (!(epoch >= MIN_INSTANT && epoch <= MAX_INSTANT)) {
+            throw (0, error_1.getError)({
+                statusCode: http_1.HTTP.ResultCodes.RS_4.BadRequest,
+                message: `[TemporalHelper] ${Number.isNaN(epoch) ? 'invalid date' : OUT_OF_RANGE} - received ${epoch}`,
+            });
+        }
+        return new Date(epoch);
+    }
+    static ensureYear(opts) {
+        if (!(0, calendar_1.isSupportedYear)(opts.parts.year)) {
+            throw (0, error_1.getError)({
+                statusCode: http_1.HTTP.ResultCodes.RS_4.BadRequest,
+                message: `[TemporalHelper] year ${opts.parts.year} is ${OUT_OF_RANGE}`,
+            });
+        }
+    }
+    resolveTimeZone(opts) {
+        return opts.timeZone === undefined
+            ? this.timeZone
+            : TemporalHelper.ensureTimeZone({
+                timeZone: opts.timeZone,
+                statusCode: http_1.HTTP.ResultCodes.RS_4.BadRequest,
+            });
+    }
+    /** The adapter's one answer, rounded: an offset is whole milliseconds, a library's float may not be. */
+    offsetAt(opts) {
+        return Math.round(this.adapter.getOffsetMilliseconds({ value: new Date(opts.epoch), timeZone: opts.timeZone }));
+    }
+    zonedParts(opts) {
+        const parts = (0, calendar_1.wallClockAt)({ epoch: opts.epoch, offsetMilliseconds: this.offsetAt(opts) });
+        TemporalHelper.ensureYear({ parts });
+        return parts;
+    }
+    /**
+     * Every instant whose wall clock reads `parts` in the zone, earliest first: one as a rule, two
+     * when the clock goes back, none when it jumps forward. `forward` is where a skipped time lands -
+     * read with the offset from before the jump, so it moves past the gap.
+     */
+    instantsOf(opts) {
+        const { parts, timeZone } = opts;
+        const local = (0, calendar_1.epochAtOffset)({ parts, offsetMilliseconds: 0 });
+        const before = this.offsetAt({ epoch: local - DAY_MILLISECONDS, timeZone });
+        const after = this.offsetAt({ epoch: local + DAY_MILLISECONDS, timeZone });
+        const offsets = before === after ? [before] : [before, after];
+        const instants = [];
+        for (const offset of offsets) {
+            const candidate = local - offset;
+            if (this.offsetAt({ epoch: candidate, timeZone }) === offset) {
+                instants.push(candidate);
+            }
+        }
+        instants.sort((left, right) => left - right);
+        return { instants, forward: local - before };
+    }
+    /** The instant wall-clock `parts` name: a skipped time moves forward, a repeated one takes the earlier. */
+    earliestOf(opts) {
+        const { instants, forward } = this.instantsOf(opts);
+        return instants[0] ?? forward;
+    }
+    /**
+     * `[start, end)` of the unit holding `epoch`. A day or longer starts at its first instant. An hour
+     * or less repeats when the clock goes back, so it starts at the latest start not after `epoch`,
+     * and ends where the wall clock next shows either the following unit or this one's start again.
+     */
+    unitBounds(opts) {
+        const { epoch, unit, timeZone } = opts;
+        const startParts = (0, calendar_1.truncateTo)({ parts: this.zonedParts({ epoch, timeZone }), unit });
+        const nextParts = (0, calendar_1.shiftWallClock)({ parts: startParts, amount: 1, unit });
+        TemporalHelper.ensureYear({ parts: nextParts });
+        const starts = this.instantsOf({ parts: startParts, timeZone });
+        if (calendar_1.EXACT_UNIT_MILLISECONDS[unit] === undefined) {
+            const start = starts.instants[0] ?? starts.forward;
+            return { start, end: this.earliestOf({ parts: nextParts, timeZone }) };
+        }
+        const started = starts.instants.filter(instant => instant <= epoch);
+        const start = started.at(-1) ?? starts.instants[0] ?? starts.forward;
+        const nexts = this.instantsOf({ parts: nextParts, timeZone });
+        const following = nexts.instants.find(instant => instant > start) ?? nexts.forward;
+        const repeated = starts.instants.find(instant => instant > start);
+        return { start, end: repeated === undefined ? following : Math.min(repeated, following) };
+    }
+    getTimeZone() {
+        return this.timeZone;
+    }
+    now() {
+        return new Date();
+    }
+    /** The instant a value names. An ISO string without an offset is read as wall clock in the zone. */
+    toDate(opts) {
+        const { value } = opts;
+        if (typeof value === 'string') {
+            return this.parse({ value, timeZone: opts.timeZone });
+        }
+        return TemporalHelper.ensureInstant({
+            epoch: value instanceof Date ? value.getTime() : value,
+        });
+    }
+    /** The wall clock the value shows in the zone, with its ISO weekday and UTC offset. */
+    parts(opts) {
+        const timeZone = this.resolveTimeZone({ timeZone: opts.timeZone });
+        const date = this.toDate({ value: opts.value, timeZone });
+        return this.zonedParts({ epoch: date.getTime(), timeZone });
+    }
+    /**
+     * 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) {
+        const { value, pattern } = opts;
+        const timeZone = this.resolveTimeZone({ timeZone: opts.timeZone });
+        const read = pattern ? pattern_1.TemporalPattern.parse({ pattern, value }) : this.readIso({ value });
+        if (!read) {
+            throw (0, error_1.getError)({
+                statusCode: http_1.HTTP.ResultCodes.RS_4.BadRequest,
+                message: pattern
+                    ? `[TemporalHelper] '${value}' does not match pattern '${pattern}'`
+                    : `[TemporalHelper] '${value}' is not ISO 8601 | Pass a pattern for any other shape`,
+            });
+        }
+        if (!(0, calendar_1.isRealDateTime)({ parts: read.parts })) {
+            throw (0, error_1.getError)({
+                statusCode: http_1.HTTP.ResultCodes.RS_4.BadRequest,
+                message: `[TemporalHelper] '${value}' is not a real date and time`,
+            });
+        }
+        const epoch = read.offsetMilliseconds === undefined
+            ? this.earliestOf({ parts: read.parts, timeZone })
+            : (0, calendar_1.epochAtOffset)({ parts: read.parts, offsetMilliseconds: read.offsetMilliseconds });
+        return TemporalHelper.ensureInstant({ epoch });
+    }
+    readIso(opts) {
+        const match = ISO_8601.exec(opts.value);
+        if (!match) {
+            return undefined;
+        }
+        const [, year, month, day, hour, minute, second, fraction, offset] = match;
+        const parts = {
+            year: Number(year),
+            month: Number(month),
+            day: Number(day),
+            hour: Number(hour ?? 0),
+            minute: Number(minute ?? 0),
+            second: Number(second ?? 0),
+            millisecond: Number((fraction ?? '0').padEnd(3, '0').slice(0, 3)),
+        };
+        if (!offset) {
+            return { parts };
+        }
+        if (offset.toUpperCase() === 'Z') {
+            return { parts, offsetMilliseconds: 0 };
+        }
+        const [, sign, offsetHours, offsetMinutes, offsetSeconds] = ISO_OFFSET.exec(offset) ?? [];
+        const hours = Number(offsetHours);
+        const minutes = Number(offsetMinutes ?? 0);
+        const seconds = Number(offsetSeconds ?? 0);
+        if (!(hours <= 23 && minutes <= 59 && seconds <= 59)) {
+            return undefined;
+        }
+        const milliseconds = ((hours * 60 + minutes) * 60 + seconds) * 1000;
+        return { parts, offsetMilliseconds: sign === '-' ? -milliseconds : milliseconds };
+    }
+    /** Writes the value in the zone. Without a `pattern`: ISO 8601 with the zone's offset. */
+    format(opts) {
+        return pattern_1.TemporalPattern.format({
+            pattern: opts.pattern ?? constants_1.DEFAULT_TEMPORAL_PATTERN,
+            parts: this.parts({ value: opts.value, timeZone: opts.timeZone }),
+        });
+    }
+    /**
+     * 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) {
+        const { amount, unit } = opts;
+        TemporalHelper.ensureUnit({ unit, amount });
+        const timeZone = this.resolveTimeZone({ timeZone: opts.timeZone });
+        const date = this.toDate({ value: opts.value, timeZone });
+        if (amount === 0) {
+            return date;
+        }
+        const exact = calendar_1.EXACT_UNIT_MILLISECONDS[unit];
+        if (exact !== undefined) {
+            return TemporalHelper.ensureInstant({ epoch: date.getTime() + amount * exact });
+        }
+        const parts = (0, calendar_1.wallClockOf)({ parts: this.zonedParts({ epoch: date.getTime(), timeZone }) });
+        const shifted = (0, calendar_1.shiftWallClock)({ parts, amount, unit });
+        TemporalHelper.ensureYear({ parts: shifted });
+        return TemporalHelper.ensureInstant({ epoch: this.earliestOf({ parts: shifted, timeZone }) });
+    }
+    subtract(opts) {
+        return this.add({ ...opts, amount: -opts.amount });
+    }
+    /** The first instant of the unit containing the value, in the zone. Weeks start on Monday. */
+    startOf(opts) {
+        const { unit } = opts;
+        TemporalHelper.ensureUnit({ unit });
+        const timeZone = this.resolveTimeZone({ timeZone: opts.timeZone });
+        const date = this.toDate({ value: opts.value, timeZone });
+        if (unit === constants_1.TemporalUnits.MILLISECOND) {
+            return date;
+        }
+        const { start } = this.unitBounds({ epoch: date.getTime(), unit, timeZone });
+        return TemporalHelper.ensureInstant({ epoch: start });
+    }
+    /** The last millisecond of the unit containing the value, in the zone. */
+    endOf(opts) {
+        const { unit } = opts;
+        TemporalHelper.ensureUnit({ unit });
+        const timeZone = this.resolveTimeZone({ timeZone: opts.timeZone });
+        const date = this.toDate({ value: opts.value, timeZone });
+        if (unit === constants_1.TemporalUnits.MILLISECOND) {
+            return date;
+        }
+        const { end } = this.unitBounds({ epoch: date.getTime(), unit, timeZone });
+        return TemporalHelper.ensureInstant({ epoch: end - 1 });
+    }
+    /** Monday to Friday, read on the wall clock of the zone. */
+    isWeekday(opts) {
+        return this.parts(opts).dayOfWeek <= 5;
+    }
+    nextWeekday(opts) {
+        return this.stepToWeekday({ ...opts, step: 1 });
+    }
+    previousWeekday(opts) {
+        return this.stepToWeekday({ ...opts, step: -1 });
+    }
+    stepToWeekday(opts) {
+        let candidate = this.add({
+            value: opts.value,
+            amount: opts.step,
+            unit: constants_1.TemporalUnits.DAY,
+            timeZone: opts.timeZone,
+        });
+        while (!this.isWeekday({ value: candidate, timeZone: opts.timeZone })) {
+            candidate = this.add({
+                value: candidate,
+                amount: opts.step,
+                unit: constants_1.TemporalUnits.DAY,
+                timeZone: opts.timeZone,
+            });
+        }
+        return candidate;
+    }
+}
+exports.TemporalHelper = TemporalHelper;
+//# sourceMappingURL=helper.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../src/modules/temporal/helper.ts"],"names":[],"mappings":";;;AAAA,kDAA+C;AAC/C,yCAA4C;AAC5C,2CAA2C;AAC3C,8CAA0D;AAC1D,yCAWoB;AACpB,kDAI4B;AAQ5B,uCAA4C;AAE5C,+GAA+G;AAC/G,MAAM,QAAQ,GACZ,uHAAuH,CAAC;AAE1H,8EAA8E;AAC9E,MAAM,UAAU,GAAG,6CAA6C,CAAC;AAEjE,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAEpC,6DAA6D;AAC7D,MAAM,WAAW,GAAG,CAAC,kBAAkB,CAAC;AACxC,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAExC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAEjC,MAAM,YAAY,GAAG,qBAAqB,4BAAiB,IAAI,4BAAiB,EAAE,CAAC;AAEnF;;;;;;;;;GASG;AACH,MAAa,cAAe,SAAQ,iBAAU;IAC5C,sFAAsF;aAC9D,mBAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IAK3D,YAAY,IAAwE;QAClF,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;QAErD,IAAI,CAAC,QAAQ,GAAG,cAAc,CAAC,cAAc,CAAC;YAC5C,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,sCAA0B;YACtD,UAAU,EAAE,WAAI,CAAC,WAAW,CAAC,IAAI,CAAC,mBAAmB;SACtD,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,IAAI,8BAAqB,EAAE,CAAC;IAC9D,CAAC;IAEO,MAAM,CAAC,cAAc,CAAC,IAA8C;QAC1E,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QACtC,IAAI,cAAc,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChD,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAA,gBAAQ,EAAC;gBACb,UAAU;gBACV,OAAO,EAAE,uCAAuC,QAAQ,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;aACxH,CAAC,CAAC;QACL,CAAC;QAED,IAAI,cAAc,CAAC,cAAc,CAAC,IAAI,GAAG,oBAAoB,EAAE,CAAC;YAC9D,cAAc,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,MAAM,CAAC,UAAU,CAAC,IAAuC;QAC/D,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAC9B,IAAI,CAAC,yBAAa,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,MAAM,IAAA,gBAAQ,EAAC;gBACb,UAAU,EAAE,WAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU;gBAC5C,OAAO,EAAE,kCAAkC,IAAI,kBAAkB,CAAC,GAAG,yBAAa,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aAC5G,CAAC,CAAC;QACL,CAAC;QACD,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACtD,MAAM,IAAA,gBAAQ,EAAC;gBACb,UAAU,EAAE,WAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU;gBAC5C,OAAO,EAAE,yDAAyD,MAAM,EAAE;aAC3E,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,wFAAwF;IAChF,MAAM,CAAC,aAAa,CAAC,IAAuB;QAClD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,CAAC,KAAK,IAAI,WAAW,IAAI,KAAK,IAAI,WAAW,CAAC,EAAE,CAAC;YACpD,MAAM,IAAA,gBAAQ,EAAC;gBACb,UAAU,EAAE,WAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU;gBAC5C,OAAO,EAAE,oBAAoB,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,YAAY,eAAe,KAAK,EAAE;aACvG,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAEO,MAAM,CAAC,UAAU,CAAC,IAA+B;QACvD,IAAI,CAAC,IAAA,0BAAe,EAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,IAAA,gBAAQ,EAAC;gBACb,UAAU,EAAE,WAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU;gBAC5C,OAAO,EAAE,yBAAyB,IAAI,CAAC,KAAK,CAAC,IAAI,OAAO,YAAY,EAAE;aACvE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,eAAe,CAAC,IAA2B;QACjD,OAAO,IAAI,CAAC,QAAQ,KAAK,SAAS;YAChC,CAAC,CAAC,IAAI,CAAC,QAAQ;YACf,CAAC,CAAC,cAAc,CAAC,cAAc,CAAC;gBAC5B,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,UAAU,EAAE,WAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU;aAC7C,CAAC,CAAC;IACT,CAAC;IAED,wGAAwG;IAChG,QAAQ,CAAC,IAAyC;QACxD,OAAO,IAAI,CAAC,KAAK,CACf,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAC7F,CAAC;IACJ,CAAC;IAEO,UAAU,CAAC,IAAyC;QAC1D,MAAM,KAAK,GAAG,IAAA,sBAAW,EAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,kBAAkB,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1F,cAAc,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;OAIG;IACK,UAAU,CAAC,IAAiD;QAIlE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QACjC,MAAM,KAAK,GAAG,IAAA,wBAAa,EAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,gBAAgB,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5E,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,gBAAgB,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE3E,MAAM,OAAO,GAAG,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAkB,EAAE,CAAC;QACnC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;YACjC,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,KAAK,MAAM,EAAE,CAAC;gBAC7D,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;QAE7C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,GAAG,MAAM,EAAE,CAAC;IAC/C,CAAC;IAED,2GAA2G;IACnG,UAAU,CAAC,IAAiD;QAClE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACpD,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACK,UAAU,CAAC,IAA8D;QAI/E,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QACvC,MAAM,UAAU,GAAG,IAAA,qBAAU,EAAC,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACrF,MAAM,SAAS,GAAG,IAAA,yBAAc,EAAC,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACzE,cAAc,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;QAChE,IAAI,kCAAuB,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YAChD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC;YACnD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACzE,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC;QACpE,MAAM,KAAK,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC;QAErE,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC9D,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,GAAG,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC;QACnF,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC;QAClE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC;IAC5F,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,GAAG;QACD,OAAO,IAAI,IAAI,EAAE,CAAC;IACpB,CAAC;IAED,oGAAoG;IACpG,MAAM,CAAC,IAAkD;QACvD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAEvB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,OAAO,cAAc,CAAC,aAAa,CAAC;YAClC,KAAK,EAAE,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK;SACvD,CAAC,CAAC;IACL,CAAC;IAED,uFAAuF;IACvF,KAAK,CAAC,IAAkD;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAA4D;QAChE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEnE,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,yBAAe,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3F,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAA,gBAAQ,EAAC;gBACb,UAAU,EAAE,WAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU;gBAC5C,OAAO,EAAE,OAAO;oBACd,CAAC,CAAC,qBAAqB,KAAK,6BAA6B,OAAO,GAAG;oBACnE,CAAC,CAAC,qBAAqB,KAAK,wDAAwD;aACvF,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,IAAA,yBAAc,EAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAA,gBAAQ,EAAC;gBACb,UAAU,EAAE,WAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU;gBAC5C,OAAO,EAAE,qBAAqB,KAAK,+BAA+B;aACnE,CAAC,CAAC;QACL,CAAC;QAED,MAAM,KAAK,GACT,IAAI,CAAC,kBAAkB,KAAK,SAAS;YACnC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;YAClD,CAAC,CAAC,IAAA,wBAAa,EAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC;QACxF,OAAO,cAAc,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACjD,CAAC;IAEO,OAAO,CAAC,IAEf;QACC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;QAC3E,MAAM,KAAK,GAAmB;YAC5B,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;YAClB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;YACpB,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC;YAChB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;YAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;YAC3B,WAAW,EAAE,MAAM,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;SAClE,CAAC;QAEF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,KAAK,EAAE,CAAC;QACnB,CAAC;QACD,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,GAAG,EAAE,CAAC;YACjC,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,EAAE,CAAC;QAC1C,CAAC;QAED,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1F,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QAClC,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC;QAC3C,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,IAAI,OAAO,IAAI,EAAE,IAAI,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;YACrD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC;QACpE,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC;IACpF,CAAC;IAED,0FAA0F;IAC1F,MAAM,CAAC,IAAoE;QACzE,OAAO,yBAAe,CAAC,MAAM,CAAC;YAC5B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,oCAAwB;YACjD,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;SAClE,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,IAKH;QACC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAC9B,cAAc,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAE5C,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC1D,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAG,kCAAuB,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,cAAc,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,MAAM,GAAG,KAAK,EAAE,CAAC,CAAC;QAClF,CAAC;QAED,MAAM,KAAK,GAAG,IAAA,sBAAW,EAAC,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3F,MAAM,OAAO,GAAG,IAAA,yBAAc,EAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,cAAc,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAE9C,OAAO,cAAc,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;IAChG,CAAC;IAED,QAAQ,CAAC,IAKR;QACC,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,8FAA8F;IAC9F,OAAO,CAAC,IAAuE;QAC7E,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACtB,cAAc,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC1D,IAAI,IAAI,KAAK,yBAAa,CAAC,WAAW,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC7E,OAAO,cAAc,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,0EAA0E;IAC1E,KAAK,CAAC,IAAuE;QAC3E,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACtB,cAAc,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC1D,IAAI,IAAI,KAAK,yBAAa,CAAC,WAAW,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC3E,OAAO,cAAc,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,4DAA4D;IAC5D,SAAS,CAAC,IAAkD;QAC1D,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,WAAW,CAAC,IAAkD;QAC5D,OAAO,IAAI,CAAC,aAAa,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,eAAe,CAAC,IAAkD;QAChE,OAAO,IAAI,CAAC,aAAa,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACnD,CAAC;IAEO,aAAa,CAAC,IAAgE;QACpF,IAAI,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,IAAI;YACjB,IAAI,EAAE,yBAAa,CAAC,GAAG;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QAEH,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC;YACtE,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC;gBACnB,KAAK,EAAE,SAAS;gBAChB,MAAM,EAAE,IAAI,CAAC,IAAI;gBACjB,IAAI,EAAE,yBAAa,CAAC,GAAG;gBACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;;AA/WH,wCAgXC"}

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

@@ -0,0 +1,4 @@
+export * from './adapters';
+export * from './common';
+export * from './helper';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/cjs/modules/temporal/index.js

@@ -0,0 +1,20 @@
+"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("./adapters"), exports);
+__exportStar(require("./common"), exports);
+__exportStar(require("./helper"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/temporal/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,2CAAyB;AACzB,2CAAyB"}

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

@@ -0,0 +1,24 @@
+import type { ITemporalParts, IZonedTemporalParts } from './common/types';
+/** The pattern dialect: compiled once per pattern, then formatted and parsed from the cache. */
+export declare class TemporalPattern {
+    /** A service formats the same few patterns millions of times; capped so caller-fed patterns cannot grow it. */
+    private static readonly compiled;
+    /**
+     * Splits a pattern into tokens and literals. A run of one letter is one token, and an unknown run
+     * is refused: `yyyy` is not `YYYY`, and `MMM` is never read as `MM` then `M`.
+     */
+    private static compile;
+    static format(opts: {
+        pattern: string;
+        parts: IZonedTemporalParts;
+    }): string;
+    /** The fields a value spells under a pattern, or undefined when it does not match. Unset fields default to the start: month 1, day 1, 00:00. */
+    static parse(opts: {
+        pattern: string;
+        value: string;
+    }): {
+        parts: ITemporalParts;
+        offsetMilliseconds?: number;
+    } | undefined;
+}
+//# sourceMappingURL=pattern.d.ts.map

package/dist/cjs/modules/temporal/pattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern.d.ts","sourceRoot":"","sources":["../../../../src/modules/temporal/pattern.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAc1E,gGAAgG;AAChG,qBAAa,eAAe;IAC1B,+GAA+G;IAC/G,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAA6C;IAE7E;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,OAAO;IAiEtB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,mBAAmB,CAAA;KAAE,GAAG,MAAM;IAU5E,gJAAgJ;IAChJ,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;KACf,GAAG;QAAE,KAAK,EAAE,cAAc,CAAC;QAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;CAwDvE"}

package/dist/cjs/modules/temporal/pattern.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemporalPattern = void 0;
+const http_1 = require("../../common/constants/http");
+const error_1 = require("../error");
+const tokens_1 = require("./tokens");
+/** The pattern dialect: compiled once per pattern, then formatted and parsed from the cache. */
+class TemporalPattern {
+    /** A service formats the same few patterns millions of times; capped so caller-fed patterns cannot grow it. */
+    static { this.compiled = new Map(); }
+    /**
+     * Splits a pattern into tokens and literals. A run of one letter is one token, and an unknown run
+     * is refused: `yyyy` is not `YYYY`, and `MMM` is never read as `MM` then `M`.
+     */
+    static compile(opts) {
+        const { pattern } = opts;
+        const cached = TemporalPattern.compiled.get(pattern);
+        if (cached) {
+            return cached;
+        }
+        const segments = [];
+        let literal = '';
+        let position = 0;
+        while (position < pattern.length) {
+            const character = pattern[position];
+            if (character === '[') {
+                const close = pattern.indexOf(']', position + 1);
+                if (close < 0) {
+                    throw (0, error_1.getError)({
+                        statusCode: http_1.HTTP.ResultCodes.RS_5.InternalServerError,
+                        message: `[TemporalPattern] unclosed [ in pattern '${pattern}'`,
+                    });
+                }
+                literal += pattern.slice(position + 1, close);
+                position = close + 1;
+                continue;
+            }
+            // `T` is the ISO date-time separator, and the one letter a pattern may carry bare.
+            if (!(0, tokens_1.isLetter)(pattern.charCodeAt(position)) || character === 'T') {
+                literal += character;
+                position += 1;
+                continue;
+            }
+            let runEnd = position + 1;
+            while (pattern[runEnd] === character) {
+                runEnd += 1;
+            }
+            const run = pattern.slice(position, runEnd);
+            if (!(0, tokens_1.isToken)(run)) {
+                throw (0, error_1.getError)({
+                    statusCode: http_1.HTTP.ResultCodes.RS_5.InternalServerError,
+                    message: `[TemporalPattern] unknown token '${run}' in pattern '${pattern}' | Supported: ${tokens_1.SUPPORTED}; wrap text in [brackets]`,
+                });
+            }
+            if (literal) {
+                segments.push({ literal });
+                literal = '';
+            }
+            segments.push({ token: run });
+            position = runEnd;
+        }
+        if (literal) {
+            segments.push({ literal });
+        }
+        if (TemporalPattern.compiled.size < tokens_1.MAX_COMPILED_PATTERNS) {
+            TemporalPattern.compiled.set(pattern, segments);
+        }
+        return segments;
+    }
+    static format(opts) {
+        const segments = TemporalPattern.compile({ pattern: opts.pattern });
+        let text = '';
+        for (const segment of segments) {
+            text +=
+                'literal' in segment ? segment.literal : (tokens_1.WRITERS.get(segment.token)?.(opts.parts) ?? '');
+        }
+        return text;
+    }
+    /** The fields a value spells under a pattern, or undefined when it does not match. Unset fields default to the start: month 1, day 1, 00:00. */
+    static parse(opts) {
+        const { value } = opts;
+        const segments = TemporalPattern.compile({ pattern: opts.pattern });
+        const parts = {
+            year: 1970,
+            month: 1,
+            day: 1,
+            hour: 0,
+            minute: 0,
+            second: 0,
+            millisecond: 0,
+        };
+        let offsetMilliseconds;
+        let position = 0;
+        for (const segment of segments) {
+            if ('literal' in segment) {
+                if (!value.startsWith(segment.literal, position)) {
+                    return undefined;
+                }
+                position += segment.literal.length;
+                continue;
+            }
+            const { token } = segment;
+            if (token === 'Z' || token === 'ZZ') {
+                const offset = (0, tokens_1.readOffset)({ value, position, separator: token === 'Z' });
+                if (!offset) {
+                    return undefined;
+                }
+                offsetMilliseconds = offset.milliseconds;
+                position = offset.next;
+                continue;
+            }
+            if (token === 'YY') {
+                const read = (0, tokens_1.readDigits)({ value, position, min: 2, max: 2 });
+                if (!read) {
+                    return undefined;
+                }
+                parts.year = read.number + (read.number > tokens_1.TWO_DIGIT_YEAR_PIVOT ? 1900 : 2000);
+                position = read.next;
+                continue;
+            }
+            const [min, max, field] = tokens_1.NUMERIC_TOKENS[token];
+            const read = (0, tokens_1.readDigits)({ value, position, min, max });
+            if (!read) {
+                return undefined;
+            }
+            parts[field] = read.number;
+            position = read.next;
+        }
+        return position === value.length ? { parts, offsetMilliseconds } : undefined;
+    }
+}
+exports.TemporalPattern = TemporalPattern;
+//# sourceMappingURL=pattern.js.map

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

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

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

@@ -0,0 +1,65 @@
+import type { ITemporalParts, IZonedTemporalParts } from './common/types';
+/**
+ * The pattern dialect, one for every adapter: `YYYY YY MM M DD D HH H mm m ss s SSS Z ZZ`, with
+ * text in `[brackets]`. Numeric only - month and weekday names are a locale's business, not a parser's.
+ */
+export type TPatternToken = 'YYYY' | 'YY' | 'MM' | 'M' | 'DD' | 'D' | 'HH' | 'H' | 'mm' | 'm' | 'ss' | 's' | 'SSS' | 'Z' | 'ZZ';
+export type TPatternSegment = {
+    token: TPatternToken;
+} | {
+    literal: string;
+};
+export type TNumericToken = Exclude<TPatternToken, 'Z' | 'ZZ' | 'YY'>;
+export declare const SUPPORTED = "YYYY YY MM M DD D HH H mm m ss s SSS Z ZZ";
+export declare const MAX_COMPILED_PATTERNS = 64;
+/** Two-digit years pivot as dayjs and moment do: 00-68 is 2000-2068, 69-99 is 1969-1999. */
+export declare const TWO_DIGIT_YEAR_PIVOT = 68;
+/** `[min digits, max digits, field]` for every numeric token a parse reads directly. */
+export declare const NUMERIC_TOKENS: Record<TNumericToken, [number, number, keyof ITemporalParts]>;
+export declare const pad: (opts: {
+    value: number;
+    width: number;
+}) => string;
+/** `+07:00`, or `+07:06:40` for an offset with seconds - historic local mean time has them. */
+export declare const formatOffset: (opts: {
+    offsetMinutes: number;
+    separator: string;
+}) => string;
+/** One writer per token - a lookup rather than a branch per token on every format. */
+export declare const WRITERS: Map<TPatternToken, (parts: IZonedTemporalParts) => string>;
+export declare const isLetter: (code: number) => boolean;
+export declare const isDigit: (code: number) => boolean;
+/** Reads `min`..`max` digits at `position`, greedily; undefined when fewer than `min` are there. */
+export declare const readDigits: (opts: {
+    value: string;
+    position: number;
+    min: number;
+    max: number;
+}) => {
+    number: number;
+    next: number;
+} | undefined;
+/** Reads two digits after an optional separator; undefined when either is missing. */
+export declare const readOffsetField: (opts: {
+    value: string;
+    position: number;
+    separator: boolean;
+}) => {
+    number: number;
+    next: number;
+} | undefined;
+/**
+ * `Z`, `+07:00` (`Z` token) or `+0700` (`ZZ` token), seconds optional, as milliseconds east
+ * of UTC. Hours past 23 and minutes or seconds past 59 are refused rather than rolled over.
+ */
+export declare const readOffset: (opts: {
+    value: string;
+    position: number;
+    separator: boolean;
+}) => {
+    milliseconds: number;
+    next: number;
+} | undefined;
+export declare const TOKEN_NAMES: ReadonlySet<string>;
+export declare const isToken: (run: string) => run is TPatternToken;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/cjs/modules/temporal/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../../src/modules/temporal/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1E;;;GAGG;AACH,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,IAAI,GACJ,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,KAAK,GACL,GAAG,GACH,IAAI,CAAC;AAET,MAAM,MAAM,eAAe,GAAG;IAAE,KAAK,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7E,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;AAEtE,eAAO,MAAM,SAAS,8CAA8C,CAAC;AAErE,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,4FAA4F;AAC5F,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,wFAAwF;AACxF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC,CAaxF,CAAC;AAEF,eAAO,MAAM,GAAG,GAAI,MAAM;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,KAAG,MACf,CAAC;AAE/C,+FAA+F;AAC/F,eAAO,MAAM,YAAY,GAAI,MAAM;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,KAAG,MAYjF,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,OAAO,6BAAkC,mBAAmB,KAAK,MAAM,CAgBlF,CAAC;AAEH,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,KAAG,OACmB,CAAC;AAE5D,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,KAAG,OAAmC,CAAC;AAE3E,oGAAoG;AACpG,eAAO,MAAM,UAAU,GAAI,MAAM;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb,KAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAStC,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,eAAe,GAAI,MAAM;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB,KAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAMtC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB,KAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SA0B5C,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,MAAM,CAA2B,CAAC;AAExE,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,KAAG,GAAG,IAAI,aAAqC,CAAC"}