@intech-software/chronera 0.1.0

package/dist/calendar/roc/adapter.js

@@ -0,0 +1,47 @@
+import { absoluteDayFromGregorianFields, gregorianFieldsFromAbsoluteDay, } from "../../core/absolute-day.js";
+import { formatGregorianMonthCode, parseGregorianMonthCode, } from "../../core/gregorian-math.js";
+import { ChroneraError } from "../../errors/errors.js";
+import { ROC_IDENTITY, ROC_OFFSET, ROC_START_ABSOLUTE_DAY, } from "./constants.js";
+import { rocValidator } from "./validator.js";
+export const rocAdapter = {
+    identity: ROC_IDENTITY,
+    validator: rocValidator,
+    converter: {
+        identity: ROC_IDENTITY,
+        toAbsoluteDay(date) {
+            const month = parseGregorianMonthCode(date.monthCode);
+            if (month === null) {
+                throw new ChroneraError("CHRONERA_INVALID_DATE", `Invalid monthCode: "${date.monthCode}". Expected M01-M12.`);
+            }
+            if (date.year < 1) {
+                throw new ChroneraError("CHRONERA_OUT_OF_RANGE", `ROC calendar supports years >= 1. Received year ${date.year}.`);
+            }
+            const gregorianYear = date.year + ROC_OFFSET;
+            if (gregorianYear > 9999) {
+                throw new ChroneraError("CHRONERA_OUT_OF_RANGE", `ROC date exceeds maximum Gregorian year 9999.`);
+            }
+            return absoluteDayFromGregorianFields(gregorianYear, month, date.day);
+        },
+        fromAbsoluteDay(absoluteDay) {
+            if (absoluteDay < ROC_START_ABSOLUTE_DAY) {
+                throw new ChroneraError("CHRONERA_OUT_OF_RANGE", `Date is before ROC calendar epoch (1912-01-01).`);
+            }
+            const fields = gregorianFieldsFromAbsoluteDay(absoluteDay);
+            if (fields.year > 9999) {
+                throw new ChroneraError("CHRONERA_OUT_OF_RANGE", `Date exceeds maximum supported year 9999.`);
+            }
+            const rocYear = fields.year - ROC_OFFSET;
+            return {
+                kind: "calendar-date",
+                calendar: "roc",
+                era: "roc",
+                eraYear: rocYear,
+                year: rocYear,
+                monthCode: formatGregorianMonthCode(fields.month),
+                month: fields.month,
+                day: fields.day,
+            };
+        },
+    },
+};
+//# sourceMappingURL=adapter.js.map

package/dist/calendar/roc/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/calendar/roc/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EACL,YAAY,EACZ,UAAU,EACV,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAK9C,MAAM,CAAC,MAAM,UAAU,GAAoB;IACzC,QAAQ,EAAE,YAAY;IACtB,SAAS,EAAE,YAAY;IACvB,SAAS,EAAE;QACT,QAAQ,EAAE,YAAY;QACtB,aAAa,CAAC,IAAkB;YAC9B,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACtD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,uBAAuB,IAAI,CAAC,SAAS,sBAAsB,CAC5D,CAAC;YACJ,CAAC;YAED,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBAClB,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,mDAAmD,IAAI,CAAC,IAAI,GAAG,CAChE,CAAC;YACJ,CAAC;YAED,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;YAC7C,IAAI,aAAa,GAAG,IAAI,EAAE,CAAC;gBACzB,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,+CAA+C,CAChD,CAAC;YACJ,CAAC;YAED,OAAO,8BAA8B,CAAC,aAAa,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACxE,CAAC;QAED,eAAe,CAAC,WAAmB;YACjC,IAAI,WAAW,GAAG,sBAAsB,EAAE,CAAC;gBACzC,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,iDAAiD,CAClD,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,8BAA8B,CAAC,WAAW,CAAC,CAAC;YAC3D,IAAI,MAAM,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC;gBACvB,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,2CAA2C,CAC5C,CAAC;YACJ,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,GAAG,UAAU,CAAC;YACzC,OAAO;gBACL,IAAI,EAAE,eAAe;gBACrB,QAAQ,EAAE,KAAK;gBACf,GAAG,EAAE,KAAK;gBACV,OAAO,EAAE,OAAO;gBAChB,IAAI,EAAE,OAAO;gBACb,SAAS,EAAE,wBAAwB,CAAC,MAAM,CAAC,KAAK,CAAC;gBACjD,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,GAAG,EAAE,MAAM,CAAC,GAAG;aAChB,CAAC;QACJ,CAAC;KACF;CACF,CAAC","sourcesContent":["import {\n  absoluteDayFromGregorianFields,\n  gregorianFieldsFromAbsoluteDay,\n} from \"../../core/absolute-day.js\";\nimport {\n  formatGregorianMonthCode,\n  parseGregorianMonthCode,\n} from \"../../core/gregorian-math.js\";\nimport { ChroneraError } from \"../../errors/errors.js\";\nimport {\n  ROC_IDENTITY,\n  ROC_OFFSET,\n  ROC_START_ABSOLUTE_DAY,\n} from \"./constants.js\";\nimport { rocValidator } from \"./validator.js\";\n\nimport type { CalendarAdapter } from \"../types.js\";\nimport type { CalendarDate } from \"../../public-types.js\";\n\nexport const rocAdapter: CalendarAdapter = {\n  identity: ROC_IDENTITY,\n  validator: rocValidator,\n  converter: {\n    identity: ROC_IDENTITY,\n    toAbsoluteDay(date: CalendarDate): number {\n      const month = parseGregorianMonthCode(date.monthCode);\n      if (month === null) {\n        throw new ChroneraError(\n          \"CHRONERA_INVALID_DATE\",\n          `Invalid monthCode: \"${date.monthCode}\". Expected M01-M12.`,\n        );\n      }\n\n      if (date.year < 1) {\n        throw new ChroneraError(\n          \"CHRONERA_OUT_OF_RANGE\",\n          `ROC calendar supports years >= 1. Received year ${date.year}.`,\n        );\n      }\n\n      const gregorianYear = date.year + ROC_OFFSET;\n      if (gregorianYear > 9999) {\n        throw new ChroneraError(\n          \"CHRONERA_OUT_OF_RANGE\",\n          `ROC date exceeds maximum Gregorian year 9999.`,\n        );\n      }\n\n      return absoluteDayFromGregorianFields(gregorianYear, month, date.day);\n    },\n\n    fromAbsoluteDay(absoluteDay: number): CalendarDate {\n      if (absoluteDay < ROC_START_ABSOLUTE_DAY) {\n        throw new ChroneraError(\n          \"CHRONERA_OUT_OF_RANGE\",\n          `Date is before ROC calendar epoch (1912-01-01).`,\n        );\n      }\n\n      const fields = gregorianFieldsFromAbsoluteDay(absoluteDay);\n      if (fields.year > 9999) {\n        throw new ChroneraError(\n          \"CHRONERA_OUT_OF_RANGE\",\n          `Date exceeds maximum supported year 9999.`,\n        );\n      }\n\n      const rocYear = fields.year - ROC_OFFSET;\n      return {\n        kind: \"calendar-date\",\n        calendar: \"roc\",\n        era: \"roc\",\n        eraYear: rocYear,\n        year: rocYear,\n        monthCode: formatGregorianMonthCode(fields.month),\n        month: fields.month,\n        day: fields.day,\n      };\n    },\n  },\n};\n"]}

