@j13b/scheduler 0.0.0-stage → 0.1.1

package/dist/dispatcher_store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher_store.js","names":[],"sources":["../src/dispatcher_store.ts"],"sourcesContent":["// Persistence for the Dispatcher's tick cursor. The cursor is a single\n// epoch-ms value: the last instant for which the Dispatcher has fired all\n// due events. On restart, the Dispatcher catches up by listing events in\n// [cursor, now) and firing them — so a process crash followed by restart\n// won't lose events that were due during downtime.\n//\n// Same shape as ChatStore / MemoryStore in the agent module — implement\n// against whatever backend you want.\nexport interface DispatcherStore {\n  loadCursor(): Promise<number | null>;\n  saveCursor(cursor: number): Promise<void>;\n}\n\n// Reference in-memory implementation. Useful for tests and short-lived\n// processes that don't need crash recovery.\nexport class InMemoryDispatcherStore implements DispatcherStore {\n  private _cursor: number | null = null;\n\n  async loadCursor(): Promise<number | null> {\n    return this._cursor;\n  }\n\n  async saveCursor(cursor: number): Promise<void> {\n    this._cursor = cursor;\n  }\n}\n"],"mappings":";AAeA,IAAa,0BAAb,MAAgE;CAC9D,UAAiC;CAEjC,MAAM,aAAqC;EACzC,OAAO,KAAK;CACd;CAEA,MAAM,WAAW,QAA+B;EAC9C,KAAK,UAAU;CACjB;AACF"}

package/dist/generators/anchored.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"anchored.d.ts","sourceRoot":"","sources":["../../src/generators/anchored.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAEL,KAAK,UAAU,EAGhB,MAAM,YAAY,CAAC;AAKpB,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,YAAY,EAClB,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,UAAU,EAAE,CAmDd"}

package/dist/generators/anchored.js

@@ -0,0 +1,42 @@
+import { computeSpanEnd } from "../tz.js";
+import { TooManyOccurrencesError, intersects } from "./types.js";
+// src/generators/anchored.ts
+function generateAnchored(rule, tz, windowStart, windowEnd) {
+	if (rule.intervalMs <= 0) throw new Error(`AnchoredRule.intervalMs must be > 0 (got ${rule.intervalMs})`);
+	if (rule.count != null && rule.count < 0) throw new Error(`AnchoredRule.count must be >= 0 (got ${rule.count})`);
+	const seriesEnd = rule.seriesEnd ?? Number.POSITIVE_INFINITY;
+	const effectiveEnd = Math.min(windowEnd, seriesEnd);
+	const effectiveStart = Math.max(windowStart, rule.seriesStart);
+	if (effectiveStart >= effectiveEnd) return [];
+	let index;
+	let occurrenceStart;
+	if (rule.count != null) {
+		index = 0;
+		occurrenceStart = rule.anchorDate;
+	} else if (effectiveStart <= rule.anchorDate) {
+		index = 0;
+		occurrenceStart = rule.anchorDate;
+	} else {
+		const stepsAhead = Math.ceil((effectiveStart - rule.anchorDate) / rule.intervalMs);
+		index = stepsAhead;
+		occurrenceStart = rule.anchorDate + stepsAhead * rule.intervalMs;
+	}
+	const out = [];
+	while (occurrenceStart < effectiveEnd) {
+		if (rule.count != null && index >= rule.count) break;
+		const occEnd = computeSpanEnd(occurrenceStart, rule.timeSpan, tz);
+		if (intersects(occurrenceStart, occEnd, windowStart, windowEnd) && occurrenceStart >= rule.seriesStart) {
+			out.push({
+				startTimestamp: occurrenceStart,
+				endTimestamp: occEnd
+			});
+			if (out.length > 1e4) throw new TooManyOccurrencesError("anchored");
+		}
+		index++;
+		occurrenceStart += rule.intervalMs;
+	}
+	return out;
+}
+export { generateAnchored };
+
+//# sourceMappingURL=anchored.js.map

