@j13b/scheduler 0.0.0-stage → 0.1.0

package/dist/generators/days_of_week.js

@@ -0,0 +1,43 @@
+import { addDaysInTz, computeSpanEnd, isNonexistentWallTime, utcToWallParts, wallTimeToUtc } from "../tz.js";
+import { TooManyOccurrencesError, intersects } from "./types.js";
+// src/generators/days_of_week.ts
+function generateDaysOfWeek(rule, tz, windowStart, windowEnd, disambiguation = "compatible") {
+	if (rule.weekInterval <= 0) throw new Error(`DaysOfWeekRule.weekInterval must be > 0 (got ${rule.weekInterval})`);
+	if (rule.days.length === 0) throw new Error("DaysOfWeekRule.days must be non-empty");
+	if (rule.count != null && rule.count < 0) throw new Error(`DaysOfWeekRule.count must be >= 0 (got ${rule.count})`);
+	const seriesEnd = rule.seriesEnd ?? Number.POSITIVE_INFINITY;
+	const effectiveEnd = Math.min(windowEnd, seriesEnd);
+	if (rule.seriesStart >= effectiveEnd) return [];
+	const days = [...rule.days].sort((a, b) => a - b);
+	const seriesStartParts = utcToWallParts(rule.seriesStart, tz);
+	const daysSinceSunday = seriesStartParts.dayOfWeek;
+	const weekAnchor = wallTimeToUtc(seriesStartParts.year, seriesStartParts.month, seriesStartParts.day - daysSinceSunday, 0, tz);
+	const out = [];
+	let count = 0;
+	let weekStart = weekAnchor;
+	while (weekStart < effectiveEnd) {
+		for (const dow of days) {
+			const dayUtc = addDaysInTz(weekStart, dow, tz);
+			const dayParts = utcToWallParts(dayUtc, tz);
+			if (disambiguation === "skip" && isNonexistentWallTime(dayParts.year, dayParts.month, dayParts.day, rule.timeOfDay, tz)) continue;
+			const occStart = wallTimeToUtc(dayParts.year, dayParts.month, dayParts.day, rule.timeOfDay, tz, disambiguation);
+			const occEnd = computeSpanEnd(occStart, rule.timeSpan, tz);
+			if (occStart < rule.seriesStart) continue;
+			if (occStart >= seriesEnd) continue;
+			if (rule.count != null && count >= rule.count) return out;
+			count++;
+			if (intersects(occStart, occEnd, windowStart, windowEnd)) {
+				out.push({
+					startTimestamp: occStart,
+					endTimestamp: occEnd
+				});
+				if (out.length > 1e4) throw new TooManyOccurrencesError("daysOfWeek");
+			}
+		}
+		weekStart = addDaysInTz(weekStart, 7 * rule.weekInterval, tz);
+	}
+	return out;
+}
+export { generateDaysOfWeek };
+
+//# sourceMappingURL=days_of_week.js.map

package/dist/generators/days_of_week.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"days_of_week.js","names":[],"sources":["../../src/generators/days_of_week.ts"],"sourcesContent":["import type { DaysOfWeekRule, Disambiguation } from \"../types.js\";\nimport {\n  addDaysInTz,\n  computeSpanEnd,\n  dayOfWeekInTz,\n  isNonexistentWallTime,\n  utcToWallParts,\n  wallTimeToUtc,\n} from \"../tz.js\";\nimport {\n  MAX_OCCURRENCES_PER_GENERATE,\n  type Occurrence,\n  TooManyOccurrencesError,\n  intersects,\n} from \"./types.js\";\n\n// Iterate week-by-week (in wall time, in tz) starting from seriesStart's\n// week. For each scheduled week, emit the occurrences that fall on the\n// rule's days.\nexport function generateDaysOfWeek(\n  rule: DaysOfWeekRule,\n  tz: string | undefined,\n  windowStart: number,\n  windowEnd: number,\n  disambiguation: Disambiguation = \"compatible\"\n): Occurrence[] {\n  if (rule.weekInterval <= 0) {\n    throw new Error(`DaysOfWeekRule.weekInterval must be > 0 (got ${rule.weekInterval})`);\n  }\n  if (rule.days.length === 0) {\n    throw new Error(\"DaysOfWeekRule.days must be non-empty\");\n  }\n  if (rule.count != null && rule.count < 0) {\n    throw new Error(`DaysOfWeekRule.count must be >= 0 (got ${rule.count})`);\n  }\n\n  const seriesEnd = rule.seriesEnd ?? Number.POSITIVE_INFINITY;\n  const effectiveEnd = Math.min(windowEnd, seriesEnd);\n  if (rule.seriesStart >= effectiveEnd) return [];\n\n  // Sort days for deterministic emit order within a week.\n  const days = [...rule.days].sort((a, b) => a - b);\n\n  // Anchor: snap seriesStart to the start of its week (Sunday) in tz.\n  const seriesStartParts = utcToWallParts(rule.seriesStart, tz);\n  const daysSinceSunday = seriesStartParts.dayOfWeek;\n  const weekAnchor = wallTimeToUtc(\n    seriesStartParts.year,\n    seriesStartParts.month,\n    seriesStartParts.day - daysSinceSunday,\n    0,\n    tz\n  );\n\n  const out: Occurrence[] = [];\n  let count = 0;\n  // Step by `weekInterval` weeks at a time. Use addDaysInTz to handle DST\n  // correctly (a week is 7 calendar days, not 7*86400000 ms).\n  let weekStart = weekAnchor;\n  while (weekStart < effectiveEnd) {\n    for (const dow of days) {\n      // Compute the day-of-week within this week in tz wall time.\n      const dayUtc = addDaysInTz(weekStart, dow, tz);\n      const dayParts = utcToWallParts(dayUtc, tz);\n      if (\n        disambiguation === \"skip\" &&\n        isNonexistentWallTime(dayParts.year, dayParts.month, dayParts.day, rule.timeOfDay, tz)\n      ) {\n        continue;\n      }\n      const occStart = wallTimeToUtc(\n        dayParts.year,\n        dayParts.month,\n        dayParts.day,\n        rule.timeOfDay,\n        tz,\n        disambiguation\n      );\n      const occEnd = computeSpanEnd(occStart, rule.timeSpan, tz);\n\n      // Must be on/after seriesStart and before seriesEnd.\n      if (occStart < rule.seriesStart) continue;\n      if (occStart >= seriesEnd) continue;\n\n      if (rule.count != null && count >= rule.count) return out;\n      count++;\n\n      if (intersects(occStart, occEnd, windowStart, windowEnd)) {\n        out.push({ startTimestamp: occStart, endTimestamp: occEnd });\n        if (out.length > MAX_OCCURRENCES_PER_GENERATE) {\n          throw new TooManyOccurrencesError(\"daysOfWeek\");\n        }\n      }\n    }\n    weekStart = addDaysInTz(weekStart, 7 * rule.weekInterval, tz);\n  }\n  return out;\n}\n\n// Re-export so consumers can sanity-check the rule's first day in tz.\nexport { dayOfWeekInTz };\n"],"mappings":";;;AAmBA,SAAgB,mBACd,MACA,IACA,aACA,WACA,iBAAiC,cACnB;CACd,IAAI,KAAK,gBAAgB,GACvB,MAAM,IAAI,MAAM,gDAAgD,KAAK,aAAa,EAAE;CAEtF,IAAI,KAAK,KAAK,WAAW,GACvB,MAAM,IAAI,MAAM,uCAAuC;CAEzD,IAAI,KAAK,SAAS,QAAQ,KAAK,QAAQ,GACrC,MAAM,IAAI,MAAM,0CAA0C,KAAK,MAAM,EAAE;CAGzE,MAAM,YAAY,KAAK,aAAa,OAAO;CAC3C,MAAM,eAAe,KAAK,IAAI,WAAW,SAAS;CAClD,IAAI,KAAK,eAAe,cAAc,OAAO,CAAC;CAG9C,MAAM,OAAO,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC;CAGhD,MAAM,mBAAmB,eAAe,KAAK,aAAa,EAAE;CAC5D,MAAM,kBAAkB,iBAAiB;CACzC,MAAM,aAAa,cACjB,iBAAiB,MACjB,iBAAiB,OACjB,iBAAiB,MAAM,iBACvB,GACA,EACF;CAEA,MAAM,MAAoB,CAAC;CAC3B,IAAI,QAAQ;CAGZ,IAAI,YAAY;CAChB,OAAO,YAAY,cAAc;EAC/B,KAAK,MAAM,OAAO,MAAM;GAEtB,MAAM,SAAS,YAAY,WAAW,KAAK,EAAE;GAC7C,MAAM,WAAW,eAAe,QAAQ,EAAE;GAC1C,IACE,mBAAmB,UACnB,sBAAsB,SAAS,MAAM,SAAS,OAAO,SAAS,KAAK,KAAK,WAAW,EAAE,GAErF;GAEF,MAAM,WAAW,cACf,SAAS,MACT,SAAS,OACT,SAAS,KACT,KAAK,WACL,IACA,cACF;GACA,MAAM,SAAS,eAAe,UAAU,KAAK,UAAU,EAAE;GAGzD,IAAI,WAAW,KAAK,aAAa;GACjC,IAAI,YAAY,WAAW;GAE3B,IAAI,KAAK,SAAS,QAAQ,SAAS,KAAK,OAAO,OAAO;GACtD;GAEA,IAAI,WAAW,UAAU,QAAQ,aAAa,SAAS,GAAG;IACxD,IAAI,KAAK;KAAE,gBAAgB;KAAU,cAAc;IAAO,CAAC;IAC3D,IAAI,IAAI,SAAA,KACN,MAAM,IAAI,wBAAwB,YAAY;GAElD;EACF;EACA,YAAY,YAAY,WAAW,IAAI,KAAK,cAAc,EAAE;CAC9D;CACA,OAAO;AACT"}

package/dist/generators/days_of_year.d.ts

@@ -0,0 +1,4 @@
+import { DaysOfYearRule, Disambiguation } from '../types.js';
+import { Occurrence } from './types.js';
+export declare function generateDaysOfYear(rule: DaysOfYearRule, tz: string | undefined, windowStart: number, windowEnd: number, disambiguation?: Disambiguation): Occurrence[];
+//# sourceMappingURL=days_of_year.d.ts.map

package/dist/generators/days_of_year.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"days_of_year.d.ts","sourceRoot":"","sources":["../../src/generators/days_of_year.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElE,OAAO,EAEL,KAAK,UAAU,EAGhB,MAAM,YAAY,CAAC;AAKpB,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,cAAc,EACpB,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,cAAc,GAAE,cAA6B,GAC5C,UAAU,EAAE,CAqEd"}

