@flamingo-stack/openframe-frontend-core 0.0.739 → 0.0.741

package/dist/components/features/scripts/schedule-form/index.js

@@ -0,0 +1,84 @@
+import { SCHEDULE_OFFLINE_BEHAVIOR, SCHEDULE_TIME_REFERENCE, SCRIPT_SCHEDULE_TRIGGER } from "./schedule-enums.js";
+import { ScheduleFormFields } from "./schedule-form-fields.js";
+import {
+  DEFAULT_SCHEDULE_FORM_VALUES,
+  EMPTY_SCHEDULE_SCRIPT_ROW,
+  SCHEDULE_OFFLINE_BEHAVIOR_OPTIONS,
+  SCHEDULE_TIME_REFERENCE_OPTIONS,
+  SCHEDULE_TRIGGER_OPTIONS
+} from "./schedule-form-types.js";
+import { ScheduleIntervalInput } from "./schedule-interval-input.js";
+import { ScheduleOfflineFields } from "./schedule-offline-fields.js";
+import { ScheduleScriptPickerCard } from "./schedule-script-picker-card.js";
+import { ScheduleScriptSearchField } from "./schedule-script-search-field.js";
+import { ScheduleScriptsField } from "./schedule-scripts-field.js";
+import { ScheduleTimingFields } from "./schedule-timing-fields.js";
+import {
+  applyTimeSlot,
+  dateToTimeSlot,
+  DEFAULT_RECONNECT_WINDOW,
+  DURATION_UNIT_LABELS,
+  DURATION_UNIT_OPTIONS,
+  DURATION_UNIT_SECONDS,
+  DURATION_UNIT_VALUES,
+  earliestDeviceLocalDay,
+  earliestScheduleDay,
+  fromScheduleInstant,
+  getTimeSlotOptions,
+  isDeviceLocalTime,
+  isEventTrigger,
+  isRetryOnReconnect,
+  isScheduleStartInPast,
+  isSlotOnGrid,
+  isStartInPastAndChanged,
+  MIN_RECONNECT_MINUTES,
+  MIN_REPEAT_MINUTES,
+  NO_SLOTS_TODAY_MESSAGE,
+  PAST_START_MESSAGE,
+  slotToLabel,
+  snapReconnectInterval,
+  snapRepeatInterval,
+  startOfToday
+} from "./schedule-timing.js";
+export {
+  DEFAULT_RECONNECT_WINDOW,
+  DEFAULT_SCHEDULE_FORM_VALUES,
+  DURATION_UNIT_LABELS,
+  DURATION_UNIT_OPTIONS,
+  DURATION_UNIT_SECONDS,
+  DURATION_UNIT_VALUES,
+  EMPTY_SCHEDULE_SCRIPT_ROW,
+  MIN_RECONNECT_MINUTES,
+  MIN_REPEAT_MINUTES,
+  NO_SLOTS_TODAY_MESSAGE,
+  PAST_START_MESSAGE,
+  SCHEDULE_OFFLINE_BEHAVIOR,
+  SCHEDULE_OFFLINE_BEHAVIOR_OPTIONS,
+  SCHEDULE_TIME_REFERENCE,
+  SCHEDULE_TIME_REFERENCE_OPTIONS,
+  SCHEDULE_TRIGGER_OPTIONS,
+  SCRIPT_SCHEDULE_TRIGGER,
+  ScheduleFormFields,
+  ScheduleIntervalInput,
+  ScheduleOfflineFields,
+  ScheduleScriptPickerCard,
+  ScheduleScriptSearchField,
+  ScheduleScriptsField,
+  ScheduleTimingFields,
+  applyTimeSlot,
+  dateToTimeSlot,
+  earliestDeviceLocalDay,
+  earliestScheduleDay,
+  fromScheduleInstant,
+  getTimeSlotOptions,
+  isDeviceLocalTime,
+  isEventTrigger,
+  isRetryOnReconnect,
+  isScheduleStartInPast,
+  isSlotOnGrid,
+  isStartInPastAndChanged,
+  slotToLabel,
+  snapReconnectInterval,
+  snapRepeatInterval,
+  startOfToday
+};

