@intech-software/chronera 0.1.0

package/dist/operations/julian-day.js

@@ -0,0 +1,37 @@
+import { defaultCalendarRegistry } from "../calendar/registry.js";
+import { absoluteDayFromGregorianFields, gregorianFieldsFromAbsoluteDay, } from "../core/absolute-day.js";
+import { fromJulianDayNumber as coreFromJdn, fromModifiedJulianDay as coreFromMjd, toJulianDayNumber as coreToJdn, toModifiedJulianDay as coreToMjd, } from "../core/julian-day.js";
+import { localDate } from "../core/local-date.js";
+import { ChroneraError } from "../errors/errors.js";
+function getAbsoluteDay(input, registry) {
+    if (input.kind === "local-date") {
+        return absoluteDayFromGregorianFields(input.year, input.month, input.day);
+    }
+    if (input.kind === "calendar-date") {
+        const adapter = registry.getAdapter(input.calendar);
+        if (!adapter.converter) {
+            throw new ChroneraError("CHRONERA_UNSUPPORTED_OPERATION", `Calendar "${input.calendar}" does not support conversion to absolute day.`);
+        }
+        return adapter.converter.toAbsoluteDay(input);
+    }
+    throw new ChroneraError("CHRONERA_INVALID_DATE", "Invalid input for Julian Day calculation; expected LocalDate or CalendarDate.");
+}
+export function toJulianDayNumber(input, registry = defaultCalendarRegistry) {
+    const absDay = getAbsoluteDay(input, registry);
+    return coreToJdn(absDay);
+}
+export function toModifiedJulianDay(input, registry = defaultCalendarRegistry) {
+    const absDay = getAbsoluteDay(input, registry);
+    return coreToMjd(absDay);
+}
+export function localDateFromJulianDayNumber(jdn) {
+    const absDay = coreFromJdn(jdn);
+    const { year, month, day } = gregorianFieldsFromAbsoluteDay(absDay);
+    return localDate(year, month, day);
+}
+export function localDateFromModifiedJulianDay(mjd) {
+    const absDay = coreFromMjd(mjd);
+    const { year, month, day } = gregorianFieldsFromAbsoluteDay(absDay);
+    return localDate(year, month, day);
+}
+//# sourceMappingURL=julian-day.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"julian-day.js","sourceRoot":"","sources":["../../src/operations/julian-day.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EACL,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,mBAAmB,IAAI,WAAW,EAClC,qBAAqB,IAAI,WAAW,EACpC,iBAAiB,IAAI,SAAS,EAC9B,mBAAmB,IAAI,SAAS,GACjC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKpD,SAAS,cAAc,CACrB,KAA+B,EAC/B,QAA0B;IAE1B,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAChC,OAAO,8BAA8B,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,aAAa,CACrB,gCAAgC,EAChC,aAAa,KAAK,CAAC,QAAQ,gDAAgD,CAC5E,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,+EAA+E,CAChF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAA+B,EAC/B,WAA6B,uBAAuB;IAEpD,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC/C,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAA+B,EAC/B,WAA6B,uBAAuB;IAEpD,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC/C,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,GAAW;IACtD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,8BAA8B,CAAC,MAAM,CAAC,CAAC;IACpE,OAAO,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,GAAW;IACxD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,8BAA8B,CAAC,MAAM,CAAC,CAAC;IACpE,OAAO,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC","sourcesContent":["import { defaultCalendarRegistry } from \"../calendar/registry.js\";\nimport {\n  absoluteDayFromGregorianFields,\n  gregorianFieldsFromAbsoluteDay,\n} from \"../core/absolute-day.js\";\nimport {\n  fromJulianDayNumber as coreFromJdn,\n  fromModifiedJulianDay as coreFromMjd,\n  toJulianDayNumber as coreToJdn,\n  toModifiedJulianDay as coreToMjd,\n} from \"../core/julian-day.js\";\nimport { localDate } from \"../core/local-date.js\";\nimport { ChroneraError } from \"../errors/errors.js\";\n\nimport type { CalendarRegistry } from \"../calendar/registry.js\";\nimport type { CalendarDate, LocalDate } from \"../public-types.js\";\n\nfunction getAbsoluteDay(\n  input: LocalDate | CalendarDate,\n  registry: CalendarRegistry,\n): number {\n  if (input.kind === \"local-date\") {\n    return absoluteDayFromGregorianFields(input.year, input.month, input.day);\n  }\n  if (input.kind === \"calendar-date\") {\n    const adapter = registry.getAdapter(input.calendar);\n    if (!adapter.converter) {\n      throw new ChroneraError(\n        \"CHRONERA_UNSUPPORTED_OPERATION\",\n        `Calendar \"${input.calendar}\" does not support conversion to absolute day.`,\n      );\n    }\n    return adapter.converter.toAbsoluteDay(input);\n  }\n  throw new ChroneraError(\n    \"CHRONERA_INVALID_DATE\",\n    \"Invalid input for Julian Day calculation; expected LocalDate or CalendarDate.\",\n  );\n}\n\nexport function toJulianDayNumber(\n  input: LocalDate | CalendarDate,\n  registry: CalendarRegistry = defaultCalendarRegistry,\n): number {\n  const absDay = getAbsoluteDay(input, registry);\n  return coreToJdn(absDay);\n}\n\nexport function toModifiedJulianDay(\n  input: LocalDate | CalendarDate,\n  registry: CalendarRegistry = defaultCalendarRegistry,\n): number {\n  const absDay = getAbsoluteDay(input, registry);\n  return coreToMjd(absDay);\n}\n\nexport function localDateFromJulianDayNumber(jdn: number): LocalDate {\n  const absDay = coreFromJdn(jdn);\n  const { year, month, day } = gregorianFieldsFromAbsoluteDay(absDay);\n  return localDate(year, month, day);\n}\n\nexport function localDateFromModifiedJulianDay(mjd: number): LocalDate {\n  const absDay = coreFromMjd(mjd);\n  const { year, month, day } = gregorianFieldsFromAbsoluteDay(absDay);\n  return localDate(year, month, day);\n}\n"]}

package/dist/operations/validate.d.ts