package/dist/calendar/roc/constants.d.ts

@@ -0,0 +1,6 @@
+import type { CalendarIdentity } from "../types.js";
+export declare const ROC_OFFSET = 1911;
+export declare const ROC_START_ABSOLUTE_DAY = -21185;
+export declare const ROC_IDENTITY: CalendarIdentity;
+export declare const TAIWAN_WEEKDAY_NAMES: readonly ["星期日", "星期一", "星期二", "星期三", "星期四", "星期五", "星期六"];
+export declare const TAIWAN_WEEKDAY_SHORT: readonly ["日", "一", "二", "三", "四", "五", "六"];

package/dist/calendar/roc/constants.js

@@ -0,0 +1,34 @@
+import { MAX_ABSOLUTE_DAY } from "../../core/absolute-day.js";
+export const ROC_OFFSET = 1911;
+// 1912-01-01 (Minguo 1)
+export const ROC_START_ABSOLUTE_DAY = -21185;
+export const ROC_IDENTITY = {
+    id: "roc",
+    algorithm: "chronera-roc-v1",
+    deterministic: true,
+    validRange: {
+        first: ROC_START_ABSOLUTE_DAY,
+        last: MAX_ABSOLUTE_DAY,
+    },
+    validFrom: { kind: "local-date", year: 1912, month: 1, day: 1 },
+    validTo: { kind: "local-date", year: 9999, month: 12, day: 31 },
+};
+export const TAIWAN_WEEKDAY_NAMES = [
+    "星期日",
+    "星期一",
+    "星期二",
+    "星期三",
+    "星期四",
+    "星期五",
+    "星期六",
+];
+export const TAIWAN_WEEKDAY_SHORT = [
+    "日",
+    "一",
+    "二",
+    "三",
+    "四",
+    "五",
+    "六",
+];
+//# sourceMappingURL=constants.js.map

package/dist/calendar/roc/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/calendar/roc/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAG9D,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC;AAE/B,wBAAwB;AACxB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAK,CAAC;AAE7C,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C,EAAE,EAAE,KAAK;IACT,SAAS,EAAE,iBAAiB;IAC5B,aAAa,EAAE,IAAI;IACnB,UAAU,EAAE;QACV,KAAK,EAAE,sBAAsB;QAC7B,IAAI,EAAE,gBAAgB;KACvB;IACD,SAAS,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;IAC/D,OAAO,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;CAChE,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;CACG,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;CACK,CAAC","sourcesContent":["import { MAX_ABSOLUTE_DAY } from \"../../core/absolute-day.js\";\nimport type { CalendarIdentity } from \"../types.js\";\n\nexport const ROC_OFFSET = 1911;\n\n// 1912-01-01 (Minguo 1)\nexport const ROC_START_ABSOLUTE_DAY = -21185;\n\nexport const ROC_IDENTITY: CalendarIdentity = {\n  id: \"roc\",\n  algorithm: \"chronera-roc-v1\",\n  deterministic: true,\n  validRange: {\n    first: ROC_START_ABSOLUTE_DAY,\n    last: MAX_ABSOLUTE_DAY,\n  },\n  validFrom: { kind: \"local-date\", year: 1912, month: 1, day: 1 },\n  validTo: { kind: \"local-date\", year: 9999, month: 12, day: 31 },\n};\n\nexport const TAIWAN_WEEKDAY_NAMES = [\n  \"星期日\",\n  \"星期一\",\n  \"星期二\",\n  \"星期三\",\n  \"星期四\",\n  \"星期五\",\n  \"星期六\",\n] as const;\n\nexport const TAIWAN_WEEKDAY_SHORT = [\n  \"日\",\n  \"一\",\n  \"二\",\n  \"三\",\n  \"四\",\n  \"五\",\n  \"六\",\n] as const;\n"]}

package/dist/calendar/roc/index.d.ts

@@ -0,0 +1,3 @@
+export { ROC_OFFSET, ROC_START_ABSOLUTE_DAY, TAIWAN_WEEKDAY_NAMES, TAIWAN_WEEKDAY_SHORT, } from "./constants.js";
+export { rocValidator, assertRocDate } from "./validator.js";
+export { rocAdapter } from "./adapter.js";

package/dist/calendar/roc/index.js

@@ -0,0 +1,4 @@
+export { ROC_OFFSET, ROC_START_ABSOLUTE_DAY, TAIWAN_WEEKDAY_NAMES, TAIWAN_WEEKDAY_SHORT, } from "./constants.js";
+export { rocValidator, assertRocDate } from "./validator.js";
+export { rocAdapter } from "./adapter.js";
+//# sourceMappingURL=index.js.map

package/dist/calendar/roc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/calendar/roc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC","sourcesContent":["export {\n  ROC_OFFSET,\n  ROC_START_ABSOLUTE_DAY,\n  TAIWAN_WEEKDAY_NAMES,\n  TAIWAN_WEEKDAY_SHORT,\n} from \"./constants.js\";\nexport { rocValidator, assertRocDate } from \"./validator.js\";\nexport { rocAdapter } from \"./adapter.js\";\n"]}

package/dist/calendar/roc/validator.d.ts

@@ -0,0 +1,4 @@
+import type { CalendarValidator } from "../types.js";
+import type { CalendarDate } from "../../public-types.js";
+export declare function assertRocDate(date: CalendarDate): void;
+export declare const rocValidator: CalendarValidator;

package/dist/calendar/roc/validator.js