package/dist/components/features/scripts/schedule-form/schedule-enums.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The three schedule enums the form branches on, with the values the OpenFrame
+ * API uses. A host's generated enums carry the same strings, so its values and
+ * these are assignable both ways.
+ */
+/** What fires a schedule: a date and time, or a device coming online. */
+export declare const SCRIPT_SCHEDULE_TRIGGER: {
+    readonly DATE_TIME: "DATE_TIME";
+    readonly DEVICE_ONLINE: "DEVICE_ONLINE";
+};
+export type ScriptScheduleTrigger = (typeof SCRIPT_SCHEDULE_TRIGGER)[keyof typeof SCRIPT_SCHEDULE_TRIGGER];
+/** Which clock a schedule's date and time mean: the account's, or each device's. */
+export declare const SCHEDULE_TIME_REFERENCE: {
+    readonly SERVER: "SERVER";
+    readonly DEVICE_LOCAL: "DEVICE_LOCAL";
+};
+export type ScheduleTimeReference = (typeof SCHEDULE_TIME_REFERENCE)[keyof typeof SCHEDULE_TIME_REFERENCE];
+/** What a schedule does with a device that is offline when it fires. */
+export declare const SCHEDULE_OFFLINE_BEHAVIOR: {
+    readonly SKIP: "SKIP";
+    readonly RETRY_ON_RECONNECT: "RETRY_ON_RECONNECT";
+};
+export type ScheduleOfflineBehavior = (typeof SCHEDULE_OFFLINE_BEHAVIOR)[keyof typeof SCHEDULE_OFFLINE_BEHAVIOR];
+//# sourceMappingURL=schedule-enums.d.ts.map

package/dist/components/features/scripts/schedule-form/schedule-enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-enums.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/scripts/schedule-form/schedule-enums.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,yEAAyE;AACzE,eAAO,MAAM,uBAAuB;;;CAG1B,CAAC;AACX,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,OAAO,uBAAuB,CAAC,CAAC;AAE3G,oFAAoF;AACpF,eAAO,MAAM,uBAAuB;;;CAG1B,CAAC;AACX,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,OAAO,uBAAuB,CAAC,CAAC;AAE3G,wEAAwE;AACxE,eAAO,MAAM,yBAAyB;;;CAG5B,CAAC;AACX,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/components/features/scripts/schedule-form/schedule-enums.js

@@ -0,0 +1,18 @@
+"use client";
+const SCRIPT_SCHEDULE_TRIGGER = {
+  DATE_TIME: "DATE_TIME",
+  DEVICE_ONLINE: "DEVICE_ONLINE"
+};
+const SCHEDULE_TIME_REFERENCE = {
+  SERVER: "SERVER",
+  DEVICE_LOCAL: "DEVICE_LOCAL"
+};
+const SCHEDULE_OFFLINE_BEHAVIOR = {
+  SKIP: "SKIP",
+  RETRY_ON_RECONNECT: "RETRY_ON_RECONNECT"
+};
+export {
+  SCHEDULE_OFFLINE_BEHAVIOR,
+  SCHEDULE_TIME_REFERENCE,
+  SCRIPT_SCHEDULE_TRIGGER
+};

package/dist/components/features/scripts/schedule-form/schedule-form-fields.d.ts

