@atlastodo/shared 0.0.0-stage → 0.1.11-rc.5

package/test-vectors/recurrence_vectors.json

@@ -0,0 +1,779 @@
+{
+  "_comment": "Golden vectors for the recurrence engine. The engine is civil (wall-clock): each vector gives `anchor`/`from`/`expected` both as Unix ms and as the wall-clock time they show in `tz` (`*_local`, ISO without offset). The test runs nextOccurrence(rule, anchor, from, tz) on the instants and the civil engine on the locals. `expected` is null when the rule is invalid or the next occurrence falls outside the JS Date range (|ms| > 8.64e15); `expected_local` is null only when the rule is invalid. `parse` lists rules the parser must accept or reject. Asserted by packages/shared/src/recurrence.test.ts.",
+  "vectors": [
+    {
+      "name": "daily every 1, on schedule",
+      "rule": "FREQ=DAILY",
+      "tz": "UTC",
+      "anchor": 1672531200000,
+      "anchor_local": "2023-01-01T00:00:00",
+      "from": 1672531200000,
+      "from_local": "2023-01-01T00:00:00",
+      "expected": 1672617600000,
+      "expected_local": "2023-01-02T00:00:00"
+    },
+    {
+      "name": "daily every 2, on schedule",
+      "rule": "FREQ=DAILY;INTERVAL=2",
+      "tz": "UTC",
+      "anchor": 1672531200000,
+      "anchor_local": "2023-01-01T00:00:00",
+      "from": 1672531200000,
+      "from_local": "2023-01-01T00:00:00",
+      "expected": 1672704000000,
+      "expected_local": "2023-01-03T00:00:00"
+    },
+    {
+      "name": "daily preserves time of day (09:00Z)",
+      "rule": "FREQ=DAILY",
+      "tz": "UTC",
+      "anchor": 1672563600000,
+      "anchor_local": "2023-01-01T09:00:00",
+      "from": 1672563600000,
+      "from_local": "2023-01-01T09:00:00",
+      "expected": 1672650000000,
+      "expected_local": "2023-01-02T09:00:00"
+    },
+    {
+      "name": "daily every 3, after completion re-anchors to completion day",
+      "rule": "FREQ=DAILY;INTERVAL=3;MODE=COMPLETION",
+      "tz": "UTC",
+      "anchor": 1672531200000,
+      "anchor_local": "2023-01-01T00:00:00",
+      "from": 1672876800000,
+      "from_local": "2023-01-05T00:00:00",
+      "expected": 1673136000000,
+      "expected_local": "2023-01-08T00:00:00"
+    },
+    {
+      "name": "daily every 2, after completion completed 10 days late (due Jan 1, completed Jan 11)",
+      "rule": "FREQ=DAILY;INTERVAL=2;MODE=COMPLETION",
+      "tz": "UTC",
+      "anchor": 1672531200000,
+      "anchor_local": "2023-01-01T00:00:00",
+      "from": 1673395200000,
+      "from_local": "2023-01-11T00:00:00",
+      "expected": 1673568000000,
+      "expected_local": "2023-01-13T00:00:00"
+    },
+    {
+      "name": "daily every 2, after completion completed a day early (due Jan 10, completed Jan 9)",
+      "rule": "FREQ=DAILY;INTERVAL=2;MODE=COMPLETION",
+      "tz": "UTC",
+      "anchor": 1673308800000,
+      "anchor_local": "2023-01-10T00:00:00",
+      "from": 1673222400000,
+      "from_local": "2023-01-09T00:00:00",
+      "expected": 1673395200000,
+      "expected_local": "2023-01-11T00:00:00"
+    },
+    {
+      "name": "daily after completion keeps the anchor's time of day (due 09:00Z, completed Jan 5 15:00Z)",
+      "rule": "FREQ=DAILY;MODE=COMPLETION",
+      "tz": "UTC",
+      "anchor": 1672563600000,
+      "anchor_local": "2023-01-01T09:00:00",
+      "from": 1672930800000,
+      "from_local": "2023-01-05T15:00:00",
+      "expected": 1672995600000,
+      "expected_local": "2023-01-06T09:00:00"
+    },
+    {
+      "name": "weekly every 1, after completion counts from the completion day (completed Fri Jan 6)",
+      "rule": "FREQ=WEEKLY;MODE=COMPLETION",
+      "tz": "UTC",
+      "anchor": 1672617600000,
+      "anchor_local": "2023-01-02T00:00:00",
+      "from": 1672963200000,
+      "from_local": "2023-01-06T00:00:00",
+      "expected": 1673568000000,
+      "expected_local": "2023-01-13T00:00:00"
+    },
+    {
+      "name": "weekly byday, after completion picks the next rule weekday after the completion day (completed Thu Jan 5)",
+      "rule": "FREQ=WEEKLY;BYDAY=MO,WE;MODE=COMPLETION",
+      "tz": "UTC",
+      "anchor": 1672617600000,
+      "anchor_local": "2023-01-02T00:00:00",
+      "from": 1672876800000,
+      "from_local": "2023-01-05T00:00:00",
+      "expected": 1673222400000,
+      "expected_local": "2023-01-09T00:00:00"
+    },
+    {
+      "name": "weekly every 2 byday, after completion still counts interval weeks from the anchor's week (completed Wed Jan 11)",
+      "rule": "FREQ=WEEKLY;INTERVAL=2;BYDAY=MO;MODE=COMPLETION",
+      "tz": "UTC",
+      "anchor": 1672617600000,
+      "anchor_local": "2023-01-02T00:00:00",
+      "from": 1673395200000,
+      "from_local": "2023-01-11T00:00:00",
+      "expected": 1673827200000,
+      "expected_local": "2023-01-16T00:00:00"
+    },
+    {
+      "name": "monthly after completion clamps to month end (completed Jan 31 -> Feb 28)",
+      "rule": "FREQ=MONTHLY;MODE=COMPLETION",
+      "tz": "UTC",
+      "anchor": 1675123200000,
+      "anchor_local": "2023-01-31T00:00:00",
+      "from": 1675166400000,
+      "from_local": "2023-01-31T12:00:00",
+      "expected": 1677542400000,
+      "expected_local": "2023-02-28T00:00:00"
+    },
+    {
+      "name": "yearly after completion clamps leap day (completed Feb 29 2024 -> Feb 28 2025)",
+      "rule": "FREQ=YEARLY;MODE=COMPLETION",
+      "tz": "UTC",
+      "anchor": 1709164800000,
+      "anchor_local": "2024-02-29T00:00:00",
+      "from": 1709186400000,
+      "from_local": "2024-02-29T06:00:00",
+      "expected": 1740700800000,
+      "expected_local": "2025-02-28T00:00:00"
+    },
+    {
+      "name": "UTC: after completion on 2023-03-12 (a US DST day) is plain calendar-day math, since UTC has no DST",
+      "rule": "FREQ=DAILY;MODE=COMPLETION",
+      "tz": "UTC",
+      "anchor": 1678608000000,
+      "anchor_local": "2023-03-12T08:00:00",
+      "from": 1678651200000,
+      "from_local": "2023-03-12T20:00:00",
+      "expected": 1678694400000,
+      "expected_local": "2023-03-13T08:00:00"
+    },
+    {
+      "name": "explicit MODE=SCHEDULE behaves like the default and ignores the completion reference",
+      "rule": "FREQ=DAILY;MODE=SCHEDULE",
+      "tz": "UTC",
+      "anchor": 1672531200000,
+      "anchor_local": "2023-01-01T00:00:00",
+      "from": 1000000000000,
+      "from_local": "2001-09-09T01:46:40",
+      "expected": 1672617600000,
+      "expected_local": "2023-01-02T00:00:00"
+    },
+    {
+      "name": "weekly every 1, no byday",
+      "rule": "FREQ=WEEKLY",
+      "tz": "UTC",
+      "anchor": 1672531200000,
+      "anchor_local": "2023-01-01T00:00:00",
+      "from": 1672531200000,
+      "from_local": "2023-01-01T00:00:00",
+      "expected": 1673136000000,
+      "expected_local": "2023-01-08T00:00:00"
+    },
+    {
+      "name": "weekly every 2, no byday",
+      "rule": "FREQ=WEEKLY;INTERVAL=2",
+      "tz": "UTC",
+      "anchor": 1672531200000,
+      "anchor_local": "2023-01-01T00:00:00",
+      "from": 1672531200000,
+      "from_local": "2023-01-01T00:00:00",
+      "expected": 1673740800000,
+      "expected_local": "2023-01-15T00:00:00"
+    },
+    {
+      "name": "weekly byday Mon/Wed/Fri from Monday -> Wednesday",
+      "rule": "FREQ=WEEKLY;BYDAY=MO,WE,FR",
+      "tz": "UTC",
+      "anchor": 1672617600000,
+      "anchor_local": "2023-01-02T00:00:00",
+      "from": 1672617600000,
+      "from_local": "2023-01-02T00:00:00",
+      "expected": 1672790400000,
+      "expected_local": "2023-01-04T00:00:00"
+    },
+    {
+      "name": "monthly every 1",
+      "rule": "FREQ=MONTHLY",
+      "tz": "UTC",
+      "anchor": 1673740800000,
+      "anchor_local": "2023-01-15T00:00:00",
+      "from": 1673740800000,
+      "from_local": "2023-01-15T00:00:00",
+      "expected": 1676419200000,
+      "expected_local": "2023-02-15T00:00:00"
+    },
+    {
+      "name": "monthly clamps to month end (Jan 31 -> Feb 28)",
+      "rule": "FREQ=MONTHLY",
+      "tz": "UTC",
+      "anchor": 1675123200000,
+      "anchor_local": "2023-01-31T00:00:00",
+      "from": 1675123200000,
+      "from_local": "2023-01-31T00:00:00",
+      "expected": 1677542400000,
+      "expected_local": "2023-02-28T00:00:00"
+    },
+    {
+      "name": "yearly every 1",
+      "rule": "FREQ=YEARLY",
+      "tz": "UTC",
+      "anchor": 1672531200000,
+      "anchor_local": "2023-01-01T00:00:00",
+      "from": 1672531200000,
+      "from_local": "2023-01-01T00:00:00",
+      "expected": 1704067200000,
+      "expected_local": "2024-01-01T00:00:00"
+    },
+    {
+      "name": "yearly clamps leap day (Feb 29 2024 -> Feb 28 2025)",
+      "rule": "FREQ=YEARLY",
+      "tz": "UTC",
+      "anchor": 1709164800000,
+      "anchor_local": "2024-02-29T00:00:00",
+      "from": 1709164800000,
+      "from_local": "2024-02-29T00:00:00",
+      "expected": 1740700800000,
+      "expected_local": "2025-02-28T00:00:00"
+    },
+    {
+      "name": "yearly leap-day anchor clamps in a common year (Feb 29 2024 -> Feb 28 2025)",
+      "rule": "FREQ=YEARLY;BYMONTHDAY=29",
+      "tz": "UTC",
+      "anchor": 1709197200000,
+      "anchor_local": "2024-02-29T09:00:00",
+      "from": 1709197200000,
+      "from_local": "2024-02-29T09:00:00",
+      "expected": 1740733200000,
+      "expected_local": "2025-02-28T09:00:00"
+    },
+    {
+      "name": "yearly leap-day anchor returns to Feb 29 in a leap year (Feb 28 2027 -> Feb 29 2028)",
+      "rule": "FREQ=YEARLY;BYMONTHDAY=29",
+      "tz": "UTC",
+      "anchor": 1803805200000,
+      "anchor_local": "2027-02-28T09:00:00",
+      "from": 1803805200000,
+      "from_local": "2027-02-28T09:00:00",
+      "expected": 1835427600000,
+      "expected_local": "2028-02-29T09:00:00"
+    },
+    {
+      "name": "yearly leap-day anchor is ignored outside February (Mar 5 2025 -> Mar 5 2026)",
+      "rule": "FREQ=YEARLY;BYMONTHDAY=29",
+      "tz": "UTC",
+      "anchor": 1741165200000,
+      "anchor_local": "2025-03-05T09:00:00",
+      "from": 1741165200000,
+      "from_local": "2025-03-05T09:00:00",
+      "expected": 1772701200000,
+      "expected_local": "2026-03-05T09:00:00"
+    },
+    {
+      "name": "invalid rule yields no occurrence",
+      "rule": "FREQ=BOGUS",
+      "tz": "UTC",
+      "anchor": 1,
+      "anchor_local": "1970-01-01T00:00:00.001",
+      "from": 1,
+      "from_local": "1970-01-01T00:00:00.001",
+      "expected": null,
+      "expected_local": null
+    },
+    {
+      "name": "invalid MODE yields no occurrence",
+      "rule": "FREQ=DAILY;MODE=BOGUS",
+      "tz": "UTC",
+      "anchor": 1672531200000,
+      "anchor_local": "2023-01-01T00:00:00",
+      "from": 1672531200000,
+      "from_local": "2023-01-01T00:00:00",
+      "expected": null,
+      "expected_local": null
+    },
+    {
+      "name": "empty rule yields no occurrence",
+      "rule": "",
+      "tz": "UTC",
+      "anchor": 1,
+      "anchor_local": "1970-01-01T00:00:00.001",
+      "from": 1,
+      "from_local": "1970-01-01T00:00:00.001",
+      "expected": null,
+      "expected_local": null
+    },
+    {
+      "name": "weekly every 1000 on Mon steps a thousand weeks without scanning them",
+      "rule": "FREQ=WEEKLY;INTERVAL=1000;BYDAY=MO",
+      "tz": "UTC",
+      "anchor": 1672617600000,
+      "anchor_local": "2023-01-02T00:00:00",
+      "from": 1672617600000,
+      "from_local": "2023-01-02T00:00:00",
+      "expected": 2277417600000,
+      "expected_local": "2042-03-03T00:00:00"
+    },
+    {
+      "name": "weekly every 3 on Tue/Thu after completion lands in the next interval week (completed Fri Jan 20)",
+      "rule": "FREQ=WEEKLY;INTERVAL=3;BYDAY=TU,TH;MODE=COMPLETION",
+      "tz": "UTC",
+      "anchor": 1672617600000,
+      "anchor_local": "2023-01-02T00:00:00",
+      "from": 1674226800000,
+      "from_local": "2023-01-20T15:00:00",
+      "expected": 1674518400000,
+      "expected_local": "2023-01-24T00:00:00"
+    },
+    {
+      "name": "weekly every 2 on Wed after completion completed before the anchor week waits for the anchor week",
+      "rule": "FREQ=WEEKLY;INTERVAL=2;BYDAY=WE;MODE=COMPLETION",
+      "tz": "UTC",
+      "anchor": 1673827200000,
+      "anchor_local": "2023-01-16T00:00:00",
+      "from": 1672704000000,
+      "from_local": "2023-01-03T00:00:00",
+      "expected": 1674000000000,
+      "expected_local": "2023-01-18T00:00:00"
+    },
+    {
+      "name": "INTERVAL above 1000 yields no occurrence",
+      "rule": "FREQ=WEEKLY;INTERVAL=4294967295;BYDAY=MO",
+      "tz": "UTC",
+      "anchor": 1672617600000,
+      "anchor_local": "2023-01-02T00:00:00",
+      "from": 1672617600000,
+      "from_local": "2023-01-02T00:00:00",
+      "expected": null,
+      "expected_local": null
+    },
+    {
+      "name": "a next occurrence past the end of the Date range yields none (the civil date still exists)",
+      "rule": "FREQ=DAILY",
+      "tz": "UTC",
+      "anchor": 8640000000000000,
+      "anchor_local": "275760-09-13T00:00:00",
+      "from": 8640000000000000,
+      "from_local": "275760-09-13T00:00:00",
+      "expected": null,
+      "expected_local": "275760-09-14T00:00:00"
+    },
+    {
+      "name": "Copenhagen: daily all-day Sat 2026-03-28 23:59 -> Sun 03-29 23:59 across spring-forward (no skipped Sunday, stays all-day)",
+      "rule": "FREQ=DAILY",
+      "tz": "Europe/Copenhagen",
+      "anchor": 1774738740000,
+      "anchor_local": "2026-03-28T23:59:00",
+      "from": 1774738740000,
+      "from_local": "2026-03-28T23:59:00",
+      "expected": 1774821540000,
+      "expected_local": "2026-03-29T23:59:00"
+    },
+    {
+      "name": "Copenhagen: daily all-day Sat 2026-10-24 23:59 -> Sun 10-25 23:59 across fall-back",
+      "rule": "FREQ=DAILY",
+      "tz": "Europe/Copenhagen",
+      "anchor": 1792879140000,
+      "anchor_local": "2026-10-24T23:59:00",
+      "from": 1792879140000,
+      "from_local": "2026-10-24T23:59:00",
+      "expected": 1792969140000,
+      "expected_local": "2026-10-25T23:59:00"
+    },
+    {
+      "name": "New York: BYDAY=MO,WE all-day Mon 2026-01-05 -> Wed 01-07 (the local weekday, not the UTC one)",
+      "rule": "FREQ=WEEKLY;BYDAY=MO,WE",
+      "tz": "America/New_York",
+      "anchor": 1767675540000,
+      "anchor_local": "2026-01-05T23:59:00",
+      "from": 1767675540000,
+      "from_local": "2026-01-05T23:59:00",
+      "expected": 1767848340000,
+      "expected_local": "2026-01-07T23:59:00"
+    },
+    {
+      "name": "New York: every 2 weeks on Mon counts interval weeks from the local anchor week (Mon 2026-01-05 -> 01-19)",
+      "rule": "FREQ=WEEKLY;INTERVAL=2;BYDAY=MO",
+      "tz": "America/New_York",
+      "anchor": 1767675540000,
+      "anchor_local": "2026-01-05T23:59:00",
+      "from": 1767675540000,
+      "from_local": "2026-01-05T23:59:00",
+      "expected": 1768885140000,
+      "expected_local": "2026-01-19T23:59:00"
+    },
+    {
+      "name": "New York: daily after completion, all-day due 2026-01-10 completed 01-11 10:00 -> 01-12 (not the completion day itself)",
+      "rule": "FREQ=DAILY;MODE=COMPLETION",
+      "tz": "America/New_York",
+      "anchor": 1768107540000,
+      "anchor_local": "2026-01-10T23:59:00",
+      "from": 1768143600000,
+      "from_local": "2026-01-11T10:00:00",
+      "expected": 1768280340000,
+      "expected_local": "2026-01-12T23:59:00"
+    },
+    {
+      "name": "New York: monthly all-day 2026-04-30 -> 05-30 (not 05-31)",
+      "rule": "FREQ=MONTHLY",
+      "tz": "America/New_York",
+      "anchor": 1777607940000,
+      "anchor_local": "2026-04-30T23:59:00",
+      "from": 1777607940000,
+      "from_local": "2026-04-30T23:59:00",
+      "expected": 1780199940000,
+      "expected_local": "2026-05-30T23:59:00"
+    },
+    {
+      "name": "New York: monthly all-day clamps Jan 31 -> Feb 28 on the local calendar",
+      "rule": "FREQ=MONTHLY",
+      "tz": "America/New_York",
+      "anchor": 1769921940000,
+      "anchor_local": "2026-01-31T23:59:00",
+      "from": 1769921940000,
+      "from_local": "2026-01-31T23:59:00",
+      "expected": 1772341140000,
+      "expected_local": "2026-02-28T23:59:00"
+    },
+    {
+      "name": "New York: yearly all-day leap day 2024-02-29 -> 2025-02-28",
+      "rule": "FREQ=YEARLY",
+      "tz": "America/New_York",
+      "anchor": 1709269140000,
+      "anchor_local": "2024-02-29T23:59:00",
+      "from": 1709269140000,
+      "from_local": "2024-02-29T23:59:00",
+      "expected": 1740805140000,
+      "expected_local": "2025-02-28T23:59:00"
+    },
+    {
+      "name": "New York: daily all-day 2023-03-11 -> 03-12 across the US spring-forward (a 23-hour step)",
+      "rule": "FREQ=DAILY",
+      "tz": "America/New_York",
+      "anchor": 1678597140000,
+      "anchor_local": "2023-03-11T23:59:00",
+      "from": 1678597140000,
+      "from_local": "2023-03-11T23:59:00",
+      "expected": 1678679940000,
+      "expected_local": "2023-03-12T23:59:00"
+    },
+    {
+      "name": "Copenhagen: timed after completion takes the local completion day (due 09:00, completed 00:30 local = the previous UTC day)",
+      "rule": "FREQ=DAILY;MODE=COMPLETION",
+      "tz": "Europe/Copenhagen",
+      "anchor": 1780297200000,
+      "anchor_local": "2026-06-01T09:00:00",
+      "from": 1780612200000,
+      "from_local": "2026-06-05T00:30:00",
+      "expected": 1780729200000,
+      "expected_local": "2026-06-06T09:00:00"
+    },
+    {
+      "name": "Copenhagen: weekly after completion keeps the wall-clock time across spring-forward (due 08:00 Mon 03-23, completed Fri 03-27)",
+      "rule": "FREQ=WEEKLY;MODE=COMPLETION",
+      "tz": "Europe/Copenhagen",
+      "anchor": 1774249200000,
+      "anchor_local": "2026-03-23T08:00:00",
+      "from": 1774630800000,
+      "from_local": "2026-03-27T18:00:00",
+      "expected": 1775196000000,
+      "expected_local": "2026-04-03T08:00:00"
+    },
+    {
+      "name": "Tokyo: BYDAY=MO,FR from Mon 2026-01-05 08:00 (still Sunday in UTC) -> Fri 01-09 08:00",
+      "rule": "FREQ=WEEKLY;BYDAY=MO,FR",
+      "tz": "Asia/Tokyo",
+      "anchor": 1767567600000,
+      "anchor_local": "2026-01-05T08:00:00",
+      "from": 1767567600000,
+      "from_local": "2026-01-05T08:00:00",
+      "expected": 1767913200000,
+      "expected_local": "2026-01-09T08:00:00"
+    },
+    {
+      "name": "monthly on day 31 clamps Jan 31 -> Feb 28",
+      "rule": "FREQ=MONTHLY;BYMONTHDAY=31",
+      "tz": "UTC",
+      "anchor": 1675123200000,
+      "anchor_local": "2023-01-31T00:00:00",
+      "from": 1675123200000,
+      "from_local": "2023-01-31T00:00:00",
+      "expected": 1677542400000,
+      "expected_local": "2023-02-28T00:00:00"
+    },
+    {
+      "name": "monthly on day 31 returns to the 31st after February (Feb 28 -> Mar 31)",
+      "rule": "FREQ=MONTHLY;BYMONTHDAY=31",
+      "tz": "UTC",
+      "anchor": 1677542400000,
+      "anchor_local": "2023-02-28T00:00:00",
+      "from": 1677542400000,
+      "from_local": "2023-02-28T00:00:00",
+      "expected": 1680220800000,
+      "expected_local": "2023-03-31T00:00:00"
+    },
+    {
+      "name": "monthly on day 31 takes Feb 29 in a leap year (Jan 31 -> Feb 29 2024)",
+      "rule": "FREQ=MONTHLY;BYMONTHDAY=31",
+      "tz": "UTC",
+      "anchor": 1706659200000,
+      "anchor_local": "2024-01-31T00:00:00",
+      "from": 1706659200000,
+      "from_local": "2024-01-31T00:00:00",
+      "expected": 1709164800000,
+      "expected_local": "2024-02-29T00:00:00"
+    },
+    {
+      "name": "monthly on day 31 after a 30-day month (Apr 30 -> May 31)",
+      "rule": "FREQ=MONTHLY;BYMONTHDAY=31",
+      "tz": "UTC",
+      "anchor": 1682812800000,
+      "anchor_local": "2023-04-30T00:00:00",
+      "from": 1682812800000,
+      "from_local": "2023-04-30T00:00:00",
+      "expected": 1685491200000,
+      "expected_local": "2023-05-31T00:00:00"
+    },
+    {
+      "name": "monthly on day 30 after February (Feb 28 -> Mar 30)",
+      "rule": "FREQ=MONTHLY;BYMONTHDAY=30",
+      "tz": "UTC",
+      "anchor": 1677542400000,
+      "anchor_local": "2023-02-28T00:00:00",
+      "from": 1677542400000,
+      "from_local": "2023-02-28T00:00:00",
+      "expected": 1680134400000,
+      "expected_local": "2023-03-30T00:00:00"
+    },
+    {
+      "name": "every 2 months on day 31 across a year end (Dec 31 -> Feb 28)",
+      "rule": "FREQ=MONTHLY;INTERVAL=2;BYMONTHDAY=31",
+      "tz": "UTC",
+      "anchor": 1672444800000,
+      "anchor_local": "2022-12-31T00:00:00",
+      "from": 1672444800000,
+      "from_local": "2022-12-31T00:00:00",
+      "expected": 1677542400000,
+      "expected_local": "2023-02-28T00:00:00"
+    },
+    {
+      "name": "every 2 months on day 31 after February (Feb 28 -> Apr 30)",
+      "rule": "FREQ=MONTHLY;INTERVAL=2;BYMONTHDAY=31",
+      "tz": "UTC",
+      "anchor": 1677542400000,
+      "anchor_local": "2023-02-28T00:00:00",
+      "from": 1677542400000,
+      "from_local": "2023-02-28T00:00:00",
+      "expected": 1682812800000,
+      "expected_local": "2023-04-30T00:00:00"
+    },
+    {
+      "name": "monthly on day 15 from a rescheduled occurrence (Jan 20 -> Feb 15)",
+      "rule": "FREQ=MONTHLY;BYMONTHDAY=15",
+      "tz": "UTC",
+      "anchor": 1674207000000,
+      "anchor_local": "2023-01-20T09:30:00",
+      "from": 1674207000000,
+      "from_local": "2023-01-20T09:30:00",
+      "expected": 1676453400000,
+      "expected_local": "2023-02-15T09:30:00"
+    },
+    {
+      "name": "monthly on day 31 after completion ignores the day and counts from the completion day (completed Feb 10 -> Mar 10)",
+      "rule": "FREQ=MONTHLY;BYMONTHDAY=31;MODE=COMPLETION",
+      "tz": "UTC",
+      "anchor": 1675123200000,
+      "anchor_local": "2023-01-31T00:00:00",
+      "from": 1676030400000,
+      "from_local": "2023-02-10T12:00:00",
+      "expected": 1678406400000,
+      "expected_local": "2023-03-10T00:00:00"
+    },
+    {
+      "name": "monthly without BYMONTHDAY (stored before it existed) still keeps the previous day (Feb 28 -> Mar 28)",
+      "rule": "FREQ=MONTHLY",
+      "tz": "UTC",
+      "anchor": 1677542400000,
+      "anchor_local": "2023-02-28T00:00:00",
+      "from": 1677542400000,
+      "from_local": "2023-02-28T00:00:00",
+      "expected": 1679961600000,
+      "expected_local": "2023-03-28T00:00:00"
+    },
+    {
+      "name": "New York: monthly on day 31 all-day Feb 28 -> Mar 31 on the local calendar",
+      "rule": "FREQ=MONTHLY;BYMONTHDAY=31",
+      "tz": "America/New_York",
+      "anchor": 1772341140000,
+      "anchor_local": "2026-02-28T23:59:00",
+      "from": 1772341140000,
+      "from_local": "2026-02-28T23:59:00",
+      "expected": 1775015940000,
+      "expected_local": "2026-03-31T23:59:00"
+    },
+    {
+      "name": "Copenhagen: monthly on day 31 at 09:00 Mar 31 -> Apr 30 09:00 (after spring-forward)",
+      "rule": "FREQ=MONTHLY;BYMONTHDAY=31",
+      "tz": "Europe/Copenhagen",
+      "anchor": 1774940400000,
+      "anchor_local": "2026-03-31T09:00:00",
+      "from": 1774940400000,
+      "from_local": "2026-03-31T09:00:00",
+      "expected": 1777532400000,
+      "expected_local": "2026-04-30T09:00:00"
+    }
+  ],
+  "parse": [
+    {
+      "rule": "FREQ=DAILY;INTERVAL=1000",
+      "valid": true
+    },
+    {
+      "rule": "FREQ=DAILY;INTERVAL=1001",
+      "valid": false
+    },
+    {
+      "rule": "FREQ=DAILY;INTERVAL=007",
+      "valid": true
+    },
+    {
+      "rule": "FREQ=DAILY;INTERVAL=0",
+      "valid": false
+    },
+    {
+      "rule": "FREQ=DAILY;INTERVAL=+5",
+      "valid": false
+    },
+    {
+      "rule": "FREQ=DAILY;INTERVAL=-1",
+      "valid": false
+    },
+    {
+      "rule": "FREQ=DAILY;INTERVAL=1.5",
+      "valid": false
+    },
+    {
+      "rule": "FREQ=DAILY;INTERVAL=",
+      "valid": false
+    },
+    {
+      "rule": "FREQ=DAILY;INTERVAL=4294967296",
+      "valid": false
+    },
+    {
+      "rule": "FREQ=DAILY;INTERVAL=99999999999999999999999",
+      "valid": false
+    },
+    {
+      "rule": "FREQ=DAILY;INTERVAL=\u0663",
+      "valid": false
+    },
+    {
+      "rule": "freq=weekly;interval=2;byday=mo,we;mode=completion",
+      "valid": true
+    },
+    {
+      "rule": " FREQ = DAILY ; INTERVAL = 2 ",
+      "valid": true
+    },
+    {
+      "rule": "freq=da\u0131ly",
+      "valid": false
+    },
+    {
+      "rule": "FREQ=WEEKLY;BYDAY=\u017fu",
+      "valid": false
+    },
+    {
+      "rule": "FREQ=DAILY;MODE=\u017fchedule",
+      "valid": false
+    },
+    {
+      "rule": "\ufeffFREQ=DAILY",
+      "valid": false
+    },
+    {
+      "rule": "\u000bFREQ=DAILY",
+      "valid": false
+    },
+    {
+      "rule": "FREQ=DAILY;\u00a0INTERVAL=2",
+      "valid": false
+    },
+    {
+      "rule": "FREQ=DAILY\u0085",
+      "valid": false
+    },
+    {
+      "rule": "FREQ=WEEKLY;BYDAY=MO,,WE,",
+      "valid": true
+    },
+    {
+      "rule": "FREQ=DAILY;;",
+      "valid": true
+    },
+    {
+      "rule": "FREQ=DAILY;INTERVAL",
+      "valid": false
+    },
+    {
+      "rule": "FREQ=MONTHLY;BYMONTHDAY=31",
+      "valid": true
+    },
+    {
+      "rule": "FREQ=MONTHLY;BYMONTHDAY=1",
+      "valid": true
+    },
+    {
+      "rule": "BYMONTHDAY=15;FREQ=MONTHLY",
+      "valid": true
+    },
+    {
+      "rule": "freq=monthly;bymonthday=07;mode=completion",
+      "valid": true
+    },
+    {
+      "rule": "FREQ=MONTHLY;BYMONTHDAY=0",
+      "valid": false
+    },
+    {
+      "rule": "FREQ=MONTHLY;BYMONTHDAY=32",
+      "valid": false
+    },
+    {
+      "rule": "FREQ=MONTHLY;BYMONTHDAY=-1",
+      "valid": false
+    },
+    {
+      "rule": "FREQ=MONTHLY;BYMONTHDAY=+5",
+      "valid": false
+    },
+    {
+      "rule": "FREQ=MONTHLY;BYMONTHDAY=1,15",
+      "valid": false
+    },
+    {
+      "rule": "FREQ=MONTHLY;BYMONTHDAY=",
+      "valid": false
+    },
+    {
+      "rule": "FREQ=MONTHLY;BYMONTHDAY=4294967327",
+      "valid": false
+    },
+    {
+      "rule": "FREQ=MONTHLY;BYMONTHDAY=\u0663",
+      "valid": false
+    },
+    {
+      "rule": "FREQ=DAILY;BYMONTHDAY=15",
+      "valid": false
+    },
+    {
+      "rule": "FREQ=WEEKLY;BYMONTHDAY=15",
+      "valid": false
+    },
+    {
+      "rule": "FREQ=YEARLY;BYMONTHDAY=29",
+      "valid": true
+    },
+    {
+      "rule": "FREQ=YEARLY;BYMONTHDAY=28",
+      "valid": false
+    }
+  ]
+}