@@ -0,0 +1,52 @@
+import { daysInGregorianMonth, isGregorianLeapYear, parseGregorianMonthCode, } from "../../core/gregorian-math.js";
+import { ChroneraError } from "../../errors/errors.js";
+import { ROC_IDENTITY, ROC_OFFSET } from "./constants.js";
+export function assertRocDate(date) {
+    if (date.calendar !== "roc") {
+        throw new ChroneraError("CHRONERA_INVALID_CALENDAR", `Expected calendar "roc", received "${date.calendar}".`);
+    }
+}
+export const rocValidator = {
+    identity: ROC_IDENTITY,
+    validate(date) {
+        assertRocDate(date);
+        const issues = [];
+        const monthNum = parseGregorianMonthCode(date.monthCode);
+        if (monthNum === null) {
+            issues.push({
+                code: "CHRONERA_INVALID_DATE",
+                message: `Invalid monthCode: "${date.monthCode}". Expected M01-M12.`,
+                path: ["monthCode"],
+            });
+            return issues;
+        }
+        const gregorianYear = date.year + ROC_OFFSET;
+        if (date.year < 1 || gregorianYear > 9999) {
+            issues.push({
+                code: "CHRONERA_OUT_OF_RANGE",
+                message: `ROC calendar supports years >= 1 (Gregorian 1912-9999). Received year: ${date.year}.`,
+                path: ["year"],
+            });
+        }
+        const maxDays = daysInGregorianMonth(gregorianYear, monthNum);
+        if (date.day < 1 || date.day > maxDays) {
+            issues.push({
+                code: "CHRONERA_INVALID_DATE",
+                message: `Invalid day ${date.day} for ROC year ${date.year} month ${monthNum}. Expected 1..${maxDays}.`,
+                path: ["day"],
+            });
+        }
+        return issues;
+    },
+    daysInMonth(year, monthCode) {
+        const month = parseGregorianMonthCode(monthCode);
+        if (month === null) {
+            throw new ChroneraError("CHRONERA_INVALID_DATE", `Invalid monthCode: "${monthCode}". Expected M01-M12.`);
+        }
+        return daysInGregorianMonth(year + ROC_OFFSET, month);
+    },
+    isLeapYear(year) {
+        return isGregorianLeapYear(year + ROC_OFFSET);
+    },
+};
+//# sourceMappingURL=validator.js.map

package/dist/calendar/roc/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../../src/calendar/roc/validator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAS1D,MAAM,UAAU,aAAa,CAAC,IAAkB;IAC9C,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;QAC5B,MAAM,IAAI,aAAa,CACrB,2BAA2B,EAC3B,sCAAsC,IAAI,CAAC,QAAQ,IAAI,CACxD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAsB;IAC7C,QAAQ,EAAE,YAAY;IAEtB,QAAQ,CAAC,IAAkB;QACzB,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,MAAM,MAAM,GAAoB,EAAE,CAAC;QAEnC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,uBAAuB;gBAC7B,OAAO,EAAE,uBAAuB,IAAI,CAAC,SAAS,sBAAsB;gBACpE,IAAI,EAAE,CAAC,WAAW,CAAC;aACpB,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QAC7C,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,aAAa,GAAG,IAAI,EAAE,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,uBAAuB;gBAC7B,OAAO,EAAE,0EAA0E,IAAI,CAAC,IAAI,GAAG;gBAC/F,IAAI,EAAE,CAAC,MAAM,CAAC;aACf,CAAC,CAAC;QACL,CAAC;QAED,MAAM,OAAO,GAAG,oBAAoB,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QAC9D,IAAI,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,GAAG,OAAO,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,uBAAuB;gBAC7B,OAAO,EAAE,eAAe,IAAI,CAAC,GAAG,iBAAiB,IAAI,CAAC,IAAI,UAAU,QAAQ,iBAAiB,OAAO,GAAG;gBACvG,IAAI,EAAE,CAAC,KAAK,CAAC;aACd,CAAC,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,WAAW,CAAC,IAAY,EAAE,SAAoB;QAC5C,MAAM,KAAK,GAAG,uBAAuB,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,uBAAuB,SAAS,sBAAsB,CACvD,CAAC;QACJ,CAAC;QACD,OAAO,oBAAoB,CAAC,IAAI,GAAG,UAAU,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,OAAO,mBAAmB,CAAC,IAAI,GAAG,UAAU,CAAC,CAAC;IAChD,CAAC;CACF,CAAC","sourcesContent":["import {\n  daysInGregorianMonth,\n  isGregorianLeapYear,\n  parseGregorianMonthCode,\n} from \"../../core/gregorian-math.js\";\nimport { ChroneraError } from \"../../errors/errors.js\";\nimport { ROC_IDENTITY, ROC_OFFSET } from \"./constants.js\";\n\nimport type { CalendarValidator } from \"../types.js\";\nimport type {\n  CalendarDate,\n  ChroneraIssue,\n  MonthCode,\n} from \"../../public-types.js\";\n\nexport function assertRocDate(date: CalendarDate): void {\n  if (date.calendar !== \"roc\") {\n    throw new ChroneraError(\n      \"CHRONERA_INVALID_CALENDAR\",\n      `Expected calendar \"roc\", received \"${date.calendar}\".`,\n    );\n  }\n}\n\nexport const rocValidator: CalendarValidator = {\n  identity: ROC_IDENTITY,\n\n  validate(date: CalendarDate): readonly ChroneraIssue[] {\n    assertRocDate(date);\n    const issues: ChroneraIssue[] = [];\n\n    const monthNum = parseGregorianMonthCode(date.monthCode);\n    if (monthNum === null) {\n      issues.push({\n        code: \"CHRONERA_INVALID_DATE\",\n        message: `Invalid monthCode: \"${date.monthCode}\". Expected M01-M12.`,\n        path: [\"monthCode\"],\n      });\n      return issues;\n    }\n\n    const gregorianYear = date.year + ROC_OFFSET;\n    if (date.year < 1 || gregorianYear > 9999) {\n      issues.push({\n        code: \"CHRONERA_OUT_OF_RANGE\",\n        message: `ROC calendar supports years >= 1 (Gregorian 1912-9999). Received year: ${date.year}.`,\n        path: [\"year\"],\n      });\n    }\n\n    const maxDays = daysInGregorianMonth(gregorianYear, monthNum);\n    if (date.day < 1 || date.day > maxDays) {\n      issues.push({\n        code: \"CHRONERA_INVALID_DATE\",\n        message: `Invalid day ${date.day} for ROC year ${date.year} month ${monthNum}. Expected 1..${maxDays}.`,\n        path: [\"day\"],\n      });\n    }\n\n    return issues;\n  },\n\n  daysInMonth(year: number, monthCode: MonthCode): number {\n    const month = parseGregorianMonthCode(monthCode);\n    if (month === null) {\n      throw new ChroneraError(\n        \"CHRONERA_INVALID_DATE\",\n        `Invalid monthCode: \"${monthCode}\". Expected M01-M12.`,\n      );\n    }\n    return daysInGregorianMonth(year + ROC_OFFSET, month);\n  },\n\n  isLeapYear(year: number): boolean {\n    return isGregorianLeapYear(year + ROC_OFFSET);\n  },\n};\n"]}

package/dist/calendar/types.d.ts

