@devicechain/widgets 0.21.1-rc.1 → 0.22.0-rc.1

package/dist/chunks/control-widgets-UDS4ET3T.js

@@ -0,0 +1,775 @@
+import {
+  buildPayload,
+  commandStatusColor,
+  commandStatusLabel,
+  isScalar,
+  parseParameterSchema,
+  validateParams
+} from "./chunk-YPFB6DAL.js";
+
+// src/widgets/command-slider.tsx
+import { useEffect as useEffect2, useId, useMemo, useRef as useRef2, useState as useState2 } from "react";
+import {
+  css as css2,
+  FIT_MIN_FONT_PX,
+  fitValueFont,
+  fitValueFontCss,
+  fontVar as fontVar2,
+  optNumber,
+  optString,
+  spaceVar as spaceVar2,
+  useStickyChars,
+  WidgetFrame
+} from "@devicechain/widget-sdk";
+
+// src/command-control-core.ts
+var refuse = (refusal) => ({ ok: false, refusal });
+var DEFAULT_NOTCHES = 100;
+function bindControl(kind, input) {
+  if (!input.commandName) return refuse({ code: "noCommand" });
+  const params = parseParameterSchema(input.parameterSchema);
+  const wanted = (p) => isScalar(p) && (kind === "boolean" ? p.dataType === "BOOLEAN" : p.dataType === "INT" || p.dataType === "DOUBLE");
+  let param;
+  if (input.parameter) {
+    param = params.find((p) => p.name === input.parameter);
+    if (!param) return refuse({ code: "parameterMissing", name: input.parameter });
+    if (!wanted(param)) return refuse({ code: "wrongType", name: param.name, kind });
+  } else {
+    const candidates = params.filter(wanted);
+    if (candidates.length !== 1) return refuse({ code: "setParameter" });
+    param = candidates[0];
+  }
+  if (param.enum && param.enum.length > 0) return refuse({ code: "fixedChoices", name: param.name });
+  const others = params.filter((p) => p !== param);
+  const unsatisfied = others.filter((p) => p.required && (!isScalar(p) || p.default == null || p.default === ""));
+  if (unsatisfied.length > 0) return refuse({ code: "otherRequired", names: unsatisfied.map((p) => p.name) });
+  const defaulted = others.filter((p) => isScalar(p) && p.default != null && p.default !== "");
+  const invalid = new Set(
+    Object.keys(validateParams(defaulted, Object.fromEntries(defaulted.map((p) => [p.name, p.default ?? ""]))))
+  );
+  for (const p of defaulted) if (p.enum && p.enum.length > 0 && !p.enum.includes(p.default ?? "")) invalid.add(p.name);
+  if (invalid.size > 0) return refuse({ code: "badDefault", names: defaulted.filter((p) => invalid.has(p.name)).map((p) => p.name) });
+  const sent = [param, ...defaulted];
+  if (kind === "boolean") return { ok: true, kind, param, sent };
+  const min = param.minValue ?? input.min;
+  const max = param.maxValue ?? input.max;
+  if (min === void 0 || max === void 0) return refuse({ code: "setRange" });
+  if (!(max > min)) return refuse({ code: "badRange" });
+  const integer = param.dataType === "INT";
+  const step = input.step !== void 0 && input.step > 0 ? input.step : integer ? 1 : (max - min) / DEFAULT_NOTCHES;
+  return { ok: true, kind, param, range: { min, max, step, integer }, sent };
+}
+function decimalsOf(n) {
+  const text = String(n);
+  const e = /e-(\d+)$/.exec(text);
+  if (e) return Number(e[1]);
+  const dot = text.indexOf(".");
+  return dot < 0 ? 0 : text.length - dot - 1;
+}
+function clampToRange(range, raw) {
+  const finite = Number.isFinite(raw) ? raw : range.min;
+  const bounded = Math.min(range.max, Math.max(range.min, finite));
+  const steps = Math.round((bounded - range.min) / range.step);
+  const decimals = Math.max(decimalsOf(range.step), decimalsOf(range.min));
+  let snapped = Number((range.min + steps * range.step).toFixed(Math.min(decimals, 12)));
+  if (snapped > range.max) snapped = Number((snapped - range.step).toFixed(Math.min(decimals, 12)));
+  if (range.integer) snapped = Math.round(snapped);
+  return Math.min(range.max, Math.max(range.min, snapped));
+}
+function payloadFor(binding, value) {
+  const values = {};
+  for (const p of binding.sent) {
+    values[p.name] = p.default ?? "";
+    if (p === binding.param) values[p.name] = String(value);
+  }
+  const payload = buildPayload(binding.sent, values);
+  return payload;
+}
+function deliveryGroup(status) {
+  switch (status) {
+    case "QUEUED":
+    case "HELD":
+    case "SENT":
+    case "PARKED":
+      return "pending";
+    case "SUCCESSFUL":
+      return "delivered";
+    case "FAILED":
+    case "TIMEOUT":
+    case "EXPIRED":
+    case "CANCELLED":
+      return "failed";
+    default:
+      return "unknown";
+  }
+}
+function readValue(kind, payload, name) {
+  if (!payload) return void 0;
+  let parsed;
+  try {
+    parsed = JSON.parse(payload);
+  } catch {
+    return void 0;
+  }
+  if (typeof parsed !== "object" || parsed === null) return void 0;
+  const v = parsed[name];
+  if (kind === "number") return typeof v === "number" && Number.isFinite(v) ? v : void 0;
+  if (typeof v === "boolean") return v;
+  return void 0;
+}
+function lastSent(kind, commands, commandName, parameter, optimistic) {
+  let newest;
+  for (const c of commands) {
+    if (c.name !== commandName) continue;
+    if (!newest || (c.queuedTime ?? "") > (newest.queuedTime ?? "")) newest = c;
+  }
+  if (optimistic && !commands.some((c) => c.token === optimistic.token)) {
+    return { token: optimistic.token, value: optimistic.value, status: "QUEUED" };
+  }
+  if (!newest) return null;
+  return { token: newest.token, value: readValue(kind, newest.payload, parameter), status: newest.status };
+}
+
+// src/command-control.tsx
+import { useCallback, useEffect, useRef, useState } from "react";
+import { css, fontVar, spaceVar } from "@devicechain/widget-sdk";
+
+// src/command-control-strings.ts
+import { viewerLocale } from "@devicechain/widget-sdk";
+var CONTROL_STRINGS = {
+  en: {
+    noCommand: "No command configured",
+    setParameter: "Set which parameter this control sends",
+    parameterMissing: (n) => `The command has no parameter \u201C${n}\u201D`,
+    wrongType: (n, e) => `Parameter \u201C${n}\u201D is not ${e}`,
+    fixedChoices: (n) => `Parameter \u201C${n}\u201D takes fixed choices, not a range`,
+    otherRequired: (ns) => `Not sent: the command also requires ${ns.map((n) => `\u201C${n}\u201D`).join(", ")}, which has no default value`,
+    badDefault: (ns) => `Not sent: the default value of ${ns.map((n) => `\u201C${n}\u201D`).join(", ")} is not valid for the command`,
+    setRange: "Set min and max",
+    badRange: "Max must be above min",
+    numberKind: "a number",
+    booleanKind: "a boolean",
+    lastSent: "Last sent",
+    nothingSent: "Nothing sent yet",
+    beyondHistory: "Not among the recent commands",
+    noValue: "no value",
+    unsent: "Not sent yet. Release or press Enter to send",
+    sliderHint: "Arrow keys choose a value; press Enter to send it, or Escape to discard it.",
+    pending: "Pending",
+    delivered: "Delivered",
+    failed: "Failed",
+    sending: "Sending\u2026",
+    on: "On",
+    off: "Off",
+    viewOnly: "View only",
+    noPermission: "You don\u2019t have permission to send commands.",
+    noSeam: "Commands aren\u2019t available in this view.",
+    noDevice: "No device is selected for this command.",
+    sendFailed: "Couldn\u2019t send the command. Try again."
+  },
+  es: {
+    noCommand: "No hay un comando configurado",
+    setParameter: "Defina qu\xE9 par\xE1metro env\xEDa este control",
+    parameterMissing: (n) => `El comando no tiene el par\xE1metro \u201C${n}\u201D`,
+    wrongType: (n, e) => `El par\xE1metro \u201C${n}\u201D no es ${e}`,
+    fixedChoices: (n) => `El par\xE1metro \u201C${n}\u201D admite opciones fijas, no un rango`,
+    otherRequired: (ns) => `No se env\xEDa: el comando tambi\xE9n exige ${ns.map((n) => `\u201C${n}\u201D`).join(", ")}, que no tiene valor por defecto`,
+    badDefault: (ns) => `No se env\xEDa: el valor por defecto de ${ns.map((n) => `\u201C${n}\u201D`).join(", ")} no es v\xE1lido para el comando`,
+    setRange: "Defina m\xEDn. y m\xE1x.",
+    badRange: "El m\xE1x. debe superar el m\xEDn.",
+    numberKind: "un n\xFAmero",
+    booleanKind: "un booleano",
+    lastSent: "\xDAltimo enviado",
+    nothingSent: "A\xFAn no se ha enviado nada",
+    beyondHistory: "No figura entre los comandos recientes",
+    noValue: "sin valor",
+    unsent: "A\xFAn no enviado. Suelte o pulse Intro para enviar",
+    sliderHint: "Las flechas eligen un valor; pulse Intro para enviarlo o Escape para descartarlo.",
+    pending: "Pendiente",
+    delivered: "Entregado",
+    failed: "Fallido",
+    sending: "Enviando\u2026",
+    on: "Encendido",
+    off: "Apagado",
+    viewOnly: "Solo lectura",
+    noPermission: "No tiene permiso para enviar comandos.",
+    noSeam: "Los comandos no est\xE1n disponibles en esta vista.",
+    noDevice: "No hay un dispositivo seleccionado para este comando.",
+    sendFailed: "No se pudo enviar el comando. Int\xE9ntelo de nuevo."
+  }
+};
+function controlStrings(locale = viewerLocale()) {
+  return locale?.toLowerCase().split("-")[0] === "es" ? CONTROL_STRINGS.es : CONTROL_STRINGS.en;
+}
+
+// src/command-control.tsx
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+var TOUCH_TARGET_PX = 44;
+function refusalText(r, s, expect) {
+  switch (r.code) {
+    case "noCommand":
+      return s.noCommand;
+    case "setParameter":
+      return s.setParameter;
+    case "parameterMissing":
+      return s.parameterMissing(r.name);
+    case "wrongType":
+      return s.wrongType(r.name, expect === "number" ? s.numberKind : s.booleanKind);
+    case "fixedChoices":
+      return s.fixedChoices(r.name);
+    case "otherRequired":
+      return s.otherRequired(r.names);
+    case "badDefault":
+      return s.badDefault(r.names);
+    case "setRange":
+      return s.setRange;
+    case "badRange":
+      return s.badRange;
+  }
+}
+function useCommandSender(actions, deviceToken, commandName, resetKey) {
+  const strings = controlStrings();
+  const canWrite = actions?.can("command:write") ?? false;
+  const hasSeam = typeof actions?.sendCommand === "function";
+  const canSend = canWrite && hasSeam && !!deviceToken && !!commandName;
+  const inFlight = useRef(false);
+  const generation = useRef(0);
+  const [pending, setPending] = useState(false);
+  const [error, setError] = useState(null);
+  const [optimistic, setOptimistic] = useState(null);
+  useEffect(() => {
+    generation.current += 1;
+    inFlight.current = false;
+    setPending(false);
+    setError(null);
+    setOptimistic(null);
+  }, [resetKey]);
+  const send = useCallback(
+    (payload, value) => {
+      if (!canSend || inFlight.current || !actions?.sendCommand || !deviceToken || !commandName) return false;
+      const gen = generation.current;
+      inFlight.current = true;
+      setPending(true);
+      setError(null);
+      const settle = () => {
+        if (gen !== generation.current) return;
+        inFlight.current = false;
+        setPending(false);
+      };
+      let promise;
+      try {
+        promise = actions.sendCommand(deviceToken, commandName, payload);
+      } catch {
+        setError(strings.sendFailed);
+        settle();
+        return true;
+      }
+      promise.then((dispatch) => {
+        if (gen !== generation.current) return;
+        if (dispatch.status === "rejected") setError(dispatch.reason);
+        else setOptimistic({ token: dispatch.token, value });
+      }).catch(() => {
+        if (gen === generation.current) setError(strings.sendFailed);
+      }).finally(settle);
+      return true;
+    },
+    [actions, canSend, commandName, deviceToken, strings.sendFailed]
+  );
+  const readOnlyReason = !hasSeam ? strings.noSeam : !canWrite ? strings.noPermission : !deviceToken ? strings.noDevice : void 0;
+  return { strings, readOnlyReason, canSend, pending, error, optimistic, send };
+}
+var note = {
+  fontSize: fontVar("xs"),
+  lineHeight: 1.25,
+  color: css("muted-foreground"),
+  overflowWrap: "anywhere"
+};
+function ControlEmpty({ message }) {
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      role: "alert",
+      "data-control-empty": "",
+      style: {
+        display: "flex",
+        alignItems: "center",
+        justifyContent: "center",
+        height: "100%",
+        textAlign: "center",
+        color: css("muted-foreground"),
+        fontSize: fontVar("sm"),
+        overflowWrap: "anywhere"
+      },
+      children: message
+    }
+  );
+}
+var readOnlyId = (captionId) => `${captionId}-ro`;
+function ControlNotes({ sender, captionId }) {
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    sender.readOnlyReason ? /* @__PURE__ */ jsx("span", { id: readOnlyId(captionId), hidden: true, children: sender.readOnlyReason }) : null,
+    sender.readOnlyReason ? /* @__PURE__ */ jsx("div", { "data-read-only": "", title: sender.readOnlyReason, style: { ...note, whiteSpace: "nowrap", overflow: "hidden", textOverflow: "ellipsis" }, children: sender.strings.viewOnly }) : null,
+    sender.error ? /* @__PURE__ */ jsx("div", { role: "alert", style: { ...note, color: commandStatusColor("FAILED") }, children: sender.error }) : null
+  ] });
+}
+function LastSentCaption({
+  id,
+  last,
+  format,
+  strings,
+  override,
+  truncated = false
+}) {
+  const group = last ? deliveryGroup(last.status) : void 0;
+  const word = group === "pending" ? strings.pending : group === "delivered" ? strings.delivered : group === "failed" ? strings.failed : last ? commandStatusLabel(last.status) : "";
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      id,
+      role: "status",
+      "aria-live": "polite",
+      "data-last-sent": "",
+      "data-delivery": group,
+      style: { ...note, fontSize: fontVar("sm"), display: "flex", flexWrap: "wrap", alignItems: "center", columnGap: spaceVar(1) },
+      children: override ? /* @__PURE__ */ jsx("span", { children: override }) : last ? /* @__PURE__ */ jsxs(Fragment, { children: [
+        /* @__PURE__ */ jsxs("span", { children: [
+          strings.lastSent,
+          ":"
+        ] }),
+        /* @__PURE__ */ jsx("span", { style: { color: css("foreground"), fontWeight: 600 }, children: format(last.value) }),
+        /* @__PURE__ */ jsx("span", { "aria-hidden": "true", children: "\xB7" }),
+        /* @__PURE__ */ jsxs(
+          "span",
+          {
+            title: last.status,
+            style: { display: "inline-flex", alignItems: "center", gap: 4, color: commandStatusColor(last.status), fontWeight: 600 },
+            children: [
+              /* @__PURE__ */ jsx("span", { "aria-hidden": "true", style: { width: 7, height: 7, borderRadius: "50%", background: commandStatusColor(last.status) } }),
+              word
+            ]
+          }
+        )
+      ] }) : /* @__PURE__ */ jsx("span", { children: truncated ? strings.beyondHistory : strings.nothingSent })
+    }
+  );
+}
+
+// src/widgets/command-slider.tsx
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+var withUnit = (v, unit) => unit ? `${v} ${unit}` : String(v);
+function CommandSlider({ widget, data, actions }) {
+  const commandName = optString(widget.options, "commandName");
+  const commandLabel = optString(widget.options, "commandLabel") ?? commandName;
+  const parameterSchema = optString(widget.options, "parameterSchema") ?? null;
+  const parameter = optString(widget.options, "parameter");
+  const min = optNumber(widget.options, "min");
+  const max = optNumber(widget.options, "max");
+  const step = optNumber(widget.options, "step");
+  const binding = useMemo(
+    () => bindControl("number", { commandName, parameterSchema, parameter, min, max, step }),
+    [commandName, parameterSchema, parameter, min, max, step]
+  );
+  const sender = useCommandSender(
+    actions,
+    data.deviceToken,
+    commandName,
+    `${commandName ?? ""}::${parameterSchema ?? ""}::${parameter ?? ""}`
+  );
+  const last = binding.ok && commandName ? lastSent("number", data.commands, commandName, binding.param.name, sender.optimistic) : null;
+  const [draft, setDraftState] = useState2(null);
+  const draftRef = useRef2(null);
+  const setDraft = (v) => {
+    draftRef.current = v;
+    setDraftState(v);
+  };
+  const captionId = useId();
+  const hintId = useId();
+  const pressed = useRef2(false);
+  const offRelease = useRef2(null);
+  useEffect2(() => () => offRelease.current?.(), []);
+  const discard = () => {
+    pressed.current = false;
+    offRelease.current?.();
+    offRelease.current = null;
+    if (draftRef.current !== null) setDraft(null);
+  };
+  const press = (input) => {
+    pressed.current = true;
+    offRelease.current?.();
+    const doc = input.ownerDocument;
+    const onRelease = (e) => {
+      if (e.target instanceof Node && input.contains(e.target)) return;
+      discard();
+    };
+    doc.addEventListener("pointerup", onRelease, true);
+    offRelease.current = () => doc.removeEventListener("pointerup", onRelease, true);
+  };
+  const commit = () => {
+    if (!binding.ok) return;
+    const staged = draftRef.current;
+    if (staged === null || !sender.canSend) return;
+    if (sender.send(payloadFor(binding, staged), staged)) setDraft(null);
+  };
+  const release = () => {
+    pressed.current = false;
+    offRelease.current?.();
+    offRelease.current = null;
+    commit();
+  };
+  return /* @__PURE__ */ jsx2(WidgetFrame, { title: optString(widget.options, "title"), children: (scale) => !binding.ok ? /* @__PURE__ */ jsx2(ControlEmpty, { message: refusalText(binding.refusal, sender.strings, "number") }) : /* @__PURE__ */ jsx2(
+    SliderBody,
+    {
+      binding,
+      label: commandLabel ?? binding.param.name,
+      draft,
+      lastValue: typeof last?.value === "number" ? last.value : void 0,
+      sender,
+      captionId,
+      hintId,
+      caption: /* @__PURE__ */ jsx2(
+        LastSentCaption,
+        {
+          id: captionId,
+          last,
+          strings: sender.strings,
+          truncated: data.total > data.commands.length,
+          format: (v) => typeof v === "number" ? withUnit(v, binding.param.unit) : sender.strings.noValue,
+          override: draft !== null ? sender.strings.unsent : sender.pending ? sender.strings.sending : void 0
+        }
+      ),
+      onStage: (v) => {
+        if (!sender.pending) setDraft(clampToRange(binding.range, v));
+      },
+      onCommit: commit,
+      onPress: press,
+      onRelease: release,
+      onDiscard: discard,
+      onLostCapture: () => {
+        if (pressed.current) discard();
+      },
+      scale
+    }
+  ) });
+}
+function SliderBody({
+  binding,
+  label,
+  draft,
+  lastValue,
+  sender,
+  captionId,
+  hintId,
+  caption,
+  onStage,
+  onCommit,
+  onPress,
+  onRelease,
+  onDiscard,
+  onLostCapture,
+  scale: ws
+}) {
+  const range = binding.range;
+  const unit = binding.param.unit;
+  const disabled = !sender.canSend;
+  const busy = sender.pending;
+  const rest = lastValue !== void 0 ? clampToRange(range, lastValue) : range.min;
+  const shown = draft ?? rest;
+  const known = draft !== null || lastValue !== void 0;
+  const readout = known ? String(shown) : "\u2014";
+  const chars = useStickyChars(readout.length + (unit && known ? Math.ceil(unit.length / 2) + 1 : 0));
+  const floor = Math.round(FIT_MIN_FONT_PX * ws.scale);
+  const measured = ws.size.width > 0 && ws.size.height > 0;
+  const room = {
+    width: Math.floor(ws.size.width * 0.34),
+    height: Math.max(TOUCH_TARGET_PX, Math.floor(ws.size.height * 0.5))
+  };
+  const font = measured ? fitValueFont(room, chars, { floor }) : fitValueFontCss(chars, { floor });
+  return /* @__PURE__ */ jsxs2(
+    "div",
+    {
+      style: {
+        height: "100%",
+        boxSizing: "border-box",
+        display: "flex",
+        flexDirection: "column",
+        justifyContent: "safe center",
+        gap: spaceVar2(1),
+        overflow: "hidden"
+      },
+      children: [
+        /* @__PURE__ */ jsxs2("div", { style: { display: "flex", alignItems: "center", gap: spaceVar2(2), minHeight: TOUCH_TARGET_PX }, children: [
+          /* @__PURE__ */ jsx2(
+            "input",
+            {
+              type: "range",
+              "aria-label": label,
+              "aria-valuetext": withUnit(shown, unit),
+              "aria-describedby": `${hintId} ${captionId}${sender.readOnlyReason ? ` ${readOnlyId(captionId)}` : ""}`,
+              "aria-disabled": busy || void 0,
+              "aria-busy": busy || void 0,
+              min: range.min,
+              max: range.max,
+              step: range.step,
+              value: shown,
+              disabled,
+              "data-staged": draft !== null ? "true" : void 0,
+              onChange: (e) => onStage(Number(e.target.value)),
+              onPointerDown: (e) => onPress(e.currentTarget),
+              onPointerUp: onRelease,
+              onPointerCancel: onDiscard,
+              onLostPointerCapture: onLostCapture,
+              onBlur: onDiscard,
+              onKeyDown: (e) => {
+                if (e.key === "Enter") onCommit();
+                else if (e.key === "Escape") onDiscard();
+              },
+              style: {
+                flex: "1 1 0",
+                minWidth: 0,
+                height: TOUCH_TARGET_PX,
+                margin: 0,
+                accentColor: css2("primary"),
+                cursor: disabled || busy ? "not-allowed" : "pointer"
+              }
+            }
+          ),
+          /* @__PURE__ */ jsx2("span", { id: hintId, hidden: true, children: sender.strings.sliderHint }),
+          /* @__PURE__ */ jsxs2(
+            "output",
+            {
+              "aria-hidden": "true",
+              "data-slider-readout": "",
+              style: {
+                flex: "0 0 auto",
+                fontSize: font,
+                fontWeight: 600,
+                lineHeight: 1.1,
+                whiteSpace: "nowrap",
+                fontVariantNumeric: "tabular-nums",
+                color: draft !== null ? css2("foreground") : css2("muted-foreground")
+              },
+              children: [
+                readout,
+                unit && known ? /* @__PURE__ */ jsx2("span", { style: { fontSize: fontVar2("sm"), marginLeft: spaceVar2(1), color: css2("muted-foreground") }, children: unit }) : null
+              ]
+            }
+          )
+        ] }),
+        /* @__PURE__ */ jsxs2("div", { style: { display: "flex", flexWrap: "wrap", alignItems: "baseline", columnGap: spaceVar2(2) }, children: [
+          caption,
+          /* @__PURE__ */ jsx2(ControlNotes, { sender, captionId })
+        ] })
+      ]
+    }
+  );
+}
+
+// src/widgets/command-toggle.tsx
+import { useId as useId2, useMemo as useMemo2 } from "react";
+import {
+  css as css3,
+  FIT_MIN_FONT_PX as FIT_MIN_FONT_PX2,
+  fitValueFont as fitValueFont2,
+  fitValueFontCss as fitValueFontCss2,
+  optString as optString2,
+  spaceVar as spaceVar3,
+  useStickyChars as useStickyChars2,
+  WidgetFrame as WidgetFrame2
+} from "@devicechain/widget-sdk";
+import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+var TRACK_W = 52;
+var TRACK_H = 30;
+var THUMB = 24;
+function CommandToggle({ widget, data, actions }) {
+  const commandName = optString2(widget.options, "commandName");
+  const commandLabel = optString2(widget.options, "commandLabel") ?? commandName;
+  const parameterSchema = optString2(widget.options, "parameterSchema") ?? null;
+  const parameter = optString2(widget.options, "parameter");
+  const binding = useMemo2(
+    () => bindControl("boolean", { commandName, parameterSchema, parameter }),
+    [commandName, parameterSchema, parameter]
+  );
+  const sender = useCommandSender(
+    actions,
+    data.deviceToken,
+    commandName,
+    `${commandName ?? ""}::${parameterSchema ?? ""}::${parameter ?? ""}`
+  );
+  const last = binding.ok && commandName ? lastSent("boolean", data.commands, commandName, binding.param.name, sender.optimistic) : null;
+  const captionId = useId2();
+  return /* @__PURE__ */ jsx3(WidgetFrame2, { title: optString2(widget.options, "title"), children: (scale) => !binding.ok ? /* @__PURE__ */ jsx3(ControlEmpty, { message: refusalText(binding.refusal, sender.strings, "boolean") }) : /* @__PURE__ */ jsx3(
+    ToggleBody,
+    {
+      binding,
+      label: commandLabel ?? binding.param.name,
+      value: intentOf(last),
+      sender,
+      captionId,
+      caption: /* @__PURE__ */ jsx3(
+        LastSentCaption,
+        {
+          id: captionId,
+          last,
+          strings: sender.strings,
+          truncated: data.total > data.commands.length,
+          format: (v) => typeof v === "boolean" ? v ? sender.strings.on : sender.strings.off : sender.strings.noValue,
+          override: sender.pending ? sender.strings.sending : void 0
+        }
+      ),
+      scale
+    }
+  ) });
+}
+function intentOf(last) {
+  if (!last || typeof last.value !== "boolean") return void 0;
+  const group = deliveryGroup(last.status);
+  return group === "pending" || group === "delivered" ? last.value : void 0;
+}
+function ToggleBody({
+  binding,
+  label,
+  value,
+  sender,
+  captionId,
+  caption,
+  scale: ws
+}) {
+  const checked = value === true;
+  const unknown = value === void 0;
+  const disabled = !sender.canSend;
+  const word = checked ? sender.strings.on : sender.strings.off;
+  const chars = useStickyChars2(word.length);
+  const floor = Math.round(FIT_MIN_FONT_PX2 * ws.scale);
+  const measured = ws.size.width > 0 && ws.size.height > 0;
+  const room = {
+    width: Math.floor(ws.size.width - TRACK_W - 16),
+    height: Math.max(TOUCH_TARGET_PX, Math.floor(ws.size.height * 0.5))
+  };
+  const font = measured ? fitValueFont2(room, chars, { floor }) : fitValueFontCss2(chars, { floor });
+  const sendValue = (next) => {
+    sender.send(payloadFor(binding, next), next);
+  };
+  return /* @__PURE__ */ jsxs3(
+    "div",
+    {
+      style: {
+        height: "100%",
+        boxSizing: "border-box",
+        display: "flex",
+        flexDirection: "column",
+        justifyContent: "safe center",
+        gap: spaceVar3(1),
+        overflow: "hidden"
+      },
+      children: [
+        unknown ? /* @__PURE__ */ jsx3("div", { role: "group", "aria-label": label, "aria-describedby": sender.readOnlyReason ? `${captionId} ${readOnlyId(captionId)}` : captionId, "data-toggle-choose": "", style: { display: "flex", gap: spaceVar3(2) }, children: [true, false].map((v) => /* @__PURE__ */ jsx3(
+          "button",
+          {
+            type: "button",
+            disabled,
+            "aria-busy": sender.pending,
+            onClick: () => sendValue(v),
+            style: {
+              flex: "1 1 0",
+              minHeight: TOUCH_TARGET_PX,
+              minWidth: TOUCH_TARGET_PX,
+              padding: `0 ${spaceVar3(2)}`,
+              borderRadius: 6,
+              border: `1px solid ${css3("border")}`,
+              background: css3("background"),
+              color: css3("foreground"),
+              fontWeight: 600,
+              cursor: disabled ? "not-allowed" : "pointer",
+              opacity: disabled ? 0.6 : 1
+            },
+            children: v ? sender.strings.on : sender.strings.off
+          },
+          String(v)
+        )) }) : /* @__PURE__ */ jsxs3(
+          "button",
+          {
+            type: "button",
+            role: "switch",
+            "aria-checked": checked,
+            "aria-label": label,
+            "aria-describedby": sender.readOnlyReason ? `${captionId} ${readOnlyId(captionId)}` : captionId,
+            "aria-busy": sender.pending,
+            disabled,
+            onClick: () => sendValue(!checked),
+            style: {
+              display: "flex",
+              alignItems: "center",
+              gap: spaceVar3(2),
+              minHeight: TOUCH_TARGET_PX,
+              minWidth: TOUCH_TARGET_PX,
+              padding: 0,
+              border: "none",
+              background: "transparent",
+              color: css3("foreground"),
+              cursor: disabled ? "not-allowed" : "pointer",
+              opacity: disabled ? 0.6 : 1,
+              textAlign: "left"
+            },
+            children: [
+              /* @__PURE__ */ jsx3(
+                "span",
+                {
+                  "aria-hidden": "true",
+                  style: {
+                    position: "relative",
+                    flex: "0 0 auto",
+                    width: TRACK_W,
+                    height: TRACK_H,
+                    borderRadius: TRACK_H / 2,
+                    boxSizing: "border-box",
+                    border: `1px solid ${css3("border")}`,
+                    background: checked ? css3("primary") : css3("muted")
+                  },
+                  children: /* @__PURE__ */ jsx3(
+                    "span",
+                    {
+                      style: {
+                        position: "absolute",
+                        top: (TRACK_H - THUMB) / 2 - 1,
+                        left: checked ? TRACK_W - THUMB - 3 : 2,
+                        width: THUMB,
+                        height: THUMB,
+                        borderRadius: "50%",
+                        background: checked ? css3("primary-foreground") : css3("background"),
+                        border: `1px solid ${css3("border")}`,
+                        boxSizing: "border-box"
+                      }
+                    }
+                  )
+                }
+              ),
+              /* @__PURE__ */ jsx3(
+                "span",
+                {
+                  "data-toggle-word": "",
+                  style: {
+                    fontSize: font,
+                    fontWeight: 600,
+                    lineHeight: 1.1,
+                    whiteSpace: "nowrap",
+                    color: css3("foreground")
+                  },
+                  children: word
+                }
+              )
+            ]
+          }
+        ),
+        /* @__PURE__ */ jsxs3("div", { style: { display: "flex", flexWrap: "wrap", alignItems: "baseline", columnGap: spaceVar3(2) }, children: [
+          caption,
+          /* @__PURE__ */ jsx3(ControlNotes, { sender, captionId })
+        ] })
+      ]
+    }
+  );
+}
+export {
+  CommandSlider,
+  CommandToggle
+};
+//# sourceMappingURL=control-widgets-UDS4ET3T.js.map