@weasel-js/labkit 1.5.2 → 1.6.1

package/dist/chunk-KHK5FGER.js

@@ -0,0 +1,145 @@
+import { textCommand, ellipsePath, linePath, markerDrawCommands, rectPath, PathBuilder } from '@weasel-js/core';
+
+// src/annotations/paint.ts
+var MARK_COLOR = "#e5484d";
+var MARK_WIDTH = 2;
+var TEXT_SIZE = 14;
+var POINT_RADIUS = 4;
+var toWorld = (p, content) => ({
+  x: p.x * content.w,
+  y: p.y * content.h
+});
+function vertices(m, content) {
+  const stored = m.data.points;
+  if (stored && stored.length >= 2) return stored.map((p) => toWorld(p, content));
+  const { x, y, width, height } = m.pose;
+  return [
+    { x, y },
+    { x: x + width, y: y + height }
+  ];
+}
+function polyline(points) {
+  const b = new PathBuilder();
+  const first = points[0];
+  if (!first) return rectPath(0, 0, 0, 0);
+  b.moveTo(first.x, first.y);
+  for (const p of points.slice(1)) b.lineTo(p.x, p.y);
+  return b.build();
+}
+function markCommands(m, content, style = {}) {
+  const color = style.color ?? MARK_COLOR;
+  const stroke = {
+    paint: { color },
+    width: MARK_WIDTH,
+    cap: "round",
+    join: "round",
+    ...style.stale ? { dash: [6, 4] } : {}
+  };
+  switch (m.data.kind) {
+    case "rect":
+      return [
+        { kind: "path", path: rectPath(m.pose.x, m.pose.y, m.pose.width, m.pose.height), stroke }
+      ];
+    case "ellipse":
+      return [{ kind: "path", path: ellipsePath(m.pose), stroke }];
+    case "line": {
+      const [a, b] = vertices(m, content);
+      return [{ kind: "path", path: linePath(a, b), stroke }];
+    }
+    case "arrow": {
+      const [a, b] = vertices(m, content);
+      const marked = { ...stroke, markerEnd: "arrow" };
+      const path = linePath(a, b);
+      return [
+        { kind: "path", path, stroke: marked },
+        ...markerDrawCommands(path, marked, MARK_WIDTH, void 0)
+      ];
+    }
+    case "stroke":
+      return [{ kind: "path", path: polyline(vertices(m, content)), stroke }];
+    case "point": {
+      const stored = m.data.points?.[0];
+      const c = stored ? toWorld(stored, content) : { x: m.pose.x, y: m.pose.y };
+      const ring = {
+        x: c.x - POINT_RADIUS,
+        y: c.y - POINT_RADIUS,
+        width: 2 * POINT_RADIUS,
+        height: 2 * POINT_RADIUS
+      };
+      return [{ kind: "path", path: ellipsePath(ring), stroke }];
+    }
+    case "text": {
+      const text = m.data.title;
+      if (!text) return [];
+      return [
+        textCommand(
+          m.pose.x,
+          m.pose.y,
+          text,
+          { fontSize: TEXT_SIZE },
+          void 0,
+          void 0,
+          void 0,
+          {
+            fill: { color }
+          }
+        )
+      ];
+    }
+  }
+}
+
+// src/annotations/svgNodes.ts
+var NO_PAINT = { kind: "none" };
+function toSvgPaint(paint) {
+  if (!paint) return NO_PAINT;
+  if ("color" in paint && typeof paint.color === "string") {
+    return {
+      kind: "solid",
+      color: paint.color,
+      ...paint.opacity != null ? { opacity: paint.opacity } : {}
+    };
+  }
+  return { kind: "gradient", paint };
+}
+function toSvgStroke(stroke) {
+  return {
+    paint: toSvgPaint(stroke.paint),
+    width: stroke.width ?? 1,
+    ...stroke.cap ? { cap: stroke.cap } : {},
+    ...stroke.join ? { join: stroke.join } : {},
+    ...stroke.dash ? { dash: [...stroke.dash] } : {},
+    ...stroke.miterLimit != null ? { miterLimit: stroke.miterLimit } : {},
+    ...stroke.align ? { align: stroke.align } : {}
+  };
+}
+function toSvgNode(cmd, m) {
+  if (cmd.kind === "path") {
+    return {
+      kind: "path",
+      path: cmd.path,
+      fill: toSvgPaint(cmd.fill),
+      ...cmd.stroke ? { stroke: toSvgStroke(cmd.stroke) } : {}
+    };
+  }
+  if (cmd.kind === "text") {
+    return {
+      kind: "text",
+      x: cmd.x,
+      y: cmd.y,
+      width: m.pose.width,
+      height: m.pose.height,
+      text: cmd.runs.map((run) => run.text).join(""),
+      style: cmd.style,
+      ...cmd.runs[0]?.fill ? { fill: cmd.runs[0].fill } : {}
+    };
+  }
+  throw new Error(`[labkit] a mark drew a '${cmd.kind}' command, which has no vector form`);
+}
+function markSvgNodes(m, content, style = {}) {
+  return markCommands(m, content, style).map((cmd) => toSvgNode(cmd, m));
+}
+
+export { markCommands, markSvgNodes };
+//# sourceMappingURL=chunk-KHK5FGER.js.map
+//# sourceMappingURL=chunk-KHK5FGER.js.map