package/dist/generators/anchored.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchored.js","names":[],"sources":["../../src/generators/anchored.ts"],"sourcesContent":["import type { AnchoredRule } from \"../types.js\";\nimport { computeSpanEnd } from \"../tz.js\";\nimport {\n  MAX_OCCURRENCES_PER_GENERATE,\n  type Occurrence,\n  TooManyOccurrencesError,\n  intersects,\n} from \"./types.js\";\n\n// Anchored is tz-independent for STEPPING (every occurrence is exactly\n// intervalMs ms from the anchor), but tz can still affect the end-of-\n// occurrence when hourSpan is used. seriesStart/seriesEnd bound in UTC.\nexport function generateAnchored(\n  rule: AnchoredRule,\n  tz: string | undefined,\n  windowStart: number,\n  windowEnd: number\n): Occurrence[] {\n  if (rule.intervalMs <= 0) {\n    throw new Error(`AnchoredRule.intervalMs must be > 0 (got ${rule.intervalMs})`);\n  }\n  if (rule.count != null && rule.count < 0) {\n    throw new Error(`AnchoredRule.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  const effectiveStart = Math.max(windowStart, rule.seriesStart);\n\n  if (effectiveStart >= effectiveEnd) return [];\n\n  // If `count` is set we must start counting from the anchor; otherwise we\n  // can fast-forward to the window start.\n  let index: number;\n  let occurrenceStart: number;\n  if (rule.count != null) {\n    index = 0;\n    occurrenceStart = rule.anchorDate;\n  } else {\n    if (effectiveStart <= rule.anchorDate) {\n      index = 0;\n      occurrenceStart = rule.anchorDate;\n    } else {\n      // First occurrence at or after effectiveStart.\n      const stepsAhead = Math.ceil((effectiveStart - rule.anchorDate) / rule.intervalMs);\n      index = stepsAhead;\n      occurrenceStart = rule.anchorDate + stepsAhead * rule.intervalMs;\n    }\n  }\n\n  const out: Occurrence[] = [];\n  while (occurrenceStart < effectiveEnd) {\n    if (rule.count != null && index >= rule.count) break;\n\n    const occEnd = computeSpanEnd(occurrenceStart, rule.timeSpan, tz);\n    if (\n      intersects(occurrenceStart, occEnd, windowStart, windowEnd) &&\n      occurrenceStart >= rule.seriesStart\n    ) {\n      out.push({ startTimestamp: occurrenceStart, endTimestamp: occEnd });\n      if (out.length > MAX_OCCURRENCES_PER_GENERATE) {\n        throw new TooManyOccurrencesError(\"anchored\");\n      }\n    }\n    index++;\n    occurrenceStart += rule.intervalMs;\n  }\n  return out;\n}\n"],"mappings":";;;AAYA,SAAgB,iBACd,MACA,IACA,aACA,WACc;CACd,IAAI,KAAK,cAAc,GACrB,MAAM,IAAI,MAAM,4CAA4C,KAAK,WAAW,EAAE;CAEhF,IAAI,KAAK,SAAS,QAAQ,KAAK,QAAQ,GACrC,MAAM,IAAI,MAAM,wCAAwC,KAAK,MAAM,EAAE;CAGvE,MAAM,YAAY,KAAK,aAAa,OAAO;CAC3C,MAAM,eAAe,KAAK,IAAI,WAAW,SAAS;CAClD,MAAM,iBAAiB,KAAK,IAAI,aAAa,KAAK,WAAW;CAE7D,IAAI,kBAAkB,cAAc,OAAO,CAAC;CAI5C,IAAI;CACJ,IAAI;CACJ,IAAI,KAAK,SAAS,MAAM;EACtB,QAAQ;EACR,kBAAkB,KAAK;CACzB,OACE,IAAI,kBAAkB,KAAK,YAAY;EACrC,QAAQ;EACR,kBAAkB,KAAK;CACzB,OAAO;EAEL,MAAM,aAAa,KAAK,MAAM,iBAAiB,KAAK,cAAc,KAAK,UAAU;EACjF,QAAQ;EACR,kBAAkB,KAAK,aAAa,aAAa,KAAK;CACxD;CAGF,MAAM,MAAoB,CAAC;CAC3B,OAAO,kBAAkB,cAAc;EACrC,IAAI,KAAK,SAAS,QAAQ,SAAS,KAAK,OAAO;EAE/C,MAAM,SAAS,eAAe,iBAAiB,KAAK,UAAU,EAAE;EAChE,IACE,WAAW,iBAAiB,QAAQ,aAAa,SAAS,KAC1D,mBAAmB,KAAK,aACxB;GACA,IAAI,KAAK;IAAE,gBAAgB;IAAiB,cAAc;GAAO,CAAC;GAClE,IAAI,IAAI,SAAA,KACN,MAAM,IAAI,wBAAwB,UAAU;EAEhD;EACA;EACA,mBAAmB,KAAK;CAC1B;CACA,OAAO;AACT"}

