@ultimat3/time 1.0.0 → 1.2.0

package/src/errors.js

@@ -1,78 +0,0 @@
-/**
- * The X_* error codes owned by @ultimat3/time.
- * DST ambiguity is a real state of the world, so it gets a code instead of a guess.
- */
-import { UltimateError } from '@ultimat3/core';
-export const TIME_ERROR_CODES = [
-    'X_TIMEZONE_INVALID',
-    'X_CRON_INVALID',
-    'X_DURATION_INVALID',
-    'X_DST_AMBIGUOUS',
-    'X_DST_NONEXISTENT',
-    'X_INSTANT_INVALID',
-    'X_SCHEDULE_INVALID',
-];
-export class TimeError extends UltimateError {
-    constructor(init) {
-        super({
-            code: init.code,
-            cause: init.cause,
-            fix: init.fix,
-            docs: `https://ultimate.dev/errors/${init.code}`,
-        });
-    }
-}
-/**
- * A wall-clock field outside its range. Separate from `X_DST_*`, which are about times that
- * are legitimately absent or doubled — this one is a spec the caller got wrong.
- */
-export function scheduleInvalid(field, value, range) {
-    return new TimeError({
-        code: 'X_SCHEDULE_INVALID',
-        cause: `${field} must be ${range}, got ${String(value)}`,
-        fix: `pass an integer in ${range} for ${field} — wall-clock fields are not wrapped or clamped, because a silently shifted schedule is worse than a failed one`,
-    });
-}
-export function timezoneInvalid(zone) {
-    return new TimeError({
-        code: 'X_TIMEZONE_INVALID',
-        cause: `"${zone}" is not an IANA timezone name`,
-        fix: 'use an IANA identifier such as Europe/Berlin, America/New_York or UTC — never an abbreviation like CET or a numeric offset',
-    });
-}
-export function cronInvalid(expression, reason) {
-    return new TimeError({
-        code: 'X_CRON_INVALID',
-        cause: `cron "${expression}": ${reason}`,
-        fix: "use 5 fields (m h dom mon dow) or 6 with seconds, e.g. '0 3 * * *' for 03:00 daily, '*/15 * * * *' every 15 minutes, '0 9 * * MON-FRI' weekday mornings",
-    });
-}
-export function durationInvalid(input) {
-    return new TimeError({
-        code: 'X_DURATION_INVALID',
-        cause: `"${input}" is not a duration`,
-        fix: "use a unit-suffixed duration: '90s', '2h30m', '3d', '1w', '250ms' — or an ISO-8601 form like 'PT2H30M'",
-    });
-}
-export function dstAmbiguous(wall, zone) {
-    return new TimeError({
-        code: 'X_DST_AMBIGUOUS',
-        cause: `${wall} happens twice in ${zone} (the fall-back hour repeats)`,
-        fix: "pass { overlap: 'first' } for the pre-transition instant or { overlap: 'second' } for the post-transition one",
-    });
-}
-export function dstNonexistent(wall, zone) {
-    return new TimeError({
-        code: 'X_DST_NONEXISTENT',
-        cause: `${wall} never happens in ${zone} (the spring-forward gap skips it)`,
-        fix: "pass { gap: 'next' } to shift forward past the gap or { gap: 'previous' } to shift back before it",
-    });
-}
-export function instantInvalid(input) {
-    return new TimeError({
-        code: 'X_INSTANT_INVALID',
-        cause: `"${input}" is not a valid instant`,
-        fix: 'pass an ISO-8601 timestamp with an offset or Z, e.g. 2026-03-14T09:00:00Z',
-    });
-}
-//# sourceMappingURL=errors.js.map

package/src/errors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,oBAAoB;IACpB,gBAAgB;IAChB,oBAAoB;IACpB,iBAAiB;IACjB,mBAAmB;IACnB,mBAAmB;IACnB,oBAAoB;CACZ,CAAC;AAIX,MAAM,OAAO,SAAU,SAAQ,aAAa;IAC1C,YAAY,IAAyD;QACnE,KAAK,CAAC;YACJ,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,IAAI,EAAE,+BAA+B,IAAI,CAAC,IAAI,EAAE;SACjD,CAAC,CAAC;IACL,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,KAAc,EAAE,KAAa;IAC1E,OAAO,IAAI,SAAS,CAAC;QACnB,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,GAAG,KAAK,YAAY,KAAK,SAAS,MAAM,CAAC,KAAK,CAAC,EAAE;QACxD,GAAG,EAAE,sBAAsB,KAAK,QAAQ,KAAK,iHAAiH;KAC/J,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,SAAS,CAAC;QACnB,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,IAAI,IAAI,gCAAgC;QAC/C,GAAG,EAAE,4HAA4H;KAClI,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,UAAkB,EAAE,MAAc;IAC5D,OAAO,IAAI,SAAS,CAAC;QACnB,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,SAAS,UAAU,MAAM,MAAM,EAAE;QACxC,GAAG,EAAE,yJAAyJ;KAC/J,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,IAAI,SAAS,CAAC;QACnB,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,IAAI,KAAK,qBAAqB;QACrC,GAAG,EAAE,wGAAwG;KAC9G,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,IAAY;IACrD,OAAO,IAAI,SAAS,CAAC;QACnB,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,GAAG,IAAI,qBAAqB,IAAI,+BAA+B;QACtE,GAAG,EAAE,+GAA+G;KACrH,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,IAAY;IACvD,OAAO,IAAI,SAAS,CAAC;QACnB,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE,GAAG,IAAI,qBAAqB,IAAI,oCAAoC;QAC3E,GAAG,EAAE,mGAAmG;KACzG,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,IAAI,SAAS,CAAC;QACnB,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE,IAAI,KAAK,0BAA0B;QAC1C,GAAG,EAAE,2EAA2E;KACjF,CAAC,CAAC;AACL,CAAC"}

