rrule-ts 0.1.0

package/dist/result.d.ts

@@ -0,0 +1,14 @@
+export type Result<T, E> = Ok<T> | Err<E>;
+export interface Ok<T> {
+    readonly ok: true;
+    readonly value: T;
+}
+export interface Err<E> {
+    readonly ok: false;
+    readonly error: E;
+}
+/** Wrap a success value in a Result. */
+export declare function ok<T>(value: T): Ok<T>;
+/** Wrap an error value in a Result. */
+export declare function err<E>(error: E): Err<E>;
+//# sourceMappingURL=result.d.ts.map

package/dist/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAA;AAEzC,MAAM,WAAW,EAAE,CAAC,CAAC;IACnB,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;IACjB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAClB;AAED,MAAM,WAAW,GAAG,CAAC,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAA;IAClB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAClB;AAED,wCAAwC;AACxC,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAErC;AAED,uCAAuC;AACvC,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAEvC"}

package/dist/result.js

@@ -0,0 +1,11 @@
+// Discriminated Result type. Never throws on user input: callers get back a
+// typed success or failure value and can decide how to handle it.
+/** Wrap a success value in a Result. */
+export function ok(value) {
+    return { ok: true, value };
+}
+/** Wrap an error value in a Result. */
+export function err(error) {
+    return { ok: false, error };
+}
+//# sourceMappingURL=result.js.map

package/dist/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,kEAAkE;AAclE,wCAAwC;AACxC,MAAM,UAAU,EAAE,CAAI,KAAQ;IAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;AAC5B,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,GAAG,CAAI,KAAQ;IAC7B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;AAC7B,CAAC"}

package/dist/stringify.d.ts

@@ -0,0 +1,14 @@
+import type { RRuleOptions } from './types.js';
+/**
+ * Serialize `RRuleOptions` to a canonical RRULE string.
+ *
+ * When `dtstart` is present the output includes a `DTSTART` content line
+ * (with `TZID=` if `tzid` is set) followed by the `RRULE:` line. This
+ * guarantees `parse(stringify(x))` deep-equals `x` for all valid `x`.
+ *
+ * The RRULE property order is:
+ * FREQ, UNTIL, COUNT, INTERVAL, WKST, BYSECOND, BYMINUTE, BYHOUR,
+ * BYDAY, BYMONTHDAY, BYYEARDAY, BYWEEKNO, BYMONTH, BYSETPOS.
+ */
+export declare function stringify(options: RRuleOptions): string;
+//# sourceMappingURL=stringify.d.ts.map

package/dist/stringify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringify.d.ts","sourceRoot":"","sources":["../src/stringify.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAgB,YAAY,EAAmC,MAAM,YAAY,CAAA;AAoG7F;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CA2DvD"}

package/dist/stringify.js