@@ -0,0 +1,57 @@
+import { type OSPlatformOption } from '../../../../utils/os-platforms';
+import type { ScheduleTimeReference } from './schedule-enums';
+import { type RenderScheduleScriptSearch, type ScheduleFormGate, type ScheduleTimeSlot } from './schedule-form-types';
+export interface ScheduleFormFieldsProps {
+    showErrors: boolean;
+    /**
+     * Locks every control. This is the edit page's loading state: the real fields,
+     * in the geometry they will keep, with nothing in them yet — so there is no
+     * placeholder to swap for them when the schedule lands.
+     */
+    disabled?: boolean;
+    /**
+     * The "Select Script" field of each script card. Searching the script library
+     * is the host's query, so the field is a slot: the product passes its
+     * data-bound search, a fixture a static one (both draw
+     * `ScheduleScriptSearchField`).
+     */
+    renderScriptSearch: RenderScheduleScriptSearch;
+    /** Whether the Timezone picker is offered: the host's flag, as a gate. Default `off`. */
+    timeReferenceGate?: ScheduleFormGate;
+    /** The platforms "Supported Platform" offers. Default: every OS platform. */
+    platforms?: ReadonlyArray<OSPlatformOption>;
+    /** Platform ids shown but not selectable yet ("Coming Soon"). Default none. */
+    comingSoonPlatforms?: ReadonlyArray<string>;
+    /** The Time dropdown's options; see `ScheduleTimingFields`. Default: the viewer's own clock. */
+    getTimeSlots?: (date: Date | null, timeReference: ScheduleTimeReference) => ScheduleTimeSlot[];
+    /**
+     * `stacked` (default): the name is a row of its own, over the rest. `inline`:
+     * on a wide form it sits beside the Date / Time / Repeat row, for a host that
+     * shows only those (the sections between them hidden).
+     */
+    nameLayout?: 'stacked' | 'inline';
+    /** The "Note" field. Default true. */
+    showNote?: boolean;
+    /** The trigger choice (on a schedule, or when a device comes online). Default true. */
+    showTrigger?: boolean;
+    /** "Supported Platform". Default true. */
+    showPlatforms?: boolean;
+    /** "If device is offline at scheduled time". Default true. */
+    showOfflineBehavior?: boolean;
+    /** The "Scheduled Scripts" heading over the script cards. Default true. */
+    showScriptsHeading?: boolean;
+    /** Each script card's arguments and environment variables. Default true. */
+    showScriptParams?: boolean;
+    /** Offer "Add Script". Default true; false is a form of the scripts it opens with. */
+    addScripts?: boolean;
+}
+/**
+ * Every field of the schedule form, in the order the design has them. Reads the
+ * form off context, so the page around it only owns the chrome and the Save.
+ *
+ * The defaults are the product's page. The layout props are for a host that
+ * shows the form in less room (a picture of it): fewer sections, and the name
+ * beside the timing.
+ */
+export declare function ScheduleFormFields({ showErrors, disabled, renderScriptSearch, timeReferenceGate, platforms, comingSoonPlatforms, getTimeSlots, nameLayout, showNote, showTrigger, showPlatforms, showOfflineBehavior, showScriptsHeading, showScriptParams, addScripts, }: ScheduleFormFieldsProps): import("react").JSX.Element;
+//# sourceMappingURL=schedule-form-fields.d.ts.map

package/dist/components/features/scripts/schedule-form/schedule-form-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-form-fields.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/scripts/schedule-form/schedule-form-fields.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAOrF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EACL,KAAK,0BAA0B,EAG/B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAK/B,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,kBAAkB,EAAE,0BAA0B,CAAC;IAC/C,yFAAyF;IACzF,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;IACrC,6EAA6E;IAC7E,SAAS,CAAC,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC5C,+EAA+E;IAC/E,mBAAmB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5C,gGAAgG;IAChG,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,aAAa,EAAE,qBAAqB,KAAK,gBAAgB,EAAE,CAAC;IAC/F;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAClC,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uFAAuF;IACvF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,sFAAsF;IACtF,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,UAAU,EACV,QAAgB,EAChB,kBAAkB,EAClB,iBAAyB,EACzB,SAAwB,EACxB,mBAAwB,EACxB,YAAY,EACZ,UAAsB,EACtB,QAAe,EACf,WAAkB,EAClB,aAAoB,EACpB,mBAA0B,EAC1B,kBAAyB,EACzB,gBAAuB,EACvB,UAAiB,GAClB,EAAE,uBAAuB,+BA0JzB"}

