@intech-software/chronera 0.1.0

package/dist/core/instant.js

@@ -0,0 +1,26 @@
+import { ChroneraError } from "../errors/errors.js";
+import { requireInteger } from "./integer.js";
+export const MIN_EPOCH_MILLISECONDS = -62135596800000;
+export const MAX_EPOCH_MILLISECONDS = 253402300799999;
+export function instantFromEpochMilliseconds(epochMilliseconds) {
+    requireInteger("epochMilliseconds", epochMilliseconds);
+    if (epochMilliseconds < MIN_EPOCH_MILLISECONDS ||
+        epochMilliseconds > MAX_EPOCH_MILLISECONDS) {
+        throw new ChroneraError("CHRONERA_OUT_OF_RANGE", `Epoch milliseconds must be between ${MIN_EPOCH_MILLISECONDS} and ${MAX_EPOCH_MILLISECONDS}; received ${epochMilliseconds}.`);
+    }
+    return {
+        kind: "instant",
+        epochMilliseconds,
+    };
+}
+export function instantFromDate(date) {
+    if (!(date instanceof Date) || Number.isNaN(date.getTime())) {
+        throw new ChroneraError("CHRONERA_INVALID_INSTANT", "Expected a valid Date object.");
+    }
+    return instantFromEpochMilliseconds(date.getTime());
+}
+export function instantFromEpochSeconds(epochSeconds) {
+    requireInteger("epochSeconds", epochSeconds);
+    return instantFromEpochMilliseconds(epochSeconds * 1000);
+}
+//# sourceMappingURL=instant.js.map

package/dist/core/instant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instant.js","sourceRoot":"","sources":["../../src/core/instant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAI9C,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,cAAc,CAAC;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,eAAe,CAAC;AAEtD,MAAM,UAAU,4BAA4B,CAC1C,iBAAyB;IAEzB,cAAc,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC;IAEvD,IACE,iBAAiB,GAAG,sBAAsB;QAC1C,iBAAiB,GAAG,sBAAsB,EAC1C,CAAC;QACD,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,sCAAsC,sBAAsB,QAAQ,sBAAsB,cAAc,iBAAiB,GAAG,CAC7H,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,SAAS;QACf,iBAAiB;KAClB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAU;IACxC,IAAI,CAAC,CAAC,IAAI,YAAY,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,aAAa,CACrB,0BAA0B,EAC1B,+BAA+B,CAChC,CAAC;IACJ,CAAC;IAED,OAAO,4BAA4B,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,YAAoB;IAC1D,cAAc,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;IAC7C,OAAO,4BAA4B,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;AAC3D,CAAC","sourcesContent":["import { ChroneraError } from \"../errors/errors.js\";\nimport { requireInteger } from \"./integer.js\";\n\nimport type { Instant } from \"../public-types.js\";\n\nexport const MIN_EPOCH_MILLISECONDS = -62135596800000;\nexport const MAX_EPOCH_MILLISECONDS = 253402300799999;\n\nexport function instantFromEpochMilliseconds(\n  epochMilliseconds: number,\n): Instant {\n  requireInteger(\"epochMilliseconds\", epochMilliseconds);\n\n  if (\n    epochMilliseconds < MIN_EPOCH_MILLISECONDS ||\n    epochMilliseconds > MAX_EPOCH_MILLISECONDS\n  ) {\n    throw new ChroneraError(\n      \"CHRONERA_OUT_OF_RANGE\",\n      `Epoch milliseconds must be between ${MIN_EPOCH_MILLISECONDS} and ${MAX_EPOCH_MILLISECONDS}; received ${epochMilliseconds}.`,\n    );\n  }\n\n  return {\n    kind: \"instant\",\n    epochMilliseconds,\n  };\n}\n\nexport function instantFromDate(date: Date): Instant {\n  if (!(date instanceof Date) || Number.isNaN(date.getTime())) {\n    throw new ChroneraError(\n      \"CHRONERA_INVALID_INSTANT\",\n      \"Expected a valid Date object.\",\n    );\n  }\n\n  return instantFromEpochMilliseconds(date.getTime());\n}\n\nexport function instantFromEpochSeconds(epochSeconds: number): Instant {\n  requireInteger(\"epochSeconds\", epochSeconds);\n  return instantFromEpochMilliseconds(epochSeconds * 1000);\n}\n"]}

package/dist/core/integer.d.ts

@@ -0,0 +1 @@
+export declare function requireInteger(name: string, value: unknown): asserts value is number;

package/dist/core/integer.js

@@ -0,0 +1,7 @@
+import { ChroneraError } from "../errors/errors.js";
+export function requireInteger(name, value) {
+    if (typeof value !== "number" || !Number.isSafeInteger(value)) {
+        throw new ChroneraError("CHRONERA_INVALID_DATE", `Expected ${name} to be a safe integer; received ${String(value)}.`);
+    }
+}
+//# sourceMappingURL=integer.js.map

package/dist/core/integer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integer.js","sourceRoot":"","sources":["../../src/core/integer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,KAAc;IAEd,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,YAAY,IAAI,mCAAmC,MAAM,CAAC,KAAK,CAAC,GAAG,CACpE,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["import { ChroneraError } from \"../errors/errors.js\";\n\nexport function requireInteger(\n  name: string,\n  value: unknown,\n): asserts value is number {\n  if (typeof value !== \"number\" || !Number.isSafeInteger(value)) {\n    throw new ChroneraError(\n      \"CHRONERA_INVALID_DATE\",\n      `Expected ${name} to be a safe integer; received ${String(value)}.`,\n    );\n  }\n}\n"]}

package/dist/core/iso-week.d.ts

@@ -0,0 +1,19 @@
+export interface IsoWeekFields {
+    readonly weekYear: number;
+    readonly weekNumber: number;
+    readonly dayOfWeek: number;
+}
+/**
+ * Computes ISO 8601 day of week from absolute day.
+ * Monday = 1, Tuesday = 2, ..., Sunday = 7.
+ * 1970-01-01 (absolute day 0) was Thursday (4).
+ */
+export declare function getIsoDayOfWeek(absoluteDay: number): number;
+/**
+ * Computes ISO 8601 week fields (weekYear, weekNumber, dayOfWeek) from Gregorian fields.
+ */
+export declare function getIsoWeekFromAbsoluteDay(absoluteDay: number): IsoWeekFields;
+/**
+ * Formats ISO 8601 week string: `YYYY-Www-D` or `YYYY-Www`.
+ */
+export declare function formatIsoWeekString(fields: IsoWeekFields, includeDayOfWeek?: boolean): string;