@@ -0,0 +1,10 @@
+import type { CalendarCapabilities, CalendarDate, CalendarId, MonthCode } from "../public-types.js";
+import type { CalendarRegistry } from "../calendar/registry.js";
+export declare function isValidCalendarDateWithRegistry(registry: CalendarRegistry, value: CalendarDate): boolean;
+export declare function isValidCalendarDate(value: CalendarDate): boolean;
+export declare function daysInMonthWithRegistry(registry: CalendarRegistry, year: number, monthCode: MonthCode, calendar: CalendarId): number;
+export declare function daysInMonth(year: number, monthCode: MonthCode, calendar: CalendarId): number;
+export declare function isLeapYearWithRegistry(registry: CalendarRegistry, year: number, calendar: CalendarId): boolean;
+export declare function isLeapYear(year: number, calendar: CalendarId): boolean;
+export declare function getCalendarCapabilitiesWithRegistry(registry: CalendarRegistry, calendar: CalendarId): CalendarCapabilities;
+export declare function getCalendarCapabilities(calendar: CalendarId): CalendarCapabilities;

package/dist/operations/validate.js

@@ -0,0 +1,55 @@
+import { defaultCalendarRegistry } from "../calendar/registry.js";
+import { ChroneraError } from "../errors/errors.js";
+export function isValidCalendarDateWithRegistry(registry, value) {
+    const adapter = registry.getAdapter(value.calendar);
+    const issues = adapter.validator.validate(value);
+    return issues.length === 0;
+}
+export function isValidCalendarDate(value) {
+    return isValidCalendarDateWithRegistry(defaultCalendarRegistry, value);
+}
+export function daysInMonthWithRegistry(registry, year, monthCode, calendar) {
+    const adapter = registry.getAdapter(calendar);
+    return adapter.validator.daysInMonth(year, monthCode);
+}
+export function daysInMonth(year, monthCode, calendar) {
+    return daysInMonthWithRegistry(defaultCalendarRegistry, year, monthCode, calendar);
+}
+export function isLeapYearWithRegistry(registry, year, calendar) {
+    const adapter = registry.getAdapter(calendar);
+    return adapter.validator.isLeapYear(year);
+}
+export function isLeapYear(year, calendar) {
+    return isLeapYearWithRegistry(defaultCalendarRegistry, year, calendar);
+}
+export function getCalendarCapabilitiesWithRegistry(registry, calendar) {
+    if (!registry.hasAdapter(calendar)) {
+        throw new ChroneraError("CHRONERA_UNSUPPORTED_CALENDAR", `Calendar "${calendar}" is not configured.`);
+    }
+    const adapter = registry.getAdapter(calendar);
+    const identity = adapter.identity;
+    return {
+        calendar,
+        maturity: identity.deterministic ? "stable" : "runtime-dependent",
+        canFormat: true,
+        canParse: true,
+        canConvertFromAbsoluteDate: adapter.converter !== undefined,
+        canConvertToAbsoluteDate: adapter.converter !== undefined,
+        canValidate: true,
+        canAddYears: adapter.arithmetic !== undefined,
+        canAddMonths: adapter.arithmetic !== undefined,
+        deterministic: identity.deterministic,
+        algorithm: identity.algorithm,
+        ...(identity.dataVersion !== undefined
+            ? { dataVersion: identity.dataVersion }
+            : {}),
+        ...(identity.validFrom !== undefined
+            ? { validFrom: identity.validFrom }
+            : {}),
+        ...(identity.validTo !== undefined ? { validTo: identity.validTo } : {}),
+    };
+}
+export function getCalendarCapabilities(calendar) {
+    return getCalendarCapabilitiesWithRegistry(defaultCalendarRegistry, calendar);
+}
+//# sourceMappingURL=validate.js.map

package/dist/operations/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/operations/validate.ts"],"names":[],"mappings":"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","sourcesContent":["import { defaultCalendarRegistry } from \"../calendar/registry.js\";\nimport { ChroneraError } from \"../errors/errors.js\";\n\nimport type {\n  CalendarCapabilities,\n  CalendarDate,\n  CalendarId,\n  MonthCode,\n} from \"../public-types.js\";\nimport type { CalendarRegistry } from \"../calendar/registry.js\";\n\nexport function isValidCalendarDateWithRegistry(\n  registry: CalendarRegistry,\n  value: CalendarDate,\n): boolean {\n  const adapter = registry.getAdapter(value.calendar);\n  const issues = adapter.validator.validate(value);\n  return issues.length === 0;\n}\n\nexport function isValidCalendarDate(value: CalendarDate): boolean {\n  return isValidCalendarDateWithRegistry(defaultCalendarRegistry, value);\n}\n\nexport function daysInMonthWithRegistry(\n  registry: CalendarRegistry,\n  year: number,\n  monthCode: MonthCode,\n  calendar: CalendarId,\n): number {\n  const adapter = registry.getAdapter(calendar);\n  return adapter.validator.daysInMonth(year, monthCode);\n}\n\nexport function daysInMonth(\n  year: number,\n  monthCode: MonthCode,\n  calendar: CalendarId,\n): number {\n  return daysInMonthWithRegistry(\n    defaultCalendarRegistry,\n    year,\n    monthCode,\n    calendar,\n  );\n}\n\nexport function isLeapYearWithRegistry(\n  registry: CalendarRegistry,\n  year: number,\n  calendar: CalendarId,\n): boolean {\n  const adapter = registry.getAdapter(calendar);\n  return adapter.validator.isLeapYear(year);\n}\n\nexport function isLeapYear(year: number, calendar: CalendarId): boolean {\n  return isLeapYearWithRegistry(defaultCalendarRegistry, year, calendar);\n}\n\nexport function getCalendarCapabilitiesWithRegistry(\n  registry: CalendarRegistry,\n  calendar: CalendarId,\n): CalendarCapabilities {\n  if (!registry.hasAdapter(calendar)) {\n    throw new ChroneraError(\n      \"CHRONERA_UNSUPPORTED_CALENDAR\",\n      `Calendar \"${calendar}\" is not configured.`,\n    );\n  }\n\n  const adapter = registry.getAdapter(calendar);\n  const identity = adapter.identity;\n\n  return {\n    calendar,\n    maturity: identity.deterministic ? \"stable\" : \"runtime-dependent\",\n    canFormat: true,\n    canParse: true,\n    canConvertFromAbsoluteDate: adapter.converter !== undefined,\n    canConvertToAbsoluteDate: adapter.converter !== undefined,\n    canValidate: true,\n    canAddYears: adapter.arithmetic !== undefined,\n    canAddMonths: adapter.arithmetic !== undefined,\n    deterministic: identity.deterministic,\n    algorithm: identity.algorithm,\n    ...(identity.dataVersion !== undefined\n      ? { dataVersion: identity.dataVersion }\n      : {}),\n    ...(identity.validFrom !== undefined\n      ? { validFrom: identity.validFrom }\n      : {}),\n    ...(identity.validTo !== undefined ? { validTo: identity.validTo } : {}),\n  };\n}\n\nexport function getCalendarCapabilities(\n  calendar: CalendarId,\n): CalendarCapabilities {\n  return getCalendarCapabilitiesWithRegistry(defaultCalendarRegistry, calendar);\n}\n"]}

