@ultimat3/time 1.0.0 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/time",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "UTC instants, DST-correct zone math, cron, durations and Intl formatting with an explicit timezone",
   "license": "MIT",
   "type": "module",
@@ -30,6 +30,6 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/core": "1.0.0"
+    "@ultimat3/core": "1.1.0"
   }
 }

package/src/business.d.ts

@@ -1,37 +0,0 @@
-/**
- * Business-day math. The weekend is configuration, not a constant: Friday/Saturday in
- * much of the Gulf, Sunday-only in parts of Asia, Saturday/Sunday in the West.
- */
-import type { Instant } from './instant';
-import type { TimeZone } from './zones';
-/** ISO weekday numbers: 1 = Monday … 7 = Sunday. */
-export type IsoWeekday = 1 | 2 | 3 | 4 | 5 | 6 | 7;
-export declare const WEEKEND_SAT_SUN: readonly IsoWeekday[];
-/** Gulf states, and the default in Israel (Fri/Sat). */
-export declare const WEEKEND_FRI_SAT: readonly IsoWeekday[];
-export declare const WEEKEND_SUN_ONLY: readonly IsoWeekday[];
-export interface BusinessCalendar {
-    zone: TimeZone;
-    /** Defaults to Saturday + Sunday, which is a choice, not a law. */
-    weekendDays?: readonly IsoWeekday[];
-    /** Local `YYYY-MM-DD` dates that are holidays in this calendar. */
-    holidays?: readonly string[];
-}
-export declare function isWeekend(at: Instant, zone: TimeZone, weekendDays?: readonly IsoWeekday[]): boolean;
-export declare function isHoliday(at: Instant, calendar: BusinessCalendar): boolean;
-/** A business day is a non-weekend, non-holiday local day. */
-export declare function isBusinessDay(at: Instant, calendar: BusinessCalendar): boolean;
-/**
- * Move `days` business days forward (or back, if negative), keeping the local wall-clock
- * time. `days === 0` returns the input untouched, even on a weekend — callers that want
- * "the next business day" should ask for 1.
- */
-export declare function addBusinessDays(at: Instant, days: number, calendar: BusinessCalendar): Instant;
-/** The next business day at the same local time; today if it already qualifies. */
-export declare function nextBusinessDay(at: Instant, calendar: BusinessCalendar): Instant;
-/**
- * Business days in `[from, to)`, counted on local calendar days. Order-independent:
- * a reversed range returns a negative count.
- */
-export declare function businessDaysBetween(from: Instant, to: Instant, calendar: BusinessCalendar): number;
-//# sourceMappingURL=business.d.ts.map

package/src/business.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"business.d.ts","sourceRoot":"","sources":["business.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,oDAAoD;AACpD,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEnD,eAAO,MAAM,eAAe,EAAE,SAAS,UAAU,EAAW,CAAC;AAC7D,wDAAwD;AACxD,eAAO,MAAM,eAAe,EAAE,SAAS,UAAU,EAAW,CAAC;AAC7D,eAAO,MAAM,gBAAgB,EAAE,SAAS,UAAU,EAAQ,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf,mEAAmE;IACnE,WAAW,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACpC,mEAAmE;IACnE,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,wBAAkB,GAAG,OAAO,CAE7F;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAG1E;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAK9E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAe9F;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAEhF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,OAAO,EACb,EAAE,EAAE,OAAO,EACX,QAAQ,EAAE,gBAAgB,GACzB,MAAM,CAYR"}

package/src/business.js