package/dist/core/iso-week.js

@@ -0,0 +1,41 @@
+import { absoluteDayFromGregorianFields, gregorianFieldsFromAbsoluteDay, } from "./absolute-day.js";
+/**
+ * Computes ISO 8601 day of week from absolute day.
+ * Monday = 1, Tuesday = 2, ..., Sunday = 7.
+ * 1970-01-01 (absolute day 0) was Thursday (4).
+ */
+export function getIsoDayOfWeek(absoluteDay) {
+    return ((((absoluteDay + 3) % 7) + 7) % 7) + 1;
+}
+/**
+ * Computes ISO 8601 week fields (weekYear, weekNumber, dayOfWeek) from Gregorian fields.
+ */
+export function getIsoWeekFromAbsoluteDay(absoluteDay) {
+    const dayOfWeek = getIsoDayOfWeek(absoluteDay);
+    // Find Thursday of current week
+    const thursdayAbsoluteDay = absoluteDay + (4 - dayOfWeek);
+    const thursdayFields = gregorianFieldsFromAbsoluteDay(thursdayAbsoluteDay);
+    const weekYear = thursdayFields.year;
+    // Find first Thursday of weekYear (which is the Thursday of the week containing Jan 4)
+    const jan4AbsoluteDay = absoluteDayFromGregorianFields(weekYear, 1, 4);
+    const jan4DayOfWeek = getIsoDayOfWeek(jan4AbsoluteDay);
+    const firstThursdayAbsoluteDay = jan4AbsoluteDay + (4 - jan4DayOfWeek);
+    const weekNumber = 1 + Math.floor((thursdayAbsoluteDay - firstThursdayAbsoluteDay) / 7);
+    return {
+        weekYear,
+        weekNumber,
+        dayOfWeek,
+    };
+}
+/**
+ * Formats ISO 8601 week string: `YYYY-Www-D` or `YYYY-Www`.
+ */
+export function formatIsoWeekString(fields, includeDayOfWeek = true) {
+    const yearStr = String(fields.weekYear).padStart(4, "0");
+    const weekStr = String(fields.weekNumber).padStart(2, "0");
+    if (!includeDayOfWeek) {
+        return `${yearStr}-W${weekStr}`;
+    }
+    return `${yearStr}-W${weekStr}-${fields.dayOfWeek}`;
+}
+//# sourceMappingURL=iso-week.js.map

package/dist/core/iso-week.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iso-week.js","sourceRoot":"","sources":["../../src/core/iso-week.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,mBAAmB,CAAC;AAQ3B;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,WAAmB;IAC3D,MAAM,SAAS,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAC/C,gCAAgC;IAChC,MAAM,mBAAmB,GAAG,WAAW,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC1D,MAAM,cAAc,GAAG,8BAA8B,CAAC,mBAAmB,CAAC,CAAC;IAC3E,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC;IAErC,uFAAuF;IACvF,MAAM,eAAe,GAAG,8BAA8B,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACvE,MAAM,aAAa,GAAG,eAAe,CAAC,eAAe,CAAC,CAAC;IACvD,MAAM,wBAAwB,GAAG,eAAe,GAAG,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC;IAEvE,MAAM,UAAU,GACd,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,mBAAmB,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC,CAAC;IAEvE,OAAO;QACL,QAAQ;QACR,UAAU;QACV,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAqB,EACrB,gBAAgB,GAAG,IAAI;IAEvB,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3D,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO,GAAG,OAAO,KAAK,OAAO,EAAE,CAAC;IAClC,CAAC;IACD,OAAO,GAAG,OAAO,KAAK,OAAO,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;AACtD,CAAC","sourcesContent":["import {\n  absoluteDayFromGregorianFields,\n  gregorianFieldsFromAbsoluteDay,\n} from \"./absolute-day.js\";\n\nexport interface IsoWeekFields {\n  readonly weekYear: number;\n  readonly weekNumber: number;\n  readonly dayOfWeek: number; // 1 (Monday) to 7 (Sunday)\n}\n\n/**\n * Computes ISO 8601 day of week from absolute day.\n * Monday = 1, Tuesday = 2, ..., Sunday = 7.\n * 1970-01-01 (absolute day 0) was Thursday (4).\n */\nexport function getIsoDayOfWeek(absoluteDay: number): number {\n  return ((((absoluteDay + 3) % 7) + 7) % 7) + 1;\n}\n\n/**\n * Computes ISO 8601 week fields (weekYear, weekNumber, dayOfWeek) from Gregorian fields.\n */\nexport function getIsoWeekFromAbsoluteDay(absoluteDay: number): IsoWeekFields {\n  const dayOfWeek = getIsoDayOfWeek(absoluteDay);\n  // Find Thursday of current week\n  const thursdayAbsoluteDay = absoluteDay + (4 - dayOfWeek);\n  const thursdayFields = gregorianFieldsFromAbsoluteDay(thursdayAbsoluteDay);\n  const weekYear = thursdayFields.year;\n\n  // Find first Thursday of weekYear (which is the Thursday of the week containing Jan 4)\n  const jan4AbsoluteDay = absoluteDayFromGregorianFields(weekYear, 1, 4);\n  const jan4DayOfWeek = getIsoDayOfWeek(jan4AbsoluteDay);\n  const firstThursdayAbsoluteDay = jan4AbsoluteDay + (4 - jan4DayOfWeek);\n\n  const weekNumber =\n    1 + Math.floor((thursdayAbsoluteDay - firstThursdayAbsoluteDay) / 7);\n\n  return {\n    weekYear,\n    weekNumber,\n    dayOfWeek,\n  };\n}\n\n/**\n * Formats ISO 8601 week string: `YYYY-Www-D` or `YYYY-Www`.\n */\nexport function formatIsoWeekString(\n  fields: IsoWeekFields,\n  includeDayOfWeek = true,\n): string {\n  const yearStr = String(fields.weekYear).padStart(4, \"0\");\n  const weekStr = String(fields.weekNumber).padStart(2, \"0\");\n  if (!includeDayOfWeek) {\n    return `${yearStr}-W${weekStr}`;\n  }\n  return `${yearStr}-W${weekStr}-${fields.dayOfWeek}`;\n}\n"]}

package/dist/core/julian-day.d.ts