@@ -0,0 +1,34 @@
+import type { CalendarDate, CalendarId, ChroneraIssue, Duration, LocalDate, MonthCode } from "../public-types.js";
+export interface CalendarIdentity {
+    readonly id: CalendarId;
+    readonly algorithm: string;
+    readonly deterministic: boolean;
+    readonly dataVersion?: string;
+    readonly validRange: {
+        readonly first: number;
+        readonly last: number;
+    };
+    readonly validFrom?: LocalDate;
+    readonly validTo?: LocalDate;
+}
+export interface CalendarConverter {
+    readonly identity: CalendarIdentity;
+    toAbsoluteDay(date: CalendarDate): number;
+    fromAbsoluteDay(day: number): CalendarDate;
+}
+export interface CalendarValidator {
+    readonly identity: CalendarIdentity;
+    validate(date: CalendarDate): readonly ChroneraIssue[];
+    daysInMonth(year: number, monthCode: MonthCode): number;
+    isLeapYear(year: number): boolean;
+}
+export interface CalendarArithmetic {
+    readonly identity: CalendarIdentity;
+    add(date: CalendarDate, duration: Duration, overflow: "constrain" | "reject"): CalendarDate;
+}
+export interface CalendarAdapter {
+    readonly identity: CalendarIdentity;
+    readonly converter?: CalendarConverter;
+    readonly validator: CalendarValidator;
+    readonly arithmetic?: CalendarArithmetic;
+}

package/dist/calendar/types.js

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

package/dist/calendar/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/calendar/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  CalendarDate,\n  CalendarId,\n  ChroneraIssue,\n  Duration,\n  LocalDate,\n  MonthCode,\n} from \"../public-types.js\";\n\nexport interface CalendarIdentity {\n  readonly id: CalendarId;\n  readonly algorithm: string;\n  readonly deterministic: boolean;\n  readonly dataVersion?: string;\n  readonly validRange: {\n    readonly first: number;\n    readonly last: number;\n  };\n  readonly validFrom?: LocalDate;\n  readonly validTo?: LocalDate;\n}\n\nexport interface CalendarConverter {\n  readonly identity: CalendarIdentity;\n  toAbsoluteDay(date: CalendarDate): number;\n  fromAbsoluteDay(day: number): CalendarDate;\n}\n\nexport interface CalendarValidator {\n  readonly identity: CalendarIdentity;\n  validate(date: CalendarDate): readonly ChroneraIssue[];\n  daysInMonth(year: number, monthCode: MonthCode): number;\n  isLeapYear(year: number): boolean;\n}\n\nexport interface CalendarArithmetic {\n  readonly identity: CalendarIdentity;\n  add(\n    date: CalendarDate,\n    duration: Duration,\n    overflow: \"constrain\" | \"reject\",\n  ): CalendarDate;\n}\n\nexport interface CalendarAdapter {\n  readonly identity: CalendarIdentity;\n  readonly converter?: CalendarConverter;\n  readonly validator: CalendarValidator;\n  readonly arithmetic?: CalendarArithmetic;\n}\n"]}

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

@@ -0,0 +1,8 @@
+export declare const MIN_ABSOLUTE_DAY = -719162;
+export declare const MAX_ABSOLUTE_DAY = 2932896;
+export declare function absoluteDayFromGregorianFields(year: number, month: number, day: number): number;
+export declare function gregorianFieldsFromAbsoluteDay(absoluteDay: number): {
+    year: number;
+    month: number;
+    day: number;
+};

package/dist/core/absolute-day.js

@@ -0,0 +1,39 @@
+import { ChroneraError } from "../errors/errors.js";
+export const MIN_ABSOLUTE_DAY = -719162;
+export const MAX_ABSOLUTE_DAY = 2932896;
+const DAY_OFFSET = 719468;
+export function absoluteDayFromGregorianFields(year, month, day) {
+    const y = month <= 2 ? year - 1 : year;
+    const era = Math.floor(y >= 0 ? y / 400 : (y - 399) / 400);
+    const yoe = y - era * 400;
+    const doy = Math.floor((153 * (month > 2 ? month - 3 : month + 9) + 2) / 5) + day - 1;
+    const doe = yoe * 365 + Math.floor(yoe / 4) - Math.floor(yoe / 100) + doy;
+    const absoluteDay = era * 146097 + doe - DAY_OFFSET;
+    if (absoluteDay < MIN_ABSOLUTE_DAY || absoluteDay > MAX_ABSOLUTE_DAY) {
+        throw new ChroneraError("CHRONERA_OUT_OF_RANGE", `Date ${year}-${String(month).padStart(2, "0")}-${String(day).padStart(2, "0")} is outside supported absolute day range [${MIN_ABSOLUTE_DAY}, ${MAX_ABSOLUTE_DAY}].`);
+    }
+    return absoluteDay;
+}
+export function gregorianFieldsFromAbsoluteDay(absoluteDay) {
+    if (!Number.isSafeInteger(absoluteDay) ||
+        absoluteDay < MIN_ABSOLUTE_DAY ||
+        absoluteDay > MAX_ABSOLUTE_DAY) {
+        throw new ChroneraError("CHRONERA_OUT_OF_RANGE", `Absolute day ${absoluteDay} is outside supported range [${MIN_ABSOLUTE_DAY}, ${MAX_ABSOLUTE_DAY}].`);
+    }
+    const z = absoluteDay + DAY_OFFSET;
+    const era = Math.floor(z >= 0 ? z / 146097 : (z - 146096) / 146097);
+    const doe = z - era * 146097;
+    const yoe = Math.floor((doe -
+        Math.floor(doe / 1460) +
+        Math.floor(doe / 36524) -
+        Math.floor(doe / 146096)) /
+        365);
+    const y = yoe + era * 400;
+    const doy = doe - (365 * yoe + Math.floor(yoe / 4) - Math.floor(yoe / 100));
+    const mp = Math.floor((5 * doy + 2) / 153);
+    const day = doy - Math.floor((153 * mp + 2) / 5) + 1;
+    const month = mp < 10 ? mp + 3 : mp - 9;
+    const year = month <= 2 ? y + 1 : y;
+    return { year, month, day };
+}
+//# sourceMappingURL=absolute-day.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"absolute-day.js","sourceRoot":"","sources":["../../src/core/absolute-day.ts"],"names":[],"mappings":"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","sourcesContent":["import { ChroneraError } from \"../errors/errors.js\";\n\nexport const MIN_ABSOLUTE_DAY = -719162;\nexport const MAX_ABSOLUTE_DAY = 2932896;\n\nconst DAY_OFFSET = 719468;\n\nexport function absoluteDayFromGregorianFields(\n  year: number,\n  month: number,\n  day: number,\n): number {\n  const y = month <= 2 ? year - 1 : year;\n  const era = Math.floor(y >= 0 ? y / 400 : (y - 399) / 400);\n  const yoe = y - era * 400;\n  const doy =\n    Math.floor((153 * (month > 2 ? month - 3 : month + 9) + 2) / 5) + day - 1;\n  const doe = yoe * 365 + Math.floor(yoe / 4) - Math.floor(yoe / 100) + doy;\n  const absoluteDay = era * 146097 + doe - DAY_OFFSET;\n\n  if (absoluteDay < MIN_ABSOLUTE_DAY || absoluteDay > MAX_ABSOLUTE_DAY) {\n    throw new ChroneraError(\n      \"CHRONERA_OUT_OF_RANGE\",\n      `Date ${year}-${String(month).padStart(2, \"0\")}-${String(day).padStart(2, \"0\")} is outside supported absolute day range [${MIN_ABSOLUTE_DAY}, ${MAX_ABSOLUTE_DAY}].`,\n    );\n  }\n\n  return absoluteDay;\n}\n\nexport function gregorianFieldsFromAbsoluteDay(absoluteDay: number): {\n  year: number;\n  month: number;\n  day: number;\n} {\n  if (\n    !Number.isSafeInteger(absoluteDay) ||\n    absoluteDay < MIN_ABSOLUTE_DAY ||\n    absoluteDay > MAX_ABSOLUTE_DAY\n  ) {\n    throw new ChroneraError(\n      \"CHRONERA_OUT_OF_RANGE\",\n      `Absolute day ${absoluteDay} is outside supported range [${MIN_ABSOLUTE_DAY}, ${MAX_ABSOLUTE_DAY}].`,\n    );\n  }\n\n  const z = absoluteDay + DAY_OFFSET;\n  const era = Math.floor(z >= 0 ? z / 146097 : (z - 146096) / 146097);\n  const doe = z - era * 146097;\n  const yoe = Math.floor(\n    (doe -\n      Math.floor(doe / 1460) +\n      Math.floor(doe / 36524) -\n      Math.floor(doe / 146096)) /\n      365,\n  );\n  const y = yoe + era * 400;\n  const doy = doe - (365 * yoe + Math.floor(yoe / 4) - Math.floor(yoe / 100));\n  const mp = Math.floor((5 * doy + 2) / 153);\n  const day = doy - Math.floor((153 * mp + 2) / 5) + 1;\n  const month = mp < 10 ? mp + 3 : mp - 9;\n  const year = month <= 2 ? y + 1 : y;\n\n  return { year, month, day };\n}\n"]}

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