package/dist/parse/field-normalizer.d.ts

@@ -0,0 +1 @@
+export declare function normalizeInputDigits(input: string): string;

package/dist/parse/field-normalizer.js

@@ -0,0 +1,5 @@
+import { parseDigitsToLatin } from "../locale/numbering-system.js";
+export function normalizeInputDigits(input) {
+    return parseDigitsToLatin(input);
+}
+//# sourceMappingURL=field-normalizer.js.map

package/dist/parse/field-normalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-normalizer.js","sourceRoot":"","sources":["../../src/parse/field-normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC","sourcesContent":["import { parseDigitsToLatin } from \"../locale/numbering-system.js\";\n\nexport function normalizeInputDigits(input: string): string {\n  return parseDigitsToLatin(input);\n}\n"]}

package/dist/parse/index.d.ts

@@ -0,0 +1,4 @@
+export { parseLocalDate } from "./parse-local-date.js";
+export { safeParseLocalDate, safeParseInstant } from "./safe-parse.js";
+export { parseInstant } from "./parse-instant.js";
+export type { ParseInstantOptions, ParseLocalDateOptions, SafeParseResult, } from "../public-types.js";

package/dist/parse/index.js

@@ -0,0 +1,4 @@
+export { parseLocalDate } from "./parse-local-date.js";
+export { safeParseLocalDate, safeParseInstant } from "./safe-parse.js";
+export { parseInstant } from "./parse-instant.js";
+//# sourceMappingURL=index.js.map

package/dist/parse/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parse/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC","sourcesContent":["export { parseLocalDate } from \"./parse-local-date.js\";\nexport { safeParseLocalDate, safeParseInstant } from \"./safe-parse.js\";\nexport { parseInstant } from \"./parse-instant.js\";\n\nexport type {\n  ParseInstantOptions,\n  ParseLocalDateOptions,\n  SafeParseResult,\n} from \"../public-types.js\";\n"]}

package/dist/parse/parse-instant.d.ts

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

package/dist/parse/parse-instant.js

@@ -0,0 +1,97 @@
+import { ChroneraError, ChroneraParseError } from "../errors/errors.js";
+import { daysInGregorianMonth } from "../core/gregorian-math.js";
+import { instantFromEpochMilliseconds, MAX_EPOCH_MILLISECONDS, MIN_EPOCH_MILLISECONDS, } from "../core/instant.js";
+const RFC3339_REGEX = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(\.\d+)?(Z|([+-])(\d{2}):(\d{2}))$/;
+export function parseInstant(input, options) {
+    if (typeof input !== "string") {
+        throw new ChroneraParseError("CHRONERA_PARSE_FAILED", `Expected string input; received ${typeof input}.`);
+    }
+    if (input.length > 4096) {
+        throw new ChroneraError("CHRONERA_INPUT_TOO_LONG", `Input length ${input.length} exceeds maximum allowed limit of 4096 characters.`);
+    }
+    // Reject -00:00 specifically
+    if (input.endsWith("-00:00")) {
+        throw new ChroneraParseError("CHRONERA_PARSE_FAILED", "Offset '-00:00' is not accepted in this RFC 3339 profile.");
+    }
+    const match = RFC3339_REGEX.exec(input);
+    if (!match) {
+        throw new ChroneraParseError("CHRONERA_PARSE_FAILED", `Invalid RFC 3339 timestamp format: "${input}". An explicit offset (Z or ±HH:mm) is required.`);
+    }
+    const year = Number.parseInt(match[1], 10);
+    const month = Number.parseInt(match[2], 10);
+    const day = Number.parseInt(match[3], 10);
+    const hour = Number.parseInt(match[4], 10);
+    const minute = Number.parseInt(match[5], 10);
+    const second = Number.parseInt(match[6], 10);
+    const fractionStr = match[7]; // e.g. ".1234"
+    const tzOffset = match[8]; // "Z" or "+HH:mm"
+    if (year < 1 || year > 9999) {
+        throw new ChroneraParseError("CHRONERA_OUT_OF_RANGE", `Year ${year} is outside supported range [0001, 9999].`);
+    }
+    if (month < 1 || month > 12) {
+        throw new ChroneraParseError("CHRONERA_INVALID_DATE", `Month must be between 1 and 12; received ${month}.`);
+    }
+    const maxDay = daysInGregorianMonth(year, month);
+    if (day < 1 || day > maxDay) {
+        throw new ChroneraParseError("CHRONERA_INVALID_DATE", `Day ${day} is invalid for month ${month} in year ${year}.`);
+    }
+    if (hour < 0 || hour > 23) {
+        throw new ChroneraParseError("CHRONERA_PARSE_FAILED", `Hour must be between 0 and 23; received ${hour}. Hour 24 is rejected.`);
+    }
+    if (minute < 0 || minute > 59) {
+        throw new ChroneraParseError("CHRONERA_PARSE_FAILED", `Minute must be between 0 and 59; received ${minute}.`);
+    }
+    if (second < 0 || second > 59) {
+        throw new ChroneraParseError("CHRONERA_PARSE_FAILED", `Second must be between 0 and 59; received ${second}. Leap seconds are not supported.`);
+    }
+    // Parse fraction of second
+    let millisecond = 0;
+    let carrySeconds = 0;
+    if (fractionStr) {
+        const rawDigits = fractionStr.slice(1); // strip leading dot
+        const mode = options?.excessFractionalSeconds ?? "reject";
+        if (rawDigits.length <= 3) {
+            millisecond = Number.parseInt(rawDigits.padEnd(3, "0"), 10);
+        }
+        else {
+            const excess = rawDigits.slice(3);
+            const hasExcessPrecision = /[1-9]/.test(excess);
+            if (mode === "reject" && hasExcessPrecision) {
+                throw new ChroneraParseError("CHRONERA_PARSE_FAILED", `Excess fractional second precision beyond milliseconds encountered in "${input}".`);
+            }
+            if (mode === "truncate" || !hasExcessPrecision) {
+                millisecond = Number.parseInt(rawDigits.slice(0, 3), 10);
+            }
+            else if (mode === "round") {
+                const floatVal = Number.parseFloat(`0.${rawDigits}`) * 1000;
+                const rounded = Math.round(floatVal);
+                if (rounded >= 1000) {
+                    carrySeconds = Math.floor(rounded / 1000);
+                    millisecond = rounded % 1000;
+                }
+                else {
+                    millisecond = rounded;
+                }
+            }
+        }
+    }
+    // Parse offset
+    let offsetMs = 0;
+    if (tzOffset !== "Z") {
+        const sign = match[9] === "-" ? -1 : 1;
+        const offHour = Number.parseInt(match[10], 10);
+        const offMin = Number.parseInt(match[11], 10);
+        if (offHour > 23 || offMin > 59) {
+            throw new ChroneraParseError("CHRONERA_PARSE_FAILED", `Invalid offset in timestamp: "${tzOffset}".`);
+        }
+        offsetMs = sign * (offHour * 60 + offMin) * 60000;
+    }
+    // Calculate UTC epoch ms
+    const baseUtcMs = Date.UTC(year, month - 1, day, hour, minute, second);
+    const totalMs = baseUtcMs + carrySeconds * 1000 + millisecond - offsetMs;
+    if (totalMs < MIN_EPOCH_MILLISECONDS || totalMs > MAX_EPOCH_MILLISECONDS) {
+        throw new ChroneraError("CHRONERA_OUT_OF_RANGE", `Timestamp "${input}" resolves to epoch milliseconds ${totalMs}, outside supported range.`);
+    }
+    return instantFromEpochMilliseconds(totalMs);
+}
+//# sourceMappingURL=parse-instant.js.map