@@ -0,0 +1,150 @@
+// RFC 5545 RRULE stringifier.
+//
+// Emits a canonical RRULE string. When `dtstart` is present in the options the
+// output includes a DTSTART content line followed by the RRULE line so that
+// round-trip is guaranteed: parse(stringify(x)) deep-equals x for all valid x.
+// ---------------------------------------------------------------------------
+// Temporal value discriminators (duck-typed, works with native + polyfill)
+// ---------------------------------------------------------------------------
+function isInstant(v) {
+    // Temporal.Instant has epochMilliseconds but no year/hour/timeZoneId
+    return typeof v === 'object' && v !== null && 'epochMilliseconds' in v && !('year' in v);
+}
+function isZonedDateTime(v) {
+    return typeof v === 'object' && v !== null && 'timeZoneId' in v;
+}
+function isPlainDateTime(v) {
+    // PlainDateTime has both year and hour but no timeZoneId
+    return typeof v === 'object' && v !== null && 'year' in v && 'hour' in v && !('timeZoneId' in v);
+}
+function isPlainDate(v) {
+    // PlainDate has year but no hour or timeZoneId
+    return (typeof v === 'object' && v !== null && 'year' in v && !('hour' in v) && !('timeZoneId' in v));
+}
+// ---------------------------------------------------------------------------
+// iCalendar date/datetime formatters
+// ---------------------------------------------------------------------------
+function pad2(n) {
+    return String(n).padStart(2, '0');
+}
+function pad4(n) {
+    return String(n).padStart(4, '0');
+}
+/** Format a PlainDate as YYYYMMDD. */
+function formatPlainDate(d) {
+    return `${pad4(d.year)}${pad2(d.month)}${pad2(d.day)}`;
+}
+/** Format a PlainDateTime as YYYYMMDDTHHmmss. */
+function formatPlainDateTime(dt) {
+    return (`${pad4(dt.year)}${pad2(dt.month)}${pad2(dt.day)}` +
+        `T${pad2(dt.hour)}${pad2(dt.minute)}${pad2(dt.second)}`);
+}
+/** Format an Instant as YYYYMMDDTHHmmssZ. */
+function formatInstant(inst) {
+    const zdt = inst.toZonedDateTimeISO('UTC');
+    return (`${pad4(zdt.year)}${pad2(zdt.month)}${pad2(zdt.day)}` +
+        `T${pad2(zdt.hour)}${pad2(zdt.minute)}${pad2(zdt.second)}Z`);
+}
+/** Serialize a DTSTART value to an iCalendar string (value portion only). */
+function dtstartToIcal(dtstart) {
+    if (isInstant(dtstart))
+        return formatInstant(dtstart);
+    if (isZonedDateTime(dtstart)) {
+        return (`${pad4(dtstart.year)}${pad2(dtstart.month)}${pad2(dtstart.day)}` +
+            `T${pad2(dtstart.hour)}${pad2(dtstart.minute)}${pad2(dtstart.second)}`);
+    }
+    if (isPlainDateTime(dtstart))
+        return formatPlainDateTime(dtstart);
+    if (isPlainDate(dtstart))
+        return formatPlainDate(dtstart);
+    throw new Error('unrecognized DTSTART Temporal value');
+}
+/** Serialize an UNTIL value to an iCalendar string. */
+function untilToIcal(until) {
+    if (isInstant(until))
+        return formatInstant(until);
+    if (isPlainDateTime(until))
+        return formatPlainDateTime(until);
+    if (isPlainDate(until))
+        return formatPlainDate(until);
+    throw new Error('unrecognized UNTIL Temporal value');
+}
+// ---------------------------------------------------------------------------
+// BYDAY and list formatters
+// ---------------------------------------------------------------------------
+function weekdayNumToString(w) {
+    if (w.ordinal === undefined)
+        return w.weekday;
+    return `${w.ordinal}${w.weekday}`;
+}
+function weekdayToString(w) {
+    return w;
+}
+// ---------------------------------------------------------------------------
+// Main stringifier
+// ---------------------------------------------------------------------------
+/**
+ * Serialize `RRuleOptions` to a canonical RRULE string.
+ *
+ * When `dtstart` is present the output includes a `DTSTART` content line
+ * (with `TZID=` if `tzid` is set) followed by the `RRULE:` line. This
+ * guarantees `parse(stringify(x))` deep-equals `x` for all valid `x`.
+ *
+ * The RRULE property order is:
+ * FREQ, UNTIL, COUNT, INTERVAL, WKST, BYSECOND, BYMINUTE, BYHOUR,
+ * BYDAY, BYMONTHDAY, BYYEARDAY, BYWEEKNO, BYMONTH, BYSETPOS.
+ */
+export function stringify(options) {
+    const parts = [];
+    parts.push(`FREQ=${options.freq}`);
+    if (options.until !== undefined) {
+        parts.push(`UNTIL=${untilToIcal(options.until)}`);
+    }
+    if (options.count !== undefined) {
+        parts.push(`COUNT=${options.count}`);
+    }
+    if (options.interval !== undefined) {
+        parts.push(`INTERVAL=${options.interval}`);
+    }
+    if (options.wkst !== undefined) {
+        parts.push(`WKST=${weekdayToString(options.wkst)}`);
+    }
+    if (options.bySecond !== undefined) {
+        parts.push(`BYSECOND=${options.bySecond.join(',')}`);
+    }
+    if (options.byMinute !== undefined) {
+        parts.push(`BYMINUTE=${options.byMinute.join(',')}`);
+    }
+    if (options.byHour !== undefined) {
+        parts.push(`BYHOUR=${options.byHour.join(',')}`);
+    }
+    if (options.byDay !== undefined) {
+        parts.push(`BYDAY=${options.byDay.map(weekdayNumToString).join(',')}`);
+    }
+    if (options.byMonthDay !== undefined) {
+        parts.push(`BYMONTHDAY=${options.byMonthDay.join(',')}`);
+    }
+    if (options.byYearDay !== undefined) {
+        parts.push(`BYYEARDAY=${options.byYearDay.join(',')}`);
+    }
+    if (options.byWeekNo !== undefined) {
+        parts.push(`BYWEEKNO=${options.byWeekNo.join(',')}`);
+    }
+    if (options.byMonth !== undefined) {
+        parts.push(`BYMONTH=${options.byMonth.join(',')}`);
+    }
+    if (options.bySetPos !== undefined) {
+        parts.push(`BYSETPOS=${options.bySetPos.join(',')}`);
+    }
+    const rruleLine = `RRULE:${parts.join(';')}`;
+    if (options.dtstart === undefined) {
+        return rruleLine;
+    }
+    // Prefix with DTSTART content line for round-trip fidelity
+    const dtstartValue = dtstartToIcal(options.dtstart);
+    const dtstartLine = options.tzid !== undefined
+        ? `DTSTART;TZID=${options.tzid}:${dtstartValue}`
+        : `DTSTART:${dtstartValue}`;
+    return `${dtstartLine}\n${rruleLine}`;
+}
+//# sourceMappingURL=stringify.js.map