@@ -0,0 +1,11 @@
+import type { CalendarDate, CalendarId, EraId, MonthCode } from "../public-types.js";
+export interface CalendarDateInit {
+    calendar: CalendarId;
+    year: number;
+    monthCode: MonthCode;
+    day: number;
+    era?: EraId;
+    eraYear?: number;
+    month?: number;
+}
+export declare function calendarDate(init: CalendarDateInit): CalendarDate;

package/dist/core/calendar-date.js

@@ -0,0 +1,37 @@
+import { ChroneraError } from "../errors/errors.js";
+import { requireInteger } from "./integer.js";
+export function calendarDate(init) {
+    if (!init || typeof init !== "object") {
+        throw new ChroneraError("CHRONERA_INVALID_DATE", "Expected calendar date fields object.");
+    }
+    if (!init.calendar || typeof init.calendar !== "string") {
+        throw new ChroneraError("CHRONERA_INVALID_CALENDAR", `Invalid calendar identifier: ${String(init.calendar)}.`);
+    }
+    requireInteger("year", init.year);
+    requireInteger("day", init.day);
+    if (typeof init.monthCode !== "string" || !init.monthCode.startsWith("M")) {
+        throw new ChroneraError("CHRONERA_INVALID_DATE", `Invalid month code: ${String(init.monthCode)}. Must start with 'M'.`);
+    }
+    if (init.month !== undefined) {
+        requireInteger("month", init.month);
+    }
+    if (init.eraYear !== undefined) {
+        requireInteger("eraYear", init.eraYear);
+    }
+    let month = init.month;
+    if (month === undefined && /^M\d{2}$/.test(init.monthCode)) {
+        month = Number.parseInt(init.monthCode.slice(1), 10);
+    }
+    const result = {
+        kind: "calendar-date",
+        calendar: init.calendar,
+        year: init.year,
+        monthCode: init.monthCode,
+        day: init.day,
+        ...(init.era !== undefined ? { era: init.era } : {}),
+        ...(init.eraYear !== undefined ? { eraYear: init.eraYear } : {}),
+        ...(month !== undefined ? { month } : {}),
+    };
+    return result;
+}
+//# sourceMappingURL=calendar-date.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-date.js","sourceRoot":"","sources":["../../src/core/calendar-date.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAmB9C,MAAM,UAAU,YAAY,CAAC,IAAsB;IACjD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,uCAAuC,CACxC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACxD,MAAM,IAAI,aAAa,CACrB,2BAA2B,EAC3B,gCAAgC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CACzD,CAAC;IACJ,CAAC;IAED,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAEhC,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1E,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,uBAAuB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,wBAAwB,CACtE,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/B,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACvB,IAAI,KAAK,KAAK,SAAS,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3D,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,MAAM,GAAiB;QAC3B,IAAI,EAAE,eAAe;QACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1C,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import { ChroneraError } from \"../errors/errors.js\";\nimport { requireInteger } from \"./integer.js\";\n\nimport type {\n  CalendarDate,\n  CalendarId,\n  EraId,\n  MonthCode,\n} from \"../public-types.js\";\n\nexport interface CalendarDateInit {\n  calendar: CalendarId;\n  year: number;\n  monthCode: MonthCode;\n  day: number;\n  era?: EraId;\n  eraYear?: number;\n  month?: number;\n}\n\nexport function calendarDate(init: CalendarDateInit): CalendarDate {\n  if (!init || typeof init !== \"object\") {\n    throw new ChroneraError(\n      \"CHRONERA_INVALID_DATE\",\n      \"Expected calendar date fields object.\",\n    );\n  }\n\n  if (!init.calendar || typeof init.calendar !== \"string\") {\n    throw new ChroneraError(\n      \"CHRONERA_INVALID_CALENDAR\",\n      `Invalid calendar identifier: ${String(init.calendar)}.`,\n    );\n  }\n\n  requireInteger(\"year\", init.year);\n  requireInteger(\"day\", init.day);\n\n  if (typeof init.monthCode !== \"string\" || !init.monthCode.startsWith(\"M\")) {\n    throw new ChroneraError(\n      \"CHRONERA_INVALID_DATE\",\n      `Invalid month code: ${String(init.monthCode)}. Must start with 'M'.`,\n    );\n  }\n\n  if (init.month !== undefined) {\n    requireInteger(\"month\", init.month);\n  }\n\n  if (init.eraYear !== undefined) {\n    requireInteger(\"eraYear\", init.eraYear);\n  }\n\n  let month = init.month;\n  if (month === undefined && /^M\\d{2}$/.test(init.monthCode)) {\n    month = Number.parseInt(init.monthCode.slice(1), 10);\n  }\n\n  const result: CalendarDate = {\n    kind: \"calendar-date\",\n    calendar: init.calendar,\n    year: init.year,\n    monthCode: init.monthCode,\n    day: init.day,\n    ...(init.era !== undefined ? { era: init.era } : {}),\n    ...(init.eraYear !== undefined ? { eraYear: init.eraYear } : {}),\n    ...(month !== undefined ? { month } : {}),\n  };\n\n  return result;\n}\n"]}