@@ -1,68 +0,0 @@
-/**
- * Business-day math. The weekend is configuration, not a constant: Friday/Saturday in
- * much of the Gulf, Sunday-only in parts of Asia, Saturday/Sunday in the West.
- */
-import { addDaysInZone, isoDateInZone, toZoned } from './zoned';
-export const WEEKEND_SAT_SUN = [6, 7];
-/** Gulf states, and the default in Israel (Fri/Sat). */
-export const WEEKEND_FRI_SAT = [5, 6];
-export const WEEKEND_SUN_ONLY = [7];
-export function isWeekend(at, zone, weekendDays = WEEKEND_SAT_SUN) {
-    return weekendDays.includes(toZoned(at, zone).weekday);
-}
-export function isHoliday(at, calendar) {
-    const holidays = calendar.holidays ?? [];
-    return holidays.includes(isoDateInZone(at, calendar.zone));
-}
-/** A business day is a non-weekend, non-holiday local day. */
-export function isBusinessDay(at, calendar) {
-    return (!isWeekend(at, calendar.zone, calendar.weekendDays ?? WEEKEND_SAT_SUN) &&
-        !isHoliday(at, calendar));
-}
-/**
- * Move `days` business days forward (or back, if negative), keeping the local wall-clock
- * time. `days === 0` returns the input untouched, even on a weekend — callers that want
- * "the next business day" should ask for 1.
- */
-export function addBusinessDays(at, days, calendar) {
-    if (days === 0)
-        return at;
-    const step = days > 0 ? 1 : -1;
-    let remaining = Math.abs(days);
-    let cursor = at;
-    let guard = 0;
-    while (remaining > 0) {
-        cursor = addDaysInZone(cursor, step, calendar.zone);
-        if (isBusinessDay(cursor, calendar))
-            remaining -= 1;
-        guard += 1;
-        // A calendar with every day marked as a holiday would otherwise loop forever.
-        if (guard > Math.abs(days) * 7 + 3650)
-            return cursor;
-    }
-    return cursor;
-}
-/** The next business day at the same local time; today if it already qualifies. */
-export function nextBusinessDay(at, calendar) {
-    return isBusinessDay(at, calendar) ? at : addBusinessDays(at, 1, calendar);
-}
-/**
- * Business days in `[from, to)`, counted on local calendar days. Order-independent:
- * a reversed range returns a negative count.
- */
-export function businessDaysBetween(from, to, calendar) {
-    const sign = to.getTime() < from.getTime() ? -1 : 1;
-    const start = sign === 1 ? from : to;
-    const end = sign === 1 ? to : from;
-    let cursor = start;
-    let count = 0;
-    while (isoDateInZone(cursor, calendar.zone) !== isoDateInZone(end, calendar.zone)) {
-        cursor = addDaysInZone(cursor, 1, calendar.zone);
-        if (cursor.getTime() > end.getTime())
-            break;
-        if (isBusinessDay(cursor, calendar))
-            count += 1;
-    }
-    return sign * count;
-}
-//# sourceMappingURL=business.js.map

package/src/business.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"business.js","sourceRoot":"","sources":["business.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAMhE,MAAM,CAAC,MAAM,eAAe,GAA0B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7D,wDAAwD;AACxD,MAAM,CAAC,MAAM,eAAe,GAA0B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,gBAAgB,GAA0B,CAAC,CAAC,CAAC,CAAC;AAU3D,MAAM,UAAU,SAAS,CAAC,EAAW,EAAE,IAAc,EAAE,WAAW,GAAG,eAAe;IAClF,OAAO,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,OAAqB,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,EAAW,EAAE,QAA0B;IAC/D,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC;IACzC,OAAO,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,aAAa,CAAC,EAAW,EAAE,QAA0B;IACnE,OAAO,CACL,CAAC,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,WAAW,IAAI,eAAe,CAAC;QACtE,CAAC,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC,CACzB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,EAAW,EAAE,IAAY,EAAE,QAA0B;IACnF,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,OAAO,SAAS,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACpD,IAAI,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC;YAAE,SAAS,IAAI,CAAC,CAAC;QACpD,KAAK,IAAI,CAAC,CAAC;QACX,8EAA8E;QAC9E,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI;YAAE,OAAO,MAAM,CAAC;IACvD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,eAAe,CAAC,EAAW,EAAE,QAA0B;IACrE,OAAO,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,EAAE,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC7E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAa,EACb,EAAW,EACX,QAA0B;IAE1B,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACrC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACnC,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,aAAa,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAClF,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,MAAM,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE;YAAE,MAAM;QAC5C,IAAI,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,IAAI,GAAG,KAAK,CAAC;AACtB,CAAC"}

