@weasel-js/labkit 1.4.4 → 1.5.1

package/dist/{chunk-SMHP6XZ4.js → chunk-UN4U4P63.js}

@@ -1,8 +1,8 @@
-import { y2, f2 } from './chunk-W3ECWC2K.js';
 import { CanvasStackContext } from './chunk-CQLQPQ4P.js';
+import { b2, g2 } from './chunk-T3EC2DXD.js';
 import { useRef, useCallback, useEffect, useState, useContext } from 'react';
 import { jsx, jsxs } from 'react/jsx-runtime';
-import { useVisibleRaf } from '@weasel-js/core';
+import { useVisibleRaf, normalizeZoom } from '@weasel-js/core';
 
 function nextIndex(current, key, count, orientation = "horizontal") {
   if (count === 0) return null;
@@ -209,10 +209,12 @@ function ZoomControl({
   zoom,
   onZoomChange,
   onZoomCommit,
-  min = 0.1,
-  max = 8,
+  min: minProp = 0.1,
+  max: maxProp = 8,
   className
 }) {
+  const min = normalizeZoom(minProp);
+  const max = normalizeZoom(maxProp);
   const commit = onZoomCommit ?? onZoomChange;
   const emit = (track, done) => {
     const next = clamp(fromTrack(track), min, max);
@@ -220,7 +222,7 @@ function ZoomControl({
   };
   return /* @__PURE__ */ jsxs("div", { className: `lk-zoom${className ? ` ${className}` : ""}`, children: [
     /* @__PURE__ */ jsx(
-      y2,
+      b2,
       {
         className: "lk-zoom__slider",
         ariaLabel: "Zoom",
@@ -235,7 +237,7 @@ function ZoomControl({
       }
     ),
     /* @__PURE__ */ jsx(
-      f2,
+      g2,
       {
         className: "lk-zoom__field",
         width: "fit",
@@ -264,5 +266,5 @@ function Section({ children, end }) {
 StatusBar.Section = Section;
 
 export { FpsMeter, ScaleIndicator, StatusBar, Toolbar, ZoomControl, useRovingTabIndex };
-//# sourceMappingURL=chunk-SMHP6XZ4.js.map
-//# sourceMappingURL=chunk-SMHP6XZ4.js.map
+//# sourceMappingURL=chunk-UN4U4P63.js.map
+//# sourceMappingURL=chunk-UN4U4P63.js.map

package/dist/chunk-UN4U4P63.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/primitives/useRovingTabIndex.ts","../src/primitives/Toolbar.tsx","../src/primitives/fpsAverage.ts","../src/primitives/FpsMeter.tsx","../src/primitives/ScaleIndicator.tsx","../src/primitives/ZoomControl.tsx","../src/primitives/StatusBar.tsx"],"names":["useRef","useEffect","jsx","jsxs","b","g"],"mappings":"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","file":"chunk-UN4U4P63.js","sourcesContent":["import { type KeyboardEvent, useCallback, useEffect, useRef } from 'react';\n\n/** Which axis a toolbar's arrow keys walk. Matches `aria-orientation`. */\nexport type RovingOrientation = 'horizontal' | 'vertical';\n\n/** Where a key takes focus within `count` items, or null if it does not move it.\n *\n *  Only the arrows on the toolbar's own axis move focus — APG leaves the\n *  cross-axis arrows to the page, so a vertical strip does not swallow\n *  ArrowLeft. `Home` / `End` work on both. */\nexport function nextIndex(\n  current: number,\n  key: string,\n  count: number,\n  orientation: RovingOrientation = 'horizontal',\n): number | null {\n  if (count === 0) return null;\n  const forward = orientation === 'vertical' ? 'ArrowDown' : 'ArrowRight';\n  const back = orientation === 'vertical' ? 'ArrowUp' : 'ArrowLeft';\n  if (key === forward) return (current + 1) % count;\n  if (key === back) return (current - 1 + count) % count;\n  if (key === 'Home') return 0;\n  if (key === 'End') return count - 1;\n  return null;\n}\n\n/**\n * The APG roving-tabindex contract: exactly one item in the tab order, arrows\n * moving focus within. `tabIndex` is written onto the DOM nodes rather than\n * threaded through props, because the items are arbitrary children — the\n * container never sees them as a list it could index.\n */\nexport function useRovingTabIndex<T extends HTMLElement>(\n  orientation: RovingOrientation = 'horizontal',\n) {\n  const ref = useRef<T | null>(null);\n  const stop = useRef(0);\n\n  const items = useCallback(\n    (): HTMLElement[] =>\n      ref.current\n        ? Array.from(\n            ref.current.querySelectorAll<HTMLElement>('button:not([disabled]), [role=\"button\"]'),\n          )\n        : [],\n    [],\n  );\n\n  const setTabStop = useCallback(\n    (index: number) => {\n      const found = items();\n      const at = Math.min(Math.max(index, 0), Math.max(found.length - 1, 0));\n      stop.current = at;\n      for (const [i, el] of found.entries()) el.tabIndex = i === at ? 0 : -1;\n    },\n    [items],\n  );\n\n  // Re-establish the tab stop whenever the item set changes — a trial's toolbar\n  // contributions are dynamic, and `disabled` moves a button in and out of the\n  // set without touching the child list. The focused item keeps the stop.\n  useEffect(() => {\n    const resync = () => {\n      const focused = items().indexOf(document.activeElement as HTMLElement);\n      setTabStop(focused === -1 ? stop.current : focused);\n    };\n    resync();\n    if (!ref.current) return;\n    const mo = new MutationObserver(resync);\n    mo.observe(ref.current, { childList: true, subtree: true, attributeFilter: ['disabled'] });\n    return () => mo.disconnect();\n  }, [items, setTabStop]);\n\n  const onKeyDown = useCallback(\n    (e: KeyboardEvent<T>) => {\n      const found = items();\n      const current = found.indexOf(document.activeElement as HTMLElement);\n      const next = nextIndex(current === -1 ? 0 : current, e.key, found.length, orientation);\n      if (next === null) return;\n      e.preventDefault();\n      found[next]?.focus();\n      setTabStop(next);\n    },\n    [items, setTabStop, orientation],\n  );\n\n  return { ref, onKeyDown };\n}\n","import type { MouseEventHandler, ReactNode } from 'react';\nimport { useRovingTabIndex } from './useRovingTabIndex';\n\n/** Props for `<Toolbar>`. */\nexport interface ToolbarProps {\n  children: ReactNode;\n  /** Names the toolbar for assistive tech. Required by the APG pattern when a\n   *  view holds more than one. */\n  'aria-label'?: string;\n}\n\n/** A horizontal bar of controls. Fill it with `<Toolbar.Title>`,\n *  `<Toolbar.Group>`, `<Toolbar.Button>` and `<Toolbar.Spacer>`. */\nexport function Toolbar({ children, 'aria-label': ariaLabel }: ToolbarProps) {\n  const { ref, onKeyDown } = useRovingTabIndex<HTMLDivElement>();\n  return (\n    <div\n      ref={ref}\n      className=\"lk-toolbar\"\n      role=\"toolbar\"\n      aria-label={ariaLabel}\n      onKeyDown={onKeyDown}\n    >\n      {children}\n    </div>\n  );\n}\n\ninterface TitleProps {\n  children: ReactNode;\n}\nfunction Title({ children }: TitleProps) {\n  return <span className=\"lk-toolbar-title\">{children}</span>;\n}\n\n/** Props for `<Toolbar.Group>`. */\nexport interface ToolbarGroupProps {\n  children: ReactNode;\n  /** Pushes this group, and everything after it, to the far end. */\n  end?: boolean;\n  'aria-label'?: string;\n}\n\n/** Related controls, kept tight and ruled off from their neighbors. Group\n *  rather than separate with repeated `<Toolbar.Spacer>`: consecutive spacers\n *  share the free space, so every gap collapses to the same slack and the bar\n *  reads as one undifferentiated run. */\nfunction Group({ children, end, 'aria-label': ariaLabel }: ToolbarGroupProps) {\n  return (\n    // biome-ignore lint/a11y/useSemanticElements: a group inside role=\"toolbar\" is the APG pattern; the rule is local and cannot see the parent. <fieldset> means form controls, needs a <legend> to be named, and its UA min-width breaks flex children.\n    <div\n      className={`lk-toolbar-group${end ? ' lk-toolbar-group--end' : ''}`}\n      role=\"group\"\n      aria-label={ariaLabel}\n    >\n      {children}\n    </div>\n  );\n}\n\n/** Props for `<Toolbar.Button>`. */\nexport interface ToolbarButtonProps {\n  children: ReactNode;\n  onClick: MouseEventHandler<HTMLButtonElement>;\n  disabled?: boolean;\n  title?: string;\n  /** Required when `children` is an icon with no text of its own. */\n  'aria-label'?: string;\n  /** `danger` reddens on hover — for actions that discard work. */\n  variant?: 'default' | 'danger';\n  /** Square, for a button whose whole content is one glyph. */\n  iconOnly?: boolean;\n  /** Makes this a toggle: `aria-pressed`, and held down while true. */\n  pressed?: boolean;\n}\n\nfunction Button({\n  children,\n  onClick,\n  disabled,\n  title,\n  'aria-label': ariaLabel,\n  variant = 'default',\n  iconOnly,\n  pressed,\n}: ToolbarButtonProps) {\n  const cls = [\n    'lk-toolbar-button',\n    variant === 'danger' && 'lk-toolbar-button--danger',\n    iconOnly && 'lk-toolbar-button--icon',\n    pressed && 'lk-toolbar-button--pressed',\n  ]\n    .filter(Boolean)\n    .join(' ');\n  return (\n    <button\n      type=\"button\"\n      className={cls}\n      onClick={onClick}\n      disabled={disabled}\n      title={title}\n      aria-label={ariaLabel ?? title}\n      aria-pressed={pressed}\n    >\n      {children}\n    </button>\n  );\n}\n\nfunction Spacer() {\n  return <span className=\"lk-toolbar-spacer\" aria-hidden=\"true\" />;\n}\n\n/** A label within a toolbar. */\nToolbar.Title = Title;\n/** A ruled-off run of related controls. */\nToolbar.Group = Group;\n/** A button within a toolbar. */\nToolbar.Button = Button;\n/** Flexible space that pushes what follows to the far end of the toolbar. */\nToolbar.Spacer = Spacer;\n","export function rollingAverage(samples: readonly number[]): number {\n  if (samples.length === 0) return 0;\n  const sum = samples.reduce((acc, n) => acc + n, 0);\n  return Math.round(sum / samples.length);\n}\n","import { useVisibleRaf } from '@weasel-js/core';\nimport { useEffect, useRef, useState } from 'react';\nimport { rollingAverage } from './fpsAverage';\n\nconst SAMPLE_WINDOW = 30;\n\n/** A live frame-rate readout, averaged over the last 30 frames. */\nexport function FpsMeter() {\n  const [fps, setFps] = useState(0);\n  const samplesRef = useRef<number[]>([]);\n  const lastTimeRef = useRef<number | null>(null);\n  const rootRef = useRef<HTMLDivElement | null>(null);\n\n  const loop = useVisibleRaf(\n    (time) => {\n      const last = lastTimeRef.current;\n      if (last !== null) {\n        const delta = time - last;\n        if (delta > 0) {\n          const samples = samplesRef.current;\n          samples.push(1000 / delta);\n          if (samples.length > SAMPLE_WINDOW) samples.shift();\n          setFps(rollingAverage(samples));\n        }\n      }\n      lastTimeRef.current = time;\n      loop.request();\n    },\n    {\n      target: rootRef,\n      // The gap spent suspended is not a frame that took an hour to draw.\n      onResume: () => {\n        lastTimeRef.current = null;\n      },\n    },\n  );\n\n  useEffect(() => {\n    loop.request();\n    return () => loop.cancel();\n  }, [loop]);\n\n  return (\n    <div className=\"lk-fps-meter\" ref={rootRef}>\n      <span className=\"lk-fps-meter-value\">FPS {fps}</span>\n    </div>\n  );\n}\n","import { useContext } from 'react';\nimport { CanvasStackContext } from '../canvas/CanvasStackContext';\n\n/** Props for `<ScaleIndicator>`. */\nexport interface ScaleIndicatorProps {\n  /** Current view zoom factor. If omitted, reads from CanvasStackContext. Defaults to 1. */\n  zoom?: number;\n  /** World pixels per unit at zoom=1. Default: 1. */\n  pixelsPerUnit?: number;\n  /** Unit label. Default: 'px'. */\n  unit?: string;\n  /** Target bar width in display pixels. Default: 100. */\n  targetWidth?: number;\n}\n\n// Rounds n to a \"nice\" number — 1, 2, 5, 10, 20, 50, ...\nfunction niceNumber(n: number): number {\n  if (n <= 0) return 1;\n  const exp = Math.floor(Math.log10(n));\n  const fraction = n / 10 ** exp;\n  let nice: number;\n  if (fraction < 1.5) nice = 1;\n  else if (fraction < 3.5) nice = 2;\n  else if (fraction < 7.5) nice = 5;\n  else nice = 10;\n  return nice * 10 ** exp;\n}\n\n/** A scale bar: a labeled rule showing how far a round number of world units\n *  is at the current zoom. Reads the zoom from the surrounding canvas stack\n *  unless one is passed. */\nexport function ScaleIndicator({\n  zoom,\n  pixelsPerUnit = 1,\n  unit = 'px',\n  targetWidth = 100,\n}: ScaleIndicatorProps) {\n  const ctxValue = useContext(CanvasStackContext);\n  const effectiveZoom = zoom ?? ctxValue?.view.zoom ?? 1;\n  const effectivePxPerUnit = pixelsPerUnit * effectiveZoom;\n  const targetUnits = targetWidth / effectivePxPerUnit;\n  const niceUnits = niceNumber(targetUnits);\n  const barWidth = niceUnits * effectivePxPerUnit;\n  return (\n    <div className=\"lk-scale-indicator\" role=\"img\" aria-label={`Scale: ${niceUnits} ${unit}`}>\n      <div className=\"lk-scale-indicator-bar\" style={{ width: `${barWidth}px` }} />\n      <span className=\"lk-scale-indicator-label\">\n        {niceUnits} {unit}\n      </span>\n    </div>\n  );\n}\n","import { normalizeZoom } from '@weasel-js/core';\nimport { NumberField, Slider } from '../passthrough/weasel-ui';\n\n/** Props for `<ZoomControl>`. */\nexport interface ZoomControlProps {\n  /** Current zoom as a scale factor: 1 is actual size. */\n  zoom: number;\n  /** Fired continuously while the slider drags. */\n  onZoomChange: (zoom: number) => void;\n  /** Fired when a drag settles or the field is committed. Defaults to\n   *  `onZoomChange`. */\n  onZoomCommit?: (zoom: number) => void;\n  /** Smallest selectable zoom. Defaults to 0.1 (10%). */\n  min?: number;\n  /** Largest selectable zoom. Defaults to 8 (800%). */\n  max?: number;\n  className?: string;\n}\n\n// Zoom is perceptually geometric — halving is as big a step as doubling — so\n// the slider runs on log2 and 100% lands mid-track for a symmetric range.\nconst toTrack = (zoom: number): number => Math.log2(zoom);\nconst fromTrack = (v: number): number => 2 ** v;\n\nconst clamp = (v: number, lo: number, hi: number): number => Math.max(lo, Math.min(hi, v));\n\n/** Zoom as a log-scaled slider with an editable percentage beside it. Pair it\n *  with zoom-in / zoom-out buttons in a `<Toolbar.Group>`; this component owns\n *  only the continuous part. */\nexport function ZoomControl({\n  zoom,\n  onZoomChange,\n  onZoomCommit,\n  min: minProp = 0.1,\n  max: maxProp = 8,\n  className,\n}: ZoomControlProps) {\n  const min = normalizeZoom(minProp);\n  const max = normalizeZoom(maxProp);\n  const commit = onZoomCommit ?? onZoomChange;\n  const emit = (track: number, done: boolean): void => {\n    const next = clamp(fromTrack(track), min, max);\n    (done ? commit : onZoomChange)(next);\n  };\n\n  return (\n    <div className={`lk-zoom${className ? ` ${className}` : ''}`}>\n      <Slider\n        className=\"lk-zoom__slider\"\n        ariaLabel=\"Zoom\"\n        density=\"slim\"\n        min={toTrack(min)}\n        max={toTrack(max)}\n        // Detents at the octaves plus actual size, so 25/50/100/200/400% are\n        // reachable by drag rather than only by typing.\n        stops={[-2, -1, 0, 1, 2]}\n        thumbs={[{ value: clamp(toTrack(zoom), toTrack(min), toTrack(max)) }]}\n        onInput={(next) => emit(next[0].value, false)}\n        onChange={(next) => emit(next[0].value, true)}\n        readoutPlacement=\"none\"\n      />\n      {/* `style: 'percent'` formats a fraction, so the field carries the scale\n          factor itself and renders 0.5 as \"50%\". */}\n      <NumberField\n        className=\"lk-zoom__field\"\n        width=\"fit\"\n        aria-label=\"Zoom\"\n        value={zoom}\n        minValue={min}\n        maxValue={max}\n        step={0.01}\n        hideSteppers\n        ghost\n        formatOptions={{ style: 'percent', maximumFractionDigits: 0 }}\n        onChange={(next) => {\n          if (!Number.isFinite(next)) return;\n          commit(clamp(next, min, max));\n        }}\n      />\n    </div>\n  );\n}\n","import type { ReactNode } from 'react';\n\n/** Props for `<StatusBar>`. */\nexport interface StatusBarProps {\n  children: ReactNode;\n}\n\n/** A footer strip for readouts. Fill it with `<StatusBar.Section>`. */\nexport function StatusBar({ children }: StatusBarProps) {\n  return <div className=\"lk-status-bar\">{children}</div>;\n}\n\n/** Props for `<StatusBar.Section>`. */\nexport interface StatusBarSectionProps {\n  children: ReactNode;\n  /** Pushes this section, and everything after it, to the far end. */\n  end?: boolean;\n}\nfunction Section({ children, end }: StatusBarSectionProps) {\n  return (\n    <span className={`lk-status-bar-section${end ? ' lk-status-bar-section--end' : ''}`}>\n      {children}\n    </span>\n  );\n}\n\n/** One readout within a status bar. */\nStatusBar.Section = Section;\n"]}

package/dist/chunk-WIG6XHJ7.js

@@ -0,0 +1,35 @@
+import { TrialIdContext } from './chunk-2YILQ7Y5.js';
+import { createContext, useContext, useCallback } from 'react';
+
+var SurfaceContext = createContext(null);
+var NO_CANVASES = { over: null, under: null };
+var SurfaceCanvasContext = createContext(NO_CANVASES);
+function useSurfaceCanvas(layer = "over") {
+  return useContext(SurfaceCanvasContext)[layer];
+}
+function useSurfaceOptional() {
+  return useContext(SurfaceContext);
+}
+function useSurface() {
+  const surface = useContext(SurfaceContext);
+  if (!surface) throw new Error("[labkit] useSurface requires a surface owner above it");
+  return surface;
+}
+function useTileId(id) {
+  const trial = useContext(TrialIdContext);
+  return trial ? `${trial}/${id}` : id;
+}
+function useSurfaceTile(id) {
+  const surface = useSurfaceOptional();
+  const tileId = useTileId(id);
+  return useCallback(
+    (el) => {
+      surface?.registerTile(tileId, el);
+    },
+    [surface, tileId]
+  );
+}
+
+export { SurfaceCanvasContext, SurfaceContext, useSurface, useSurfaceCanvas, useSurfaceOptional, useSurfaceTile, useTileId };
+//# sourceMappingURL=chunk-WIG6XHJ7.js.map
+//# sourceMappingURL=chunk-WIG6XHJ7.js.map

package/dist/chunk-WIG6XHJ7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/surface/SurfaceContext.ts","../src/surface/useSurfaceTile.ts"],"names":[],"mappings":";;;AAIO,IAAM,cAAA,GAAiB,cAAoC,IAAI;AAwBtE,IAAM,WAAA,GAA+B,EAAE,IAAA,EAAM,IAAA,EAAM,OAAO,IAAA,EAAK;AAGxD,IAAM,oBAAA,GAAuB,cAA+B,WAAW;ACvBvE,SAAS,gBAAA,CAAiB,QAAsB,MAAA,EAAkC;AACvF,EAAA,OAAO,UAAA,CAAW,oBAAoB,CAAA,CAAE,KAAK,CAAA;AAC/C;AAGO,SAAS,kBAAA,GAA2C;AACzD,EAAA,OAAO,WAAW,cAAc,CAAA;AAClC;AAGO,SAAS,UAAA,GAA4B;AAC1C,EAAA,MAAM,OAAA,GAAU,WAAW,cAAc,CAAA;AACzC,EAAA,IAAI,CAAC,OAAA,EAAS,MAAM,IAAI,MAAM,uDAAuD,CAAA;AACrF,EAAA,OAAO,OAAA;AACT;AAWO,SAAS,UAAU,EAAA,EAAoB;AAC5C,EAAA,MAAM,KAAA,GAAQ,WAAW,cAAc,CAAA;AACvC,EAAA,OAAO,KAAA,GAAQ,CAAA,EAAG,KAAK,CAAA,CAAA,EAAI,EAAE,CAAA,CAAA,GAAK,EAAA;AACpC;AAWO,SAAS,eAAe,EAAA,EAA8C;AAC3E,EAAA,MAAM,UAAU,kBAAA,EAAmB;AACnC,EAAA,MAAM,MAAA,GAAS,UAAU,EAAE,CAAA;AAC3B,EAAA,OAAO,WAAA;AAAA,IACL,CAAC,EAAA,KAA2B;AAC1B,MAAA,OAAA,EAAS,YAAA,CAAa,QAAQ,EAAE,CAAA;AAAA,IAClC,CAAA;AAAA,IACA,CAAC,SAAS,MAAM;AAAA,GAClB;AACF","file":"chunk-WIG6XHJ7.js","sourcesContent":["import { createContext } from 'react';\nimport type { SurfaceHandle } from './useTiledSurface';\n\n/** Null when no surface owner is above — a lab with no shared surface at all. */\nexport const SurfaceContext = createContext<SurfaceHandle | null>(null);\n\n/**\n * Which of the two stacked buffers a tenant paints into.\n *\n * `'over'` sits above the trial DOM: right for marks that annotate an\n * instrument, which is what the surface was built for and so the default.\n * `'under'` sits below it, which is what an opaque renderer needs — a tile that\n * fills its pane hides anything the pane's own DOM draws, so a 3D viewport on\n * the over-buffer has to paint its own chrome into the backend rather than\n * putting a label or a button in the pane.\n *\n * Both exist for the lifetime of the surface and share one set of tile rects,\n * so a lab can hold an annotated 2D trial and an opaque 3D one at once.\n */\nexport type SurfaceLayer = 'over' | 'under';\n\n/** The two buffers a surface owner publishes. A member is null until the\n *  owner's canvas mounts, and for an owner that keeps its surface unpainted. */\nexport interface SurfaceCanvases {\n  over: HTMLCanvasElement | null;\n  under: HTMLCanvasElement | null;\n}\n\nconst NO_CANVASES: SurfaceCanvases = { over: null, under: null };\n\n/** The buffers the surface's tiles paint into. */\nexport const SurfaceCanvasContext = createContext<SurfaceCanvases>(NO_CANVASES);\n","import { useCallback, useContext } from 'react';\nimport { TrialIdContext } from '../state/context';\nimport { SurfaceCanvasContext, SurfaceContext, type SurfaceLayer } from './SurfaceContext';\nimport type { SurfaceHandle } from './useTiledSurface';\n\n/** One of the surface's two shared buffers, or null where nothing paints one.\n *  What a tile hands to `paintInto`. See {@link SurfaceLayer} for which to ask\n *  for; the default is the one over the trial DOM. */\nexport function useSurfaceCanvas(layer: SurfaceLayer = 'over'): HTMLCanvasElement | null {\n  return useContext(SurfaceCanvasContext)[layer];\n}\n\n/** The surface above, or null. Use this where a surface is genuinely optional. */\nexport function useSurfaceOptional(): SurfaceHandle | null {\n  return useContext(SurfaceContext);\n}\n\n/** The surface above. Throws where a caller cannot work without one. */\nexport function useSurface(): SurfaceHandle {\n  const surface = useContext(SurfaceContext);\n  if (!surface) throw new Error('[labkit] useSurface requires a surface owner above it');\n  return surface;\n}\n\n/**\n * The key `id` is registered under, and so the key it comes back on in a\n * frame's `rects`: `<trial>/<id>` inside a trial, and `id` alone outside one.\n *\n * A surface's tile namespace is flat and shared by the whole lab, but an\n * instrument names its regions once and every trial of it declares those same\n * names. Unscoped, the second trial to mount takes the first one's rect and its\n * painter, and the first is never told it moved again.\n */\nexport function useTileId(id: string): string {\n  const trial = useContext(TrialIdContext);\n  return trial ? `${trial}/${id}` : id;\n}\n\n/**\n * A ref callback that publishes this element's rect to the surface under `id`.\n *\n * Attach it to whichever element the surface should draw into — that is not\n * necessarily the trial's own element, since a trial may hold a drawn pane beside\n * an undrawn one, or none at all.\n *\n * The frame reports it under `useTileId(id)`, not under `id`.\n */\nexport function useSurfaceTile(id: string): (el: HTMLElement | null) => void {\n  const surface = useSurfaceOptional();\n  const tileId = useTileId(id);\n  return useCallback(\n    (el: HTMLElement | null) => {\n      surface?.registerTile(tileId, el);\n    },\n    [surface, tileId],\n  );\n}\n"]}

package/dist/chunk-Z76KEZAX.js

@@ -0,0 +1,15 @@
+import { createContext, useContext } from 'react';
+
+// src/lab/LabContext.ts
+var LabContext = createContext(null);
+function useLabContext() {
+  const ctx = useContext(LabContext);
+  if (ctx === null) {
+    throw new Error("useLabContext must be used inside <Lab>");
+  }
+  return ctx;
+}
+
+export { LabContext, useLabContext };
+//# sourceMappingURL=chunk-Z76KEZAX.js.map
+//# sourceMappingURL=chunk-Z76KEZAX.js.map

package/dist/chunk-Z76KEZAX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lab/LabContext.ts"],"names":[],"mappings":";;;AA0CO,IAAM,UAAA,GAAa,cAAsC,IAAI;AAG7D,SAAS,aAAA,GAAiC;AAC/C,EAAA,MAAM,GAAA,GAAM,WAAW,UAAU,CAAA;AACjC,EAAA,IAAI,QAAQ,IAAA,EAAM;AAChB,IAAA,MAAM,IAAI,MAAM,yCAAyC,CAAA;AAAA,EAC3D;AACA,EAAA,OAAO,GAAA;AACT","file":"chunk-Z76KEZAX.js","sourcesContent":["import { createContext, useContext } from 'react';\nimport type { ConfigRule, ControlRenderer } from '../config/types';\nimport type { InstrumentList } from '../instrument/types';\nimport type { LabMode, SavedSnapshot, TrialRecord } from '../state/types';\nimport type { AddTrialOptions } from '../trial/trialOps';\n\n/** Lab-wide state and commands: the available instruments, the open\n *  trials and the operations over them, saved snapshots, and the color\n *  mode. */\nexport interface LabContextValue {\n  instruments: InstrumentList;\n  trials: TrialRecord[];\n  /** Open a trial running `instrumentName`. `options.config` is written over\n   *  that instrument's defaults, which is where a trial opened on a subject\n   *  says which subject. */\n  addTrial: (instrumentName: string, options?: AddTrialOptions) => void;\n  cloneTrial: (id: string) => void;\n  closeTrial: (id: string) => void;\n  resetTrial: (id: string) => void;\n  reorderTrials: (ids: readonly string[]) => void;\n  /** Put a fresh trial running `instrumentName` in trial `id`'s place, at its\n   *  size. The replacement has a new id, and takes the focus if `id` had it. */\n  swapTrial: (id: string, instrumentName: string, options?: AddTrialOptions) => void;\n  /** The trial last pointed at or focused, counting focus that moved into a\n   *  frame inside it. A trial `addTrial` or `cloneTrial` opens takes it. Falls\n   *  back to the first trial; null only when there are none. */\n  focusedTrialId: string | null;\n  focusTrial: (id: string) => void;\n  savedSnapshots: SavedSnapshot[];\n  saveSnapshot: (trialId: string, name?: string) => void;\n  loadSnapshot: (trialId: string, snapshotId: string) => void;\n  deleteSnapshot: (snapshotId: string) => void;\n  mode: LabMode;\n  setMode: (m: LabMode) => void;\n  /** Lab-wide rules run over every instrument's config leaves, before\n   *  labkit's own inference. */\n  configRules?: readonly ConfigRule[];\n  /** Lab-wide control overrides, keyed by config path or by leaf kind. */\n  controls?: Record<string, ControlRenderer>;\n}\n\n/** Context carrying the surrounding lab. Prefer `useLabContext`. */\nexport const LabContext = createContext<LabContextValue | null>(null);\n\n/** The surrounding lab. Throws outside a `<Lab>`. */\nexport function useLabContext(): LabContextValue {\n  const ctx = useContext(LabContext);\n  if (ctx === null) {\n    throw new Error('useLabContext must be used inside <Lab>');\n  }\n  return ctx;\n}\n"]}

package/dist/chunk-ZDHY47EV.js

@@ -0,0 +1,363 @@
+import { isAuto, resolveAutoConfig } from './chunk-7PFH3CNM.js';
+import { useMemo } from 'react';
+
+// src/config/builder.ts
+function isConfigBranch(entry) {
+  return "children" in entry;
+}
+var BaseNode = class {
+  constructor(defaultValue, annotations = {}, options = {}) {
+    this.annotations = annotations;
+    this.options = options;
+    this.default = defaultValue;
+  }
+  annotations;
+  options;
+  // `default` is a reserved word in a parameter position, so the field is
+  // declared rather than taken as a parameter property.
+  default;
+  /** Clone into the same subclass. Subclasses with extra constructor
+   *  arguments override this. */
+  with(annotations, options) {
+    const Ctor = this.constructor;
+    return new Ctor(this.default, annotations, options);
+  }
+  ann(patch) {
+    return this.with({ ...this.annotations, ...patch }, this.options);
+  }
+  opt(patch) {
+    return this.with(this.annotations, { ...this.options, ...patch });
+  }
+  /** Human-readable label. Defaults to the key, title-cased. */
+  label(name) {
+    return this.ann({ name });
+  }
+  /** Longer help text, surfaced as a tooltip on the row label. */
+  describe(description) {
+    return this.ann({ description });
+  }
+  /** Omit from the panel unless it is asked to show hidden leaves. */
+  hidden() {
+    return this.ann({ hidden: true });
+  }
+  /** Pair with a sibling sharing this id, side-by-side on one row. */
+  pair(pair) {
+    return this.ann({ pair });
+  }
+  /** Render under a named section heading. `collapsed` opens the section
+   *  folded, and `layout` and `pack` lay out its rows — say each on any one of
+   *  the section's leaves. */
+  section(label, opts = {}) {
+    return this.opt({ section: { label, ...opts } });
+  }
+  /** Show this row only while the predicate holds. Presentational — the value
+   *  stays in config and the instrument still reads it. */
+  showIf(predicate) {
+    return this.opt({ showIf: predicate });
+  }
+  /** Draw this one row yourself, keeping the kind, default and validation. */
+  render(renderer) {
+    return this.opt({ render: renderer });
+  }
+  /**
+   * Compute this leaf's value while it is auto, instead of leaving it
+   * `undefined`. The resolver is given the config with every other auto path
+   * already resolved.
+   */
+  auto(resolve) {
+    return this.opt({ autoResolve: resolve });
+  }
+  /**
+   * Start this leaf auto rather than pinned at its default. Takes `auto` and
+   * nothing else — the constructor argument already declares the value, and a
+   * second way to say it would fight with the first.
+   */
+  initial(value) {
+    if (!isAuto(value)) throw new Error("[labkit] .initial() takes `auto` and nothing else");
+    return this.opt({ unpinned: true });
+  }
+  /** Never auto. The row takes no pin dot and ignores the gesture. */
+  manual() {
+    return this.opt({ manual: true });
+  }
+};
+var NumberNode = class extends BaseNode {
+  kind = "number";
+  /** Bound the value. A number with both bounds renders as a slider. */
+  range(min, max) {
+    return this.ann({ min, max });
+  }
+  step(step) {
+    return this.ann({ step });
+  }
+  /** A display suffix for the value — `'px'`, `'ms'`, `'°'`. Presentation only:
+   *  it is never parsed, and the stored value stays a plain number. */
+  suffix(suffix) {
+    return this.ann({ suffix });
+  }
+  /** Show the value in a named format — `'compact'` reads `2.0M`. Presentation
+   *  only: the stored value stays a plain number, and a typed `2.5m` reads back. */
+  format(format) {
+    return this.ann({ format });
+  }
+  /**
+   * Store the value in one unit and edit it in another — radians stored,
+   * degrees typed. `min`, `max` and `step` are declared in the stored unit
+   * alongside the value, and convert with it. `prefUnit` builds one from a
+   * `UnitSystem`.
+   */
+  unit(unit) {
+    return this.ann({ unit });
+  }
+  /** Force a slider even without both bounds. */
+  slider() {
+    return this.ann({ control: "slider" });
+  }
+  /** Force a typed input even when both bounds are set. */
+  input() {
+    return this.ann({ control: "input" });
+  }
+};
+var BooleanNode = class extends BaseNode {
+  kind = "boolean";
+  /** Ask for a switch rather than a checkbox. */
+  toggle() {
+    return this.ann({ control: "switch" });
+  }
+};
+var StringNode = class extends BaseNode {
+  kind = "string";
+  placeholder(placeholder) {
+    return this.ann({ placeholder });
+  }
+  maxLength(maxLength) {
+    return this.ann({ maxLength });
+  }
+  /** Milliseconds to debounce live writes. 0 commits every keystroke. */
+  debounce(debounceMs) {
+    return this.ann({ debounceMs });
+  }
+};
+var ColorNode = class extends BaseNode {
+  kind = "color";
+  /** The value carries alpha as `#rrggbbaa`, and the row gets an opacity
+   *  track beside the swatch. */
+  alpha() {
+    return this.ann({ alpha: true });
+  }
+};
+var EnumNode = class extends BaseNode {
+  kind = "enum";
+  /** Render as a segmented control rather than a select. */
+  radio() {
+    return this.ann({ control: "radio" });
+  }
+  /** Relabel the choices. Named `labels` rather than `options` because
+   *  `options` is the node's own extras bag. */
+  labels(options) {
+    return this.ann({ options });
+  }
+};
+var ValueNode = class extends BaseNode {
+  kind = null;
+};
+var CustomNode = class _CustomNode extends BaseNode {
+  constructor(kind, defaultValue, annotations = {}, options = {}) {
+    super(defaultValue, annotations, options);
+    this.kind = kind;
+  }
+  kind;
+  with(annotations, options) {
+    return new _CustomNode(this.kind, this.default, annotations, options);
+  }
+};
+var GroupNode = class _GroupNode {
+  constructor(children, annotations = {}, options = {}) {
+    this.children = children;
+    this.annotations = annotations;
+    this.options = options;
+  }
+  children;
+  annotations;
+  options;
+  with(annotations, options) {
+    return new _GroupNode(this.children, annotations, options);
+  }
+  /** Heading for the group's rows. Defaults to the key, title-cased. */
+  label(name) {
+    return this.with({ ...this.annotations, name }, this.options);
+  }
+  /** Longer help text. Carried on the resolved `PrefGroup`, where weasel-ui's
+   *  `PrefsForm` draws it under the heading; `ControlPanel` has no place for
+   *  it yet and shows the heading alone. */
+  describe(description) {
+    return this.with({ ...this.annotations, description }, this.options);
+  }
+  /** Render this whole group under a named section heading. */
+  section(label, opts = {}) {
+    return this.with(this.annotations, { ...this.options, section: { label, ...opts } });
+  }
+  /** Show this group only while the predicate holds. Presentational — every
+   *  value beneath it stays in config and the instrument still reads it. */
+  showIf(predicate) {
+    return this.with(this.annotations, { ...this.options, showIf: predicate });
+  }
+};
+function shapeDefaults(shape) {
+  const out = {};
+  for (const [key, entry] of Object.entries(shape)) {
+    out[key] = isConfigBranch(entry) ? shapeDefaults(entry.children) : entry.default;
+  }
+  return out;
+}
+var expand = (options) => options.map((o) => typeof o === "string" ? { value: o, label: o } : o);
+var f = {
+  number: (def) => new NumberNode(def),
+  boolean: (def) => new BooleanNode(def),
+  string: (def) => new StringNode(def),
+  color: (def) => new ColorNode(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`. */
+  enum: (def, options) => new EnumNode(def, { options: expand(options) }),
+  /** A leaf with no declared kind: the rule chain decides, which is how a lab
+   *  states a convention like "every `*Color` key is a color picker". */
+  value: (def) => new ValueNode(def),
+  /** A branch: its children nest under this key, so `grid: f.group({ size })`
+   *  puts the value at `config.grid.size` and addresses it as `'grid.size'`.
+   *  Groups nest as deeply as the schema wants. */
+  group: (children) => new GroupNode(children),
+  /** A leaf of a kind a lab supplies the control for, through `controls`. */
+  custom: (kind, def, validate) => new CustomNode(kind, def, {}, validate ? { validate } : {}),
+  /** Collect leaves and groups into an instrument's config. */
+  schema(nodes) {
+    return { nodes, defaults: () => shapeDefaults(nodes) };
+  }
+};
+
+// src/config/rules.ts
+function titleCase(key) {
+  const words = key.replace(/[_-]+/g, " ").split(/(?<=[a-z0-9])(?=[A-Z])/).join(" ").trim().toLowerCase();
+  return words.length === 0 ? words : words[0].toUpperCase() + words.slice(1);
+}
+var kindFromValue = (ctx) => {
+  const t = typeof ctx.default;
+  if (t === "boolean" || t === "number" || t === "string") return { kind: t };
+  return null;
+};
+var labelFromKey = (ctx) => ({ name: titleCase(ctx.key) });
+var sliderWhenBounded = (ctx) => {
+  if (ctx.leaf.kind !== "number") return null;
+  const bounded = ctx.leaf.min !== void 0 && ctx.leaf.max !== void 0;
+  return bounded ? { control: "slider" } : null;
+};
+var descriptionDefault = () => ({ description: "" });
+var builtinRules = [
+  kindFromValue,
+  labelFromKey,
+  sliderWhenBounded,
+  descriptionDefault
+];
+function applyRules(seed, ctx, rules) {
+  const acc = { ...seed };
+  for (const rule of rules) {
+    const patch = rule({ ...ctx, leaf: acc });
+    if (patch === null) continue;
+    for (const [k, v] of Object.entries(patch)) {
+      if (v !== void 0 && acc[k] === void 0) {
+        acc[k] = v;
+      }
+    }
+  }
+  return acc;
+}
+
+// src/config/resolve.ts
+function defined(annotations) {
+  const out = {};
+  for (const [k, v] of Object.entries(annotations)) if (v !== void 0) out[k] = v;
+  return out;
+}
+function resolveConfigSchema(schema, rules = []) {
+  const sink = {
+    sections: [],
+    showIf: /* @__PURE__ */ new Map(),
+    renderers: {},
+    chain: [...rules, ...builtinRules]
+  };
+  const group = resolveShape(schema.nodes, "", "", sink);
+  return { group, sections: sink.sections, showIf: sink.showIf, renderers: sink.renderers };
+}
+function resolveShape(shape, at, name, sink) {
+  const children = {};
+  const sections = /* @__PURE__ */ new Map();
+  for (const [key, entry] of Object.entries(shape)) {
+    const path = at === "" ? key : `${at}.${key}`;
+    children[key] = resolveEntry(entry, key, path, sink);
+    const { section, showIf: predicate } = entry.options;
+    if (section !== void 0) {
+      let spec = sections.get(section.label);
+      if (!spec) {
+        spec = { at, label: section.label, paths: [] };
+        sections.set(section.label, spec);
+        sink.sections.push(spec);
+      }
+      spec.paths.push(path);
+      if (section.collapsed !== void 0) {
+        spec.collapsed = (spec.collapsed ?? false) || section.collapsed;
+      }
+      if (section.layout !== void 0 && spec.layout === void 0) spec.layout = section.layout;
+      if (section.pack !== void 0 && spec.pack === void 0) spec.pack = section.pack;
+    }
+    if (predicate) sink.showIf.set(path, predicate);
+    if (!isConfigBranch(entry) && entry.options.render) sink.renderers[path] = entry.options.render;
+  }
+  return { name, children };
+}
+function resolveEntry(entry, key, path, sink) {
+  if (isConfigBranch(entry)) {
+    const group = resolveShape(
+      entry.children,
+      path,
+      entry.annotations.name ?? titleCase(key),
+      sink
+    );
+    return entry.annotations.description === void 0 ? group : { ...group, description: entry.annotations.description };
+  }
+  if (entry.options.manual && entry.options.unpinned) {
+    throw new Error(
+      `[labkit] "${path}" is both .manual() and .initial(auto) \u2014 a field that can never be auto cannot start auto`
+    );
+  }
+  const seed = defined({
+    ...entry.annotations,
+    ...entry.kind === null ? {} : { kind: entry.kind }
+  });
+  const patch = applyRules(seed, { key, path, default: entry.default }, sink.chain);
+  const { autoResolve, unpinned, manual } = entry.options;
+  return {
+    ...patch,
+    default: entry.default,
+    // Extra keys survive onto the leaf at runtime; `ControlPanel` reads them
+    // back with its `extra<T>` helper, the same as `min`, `step` and the rest.
+    ...autoResolve === void 0 ? {} : { autoResolve },
+    ...unpinned === void 0 ? {} : { unpinned },
+    ...manual === void 0 ? {} : { manual }
+  };
+}
+var NONE = /* @__PURE__ */ new Set();
+function useResolvedConfig(schema, config, autoPaths) {
+  const auto = useMemo(
+    () => autoPaths && autoPaths.length > 0 ? new Set(autoPaths) : NONE,
+    [autoPaths]
+  );
+  const resolvedConfig = useMemo(
+    () => schema ? resolveAutoConfig(schema, config, auto) : config,
+    [schema, config, auto]
+  );
+  return { config: resolvedConfig, auto };
+}
+
+export { BaseNode, BooleanNode, ColorNode, CustomNode, EnumNode, GroupNode, NumberNode, StringNode, ValueNode, applyRules, builtinRules, f, isConfigBranch, resolveConfigSchema, titleCase, useResolvedConfig };
+//# sourceMappingURL=chunk-ZDHY47EV.js.map
+//# sourceMappingURL=chunk-ZDHY47EV.js.map

package/dist/chunk-ZDHY47EV.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-ZDHY47EV.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  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 });\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 takes no pin dot and ignores the gesture. */\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.0M`. 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 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`, where weasel-ui's\n   *  `PrefsForm` draws it under the heading; `ControlPanel` has no place for\n   *  it yet and shows the heading alone. */\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\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  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  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  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    chain: [...rules, ...builtinRules],\n  };\n  const group = resolveShape(schema.nodes, '', '', sink);\n  return { group, sections: sink.sections, showIf: sink.showIf, renderers: sink.renderers };\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  }\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"]}