@intech-software/chronera 0.1.0

package/dist/public-types.d.ts

@@ -0,0 +1,209 @@
+import type { DayOfYearFields } from "./core/day-of-year.js";
+import type { FiscalFields, FiscalOptions, QuarterNumber } from "./core/fiscal.js";
+import type { ChroneraErrorCode } from "./errors/error-codes.js";
+import type { PresetName } from "./format/presets/types.js";
+import type { Rfc2822Options } from "./format/rfc2822.js";
+export type { ChroneraErrorCode, DayOfYearFields, FiscalFields, FiscalOptions, PresetName, QuarterNumber, Rfc2822Options, };
+export type BuiltInCalendarId = "iso8601" | "gregory" | "buddhist" | "islamic" | "islamic-civil" | "islamic-tbla" | "islamic-umalqura" | "persian" | "hebrew" | "japanese" | "roc" | "indian" | "coptic" | "ethiopic" | "chinese" | "dangi";
+type ExtensibleIdentifier = string & Record<never, never>;
+export type CalendarId = BuiltInCalendarId | ExtensibleIdentifier;
+export type LocaleId = string;
+export type TimeZoneId = string;
+export type NumberingSystemId = string;
+export type EraId = string;
+export type MonthCode = `M${string}`;
+export interface Instant {
+    readonly kind: "instant";
+    readonly epochMilliseconds: number;
+}
+export interface LocalDate {
+    readonly kind: "local-date";
+    readonly year: number;
+    readonly month: number;
+    readonly day: number;
+}
+export interface LocalTime {
+    readonly kind: "local-time";
+    readonly hour: number;
+    readonly minute: number;
+    readonly second: number;
+    readonly millisecond: number;
+}
+export interface LocalDateTime {
+    readonly kind: "local-date-time";
+    readonly date: LocalDate;
+    readonly time: LocalTime;
+}
+export interface CalendarDate {
+    readonly kind: "calendar-date";
+    readonly calendar: CalendarId;
+    readonly era?: EraId;
+    readonly eraYear?: number;
+    readonly year: number;
+    readonly monthCode: MonthCode;
+    readonly month?: number;
+    readonly day: number;
+}
+export interface ZonedDateTime {
+    readonly kind: "zoned-date-time";
+    readonly instant: Instant;
+    readonly timeZone: TimeZoneId;
+    readonly calendar: CalendarId;
+}
+export type FormatDateInput = LocalDate | CalendarDate | Instant | Date;
+export interface Duration {
+    readonly years?: number;
+    readonly months?: number;
+    readonly weeks?: number;
+    readonly days?: number;
+    readonly hours?: number;
+    readonly minutes?: number;
+    readonly seconds?: number;
+    readonly milliseconds?: number;
+}
+export interface DateRange<TDate> {
+    readonly start: TDate;
+    readonly end: TDate;
+    readonly startInclusive: boolean;
+    readonly endInclusive: boolean;
+}
+export interface CalendarConversionMetadata {
+    readonly requestedCalendar: CalendarId;
+    readonly resolvedCalendar: CalendarId;
+    readonly engine: "chronera" | "runtime-intl" | "custom";
+    readonly algorithm: string;
+    readonly deterministic: boolean;
+    readonly dataVersion?: string;
+    readonly validFrom?: LocalDate;
+    readonly validTo?: LocalDate;
+}
+export interface CalendarConversionResult {
+    readonly value: CalendarDate;
+    readonly metadata: CalendarConversionMetadata;
+}
+export interface ChroneraIssue {
+    readonly code: ChroneraErrorCode;
+    readonly message: string;
+    readonly path?: readonly (string | number)[];
+}
+export type SafeParseResult<T> = {
+    readonly success: true;
+    readonly value: T;
+} | {
+    readonly success: false;
+    readonly error: ChroneraIssue;
+};
+export type Comparison = -1 | 0 | 1;
+export interface CalendarPlugin {
+    readonly id: CalendarId;
+    readonly algorithm: string;
+    readonly deterministic: boolean;
+    readonly validFrom: LocalDate;
+    readonly validTo: LocalDate;
+    toIsoDate(date: CalendarDate): LocalDate;
+    fromIsoDate(date: LocalDate): CalendarDate;
+    validate(date: CalendarDate): readonly ChroneraIssue[];
+}
+export interface ChroneraConfig {
+    readonly locale?: LocaleId;
+    readonly calendar?: CalendarId;
+    readonly numberingSystem?: NumberingSystemId;
+    readonly timeZone?: TimeZoneId;
+    readonly calendars?: readonly CalendarPlugin[];
+    readonly formatterCacheSize?: number;
+}
+export interface ResolvedChroneraOptions {
+    readonly locale: LocaleId;
+    readonly calendar: CalendarId;
+    readonly numberingSystem?: NumberingSystemId;
+    readonly timeZone: TimeZoneId;
+    readonly formatterCacheSize: number;
+}
+export interface FormatDateBaseOptions {
+    readonly locale?: LocaleId;
+    readonly calendar?: CalendarId;
+    readonly numberingSystem?: NumberingSystemId;
+    readonly timeZone?: TimeZoneId;
+    readonly fallback?: "error";
+}
+export type FormatDateOptions = FormatDateBaseOptions & ({
+    readonly style?: "numeric" | "short" | "medium" | "long" | "full";
+    readonly preset?: never;
+} | {
+    readonly style?: never;
+    readonly preset: PresetName;
+});
+export interface FormatTimeOptions {
+    readonly locale?: LocaleId;
+    readonly numberingSystem?: NumberingSystemId;
+    readonly timeZone?: TimeZoneId;
+    readonly style?: "short" | "medium" | "long" | "full";
+    readonly hourCycle?: "h11" | "h12" | "h23" | "h24";
+}
+export interface FormatDateTimeOptions extends FormatDateBaseOptions {
+    readonly dateStyle?: "short" | "medium" | "long" | "full";
+    readonly timeStyle?: "short" | "medium" | "long" | "full";
+    readonly hourCycle?: "h11" | "h12" | "h23" | "h24";
+}
+export type FormatDateRangeOptions = FormatDateOptions & {
+    readonly collapse?: "auto" | "none";
+};
+export interface FormatRelativeOptions {
+    readonly relativeTo: Instant | LocalDate;
+    readonly locale?: LocaleId;
+    readonly numeric?: "always" | "auto";
+    readonly unit?: "second" | "minute" | "hour" | "day" | "week" | "month" | "year";
+    readonly timeZone?: TimeZoneId;
+}
+export interface PatternFormatOptions {
+    readonly locale?: LocaleId;
+    readonly calendar?: CalendarId;
+    readonly numberingSystem?: NumberingSystemId;
+    readonly timeZone?: TimeZoneId;
+}
+export interface ParseLocalDateOptions {
+    readonly pattern?: string;
+    readonly locale?: LocaleId;
+    readonly calendar?: "gregory" | "iso8601";
+    readonly numberingSystem?: NumberingSystemId;
+}
+export interface ParseInstantOptions {
+    readonly excessFractionalSeconds?: "reject" | "truncate" | "round";
+}
+export interface ConvertCalendarOptions {
+    readonly fallback?: "error";
+}
+export interface CalendarCapabilities {
+    readonly calendar: CalendarId;
+    readonly maturity: "stable" | "experimental" | "runtime-dependent" | "planned" | "unsupported";
+    readonly canFormat: boolean;
+    readonly canParse: boolean;
+    readonly canConvertFromAbsoluteDate: boolean;
+    readonly canConvertToAbsoluteDate: boolean;
+    readonly canValidate: boolean;
+    readonly canAddYears: boolean;
+    readonly canAddMonths: boolean;
+    readonly deterministic: boolean;
+    readonly algorithm?: string;
+    readonly dataVersion?: string;
+    readonly validFrom?: LocalDate;
+    readonly validTo?: LocalDate;
+}
+export interface RuntimeCapabilities {
+    readonly hasDateTimeFormat: boolean;
+    readonly hasFormatToParts: boolean;
+    readonly hasFormatRange: boolean;
+    readonly hasRelativeTimeFormat: boolean;
+    readonly hasLocale: boolean;
+    readonly hasSupportedValuesOf: boolean;
+    readonly hasTemporal: boolean;
+    readonly calendars: Readonly<Record<string, boolean>>;
+    readonly timeZones: Readonly<Record<string, boolean>>;
+}
+export interface ChroneraInstance {
+    formatDate(input: FormatDateInput, options?: Readonly<FormatDateOptions>): string;
+    parseLocalDate(input: string, options?: Readonly<ParseLocalDateOptions>): LocalDate;
+    convertCalendarDate(source: CalendarDate, targetCalendar: CalendarId, options?: Readonly<ConvertCalendarOptions>): CalendarConversionResult;
+    resolvedOptions(): ResolvedChroneraOptions;
+}
+export type { IsoWeekFields } from "./core/iso-week.js";