package/dist/parse/parse-instant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-instant.js","sourceRoot":"","sources":["../../src/parse/parse-instant.ts"],"names":[],"mappings":"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","sourcesContent":["import { ChroneraError, ChroneraParseError } from \"../errors/errors.js\";\nimport { daysInGregorianMonth } from \"../core/gregorian-math.js\";\nimport {\n  instantFromEpochMilliseconds,\n  MAX_EPOCH_MILLISECONDS,\n  MIN_EPOCH_MILLISECONDS,\n} from \"../core/instant.js\";\n\nimport type { Instant, ParseInstantOptions } from \"../public-types.js\";\n\nconst RFC3339_REGEX =\n  /^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})(\\.\\d+)?(Z|([+-])(\\d{2}):(\\d{2}))$/;\n\nexport function parseInstant(\n  input: string,\n  options?: Readonly<ParseInstantOptions>,\n): Instant {\n  if (typeof input !== \"string\") {\n    throw new ChroneraParseError(\n      \"CHRONERA_PARSE_FAILED\",\n      `Expected string input; received ${typeof input}.`,\n    );\n  }\n\n  if (input.length > 4096) {\n    throw new ChroneraError(\n      \"CHRONERA_INPUT_TOO_LONG\",\n      `Input length ${input.length} exceeds maximum allowed limit of 4096 characters.`,\n    );\n  }\n\n  // Reject -00:00 specifically\n  if (input.endsWith(\"-00:00\")) {\n    throw new ChroneraParseError(\n      \"CHRONERA_PARSE_FAILED\",\n      \"Offset '-00:00' is not accepted in this RFC 3339 profile.\",\n    );\n  }\n\n  const match = RFC3339_REGEX.exec(input);\n  if (!match) {\n    throw new ChroneraParseError(\n      \"CHRONERA_PARSE_FAILED\",\n      `Invalid RFC 3339 timestamp format: \"${input}\". An explicit offset (Z or ±HH:mm) is required.`,\n    );\n  }\n\n  const year = Number.parseInt(match[1]!, 10);\n  const month = Number.parseInt(match[2]!, 10);\n  const day = Number.parseInt(match[3]!, 10);\n  const hour = Number.parseInt(match[4]!, 10);\n  const minute = Number.parseInt(match[5]!, 10);\n  const second = Number.parseInt(match[6]!, 10);\n  const fractionStr = match[7]; // e.g. \".1234\"\n  const tzOffset = match[8]!; // \"Z\" or \"+HH:mm\"\n\n  if (year < 1 || year > 9999) {\n    throw new ChroneraParseError(\n      \"CHRONERA_OUT_OF_RANGE\",\n      `Year ${year} is outside supported range [0001, 9999].`,\n    );\n  }\n\n  if (month < 1 || month > 12) {\n    throw new ChroneraParseError(\n      \"CHRONERA_INVALID_DATE\",\n      `Month must be between 1 and 12; received ${month}.`,\n    );\n  }\n\n  const maxDay = daysInGregorianMonth(year, month);\n  if (day < 1 || day > maxDay) {\n    throw new ChroneraParseError(\n      \"CHRONERA_INVALID_DATE\",\n      `Day ${day} is invalid for month ${month} in year ${year}.`,\n    );\n  }\n\n  if (hour < 0 || hour > 23) {\n    throw new ChroneraParseError(\n      \"CHRONERA_PARSE_FAILED\",\n      `Hour must be between 0 and 23; received ${hour}. Hour 24 is rejected.`,\n    );\n  }\n\n  if (minute < 0 || minute > 59) {\n    throw new ChroneraParseError(\n      \"CHRONERA_PARSE_FAILED\",\n      `Minute must be between 0 and 59; received ${minute}.`,\n    );\n  }\n\n  if (second < 0 || second > 59) {\n    throw new ChroneraParseError(\n      \"CHRONERA_PARSE_FAILED\",\n      `Second must be between 0 and 59; received ${second}. Leap seconds are not supported.`,\n    );\n  }\n\n  // Parse fraction of second\n  let millisecond = 0;\n  let carrySeconds = 0;\n  if (fractionStr) {\n    const rawDigits = fractionStr.slice(1); // strip leading dot\n    const mode = options?.excessFractionalSeconds ?? \"reject\";\n\n    if (rawDigits.length <= 3) {\n      millisecond = Number.parseInt(rawDigits.padEnd(3, \"0\"), 10);\n    } else {\n      const excess = rawDigits.slice(3);\n      const hasExcessPrecision = /[1-9]/.test(excess);\n\n      if (mode === \"reject\" && hasExcessPrecision) {\n        throw new ChroneraParseError(\n          \"CHRONERA_PARSE_FAILED\",\n          `Excess fractional second precision beyond milliseconds encountered in \"${input}\".`,\n        );\n      }\n\n      if (mode === \"truncate\" || !hasExcessPrecision) {\n        millisecond = Number.parseInt(rawDigits.slice(0, 3), 10);\n      } else if (mode === \"round\") {\n        const floatVal = Number.parseFloat(`0.${rawDigits}`) * 1000;\n        const rounded = Math.round(floatVal);\n        if (rounded >= 1000) {\n          carrySeconds = Math.floor(rounded / 1000);\n          millisecond = rounded % 1000;\n        } else {\n          millisecond = rounded;\n        }\n      }\n    }\n  }\n\n  // Parse offset\n  let offsetMs = 0;\n  if (tzOffset !== \"Z\") {\n    const sign = match[9] === \"-\" ? -1 : 1;\n    const offHour = Number.parseInt(match[10]!, 10);\n    const offMin = Number.parseInt(match[11]!, 10);\n\n    if (offHour > 23 || offMin > 59) {\n      throw new ChroneraParseError(\n        \"CHRONERA_PARSE_FAILED\",\n        `Invalid offset in timestamp: \"${tzOffset}\".`,\n      );\n    }\n    offsetMs = sign * (offHour * 60 + offMin) * 60000;\n  }\n\n  // Calculate UTC epoch ms\n  const baseUtcMs = Date.UTC(year, month - 1, day, hour, minute, second);\n  const totalMs = baseUtcMs + carrySeconds * 1000 + millisecond - offsetMs;\n\n  if (totalMs < MIN_EPOCH_MILLISECONDS || totalMs > MAX_EPOCH_MILLISECONDS) {\n    throw new ChroneraError(\n      \"CHRONERA_OUT_OF_RANGE\",\n      `Timestamp \"${input}\" resolves to epoch milliseconds ${totalMs}, outside supported range.`,\n    );\n  }\n\n  return instantFromEpochMilliseconds(totalMs);\n}\n"]}

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