package/dist/components/features/scripts/schedule-form/schedule-form-fields.js

@@ -0,0 +1,169 @@
+"use client";
+"use no memo";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useCallback } from "react";
+import { Controller, useFormContext, useWatch } from "react-hook-form";
+import { useContentMdUp } from "../../../../hooks/ui/use-content-breakpoint.js";
+import { OS_PLATFORMS } from "../../../../utils/os-platforms.js";
+import { Input } from "../../../ui/input.js";
+import { Label } from "../../../ui/label.js";
+import { RadioGroupBlock } from "../../../ui/radio-group.js";
+import { Textarea } from "../../../ui/textarea.js";
+import { TruncateText } from "../../../ui/truncate-text.js";
+import { SelectButton } from "../../select-button.js";
+import {
+  SCHEDULE_TRIGGER_OPTIONS
+} from "./schedule-form-types.js";
+import { ScheduleOfflineFields } from "./schedule-offline-fields.js";
+import { ScheduleScriptsField } from "./schedule-scripts-field.js";
+import { ScheduleTimingFields } from "./schedule-timing-fields.js";
+function ScheduleFormFields({
+  showErrors,
+  disabled = false,
+  renderScriptSearch,
+  timeReferenceGate = "off",
+  platforms = OS_PLATFORMS,
+  comingSoonPlatforms = [],
+  getTimeSlots,
+  nameLayout = "stacked",
+  showNote = true,
+  showTrigger = true,
+  showPlatforms = true,
+  showOfflineBehavior = true,
+  showScriptsHeading = true,
+  showScriptParams = true,
+  addScripts = true
+}) {
+  const { control, formState, getValues, setValue } = useFormContext();
+  const isMdUp = useContentMdUp();
+  const supportedPlatforms = useWatch({ control, name: "supportedPlatforms" });
+  const togglePlatform = useCallback(
+    (platform) => {
+      const current = getValues("supportedPlatforms");
+      const has = current.includes(platform);
+      setValue("supportedPlatforms", has ? current.filter((p) => p !== platform) : [...current, platform], {
+        shouldValidate: true,
+        shouldDirty: true
+      });
+    },
+    [getValues, setValue]
+  );
+  const nameField = /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-[var(--spacing-system-xxs)]", children: [
+    /* @__PURE__ */ jsx(Label, { className: "text-h4", children: "Schedule Name" }),
+    /* @__PURE__ */ jsx(
+      Controller,
+      {
+        name: "name",
+        control,
+        render: ({ field, fieldState }) => /* @__PURE__ */ jsx(
+          Input,
+          {
+            placeholder: "Enter schedule name",
+            value: field.value,
+            onChange: field.onChange,
+            disabled,
+            className: "w-full",
+            error: showErrors ? fieldState.error?.message : void 0,
+            invalid: showErrors && !!fieldState.error
+          }
+        )
+      }
+    )
+  ] });
+  const platformField = /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: "relative flex flex-col gap-[var(--spacing-system-xxs)]",
+      "data-invalid": showErrors && !!formState.errors.supportedPlatforms || void 0,
+      children: [
+        /* @__PURE__ */ jsx(Label, { className: "text-h4", children: "Supported Platform" }),
+        /* @__PURE__ */ jsx("div", { className: "grid grid-cols-2 gap-[var(--spacing-system-mf)] content-md:grid-cols-4", children: platforms.map((platform) => {
+          const comingSoon = comingSoonPlatforms.includes(platform.id);
+          return /* @__PURE__ */ jsx(
+            SelectButton,
+            {
+              title: platform.name,
+              icon: /* @__PURE__ */ jsx(platform.icon, { className: "h-5 w-5" }),
+              selected: !comingSoon && supportedPlatforms.includes(platform.id),
+              disabled: comingSoon || disabled,
+              tag: comingSoon ? isMdUp ? "Coming Soon" : "Soon" : void 0,
+              onClick: comingSoon || disabled ? void 0 : () => togglePlatform(platform.id)
+            },
+            platform.id
+          );
+        }) }),
+        showErrors && formState.errors.supportedPlatforms && /* @__PURE__ */ jsx("div", { className: "absolute bottom-0 left-0 right-0 translate-y-full", children: /* @__PURE__ */ jsx(TruncateText, { variant: "h6", className: "text-ods-error", children: formState.errors.supportedPlatforms.message ?? "" }) })
+      ]
+    }
+  );
+  const timingFields = /* @__PURE__ */ jsx(
+    ScheduleTimingFields,
+    {
+      showErrors,
+      disabled,
+      timeReferenceGate,
+      getTimeSlots
+    }
+  );
+  const nameInline = nameLayout === "inline";
+  return /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-[var(--spacing-system-lf)]", children: [
+    nameInline ? /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-[var(--spacing-system-lf)] content-md:flex-row content-md:items-start", children: [
+      /* @__PURE__ */ jsx("div", { className: "min-w-0 content-md:flex-1", children: nameField }),
+      /* @__PURE__ */ jsx("div", { className: "min-w-0 content-md:flex-[3]", children: timingFields })
+    ] }) : nameField,
+    showNote && /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-[var(--spacing-system-xxs)]", children: [
+      /* @__PURE__ */ jsx(Label, { className: "text-h4", children: "Note" }),
+      /* @__PURE__ */ jsx(
+        Controller,
+        {
+          name: "description",
+          control,
+          render: ({ field }) => /* @__PURE__ */ jsx(
+            Textarea,
+            {
+              placeholder: "Enter note here (optional)",
+              value: field.value,
+              onChange: field.onChange,
+              disabled,
+              className: "min-h-[96px] w-full"
+            }
+          )
+        }
+      )
+    ] }),
+    showTrigger && /* @__PURE__ */ jsx(
+      Controller,
+      {
+        name: "trigger",
+        control,
+        render: ({ field }) => /* @__PURE__ */ jsx(
+          RadioGroupBlock,
+          {
+            variant: "grouped",
+            value: field.value,
+            onValueChange: field.onChange,
+            disabled,
+            options: SCHEDULE_TRIGGER_OPTIONS
+          }
+        )
+      }
+    ),
+    showPlatforms && platformField,
+    !nameInline && timingFields,
+    showOfflineBehavior && /* @__PURE__ */ jsx(ScheduleOfflineFields, { showErrors, disabled }),
+    /* @__PURE__ */ jsx(
+      ScheduleScriptsField,
+      {
+        showErrors,
+        disabled,
+        renderScriptSearch,
+        showHeading: showScriptsHeading,
+        showScriptParams,
+        addScripts
+      }
+    )
+  ] });
+}
+export {
+  ScheduleFormFields
+};