package/dist/generators/days_of_year.js

@@ -0,0 +1,50 @@
+import { computeSpanEnd, isNonexistentWallTime, utcToWallParts, wallTimeToUtc } from "../tz.js";
+import { TooManyOccurrencesError, intersects } from "./types.js";
+// src/generators/days_of_year.ts
+function generateDaysOfYear(rule, tz, windowStart, windowEnd, disambiguation = "compatible") {
+	if (rule.yearInterval <= 0) throw new Error(`DaysOfYearRule.yearInterval must be > 0 (got ${rule.yearInterval})`);
+	if (rule.daysOfYear.length === 0) throw new Error("DaysOfYearRule.daysOfYear must be non-empty");
+	for (const d of rule.daysOfYear) if (d < 1 || d > 366) throw new Error(`DaysOfYearRule.daysOfYear entries must be in 1..366 (got ${d})`);
+	if (rule.count != null && rule.count < 0) throw new Error(`DaysOfYearRule.count must be >= 0 (got ${rule.count})`);
+	const seriesEnd = rule.seriesEnd ?? Number.POSITIVE_INFINITY;
+	const effectiveEnd = Math.min(windowEnd, seriesEnd);
+	if (rule.seriesStart >= effectiveEnd) return [];
+	const days = [...new Set(rule.daysOfYear)].sort((a, b) => a - b);
+	const startYear = utcToWallParts(rule.seriesStart, tz).year;
+	const endYear = utcToWallParts(Math.min(effectiveEnd, Number.MAX_SAFE_INTEGER), tz).year;
+	const out = [];
+	let count = 0;
+	for (let year = startYear; year <= endYear; year += rule.yearInterval) {
+		const yearEmits = [];
+		for (const dayOfYear of days) {
+			const probe = new Date(Date.UTC(year, 0, dayOfYear));
+			if (probe.getUTCFullYear() !== year) continue;
+			const month = probe.getUTCMonth();
+			const day = probe.getUTCDate();
+			if (disambiguation === "skip" && isNonexistentWallTime(year, month, day, rule.timeOfDay, tz)) continue;
+			const occStart = wallTimeToUtc(year, month, day, rule.timeOfDay, tz, disambiguation);
+			const occEnd = computeSpanEnd(occStart, rule.timeSpan, tz);
+			if (occStart < rule.seriesStart) continue;
+			if (occStart >= seriesEnd) continue;
+			if (rule.count != null && count >= rule.count) {
+				yearEmits.sort((a, b) => a.startTimestamp - b.startTimestamp);
+				out.push(...yearEmits);
+				return out;
+			}
+			count++;
+			if (intersects(occStart, occEnd, windowStart, windowEnd)) {
+				yearEmits.push({
+					startTimestamp: occStart,
+					endTimestamp: occEnd
+				});
+				if (out.length + yearEmits.length > 1e4) throw new TooManyOccurrencesError("daysOfYear");
+			}
+		}
+		yearEmits.sort((a, b) => a.startTimestamp - b.startTimestamp);
+		out.push(...yearEmits);
+	}
+	return out;
+}
+export { generateDaysOfYear };
+
+//# sourceMappingURL=days_of_year.js.map

package/dist/generators/days_of_year.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"days_of_year.js","names":[],"sources":["../../src/generators/days_of_year.ts"],"sourcesContent":["import type { DaysOfYearRule, Disambiguation } from \"../types.js\";\nimport { computeSpanEnd, isNonexistentWallTime, utcToWallParts, wallTimeToUtc } from \"../tz.js\";\nimport {\n  MAX_OCCURRENCES_PER_GENERATE,\n  type Occurrence,\n  TooManyOccurrencesError,\n  intersects,\n} from \"./types.js\";\n\n// Day-of-year recurrence. Day 1 = Jan 1. Day 366 only exists in leap\n// years and is SKIPPED in non-leap years (no clamp — \"366th day\" means\n// literally that).\nexport function generateDaysOfYear(\n  rule: DaysOfYearRule,\n  tz: string | undefined,\n  windowStart: number,\n  windowEnd: number,\n  disambiguation: Disambiguation = \"compatible\"\n): Occurrence[] {\n  if (rule.yearInterval <= 0) {\n    throw new Error(`DaysOfYearRule.yearInterval must be > 0 (got ${rule.yearInterval})`);\n  }\n  if (rule.daysOfYear.length === 0) {\n    throw new Error(\"DaysOfYearRule.daysOfYear must be non-empty\");\n  }\n  for (const d of rule.daysOfYear) {\n    if (d < 1 || d > 366) {\n      throw new Error(`DaysOfYearRule.daysOfYear entries must be in 1..366 (got ${d})`);\n    }\n  }\n  if (rule.count != null && rule.count < 0) {\n    throw new Error(`DaysOfYearRule.count must be >= 0 (got ${rule.count})`);\n  }\n\n  const seriesEnd = rule.seriesEnd ?? Number.POSITIVE_INFINITY;\n  const effectiveEnd = Math.min(windowEnd, seriesEnd);\n  if (rule.seriesStart >= effectiveEnd) return [];\n\n  const days = [...new Set(rule.daysOfYear)].sort((a, b) => a - b);\n\n  const startYear = utcToWallParts(rule.seriesStart, tz).year;\n  const endYear = utcToWallParts(Math.min(effectiveEnd, Number.MAX_SAFE_INTEGER), tz).year;\n\n  const out: Occurrence[] = [];\n  let count = 0;\n\n  for (let year = startYear; year <= endYear; year += rule.yearInterval) {\n    const yearEmits: Occurrence[] = [];\n\n    for (const dayOfYear of days) {\n      // Date.UTC(year, 0, N) treats N as \"Nth day from Jan 1\". If N is 366\n      // in a non-leap year it rolls into year+1; detect and skip.\n      const probe = new Date(Date.UTC(year, 0, dayOfYear));\n      if (probe.getUTCFullYear() !== year) continue; // day 366 in non-leap year\n\n      const month = probe.getUTCMonth();\n      const day = probe.getUTCDate();\n      if (\n        disambiguation === \"skip\" &&\n        isNonexistentWallTime(year, month, day, rule.timeOfDay, tz)\n      ) {\n        continue;\n      }\n      const occStart = wallTimeToUtc(year, month, day, rule.timeOfDay, tz, disambiguation);\n      const occEnd = computeSpanEnd(occStart, rule.timeSpan, tz);\n\n      if (occStart < rule.seriesStart) continue;\n      if (occStart >= seriesEnd) continue;\n\n      if (rule.count != null && count >= rule.count) {\n        yearEmits.sort((a, b) => a.startTimestamp - b.startTimestamp);\n        out.push(...yearEmits);\n        return out;\n      }\n      count++;\n\n      if (intersects(occStart, occEnd, windowStart, windowEnd)) {\n        yearEmits.push({ startTimestamp: occStart, endTimestamp: occEnd });\n        if (out.length + yearEmits.length > MAX_OCCURRENCES_PER_GENERATE) {\n          throw new TooManyOccurrencesError(\"daysOfYear\");\n        }\n      }\n    }\n    yearEmits.sort((a, b) => a.startTimestamp - b.startTimestamp);\n    out.push(...yearEmits);\n  }\n  return out;\n}\n"],"mappings":";;;AAYA,SAAgB,mBACd,MACA,IACA,aACA,WACA,iBAAiC,cACnB;CACd,IAAI,KAAK,gBAAgB,GACvB,MAAM,IAAI,MAAM,gDAAgD,KAAK,aAAa,EAAE;CAEtF,IAAI,KAAK,WAAW,WAAW,GAC7B,MAAM,IAAI,MAAM,6CAA6C;CAE/D,KAAK,MAAM,KAAK,KAAK,YACnB,IAAI,IAAI,KAAK,IAAI,KACf,MAAM,IAAI,MAAM,4DAA4D,EAAE,EAAE;CAGpF,IAAI,KAAK,SAAS,QAAQ,KAAK,QAAQ,GACrC,MAAM,IAAI,MAAM,0CAA0C,KAAK,MAAM,EAAE;CAGzE,MAAM,YAAY,KAAK,aAAa,OAAO;CAC3C,MAAM,eAAe,KAAK,IAAI,WAAW,SAAS;CAClD,IAAI,KAAK,eAAe,cAAc,OAAO,CAAC;CAE9C,MAAM,OAAO,CAAC,GAAG,IAAI,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC;CAE/D,MAAM,YAAY,eAAe,KAAK,aAAa,EAAE,CAAC,CAAC;CACvD,MAAM,UAAU,eAAe,KAAK,IAAI,cAAc,OAAO,gBAAgB,GAAG,EAAE,CAAC,CAAC;CAEpF,MAAM,MAAoB,CAAC;CAC3B,IAAI,QAAQ;CAEZ,KAAK,IAAI,OAAO,WAAW,QAAQ,SAAS,QAAQ,KAAK,cAAc;EACrE,MAAM,YAA0B,CAAC;EAEjC,KAAK,MAAM,aAAa,MAAM;GAG5B,MAAM,QAAQ,IAAI,KAAK,KAAK,IAAI,MAAM,GAAG,SAAS,CAAC;GACnD,IAAI,MAAM,eAAe,MAAM,MAAM;GAErC,MAAM,QAAQ,MAAM,YAAY;GAChC,MAAM,MAAM,MAAM,WAAW;GAC7B,IACE,mBAAmB,UACnB,sBAAsB,MAAM,OAAO,KAAK,KAAK,WAAW,EAAE,GAE1D;GAEF,MAAM,WAAW,cAAc,MAAM,OAAO,KAAK,KAAK,WAAW,IAAI,cAAc;GACnF,MAAM,SAAS,eAAe,UAAU,KAAK,UAAU,EAAE;GAEzD,IAAI,WAAW,KAAK,aAAa;GACjC,IAAI,YAAY,WAAW;GAE3B,IAAI,KAAK,SAAS,QAAQ,SAAS,KAAK,OAAO;IAC7C,UAAU,MAAM,GAAG,MAAM,EAAE,iBAAiB,EAAE,cAAc;IAC5D,IAAI,KAAK,GAAG,SAAS;IACrB,OAAO;GACT;GACA;GAEA,IAAI,WAAW,UAAU,QAAQ,aAAa,SAAS,GAAG;IACxD,UAAU,KAAK;KAAE,gBAAgB;KAAU,cAAc;IAAO,CAAC;IACjE,IAAI,IAAI,SAAS,UAAU,SAAA,KACzB,MAAM,IAAI,wBAAwB,YAAY;GAElD;EACF;EACA,UAAU,MAAM,GAAG,MAAM,EAAE,iBAAiB,EAAE,cAAc;EAC5D,IAAI,KAAK,GAAG,SAAS;CACvB;CACA,OAAO;AACT"}

