@weasel-js/labkit 1.5.0 → 1.5.2

package/dist/chunk-FKLT3ITC.js

@@ -0,0 +1,590 @@
+import { fromConfigFields, isLeafVisible } from './chunk-EMXAIRUJ.js';
+import { resolveAutoConfig, schemaNodeAtPath, valueAtPath, auto } from './chunk-REOBGYMC.js';
+import { O, X, n2, j2, z2, G2, W, V, B, I2, U, r5, b2, a3, H, e } from './chunk-LASCBWW7.js';
+import { isBuiltinToolPref } from '@weasel-js/core';
+import { useMemo, useState, Fragment as Fragment$1, useRef, useEffect } from 'react';
+import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
+
+var gridOf = (pack) => pack === "one-up" ? "auto-color" : "pairs";
+function sectionRows(section, rows) {
+  return {
+    pack: section.pack ?? rows.pack,
+    layout: section.layout ?? rows.layout,
+    grid: section.pack ? gridOf(section.pack) : rows.grid
+  };
+}
+var NO_AUTO = /* @__PURE__ */ new Set();
+function ControlPanel({
+  schema,
+  fields,
+  config,
+  setConfig,
+  renderers,
+  pack = "pairs",
+  layout,
+  density,
+  align,
+  collapse,
+  collapsed,
+  onCollapse,
+  auto: given,
+  showHidden = false,
+  className
+}) {
+  const resolved = useMemo(() => schema ?? fromConfigFields(fields ?? []), [schema, fields]);
+  const [ownAuto, setOwnAuto] = useState(NO_AUTO);
+  const auto2 = given ?? ownAuto;
+  const setRowAuto = (path, next, value) => {
+    if (given) {
+      setConfig(path, next ? auto : value);
+      return;
+    }
+    setOwnAuto((prev) => {
+      const now = new Set(prev);
+      if (next) now.add(path);
+      else now.delete(path);
+      return now;
+    });
+    if (!next) setConfig(path, value);
+  };
+  const shown = useMemo(
+    () => auto2 && auto2.size > 0 ? resolveAutoConfig(resolved, config, auto2) : config,
+    [resolved, config, auto2]
+  );
+  const gridPack = gridOf(pack);
+  const folds = collapse !== void 0 || collapsed !== void 0 || onCollapse !== void 0 || resolved.sections.some((s) => s.collapsed !== void 0);
+  const startsFolded = collapse === "closed";
+  const fold = (key, declared, grid = gridPack) => ({
+    pack: grid,
+    collapsible: folds,
+    defaultCollapsed: declared ?? startsFolded,
+    collapsed: collapsed ? collapsed[key] ?? declared ?? startsFolded : void 0,
+    onCollapsedChange: onCollapse ? (next) => onCollapse(key, next) : void 0
+  });
+  const node = (path, rows) => {
+    const found = schemaNodeAtPath(resolved.group, path);
+    if (!found) return null;
+    if (!isLeafVisible(resolved, path, config, showHidden)) return null;
+    if (n2(found)) {
+      return /* @__PURE__ */ jsx(
+        ControlRow,
+        {
+          path,
+          leaf: found,
+          resolved,
+          config,
+          shown,
+          setConfig,
+          renderers,
+          pack: rows.pack,
+          layout: rows.layout,
+          auto: auto2,
+          setRowAuto
+        },
+        path
+      );
+    }
+    if (found.name === "") return /* @__PURE__ */ jsx(Fragment$1, { children: body(found, path, rows) }, path);
+    return /* @__PURE__ */ jsx(
+      X,
+      {
+        title: found.name,
+        description: found.description,
+        span: true,
+        ...fold(path, void 0, rows.grid),
+        children: body(found, path, rows)
+      },
+      path
+    );
+  };
+  const pairable = (path) => {
+    const found = schemaNodeAtPath(resolved.group, path);
+    if (!found || !n2(found)) return void 0;
+    const pair = extra(found, "pair");
+    if (pair === void 0) return void 0;
+    if (!isLeafVisible(resolved, path, config, showHidden))
+      return void 0;
+    if (renderers?.[path] ?? resolved.renderers[path] ?? renderers?.[found.kind]) return void 0;
+    if (!isBuiltinToolPref(found)) return void 0;
+    if (found.kind === "paint" || found.kind === "object" || isSliderLeaf(found)) return void 0;
+    return { leaf: found, pair };
+  };
+  const rowsFor = (paths, rows) => {
+    const out = [];
+    for (let i = 0; i < paths.length; ) {
+      const head = pairable(paths[i]);
+      if (!head) {
+        out.push(node(paths[i], rows));
+        i += 1;
+        continue;
+      }
+      const { pair } = head;
+      const cells = [{ path: paths[i], leaf: head.leaf }];
+      let j2 = i + 1;
+      for (; j2 < paths.length; j2 += 1) {
+        const next = pairable(paths[j2]);
+        if (!next || next.pair !== pair) break;
+        cells.push({ path: paths[j2], leaf: next.leaf });
+      }
+      out.push(
+        /* @__PURE__ */ jsx(
+          PairedRow,
+          {
+            label: pair,
+            cells,
+            shown,
+            setConfig,
+            layout: rows.layout,
+            span: cells.some(({ leaf }) => extra(leaf, "control") === "radio")
+          },
+          paths[i]
+        )
+      );
+      i = j2;
+    }
+    return out;
+  };
+  const body = (group, at, rows) => {
+    const sections = resolved.sections.filter((s) => s.at === at);
+    const sectioned = new Set(sections.flatMap((s) => s.paths));
+    const paths = Object.keys(group.children).map((key) => at === "" ? key : `${at}.${key}`);
+    return /* @__PURE__ */ jsxs(Fragment, { children: [
+      rowsFor(
+        paths.filter((p) => !sectioned.has(p)),
+        rows
+      ),
+      sections.map((section) => {
+        const inner = sectionRows(section, rows);
+        return /* @__PURE__ */ jsx(
+          X,
+          {
+            title: section.label,
+            ...fold(sectionKey(section), section.collapsed, inner.grid),
+            children: rowsFor(section.paths, inner)
+          },
+          sectionKey(section)
+        );
+      })
+    ] });
+  };
+  return /* @__PURE__ */ jsx(
+    O,
+    {
+      pack: gridPack,
+      density,
+      align,
+      className: className ? `lk-control-panel ${className}` : "lk-control-panel",
+      children: body(resolved.group, "", { pack, layout, grid: gridPack })
+    }
+  );
+}
+function sectionKey(section) {
+  return section.at === "" ? section.label : `${section.at}.${section.label}`;
+}
+function isSliderLeaf(leaf) {
+  return leaf.kind === "number" && extra(leaf, "control") === "slider" && extra(leaf, "min") !== void 0 && extra(leaf, "max") !== void 0;
+}
+function extra(leaf, key) {
+  return leaf[key];
+}
+function ControlRow({
+  path,
+  leaf,
+  resolved,
+  config,
+  shown,
+  setConfig,
+  renderers,
+  pack,
+  layout,
+  auto: auto2,
+  setRowAuto
+}) {
+  const write = (value2) => setConfig(path, value2);
+  const fallback = extra(leaf, "default");
+  const pinned = valueAtPath(config, path) ?? fallback;
+  const isAutoRow = auto2?.has(path) ?? false;
+  const canAuto = !extra(leaf, "manual");
+  const resolvedValue = isAutoRow ? valueAtPath(shown, path) : void 0;
+  const value = resolvedValue ?? pinned;
+  const setAuto = (next) => setRowAuto(path, next, value);
+  const onAutoChange = canAuto ? setAuto : void 0;
+  const autoReadout = isAutoRow ? "auto" : void 0;
+  const autoProps = { auto: isAutoRow, onAutoChange };
+  const custom = renderers?.[path] ?? resolved.renderers[path] ?? renderers?.[leaf.kind];
+  if (custom) return custom({ path, pref: leaf, value, setValue: write, auto: isAutoRow, setAuto });
+  const label = leaf.name;
+  const description = leaf.description;
+  const read = () => value;
+  const wide = pack === "auto";
+  if (!isBuiltinToolPref(leaf))
+    return /* @__PURE__ */ jsx(UnwiredRow, { label, kind: leaf.kind, description });
+  switch (leaf.kind) {
+    case "number": {
+      const field = numberField(leaf, read());
+      const suffix = extra(leaf, "suffix") ?? field.unit?.suffix;
+      const notation = extra(leaf, "format");
+      if (isSliderLeaf(leaf)) {
+        return /* @__PURE__ */ jsx(
+          I2,
+          {
+            label,
+            value: field.shown,
+            min: field.min,
+            max: field.max,
+            step: field.step,
+            notation,
+            unit: suffix,
+            onChange: (n2) => write(field.store(n2)),
+            readout: autoReadout,
+            layout,
+            span: wide,
+            description,
+            ...autoProps
+          }
+        );
+      }
+      return /* @__PURE__ */ jsx(
+        U,
+        {
+          label,
+          value: field.shown,
+          min: field.min,
+          max: field.max,
+          step: field.step,
+          unit: suffix,
+          onChange: (n2) => write(field.store(n2)),
+          readout: autoReadout,
+          layout,
+          description,
+          ...autoProps
+        }
+      );
+    }
+    case "boolean": {
+      const Row = extra(leaf, "control") === "switch" ? V : B;
+      return /* @__PURE__ */ jsx(
+        Row,
+        {
+          label,
+          value: read(),
+          onChange: write,
+          readout: autoReadout,
+          layout,
+          description,
+          ...autoProps
+        }
+      );
+    }
+    case "enum": {
+      const options = extra(leaf, "options") ?? [];
+      const segmented = extra(leaf, "control") === "radio";
+      const Row = segmented ? G2 : W;
+      return /* @__PURE__ */ jsx(
+        Row,
+        {
+          label,
+          value: read(),
+          options,
+          onChange: write,
+          readout: autoReadout,
+          layout,
+          span: segmented && wide,
+          description,
+          ...autoProps
+        }
+      );
+    }
+    case "string":
+      return /* @__PURE__ */ jsx(
+        DebouncedTextRow,
+        {
+          leaf,
+          label,
+          value: read(),
+          write,
+          readout: autoReadout,
+          layout,
+          span: wide,
+          description,
+          ...autoProps
+        }
+      );
+    case "color": {
+      const common = {
+        label,
+        readout: autoReadout,
+        layout,
+        description,
+        ...autoProps
+      };
+      if (extra(leaf, "alpha") !== true)
+        return /* @__PURE__ */ jsx(z2, { ...common, value: read(), onChange: write });
+      const { rgb, alpha } = splitHexAlpha(read());
+      return /* @__PURE__ */ jsx(
+        z2,
+        {
+          ...common,
+          value: rgb,
+          onChange: (next) => write(joinHexAlpha(next, alpha)),
+          alpha,
+          onAlphaChange: (next) => write(joinHexAlpha(rgb, next))
+        }
+      );
+    }
+    case "paint":
+    case "object":
+      return /* @__PURE__ */ jsx(UnwiredRow, { label, kind: leaf.kind, description });
+    default: {
+      const _exhaustive = leaf;
+      throw new Error(
+        `ControlPanel: no control for built-in pref kind "${_exhaustive.kind}"`
+      );
+    }
+  }
+}
+function UnwiredRow({
+  label,
+  kind,
+  description
+}) {
+  return /* @__PURE__ */ jsx(j2, { label, description, children: /* @__PURE__ */ jsxs("span", { className: "lk-control-panel__unknown", children: [
+    "no control for \u201C",
+    kind,
+    "\u201D"
+  ] }) });
+}
+function DebouncedTextRow({
+  leaf,
+  label,
+  value,
+  write,
+  layout,
+  span,
+  description,
+  readout,
+  auto: auto2,
+  onAutoChange
+}) {
+  const text = useDebouncedText(
+    value,
+    write,
+    extra(leaf, "debounceMs") ?? 150
+  );
+  return /* @__PURE__ */ jsx(
+    H,
+    {
+      label,
+      readout,
+      layout,
+      span,
+      description,
+      auto: auto2,
+      onAutoChange,
+      value: text.local,
+      placeholder: extra(leaf, "placeholder"),
+      maxLength: extra(leaf, "maxLength"),
+      onChange: text.type
+    }
+  );
+}
+function numberField(leaf, value) {
+  const unit = extra(leaf, "unit");
+  const bounds = unit ? e(leaf) : {
+    min: extra(leaf, "min"),
+    max: extra(leaf, "max"),
+    step: extra(leaf, "step")
+  };
+  const lo = bounds.min ?? Number.NEGATIVE_INFINITY;
+  const hi = bounds.max ?? Number.POSITIVE_INFINITY;
+  return {
+    unit,
+    min: bounds.min,
+    max: bounds.max,
+    step: bounds.step,
+    shown: unit ? unit.toDisplay(value) : value,
+    store: (shown) => {
+      const clamped = Math.min(hi, Math.max(lo, shown));
+      return unit ? unit.fromDisplay(clamped) : clamped;
+    }
+  };
+}
+function splitHexAlpha(value) {
+  const digits = /^#([0-9a-f]{3,8})$/i.exec(value?.trim() ?? "")?.[1];
+  const twice = (s) => s.split("").map((c) => c + c).join("");
+  const byte = (s) => Number.parseInt(s, 16) / 255;
+  switch (digits?.length) {
+    case 3:
+      return { rgb: `#${twice(digits)}`, alpha: 1 };
+    case 4:
+      return { rgb: `#${twice(digits.slice(0, 3))}`, alpha: byte(twice(digits.slice(3))) };
+    case 6:
+      return { rgb: `#${digits}`, alpha: 1 };
+    case 8:
+      return { rgb: `#${digits.slice(0, 6)}`, alpha: byte(digits.slice(6)) };
+    default:
+      return { rgb: "#000000", alpha: 1 };
+  }
+}
+function joinHexAlpha(rgb, alpha) {
+  const byte = Math.max(0, Math.min(255, Math.round(alpha * 255)));
+  return `${rgb}${byte.toString(16).padStart(2, "0")}`;
+}
+function PairedRow({
+  label,
+  cells,
+  shown,
+  setConfig,
+  layout,
+  span
+}) {
+  return /* @__PURE__ */ jsx(j2, { group: true, span, label, layout, children: cells.map(({ path, leaf }) => (
+    // The row is named by the pair, so a cell that shares it says which
+    // knob it is — without a caption a paired switch reads only to a
+    // screen reader. A cell whose leaf is deliberately unnamed keeps none.
+    /* @__PURE__ */ jsxs("span", { className: "lk-pair-cell", children: [
+      leaf.name ? /* @__PURE__ */ jsx("span", { className: "lk-pair-label", children: leaf.name }) : null,
+      /* @__PURE__ */ jsx(
+        PairCell,
+        {
+          leaf,
+          value: valueAtPath(shown, path) ?? extra(leaf, "default"),
+          write: (value) => setConfig(path, value)
+        }
+      )
+    ] }, path)
+  )) });
+}
+function PairCell({
+  leaf,
+  value,
+  write
+}) {
+  const name = leaf.name;
+  const title = leaf.description;
+  const text = useDebouncedText(
+    typeof value === "string" ? value : "",
+    write,
+    extra(leaf, "debounceMs") ?? 150
+  );
+  switch (leaf.kind) {
+    case "number": {
+      const field = numberField(leaf, typeof value === "number" ? value : 0);
+      return /* @__PURE__ */ jsx(
+        "input",
+        {
+          type: "number",
+          "aria-label": name,
+          title,
+          value: field.shown,
+          min: field.min,
+          max: field.max,
+          step: field.step,
+          onChange: (e2) => {
+            const n2 = Number(e2.target.value);
+            if (e2.target.value !== "" && Number.isFinite(n2)) write(field.store(n2));
+          }
+        }
+      );
+    }
+    case "boolean":
+      return extra(leaf, "control") === "switch" ? /* @__PURE__ */ jsx(a3, { "aria-label": name, isSelected: value === true, onChange: write }) : /* @__PURE__ */ jsx(
+        "input",
+        {
+          type: "checkbox",
+          "aria-label": name,
+          title,
+          checked: value === true,
+          onChange: (e2) => write(e2.target.checked)
+        }
+      );
+    case "string":
+      return /* @__PURE__ */ jsx(
+        "input",
+        {
+          type: "text",
+          "aria-label": name,
+          title,
+          value: text.local,
+          placeholder: extra(leaf, "placeholder"),
+          maxLength: extra(leaf, "maxLength"),
+          onChange: (e2) => text.type(e2.target.value)
+        }
+      );
+    case "color": {
+      const { rgb, alpha } = splitHexAlpha(typeof value === "string" ? value : "");
+      const carriesAlpha = extra(leaf, "alpha") === true;
+      return /* @__PURE__ */ jsx(
+        "input",
+        {
+          type: "color",
+          "aria-label": name,
+          title,
+          value: rgb,
+          onChange: (e2) => write(carriesAlpha ? joinHexAlpha(e2.target.value, alpha) : e2.target.value)
+        }
+      );
+    }
+    case "enum": {
+      const options = extra(leaf, "options") ?? [];
+      if (extra(leaf, "control") === "radio") {
+        return /* @__PURE__ */ jsx("span", { title, children: /* @__PURE__ */ jsx(
+          r5,
+          {
+            ariaLabel: name,
+            size: "sm",
+            value: typeof value === "string" ? value : null,
+            onChange: (next) => next !== null && write(next),
+            items: options.map((o) => ({ value: o.value, label: o.label }))
+          }
+        ) });
+      }
+      return /* @__PURE__ */ jsx("span", { title, children: /* @__PURE__ */ jsx(
+        b2,
+        {
+          variant: "bare",
+          "aria-label": name,
+          options,
+          selectedKey: typeof value === "string" ? value : null,
+          onSelectionChange: write
+        }
+      ) });
+    }
+    default:
+      return null;
+  }
+}
+function useDebouncedText(value, write, debounceMs) {
+  const [local, setLocal] = useState(value);
+  const timer = useRef(null);
+  const lastExternal = useRef(value);
+  useEffect(() => {
+    if (value !== lastExternal.current) {
+      lastExternal.current = value;
+      setLocal(value);
+    }
+  }, [value]);
+  useEffect(
+    () => () => {
+      if (timer.current) clearTimeout(timer.current);
+    },
+    []
+  );
+  return {
+    local,
+    type: (next) => {
+      setLocal(next);
+      if (timer.current) clearTimeout(timer.current);
+      const commit = () => {
+        lastExternal.current = next;
+        write(next);
+      };
+      if (debounceMs === 0) commit();
+      else timer.current = setTimeout(commit, debounceMs);
+    }
+  };
+}
+
+export { ControlPanel };
+//# sourceMappingURL=chunk-FKLT3ITC.js.map
+//# sourceMappingURL=chunk-FKLT3ITC.js.map