rrule-ts 0.2.0 → 0.3.0

package/dist/text/index.d.ts

@@ -1,24 +1,69 @@
 import type { RRuleOptions } from '../types.js';
-/** Options accepted by toText. */
+import type { Result } from '../result.js';
+import type { LocalePack } from '../locales/types.js';
+export type { LocalePack, LocaleTokens } from '../locales/types.js';
+export { COMPLEX_RULE_FALLBACK } from './toText.js';
+/** Options accepted by toText and fromText. */
 export interface TextOptions {
-    /** Locale identifier, e.g. 'en' or 'de'. Defaults to 'en'. */
-    locale?: string;
+    /**
+     * Locale pack to use for rendering. Defaults to the built-in English locale
+     * when omitted. Pass 'en' or 'de' (imported from rrule-ts/locales/en or
+     * rrule-ts/locales/de) to override.
+     */
+    locale?: LocalePack;
 }
 /**
- * Convert `RRuleOptions` to a human-readable recurrence description.
+ * Convert RRuleOptions to a human-readable recurrence description.
  *
- * @example toText({ freq: 'WEEKLY', byDay: [{ weekday: 'MO', ordinal: undefined }] })
- *   // 'every week on Monday' (expansion phase)
+ * Never throws. Returns '(complex recurrence rule)' for rules that cannot be
+ * naturally phrased in the target locale (e.g. BYWEEKNO, BYYEARDAY, unusual
+ * BYSETPOS combinations). This is the only case where the output is not a
+ * grammatical sentence.
  *
- * @stub Not yet implemented.
- * TODO(expansion-phase): implement locale-aware text rendering.
+ * @example
+ * toText({ freq: 'DAILY' })
+ * // 'every day'
+ *
+ * @example
+ * toText({ freq: 'WEEKLY', byDay: [{ weekday: 'MO', ordinal: undefined }] })
+ * // 'every week on Monday'
+ *
+ * @example
+ * import { de } from 'rrule-ts/locales/de'
+ * toText({ freq: 'DAILY' }, { locale: de })
+ * // 'jeden Tag'
  */
-export declare function toText(_options: RRuleOptions, _textOptions?: TextOptions): never;
+export declare function toText(options: RRuleOptions, textOptions?: TextOptions): string;
 /**
- * Parse a human-readable recurrence description into `RRuleOptions`.
+ * Parse a human-readable English recurrence description into RRuleOptions.
+ *
+ * Accepts only canonical output produced by toText with the EN locale.
+ * Not a general natural-language parser.
+ *
+ * fromText is EN-only. There is no locale parameter because DE (and other
+ * locales) parsing is not supported: the parser grammar is tied to the
+ * English strings produced by toText. Passing non-English text returns Err.
+ *
+ * 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})).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,
+ * and excluding BYSETPOS + single plain weekday which is reconstructed as an
+ * ordinal BYDAY entry, losing the original bySetPos field).
+ *
+ * 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.
+ *
+ * @example
+ * fromText('every day')
+ * // { ok: true, value: { freq: 'DAILY' } }
  *
- * @stub Not yet implemented.
- * TODO(expansion-phase): implement natural-language RRULE parser.
+ * @example
+ * fromText('every week on Monday')
+ * // { ok: true, value: { freq: 'WEEKLY', byDay: [{ weekday: 'MO', ordinal: undefined }] } }
  */
-export declare function fromText(_text: string, _locale?: string): never;
+export declare function fromText(text: string): Result<RRuleOptions, string>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/text/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;GAQG;AAEH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,WAAW,GAAG,KAAK,CAEhF;AAED;;;;;GAKG;AAEH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAE/D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/text/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAIrD,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAEnD,+CAA+C;AAC/C,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,MAAM,CAE/E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAEnE"}

package/dist/text/index.js

@@ -1,28 +1,68 @@
 // Human-readable RRULE text rendering (import 'rrule-ts/text').
 //
