rrule-ts 0.2.0 → 0.3.0

package/dist/locales/en.d.ts

@@ -1,32 +1,13 @@
-/** Shape of a locale pack used by toText. */
-export interface LocalePack {
-    /** Locale identifier. */
-    id: string;
-    /** Weekday names, indexed 0=Monday ... 6=Sunday. */
-    weekdays: [string, string, string, string, string, string, string];
-    /** Month names, indexed 0=January ... 11=December. */
-    months: [
-        string,
-        string,
-        string,
-        string,
-        string,
-        string,
-        string,
-        string,
-        string,
-        string,
-        string,
-        string
-    ];
-    /** Frequency labels. */
-    frequencies: Record<string, string>;
-}
+import type { LocalePack } from './types.js';
+export type { LocalePack, LocaleTokens } from './types.js';
 /**
  * English locale pack.
  *
- * @stub Partial data. The full locale will be populated in the expansion phase.
- * TODO(expansion-phase): fill all strings and wire into toText.
+ * formatInterval: n=1 -> 'every day'; n>1 -> 'every N days'.
+ * formatOrdinal: 1->'1st', 2->'2nd', 3->'3rd', 4->'4th', -1->'last'.
+ * formatCount: 1->'1 time'; N->'N times'.
+ * formatList: Oxford comma ('A, B, and C').
+ * formatDate: PlainDate -> 'January 1, 2025'; DateTime/Instant -> '...at H:MM'.
  */
 export declare const en: LocalePack;
 //# sourceMappingURL=en.d.ts.map