package/dist/stringify.js.map

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

package/dist/temporal.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Inject a Temporal implementation. Used by application code on Node < 26 and
+ * by test setup (test/setup-temporal.ts) on the Node 22 CI matrix leg.
+ *
+ * Example:
+ * ```ts
+ * import { setTemporal } from 'rrule-ts'
+ * import { Temporal } from 'temporal-polyfill'
+ * setTemporal(Temporal)
+ * ```
+ */
+export declare function setTemporal(impl: typeof Temporal): void;
+/**
+ * Return the available Temporal namespace.
+ * Prefers the native global (`globalThis.Temporal`, present on Node >= 26 and
+ * modern browsers); falls back to the implementation injected via setTemporal().
+ *
+ * Throws a descriptive error if neither is available so callers get a clear
+ * message instead of a cryptic TypeError.
+ */
+export declare function getTemporal(): typeof Temporal;
+//# sourceMappingURL=temporal.d.ts.map

package/dist/temporal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.d.ts","sourceRoot":"","sources":["../src/temporal.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,QAAQ,GAAG,IAAI,CAEvD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,IAAI,OAAO,QAAQ,CAa7C"}

package/dist/temporal.js

@@ -0,0 +1,45 @@
+// Temporal accessor and injector.
+//
+// The library has zero runtime dependencies: it reads globalThis.Temporal when
+// present (Node >= 26, modern browsers that ship the TC39 Temporal proposal)
+// and falls back to an instance injected by the caller via setTemporal().
+//
+// Test setup (test/setup-temporal.ts) injects temporal-polyfill on Node 22.
+// We store the injected implementation separately so it can be swapped in
+// tests without mutating globalThis.
+let _injected;
+/**
+ * Inject a Temporal implementation. Used by application code on Node < 26 and
+ * by test setup (test/setup-temporal.ts) on the Node 22 CI matrix leg.
+ *
+ * Example:
+ * ```ts
+ * import { setTemporal } from 'rrule-ts'
+ * import { Temporal } from 'temporal-polyfill'
+ * setTemporal(Temporal)
+ * ```
+ */
+export function setTemporal(impl) {
+    _injected = impl;
+}
+/**
+ * Return the available Temporal namespace.
+ * Prefers the native global (`globalThis.Temporal`, present on Node >= 26 and
+ * modern browsers); falls back to the implementation injected via setTemporal().
+ *
+ * Throws a descriptive error if neither is available so callers get a clear
+ * message instead of a cryptic TypeError.
+ */
+export function getTemporal() {
+    const native = globalThis.Temporal;
+    if (native !== undefined) {
+        return native;
+    }
+    if (_injected !== undefined) {
+        return _injected;
+    }
+    throw new Error('Temporal is not available. On Node.js < 26, inject a polyfill with setTemporal() ' +
+        'before using date-aware RRULE features (DTSTART, UNTIL). ' +
+        'See https://github.com/codewithagents/rrule#readme for the setup pattern.');
+}
+//# sourceMappingURL=temporal.js.map

package/dist/temporal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.js","sourceRoot":"","sources":["../src/temporal.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,0EAA0E;AAC1E,EAAE;AACF,4EAA4E;AAE5E,0EAA0E;AAC1E,qCAAqC;AACrC,IAAI,SAAsC,CAAA;AAE1C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,IAAqB;IAC/C,SAAS,GAAG,IAAI,CAAA;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,MAAM,GAAI,UAAsC,CAAC,QAAQ,CAAA;IAC/D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,MAAyB,CAAA;IAClC,CAAC;IACD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,MAAM,IAAI,KAAK,CACb,mFAAmF;QACjF,2DAA2D;QAC3D,2EAA2E,CAC9E,CAAA;AACH,CAAC"}

