@intech-software/chronera 0.1.6 → 0.1.7

package/dist/operations/natural-language.js

@@ -0,0 +1,428 @@
+import { ChroneraError } from "../errors/errors.js";
+import { projectInstantToZonedFields } from "../runtime/timezone.js";
+import { absoluteDayFromGregorianFields, gregorianFieldsFromAbsoluteDay, } from "../core/absolute-day.js";
+import { addDays, addMonths, addYears, startOfMonth, endOfMonth, startOfYear, endOfYear, } from "./convenience.js";
+function todayLocal(tz) {
+    const zone = tz ??
+        (typeof Intl !== "undefined"
+            ? Intl.DateTimeFormat().resolvedOptions().timeZone
+            : "UTC") ??
+        "UTC";
+    const instant = { kind: "instant", epochMilliseconds: Date.now() };
+    const z = projectInstantToZonedFields(instant, zone);
+    return { kind: "local-date", year: z.year, month: z.month, day: z.day };
+}
+function absDay(d) {
+    return absoluteDayFromGregorianFields(d.year, d.month, d.day);
+}
+function fromAbs(n) {
+    const f = gregorianFieldsFromAbsoluteDay(n);
+    return { kind: "local-date", year: f.year, month: f.month, day: f.day };
+}
+// absDay % 7 mapping (derived from absoluteDayFromGregorianFields):
+// Thursday=0, Friday=1, Saturday=2, Sunday=3, Monday=4, Tuesday=5, Wednesday=6
+const DOW_INDEX = {
+    monday: 4,
+    tuesday: 5,
+    wednesday: 6,
+    thursday: 0,
+    friday: 1,
+    saturday: 2,
+    sunday: 3,
+};
+function dayOfWeekIndex(d) {
+    return absDay(d) % 7;
+}
+function nextWeekday(ref, t) {
+    const diff = (t - dayOfWeekIndex(ref) + 7) % 7 || 7;
+    return fromAbs(absDay(ref) + diff);
+}
+function lastWeekday(ref, t) {
+    const diff = (dayOfWeekIndex(ref) - t + 7) % 7 || 7;
+    return fromAbs(absDay(ref) - diff);
+}
+const LANG_TOKENS = {
+    th: {
+        วันนี้: "today",
+        เมื่อวาน: "yesterday",
+        เมื่อวานนี้: "yesterday",
+        พรุ่งนี้: "tomorrow",
+        มะรืน: "day after tomorrow",
+        อาทิตย์หน้า: "next week",
+        สัปดาห์หน้า: "next week",
+        อาทิตย์ที่แล้ว: "last week",
+        สัปดาห์ที่แล้ว: "last week",
+        เดือนหน้า: "next month",
+        เดือนที่แล้ว: "last month",
+        ปีหน้า: "next year",
+        ปีที่แล้ว: "last year",
+        วันจันทร์: "monday",
+        วันอังคาร: "tuesday",
+        วันพุธ: "wednesday",
+        วันพฤหัสบดี: "thursday",
+        วันพฤหัส: "thursday",
+        วันศุกร์: "friday",
+        วันเสาร์: "saturday",
+        วันอาทิตย์: "sunday",
+        ต้นเดือน: "start of month",
+        ปลายเดือน: "end of month",
+        ต้นปี: "start of year",
+        ปลายปี: "end of year",
+    },
+    ja: {
+        今日: "today",
+        本日: "today",
+        昨日: "yesterday",
+        明日: "tomorrow",
+        明後日: "day after tomorrow",
+        来週: "next week",
+        先週: "last week",
+        今週: "this week",
+        来月: "next month",
+        先月: "last month",
+        今月: "this month",
+        来年: "next year",
+        去年: "last year",
+        今年: "this year",
+        月曜日: "monday",
+        火曜日: "tuesday",
+        水曜日: "wednesday",
+        木曜日: "thursday",
+        金曜日: "friday",
+        土曜日: "saturday",
+        日曜日: "sunday",
+        月曜: "monday",
+        火曜: "tuesday",
+        水曜: "wednesday",
+        木曜: "thursday",
+        金曜: "friday",
+        土曜: "saturday",
+        日曜: "sunday",
+    },
+    zh: {
+        今天: "today",
+        今日: "today",
+        昨天: "yesterday",
+        昨日: "yesterday",
+        明天: "tomorrow",
+        明日: "tomorrow",
+        后天: "day after tomorrow",
+        後天: "day after tomorrow",
+        下周: "next week",
+        下週: "next week",
+        上周: "last week",
+        上週: "last week",
+        下个月: "next month",
+        下個月: "next month",
+        上个月: "last month",
+        上個月: "last month",
+        明年: "next year",
+        去年: "last year",
+        星期一: "monday",
+        星期二: "tuesday",
+        星期三: "wednesday",
+        星期四: "thursday",
+        星期五: "friday",
+        星期六: "saturday",
+        星期日: "sunday",
+        星期天: "sunday",
+        周一: "monday",
+        周二: "tuesday",
+        周三: "wednesday",
+        周四: "thursday",
+        周五: "friday",
+        周六: "saturday",
+        周日: "sunday",
+    },
+    ko: {
+        오늘: "today",
+        어제: "yesterday",
+        내일: "tomorrow",
+        모레: "day after tomorrow",
+        다음주: "next week",
+        지난주: "last week",
+        다음달: "next month",
+        지난달: "last month",
+        내년: "next year",
+        작년: "last year",
+        월요일: "monday",
+        화요일: "tuesday",
+        수요일: "wednesday",
+        목요일: "thursday",
+        금요일: "friday",
+        토요일: "saturday",
+        일요일: "sunday",
+    },
+    de: {
+        heute: "today",
+        gestern: "yesterday",
+        morgen: "tomorrow",
+        übermorgen: "day after tomorrow",
+        "nächste woche": "next week",
+        "letzte woche": "last week",
+        "nächsten monat": "next month",
+        "letzten monat": "last month",
+        "nächstes jahr": "next year",
+        "letztes jahr": "last year",
+        montag: "monday",
+        dienstag: "tuesday",
+        mittwoch: "wednesday",
+        donnerstag: "thursday",
+        freitag: "friday",
+        samstag: "saturday",
+        sonntag: "sunday",
+        "nächsten montag": "next monday",
+        "nächsten dienstag": "next tuesday",
+        "nächsten mittwoch": "next wednesday",
+        "nächsten donnerstag": "next thursday",
+        "nächsten freitag": "next friday",
+    },
+    fr: {
+        "aujourd'hui": "today",
+        hier: "yesterday",
+        demain: "tomorrow",
+        "après-demain": "day after tomorrow",
+        "la semaine prochaine": "next week",
+        "la semaine dernière": "last week",
+        "le mois prochain": "next month",
+        "le mois dernier": "last month",
+        "l'année prochaine": "next year",
+        "l'année dernière": "last year",
+        lundi: "monday",
+        mardi: "tuesday",
+        mercredi: "wednesday",
+        jeudi: "thursday",
+        vendredi: "friday",
+        samedi: "saturday",
+        dimanche: "sunday",
+        "lundi prochain": "next monday",
+        "mardi prochain": "next tuesday",
+    },
+};
+function normalize(input, locale) {
+    const lang = locale.split("-")[0]?.toLowerCase() ?? "en";
+    const map = LANG_TOKENS[lang] ?? {};
+    let s = input.trim().toLowerCase();
+    const keys = Object.keys(map).sort((a, b) => b.length - a.length);
+    for (const k of keys) {
+        const val = map[k];
+        if (val !== undefined)
+            s = s.replace(k.toLowerCase(), val);
+    }
+    return s.replace(/\s+/g, " ").trim();
+}
+function matchPattern(s, ref) {
+    if (s === "today")
+        return { date: ref, pattern: "today" };
+    if (s === "yesterday")
+        return { date: fromAbs(absDay(ref) - 1), pattern: "yesterday" };
+    if (s === "tomorrow")
+        return { date: fromAbs(absDay(ref) + 1), pattern: "tomorrow" };
+    if (s === "day after tomorrow")
+        return { date: fromAbs(absDay(ref) + 2), pattern: "day after tomorrow" };
+    if (s === "day before yesterday")
+        return { date: fromAbs(absDay(ref) - 2), pattern: "day before yesterday" };
+    if (s === "next week")
+        return { date: fromAbs(absDay(ref) + 7), pattern: "next week" };
+    if (s === "last week")
+        return { date: fromAbs(absDay(ref) - 7), pattern: "last week" };
+    if (s === "this week" || s === "start of this week") {
+        return {
+            date: fromAbs(absDay(ref) - dayOfWeekIndex(ref)),
+            pattern: "start of this week",
+        };
+    }
+    if (s === "end of this week") {
+        return {
+            date: fromAbs(absDay(ref) + (6 - dayOfWeekIndex(ref))),
+            pattern: "end of this week",
+        };
+    }
+    if (s === "next month")
+        return {
+            date: addMonths(ref, 1, "constrain"),
+            pattern: "next month",
+        };
+    if (s === "last month")
+        return {
+            date: addMonths(ref, -1, "constrain"),
+            pattern: "last month",
+        };
+    if (s === "this month" || s === "start of month")
+        return { date: startOfMonth(ref), pattern: "start of month" };
+    if (s === "end of month")
+        return { date: endOfMonth(ref), pattern: "end of month" };
+    if (s === "next year")
+        return {
+            date: addYears(ref, 1, "constrain"),
+            pattern: "next year",
+        };
+    if (s === "last year")
+        return {
+            date: addYears(ref, -1, "constrain"),
+            pattern: "last year",
+        };
+    if (s === "this year" || s === "start of year")
+        return { date: startOfYear(ref), pattern: "start of year" };
+    if (s === "end of year")
+        return { date: endOfYear(ref), pattern: "end of year" };
+    if (DOW_INDEX[s] !== undefined)
+        return {
+            date: nextWeekday(ref, DOW_INDEX[s]),
+            pattern: `next ${s}`,
+        };
+    const nextDay = /^next (monday|tuesday|wednesday|thursday|friday|saturday|sunday)$/.exec(s);
+    if (nextDay?.[1])
+        return {
+            date: nextWeekday(ref, DOW_INDEX[nextDay[1]]),
+            pattern: `next ${nextDay[1]}`,
+        };
+    const lastDay = /^last (monday|tuesday|wednesday|thursday|friday|saturday|sunday)$/.exec(s);
+    if (lastDay?.[1])
+        return {
+            date: lastWeekday(ref, DOW_INDEX[lastDay[1]]),
+            pattern: `last ${lastDay[1]}`,
+        };
+    const thisDay = /^this (monday|tuesday|wednesday|thursday|friday|saturday|sunday)$/.exec(s);
+    if (thisDay?.[1]) {
+        const t = DOW_INDEX[thisDay[1]];
+        const diff = (t - dayOfWeekIndex(ref) + 7) % 7;
+        return { date: fromAbs(absDay(ref) + diff), pattern: `this ${thisDay[1]}` };
+    }
+    const inFuture = /^in (\d+) (day|days|week|weeks|month|months|year|years)$/.exec(s);
+    if (inFuture?.[1] && inFuture[2]) {
+        const n = parseInt(inFuture[1], 10);
+        const u = inFuture[2].replace(/s$/, "");
+        if (u === "day")
+            return { date: addDays(ref, n), pattern: `in ${n} days` };
+        if (u === "week")
+            return {
+                date: addDays(ref, n * 7),
+                pattern: `in ${n} weeks`,
+            };
+        if (u === "month")
+            return {
+                date: addMonths(ref, n, "constrain"),
+                pattern: `in ${n} months`,
+            };
+        if (u === "year")
+            return {
+                date: addYears(ref, n, "constrain"),
+                pattern: `in ${n} years`,
+            };
+    }
+    const ago = /^(\d+) (day|days|week|weeks|month|months|year|years) ago$/.exec(s);
+    if (ago?.[1] && ago[2]) {
+        const n = parseInt(ago[1], 10);
+        const u = ago[2].replace(/s$/, "");
+        if (u === "day")
+            return { date: addDays(ref, -n), pattern: `${n} days ago` };
+        if (u === "week")
+            return {
+                date: addDays(ref, -n * 7),
+                pattern: `${n} weeks ago`,
+            };
+        if (u === "month")
+            return {
+                date: addMonths(ref, -n, "constrain"),
+                pattern: `${n} months ago`,
+            };
+        if (u === "year")
+            return {
+                date: addYears(ref, -n, "constrain"),
+                pattern: `${n} years ago`,
+            };
+    }
+    const fromNow = /^(\d+) (day|days|week|weeks|month|months|year|years) from now$/.exec(s);
+    if (fromNow?.[1] && fromNow[2]) {
+        const n = parseInt(fromNow[1], 10);
+        const u = fromNow[2].replace(/s$/, "");
+        if (u === "day")
+            return {
+                date: addDays(ref, n),
+                pattern: `${n} days from now`,
+            };
+        if (u === "week")
+            return {
+                date: addDays(ref, n * 7),
+                pattern: `${n} weeks from now`,
+            };
+        if (u === "month")
+            return {
+                date: addMonths(ref, n, "constrain"),
+                pattern: `${n} months from now`,
+            };
+        if (u === "year")
+            return {
+                date: addYears(ref, n, "constrain"),
+                pattern: `${n} years from now`,
+            };
+    }
+    const boundary = /^(start|end) of (next|last|this) (month|year)$/.exec(s);
+    if (boundary) {
+        const edge = boundary[1];
+        const rel = boundary[2];
+        const unit = boundary[3];
+        let base = ref;
+        if (unit === "month") {
+            if (rel === "next")
+                base = addMonths(ref, 1, "constrain");
+            else if (rel === "last")
+                base = addMonths(ref, -1, "constrain");
+            return {
+                date: (edge === "start"
+                    ? startOfMonth(base)
+                    : endOfMonth(base)),
+                pattern: `${edge} of ${rel} month`,
+            };
+        }
+        if (unit === "year") {
+            if (rel === "next")
+                base = addYears(ref, 1, "constrain");
+            else if (rel === "last")
+                base = addYears(ref, -1, "constrain");
+            return {
+                date: (edge === "start"
+                    ? startOfYear(base)
+                    : endOfYear(base)),
+                pattern: `${edge} of ${rel} year`,
+            };
+        }
+    }
+    const iso = /^(\d{4})-(\d{2})-(\d{2})$/.exec(s);
+    if (iso?.[1] && iso[2] && iso[3]) {
+        return {
+            date: { kind: "local-date", year: +iso[1], month: +iso[2], day: +iso[3] },
+            pattern: "iso-date",
+        };
+    }
+    return null;
+}
+export function parseNaturalDate(input, options) {
+    const ref = options?.referenceDate ?? todayLocal(options?.timeZone);
+    const normalized = normalize(input, options?.locale ?? "en");
+    const result = matchPattern(normalized, ref);
+    if (!result) {
+        throw new ChroneraError("CHRONERA_INVALID_DATE", `Cannot parse natural language date: "${input}". ` +
+            `Supported: today, yesterday, tomorrow, next/last week/month/year, ` +
+            `in N days/weeks/months/years, N days ago, next/last <weekday>, YYYY-MM-DD.`);
+    }
+    return result.date;
+}
+export function safeParseNaturalDate(input, options) {
+    try {
+        return parseNaturalDate(input, options);
+    }
+    catch {
+        return null;
+    }
+}
+export function parseNaturalDateDebug(input, options) {
+    const ref = options?.referenceDate ?? todayLocal(options?.timeZone);
+    const normalized = normalize(input, options?.locale ?? "en");
+    const result = matchPattern(normalized, ref);
+    if (!result)
+        throw new ChroneraError("CHRONERA_INVALID_DATE", `Cannot parse: "${input}".`);
+    return result;
+}
+//# sourceMappingURL=natural-language.js.map