@@ -0,0 +1,26 @@
+/**
+ * International Astronomical Union (IAU) / NASA standard conversions
+ * for Julian Day Number (JDN) and Modified Julian Day (MJD).
+ *
+ * Benchmark reference points:
+ * - 1970-01-01 (Absolute Day 0) = JDN 2440588, MJD 40587
+ * - 2000-01-01 (J2000.0 Epoch)  = JDN 2451545, MJD 51544
+ */
+export declare const JDN_EPOCH_OFFSET = 2440588;
+export declare const MJD_EPOCH_OFFSET = 40587;
+/**
+ * Converts a Howard Hinnant absolute civil day to an astronomical Julian Day Number (JDN).
+ */
+export declare function toJulianDayNumber(absoluteDay: number): number;
+/**
+ * Converts an astronomical Julian Day Number (JDN) to a Howard Hinnant absolute civil day.
+ */
+export declare function fromJulianDayNumber(jdn: number): number;
+/**
+ * Converts a Howard Hinnant absolute civil day to a Modified Julian Day (MJD).
+ */
+export declare function toModifiedJulianDay(absoluteDay: number): number;
+/**
+ * Converts a Modified Julian Day (MJD) to a Howard Hinnant absolute civil day.
+ */
+export declare function fromModifiedJulianDay(mjd: number): number;

package/dist/core/julian-day.js

@@ -0,0 +1,35 @@
+/**
+ * International Astronomical Union (IAU) / NASA standard conversions
+ * for Julian Day Number (JDN) and Modified Julian Day (MJD).
+ *
+ * Benchmark reference points:
+ * - 1970-01-01 (Absolute Day 0) = JDN 2440588, MJD 40587
+ * - 2000-01-01 (J2000.0 Epoch)  = JDN 2451545, MJD 51544
+ */
+export const JDN_EPOCH_OFFSET = 2440588;
+export const MJD_EPOCH_OFFSET = 40587;
+/**
+ * Converts a Howard Hinnant absolute civil day to an astronomical Julian Day Number (JDN).
+ */
+export function toJulianDayNumber(absoluteDay) {
+    return absoluteDay + JDN_EPOCH_OFFSET;
+}
+/**
+ * Converts an astronomical Julian Day Number (JDN) to a Howard Hinnant absolute civil day.
+ */
+export function fromJulianDayNumber(jdn) {
+    return jdn - JDN_EPOCH_OFFSET;
+}
+/**
+ * Converts a Howard Hinnant absolute civil day to a Modified Julian Day (MJD).
+ */
+export function toModifiedJulianDay(absoluteDay) {
+    return absoluteDay + MJD_EPOCH_OFFSET;
+}
+/**
+ * Converts a Modified Julian Day (MJD) to a Howard Hinnant absolute civil day.
+ */
+export function fromModifiedJulianDay(mjd) {
+    return mjd - MJD_EPOCH_OFFSET;
+}
+//# sourceMappingURL=julian-day.js.map

package/dist/core/julian-day.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"julian-day.js","sourceRoot":"","sources":["../../src/core/julian-day.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC;AACxC,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAEtC;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,OAAO,WAAW,GAAG,gBAAgB,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,OAAO,GAAG,GAAG,gBAAgB,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,OAAO,WAAW,GAAG,gBAAgB,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,OAAO,GAAG,GAAG,gBAAgB,CAAC;AAChC,CAAC","sourcesContent":["/**\n * International Astronomical Union (IAU) / NASA standard conversions\n * for Julian Day Number (JDN) and Modified Julian Day (MJD).\n *\n * Benchmark reference points:\n * - 1970-01-01 (Absolute Day 0) = JDN 2440588, MJD 40587\n * - 2000-01-01 (J2000.0 Epoch)  = JDN 2451545, MJD 51544\n */\n\nexport const JDN_EPOCH_OFFSET = 2440588;\nexport const MJD_EPOCH_OFFSET = 40587;\n\n/**\n * Converts a Howard Hinnant absolute civil day to an astronomical Julian Day Number (JDN).\n */\nexport function toJulianDayNumber(absoluteDay: number): number {\n  return absoluteDay + JDN_EPOCH_OFFSET;\n}\n\n/**\n * Converts an astronomical Julian Day Number (JDN) to a Howard Hinnant absolute civil day.\n */\nexport function fromJulianDayNumber(jdn: number): number {\n  return jdn - JDN_EPOCH_OFFSET;\n}\n\n/**\n * Converts a Howard Hinnant absolute civil day to a Modified Julian Day (MJD).\n */\nexport function toModifiedJulianDay(absoluteDay: number): number {\n  return absoluteDay + MJD_EPOCH_OFFSET;\n}\n\n/**\n * Converts a Modified Julian Day (MJD) to a Howard Hinnant absolute civil day.\n */\nexport function fromModifiedJulianDay(mjd: number): number {\n  return mjd - MJD_EPOCH_OFFSET;\n}\n"]}

package/dist/core/local-date-time.d.ts

@@ -0,0 +1,2 @@
+import type { LocalDate, LocalDateTime, LocalTime } from "../public-types.js";
+export declare function localDateTime(date: LocalDate, time: LocalTime): LocalDateTime;

package/dist/core/local-date-time.js

@@ -0,0 +1,15 @@
+import { ChroneraError } from "../errors/errors.js";
+export function localDateTime(date, time) {
+    if (!date || date.kind !== "local-date") {
+        throw new ChroneraError("CHRONERA_INVALID_DATE", "Expected a valid LocalDate.");
+    }
+    if (!time || time.kind !== "local-time") {
+        throw new ChroneraError("CHRONERA_INVALID_TIME", "Expected a valid LocalTime.");
+    }
+    return {
+        kind: "local-date-time",
+        date,
+        time,
+    };
+}
+//# sourceMappingURL=local-date-time.js.map

package/dist/core/local-date-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-date-time.js","sourceRoot":"","sources":["../../src/core/local-date-time.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIpD,MAAM,UAAU,aAAa,CAAC,IAAe,EAAE,IAAe;IAC5D,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACxC,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,6BAA6B,CAC9B,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACxC,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,6BAA6B,CAC9B,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,IAAI;QACJ,IAAI;KACL,CAAC;AACJ,CAAC","sourcesContent":["import { ChroneraError } from \"../errors/errors.js\";\n\nimport type { LocalDate, LocalDateTime, LocalTime } from \"../public-types.js\";\n\nexport function localDateTime(date: LocalDate, time: LocalTime): LocalDateTime {\n  if (!date || date.kind !== \"local-date\") {\n    throw new ChroneraError(\n      \"CHRONERA_INVALID_DATE\",\n      \"Expected a valid LocalDate.\",\n    );\n  }\n\n  if (!time || time.kind !== \"local-time\") {\n    throw new ChroneraError(\n      \"CHRONERA_INVALID_TIME\",\n      \"Expected a valid LocalTime.\",\n    );\n  }\n\n  return {\n    kind: \"local-date-time\",\n    date,\n    time,\n  };\n}\n"]}

