@dowel-ui/react 0.3.0 → 0.5.0

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

@@ -0,0 +1,493 @@
+"use client";
+import { focusRing } from "../../lib/styles.js";
+import { cn } from "../../lib/utils.js";
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "../select/select.js";
+import { Input } from "../input/input.js";
+import { CronExpressionError, describeCron, nextRuns, parseCron } from "./cron-expression.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { createContext, useContext, useId, useMemo, useState, useSyncExternalStore } from "react";
+//#region src/components/cron-editor/cron-editor.tsx
+const CronContext = createContext(null);
+function useCron(component) {
+	const context = useContext(CronContext);
+	if (!context) throw new Error(`${component} must be used inside <Cron>.`);
+	return context;
+}
+const subscribeToNothing = () => () => void 0;
+let sharedClock = null;
+const readSharedClock = () => sharedClock ??= /* @__PURE__ */ new Date();
+const readNoClock = () => null;
+function Cron({ className, value: valueProp, defaultValue = "0 9 * * 1", onValueChange, timeZone, locale, now, children, ...props }) {
+	const [uncontrolled, setUncontrolled] = useState(defaultValue);
+	const value = valueProp ?? uncontrolled;
+	const fallbackClock = useSyncExternalStore(subscribeToNothing, readSharedClock, readNoClock);
+	const clock = now ?? fallbackClock;
+	const schedule = useMemo(() => {
+		try {
+			return parseCron(value);
+		} catch {
+			return null;
+		}
+	}, [value]);
+	const context = useMemo(() => ({
+		value,
+		setValue: (expression) => {
+			setUncontrolled(expression);
+			onValueChange?.(expression);
+		},
+		schedule,
+		timeZone,
+		locale,
+		now: clock
+	}), [
+		value,
+		schedule,
+		timeZone,
+		locale,
+		clock,
+		onValueChange
+	]);
+	return /* @__PURE__ */ jsx(CronContext.Provider, {
+		value: context,
+		children: /* @__PURE__ */ jsx("div", {
+			"data-slot": "cron-editor",
+			className: cn("flex flex-col gap-4", className),
+			...props,
+			children
+		})
+	});
+}
+const FREQUENCIES = [
+	{
+		value: "minute",
+		label: "Every minute"
+	},
+	{
+		value: "hour",
+		label: "Every hour"
+	},
+	{
+		value: "day",
+		label: "Every day"
+	},
+	{
+		value: "week",
+		label: "Every week"
+	},
+	{
+		value: "month",
+		label: "Every month"
+	},
+	{
+		value: "year",
+		label: "Every year"
+	},
+	{
+		value: "custom",
+		label: "Custom"
+	}
+];
+const isNumber = (token) => /^\d+$/.test(token);
+const isStar = (token) => token === "*";
+const stepOf = (token) => /^\*\/\d+$/.test(token) ? Number(token.slice(2)) : null;
+/**
+* Which builder shape an expression fits, if any. Anything the controls
+* cannot express — every 15 minutes during office hours, say — is "custom",
+* and the expression field becomes the editor rather than the builder quietly
+* showing something else.
+*/
+function classify(schedule) {
+	const state = {
+		frequency: "custom",
+		minuteStep: 1,
+		hourStep: 1,
+		minute: 0,
+		hour: 9,
+		days: [1],
+		dayOfMonth: 1,
+		month: 1
+	};
+	if (!schedule) return state;
+	const [m = "", h = "", dom = "", mon = "", dow = ""] = schedule.expression.split(" ");
+	if (isNumber(m)) state.minute = schedule.minutes[0] ?? 0;
+	if (isNumber(h)) state.hour = schedule.hours[0] ?? 0;
+	const restStar = isStar(dom) && isStar(mon) && isStar(dow);
+	const timeFixed = isNumber(m) && isNumber(h);
+	if ((isStar(m) || stepOf(m) !== null) && isStar(h) && restStar) {
+		state.frequency = "minute";
+		state.minuteStep = stepOf(m) ?? 1;
+	} else if (isNumber(m) && (isStar(h) || stepOf(h) !== null) && restStar) {
+		state.frequency = "hour";
+		state.hourStep = stepOf(h) ?? 1;
+	} else if (timeFixed && restStar) state.frequency = "day";
+	else if (timeFixed && isStar(dom) && isStar(mon) && !dow.includes("/")) {
+		state.frequency = "week";
+		state.days = schedule.daysOfWeek;
+	} else if (timeFixed && isNumber(dom) && isStar(mon) && isStar(dow)) {
+		state.frequency = "month";
+		state.dayOfMonth = schedule.daysOfMonth[0] ?? 1;
+	} else if (timeFixed && isNumber(dom) && schedule.months.length === 1 && !/[-,/]/.test(mon) && isStar(dow)) {
+		state.frequency = "year";
+		state.dayOfMonth = schedule.daysOfMonth[0] ?? 1;
+		state.month = schedule.months[0] ?? 1;
+	}
+	return state;
+}
+/** `1,2,3,4,5` written the way people write it: `1-5`. Runs of two stay a list. */
+function compressDays(days) {
+	const sorted = [...new Set(days)].sort((a, b) => a - b);
+	const parts = [];
+	for (let i = 0; i < sorted.length;) {
+		let j = i;
+		while (j + 1 < sorted.length && sorted[j + 1] === (sorted[j] ?? 0) + 1) j += 1;
+		const first = String(sorted[i] ?? 0);
+		const last = String(sorted[j] ?? 0);
+		parts.push(j - i >= 2 ? `${first}-${last}` : j > i ? `${first},${last}` : first);
+		i = j + 1;
+	}
+	return parts.join(",");
+}
+function build(state, current) {
+	const { minute, hour, dayOfMonth, month } = state;
+	switch (state.frequency) {
+		case "minute": return `${state.minuteStep > 1 ? `*/${String(state.minuteStep)}` : "*"} * * * *`;
+		case "hour": return `${String(minute)} ${state.hourStep > 1 ? `*/${String(state.hourStep)}` : "*"} * * *`;
+		case "day": return `${String(minute)} ${String(hour)} * * *`;
+		case "week": return `${String(minute)} ${String(hour)} * * ${compressDays(state.days)}`;
+		case "month": return `${String(minute)} ${String(hour)} ${String(dayOfMonth)} * *`;
+		case "year": return `${String(minute)} ${String(hour)} ${String(dayOfMonth)} ${String(month)} *`;
+		case "custom": return current;
+	}
+}
+/** Monday first, Sunday last. */
+const WEEK = [
+	1,
+	2,
+	3,
+	4,
+	5,
+	6,
+	0
+];
+const weekdayName = (day, locale, style) => new Intl.DateTimeFormat(locale, { weekday: style }).format(new Date(2026, 0, 4 + day));
+const monthName = (month, locale) => new Intl.DateTimeFormat(locale, { month: "long" }).format(new Date(2026, month - 1, 1));
+function CronBuilder({ className, ...props }) {
+	const { value, setValue, schedule, locale } = useCron("CronBuilder");
+	const uid = useId();
+	const state = useMemo(() => classify(schedule), [schedule]);
+	const update = (patch) => {
+		setValue(build({
+			...state,
+			...patch
+		}, value));
+	};
+	const numberField = (key, label, min, max, describedBy) => /* @__PURE__ */ jsx(NumberField, {
+		id: `${uid}-${key}`,
+		label,
+		min,
+		max,
+		value: state[key],
+		describedBy,
+		onCommit: (next) => {
+			update({ [key]: next });
+		}
+	});
+	const hasTime = [
+		"day",
+		"week",
+		"month",
+		"year"
+	].includes(state.frequency);
+	const hasDayOfMonth = state.frequency === "month" || state.frequency === "year";
+	const dayHintId = `${uid}-day-hint`;
+	const daysHintId = `${uid}-days-hint`;
+	return /* @__PURE__ */ jsxs("div", {
+		"data-slot": "cron-builder",
+		"data-frequency": state.frequency,
+		className: cn("flex flex-wrap items-end gap-3", className),
+		...props,
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex flex-col gap-1.5",
+				children: [/* @__PURE__ */ jsx("label", {
+					htmlFor: `${uid}-frequency`,
+					className: "text-xs font-medium",
+					children: "Frequency"
+				}), /* @__PURE__ */ jsxs(Select, {
+					value: state.frequency,
+					onValueChange: (frequency) => {
+						update({ frequency });
+					},
+					children: [/* @__PURE__ */ jsx(SelectTrigger, {
+						id: `${uid}-frequency`,
+						className: "w-40",
+						children: /* @__PURE__ */ jsx(SelectValue, {})
+					}), /* @__PURE__ */ jsx(SelectContent, { children: FREQUENCIES.map((option) => /* @__PURE__ */ jsx(SelectItem, {
+						value: option.value,
+						children: option.label
+					}, option.value)) })]
+				})]
+			}),
+			state.frequency === "minute" ? numberField("minuteStep", "Every how many minutes", 1, 59) : null,
+			state.frequency === "hour" ? /* @__PURE__ */ jsxs(Fragment, { children: [numberField("hourStep", "Every how many hours", 1, 23), numberField("minute", "At minute", 0, 59)] }) : null,
+			hasTime ? /* @__PURE__ */ jsxs("div", {
+				className: "flex flex-col gap-1.5",
+				children: [/* @__PURE__ */ jsx("label", {
+					htmlFor: `${uid}-time`,
+					className: "text-xs font-medium",
+					children: "At"
+				}), /* @__PURE__ */ jsx(Input, {
+					id: `${uid}-time`,
+					type: "time",
+					inputSize: "sm",
+					className: "w-32",
+					value: `${String(state.hour).padStart(2, "0")}:${String(state.minute).padStart(2, "0")}`,
+					onChange: (event) => {
+						const [hour, minute] = event.target.value.split(":").map(Number);
+						if (hour === void 0 || minute === void 0 || Number.isNaN(hour) || Number.isNaN(minute)) return;
+						update({
+							hour,
+							minute
+						});
+					}
+				})]
+			}) : null,
+			state.frequency === "week" ? /* @__PURE__ */ jsxs("div", {
+				className: "flex flex-col gap-1.5",
+				children: [
+					/* @__PURE__ */ jsx("span", {
+						id: `${uid}-days-label`,
+						className: "text-xs font-medium",
+						children: "On"
+					}),
+					/* @__PURE__ */ jsx("div", {
+						role: "group",
+						"aria-labelledby": `${uid}-days-label`,
+						"aria-describedby": daysHintId,
+						className: "flex gap-1",
+						children: WEEK.map((day) => {
+							const pressed = state.days.includes(day);
+							const last = pressed && state.days.length === 1;
+							return /* @__PURE__ */ jsx("button", {
+								type: "button",
+								"aria-pressed": pressed,
+								"aria-label": weekdayName(day, locale, "long"),
+								className: cn("h-8 min-w-9 rounded-md border px-2 text-xs font-medium transition-colors", pressed ? "border-primary bg-primary text-primary-foreground" : "border-input bg-background hover:bg-accent hover:text-accent-foreground", focusRing),
+								onClick: () => {
+									if (last) return;
+									update({ days: pressed ? state.days.filter((d) => d !== day) : [...state.days, day] });
+								},
+								children: weekdayName(day, locale, "short")
+							}, day);
+						})
+					}),
+					/* @__PURE__ */ jsx("p", {
+						id: daysHintId,
+						className: "text-xs text-muted-foreground",
+						children: "Pick at least one day."
+					})
+				]
+			}) : null,
+			hasDayOfMonth ? /* @__PURE__ */ jsxs("div", {
+				className: "flex flex-col gap-1.5",
+				children: [numberField("dayOfMonth", "On day", 1, 31, state.dayOfMonth > 28 ? dayHintId : void 0), state.dayOfMonth > 28 ? /* @__PURE__ */ jsx("p", {
+					id: dayHintId,
+					"data-slot": "cron-day-hint",
+					className: "text-xs text-warning",
+					children: "Months with fewer days skip this run."
+				}) : null]
+			}) : null,
+			state.frequency === "year" ? /* @__PURE__ */ jsxs("div", {
+				className: "flex flex-col gap-1.5",
+				children: [/* @__PURE__ */ jsx("label", {
+					htmlFor: `${uid}-month`,
+					className: "text-xs font-medium",
+					children: "In"
+				}), /* @__PURE__ */ jsxs(Select, {
+					value: String(state.month),
+					onValueChange: (month) => {
+						update({ month: Number(month) });
+					},
+					children: [/* @__PURE__ */ jsx(SelectTrigger, {
+						id: `${uid}-month`,
+						className: "w-36",
+						children: /* @__PURE__ */ jsx(SelectValue, {})
+					}), /* @__PURE__ */ jsx(SelectContent, { children: Array.from({ length: 12 }, (_, index) => index + 1).map((month) => /* @__PURE__ */ jsx(SelectItem, {
+						value: String(month),
+						children: monthName(month, locale)
+					}, month)) })]
+				})]
+			}) : null,
+			state.frequency === "custom" ? /* @__PURE__ */ jsx("p", {
+				className: "text-xs text-muted-foreground",
+				children: "This schedule needs the expression. Edit it below."
+			}) : null
+		]
+	});
+}
+/**
+* A number the builder owns, with the text the reader is typing kept apart
+* from the value — so clearing the field to type a new number does not snap
+* it back to the old one after the first keystroke.
+*/
+function NumberField({ id, label, min, max, value, describedBy, onCommit }) {
+	const [draft, setDraft] = useState(String(value));
+	const [seen, setSeen] = useState(value);
+	if (seen !== value) {
+		setSeen(value);
+		setDraft(String(value));
+	}
+	return /* @__PURE__ */ jsxs("div", {
+		className: "flex flex-col gap-1.5",
+		children: [/* @__PURE__ */ jsx("label", {
+			htmlFor: id,
+			className: "text-xs font-medium",
+			children: label
+		}), /* @__PURE__ */ jsx(Input, {
+			id,
+			type: "number",
+			inputSize: "sm",
+			min,
+			max,
+			value: draft,
+			"aria-describedby": describedBy,
+			className: "w-24",
+			onChange: (event) => {
+				const text = event.target.value;
+				setDraft(text);
+				const next = Number(text);
+				if (text === "" || !Number.isInteger(next) || next < min || next > max) return;
+				if (next !== value) onCommit(next);
+			},
+			onBlur: () => {
+				if (draft !== String(value)) setDraft(String(value));
+			}
+		})]
+	});
+}
+/**
+* The expression, editable, with its reading underneath — or the reason it is
+* invalid. An invalid entry is never applied: the last valid schedule stands
+* until the field says something that parses.
+*/
+function CronExpression({ className, ...props }) {
+	const { value, setValue, locale } = useCron("CronExpression");
+	const id = useId();
+	const [draft, setDraft] = useState(value);
+	const [lastValue, setLastValue] = useState(value);
+	if (value !== lastValue) {
+		setLastValue(value);
+		setDraft(value);
+	}
+	const feedback = useMemo(() => {
+		try {
+			return {
+				text: describeCron(draft, { locale }),
+				error: null
+			};
+		} catch (thrown) {
+			return {
+				text: null,
+				error: thrown instanceof CronExpressionError ? thrown.message : "Invalid schedule."
+			};
+		}
+	}, [draft, locale]);
+	return /* @__PURE__ */ jsxs("div", {
+		"data-slot": "cron-expression",
+		className: cn("flex flex-col gap-1.5", className),
+		...props,
+		children: [
+			/* @__PURE__ */ jsx("label", {
+				htmlFor: `${id}-input`,
+				className: "text-xs font-medium",
+				children: "Expression"
+			}),
+			/* @__PURE__ */ jsx(Input, {
+				id: `${id}-input`,
+				inputSize: "sm",
+				value: draft,
+				spellCheck: false,
+				autoComplete: "off",
+				"aria-invalid": feedback.error ? true : void 0,
+				"aria-describedby": `${id}-feedback`,
+				className: "font-mono",
+				onChange: (event) => {
+					const next = event.target.value;
+					setDraft(next);
+					try {
+						parseCron(next);
+						setValue(next.trim());
+					} catch {}
+				}
+			}),
+			/* @__PURE__ */ jsx("p", {
+				id: `${id}-feedback`,
+				"data-slot": "cron-feedback",
+				className: cn("text-xs", feedback.error ? "text-destructive" : "text-muted-foreground"),
+				children: feedback.error ?? feedback.text
+			})
+		]
+	});
+}
+/**
+* When it will fire, in the zone it is defined in. The zone is in the
+* heading because a time with no zone is the classic scheduling mistake, and
+* a schedule that never runs says so rather than showing an empty list.
+*/
+function CronNextRuns({ className, count = 5, ...props }) {
+	const { value, schedule, timeZone, locale, now } = useCron("CronNextRuns");
+	const headingId = useId();
+	const runs = useMemo(() => now && schedule ? nextRuns(value, {
+		from: now,
+		count,
+		timeZone
+	}) : null, [
+		value,
+		schedule,
+		now,
+		count,
+		timeZone
+	]);
+	if (!runs) return null;
+	const format = new Intl.DateTimeFormat(locale, {
+		dateStyle: "medium",
+		timeStyle: "short",
+		timeZone
+	});
+	return /* @__PURE__ */ jsxs("div", {
+		"data-slot": "cron-next-runs",
+		className: cn("flex flex-col gap-1.5", className),
+		...props,
+		children: [/* @__PURE__ */ jsxs("p", {
+			id: headingId,
+			className: "text-xs font-medium",
+			children: [
+				"Next ",
+				count === 1 ? "run" : `${String(count)} runs`,
+				/* @__PURE__ */ jsxs("span", {
+					className: "font-normal text-muted-foreground",
+					children: [" · ", timeZone ?? "local time"]
+				})
+			]
+		}), runs.length === 0 ? /* @__PURE__ */ jsx("p", {
+			"data-slot": "cron-never",
+			className: "text-xs text-destructive",
+			children: "Never runs: no day matches this schedule."
+		}) : /* @__PURE__ */ jsxs("ol", {
+			"aria-labelledby": headingId,
+			className: "m-0 flex list-none flex-col gap-0.5 p-0 text-sm",
+			children: [runs.map((run) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx("time", {
+				dateTime: run.toISOString(),
+				className: "tabular-nums",
+				children: format.format(run)
+			}) }, run.toISOString())), runs.length < count ? /* @__PURE__ */ jsx("li", {
+				className: "text-xs text-muted-foreground",
+				children: "Then nothing within five years."
+			}) : null]
+		})]
+	});
+}
+//#endregion
+export { Cron, CronBuilder, CronExpression, CronNextRuns };
+
+//# sourceMappingURL=cron-editor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cron-editor.js","names":[],"sources":["../../../src/components/cron-editor/cron-editor.tsx"],"sourcesContent":["\"use client\";\n\nimport {\n  createContext,\n  useContext,\n  useId,\n  useMemo,\n  useState,\n  useSyncExternalStore,\n  type ComponentPropsWithRef,\n  type ReactNode,\n} from \"react\";\n\nimport { Input } from \"@/components/input\";\nimport {\n  Select,\n  SelectContent,\n  SelectItem,\n  SelectTrigger,\n  SelectValue,\n} from \"@/components/select\";\nimport { focusRing } from \"@/lib/styles\";\nimport { cn } from \"@/lib/utils\";\n\nimport {\n  CronExpressionError,\n  describeCron,\n  nextRuns,\n  parseCron,\n  type CronSchedule,\n} from \"./cron-expression\";\n\n/**\n * The \"run this nightly\" control.\n *\n * GitHub Actions, Vercel, Airflow, Sentry and every admin panel with a\n * schedule draws one by hand: a few frequency controls that write a cron\n * expression, the expression itself for anyone who can read it, the sentence\n * beside it for everyone else, and the next few runs so a mistake is visible\n * before it is saved. The packages that exist are bound to Ant Design or ship\n * their own stylesheet — see `cron-expression.ts` for the value model, which\n * is where the two mistakes every reimplementation makes actually live.\n *\n * Composed from the library's own Select and Input, and split into parts so\n * an app can show the expression and its reading without the builder, or the\n * next runs beside a saved schedule.\n */\n\ninterface CronContextValue {\n  value: string;\n  setValue: (expression: string) => void;\n  schedule: CronSchedule | null;\n  timeZone?: string;\n  locale?: string;\n  /** Null until the clock is known, which on a server render is never. */\n  now: Date | null;\n}\n\nconst CronContext = createContext<CronContextValue | null>(null);\n\nfunction useCron(component: string): CronContextValue {\n  const context = useContext(CronContext);\n  if (!context) throw new Error(`${component} must be used inside <Cron>.`);\n  return context;\n}\n\n/* The clock, for callers who did not supply one — the same arrangement as\n   time-range-picker: a null server snapshot, so nothing clock-dependent is\n   rendered until the real instant arrives after hydration. */\nconst subscribeToNothing = () => () => undefined;\nlet sharedClock: Date | null = null;\nconst readSharedClock = () => (sharedClock ??= new Date());\nconst readNoClock = () => null;\n\nexport interface CronProps extends Omit<\n  ComponentPropsWithRef<\"div\">,\n  \"defaultValue\" | \"onChange\" | \"children\"\n> {\n  /** The expression. Controlled. */\n  value?: string;\n  defaultValue?: string;\n  onValueChange?: (expression: string) => void;\n  /** IANA zone the expression's times are in. Defaults to the runtime zone. */\n  timeZone?: string;\n  locale?: string;\n  /** The instant next runs are counted from. Pass one that changes when you refresh. */\n  now?: Date;\n  children: ReactNode;\n}\n\nexport function Cron({\n  className,\n  value: valueProp,\n  defaultValue = \"0 9 * * 1\",\n  onValueChange,\n  timeZone,\n  locale,\n  now,\n  children,\n  ...props\n}: CronProps) {\n  const [uncontrolled, setUncontrolled] = useState(defaultValue);\n  const value = valueProp ?? uncontrolled;\n\n  const fallbackClock = useSyncExternalStore(subscribeToNothing, readSharedClock, readNoClock);\n  const clock = now ?? fallbackClock;\n\n  const schedule = useMemo(() => {\n    try {\n      return parseCron(value);\n    } catch {\n      return null;\n    }\n  }, [value]);\n\n  const context = useMemo<CronContextValue>(\n    () => ({\n      value,\n      setValue: (expression) => {\n        setUncontrolled(expression);\n        onValueChange?.(expression);\n      },\n      schedule,\n      timeZone,\n      locale,\n      now: clock,\n    }),\n    [value, schedule, timeZone, locale, clock, onValueChange],\n  );\n\n  return (\n    <CronContext.Provider value={context}>\n      <div data-slot=\"cron-editor\" className={cn(\"flex flex-col gap-4\", className)} {...props}>\n        {children}\n      </div>\n    </CronContext.Provider>\n  );\n}\n\n/* ------------------------------------------------------------------ */\n/*  Builder                                                            */\n/* ------------------------------------------------------------------ */\n\ntype Frequency = \"minute\" | \"hour\" | \"day\" | \"week\" | \"month\" | \"year\" | \"custom\";\n\nconst FREQUENCIES: { value: Frequency; label: string }[] = [\n  { value: \"minute\", label: \"Every minute\" },\n  { value: \"hour\", label: \"Every hour\" },\n  { value: \"day\", label: \"Every day\" },\n  { value: \"week\", label: \"Every week\" },\n  { value: \"month\", label: \"Every month\" },\n  { value: \"year\", label: \"Every year\" },\n  { value: \"custom\", label: \"Custom\" },\n];\n\ninterface BuilderState {\n  frequency: Frequency;\n  minuteStep: number;\n  hourStep: number;\n  minute: number;\n  hour: number;\n  /** 0 = Sunday. */\n  days: number[];\n  dayOfMonth: number;\n  month: number;\n}\n\nconst isNumber = (token: string) => /^\\d+$/.test(token);\nconst isStar = (token: string) => token === \"*\";\nconst stepOf = (token: string) => (/^\\*\\/\\d+$/.test(token) ? Number(token.slice(2)) : null);\n\n/**\n * Which builder shape an expression fits, if any. Anything the controls\n * cannot express — every 15 minutes during office hours, say — is \"custom\",\n * and the expression field becomes the editor rather than the builder quietly\n * showing something else.\n */\nfunction classify(schedule: CronSchedule | null): BuilderState {\n  const state: BuilderState = {\n    frequency: \"custom\",\n    minuteStep: 1,\n    hourStep: 1,\n    minute: 0,\n    hour: 9,\n    days: [1],\n    dayOfMonth: 1,\n    month: 1,\n  };\n  if (!schedule) return state;\n\n  const [m = \"\", h = \"\", dom = \"\", mon = \"\", dow = \"\"] = schedule.expression.split(\" \");\n  if (isNumber(m)) state.minute = schedule.minutes[0] ?? 0;\n  if (isNumber(h)) state.hour = schedule.hours[0] ?? 0;\n\n  const restStar = isStar(dom) && isStar(mon) && isStar(dow);\n  const timeFixed = isNumber(m) && isNumber(h);\n\n  if ((isStar(m) || stepOf(m) !== null) && isStar(h) && restStar) {\n    state.frequency = \"minute\";\n    state.minuteStep = stepOf(m) ?? 1;\n  } else if (isNumber(m) && (isStar(h) || stepOf(h) !== null) && restStar) {\n    state.frequency = \"hour\";\n    state.hourStep = stepOf(h) ?? 1;\n  } else if (timeFixed && restStar) {\n    state.frequency = \"day\";\n  } else if (timeFixed && isStar(dom) && isStar(mon) && !dow.includes(\"/\")) {\n    state.frequency = \"week\";\n    state.days = schedule.daysOfWeek;\n  } else if (timeFixed && isNumber(dom) && isStar(mon) && isStar(dow)) {\n    state.frequency = \"month\";\n    state.dayOfMonth = schedule.daysOfMonth[0] ?? 1;\n  } else if (\n    timeFixed &&\n    isNumber(dom) &&\n    schedule.months.length === 1 &&\n    !/[-,/]/.test(mon) &&\n    isStar(dow)\n  ) {\n    state.frequency = \"year\";\n    state.dayOfMonth = schedule.daysOfMonth[0] ?? 1;\n    state.month = schedule.months[0] ?? 1;\n  }\n  return state;\n}\n\n/** `1,2,3,4,5` written the way people write it: `1-5`. Runs of two stay a list. */\nfunction compressDays(days: number[]): string {\n  const sorted = [...new Set(days)].sort((a, b) => a - b);\n  const parts: string[] = [];\n  for (let i = 0; i < sorted.length;) {\n    let j = i;\n    while (j + 1 < sorted.length && sorted[j + 1] === (sorted[j] ?? 0) + 1) j += 1;\n    const first = String(sorted[i] ?? 0);\n    const last = String(sorted[j] ?? 0);\n    parts.push(j - i >= 2 ? `${first}-${last}` : j > i ? `${first},${last}` : first);\n    i = j + 1;\n  }\n  return parts.join(\",\");\n}\n\nfunction build(state: BuilderState, current: string): string {\n  const { minute, hour, dayOfMonth, month } = state;\n  switch (state.frequency) {\n    case \"minute\":\n      return `${state.minuteStep > 1 ? `*/${String(state.minuteStep)}` : \"*\"} * * * *`;\n    case \"hour\":\n      return `${String(minute)} ${state.hourStep > 1 ? `*/${String(state.hourStep)}` : \"*\"} * * *`;\n    case \"day\":\n      return `${String(minute)} ${String(hour)} * * *`;\n    case \"week\":\n      return `${String(minute)} ${String(hour)} * * ${compressDays(state.days)}`;\n    case \"month\":\n      return `${String(minute)} ${String(hour)} ${String(dayOfMonth)} * *`;\n    case \"year\":\n      return `${String(minute)} ${String(hour)} ${String(dayOfMonth)} ${String(month)} *`;\n    case \"custom\":\n      return current;\n  }\n}\n\n/** Monday first, Sunday last. */\nconst WEEK = [1, 2, 3, 4, 5, 6, 0];\n// 4 January 2026 is a Sunday; 1 January 2026 is in month 1.\nconst weekdayName = (day: number, locale: string | undefined, style: \"long\" | \"short\") =>\n  new Intl.DateTimeFormat(locale, { weekday: style }).format(new Date(2026, 0, 4 + day));\nconst monthName = (month: number, locale: string | undefined) =>\n  new Intl.DateTimeFormat(locale, { month: \"long\" }).format(new Date(2026, month - 1, 1));\n\nexport type CronBuilderProps = Omit<ComponentPropsWithRef<\"div\">, \"children\">;\n\nexport function CronBuilder({ className, ...props }: CronBuilderProps) {\n  const { value, setValue, schedule, locale } = useCron(\"CronBuilder\");\n  const uid = useId();\n  const state = useMemo(() => classify(schedule), [schedule]);\n\n  const update = (patch: Partial<BuilderState>) => {\n    setValue(build({ ...state, ...patch }, value));\n  };\n\n  const numberField = (\n    key: \"minuteStep\" | \"hourStep\" | \"minute\" | \"dayOfMonth\",\n    label: string,\n    min: number,\n    max: number,\n    describedBy?: string,\n  ) => (\n    <NumberField\n      id={`${uid}-${key}`}\n      label={label}\n      min={min}\n      max={max}\n      value={state[key]}\n      describedBy={describedBy}\n      onCommit={(next) => {\n        update({ [key]: next });\n      }}\n    />\n  );\n\n  const hasTime = [\"day\", \"week\", \"month\", \"year\"].includes(state.frequency);\n  const hasDayOfMonth = state.frequency === \"month\" || state.frequency === \"year\";\n  const dayHintId = `${uid}-day-hint`;\n  const daysHintId = `${uid}-days-hint`;\n\n  return (\n    <div\n      data-slot=\"cron-builder\"\n      data-frequency={state.frequency}\n      className={cn(\"flex flex-wrap items-end gap-3\", className)}\n      {...props}\n    >\n      <div className=\"flex flex-col gap-1.5\">\n        <label htmlFor={`${uid}-frequency`} className=\"text-xs font-medium\">\n          Frequency\n        </label>\n        <Select\n          value={state.frequency}\n          onValueChange={(frequency) => {\n            update({ frequency: frequency as Frequency });\n          }}\n        >\n          <SelectTrigger id={`${uid}-frequency`} className=\"w-40\">\n            <SelectValue />\n          </SelectTrigger>\n          <SelectContent>\n            {FREQUENCIES.map((option) => (\n              <SelectItem key={option.value} value={option.value}>\n                {option.label}\n              </SelectItem>\n            ))}\n          </SelectContent>\n        </Select>\n      </div>\n\n      {state.frequency === \"minute\"\n        ? numberField(\"minuteStep\", \"Every how many minutes\", 1, 59)\n        : null}\n\n      {state.frequency === \"hour\" ? (\n        <>\n          {numberField(\"hourStep\", \"Every how many hours\", 1, 23)}\n          {numberField(\"minute\", \"At minute\", 0, 59)}\n        </>\n      ) : null}\n\n      {hasTime ? (\n        <div className=\"flex flex-col gap-1.5\">\n          <label htmlFor={`${uid}-time`} className=\"text-xs font-medium\">\n            At\n          </label>\n          <Input\n            id={`${uid}-time`}\n            type=\"time\"\n            inputSize=\"sm\"\n            className=\"w-32\"\n            value={`${String(state.hour).padStart(2, \"0\")}:${String(state.minute).padStart(2, \"0\")}`}\n            onChange={(event) => {\n              const [hour, minute] = event.target.value.split(\":\").map(Number);\n              if (\n                hour === undefined ||\n                minute === undefined ||\n                Number.isNaN(hour) ||\n                Number.isNaN(minute)\n              ) {\n                return;\n              }\n              update({ hour, minute });\n            }}\n          />\n        </div>\n      ) : null}\n\n      {state.frequency === \"week\" ? (\n        <div className=\"flex flex-col gap-1.5\">\n          <span id={`${uid}-days-label`} className=\"text-xs font-medium\">\n            On\n          </span>\n          <div\n            role=\"group\"\n            aria-labelledby={`${uid}-days-label`}\n            aria-describedby={daysHintId}\n            className=\"flex gap-1\"\n          >\n            {WEEK.map((day) => {\n              const pressed = state.days.includes(day);\n              const last = pressed && state.days.length === 1;\n              return (\n                <button\n                  key={day}\n                  type=\"button\"\n                  aria-pressed={pressed}\n                  aria-label={weekdayName(day, locale, \"long\")}\n                  className={cn(\n                    \"h-8 min-w-9 rounded-md border px-2 text-xs font-medium transition-colors\",\n                    pressed\n                      ? \"border-primary bg-primary text-primary-foreground\"\n                      : \"border-input bg-background hover:bg-accent hover:text-accent-foreground\",\n                    focusRing,\n                  )}\n                  onClick={() => {\n                    // The last day stays: a week schedule with no day is not a\n                    // schedule. The group's description says so, so the refusal\n                    // is not silent.\n                    if (last) return;\n                    update({\n                      days: pressed\n                        ? state.days.filter((d) => d !== day)\n                        : [...state.days, day],\n                    });\n                  }}\n                >\n                  {weekdayName(day, locale, \"short\")}\n                </button>\n              );\n            })}\n          </div>\n          <p id={daysHintId} className=\"text-xs text-muted-foreground\">\n            Pick at least one day.\n          </p>\n        </div>\n      ) : null}\n\n      {hasDayOfMonth ? (\n        <div className=\"flex flex-col gap-1.5\">\n          {numberField(\n            \"dayOfMonth\",\n            \"On day\",\n            1,\n            31,\n            state.dayOfMonth > 28 ? dayHintId : undefined,\n          )}\n          {state.dayOfMonth > 28 ? (\n            <p id={dayHintId} data-slot=\"cron-day-hint\" className=\"text-xs text-warning\">\n              Months with fewer days skip this run.\n            </p>\n          ) : null}\n        </div>\n      ) : null}\n\n      {state.frequency === \"year\" ? (\n        <div className=\"flex flex-col gap-1.5\">\n          <label htmlFor={`${uid}-month`} className=\"text-xs font-medium\">\n            In\n          </label>\n          <Select\n            value={String(state.month)}\n            onValueChange={(month) => {\n              update({ month: Number(month) });\n            }}\n          >\n            <SelectTrigger id={`${uid}-month`} className=\"w-36\">\n              <SelectValue />\n            </SelectTrigger>\n            <SelectContent>\n              {Array.from({ length: 12 }, (_, index) => index + 1).map((month) => (\n                <SelectItem key={month} value={String(month)}>\n                  {monthName(month, locale)}\n                </SelectItem>\n              ))}\n            </SelectContent>\n          </Select>\n        </div>\n      ) : null}\n\n      {state.frequency === \"custom\" ? (\n        <p className=\"text-xs text-muted-foreground\">\n          This schedule needs the expression. Edit it below.\n        </p>\n      ) : null}\n    </div>\n  );\n}\n\n/**\n * A number the builder owns, with the text the reader is typing kept apart\n * from the value — so clearing the field to type a new number does not snap\n * it back to the old one after the first keystroke.\n */\nfunction NumberField({\n  id,\n  label,\n  min,\n  max,\n  value,\n  describedBy,\n  onCommit,\n}: {\n  id: string;\n  label: string;\n  min: number;\n  max: number;\n  value: number;\n  describedBy?: string;\n  onCommit: (value: number) => void;\n}) {\n  const [draft, setDraft] = useState(String(value));\n  const [seen, setSeen] = useState(value);\n  if (seen !== value) {\n    setSeen(value);\n    setDraft(String(value));\n  }\n\n  return (\n    <div className=\"flex flex-col gap-1.5\">\n      <label htmlFor={id} className=\"text-xs font-medium\">\n        {label}\n      </label>\n      <Input\n        id={id}\n        type=\"number\"\n        inputSize=\"sm\"\n        min={min}\n        max={max}\n        value={draft}\n        aria-describedby={describedBy}\n        className=\"w-24\"\n        onChange={(event) => {\n          const text = event.target.value;\n          setDraft(text);\n          const next = Number(text);\n          if (text === \"\" || !Number.isInteger(next) || next < min || next > max) return;\n          if (next !== value) onCommit(next);\n        }}\n        onBlur={() => {\n          // Whatever was left half-typed goes back to the value in force.\n          if (draft !== String(value)) setDraft(String(value));\n        }}\n      />\n    </div>\n  );\n}\n\n/* ------------------------------------------------------------------ */\n/*  Expression                                                         */\n/* ------------------------------------------------------------------ */\n\nexport type CronExpressionProps = Omit<ComponentPropsWithRef<\"div\">, \"children\">;\n\n/**\n * The expression, editable, with its reading underneath — or the reason it is\n * invalid. An invalid entry is never applied: the last valid schedule stands\n * until the field says something that parses.\n */\nexport function CronExpression({ className, ...props }: CronExpressionProps) {\n  const { value, setValue, locale } = useCron(\"CronExpression\");\n  const id = useId();\n\n  const [draft, setDraft] = useState(value);\n  // The value can change under the field — the builder, or the consumer.\n  const [lastValue, setLastValue] = useState(value);\n  if (value !== lastValue) {\n    setLastValue(value);\n    setDraft(value);\n  }\n\n  const feedback = useMemo(() => {\n    try {\n      return { text: describeCron(draft, { locale }), error: null as string | null };\n    } catch (thrown) {\n      return {\n        text: null,\n        error: thrown instanceof CronExpressionError ? thrown.message : \"Invalid schedule.\",\n      };\n    }\n  }, [draft, locale]);\n\n  return (\n    <div\n      data-slot=\"cron-expression\"\n      className={cn(\"flex flex-col gap-1.5\", className)}\n      {...props}\n    >\n      <label htmlFor={`${id}-input`} className=\"text-xs font-medium\">\n        Expression\n      </label>\n      <Input\n        id={`${id}-input`}\n        inputSize=\"sm\"\n        value={draft}\n        spellCheck={false}\n        autoComplete=\"off\"\n        aria-invalid={feedback.error ? true : undefined}\n        aria-describedby={`${id}-feedback`}\n        className=\"font-mono\"\n        onChange={(event) => {\n          const next = event.target.value;\n          setDraft(next);\n          try {\n            parseCron(next);\n            setValue(next.trim());\n          } catch {\n            // Said in the feedback; the last valid schedule stands.\n          }\n        }}\n      />\n      {/* One element for both, so a reader hears the error replace the\n          reading rather than both at once. */}\n      <p\n        id={`${id}-feedback`}\n        data-slot=\"cron-feedback\"\n        className={cn(\"text-xs\", feedback.error ? \"text-destructive\" : \"text-muted-foreground\")}\n      >\n        {feedback.error ?? feedback.text}\n      </p>\n    </div>\n  );\n}\n\n/* ------------------------------------------------------------------ */\n/*  Next runs                                                          */\n/* ------------------------------------------------------------------ */\n\nexport interface CronNextRunsProps extends Omit<ComponentPropsWithRef<\"div\">, \"children\"> {\n  count?: number;\n}\n\n/**\n * When it will fire, in the zone it is defined in. The zone is in the\n * heading because a time with no zone is the classic scheduling mistake, and\n * a schedule that never runs says so rather than showing an empty list.\n */\nexport function CronNextRuns({ className, count = 5, ...props }: CronNextRunsProps) {\n  const { value, schedule, timeZone, locale, now } = useCron(\"CronNextRuns\");\n  const headingId = useId();\n\n  const runs = useMemo(\n    () => (now && schedule ? nextRuns(value, { from: now, count, timeZone }) : null),\n    [value, schedule, now, count, timeZone],\n  );\n\n  // Nothing clock-dependent before the clock is known.\n  if (!runs) return null;\n\n  const format = new Intl.DateTimeFormat(locale, {\n    dateStyle: \"medium\",\n    timeStyle: \"short\",\n    timeZone,\n  });\n\n  return (\n    <div\n      data-slot=\"cron-next-runs\"\n      className={cn(\"flex flex-col gap-1.5\", className)}\n      {...props}\n    >\n      <p id={headingId} className=\"text-xs font-medium\">\n        Next {count === 1 ? \"run\" : `${String(count)} runs`}\n        <span className=\"font-normal text-muted-foreground\">\n          {\" · \"}\n          {timeZone ?? \"local time\"}\n        </span>\n      </p>\n      {runs.length === 0 ? (\n        <p data-slot=\"cron-never\" className=\"text-xs text-destructive\">\n          Never runs: no day matches this schedule.\n        </p>\n      ) : (\n        <ol\n          aria-labelledby={headingId}\n          className=\"m-0 flex list-none flex-col gap-0.5 p-0 text-sm\"\n        >\n          {runs.map((run) => (\n            <li key={run.toISOString()}>\n              <time dateTime={run.toISOString()} className=\"tabular-nums\">\n                {format.format(run)}\n              </time>\n            </li>\n          ))}\n          {runs.length < count ? (\n            <li className=\"text-xs text-muted-foreground\">Then nothing within five years.</li>\n          ) : null}\n        </ol>\n      )}\n    </div>\n  );\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,82 @@
+//#region src/components/cron-editor/cron-expression.d.ts
+/**
+ * The five-field cron expression, as a value: parsed, described in words, and
+ * projected onto a calendar in a named time zone.
+ *
+ * The dialect is the POSIX one — minute, hour, day of month, month, day of
+ * week — which is what crontab, GitHub Actions, Vercel, Kubernetes and Airflow
+ * all read. Not the Quartz one: no seconds field and no `L`, `W` or `#`,
+ * because the products people schedule from a form do not accept them, and an
+ * expression this editor produces has to run where it is pasted. The `@daily`
+ * family of shortcuts is accepted, since crontab accepts it.
+ *
+ * Everything here is pure and takes its clock as an argument, so the
+ * description, the run times and the two things every reimplementation gets
+ * wrong — day-of-month OR day-of-week, and a wall-clock time that does not
+ * exist on the day the clocks go forward — are tested without rendering
+ * anything, and an application can compute the next run on the server from
+ * the same expression the editor produced.
+ */
+type CronField = "minute" | "hour" | "dayOfMonth" | "month" | "dayOfWeek";
+declare class CronExpressionError extends Error {
+  /** Which of the five fields is wrong, when one is. */
+  readonly field?: CronField | undefined;
+  constructor(message: string,
+  /** Which of the five fields is wrong, when one is. */
+  field?: CronField | undefined);
+}
+interface CronSchedule {
+  minutes: number[];
+  hours: number[];
+  daysOfMonth: number[];
+  months: number[];
+  /** 0 to 6, Sunday first. `7` in the source is folded into 0. */
+  daysOfWeek: number[];
+  /**
+   * Whether each day field was written as something other than `*`. Cron's
+   * rule, which every reimplementation gets wrong at least once: when both are
+   * restricted a day matches if EITHER does, not both.
+   */
+  dayOfMonthRestricted: boolean;
+  dayOfWeekRestricted: boolean;
+  /** The expression with any shortcut expanded. */
+  expression: string;
+}
+declare const CRON_SHORTCUTS: Record<string, string>;
+declare function parseCron(expression: string): CronSchedule;
+declare function isValidCron(expression: string): boolean;
+interface DescribeOptions {
+  locale?: string;
+}
+/**
+ * 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.
+ */
+declare function describeCron(expression: string, options?: DescribeOptions): string;
+interface NextRunsOptions {
+  /** Runs strictly after this instant. */
+  from: Date;
+  count?: number;
+  /** IANA zone the expression's wall-clock times are in. Defaults to the runtime zone. */
+  timeZone?: string;
+}
+/**
+ * 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.
+ */
+declare function zonedTimeToInstant(year: number, month: number, day: number, hour: number, minute: number, timeZone: string | undefined): number | null;
+/**
+ * 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.
+ */
+declare function nextRuns(expression: string, options: NextRunsOptions): Date[];
+//#endregion
+export { CRON_SHORTCUTS, CronExpressionError, CronField, CronSchedule, DescribeOptions, NextRunsOptions, describeCron, isValidCron, nextRuns, parseCron, zonedTimeToInstant };
+//# sourceMappingURL=cron-expression.d.ts.map

package/dist/components/cron-editor/cron-expression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-expression.d.ts","names":[],"sources":["../../../src/components/cron-editor/cron-expression.ts"],"mappings":";;;;;;;;;;;;;;;;;;;KAmBY;cAEC,4BAA4B;;WAIrB,QAAQ;EAFxB,YAAA,iBAEgB;;EAAA,QAAQ;;UAOX;EACf;EACA;EACA;EACA;;EAEA;;;;;;EAMA;EACA;;EAEA;;cA6BW,gBAAgB;iBAwGb,UAAU,qBAAqB;iBAkC/B,YAAY;UAaX;EACf;;;;;;;;;;iBAiEc,aAAa,oBAAoB,UAAS;UA+FzC;;EAEf,MAAM;EACN;;EAEA;;;;;;;iBA8Dc,mBACd,cACA,eACA,aACA,cACA,gBACA;;;;;;;iBAyCc,SAAS,oBAAoB,SAAS,kBAAkB"}