package/dist/generators/instant.d.ts

@@ -0,0 +1,4 @@
+import { InstantRule } from '../types.js';
+import { Occurrence } from './types.js';
+export declare function generateInstant(rule: InstantRule, tz: string | undefined, windowStart: number, windowEnd: number): Occurrence[];
+//# sourceMappingURL=instant.d.ts.map

package/dist/generators/instant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instant.d.ts","sourceRoot":"","sources":["../../src/generators/instant.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,KAAK,UAAU,EAAc,MAAM,YAAY,CAAC;AAKzD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,UAAU,EAAE,CAKd"}

package/dist/generators/instant.js

@@ -0,0 +1,15 @@
+import { computeSpanEnd } from "../tz.js";
+import { intersects } from "./types.js";
+// src/generators/instant.ts
+function generateInstant(rule, tz, windowStart, windowEnd) {
+	const start = rule.startOn;
+	const end = computeSpanEnd(start, rule.timeSpan, tz);
+	if (!intersects(start, end, windowStart, windowEnd)) return [];
+	return [{
+		startTimestamp: start,
+		endTimestamp: end
+	}];
+}
+export { generateInstant };
+
+//# sourceMappingURL=instant.js.map

package/dist/generators/instant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instant.js","names":[],"sources":["../../src/generators/instant.ts"],"sourcesContent":["import type { InstantRule } from \"../types.js\";\nimport { computeSpanEnd } from \"../tz.js\";\nimport { type Occurrence, intersects } from \"./types.js\";\n\n// A single occurrence at an absolute UTC instant. The template timezone does\n// not affect the start (the instant is already a fixed point on the timeline);\n// it only flexes an hourSpan end, via computeSpanEnd.\nexport function generateInstant(\n  rule: InstantRule,\n  tz: string | undefined,\n  windowStart: number,\n  windowEnd: number\n): Occurrence[] {\n  const start = rule.startOn;\n  const end = computeSpanEnd(start, rule.timeSpan, tz);\n  if (!intersects(start, end, windowStart, windowEnd)) return [];\n  return [{ startTimestamp: start, endTimestamp: end }];\n}\n"],"mappings":";;;AAOA,SAAgB,gBACd,MACA,IACA,aACA,WACc;CACd,MAAM,QAAQ,KAAK;CACnB,MAAM,MAAM,eAAe,OAAO,KAAK,UAAU,EAAE;CACnD,IAAI,CAAC,WAAW,OAAO,KAAK,aAAa,SAAS,GAAG,OAAO,CAAC;CAC7D,OAAO,CAAC;EAAE,gBAAgB;EAAO,cAAc;CAAI,CAAC;AACtD"}

package/dist/generators/local_date_time.d.ts

@@ -0,0 +1,4 @@
+import { Disambiguation, LocalDateTimeRule } from '../types.js';
+import { Occurrence } from './types.js';
+export declare function generateLocalDateTime(rule: LocalDateTimeRule, tz: string | undefined, windowStart: number, windowEnd: number, disambiguation?: Disambiguation): Occurrence[];
+//# sourceMappingURL=local_date_time.d.ts.map

package/dist/generators/local_date_time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local_date_time.d.ts","sourceRoot":"","sources":["../../src/generators/local_date_time.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErE,OAAO,EAAE,KAAK,UAAU,EAAc,MAAM,YAAY,CAAC;AAOzD,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,iBAAiB,EACvB,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,cAAc,GAAE,cAA6B,GAC5C,UAAU,EAAE,CAsBd"}

package/dist/generators/local_date_time.js

@@ -0,0 +1,20 @@
+import { computeSpanEnd, isNonexistentWallTime, monthLength, wallTimeToUtc } from "../tz.js";
+import { intersects } from "./types.js";
+// src/generators/local_date_time.ts
+function generateLocalDateTime(rule, tz, windowStart, windowEnd, disambiguation = "compatible") {
+	if (!Number.isInteger(rule.year)) throw new Error(`LocalDateTimeRule.year must be an integer (got ${rule.year})`);
+	if (rule.month < 0 || rule.month > 11) throw new Error(`LocalDateTimeRule.month must be in 0..11 (got ${rule.month})`);
+	if (rule.day < 1 || rule.day > 31) throw new Error(`LocalDateTimeRule.day must be in 1..31 (got ${rule.day})`);
+	const day = Math.min(rule.day, monthLength(rule.year, rule.month));
+	if (disambiguation === "skip" && isNonexistentWallTime(rule.year, rule.month, day, rule.timeOfDay, tz)) return [];
+	const start = wallTimeToUtc(rule.year, rule.month, day, rule.timeOfDay, tz, disambiguation);
+	const end = computeSpanEnd(start, rule.timeSpan, tz);
+	if (!intersects(start, end, windowStart, windowEnd)) return [];
+	return [{
+		startTimestamp: start,
+		endTimestamp: end
+	}];
+}
+export { generateLocalDateTime };
+
+//# sourceMappingURL=local_date_time.js.map

package/dist/generators/local_date_time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local_date_time.js","names":[],"sources":["../../src/generators/local_date_time.ts"],"sourcesContent":["import type { Disambiguation, LocalDateTimeRule } from \"../types.js\";\nimport { computeSpanEnd, isNonexistentWallTime, monthLength, wallTimeToUtc } from \"../tz.js\";\nimport { type Occurrence, intersects } from \"./types.js\";\n\n// A single occurrence expressed in wall-clock terms, resolved through the\n// template timezone (DST-aware). `day` clamps to the month length. When tz is\n// undefined the wall-clock fields are interpreted as UTC. A spring-forward gap\n// or fall-back overlap on the start is resolved per `disambiguation` (see\n// tz.ts) — \"skip\" drops the occurrence entirely if its wall time doesn't exist.\nexport function generateLocalDateTime(\n  rule: LocalDateTimeRule,\n  tz: string | undefined,\n  windowStart: number,\n  windowEnd: number,\n  disambiguation: Disambiguation = \"compatible\"\n): Occurrence[] {\n  if (!Number.isInteger(rule.year)) {\n    throw new Error(`LocalDateTimeRule.year must be an integer (got ${rule.year})`);\n  }\n  if (rule.month < 0 || rule.month > 11) {\n    throw new Error(`LocalDateTimeRule.month must be in 0..11 (got ${rule.month})`);\n  }\n  if (rule.day < 1 || rule.day > 31) {\n    throw new Error(`LocalDateTimeRule.day must be in 1..31 (got ${rule.day})`);\n  }\n\n  const day = Math.min(rule.day, monthLength(rule.year, rule.month));\n  if (\n    disambiguation === \"skip\" &&\n    isNonexistentWallTime(rule.year, rule.month, day, rule.timeOfDay, tz)\n  ) {\n    return [];\n  }\n  const start = wallTimeToUtc(rule.year, rule.month, day, rule.timeOfDay, tz, disambiguation);\n  const end = computeSpanEnd(start, rule.timeSpan, tz);\n  if (!intersects(start, end, windowStart, windowEnd)) return [];\n  return [{ startTimestamp: start, endTimestamp: end }];\n}\n"],"mappings":";;;AASA,SAAgB,sBACd,MACA,IACA,aACA,WACA,iBAAiC,cACnB;CACd,IAAI,CAAC,OAAO,UAAU,KAAK,IAAI,GAC7B,MAAM,IAAI,MAAM,kDAAkD,KAAK,KAAK,EAAE;CAEhF,IAAI,KAAK,QAAQ,KAAK,KAAK,QAAQ,IACjC,MAAM,IAAI,MAAM,iDAAiD,KAAK,MAAM,EAAE;CAEhF,IAAI,KAAK,MAAM,KAAK,KAAK,MAAM,IAC7B,MAAM,IAAI,MAAM,+CAA+C,KAAK,IAAI,EAAE;CAG5E,MAAM,MAAM,KAAK,IAAI,KAAK,KAAK,YAAY,KAAK,MAAM,KAAK,KAAK,CAAC;CACjE,IACE,mBAAmB,UACnB,sBAAsB,KAAK,MAAM,KAAK,OAAO,KAAK,KAAK,WAAW,EAAE,GAEpE,OAAO,CAAC;CAEV,MAAM,QAAQ,cAAc,KAAK,MAAM,KAAK,OAAO,KAAK,KAAK,WAAW,IAAI,cAAc;CAC1F,MAAM,MAAM,eAAe,OAAO,KAAK,UAAU,EAAE;CACnD,IAAI,CAAC,WAAW,OAAO,KAAK,aAAa,SAAS,GAAG,OAAO,CAAC;CAC7D,OAAO,CAAC;EAAE,gBAAgB;EAAO,cAAc;CAAI,CAAC;AACtD"}

package/dist/generators/months_of_year.d.ts

@@ -0,0 +1,4 @@
+import { Disambiguation, MonthsOfYearRule } from '../types.js';
+import { Occurrence } from './types.js';
+export declare function generateMonthsOfYear(rule: MonthsOfYearRule, tz: string | undefined, windowStart: number, windowEnd: number, disambiguation?: Disambiguation): Occurrence[];
+//# sourceMappingURL=months_of_year.d.ts.map

package/dist/generators/months_of_year.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"months_of_year.d.ts","sourceRoot":"","sources":["../../src/generators/months_of_year.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AASpE,OAAO,EAEL,KAAK,UAAU,EAGhB,MAAM,YAAY,CAAC;AASpB,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,gBAAgB,EACtB,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,cAAc,GAAE,cAA6B,GAC5C,UAAU,EAAE,CAgGd"}

package/dist/generators/months_of_year.js