package/dist/core/day-of-year.d.ts

@@ -0,0 +1,16 @@
+export interface DayOfYearFields {
+    readonly year: number;
+    readonly dayOfYear: number;
+}
+/**
+ * Calculates the ordinal day of year (1..366) from an absolute day.
+ */
+export declare function getDayOfYearFromAbsoluteDay(absoluteDay: number): DayOfYearFields;
+/**
+ * Calculates the ordinal day of year (1..366) from Gregorian year, month, and day.
+ */
+export declare function getDayOfYearFromGregorianFields(year: number, month: number, day: number): number;
+/**
+ * Formats an ISO 8601 ordinal date string: YYYY-DDD (e.g. 2026-245).
+ */
+export declare function formatOrdinalDate(year: number, dayOfYear: number): string;

package/dist/core/day-of-year.js

@@ -0,0 +1,30 @@
+import { absoluteDayFromGregorianFields, gregorianFieldsFromAbsoluteDay, } from "./absolute-day.js";
+/**
+ * Calculates the ordinal day of year (1..366) from an absolute day.
+ */
+export function getDayOfYearFromAbsoluteDay(absoluteDay) {
+    const fields = gregorianFieldsFromAbsoluteDay(absoluteDay);
+    const startOfYearAbsDay = absoluteDayFromGregorianFields(fields.year, 1, 1);
+    const dayOfYear = absoluteDay - startOfYearAbsDay + 1;
+    return {
+        year: fields.year,
+        dayOfYear,
+    };
+}
+/**
+ * Calculates the ordinal day of year (1..366) from Gregorian year, month, and day.
+ */
+export function getDayOfYearFromGregorianFields(year, month, day) {
+    const targetAbsDay = absoluteDayFromGregorianFields(year, month, day);
+    const startOfYearAbsDay = absoluteDayFromGregorianFields(year, 1, 1);
+    return targetAbsDay - startOfYearAbsDay + 1;
+}
+/**
+ * Formats an ISO 8601 ordinal date string: YYYY-DDD (e.g. 2026-245).
+ */
+export function formatOrdinalDate(year, dayOfYear) {
+    const paddedYear = String(year).padStart(4, "0");
+    const paddedDoy = String(dayOfYear).padStart(3, "0");
+    return `${paddedYear}-${paddedDoy}`;
+}
+//# sourceMappingURL=day-of-year.js.map

package/dist/core/day-of-year.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"day-of-year.js","sourceRoot":"","sources":["../../src/core/day-of-year.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,mBAAmB,CAAC;AAO3B;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,WAAmB;IAEnB,MAAM,MAAM,GAAG,8BAA8B,CAAC,WAAW,CAAC,CAAC;IAC3D,MAAM,iBAAiB,GAAG,8BAA8B,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5E,MAAM,SAAS,GAAG,WAAW,GAAG,iBAAiB,GAAG,CAAC,CAAC;IACtD,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAC7C,IAAY,EACZ,KAAa,EACb,GAAW;IAEX,MAAM,YAAY,GAAG,8BAA8B,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IACtE,MAAM,iBAAiB,GAAG,8BAA8B,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACrE,OAAO,YAAY,GAAG,iBAAiB,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,SAAiB;IAC/D,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACrD,OAAO,GAAG,UAAU,IAAI,SAAS,EAAE,CAAC;AACtC,CAAC","sourcesContent":["import {\n  absoluteDayFromGregorianFields,\n  gregorianFieldsFromAbsoluteDay,\n} from \"./absolute-day.js\";\n\nexport interface DayOfYearFields {\n  readonly year: number;\n  readonly dayOfYear: number;\n}\n\n/**\n * Calculates the ordinal day of year (1..366) from an absolute day.\n */\nexport function getDayOfYearFromAbsoluteDay(\n  absoluteDay: number,\n): DayOfYearFields {\n  const fields = gregorianFieldsFromAbsoluteDay(absoluteDay);\n  const startOfYearAbsDay = absoluteDayFromGregorianFields(fields.year, 1, 1);\n  const dayOfYear = absoluteDay - startOfYearAbsDay + 1;\n  return {\n    year: fields.year,\n    dayOfYear,\n  };\n}\n\n/**\n * Calculates the ordinal day of year (1..366) from Gregorian year, month, and day.\n */\nexport function getDayOfYearFromGregorianFields(\n  year: number,\n  month: number,\n  day: number,\n): number {\n  const targetAbsDay = absoluteDayFromGregorianFields(year, month, day);\n  const startOfYearAbsDay = absoluteDayFromGregorianFields(year, 1, 1);\n  return targetAbsDay - startOfYearAbsDay + 1;\n}\n\n/**\n * Formats an ISO 8601 ordinal date string: YYYY-DDD (e.g. 2026-245).\n */\nexport function formatOrdinalDate(year: number, dayOfYear: number): string {\n  const paddedYear = String(year).padStart(4, \"0\");\n  const paddedDoy = String(dayOfYear).padStart(3, \"0\");\n  return `${paddedYear}-${paddedDoy}`;\n}\n"]}

package/dist/core/duration.d.ts

@@ -0,0 +1,2 @@
+import type { Duration } from "../public-types.js";
+export declare function duration(init: Duration): Duration;

package/dist/core/duration.js

@@ -0,0 +1,31 @@
+import { ChroneraError } from "../errors/errors.js";
+import { requireInteger } from "./integer.js";
+export function duration(init) {
+    let hasPositive = false;
+    let hasNegative = false;
+    const fields = [
+        "years",
+        "months",
+        "weeks",
+        "days",
+        "hours",
+        "minutes",
+        "seconds",
+        "milliseconds",
+    ];
+    for (const field of fields) {
+        const val = init[field];
+        if (val !== undefined) {
+            requireInteger(field, val);
+            if (val > 0)
+                hasPositive = true;
+            if (val < 0)
+                hasNegative = true;
+        }
+    }
+    if (hasPositive && hasNegative) {
+        throw new ChroneraError("CHRONERA_INCOMPATIBLE_OPTION", "Mixed-sign duration fields are not supported.");
+    }
+    return { ...init };
+}
+//# sourceMappingURL=duration.js.map