-// Stubs for the expansion phase.
-// TODO(expansion-phase): implement toText and fromText with i18n locale packs.
+// Public API for toText and fromText. The EN locale pack is bundled here as
+// the default so consumers get natural English output without any imports.
+// Other locales must be imported explicitly from 'rrule-ts/locales/en' or
+// 'rrule-ts/locales/de', which keeps the DE locale fully tree-shakeable.
+import { toText as buildToText } from './toText.js';
+import { fromText as parseFromText } from './fromText.js';
+export { COMPLEX_RULE_FALLBACK } from './toText.js';
 /**
- * Convert `RRuleOptions` to a human-readable recurrence description.
+ * Convert RRuleOptions to a human-readable recurrence description.
  *
- * @example toText({ freq: 'WEEKLY', byDay: [{ weekday: 'MO', ordinal: undefined }] })
- *   // 'every week on Monday' (expansion phase)
+ * Never throws. Returns '(complex recurrence rule)' for rules that cannot be
+ * naturally phrased in the target locale (e.g. BYWEEKNO, BYYEARDAY, unusual
+ * BYSETPOS combinations). This is the only case where the output is not a
+ * grammatical sentence.
  *
- * @stub Not yet implemented.
- * TODO(expansion-phase): implement locale-aware text rendering.
+ * @example
+ * toText({ freq: 'DAILY' })
+ * // 'every day'
+ *
+ * @example
+ * toText({ freq: 'WEEKLY', byDay: [{ weekday: 'MO', ordinal: undefined }] })
+ * // 'every week on Monday'
+ *
+ * @example
+ * import { de } from 'rrule-ts/locales/de'
+ * toText({ freq: 'DAILY' }, { locale: de })
+ * // 'jeden Tag'
  */