@@ -0,0 +1,64 @@
+import { addMonthsInTz, computeSpanEnd, isNonexistentWallTime, monthLength, utcToWallParts, wallTimeToUtc } from "../tz.js";
+import { TooManyOccurrencesError, intersects } from "./types.js";
+// src/generators/months_of_year.ts
+function generateMonthsOfYear(rule, tz, windowStart, windowEnd, disambiguation = "compatible") {
+	if (rule.yearInterval <= 0) throw new Error(`MonthsOfYearRule.yearInterval must be > 0 (got ${rule.yearInterval})`);
+	if (rule.months.length === 0) throw new Error("MonthsOfYearRule.months must be non-empty");
+	for (const m of rule.months) if (m < 0 || m > 11) throw new Error(`MonthsOfYearRule.months entries must be in 0..11 (got ${m})`);
+	if (rule.weeks.length === 0) throw new Error("MonthsOfYearRule.weeks must be non-empty");
+	for (const w of rule.weeks) if (w === 0 || w < -5 || w > 5) throw new Error(`MonthsOfYearRule.weeks entries must be in [-5..-1] or [1..5] (got ${w})`);
+	if (rule.days.length === 0) throw new Error("MonthsOfYearRule.days must be non-empty");
+	if (rule.count != null && rule.count < 0) throw new Error(`MonthsOfYearRule.count must be >= 0 (got ${rule.count})`);
+	const seriesEnd = rule.seriesEnd ?? Number.POSITIVE_INFINITY;
+	const effectiveEnd = Math.min(windowEnd, seriesEnd);
+	if (rule.seriesStart >= effectiveEnd) return [];
+	const months = [...new Set(rule.months)].sort((a, b) => a - b);
+	const weeks = [...new Set(rule.weeks)];
+	const weekdays = [...new Set(rule.days)].sort((a, b) => a - b);
+	const seriesStartParts = utcToWallParts(rule.seriesStart, tz);
+	let yearAnchor = wallTimeToUtc(seriesStartParts.year, 0, 1, 0, tz);
+	const out = [];
+	let count = 0;
+	while (yearAnchor < effectiveEnd) {
+		const yp = utcToWallParts(yearAnchor, tz);
+		const yearEmits = [];
+		for (const month of months) for (const week of weeks) for (const dow of weekdays) {
+			const targetDay = _nthWeekdayOfMonth(yp.year, month, dow, week);
+			if (targetDay == null) continue;
+			if (disambiguation === "skip" && isNonexistentWallTime(yp.year, month, targetDay, rule.timeOfDay, tz)) continue;
+			const occStart = wallTimeToUtc(yp.year, month, targetDay, rule.timeOfDay, tz, disambiguation);
+			const occEnd = computeSpanEnd(occStart, rule.timeSpan, tz);
+			if (occStart < rule.seriesStart) continue;
+			if (occStart >= seriesEnd) continue;
+			if (rule.count != null && count >= rule.count) {
+				yearEmits.sort((a, b) => a.startTimestamp - b.startTimestamp);
+				out.push(...yearEmits);
+				return out;
+			}
+			count++;
+			if (intersects(occStart, occEnd, windowStart, windowEnd)) {
+				yearEmits.push({
+					startTimestamp: occStart,
+					endTimestamp: occEnd
+				});
+				if (out.length + yearEmits.length > 1e4) throw new TooManyOccurrencesError("monthsOfYear");
+			}
+		}
+		yearEmits.sort((a, b) => a.startTimestamp - b.startTimestamp);
+		out.push(...yearEmits);
+		yearAnchor = addMonthsInTz(yearAnchor, 12 * rule.yearInterval, tz);
+	}
+	return out;
+}
+function _nthWeekdayOfMonth(year, month, dow, n) {
+	const len = monthLength(year, month);
+	if (n > 0) {
+		const day = 1 + (dow - new Date(Date.UTC(year, month, 1)).getUTCDay() + 7) % 7 + (n - 1) * 7;
+		return day <= len ? day : null;
+	}
+	const day = len - (new Date(Date.UTC(year, month, len)).getUTCDay() - dow + 7) % 7 + (n + 1) * 7;
+	return day >= 1 ? day : null;
+}
+export { generateMonthsOfYear };
+
+//# sourceMappingURL=months_of_year.js.map

package/dist/generators/months_of_year.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"months_of_year.js","names":[],"sources":["../../src/generators/months_of_year.ts"],"sourcesContent":["import type { Disambiguation, MonthsOfYearRule } from \"../types.js\";\nimport {\n  addMonthsInTz,\n  computeSpanEnd,\n  isNonexistentWallTime,\n  monthLength,\n  utcToWallParts,\n  wallTimeToUtc,\n} from \"../tz.js\";\nimport {\n  MAX_OCCURRENCES_PER_GENERATE,\n  type Occurrence,\n  TooManyOccurrencesError,\n  intersects,\n} from \"./types.js\";\n\n// Positional yearly recurrence — top of the positional cascade.\n// (months × weeks-of-month × weekdays, with yearInterval as cadence.)\n//\n// For each year in cadence, walk the selected months; in each month, find\n// the Nth weekday matches (e.g. \"2nd Tuesday\") for each (week, day) pair.\n// If a position doesn't exist that month (e.g. 5th Sunday in a 4-Sunday\n// month), silently skip — same policy as WeeksOfMonthRule.\nexport function generateMonthsOfYear(\n  rule: MonthsOfYearRule,\n  tz: string | undefined,\n  windowStart: number,\n  windowEnd: number,\n  disambiguation: Disambiguation = \"compatible\"\n): Occurrence[] {\n  if (rule.yearInterval <= 0) {\n    throw new Error(`MonthsOfYearRule.yearInterval must be > 0 (got ${rule.yearInterval})`);\n  }\n  if (rule.months.length === 0) {\n    throw new Error(\"MonthsOfYearRule.months must be non-empty\");\n  }\n  for (const m of rule.months) {\n    if (m < 0 || m > 11) {\n      throw new Error(`MonthsOfYearRule.months entries must be in 0..11 (got ${m})`);\n    }\n  }\n  if (rule.weeks.length === 0) {\n    throw new Error(\"MonthsOfYearRule.weeks must be non-empty\");\n  }\n  for (const w of rule.weeks) {\n    if (w === 0 || w < -5 || w > 5) {\n      throw new Error(`MonthsOfYearRule.weeks entries must be in [-5..-1] or [1..5] (got ${w})`);\n    }\n  }\n  if (rule.days.length === 0) {\n    throw new Error(\"MonthsOfYearRule.days must be non-empty\");\n  }\n  if (rule.count != null && rule.count < 0) {\n    throw new Error(`MonthsOfYearRule.count must be >= 0 (got ${rule.count})`);\n  }\n\n  const seriesEnd = rule.seriesEnd ?? Number.POSITIVE_INFINITY;\n  const effectiveEnd = Math.min(windowEnd, seriesEnd);\n  if (rule.seriesStart >= effectiveEnd) return [];\n\n  const months = [...new Set(rule.months)].sort((a, b) => a - b);\n  const weeks = [...new Set(rule.weeks)];\n  const weekdays = [...new Set(rule.days)].sort((a, b) => a - b);\n\n  // Anchor at the start of seriesStart's year (in tz), but actually anchor\n  // at its first selected month within that year. We iterate year-by-year.\n  const seriesStartParts = utcToWallParts(rule.seriesStart, tz);\n  let yearAnchor = wallTimeToUtc(seriesStartParts.year, 0, 1, 0, tz);\n\n  const out: Occurrence[] = [];\n  let count = 0;\n\n  while (yearAnchor < effectiveEnd) {\n    const yp = utcToWallParts(yearAnchor, tz);\n    const yearEmits: Occurrence[] = [];\n\n    for (const month of months) {\n      for (const week of weeks) {\n        for (const dow of weekdays) {\n          const targetDay = _nthWeekdayOfMonth(yp.year, month, dow, week);\n          if (targetDay == null) continue; // Nth doesn't exist this month\n\n          if (\n            disambiguation === \"skip\" &&\n            isNonexistentWallTime(yp.year, month, targetDay, rule.timeOfDay, tz)\n          ) {\n            continue;\n          }\n          const occStart = wallTimeToUtc(\n            yp.year,\n            month,\n            targetDay,\n            rule.timeOfDay,\n            tz,\n            disambiguation\n          );\n          const occEnd = computeSpanEnd(occStart, rule.timeSpan, tz);\n\n          if (occStart < rule.seriesStart) continue;\n          if (occStart >= seriesEnd) continue;\n\n          if (rule.count != null && count >= rule.count) {\n            yearEmits.sort((a, b) => a.startTimestamp - b.startTimestamp);\n            out.push(...yearEmits);\n            return out;\n          }\n          count++;\n\n          if (intersects(occStart, occEnd, windowStart, windowEnd)) {\n            yearEmits.push({ startTimestamp: occStart, endTimestamp: occEnd });\n            if (out.length + yearEmits.length > MAX_OCCURRENCES_PER_GENERATE) {\n              throw new TooManyOccurrencesError(\"monthsOfYear\");\n            }\n          }\n        }\n      }\n    }\n    yearEmits.sort((a, b) => a.startTimestamp - b.startTimestamp);\n    out.push(...yearEmits);\n    // Step yearInterval years. Use addMonthsInTz(12) so leap-year wall-clock\n    // arithmetic is correct (it isn't strictly necessary at year granularity,\n    // but matches the rest of the codebase).\n    yearAnchor = addMonthsInTz(yearAnchor, 12 * rule.yearInterval, tz);\n  }\n  return out;\n}\n\n// Same helper as WeeksOfMonth uses. Returns day-of-month (1..31) for the\n// Nth occurrence of `dow` in the given month, or null if it doesn't exist.\nfunction _nthWeekdayOfMonth(year: number, month: number, dow: number, n: number): number | null {\n  const len = monthLength(year, month);\n\n  if (n > 0) {\n    const firstDow = new Date(Date.UTC(year, month, 1)).getUTCDay();\n    const offset = (dow - firstDow + 7) % 7;\n    const day = 1 + offset + (n - 1) * 7;\n    return day <= len ? day : null;\n  }\n  const lastDow = new Date(Date.UTC(year, month, len)).getUTCDay();\n  const offset = (lastDow - dow + 7) % 7;\n  const day = len - offset + (n + 1) * 7;\n  return day >= 1 ? day : null;\n}\n"],"mappings":";;;AAuBA,SAAgB,qBACd,MACA,IACA,aACA,WACA,iBAAiC,cACnB;CACd,IAAI,KAAK,gBAAgB,GACvB,MAAM,IAAI,MAAM,kDAAkD,KAAK,aAAa,EAAE;CAExF,IAAI,KAAK,OAAO,WAAW,GACzB,MAAM,IAAI,MAAM,2CAA2C;CAE7D,KAAK,MAAM,KAAK,KAAK,QACnB,IAAI,IAAI,KAAK,IAAI,IACf,MAAM,IAAI,MAAM,yDAAyD,EAAE,EAAE;CAGjF,IAAI,KAAK,MAAM,WAAW,GACxB,MAAM,IAAI,MAAM,0CAA0C;CAE5D,KAAK,MAAM,KAAK,KAAK,OACnB,IAAI,MAAM,KAAK,IAAI,MAAM,IAAI,GAC3B,MAAM,IAAI,MAAM,qEAAqE,EAAE,EAAE;CAG7F,IAAI,KAAK,KAAK,WAAW,GACvB,MAAM,IAAI,MAAM,yCAAyC;CAE3D,IAAI,KAAK,SAAS,QAAQ,KAAK,QAAQ,GACrC,MAAM,IAAI,MAAM,4CAA4C,KAAK,MAAM,EAAE;CAG3E,MAAM,YAAY,KAAK,aAAa,OAAO;CAC3C,MAAM,eAAe,KAAK,IAAI,WAAW,SAAS;CAClD,IAAI,KAAK,eAAe,cAAc,OAAO,CAAC;CAE9C,MAAM,SAAS,CAAC,GAAG,IAAI,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC;CAC7D,MAAM,QAAQ,CAAC,GAAG,IAAI,IAAI,KAAK,KAAK,CAAC;CACrC,MAAM,WAAW,CAAC,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC;CAI7D,MAAM,mBAAmB,eAAe,KAAK,aAAa,EAAE;CAC5D,IAAI,aAAa,cAAc,iBAAiB,MAAM,GAAG,GAAG,GAAG,EAAE;CAEjE,MAAM,MAAoB,CAAC;CAC3B,IAAI,QAAQ;CAEZ,OAAO,aAAa,cAAc;EAChC,MAAM,KAAK,eAAe,YAAY,EAAE;EACxC,MAAM,YAA0B,CAAC;EAEjC,KAAK,MAAM,SAAS,QAClB,KAAK,MAAM,QAAQ,OACjB,KAAK,MAAM,OAAO,UAAU;GAC1B,MAAM,YAAY,mBAAmB,GAAG,MAAM,OAAO,KAAK,IAAI;GAC9D,IAAI,aAAa,MAAM;GAEvB,IACE,mBAAmB,UACnB,sBAAsB,GAAG,MAAM,OAAO,WAAW,KAAK,WAAW,EAAE,GAEnE;GAEF,MAAM,WAAW,cACf,GAAG,MACH,OACA,WACA,KAAK,WACL,IACA,cACF;GACA,MAAM,SAAS,eAAe,UAAU,KAAK,UAAU,EAAE;GAEzD,IAAI,WAAW,KAAK,aAAa;GACjC,IAAI,YAAY,WAAW;GAE3B,IAAI,KAAK,SAAS,QAAQ,SAAS,KAAK,OAAO;IAC7C,UAAU,MAAM,GAAG,MAAM,EAAE,iBAAiB,EAAE,cAAc;IAC5D,IAAI,KAAK,GAAG,SAAS;IACrB,OAAO;GACT;GACA;GAEA,IAAI,WAAW,UAAU,QAAQ,aAAa,SAAS,GAAG;IACxD,UAAU,KAAK;KAAE,gBAAgB;KAAU,cAAc;IAAO,CAAC;IACjE,IAAI,IAAI,SAAS,UAAU,SAAA,KACzB,MAAM,IAAI,wBAAwB,cAAc;GAEpD;EACF;EAGJ,UAAU,MAAM,GAAG,MAAM,EAAE,iBAAiB,EAAE,cAAc;EAC5D,IAAI,KAAK,GAAG,SAAS;EAIrB,aAAa,cAAc,YAAY,KAAK,KAAK,cAAc,EAAE;CACnE;CACA,OAAO;AACT;AAIA,SAAS,mBAAmB,MAAc,OAAe,KAAa,GAA0B;CAC9F,MAAM,MAAM,YAAY,MAAM,KAAK;CAEnC,IAAI,IAAI,GAAG;EAGT,MAAM,MAAM,KADI,MADC,IAAI,KAAK,KAAK,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,UAC9B,IAAW,KAAK,KACZ,IAAI,KAAK;EACnC,OAAO,OAAO,MAAM,MAAM;CAC5B;CAGA,MAAM,MAAM,OAFI,IAAI,KAAK,KAAK,IAAI,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,UACrC,IAAU,MAAM,KAAK,KACT,IAAI,KAAK;CACrC,OAAO,OAAO,IAAI,MAAM;AAC1B"}