package/src/context.d.ts

@@ -1,40 +0,0 @@
-/**
- * Resolve the request timezone once, then read it from the ALS context.
- * User record → header → config default. Every formatter still takes the zone
- * explicitly; this is where call sites get the value from, not a hidden default.
- */
-import { type Ctx } from '@ultimat3/core';
-import { type TimeZone } from './zones';
-/** Header a client sets from `Intl.DateTimeFormat().resolvedOptions().timeZone`. */
-export declare const TIMEZONE_HEADER = "x-timezone";
-export interface TimeZoneSources {
-    /** `user.timeZone` — an explicit preference beats a browser guess. */
-    user?: string | null;
-    /** `x-timezone` request header. */
-    header?: string | null;
-    /** `?tz=Europe/Berlin`, for share links and email previews. */
-    query?: string | null;
-}
-export type TimeZoneSourceName = keyof TimeZoneSources;
-export interface TimeZoneResolution {
-    zone: TimeZone;
-    source: TimeZoneSourceName | 'default';
-}
-export interface TimeConfig {
-    /** The zone used when nothing else resolves. UTC unless the app says otherwise. */
-    defaultZone: TimeZone;
-    order: readonly TimeZoneSourceName[];
-}
-export declare function configureTime(partial: Partial<TimeConfig>): TimeConfig;
-export declare function timeConfig(): TimeConfig;
-/**
- * First valid IANA name wins. An invalid value is skipped, never thrown: a stale
- * `x-timezone` header from an old client must not fail the request.
- */
-export declare function resolveTimeZone(sources: TimeZoneSources, overrides?: Partial<TimeConfig>): TimeZoneResolution;
-/** Called once per request by the HTTP layer. */
-export declare function attachTimeZone(ctx: Ctx, zone: TimeZone): TimeZone;
-export declare function timeZoneOf(ctx: Ctx): TimeZone;
-/** Ambient zone for the in-flight request; the configured default outside one. */
-export declare function currentTimeZone(): TimeZone;
-//# sourceMappingURL=context.d.ts.map

package/src/context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,GAAG,EAAc,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAmB,KAAK,QAAQ,EAAO,MAAM,SAAS,CAAC;AAE9D,oFAAoF;AACpF,eAAO,MAAM,eAAe,eAAe,CAAC;AAI5C,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,eAAe,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,UAAU;IACzB,mFAAmF;IACnF,WAAW,EAAE,QAAQ,CAAC;IACtB,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACtC;AAID,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAGtE;AAED,wBAAgB,UAAU,IAAI,UAAU,CAEvC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,eAAe,EACxB,SAAS,GAAE,OAAO,CAAC,UAAU,CAAM,GAClC,kBAAkB,CAQpB;AAED,iDAAiD;AACjD,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAGjE;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,QAAQ,CAE7C;AAED,kFAAkF;AAClF,wBAAgB,eAAe,IAAI,QAAQ,CAG1C"}

package/src/context.js