-// v8 ignore next 3
-export function toText(_options, _textOptions) {
-    throw new Error('not implemented: toText (coming in expansion phase)');
+export function toText(options, textOptions) {
+    return buildToText(options, textOptions?.locale);
 }
 /**
- * Parse a human-readable recurrence description into `RRuleOptions`.
+ * Parse a human-readable English recurrence description into RRuleOptions.
+ *
+ * Accepts only canonical output produced by toText with the EN locale.
+ * Not a general natural-language parser.
+ *
+ * fromText is EN-only. There is no locale parameter because DE (and other
+ * locales) parsing is not supported: the parser grammar is tied to the
+ * English strings produced by toText. Passing non-English text returns Err.
+ *
+ * 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})).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,
+ * and excluding BYSETPOS + single plain weekday which is reconstructed as an
+ * ordinal BYDAY entry, losing the original bySetPos field).
+ *
+ * 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.
+ *
+ * @example
+ * fromText('every day')
+ * // { ok: true, value: { freq: 'DAILY' } }
  *
- * @stub Not yet implemented.
- * TODO(expansion-phase): implement natural-language RRULE parser.
+ * @example
+ * fromText('every week on Monday')
+ * // { ok: true, value: { freq: 'WEEKLY', byDay: [{ weekday: 'MO', ordinal: undefined }] } }
  */
-// v8 ignore next 3
-export function fromText(_text, _locale) {
-    throw new Error('not implemented: fromText (coming in expansion phase)');
+export function fromText(text) {
+    return parseFromText(text);
 }
 //# sourceMappingURL=index.js.map

package/dist/text/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/text/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,EAAE;AACF,iCAAiC;AACjC,+EAA+E;AAU/E;;;;;;;;GAQG;AACH,mBAAmB;AACnB,MAAM,UAAU,MAAM,CAAC,QAAsB,EAAE,YAA0B;IACvE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAA;AACxE,CAAC;AAED;;;;;GAKG;AACH,mBAAmB;AACnB,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,OAAgB;IACtD,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAA;AAC1E,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/text/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,EAAE;AACF,4EAA4E;AAC5E,2EAA2E;AAC3E,0EAA0E;AAC1E,yEAAyE;AAKzE,OAAO,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,EAAE,QAAQ,IAAI,aAAa,EAAE,MAAM,eAAe,CAAA;AAGzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAYnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,MAAM,CAAC,OAAqB,EAAE,WAAyB;IACrE,OAAO,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,CAAA;AAClD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAA;AAC5B,CAAC"}

package/dist/text/toText.d.ts

@@ -0,0 +1,20 @@
+import type { RRuleOptions } from '../types.js';
+import type { LocalePack } from '../locales/types.js';
+/**
+ * Returned (for the EN locale) for rules that cannot be phrased naturally.
+ * Tied to en.complexRuleFallback so string comparisons remain valid when
+ * the EN locale is in use. For other locales, compare against
+ * locale.complexRuleFallback instead.
+ */
+export declare const COMPLEX_RULE_FALLBACK: string;
+/**
+ * Convert RRuleOptions to a human-readable recurrence description.
+ *
+ * @param options - Parsed RRULE options.
+ * @param locale - Optional locale pack. Defaults to the built-in English locale.
+ * @returns Human-readable string, or '(complex recurrence rule)' for rules
+ *   that cannot be expressed naturally (BYWEEKNO, BYYEARDAY, complex BYSETPOS).
+ *   Never throws.
+ */
+export declare function toText(options: RRuleOptions, locale?: LocalePack): string;
+//# sourceMappingURL=toText.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toText.d.ts","sourceRoot":"","sources":["../../src/text/toText.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAW,MAAM,aAAa,CAAA;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAOrD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,QAAyB,CAAA;AAkL3D;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,GAAE,UAAe,GAAG,MAAM,CAgD7E"}

package/dist/text/toText.js

@@ -0,0 +1,230 @@
+// Internal toText implementation for rrule-ts.
+//
+// Assembles a human-readable recurrence description from RRuleOptions.
+// All clause construction logic lives here. The public API surface is
+// in src/text/index.ts.
+//
+// Clause assembly order:
+//   [interval phrase] [BYMONTH clause] [BYDAY clause] [BYMONTHDAY clause]
+//   [BYHOUR+BYMINUTE clause] [, COUNT | UNTIL]
+import { en } from '../locales/en.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/**
+ * Returned (for the EN locale) for rules that cannot be phrased naturally.
+ * Tied to en.complexRuleFallback so string comparisons remain valid when
+ * the EN locale is in use. For other locales, compare against
+ * locale.complexRuleFallback instead.
+ */
+export const COMPLEX_RULE_FALLBACK = en.complexRuleFallback;
+/**
+ * Maps RFC 5545 weekday abbreviation to the LocalePack weekdays array index.
+ * MO=0 (Monday) through SU=6 (Sunday), matching LocalePack.weekdays order.
+ */
+const WEEKDAY_INDEX = {
+    MO: 0,
+    TU: 1,
+    WE: 2,
+    TH: 3,
+    FR: 4,
+    SA: 5,
+    SU: 6,
+};
+/** Weekday abbreviations that form the standard Mon-Fri business-day set. */
+const MON_TO_FRI = new Set(['MO', 'TU', 'WE', 'TH', 'FR']);
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Join non-empty strings with a single space.
+ * Filters out empty strings so that empty tokens (e.g. DE tokens.the = '')
+ * do not produce double spaces in the output.
+ */
+function sp(...parts) {
+    return parts.filter(Boolean).join(' ');
+}
+// ---------------------------------------------------------------------------
+// Complexity detection
+// ---------------------------------------------------------------------------
+/**
+ * Return true when a rule cannot be phrased as a natural sentence.
+ *
+ * Fallback triggers:
+ * - BYWEEKNO: no natural English phrasing
+ * - BYYEARDAY: no natural English phrasing
+ * - BYSETPOS with multiple positions
+ * - BYSETPOS combined with BY* parts other than BYDAY
+ * - BYSETPOS + BYDAY where BYDAY contains ordinals
+ * - BYSETPOS + multiple plain weekdays that are not exactly Mon-Fri
+ */
+function isComplex(opts) {
+    if (opts.byWeekNo !== undefined)
+        return true;
+    if (opts.byYearDay !== undefined)
+        return true;
+    // BYDAY + BYMONTHDAY together cannot be phrased naturally: the two constraints
+    // would need a compound clause that no locale currently supports.
+    if (opts.byDay !== undefined && opts.byMonthDay !== undefined)
+        return true;
+    // Multiple BYMINUTE values cannot be paired with each BYHOUR in a single
+    // natural time phrase; only one minute value per render is supported.
+    if (opts.byMinute !== undefined && opts.byMinute.length > 1)
+        return true;
+    if (opts.bySetPos !== undefined) {
+        // Multiple positions have no single natural phrase.
+        if (opts.bySetPos.length > 1)
+            return true;
+        // BYSETPOS combined with any BY* other than BYDAY.
+        const hasNonBydayBy = opts.byMonth !== undefined ||
+            opts.byMonthDay !== undefined ||
+            opts.byHour !== undefined ||
+            opts.byMinute !== undefined ||
+            opts.bySecond !== undefined;
+        if (hasNonBydayBy)
+            return true;
+        // BYSETPOS must come with BYDAY.
+        if (opts.byDay === undefined)
+            return true;
+        // BYSETPOS + ordinal BYDAY is contradictory.
+        if (opts.byDay.some((d) => d.ordinal !== undefined))
+            return true;
+        // Multiple plain weekdays: only Mon-Fri (weekday set) with BYSETPOS=-1
+        // ("last weekday") is naturally phraseable. Any other BYSETPOS value with
+        // a multi-weekday set cannot be phrased as a single natural sentence.
+        const weekdays = opts.byDay.map((d) => d.weekday);
+        if (weekdays.length > 1) {
+            const isWeekdaySet = weekdays.length === 5 && weekdays.every((w) => MON_TO_FRI.has(w));
+            if (!isWeekdaySet)
+                return true;
+            // Mon-Fri 5-day set: only BYSETPOS=-1 (last weekday) is phraseable.
+            if (opts.bySetPos[0] !== -1)
+                return true;
+        }
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Clause builders
+// ---------------------------------------------------------------------------
+/** Build the BYDAY clause. Handles plain weekdays, ordinal weekdays, and BYSETPOS. */
+function buildByDayClause(opts, locale) {
+    const byDay = opts.byDay;
+    // BYSETPOS pattern: single position value, plain weekdays only, no other BY*.
+    if (opts.bySetPos !== undefined) {
+        const pos = opts.bySetPos[0];
+        const weekdays = byDay.map((d) => d.weekday);
+        // BYSETPOS=-1 + Mon-Fri: 'on the last weekday'
+        if (pos === -1 && weekdays.length === 5 && weekdays.every((w) => MON_TO_FRI.has(w))) {
+            return sp(locale.tokens.on, locale.tokens.the, locale.tokens.last, locale.tokens.weekday);
+        }
+        // BYSETPOS + single weekday: 'on [the] [ordinal] [weekday]'
+        const weekdayName = locale.weekdays[WEEKDAY_INDEX[weekdays[0]]];
+        const ordinalStr = pos === -1 ? locale.tokens.last : locale.formatOrdinal(pos);
+        return sp(locale.tokens.on, locale.tokens.the, ordinalStr, weekdayName);
+    }
+    const hasOrdinals = byDay.some((d) => d.ordinal !== undefined);
+    if (!hasOrdinals) {
+        // Plain weekdays: WEEKLY/DAILY context. 'on Monday', 'on Monday and Wednesday'
+        const names = byDay.map((d) => locale.weekdays[WEEKDAY_INDEX[d.weekday]]);
+        return sp(locale.tokens.on, locale.formatList(names));
+    }
+    // Ordinal weekdays: MONTHLY/YEARLY context.
+    // Each entry renders as '[the] [ordinal] [weekday]'; the list is then joined
+    // and prefixed with 'on'. The 'the' token is empty in DE, so sp() filters it.
+    const items = byDay.map((d) => {
+        const name = locale.weekdays[WEEKDAY_INDEX[d.weekday]];
+        const ord = d.ordinal;
+        if (ord === -1) {
+            // Use tokens.last for the adjectival 'last' form.
+            return sp(locale.tokens.the, locale.tokens.last, name);
+        }
+        if (ord < -1) {
+            // Negative ordinals below -1 (e.g. -2MO = 2nd-to-last Monday).
+            // Delegate to the locale so each language can produce a natural phrase.
+            return sp(locale.tokens.the, locale.formatNthToLastOrdinal(Math.abs(ord)), name);
+        }
+        return sp(locale.tokens.the, locale.formatOrdinal(ord), name);
+    });
+    return sp(locale.tokens.on, locale.formatList(items));
+}
+/** Build the BYMONTHDAY clause. Handles positive values, -1, and other negatives. */
+function buildByMonthDayClause(opts, locale) {
+    const byMonthDay = opts.byMonthDay;
+    const items = byMonthDay.map((n) => {
+        if (n === -1)
+            return locale.tokens.lastDay;
+        if (n < -1) {
+            // Delegate to the locale so non-English locales produce grammatically
+            // correct phrases (e.g. DE: 'vorletzten Tag' for n=-2).
+            return locale.formatNthToLastDay(Math.abs(n));
+        }
+        return locale.formatOrdinal(n);
+    });
+    // 'on the [list]' in EN; 'am [list]' in DE (tokens.the is empty for DE).
+    return sp(locale.tokens.on, locale.tokens.the, locale.formatList(items));
+}
+/** Build the BYHOUR+BYMINUTE time clause. */
+function buildTimeClause(opts, locale) {
+    const byHour = opts.byHour;
+    // When byMinute is absent, use :00 for each hour.
+    // When byMinute is present, pair each hour with the first byMinute value.
+    const minute = opts.byMinute !== undefined ? opts.byMinute[0] : 0;
+    const times = byHour.map((h) => `${h}:${String(minute).padStart(2, '0')}`);
+    return sp(locale.tokens.at, locale.formatList(times));
+}
+// ---------------------------------------------------------------------------
+// Exported function
+// ---------------------------------------------------------------------------
+/**
+ * Convert RRuleOptions to a human-readable recurrence description.
+ *
+ * @param options - Parsed RRULE options.
+ * @param locale - Optional locale pack. Defaults to the built-in English locale.
+ * @returns Human-readable string, or '(complex recurrence rule)' for rules
+ *   that cannot be expressed naturally (BYWEEKNO, BYYEARDAY, complex BYSETPOS).
+ *   Never throws.
+ */
+export function toText(options, locale = en) {
+    if (isComplex(options))
+        return locale.complexRuleFallback;
+    const parts = [];
+    // 1. Interval phrase: always present.
+    const interval = options.interval ?? 1;
+    parts.push(locale.formatInterval(interval, options.freq));
+    // 2. BYMONTH clause (skipped when BYSETPOS is present because BYSETPOS +
+    //    BYMONTH is already marked complex above, so this guard is defensive).
+    if (options.byMonth !== undefined && options.bySetPos === undefined) {
+        if (options.byMonth.length === 1) {
+            const monthName = locale.months[options.byMonth[0] - 1];
+            parts.push(sp(locale.tokens.inSingular, monthName));
+        }
+        else {
+            const monthNames = options.byMonth.map((m) => locale.months[m - 1]);
+            parts.push(sp(locale.tokens.in, locale.formatList(monthNames)));
+        }
+    }
+    // 3. BYDAY clause (also handles BYSETPOS patterns).
+    if (options.byDay !== undefined) {
+        parts.push(buildByDayClause(options, locale));
+    }
+    // 4. BYMONTHDAY clause (only rendered when BYDAY is absent; the two clauses
+    //    describe the same period so combining them in one rule is uncommon).
+    if (options.byMonthDay !== undefined && options.byDay === undefined) {
+        parts.push(buildByMonthDayClause(options, locale));
+    }
+    // 5. BYHOUR + BYMINUTE time clause.
+    if (options.byHour !== undefined) {
+        parts.push(buildTimeClause(options, locale));
+    }
+    // 6. COUNT or UNTIL terminator. COUNT uses ', ' prefix; UNTIL uses ' ' (space).
+    const main = parts.join(' ');
+    if (options.count !== undefined) {
+        return `${main}, ${locale.formatCount(options.count)}`;
+    }
+    if (options.until !== undefined) {
+        return `${main} ${locale.tokens.until} ${locale.formatDate(options.until)}`;
+    }
+    return main;
+}
+//# sourceMappingURL=toText.js.map

package/dist/text/toText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toText.js","sourceRoot":"","sources":["../../src/text/toText.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rrule-ts",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "RFC 5545 RRULE parser, validator, stringifier, and expander. Temporal-native, zero runtime dependencies.",
   "type": "module",
   "main": "./dist/index.js",