package/dist/generators/types.d.ts

@@ -0,0 +1,10 @@
+export interface Occurrence {
+    startTimestamp: number;
+    endTimestamp: number;
+}
+export declare const MAX_OCCURRENCES_PER_GENERATE = 10000;
+export declare class TooManyOccurrencesError extends Error {
+    constructor(kind: string);
+}
+export declare function intersects(startA: number, endA: number, startB: number, endB: number): boolean;
+//# sourceMappingURL=types.d.ts.map

package/dist/generators/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/generators/types.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAKD,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAEnD,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,IAAI,EAAE,MAAM;CAMzB;AAGD,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9F"}

package/dist/generators/types.js

@@ -0,0 +1,14 @@
+// src/generators/types.ts
+var MAX_OCCURRENCES_PER_GENERATE = 1e4;
+var TooManyOccurrencesError = class extends Error {
+	constructor(kind) {
+		super(`Generator '${kind}' would emit more than ${MAX_OCCURRENCES_PER_GENERATE} occurrences for the requested window. Narrow the window, increase the interval, or set 'count' on the rule.`);
+		this.name = "TooManyOccurrencesError";
+	}
+};
+function intersects(startA, endA, startB, endB) {
+	return Math.max(startA, startB) < Math.min(endA, endB);
+}
+export { MAX_OCCURRENCES_PER_GENERATE, TooManyOccurrencesError, intersects };
+
+//# sourceMappingURL=types.js.map

package/dist/generators/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../src/generators/types.ts"],"sourcesContent":["// Generators emit raw start/end pairs sorted ascending by startTimestamp.\n// Stable per-occurrence keys are assigned downstream (occurrence_key.ts) so\n// keys can be derived consistently across rule kinds.\nexport interface Occurrence {\n  startTimestamp: number;\n  endTimestamp: number;\n}\n\n// Hard ceiling per generate() call. A misconfigured rule (e.g. 1ms anchored\n// interval over a year-long window) would otherwise produce billions of\n// occurrences; we'd rather throw a clear error than blow heap.\nexport const MAX_OCCURRENCES_PER_GENERATE = 10_000;\n\nexport class TooManyOccurrencesError extends Error {\n  constructor(kind: string) {\n    super(\n      `Generator '${kind}' would emit more than ${MAX_OCCURRENCES_PER_GENERATE} occurrences for the requested window. Narrow the window, increase the interval, or set 'count' on the rule.`\n    );\n    this.name = \"TooManyOccurrencesError\";\n  }\n}\n\n// Half-open intersection: [startA, endA) overlaps [startB, endB)?\nexport function intersects(startA: number, endA: number, startB: number, endB: number): boolean {\n  return Math.max(startA, startB) < Math.min(endA, endB);\n}\n"],"mappings":";AAWA,IAAa,+BAA+B;AAE5C,IAAa,0BAAb,cAA6C,MAAM;CACjD,YAAY,MAAc;EACxB,MACE,cAAc,KAAK,yBAAyB,6BAA6B,6GAC3E;EACA,KAAK,OAAO;CACd;AACF;AAGA,SAAgB,WAAW,QAAgB,MAAc,QAAgB,MAAuB;CAC9F,OAAO,KAAK,IAAI,QAAQ,MAAM,IAAI,KAAK,IAAI,MAAM,IAAI;AACvD"}

package/dist/generators/weeks_of_month.d.ts

@@ -0,0 +1,4 @@
+import { Disambiguation, WeeksOfMonthRule } from '../types.js';
+import { Occurrence } from './types.js';
+export declare function generateWeeksOfMonth(rule: WeeksOfMonthRule, tz: string | undefined, windowStart: number, windowEnd: number, disambiguation?: Disambiguation): Occurrence[];
+//# sourceMappingURL=weeks_of_month.d.ts.map

package/dist/generators/weeks_of_month.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weeks_of_month.d.ts","sourceRoot":"","sources":["../../src/generators/weeks_of_month.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AASpE,OAAO,EAEL,KAAK,UAAU,EAGhB,MAAM,YAAY,CAAC;AAKpB,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,gBAAgB,EACtB,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,cAAc,GAAE,cAA6B,GAC5C,UAAU,EAAE,CAuFd"}

package/dist/generators/weeks_of_month.js

@@ -0,0 +1,61 @@
+import { addMonthsInTz, computeSpanEnd, isNonexistentWallTime, monthLength, utcToWallParts, wallTimeToUtc } from "../tz.js";
+import { TooManyOccurrencesError, intersects } from "./types.js";
+// src/generators/weeks_of_month.ts
+function generateWeeksOfMonth(rule, tz, windowStart, windowEnd, disambiguation = "compatible") {
+	if (rule.monthInterval <= 0) throw new Error(`WeeksOfMonthRule.monthInterval must be > 0 (got ${rule.monthInterval})`);
+	if (rule.weeks.length === 0) throw new Error("WeeksOfMonthRule.weeks must be non-empty");
+	for (const w of rule.weeks) if (w === 0 || w < -5 || w > 5) throw new Error(`WeeksOfMonthRule.weeks entries must be in [-5..-1] or [1..5] (got ${w})`);
+	if (rule.days.length === 0) throw new Error("WeeksOfMonthRule.days must be non-empty");
+	if (rule.count != null && rule.count < 0) throw new Error(`WeeksOfMonthRule.count must be >= 0 (got ${rule.count})`);
+	const seriesEnd = rule.seriesEnd ?? Number.POSITIVE_INFINITY;
+	const effectiveEnd = Math.min(windowEnd, seriesEnd);
+	if (rule.seriesStart >= effectiveEnd) return [];
+	const days = [...rule.days].sort((a, b) => a - b);
+	const weeks = [...new Set(rule.weeks)];
+	const seriesStartParts = utcToWallParts(rule.seriesStart, tz);
+	let monthAnchor = wallTimeToUtc(seriesStartParts.year, seriesStartParts.month, 1, 0, tz);
+	const out = [];
+	let count = 0;
+	while (monthAnchor < effectiveEnd) {
+		const mp = utcToWallParts(monthAnchor, tz);
+		const monthEmits = [];
+		for (const week of weeks) for (const dow of days) {
+			const targetDay = _nthWeekdayOfMonth(mp.year, mp.month, dow, week);
+			if (targetDay == null) continue;
+			if (disambiguation === "skip" && isNonexistentWallTime(mp.year, mp.month, targetDay, rule.timeOfDay, tz)) continue;
+			const occStart = wallTimeToUtc(mp.year, mp.month, targetDay, rule.timeOfDay, tz, disambiguation);
+			const occEnd = computeSpanEnd(occStart, rule.timeSpan, tz);
+			if (occStart < rule.seriesStart) continue;
+			if (occStart >= seriesEnd) continue;
+			if (rule.count != null && count >= rule.count) {
+				monthEmits.sort((a, b) => a.startTimestamp - b.startTimestamp);
+				out.push(...monthEmits);
+				return out;
+			}
+			count++;
+			if (intersects(occStart, occEnd, windowStart, windowEnd)) {
+				monthEmits.push({
+					startTimestamp: occStart,
+					endTimestamp: occEnd
+				});
+				if (out.length + monthEmits.length > 1e4) throw new TooManyOccurrencesError("weeksOfMonth");
+			}
+		}
+		monthEmits.sort((a, b) => a.startTimestamp - b.startTimestamp);
+		out.push(...monthEmits);
+		monthAnchor = addMonthsInTz(monthAnchor, rule.monthInterval, tz);
+	}
+	return out;
+}
+function _nthWeekdayOfMonth(year, month, dow, n) {
+	const len = monthLength(year, month);
+	if (n > 0) {
+		const day = 1 + (dow - new Date(Date.UTC(year, month, 1)).getUTCDay() + 7) % 7 + (n - 1) * 7;
+		return day <= len ? day : null;
+	}
+	const day = len - (new Date(Date.UTC(year, month, len)).getUTCDay() - dow + 7) % 7 + (n + 1) * 7;
+	return day >= 1 ? day : null;
+}
+export { generateWeeksOfMonth };
+
+//# sourceMappingURL=weeks_of_month.js.map