package/dist/core/duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.js","sourceRoot":"","sources":["../../src/core/duration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAI9C,MAAM,UAAU,QAAQ,CAAC,IAAc;IACrC,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,WAAW,GAAG,KAAK,CAAC;IAExB,MAAM,MAAM,GAAuB;QACjC,OAAO;QACP,QAAQ;QACR,OAAO;QACP,MAAM;QACN,OAAO;QACP,SAAS;QACT,SAAS;QACT,cAAc;KACf,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC3B,IAAI,GAAG,GAAG,CAAC;gBAAE,WAAW,GAAG,IAAI,CAAC;YAChC,IAAI,GAAG,GAAG,CAAC;gBAAE,WAAW,GAAG,IAAI,CAAC;QAClC,CAAC;IACH,CAAC;IAED,IAAI,WAAW,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,IAAI,aAAa,CACrB,8BAA8B,EAC9B,+CAA+C,CAChD,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;AACrB,CAAC","sourcesContent":["import { ChroneraError } from \"../errors/errors.js\";\nimport { requireInteger } from \"./integer.js\";\n\nimport type { Duration } from \"../public-types.js\";\n\nexport function duration(init: Duration): Duration {\n  let hasPositive = false;\n  let hasNegative = false;\n\n  const fields: (keyof Duration)[] = [\n    \"years\",\n    \"months\",\n    \"weeks\",\n    \"days\",\n    \"hours\",\n    \"minutes\",\n    \"seconds\",\n    \"milliseconds\",\n  ];\n\n  for (const field of fields) {\n    const val = init[field];\n    if (val !== undefined) {\n      requireInteger(field, val);\n      if (val > 0) hasPositive = true;\n      if (val < 0) hasNegative = true;\n    }\n  }\n\n  if (hasPositive && hasNegative) {\n    throw new ChroneraError(\n      \"CHRONERA_INCOMPATIBLE_OPTION\",\n      \"Mixed-sign duration fields are not supported.\",\n    );\n  }\n\n  return { ...init };\n}\n"]}

package/dist/core/fiscal.d.ts

@@ -0,0 +1,31 @@
+export type QuarterNumber = 1 | 2 | 3 | 4;
+export interface FiscalOptions {
+    /**
+     * Starting month of the fiscal year (1..12). Defaults to 1 (calendar year).
+     * Common corporate/governmental standards:
+     * - 1: Calendar year (US corporate default, China, Germany)
+     * - 4: April 1 (United Kingdom, Japan, India, Canada)
+     * - 7: July 1 (Australia, New Zealand)
+     * - 10: October 1 (United States Federal Government)
+     */
+    readonly startMonth?: number;
+    /**
+     * Whether the fiscal year is labeled by the year it ends (standard in US/UK accounting)
+     * or the year it starts. Defaults to "endYear".
+     */
+    readonly label?: "endYear" | "startYear";
+}
+export interface FiscalFields {
+    readonly fiscalYear: number;
+    readonly fiscalQuarter: QuarterNumber;
+    readonly calendarQuarter: QuarterNumber;
+    readonly quarterMonth: 1 | 2 | 3;
+}
+/**
+ * Calculates calendar quarter (1..4) from a 1-based month (1..12).
+ */
+export declare function getCalendarQuarter(month: number): QuarterNumber;
+/**
+ * Calculates fiscal fields for a given Gregorian year and month.
+ */
+export declare function getFiscalFields(year: number, month: number, options?: FiscalOptions): FiscalFields;

package/dist/core/fiscal.js

@@ -0,0 +1,45 @@
+/**
+ * Calculates calendar quarter (1..4) from a 1-based month (1..12).
+ */
+export function getCalendarQuarter(month) {
+    if (month < 1 || month > 12) {
+        throw new RangeError(`Invalid month: ${month}. Expected 1..12.`);
+    }
+    return (Math.floor((month - 1) / 3) + 1);
+}
+/**
+ * Calculates fiscal fields for a given Gregorian year and month.
+ */
+export function getFiscalFields(year, month, options = {}) {
+    if (month < 1 || month > 12) {
+        throw new RangeError(`Invalid month: ${month}. Expected 1..12.`);
+    }
+    const startMonth = options.startMonth ?? 1;
+    if (startMonth < 1 || startMonth > 12) {
+        throw new RangeError(`Invalid fiscal startMonth: ${startMonth}. Expected 1..12.`);
+    }
+    const label = options.label ?? "endYear";
+    const calendarQuarter = getCalendarQuarter(month);
+    // Month index relative to fiscal year start (0..11)
+    const relativeMonth = (month - startMonth + 12) % 12;
+    const fiscalQuarter = (Math.floor(relativeMonth / 3) + 1);
+    const quarterMonth = ((relativeMonth % 3) + 1);
+    let fiscalYear = year;
+    if (startMonth !== 1) {
+        if (label === "endYear") {
+            // If month is on or after startMonth, it belongs to the fiscal year ending next calendar year
+            fiscalYear = month >= startMonth ? year + 1 : year;
+        }
+        else {
+            // startYear: if month is before startMonth, it belongs to the fiscal year started in previous calendar year
+            fiscalYear = month < startMonth ? year - 1 : year;
+        }
+    }
+    return {
+        fiscalYear,
+        fiscalQuarter,
+        calendarQuarter,
+        quarterMonth,
+    };
+}
+//# sourceMappingURL=fiscal.js.map