@@ -1,61 +0,0 @@
-/**
- * Resolve the request timezone once, then read it from the ALS context.
- * User record → header → config default. Every formatter still takes the zone
- * explicitly; this is where call sites get the value from, not a hidden default.
- */
-import { useContext } from '@ultimat3/core';
-import { isValidTimeZone, UTC } from './zones';
-/** Header a client sets from `Intl.DateTimeFormat().resolvedOptions().timeZone`. */
-export const TIMEZONE_HEADER = 'x-timezone';
-const CTX_TIMEZONE = 'timeZone';
-let config = { defaultZone: UTC, order: ['user', 'header', 'query'] };
-export function configureTime(partial) {
-    config = { ...config, ...partial };
-    return config;
-}
-export function timeConfig() {
-    return config;
-}
-/**
- * First valid IANA name wins. An invalid value is skipped, never thrown: a stale
- * `x-timezone` header from an old client must not fail the request.
- */
-export function resolveTimeZone(sources, overrides = {}) {
-    const { defaultZone, order } = { ...config, ...overrides };
-    for (const name of order) {
-        const candidate = sources[name];
-        if (candidate === undefined || candidate === null || candidate === '')
-            continue;
-        if (isValidTimeZone(candidate))
-            return { zone: candidate, source: name };
-    }
-    return { zone: defaultZone, source: 'default' };
-}
-/** Called once per request by the HTTP layer. */
-export function attachTimeZone(ctx, zone) {
-    ctx[CTX_TIMEZONE] = zone;
-    return zone;
-}
-export function timeZoneOf(ctx) {
-    return readField(ctx, CTX_TIMEZONE) ?? config.defaultZone;
-}
-/** Ambient zone for the in-flight request; the configured default outside one. */
-export function currentTimeZone() {
-    const ctx = tryContext();
-    return (ctx === undefined ? undefined : readField(ctx, CTX_TIMEZONE)) ?? config.defaultZone;
-}
-function tryContext() {
-    try {
-        return useContext();
-    }
-    catch {
-        // Outside a request scope (boot, worker tick, CLI) — fall back to the configured zone.
-        return undefined;
-    }
-}
-/** `Ctx` belongs to core (tier 0) and cannot import `TimeZone`; read the field structurally. */
-function readField(ctx, field) {
-    const value = ctx[field];
-    return typeof value === 'string' && value !== '' ? value : undefined;
-}
-//# sourceMappingURL=context.js.map

package/src/context.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAY,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAiB,GAAG,EAAE,MAAM,SAAS,CAAC;AAE9D,oFAAoF;AACpF,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CAAC;AAE5C,MAAM,YAAY,GAAG,UAAU,CAAC;AAwBhC,IAAI,MAAM,GAAe,EAAE,WAAW,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;AAElF,MAAM,UAAU,aAAa,CAAC,OAA4B;IACxD,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC;IACnC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAwB,EACxB,SAAS,GAAwB,EAAE;IAEnC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;IAC3D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,EAAE;YAAE,SAAS;QAChF,IAAI,eAAe,CAAC,SAAS,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC3E,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAClD,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,cAAc,CAAC,GAAQ,EAAE,IAAc;IACpD,GAA0C,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IACjE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAQ;IACjC,OAAO,SAAS,CAAC,GAAG,EAAE,YAAY,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC;AAC5D,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,eAAe;IAC7B,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC;AAC9F,CAAC;AAED,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,OAAO,UAAU,EAAE,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,uFAAuF;QACvF,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,gGAAgG;AAChG,SAAS,SAAS,CAAC,GAAQ,EAAE,KAAa;IACxC,MAAM,KAAK,GAAI,GAA0C,CAAC,KAAK,CAAC,CAAC;IACjE,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC"}

package/src/cron.d.ts