package/dist/generators/weeks_of_month.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weeks_of_month.js","names":[],"sources":["../../src/generators/weeks_of_month.ts"],"sourcesContent":["import type { Disambiguation, WeeksOfMonthRule } from \"../types.js\";\nimport {\n  addMonthsInTz,\n  computeSpanEnd,\n  isNonexistentWallTime,\n  monthLength,\n  utcToWallParts,\n  wallTimeToUtc,\n} from \"../tz.js\";\nimport {\n  MAX_OCCURRENCES_PER_GENERATE,\n  type Occurrence,\n  TooManyOccurrencesError,\n  intersects,\n} from \"./types.js\";\n\n// \"Nth Tuesday of every month\", \"last Friday of every other month\", etc.\n// Iterate month-by-month at monthInterval cadence; for each repeatable day,\n// resolve the target wall date.\nexport function generateWeeksOfMonth(\n  rule: WeeksOfMonthRule,\n  tz: string | undefined,\n  windowStart: number,\n  windowEnd: number,\n  disambiguation: Disambiguation = \"compatible\"\n): Occurrence[] {\n  if (rule.monthInterval <= 0) {\n    throw new Error(`WeeksOfMonthRule.monthInterval must be > 0 (got ${rule.monthInterval})`);\n  }\n  if (rule.weeks.length === 0) {\n    throw new Error(\"WeeksOfMonthRule.weeks must be non-empty\");\n  }\n  for (const w of rule.weeks) {\n    if (w === 0 || w < -5 || w > 5) {\n      throw new Error(`WeeksOfMonthRule.weeks entries must be in [-5..-1] or [1..5] (got ${w})`);\n    }\n  }\n  if (rule.days.length === 0) {\n    throw new Error(\"WeeksOfMonthRule.days must be non-empty\");\n  }\n  if (rule.count != null && rule.count < 0) {\n    throw new Error(`WeeksOfMonthRule.count must be >= 0 (got ${rule.count})`);\n  }\n\n  const seriesEnd = rule.seriesEnd ?? Number.POSITIVE_INFINITY;\n  const effectiveEnd = Math.min(windowEnd, seriesEnd);\n  if (rule.seriesStart >= effectiveEnd) return [];\n\n  const days = [...rule.days].sort((a, b) => a - b);\n  // Dedup `weeks` so a duplicated entry doesn't double-emit. Don't sort —\n  // we sort the per-month emits at the end of each month iteration anyway.\n  const weeks = [...new Set(rule.weeks)];\n\n  // Anchor at seriesStart's month (in tz).\n  const seriesStartParts = utcToWallParts(rule.seriesStart, tz);\n  let monthAnchor = wallTimeToUtc(seriesStartParts.year, seriesStartParts.month, 1, 0, tz);\n\n  const out: Occurrence[] = [];\n  let count = 0;\n\n  while (monthAnchor < effectiveEnd) {\n    const mp = utcToWallParts(monthAnchor, tz);\n    const monthEmits: Occurrence[] = [];\n\n    for (const week of weeks) {\n      for (const dow of days) {\n        const targetDay = _nthWeekdayOfMonth(mp.year, mp.month, dow, week);\n        if (targetDay == null) continue; // e.g. 5th Friday in a 4-Friday month\n\n        if (\n          disambiguation === \"skip\" &&\n          isNonexistentWallTime(mp.year, mp.month, targetDay, rule.timeOfDay, tz)\n        ) {\n          continue;\n        }\n        const occStart = wallTimeToUtc(\n          mp.year,\n          mp.month,\n          targetDay,\n          rule.timeOfDay,\n          tz,\n          disambiguation\n        );\n        const occEnd = computeSpanEnd(occStart, rule.timeSpan, tz);\n\n        if (occStart < rule.seriesStart) continue;\n        if (occStart >= seriesEnd) continue;\n\n        if (rule.count != null && count >= rule.count) {\n          // Sort and emit what we collected this month before returning.\n          monthEmits.sort((a, b) => a.startTimestamp - b.startTimestamp);\n          out.push(...monthEmits);\n          return out;\n        }\n        count++;\n\n        if (intersects(occStart, occEnd, windowStart, windowEnd)) {\n          monthEmits.push({ startTimestamp: occStart, endTimestamp: occEnd });\n          if (out.length + monthEmits.length > MAX_OCCURRENCES_PER_GENERATE) {\n            throw new TooManyOccurrencesError(\"weeksOfMonth\");\n          }\n        }\n      }\n    }\n    // Sort within-month emits before appending. With multiple weeks (and\n    // negative weeks mixed with positive), per-week iteration order doesn't\n    // produce ascending startTimestamps.\n    monthEmits.sort((a, b) => a.startTimestamp - b.startTimestamp);\n    out.push(...monthEmits);\n    monthAnchor = addMonthsInTz(monthAnchor, rule.monthInterval, tz);\n  }\n  return out;\n}\n\n// Returns the day-of-month (1..31) for the Nth weekday of the given month,\n// or null if it doesn't exist (e.g. asking for the 5th Tuesday of a 4-Tuesday\n// month). Negative N counts from the end: -1 = last, -2 = second-to-last.\nfunction _nthWeekdayOfMonth(year: number, month: number, dow: number, n: number): number | null {\n  const len = monthLength(year, month);\n\n  if (n > 0) {\n    // Find the first occurrence of `dow` in the month, then step by 7s.\n    const firstDow = new Date(Date.UTC(year, month, 1)).getUTCDay();\n    const offset = (dow - firstDow + 7) % 7;\n    const day = 1 + offset + (n - 1) * 7;\n    return day <= len ? day : null;\n  }\n  // n < 0: count from end of month.\n  const lastDow = new Date(Date.UTC(year, month, len)).getUTCDay();\n  const offset = (lastDow - dow + 7) % 7;\n  const day = len - offset + (n + 1) * 7;\n  return day >= 1 ? day : null;\n}\n"],"mappings":";;;AAmBA,SAAgB,qBACd,MACA,IACA,aACA,WACA,iBAAiC,cACnB;CACd,IAAI,KAAK,iBAAiB,GACxB,MAAM,IAAI,MAAM,mDAAmD,KAAK,cAAc,EAAE;CAE1F,IAAI,KAAK,MAAM,WAAW,GACxB,MAAM,IAAI,MAAM,0CAA0C;CAE5D,KAAK,MAAM,KAAK,KAAK,OACnB,IAAI,MAAM,KAAK,IAAI,MAAM,IAAI,GAC3B,MAAM,IAAI,MAAM,qEAAqE,EAAE,EAAE;CAG7F,IAAI,KAAK,KAAK,WAAW,GACvB,MAAM,IAAI,MAAM,yCAAyC;CAE3D,IAAI,KAAK,SAAS,QAAQ,KAAK,QAAQ,GACrC,MAAM,IAAI,MAAM,4CAA4C,KAAK,MAAM,EAAE;CAG3E,MAAM,YAAY,KAAK,aAAa,OAAO;CAC3C,MAAM,eAAe,KAAK,IAAI,WAAW,SAAS;CAClD,IAAI,KAAK,eAAe,cAAc,OAAO,CAAC;CAE9C,MAAM,OAAO,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC;CAGhD,MAAM,QAAQ,CAAC,GAAG,IAAI,IAAI,KAAK,KAAK,CAAC;CAGrC,MAAM,mBAAmB,eAAe,KAAK,aAAa,EAAE;CAC5D,IAAI,cAAc,cAAc,iBAAiB,MAAM,iBAAiB,OAAO,GAAG,GAAG,EAAE;CAEvF,MAAM,MAAoB,CAAC;CAC3B,IAAI,QAAQ;CAEZ,OAAO,cAAc,cAAc;EACjC,MAAM,KAAK,eAAe,aAAa,EAAE;EACzC,MAAM,aAA2B,CAAC;EAElC,KAAK,MAAM,QAAQ,OACjB,KAAK,MAAM,OAAO,MAAM;GACtB,MAAM,YAAY,mBAAmB,GAAG,MAAM,GAAG,OAAO,KAAK,IAAI;GACjE,IAAI,aAAa,MAAM;GAEvB,IACE,mBAAmB,UACnB,sBAAsB,GAAG,MAAM,GAAG,OAAO,WAAW,KAAK,WAAW,EAAE,GAEtE;GAEF,MAAM,WAAW,cACf,GAAG,MACH,GAAG,OACH,WACA,KAAK,WACL,IACA,cACF;GACA,MAAM,SAAS,eAAe,UAAU,KAAK,UAAU,EAAE;GAEzD,IAAI,WAAW,KAAK,aAAa;GACjC,IAAI,YAAY,WAAW;GAE3B,IAAI,KAAK,SAAS,QAAQ,SAAS,KAAK,OAAO;IAE7C,WAAW,MAAM,GAAG,MAAM,EAAE,iBAAiB,EAAE,cAAc;IAC7D,IAAI,KAAK,GAAG,UAAU;IACtB,OAAO;GACT;GACA;GAEA,IAAI,WAAW,UAAU,QAAQ,aAAa,SAAS,GAAG;IACxD,WAAW,KAAK;KAAE,gBAAgB;KAAU,cAAc;IAAO,CAAC;IAClE,IAAI,IAAI,SAAS,WAAW,SAAA,KAC1B,MAAM,IAAI,wBAAwB,cAAc;GAEpD;EACF;EAKF,WAAW,MAAM,GAAG,MAAM,EAAE,iBAAiB,EAAE,cAAc;EAC7D,IAAI,KAAK,GAAG,UAAU;EACtB,cAAc,cAAc,aAAa,KAAK,eAAe,EAAE;CACjE;CACA,OAAO;AACT;AAKA,SAAS,mBAAmB,MAAc,OAAe,KAAa,GAA0B;CAC9F,MAAM,MAAM,YAAY,MAAM,KAAK;CAEnC,IAAI,IAAI,GAAG;EAIT,MAAM,MAAM,KADI,MADC,IAAI,KAAK,KAAK,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,UAC9B,IAAW,KAAK,KACZ,IAAI,KAAK;EACnC,OAAO,OAAO,MAAM,MAAM;CAC5B;CAIA,MAAM,MAAM,OAFI,IAAI,KAAK,KAAK,IAAI,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,UACrC,IAAU,MAAM,KAAK,KACT,IAAI,KAAK;CACrC,OAAO,OAAO,IAAI,MAAM;AAC1B"}