package/dist/generators/days_of_month.d.ts

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

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

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

package/dist/generators/days_of_month.js

@@ -0,0 +1,53 @@
+import { computeSpanEnd, isNonexistentWallTime, monthLength, utcToWallParts, wallTimeToUtc } from "../tz.js";
+import { TooManyOccurrencesError, intersects } from "./types.js";
+// src/generators/days_of_month.ts
+function generateDaysOfMonth(rule, tz, windowStart, windowEnd, disambiguation = "compatible") {
+	if (rule.yearInterval <= 0) throw new Error(`DaysOfMonthRule.yearInterval must be > 0 (got ${rule.yearInterval})`);
+	if (rule.months.length === 0) throw new Error("DaysOfMonthRule.months must be non-empty");
+	for (const m of rule.months) if (m < 0 || m > 11) throw new Error(`DaysOfMonthRule.months entries must be in 0..11 (got ${m})`);
+	if (rule.daysOfMonth.length === 0) throw new Error("DaysOfMonthRule.daysOfMonth must be non-empty");
+	for (const d of rule.daysOfMonth) if (d < 1 || d > 31) throw new Error(`DaysOfMonthRule.daysOfMonth entries must be in 1..31 (got ${d})`);
+	if (rule.count != null && rule.count < 0) throw new Error(`DaysOfMonthRule.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 daysOfMonth = [...new Set(rule.daysOfMonth)].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 month of months) {
+			const len = monthLength(year, month);
+			const clampedDays = [...new Set(daysOfMonth.map((d) => Math.min(d, len)))];
+			for (const day of clampedDays) {
+				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("daysOfMonth");
+				}
+			}
+		}
+		yearEmits.sort((a, b) => a.startTimestamp - b.startTimestamp);
+		out.push(...yearEmits);
+	}
+	return out;
+}
+export { generateDaysOfMonth };
+
+//# sourceMappingURL=days_of_month.js.map

package/dist/generators/days_of_month.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"days_of_month.js","names":[],"sources":["../../src/generators/days_of_month.ts"],"sourcesContent":["import type { DaysOfMonthRule, Disambiguation } 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// Numerical date-based recurrence: months × daysOfMonth. Days clamp per\n// month (day 31 in April → Apr 30, day 29 in Feb non-leap → Feb 28).\nexport function generateDaysOfMonth(\n  rule: DaysOfMonthRule,\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(`DaysOfMonthRule.yearInterval must be > 0 (got ${rule.yearInterval})`);\n  }\n  if (rule.months.length === 0) {\n    throw new Error(\"DaysOfMonthRule.months must be non-empty\");\n  }\n  for (const m of rule.months) {\n    if (m < 0 || m > 11) {\n      throw new Error(`DaysOfMonthRule.months entries must be in 0..11 (got ${m})`);\n    }\n  }\n  if (rule.daysOfMonth.length === 0) {\n    throw new Error(\"DaysOfMonthRule.daysOfMonth must be non-empty\");\n  }\n  for (const d of rule.daysOfMonth) {\n    if (d < 1 || d > 31) {\n      throw new Error(`DaysOfMonthRule.daysOfMonth entries must be in 1..31 (got ${d})`);\n    }\n  }\n  if (rule.count != null && rule.count < 0) {\n    throw new Error(`DaysOfMonthRule.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 daysOfMonth = [...new Set(rule.daysOfMonth)].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 month of months) {\n      const len = monthLength(year, month);\n      // Dedup clamped days so day-31 + day-30 in April don't both emit Apr 30.\n      const clampedDays = [...new Set(daysOfMonth.map((d) => Math.min(d, len)))];\n      for (const day of clampedDays) {\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(\"daysOfMonth\");\n          }\n        }\n      }\n    }\n    yearEmits.sort((a, b) => a.startTimestamp - b.startTimestamp);\n    out.push(...yearEmits);\n  }\n  return out;\n}\n"],"mappings":";;;AAiBA,SAAgB,oBACd,MACA,IACA,aACA,WACA,iBAAiC,cACnB;CACd,IAAI,KAAK,gBAAgB,GACvB,MAAM,IAAI,MAAM,iDAAiD,KAAK,aAAa,EAAE;CAEvF,IAAI,KAAK,OAAO,WAAW,GACzB,MAAM,IAAI,MAAM,0CAA0C;CAE5D,KAAK,MAAM,KAAK,KAAK,QACnB,IAAI,IAAI,KAAK,IAAI,IACf,MAAM,IAAI,MAAM,wDAAwD,EAAE,EAAE;CAGhF,IAAI,KAAK,YAAY,WAAW,GAC9B,MAAM,IAAI,MAAM,+CAA+C;CAEjE,KAAK,MAAM,KAAK,KAAK,aACnB,IAAI,IAAI,KAAK,IAAI,IACf,MAAM,IAAI,MAAM,6DAA6D,EAAE,EAAE;CAGrF,IAAI,KAAK,SAAS,QAAQ,KAAK,QAAQ,GACrC,MAAM,IAAI,MAAM,2CAA2C,KAAK,MAAM,EAAE;CAG1E,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,cAAc,CAAC,GAAG,IAAI,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC;CAEvE,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,SAAS,QAAQ;GAC1B,MAAM,MAAM,YAAY,MAAM,KAAK;GAEnC,MAAM,cAAc,CAAC,GAAG,IAAI,IAAI,YAAY,KAAK,MAAM,KAAK,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC;GACzE,KAAK,MAAM,OAAO,aAAa;IAC7B,IACE,mBAAmB,UACnB,sBAAsB,MAAM,OAAO,KAAK,KAAK,WAAW,EAAE,GAE1D;IAEF,MAAM,WAAW,cAAc,MAAM,OAAO,KAAK,KAAK,WAAW,IAAI,cAAc;IACnF,MAAM,SAAS,eAAe,UAAU,KAAK,UAAU,EAAE;IAEzD,IAAI,WAAW,KAAK,aAAa;IACjC,IAAI,YAAY,WAAW;IAE3B,IAAI,KAAK,SAAS,QAAQ,SAAS,KAAK,OAAO;KAC7C,UAAU,MAAM,GAAG,MAAM,EAAE,iBAAiB,EAAE,cAAc;KAC5D,IAAI,KAAK,GAAG,SAAS;KACrB,OAAO;IACT;IACA;IAEA,IAAI,WAAW,UAAU,QAAQ,aAAa,SAAS,GAAG;KACxD,UAAU,KAAK;MAAE,gBAAgB;MAAU,cAAc;KAAO,CAAC;KACjE,IAAI,IAAI,SAAS,UAAU,SAAA,KACzB,MAAM,IAAI,wBAAwB,aAAa;IAEnD;GACF;EACF;EACA,UAAU,MAAM,GAAG,MAAM,EAAE,iBAAiB,EAAE,cAAc;EAC5D,IAAI,KAAK,GAAG,SAAS;CACvB;CACA,OAAO;AACT"}

package/dist/generators/days_of_week.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"days_of_week.d.ts","sourceRoot":"","sources":["../../src/generators/days_of_week.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAGL,aAAa,EAId,MAAM,UAAU,CAAC;AAClB,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,CAwEd;AAGD,OAAO,EAAE,aAAa,EAAE,CAAC"}

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"}