package/dist/chunk-KHK5FGER.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/annotations/paint.ts","../src/annotations/svgNodes.ts"],"names":[],"mappings":"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","file":"chunk-KHK5FGER.js","sourcesContent":["import type { DrawCommand, Path, Stroke } from '@weasel-js/core';\nimport {\n  ellipsePath,\n  linePath,\n  markerDrawCommands,\n  PathBuilder,\n  rectPath,\n  textCommand,\n} from '@weasel-js/core';\nimport type { WorldRect } from './frac';\nimport type { AnnotationData, FracPoint } from './types';\n\n/** One loud color, not a themed one: a mark sits over the instrument's own\n *  picture and has to be legible against whatever that picture is. */\nconst MARK_COLOR = '#e5484d';\n/** World units, so a mark thickens with the picture it annotates — and so the\n *  marker geometry can be resolved here, which needs a resolved width. */\nconst MARK_WIDTH = 2;\nconst TEXT_SIZE = 14;\nconst POINT_RADIUS = 4;\n\n/** The subset of a mark's scene node this needs: where it is, and what it is. */\nexport interface PaintableMark {\n  pose: WorldRect;\n  data: AnnotationData;\n}\n\n/** How a mark is drawn, as opposed to where. Resolved by the overlay from the\n *  instrument's vocabulary and the mark's own staleness. */\nexport interface MarkStyle {\n  /** The status's color, or the default. */\n  color?: string;\n  /** A mark whose stored position no longer describes the picture. Drawn\n   *  dashed rather than hidden: it still describes *something*, and dropping\n   *  it would lose it. */\n  stale?: boolean;\n}\n\nconst toWorld = (p: FracPoint, content: { w: number; h: number }) => ({\n  x: p.x * content.w,\n  y: p.y * content.h,\n});\n\n/** A mark's stored vertices in world units, or the pose's diagonal — a stored\n *  mark whose `points` did not survive still has to draw somewhere. */\nfunction vertices(m: PaintableMark, content: { w: number; h: number }): { x: number; y: number }[] {\n  const stored = m.data.points;\n  if (stored && stored.length >= 2) return stored.map((p) => toWorld(p, content));\n  const { x, y, width, height } = m.pose;\n  return [\n    { x, y },\n    { x: x + width, y: y + height },\n  ];\n}\n\nfunction polyline(points: { x: number; y: number }[]): Path {\n  const b = new PathBuilder();\n  const first = points[0];\n  if (!first) return rectPath(0, 0, 0, 0);\n  b.moveTo(first.x, first.y);\n  for (const p of points.slice(1)) b.lineTo(p.x, p.y);\n  return b.build();\n}\n\n/**\n * What one mark draws, in its target's world.\n *\n * Pure: a node and the target's content box in, draw commands out. Geometry\n * that a bounding box cannot describe — a line's ends, a stroke's path — comes\n * from `data.points`, which is in fractions like the bounds.\n */\nexport function markCommands(\n  m: PaintableMark,\n  content: { w: number; h: number },\n  style: MarkStyle = {},\n): DrawCommand[] {\n  const color = style.color ?? MARK_COLOR;\n  const stroke: Stroke = {\n    paint: { color },\n    width: MARK_WIDTH,\n    cap: 'round',\n    join: 'round',\n    ...(style.stale ? { dash: [6, 4] } : {}),\n  };\n\n  switch (m.data.kind) {\n    case 'rect':\n      return [\n        { kind: 'path', path: rectPath(m.pose.x, m.pose.y, m.pose.width, m.pose.height), stroke },\n      ];\n    case 'ellipse':\n      return [{ kind: 'path', path: ellipsePath(m.pose), stroke }];\n    case 'line': {\n      const [a, b] = vertices(m, content);\n      return [{ kind: 'path', path: linePath(a, b), stroke }];\n    }\n    case 'arrow': {\n      const [a, b] = vertices(m, content);\n      // The spec's arrow: a line carrying an end marker, not its own geometry.\n      // Markers are separate commands — a stroke's `markerEnd` is inert unless\n      // something turns it into geometry, and only the kit's own node painter\n      // does that, for the nodes it owns.\n      const marked: Stroke = { ...stroke, markerEnd: 'arrow' };\n      const path = linePath(a, b);\n      return [\n        { kind: 'path', path, stroke: marked },\n        ...markerDrawCommands(path, marked, MARK_WIDTH, undefined),\n      ];\n    }\n    case 'stroke':\n      return [{ kind: 'path', path: polyline(vertices(m, content)), stroke }];\n    case 'point': {\n      const stored = m.data.points?.[0];\n      const c = stored ? toWorld(stored, content) : { x: m.pose.x, y: m.pose.y };\n      const ring = {\n        x: c.x - POINT_RADIUS,\n        y: c.y - POINT_RADIUS,\n        width: 2 * POINT_RADIUS,\n        height: 2 * POINT_RADIUS,\n      };\n      return [{ kind: 'path', path: ellipsePath(ring), stroke }];\n    }\n    case 'text': {\n      const text = m.data.title;\n      if (!text) return [];\n      return [\n        textCommand(\n          m.pose.x,\n          m.pose.y,\n          text,\n          { fontSize: TEXT_SIZE },\n          undefined,\n          undefined,\n          undefined,\n          {\n            fill: { color },\n          },\n        ),\n      ];\n    }\n  }\n}\n","import type { DrawCommand, FillStyle, Stroke } from '@weasel-js/core';\nimport type { SvgNode, SvgPaint, SvgStroke } from '@weasel-js/svg';\nimport { type MarkStyle, markCommands, type PaintableMark } from './paint';\n\nconst NO_PAINT: SvgPaint = { kind: 'none' };\n\nfunction toSvgPaint(paint: FillStyle | undefined): SvgPaint {\n  if (!paint) return NO_PAINT;\n  if ('color' in paint && typeof paint.color === 'string') {\n    return {\n      kind: 'solid',\n      color: paint.color,\n      ...(paint.opacity != null ? { opacity: paint.opacity } : {}),\n    };\n  }\n  return { kind: 'gradient', paint };\n}\n\n/** Marker references are deliberately dropped: `markCommands` already resolves\n *  a marker into its own path command, and keeping the reference would make\n *  the serializer emit a `<marker>` def that draws the head a second time. */\nfunction toSvgStroke(stroke: Stroke): SvgStroke {\n  return {\n    paint: toSvgPaint(stroke.paint),\n    width: stroke.width ?? 1,\n    ...(stroke.cap ? { cap: stroke.cap } : {}),\n    ...(stroke.join ? { join: stroke.join } : {}),\n    ...(stroke.dash ? { dash: [...stroke.dash] } : {}),\n    ...(stroke.miterLimit != null ? { miterLimit: stroke.miterLimit } : {}),\n    ...(stroke.align ? { align: stroke.align } : {}),\n  };\n}\n\nfunction toSvgNode(cmd: DrawCommand, m: PaintableMark): SvgNode {\n  if (cmd.kind === 'path') {\n    return {\n      kind: 'path',\n      path: cmd.path,\n      fill: toSvgPaint(cmd.fill),\n      ...(cmd.stroke ? { stroke: toSvgStroke(cmd.stroke) } : {}),\n    };\n  }\n  if (cmd.kind === 'text') {\n    return {\n      kind: 'text',\n      x: cmd.x,\n      y: cmd.y,\n      width: m.pose.width,\n      height: m.pose.height,\n      text: cmd.runs.map((run) => run.text).join(''),\n      style: cmd.style,\n      ...(cmd.runs[0]?.fill ? { fill: cmd.runs[0].fill } : {}),\n    };\n  }\n  // Unreachable while `markCommands` emits only paths and text. A throw rather\n  // than a skip: a new mark kind silently vanishing from every export is a\n  // worse afternoon than a loud one.\n  throw new Error(`[labkit] a mark drew a '${cmd.kind}' command, which has no vector form`);\n}\n\n/**\n * One mark as SVG nodes, converted from the very commands the pane paints.\n *\n * Deliberately not a second switch over `data.kind`: geometry has one source,\n * and this is a translation of it. `serializeSvg` turns the result into a\n * document.\n */\nexport function markSvgNodes(\n  m: PaintableMark,\n  content: { w: number; h: number },\n  style: MarkStyle = {},\n): SvgNode[] {\n  return markCommands(m, content, style).map((cmd) => toSvgNode(cmd, m));\n}\n"]}

package/dist/chunk-NEXR37YJ.js

@@ -0,0 +1,144 @@
+import { usePersistedState } from './chunk-RWNDDKOH.js';
+import { openPointerSession } from '@weasel-js/core';
+import { useRef, useMemo, useState, useEffect } from 'react';
+import { floatingStrategy, DEFAULT_INSET, DEFAULT_ANCHOR, FLOATING_DRAG_PREFIX } from 'windease';
+import { jsx } from 'react/jsx-runtime';
+
+var ITEM_ID = "panel";
+function borderBoxOf(entry) {
+  const box = entry.borderBoxSize?.[0];
+  if (box) return { w: box.inlineSize, h: box.blockSize };
+  return { w: entry.contentRect.width, h: entry.contentRect.height };
+}
+var DRAG_THRESHOLD = 3;
+function isInteractive(target) {
+  if (!(target instanceof Element)) return false;
+  return target.closest("input, button, a, select, textarea, [data-no-drag]") !== null;
+}
+function FloatingPanel({
+  children,
+  anchor = DEFAULT_ANCHOR,
+  snapCorners,
+  inset = DEFAULT_INSET,
+  persist,
+  className
+}) {
+  const ref = useRef(null);
+  const strategy = useMemo(() => floatingStrategy(), []);
+  const options = useMemo(() => ({ defaultAnchor: anchor, inset }), [anchor, inset]);
+  const [container, setContainer] = useState({ w: 0, h: 0 });
+  const [size, setSize] = useState({ w: 0, h: 0 });
+  const [place, setPlace] = usePersistedState(persist, () => ({
+    x: 0,
+    y: 0,
+    anchor
+  }));
+  const item = useMemo(
+    () => ({
+      id: ITEM_ID,
+      meta: { floating: true, ...snapCorners ? { snapCorners: [...snapCorners] } : {} },
+      natural: size
+    }),
+    [size, snapCorners]
+  );
+  useEffect(() => {
+    const el = ref.current;
+    const parent = el?.offsetParent ?? el?.parentElement;
+    if (!el || !parent) return;
+    const observer = new ResizeObserver((entries) => {
+      for (const entry of entries) {
+        if (entry.target === parent) {
+          setContainer({ w: entry.contentRect.width, h: entry.contentRect.height });
+        } else {
+          setSize(borderBoxOf(entry));
+        }
+      }
+    });
+    observer.observe(parent);
+    observer.observe(el);
+    return () => observer.disconnect();
+  }, []);
+  const rect = strategy.layout({
+    items: [item],
+    container,
+    state: { at: { [ITEM_ID]: place }, inner: void 0 },
+    options
+  }).placements.get(ITEM_ID);
+  const dragging = useRef(null);
+  const session = useRef(null);
+  const [isDragging, setDragging] = useState(false);
+  const layout = useRef({ container, options, item });
+  layout.current = { container, options, item };
+  useEffect(() => () => session.current?.cancel(), []);
+  const onPointerDown = (e) => {
+    if (isInteractive(e.target)) return;
+    e.stopPropagation();
+    const origin = e.currentTarget;
+    const pointerId = e.pointerId;
+    const start = { x: e.clientX, y: e.clientY };
+    const end = () => {
+      session.current = null;
+      if (!dragging.current) return;
+      dragging.current = null;
+      setDragging(false);
+      try {
+        origin.releasePointerCapture?.(pointerId);
+      } catch {
+      }
+    };
+    session.current = openPointerSession(
+      origin,
+      e,
+      {
+        onMove: (ev) => {
+          if (!dragging.current) {
+            if (Math.hypot(ev.clientX - start.x, ev.clientY - start.y) < DRAG_THRESHOLD) return;
+            dragging.current = { ...start };
+            setDragging(true);
+            origin.setPointerCapture?.(pointerId);
+          }
+          const from = dragging.current;
+          const dx = ev.clientX - from.x;
+          const dy = ev.clientY - from.y;
+          if (dx === 0 && dy === 0) return;
+          dragging.current = { x: ev.clientX, y: ev.clientY };
+          const { container: box, options: opts, item: only } = layout.current;
+          setPlace(
+            (prev) => strategy.reduce?.(
+              { at: { [ITEM_ID]: prev }, inner: void 0 },
+              {
+                affordanceId: `${FLOATING_DRAG_PREFIX}${ITEM_ID}`,
+                kind: "drag",
+                payload: { dx, dy }
+              },
+              { container: box, options: opts, items: [only] }
+            ).at[ITEM_ID] ?? prev
+          );
+        },
+        onEnd: end,
+        onCancel: end
+      },
+      { capture: false }
+    );
+  };
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      className: className ? `lk-floating-panel ${className}` : "lk-floating-panel",
+      "data-dragging": isDragging ? "true" : void 0,
+      "data-placed": rect ? "true" : void 0,
+      onPointerDown,
+      ref,
+      style: {
+        position: "absolute",
+        left: `${rect?.x ?? 0}px`,
+        top: `${rect?.y ?? 0}px`
+      },
+      children
+    }
+  );
+}
+
+export { FloatingPanel };
+//# sourceMappingURL=chunk-NEXR37YJ.js.map
+//# sourceMappingURL=chunk-NEXR37YJ.js.map

package/dist/chunk-NEXR37YJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/primitives/FloatingPanel.tsx"],"names":[],"mappings":"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","file":"chunk-NEXR37YJ.js","sourcesContent":["import { openPointerSession, type PointerSession } from '@weasel-js/core';\nimport type React from 'react';\nimport { type CSSProperties, type ReactNode, useEffect, useMemo, useRef, useState } from 'react';\nimport {\n  type Corner,\n  DEFAULT_ANCHOR,\n  DEFAULT_INSET,\n  FLOATING_DRAG_PREFIX,\n  type FloatingPlacement,\n  floatingStrategy,\n} from 'windease';\nimport { usePersistedState } from '../state/usePersistedState';\n\n/** The strategy holds a map keyed by item id; a panel is always a lone item. */\nconst ITEM_ID = 'panel';\n\n/** Props for `<FloatingPanel>`. */\nexport interface FloatingPanelProps {\n  children: ReactNode;\n  /** Corner it rests in before it has ever been dragged. Default `'bottom-left'`. */\n  anchor?: Corner;\n  /** Corners that may capture it. Default: all four. */\n  snapCorners?: readonly Corner[];\n  /** Pixels in from a corner when snapped. Default 12. */\n  inset?: number;\n  /** Name to remember its position under, through `usePersistedState` — so it\n   *  is remembered only inside a lab or a `<Persistence>`. Omit to forget on\n   *  reload. */\n  persist?: string;\n  className?: string;\n}\n\n/**\n * The panel's footprint is its border box — `contentRect` excludes padding and\n * border, which would place a panel that then overflows its corner by exactly\n * that much.\n */\nfunction borderBoxOf(entry: ResizeObserverEntry): { w: number; h: number } {\n  const box = entry.borderBoxSize?.[0];\n  if (box) return { w: box.inlineSize, h: box.blockSize };\n  return { w: entry.contentRect.width, h: entry.contentRect.height };\n}\n\n/** How far the pointer must travel before a press becomes a drag. */\nconst DRAG_THRESHOLD = 3;\n\n/** A pointerdown on one of these is the child's, not a drag. */\nfunction isInteractive(target: EventTarget | null): boolean {\n  if (!(target instanceof Element)) return false;\n  return target.closest('input, button, a, select, textarea, [data-no-drag]') !== null;\n}\n\n/**\n * A draggable box that floats over its offset parent and snaps to its corners.\n *\n * Drives windease's `floatingStrategy` as a pure function rather than mounting a\n * windease container: a lab overlay has one item and no zone tree, so the node\n * model would be all cost. Pointer handling is therefore this component's, and\n * windease's own affordance rendering never participates.\n */\nexport function FloatingPanel({\n  children,\n  anchor = DEFAULT_ANCHOR,\n  snapCorners,\n  inset = DEFAULT_INSET,\n  persist,\n  className,\n}: FloatingPanelProps) {\n  const ref = useRef<HTMLDivElement>(null);\n  const strategy = useMemo(() => floatingStrategy(), []);\n  const options = useMemo(() => ({ defaultAnchor: anchor, inset }), [anchor, inset]);\n\n  const [container, setContainer] = useState({ w: 0, h: 0 });\n  const [size, setSize] = useState({ w: 0, h: 0 });\n  const [place, setPlace] = usePersistedState<FloatingPlacement>(persist, () => ({\n    x: 0,\n    y: 0,\n    anchor,\n  }));\n\n  const item = useMemo(\n    () => ({\n      id: ITEM_ID,\n      meta: { floating: true, ...(snapCorners ? { snapCorners: [...snapCorners] } : {}) },\n      natural: size,\n    }),\n    [size, snapCorners],\n  );\n\n  useEffect(() => {\n    const el = ref.current;\n    const parent = el?.offsetParent ?? el?.parentElement;\n    if (!el || !parent) return;\n    // Sizes come off the entry, not the DOM: jsdom reports 0 for every\n    // clientWidth/offsetWidth, and an unmeasured item is withheld from layout.\n    const observer = new ResizeObserver((entries) => {\n      for (const entry of entries) {\n        if (entry.target === parent) {\n          setContainer({ w: entry.contentRect.width, h: entry.contentRect.height });\n        } else {\n          setSize(borderBoxOf(entry));\n        }\n      }\n    });\n    observer.observe(parent);\n    observer.observe(el);\n    return () => observer.disconnect();\n  }, []);\n\n  const rect = strategy\n    .layout({\n      items: [item],\n      container,\n      state: { at: { [ITEM_ID]: place }, inner: undefined },\n      options,\n    })\n    .placements.get(ITEM_ID);\n\n  const dragging = useRef<{ x: number; y: number } | null>(null);\n  const session = useRef<PointerSession | null>(null);\n  const [isDragging, setDragging] = useState(false);\n  // A drag outlives the render that started it, so the reducer's inputs are\n  // read here and not from that render's closure — a container resized\n  // mid-drag would otherwise place the panel against its old box.\n  const layout = useRef({ container, options, item });\n  layout.current = { container, options, item };\n\n  useEffect(() => () => session.current?.cancel(), []);\n\n  const onPointerDown = (e: React.PointerEvent<HTMLDivElement>) => {\n    if (isInteractive(e.target)) return;\n    // The canvas stack underneath owns pan/zoom on the same pointer events.\n    e.stopPropagation();\n    const origin = e.currentTarget;\n    const pointerId = e.pointerId;\n    const start = { x: e.clientX, y: e.clientY };\n\n    const end = () => {\n      session.current = null;\n      if (!dragging.current) return;\n      dragging.current = null;\n      setDragging(false);\n      try {\n        origin.releasePointerCapture?.(pointerId);\n      } catch {\n        // Capture is already gone whenever the session ended by losing it.\n      }\n    };\n\n    // Armed, not capturing. Capture retargets mouseup to this element, and the\n    // browser then synthesizes no `click` on the child under the cursor — so\n    // capturing on press makes every non-native control in the panel dead to a\n    // real mouse, silently. `isInteractive` only exempts the names it lists; a\n    // `role=\"button\"` span, a react-aria control or a canvas is not among them.\n    session.current = openPointerSession(\n      origin,\n      e,\n      {\n        onMove: (ev) => {\n          if (!dragging.current) {\n            if (Math.hypot(ev.clientX - start.x, ev.clientY - start.y) < DRAG_THRESHOLD) return;\n            dragging.current = { ...start };\n            setDragging(true);\n            origin.setPointerCapture?.(pointerId);\n          }\n          const from = dragging.current;\n          const dx = ev.clientX - from.x;\n          const dy = ev.clientY - from.y;\n          if (dx === 0 && dy === 0) return;\n          dragging.current = { x: ev.clientX, y: ev.clientY };\n          const { container: box, options: opts, item: only } = layout.current;\n          setPlace(\n            (prev) =>\n              strategy.reduce?.(\n                { at: { [ITEM_ID]: prev }, inner: undefined },\n                {\n                  affordanceId: `${FLOATING_DRAG_PREFIX}${ITEM_ID}`,\n                  kind: 'drag',\n                  payload: { dx, dy },\n                },\n                { container: box, options: opts, items: [only] },\n              ).at[ITEM_ID] ?? prev,\n          );\n        },\n        onEnd: end,\n        onCancel: end,\n      },\n      { capture: false },\n    );\n  };\n\n  return (\n    <div\n      className={className ? `lk-floating-panel ${className}` : 'lk-floating-panel'}\n      data-dragging={isDragging ? 'true' : undefined}\n      data-placed={rect ? 'true' : undefined}\n      onPointerDown={onPointerDown}\n      ref={ref}\n      style={\n        {\n          position: 'absolute',\n          left: `${rect?.x ?? 0}px`,\n          top: `${rect?.y ?? 0}px`,\n        } as CSSProperties\n      }\n    >\n      {children}\n    </div>\n  );\n}\n"]}

package/dist/{chunk-A2ACAGW6.js → chunk-O6FFFOHS.js}

@@ -1,4 +1,4 @@
-import { isAuto, resolveAutoConfig } from './chunk-REOBGYMC.js';
+import { isAuto, resolveAutoConfig } from './chunk-TJ77A4A3.js';
 import { useMemo } from 'react';
 
 // src/config/builder.ts
@@ -57,7 +57,12 @@ var BaseNode = class {
   }
   /** Draw this one row yourself, keeping the kind, default and validation. */
   render(renderer) {
-    return this.opt({ render: renderer });
+    return this.opt({ render: renderer, dialog: void 0 });
+  }
+  /** Draw this row as a button that opens a dialog, with `body` as the
+   *  dialog's content — for an editor too big for the row. */
+  dialog(body, opts) {
+    return this.opt({ dialog: { ...opts, body }, render: void 0 });
   }
   /**
    * Compute this leaf's value while it is auto, instead of leaving it
@@ -95,7 +100,7 @@ var NumberNode = class extends BaseNode {
   suffix(suffix) {
     return this.ann({ suffix });
   }
-  /** Show the value in a named format — `'compact'` reads `2.0M`. Presentation
+  /** Show the value in a named format — `'compact'` reads `2.00M`. Presentation
    *  only: the stored value stays a plain number, and a typed `2.5m` reads back. */
   format(format) {
     return this.ann({ format });
@@ -138,6 +143,13 @@ var StringNode = class extends BaseNode {
     return this.ann({ debounceMs });
   }
 };
+var ListNode = class extends BaseNode {
+  kind = "list";
+  /** Shown in an empty entry. */
+  placeholder(placeholder) {
+    return this.ann({ placeholder });
+  }
+};
 var ColorNode = class extends BaseNode {
   kind = "color";
   /** The value carries alpha as `#rrggbbaa`, and the row gets an opacity
@@ -215,6 +227,9 @@ var f = {
   boolean: (def) => new BooleanNode(def),
   string: (def) => new StringNode(def),
   color: (def) => new ColorNode(def),
+  /** A list of strings. Its row summarizes the list, and opens a dialog to
+   *  edit it one entry per field. */
+  list: (def) => new ListNode([...def]),
   /** A fixed set of choices. The default's literal type flows into the config
    *  type, so `f.enum('fast', ['fast', 'accurate'])` gives
    *  `'fast' | 'accurate'` with no `as const`. */
@@ -242,6 +257,8 @@ function titleCase(key) {
 var kindFromValue = (ctx) => {
   const t = typeof ctx.default;
   if (t === "boolean" || t === "number" || t === "string") return { kind: t };
+  const d = ctx.default;
+  if (Array.isArray(d) && d.every((v) => typeof v === "string")) return { kind: "list" };
   return null;
 };
 var labelFromKey = (ctx) => ({ name: titleCase(ctx.key) });
@@ -282,10 +299,17 @@ function resolveConfigSchema(schema, rules = []) {
     sections: [],
     showIf: /* @__PURE__ */ new Map(),
     renderers: {},
+    dialogs: {},
     chain: [...rules, ...builtinRules]
   };
   const group = resolveShape(schema.nodes, "", "", sink);
-  return { group, sections: sink.sections, showIf: sink.showIf, renderers: sink.renderers };
+  return {
+    group,
+    sections: sink.sections,
+    showIf: sink.showIf,
+    renderers: sink.renderers,
+    dialogs: sink.dialogs
+  };
 }
 function resolveShape(shape, at, name, sink) {
   const children = {};
@@ -310,6 +334,7 @@ function resolveShape(shape, at, name, sink) {
     }
     if (predicate) sink.showIf.set(path, predicate);
     if (!isConfigBranch(entry) && entry.options.render) sink.renderers[path] = entry.options.render;
+    if (!isConfigBranch(entry) && entry.options.dialog) sink.dialogs[path] = entry.options.dialog;
   }
   return { name, children };
 }
@@ -357,6 +382,6 @@ function useResolvedConfig(schema, config, autoPaths) {
   return { config: resolvedConfig, auto };
 }
 
-export { BaseNode, BooleanNode, ColorNode, CustomNode, EnumNode, GroupNode, NumberNode, StringNode, ValueNode, applyRules, builtinRules, f, isConfigBranch, resolveConfigSchema, titleCase, useResolvedConfig };
-//# sourceMappingURL=chunk-A2ACAGW6.js.map
-//# sourceMappingURL=chunk-A2ACAGW6.js.map
+export { BaseNode, BooleanNode, ColorNode, CustomNode, EnumNode, GroupNode, ListNode, NumberNode, StringNode, ValueNode, applyRules, builtinRules, f, isConfigBranch, resolveConfigSchema, titleCase, useResolvedConfig };
+//# sourceMappingURL=chunk-O6FFFOHS.js.map
+//# sourceMappingURL=chunk-O6FFFOHS.js.map

package/dist/chunk-O6FFFOHS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/builder.ts","../src/config/rules.ts","../src/config/resolve.ts","../src/config/useResolvedConfig.ts"],"names":[],"mappings":"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","file":"chunk-O6FFFOHS.js","sourcesContent":["import type { PrefLeaf, PrefNumberFormat, PrefNumberUnit } from '@weasel-js/ui';\nimport { type Auto, isAuto } from './auto';\nimport type {\n  Annotations,\n  BranchAnnotations,\n  BranchOptions,\n  ConfigBranch,\n  ConfigEntry,\n  ConfigNode,\n  ConfigOption,\n  ConfigSchema,\n  ConfigShape,\n  ControlRenderer,\n  InDialogOptions,\n  InferConfig,\n  NodeOptions,\n  SectionOption,\n} from './types';\n\n/** Whether a schema entry is a branch rather than a leaf. */\nexport function isConfigBranch(entry: ConfigEntry): entry is ConfigBranch {\n  return 'children' in entry;\n}\n\n/** Shared chaining surface. Every method clones, so a node can be reused as a\n *  base for several leaves without one bleeding into the next. */\nexport abstract class BaseNode<T> implements ConfigNode<T> {\n  abstract readonly kind: string | null;\n\n  // `default` is a reserved word in a parameter position, so the field is\n  // declared rather than taken as a parameter property.\n  readonly default: T;\n\n  constructor(\n    defaultValue: T,\n    readonly annotations: Readonly<Annotations> = {},\n    readonly options: Readonly<NodeOptions> = {},\n  ) {\n    this.default = defaultValue;\n  }\n\n  /** Clone into the same subclass. Subclasses with extra constructor\n   *  arguments override this. */\n  protected with(annotations: Annotations, options: NodeOptions): this {\n    const Ctor = this.constructor as new (d: T, a: Annotations, o: NodeOptions) => this;\n    return new Ctor(this.default, annotations, options);\n  }\n\n  protected ann(patch: Annotations): this {\n    return this.with({ ...this.annotations, ...patch }, this.options);\n  }\n\n  protected opt(patch: NodeOptions): this {\n    return this.with(this.annotations, { ...this.options, ...patch });\n  }\n\n  /** Human-readable label. Defaults to the key, title-cased. */\n  label(name: string): this {\n    return this.ann({ name });\n  }\n\n  /** Longer help text, surfaced as a tooltip on the row label. */\n  describe(description: string): this {\n    return this.ann({ description });\n  }\n\n  /** Omit from the panel unless it is asked to show hidden leaves. */\n  hidden(): this {\n    return this.ann({ hidden: true });\n  }\n\n  /** Pair with a sibling sharing this id, side-by-side on one row. */\n  pair(pair: string): this {\n    return this.ann({ pair });\n  }\n\n  /** Render under a named section heading. `collapsed` opens the section\n   *  folded, and `layout` and `pack` lay out its rows — say each on any one of\n   *  the section's leaves. */\n  section(label: string, opts: Omit<SectionOption, 'label'> = {}): this {\n    return this.opt({ section: { label, ...opts } });\n  }\n\n  /** Show this row only while the predicate holds. Presentational — the value\n   *  stays in config and the instrument still reads it. */\n  showIf(predicate: (config: Record<string, unknown>) => boolean): this {\n    return this.opt({ showIf: predicate });\n  }\n\n  /** Draw this one row yourself, keeping the kind, default and validation. */\n  render(renderer: ControlRenderer): this {\n    return this.opt({ render: renderer, dialog: undefined });\n  }\n\n  /** Draw this row as a button that opens a dialog, with `body` as the\n   *  dialog's content — for an editor too big for the row. */\n  dialog(body: ControlRenderer, opts?: InDialogOptions): this {\n    return this.opt({ dialog: { ...opts, body }, render: undefined });\n  }\n\n  /**\n   * Compute this leaf's value while it is auto, instead of leaving it\n   * `undefined`. The resolver is given the config with every other auto path\n   * already resolved.\n   */\n  auto(resolve: (config: Record<string, unknown>) => T): this {\n    return this.opt({ autoResolve: resolve as (c: Record<string, unknown>) => unknown });\n  }\n\n  /**\n   * Start this leaf auto rather than pinned at its default. Takes `auto` and\n   * nothing else — the constructor argument already declares the value, and a\n   * second way to say it would fight with the first.\n   */\n  initial(value: Auto): this {\n    if (!isAuto(value)) throw new Error('[labkit] .initial() takes `auto` and nothing else');\n    return this.opt({ unpinned: true });\n  }\n\n  /** Never auto. The row's label does not toggle. */\n  manual(): this {\n    return this.opt({ manual: true });\n  }\n}\n\nexport class NumberNode extends BaseNode<number> {\n  readonly kind = 'number';\n\n  /** Bound the value. A number with both bounds renders as a slider. */\n  range(min: number, max: number): this {\n    return this.ann({ min, max });\n  }\n\n  step(step: number): this {\n    return this.ann({ step });\n  }\n\n  /** A display suffix for the value — `'px'`, `'ms'`, `'°'`. Presentation only:\n   *  it is never parsed, and the stored value stays a plain number. */\n  suffix(suffix: string): this {\n    return this.ann({ suffix });\n  }\n\n  /** Show the value in a named format — `'compact'` reads `2.00M`. Presentation\n   *  only: the stored value stays a plain number, and a typed `2.5m` reads back. */\n  format(format: PrefNumberFormat): this {\n    return this.ann({ format });\n  }\n\n  /**\n   * Store the value in one unit and edit it in another — radians stored,\n   * degrees typed. `min`, `max` and `step` are declared in the stored unit\n   * alongside the value, and convert with it. `prefUnit` builds one from a\n   * `UnitSystem`.\n   */\n  unit(unit: PrefNumberUnit): this {\n    return this.ann({ unit });\n  }\n\n  /** Force a slider even without both bounds. */\n  slider(): this {\n    return this.ann({ control: 'slider' });\n  }\n\n  /** Force a typed input even when both bounds are set. */\n  input(): this {\n    return this.ann({ control: 'input' });\n  }\n}\n\nexport class BooleanNode extends BaseNode<boolean> {\n  readonly kind = 'boolean';\n\n  /** Ask for a switch rather than a checkbox. */\n  toggle(): this {\n    return this.ann({ control: 'switch' });\n  }\n}\n\nexport class StringNode extends BaseNode<string> {\n  readonly kind = 'string';\n\n  placeholder(placeholder: string): this {\n    return this.ann({ placeholder });\n  }\n\n  maxLength(maxLength: number): this {\n    return this.ann({ maxLength });\n  }\n\n  /** Milliseconds to debounce live writes. 0 commits every keystroke. */\n  debounce(debounceMs: number): this {\n    return this.ann({ debounceMs });\n  }\n}\n\nexport class ListNode extends BaseNode<string[]> {\n  readonly kind = 'list';\n\n  /** Shown in an empty entry. */\n  placeholder(placeholder: string): this {\n    return this.ann({ placeholder });\n  }\n}\n\nexport class ColorNode extends BaseNode<string> {\n  readonly kind = 'color';\n\n  /** The value carries alpha as `#rrggbbaa`, and the row gets an opacity\n   *  track beside the swatch. */\n  alpha(): this {\n    return this.ann({ alpha: true });\n  }\n}\n\nexport class EnumNode<T extends string> extends BaseNode<T> {\n  readonly kind = 'enum';\n\n  /** Render as a segmented control rather than a select. */\n  radio(): this {\n    return this.ann({ control: 'radio' });\n  }\n\n  /** Relabel the choices. Named `labels` rather than `options` because\n   *  `options` is the node's own extras bag. */\n  labels(options: readonly ConfigOption[]): this {\n    return this.ann({ options });\n  }\n}\n\n/** A leaf whose kind the rule chain decides. */\nexport class ValueNode<T> extends BaseNode<T> {\n  readonly kind = null;\n}\n\n/** A leaf of a kind labkit does not ship a row for. */\nexport class CustomNode<T> extends BaseNode<T> {\n  constructor(\n    readonly kind: string,\n    defaultValue: T,\n    annotations: Readonly<Annotations> = {},\n    options: Readonly<NodeOptions> = {},\n  ) {\n    super(defaultValue, annotations, options);\n  }\n\n  protected override with(annotations: Annotations, options: NodeOptions): this {\n    return new CustomNode(this.kind, this.default, annotations, options) as this;\n  }\n}\n\n/**\n * A branch of the schema: its children nest under its key, so a leaf inside\n * one is read and written at a dotted path. Distinct from `.section()`, which\n * puts a heading over sibling leaves and leaves their paths alone.\n */\nexport class GroupNode<S extends ConfigShape> implements ConfigBranch<S> {\n  constructor(\n    readonly children: S,\n    readonly annotations: Readonly<BranchAnnotations> = {},\n    readonly options: Readonly<BranchOptions> = {},\n  ) {}\n\n  private with(annotations: BranchAnnotations, options: BranchOptions): GroupNode<S> {\n    return new GroupNode(this.children, annotations, options);\n  }\n\n  /** Heading for the group's rows. Defaults to the key, title-cased. */\n  label(name: string): GroupNode<S> {\n    return this.with({ ...this.annotations, name }, this.options);\n  }\n\n  /** Longer help text. Carried on the resolved `PrefGroup`; both weasel-ui's\n   *  `PrefsForm` and `ControlPanel` draw it under the heading. */\n  describe(description: string): GroupNode<S> {\n    return this.with({ ...this.annotations, description }, this.options);\n  }\n\n  /** Render this whole group under a named section heading. */\n  section(label: string, opts: Omit<SectionOption, 'label'> = {}): GroupNode<S> {\n    return this.with(this.annotations, { ...this.options, section: { label, ...opts } });\n  }\n\n  /** Show this group only while the predicate holds. Presentational — every\n   *  value beneath it stays in config and the instrument still reads it. */\n  showIf(predicate: (config: Record<string, unknown>) => boolean): GroupNode<S> {\n    return this.with(this.annotations, { ...this.options, showIf: predicate });\n  }\n}\n\n/** Every default in a shape, nested the way the shape is. */\nfunction shapeDefaults(shape: ConfigShape): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n  for (const [key, entry] of Object.entries(shape)) {\n    out[key] = isConfigBranch(entry) ? shapeDefaults(entry.children) : entry.default;\n  }\n  return out;\n}\n\nconst expand = <T extends string>(\n  options: readonly T[] | readonly ConfigOption[],\n): readonly ConfigOption[] =>\n  options.map((o) => (typeof o === 'string' ? { value: o, label: o } : o));\n\n/**\n * Builds an instrument's config: the values, their types, and how each is\n * edited, in one declaration.\n *\n * ```ts\n * const config = f.schema({\n *   showGrid: f.boolean(true),\n *   cellSize: f.number(20).range(5, 80).step(5).label('Grid spacing'),\n *   // Nested: read and written at `grid.color`.\n *   grid: f.group({ color: f.color('#ffffff') }),\n * })\n * ```\n */\nexport const f = {\n  number: (def: number): NumberNode => new NumberNode(def),\n  boolean: (def: boolean): BooleanNode => new BooleanNode(def),\n  string: (def: string): StringNode => new StringNode(def),\n  color: (def: string): ColorNode => new ColorNode(def),\n  /** A list of strings. Its row summarizes the list, and opens a dialog to\n   *  edit it one entry per field. */\n  list: (def: readonly string[]): ListNode => new ListNode([...def]),\n\n  /** A fixed set of choices. The default's literal type flows into the config\n   *  type, so `f.enum('fast', ['fast', 'accurate'])` gives\n   *  `'fast' | 'accurate'` with no `as const`. */\n  enum: <const T extends string>(\n    def: T,\n    options: readonly T[] | readonly ConfigOption[],\n  ): EnumNode<T> => new EnumNode<T>(def, { options: expand(options) }),\n\n  /** A leaf with no declared kind: the rule chain decides, which is how a lab\n   *  states a convention like \"every `*Color` key is a color picker\". */\n  value: <T>(def: T): ValueNode<T> => new ValueNode(def),\n\n  /** A branch: its children nest under this key, so `grid: f.group({ size })`\n   *  puts the value at `config.grid.size` and addresses it as `'grid.size'`.\n   *  Groups nest as deeply as the schema wants. */\n  group: <const S extends ConfigShape>(children: S): GroupNode<S> => new GroupNode(children),\n\n  /** A leaf of a kind a lab supplies the control for, through `controls`. */\n  custom: <T>(\n    kind: string,\n    def: T,\n    validate?: (leaf: PrefLeaf, config: Record<string, unknown>) => string[],\n  ): CustomNode<T> => new CustomNode(kind, def, {}, validate ? { validate } : {}),\n\n  /** Collect leaves and groups into an instrument's config. */\n  schema<S extends ConfigShape>(nodes: S): ConfigSchema<InferConfig<S>> {\n    return { nodes, defaults: () => shapeDefaults(nodes) as InferConfig<S> };\n  },\n};\n","import type { ConfigRule, ConfigRuleContext, LeafPatch } from './types';\n\n/** `cellSize` -> `Cell size`. Splits camelCase without shattering acronyms. */\nexport function titleCase(key: string): string {\n  const words = key\n    .replace(/[_-]+/g, ' ')\n    .split(/(?<=[a-z0-9])(?=[A-Z])/)\n    .join(' ')\n    .trim()\n    .toLowerCase();\n  return words.length === 0 ? words : words[0].toUpperCase() + words.slice(1);\n}\n\n/** An `f.value` leaf takes its kind from the shape of its default. */\nconst kindFromValue: ConfigRule = (ctx) => {\n  const t = typeof ctx.default;\n  if (t === 'boolean' || t === 'number' || t === 'string') return { kind: t };\n  const d = ctx.default;\n  if (Array.isArray(d) && d.every((v) => typeof v === 'string')) return { kind: 'list' };\n  return null;\n};\n\nconst labelFromKey: ConfigRule = (ctx) => ({ name: titleCase(ctx.key) });\n\n/** A number bounded on both sides is a slider; one bound or none is an input. */\nconst sliderWhenBounded: ConfigRule = (ctx) => {\n  if (ctx.leaf.kind !== 'number') return null;\n  const bounded = ctx.leaf.min !== undefined && ctx.leaf.max !== undefined;\n  return bounded ? { control: 'slider' } : null;\n};\n\n/** `PrefBase.description` is required, so every leaf must end up with one. */\nconst descriptionDefault: ConfigRule = () => ({ description: '' });\n\n/**\n * labkit's own inference, expressed in the same vocabulary a consumer\n * extends. Runs after the consumer's rules, so a lab always wins.\n *\n * If one of these ever needs something a `ConfigRule` cannot express, the\n * seam is too weak — that is the point of writing them this way.\n */\nexport const builtinRules: readonly ConfigRule[] = [\n  kindFromValue,\n  labelFromKey,\n  sliderWhenBounded,\n  descriptionDefault,\n];\n\n/**\n * Fold a rule chain into one leaf patch. Gap-filling: a property already\n * settled is never overwritten, so the accumulator seeded with the author's\n * annotations beats every rule, and earlier rules beat later ones.\n */\nexport function applyRules(\n  seed: LeafPatch,\n  ctx: Omit<ConfigRuleContext, 'leaf'>,\n  rules: readonly ConfigRule[],\n): LeafPatch {\n  const acc: LeafPatch = { ...seed };\n  for (const rule of rules) {\n    const patch = rule({ ...ctx, leaf: acc });\n    if (patch === null) continue;\n    for (const [k, v] of Object.entries(patch)) {\n      if (v !== undefined && acc[k as keyof LeafPatch] === undefined) {\n        (acc as Record<string, unknown>)[k] = v;\n      }\n    }\n  }\n  return acc;\n}\n","import type { PrefGroup, PrefLeaf } from '@weasel-js/ui';\nimport { isConfigBranch } from './builder';\nimport { applyRules, builtinRules, titleCase } from './rules';\nimport type {\n  ConfigEntry,\n  ConfigRule,\n  ConfigSchema,\n  ConfigShape,\n  ControlRenderer,\n  DialogSpec,\n  LeafPatch,\n  ResolvedConfig,\n  SectionSpec,\n} from './types';\n\n/** Drop keys whose value is undefined, so an unset annotation stays a gap the\n *  rule chain can fill rather than a settled `undefined`. */\nfunction defined(annotations: Record<string, unknown>): LeafPatch {\n  const out: Record<string, unknown> = {};\n  for (const [k, v] of Object.entries(annotations)) if (v !== undefined) out[k] = v;\n  return out as LeafPatch;\n}\n\n/** What the walk collects on the side of the `PrefGroup` tree. */\ninterface Sink {\n  sections: SectionSpec[];\n  showIf: Map<string, (config: Record<string, unknown>) => boolean>;\n  renderers: Record<string, ControlRenderer>;\n  dialogs: Record<string, DialogSpec>;\n  chain: readonly ConfigRule[];\n}\n\n/**\n * Resolve a schema into the vocabulary weasel-ui renders, running each leaf\n * through the consumer's rules and then labkit's own.\n *\n * The group mirrors the schema's own nesting: an `f.group` becomes a nested\n * `PrefGroup`, so a leaf's dotted path within the tree is the path its value\n * is written at, and both `ControlPanel` and `PrefsForm` address it\n * identically.\n */\nexport function resolveConfigSchema<TC>(\n  schema: ConfigSchema<TC>,\n  rules: readonly ConfigRule[] = [],\n): ResolvedConfig {\n  const sink: Sink = {\n    sections: [],\n    showIf: new Map(),\n    renderers: {},\n    dialogs: {},\n    chain: [...rules, ...builtinRules],\n  };\n  const group = resolveShape(schema.nodes, '', '', sink);\n  return {\n    group,\n    sections: sink.sections,\n    showIf: sink.showIf,\n    renderers: sink.renderers,\n    dialogs: sink.dialogs,\n  };\n}\n\n/** A section while it is still being filled. */\ntype OpenSection = Omit<SectionSpec, 'paths'> & { paths: string[] };\n\nfunction resolveShape(shape: ConfigShape, at: string, name: string, sink: Sink): PrefGroup {\n  const children: Record<string, PrefLeaf | PrefGroup> = {};\n  const sections = new Map<string, OpenSection>();\n\n  for (const [key, entry] of Object.entries(shape)) {\n    const path = at === '' ? key : `${at}.${key}`;\n    children[key] = resolveEntry(entry, key, path, sink);\n\n    const { section, showIf: predicate } = entry.options;\n    if (section !== undefined) {\n      let spec = sections.get(section.label);\n      if (!spec) {\n        spec = { at, label: section.label, paths: [] };\n        sections.set(section.label, spec);\n        sink.sections.push(spec);\n      }\n      spec.paths.push(path);\n      // One node saying `collapsed` settles the section, so a schema does not\n      // have to repeat it on every node under the heading.\n      if (section.collapsed !== undefined) {\n        spec.collapsed = (spec.collapsed ?? false) || section.collapsed;\n      }\n      if (section.layout !== undefined && spec.layout === undefined) spec.layout = section.layout;\n      if (section.pack !== undefined && spec.pack === undefined) spec.pack = section.pack;\n    }\n    if (predicate) sink.showIf.set(path, predicate);\n    if (!isConfigBranch(entry) && entry.options.render) sink.renderers[path] = entry.options.render;\n    if (!isConfigBranch(entry) && entry.options.dialog) sink.dialogs[path] = entry.options.dialog;\n  }\n\n  return { name, children };\n}\n\nfunction resolveEntry(\n  entry: ConfigEntry,\n  key: string,\n  path: string,\n  sink: Sink,\n): PrefLeaf | PrefGroup {\n  if (isConfigBranch(entry)) {\n    const group = resolveShape(\n      entry.children,\n      path,\n      entry.annotations.name ?? titleCase(key),\n      sink,\n    );\n    return entry.annotations.description === undefined\n      ? group\n      : { ...group, description: entry.annotations.description };\n  }\n  if (entry.options.manual && entry.options.unpinned) {\n    throw new Error(\n      `[labkit] \"${path}\" is both .manual() and .initial(auto) — a field that can never be auto cannot start auto`,\n    );\n  }\n  const seed: LeafPatch = defined({\n    ...entry.annotations,\n    ...(entry.kind === null ? {} : { kind: entry.kind }),\n  });\n  const patch = applyRules(seed, { key, path, default: entry.default }, sink.chain);\n  const { autoResolve, unpinned, manual } = entry.options;\n  return {\n    ...patch,\n    default: entry.default,\n    // Extra keys survive onto the leaf at runtime; `ControlPanel` reads them\n    // back with its `extra<T>` helper, the same as `min`, `step` and the rest.\n    ...(autoResolve === undefined ? {} : { autoResolve }),\n    ...(unpinned === undefined ? {} : { unpinned }),\n    ...(manual === undefined ? {} : { manual }),\n  } as PrefLeaf;\n}\n","import { useMemo } from 'react';\nimport { resolveAutoConfig } from './autoConfig';\nimport type { ResolvedConfig } from './types';\n\nconst NONE: ReadonlySet<string> = new Set();\n\n/**\n * The config an instrument reads: the stored one with every unpinned path\n * resolved. The single place resolution happens, so `Trial` and\n * `useTrialState` cannot disagree about what an instrument is looking at.\n */\nexport function useResolvedConfig<TC>(\n  schema: ResolvedConfig | undefined,\n  config: TC,\n  autoPaths: readonly string[] | undefined,\n): { config: TC; auto: ReadonlySet<string> } {\n  const auto = useMemo(\n    () => (autoPaths && autoPaths.length > 0 ? new Set(autoPaths) : NONE),\n    [autoPaths],\n  );\n  const resolvedConfig = useMemo(\n    () => (schema ? resolveAutoConfig(schema, config, auto) : config),\n    [schema, config, auto],\n  );\n  return { config: resolvedConfig, auto };\n}\n"]}