@stigmer/react 3.5.2 → 3.6.0

package/schedule/ScheduleForm.js

@@ -0,0 +1,129 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useState } from "react";
+import { cn } from "@stigmer/theme";
+import { getUserMessage } from "@stigmer/sdk";
+import { Popover } from "@base-ui/react/popover";
+import { AgentPicker } from "../agent/AgentPicker.js";
+import { Switch } from "../switch/Switch.js";
+import { useStigmerPortalContainer } from "../portal-container.js";
+import { CadenceField } from "./CadenceField.js";
+import { TimeZoneField, browserTimeZone } from "./TimeZoneField.js";
+import { useCreateSchedule } from "./useCreateSchedule.js";
+import { cadenceToCron, validateCron } from "./cadence.js";
+/** spec.proto pins AgentTarget.message to 8192 characters. */
+const MESSAGE_MAX_LEN = 8192;
+/** Show the remaining-characters counter once within this margin. */
+const MESSAGE_COUNTER_THRESHOLD = 500;
+/**
+ * Single-page form for creating a {@link Schedule}.
+ *
+ * Collects the four things a user decides about a schedule — which
+ * agent, what message, when ({@link CadenceField}, generating the cron
+ * expression from human-friendly presets), and whether it starts
+ * enabled — then creates it via {@link useCreateSchedule}.
+ *
+ * Enabled defaults to OFF, deliberately: it matches the proto/YAML
+ * default (an omitted `enabled` is false) and the platform's
+ * recommended workflow — create staged-disabled, validate with
+ * "Run now" on the detail page, then enable.
+ *
+ * Creation only. Editing an existing schedule must not flow through
+ * this form's curated input — see the note on {@link useCreateSchedule}.
+ *
+ * @example
+ * ```tsx
+ * <ScheduleForm
+ *   org="acme"
+ *   onComplete={(s) => navigate(`/library/schedules/${s.metadata?.org}/${s.metadata?.slug}`)}
+ *   onCancel={() => navigate("/library/schedules")}
+ * />
+ * ```
+ */
+export function ScheduleForm({ org, onComplete, onCancel, className, }) {
+    const { create, isCreating, error, clearError } = useCreateSchedule();
+    const [name, setName] = useState("");
+    const [agentRef, setAgentRef] = useState(null);
+    const [agentName, setAgentName] = useState(null);
+    const [message, setMessage] = useState("");
+    const [cadence, setCadence] = useState({
+        kind: "daily",
+        hour: 9,
+        minute: 0,
+    });
+    const [timeZone, setTimeZone] = useState(browserTimeZone);
+    const [enabled, setEnabled] = useState(false);
+    const [pickerOpen, setPickerOpen] = useState(false);
+    const trimmedName = name.trim();
+    const trimmedMessage = message.trim();
+    const cron = cadenceToCron(cadence).trim();
+    const cronValid = cron !== "" && validateCron(cron) === null;
+    const canSubmit = trimmedName !== "" &&
+        agentRef !== null &&
+        trimmedMessage !== "" &&
+        cronValid &&
+        !isCreating;
+    const handleAgentChange = useCallback((ref) => {
+        setAgentRef(ref);
+        if (ref === null)
+            setAgentName(null);
+        setPickerOpen(false);
+    }, []);
+    const handleSubmit = useCallback(async (e) => {
+        e.preventDefault();
+        if (!canSubmit || !agentRef)
+            return;
+        clearError();
+        try {
+            const schedule = await create({
+                name: trimmedName,
+                org,
+                cron,
+                timeZone,
+                enabled,
+                agent: { agentRef, message: trimmedMessage },
+            });
+            onComplete?.(schedule);
+        }
+        catch {
+            // error state is managed by useCreateSchedule
+        }
+    }, [
+        canSubmit,
+        agentRef,
+        clearError,
+        create,
+        trimmedName,
+        org,
+        cron,
+        timeZone,
+        enabled,
+        trimmedMessage,
+        onComplete,
+    ]);
+    const remaining = MESSAGE_MAX_LEN - message.length;
+    return (_jsxs("form", { onSubmit: handleSubmit, className: cn("max-w-2xl space-y-5", className), "aria-label": "New schedule", children: [_jsxs("div", { className: "space-y-1", children: [_jsx("label", { htmlFor: "stgm-new-schedule-name", className: labelClasses, children: "Name" }), _jsx("input", { id: "stgm-new-schedule-name", type: "text", value: name, onChange: (e) => setName(e.target.value), placeholder: "e.g. daily-fee-reminders", disabled: isCreating, autoFocus: true, required: true, className: inputClasses })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("span", { id: "stgm-new-schedule-agent-label", className: labelClasses, children: "Agent to run" }), _jsxs(Popover.Root, { open: pickerOpen, onOpenChange: setPickerOpen, children: [_jsxs(Popover.Trigger, { disabled: isCreating, "aria-labelledby": "stgm-new-schedule-agent-label", className: cn("flex w-full items-center justify-between rounded-md border border-input bg-background px-2.5 py-1.5 text-left text-xs", "focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring", "disabled:pointer-events-none disabled:opacity-50", agentRef ? "text-foreground" : "text-muted-foreground"), children: [_jsx("span", { className: "truncate", children: agentRef
+                                            ? (agentName ?? `${agentRef.org}/${agentRef.slug}`)
+                                            : "Choose an agent…" }), _jsx(ChevronIcon, {})] }), _jsx(AgentPickerPopup, { org: org, value: agentRef, onChange: handleAgentChange, onDisplayNameResolved: (_key, resolvedName) => setAgentName(resolvedName), disabled: isCreating })] }), _jsxs("p", { className: hintClasses, children: ["Each fire runs this agent unattended in a fresh session. Only agents in ", _jsx("span", { className: "font-medium", children: org }), " can be scheduled."] })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("label", { htmlFor: "stgm-new-schedule-message", className: labelClasses, children: "Message" }), _jsx("textarea", { id: "stgm-new-schedule-message", value: message, onChange: (e) => setMessage(e.target.value), placeholder: "The instruction the agent receives on every fire \u2014 write it for a run with no human present.", disabled: isCreating, required: true, rows: 5, maxLength: MESSAGE_MAX_LEN, className: cn(inputClasses, "resize-y") }), remaining <= MESSAGE_COUNTER_THRESHOLD && (_jsxs("p", { className: hintClasses, children: [remaining, " characters left"] }))] }), _jsxs("div", { className: "space-y-1", children: [_jsx("span", { className: labelClasses, children: "Runs" }), _jsx(CadenceField, { value: cadence, onChange: setCadence, timeZone: timeZone, disabled: isCreating })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("label", { htmlFor: "stgm-new-schedule-tz", className: labelClasses, children: "Time zone" }), _jsx(TimeZoneField, { id: "stgm-new-schedule-tz", value: timeZone, onChange: setTimeZone, disabled: isCreating })] }), _jsxs("div", { className: "flex items-start gap-3", children: [_jsx(Switch, { id: "stgm-new-schedule-enabled", checked: enabled, onCheckedChange: setEnabled, disabled: isCreating, "aria-labelledby": "stgm-new-schedule-enabled-label" }), _jsxs("div", { className: "space-y-0.5", children: [_jsx("label", { id: "stgm-new-schedule-enabled-label", htmlFor: "stgm-new-schedule-enabled", className: labelClasses, children: "Enabled" }), _jsx("p", { className: hintClasses, children: "Leave off to create the schedule staged: validate it with \u201CRun now\u201D on the schedule page, then enable it there." })] })] }), error && (_jsx("p", { className: "text-xs text-destructive", role: "alert", children: getUserMessage(error) })), _jsxs("div", { className: "flex items-center gap-2", children: [_jsxs("button", { type: "submit", disabled: !canSubmit, className: cn("inline-flex items-center gap-1.5 rounded-md px-3 py-1.5 text-sm font-medium", "bg-primary text-primary-foreground hover:bg-primary-hover", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", "disabled:pointer-events-none disabled:opacity-40"), children: [isCreating && _jsx(SpinnerIcon, {}), "Create schedule"] }), onCancel && (_jsx("button", { type: "button", onClick: onCancel, disabled: isCreating, className: cn("rounded-md px-3 py-1.5 text-sm", "text-muted-foreground hover:bg-accent-hover hover:text-foreground", "disabled:pointer-events-none disabled:opacity-50"), children: "Cancel" }))] })] }));
+}
+// ---------------------------------------------------------------------------
+// Private helpers
+// ---------------------------------------------------------------------------
+const labelClasses = "block text-xs font-medium text-foreground";
+const hintClasses = "text-[0.65rem] text-muted-foreground";
+const inputClasses = cn("w-full rounded-md border border-input bg-background px-2.5 py-1.5 text-xs text-foreground", "placeholder:text-muted-foreground", "focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring", "disabled:pointer-events-none disabled:opacity-50");
+function AgentPickerPopup({ org, value, onChange, onDisplayNameResolved, disabled, }) {
+    const portalContainer = useStigmerPortalContainer();
+    return (_jsx(Popover.Portal, { container: portalContainer, children: _jsx(Popover.Positioner, { sideOffset: 4, align: "start", children: _jsx(Popover.Popup, { className: cn("z-popover overflow-x-hidden overflow-y-auto rounded-lg border border-border", "bg-popover p-3 text-popover-foreground shadow-md", "max-h-[60vh]"), children: _jsx(AgentPicker, { org: org, value: value, onChange: onChange, onDisplayNameResolved: onDisplayNameResolved, 
+                    // Schedules are org-local: the server rejects a target
+                    // agent outside the schedule's org, so cross-org browsing
+                    // could only offer choices that fail at submit.
+                    scope: "org", showScopeToggle: false, disabled: disabled }) }) }) }));
+}
+function ChevronIcon() {
+    return (_jsx("svg", { width: "12", height: "12", viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", className: "shrink-0 text-muted-foreground", "aria-hidden": "true", children: _jsx("path", { d: "M4 6l4 4 4-4" }) }));
+}
+function SpinnerIcon() {
+    return (_jsx("svg", { width: "14", height: "14", viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", className: "animate-spin", "aria-hidden": "true", children: _jsx("path", { d: "M8 2a6 6 0 1 0 6 6" }) }));
+}
+//# sourceMappingURL=ScheduleForm.js.map

package/schedule/ScheduleForm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScheduleForm.js","sourceRoot":"","sources":["../../src/schedule/ScheduleForm.tsx"],"names":[],"mappings":"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"}

package/schedule/ScheduleRowActions.d.ts

@@ -0,0 +1,20 @@
+import type { Schedule } from "@stigmer/protos/ai/stigmer/agentic/schedule/v1/api_pb";
+/** Props for {@link ScheduleRowActions}. */
+export interface ScheduleRowActionsProps {
+    /** The schedule this row represents. */
+    readonly schedule: Schedule;
+    /** Called after a successful action so the list can refetch. */
+    readonly onChanged?: () => void;
+}
+/**
+ * Compact per-row actions for a schedule list: **Run now** on an active
+ * schedule (confirmation-gated — it starts a real, billable execution)
+ * and **Resume** on a platform-paused one. Exactly one action renders
+ * at a time — the one that is currently meaningful; an owner-disabled
+ * schedule renders neither (its remedy lives on the detail page).
+ *
+ * Shared by every console's schedule workbench via `renderItemAction`
+ * so row behavior never diverges between apps (DD-016).
+ */
+export declare function ScheduleRowActions({ schedule, onChanged, }: ScheduleRowActionsProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=ScheduleRowActions.d.ts.map

package/schedule/ScheduleRowActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScheduleRowActions.d.ts","sourceRoot":"","sources":["../../src/schedule/ScheduleRowActions.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uDAAuD,CAAC;AAOtF,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACtC,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,SAAS,GACV,EAAE,uBAAuB,kDA+DzB"}

package/schedule/ScheduleRowActions.js

@@ -0,0 +1,54 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from "@stigmer/theme";
+import { ConfirmDialog } from "../resource-detail/ConfirmDialog.js";
+import { useConfirmAction } from "../resource-detail/useConfirmAction.js";
+import { deriveScheduleState } from "./scheduleState.js";
+import { useResumeSchedule } from "./useResumeSchedule.js";
+import { useTriggerSchedule } from "./useTriggerSchedule.js";
+/**
+ * Compact per-row actions for a schedule list: **Run now** on an active
+ * schedule (confirmation-gated — it starts a real, billable execution)
+ * and **Resume** on a platform-paused one. Exactly one action renders
+ * at a time — the one that is currently meaningful; an owner-disabled
+ * schedule renders neither (its remedy lives on the detail page).
+ *
+ * Shared by every console's schedule workbench via `renderItemAction`
+ * so row behavior never diverges between apps (DD-016).
+ */
+export function ScheduleRowActions({ schedule, onChanged, }) {
+    const { resumeSchedule, isResuming } = useResumeSchedule();
+    const { triggerSchedule, isTriggering } = useTriggerSchedule();
+    const { confirmState, confirm, handleConfirm, handleCancel } = useConfirmAction();
+    const info = deriveScheduleState(schedule.spec, schedule.status);
+    const scheduleId = schedule.metadata?.id ?? "";
+    const name = schedule.metadata?.name || schedule.metadata?.slug || "schedule";
+    const handleTrigger = async () => {
+        const confirmed = await confirm({
+            title: "Run this schedule now?",
+            description: `"${name}" starts a real agent execution immediately, outside ` +
+                "the cron cadence.",
+            confirmLabel: "Start run",
+            variant: "default",
+        });
+        if (!confirmed)
+            return;
+        await triggerSchedule(scheduleId);
+        onChanged?.();
+    };
+    const handleResume = async () => {
+        await resumeSchedule(scheduleId);
+        onChanged?.();
+    };
+    if (info.state === "disabled")
+        return null;
+    return (
+    // Row actions must never bubble into the row's navigate-to-detail
+    // click handler. The span is a non-interactive event fence — the
+    // real interactive element (with keyboard support) is the button.
+    _jsxs("span", { onClick: (e) => e.stopPropagation(), children: [info.state === "active" ? (_jsx(RowActionButton, { label: `Run ${name} now`, busy: isTriggering, onClick: () => void handleTrigger(), children: "Run now" })) : (_jsx(RowActionButton, { label: `Resume ${name}`, busy: isResuming, onClick: () => void handleResume(), children: "Resume" })), confirmState && (_jsx(ConfirmDialog, { state: confirmState, onConfirm: handleConfirm, onCancel: handleCancel }))] }));
+}
+function RowActionButton({ label, busy, onClick, children, }) {
+    return (_jsx("button", { type: "button", "aria-label": label, onClick: onClick, disabled: busy, className: cn("rounded-md border border-input bg-background px-2 py-1 text-xs font-medium text-foreground", "hover:bg-accent hover:text-accent-foreground", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", "disabled:pointer-events-none disabled:opacity-50"), children: children }));
+}
+//# sourceMappingURL=ScheduleRowActions.js.map

package/schedule/ScheduleRowActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScheduleRowActions.js","sourceRoot":"","sources":["../../src/schedule/ScheduleRowActions.tsx"],"names":[],"mappings":"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"}

package/schedule/TimeZoneField.d.ts

@@ -0,0 +1,32 @@
+/** Props for {@link TimeZoneField}. */
+export interface TimeZoneFieldProps {
+    /** Element ID, for association with an external `<label htmlFor>`. */
+    readonly id?: string;
+    /** The selected IANA time zone name. */
+    readonly value: string;
+    /** Called with the new zone when the user picks one. */
+    readonly onChange: (timeZone: string) => void;
+    /** Prevents interaction when `true`. */
+    readonly disabled?: boolean;
+}
+/**
+ * Searchable IANA time zone selector for the schedule form.
+ *
+ * The IANA database has ~400 zones — far too many for a plain
+ * `<select>` — so this follows the SDK's searchable-picker idiom
+ * (search input + listbox, as in `AgentPicker`): the input shows the
+ * selected zone; typing filters the list; Enter or click selects.
+ *
+ * The zone list comes from the runtime's own tz database
+ * (`Intl.supportedValuesOf`), which is also what {@link validateTimeZone}
+ * checks against — the offered choices and the accepted choices cannot
+ * drift.
+ *
+ * Internal to the schedule folder by design: public API surface is a
+ * contract, and this earns a barrel export only when a second consumer
+ * appears.
+ */
+export declare function TimeZoneField({ id, value, onChange, disabled, }: TimeZoneFieldProps): import("react/jsx-runtime").JSX.Element;
+/** The browser's own IANA time zone — the form's default. */
+export declare function browserTimeZone(): string;
+//# sourceMappingURL=TimeZoneField.d.ts.map

package/schedule/TimeZoneField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeZoneField.d.ts","sourceRoot":"","sources":["../../src/schedule/TimeZoneField.tsx"],"names":[],"mappings":"AAWA,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAKD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,EAAE,EACF,KAAK,EACL,QAAQ,EACR,QAAQ,GACT,EAAE,kBAAkB,2CAsIpB;AAaD,6DAA6D;AAC7D,wBAAgB,eAAe,IAAI,MAAM,CAExC"}

package/schedule/TimeZoneField.js

@@ -0,0 +1,104 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useMemo, useRef, useState, } from "react";
+import { cn } from "@stigmer/theme";
+const LIST_ID = "stgm-timezone-list";
+const MAX_VISIBLE = 100;
+/**
+ * Searchable IANA time zone selector for the schedule form.
+ *
+ * The IANA database has ~400 zones — far too many for a plain
+ * `<select>` — so this follows the SDK's searchable-picker idiom
+ * (search input + listbox, as in `AgentPicker`): the input shows the
+ * selected zone; typing filters the list; Enter or click selects.
+ *
+ * The zone list comes from the runtime's own tz database
+ * (`Intl.supportedValuesOf`), which is also what {@link validateTimeZone}
+ * checks against — the offered choices and the accepted choices cannot
+ * drift.
+ *
+ * Internal to the schedule folder by design: public API surface is a
+ * contract, and this earns a barrel export only when a second consumer
+ * appears.
+ */
+export function TimeZoneField({ id, value, onChange, disabled, }) {
+    const zones = useMemo(() => allTimeZones(), []);
+    const [query, setQuery] = useState(null);
+    const [focusIndex, setFocusIndex] = useState(-1);
+    const listRef = useRef(null);
+    const isOpen = query !== null;
+    const filtered = useMemo(() => {
+        if (query === null)
+            return [];
+        const needle = query.trim().toLowerCase().replace(/\s+/g, "_");
+        const matches = needle
+            ? zones.filter((z) => z.toLowerCase().includes(needle))
+            : zones;
+        return matches.slice(0, MAX_VISIBLE);
+    }, [zones, query]);
+    const close = useCallback(() => {
+        setQuery(null);
+        setFocusIndex(-1);
+    }, []);
+    const select = useCallback((zone) => {
+        onChange(zone);
+        close();
+    }, [onChange, close]);
+    const handleKeyDown = useCallback((e) => {
+        if (e.key === "Escape") {
+            e.preventDefault();
+            close();
+            return;
+        }
+        if (!isOpen)
+            return;
+        if (e.key === "ArrowDown") {
+            e.preventDefault();
+            setFocusIndex((prev) => (prev < filtered.length - 1 ? prev + 1 : prev));
+        }
+        else if (e.key === "ArrowUp") {
+            e.preventDefault();
+            setFocusIndex((prev) => (prev > 0 ? prev - 1 : -1));
+        }
+        else if (e.key === "Enter") {
+            e.preventDefault();
+            if (focusIndex >= 0 && focusIndex < filtered.length) {
+                select(filtered[focusIndex]);
+            }
+            else if (filtered.length === 1) {
+                select(filtered[0]);
+            }
+        }
+    }, [isOpen, filtered, focusIndex, select, close]);
+    return (_jsxs("div", { className: "relative", children: [_jsx("input", { id: id, type: "text", role: "combobox", "aria-expanded": isOpen, "aria-controls": LIST_ID, "aria-activedescendant": focusIndex >= 0 ? `stgm-timezone-${focusIndex}` : undefined, "aria-label": "Time zone", placeholder: "Search time zones\u2026", value: query ?? value, onChange: (e) => {
+                    setQuery(e.target.value);
+                    setFocusIndex(-1);
+                }, onFocus: () => setQuery(""), 
+                // Closing on blur reverts the input to the committed value —
+                // free-typed text is never submitted, only list selections.
+                onBlur: close, onKeyDown: handleKeyDown, disabled: disabled, className: cn("w-full rounded-md border border-input bg-background px-2.5 py-1.5 text-xs text-foreground", "placeholder:text-muted-foreground", "focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring", "disabled:pointer-events-none disabled:opacity-50") }), isOpen && (_jsx("div", { ref: listRef, id: LIST_ID, role: "listbox", "aria-label": "Time zones", className: cn("absolute z-popover mt-1 max-h-52 w-full overflow-y-auto rounded-md border border-border", "bg-popover p-1 text-popover-foreground shadow-md"), children: filtered.length === 0 ? (_jsx("div", { className: "py-3 text-center text-xs text-muted-foreground", children: "No time zones match" })) : (filtered.map((zone, idx) => (_jsx("button", { id: `stgm-timezone-${idx}`, type: "button", role: "option", "aria-selected": zone === value, 
+                    // Runs before the input's blur, so selection wins over
+                    // the close-on-blur revert.
+                    onMouseDown: (e) => {
+                        e.preventDefault();
+                        select(zone);
+                    }, className: cn("flex w-full items-center rounded-sm px-2 py-1.5 text-left text-xs transition-colors", idx === focusIndex
+                        ? "bg-accent text-foreground"
+                        : "text-popover-foreground hover:bg-accent-hover", zone === value && "font-medium"), children: zone }, zone)))) }))] }));
+}
+function allTimeZones() {
+    try {
+        return Intl.supportedValuesOf("timeZone");
+    }
+    catch {
+        // Pre-2022 runtimes without supportedValuesOf: offer the browser's
+        // own zone plus UTC rather than an empty list.
+        const own = Intl.DateTimeFormat().resolvedOptions().timeZone;
+        return own && own !== "UTC" ? [own, "UTC"] : ["UTC"];
+    }
+}
+/** The browser's own IANA time zone — the form's default. */
+export function browserTimeZone() {
+    return Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
+}
+//# sourceMappingURL=TimeZoneField.js.map

package/schedule/TimeZoneField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeZoneField.js","sourceRoot":"","sources":["../../src/schedule/TimeZoneField.tsx"],"names":[],"mappings":"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"}

package/schedule/cadence.d.ts

@@ -0,0 +1,95 @@
+/**
+ * The cadence model behind {@link CadenceField} — a pure, dependency-free
+ * bridge between human-friendly schedule presets and the 5-field cron
+ * grammar the Schedule spec stores.
+ *
+ * Deliberately NOT a cron parser. The platform owns no cron parsing in
+ * either edition — calendar and DST semantics live in the Temporal server
+ * (see stigmer-server's schedule/controller/cron.go, DD-008 D2). This
+ * module only:
+ *
+ *   1. GENERATES cron strings from presets (`cadenceToCron`) — trivial
+ *      string construction, always valid by construction.
+ *   2. RECOGNIZES the exact shapes the builder emits (`cronToCadence`)
+ *      so a stored cron round-trips back into the preset UI; anything
+ *      else falls back to the `custom` preset showing the raw string.
+ *   3. MIRRORS the server's purely lexical validation (`validateCron`,
+ *      `validateTimeZone`) with the same user-facing wording, so the
+ *      form can reject bad input instantly. The server remains the
+ *      authority — its errors surface verbatim on submit.
+ */
+/** A human-friendly cadence, convertible to/from a cron expression. */
+export type CadencePreset = {
+    readonly kind: "hourly";
+    readonly minute: number;
+} | {
+    readonly kind: "daily";
+    readonly hour: number;
+    readonly minute: number;
+} | {
+    readonly kind: "weekly";
+    /** Days of week, cron numbering: 0 = Sunday … 6 = Saturday. */
+    readonly days: readonly number[];
+    readonly hour: number;
+    readonly minute: number;
+} | {
+    readonly kind: "monthly";
+    /** Day of month, 1–31. Days 29–31 skip months without that day. */
+    readonly day: number;
+    readonly hour: number;
+    readonly minute: number;
+} | {
+    readonly kind: "custom";
+    readonly cron: string;
+};
+/** Discriminant of {@link CadencePreset}. */
+export type CadenceKind = CadencePreset["kind"];
+/** Day-of-week labels indexed by cron numbering (0 = Sunday). */
+export declare const WEEKDAY_LABELS: readonly ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
+/**
+ * Build the 5-field cron expression for a preset.
+ *
+ * Output is always valid by construction: numeric fields only,
+ * day-of-week in cron numbering (0 = Sunday). For `custom`, the raw
+ * string is returned as-is — validate it with {@link validateCron}.
+ */
+export declare function cadenceToCron(preset: CadencePreset): string;
+/**
+ * Recognize a cron expression as one of the builder's presets.
+ *
+ * Only the exact shapes {@link cadenceToCron} emits (plus the
+ * calendar shorthands `@hourly`/`@daily`/`@weekly`/`@monthly`) map to a
+ * structured preset. Everything else — ranges, steps, names, `@yearly`
+ * — is a perfectly valid schedule that this UI simply cannot decompose,
+ * so it round-trips as `custom` with the raw string intact.
+ */
+export declare function cronToCadence(cron: string): CadencePreset;
+/**
+ * Human-readable summary of a cadence, e.g.
+ * `"Every day at 09:00 (Asia/Kolkata)"`.
+ *
+ * This is a description of the chosen preset, not a computed fire-time
+ * forecast — the platform's next fire time is published by the server
+ * as `status.next_fire_at` after apply.
+ */
+export declare function describeCadence(preset: CadencePreset, timeZone?: string): string;
+/** `9, 5` → `"09:05"` (24-hour clock, zero-padded). */
+export declare function formatTime(hour: number, minute: number): string;
+/**
+ * Validate a cron expression against the platform's lexical grammar.
+ *
+ * Returns the user-facing error message (identical wording to the
+ * server's) or `null` when the expression is acceptable. Purely
+ * lexical — it does not evaluate calendar semantics.
+ */
+export declare function validateCron(cron: string): string | null;
+/**
+ * Validate an IANA time zone name using the runtime's own tz database
+ * (`Intl`), mirroring the server's check against the platform tz
+ * database. Returns the user-facing error message or `null`.
+ *
+ * `"Local"` is rejected explicitly for the same reason the server
+ * rejects it: it is host-dependent, not a zone.
+ */
+export declare function validateTimeZone(timeZone: string): string | null;
+//# sourceMappingURL=cadence.d.ts.map

package/schedule/cadence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cadence.d.ts","sourceRoot":"","sources":["../../src/schedule/cadence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,uEAAuE;AACvE,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1E;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,mEAAmE;IACnE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,6CAA6C;AAC7C,MAAM,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AAEhD,iEAAiE;AACjE,eAAO,MAAM,cAAc,yFAQjB,CAAC;AAMX;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAiB3D;AAWD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAsDzD;AAcD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAoBR;AAED,uDAAuD;AACvD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE/D;AA2BD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiCxD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAShE"}