package/dist/core/local-date.d.ts

@@ -0,0 +1,2 @@
+import type { LocalDate } from "../public-types.js";
+export declare function localDate(year: number, month: number, day: number): LocalDate;

package/dist/core/local-date.js

@@ -0,0 +1,22 @@
+import { ChroneraError } from "../errors/errors.js";
+import { daysInGregorianMonth } from "./gregorian-math.js";
+import { requireInteger } from "./integer.js";
+export function localDate(year, month, day) {
+    requireInteger("year", year);
+    requireInteger("month", month);
+    requireInteger("day", day);
+    if (year < 1 || year > 9999) {
+        throw new ChroneraError("CHRONERA_OUT_OF_RANGE", `Gregorian year must be between 1 and 9999; received ${year}.`);
+    }
+    const maximumDay = daysInGregorianMonth(year, month);
+    if (day < 1 || day > maximumDay) {
+        throw new ChroneraError("CHRONERA_INVALID_DATE", `Invalid day ${day} for Gregorian month ${month} in year ${year}.`);
+    }
+    return {
+        kind: "local-date",
+        year,
+        month,
+        day,
+    };
+}
+//# sourceMappingURL=local-date.js.map

package/dist/core/local-date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-date.js","sourceRoot":"","sources":["../../src/core/local-date.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAI9C,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAAa,EAAE,GAAW;IAChE,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC7B,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC/B,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAE3B,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;QAC5B,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,uDAAuD,IAAI,GAAG,CAC/D,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,oBAAoB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAErD,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,UAAU,EAAE,CAAC;QAChC,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,eAAe,GAAG,wBAAwB,KAAK,YAAY,IAAI,GAAG,CACnE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,IAAI;QACJ,KAAK;QACL,GAAG;KACJ,CAAC;AACJ,CAAC","sourcesContent":["import { ChroneraError } from \"../errors/errors.js\";\nimport { daysInGregorianMonth } from \"./gregorian-math.js\";\nimport { requireInteger } from \"./integer.js\";\n\nimport type { LocalDate } from \"../public-types.js\";\n\nexport function localDate(year: number, month: number, day: number): LocalDate {\n  requireInteger(\"year\", year);\n  requireInteger(\"month\", month);\n  requireInteger(\"day\", day);\n\n  if (year < 1 || year > 9999) {\n    throw new ChroneraError(\n      \"CHRONERA_OUT_OF_RANGE\",\n      `Gregorian year must be between 1 and 9999; received ${year}.`,\n    );\n  }\n\n  const maximumDay = daysInGregorianMonth(year, month);\n\n  if (day < 1 || day > maximumDay) {\n    throw new ChroneraError(\n      \"CHRONERA_INVALID_DATE\",\n      `Invalid day ${day} for Gregorian month ${month} in year ${year}.`,\n    );\n  }\n\n  return {\n    kind: \"local-date\",\n    year,\n    month,\n    day,\n  };\n}\n"]}

package/dist/core/local-time.d.ts

@@ -0,0 +1,2 @@
+import type { LocalTime } from "../public-types.js";
+export declare function localTime(hour: number, minute: number, second?: number, millisecond?: number): LocalTime;

package/dist/core/local-time.js

@@ -0,0 +1,28 @@
+import { ChroneraError } from "../errors/errors.js";
+import { requireInteger } from "./integer.js";
+export function localTime(hour, minute, second = 0, millisecond = 0) {
+    requireInteger("hour", hour);
+    requireInteger("minute", minute);
+    requireInteger("second", second);
+    requireInteger("millisecond", millisecond);
+    if (hour < 0 || hour > 23) {
+        throw new ChroneraError("CHRONERA_INVALID_TIME", `Hour must be between 0 and 23; received ${hour}.`);
+    }
+    if (minute < 0 || minute > 59) {
+        throw new ChroneraError("CHRONERA_INVALID_TIME", `Minute must be between 0 and 59; received ${minute}.`);
+    }
+    if (second < 0 || second > 59) {
+        throw new ChroneraError("CHRONERA_INVALID_TIME", `Second must be between 0 and 59; received ${second}.`);
+    }
+    if (millisecond < 0 || millisecond > 999) {
+        throw new ChroneraError("CHRONERA_INVALID_TIME", `Millisecond must be between 0 and 999; received ${millisecond}.`);
+    }
+    return {
+        kind: "local-time",
+        hour,
+        minute,
+        second,
+        millisecond,
+    };
+}
+//# sourceMappingURL=local-time.js.map

package/dist/core/local-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-time.js","sourceRoot":"","sources":["../../src/core/local-time.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAI9C,MAAM,UAAU,SAAS,CACvB,IAAY,EACZ,MAAc,EACd,SAAiB,CAAC,EAClB,cAAsB,CAAC;IAEvB,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC7B,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjC,cAAc,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAE3C,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,EAAE,EAAE,CAAC;QAC1B,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,2CAA2C,IAAI,GAAG,CACnD,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,EAAE,EAAE,CAAC;QAC9B,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,6CAA6C,MAAM,GAAG,CACvD,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,EAAE,EAAE,CAAC;QAC9B,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,6CAA6C,MAAM,GAAG,CACvD,CAAC;IACJ,CAAC;IAED,IAAI,WAAW,GAAG,CAAC,IAAI,WAAW,GAAG,GAAG,EAAE,CAAC;QACzC,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,mDAAmD,WAAW,GAAG,CAClE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,IAAI;QACJ,MAAM;QACN,MAAM;QACN,WAAW;KACZ,CAAC;AACJ,CAAC","sourcesContent":["import { ChroneraError } from \"../errors/errors.js\";\nimport { requireInteger } from \"./integer.js\";\n\nimport type { LocalTime } from \"../public-types.js\";\n\nexport function localTime(\n  hour: number,\n  minute: number,\n  second: number = 0,\n  millisecond: number = 0,\n): LocalTime {\n  requireInteger(\"hour\", hour);\n  requireInteger(\"minute\", minute);\n  requireInteger(\"second\", second);\n  requireInteger(\"millisecond\", millisecond);\n\n  if (hour < 0 || hour > 23) {\n    throw new ChroneraError(\n      \"CHRONERA_INVALID_TIME\",\n      `Hour must be between 0 and 23; received ${hour}.`,\n    );\n  }\n\n  if (minute < 0 || minute > 59) {\n    throw new ChroneraError(\n      \"CHRONERA_INVALID_TIME\",\n      `Minute must be between 0 and 59; received ${minute}.`,\n    );\n  }\n\n  if (second < 0 || second > 59) {\n    throw new ChroneraError(\n      \"CHRONERA_INVALID_TIME\",\n      `Second must be between 0 and 59; received ${second}.`,\n    );\n  }\n\n  if (millisecond < 0 || millisecond > 999) {\n    throw new ChroneraError(\n      \"CHRONERA_INVALID_TIME\",\n      `Millisecond must be between 0 and 999; received ${millisecond}.`,\n    );\n  }\n\n  return {\n    kind: \"local-time\",\n    hour,\n    minute,\n    second,\n    millisecond,\n  };\n}\n"]}

