@dowel-ui/react 0.4.0 → 0.5.0

package/dist/components/cron-editor/cron-expression.js

@@ -0,0 +1,352 @@
+//#region src/components/cron-editor/cron-expression.ts
+var CronExpressionError = class extends Error {
+	field;
+	constructor(message, field) {
+		super(message);
+		this.field = field;
+		this.name = "CronExpressionError";
+	}
+};
+const FIELDS = [
+	"minute",
+	"hour",
+	"dayOfMonth",
+	"month",
+	"dayOfWeek"
+];
+const RANGES = {
+	minute: {
+		min: 0,
+		max: 59,
+		label: "Minute"
+	},
+	hour: {
+		min: 0,
+		max: 23,
+		label: "Hour"
+	},
+	dayOfMonth: {
+		min: 1,
+		max: 31,
+		label: "Day of month"
+	},
+	month: {
+		min: 1,
+		max: 12,
+		label: "Month"
+	},
+	dayOfWeek: {
+		min: 0,
+		max: 7,
+		label: "Day of week"
+	}
+};
+const MONTH_NAMES = [
+	"JAN",
+	"FEB",
+	"MAR",
+	"APR",
+	"MAY",
+	"JUN",
+	"JUL",
+	"AUG",
+	"SEP",
+	"OCT",
+	"NOV",
+	"DEC"
+];
+const DAY_NAMES = [
+	"SUN",
+	"MON",
+	"TUE",
+	"WED",
+	"THU",
+	"FRI",
+	"SAT"
+];
+const CRON_SHORTCUTS = {
+	"@yearly": "0 0 1 1 *",
+	"@annually": "0 0 1 1 *",
+	"@monthly": "0 0 1 * *",
+	"@weekly": "0 0 * * 0",
+	"@daily": "0 0 * * *",
+	"@midnight": "0 0 * * *",
+	"@hourly": "0 * * * *"
+};
+function nameToNumber(token, field) {
+	const upper = token.toUpperCase();
+	if (field === "month") {
+		const index = MONTH_NAMES.indexOf(upper);
+		return index === -1 ? null : index + 1;
+	}
+	if (field === "dayOfWeek") {
+		const index = DAY_NAMES.indexOf(upper);
+		return index === -1 ? null : index;
+	}
+	return null;
+}
+function parseNumber(token, field) {
+	const { min, max, label } = RANGES[field];
+	const value = nameToNumber(token, field) ?? (/^\d+$/.test(token) ? Number(token) : NaN);
+	if (Number.isNaN(value)) throw new CronExpressionError(`${label}: "${token}" is not a number${field === "month" || field === "dayOfWeek" ? " or a name" : ""}.`, field);
+	if (value < min || value > max) throw new CronExpressionError(`${label} must be ${String(min)}–${String(max)}, not ${String(value)}.`, field);
+	return value;
+}
+/** One field's set of values, in order and without duplicates. */
+function parseField(text, field) {
+	const { min, max, label } = RANGES[field];
+	const top = field === "dayOfWeek" ? 6 : max;
+	const values = /* @__PURE__ */ new Set();
+	let restricted = false;
+	for (const part of text.split(",")) {
+		if (part === "") throw new CronExpressionError(`${label}: empty item in "${text}".`, field);
+		const [rangeText, stepText, ...extra] = part.split("/");
+		if (extra.length > 0 || stepText === "") throw new CronExpressionError(`${label}: "${part}" has a malformed step.`, field);
+		const step = stepText === void 0 ? 1 : Number(stepText);
+		if (stepText !== void 0 && (!/^\d+$/.test(stepText) || step < 1)) throw new CronExpressionError(`${label}: step must be a whole number of 1 or more, not "${stepText}".`, field);
+		let start;
+		let end;
+		if (rangeText === "*") {
+			start = min;
+			end = top;
+			if (stepText !== void 0) restricted = true;
+		} else if (rangeText === void 0) throw new CronExpressionError(`${label}: "${part}" is empty.`, field);
+		else {
+			restricted = true;
+			const [startText, endText, ...more] = rangeText.split("-");
+			if (more.length > 0 || startText === void 0 || startText === "") throw new CronExpressionError(`${label}: "${rangeText}" is not a range.`, field);
+			start = parseNumber(startText, field);
+			if (endText === void 0) end = stepText === void 0 ? start : top;
+			else {
+				if (endText === "") throw new CronExpressionError(`${label}: "${rangeText}" is missing its end.`, field);
+				end = parseNumber(endText, field);
+				if (end < start) throw new CronExpressionError(`${label}: ${String(start)}-${String(end)} runs backwards.`, field);
+			}
+		}
+		for (let value = start; value <= end; value += step) values.add(field === "dayOfWeek" && value === 7 ? 0 : value);
+	}
+	return {
+		values: [...values].sort((a, b) => a - b),
+		restricted
+	};
+}
+function parseCron(expression) {
+	const trimmed = expression.trim();
+	if (trimmed === "") throw new CronExpressionError("Enter a schedule.");
+	const expanded = trimmed.startsWith("@") ? CRON_SHORTCUTS[trimmed.toLowerCase()] : trimmed;
+	if (expanded === void 0) throw new CronExpressionError(`"${trimmed}" is not a shortcut. Try @hourly, @daily, @weekly, @monthly or @yearly.`);
+	const parts = expanded.split(/\s+/);
+	if (parts.length !== 5) throw new CronExpressionError(`Expected 5 fields — minute, hour, day of month, month, day of week — not ${String(parts.length)}.`);
+	const fields = FIELDS.map((field, index) => parseField(parts[index] ?? "", field));
+	const at = (index) => fields[index] ?? {
+		values: [],
+		restricted: false
+	};
+	const [minute, hour, dayOfMonth, month, dayOfWeek] = [
+		at(0),
+		at(1),
+		at(2),
+		at(3),
+		at(4)
+	];
+	return {
+		minutes: minute.values,
+		hours: hour.values,
+		daysOfMonth: dayOfMonth.values,
+		months: month.values,
+		daysOfWeek: dayOfWeek.values,
+		dayOfMonthRestricted: dayOfMonth.restricted,
+		dayOfWeekRestricted: dayOfWeek.restricted,
+		expression: parts.join(" ")
+	};
+}
+function isValidCron(expression) {
+	try {
+		parseCron(expression);
+		return true;
+	} catch {
+		return false;
+	}
+}
+/** "1, 2 and 3", or "1 to 5" when the values are consecutive. */
+function listOf(items, consecutive) {
+	if (items.length === 1) return items[0] ?? "";
+	if (consecutive && items.length > 2) return `${items[0] ?? ""} to ${items[items.length - 1] ?? ""}`;
+	return `${items.slice(0, -1).join(", ")} and ${items[items.length - 1] ?? ""}`;
+}
+function isConsecutive(values) {
+	return values.every((value, index) => index === 0 || value === (values[index - 1] ?? 0) + 1);
+}
+/** The step a field was written with, when it was written as a star over a number. */
+function stepOf(text) {
+	const match = /^\*\/(\d+)$/.exec(text);
+	return match ? Number(match[1]) : null;
+}
+function ordinal(n) {
+	const rem10 = n % 10;
+	const rem100 = n % 100;
+	return `${String(n)}${rem10 === 1 && rem100 !== 11 ? "st" : rem10 === 2 && rem100 !== 12 ? "nd" : rem10 === 3 && rem100 !== 13 ? "rd" : "th"}`;
+}
+function formatTime(hour, minute, locale) {
+	return new Intl.DateTimeFormat(locale, {
+		hour: "2-digit",
+		minute: "2-digit",
+		timeZone: "UTC"
+	}).format(Date.UTC(2026, 0, 1, hour, minute));
+}
+function dayName(index, locale) {
+	return new Intl.DateTimeFormat(locale, { weekday: "long" }).format(new Date(2026, 0, 4 + index));
+}
+function monthName(index, locale) {
+	return new Intl.DateTimeFormat(locale, { month: "long" }).format(new Date(2026, index - 1, 1));
+}
+/**
+* The schedule in a sentence.
+*
+* Every product that has this control renders "Every Monday at 09:00" beside
+* the expression, because `0 9 * * 1` is not something most people can read.
+* Throws for an invalid expression; the editor turns that into the field's
+* error text.
+*/
+function describeCron(expression, options = {}) {
+	const { locale } = options;
+	const schedule = parseCron(expression);
+	const [minuteText = "", hourText = "", dayText = "", monthText = ""] = schedule.expression.split(" ");
+	const every = (label, n) => n === 1 ? `every ${label}` : `every ${ordinal(n)} ${label}`;
+	let time;
+	const minuteStep = stepOf(minuteText);
+	const hourStep = stepOf(hourText);
+	const allMinutes = minuteText === "*";
+	const allHours = hourText === "*";
+	if (allMinutes && allHours) time = "Every minute";
+	else if (minuteStep !== null && allHours) time = `Every ${minuteStep === 1 ? "minute" : `${String(minuteStep)} minutes`}`;
+	else if (allMinutes) time = `Every minute of ${listOf(schedule.hours.map((h) => formatTime(h, 0, locale)), isConsecutive(schedule.hours))}`;
+	else if (allHours || hourStep !== null) {
+		const hours = hourStep !== null && hourStep > 1 ? every("hour", hourStep) : "every hour";
+		if (minuteStep !== null) time = `Every ${String(minuteStep)} minutes of ${hours}`;
+		else time = `At minute ${listOf(schedule.minutes.map(String), isConsecutive(schedule.minutes))} past ${hours}`;
+	} else if (minuteStep !== null) time = `Every ${String(minuteStep)} minutes during ${listOf(schedule.hours.map((h) => formatTime(h, 0, locale)), isConsecutive(schedule.hours))}`;
+	else if (schedule.minutes.length === 1) {
+		const minute = schedule.minutes[0] ?? 0;
+		time = `At ${listOf(schedule.hours.map((h) => formatTime(h, minute, locale)), false)}`;
+	} else time = `At minute ${listOf(schedule.minutes.map(String), isConsecutive(schedule.minutes))} past ${listOf(schedule.hours.map((h) => formatTime(h, 0, locale)), isConsecutive(schedule.hours))}`;
+	const dayPhrases = [];
+	if (schedule.dayOfMonthRestricted) {
+		const step = stepOf(dayText);
+		dayPhrases.push(step !== null ? `${every("day", step)} of the month` : `on day ${listOf(schedule.daysOfMonth.map(String), isConsecutive(schedule.daysOfMonth))} of the month`);
+	}
+	if (schedule.dayOfWeekRestricted) dayPhrases.push(`on ${listOf(schedule.daysOfWeek.map((d) => dayName(d, locale)), isConsecutive(schedule.daysOfWeek))}`);
+	let days = dayPhrases.join(", or ");
+	if (!days && !allMinutes && !allHours && minuteStep === null && hourStep === null) days = "every day";
+	if (schedule.months.length < 12) {
+		const step = stepOf(monthText);
+		const months = step !== null ? every("month", step) : listOf(schedule.months.map((m) => monthName(m, locale)), isConsecutive(schedule.months));
+		days = `${days ? `${days} ` : ""}in ${months}`;
+	}
+	return days ? `${time} ${days}` : time;
+}
+const formatters = /* @__PURE__ */ new Map();
+function formatterFor(timeZone) {
+	const key = timeZone ?? "";
+	let formatter = formatters.get(key);
+	if (!formatter) {
+		formatter = new Intl.DateTimeFormat("en-US", {
+			timeZone,
+			hourCycle: "h23",
+			year: "numeric",
+			month: "numeric",
+			day: "numeric",
+			hour: "numeric",
+			minute: "numeric",
+			weekday: "short"
+		});
+		formatters.set(key, formatter);
+	}
+	return formatter;
+}
+function wallClockOf(instant, timeZone) {
+	const parts = {};
+	for (const part of formatterFor(timeZone).formatToParts(new Date(instant))) parts[part.type] = part.value;
+	return {
+		year: Number(parts.year),
+		month: Number(parts.month),
+		day: Number(parts.day),
+		hour: Number(parts.hour) % 24,
+		minute: Number(parts.minute),
+		weekday: DAY_NAMES.indexOf((parts.weekday ?? "").slice(0, 3).toUpperCase())
+	};
+}
+function offsetAt(instant, timeZone) {
+	const wall = wallClockOf(instant, timeZone);
+	return Date.UTC(wall.year, wall.month - 1, wall.day, wall.hour, wall.minute) - Math.floor(instant / 6e4) * 6e4;
+}
+/**
+* The instant a wall-clock time names in a zone, or null when it names none —
+* the hour the clocks skip in spring. An ambiguous time, in the hour that
+* repeats in autumn, resolves to its first occurrence.
+*/
+function zonedTimeToInstant(year, month, day, hour, minute, timeZone) {
+	const guess = Date.UTC(year, month - 1, day, hour, minute);
+	const candidates = /* @__PURE__ */ new Set();
+	const oneDay = 864e5;
+	for (const seed of [
+		guess,
+		guess - oneDay,
+		guess + oneDay
+	]) {
+		let instant = seed;
+		for (let pass = 0; pass < 2; pass += 1) {
+			instant = guess - offsetAt(instant, timeZone);
+			candidates.add(instant);
+		}
+	}
+	for (const candidate of [...candidates].sort((a, b) => a - b)) {
+		const wall = wallClockOf(candidate, timeZone);
+		if (wall.year === year && wall.month === month && wall.day === day && wall.hour === hour && wall.minute === minute) return candidate;
+	}
+	return null;
+}
+/** Roughly five years of days: enough to find the 29th of February, and to give up on the 30th. */
+const MAX_DAYS = 1830;
+/**
+* The next `count` instants the schedule fires, in order.
+*
+* Fewer than `count` are returned when the schedule cannot produce them —
+* `0 0 30 2 *` never runs, and saying so beats a spinner.
+*/
+function nextRuns(expression, options) {
+	const { from, count = 5, timeZone } = options;
+	const schedule = parseCron(expression);
+	const runs = [];
+	const start = Math.floor(from.getTime() / 6e4) * 6e4 + 6e4;
+	const months = new Set(schedule.months);
+	const daysOfMonth = new Set(schedule.daysOfMonth);
+	const daysOfWeek = new Set(schedule.daysOfWeek);
+	const dayMatches = (wall) => {
+		if (!months.has(wall.month)) return false;
+		const domMatch = daysOfMonth.has(wall.day);
+		const dowMatch = daysOfWeek.has(wall.weekday);
+		if (schedule.dayOfMonthRestricted && schedule.dayOfWeekRestricted) return domMatch || dowMatch;
+		if (schedule.dayOfMonthRestricted) return domMatch;
+		if (schedule.dayOfWeekRestricted) return dowMatch;
+		return true;
+	};
+	const first = wallClockOf(start, timeZone);
+	let noon = zonedTimeToInstant(first.year, first.month, first.day, 12, 0, timeZone);
+	if (noon === null) return runs;
+	for (let i = 0; i < MAX_DAYS && runs.length < count; i += 1, noon += 864e5) {
+		const wall = wallClockOf(noon, timeZone);
+		if (!dayMatches(wall)) continue;
+		for (const hour of schedule.hours) for (const minute of schedule.minutes) {
+			const instant = zonedTimeToInstant(wall.year, wall.month, wall.day, hour, minute, timeZone);
+			if (instant === null || instant < start) continue;
+			runs.push(new Date(instant));
+			if (runs.length >= count) return runs;
+		}
+	}
+	return runs;
+}
+//#endregion
+export { CRON_SHORTCUTS, CronExpressionError, describeCron, isValidCron, nextRuns, parseCron, zonedTimeToInstant };
+
+//# sourceMappingURL=cron-expression.js.map