package/src/format.d.ts

@@ -1,54 +0,0 @@
-/**
- * `Intl.DateTimeFormat` at the edge. Every function takes an explicit `zone` and
- * `locale` — there is no ambient default and no `toLocaleString()` without options,
- * because "the server's timezone" is never the answer to "what time is it for the user".
- */
-import { type Instant } from './instant';
-import { type TimeZone } from './zones';
-export type DateTimeStyle = 'short' | 'medium' | 'long' | 'full';
-export interface FormatContext {
-    locale: string;
-    /** IANA zone. Required, always. */
-    zone: TimeZone;
-}
-export interface FormatDateTimeOptions extends FormatContext {
-    /** Sets both date and time style; `dateStyle`/`timeStyle` override it. */
-    style?: DateTimeStyle;
-    dateStyle?: DateTimeStyle;
-    timeStyle?: DateTimeStyle;
-    hour12?: boolean;
-}
-/** `14 Mar 2026, 09:00` in `en-GB` / `Europe/Berlin`. */
-export declare function formatDateTime(at: Instant, options: FormatDateTimeOptions): string;
-export declare function formatDate(at: Instant, options: FormatContext & {
-    style?: DateTimeStyle;
-}): string;
-export declare function formatTime(at: Instant, options: FormatContext & {
-    style?: DateTimeStyle;
-    hour12?: boolean;
-}): string;
-/**
- * `14 Mar 2026, 09:00 (GMT+1)` — the offset made visible.
- * Built with `timeZoneName: 'shortOffset'` + `formatToParts` so the offset is appended
- * in a fixed position instead of wherever the locale pattern happens to put it.
- */
-export declare function formatWithOffset(at: Instant, options: FormatDateTimeOptions): string;
-/** ISO-8601 date parts in a zone, for `<input type="date">` and CSV columns. */
-export declare function formatIsoDate(at: Instant, zone: TimeZone): string;
-export interface FormatRelativeOptions extends Omit<FormatContext, 'zone'> {
-    /** The reference point. Pass `now(clock)` — never let this default to a live clock. */
-    now: Instant;
-    numeric?: 'always' | 'auto';
-    style?: 'long' | 'short' | 'narrow';
-}
-/** `in 3 days` / `2 hours ago`, picking the largest unit that fits. */
-export declare function formatRelative(at: Instant, options: FormatRelativeOptions): string;
-/** `14–16 Mar 2026` — one call, so the locale decides how to collapse the range. */
-export declare function formatRange(from: Instant, to: Instant, options: FormatDateTimeOptions): string;
-/**
- * `Intl` renders `November 5, 2011`, never `5th of November`. When a design asks for the
- * ordinal, build it from `Intl.PluralRules` with `type: 'ordinal'` — English-only by
- * nature, which is why it is a helper and not the default date format.
- */
-export declare function ordinal(value: number, locale?: string): string;
-//# sourceMappingURL=format.d.ts.map

package/src/format.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAgB,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExD,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D,0EAA0E;IAC1E,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAQlF;AAED,wBAAgB,UAAU,CACxB,EAAE,EAAE,OAAO,EACX,OAAO,EAAE,aAAa,GAAG;IAAE,KAAK,CAAC,EAAE,aAAa,CAAA;CAAE,GACjD,MAAM,CAKR;AAED,wBAAgB,UAAU,CACxB,EAAE,EAAE,OAAO,EACX,OAAO,EAAE,aAAa,GAAG;IAAE,KAAK,CAAC,EAAE,aAAa,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GACnE,MAAM,CAMR;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAuBpF;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAQjE;AAED,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC;IACxE,uFAAuF;IACvF,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;CACrC;AAYD,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAalF;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAY9F;AAWD;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAO,GAAG,MAAM,CAG5D"}