package/dist/core/range.d.ts

@@ -0,0 +1,2 @@
+import type { DateRange } from "../public-types.js";
+export declare function dateRange<TDate>(start: TDate, end: TDate, startInclusive?: boolean, endInclusive?: boolean): DateRange<TDate>;

package/dist/core/range.js

@@ -0,0 +1,9 @@
+export function dateRange(start, end, startInclusive = true, endInclusive = true) {
+    return {
+        start,
+        end,
+        startInclusive,
+        endInclusive,
+    };
+}
+//# sourceMappingURL=range.js.map

package/dist/core/range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"range.js","sourceRoot":"","sources":["../../src/core/range.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,SAAS,CACvB,KAAY,EACZ,GAAU,EACV,iBAA0B,IAAI,EAC9B,eAAwB,IAAI;IAE5B,OAAO;QACL,KAAK;QACL,GAAG;QACH,cAAc;QACd,YAAY;KACb,CAAC;AACJ,CAAC","sourcesContent":["import type { DateRange } from \"../public-types.js\";\n\nexport function dateRange<TDate>(\n  start: TDate,\n  end: TDate,\n  startInclusive: boolean = true,\n  endInclusive: boolean = true,\n): DateRange<TDate> {\n  return {\n    start,\n    end,\n    startInclusive,\n    endInclusive,\n  };\n}\n"]}

package/dist/create-chronera.d.ts

@@ -0,0 +1,2 @@
+import type { ChroneraConfig, ChroneraInstance } from "./public-types.js";
+export declare function createChronera(config?: Readonly<ChroneraConfig>): ChroneraInstance;

package/dist/create-chronera.js

@@ -0,0 +1,59 @@
+import { ChroneraEngine } from "./internal/engine.js";
+import { formatDateWithRegistry } from "./format/format-date.js";
+import { parseLocalDate } from "./parse/parse-local-date.js";
+import { convertCalendarDateWithRegistry } from "./operations/convert-calendar-date.js";
+export function createChronera(config) {
+    const engine = new ChroneraEngine(config);
+    const defaultLocale = config?.locale ?? "en-US";
+    const defaultCalendar = config?.calendar ?? "gregory";
+    const defaultTimeZone = config?.timeZone ?? "UTC";
+    const defaultNumberingSystem = config?.numberingSystem;
+    const formatterCacheSize = config?.formatterCacheSize ?? 64;
+    return {
+        formatDate(input, options) {
+            const isDateOnly = "kind" in input &&
+                (input.kind === "local-date" || input.kind === "calendar-date");
+            const base = {
+                locale: options?.locale ?? defaultLocale,
+                calendar: options?.calendar ?? defaultCalendar,
+                ...(options?.numberingSystem !== undefined
+                    ? { numberingSystem: options.numberingSystem }
+                    : defaultNumberingSystem !== undefined
+                        ? { numberingSystem: defaultNumberingSystem }
+                        : {}),
+                ...(options?.timeZone !== undefined
+                    ? { timeZone: options.timeZone }
+                    : !isDateOnly
+                        ? { timeZone: defaultTimeZone }
+                        : {}),
+            };
+            const mergedOptions = options && "preset" in options && options.preset !== undefined
+                ? { ...base, preset: options.preset }
+                : {
+                    ...base,
+                    ...(options && "style" in options && options.style !== undefined
+                        ? { style: options.style }
+                        : {}),
+                };
+            return formatDateWithRegistry(engine.registry, input, mergedOptions);
+        },
+        parseLocalDate(input, options) {
+            return parseLocalDate(input, options);
+        },
+        convertCalendarDate(source, targetCalendar, options) {
+            return convertCalendarDateWithRegistry(engine.registry, source, targetCalendar, options);
+        },
+        resolvedOptions() {
+            return {
+                locale: defaultLocale,
+                calendar: defaultCalendar,
+                ...(defaultNumberingSystem !== undefined
+                    ? { numberingSystem: defaultNumberingSystem }
+                    : {}),
+                timeZone: defaultTimeZone,
+                formatterCacheSize,
+            };
+        },
+    };
+}
+//# sourceMappingURL=create-chronera.js.map