package/dist/operations/natural-language.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"natural-language.js","sourceRoot":"","sources":["../../src/operations/natural-language.ts"],"names":[],"mappings":"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","sourcesContent":["import { ChroneraError } from \"../errors/errors.js\";\nimport { projectInstantToZonedFields } from \"../runtime/timezone.js\";\nimport {\n  absoluteDayFromGregorianFields,\n  gregorianFieldsFromAbsoluteDay,\n} from \"../core/absolute-day.js\";\nimport {\n  addDays,\n  addMonths,\n  addYears,\n  startOfMonth,\n  endOfMonth,\n  startOfYear,\n  endOfYear,\n} from \"./convenience.js\";\n\nimport type { LocalDate, TimeZoneId } from \"../public-types.js\";\n\nexport interface ParseNaturalDateOptions {\n  readonly locale?: string;\n  readonly referenceDate?: LocalDate;\n  readonly timeZone?: TimeZoneId;\n}\n\nexport interface ParseNaturalDateResult {\n  readonly date: LocalDate;\n  readonly pattern: string;\n}\n\nfunction todayLocal(tz?: TimeZoneId): LocalDate {\n  const zone =\n    tz ??\n    (typeof Intl !== \"undefined\"\n      ? Intl.DateTimeFormat().resolvedOptions().timeZone\n      : \"UTC\") ??\n    \"UTC\";\n  const instant = { kind: \"instant\" as const, epochMilliseconds: Date.now() };\n  const z = projectInstantToZonedFields(instant, zone);\n  return { kind: \"local-date\", year: z.year, month: z.month, day: z.day };\n}\n\nfunction absDay(d: LocalDate): number {\n  return absoluteDayFromGregorianFields(d.year, d.month, d.day);\n}\n\nfunction fromAbs(n: number): LocalDate {\n  const f = gregorianFieldsFromAbsoluteDay(n);\n  return { kind: \"local-date\", year: f.year, month: f.month, day: f.day };\n}\n\n// absDay % 7 mapping (derived from absoluteDayFromGregorianFields):\n// Thursday=0, Friday=1, Saturday=2, Sunday=3, Monday=4, Tuesday=5, Wednesday=6\nconst DOW_INDEX: Record<string, number> = {\n  monday: 4,\n  tuesday: 5,\n  wednesday: 6,\n  thursday: 0,\n  friday: 1,\n  saturday: 2,\n  sunday: 3,\n};\n\nfunction dayOfWeekIndex(d: LocalDate): number {\n  return absDay(d) % 7;\n}\n\nfunction nextWeekday(ref: LocalDate, t: number): LocalDate {\n  const diff = (t - dayOfWeekIndex(ref) + 7) % 7 || 7;\n  return fromAbs(absDay(ref) + diff);\n}\n\nfunction lastWeekday(ref: LocalDate, t: number): LocalDate {\n  const diff = (dayOfWeekIndex(ref) - t + 7) % 7 || 7;\n  return fromAbs(absDay(ref) - diff);\n}\n\nconst LANG_TOKENS: Record<string, Record<string, string>> = {\n  th: {\n    วันนี้: \"today\",\n    เมื่อวาน: \"yesterday\",\n    เมื่อวานนี้: \"yesterday\",\n    พรุ่งนี้: \"tomorrow\",\n    มะรืน: \"day after tomorrow\",\n    อาทิตย์หน้า: \"next week\",\n    สัปดาห์หน้า: \"next week\",\n    อาทิตย์ที่แล้ว: \"last week\",\n    สัปดาห์ที่แล้ว: \"last week\",\n    เดือนหน้า: \"next month\",\n    เดือนที่แล้ว: \"last month\",\n    ปีหน้า: \"next year\",\n    ปีที่แล้ว: \"last year\",\n    วันจันทร์: \"monday\",\n    วันอังคาร: \"tuesday\",\n    วันพุธ: \"wednesday\",\n    วันพฤหัสบดี: \"thursday\",\n    วันพฤหัส: \"thursday\",\n    วันศุกร์: \"friday\",\n    วันเสาร์: \"saturday\",\n    วันอาทิตย์: \"sunday\",\n    ต้นเดือน: \"start of month\",\n    ปลายเดือน: \"end of month\",\n    ต้นปี: \"start of year\",\n    ปลายปี: \"end of year\",\n  },\n  ja: {\n    今日: \"today\",\n    本日: \"today\",\n    昨日: \"yesterday\",\n    明日: \"tomorrow\",\n    明後日: \"day after tomorrow\",\n    来週: \"next week\",\n    先週: \"last week\",\n    今週: \"this week\",\n    来月: \"next month\",\n    先月: \"last month\",\n    今月: \"this month\",\n    来年: \"next year\",\n    去年: \"last year\",\n    今年: \"this year\",\n    月曜日: \"monday\",\n    火曜日: \"tuesday\",\n    水曜日: \"wednesday\",\n    木曜日: \"thursday\",\n    金曜日: \"friday\",\n    土曜日: \"saturday\",\n    日曜日: \"sunday\",\n    月曜: \"monday\",\n    火曜: \"tuesday\",\n    水曜: \"wednesday\",\n    木曜: \"thursday\",\n    金曜: \"friday\",\n    土曜: \"saturday\",\n    日曜: \"sunday\",\n  },\n  zh: {\n    今天: \"today\",\n    今日: \"today\",\n    昨天: \"yesterday\",\n    昨日: \"yesterday\",\n    明天: \"tomorrow\",\n    明日: \"tomorrow\",\n    后天: \"day after tomorrow\",\n    後天: \"day after tomorrow\",\n    下周: \"next week\",\n    下週: \"next week\",\n    上周: \"last week\",\n    上週: \"last week\",\n    下个月: \"next month\",\n    下個月: \"next month\",\n    上个月: \"last month\",\n    上個月: \"last month\",\n    明年: \"next year\",\n    去年: \"last year\",\n    星期一: \"monday\",\n    星期二: \"tuesday\",\n    星期三: \"wednesday\",\n    星期四: \"thursday\",\n    星期五: \"friday\",\n    星期六: \"saturday\",\n    星期日: \"sunday\",\n    星期天: \"sunday\",\n    周一: \"monday\",\n    周二: \"tuesday\",\n    周三: \"wednesday\",\n    周四: \"thursday\",\n    周五: \"friday\",\n    周六: \"saturday\",\n    周日: \"sunday\",\n  },\n  ko: {\n    오늘: \"today\",\n    어제: \"yesterday\",\n    내일: \"tomorrow\",\n    모레: \"day after tomorrow\",\n    다음주: \"next week\",\n    지난주: \"last week\",\n    다음달: \"next month\",\n    지난달: \"last month\",\n    내년: \"next year\",\n    작년: \"last year\",\n    월요일: \"monday\",\n    화요일: \"tuesday\",\n    수요일: \"wednesday\",\n    목요일: \"thursday\",\n    금요일: \"friday\",\n    토요일: \"saturday\",\n    일요일: \"sunday\",\n  },\n  de: {\n    heute: \"today\",\n    gestern: \"yesterday\",\n    morgen: \"tomorrow\",\n    übermorgen: \"day after tomorrow\",\n    \"nächste woche\": \"next week\",\n    \"letzte woche\": \"last week\",\n    \"nächsten monat\": \"next month\",\n    \"letzten monat\": \"last month\",\n    \"nächstes jahr\": \"next year\",\n    \"letztes jahr\": \"last year\",\n    montag: \"monday\",\n    dienstag: \"tuesday\",\n    mittwoch: \"wednesday\",\n    donnerstag: \"thursday\",\n    freitag: \"friday\",\n    samstag: \"saturday\",\n    sonntag: \"sunday\",\n    \"nächsten montag\": \"next monday\",\n    \"nächsten dienstag\": \"next tuesday\",\n    \"nächsten mittwoch\": \"next wednesday\",\n    \"nächsten donnerstag\": \"next thursday\",\n    \"nächsten freitag\": \"next friday\",\n  },\n  fr: {\n    \"aujourd'hui\": \"today\",\n    hier: \"yesterday\",\n    demain: \"tomorrow\",\n    \"après-demain\": \"day after tomorrow\",\n    \"la semaine prochaine\": \"next week\",\n    \"la semaine dernière\": \"last week\",\n    \"le mois prochain\": \"next month\",\n    \"le mois dernier\": \"last month\",\n    \"l'année prochaine\": \"next year\",\n    \"l'année dernière\": \"last year\",\n    lundi: \"monday\",\n    mardi: \"tuesday\",\n    mercredi: \"wednesday\",\n    jeudi: \"thursday\",\n    vendredi: \"friday\",\n    samedi: \"saturday\",\n    dimanche: \"sunday\",\n    \"lundi prochain\": \"next monday\",\n    \"mardi prochain\": \"next tuesday\",\n  },\n};\n\nfunction normalize(input: string, locale: string): string {\n  const lang = locale.split(\"-\")[0]?.toLowerCase() ?? \"en\";\n  const map = LANG_TOKENS[lang] ?? {};\n  let s = input.trim().toLowerCase();\n  const keys = Object.keys(map).sort((a, b) => b.length - a.length);\n  for (const k of keys) {\n    const val = map[k];\n    if (val !== undefined) s = s.replace(k.toLowerCase(), val);\n  }\n  return s.replace(/\\s+/g, \" \").trim();\n}\n\ntype MatchResult = { date: LocalDate; pattern: string } | null;\n\nfunction matchPattern(s: string, ref: LocalDate): MatchResult {\n  if (s === \"today\") return { date: ref, pattern: \"today\" };\n  if (s === \"yesterday\")\n    return { date: fromAbs(absDay(ref) - 1), pattern: \"yesterday\" };\n  if (s === \"tomorrow\")\n    return { date: fromAbs(absDay(ref) + 1), pattern: \"tomorrow\" };\n  if (s === \"day after tomorrow\")\n    return { date: fromAbs(absDay(ref) + 2), pattern: \"day after tomorrow\" };\n  if (s === \"day before yesterday\")\n    return { date: fromAbs(absDay(ref) - 2), pattern: \"day before yesterday\" };\n\n  if (s === \"next week\")\n    return { date: fromAbs(absDay(ref) + 7), pattern: \"next week\" };\n  if (s === \"last week\")\n    return { date: fromAbs(absDay(ref) - 7), pattern: \"last week\" };\n  if (s === \"this week\" || s === \"start of this week\") {\n    return {\n      date: fromAbs(absDay(ref) - dayOfWeekIndex(ref)),\n      pattern: \"start of this week\",\n    };\n  }\n  if (s === \"end of this week\") {\n    return {\n      date: fromAbs(absDay(ref) + (6 - dayOfWeekIndex(ref))),\n      pattern: \"end of this week\",\n    };\n  }\n\n  if (s === \"next month\")\n    return {\n      date: addMonths(ref, 1, \"constrain\") as LocalDate,\n      pattern: \"next month\",\n    };\n  if (s === \"last month\")\n    return {\n      date: addMonths(ref, -1, \"constrain\") as LocalDate,\n      pattern: \"last month\",\n    };\n  if (s === \"this month\" || s === \"start of month\")\n    return { date: startOfMonth(ref) as LocalDate, pattern: \"start of month\" };\n  if (s === \"end of month\")\n    return { date: endOfMonth(ref) as LocalDate, pattern: \"end of month\" };\n\n  if (s === \"next year\")\n    return {\n      date: addYears(ref, 1, \"constrain\") as LocalDate,\n      pattern: \"next year\",\n    };\n  if (s === \"last year\")\n    return {\n      date: addYears(ref, -1, \"constrain\") as LocalDate,\n      pattern: \"last year\",\n    };\n  if (s === \"this year\" || s === \"start of year\")\n    return { date: startOfYear(ref) as LocalDate, pattern: \"start of year\" };\n  if (s === \"end of year\")\n    return { date: endOfYear(ref) as LocalDate, pattern: \"end of year\" };\n\n  if (DOW_INDEX[s] !== undefined)\n    return {\n      date: nextWeekday(ref, DOW_INDEX[s] as number),\n      pattern: `next ${s}`,\n    };\n\n  const nextDay =\n    /^next (monday|tuesday|wednesday|thursday|friday|saturday|sunday)$/.exec(s);\n  if (nextDay?.[1])\n    return {\n      date: nextWeekday(ref, DOW_INDEX[nextDay[1]] as number),\n      pattern: `next ${nextDay[1]}`,\n    };\n\n  const lastDay =\n    /^last (monday|tuesday|wednesday|thursday|friday|saturday|sunday)$/.exec(s);\n  if (lastDay?.[1])\n    return {\n      date: lastWeekday(ref, DOW_INDEX[lastDay[1]] as number),\n      pattern: `last ${lastDay[1]}`,\n    };\n\n  const thisDay =\n    /^this (monday|tuesday|wednesday|thursday|friday|saturday|sunday)$/.exec(s);\n  if (thisDay?.[1]) {\n    const t = DOW_INDEX[thisDay[1]] as number;\n    const diff = (t - dayOfWeekIndex(ref) + 7) % 7;\n    return { date: fromAbs(absDay(ref) + diff), pattern: `this ${thisDay[1]}` };\n  }\n\n  const inFuture =\n    /^in (\\d+) (day|days|week|weeks|month|months|year|years)$/.exec(s);\n  if (inFuture?.[1] && inFuture[2]) {\n    const n = parseInt(inFuture[1], 10);\n    const u = inFuture[2].replace(/s$/, \"\");\n    if (u === \"day\")\n      return { date: addDays(ref, n) as LocalDate, pattern: `in ${n} days` };\n    if (u === \"week\")\n      return {\n        date: addDays(ref, n * 7) as LocalDate,\n        pattern: `in ${n} weeks`,\n      };\n    if (u === \"month\")\n      return {\n        date: addMonths(ref, n, \"constrain\") as LocalDate,\n        pattern: `in ${n} months`,\n      };\n    if (u === \"year\")\n      return {\n        date: addYears(ref, n, \"constrain\") as LocalDate,\n        pattern: `in ${n} years`,\n      };\n  }\n\n  const ago = /^(\\d+) (day|days|week|weeks|month|months|year|years) ago$/.exec(\n    s,\n  );\n  if (ago?.[1] && ago[2]) {\n    const n = parseInt(ago[1], 10);\n    const u = ago[2].replace(/s$/, \"\");\n    if (u === \"day\")\n      return { date: addDays(ref, -n) as LocalDate, pattern: `${n} days ago` };\n    if (u === \"week\")\n      return {\n        date: addDays(ref, -n * 7) as LocalDate,\n        pattern: `${n} weeks ago`,\n      };\n    if (u === \"month\")\n      return {\n        date: addMonths(ref, -n, \"constrain\") as LocalDate,\n        pattern: `${n} months ago`,\n      };\n    if (u === \"year\")\n      return {\n        date: addYears(ref, -n, \"constrain\") as LocalDate,\n        pattern: `${n} years ago`,\n      };\n  }\n\n  const fromNow =\n    /^(\\d+) (day|days|week|weeks|month|months|year|years) from now$/.exec(s);\n  if (fromNow?.[1] && fromNow[2]) {\n    const n = parseInt(fromNow[1], 10);\n    const u = fromNow[2].replace(/s$/, \"\");\n    if (u === \"day\")\n      return {\n        date: addDays(ref, n) as LocalDate,\n        pattern: `${n} days from now`,\n      };\n    if (u === \"week\")\n      return {\n        date: addDays(ref, n * 7) as LocalDate,\n        pattern: `${n} weeks from now`,\n      };\n    if (u === \"month\")\n      return {\n        date: addMonths(ref, n, \"constrain\") as LocalDate,\n        pattern: `${n} months from now`,\n      };\n    if (u === \"year\")\n      return {\n        date: addYears(ref, n, \"constrain\") as LocalDate,\n        pattern: `${n} years from now`,\n      };\n  }\n\n  const boundary = /^(start|end) of (next|last|this) (month|year)$/.exec(s);\n  if (boundary) {\n    const edge = boundary[1] as \"start\" | \"end\";\n    const rel = boundary[2] as \"next\" | \"last\" | \"this\";\n    const unit = boundary[3] as \"month\" | \"year\";\n    let base = ref as LocalDate;\n    if (unit === \"month\") {\n      if (rel === \"next\") base = addMonths(ref, 1, \"constrain\") as LocalDate;\n      else if (rel === \"last\")\n        base = addMonths(ref, -1, \"constrain\") as LocalDate;\n      return {\n        date: (edge === \"start\"\n          ? startOfMonth(base)\n          : endOfMonth(base)) as LocalDate,\n        pattern: `${edge} of ${rel} month`,\n      };\n    }\n    if (unit === \"year\") {\n      if (rel === \"next\") base = addYears(ref, 1, \"constrain\") as LocalDate;\n      else if (rel === \"last\")\n        base = addYears(ref, -1, \"constrain\") as LocalDate;\n      return {\n        date: (edge === \"start\"\n          ? startOfYear(base)\n          : endOfYear(base)) as LocalDate,\n        pattern: `${edge} of ${rel} year`,\n      };\n    }\n  }\n\n  const iso = /^(\\d{4})-(\\d{2})-(\\d{2})$/.exec(s);\n  if (iso?.[1] && iso[2] && iso[3]) {\n    return {\n      date: { kind: \"local-date\", year: +iso[1], month: +iso[2], day: +iso[3] },\n      pattern: \"iso-date\",\n    };\n  }\n\n  return null;\n}\n\nexport function parseNaturalDate(\n  input: string,\n  options?: ParseNaturalDateOptions,\n): LocalDate {\n  const ref = options?.referenceDate ?? todayLocal(options?.timeZone);\n  const normalized = normalize(input, options?.locale ?? \"en\");\n  const result = matchPattern(normalized, ref);\n  if (!result) {\n    throw new ChroneraError(\n      \"CHRONERA_INVALID_DATE\",\n      `Cannot parse natural language date: \"${input}\". ` +\n        `Supported: today, yesterday, tomorrow, next/last week/month/year, ` +\n        `in N days/weeks/months/years, N days ago, next/last <weekday>, YYYY-MM-DD.`,\n    );\n  }\n  return result.date;\n}\n\nexport function safeParseNaturalDate(\n  input: string,\n  options?: ParseNaturalDateOptions,\n): LocalDate | null {\n  try {\n    return parseNaturalDate(input, options);\n  } catch {\n    return null;\n  }\n}\n\nexport function parseNaturalDateDebug(\n  input: string,\n  options?: ParseNaturalDateOptions,\n): ParseNaturalDateResult {\n  const ref = options?.referenceDate ?? todayLocal(options?.timeZone);\n  const normalized = normalize(input, options?.locale ?? \"en\");\n  const result = matchPattern(normalized, ref);\n  if (!result)\n    throw new ChroneraError(\n      \"CHRONERA_INVALID_DATE\",\n      `Cannot parse: \"${input}\".`,\n    );\n  return result;\n}\n"]}