package/dist/components/cron-editor/cron-expression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-expression.js","names":[],"sources":["../../../src/components/cron-editor/cron-expression.ts"],"sourcesContent":["/**\n * The five-field cron expression, as a value: parsed, described in words, and\n * projected onto a calendar in a named time zone.\n *\n * The dialect is the POSIX one — minute, hour, day of month, month, day of\n * week — which is what crontab, GitHub Actions, Vercel, Kubernetes and Airflow\n * all read. Not the Quartz one: no seconds field and no `L`, `W` or `#`,\n * because the products people schedule from a form do not accept them, and an\n * expression this editor produces has to run where it is pasted. The `@daily`\n * family of shortcuts is accepted, since crontab accepts it.\n *\n * Everything here is pure and takes its clock as an argument, so the\n * description, the run times and the two things every reimplementation gets\n * wrong — day-of-month OR day-of-week, and a wall-clock time that does not\n * exist on the day the clocks go forward — are tested without rendering\n * anything, and an application can compute the next run on the server from\n * the same expression the editor produced.\n */\n\nexport type CronField = \"minute\" | \"hour\" | \"dayOfMonth\" | \"month\" | \"dayOfWeek\";\n\nexport class CronExpressionError extends Error {\n  constructor(\n    message: string,\n    /** Which of the five fields is wrong, when one is. */\n    public readonly field?: CronField,\n  ) {\n    super(message);\n    this.name = \"CronExpressionError\";\n  }\n}\n\nexport interface CronSchedule {\n  minutes: number[];\n  hours: number[];\n  daysOfMonth: number[];\n  months: number[];\n  /** 0 to 6, Sunday first. `7` in the source is folded into 0. */\n  daysOfWeek: number[];\n  /**\n   * Whether each day field was written as something other than `*`. Cron's\n   * rule, which every reimplementation gets wrong at least once: when both are\n   * restricted a day matches if EITHER does, not both.\n   */\n  dayOfMonthRestricted: boolean;\n  dayOfWeekRestricted: boolean;\n  /** The expression with any shortcut expanded. */\n  expression: string;\n}\n\nconst FIELDS: readonly CronField[] = [\"minute\", \"hour\", \"dayOfMonth\", \"month\", \"dayOfWeek\"];\n\nconst RANGES: Record<CronField, { min: number; max: number; label: string }> = {\n  minute: { min: 0, max: 59, label: \"Minute\" },\n  hour: { min: 0, max: 23, label: \"Hour\" },\n  dayOfMonth: { min: 1, max: 31, label: \"Day of month\" },\n  month: { min: 1, max: 12, label: \"Month\" },\n  dayOfWeek: { min: 0, max: 7, label: \"Day of week\" },\n};\n\nconst MONTH_NAMES = [\n  \"JAN\",\n  \"FEB\",\n  \"MAR\",\n  \"APR\",\n  \"MAY\",\n  \"JUN\",\n  \"JUL\",\n  \"AUG\",\n  \"SEP\",\n  \"OCT\",\n  \"NOV\",\n  \"DEC\",\n];\nconst DAY_NAMES = [\"SUN\", \"MON\", \"TUE\", \"WED\", \"THU\", \"FRI\", \"SAT\"];\n\nexport const CRON_SHORTCUTS: Record<string, string> = {\n  \"@yearly\": \"0 0 1 1 *\",\n  \"@annually\": \"0 0 1 1 *\",\n  \"@monthly\": \"0 0 1 * *\",\n  \"@weekly\": \"0 0 * * 0\",\n  \"@daily\": \"0 0 * * *\",\n  \"@midnight\": \"0 0 * * *\",\n  \"@hourly\": \"0 * * * *\",\n};\n\nfunction nameToNumber(token: string, field: CronField): number | null {\n  const upper = token.toUpperCase();\n  if (field === \"month\") {\n    const index = MONTH_NAMES.indexOf(upper);\n    return index === -1 ? null : index + 1;\n  }\n  if (field === \"dayOfWeek\") {\n    const index = DAY_NAMES.indexOf(upper);\n    return index === -1 ? null : index;\n  }\n  return null;\n}\n\nfunction parseNumber(token: string, field: CronField): number {\n  const { min, max, label } = RANGES[field];\n  const named = nameToNumber(token, field);\n  const value = named ?? (/^\\d+$/.test(token) ? Number(token) : Number.NaN);\n  if (Number.isNaN(value)) {\n    throw new CronExpressionError(\n      `${label}: \"${token}\" is not a number${field === \"month\" || field === \"dayOfWeek\" ? \" or a name\" : \"\"}.`,\n      field,\n    );\n  }\n  if (value < min || value > max) {\n    throw new CronExpressionError(\n      `${label} must be ${String(min)}–${String(max)}, not ${String(value)}.`,\n      field,\n    );\n  }\n  return value;\n}\n\n/** One field's set of values, in order and without duplicates. */\nfunction parseField(text: string, field: CronField): { values: number[]; restricted: boolean } {\n  const { min, max, label } = RANGES[field];\n  // Day of week runs 0–7 in the source and 0–6 in the result.\n  const top = field === \"dayOfWeek\" ? 6 : max;\n  const values = new Set<number>();\n  let restricted = false;\n\n  for (const part of text.split(\",\")) {\n    if (part === \"\") throw new CronExpressionError(`${label}: empty item in \"${text}\".`, field);\n\n    const [rangeText, stepText, ...extra] = part.split(\"/\");\n    if (extra.length > 0 || stepText === \"\") {\n      throw new CronExpressionError(`${label}: \"${part}\" has a malformed step.`, field);\n    }\n    const step = stepText === undefined ? 1 : Number(stepText);\n    if (stepText !== undefined && (!/^\\d+$/.test(stepText) || step < 1)) {\n      throw new CronExpressionError(\n        `${label}: step must be a whole number of 1 or more, not \"${stepText}\".`,\n        field,\n      );\n    }\n\n    let start: number;\n    let end: number;\n    if (rangeText === \"*\") {\n      start = min;\n      end = top;\n      if (stepText !== undefined) restricted = true;\n    } else if (rangeText === undefined) {\n      throw new CronExpressionError(`${label}: \"${part}\" is empty.`, field);\n    } else {\n      restricted = true;\n      const [startText, endText, ...more] = rangeText.split(\"-\");\n      if (more.length > 0 || startText === undefined || startText === \"\") {\n        throw new CronExpressionError(`${label}: \"${rangeText}\" is not a range.`, field);\n      }\n      start = parseNumber(startText, field);\n      if (endText === undefined) {\n        // A bare number with a step, `5/10`, means \"from 5 onwards\" in Vixie cron.\n        end = stepText === undefined ? start : top;\n      } else {\n        if (endText === \"\")\n          throw new CronExpressionError(`${label}: \"${rangeText}\" is missing its end.`, field);\n        end = parseNumber(endText, field);\n        if (end < start) {\n          throw new CronExpressionError(\n            `${label}: ${String(start)}-${String(end)} runs backwards.`,\n            field,\n          );\n        }\n      }\n    }\n\n    for (let value = start; value <= end; value += step) {\n      values.add(field === \"dayOfWeek\" && value === 7 ? 0 : value);\n    }\n  }\n\n  return { values: [...values].sort((a, b) => a - b), restricted };\n}\n\nexport function parseCron(expression: string): CronSchedule {\n  const trimmed = expression.trim();\n  if (trimmed === \"\") throw new CronExpressionError(\"Enter a schedule.\");\n\n  const expanded = trimmed.startsWith(\"@\") ? CRON_SHORTCUTS[trimmed.toLowerCase()] : trimmed;\n  if (expanded === undefined) {\n    throw new CronExpressionError(\n      `\"${trimmed}\" is not a shortcut. Try @hourly, @daily, @weekly, @monthly or @yearly.`,\n    );\n  }\n\n  const parts = expanded.split(/\\s+/);\n  if (parts.length !== 5) {\n    throw new CronExpressionError(\n      `Expected 5 fields — minute, hour, day of month, month, day of week — not ${String(parts.length)}.`,\n    );\n  }\n\n  const fields = FIELDS.map((field, index) => parseField(parts[index] ?? \"\", field));\n  const at = (index: number) => fields[index] ?? { values: [], restricted: false };\n  const [minute, hour, dayOfMonth, month, dayOfWeek] = [at(0), at(1), at(2), at(3), at(4)];\n\n  return {\n    minutes: minute.values,\n    hours: hour.values,\n    daysOfMonth: dayOfMonth.values,\n    months: month.values,\n    daysOfWeek: dayOfWeek.values,\n    dayOfMonthRestricted: dayOfMonth.restricted,\n    dayOfWeekRestricted: dayOfWeek.restricted,\n    expression: parts.join(\" \"),\n  };\n}\n\nexport function isValidCron(expression: string): boolean {\n  try {\n    parseCron(expression);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/* ------------------------------------------------------------------ */\n/*  Describing                                                         */\n/* ------------------------------------------------------------------ */\n\nexport interface DescribeOptions {\n  locale?: string;\n}\n\n/** \"1, 2 and 3\", or \"1 to 5\" when the values are consecutive. */\nfunction listOf(items: string[], consecutive: boolean): string {\n  if (items.length === 1) return items[0] ?? \"\";\n  if (consecutive && items.length > 2)\n    return `${items[0] ?? \"\"} to ${items[items.length - 1] ?? \"\"}`;\n  return `${items.slice(0, -1).join(\", \")} and ${items[items.length - 1] ?? \"\"}`;\n}\n\nfunction isConsecutive(values: number[]): boolean {\n  return values.every((value, index) => index === 0 || value === (values[index - 1] ?? 0) + 1);\n}\n\n/** The step a field was written with, when it was written as a star over a number. */\nfunction stepOf(text: string): number | null {\n  const match = /^\\*\\/(\\d+)$/.exec(text);\n  return match ? Number(match[1]) : null;\n}\n\nfunction ordinal(n: number): string {\n  const rem10 = n % 10;\n  const rem100 = n % 100;\n  const suffix =\n    rem10 === 1 && rem100 !== 11\n      ? \"st\"\n      : rem10 === 2 && rem100 !== 12\n        ? \"nd\"\n        : rem10 === 3 && rem100 !== 13\n          ? \"rd\"\n          : \"th\";\n  return `${String(n)}${suffix}`;\n}\n\nfunction formatTime(hour: number, minute: number, locale?: string): string {\n  // Formatted in UTC from a UTC instant, so the runtime zone cannot shift it.\n  return new Intl.DateTimeFormat(locale, {\n    hour: \"2-digit\",\n    minute: \"2-digit\",\n    timeZone: \"UTC\",\n  }).format(Date.UTC(2026, 0, 1, hour, minute));\n}\n\nfunction dayName(index: number, locale?: string): string {\n  // 4 January 2026 is a Sunday.\n  return new Intl.DateTimeFormat(locale, { weekday: \"long\" }).format(\n    new Date(2026, 0, 4 + index),\n  );\n}\n\nfunction monthName(index: number, locale?: string): string {\n  return new Intl.DateTimeFormat(locale, { month: \"long\" }).format(\n    new Date(2026, index - 1, 1),\n  );\n}\n\n/**\n * The schedule in a sentence.\n *\n * Every product that has this control renders \"Every Monday at 09:00\" beside\n * the expression, because `0 9 * * 1` is not something most people can read.\n * Throws for an invalid expression; the editor turns that into the field's\n * error text.\n */\nexport function describeCron(expression: string, options: DescribeOptions = {}): string {\n  const { locale } = options;\n  const schedule = parseCron(expression);\n  const [minuteText = \"\", hourText = \"\", dayText = \"\", monthText = \"\"] =\n    schedule.expression.split(\" \");\n\n  const every = (label: string, n: number) =>\n    n === 1 ? `every ${label}` : `every ${ordinal(n)} ${label}`;\n\n  // Time of day.\n  let time: string;\n  const minuteStep = stepOf(minuteText);\n  const hourStep = stepOf(hourText);\n  const allMinutes = minuteText === \"*\";\n  const allHours = hourText === \"*\";\n\n  if (allMinutes && allHours) {\n    time = \"Every minute\";\n  } else if (minuteStep !== null && allHours) {\n    time = `Every ${minuteStep === 1 ? \"minute\" : `${String(minuteStep)} minutes`}`;\n  } else if (allMinutes) {\n    time = `Every minute of ${listOf(\n      schedule.hours.map((h) => formatTime(h, 0, locale)),\n      isConsecutive(schedule.hours),\n    )}`;\n  } else if (allHours || hourStep !== null) {\n    const hours = hourStep !== null && hourStep > 1 ? every(\"hour\", hourStep) : \"every hour\";\n    if (minuteStep !== null) {\n      time = `Every ${String(minuteStep)} minutes of ${hours}`;\n    } else {\n      time = `At minute ${listOf(schedule.minutes.map(String), isConsecutive(schedule.minutes))} past ${hours}`;\n    }\n  } else if (minuteStep !== null) {\n    time = `Every ${String(minuteStep)} minutes during ${listOf(\n      schedule.hours.map((h) => formatTime(h, 0, locale)),\n      isConsecutive(schedule.hours),\n    )}`;\n  } else if (schedule.minutes.length === 1) {\n    const minute = schedule.minutes[0] ?? 0;\n    time = `At ${listOf(\n      schedule.hours.map((h) => formatTime(h, minute, locale)),\n      false,\n    )}`;\n  } else {\n    time = `At minute ${listOf(schedule.minutes.map(String), isConsecutive(schedule.minutes))} past ${listOf(\n      schedule.hours.map((h) => formatTime(h, 0, locale)),\n      isConsecutive(schedule.hours),\n    )}`;\n  }\n\n  // Days. When both day fields are restricted a day matches if either does —\n  // said with \"or\", because \"and\" is what readers assume and it is wrong.\n  const dayPhrases: string[] = [];\n  if (schedule.dayOfMonthRestricted) {\n    const step = stepOf(dayText);\n    dayPhrases.push(\n      step !== null\n        ? `${every(\"day\", step)} of the month`\n        : `on day ${listOf(schedule.daysOfMonth.map(String), isConsecutive(schedule.daysOfMonth))} of the month`,\n    );\n  }\n  if (schedule.dayOfWeekRestricted) {\n    dayPhrases.push(\n      `on ${listOf(\n        schedule.daysOfWeek.map((d) => dayName(d, locale)),\n        isConsecutive(schedule.daysOfWeek),\n      )}`,\n    );\n  }\n  let days = dayPhrases.join(\", or \");\n\n  // A fixed time of day with no day named is every day. \"Every 15 minutes\"\n  // already says how often, and \"every day\" after it would be noise.\n  const fixedTime = !allMinutes && !allHours && minuteStep === null && hourStep === null;\n  if (!days && fixedTime) days = \"every day\";\n\n  if (schedule.months.length < 12) {\n    const step = stepOf(monthText);\n    const months =\n      step !== null\n        ? every(\"month\", step)\n        : listOf(\n            schedule.months.map((m) => monthName(m, locale)),\n            isConsecutive(schedule.months),\n          );\n    days = `${days ? `${days} ` : \"\"}in ${months}`;\n  }\n\n  return days ? `${time} ${days}` : time;\n}\n\n/* ------------------------------------------------------------------ */\n/*  Next runs                                                          */\n/* ------------------------------------------------------------------ */\n\nexport interface NextRunsOptions {\n  /** Runs strictly after this instant. */\n  from: Date;\n  count?: number;\n  /** IANA zone the expression's wall-clock times are in. Defaults to the runtime zone. */\n  timeZone?: string;\n}\n\ninterface WallClock {\n  year: number;\n  month: number;\n  day: number;\n  hour: number;\n  minute: number;\n  /** 0 = Sunday. */\n  weekday: number;\n}\n\nconst formatters = new Map<string, Intl.DateTimeFormat>();\n\nfunction formatterFor(timeZone: string | undefined): Intl.DateTimeFormat {\n  const key = timeZone ?? \"\";\n  let formatter = formatters.get(key);\n  if (!formatter) {\n    formatter = new Intl.DateTimeFormat(\"en-US\", {\n      timeZone,\n      hourCycle: \"h23\",\n      year: \"numeric\",\n      month: \"numeric\",\n      day: \"numeric\",\n      hour: \"numeric\",\n      minute: \"numeric\",\n      weekday: \"short\",\n    });\n    formatters.set(key, formatter);\n  }\n  return formatter;\n}\n\nfunction wallClockOf(instant: number, timeZone: string | undefined): WallClock {\n  const parts: Record<string, string> = {};\n  for (const part of formatterFor(timeZone).formatToParts(new Date(instant))) {\n    parts[part.type] = part.value;\n  }\n  return {\n    year: Number(parts.year),\n    month: Number(parts.month),\n    day: Number(parts.day),\n    hour: Number(parts.hour) % 24,\n    minute: Number(parts.minute),\n    weekday: DAY_NAMES.indexOf((parts.weekday ?? \"\").slice(0, 3).toUpperCase()),\n  };\n}\n\nfunction offsetAt(instant: number, timeZone: string | undefined): number {\n  const wall = wallClockOf(instant, timeZone);\n  return (\n    Date.UTC(wall.year, wall.month - 1, wall.day, wall.hour, wall.minute) -\n    Math.floor(instant / 60_000) * 60_000\n  );\n}\n\n/**\n * The instant a wall-clock time names in a zone, or null when it names none —\n * the hour the clocks skip in spring. An ambiguous time, in the hour that\n * repeats in autumn, resolves to its first occurrence.\n */\nexport function zonedTimeToInstant(\n  year: number,\n  month: number,\n  day: number,\n  hour: number,\n  minute: number,\n  timeZone: string | undefined,\n): number | null {\n  const guess = Date.UTC(year, month - 1, day, hour, minute);\n  // Each pass corrects the guess by the offset in force at the previous\n  // answer; across a DST change the two answers are the two candidates.\n  const candidates = new Set<number>();\n  // Seeded from a day either side as well, so the offset that stopped\n  // applying an hour ago — the one that makes an autumn time ambiguous — is\n  // still tried.\n  const oneDay = 24 * 60 * 60_000;\n  for (const seed of [guess, guess - oneDay, guess + oneDay]) {\n    let instant = seed;\n    for (let pass = 0; pass < 2; pass += 1) {\n      instant = guess - offsetAt(instant, timeZone);\n      candidates.add(instant);\n    }\n  }\n  for (const candidate of [...candidates].sort((a, b) => a - b)) {\n    const wall = wallClockOf(candidate, timeZone);\n    if (\n      wall.year === year &&\n      wall.month === month &&\n      wall.day === day &&\n      wall.hour === hour &&\n      wall.minute === minute\n    ) {\n      return candidate;\n    }\n  }\n  return null;\n}\n\n/** Roughly five years of days: enough to find the 29th of February, and to give up on the 30th. */\nconst MAX_DAYS = 366 * 5;\n\n/**\n * The next `count` instants the schedule fires, in order.\n *\n * Fewer than `count` are returned when the schedule cannot produce them —\n * `0 0 30 2 *` never runs, and saying so beats a spinner.\n */\nexport function nextRuns(expression: string, options: NextRunsOptions): Date[] {\n  const { from, count = 5, timeZone } = options;\n  const schedule = parseCron(expression);\n  const runs: Date[] = [];\n\n  const start = Math.floor(from.getTime() / 60_000) * 60_000 + 60_000;\n  const months = new Set(schedule.months);\n  const daysOfMonth = new Set(schedule.daysOfMonth);\n  const daysOfWeek = new Set(schedule.daysOfWeek);\n\n  const dayMatches = (wall: WallClock): boolean => {\n    if (!months.has(wall.month)) return false;\n    const domMatch = daysOfMonth.has(wall.day);\n    const dowMatch = daysOfWeek.has(wall.weekday);\n    if (schedule.dayOfMonthRestricted && schedule.dayOfWeekRestricted)\n      return domMatch || dowMatch;\n    if (schedule.dayOfMonthRestricted) return domMatch;\n    if (schedule.dayOfWeekRestricted) return dowMatch;\n    return true;\n  };\n\n  // Walk day by day from noon, which no DST change touches, so that stepping\n  // 24 hours always lands in the next calendar day.\n  const first = wallClockOf(start, timeZone);\n  let noon = zonedTimeToInstant(first.year, first.month, first.day, 12, 0, timeZone);\n  if (noon === null) return runs;\n\n  for (let i = 0; i < MAX_DAYS && runs.length < count; i += 1, noon += 24 * 60 * 60_000) {\n    const wall = wallClockOf(noon, timeZone);\n    if (!dayMatches(wall)) continue;\n\n    for (const hour of schedule.hours) {\n      for (const minute of schedule.minutes) {\n        const instant = zonedTimeToInstant(\n          wall.year,\n          wall.month,\n          wall.day,\n          hour,\n          minute,\n          timeZone,\n        );\n        if (instant === null || instant < start) continue;\n        runs.push(new Date(instant));\n        if (runs.length >= count) return runs;\n      }\n    }\n  }\n\n  return runs;\n}\n"],"mappings":"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"}