package/dist/text/index.d.ts

@@ -0,0 +1,24 @@
+import type { RRuleOptions } from '../types.js';
+/** Options accepted by toText. */
+export interface TextOptions {
+    /** Locale identifier, e.g. 'en' or 'de'. Defaults to 'en'. */
+    locale?: string;
+}
+/**
+ * Convert `RRuleOptions` to a human-readable recurrence description.
+ *
+ * @example toText({ freq: 'WEEKLY', byDay: [{ weekday: 'MO', ordinal: undefined }] })
+ *   // 'every week on Monday' (expansion phase)
+ *
+ * @stub Not yet implemented.
+ * TODO(expansion-phase): implement locale-aware text rendering.
+ */
+export declare function toText(_options: RRuleOptions, _textOptions?: TextOptions): never;
+/**
+ * Parse a human-readable recurrence description into `RRuleOptions`.
+ *
+ * @stub Not yet implemented.
+ * TODO(expansion-phase): implement natural-language RRULE parser.
+ */
+export declare function fromText(_text: string, _locale?: string): never;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/text/index.js

@@ -0,0 +1,28 @@
+// 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.
+/**
+ * Convert `RRuleOptions` to a human-readable recurrence description.
+ *
+ * @example toText({ freq: 'WEEKLY', byDay: [{ weekday: 'MO', ordinal: undefined }] })
+ *   // 'every week on Monday' (expansion phase)
+ *
+ * @stub Not yet implemented.
+ * TODO(expansion-phase): implement locale-aware text rendering.
+ */
+// v8 ignore next 3
+export function toText(_options, _textOptions) {
+    throw new Error('not implemented: toText (coming in expansion phase)');
+}
+/**
+ * Parse a human-readable recurrence description into `RRuleOptions`.
+ *
+ * @stub Not yet implemented.
+ * TODO(expansion-phase): implement natural-language RRULE parser.
+ */
+// v8 ignore next 3
+export function fromText(_text, _locale) {
+    throw new Error('not implemented: fromText (coming in expansion phase)');
+}
+//# sourceMappingURL=index.js.map

package/dist/text/index.js.map

@@ -0,0 +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"}

package/dist/types.d.ts