@@ -1,60 +0,0 @@
-/**
- * A real cron parser and occurrence calculator. Timezone-aware through `fromZoned`, so
- * `0 3 * * *` in `Europe/Berlin` fires at 03:00 local on both sides of a DST change
- * instead of drifting to 02:00 or 04:00 for half the year.
- */
-import { type Instant } from './instant';
-import { type TimeZone } from './zones';
-export interface CronExpression {
-    /** The normalized source text. */
-    source: string;
-    seconds: readonly number[];
-    minutes: readonly number[];
-    hours: readonly number[];
-    daysOfMonth: readonly number[];
-    months: readonly number[];
-    /** ISO weekdays, 1 = Monday … 7 = Sunday (cron's 0 and 7 both mean Sunday). */
-    daysOfWeek: readonly number[];
-    /** Vixie semantics: when both day fields are restricted, either one matching is a hit. */
-    dayOfMonthRestricted: boolean;
-    dayOfWeekRestricted: boolean;
-}
-/** Parse 5 fields (`m h dom mon dow`) or 6 with a leading seconds field. */
-export declare function parseCron(expression: string): CronExpression;
-export declare function isValidCron(expression: string): boolean;
-/** True when `at` matches the expression in `zone`, to the second. */
-export declare function matchesCron(expression: string | CronExpression, at: Instant, zone: TimeZone): boolean;
-/**
- * The next instant strictly after `after` that matches, computed on the zone's wall clock
- * and converted with `fromZoned({ gap: 'next', overlap: 'first' })`:
- *  - spring forward: a 02:30 daily job runs once, at the first existing local time after
- *    the gap, instead of being silently skipped;
- *  - fall back: a repeated local time runs once, on its first occurrence.
- */
-export declare function nextCronOccurrence(expression: string | CronExpression, zone: TimeZone, after: Instant): Instant;
-/** The next `count` occurrences, each strictly after the previous one. */
-export declare function nextCronOccurrences(expression: string | CronExpression, zone: TimeZone, after: Instant, count: number): Instant[];
-export interface CronPhrases {
-    everyMinute: string;
-    everyNMinutes: string;
-    everyHour: string;
-    everyNHours: string;
-    at: string;
-    onDaysOfMonth: string;
-    onWeekdays: string;
-    inMonths: string;
-    everyDay: string;
-}
-/** English defaults; the admin dashboard passes `t('time.cron.*')` instead. */
-export declare const DEFAULT_CRON_PHRASES: CronPhrases;
-/**
- * `describeCron('0 3 * * MON-FRI', 'en')` → `at 03:00 on Monday–Friday`.
- * Month and weekday names come from `Intl`; the connective phrases are injected so this
- * package never hardcodes a user-facing English string.
- */
-export declare function describeCron(expression: string | CronExpression, locale: string, phrases?: Partial<CronPhrases>): string;
-/** Exported for the scheduler's leader loop: has this expression fired since `since`? */
-export declare function firedSince(expression: string | CronExpression, zone: TimeZone, since: Instant, until: Instant): boolean;
-/** Epoch-ms helper used by the jobs package when it only has a number. */
-export declare function nextCronOccurrenceMs(expression: string | CronExpression, zone: TimeZone, afterMs: number): number;
-//# sourceMappingURL=cron.d.ts.map

package/src/cron.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["cron.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAEtD,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,+EAA+E;IAC/E,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,0FAA0F;IAC1F,oBAAoB,EAAE,OAAO,CAAC;IAC9B,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AA4BD,4EAA4E;AAC5E,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAkC5D;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAOvD;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,GAAG,cAAc,EACnC,EAAE,EAAE,OAAO,EACX,IAAI,EAAE,QAAQ,GACb,OAAO,CAUT;AAKD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,GAAG,cAAc,EACnC,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,OAAO,GACb,OAAO,CAkET;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,GAAG,cAAc,EACnC,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,EAAE,CASX;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,+EAA+E;AAC/E,eAAO,MAAM,oBAAoB,EAAE,WAUlC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,GAAG,cAAc,EACnC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,OAAO,CAAC,WAAW,CAAM,GACjC,MAAM,CAuCR;AAyLD,yFAAyF;AACzF,wBAAgB,UAAU,CACxB,UAAU,EAAE,MAAM,GAAG,cAAc,EACnC,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,OAAO,GACb,OAAO,CAIT;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,GAAG,cAAc,EACnC,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,MAAM,GACd,MAAM,CAER"}