package/dist/create-chronera.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-chronera.js","sourceRoot":"","sources":["../src/create-chronera.ts"],"names":[],"mappings":"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","sourcesContent":["import { ChroneraEngine } from \"./internal/engine.js\";\nimport { formatDateWithRegistry } from \"./format/format-date.js\";\nimport { parseLocalDate } from \"./parse/parse-local-date.js\";\nimport { convertCalendarDateWithRegistry } from \"./operations/convert-calendar-date.js\";\n\nimport type {\n  CalendarDate,\n  CalendarId,\n  ChroneraConfig,\n  ChroneraInstance,\n  ConvertCalendarOptions,\n  FormatDateInput,\n  FormatDateOptions,\n  LocalDate,\n  ParseLocalDateOptions,\n  ResolvedChroneraOptions,\n} from \"./public-types.js\";\n\nexport function createChronera(\n  config?: Readonly<ChroneraConfig>,\n): ChroneraInstance {\n  const engine = new ChroneraEngine(config);\n\n  const defaultLocale = config?.locale ?? \"en-US\";\n  const defaultCalendar = config?.calendar ?? \"gregory\";\n  const defaultTimeZone = config?.timeZone ?? \"UTC\";\n  const defaultNumberingSystem = config?.numberingSystem;\n  const formatterCacheSize = config?.formatterCacheSize ?? 64;\n\n  return {\n    formatDate(\n      input: FormatDateInput,\n      options?: Readonly<FormatDateOptions>,\n    ): string {\n      const isDateOnly =\n        \"kind\" in input &&\n        (input.kind === \"local-date\" || input.kind === \"calendar-date\");\n\n      const base = {\n        locale: options?.locale ?? defaultLocale,\n        calendar: options?.calendar ?? defaultCalendar,\n        ...(options?.numberingSystem !== undefined\n          ? { numberingSystem: options.numberingSystem }\n          : defaultNumberingSystem !== undefined\n            ? { numberingSystem: defaultNumberingSystem }\n            : {}),\n        ...(options?.timeZone !== undefined\n          ? { timeZone: options.timeZone }\n          : !isDateOnly\n            ? { timeZone: defaultTimeZone }\n            : {}),\n      };\n\n      const mergedOptions: FormatDateOptions =\n        options && \"preset\" in options && options.preset !== undefined\n          ? { ...base, preset: options.preset }\n          : {\n              ...base,\n              ...(options && \"style\" in options && options.style !== undefined\n                ? { style: options.style }\n                : {}),\n            };\n\n      return formatDateWithRegistry(engine.registry, input, mergedOptions);\n    },\n\n    parseLocalDate(\n      input: string,\n      options?: Readonly<ParseLocalDateOptions>,\n    ): LocalDate {\n      return parseLocalDate(input, options);\n    },\n\n    convertCalendarDate(\n      source: CalendarDate,\n      targetCalendar: CalendarId,\n      options?: Readonly<ConvertCalendarOptions>,\n    ): ReturnType<typeof convertCalendarDateWithRegistry> {\n      return convertCalendarDateWithRegistry(\n        engine.registry,\n        source,\n        targetCalendar,\n        options,\n      );\n    },\n\n    resolvedOptions(): ResolvedChroneraOptions {\n      return {\n        locale: defaultLocale,\n        calendar: defaultCalendar,\n        ...(defaultNumberingSystem !== undefined\n          ? { numberingSystem: defaultNumberingSystem }\n          : {}),\n        timeZone: defaultTimeZone,\n        formatterCacheSize,\n      };\n    },\n  };\n}\n"]}

package/dist/errors/error-codes.d.ts

@@ -0,0 +1 @@
+export type ChroneraErrorCode = "CHRONERA_INVALID_DATE" | "CHRONERA_INVALID_TIME" | "CHRONERA_INVALID_INSTANT" | "CHRONERA_INVALID_CALENDAR" | "CHRONERA_UNSUPPORTED_CALENDAR" | "CHRONERA_INVALID_TIME_ZONE" | "CHRONERA_UNSUPPORTED_TIME_ZONE" | "CHRONERA_INVALID_LOCALE" | "CHRONERA_PARSE_FAILED" | "CHRONERA_AMBIGUOUS_DATE" | "CHRONERA_OUT_OF_RANGE" | "CHRONERA_UNSUPPORTED_OPERATION" | "CHRONERA_INCOMPATIBLE_OPTION" | "CHRONERA_INPUT_TOO_LONG" | "CHRONERA_INPUT_TOO_LARGE" | "CHRONERA_PATTERN_TOO_LONG" | "CHRONERA_PATTERN_TOO_COMPLEX";

package/dist/errors/error-codes.js

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

package/dist/errors/error-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.js","sourceRoot":"","sources":["../../src/errors/error-codes.ts"],"names":[],"mappings":"","sourcesContent":["export type ChroneraErrorCode =\n  | \"CHRONERA_INVALID_DATE\"\n  | \"CHRONERA_INVALID_TIME\"\n  | \"CHRONERA_INVALID_INSTANT\"\n  | \"CHRONERA_INVALID_CALENDAR\"\n  | \"CHRONERA_UNSUPPORTED_CALENDAR\"\n  | \"CHRONERA_INVALID_TIME_ZONE\"\n  | \"CHRONERA_UNSUPPORTED_TIME_ZONE\"\n  | \"CHRONERA_INVALID_LOCALE\"\n  | \"CHRONERA_PARSE_FAILED\"\n  | \"CHRONERA_AMBIGUOUS_DATE\"\n  | \"CHRONERA_OUT_OF_RANGE\"\n  | \"CHRONERA_UNSUPPORTED_OPERATION\"\n  | \"CHRONERA_INCOMPATIBLE_OPTION\"\n  | \"CHRONERA_INPUT_TOO_LONG\"\n  | \"CHRONERA_INPUT_TOO_LARGE\"\n  | \"CHRONERA_PATTERN_TOO_LONG\"\n  | \"CHRONERA_PATTERN_TOO_COMPLEX\";\n"]}

package/dist/errors/errors.d.ts

@@ -0,0 +1,16 @@
+import type { ChroneraErrorCode } from "./error-codes.js";
+export declare class ChroneraError extends Error {
+    readonly name: string;
+    readonly code: ChroneraErrorCode;
+    readonly details?: Readonly<Record<string, unknown>>;
+    constructor(code: ChroneraErrorCode, message: string, details?: Readonly<Record<string, unknown>>, options?: ErrorOptions);
+}
+export declare class ChroneraParseError extends ChroneraError {
+    readonly name = "ChroneraParseError";
+}
+export declare class ChroneraRangeError extends ChroneraError {
+    readonly name = "ChroneraRangeError";
+}
+export declare class ChroneraUnsupportedError extends ChroneraError {
+    readonly name = "ChroneraUnsupportedError";
+}

package/dist/errors/errors.js