package/dist/components/features/scripts/schedule-form/schedule-form-types.d.ts

@@ -0,0 +1,138 @@
+import type { ReactNode } from 'react';
+import type { ScriptArgument } from '../../../platform/ScriptArguments';
+import { type ScheduleOfflineBehavior, type ScheduleTimeReference, type ScriptScheduleTrigger } from './schedule-enums';
+import { type DurationUnit } from './schedule-timing';
+/** One of a script's own environment variables. `value` is null for a secret: the server masks it on every read. */
+export interface ScheduleFormEnvVar {
+    name: string;
+    value: string | null;
+    secret: boolean;
+}
+/** One card of "Scheduled Scripts": the picked script and what the schedule runs it with. */
+export interface ScheduleFormScriptRow {
+    /** `''` = no script picked yet. */
+    scriptId: string;
+    name: string;
+    /** The picked script's OWN platforms (UI ids) — a host checks them against the schedule's. */
+    supportedPlatforms: string[];
+    timeoutSeconds: number;
+    args: ScriptArgument[];
+    envVars: ScriptArgument[];
+    /**
+     * The picked script's OWN defaults, carried with no control of their
+     * own: an override is written only for the half that differs from
+     * them, so a schedule keeps inheriting later edits to the script
+     * instead of freezing a copy the day it was saved.
+     */
+    defaultArgs: string[];
+    defaultEnvVars: ScheduleFormEnvVar[];
+}
+/**
+ * Everything the schedule form holds. The fields read it off the
+ * react-hook-form context; the host owns the form itself (its schema, its
+ * seeding, its submit), and checks its own form type against this one.
+ */
+export interface ScheduleFormData {
+    name: string;
+    /** "Note" in the UI. */
+    description: string;
+    trigger: ScriptScheduleTrigger;
+    scheduledDate: Date | null;
+    /** `HH:mm` on the 30-minute grid; `''` = the user hasn't picked a time yet. */
+    scheduledTime: string;
+    /** Which clock the pair above means — the "Timezone" control. Held even when the control is not rendered. */
+    timeReference: ScheduleTimeReference;
+    repeatEnabled: boolean;
+    /** `null` while the box is EMPTY — the user is mid-edit, not proposing zero. */
+    repeatInterval: number | null;
+    repeatUnit: DurationUnit;
+    /** The stored cadence the form was seeded with, carried with no control of its own. */
+    repeatSecondsStored: number | null;
+    /**
+     * The stored start the form was seeded with, carried with no control of its
+     * own: a start that has already passed stays legal for as long as the form
+     * still shows exactly it (see `isStartInPastAndChanged`).
+     */
+    startAtStored: string | null;
+    offlineBehavior: ScheduleOfflineBehavior;
+    /** "Stop Retry after", as the `[interval] [unit]` pair. `null` while the box is empty. */
+    reconnectInterval: number | null;
+    reconnectUnit: DurationUnit;
+    /** The stored reconnect window the form was seeded with, carried with no control of its own. */
+    reconnectWindowSecondsStored: number | null;
+    /** UI platform ids the schedule targets. */
+    supportedPlatforms: string[];
+    /** Card order IS the run order. */
+    scripts: ScheduleFormScriptRow[];
+}
+export declare const EMPTY_SCHEDULE_SCRIPT_ROW: ScheduleFormScriptRow;
+export declare const SCHEDULE_TRIGGER_OPTIONS: ({
+    value: "DATE_TIME";
+    label: string;
+    description: string;
+} | {
+    value: "DEVICE_ONLINE";
+    label: string;
+    description: string;
+})[];
+/**
+ * The "Timezone" dropdown (design node 793:61340), in the designer's own
+ * wording: the account's clock, or each device's.
+ *
+ * SERVER first — it is the backend's documented default for a null
+ * `timeReference`, and it is what every schedule authored before the field
+ * existed already means.
+ */
+export declare const SCHEDULE_TIME_REFERENCE_OPTIONS: ({
+    value: "SERVER";
+    label: string;
+} | {
+    value: "DEVICE_LOCAL";
+    label: string;
+})[];
+/**
+ * The two answers to "if device is offline at scheduled time" (design node
+ * 460:63425). SKIP first, because it is both the design's default and the
+ * behavior every schedule authored before this field existed already has — the
+ * backend reads a null `offlineBehavior` as SKIP.
+ */
+export declare const SCHEDULE_OFFLINE_BEHAVIOR_OPTIONS: ({
+    value: "SKIP";
+    label: string;
+    description: string;
+} | {
+    value: "RETRY_ON_RECONNECT";
+    label: string;
+    description: string;
+})[];
+export declare const DEFAULT_SCHEDULE_FORM_VALUES: ScheduleFormData;
+/**
+ * A flag a host has asked about and may not have an answer to yet. `loading`
+ * is never read as `off`: the fields it decides are locked until it settles.
+ */
+export type ScheduleFormGate = 'on' | 'off' | 'loading';
+/** One option of the Time dropdown: `value` is 24h `HH:mm`, `label` what the viewer reads. */
+export interface ScheduleTimeSlot {
+    value: string;
+    label: string;
+}
+/**
+ * What a card's "Select Script" slot is told. Searching the script library is
+ * the host's query, so the field is a slot: the product passes its data-bound
+ * search, a fixture passes a static one. Both draw `ScheduleScriptSearchField`.
+ */
+export interface ScheduleScriptSearchSlotProps {
+    /** The card's script: `''` while nothing is picked. */
+    scriptId: string;
+    /** Its name — the label shown when the script is not on the current search page. */
+    name: string;
+    /** UI platform ids the schedule targets — what a host narrows its search by. */
+    supportedPlatforms: string[];
+    /** Writes the card: the row a picked script seeds, or null when the field is cleared. */
+    onPick: (row: ScheduleFormScriptRow | null) => void;
+    disabled: boolean;
+    error: string | undefined;
+    invalid: boolean;
+}
+export type RenderScheduleScriptSearch = (field: ScheduleScriptSearchSlotProps) => ReactNode;
+//# sourceMappingURL=schedule-form-types.d.ts.map