package/dist/public-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=public-types.js.map

package/dist/public-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-types.js","sourceRoot":"","sources":["../src/public-types.ts"],"names":[],"mappings":"","sourcesContent":["import type { DayOfYearFields } from \"./core/day-of-year.js\";\nimport type {\n  FiscalFields,\n  FiscalOptions,\n  QuarterNumber,\n} from \"./core/fiscal.js\";\nimport type { ChroneraErrorCode } from \"./errors/error-codes.js\";\nimport type { PresetName } from \"./format/presets/types.js\";\nimport type { Rfc2822Options } from \"./format/rfc2822.js\";\n\nexport type {\n  ChroneraErrorCode,\n  DayOfYearFields,\n  FiscalFields,\n  FiscalOptions,\n  PresetName,\n  QuarterNumber,\n  Rfc2822Options,\n};\n\nexport type BuiltInCalendarId =\n  | \"iso8601\"\n  | \"gregory\"\n  | \"buddhist\"\n  | \"islamic\"\n  | \"islamic-civil\"\n  | \"islamic-tbla\"\n  | \"islamic-umalqura\"\n  | \"persian\"\n  | \"hebrew\"\n  | \"japanese\"\n  | \"roc\"\n  | \"indian\"\n  | \"coptic\"\n  | \"ethiopic\"\n  | \"chinese\"\n  | \"dangi\";\n\ntype ExtensibleIdentifier = string & Record<never, never>;\n\nexport type CalendarId = BuiltInCalendarId | ExtensibleIdentifier;\n\nexport type LocaleId = string;\nexport type TimeZoneId = string;\nexport type NumberingSystemId = string;\nexport type EraId = string;\nexport type MonthCode = `M${string}`;\n\nexport interface Instant {\n  readonly kind: \"instant\";\n  readonly epochMilliseconds: number;\n}\n\nexport interface LocalDate {\n  readonly kind: \"local-date\";\n  readonly year: number;\n  readonly month: number;\n  readonly day: number;\n}\n\nexport interface LocalTime {\n  readonly kind: \"local-time\";\n  readonly hour: number;\n  readonly minute: number;\n  readonly second: number;\n  readonly millisecond: number;\n}\n\nexport interface LocalDateTime {\n  readonly kind: \"local-date-time\";\n  readonly date: LocalDate;\n  readonly time: LocalTime;\n}\n\nexport interface CalendarDate {\n  readonly kind: \"calendar-date\";\n  readonly calendar: CalendarId;\n  readonly era?: EraId;\n  readonly eraYear?: number;\n  readonly year: number;\n  readonly monthCode: MonthCode;\n  readonly month?: number;\n  readonly day: number;\n}\n\nexport interface ZonedDateTime {\n  readonly kind: \"zoned-date-time\";\n  readonly instant: Instant;\n  readonly timeZone: TimeZoneId;\n  readonly calendar: CalendarId;\n}\n\nexport type FormatDateInput = LocalDate | CalendarDate | Instant | Date;\n\nexport interface Duration {\n  readonly years?: number;\n  readonly months?: number;\n  readonly weeks?: number;\n  readonly days?: number;\n  readonly hours?: number;\n  readonly minutes?: number;\n  readonly seconds?: number;\n  readonly milliseconds?: number;\n}\n\nexport interface DateRange<TDate> {\n  readonly start: TDate;\n  readonly end: TDate;\n  readonly startInclusive: boolean;\n  readonly endInclusive: boolean;\n}\n\nexport interface CalendarConversionMetadata {\n  readonly requestedCalendar: CalendarId;\n  readonly resolvedCalendar: CalendarId;\n  readonly engine: \"chronera\" | \"runtime-intl\" | \"custom\";\n  readonly algorithm: string;\n  readonly deterministic: boolean;\n  readonly dataVersion?: string;\n  readonly validFrom?: LocalDate;\n  readonly validTo?: LocalDate;\n}\n\nexport interface CalendarConversionResult {\n  readonly value: CalendarDate;\n  readonly metadata: CalendarConversionMetadata;\n}\n\nexport interface ChroneraIssue {\n  readonly code: ChroneraErrorCode;\n  readonly message: string;\n  readonly path?: readonly (string | number)[];\n}\n\nexport type SafeParseResult<T> =\n  | {\n      readonly success: true;\n      readonly value: T;\n    }\n  | {\n      readonly success: false;\n      readonly error: ChroneraIssue;\n    };\n\nexport type Comparison = -1 | 0 | 1;\n\nexport interface CalendarPlugin {\n  readonly id: CalendarId;\n  readonly algorithm: string;\n  readonly deterministic: boolean;\n  readonly validFrom: LocalDate;\n  readonly validTo: LocalDate;\n  toIsoDate(date: CalendarDate): LocalDate;\n  fromIsoDate(date: LocalDate): CalendarDate;\n  validate(date: CalendarDate): readonly ChroneraIssue[];\n}\n\nexport interface ChroneraConfig {\n  readonly locale?: LocaleId;\n  readonly calendar?: CalendarId;\n  readonly numberingSystem?: NumberingSystemId;\n  readonly timeZone?: TimeZoneId;\n  readonly calendars?: readonly CalendarPlugin[];\n  readonly formatterCacheSize?: number;\n}\n\nexport interface ResolvedChroneraOptions {\n  readonly locale: LocaleId;\n  readonly calendar: CalendarId;\n  readonly numberingSystem?: NumberingSystemId;\n  readonly timeZone: TimeZoneId;\n  readonly formatterCacheSize: number;\n}\n\nexport interface FormatDateBaseOptions {\n  readonly locale?: LocaleId;\n  readonly calendar?: CalendarId;\n  readonly numberingSystem?: NumberingSystemId;\n  readonly timeZone?: TimeZoneId;\n  readonly fallback?: \"error\";\n}\n\nexport type FormatDateOptions = FormatDateBaseOptions &\n  (\n    | {\n        readonly style?: \"numeric\" | \"short\" | \"medium\" | \"long\" | \"full\";\n        readonly preset?: never;\n      }\n    | {\n        readonly style?: never;\n        readonly preset: PresetName;\n      }\n  );\n\nexport interface FormatTimeOptions {\n  readonly locale?: LocaleId;\n  readonly numberingSystem?: NumberingSystemId;\n  readonly timeZone?: TimeZoneId;\n  readonly style?: \"short\" | \"medium\" | \"long\" | \"full\";\n  readonly hourCycle?: \"h11\" | \"h12\" | \"h23\" | \"h24\";\n}\n\nexport interface FormatDateTimeOptions extends FormatDateBaseOptions {\n  readonly dateStyle?: \"short\" | \"medium\" | \"long\" | \"full\";\n  readonly timeStyle?: \"short\" | \"medium\" | \"long\" | \"full\";\n  readonly hourCycle?: \"h11\" | \"h12\" | \"h23\" | \"h24\";\n}\n\nexport type FormatDateRangeOptions = FormatDateOptions & {\n  readonly collapse?: \"auto\" | \"none\";\n};\n\nexport interface FormatRelativeOptions {\n  readonly relativeTo: Instant | LocalDate;\n  readonly locale?: LocaleId;\n  readonly numeric?: \"always\" | \"auto\";\n  readonly unit?:\n    \"second\" | \"minute\" | \"hour\" | \"day\" | \"week\" | \"month\" | \"year\";\n  readonly timeZone?: TimeZoneId;\n}\n\nexport interface PatternFormatOptions {\n  readonly locale?: LocaleId;\n  readonly calendar?: CalendarId;\n  readonly numberingSystem?: NumberingSystemId;\n  readonly timeZone?: TimeZoneId;\n}\n\nexport interface ParseLocalDateOptions {\n  readonly pattern?: string;\n  readonly locale?: LocaleId;\n  readonly calendar?: \"gregory\" | \"iso8601\";\n  readonly numberingSystem?: NumberingSystemId;\n}\n\nexport interface ParseInstantOptions {\n  readonly excessFractionalSeconds?: \"reject\" | \"truncate\" | \"round\";\n}\n\nexport interface ConvertCalendarOptions {\n  readonly fallback?: \"error\";\n}\n\nexport interface CalendarCapabilities {\n  readonly calendar: CalendarId;\n  readonly maturity:\n    \"stable\" | \"experimental\" | \"runtime-dependent\" | \"planned\" | \"unsupported\";\n  readonly canFormat: boolean;\n  readonly canParse: boolean;\n  readonly canConvertFromAbsoluteDate: boolean;\n  readonly canConvertToAbsoluteDate: boolean;\n  readonly canValidate: boolean;\n  readonly canAddYears: boolean;\n  readonly canAddMonths: boolean;\n  readonly deterministic: boolean;\n  readonly algorithm?: string;\n  readonly dataVersion?: string;\n  readonly validFrom?: LocalDate;\n  readonly validTo?: LocalDate;\n}\n\nexport interface RuntimeCapabilities {\n  readonly hasDateTimeFormat: boolean;\n  readonly hasFormatToParts: boolean;\n  readonly hasFormatRange: boolean;\n  readonly hasRelativeTimeFormat: boolean;\n  readonly hasLocale: boolean;\n  readonly hasSupportedValuesOf: boolean;\n  readonly hasTemporal: boolean;\n  readonly calendars: Readonly<Record<string, boolean>>;\n  readonly timeZones: Readonly<Record<string, boolean>>;\n}\n\nexport interface ChroneraInstance {\n  formatDate(\n    input: FormatDateInput,\n    options?: Readonly<FormatDateOptions>,\n  ): string;\n  parseLocalDate(\n    input: string,\n    options?: Readonly<ParseLocalDateOptions>,\n  ): LocalDate;\n  convertCalendarDate(\n    source: CalendarDate,\n    targetCalendar: CalendarId,\n    options?: Readonly<ConvertCalendarOptions>,\n  ): CalendarConversionResult;\n  resolvedOptions(): ResolvedChroneraOptions;\n}\n\nexport type { IsoWeekFields } from \"./core/iso-week.js\";\n"]}