package/dist/components/cron-editor/index.d.ts

@@ -0,0 +1,3 @@
+import { Cron, CronBuilder, CronBuilderProps, CronExpression, CronExpressionProps, CronNextRuns, CronNextRunsProps, CronProps } from "./cron-editor.js";
+import { CRON_SHORTCUTS, CronExpressionError, CronField, CronSchedule, DescribeOptions, NextRunsOptions, describeCron, isValidCron, nextRuns, parseCron, zonedTimeToInstant } from "./cron-expression.js";
+export { CRON_SHORTCUTS, Cron, CronBuilder, type CronBuilderProps, CronExpression, CronExpressionError, type CronExpressionProps, type CronField, CronNextRuns, type CronNextRunsProps, type CronProps, type CronSchedule, type DescribeOptions, type NextRunsOptions, describeCron, isValidCron, nextRuns, parseCron, zonedTimeToInstant };

package/dist/components/cron-editor/index.js

@@ -0,0 +1,3 @@
+import { CRON_SHORTCUTS, CronExpressionError, describeCron, isValidCron, nextRuns, parseCron, zonedTimeToInstant } from "./cron-expression.js";
+import { Cron, CronBuilder, CronExpression, CronNextRuns } from "./cron-editor.js";
+export { CRON_SHORTCUTS, Cron, CronBuilder, CronExpression, CronExpressionError, CronNextRuns, describeCron, isValidCron, nextRuns, parseCron, zonedTimeToInstant };