@@ -0,0 +1,2 @@
+import type { LocalDate, ParseLocalDateOptions } from "../public-types.js";
+export declare function parseLocalDate(input: string, options?: Readonly<ParseLocalDateOptions>): LocalDate;

package/dist/parse/parse-local-date.js

@@ -0,0 +1,31 @@
+import { ChroneraError, ChroneraParseError } from "../errors/errors.js";
+import { localDate } from "../core/local-date.js";
+import { parseDateWithPattern } from "./pattern-parser.js";
+import { validateAndResolveLocale } from "../locale/resolve-locale.js";
+const ISO_DATE_REGEX = /^(\d{4})-(\d{2})-(\d{2})$/;
+export function parseLocalDate(input, options) {
+    if (typeof input !== "string") {
+        throw new ChroneraParseError("CHRONERA_PARSE_FAILED", `Expected string input; received ${typeof input}.`);
+    }
+    if (input.length > 4096) {
+        throw new ChroneraError("CHRONERA_INPUT_TOO_LONG", `Input length ${input.length} exceeds maximum allowed limit of 4096 characters.`);
+    }
+    if (options?.pattern) {
+        const localeInfo = validateAndResolveLocale(options.locale);
+        return parseDateWithPattern(input, options.pattern, localeInfo.baseLocale);
+    }
+    // Strict ISO YYYY-MM-DD parser
+    const match = ISO_DATE_REGEX.exec(input);
+    if (!match) {
+        throw new ChroneraParseError("CHRONERA_PARSE_FAILED", `Invalid ISO date format: "${input}". Expected format YYYY-MM-DD.`);
+    }
+    const year = Number.parseInt(match[1], 10);
+    const month = Number.parseInt(match[2], 10);
+    const day = Number.parseInt(match[3], 10);
+    if (year === 0) {
+        throw new ChroneraParseError("CHRONERA_INVALID_DATE", "Year zero is not accepted in this civil-date API.");
+    }
+    // localDate validates month and day bounds according to Gregorian calendar
+    return localDate(year, month, day);
+}
+//# sourceMappingURL=parse-local-date.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse-local-date.js","sourceRoot":"","sources":["../../src/parse/parse-local-date.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAIvE,MAAM,cAAc,GAAG,2BAA2B,CAAC;AAEnD,MAAM,UAAU,cAAc,CAC5B,KAAa,EACb,OAAyC;IAEzC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,kBAAkB,CAC1B,uBAAuB,EACvB,mCAAmC,OAAO,KAAK,GAAG,CACnD,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;QACxB,MAAM,IAAI,aAAa,CACrB,yBAAyB,EACzB,gBAAgB,KAAK,CAAC,MAAM,oDAAoD,CACjF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;QACrB,MAAM,UAAU,GAAG,wBAAwB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5D,OAAO,oBAAoB,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IAC7E,CAAC;IAED,+BAA+B;IAC/B,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,kBAAkB,CAC1B,uBAAuB,EACvB,6BAA6B,KAAK,gCAAgC,CACnE,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;IAE3C,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,kBAAkB,CAC1B,uBAAuB,EACvB,mDAAmD,CACpD,CAAC;IACJ,CAAC;IAED,2EAA2E;IAC3E,OAAO,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC","sourcesContent":["import { ChroneraError, ChroneraParseError } from \"../errors/errors.js\";\nimport { localDate } from \"../core/local-date.js\";\nimport { parseDateWithPattern } from \"./pattern-parser.js\";\nimport { validateAndResolveLocale } from \"../locale/resolve-locale.js\";\n\nimport type { LocalDate, ParseLocalDateOptions } from \"../public-types.js\";\n\nconst ISO_DATE_REGEX = /^(\\d{4})-(\\d{2})-(\\d{2})$/;\n\nexport function parseLocalDate(\n  input: string,\n  options?: Readonly<ParseLocalDateOptions>,\n): LocalDate {\n  if (typeof input !== \"string\") {\n    throw new ChroneraParseError(\n      \"CHRONERA_PARSE_FAILED\",\n      `Expected string input; received ${typeof input}.`,\n    );\n  }\n\n  if (input.length > 4096) {\n    throw new ChroneraError(\n      \"CHRONERA_INPUT_TOO_LONG\",\n      `Input length ${input.length} exceeds maximum allowed limit of 4096 characters.`,\n    );\n  }\n\n  if (options?.pattern) {\n    const localeInfo = validateAndResolveLocale(options.locale);\n    return parseDateWithPattern(input, options.pattern, localeInfo.baseLocale);\n  }\n\n  // Strict ISO YYYY-MM-DD parser\n  const match = ISO_DATE_REGEX.exec(input);\n  if (!match) {\n    throw new ChroneraParseError(\n      \"CHRONERA_PARSE_FAILED\",\n      `Invalid ISO date format: \"${input}\". Expected format YYYY-MM-DD.`,\n    );\n  }\n\n  const year = Number.parseInt(match[1]!, 10);\n  const month = Number.parseInt(match[2]!, 10);\n  const day = Number.parseInt(match[3]!, 10);\n\n  if (year === 0) {\n    throw new ChroneraParseError(\n      \"CHRONERA_INVALID_DATE\",\n      \"Year zero is not accepted in this civil-date API.\",\n    );\n  }\n\n  // localDate validates month and day bounds according to Gregorian calendar\n  return localDate(year, month, day);\n}\n"]}

