Recurrence module

Đang mở
  • Có gì không ổn?
#29 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
25/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
typescript
Lĩnh vực
backend-api-design

Hướng nghiên cứu

Start with parent issue #25 and the blocked module API issue #28, then trace how the kernel's read and write pipelines and the Calendar product factory register modules. Review the RecurrenceRule model and the occurrence projection; identify how the listed acceptance criteria fit together before estimating the work. Done means the module meets the recurrence, editing, navigation, and tree-shaking criteria while keeping occurrences ephemeral.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

enhancement

Parent

https://github.com/TanStack/time/issues/25

What to build

Extract recurrence expansion and editing into a proper module that plugs into the kernel's read and write pipelines. When registered, the module expands Master Events into ephemeral Occurrences within the current viewport and handles all recurrence-specific writes (edit-this, edit-this-and-following, delete-this, delete-all).

Also extend the `RecurrenceRule` model to cover the full UI-builder subset: add `byMonthDay` (supports negative values, e.g. `-1` = last day of month) and ordinal weekdays (e.g. `{ weekday: 2, nth: 2 }` = 2nd Tuesday, `{ weekday: 5, nth: -1 }` = last Friday).

Occurrences are ephemeral — derived in the projection, never stored. The Master Event carries the rule; Overrides and Exceptions live on the master's rule.

Acceptance criteria

  • `RecurrenceModule` plugs into the kernel via the module API (#28) and is listed as a registered module in the Calendar product factory
  • A Master Event with a `RecurrenceRule` produces the correct Occurrences for the current viewport
  • Editing a single Occurrence creates an Override keyed by original start (RECURRENCE-ID); other occurrences are unaffected
  • Editing "this and following" splits the master at the occurrence boundary, producing a new master for the remainder
  • Deleting a single Occurrence adds it to `exDates` (Exception); the series continues
  • `byMonthDay` (including negative values) generates the correct occurrences for monthly/yearly rules
  • Ordinal weekday (`{ weekday, nth }`) generates the correct occurrences (e.g. 2nd Tuesday, last Friday)
  • `goToNextOccurrence` / `goToPreviousOccurrence` navigate correctly across the series
  • Removing the `RecurrenceModule` from the module list causes recurrence-related code to tree-shake out of the bundle

Blocked by

https://github.com/TanStack/time/issues/28

Ngôn ngữ chính
TypeScript
Star
620
Fork
6
Không có pull request nào được merge trong 30 ngày

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của TanStack/time

Tất cả issue của TanStack/time

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.