package/dist/components/features/scripts/schedule-form/schedule-form-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-form-types.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/scripts/schedule-form/schedule-form-types.ts"],"names":[],"mappings":"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"}

package/dist/components/features/scripts/schedule-form/schedule-form-types.js

@@ -0,0 +1,72 @@
+"use client";
+import {
+  SCHEDULE_OFFLINE_BEHAVIOR,
+  SCHEDULE_TIME_REFERENCE,
+  SCRIPT_SCHEDULE_TRIGGER
+} from "./schedule-enums.js";
+import { DEFAULT_RECONNECT_WINDOW } from "./schedule-timing.js";
+const EMPTY_SCHEDULE_SCRIPT_ROW = {
+  scriptId: "",
+  name: "",
+  supportedPlatforms: [],
+  // 0 keeps the Timeout field locked and empty until a script is picked.
+  timeoutSeconds: 0,
+  args: [],
+  envVars: [],
+  defaultArgs: [],
+  defaultEnvVars: []
+};
+const SCHEDULE_TRIGGER_OPTIONS = [
+  {
+    value: SCRIPT_SCHEDULE_TRIGGER.DATE_TIME,
+    label: "Run on schedule",
+    description: "Runs at the set date and time, whether or not the device is online."
+  },
+  {
+    value: SCRIPT_SCHEDULE_TRIGGER.DEVICE_ONLINE,
+    label: "Run when device comes online",
+    description: "Waits for the device to connect, then runs as soon as it's reachable."
+  }
+];
+const SCHEDULE_TIME_REFERENCE_OPTIONS = [
+  { value: SCHEDULE_TIME_REFERENCE.SERVER, label: "Your account timezone" },
+  { value: SCHEDULE_TIME_REFERENCE.DEVICE_LOCAL, label: "Device local timezone" }
+];
+const SCHEDULE_OFFLINE_BEHAVIOR_OPTIONS = [
+  {
+    value: SCHEDULE_OFFLINE_BEHAVIOR.SKIP,
+    label: "Skip this Run",
+    description: "Next run stays on schedule. Missed runs are logged."
+  },
+  {
+    value: SCHEDULE_OFFLINE_BEHAVIOR.RETRY_ON_RECONNECT,
+    label: "Run when device comes back online",
+    description: "Executes on the next reconnect."
+  }
+];
+const DEFAULT_SCHEDULE_FORM_VALUES = {
+  name: "",
+  description: "",
+  trigger: SCRIPT_SCHEDULE_TRIGGER.DATE_TIME,
+  scheduledDate: null,
+  scheduledTime: "",
+  timeReference: SCHEDULE_TIME_REFERENCE.SERVER,
+  repeatEnabled: false,
+  repeatInterval: 1,
+  repeatUnit: "day",
+  repeatSecondsStored: null,
+  startAtStored: null,
+  offlineBehavior: SCHEDULE_OFFLINE_BEHAVIOR.SKIP,
+  reconnectInterval: DEFAULT_RECONNECT_WINDOW.interval,
+  reconnectUnit: DEFAULT_RECONNECT_WINDOW.unit,
+  reconnectWindowSecondsStored: null,
+  supportedPlatforms: ["windows"],
+  scripts: [EMPTY_SCHEDULE_SCRIPT_ROW]
+};
+export {
+  DEFAULT_SCHEDULE_FORM_VALUES,
+  EMPTY_SCHEDULE_SCRIPT_ROW,
+  SCHEDULE_OFFLINE_BEHAVIOR_OPTIONS,
+  SCHEDULE_TIME_REFERENCE_OPTIONS,
+  SCHEDULE_TRIGGER_OPTIONS
+};