package/dist/parse/pattern-parser.d.ts

@@ -0,0 +1,2 @@
+import type { LocalDate } from "../public-types.js";
+export declare function parseDateWithPattern(input: string, pattern: string, locale?: string): LocalDate;

package/dist/parse/pattern-parser.js

@@ -0,0 +1,150 @@
+import { scanPattern } from "../format/pattern-scanner.js";
+import { ChroneraParseError } from "../errors/errors.js";
+import { localDate } from "../core/local-date.js";
+import { parseDigitsToLatin } from "../locale/numbering-system.js";
+export function parseDateWithPattern(input, pattern, locale = "en-US") {
+    const tokens = scanPattern(pattern);
+    const normalizedInput = parseDigitsToLatin(input);
+    let pos = 0;
+    let year;
+    let month;
+    let day;
+    // Build month name tables for locale
+    const shortMonths = [];
+    const longMonths = [];
+    for (let m = 1; m <= 12; m++) {
+        const d = new Date(Date.UTC(2026, m - 1, 1));
+        shortMonths[m] = new Intl.DateTimeFormat(locale, {
+            month: "short",
+            timeZone: "UTC",
+        })
+            .format(d)
+            .toLowerCase();
+        longMonths[m] = new Intl.DateTimeFormat(locale, {
+            month: "long",
+            timeZone: "UTC",
+        })
+            .format(d)
+            .toLowerCase();
+    }
+    for (const token of tokens) {
+        if (token.type === "literal") {
+            const lit = token.value;
+            if (normalizedInput.slice(pos, pos + lit.length) !== lit) {
+                throw new ChroneraParseError("CHRONERA_PARSE_FAILED", `Expected literal "${lit}" at position ${pos} in input "${input}".`);
+            }
+            pos += lit.length;
+            continue;
+        }
+        const sym = token.symbol;
+        if (sym === "yyyy") {
+            const chunk = normalizedInput.slice(pos, pos + 4);
+            if (!/^\d{4}$/.test(chunk)) {
+                throw new ChroneraParseError("CHRONERA_PARSE_FAILED", `Expected 4-digit year at position ${pos}.`);
+            }
+            year = Number.parseInt(chunk, 10);
+            pos += 4;
+        }
+        else if (sym === "y") {
+            let run = "";
+            while (pos < normalizedInput.length && /\d/.test(normalizedInput[pos])) {
+                run += normalizedInput[pos];
+                pos++;
+            }
+            if (run.length === 0 || run.length > 6) {
+                throw new ChroneraParseError("CHRONERA_PARSE_FAILED", `Expected 1 to 6 digit year at position ${pos}.`);
+            }
+            year = Number.parseInt(run, 10);
+        }
+        else if (sym === "MM") {
+            const chunk = normalizedInput.slice(pos, pos + 2);
+            if (!/^\d{2}$/.test(chunk)) {
+                throw new ChroneraParseError("CHRONERA_PARSE_FAILED", `Expected 2-digit month at position ${pos}.`);
+            }
+            month = Number.parseInt(chunk, 10);
+            pos += 2;
+        }
+        else if (sym === "M") {
+            let run = "";
+            while (pos < normalizedInput.length &&
+                /\d/.test(normalizedInput[pos]) &&
+                run.length < 2) {
+                run += normalizedInput[pos];
+                pos++;
+            }
+            if (run.length === 0) {
+                throw new ChroneraParseError("CHRONERA_PARSE_FAILED", `Expected numeric month at position ${pos}.`);
+            }
+            month = Number.parseInt(run, 10);
+        }
+        else if (sym === "MMM") {
+            let matched = false;
+            for (let m = 1; m <= 12; m++) {
+                const name = shortMonths[m];
+                if (normalizedInput.slice(pos, pos + name.length).toLowerCase() === name) {
+                    month = m;
+                    pos += name.length;
+                    matched = true;
+                    break;
+                }
+            }
+            if (!matched) {
+                throw new ChroneraParseError("CHRONERA_PARSE_FAILED", `Expected abbreviated month name at position ${pos}.`);
+            }
+        }
+        else if (sym === "MMMM") {
+            let matched = false;
+            for (let m = 1; m <= 12; m++) {
+                const name = longMonths[m];
+                if (normalizedInput.slice(pos, pos + name.length).toLowerCase() === name) {
+                    month = m;
+                    pos += name.length;
+                    matched = true;
+                    break;
+                }
+            }
+            if (!matched) {
+                throw new ChroneraParseError("CHRONERA_PARSE_FAILED", `Expected full month name at position ${pos}.`);
+            }
+        }
+        else if (sym === "dd") {
+            const chunk = normalizedInput.slice(pos, pos + 2);
+            if (!/^\d{2}$/.test(chunk)) {
+                throw new ChroneraParseError("CHRONERA_PARSE_FAILED", `Expected 2-digit day at position ${pos}.`);
+            }
+            day = Number.parseInt(chunk, 10);
+            pos += 2;
+        }
+        else if (sym === "d") {
+            let run = "";
+            while (pos < normalizedInput.length &&
+                /\d/.test(normalizedInput[pos]) &&
+                run.length < 2) {
+                run += normalizedInput[pos];
+                pos++;
+            }
+            if (run.length === 0) {
+                throw new ChroneraParseError("CHRONERA_PARSE_FAILED", `Expected numeric day at position ${pos}.`);
+            }
+            day = Number.parseInt(run, 10);
+        }
+        else if (sym === "G") {
+            // Consume era letters
+            while (pos < normalizedInput.length &&
+                /[A-Za-z]/.test(normalizedInput[pos])) {
+                pos++;
+            }
+        }
+        else {
+            throw new ChroneraParseError("CHRONERA_PARSE_FAILED", `Unsupported parse pattern token: "${sym}".`);
+        }
+    }
+    if (pos !== normalizedInput.length) {
+        throw new ChroneraParseError("CHRONERA_PARSE_FAILED", `Unexpected trailing data at position ${pos} in "${input}".`);
+    }
+    if (year === undefined || month === undefined || day === undefined) {
+        throw new ChroneraParseError("CHRONERA_PARSE_FAILED", "Pattern parsing did not extract all required fields (year, month, day).");
+    }
+    return localDate(year, month, day);
+}
+//# sourceMappingURL=pattern-parser.js.map