package/dist/components/cron-editor/meta.js

@@ -0,0 +1,17 @@
+import { defineMeta } from "../../registry/schema.js";
+//#region src/components/cron-editor/meta.ts
+const meta = defineMeta({
+	name: "cron-editor",
+	title: "Cron Editor",
+	description: "A schedule as a cron expression, with a plain-language reading and the next runs.",
+	category: "form",
+	status: "stable",
+	dependencies: [],
+	registryDependencies: ["input", "select"],
+	files: ["cron-expression.ts", "cron-editor.tsx"],
+	a11y: "The expression field is described by one element that holds either the plain-language reading or the reason the expression is invalid, so a reader hears the error replace the reading rather than both at once; an invalid expression is never applied. The builder's day buttons are a named group of aria-pressed toggles with the full day name as the accessible name, and the last selected day cannot be removed silently — the group says why. Days 29 to 31 say in text that shorter months skip them. Next runs are a list of time elements with machine-readable datetimes, headed by the zone they are in, because a time with no zone is the classic scheduling mistake. Nothing clock-dependent renders until the clock is known, so server and client cannot disagree."
+});
+//#endregion
+export { meta };
+
+//# sourceMappingURL=meta.js.map

package/dist/components/cron-editor/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","names":[],"sources":["../../../src/components/cron-editor/meta.ts"],"sourcesContent":["import { defineMeta } from \"@/registry/schema\";\n\nexport const meta = defineMeta({\n  name: \"cron-editor\",\n  title: \"Cron Editor\",\n  description:\n    \"A schedule as a cron expression, with a plain-language reading and the next runs.\",\n  category: \"form\",\n  status: \"stable\",\n  dependencies: [],\n  registryDependencies: [\"input\", \"select\"],\n  files: [\"cron-expression.ts\", \"cron-editor.tsx\"],\n  a11y:\n    \"The expression field is described by one element that holds either the plain-language \" +\n    \"reading or the reason the expression is invalid, so a reader hears the error replace the \" +\n    \"reading rather than both at once; an invalid expression is never applied. The builder's \" +\n    \"day buttons are a named group of aria-pressed toggles with the full day name as the \" +\n    \"accessible name, and the last selected day cannot be removed silently — the group says why. \" +\n    \"Days 29 to 31 say in text that shorter months skip them. Next runs are a list of time \" +\n    \"elements with machine-readable datetimes, headed by the zone they are in, because a time \" +\n    \"with no zone is the classic scheduling mistake. Nothing clock-dependent renders until the \" +\n    \"clock is known, so server and client cannot disagree.\",\n});\n"],"mappings":";;AAEA,MAAa,OAAO,WAAW;CAC7B,MAAM;CACN,OAAO;CACP,aACE;CACF,UAAU;CACV,QAAQ;CACR,cAAc,CAAC;CACf,sBAAsB,CAAC,SAAS,QAAQ;CACxC,OAAO,CAAC,sBAAsB,iBAAiB;CAC/C,MACE;AASJ,CAAC"}