package/dist/operations/recurrence.d.ts

@@ -0,0 +1,48 @@
+import type { DateOrCalendarDate } from "../public-types.js";
+export type RecurrenceFrequency = "daily" | "weekly" | "monthly" | "yearly";
+export type DayOfWeek = "monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday" | "sunday";
+export interface RecurrenceRule {
+    readonly frequency: RecurrenceFrequency;
+    readonly interval: number;
+    readonly daysOfWeek?: DayOfWeek[];
+    readonly until?: DateOrCalendarDate;
+    readonly count?: number;
+}
+export interface RecurrenceBuilder {
+    every(n: number): FrequencySelector;
+}
+export interface FrequencySelector {
+    days(): RecurrenceRuleBuilder;
+    weeks(): RecurrenceRuleBuilder;
+    months(): RecurrenceRuleBuilder;
+    years(): RecurrenceRuleBuilder;
+}
+export interface RecurrenceRuleBuilder {
+    on(days: DayOfWeek[]): RecurrenceRuleBuilder;
+    until(date: DateOrCalendarDate): RecurrenceRuleBuilder;
+    count(n: number): RecurrenceRuleBuilder;
+    next(n: number): DateOrCalendarDate[];
+    occurrences(): DateOrCalendarDate[];
+    build(): RecurrenceRule;
+}
+/**
+ * Computes all occurrences of a recurring schedule.
+ */
+export declare function getOccurrences<T extends DateOrCalendarDate>(startDate: T, rule: RecurrenceRule, limit?: number): T[];
+/**
+ * Returns true if the given date is an occurrence of the recurrence rule starting from startDate.
+ */
+export declare function isOccurrence<T extends DateOrCalendarDate>(date: T, startDate: T, rule: RecurrenceRule): boolean;
+/**
+ * Creates a fluent recurrence builder anchored to the given start date.
+ *
+ * @example
+ * ```ts
+ * const dates = recur(localDate(2026, 1, 1))
+ *   .every(1).weeks()
+ *   .on(['monday', 'wednesday', 'friday'])
+ *   .until(localDate(2026, 3, 31))
+ *   .occurrences();
+ * ```
+ */
+export declare function recur<T extends DateOrCalendarDate>(startDate: T): RecurrenceBuilder;