package/dist/core/fiscal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fiscal.js","sourceRoot":"","sources":["../../src/core/fiscal.ts"],"names":[],"mappings":"AA2BA;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,UAAU,CAAC,kBAAkB,KAAK,mBAAmB,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAkB,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,KAAa,EACb,UAAyB,EAAE;IAE3B,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,UAAU,CAAC,kBAAkB,KAAK,mBAAmB,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;IAC3C,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,UAAU,CAClB,8BAA8B,UAAU,mBAAmB,CAC5D,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,SAAS,CAAC;IACzC,MAAM,eAAe,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAElD,oDAAoD;IACpD,MAAM,aAAa,GAAG,CAAC,KAAK,GAAG,UAAU,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;IACrD,MAAM,aAAa,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC,GAAG,CAAC,CAAkB,CAAC;IAC3E,MAAM,YAAY,GAAG,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,GAAG,CAAC,CAAc,CAAC;IAE5D,IAAI,UAAU,GAAG,IAAI,CAAC;IACtB,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;QACrB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,8FAA8F;YAC9F,UAAU,GAAG,KAAK,IAAI,UAAU,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACrD,CAAC;aAAM,CAAC;YACN,4GAA4G;YAC5G,UAAU,GAAG,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACpD,CAAC;IACH,CAAC;IAED,OAAO;QACL,UAAU;QACV,aAAa;QACb,eAAe;QACf,YAAY;KACb,CAAC;AACJ,CAAC","sourcesContent":["export type QuarterNumber = 1 | 2 | 3 | 4;\n\nexport interface FiscalOptions {\n  /**\n   * Starting month of the fiscal year (1..12). Defaults to 1 (calendar year).\n   * Common corporate/governmental standards:\n   * - 1: Calendar year (US corporate default, China, Germany)\n   * - 4: April 1 (United Kingdom, Japan, India, Canada)\n   * - 7: July 1 (Australia, New Zealand)\n   * - 10: October 1 (United States Federal Government)\n   */\n  readonly startMonth?: number;\n\n  /**\n   * Whether the fiscal year is labeled by the year it ends (standard in US/UK accounting)\n   * or the year it starts. Defaults to \"endYear\".\n   */\n  readonly label?: \"endYear\" | \"startYear\";\n}\n\nexport interface FiscalFields {\n  readonly fiscalYear: number;\n  readonly fiscalQuarter: QuarterNumber;\n  readonly calendarQuarter: QuarterNumber;\n  readonly quarterMonth: 1 | 2 | 3; // 1st, 2nd, or 3rd month of the quarter\n}\n\n/**\n * Calculates calendar quarter (1..4) from a 1-based month (1..12).\n */\nexport function getCalendarQuarter(month: number): QuarterNumber {\n  if (month < 1 || month > 12) {\n    throw new RangeError(`Invalid month: ${month}. Expected 1..12.`);\n  }\n  return (Math.floor((month - 1) / 3) + 1) as QuarterNumber;\n}\n\n/**\n * Calculates fiscal fields for a given Gregorian year and month.\n */\nexport function getFiscalFields(\n  year: number,\n  month: number,\n  options: FiscalOptions = {},\n): FiscalFields {\n  if (month < 1 || month > 12) {\n    throw new RangeError(`Invalid month: ${month}. Expected 1..12.`);\n  }\n\n  const startMonth = options.startMonth ?? 1;\n  if (startMonth < 1 || startMonth > 12) {\n    throw new RangeError(\n      `Invalid fiscal startMonth: ${startMonth}. Expected 1..12.`,\n    );\n  }\n\n  const label = options.label ?? \"endYear\";\n  const calendarQuarter = getCalendarQuarter(month);\n\n  // Month index relative to fiscal year start (0..11)\n  const relativeMonth = (month - startMonth + 12) % 12;\n  const fiscalQuarter = (Math.floor(relativeMonth / 3) + 1) as QuarterNumber;\n  const quarterMonth = ((relativeMonth % 3) + 1) as 1 | 2 | 3;\n\n  let fiscalYear = year;\n  if (startMonth !== 1) {\n    if (label === \"endYear\") {\n      // If month is on or after startMonth, it belongs to the fiscal year ending next calendar year\n      fiscalYear = month >= startMonth ? year + 1 : year;\n    } else {\n      // startYear: if month is before startMonth, it belongs to the fiscal year started in previous calendar year\n      fiscalYear = month < startMonth ? year - 1 : year;\n    }\n  }\n\n  return {\n    fiscalYear,\n    fiscalQuarter,\n    calendarQuarter,\n    quarterMonth,\n  };\n}\n"]}

package/dist/core/gregorian-math.d.ts

@@ -0,0 +1,4 @@
+export declare function isGregorianLeapYear(year: number): boolean;
+export declare function daysInGregorianMonth(year: number, month: number): number;
+export declare function parseGregorianMonthCode(monthCode: string): number;
+export declare function formatGregorianMonthCode(month: number): `M${string}`;

package/dist/core/gregorian-math.js

@@ -0,0 +1,30 @@
+import { ChroneraError } from "../errors/errors.js";
+export function isGregorianLeapYear(year) {
+    return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
+}
+const COMMON_YEAR_MONTH_DAYS = [
+    0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31,
+];
+export function daysInGregorianMonth(year, month) {
+    if (month < 1 || month > 12) {
+        throw new ChroneraError("CHRONERA_INVALID_DATE", `Gregorian month must be between 1 and 12; received ${month}.`);
+    }
+    if (month === 2 && isGregorianLeapYear(year)) {
+        return 29;
+    }
+    const days = COMMON_YEAR_MONTH_DAYS[month];
+    if (days === undefined) {
+        throw new ChroneraError("CHRONERA_INVALID_DATE", `Invalid Gregorian month ${month}.`);
+    }
+    return days;
+}
+export function parseGregorianMonthCode(monthCode) {
+    if (!/^M(0[1-9]|1[0-2])$/.test(monthCode)) {
+        throw new ChroneraError("CHRONERA_INVALID_DATE", `Invalid Gregorian month code: "${monthCode}". Expected format M01 through M12.`);
+    }
+    return Number.parseInt(monthCode.slice(1), 10);
+}
+export function formatGregorianMonthCode(month) {
+    return `M${String(month).padStart(2, "0")}`;
+}
+//# sourceMappingURL=gregorian-math.js.map

package/dist/core/gregorian-math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gregorian-math.js","sourceRoot":"","sources":["../../src/core/gregorian-math.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,IAAI,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,sBAAsB,GAAG;IAC7B,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;CACzC,CAAC;AAEX,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,KAAa;IAC9D,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,sDAAsD,KAAK,GAAG,CAC/D,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,KAAK,CAAC,IAAI,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,IAAI,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,2BAA2B,KAAK,GAAG,CACpC,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,SAAiB;IACvD,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,kCAAkC,SAAS,qCAAqC,CACjF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAa;IACpD,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AAC9C,CAAC","sourcesContent":["import { ChroneraError } from \"../errors/errors.js\";\n\nexport function isGregorianLeapYear(year: number): boolean {\n  return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;\n}\n\nconst COMMON_YEAR_MONTH_DAYS = [\n  0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31,\n] as const;\n\nexport function daysInGregorianMonth(year: number, month: number): number {\n  if (month < 1 || month > 12) {\n    throw new ChroneraError(\n      \"CHRONERA_INVALID_DATE\",\n      `Gregorian month must be between 1 and 12; received ${month}.`,\n    );\n  }\n\n  if (month === 2 && isGregorianLeapYear(year)) {\n    return 29;\n  }\n\n  const days = COMMON_YEAR_MONTH_DAYS[month];\n  if (days === undefined) {\n    throw new ChroneraError(\n      \"CHRONERA_INVALID_DATE\",\n      `Invalid Gregorian month ${month}.`,\n    );\n  }\n\n  return days;\n}\n\nexport function parseGregorianMonthCode(monthCode: string): number {\n  if (!/^M(0[1-9]|1[0-2])$/.test(monthCode)) {\n    throw new ChroneraError(\n      \"CHRONERA_INVALID_DATE\",\n      `Invalid Gregorian month code: \"${monthCode}\". Expected format M01 through M12.`,\n    );\n  }\n  return Number.parseInt(monthCode.slice(1), 10);\n}\n\nexport function formatGregorianMonthCode(month: number): `M${string}` {\n  return `M${String(month).padStart(2, \"0\")}`;\n}\n"]}

package/dist/core/instant.d.ts

@@ -0,0 +1,6 @@
+import type { Instant } from "../public-types.js";
+export declare const MIN_EPOCH_MILLISECONDS = -62135596800000;
+export declare const MAX_EPOCH_MILLISECONDS = 253402300799999;
+export declare function instantFromEpochMilliseconds(epochMilliseconds: number): Instant;
+export declare function instantFromDate(date: Date): Instant;
+export declare function instantFromEpochSeconds(epochSeconds: number): Instant;