v3.1.0-next.1

3.1.0-next.1 (2025-12-06)

• feat: add fromDate and fromTimestamp factory methods to DateTime (#654) (f0f5fd2), closes #654

v3.0.1-next.1

3.0.1-next.1 (2025-12-02)

• build(deps-dev): bump prettier from 3.6.2 to 3.7.3 (#651) (daf741a), closes #651
• chore: remove ts-jest (#653) (f83d324), closes #653
• Merge pull request #650 from lsndr/master (fa2f842), closes #650 #649

v3.0.0

The library now runs in browsers via WebAssembly, making it a truly universal solution for handling recurrence rules across all JavaScript environments.

The API has been completely redesigned with dedicated classes for all core concepts — DtStart, ExDate, RDate, and an enhanced DateTime — providing better type safety and a more intuitive developer experience. You can now work with date-only recurrence rules for all-day events, and take advantage of built-in results caching to speed up repeated queries.

Every public API is now documented with comprehensive JSDoc comments, giving you inline documentation and better autocomplete in your IDE.

✨ New Features

WASM Support

• Browser compatibility via WebAssembly - The library now supports browsers through WASM! Install with:

Date-Only RRules

• Date-only support - DateTime now supports date-only values (without time component)

Results Cache

• Results caching - New caching mechanism for improved performance on repeated queries

Enhanced API

• New DtStart object - Dedicated class for representing recurrence start dates with timezone support
• New ExDate object - First-class support for exclusion dates with proper encapsulation
• New RDate object - First-class support for additional recurrence dates
• toTimestamp() and toDate() methods - Convert DateTime instances to Unix timestamps or JavaScript Date objects
• Flexible type definitions - More permissive types for RRule configuration

Documentation

• Comprehensive JSDoc documentation - All public APIs now include detailed JSDoc comments for better IDE support and developer experience

---

💥 Breaking Changes

Constructor Changes

• Plain objects are no longer accepted directly in constructors - use the new dedicated classes (DtStart, ExDate, RDate, DateTime)
• Improved plain object handling with explicit toPlain()/fromPlain() methods

Method Renames

• Several method names have been adjusted for consistency
• Field names in DtStart now align with method names

Minimum Requirements

• Node.js 20+ is now required (previously Node.js 10+)
• npm 10+ is now required

---

📚 Examples

// Before (v2.x)
const set = new RRuleSet({
  dtstart: DateTime.local(2024, 1, 1, 9, 0, 0),
  tzid: 'US/Eastern',
  rrules: [rrule],
});

// After (v3.x)
import { RRuleSet, RRule, DateTime, DtStart } from 'rrule-rust';

const set = new RRuleSet({
  dtstart: new DtStart(DateTime.local(2024, 1, 1, 9, 0, 0), 'US/Eastern'),
  rrules: [rrule],
});

// New: Get results as timestamps or Date objects
const dates = set.all();
dates[0].toTimestamp(); // Unix timestamp
dates[0].toDate(); // JavaScript Date

v3.0.0-next.9

3.0.0-next.9 (2025-11-28)

• fix: properly import WASM package (#639) (2e7ff95), closes #639

v3.0.0-next.15

3.0.0-next.15 (2025-11-28)

• build: bump version (5f50aba)

v3.0.0-next.14

3.0.0-next.14 (2025-11-28)

• build: actualize subpackages info (36d5698)

v3.0.0-next.13

3.0.0-next.13 (2025-11-28)

• build: enable napi github releases (#646) (9fe98d6), closes #646

v3.0.0-next.12

3.0.0-next.12 (2025-11-28)

• build: enable publishing of subpackages (#645) (8852394), closes #645

v3.0.0-next.11

3.0.0-next.11 (2025-11-28)

• build: disable napi-rs publishing (#643) (0d9ff8d), closes #643
• test(e2e): run sandbox in package path (#644) (f304db5), closes #644
• test(e2e): run sandbox in system OS dir (#642) (4e4623b), closes #642
• fix: do not patch package in prod (#641) (f76af01), closes #641

v3.0.0-next.10

3.0.0-next.10 (2025-11-28)

• refactor: simplify WASM loading patch (#640) (fe46206), closes #640