@@ -0,0 +1,22 @@
+export class ChroneraError extends Error {
+    name = "ChroneraError";
+    code;
+    details;
+    constructor(code, message, details, options) {
+        super(message, options);
+        this.code = code;
+        if (details !== undefined) {
+            this.details = { ...details };
+        }
+    }
+}
+export class ChroneraParseError extends ChroneraError {
+    name = "ChroneraParseError";
+}
+export class ChroneraRangeError extends ChroneraError {
+    name = "ChroneraRangeError";
+}
+export class ChroneraUnsupportedError extends ChroneraError {
+    name = "ChroneraUnsupportedError";
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAc,SAAQ,KAAK;IACpB,IAAI,GAAW,eAAe,CAAC;IACxC,IAAI,CAAoB;IACxB,OAAO,CAAqC;IAErD,YACE,IAAuB,EACvB,OAAe,EACf,OAA2C,EAC3C,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;QAChC,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACjC,IAAI,GAAG,oBAAoB,CAAC;CAC/C;AAED,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACjC,IAAI,GAAG,oBAAoB,CAAC;CAC/C;AAED,MAAM,OAAO,wBAAyB,SAAQ,aAAa;IACvC,IAAI,GAAG,0BAA0B,CAAC;CACrD","sourcesContent":["import type { ChroneraErrorCode } from \"./error-codes.js\";\n\nexport class ChroneraError extends Error {\n  override readonly name: string = \"ChroneraError\";\n  readonly code: ChroneraErrorCode;\n  readonly details?: Readonly<Record<string, unknown>>;\n\n  constructor(\n    code: ChroneraErrorCode,\n    message: string,\n    details?: Readonly<Record<string, unknown>>,\n    options?: ErrorOptions,\n  ) {\n    super(message, options);\n    this.code = code;\n    if (details !== undefined) {\n      this.details = { ...details };\n    }\n  }\n}\n\nexport class ChroneraParseError extends ChroneraError {\n  override readonly name = \"ChroneraParseError\";\n}\n\nexport class ChroneraRangeError extends ChroneraError {\n  override readonly name = \"ChroneraRangeError\";\n}\n\nexport class ChroneraUnsupportedError extends ChroneraError {\n  override readonly name = \"ChroneraUnsupportedError\";\n}\n"]}

package/dist/errors/index.d.ts

@@ -0,0 +1,2 @@
+export { ChroneraError, ChroneraParseError, ChroneraRangeError, ChroneraUnsupportedError, } from "./errors.js";
+export type { ChroneraErrorCode } from "./error-codes.js";

package/dist/errors/index.js

@@ -0,0 +1,2 @@
+export { ChroneraError, ChroneraParseError, ChroneraRangeError, ChroneraUnsupportedError, } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,aAAa,CAAC","sourcesContent":["export {\n  ChroneraError,\n  ChroneraParseError,\n  ChroneraRangeError,\n  ChroneraUnsupportedError,\n} from \"./errors.js\";\n\nexport type { ChroneraErrorCode } from \"./error-codes.js\";\n"]}

package/dist/format/format-date-range.d.ts

@@ -0,0 +1,2 @@
+import type { CalendarDate, DateRange, FormatDateRangeOptions, Instant, LocalDate } from "../public-types.js";
+export declare function formatDateRange(range: DateRange<LocalDate | CalendarDate | Instant>, options?: Readonly<FormatDateRangeOptions>): string;

package/dist/format/format-date-range.js

@@ -0,0 +1,89 @@
+import { ChroneraError } from "../errors/errors.js";
+import { compareInstants, compareLocalDates } from "../operations/compare.js";
+import { formatDate } from "./format-date.js";
+import { validateAndResolveLocale } from "../locale/resolve-locale.js";
+export function formatDateRange(range, options = {}) {
+    const { start, end } = range;
+    // Validate mixed input kinds
+    if (start.kind !== end.kind) {
+        throw new ChroneraError("CHRONERA_INVALID_DATE", `Cannot format date range with mixed input kinds: "${start.kind}" and "${end.kind}".`);
+    }
+    // Validate ordering and timezone rules
+    if (start.kind === "local-date") {
+        if (options.timeZone !== undefined) {
+            throw new ChroneraError("CHRONERA_INCOMPATIBLE_OPTION", "Timezone option is forbidden for date-only ranges.");
+        }
+        const cmp = compareLocalDates(start, end);
+        if (cmp > 0) {
+            throw new ChroneraError("CHRONERA_OUT_OF_RANGE", "Range start must be earlier than or equal to range end.");
+        }
+    }
+    else if (start.kind === "calendar-date") {
+        if (options.timeZone !== undefined) {
+            throw new ChroneraError("CHRONERA_INCOMPATIBLE_OPTION", "Timezone option is forbidden for calendar date ranges.");
+        }
+        const endCal = end;
+        if (start.calendar !== endCal.calendar) {
+            throw new ChroneraError("CHRONERA_INVALID_CALENDAR", `Cannot format range with mixed calendars "${start.calendar}" and "${endCal.calendar}".`);
+        }
+        if (start.year > endCal.year ||
+            (start.year === endCal.year && start.monthCode > endCal.monthCode) ||
+            (start.year === endCal.year &&
+                start.monthCode === endCal.monthCode &&
+                start.day > endCal.day)) {
+            throw new ChroneraError("CHRONERA_OUT_OF_RANGE", "Range start must be earlier than or equal to range end.");
+        }
+    }
+    else if (start.kind === "instant") {
+        const cmp = compareInstants(start, end);
+        if (cmp > 0) {
+            throw new ChroneraError("CHRONERA_OUT_OF_RANGE", "Range start must be earlier than or equal to range end.");
+        }
+    }
+    const collapse = options.collapse ?? "auto";
+    if (collapse === "auto" &&
+        typeof Intl !== "undefined" &&
+        typeof Intl.DateTimeFormat.prototype
+            .formatRange === "function" &&
+        options.preset === undefined) {
+        try {
+            const localeInfo = validateAndResolveLocale(options.locale);
+            const locale = localeInfo.baseLocale;
+            const cal = options.calendar ??
+                (start.kind === "calendar-date" ? start.calendar : "gregory");
+            const style = options.style ?? "medium";
+            let startDate;
+            let endDate;
+            if (start.kind === "local-date") {
+                const endLd = end;
+                startDate = new Date(Date.UTC(start.year, start.month - 1, start.day));
+                endDate = new Date(Date.UTC(endLd.year, endLd.month - 1, endLd.day));
+            }
+            else if (start.kind === "calendar-date") {
+                const endCd = end;
+                const startM = start.month ?? Number.parseInt(start.monthCode.slice(1), 10);
+                const endM = endCd.month ?? Number.parseInt(endCd.monthCode.slice(1), 10);
+                startDate = new Date(Date.UTC(start.year, startM - 1, start.day));
+                endDate = new Date(Date.UTC(endCd.year, endM - 1, endCd.day));
+            }
+            else {
+                startDate = new Date(start.epochMilliseconds);
+                endDate = new Date(end.epochMilliseconds);
+            }
+            const dtf = new Intl.DateTimeFormat(locale, {
+                dateStyle: style,
+                timeZone: options.timeZone ?? "UTC",
+                ...(cal !== "iso8601" ? { calendar: cal } : { calendar: "gregory" }),
+            });
+            return dtf.formatRange(startDate, endDate);
+        }
+        catch {
+            // Fall through to fallback formatting
+        }
+    }
+    // Fallback formatting: start – end
+    const startFormatted = formatDate(start, options);
+    const endFormatted = formatDate(end, options);
+    return `${startFormatted} – ${endFormatted}`;
+}
+//# sourceMappingURL=format-date-range.js.map