package/dist/parse/pattern-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-parser.js","sourceRoot":"","sources":["../../src/parse/pattern-parser.ts"],"names":[],"mappings":"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","sourcesContent":["import { scanPattern } from \"../format/pattern-scanner.js\";\nimport { ChroneraParseError } from \"../errors/errors.js\";\nimport { localDate } from \"../core/local-date.js\";\nimport { parseDigitsToLatin } from \"../locale/numbering-system.js\";\n\nimport type { LocalDate } from \"../public-types.js\";\n\nexport function parseDateWithPattern(\n  input: string,\n  pattern: string,\n  locale: string = \"en-US\",\n): LocalDate {\n  const tokens = scanPattern(pattern);\n  const normalizedInput = parseDigitsToLatin(input);\n\n  let pos = 0;\n  let year: number | undefined;\n  let month: number | undefined;\n  let day: number | undefined;\n\n  // Build month name tables for locale\n  const shortMonths: string[] = [];\n  const longMonths: string[] = [];\n  for (let m = 1; m <= 12; m++) {\n    const d = new Date(Date.UTC(2026, m - 1, 1));\n    shortMonths[m] = new Intl.DateTimeFormat(locale, {\n      month: \"short\",\n      timeZone: \"UTC\",\n    })\n      .format(d)\n      .toLowerCase();\n    longMonths[m] = new Intl.DateTimeFormat(locale, {\n      month: \"long\",\n      timeZone: \"UTC\",\n    })\n      .format(d)\n      .toLowerCase();\n  }\n\n  for (const token of tokens) {\n    if (token.type === \"literal\") {\n      const lit = token.value;\n      if (normalizedInput.slice(pos, pos + lit.length) !== lit) {\n        throw new ChroneraParseError(\n          \"CHRONERA_PARSE_FAILED\",\n          `Expected literal \"${lit}\" at position ${pos} in input \"${input}\".`,\n        );\n      }\n      pos += lit.length;\n      continue;\n    }\n\n    const sym = token.symbol;\n    if (sym === \"yyyy\") {\n      const chunk = normalizedInput.slice(pos, pos + 4);\n      if (!/^\\d{4}$/.test(chunk)) {\n        throw new ChroneraParseError(\n          \"CHRONERA_PARSE_FAILED\",\n          `Expected 4-digit year at position ${pos}.`,\n        );\n      }\n      year = Number.parseInt(chunk, 10);\n      pos += 4;\n    } else if (sym === \"y\") {\n      let run = \"\";\n      while (pos < normalizedInput.length && /\\d/.test(normalizedInput[pos]!)) {\n        run += normalizedInput[pos];\n        pos++;\n      }\n      if (run.length === 0 || run.length > 6) {\n        throw new ChroneraParseError(\n          \"CHRONERA_PARSE_FAILED\",\n          `Expected 1 to 6 digit year at position ${pos}.`,\n        );\n      }\n      year = Number.parseInt(run, 10);\n    } else if (sym === \"MM\") {\n      const chunk = normalizedInput.slice(pos, pos + 2);\n      if (!/^\\d{2}$/.test(chunk)) {\n        throw new ChroneraParseError(\n          \"CHRONERA_PARSE_FAILED\",\n          `Expected 2-digit month at position ${pos}.`,\n        );\n      }\n      month = Number.parseInt(chunk, 10);\n      pos += 2;\n    } else if (sym === \"M\") {\n      let run = \"\";\n      while (\n        pos < normalizedInput.length &&\n        /\\d/.test(normalizedInput[pos]!) &&\n        run.length < 2\n      ) {\n        run += normalizedInput[pos];\n        pos++;\n      }\n      if (run.length === 0) {\n        throw new ChroneraParseError(\n          \"CHRONERA_PARSE_FAILED\",\n          `Expected numeric month at position ${pos}.`,\n        );\n      }\n      month = Number.parseInt(run, 10);\n    } else if (sym === \"MMM\") {\n      let matched = false;\n      for (let m = 1; m <= 12; m++) {\n        const name = shortMonths[m]!;\n        if (\n          normalizedInput.slice(pos, pos + name.length).toLowerCase() === name\n        ) {\n          month = m;\n          pos += name.length;\n          matched = true;\n          break;\n        }\n      }\n      if (!matched) {\n        throw new ChroneraParseError(\n          \"CHRONERA_PARSE_FAILED\",\n          `Expected abbreviated month name at position ${pos}.`,\n        );\n      }\n    } else if (sym === \"MMMM\") {\n      let matched = false;\n      for (let m = 1; m <= 12; m++) {\n        const name = longMonths[m]!;\n        if (\n          normalizedInput.slice(pos, pos + name.length).toLowerCase() === name\n        ) {\n          month = m;\n          pos += name.length;\n          matched = true;\n          break;\n        }\n      }\n      if (!matched) {\n        throw new ChroneraParseError(\n          \"CHRONERA_PARSE_FAILED\",\n          `Expected full month name at position ${pos}.`,\n        );\n      }\n    } else if (sym === \"dd\") {\n      const chunk = normalizedInput.slice(pos, pos + 2);\n      if (!/^\\d{2}$/.test(chunk)) {\n        throw new ChroneraParseError(\n          \"CHRONERA_PARSE_FAILED\",\n          `Expected 2-digit day at position ${pos}.`,\n        );\n      }\n      day = Number.parseInt(chunk, 10);\n      pos += 2;\n    } else if (sym === \"d\") {\n      let run = \"\";\n      while (\n        pos < normalizedInput.length &&\n        /\\d/.test(normalizedInput[pos]!) &&\n        run.length < 2\n      ) {\n        run += normalizedInput[pos];\n        pos++;\n      }\n      if (run.length === 0) {\n        throw new ChroneraParseError(\n          \"CHRONERA_PARSE_FAILED\",\n          `Expected numeric day at position ${pos}.`,\n        );\n      }\n      day = Number.parseInt(run, 10);\n    } else if (sym === \"G\") {\n      // Consume era letters\n      while (\n        pos < normalizedInput.length &&\n        /[A-Za-z]/.test(normalizedInput[pos]!)\n      ) {\n        pos++;\n      }\n    } else {\n      throw new ChroneraParseError(\n        \"CHRONERA_PARSE_FAILED\",\n        `Unsupported parse pattern token: \"${sym}\".`,\n      );\n    }\n  }\n\n  if (pos !== normalizedInput.length) {\n    throw new ChroneraParseError(\n      \"CHRONERA_PARSE_FAILED\",\n      `Unexpected trailing data at position ${pos} in \"${input}\".`,\n    );\n  }\n\n  if (year === undefined || month === undefined || day === undefined) {\n    throw new ChroneraParseError(\n      \"CHRONERA_PARSE_FAILED\",\n      \"Pattern parsing did not extract all required fields (year, month, day).\",\n    );\n  }\n\n  return localDate(year, month, day);\n}\n"]}