package/dist/components/dns-record/dns-record.d.ts

@@ -0,0 +1,61 @@
+import { ComponentPropsWithRef, ReactNode } from "react";
+//#region src/components/dns-record/dns-record.d.ts
+/**
+ * "Add this record at your DNS provider."
+ *
+ * Vercel, Resend, Cloudflare, Postmark, Google Workspace and every product
+ * that verifies a domain or routes its mail draws this card by hand, and
+ * they all learn the same three things the hard way.
+ *
+ * The parts are copied separately. A provider's form has a Name field, a
+ * Type field and a Value field, so one button that copies the whole line
+ * copies something nobody can paste anywhere.
+ *
+ * The Name field is a trap. Some providers want the host relative to the
+ * zone, `_dmarc`; some want the full name, `_dmarc.acme.com`; and some take
+ * the relative form and append the zone themselves, so a full name pasted
+ * in becomes `_dmarc.acme.com.acme.com` and the check fails for a reason
+ * nobody can see. So the host is shown both ways, with the sentence that
+ * explains which to use.
+ *
+ * A failed check says what was found. "Not verified" sends people back to
+ * their provider to stare at a record that is correct and has not
+ * propagated yet; "found v=spf1 -all, expected v=spf1 include:…" sends them
+ * to the typo. And nothing found at all is said as nothing found, with how
+ * long that can take, because it is not the same as wrong.
+ */
+type DnsRecordStatus = "pending" | "checking" | "verified" | "failed";
+interface DnsHostForms {
+  /** Relative to the zone: `_dmarc`, or `@` for the zone itself. */
+  relative: string;
+  /** Fully qualified: `_dmarc.acme.com`. */
+  full: string;
+}
+/**
+ * The host both ways a provider might want it. Accepts either form and a
+ * trailing dot, so the record can be declared however the backend has it.
+ */
+declare function dnsHostForms(name: string, zone: string): DnsHostForms;
+interface DnsRecordProps extends Omit<ComponentPropsWithRef<"section">, "children"> {
+  type: string;
+  /** The host, relative or fully qualified. */
+  name: string;
+  value: string;
+  /** The zone the record belongs to. Enables the host to be shown both ways. */
+  zone?: string;
+  ttl?: number | string;
+  priority?: number;
+  /** What the record is for, in the reader's language: "Proves you own acme.com". */
+  purpose?: string;
+  status?: DnsRecordStatus;
+  /** What the check found instead, when it failed. The useful part. */
+  found?: string[];
+  checkedAt?: Date;
+  locale?: string;
+  onCheck?: () => void;
+  children?: ReactNode;
+}
+declare function DnsRecord({ className, type, name, value, zone, ttl, priority, purpose, status, found, checkedAt, locale, onCheck, children, ...props }: DnsRecordProps): import("react").JSX.Element;
+//#endregion
+export { DnsHostForms, DnsRecord, DnsRecordProps, DnsRecordStatus, dnsHostForms };
+//# sourceMappingURL=dns-record.d.ts.map

package/dist/components/dns-record/dns-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dns-record.d.ts","names":[],"sources":["../../../src/components/dns-record/dns-record.tsx"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;KAyCY;UAEK;;EAEf;;EAEA;;;;;;iBAOc,aAAa,cAAc,eAAe;UAYzC,uBAAuB,KAAK;EAC3C;;EAEA;EACA;;EAEA;EACA;EACA;;EAEA;EACA,SAAS;;EAET;EACA,YAAY;EACZ;EACA;EACA,WAAW;;iBAKG,YACd,WACA,MACA,MACA,OACA,MACA,KACA,UACA,SACA,QACA,OACA,WACA,QACA,SACA,aACG,SACF,iCAAc,IAAA"}