package/dist/format/format-date-range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-date-range.js","sourceRoot":"","sources":["../../src/format/format-date-range.ts"],"names":[],"mappings":"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","sourcesContent":["import { ChroneraError } from \"../errors/errors.js\";\nimport { compareInstants, compareLocalDates } from \"../operations/compare.js\";\nimport { formatDate } from \"./format-date.js\";\nimport { validateAndResolveLocale } from \"../locale/resolve-locale.js\";\n\nimport type {\n  CalendarDate,\n  DateRange,\n  FormatDateRangeOptions,\n  Instant,\n  LocalDate,\n} from \"../public-types.js\";\n\nexport function formatDateRange(\n  range: DateRange<LocalDate | CalendarDate | Instant>,\n  options: Readonly<FormatDateRangeOptions> = {},\n): string {\n  const { start, end } = range;\n\n  // Validate mixed input kinds\n  if (start.kind !== end.kind) {\n    throw new ChroneraError(\n      \"CHRONERA_INVALID_DATE\",\n      `Cannot format date range with mixed input kinds: \"${start.kind}\" and \"${end.kind}\".`,\n    );\n  }\n\n  // Validate ordering and timezone rules\n  if (start.kind === \"local-date\") {\n    if (options.timeZone !== undefined) {\n      throw new ChroneraError(\n        \"CHRONERA_INCOMPATIBLE_OPTION\",\n        \"Timezone option is forbidden for date-only ranges.\",\n      );\n    }\n    const cmp = compareLocalDates(start, end as LocalDate);\n    if (cmp > 0) {\n      throw new ChroneraError(\n        \"CHRONERA_OUT_OF_RANGE\",\n        \"Range start must be earlier than or equal to range end.\",\n      );\n    }\n  } else if (start.kind === \"calendar-date\") {\n    if (options.timeZone !== undefined) {\n      throw new ChroneraError(\n        \"CHRONERA_INCOMPATIBLE_OPTION\",\n        \"Timezone option is forbidden for calendar date ranges.\",\n      );\n    }\n    const endCal = end as CalendarDate;\n    if (start.calendar !== endCal.calendar) {\n      throw new ChroneraError(\n        \"CHRONERA_INVALID_CALENDAR\",\n        `Cannot format range with mixed calendars \"${start.calendar}\" and \"${endCal.calendar}\".`,\n      );\n    }\n    if (\n      start.year > endCal.year ||\n      (start.year === endCal.year && start.monthCode > endCal.monthCode) ||\n      (start.year === endCal.year &&\n        start.monthCode === endCal.monthCode &&\n        start.day > endCal.day)\n    ) {\n      throw new ChroneraError(\n        \"CHRONERA_OUT_OF_RANGE\",\n        \"Range start must be earlier than or equal to range end.\",\n      );\n    }\n  } else if (start.kind === \"instant\") {\n    const cmp = compareInstants(start, end as Instant);\n    if (cmp > 0) {\n      throw new ChroneraError(\n        \"CHRONERA_OUT_OF_RANGE\",\n        \"Range start must be earlier than or equal to range end.\",\n      );\n    }\n  }\n\n  const collapse = options.collapse ?? \"auto\";\n\n  if (\n    collapse === \"auto\" &&\n    typeof Intl !== \"undefined\" &&\n    typeof (Intl.DateTimeFormat.prototype as { formatRange?: unknown })\n      .formatRange === \"function\" &&\n    options.preset === undefined\n  ) {\n    try {\n      const localeInfo = validateAndResolveLocale(options.locale);\n      const locale = localeInfo.baseLocale;\n      const cal =\n        options.calendar ??\n        (start.kind === \"calendar-date\" ? start.calendar : \"gregory\");\n      const style = options.style ?? \"medium\";\n\n      let startDate: Date;\n      let endDate: Date;\n\n      if (start.kind === \"local-date\") {\n        const endLd = end as LocalDate;\n        startDate = new Date(Date.UTC(start.year, start.month - 1, start.day));\n        endDate = new Date(Date.UTC(endLd.year, endLd.month - 1, endLd.day));\n      } else if (start.kind === \"calendar-date\") {\n        const endCd = end as CalendarDate;\n        const startM =\n          start.month ?? Number.parseInt(start.monthCode.slice(1), 10);\n        const endM =\n          endCd.month ?? Number.parseInt(endCd.monthCode.slice(1), 10);\n        startDate = new Date(Date.UTC(start.year, startM - 1, start.day));\n        endDate = new Date(Date.UTC(endCd.year, endM - 1, endCd.day));\n      } else {\n        startDate = new Date(start.epochMilliseconds);\n        endDate = new Date((end as Instant).epochMilliseconds);\n      }\n\n      const dtf = new Intl.DateTimeFormat(locale, {\n        dateStyle: style as Intl.DateTimeFormatOptions[\"dateStyle\"],\n        timeZone: options.timeZone ?? \"UTC\",\n        ...(cal !== \"iso8601\" ? { calendar: cal } : { calendar: \"gregory\" }),\n      });\n\n      return (\n        dtf as unknown as { formatRange(a: Date, b: Date): string }\n      ).formatRange(startDate, endDate);\n    } catch {\n      // Fall through to fallback formatting\n    }\n  }\n\n  // Fallback formatting: start – end\n  const startFormatted = formatDate(start, options);\n  const endFormatted = formatDate(end, options);\n  return `${startFormatted} – ${endFormatted}`;\n}\n"]}

package/dist/format/format-date-time.d.ts

@@ -0,0 +1,2 @@
+import type { FormatDateTimeOptions, Instant, LocalDateTime } from "../public-types.js";
+export declare function formatDateTime(input: LocalDateTime | Instant | Date, options?: Readonly<FormatDateTimeOptions>): string;