@@ -0,0 +1,83 @@
+/** Recurrence frequency, ordered from finest to coarsest (RFC 5545 §3.3.10). */
+export type Frequency = 'SECONDLY' | 'MINUTELY' | 'HOURLY' | 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY';
+/** ISO weekday abbreviations used in BYDAY and WKST values. */
+export type Weekday = 'MO' | 'TU' | 'WE' | 'TH' | 'FR' | 'SA' | 'SU';
+/**
+ * A BYDAY entry such as `MO`, `3MO`, or `-1FR`.
+ * When `ordinal` is undefined the entry applies to every occurrence of that
+ * weekday within the recurrence period (e.g. BYDAY=MO in a WEEKLY rule).
+ * When `ordinal` is set, it selects the nth (or nth-from-last) occurrence
+ * within a MONTHLY or YEARLY period (e.g. `2MO` = 2nd Monday).
+ */
+export interface WeekdayNum {
+    /** The ordinal position, e.g. 2 or -1. undefined means "all". */
+    ordinal: number | undefined;
+    weekday: Weekday;
+}
+/**
+ * A DTSTART value. Covers all four Temporal representations that iCalendar
+ * DTSTART can express:
+ * - Date-only:          Temporal.PlainDate
+ * - Floating datetime:  Temporal.PlainDateTime
+ * - UTC datetime:       Temporal.Instant
+ * - Zoned datetime:     Temporal.ZonedDateTime  (when TZID= is present)
+ */
+export type RRuleDtstart = Temporal.PlainDate | Temporal.PlainDateTime | Temporal.Instant | Temporal.ZonedDateTime;
+/**
+ * A UNTIL value. RFC 5545 mandates the same value type as DTSTART, so
+ * ZonedDateTime is not used here (UNTIL is always UTC or plain per spec).
+ */
+export type RRuleUntil = Temporal.PlainDate | Temporal.PlainDateTime | Temporal.Instant;
+/**
+ * Parsed and typed representation of an RFC 5545 RRULE, plus optional DTSTART
+ * and TZID context.
+ *
+ * Fields map directly to RRULE parts:
+ * - `freq`        FREQ (required)
+ * - `interval`    INTERVAL (default 1 when absent)
+ * - `count`       COUNT
+ * - `until`       UNTIL
+ * - `wkst`        WKST
+ * - `byMonth`     BYMONTH
+ * - `byMonthDay`  BYMONTHDAY
+ * - `byDay`       BYDAY
+ * - `byYearDay`   BYYEARDAY
+ * - `byWeekNo`    BYWEEKNO
+ * - `byHour`      BYHOUR
+ * - `byMinute`    BYMINUTE
+ * - `bySecond`    BYSECOND
+ * - `bySetPos`    BYSETPOS
+ * - `dtstart`     from a DTSTART content line (not part of the RRULE value)
+ * - `tzid`        from DTSTART;TZID= (not part of the RRULE value)
+ */
+export interface RRuleOptions {
+    freq: Frequency;
+    interval?: number;
+    count?: number;
+    until?: RRuleUntil;
+    wkst?: Weekday;
+    byMonth?: number[];
+    byMonthDay?: number[];
+    byDay?: WeekdayNum[];
+    byYearDay?: number[];
+    byWeekNo?: number[];
+    byHour?: number[];
+    byMinute?: number[];
+    bySecond?: number[];
+    bySetPos?: number[];
+    dtstart?: RRuleDtstart;
+    tzid?: string;
+}
+/** A single RFC validation failure. */
+export interface ValidationError {
+    /** The RRULE field that failed, e.g. "COUNT", "UNTIL", "BYDAY". */
+    field: string;
+    /**
+     * Stable machine-readable identifier for the rule, e.g. "COUNT_XNOR_UNTIL".
+     * Safe to use in translations and error maps.
+     */
+    ruleId: string;
+    /** Human-readable description of the failure. */
+    message: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAOA,gFAAgF;AAChF,MAAM,MAAM,SAAS,GACnB,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAA;AAEhF,+DAA+D;AAC/D,MAAM,MAAM,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAEpE;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,iEAAiE;IACjE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GACtB,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,aAAa,GAAG,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAA;AAEzF;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAA;AAEvF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,uCAAuC;AACvC,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;IACd,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAA;CAChB"}

package/dist/types.js

@@ -0,0 +1,8 @@
+// Public type model for RFC 5545 RRULE options.
+//
+// Temporal types (Temporal.Instant, Temporal.PlainDate, etc.) are used
+// directly. They are available as globals from TypeScript's lib.es2025.temporal
+// declarations (TypeScript >= 5.8 / 6.x). At runtime the library reads them
+// from globalThis.Temporal (Node >= 26) or from an injected polyfill.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,EAAE;AACF,uEAAuE;AACvE,gFAAgF;AAChF,4EAA4E;AAC5E,sEAAsE"}

package/dist/validate.d.ts

@@ -0,0 +1,22 @@
+import type { RRuleOptions, ValidationError } from './types.js';
+import type { Result } from './result.js';
+/**
+ * Validate cross-field RFC 5545 constraints on parsed `RRuleOptions`.
+ *
+ * Returns all errors found in a single pass; the caller sees the complete
+ * picture, not just the first problem. Never throws on user input.
+ *
+ * Rules checked:
+ * - COUNT and UNTIL are mutually exclusive
+ * - INTERVAL >= 1
+ * - COUNT >= 1
+ * - UNTIL value type matches DTSTART value type (RFC 5545 §3.3.10)
+ * - BYDAY ordinals only allowed for MONTHLY/YEARLY, not with BYWEEKNO
+ * - BYWEEKNO only valid with FREQ=YEARLY (RFC 5545 §3.3.10 Table 1)
+ * - BYYEARDAY not valid with DAILY, WEEKLY, MONTHLY (RFC 5545 §3.3.10 Table 1)
+ * - BYMONTHDAY not valid with FREQ=WEEKLY (RFC 5545 §3.3.10 Table 1)
+ * - BYSETPOS requires at least one other BYxxx rule (RFC 5545 §3.3.10)
+ * - BY* value ranges (BYMONTH 1-12, BYMONTHDAY ±1-31, BYHOUR 0-23, etc.)
+ */
+export declare function validate(options: RRuleOptions): Result<RRuleOptions, ValidationError[]>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAuPzC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAAC,YAAY,EAAE,eAAe,EAAE,CAAC,CAgBvF"}