package/dist/generators/yearly.d.ts

@@ -0,0 +1,4 @@
+import { Disambiguation, YearlyRule } from '../types.js';
+import { Occurrence } from './types.js';
+export declare function generateYearly(rule: YearlyRule, tz: string | undefined, windowStart: number, windowEnd: number, disambiguation?: Disambiguation): Occurrence[];
+//# sourceMappingURL=yearly.d.ts.map

package/dist/generators/yearly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yearly.d.ts","sourceRoot":"","sources":["../../src/generators/yearly.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAQ9D,OAAO,EAEL,KAAK,UAAU,EAGhB,MAAM,YAAY,CAAC;AAIpB,wBAAgB,cAAc,CAC5B,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,cAAc,GAAE,cAA6B,GAC5C,UAAU,EAAE,CAiDd"}

package/dist/generators/yearly.js

@@ -0,0 +1,37 @@
+import { computeSpanEnd, isNonexistentWallTime, monthLength, utcToWallParts, wallTimeToUtc } from "../tz.js";
+import { TooManyOccurrencesError, intersects } from "./types.js";
+// src/generators/yearly.ts
+function generateYearly(rule, tz, windowStart, windowEnd, disambiguation = "compatible") {
+	if (rule.yearInterval <= 0) throw new Error(`YearlyRule.yearInterval must be > 0 (got ${rule.yearInterval})`);
+	if (rule.month < 0 || rule.month > 11) throw new Error(`YearlyRule.month must be in 0..11 (got ${rule.month})`);
+	if (rule.day < 1 || rule.day > 31) throw new Error(`YearlyRule.day must be in 1..31 (got ${rule.day})`);
+	if (rule.count != null && rule.count < 0) throw new Error(`YearlyRule.count must be >= 0 (got ${rule.count})`);
+	const seriesEnd = rule.seriesEnd ?? Number.POSITIVE_INFINITY;
+	const effectiveEnd = Math.min(windowEnd, seriesEnd);
+	if (rule.seriesStart >= effectiveEnd) return [];
+	const startYear = utcToWallParts(rule.seriesStart, tz).year;
+	const endYear = utcToWallParts(Math.min(effectiveEnd, Number.MAX_SAFE_INTEGER), tz).year;
+	const out = [];
+	let count = 0;
+	for (let year = startYear; year <= endYear; year += rule.yearInterval) {
+		const day = Math.min(rule.day, monthLength(year, rule.month));
+		if (disambiguation === "skip" && isNonexistentWallTime(year, rule.month, day, rule.timeOfDay, tz)) continue;
+		const occStart = wallTimeToUtc(year, rule.month, day, rule.timeOfDay, tz, disambiguation);
+		const occEnd = computeSpanEnd(occStart, rule.timeSpan, tz);
+		if (occStart < rule.seriesStart) continue;
+		if (occStart >= seriesEnd) continue;
+		if (rule.count != null && count >= rule.count) break;
+		count++;
+		if (intersects(occStart, occEnd, windowStart, windowEnd)) {
+			out.push({
+				startTimestamp: occStart,
+				endTimestamp: occEnd
+			});
+			if (out.length > 1e4) throw new TooManyOccurrencesError("yearly");
+		}
+	}
+	return out;
+}
+export { generateYearly };
+
+//# sourceMappingURL=yearly.js.map

package/dist/generators/yearly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yearly.js","names":[],"sources":["../../src/generators/yearly.ts"],"sourcesContent":["import type { Disambiguation, YearlyRule } from \"../types.js\";\nimport {\n  computeSpanEnd,\n  isNonexistentWallTime,\n  monthLength,\n  utcToWallParts,\n  wallTimeToUtc,\n} from \"../tz.js\";\nimport {\n  MAX_OCCURRENCES_PER_GENERATE,\n  type Occurrence,\n  TooManyOccurrencesError,\n  intersects,\n} from \"./types.js\";\n\n// Simple yearly recurrence: a single month + day. Day clamps to month\n// length (Feb 29 → Feb 28 in non-leap years, Apr 31 → Apr 30, etc.).\nexport function generateYearly(\n  rule: YearlyRule,\n  tz: string | undefined,\n  windowStart: number,\n  windowEnd: number,\n  disambiguation: Disambiguation = \"compatible\"\n): Occurrence[] {\n  if (rule.yearInterval <= 0) {\n    throw new Error(`YearlyRule.yearInterval must be > 0 (got ${rule.yearInterval})`);\n  }\n  if (rule.month < 0 || rule.month > 11) {\n    throw new Error(`YearlyRule.month must be in 0..11 (got ${rule.month})`);\n  }\n  if (rule.day < 1 || rule.day > 31) {\n    throw new Error(`YearlyRule.day must be in 1..31 (got ${rule.day})`);\n  }\n  if (rule.count != null && rule.count < 0) {\n    throw new Error(`YearlyRule.count must be >= 0 (got ${rule.count})`);\n  }\n\n  const seriesEnd = rule.seriesEnd ?? Number.POSITIVE_INFINITY;\n  const effectiveEnd = Math.min(windowEnd, seriesEnd);\n  if (rule.seriesStart >= effectiveEnd) return [];\n\n  const startYear = utcToWallParts(rule.seriesStart, tz).year;\n  const endYear = utcToWallParts(Math.min(effectiveEnd, Number.MAX_SAFE_INTEGER), tz).year;\n\n  const out: Occurrence[] = [];\n  let count = 0;\n\n  for (let year = startYear; year <= endYear; year += rule.yearInterval) {\n    const day = Math.min(rule.day, monthLength(year, rule.month));\n    if (\n      disambiguation === \"skip\" &&\n      isNonexistentWallTime(year, rule.month, day, rule.timeOfDay, tz)\n    ) {\n      continue;\n    }\n    const occStart = wallTimeToUtc(year, rule.month, day, rule.timeOfDay, tz, disambiguation);\n    const occEnd = computeSpanEnd(occStart, rule.timeSpan, tz);\n\n    if (occStart < rule.seriesStart) continue;\n    if (occStart >= seriesEnd) continue;\n\n    if (rule.count != null && count >= rule.count) break;\n    count++;\n\n    if (intersects(occStart, occEnd, windowStart, windowEnd)) {\n      out.push({ startTimestamp: occStart, endTimestamp: occEnd });\n      if (out.length > MAX_OCCURRENCES_PER_GENERATE) {\n        throw new TooManyOccurrencesError(\"yearly\");\n      }\n    }\n  }\n  return out;\n}\n"],"mappings":";;;AAiBA,SAAgB,eACd,MACA,IACA,aACA,WACA,iBAAiC,cACnB;CACd,IAAI,KAAK,gBAAgB,GACvB,MAAM,IAAI,MAAM,4CAA4C,KAAK,aAAa,EAAE;CAElF,IAAI,KAAK,QAAQ,KAAK,KAAK,QAAQ,IACjC,MAAM,IAAI,MAAM,0CAA0C,KAAK,MAAM,EAAE;CAEzE,IAAI,KAAK,MAAM,KAAK,KAAK,MAAM,IAC7B,MAAM,IAAI,MAAM,wCAAwC,KAAK,IAAI,EAAE;CAErE,IAAI,KAAK,SAAS,QAAQ,KAAK,QAAQ,GACrC,MAAM,IAAI,MAAM,sCAAsC,KAAK,MAAM,EAAE;CAGrE,MAAM,YAAY,KAAK,aAAa,OAAO;CAC3C,MAAM,eAAe,KAAK,IAAI,WAAW,SAAS;CAClD,IAAI,KAAK,eAAe,cAAc,OAAO,CAAC;CAE9C,MAAM,YAAY,eAAe,KAAK,aAAa,EAAE,CAAC,CAAC;CACvD,MAAM,UAAU,eAAe,KAAK,IAAI,cAAc,OAAO,gBAAgB,GAAG,EAAE,CAAC,CAAC;CAEpF,MAAM,MAAoB,CAAC;CAC3B,IAAI,QAAQ;CAEZ,KAAK,IAAI,OAAO,WAAW,QAAQ,SAAS,QAAQ,KAAK,cAAc;EACrE,MAAM,MAAM,KAAK,IAAI,KAAK,KAAK,YAAY,MAAM,KAAK,KAAK,CAAC;EAC5D,IACE,mBAAmB,UACnB,sBAAsB,MAAM,KAAK,OAAO,KAAK,KAAK,WAAW,EAAE,GAE/D;EAEF,MAAM,WAAW,cAAc,MAAM,KAAK,OAAO,KAAK,KAAK,WAAW,IAAI,cAAc;EACxF,MAAM,SAAS,eAAe,UAAU,KAAK,UAAU,EAAE;EAEzD,IAAI,WAAW,KAAK,aAAa;EACjC,IAAI,YAAY,WAAW;EAE3B,IAAI,KAAK,SAAS,QAAQ,SAAS,KAAK,OAAO;EAC/C;EAEA,IAAI,WAAW,UAAU,QAAQ,aAAa,SAAS,GAAG;GACxD,IAAI,KAAK;IAAE,gBAAgB;IAAU,cAAc;GAAO,CAAC;GAC3D,IAAI,IAAI,SAAA,KACN,MAAM,IAAI,wBAAwB,QAAQ;EAE9C;CACF;CACA,OAAO;AACT"}

package/dist/in_memory_port.d.ts