package/dist/runtime/bounded-lru.d.ts

@@ -0,0 +1,11 @@
+export declare class BoundedLRU<T> {
+    private readonly cache;
+    private readonly maxEntries;
+    constructor(maxEntries?: number);
+    get(key: string): T | undefined;
+    set(key: string, value: T): void;
+    has(key: string): boolean;
+    clear(): void;
+    get size(): number;
+    get capacity(): number;
+}

package/dist/runtime/bounded-lru.js

@@ -0,0 +1,42 @@
+export class BoundedLRU {
+    cache = new Map();
+    maxEntries;
+    constructor(maxEntries = 64) {
+        this.maxEntries = Math.max(1, maxEntries);
+    }
+    get(key) {
+        const value = this.cache.get(key);
+        if (value !== undefined) {
+            // Refresh key order (MRU at end)
+            this.cache.delete(key);
+            this.cache.set(key, value);
+        }
+        return value;
+    }
+    set(key, value) {
+        if (this.cache.has(key)) {
+            this.cache.delete(key);
+        }
+        else if (this.cache.size >= this.maxEntries) {
+            // Evict oldest entry (first key in map)
+            const oldestKey = this.cache.keys().next().value;
+            if (oldestKey !== undefined) {
+                this.cache.delete(oldestKey);
+            }
+        }
+        this.cache.set(key, value);
+    }
+    has(key) {
+        return this.cache.has(key);
+    }
+    clear() {
+        this.cache.clear();
+    }
+    get size() {
+        return this.cache.size;
+    }
+    get capacity() {
+        return this.maxEntries;
+    }
+}
+//# sourceMappingURL=bounded-lru.js.map