package/dist/components/features/scripts/schedule-form/schedule-interval-input.d.ts

@@ -0,0 +1,54 @@
+interface ScheduleIntervalInputProps {
+    /** The form's value. `null` = the box is empty. */
+    value: number | null;
+    onChange: (next: number | null) => void;
+    /**
+     * The form's own blur handler. Load-bearing, not optional plumbing: react-hook-form
+     * learns a field was left ONLY through this, and `reValidateMode: 'onBlur'` is
+     * what re-runs the schema. Without it an error the user has already fixed sits
+     * on screen until the next Save.
+     */
+    onBlur?: () => void;
+    disabled?: boolean;
+    invalid?: boolean;
+    error?: string;
+    min?: number;
+    className?: string;
+    'aria-label'?: string;
+    /**
+     * Marks this box as where `scrollToFirstInvalidField` should put focus when
+     * the error is carried by an ancestor rather than by the input itself.
+     */
+    'data-invalid-focus'?: boolean;
+}
+/**
+ * The `[interval]` half of the form's two duration pairs (Repeat in, Stop Retry
+ * after).
+ *
+ * **What the user types owns the display; the form value never writes back into
+ * it while the field has focus.** That inversion is the whole component. Binding
+ * a number input straight to validated state reads as a bug rather than a rule:
+ * the previous version coerced an emptied box back to a floor on every
+ * keystroke, so the digit reappeared as fast as it was deleted and "1" could not
+ * be typed over. Any round trip through `Number()` has the same shape in
+ * smaller ways — a leading zero vanishes mid-word, "10" briefly becomes "1"
+ * while a character is being removed.
+ *
+ * So the raw string is local state, and the form is told the PARSED value as it
+ * changes. Keeping the form current (rather than committing on blur alone)
+ * matters for one case: submitting with Enter never fires a blur, and a form
+ * reading a stale interval would save a number the user cannot see.
+ *
+ * The reverse direction — form → box — is deliberately narrow. It runs only
+ * when the field is NOT focused, which is exactly the set of changes that come
+ * from somewhere else: the record arriving (`useSeedForm`), or the unit
+ * dropdown raising the interval to its floor. While the box has focus those
+ * cannot happen, and nothing else may repaint what is being typed.
+ *
+ * Validation timing is the form's business, not this component's: errors are
+ * held until the first Save (`showErrors`) and re-checked on blur
+ * (`reValidateMode`), so nothing here is judged mid-word.
+ */
+export declare function ScheduleIntervalInput({ value, onChange, onBlur, disabled, invalid, error, min, className, 'aria-label': ariaLabel, 'data-invalid-focus': invalidFocus, }: ScheduleIntervalInputProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=schedule-interval-input.d.ts.map

package/dist/components/features/scripts/schedule-form/schedule-interval-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-interval-input.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/scripts/schedule-form/schedule-interval-input.tsx"],"names":[],"mappings":"AAKA,UAAU,0BAA0B;IAClC,mDAAmD;IACnD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACxC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,KAAK,EACL,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,OAAO,EACP,KAAK,EACL,GAAG,EACH,SAAS,EACT,YAAY,EAAE,SAAS,EACvB,oBAAoB,EAAE,YAAY,GACnC,EAAE,0BAA0B,+BAoD5B"}