@@ -0,0 +1,19 @@
+import { SchedulerPort } from './port.js';
+import { Alteration, ScheduleTemplate } from './types.js';
+export declare class InMemorySchedulerPort<TPayload extends {
+    type: string;
+}> implements SchedulerPort<TPayload> {
+    private _templates;
+    private _alterations;
+    listTemplates(_start: number, _end: number): Promise<ScheduleTemplate<TPayload>[]>;
+    getTemplate(id: string): Promise<ScheduleTemplate<TPayload> | null>;
+    addTemplate(template: ScheduleTemplate<TPayload>): Promise<void>;
+    updateTemplate(template: ScheduleTemplate<TPayload>): Promise<void>;
+    removeTemplate(id: string): Promise<void>;
+    listAlterations(_start: number, _end: number): Promise<Alteration<TPayload>[]>;
+    listAlterationsByTemplate(templateId: string): Promise<Alteration<TPayload>[]>;
+    addAlteration(alteration: Alteration<TPayload>): Promise<void>;
+    removeAlteration(id: string): Promise<void>;
+    removeAlterationsForTemplate(templateId: string): Promise<void>;
+}
+//# sourceMappingURL=in_memory_port.d.ts.map

package/dist/in_memory_port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in_memory_port.d.ts","sourceRoot":"","sources":["../src/in_memory_port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAO/D,qBAAa,qBAAqB,CAAC,QAAQ,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAClE,YAAW,aAAa,CAAC,QAAQ,CAAC;IAElC,OAAO,CAAC,UAAU,CAAiD;IACnE,OAAO,CAAC,YAAY,CAA2C;IAEzD,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;IAIlF,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAKnE,WAAW,CAAC,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhE,cAAc,CAAC,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnE,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;IAI9E,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;IAI9E,aAAa,CAAC,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9D,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKtE"}

package/dist/in_memory_port.js

@@ -0,0 +1,45 @@
+// src/in_memory_port.ts
+var InMemorySchedulerPort = class {
+	_templates = /* @__PURE__ */ new Map();
+	_alterations = /* @__PURE__ */ new Map();
+	async listTemplates(_start, _end) {
+		return [...this._templates.values()].map(clone);
+	}
+	async getTemplate(id) {
+		const t = this._templates.get(id);
+		return t == null ? null : clone(t);
+	}
+	async addTemplate(template) {
+		if (this._templates.has(template.id)) throw new Error(`Template already exists: ${template.id}`);
+		this._templates.set(template.id, clone(template));
+	}
+	async updateTemplate(template) {
+		if (!this._templates.has(template.id)) throw new Error(`No template with id ${template.id}`);
+		this._templates.set(template.id, clone(template));
+	}
+	async removeTemplate(id) {
+		this._templates.delete(id);
+	}
+	async listAlterations(_start, _end) {
+		return [...this._alterations.values()].map(clone);
+	}
+	async listAlterationsByTemplate(templateId) {
+		return [...this._alterations.values()].filter((a) => a.templateId === templateId).map(clone);
+	}
+	async addAlteration(alteration) {
+		if (this._alterations.has(alteration.id)) throw new Error(`Alteration already exists: ${alteration.id}`);
+		this._alterations.set(alteration.id, clone(alteration));
+	}
+	async removeAlteration(id) {
+		this._alterations.delete(id);
+	}
+	async removeAlterationsForTemplate(templateId) {
+		for (const [id, a] of this._alterations) if (a.templateId === templateId) this._alterations.delete(id);
+	}
+};
+function clone(value) {
+	return JSON.parse(JSON.stringify(value));
+}
+export { InMemorySchedulerPort };
+
+//# sourceMappingURL=in_memory_port.js.map

package/dist/in_memory_port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in_memory_port.js","names":[],"sources":["../src/in_memory_port.ts"],"sourcesContent":["import type { SchedulerPort } from \"./port.js\";\nimport type { Alteration, ScheduleTemplate } from \"./types.js\";\n\n// Reference port. Stores templates and alterations in plain Maps. Returns\n// deep-cloned copies so callers can't mutate internal state.\n//\n// Range queries return everything and let the Scheduler filter — correct,\n// but O(n) per query. A real backend would index on seriesStart/seriesEnd.\nexport class InMemorySchedulerPort<TPayload extends { type: string }>\n  implements SchedulerPort<TPayload>\n{\n  private _templates = new Map<string, ScheduleTemplate<TPayload>>();\n  private _alterations = new Map<string, Alteration<TPayload>>();\n\n  async listTemplates(_start: number, _end: number): Promise<ScheduleTemplate<TPayload>[]> {\n    return [...this._templates.values()].map(clone);\n  }\n\n  async getTemplate(id: string): Promise<ScheduleTemplate<TPayload> | null> {\n    const t = this._templates.get(id);\n    return t == null ? null : clone(t);\n  }\n\n  async addTemplate(template: ScheduleTemplate<TPayload>): Promise<void> {\n    if (this._templates.has(template.id)) {\n      throw new Error(`Template already exists: ${template.id}`);\n    }\n    this._templates.set(template.id, clone(template));\n  }\n\n  async updateTemplate(template: ScheduleTemplate<TPayload>): Promise<void> {\n    if (!this._templates.has(template.id)) {\n      throw new Error(`No template with id ${template.id}`);\n    }\n    this._templates.set(template.id, clone(template));\n  }\n\n  async removeTemplate(id: string): Promise<void> {\n    this._templates.delete(id);\n  }\n\n  async listAlterations(_start: number, _end: number): Promise<Alteration<TPayload>[]> {\n    return [...this._alterations.values()].map(clone);\n  }\n\n  async listAlterationsByTemplate(templateId: string): Promise<Alteration<TPayload>[]> {\n    return [...this._alterations.values()].filter((a) => a.templateId === templateId).map(clone);\n  }\n\n  async addAlteration(alteration: Alteration<TPayload>): Promise<void> {\n    if (this._alterations.has(alteration.id)) {\n      throw new Error(`Alteration already exists: ${alteration.id}`);\n    }\n    this._alterations.set(alteration.id, clone(alteration));\n  }\n\n  async removeAlteration(id: string): Promise<void> {\n    this._alterations.delete(id);\n  }\n\n  async removeAlterationsForTemplate(templateId: string): Promise<void> {\n    for (const [id, a] of this._alterations) {\n      if (a.templateId === templateId) this._alterations.delete(id);\n    }\n  }\n}\n\nfunction clone<T>(value: T): T {\n  return JSON.parse(JSON.stringify(value)) as T;\n}\n"],"mappings":";AAQA,IAAa,wBAAb,MAEA;CACE,6BAAqB,IAAI,IAAwC;CACjE,+BAAuB,IAAI,IAAkC;CAE7D,MAAM,cAAc,QAAgB,MAAqD;EACvF,OAAO,CAAC,GAAG,KAAK,WAAW,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK;CAChD;CAEA,MAAM,YAAY,IAAwD;EACxE,MAAM,IAAI,KAAK,WAAW,IAAI,EAAE;EAChC,OAAO,KAAK,OAAO,OAAO,MAAM,CAAC;CACnC;CAEA,MAAM,YAAY,UAAqD;EACrE,IAAI,KAAK,WAAW,IAAI,SAAS,EAAE,GACjC,MAAM,IAAI,MAAM,4BAA4B,SAAS,IAAI;EAE3D,KAAK,WAAW,IAAI,SAAS,IAAI,MAAM,QAAQ,CAAC;CAClD;CAEA,MAAM,eAAe,UAAqD;EACxE,IAAI,CAAC,KAAK,WAAW,IAAI,SAAS,EAAE,GAClC,MAAM,IAAI,MAAM,uBAAuB,SAAS,IAAI;EAEtD,KAAK,WAAW,IAAI,SAAS,IAAI,MAAM,QAAQ,CAAC;CAClD;CAEA,MAAM,eAAe,IAA2B;EAC9C,KAAK,WAAW,OAAO,EAAE;CAC3B;CAEA,MAAM,gBAAgB,QAAgB,MAA+C;EACnF,OAAO,CAAC,GAAG,KAAK,aAAa,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK;CAClD;CAEA,MAAM,0BAA0B,YAAqD;EACnF,OAAO,CAAC,GAAG,KAAK,aAAa,OAAO,CAAC,CAAC,CAAC,QAAQ,MAAM,EAAE,eAAe,UAAU,CAAC,CAAC,IAAI,KAAK;CAC7F;CAEA,MAAM,cAAc,YAAiD;EACnE,IAAI,KAAK,aAAa,IAAI,WAAW,EAAE,GACrC,MAAM,IAAI,MAAM,8BAA8B,WAAW,IAAI;EAE/D,KAAK,aAAa,IAAI,WAAW,IAAI,MAAM,UAAU,CAAC;CACxD;CAEA,MAAM,iBAAiB,IAA2B;EAChD,KAAK,aAAa,OAAO,EAAE;CAC7B;CAEA,MAAM,6BAA6B,YAAmC;EACpE,KAAK,MAAM,CAAC,IAAI,MAAM,KAAK,cACzB,IAAI,EAAE,eAAe,YAAY,KAAK,aAAa,OAAO,EAAE;CAEhE;AACF;AAEA,SAAS,MAAS,OAAa;CAC7B,OAAO,KAAK,MAAM,KAAK,UAAU,KAAK,CAAC;AACzC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { Scheduler } from './scheduler.js';
+export { InMemorySchedulerPort } from './in_memory_port.js';
+export type { SchedulerPort } from './port.js';
+export { Dispatcher, type DispatcherConfig } from './dispatcher.js';
+export { type DispatcherStore, InMemoryDispatcherStore } from './dispatcher_store.js';
+export { Day, Month, type RecurrenceRule, type InstantRule, type LocalDateTimeRule, type AnchoredRule, type DaysOfWeekRule, type WeeksOfMonthRule, type MonthsOfYearRule, type YearlyRule, type DaysOfMonthRule, type DaysOfYearRule, type ScheduleTemplate, type Alteration, type ScheduledEvent, type TimeSpan, type Disambiguation, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,KAAK,eAAe,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EACL,GAAG,EACH,KAAK,EACL,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+import { Scheduler } from "./scheduler.js";
+import { InMemorySchedulerPort } from "./in_memory_port.js";
+import { Dispatcher } from "./dispatcher.js";
+import { InMemoryDispatcherStore } from "./dispatcher_store.js";
+import { Day, Month } from "./types.js";
+export { Day, Dispatcher, InMemoryDispatcherStore, InMemorySchedulerPort, Month, Scheduler };

package/dist/occurrence_key.d.ts

@@ -0,0 +1,6 @@
+import { Occurrence } from './generators/types.js';
+export interface KeyedOccurrence extends Occurrence {
+    occurrenceKey: string;
+}
+export declare function assignOccurrenceKeys(occurrences: readonly Occurrence[], tz: string | undefined): KeyedOccurrence[];
+//# sourceMappingURL=occurrence_key.d.ts.map

package/dist/occurrence_key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"occurrence_key.d.ts","sourceRoot":"","sources":["../src/occurrence_key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAgBxD,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,SAAS,UAAU,EAAE,EAClC,EAAE,EAAE,MAAM,GAAG,SAAS,GACrB,eAAe,EAAE,CAUnB"}