package/dist/parse/safe-parse.d.ts

@@ -0,0 +1,3 @@
+import type { Instant, LocalDate, ParseInstantOptions, ParseLocalDateOptions, SafeParseResult } from "../public-types.js";
+export declare function safeParseLocalDate(input: string, options?: Readonly<ParseLocalDateOptions>): SafeParseResult<LocalDate>;
+export declare function safeParseInstant(input: string, options?: Readonly<ParseInstantOptions>): SafeParseResult<Instant>;

package/dist/parse/safe-parse.js

@@ -0,0 +1,46 @@
+import { ChroneraError } from "../errors/errors.js";
+import { parseLocalDate } from "./parse-local-date.js";
+import { parseInstant } from "./parse-instant.js";
+export function safeParseLocalDate(input, options) {
+    try {
+        const value = parseLocalDate(input, options);
+        return {
+            success: true,
+            value,
+        };
+    }
+    catch (err) {
+        if (err instanceof ChroneraError) {
+            return {
+                success: false,
+                error: {
+                    code: err.code,
+                    message: err.message,
+                },
+            };
+        }
+        throw err;
+    }
+}
+export function safeParseInstant(input, options) {
+    try {
+        const value = parseInstant(input, options);
+        return {
+            success: true,
+            value,
+        };
+    }
+    catch (err) {
+        if (err instanceof ChroneraError) {
+            return {
+                success: false,
+                error: {
+                    code: err.code,
+                    message: err.message,
+                },
+            };
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=safe-parse.js.map

package/dist/parse/safe-parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-parse.js","sourceRoot":"","sources":["../../src/parse/safe-parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAUlD,MAAM,UAAU,kBAAkB,CAChC,KAAa,EACb,OAAyC;IAEzC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC7C,OAAO;YACL,OAAO,EAAE,IAAI;YACb,KAAK;SACN,CAAC;IACJ,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAI,GAAG,YAAY,aAAa,EAAE,CAAC;YACjC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE;oBACL,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,OAAO,EAAE,GAAG,CAAC,OAAO;iBACrB;aACF,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAAa,EACb,OAAuC;IAEvC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3C,OAAO;YACL,OAAO,EAAE,IAAI;YACb,KAAK;SACN,CAAC;IACJ,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAI,GAAG,YAAY,aAAa,EAAE,CAAC;YACjC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE;oBACL,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,OAAO,EAAE,GAAG,CAAC,OAAO;iBACrB;aACF,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC","sourcesContent":["import { ChroneraError } from \"../errors/errors.js\";\nimport { parseLocalDate } from \"./parse-local-date.js\";\nimport { parseInstant } from \"./parse-instant.js\";\n\nimport type {\n  Instant,\n  LocalDate,\n  ParseInstantOptions,\n  ParseLocalDateOptions,\n  SafeParseResult,\n} from \"../public-types.js\";\n\nexport function safeParseLocalDate(\n  input: string,\n  options?: Readonly<ParseLocalDateOptions>,\n): SafeParseResult<LocalDate> {\n  try {\n    const value = parseLocalDate(input, options);\n    return {\n      success: true,\n      value,\n    };\n  } catch (err: unknown) {\n    if (err instanceof ChroneraError) {\n      return {\n        success: false,\n        error: {\n          code: err.code,\n          message: err.message,\n        },\n      };\n    }\n    throw err;\n  }\n}\n\nexport function safeParseInstant(\n  input: string,\n  options?: Readonly<ParseInstantOptions>,\n): SafeParseResult<Instant> {\n  try {\n    const value = parseInstant(input, options);\n    return {\n      success: true,\n      value,\n    };\n  } catch (err: unknown) {\n    if (err instanceof ChroneraError) {\n      return {\n        success: false,\n        error: {\n          code: err.code,\n          message: err.message,\n        },\n      };\n    }\n    throw err;\n  }\n}\n"]}