package/dist/locales/en.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../src/locales/en.ts"],"names":[],"mappings":"AAKA,6CAA6C;AAC7C,MAAM,WAAW,UAAU;IACzB,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,oDAAoD;IACpD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAClE,sDAAsD;IACtD,MAAM,EAAE;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;KACP,CAAA;IACD,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACpC;AAED;;;;;GAKG;AACH,eAAO,MAAM,EAAE,EAAE,UA0BhB,CAAA"}
+{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../src/locales/en.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAG5C,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AA6C1D;;;;;;;;GAQG;AACH,eAAO,MAAM,EAAE,EAAE,UAmHhB,CAAA"}

package/dist/locales/en.js

@@ -1,38 +1,178 @@
 // English locale pack for rrule-ts/text (import 'rrule-ts/locales/en').
 //
-// Stub for the expansion phase.
-// TODO(expansion-phase): provide full English locale strings for toText.
+// Implements the full LocalePack interface from types.ts with production-quality
+// English strings and formatters.
+import { getTemporal } from '../temporal.js';
+// ---------------------------------------------------------------------------
+// Internal tables (referenced from methods to avoid closure-over-self issues)
+// ---------------------------------------------------------------------------
+const EN_MONTHS = [
+    'January',
+    'February',
+    'March',
+    'April',
+    'May',
+    'June',
+    'July',
+    'August',
+    'September',
+    'October',
+    'November',
+    'December',
+];
+const FREQ_SINGULAR = {
+    SECONDLY: 'every second',
+    MINUTELY: 'every minute',
+    HOURLY: 'every hour',
+    DAILY: 'every day',
+    WEEKLY: 'every week',
+    MONTHLY: 'every month',
+    YEARLY: 'every year',
+};
+const FREQ_PLURAL = {
+    SECONDLY: 'seconds',
+    MINUTELY: 'minutes',
+    HOURLY: 'hours',
+    DAILY: 'days',
+    WEEKLY: 'weeks',
+    MONTHLY: 'months',
+    YEARLY: 'years',
+};
+// ---------------------------------------------------------------------------
+// English locale pack
+// ---------------------------------------------------------------------------
 /**
  * English locale pack.
  *
- * @stub Partial data. The full locale will be populated in the expansion phase.
- * TODO(expansion-phase): fill all strings and wire into toText.
+ * formatInterval: n=1 -> 'every day'; n>1 -> 'every N days'.
+ * formatOrdinal: 1->'1st', 2->'2nd', 3->'3rd', 4->'4th', -1->'last'.
+ * formatCount: 1->'1 time'; N->'N times'.
+ * formatList: Oxford comma ('A, B, and C').
+ * formatDate: PlainDate -> 'January 1, 2025'; DateTime/Instant -> '...at H:MM'.
  */
 export const en = {
     id: 'en',
     weekdays: ['Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', 'Sunday'],
-    months: [
-        'January',
-        'February',
-        'March',
-        'April',
-        'May',
-        'June',
-        'July',
-        'August',
-        'September',
-        'October',
-        'November',
-        'December',
-    ],
-    frequencies: {
-        SECONDLY: 'every second',
-        MINUTELY: 'every minute',
-        HOURLY: 'every hour',
-        DAILY: 'every day',
-        WEEKLY: 'every week',
-        MONTHLY: 'every month',
-        YEARLY: 'every year',
+    months: EN_MONTHS,
+    tokens: {
+        on: 'on',
+        at: 'at',
+        in: 'in',
+        inSingular: 'in',
+        until: 'until',
+        the: 'the',
+        last: 'last',
+        lastDay: 'last day',
+        weekday: 'weekday',
+    },
+    formatInterval(n, freq) {
+        if (n === 1)
+            return FREQ_SINGULAR[freq];
+        return `every ${n} ${FREQ_PLURAL[freq]}`;
+    },
+    formatOrdinal(n) {
+        if (n === -1)
+            return 'last';
+        const abs = Math.abs(n);
+        const mod100 = abs % 100;
+        const mod10 = abs % 10;
+        let suffix;
+        if (mod100 >= 11 && mod100 <= 13) {
+            // 11th, 12th, 13th: special case
+            suffix = 'th';
+        }
+        else if (mod10 === 1) {
+            suffix = 'st';
+        }
+        else if (mod10 === 2) {
+            suffix = 'nd';
+        }
+        else if (mod10 === 3) {
+            suffix = 'rd';
+        }
+        else {
+            suffix = 'th';
+        }
+        return `${abs}${suffix}`;
+    },
+    formatCount(n) {
+        return n === 1 ? '1 time' : `${n} times`;
+    },
+    formatList(items) {
+        if (items.length === 0)
+            return '';
+        if (items.length === 1)
+            return items[0];
+        if (items.length === 2)
+            return `${items[0]} and ${items[1]}`;
+        // Oxford comma: "A, B, and C"
+        return `${items.slice(0, -1).join(', ')}, and ${items[items.length - 1]}`;
+    },
+    formatDate(date) {
+        const T = getTemporal();
+        // Use instanceof to safely identify the Temporal variant.
+        if (date instanceof T.Instant) {
+            const dt = date.toZonedDateTimeISO('UTC');
+            const min = String(dt.minute).padStart(2, '0');
+            return `${EN_MONTHS[dt.month - 1]} ${dt.day}, ${dt.year} at ${dt.hour}:${min}`;
+        }
+        if (date instanceof T.PlainDateTime) {
+            const min = String(date.minute).padStart(2, '0');
+            return `${EN_MONTHS[date.month - 1]} ${date.day}, ${date.year} at ${date.hour}:${min}`;
+        }
+        // Temporal.PlainDate
+        const d = date;
+        return `${EN_MONTHS[d.month - 1]} ${d.day}, ${d.year}`;
+    },
+    formatNthToLastDay(n) {
+        // n is the absolute value (n >= 2).
+        // EN: '2nd-to-last day', '3rd-to-last day', etc.
+        const abs = n;
+        const mod100 = abs % 100;
+        const mod10 = abs % 10;
+        let suffix;
+        if (mod100 >= 11 && mod100 <= 13) {
+            suffix = 'th';
+        }
+        else if (mod10 === 1) {
+            suffix = 'st';
+        }
+        else if (mod10 === 2) {
+            suffix = 'nd';
+        }
+        else if (mod10 === 3) {
+            suffix = 'rd';
+        }
+        else {
+            suffix = 'th';
+        }
+        return `${abs}${suffix}-to-last day`;
+    },
+    formatNthToLastOrdinal(n) {
+        // n is the absolute value (n >= 2).
+        // Returns the adjectival "Nth-to-last" form used before a weekday name in BYDAY.
+        // EN: 2 -> '2nd-to-last', 3 -> '3rd-to-last', 11 -> '11th-to-last', etc.
+        const abs = n;
+        const mod100 = abs % 100;
+        const mod10 = abs % 10;
+        let suffix;
+        if (mod100 >= 11 && mod100 <= 13) {
+            suffix = 'th';
+        }
+        else if (mod10 === 1) {
+            suffix = 'st';
+        }
+        else if (mod10 === 2) {
+            suffix = 'nd';
+        }
+        else if (mod10 === 3) {
+            suffix = 'rd';
+        }
+        else {
+            suffix = 'th';
+        }
+        return `${abs}${suffix}-to-last`;
     },
+    complexRuleFallback: '(complex recurrence rule)',
 };
 //# sourceMappingURL=en.js.map

package/dist/locales/en.js.map

@@ -1 +1 @@
-{"version":3,"file":"en.js","sourceRoot":"","sources":["../../src/locales/en.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,EAAE;AACF,gCAAgC;AAChC,yEAAyE;AA2BzE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,EAAE,GAAe;IAC5B,EAAE,EAAE,IAAI;IACR,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC;IACxF,MAAM,EAAE;QACN,SAAS;QACT,UAAU;QACV,OAAO;QACP,OAAO;QACP,KAAK;QACL,MAAM;QACN,MAAM;QACN,QAAQ;QACR,WAAW;QACX,SAAS;QACT,UAAU;QACV,UAAU;KACX;IACD,WAAW,EAAE;QACX,QAAQ,EAAE,cAAc;QACxB,QAAQ,EAAE,cAAc;QACxB,MAAM,EAAE,YAAY;QACpB,KAAK,EAAE,WAAW;QAClB,MAAM,EAAE,YAAY;QACpB,OAAO,EAAE,aAAa;QACtB,MAAM,EAAE,YAAY;KACrB;CACF,CAAA"}
+{"version":3,"file":"en.js","sourceRoot":"","sources":["../../src/locales/en.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,EAAE;AACF,iFAAiF;AACjF,kCAAkC;AAIlC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAI5C,8EAA8E;AAC9E,8EAA8E;AAC9E,8EAA8E;AAE9E,MAAM,SAAS,GAAyB;IACtC,SAAS;IACT,UAAU;IACV,OAAO;IACP,OAAO;IACP,KAAK;IACL,MAAM;IACN,MAAM;IACN,QAAQ;IACR,WAAW;IACX,SAAS;IACT,UAAU;IACV,UAAU;CACX,CAAA;AAED,MAAM,aAAa,GAA8B;IAC/C,QAAQ,EAAE,cAAc;IACxB,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,YAAY;IACpB,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,aAAa;IACtB,MAAM,EAAE,YAAY;CACrB,CAAA;AAED,MAAM,WAAW,GAA8B;IAC7C,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,MAAM,EAAE,OAAO;IACf,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,OAAO;IACf,OAAO,EAAE,QAAQ;IACjB,MAAM,EAAE,OAAO;CAChB,CAAA;AAED,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,EAAE,GAAe;IAC5B,EAAE,EAAE,IAAI;IACR,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC;IACxF,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE;QACN,EAAE,EAAE,IAAI;QACR,EAAE,EAAE,IAAI;QACR,EAAE,EAAE,IAAI;QACR,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,OAAO;QACd,GAAG,EAAE,KAAK;QACV,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,UAAU;QACnB,OAAO,EAAE,SAAS;KACnB;IAED,cAAc,CAAC,CAAS,EAAE,IAAe;QACvC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,aAAa,CAAC,IAAI,CAAC,CAAA;QACvC,OAAO,SAAS,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAA;IAC1C,CAAC;IAED,aAAa,CAAC,CAAS;QACrB,IAAI,CAAC,KAAK,CAAC,CAAC;YAAE,OAAO,MAAM,CAAA;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QACvB,MAAM,MAAM,GAAG,GAAG,GAAG,GAAG,CAAA;QACxB,MAAM,KAAK,GAAG,GAAG,GAAG,EAAE,CAAA;QACtB,IAAI,MAAc,CAAA;QAClB,IAAI,MAAM,IAAI,EAAE,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;YACjC,iCAAiC;YACjC,MAAM,GAAG,IAAI,CAAA;QACf,CAAC;aAAM,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,GAAG,IAAI,CAAA;QACf,CAAC;aAAM,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,GAAG,IAAI,CAAA;QACf,CAAC;aAAM,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,GAAG,IAAI,CAAA;QACf,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,IAAI,CAAA;QACf,CAAC;QACD,OAAO,GAAG,GAAG,GAAG,MAAM,EAAE,CAAA;IAC1B,CAAC;IAED,WAAW,CAAC,CAAS;QACnB,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAA;IAC1C,CAAC;IAED,UAAU,CAAC,KAAe;QACxB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAA;QACjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAA;QACvC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;QAC5D,8BAA8B;QAC9B,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAA;IAC3E,CAAC;IAED,UAAU,CAAC,IAAI;QACb,MAAM,CAAC,GAAG,WAAW,EAAE,CAAA;QACvB,0DAA0D;QAC1D,IAAI,IAAI,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC;YAC9B,MAAM,EAAE,GAAG,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAA;YACzC,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;YAC9C,OAAO,GAAG,SAAS,CAAC,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC,IAAI,IAAI,GAAG,EAAE,CAAA;QAChF,CAAC;QACD,IAAI,IAAI,YAAY,CAAC,CAAC,aAAa,EAAE,CAAC;YACpC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;YAChD,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,IAAI,GAAG,EAAE,CAAA;QACxF,CAAC;QACD,qBAAqB;QACrB,MAAM,CAAC,GAAG,IAA0B,CAAA;QACpC,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAA;IACxD,CAAC;IAED,kBAAkB,CAAC,CAAS;QAC1B,oCAAoC;QACpC,iDAAiD;QACjD,MAAM,GAAG,GAAG,CAAC,CAAA;QACb,MAAM,MAAM,GAAG,GAAG,GAAG,GAAG,CAAA;QACxB,MAAM,KAAK,GAAG,GAAG,GAAG,EAAE,CAAA;QACtB,IAAI,MAAc,CAAA;QAClB,IAAI,MAAM,IAAI,EAAE,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;YACjC,MAAM,GAAG,IAAI,CAAA;QACf,CAAC;aAAM,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,GAAG,IAAI,CAAA;QACf,CAAC;aAAM,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,GAAG,IAAI,CAAA;QACf,CAAC;aAAM,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,GAAG,IAAI,CAAA;QACf,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,IAAI,CAAA;QACf,CAAC;QACD,OAAO,GAAG,GAAG,GAAG,MAAM,cAAc,CAAA;IACtC,CAAC;IAED,sBAAsB,CAAC,CAAS;QAC9B,oCAAoC;QACpC,iFAAiF;QACjF,yEAAyE;QACzE,MAAM,GAAG,GAAG,CAAC,CAAA;QACb,MAAM,MAAM,GAAG,GAAG,GAAG,GAAG,CAAA;QACxB,MAAM,KAAK,GAAG,GAAG,GAAG,EAAE,CAAA;QACtB,IAAI,MAAc,CAAA;QAClB,IAAI,MAAM,IAAI,EAAE,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;YACjC,MAAM,GAAG,IAAI,CAAA;QACf,CAAC;aAAM,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,GAAG,IAAI,CAAA;QACf,CAAC;aAAM,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,GAAG,IAAI,CAAA;QACf,CAAC;aAAM,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,GAAG,IAAI,CAAA;QACf,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,IAAI,CAAA;QACf,CAAC;QACD,OAAO,GAAG,GAAG,GAAG,MAAM,UAAU,CAAA;IAClC,CAAC;IAED,mBAAmB,EAAE,2BAA2B;CACjD,CAAA"}

package/dist/locales/types.d.ts

@@ -0,0 +1,113 @@
+import type { Frequency, RRuleUntil } from '../types.js';
+/**
+ * Fixed-string connective tokens used to assemble human-readable RRULE clauses.
+ * Each token is a locale-specific word or phrase.
+ */
+export interface LocaleTokens {
+    /** Precedes a BYDAY or BYMONTHDAY clause. EN: 'on', DE: 'am' */
+    on: string;
+    /** Precedes a BYHOUR time clause. EN: 'at', DE: 'um' */
+    at: string;
+    /** Precedes a multi-month BYMONTH clause. EN: 'in', DE: 'in' */
+    in: string;
+    /** Precedes a single-month BYMONTH clause. EN: 'in', DE: 'im' */
+    inSingular: string;
+    /** Precedes the UNTIL date. EN: 'until', DE: 'bis' */
+    until: string;
+    /** Appears between 'on' and an ordinal. EN: 'the', DE: '' (empty, not used in German) */
+    the: string;
+    /** Used for the -1 ordinal in adjectival BYDAY position. EN: 'last', DE: 'letzten' */
+    last: string;
+    /** Rendered for BYMONTHDAY=-1. EN: 'last day', DE: 'letzten Tag' */
+    lastDay: string;
+    /** Used for the BYSETPOS=-1 + Mon-Fri weekday set pattern. EN: 'weekday', DE: 'Werktag' */
+    weekday: string;
+}
+/**
+ * A locale pack supplies all human-language strings and formatter functions
+ * needed by toText. Consumers pass a LocalePack object directly to toText
+ * instead of a locale identifier string, which preserves tree-shaking: only
+ * imported locale packs are included in the consumer bundle.
+ *
+ * The frequencies Record is intentionally absent. All interval phrasing is
+ * delegated to formatInterval so that each locale can handle grammatical gender
+ * and number agreement (e.g. German jeden/jede/jedes vs alle N).
+ */
+export interface LocalePack {
+    /** Locale identifier, e.g. 'en' or 'de'. */
+    id: string;
+    /**
+     * Weekday display names in RFC 5545 order.
+     * Index 0 = Monday (MO) through index 6 = Sunday (SU).
+     */
+    weekdays: [string, string, string, string, string, string, string];
+    /**
+     * Month display names.
+     * Index 0 = January through index 11 = December.
+     */
+    months: [
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string
+    ];
+    /** Fixed-string connective tokens for clause assembly. */
+    tokens: LocaleTokens;
+    /**
+     * Render an interval phrase. When n=1 returns singular (e.g. 'every day').
+     * When n>1 returns plural with count (e.g. 'every 2 days').
+     * Must handle grammatical gender per language.
+     */
+    formatInterval(n: number, freq: Frequency): string;
+    /**
+     * Render an ordinal for a BYDAY or BYSETPOS position.
+     * Positive n: 1->'1st' (EN), '1.' (DE).
+     * Negative n: -1->'last' (EN adjectival form), 'letzten' (DE).
+     */
+    formatOrdinal(n: number): string;
+    /**
+     * Render a COUNT value as a human phrase.
+     * EN: 1->'1 time', 5->'5 times'. DE: '5-mal'.
+     */
+    formatCount(n: number): string;
+    /**
+     * Join a list of strings with locale-appropriate conjunction.
+     * EN: Oxford comma ('A, B, and C'). DE: ' und ' with no Oxford comma ('A, B und C').
+     */
+    formatList(items: string[]): string;
+    /**
+     * Render an UNTIL date as a human-readable string.
+     * Temporal.PlainDate -> date only (e.g. 'January 1, 2025').
+     * Temporal.PlainDateTime or Temporal.Instant -> date + time.
+     */
+    formatDate(date: RRuleUntil): string;
+    /**
+     * Render a "Nth-to-last day" phrase for negative BYMONTHDAY values below -1.
+     * n is the absolute value (n >= 2). The phrase must be in the target language.
+     * EN: n=2 -> '2nd-to-last day'. DE: n=2 -> 'vorletzten Tag', n=3 -> '3.-letzten Tag'.
+     */
+    formatNthToLastDay(n: number): string;
+    /**
+     * Render just the adjectival "nth-to-last" ordinal for a negative BYDAY ordinal
+     * below -1 (e.g. ordinal=-2 for -2MO). n is the absolute value (n >= 2).
+     * The returned string is combined with a weekday name by toText.
+     * EN: n=2 -> '2nd-to-last'. DE: n=2 -> 'vorletzten', n=3 -> '3.-letzten'.
+     */
+    formatNthToLastOrdinal(n: number): string;
+    /**
+     * The phrase returned by toText when a rule cannot be expressed naturally.
+     * Callers who compare against COMPLEX_RULE_FALLBACK should use the EN locale
+     * or compare against locale.complexRuleFallback for the locale they use.
+     * EN: '(complex recurrence rule)'. DE: '(komplexe Wiederholungsregel)'.
+     */
+    complexRuleFallback: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/locales/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/locales/types.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,EAAE,EAAE,MAAM,CAAA;IACV,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAA;IACV,gEAAgE;IAChE,EAAE,EAAE,MAAM,CAAA;IACV,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAA;IAClB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAA;IACb,yFAAyF;IACzF,GAAG,EAAE,MAAM,CAAA;IACX,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAA;IACZ,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAA;IACf,2FAA2F;IAC3F,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAA;IAEV;;;OAGG;IACH,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAElE;;;OAGG;IACH,MAAM,EAAE;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;KACP,CAAA;IAED,0DAA0D;IAC1D,MAAM,EAAE,YAAY,CAAA;IAEpB;;;;OAIG;IACH,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAAA;IAElD;;;;OAIG;IACH,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAEhC;;;OAGG;IACH,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAE9B;;;OAGG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;IAEnC;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAA;IAEpC;;;;OAIG;IACH,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAErC;;;;;OAKG;IACH,sBAAsB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAEzC;;;;;OAKG;IACH,mBAAmB,EAAE,MAAM,CAAA;CAC5B"}

package/dist/locales/types.js

@@ -0,0 +1,7 @@
+// LocalePack and LocaleTokens interfaces for rrule-ts i18n text rendering.
+//
+// Locale packs are plain objects with static tables and formatter functions.
+// They are imported per-locale (e.g. 'rrule-ts/locales/en') so tree-shaking
+// works: unused locales add zero bytes to the consumer bundle.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/locales/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/locales/types.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,+DAA+D"}

package/dist/text/fromText.d.ts

@@ -0,0 +1,23 @@
+import type { RRuleOptions } from '../types.js';
+import type { Result } from '../result.js';
+/**
+ * Parse a human-readable English recurrence description into RRuleOptions.
+ *
+ * Only accepts canonical output produced by toText with the EN locale. Not a
+ * general natural-language parser.
+ *
+ * Round-trip guarantee: for all RRuleOptions x where toText(x, {locale: en})
+ * does not return the complex-rule fallback string,
+ * fromText(toText(x, {locale: en}), {locale: en}).value deep-equals x
+ * (excluding dtstart, tzid, wkst, bySecond which are absent from text output,
+ * and excluding byMinute=[0] which is indistinguishable from byMinute=undefined
+ * in the rendered text).
+ *
+ * Returns Err if the text cannot be parsed as EN toText output.
+ *
+ * Out of scope: BYWEEKNO, BYYEARDAY, BYSECOND, WKST,
+ * multi-value BYSETPOS, free-form prose not produced by toText.
+ * fromText is EN-only: passing DE (or any other locale) text returns Err.
+ */
+export declare function fromText(text: string): Result<RRuleOptions, string>;
+//# sourceMappingURL=fromText.d.ts.map

package/dist/text/fromText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fromText.d.ts","sourceRoot":"","sources":["../../src/text/fromText.ts"],"names":[],"mappings":"AAgEA,OAAO,KAAK,EAAa,YAAY,EAAuB,MAAM,aAAa,CAAA;AAC/E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAsiB1C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAcnE"}