package/dist/runtime/bounded-lru.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded-lru.js","sourceRoot":"","sources":["../../src/runtime/bounded-lru.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAU;IACJ,KAAK,GAAG,IAAI,GAAG,EAAa,CAAC;IAC7B,UAAU,CAAS;IAEpC,YAAY,aAAqB,EAAE;QACjC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,GAAG,CAAC,GAAW;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,iCAAiC;YACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAQ;QACvB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAC9C,wCAAwC;YACxC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YACjD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF","sourcesContent":["export class BoundedLRU<T> {\n  private readonly cache = new Map<string, T>();\n  private readonly maxEntries: number;\n\n  constructor(maxEntries: number = 64) {\n    this.maxEntries = Math.max(1, maxEntries);\n  }\n\n  get(key: string): T | undefined {\n    const value = this.cache.get(key);\n    if (value !== undefined) {\n      // Refresh key order (MRU at end)\n      this.cache.delete(key);\n      this.cache.set(key, value);\n    }\n    return value;\n  }\n\n  set(key: string, value: T): void {\n    if (this.cache.has(key)) {\n      this.cache.delete(key);\n    } else if (this.cache.size >= this.maxEntries) {\n      // Evict oldest entry (first key in map)\n      const oldestKey = this.cache.keys().next().value;\n      if (oldestKey !== undefined) {\n        this.cache.delete(oldestKey);\n      }\n    }\n    this.cache.set(key, value);\n  }\n\n  has(key: string): boolean {\n    return this.cache.has(key);\n  }\n\n  clear(): void {\n    this.cache.clear();\n  }\n\n  get size(): number {\n    return this.cache.size;\n  }\n\n  get capacity(): number {\n    return this.maxEntries;\n  }\n}\n"]}

package/dist/runtime/capabilities.d.ts

@@ -0,0 +1,5 @@
+import type { CalendarId, RuntimeCapabilities, TimeZoneId } from "../public-types.js";
+export declare function getRuntimeCapabilities(requests?: Readonly<{
+    calendars?: readonly CalendarId[];
+    timeZones?: readonly TimeZoneId[];
+}>): RuntimeCapabilities;

package/dist/runtime/capabilities.js

@@ -0,0 +1,61 @@
+export function getRuntimeCapabilities(requests) {
+    const hasIntl = typeof Intl !== "undefined";
+    const hasDateTimeFormat = hasIntl && typeof Intl.DateTimeFormat === "function";
+    const hasFormatToParts = hasDateTimeFormat &&
+        typeof Intl.DateTimeFormat.prototype.formatToParts === "function";
+    const hasFormatRange = hasDateTimeFormat &&
+        typeof Intl.DateTimeFormat.prototype
+            .formatRange === "function";
+    const hasRelativeTimeFormat = hasIntl && typeof Intl.RelativeTimeFormat === "function";
+    const hasLocale = hasIntl && typeof Intl.Locale === "function";
+    const hasSupportedValuesOf = hasIntl &&
+        typeof Intl
+            .supportedValuesOf === "function";
+    const hasTemporal = typeof globalThis.Temporal !==
+        "undefined";
+    const calendars = {};
+    if (requests?.calendars) {
+        for (const cal of requests.calendars) {
+            if (!hasDateTimeFormat) {
+                calendars[cal] = false;
+                continue;
+            }
+            try {
+                const dtf = new Intl.DateTimeFormat("en-US", { calendar: cal });
+                const resolved = dtf.resolvedOptions().calendar;
+                calendars[cal] = resolved === cal;
+            }
+            catch {
+                calendars[cal] = false;
+            }
+        }
+    }
+    const timeZones = {};
+    if (requests?.timeZones) {
+        for (const tz of requests.timeZones) {
+            if (!hasDateTimeFormat) {
+                timeZones[tz] = false;
+                continue;
+            }
+            try {
+                new Intl.DateTimeFormat("en-US", { timeZone: tz });
+                timeZones[tz] = true;
+            }
+            catch {
+                timeZones[tz] = false;
+            }
+        }
+    }
+    return {
+        hasDateTimeFormat,
+        hasFormatToParts,
+        hasFormatRange,
+        hasRelativeTimeFormat,
+        hasLocale,
+        hasSupportedValuesOf,
+        hasTemporal,
+        calendars: Object.freeze(calendars),
+        timeZones: Object.freeze(timeZones),
+    };
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/runtime/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/runtime/capabilities.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,sBAAsB,CACpC,QAGE;IAEF,MAAM,OAAO,GAAG,OAAO,IAAI,KAAK,WAAW,CAAC;IAC5C,MAAM,iBAAiB,GACrB,OAAO,IAAI,OAAO,IAAI,CAAC,cAAc,KAAK,UAAU,CAAC;IACvD,MAAM,gBAAgB,GACpB,iBAAiB;QACjB,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,aAAa,KAAK,UAAU,CAAC;IACpE,MAAM,cAAc,GAClB,iBAAiB;QACjB,OAAQ,IAAI,CAAC,cAAc,CAAC,SAAuC;aAChE,WAAW,KAAK,UAAU,CAAC;IAChC,MAAM,qBAAqB,GACzB,OAAO,IAAI,OAAO,IAAI,CAAC,kBAAkB,KAAK,UAAU,CAAC;IAC3D,MAAM,SAAS,GAAG,OAAO,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC;IAC/D,MAAM,oBAAoB,GACxB,OAAO;QACP,OAAQ,IAAmD;aACxD,iBAAiB,KAAK,UAAU,CAAC;IACtC,MAAM,WAAW,GACf,OAAQ,UAAgD,CAAC,QAAQ;QACjE,WAAW,CAAC;IAEd,MAAM,SAAS,GAA4B,EAAE,CAAC;IAC9C,IAAI,QAAQ,EAAE,SAAS,EAAE,CAAC;QACxB,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YACrC,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBACvB,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBACvB,SAAS;YACX,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;gBAChE,MAAM,QAAQ,GAAG,GAAG,CAAC,eAAe,EAAE,CAAC,QAAQ,CAAC;gBAChD,SAAS,CAAC,GAAG,CAAC,GAAG,QAAQ,KAAK,GAAG,CAAC;YACpC,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAA4B,EAAE,CAAC;IAC9C,IAAI,QAAQ,EAAE,SAAS,EAAE,CAAC;QACxB,KAAK,MAAM,EAAE,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBACvB,SAAS,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC;gBACtB,SAAS;YACX,CAAC;YACD,IAAI,CAAC;gBACH,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;gBACnD,SAAS,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC;YACxB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,iBAAiB;QACjB,gBAAgB;QAChB,cAAc;QACd,qBAAqB;QACrB,SAAS;QACT,oBAAoB;QACpB,WAAW;QACX,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;QACnC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;KACpC,CAAC;AACJ,CAAC","sourcesContent":["import type {\n  CalendarId,\n  RuntimeCapabilities,\n  TimeZoneId,\n} from \"../public-types.js\";\n\nexport function getRuntimeCapabilities(\n  requests?: Readonly<{\n    calendars?: readonly CalendarId[];\n    timeZones?: readonly TimeZoneId[];\n  }>,\n): RuntimeCapabilities {\n  const hasIntl = typeof Intl !== \"undefined\";\n  const hasDateTimeFormat =\n    hasIntl && typeof Intl.DateTimeFormat === \"function\";\n  const hasFormatToParts =\n    hasDateTimeFormat &&\n    typeof Intl.DateTimeFormat.prototype.formatToParts === \"function\";\n  const hasFormatRange =\n    hasDateTimeFormat &&\n    typeof (Intl.DateTimeFormat.prototype as { formatRange?: unknown })\n      .formatRange === \"function\";\n  const hasRelativeTimeFormat =\n    hasIntl && typeof Intl.RelativeTimeFormat === \"function\";\n  const hasLocale = hasIntl && typeof Intl.Locale === \"function\";\n  const hasSupportedValuesOf =\n    hasIntl &&\n    typeof (Intl as unknown as { supportedValuesOf?: unknown })\n      .supportedValuesOf === \"function\";\n  const hasTemporal =\n    typeof (globalThis as unknown as { Temporal?: unknown }).Temporal !==\n    \"undefined\";\n\n  const calendars: Record<string, boolean> = {};\n  if (requests?.calendars) {\n    for (const cal of requests.calendars) {\n      if (!hasDateTimeFormat) {\n        calendars[cal] = false;\n        continue;\n      }\n      try {\n        const dtf = new Intl.DateTimeFormat(\"en-US\", { calendar: cal });\n        const resolved = dtf.resolvedOptions().calendar;\n        calendars[cal] = resolved === cal;\n      } catch {\n        calendars[cal] = false;\n      }\n    }\n  }\n\n  const timeZones: Record<string, boolean> = {};\n  if (requests?.timeZones) {\n    for (const tz of requests.timeZones) {\n      if (!hasDateTimeFormat) {\n        timeZones[tz] = false;\n        continue;\n      }\n      try {\n        new Intl.DateTimeFormat(\"en-US\", { timeZone: tz });\n        timeZones[tz] = true;\n      } catch {\n        timeZones[tz] = false;\n      }\n    }\n  }\n\n  return {\n    hasDateTimeFormat,\n    hasFormatToParts,\n    hasFormatRange,\n    hasRelativeTimeFormat,\n    hasLocale,\n    hasSupportedValuesOf,\n    hasTemporal,\n    calendars: Object.freeze(calendars),\n    timeZones: Object.freeze(timeZones),\n  };\n}\n"]}

package/dist/runtime/intl-date-time.d.ts

@@ -0,0 +1,11 @@
+export interface CachedDateTimeFormatOptions extends Intl.DateTimeFormatOptions {
+    locale?: string;
+}
+export declare class IntlDateTimeService {
+    private readonly cache;
+    constructor(cacheSize?: number);
+    getFormatter(locale: string, options?: Intl.DateTimeFormatOptions): Intl.DateTimeFormat;
+    private createKey;
+    clearCache(): void;
+    get cacheSize(): number;
+}

package/dist/runtime/intl-date-time.js

@@ -0,0 +1,38 @@
+import { BoundedLRU } from "./bounded-lru.js";
+import { ChroneraError } from "../errors/errors.js";
+export class IntlDateTimeService {
+    cache;
+    constructor(cacheSize = 64) {
+        this.cache = new BoundedLRU(cacheSize);
+    }
+    getFormatter(locale, options = {}) {
+        const key = this.createKey(locale, options);
+        const cached = this.cache.get(key);
+        if (cached) {
+            return cached;
+        }
+        try {
+            const formatter = new Intl.DateTimeFormat(locale, options);
+            this.cache.set(key, formatter);
+            return formatter;
+        }
+        catch (err) {
+            throw new ChroneraError("CHRONERA_INCOMPATIBLE_OPTION", `Failed to create DateTimeFormat for locale "${locale}": ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+        }
+    }
+    createKey(locale, options) {
+        const keys = Object.keys(options).sort();
+        let optsStr = "";
+        for (const k of keys) {
+            optsStr += `${k}:${String(options[k])};`;
+        }
+        return `${locale}|${optsStr}`;
+    }
+    clearCache() {
+        this.cache.clear();
+    }
+    get cacheSize() {
+        return this.cache.size;
+    }
+}
+//# sourceMappingURL=intl-date-time.js.map

package/dist/runtime/intl-date-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intl-date-time.js","sourceRoot":"","sources":["../../src/runtime/intl-date-time.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOpD,MAAM,OAAO,mBAAmB;IACb,KAAK,CAAkC;IAExD,YAAY,YAAoB,EAAE;QAChC,IAAI,CAAC,KAAK,GAAG,IAAI,UAAU,CAAsB,SAAS,CAAC,CAAC;IAC9D,CAAC;IAED,YAAY,CACV,MAAc,EACd,UAAsC,EAAE;QAExC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC3D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC/B,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,aAAa,CACrB,8BAA8B,EAC9B,+CAA+C,MAAM,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAC7G,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,SAAS,CACf,MAAc,EACd,OAAmC;QAEnC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACzC,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,OAAO,IAAI,GAAG,CAAC,IAAI,MAAM,CAAE,OAAmC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACxE,CAAC;QACD,OAAO,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC;IAChC,CAAC;IAED,UAAU;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF","sourcesContent":["import { BoundedLRU } from \"./bounded-lru.js\";\nimport { ChroneraError } from \"../errors/errors.js\";\n\nexport interface CachedDateTimeFormatOptions\n  extends Intl.DateTimeFormatOptions {\n  locale?: string;\n}\n\nexport class IntlDateTimeService {\n  private readonly cache: BoundedLRU<Intl.DateTimeFormat>;\n\n  constructor(cacheSize: number = 64) {\n    this.cache = new BoundedLRU<Intl.DateTimeFormat>(cacheSize);\n  }\n\n  getFormatter(\n    locale: string,\n    options: Intl.DateTimeFormatOptions = {},\n  ): Intl.DateTimeFormat {\n    const key = this.createKey(locale, options);\n    const cached = this.cache.get(key);\n    if (cached) {\n      return cached;\n    }\n\n    try {\n      const formatter = new Intl.DateTimeFormat(locale, options);\n      this.cache.set(key, formatter);\n      return formatter;\n    } catch (err) {\n      throw new ChroneraError(\n        \"CHRONERA_INCOMPATIBLE_OPTION\",\n        `Failed to create DateTimeFormat for locale \"${locale}\": ${err instanceof Error ? err.message : String(err)}`,\n        { cause: err },\n      );\n    }\n  }\n\n  private createKey(\n    locale: string,\n    options: Intl.DateTimeFormatOptions,\n  ): string {\n    const keys = Object.keys(options).sort();\n    let optsStr = \"\";\n    for (const k of keys) {\n      optsStr += `${k}:${String((options as Record<string, unknown>)[k])};`;\n    }\n    return `${locale}|${optsStr}`;\n  }\n\n  clearCache(): void {\n    this.cache.clear();\n  }\n\n  get cacheSize(): number {\n    return this.cache.size;\n  }\n}\n"]}

package/dist/runtime/intl-number.d.ts

@@ -0,0 +1,7 @@
+export declare class IntlNumberService {
+    private readonly cache;
+    constructor(cacheSize?: number);
+    getFormatter(locale: string, options?: Intl.NumberFormatOptions): Intl.NumberFormat;
+    private createKey;
+    clearCache(): void;
+}

package/dist/runtime/intl-number.js

@@ -0,0 +1,35 @@
+import { BoundedLRU } from "./bounded-lru.js";
+import { ChroneraError } from "../errors/errors.js";
+export class IntlNumberService {
+    cache;
+    constructor(cacheSize = 64) {
+        this.cache = new BoundedLRU(cacheSize);
+    }
+    getFormatter(locale, options = {}) {
+        const key = this.createKey(locale, options);
+        const cached = this.cache.get(key);
+        if (cached) {
+            return cached;
+        }
+        try {
+            const formatter = new Intl.NumberFormat(locale, options);
+            this.cache.set(key, formatter);
+            return formatter;
+        }
+        catch (err) {
+            throw new ChroneraError("CHRONERA_INCOMPATIBLE_OPTION", `Failed to create NumberFormat for locale "${locale}": ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+        }
+    }
+    createKey(locale, options) {
+        const keys = Object.keys(options).sort();
+        let optsStr = "";
+        for (const k of keys) {
+            optsStr += `${k}:${String(options[k])};`;
+        }
+        return `${locale}|${optsStr}`;
+    }
+    clearCache() {
+        this.cache.clear();
+    }
+}
+//# sourceMappingURL=intl-number.js.map

package/dist/runtime/intl-number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intl-number.js","sourceRoot":"","sources":["../../src/runtime/intl-number.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,OAAO,iBAAiB;IACX,KAAK,CAAgC;IAEtD,YAAY,YAAoB,EAAE;QAChC,IAAI,CAAC,KAAK,GAAG,IAAI,UAAU,CAAoB,SAAS,CAAC,CAAC;IAC5D,CAAC;IAED,YAAY,CACV,MAAc,EACd,UAAoC,EAAE;QAEtC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACzD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC/B,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,aAAa,CACrB,8BAA8B,EAC9B,6CAA6C,MAAM,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAC3G,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,SAAS,CAAC,MAAc,EAAE,OAAiC;QACjE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACzC,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,OAAO,IAAI,GAAG,CAAC,IAAI,MAAM,CAAE,OAAmC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACxE,CAAC;QACD,OAAO,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC;IAChC,CAAC;IAED,UAAU;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF","sourcesContent":["import { BoundedLRU } from \"./bounded-lru.js\";\nimport { ChroneraError } from \"../errors/errors.js\";\n\nexport class IntlNumberService {\n  private readonly cache: BoundedLRU<Intl.NumberFormat>;\n\n  constructor(cacheSize: number = 64) {\n    this.cache = new BoundedLRU<Intl.NumberFormat>(cacheSize);\n  }\n\n  getFormatter(\n    locale: string,\n    options: Intl.NumberFormatOptions = {},\n  ): Intl.NumberFormat {\n    const key = this.createKey(locale, options);\n    const cached = this.cache.get(key);\n    if (cached) {\n      return cached;\n    }\n\n    try {\n      const formatter = new Intl.NumberFormat(locale, options);\n      this.cache.set(key, formatter);\n      return formatter;\n    } catch (err) {\n      throw new ChroneraError(\n        \"CHRONERA_INCOMPATIBLE_OPTION\",\n        `Failed to create NumberFormat for locale \"${locale}\": ${err instanceof Error ? err.message : String(err)}`,\n        { cause: err },\n      );\n    }\n  }\n\n  private createKey(locale: string, options: Intl.NumberFormatOptions): string {\n    const keys = Object.keys(options).sort();\n    let optsStr = \"\";\n    for (const k of keys) {\n      optsStr += `${k}:${String((options as Record<string, unknown>)[k])};`;\n    }\n    return `${locale}|${optsStr}`;\n  }\n\n  clearCache(): void {\n    this.cache.clear();\n  }\n}\n"]}

package/dist/runtime/intl-relative-time.d.ts

@@ -0,0 +1,7 @@
+export declare class IntlRelativeTimeService {
+    private readonly cache;
+    constructor(cacheSize?: number);
+    getFormatter(locale: string, options?: Intl.RelativeTimeFormatOptions): Intl.RelativeTimeFormat;
+    private createKey;
+    clearCache(): void;
+}

package/dist/runtime/intl-relative-time.js

@@ -0,0 +1,35 @@
+import { BoundedLRU } from "./bounded-lru.js";
+import { ChroneraError } from "../errors/errors.js";
+export class IntlRelativeTimeService {
+    cache;
+    constructor(cacheSize = 64) {
+        this.cache = new BoundedLRU(cacheSize);
+    }
+    getFormatter(locale, options = {}) {
+        const key = this.createKey(locale, options);
+        const cached = this.cache.get(key);
+        if (cached) {
+            return cached;
+        }
+        try {
+            const formatter = new Intl.RelativeTimeFormat(locale, options);
+            this.cache.set(key, formatter);
+            return formatter;
+        }
+        catch (err) {
+            throw new ChroneraError("CHRONERA_INCOMPATIBLE_OPTION", `Failed to create RelativeTimeFormat for locale "${locale}": ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+        }
+    }
+    createKey(locale, options) {
+        const keys = Object.keys(options).sort();
+        let optsStr = "";
+        for (const k of keys) {
+            optsStr += `${k}:${String(options[k])};`;
+        }
+        return `${locale}|${optsStr}`;
+    }
+    clearCache() {
+        this.cache.clear();
+    }
+}
+//# sourceMappingURL=intl-relative-time.js.map

package/dist/runtime/intl-relative-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intl-relative-time.js","sourceRoot":"","sources":["../../src/runtime/intl-relative-time.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,OAAO,uBAAuB;IACjB,KAAK,CAAsC;IAE5D,YAAY,YAAoB,EAAE;QAChC,IAAI,CAAC,KAAK,GAAG,IAAI,UAAU,CAA0B,SAAS,CAAC,CAAC;IAClE,CAAC;IAED,YAAY,CACV,MAAc,EACd,UAA0C,EAAE;QAE5C,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC/D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC/B,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,aAAa,CACrB,8BAA8B,EAC9B,mDAAmD,MAAM,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EACjH,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,SAAS,CACf,MAAc,EACd,OAAuC;QAEvC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACzC,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,OAAO,IAAI,GAAG,CAAC,IAAI,MAAM,CAAE,OAAmC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACxE,CAAC;QACD,OAAO,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC;IAChC,CAAC;IAED,UAAU;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF","sourcesContent":["import { BoundedLRU } from \"./bounded-lru.js\";\nimport { ChroneraError } from \"../errors/errors.js\";\n\nexport class IntlRelativeTimeService {\n  private readonly cache: BoundedLRU<Intl.RelativeTimeFormat>;\n\n  constructor(cacheSize: number = 64) {\n    this.cache = new BoundedLRU<Intl.RelativeTimeFormat>(cacheSize);\n  }\n\n  getFormatter(\n    locale: string,\n    options: Intl.RelativeTimeFormatOptions = {},\n  ): Intl.RelativeTimeFormat {\n    const key = this.createKey(locale, options);\n    const cached = this.cache.get(key);\n    if (cached) {\n      return cached;\n    }\n\n    try {\n      const formatter = new Intl.RelativeTimeFormat(locale, options);\n      this.cache.set(key, formatter);\n      return formatter;\n    } catch (err) {\n      throw new ChroneraError(\n        \"CHRONERA_INCOMPATIBLE_OPTION\",\n        `Failed to create RelativeTimeFormat for locale \"${locale}\": ${err instanceof Error ? err.message : String(err)}`,\n        { cause: err },\n      );\n    }\n  }\n\n  private createKey(\n    locale: string,\n    options: Intl.RelativeTimeFormatOptions,\n  ): string {\n    const keys = Object.keys(options).sort();\n    let optsStr = \"\";\n    for (const k of keys) {\n      optsStr += `${k}:${String((options as Record<string, unknown>)[k])};`;\n    }\n    return `${locale}|${optsStr}`;\n  }\n\n  clearCache(): void {\n    this.cache.clear();\n  }\n}\n"]}

package/dist/runtime/timezone.d.ts

@@ -0,0 +1,14 @@
+import type { Instant, TimeZoneId } from "../public-types.js";
+export declare function validateTimeZone(timeZone: unknown): asserts timeZone is TimeZoneId;
+export interface ProjectedZonedFields {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+    second: number;
+    millisecond: number;
+    era?: string;
+    weekday?: number;
+}
+export declare function projectInstantToZonedFields(instant: Instant, timeZone: TimeZoneId): ProjectedZonedFields;

package/dist/runtime/timezone.js

@@ -0,0 +1,95 @@
+import { ChroneraError } from "../errors/errors.js";
+const DISALLOWED_TIMEZONE_ABBREVIATIONS = new Set([
+    "EST",
+    "EDT",
+    "CST",
+    "CDT",
+    "MST",
+    "MDT",
+    "PST",
+    "PDT",
+    "IST",
+    "WET",
+    "CET",
+    "EET",
+    "BST",
+]);
+export function validateTimeZone(timeZone) {
+    if (typeof timeZone !== "string" || timeZone.trim().length === 0) {
+        throw new ChroneraError("CHRONERA_INVALID_TIME_ZONE", `Invalid time zone identifier: ${String(timeZone)}.`);
+    }
+    const trimmed = timeZone.trim();
+    if (DISALLOWED_TIMEZONE_ABBREVIATIONS.has(trimmed) ||
+        /^GMT[+-]\d+$/i.test(trimmed) ||
+        /^[+-]\d{2}(:?\d{2})?$/.test(trimmed)) {
+        throw new ChroneraError("CHRONERA_INVALID_TIME_ZONE", `Time zone identifier "${trimmed}" is not a valid canonical IANA time zone. Fixed offsets and abbreviations are not allowed.`);
+    }
+    try {
+        new Intl.DateTimeFormat("en-US", { timeZone: trimmed });
+    }
+    catch (err) {
+        throw new ChroneraError("CHRONERA_INVALID_TIME_ZONE", `Unsupported or invalid IANA time zone identifier: "${trimmed}".`, { cause: err });
+    }
+}
+export function projectInstantToZonedFields(instant, timeZone) {
+    validateTimeZone(timeZone);
+    const date = new Date(instant.epochMilliseconds);
+    const formatter = new Intl.DateTimeFormat("en-US", {
+        timeZone,
+        calendar: "gregory",
+        hourCycle: "h23",
+        year: "numeric",
+        month: "numeric",
+        day: "numeric",
+        hour: "numeric",
+        minute: "numeric",
+        second: "numeric",
+        era: "short",
+        weekday: "narrow",
+    });
+    const parts = formatter.formatToParts(date);
+    let year = 0;
+    let month = 0;
+    let day = 0;
+    let hour = 0;
+    let minute = 0;
+    let second = 0;
+    let era;
+    for (const part of parts) {
+        switch (part.type) {
+            case "year":
+                year = Number.parseInt(part.value, 10);
+                break;
+            case "month":
+                month = Number.parseInt(part.value, 10);
+                break;
+            case "day":
+                day = Number.parseInt(part.value, 10);
+                break;
+            case "hour":
+                hour = Number.parseInt(part.value, 10);
+                break;
+            case "minute":
+                minute = Number.parseInt(part.value, 10);
+                break;
+            case "second":
+                second = Number.parseInt(part.value, 10);
+                break;
+            case "era":
+                era = part.value;
+                break;
+        }
+    }
+    const ms = ((instant.epochMilliseconds % 1000) + 1000) % 1000;
+    return {
+        year,
+        month,
+        day,
+        hour,
+        minute,
+        second,
+        millisecond: ms,
+        ...(era !== undefined ? { era } : {}),
+    };
+}
+//# sourceMappingURL=timezone.js.map