package/src/format.js

@@ -1,133 +0,0 @@
-/**
- * `Intl.DateTimeFormat` at the edge. Every function takes an explicit `zone` and
- * `locale` — there is no ambient default and no `toLocaleString()` without options,
- * because "the server's timezone" is never the answer to "what time is it for the user".
- */
-import { differenceMs } from './instant';
-import { assertTimeZone } from './zones';
-/** `14 Mar 2026, 09:00` in `en-GB` / `Europe/Berlin`. */
-export function formatDateTime(at, options) {
-    const style = options.style ?? 'medium';
-    return formatterFor(options.locale, {
-        timeZone: assertTimeZone(options.zone),
-        dateStyle: options.dateStyle ?? style,
-        timeStyle: options.timeStyle ?? (style === 'full' || style === 'long' ? 'medium' : style),
-        ...(options.hour12 === undefined ? {} : { hour12: options.hour12 }),
-    }).format(at);
-}
-export function formatDate(at, options) {
-    return formatterFor(options.locale, {
-        timeZone: assertTimeZone(options.zone),
-        dateStyle: options.style ?? 'medium',
-    }).format(at);
-}
-export function formatTime(at, options) {
-    return formatterFor(options.locale, {
-        timeZone: assertTimeZone(options.zone),
-        timeStyle: options.style ?? 'short',
-        ...(options.hour12 === undefined ? {} : { hour12: options.hour12 }),
-    }).format(at);
-}
-/**
- * `14 Mar 2026, 09:00 (GMT+1)` — the offset made visible.
- * Built with `timeZoneName: 'shortOffset'` + `formatToParts` so the offset is appended
- * in a fixed position instead of wherever the locale pattern happens to put it.
- */
-export function formatWithOffset(at, options) {
-    const style = options.style ?? 'medium';
-    // `timeZoneName` is a component option, and Intl forbids mixing those with dateStyle /
-    // timeStyle — so the components are spelled out here instead.
-    const parts = formatterFor(options.locale, {
-        timeZone: assertTimeZone(options.zone),
-        year: 'numeric',
-        month: style === 'short' ? 'numeric' : style === 'medium' ? 'short' : 'long',
-        day: 'numeric',
-        hour: '2-digit',
-        minute: '2-digit',
-        ...(options.hour12 === undefined ? { hourCycle: 'h23' } : { hour12: options.hour12 }),
-        timeZoneName: 'shortOffset',
-    }).formatToParts(at);
-    const offset = parts.find((part) => part.type === 'timeZoneName')?.value ?? '';
-    const text = parts
-        .filter((part) => part.type !== 'timeZoneName')
-        .map((part) => part.value)
-        .join('')
-        .replace(/[\s,]+$/u, '')
-        .trim();
-    return offset === '' ? text : `${text} (${offset})`;
-}
-/** ISO-8601 date parts in a zone, for `<input type="date">` and CSV columns. */
-export function formatIsoDate(at, zone) {
-    const parts = formatterFor('en-CA', {
-        timeZone: assertTimeZone(zone),
-        year: 'numeric',
-        month: '2-digit',
-        day: '2-digit',
-    }).format(at);
-    return parts.replace(/\//g, '-');
-}
-const RELATIVE_UNITS = [
-    ['year', 31_536_000_000],
-    ['month', 2_592_000_000],
-    ['week', 604_800_000],
-    ['day', 86_400_000],
-    ['hour', 3_600_000],
-    ['minute', 60_000],
-    ['second', 1000],
-];
-/** `in 3 days` / `2 hours ago`, picking the largest unit that fits. */
-export function formatRelative(at, options) {
-    const delta = differenceMs(options.now, at);
-    const formatter = new Intl.RelativeTimeFormat(options.locale, {
-        numeric: options.numeric ?? 'auto',
-        style: options.style ?? 'long',
-    });
-    const magnitude = Math.abs(delta);
-    for (const [unit, ms] of RELATIVE_UNITS) {
-        if (magnitude >= ms) {
-            return formatter.format(Math.trunc(delta / ms), unit);
-        }
-    }
-    return formatter.format(0, 'second');
-}
-/** `14–16 Mar 2026` — one call, so the locale decides how to collapse the range. */
-export function formatRange(from, to, options) {
-    const style = options.style ?? 'medium';
-    const formatter = formatterFor(options.locale, {
-        timeZone: assertTimeZone(options.zone),
-        dateStyle: options.dateStyle ?? style,
-        ...(options.timeStyle === undefined ? {} : { timeStyle: options.timeStyle }),
-    });
-    // `formatRange` is ES2021; fall back to two formatted endpoints on older engines.
-    if (typeof formatter.formatRange === 'function')
-        return formatter.formatRange(from, to);
-    return `${formatter.format(from)} – ${formatter.format(to)}`;
-}
-const ORDINAL_SUFFIX = {
-    one: 'st',
-    two: 'nd',
-    few: 'rd',
-    other: 'th',
-    zero: 'th',
-    many: 'th',
-};
-/**
- * `Intl` renders `November 5, 2011`, never `5th of November`. When a design asks for the
- * ordinal, build it from `Intl.PluralRules` with `type: 'ordinal'` — English-only by
- * nature, which is why it is a helper and not the default date format.
- */
-export function ordinal(value, locale = 'en') {
-    const category = new Intl.PluralRules(locale, { type: 'ordinal' }).select(value);
-    return `${value}${ORDINAL_SUFFIX[category]}`;
-}
-const cache = new Map();
-function formatterFor(locale, options) {
-    const key = `${locale}|${JSON.stringify(options)}`;
-    const cached = cache.get(key);
-    if (cached !== undefined)
-        return cached;
-    const formatter = new Intl.DateTimeFormat(locale, options);
-    cache.set(key, formatter);
-    return formatter;
-}
-//# sourceMappingURL=format.js.map

package/src/format.js.map

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

package/src/index.d.ts

@@ -1,12 +0,0 @@
-/** Public surface of @ultimat3/time. Explicit exports only. */
-export { addBusinessDays, type BusinessCalendar, businessDaysBetween, type IsoWeekday, isBusinessDay, isHoliday, isWeekend, nextBusinessDay, WEEKEND_FRI_SAT, WEEKEND_SAT_SUN, WEEKEND_SUN_ONLY, } from './business';
-export { attachTimeZone, configureTime, currentTimeZone, resolveTimeZone, TIMEZONE_HEADER, type TimeConfig, type TimeZoneResolution, type TimeZoneSourceName, type TimeZoneSources, timeConfig, timeZoneOf, } from './context';
-export { type CronExpression, type CronPhrases, DEFAULT_CRON_PHRASES, describeCron, firedSince, isValidCron, matchesCron, nextCronOccurrence, nextCronOccurrenceMs, nextCronOccurrences, parseCron, } from './cron';
-export { DAY, type FormatDurationOptions, formatDuration, formatDurationIso, HOUR, MINUTE, MS, parseDuration, SECOND, toMs, toSeconds, WEEK, } from './duration';
-export { cronInvalid, dstAmbiguous, dstNonexistent, durationInvalid, instantInvalid, TIME_ERROR_CODES, TimeError, type TimeErrorCode, timezoneInvalid, } from './errors';
-export { type DateTimeStyle, type FormatContext, type FormatDateTimeOptions, type FormatRelativeOptions, formatDate, formatDateTime, formatIsoDate, formatRange, formatRelative, formatTime, formatWithOffset, ordinal, } from './format';
-export { addMs, compareInstants, differenceMs, EPOCH, fromEpochMs, fromEpochSeconds, fromIso, type Instant, instant, isAfter, isBefore, isInstant, now, subtractMs, toEpochMs, toIso, toIsoDateUtc, } from './instant';
-export { type LocalSlot, nextLocalSlot, nextLocalSlots, nextWeeklySlot, type WeeklySlot, } from './schedule';
-export { addDaysInZone, endOfDay, type FromZonedOptions, type FromZonedResult, fromZoned, fromZonedDetailed, type GapPolicy, isoDateInZone, isSameLocalDay, type OverlapPolicy, startOfDay, toZoned, type WallClock, type ZonedDateTime, type ZonedResolution, } from './zoned';
-export { assertTimeZone, isValidTimeZone, observesDst, offsetAt, offsetLabel, type TimeZone, UTC, type ZoneParts, zoneAbbrev, zonePartsAt, } from './zones';
-//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAE/D,OAAO,EACL,eAAe,EACf,KAAK,gBAAgB,EACrB,mBAAmB,EACnB,KAAK,UAAU,EACf,aAAa,EACb,SAAS,EACT,SAAS,EACT,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,EACf,eAAe,EACf,eAAe,EACf,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,UAAU,EACV,UAAU,GACX,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,oBAAoB,EACpB,YAAY,EACZ,UAAU,EACV,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,SAAS,GACV,MAAM,QAAQ,CAAC;AAChB,OAAO,EACL,GAAG,EACH,KAAK,qBAAqB,EAC1B,cAAc,EACd,iBAAiB,EACjB,IAAI,EACJ,MAAM,EACN,EAAE,EACF,aAAa,EACb,MAAM,EACN,IAAI,EACJ,SAAS,EACT,IAAI,GACL,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,cAAc,EACd,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,SAAS,EACT,KAAK,aAAa,EAClB,eAAe,GAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,UAAU,EACV,cAAc,EACd,aAAa,EACb,WAAW,EACX,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,OAAO,GACR,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,KAAK,EACL,eAAe,EACf,YAAY,EACZ,KAAK,EACL,WAAW,EACX,gBAAgB,EAChB,OAAO,EACP,KAAK,OAAO,EACZ,OAAO,EACP,OAAO,EACP,QAAQ,EACR,SAAS,EACT,GAAG,EACH,UAAU,EACV,SAAS,EACT,KAAK,EACL,YAAY,GACb,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,KAAK,SAAS,EACd,aAAa,EACb,cAAc,EACd,cAAc,EACd,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,aAAa,EACb,QAAQ,EACR,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,SAAS,EACT,iBAAiB,EACjB,KAAK,SAAS,EACd,aAAa,EACb,cAAc,EACd,KAAK,aAAa,EAClB,UAAU,EACV,OAAO,EACP,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,cAAc,EACd,eAAe,EACf,WAAW,EACX,QAAQ,EACR,WAAW,EACX,KAAK,QAAQ,EACb,GAAG,EACH,KAAK,SAAS,EACd,UAAU,EACV,WAAW,GACZ,MAAM,SAAS,CAAC"}

package/src/index.js

@@ -1,12 +0,0 @@
-/** Public surface of @ultimat3/time. Explicit exports only. */
-export { addBusinessDays, businessDaysBetween, isBusinessDay, isHoliday, isWeekend, nextBusinessDay, WEEKEND_FRI_SAT, WEEKEND_SAT_SUN, WEEKEND_SUN_ONLY, } from './business';
-export { attachTimeZone, configureTime, currentTimeZone, resolveTimeZone, TIMEZONE_HEADER, timeConfig, timeZoneOf, } from './context';
-export { DEFAULT_CRON_PHRASES, describeCron, firedSince, isValidCron, matchesCron, nextCronOccurrence, nextCronOccurrenceMs, nextCronOccurrences, parseCron, } from './cron';
-export { DAY, formatDuration, formatDurationIso, HOUR, MINUTE, MS, parseDuration, SECOND, toMs, toSeconds, WEEK, } from './duration';
-export { cronInvalid, dstAmbiguous, dstNonexistent, durationInvalid, instantInvalid, TIME_ERROR_CODES, TimeError, timezoneInvalid, } from './errors';
-export { formatDate, formatDateTime, formatIsoDate, formatRange, formatRelative, formatTime, formatWithOffset, ordinal, } from './format';
-export { addMs, compareInstants, differenceMs, EPOCH, fromEpochMs, fromEpochSeconds, fromIso, instant, isAfter, isBefore, isInstant, now, subtractMs, toEpochMs, toIso, toIsoDateUtc, } from './instant';
-export { nextLocalSlot, nextLocalSlots, nextWeeklySlot, } from './schedule';
-export { addDaysInZone, endOfDay, fromZoned, fromZonedDetailed, isoDateInZone, isSameLocalDay, startOfDay, toZoned, } from './zoned';
-export { assertTimeZone, isValidTimeZone, observesDst, offsetAt, offsetLabel, UTC, zoneAbbrev, zonePartsAt, } from './zones';
-//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAE/D,OAAO,EACL,eAAe,EAEf,mBAAmB,EAEnB,aAAa,EACb,SAAS,EACT,SAAS,EACT,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,EACf,eAAe,EACf,eAAe,EAKf,UAAU,EACV,UAAU,GACX,MAAM,WAAW,CAAC;AACnB,OAAO,EAGL,oBAAoB,EACpB,YAAY,EACZ,UAAU,EACV,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,SAAS,GACV,MAAM,QAAQ,CAAC;AAChB,OAAO,EACL,GAAG,EAEH,cAAc,EACd,iBAAiB,EACjB,IAAI,EACJ,MAAM,EACN,EAAE,EACF,aAAa,EACb,MAAM,EACN,IAAI,EACJ,SAAS,EACT,IAAI,GACL,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,cAAc,EACd,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,SAAS,EAET,eAAe,GAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EAKL,UAAU,EACV,cAAc,EACd,aAAa,EACb,WAAW,EACX,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,OAAO,GACR,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,KAAK,EACL,eAAe,EACf,YAAY,EACZ,KAAK,EACL,WAAW,EACX,gBAAgB,EAChB,OAAO,EAEP,OAAO,EACP,OAAO,EACP,QAAQ,EACR,SAAS,EACT,GAAG,EACH,UAAU,EACV,SAAS,EACT,KAAK,EACL,YAAY,GACb,MAAM,WAAW,CAAC;AACnB,OAAO,EAEL,aAAa,EACb,cAAc,EACd,cAAc,GAEf,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,aAAa,EACb,QAAQ,EAGR,SAAS,EACT,iBAAiB,EAEjB,aAAa,EACb,cAAc,EAEd,UAAU,EACV,OAAO,GAIR,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,cAAc,EACd,eAAe,EACf,WAAW,EACX,QAAQ,EACR,WAAW,EAEX,GAAG,EAEH,UAAU,EACV,WAAW,GACZ,MAAM,SAAS,CAAC"}

package/src/instant.d.ts

@@ -1,38 +0,0 @@
-/**
- * An `Instant` is a point on the UTC timeline. **All storage is UTC** — columns are
- * `timestamptz`, wire format is ISO-8601 with `Z`, and no zone is attached to a stored
- * value. Zones exist only at the edge, in `format.ts` and `zoned.ts`.
- */
-import { type Clock } from '@ultimat3/core';
-declare const instantBrand: unique symbol;
-/** A `Date` that has been proven valid and is documented as UTC. */
-export type Instant = Date & {
-    readonly [instantBrand]: 'utc';
-};
-/** Wrap a `Date` from an untrusted source (a DB driver, a parsed payload). */
-export declare function instant(value: Date): Instant;
-/** ISO-8601 in, `Instant` out. An offset or `Z` is required — a bare local string is a bug. */
-export declare function fromIso(iso: string): Instant;
-/** The only serialization: `2026-03-14T09:00:00.000Z`. */
-export declare function toIso(at: Instant): string;
-/** Date-only ISO form in UTC. Use `formatIsoDate` when you need it in a zone. */
-export declare function toIsoDateUtc(at: Instant): string;
-export declare function fromEpochMs(ms: number): Instant;
-export declare function toEpochMs(at: Instant): number;
-export declare function fromEpochSeconds(seconds: number): Instant;
-/**
- * The clock is always injected. Tests freeze time by passing a fake clock; nothing in
- * the framework calls `Date.now()` directly.
- */
-export declare function now(clock?: Clock): Instant;
-export declare function addMs(at: Instant, ms: number): Instant;
-export declare function subtractMs(at: Instant, ms: number): Instant;
-/** Signed milliseconds from `from` to `to`. */
-export declare function differenceMs(from: Instant, to: Instant): number;
-export declare function isBefore(left: Instant, right: Instant): boolean;
-export declare function isAfter(left: Instant, right: Instant): boolean;
-export declare function compareInstants(left: Instant, right: Instant): -1 | 0 | 1;
-export declare function isInstant(value: unknown): value is Instant;
-export declare const EPOCH: Instant;
-export {};
-//# sourceMappingURL=instant.d.ts.map

package/src/instant.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"instant.d.ts","sourceRoot":"","sources":["instant.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,KAAK,EAAe,MAAM,gBAAgB,CAAC;AAGzD,OAAO,CAAC,MAAM,YAAY,EAAE,OAAO,MAAM,CAAC;AAE1C,oEAAoE;AACpE,MAAM,MAAM,OAAO,GAAG,IAAI,GAAG;IAAE,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAEhE,8EAA8E;AAC9E,wBAAgB,OAAO,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO,CAG5C;AAED,+FAA+F;AAC/F,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAI5C;AAED,0DAA0D;AAC1D,wBAAgB,KAAK,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,CAEzC;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,CAEhD;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAG/C;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,CAE7C;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;GAGG;AACH,wBAAgB,GAAG,CAAC,KAAK,GAAE,KAAmB,GAAG,OAAO,CAEvD;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,GAAG,MAAM,CAE/D;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAE/D;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAE9D;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAGzE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D;AAED,eAAO,MAAM,KAAK,EAAE,OAAgC,CAAC"}

package/src/instant.js

@@ -1,76 +0,0 @@
-/**
- * An `Instant` is a point on the UTC timeline. **All storage is UTC** — columns are
- * `timestamptz`, wire format is ISO-8601 with `Z`, and no zone is attached to a stored
- * value. Zones exist only at the edge, in `format.ts` and `zoned.ts`.
- */
-import { systemClock } from '@ultimat3/core';
-import { instantInvalid } from './errors';
-/** Wrap a `Date` from an untrusted source (a DB driver, a parsed payload). */
-export function instant(value) {
-    if (Number.isNaN(value.getTime()))
-        throw instantInvalid(String(value));
-    return value;
-}
-/** ISO-8601 in, `Instant` out. An offset or `Z` is required — a bare local string is a bug. */
-export function fromIso(iso) {
-    const parsed = new Date(iso);
-    if (Number.isNaN(parsed.getTime()))
-        throw instantInvalid(iso);
-    return parsed;
-}
-/** The only serialization: `2026-03-14T09:00:00.000Z`. */
-export function toIso(at) {
-    return at.toISOString();
-}
-/** Date-only ISO form in UTC. Use `formatIsoDate` when you need it in a zone. */
-export function toIsoDateUtc(at) {
-    return at.toISOString().slice(0, 10);
-}
-export function fromEpochMs(ms) {
-    if (!Number.isFinite(ms))
-        throw instantInvalid(String(ms));
-    return new Date(ms);
-}
-export function toEpochMs(at) {
-    return at.getTime();
-}
-export function fromEpochSeconds(seconds) {
-    return fromEpochMs(seconds * 1000);
-}
-/**
- * The clock is always injected. Tests freeze time by passing a fake clock; nothing in
- * the framework calls `Date.now()` directly.
- */
-export function now(clock = systemClock) {
-    return fromEpochMs(epochMsOf(clock.now()));
-}
-export function addMs(at, ms) {
-    return fromEpochMs(at.getTime() + ms);
-}
-export function subtractMs(at, ms) {
-    return fromEpochMs(at.getTime() - ms);
-}
-/** Signed milliseconds from `from` to `to`. */
-export function differenceMs(from, to) {
-    return to.getTime() - from.getTime();
-}
-export function isBefore(left, right) {
-    return left.getTime() < right.getTime();
-}
-export function isAfter(left, right) {
-    return left.getTime() > right.getTime();
-}
-export function compareInstants(left, right) {
-    if (left.getTime() < right.getTime())
-        return -1;
-    return left.getTime() > right.getTime() ? 1 : 0;
-}
-export function isInstant(value) {
-    return value instanceof Date && !Number.isNaN(value.getTime());
-}
-export const EPOCH = new Date(0);
-/** Tolerates a `Clock` whose `now()` returns either a `Date` or epoch milliseconds. */
-function epochMsOf(value) {
-    return typeof value === 'number' ? value : value.getTime();
-}
-//# sourceMappingURL=instant.js.map

package/src/instant.js.map

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

package/src/schedule.d.ts

@@ -1,24 +0,0 @@
-/**
- * "Send at 09:00 local" — the scheduling primitive digests, reminders and drip campaigns
- * are built from. Local means the *recipient's* local, and it survives DST.
- */
-import type { Instant } from './instant';
-import { type TimeZone } from './zones';
-export interface LocalSlot {
-    zone: TimeZone;
-    /** 0–23, wall clock in `zone`. */
-    hour: number;
-    /** 0–59. */
-    minute?: number;
-    second?: number;
-}
-export declare function nextLocalSlot(slot: LocalSlot, after: Instant): Instant;
-/** The next `count` daily slots — a preview for the schedule screen. */
-export declare function nextLocalSlots(slot: LocalSlot, after: Instant, count: number): Instant[];
-export interface WeeklySlot extends LocalSlot {
-    /** ISO weekday: 1 = Monday … 7 = Sunday. */
-    weekday: number;
-}
-/** Next `weekday` at the local time, strictly after `after`. */
-export declare function nextWeeklySlot(slot: WeeklySlot, after: Instant): Instant;
-//# sourceMappingURL=schedule.d.ts.map

package/src/schedule.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["schedule.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,QAAQ,CAAC;IACf,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAgBD,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CA6BtE;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,CAQxF;AAED,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAQxE"}

package/src/schedule.js

@@ -1,67 +0,0 @@
-/**
- * "Send at 09:00 local" — the scheduling primitive digests, reminders and drip campaigns
- * are built from. Local means the *recipient's* local, and it survives DST.
- */
-import { scheduleInvalid, timezoneInvalid } from './errors';
-import { fromZoned, toZoned } from './zoned';
-import { assertTimeZone } from './zones';
-/**
- * Next instant matching the local `HH:mm` in `zone`, strictly after `after`.
- *
- * Walks forward day by day on the *local* calendar rather than adding 86 400 000 ms, so
- * a 23- or 25-hour day does not shift the slot. If the slot falls in a spring-forward
- * gap, `{ gap: 'next' }` picks the first existing local time instead of skipping the day.
- */
-/** Wall-clock fields are never wrapped or clamped — a shifted schedule beats no schedule. */
-function assertWallField(field, value, max) {
-    if (!Number.isInteger(value) || value < 0 || value > max) {
-        throw scheduleInvalid(field, value, `an integer 0-${String(max)}`);
-    }
-}
-export function nextLocalSlot(slot, after) {
-    assertTimeZone(slot.zone);
-    assertWallField('slot.hour', slot.hour, 23);
-    const minute = slot.minute ?? 0;
-    const second = slot.second ?? 0;
-    // Validated too: a minute of 90 would otherwise roll into the next hour and ship a
-    // schedule an hour off, which is exactly the class of bug this package exists to prevent.
-    assertWallField('slot.minute', minute, 59);
-    assertWallField('slot.second', second, 59);
-    const start = toZoned(after, slot.zone);
-    for (let dayOffset = 0; dayOffset < 4; dayOffset += 1) {
-        const candidate = fromZoned({
-            year: start.year,
-            month: start.month,
-            day: start.day + dayOffset,
-            hour: slot.hour,
-            minute,
-            second,
-        }, slot.zone, { gap: 'next', overlap: 'first' });
-        if (candidate.getTime() > after.getTime())
-            return candidate;
-    }
-    // Four local days always contain the slot; reaching here means the zone data is broken.
-    throw timezoneInvalid(slot.zone);
-}
-/** The next `count` daily slots — a preview for the schedule screen. */
-export function nextLocalSlots(slot, after, count) {
-    const slots = [];
-    let cursor = after;
-    for (let index = 0; index < count; index += 1) {
-        cursor = nextLocalSlot(slot, cursor);
-        slots.push(cursor);
-    }
-    return slots;
-}
-/** Next `weekday` at the local time, strictly after `after`. */
-export function nextWeeklySlot(slot, after) {
-    let cursor = after;
-    for (let index = 0; index < 8; index += 1) {
-        const candidate = nextLocalSlot(slot, cursor);
-        if (toZoned(candidate, slot.zone).weekday === slot.weekday)
-            return candidate;
-        cursor = candidate;
-    }
-    throw timezoneInvalid(slot.zone);
-}
-//# sourceMappingURL=schedule.js.map

package/src/schedule.js.map

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

package/src/zoned.d.ts

@@ -1,80 +0,0 @@
-/**
- * The two conversions everything else is built on: instant → wall clock, and wall clock →
- * instant. `fromZoned` is the DST-correct one, and it is the reason this package exists.
- */
-import { type Instant } from './instant';
-import { type TimeZone } from './zones';
-/** A local date and time with no zone attached — meaningless until paired with one. */
-export interface WallClock {
-    year: number;
-    month: number;
-    day: number;
-    hour: number;
-    minute: number;
-    second?: number;
-    millisecond?: number;
-}
-export interface ZonedDateTime {
-    year: number;
-    month: number;
-    day: number;
-    hour: number;
-    minute: number;
-    second: number;
-    millisecond: number;
-    zone: TimeZone;
-    /** Minutes east of UTC in effect at this instant. */
-    offsetMinutes: number;
-    /** ISO weekday: 1 = Monday … 7 = Sunday. */
-    weekday: number;
-}
-/** What to do with a wall-clock time that does not exist (spring forward). */
-export type GapPolicy = 'next' | 'previous' | 'throw';
-/** What to do with a wall-clock time that happens twice (fall back). */
-export type OverlapPolicy = 'first' | 'second' | 'throw';
-export interface FromZonedOptions {
-    gap?: GapPolicy;
-    overlap?: OverlapPolicy;
-}
-export type ZonedResolution = 'exact' | 'gap' | 'overlap';
-export interface FromZonedResult {
-    instant: Instant;
-    /** Which case the wall-clock time fell into — log it when scheduling. */
-    resolution: ZonedResolution;
-    offsetMinutes: number;
-}
-/** Instant → the zone's wall clock. */
-export declare function toZoned(at: Instant, zone: TimeZone): ZonedDateTime;
-/**
- * Wall clock + zone → instant, DST-correct.
- *
- * Algorithm (search and verify — never `offset * 3600`):
- *  1. Read the wall-clock fields as if they were UTC. Call that `target`.
- *  2. Collect the candidate offsets in force around `target` — 24h before, at, and 24h
- *     after. Any DST transition puts both of its offsets in that set.
- *  3. For each distinct offset `o`, the candidate instant is `target - o`.
- *  4. Verify each candidate by converting it *back* with `toZoned`. A candidate that does
- *     not reproduce the requested wall clock is not a real instant for it.
- *      - two distinct verified candidates → the hour repeats (overlap)
- *      - exactly one                      → normal case
- *      - none                             → the hour was skipped (gap)
- *
- * Milliseconds ride along untouched: every real offset is a whole number of minutes.
- */
-export declare function fromZonedDetailed(wall: WallClock, zone: TimeZone, options?: FromZonedOptions): FromZonedResult;
-/** The common form: just the instant. */
-export declare function fromZoned(wall: WallClock, zone: TimeZone, options?: FromZonedOptions): Instant;
-/** Midnight local, as an instant. DST-correct: on a spring-forward day it still exists. */
-export declare function startOfDay(at: Instant, zone: TimeZone): Instant;
-/** The last millisecond of the local day. */
-export declare function endOfDay(at: Instant, zone: TimeZone): Instant;
-/**
- * Add calendar days in a zone, keeping the wall-clock time. Adding one day is 23, 24 or
- * 25 hours depending on the transition — which is why this is not `+ 86_400_000`.
- */
-export declare function addDaysInZone(at: Instant, days: number, zone: TimeZone): Instant;
-/** `2026-03-14` for the given instant in the given zone. */
-export declare function isoDateInZone(at: Instant, zone: TimeZone): string;
-/** True when both instants fall on the same local calendar day. */
-export declare function isSameLocalDay(left: Instant, right: Instant, zone: TimeZone): boolean;
-//# sourceMappingURL=zoned.d.ts.map