@weasel-js/labkit 1.7.0 → 1.7.2

package/dist/{chunk-FMK7UQ6V.js → chunk-XZDCEMEL.js}

@@ -1,7 +1,8 @@
-import { je, Me, i3, a4 } from './chunk-MIM5R4ZT.js';
+import { je, Me, s, c2 } from './chunk-U6UQVGFP.js';
 import { jsxs, jsx } from 'react/jsx-runtime';
+import { useLatest } from '@weasel-js/core';
 import { useRef, useEffect, useMemo } from 'react';
-import { asNodeId, Store, createNode, stripStrategy } from 'windease';
+import { asNodeId, stripStrategy, Store, createNode } from 'windease';
 import { Provider, StrategyRegistryProvider, Container } from 'windease/react';
 
 function JobProgress({ job, className }) {
@@ -63,15 +64,15 @@ function Legend({ entries, className }) {
 }
 function Readout({ rows, title, children, className }) {
   return /* @__PURE__ */ jsxs("div", { className: className ? `lk-readout ${className}` : "lk-readout", children: [
-    /* @__PURE__ */ jsx(i3, { title, values: "figures", children: rows.map((row, i2) => /* @__PURE__ */ jsx(
-      a4,
+    /* @__PURE__ */ jsx(s, { title, values: "figures", children: rows.map((row, i) => /* @__PURE__ */ jsx(
+      c2,
       {
         label: row.label,
         status: row.status,
         values: row.values,
         children: row.value
       },
-      row.key ?? (typeof row.label === "string" ? row.label : i2)
+      row.key ?? (typeof row.label === "string" ? row.label : i)
     )) }),
     children != null && /* @__PURE__ */ jsx("div", { className: "lk-readout__footer", children })
   ] });
@@ -80,6 +81,53 @@ var ZONE_ID = asNodeId("lk-split");
 var SIDEBAR_ID = asNodeId("lk-split-sidebar");
 var CONTENT_ID = asNodeId("lk-split-content");
 var STRATEGIES = { strip: stripStrategy };
+function createSplitStore({
+  side,
+  label,
+  sidebarWidth,
+  minWidth,
+  maxWidth,
+  contentMinWidth
+}) {
+  const store = new Store();
+  store.registerNode(
+    createNode({
+      kind: "zone",
+      id: ZONE_ID,
+      // A strip's seam resizes the pane before it, which on the end side is the
+      // content; 'neighbor' has the seam size the sidebar after it too.
+      container: {
+        strategyId: "strip",
+        config: {
+          axis: "x",
+          resizable: true,
+          ...side === "end" ? { resizeMode: "neighbor" } : {}
+        }
+      }
+    })
+  );
+  const sidebarNode = createNode({
+    kind: "sidebar",
+    id: SIDEBAR_ID,
+    parentId: ZONE_ID,
+    meta: { title: label },
+    placement: { size: { w: sidebarWidth } },
+    hints: { minSize: { w: minWidth, h: 0 }, maxSize: { w: maxWidth, h: 0 } }
+  });
+  const contentNode = createNode({
+    kind: "content",
+    id: CONTENT_ID,
+    parentId: ZONE_ID,
+    meta: { title: "Content" },
+    hints: { minSize: { w: contentMinWidth, h: 0 } }
+  });
+  for (const node of side === "end" ? [contentNode, sidebarNode] : [sidebarNode, contentNode]) {
+    store.registerNode(node);
+  }
+  store.showNode(SIDEBAR_ID);
+  store.showNode(CONTENT_ID);
+  return store;
+}
 function Split({
   sidebar,
   children,
@@ -98,44 +146,14 @@ function Split({
 }) {
   const storeRef = useRef(null);
   if (storeRef.current === null) {
-    const store2 = new Store();
-    store2.registerNode(
-      createNode({
-        kind: "zone",
-        id: ZONE_ID,
-        // A strip's seam resizes the pane before it, which on the end side is the
-        // content; 'neighbor' has the seam size the sidebar after it too.
-        container: {
-          strategyId: "strip",
-          config: {
-            axis: "x",
-            resizable: true,
-            ...side === "end" ? { resizeMode: "neighbor" } : {}
-          }
-        }
-      })
-    );
-    const sidebarNode = createNode({
-      kind: "sidebar",
-      id: SIDEBAR_ID,
-      parentId: ZONE_ID,
-      meta: { title: label },
-      placement: { size: { w: width ?? defaultWidth } },
-      hints: { minSize: { w: minWidth, h: 0 }, maxSize: { w: maxWidth, h: 0 } }
+    storeRef.current = createSplitStore({
+      side,
+      label,
+      sidebarWidth: width ?? defaultWidth,
+      minWidth,
+      maxWidth,
+      contentMinWidth
     });
-    const contentNode = createNode({
-      kind: "content",
-      id: CONTENT_ID,
-      parentId: ZONE_ID,
-      meta: { title: "Content" },
-      hints: { minSize: { w: contentMinWidth, h: 0 } }
-    });
-    for (const node of side === "end" ? [contentNode, sidebarNode] : [sidebarNode, contentNode]) {
-      store2.registerNode(node);
-    }
-    store2.showNode(SIDEBAR_ID);
-    store2.showNode(CONTENT_ID);
-    storeRef.current = store2;
   }
   const store = storeRef.current;
   const widthRef = useRef(width ?? defaultWidth);
@@ -154,8 +172,7 @@ function Split({
     widthRef.current = width;
     store.patchPlacement(SIDEBAR_ID, { size: { w: width } });
   }, [store, width]);
-  const onWidthChangeRef = useRef(onWidthChange);
-  onWidthChangeRef.current = onWidthChange;
+  const onWidthChangeRef = useLatest(onWidthChange);
   useEffect(
     () => store.events.on("node.placementChanged", () => {
       if (store.getPlacement(CONTENT_ID)?.size?.w !== void 0) {
@@ -166,7 +183,7 @@ function Split({
       widthRef.current = next;
       onWidthChangeRef.current?.(next);
     }),
-    [store]
+    [onWidthChangeRef, store]
   );
   const chrome = useMemo(
     () => ({
@@ -188,5 +205,5 @@ function Split({
 }
 
 export { JobProgress, Legend, Readout, Split };
-//# sourceMappingURL=chunk-FMK7UQ6V.js.map
-//# sourceMappingURL=chunk-FMK7UQ6V.js.map
+//# sourceMappingURL=chunk-XZDCEMEL.js.map
+//# sourceMappingURL=chunk-XZDCEMEL.js.map

package/dist/chunk-XZDCEMEL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/primitives/JobProgress.tsx","../src/primitives/Legend.tsx","../src/primitives/Readout.tsx","../src/primitives/Split.tsx"],"names":["jsx","jsxs","c"],"mappings":"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","file":"chunk-XZDCEMEL.js","sourcesContent":["import { ErrorIcon, WarningIcon } from '@weasel-js/ui';\nimport type { JobHandle } from '../job/types';\n\n/** Props for `<JobProgress>`. */\nexport interface JobProgressProps {\n  job: JobHandle;\n  className?: string;\n}\n\n/** A running job's progress, failures and outcome. Determinate once the job\n *  reports a total; a job that cannot count up front never sends one, so the\n *  bar stays indeterminate rather than inventing a denominator. */\nexport function JobProgress({ job, className }: JobProgressProps) {\n  const { status, done, total, failures, error } = job;\n  if (status === 'idle') return null;\n\n  const determinate = total !== null && total > 0;\n  const fraction = determinate ? Math.min(1, done / total) : 0;\n  const cls = ['lk-job', `lk-job--${status}`, className].filter(Boolean).join(' ');\n\n  return (\n    <div className={cls}>\n      <div\n        className={`lk-job__track${determinate ? '' : ' lk-job__track--indeterminate'}`}\n        role=\"progressbar\"\n        aria-label=\"Job progress\"\n        aria-valuenow={determinate ? done : undefined}\n        aria-valuemin={determinate ? 0 : undefined}\n        aria-valuemax={determinate ? total : undefined}\n      >\n        {/* Scaling a full-width bar keeps the fill off the layout path, so\n            progress updates never reflow the status bar. */}\n        <div\n          className=\"lk-job__fill\"\n          style={{ transform: `scaleX(${determinate ? fraction : 1})` }}\n        />\n      </div>\n\n      <span className=\"lk-job__count\">\n        {done}\n        {determinate ? ` / ${total}` : ''}\n      </span>\n\n      {failures.length > 0 && (\n        <span className=\"lk-job__failures\" title={failures.map((f) => f.error).join('\\n')}>\n          <WarningIcon size={14} />\n          {failures.length} failed\n        </span>\n      )}\n\n      {error && (\n        <span className=\"lk-job__error\" title={error}>\n          <ErrorIcon size={14} />\n          {error}\n        </span>\n      )}\n\n      {status === 'running' && (\n        <button type=\"button\" className=\"lk-job__cancel\" onClick={job.cancel}>\n          Cancel\n        </button>\n      )}\n    </div>\n  );\n}\n","import type { CSSProperties } from 'react';\n\n/** How a legend entry's swatch is drawn, matching how the thing looks on canvas. */\nexport type LegendMark = 'line' | 'dash' | 'dot' | 'band';\n\n/** One row of a legend: a swatch and what it means. */\nexport interface LegendEntry {\n  key: string;\n  label: string;\n  color: string;\n  /** Defaults to `'line'`. */\n  mark?: LegendMark;\n}\n\n/** Props for `<Legend>`. */\nexport interface LegendProps {\n  entries: readonly LegendEntry[];\n  className?: string;\n}\n\n/** A color key. Presentational only — no handlers, no state, no hover behavior. */\nexport function Legend({ entries, className }: LegendProps) {\n  return (\n    <ul className={className ? `lk-legend ${className}` : 'lk-legend'}>\n      {entries.map((entry) => {\n        const mark = entry.mark ?? 'line';\n        return (\n          <li className=\"lk-legend__row\" key={entry.key}>\n            <span\n              aria-hidden=\"true\"\n              className={`lk-legend__swatch lk-legend__swatch--${mark}`}\n              style={{ '--lk-legend-ink': entry.color } as CSSProperties}\n            />\n            <span className=\"lk-legend__label\">{entry.label}</span>\n          </li>\n        );\n      })}\n    </ul>\n  );\n}\n","import { DetailList, type DetailListValues, DetailRow, type DetailRowStatus } from '@weasel-js/ui';\nimport type { ReactNode } from 'react';\n\n/** One measurement in a {@link Readout}. */\nexport interface ReadoutRow {\n  /** React key. Defaults to `label` when that is a string, else the row's index. */\n  key?: string;\n  label: ReactNode;\n  /** `null` or `undefined` keeps the row in place showing an en dash, so the\n   *  readout holds its height while a measurement comes and goes. */\n  value?: ReactNode;\n  /** A dot in the status color before the value. Color is never the only\n   *  signal: the value has to say the same thing in words. */\n  status?: DetailRowStatus;\n  /** `text` sets this row's value as wrapping prose instead of a figure. */\n  values?: DetailListValues;\n}\n\n/** Props for {@link Readout}. */\nexport interface ReadoutProps {\n  rows: readonly ReadoutRow[];\n  /** Heading above the rows, which also names the list. */\n  title?: ReactNode;\n  /** Drawn below the rows — a small table, a note. */\n  children?: ReactNode;\n  className?: string;\n}\n\n/**\n * Values a lab only reads — measurements shown beside its picture, such as\n * \"Lock margin +47.9°\". A {@link DetailList} set as figures: labels take the\n * params label recipe and `--wzl-params-label-width` rail, so a readout lines\n * up with a `ControlPanel` beside it, and values sit right-aligned in the mono\n * face with spaces kept, so figure-space padding aligns a column on its\n * decimal point. Rows compose by hand as `DetailRow`s inside a `DetailList`\n * with `values=\"figures\"`.\n */\nexport function Readout({ rows, title, children, className }: ReadoutProps) {\n  return (\n    <div className={className ? `lk-readout ${className}` : 'lk-readout'}>\n      <DetailList title={title} values=\"figures\">\n        {rows.map((row, i) => (\n          <DetailRow\n            key={row.key ?? (typeof row.label === 'string' ? row.label : i)}\n            label={row.label}\n            status={row.status}\n            values={row.values}\n          >\n            {row.value}\n          </DetailRow>\n        ))}\n      </DetailList>\n      {children != null && <div className=\"lk-readout__footer\">{children}</div>}\n    </div>\n  );\n}\n","import { useLatest } from '@weasel-js/core';\nimport { type ReactNode, useEffect, useMemo, useRef } from 'react';\nimport { asNodeId, createNode, Store, stripStrategy } from 'windease';\nimport { type ChromeMap, Container, Provider, StrategyRegistryProvider } from 'windease/react';\n\nconst ZONE_ID = asNodeId('lk-split');\nconst SIDEBAR_ID = asNodeId('lk-split-sidebar');\nconst CONTENT_ID = asNodeId('lk-split-content');\nconst STRATEGIES = { strip: stripStrategy as never };\n\n/** Props for `<Split>`. */\nexport interface SplitProps {\n  /** The sidebar pane's contents. */\n  sidebar: ReactNode;\n  /** The edge the sidebar sits on. Read once, when the strip mounts. Default `'start'`. */\n  side?: 'start' | 'end';\n  /** The content pane's contents. */\n  children: ReactNode;\n  /** Names the sidebar pane, and through it the seam. Default `'Sidebar'`. */\n  label?: string;\n  /** Extra classes on the strip, which always has `lk-split`. */\n  className?: string;\n  /** The class on the sidebar pane. */\n  sidebarClassName?: string;\n  /** The class on the content pane. */\n  contentClassName?: string;\n  /** The sidebar's current extent in pixels. Omit to leave it unpersisted: the\n   *  seam still works, its result just does not outlive the mount. */\n  width?: number;\n  /** Where the sidebar starts before anyone drags it. */\n  defaultWidth?: number;\n  minWidth?: number;\n  maxWidth?: number;\n  /** How little the content pane may be squeezed to. Reported as the seam's\n   *  reachable maximum, so the drag stops there rather than clamping silently. */\n  contentMinWidth?: number;\n  /** Fires through the drag, not on release: the pane is already there. */\n  onWidthChange?: (width: number) => void;\n  /**\n   * Fixed extent. Omit in an app — the strip measures its own box. Supply it\n   * where nothing measures, notably jsdom, or both panes lay out at zero.\n   */\n  viewport?: { w: number; h: number };\n}\n\ninterface SplitInit {\n  side: 'start' | 'end';\n  label: string;\n  sidebarWidth: number;\n  minWidth: number;\n  maxWidth: number;\n  contentMinWidth: number;\n}\n\n/** A strip holding the sidebar and the content pane, sized as the first render asks. */\nfunction createSplitStore({\n  side,\n  label,\n  sidebarWidth,\n  minWidth,\n  maxWidth,\n  contentMinWidth,\n}: SplitInit): Store {\n  const store = new Store();\n  store.registerNode(\n    createNode({\n      kind: 'zone',\n      id: ZONE_ID,\n      // A strip's seam resizes the pane before it, which on the end side is the\n      // content; 'neighbor' has the seam size the sidebar after it too.\n      container: {\n        strategyId: 'strip',\n        config: {\n          axis: 'x',\n          resizable: true,\n          ...(side === 'end' ? { resizeMode: 'neighbor' } : {}),\n        },\n      },\n    }),\n  );\n  const sidebarNode = createNode({\n    kind: 'sidebar',\n    id: SIDEBAR_ID,\n    parentId: ZONE_ID,\n    meta: { title: label },\n    placement: { size: { w: sidebarWidth } },\n    hints: { minSize: { w: minWidth, h: 0 }, maxSize: { w: maxWidth, h: 0 } },\n  });\n  const contentNode = createNode({\n    kind: 'content',\n    id: CONTENT_ID,\n    parentId: ZONE_ID,\n    meta: { title: 'Content' },\n    hints: { minSize: { w: contentMinWidth, h: 0 } },\n  });\n  // A strip lays its children out in registration order.\n  for (const node of side === 'end' ? [contentNode, sidebarNode] : [sidebarNode, contentNode]) {\n    store.registerNode(node);\n  }\n  store.showNode(SIDEBAR_ID);\n  store.showNode(CONTENT_ID);\n  return store;\n}\n\n/**\n * A sidebar and a content pane as a two-pane strip with a draggable seam.\n *\n * The seam is `stripStrategy`'s own resize affordance, so it arrives as a\n * `role=\"separator\"` carrying the reachable range, operable by pointer and by\n * arrows / Home / End, and clamped against the content pane's floor rather\n * than against the sidebar's alone.\n */\nexport function Split({\n  sidebar,\n  children,\n  side = 'start',\n  label = 'Sidebar',\n  className,\n  sidebarClassName,\n  contentClassName,\n  width,\n  defaultWidth = 320,\n  minWidth = 140,\n  maxWidth = 720,\n  contentMinWidth = 160,\n  onWidthChange,\n  viewport,\n}: SplitProps) {\n  // The cross-axis half of every size hint below is inert: a horizontal strip\n  // stretches its panes to the container's height and never reads `h`.\n  const storeRef = useRef<Store | null>(null);\n  if (storeRef.current === null) {\n    storeRef.current = createSplitStore({\n      side,\n      label,\n      sidebarWidth: width ?? defaultWidth,\n      minWidth,\n      maxWidth,\n      contentMinWidth,\n    });\n  }\n  const store = storeRef.current;\n\n  // What the store last held, so the placement event can tell a drag from the\n  // echo of our own write and a controlled `width` does not fight the seam.\n  const widthRef = useRef(width ?? defaultWidth);\n\n  useEffect(() => {\n    store.setHints(SIDEBAR_ID, {\n      minSize: { w: minWidth, h: 0 },\n      maxSize: { w: maxWidth, h: 0 },\n    });\n    store.setHints(CONTENT_ID, { minSize: { w: contentMinWidth, h: 0 } });\n  }, [store, minWidth, maxWidth, contentMinWidth]);\n\n  useEffect(() => {\n    store.setMeta(SIDEBAR_ID, { title: label });\n  }, [store, label]);\n\n  useEffect(() => {\n    if (width === undefined || width === widthRef.current) return;\n    widthRef.current = width;\n    store.patchPlacement(SIDEBAR_ID, { size: { w: width } });\n  }, [store, width]);\n\n  const onWidthChangeRef = useLatest(onWidthChange);\n  useEffect(\n    () =>\n      store.events.on('node.placementChanged', () => {\n        // A neighbor drag pins the content's width too; unpinned, it goes on filling the strip.\n        if ((store.getPlacement(CONTENT_ID)?.size as { w?: number } | undefined)?.w !== undefined) {\n          store.patchPlacement(CONTENT_ID, { size: {} });\n        }\n        const next = (store.getPlacement(SIDEBAR_ID)?.size as { w?: number } | undefined)?.w;\n        if (typeof next !== 'number' || next === widthRef.current) return;\n        widthRef.current = next;\n        onWidthChangeRef.current?.(next);\n      }),\n    [onWidthChangeRef, store],\n  );\n\n  const chrome = useMemo<ChromeMap>(\n    () => ({\n      sidebar: () => <div className={sidebarClassName}>{sidebar}</div>,\n      content: () => <div className={contentClassName}>{children}</div>,\n    }),\n    [sidebar, children, sidebarClassName, contentClassName],\n  );\n\n  return (\n    <Provider store={store}>\n      <StrategyRegistryProvider strategies={STRATEGIES}>\n        <Container\n          parentId={ZONE_ID}\n          chrome={chrome}\n          className={className ? `lk-split windease-zone ${className}` : 'lk-split windease-zone'}\n          affordances\n          viewport={viewport}\n        />\n      </StrategyRegistryProvider>\n    </Provider>\n  );\n}\n"]}

package/dist/{chunk-FZ7YFQN7.js → chunk-YCFKW5RX.js}

@@ -1,4 +1,4 @@
-import { isAuto, resolveAutoConfig } from './chunk-Y23G2VZL.js';
+import { isAuto, resolveAutoConfig } from './chunk-READTDQX.js';
 import { useMemo } from 'react';
 
 // src/config/builder.ts
@@ -391,5 +391,5 @@ function useResolvedConfig(schema, config, autoPaths) {
 }
 
 export { BaseNode, BooleanNode, ColorNode, CustomNode, EnumNode, GroupNode, ListNode, NumberNode, StringNode, ValueNode, applyRules, builtinRules, f, isConfigBranch, resolveConfigSchema, titleCase, useResolvedConfig };
-//# sourceMappingURL=chunk-FZ7YFQN7.js.map
-//# sourceMappingURL=chunk-FZ7YFQN7.js.map
+//# sourceMappingURL=chunk-YCFKW5RX.js.map
+//# sourceMappingURL=chunk-YCFKW5RX.js.map

package/dist/chunk-YCFKW5RX.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-YCFKW5RX.js","sourcesContent":["import type { Display } from '@weasel-js/quantity';\nimport type { PrefLeaf, 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\n/** A numeric leaf, built by `f.number`. */\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, speak and read the value through a display — `compact()` reads\n   *  `2.00M`. Presentation only: the stored value stays a plain number. */\n  display(display: Display): this {\n    return this.ann({ display });\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\n/** A true/false leaf, built by `f.boolean`; a checkbox unless `.toggle()`. */\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\n/** A text leaf, built by `f.string`. */\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\n/** A string-list leaf, built by `f.list`. */\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\n/** A color leaf holding a hex string, built by `f.color`. */\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\n/** A fixed-choice leaf, built by `f.enum`; a select unless `.radio()`. */\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  /** Put a button on the group's heading that returns every value beneath it\n   *  to its default, leaving the rest of the config alone. */\n  resettable(): GroupNode<S> {\n    return this.with(this.annotations, { ...this.options, resettable: true });\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  resettable: Set<string>;\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    resettable: new Set(),\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    resettable: sink.resettable,\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.resettable) sink.resettable.add(path);\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"]}

package/dist/{chunk-CQLQPQ4P.js → chunk-ZQIHJXP4.js}

@@ -4,5 +4,5 @@ import { createContext } from 'react';
 var CanvasStackContext = createContext(null);
 
 export { CanvasStackContext };
-//# sourceMappingURL=chunk-CQLQPQ4P.js.map
-//# sourceMappingURL=chunk-CQLQPQ4P.js.map
+//# sourceMappingURL=chunk-ZQIHJXP4.js.map
+//# sourceMappingURL=chunk-ZQIHJXP4.js.map

package/dist/chunk-ZQIHJXP4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/canvas/CanvasStackContext.ts"],"names":[],"mappings":";;;AAgCO,IAAM,kBAAA,GAAqB,cAA8C,IAAI","file":"chunk-ZQIHJXP4.js","sourcesContent":["import { createContext, type RefObject } from 'react';\nimport type { ViewTransform } from '../instrument/types';\nimport type { CanvasLayerDescriptor } from './useLayerScheduler';\nimport type { WorldFrame, WorldSpec } from './worldSpec';\n\n/** The stack's own drawing surface, for an overlay that has to re-draw it at\n *  another camera or read back what it presented — a loupe. */\nexport interface CanvasStackSurface {\n  /** The element the layers are stacked in, and the one pan/zoom listens on. */\n  element: RefObject<HTMLElement | null>;\n  /** Its measured CSS size, and the ratio the backing stores are scaled by. */\n  size: { width: number; height: number; dpr: number };\n  /** The presented `<canvas>` per layer id. */\n  canvases: RefObject<Map<string, HTMLCanvasElement>>;\n  /** The layers as the stack is drawing them, bottom first. */\n  layers: readonly CanvasLayerDescriptor[];\n  /** The coordinate system the stack was given, which `frame` resolves at\n   *  its size — for a re-draw at another size. */\n  worldSpec?: WorldSpec;\n}\n\n/** What a canvas stack publishes to its children: the view, and the resolved\n *  coordinate system it is read in, so DOM overlays can place themselves in the\n *  same coordinates the layers draw in. */\nexport interface CanvasStackContextValue {\n  view: ViewTransform;\n  frame: WorldFrame;\n  /** Absent from a context assembled by hand, which has no stack behind it. */\n  surface?: CanvasStackSurface;\n}\n\n/** Context carrying the surrounding canvas stack's view and world frame. */\nexport const CanvasStackContext = createContext<CanvasStackContextValue | null>(null);\n"]}

package/dist/config/index.d.ts

@@ -1,13 +1,15 @@
-import { a5 as Auto } from '../_dts/types-CSm9jgol.js';
+import { a4 as Auto } from '../_dts/index-DCMA4Fy1.js';
 import { Instrument } from '../index.js';
-export { aC as auto, aI as isAuto } from '../_dts/types-CSm9jgol.js';
-import { R as ResolvedConfig, l as ConfigNode, A as Annotations, N as NodeOptions, S as SectionOption, d as ControlRenderer, I as InDialogOptions, n as ConfigOption, p as ConfigShape, h as ConfigBranch, B as BranchAnnotations, e as BranchOptions, b as ConfigSchema, q as InferConfig, i as ConfigEntry, c as ConfigRule, L as LeafPatch, o as ConfigRuleContext } from '../_dts/types-CRPSGFAp.js';
+export { aw as auto, aC as isAuto } from '../_dts/index-DCMA4Fy1.js';
+import { R as ResolvedConfig, k as ConfigNode, A as Annotations, N as NodeOptions, S as SectionOption, c as ControlRenderer, I as InDialogOptions, m as ConfigOption, p as ConfigShape, g as ConfigBranch, B as BranchAnnotations, d as BranchOptions, C as ConfigSchema, q as InferConfig, h as ConfigEntry, b as ConfigRule, L as LeafPatch, o as ConfigRuleContext } from '../_dts/types-BUBSIZuV.js';
 import { ConfigField } from '../controls/index.js';
-export { m as ConfigOf, C as ConfigPath, D as DialogSpec, E as EntryValue, r as NodeValue, t as SectionSpec, V as ValueAtPath } from '../_dts/types-CRPSGFAp.js';
-import { D as Display } from '../_dts/PrefsRow.d-TOZ7BgD9.js';
-import { ToolPrefNumberUnit, ToolPrefLeaf, ToolPrefGroup } from '@weasel-js/core';
+export { l as ConfigOf, n as ConfigPath, D as DialogSpec, E as EntryValue, r as NodeValue, t as SectionSpec, V as ValueAtPath } from '../_dts/types-BUBSIZuV.js';
+import { Display } from '@weasel-js/quantity';
+import { PrefNumberUnit, PrefLeaf, PrefGroup } from '@weasel-js/ui';
+import '@weasel-js/core';
 import 'react';
 import '@weasel-js/theme';
+import '@weasel-js/geom';
 import '../_dts/types-DJ79Tg5J.js';
 
 /** The dotted paths a schema declares as starting auto — every leaf that said
@@ -73,6 +75,7 @@ declare abstract class BaseNode<T> implements ConfigNode<T> {
     /** Never auto. The row's label does not toggle. */
     manual(): this;
 }
+/** A numeric leaf, built by `f.number`. */
 declare class NumberNode extends BaseNode<number> {
     readonly kind = "number";
     /** Bound the value. A number with both bounds renders as a slider. */
@@ -90,17 +93,19 @@ declare class NumberNode extends BaseNode<number> {
      * alongside the value, and convert with it. `prefUnit` builds one from a
      * `UnitSystem`.
      */
-    unit(unit: ToolPrefNumberUnit): this;
+    unit(unit: PrefNumberUnit): this;
     /** Force a slider even without both bounds. */
     slider(): this;
     /** Force a typed input even when both bounds are set. */
     input(): this;
 }
+/** A true/false leaf, built by `f.boolean`; a checkbox unless `.toggle()`. */
 declare class BooleanNode extends BaseNode<boolean> {
     readonly kind = "boolean";
     /** Ask for a switch rather than a checkbox. */
     toggle(): this;
 }
+/** A text leaf, built by `f.string`. */
 declare class StringNode extends BaseNode<string> {
     readonly kind = "string";
     placeholder(placeholder: string): this;
@@ -108,17 +113,20 @@ declare class StringNode extends BaseNode<string> {
     /** Milliseconds to debounce live writes. 0 commits every keystroke. */
     debounce(debounceMs: number): this;
 }
+/** A string-list leaf, built by `f.list`. */
 declare class ListNode extends BaseNode<string[]> {
     readonly kind = "list";
     /** Shown in an empty entry. */
     placeholder(placeholder: string): this;
 }
+/** A color leaf holding a hex string, built by `f.color`. */
 declare class ColorNode extends BaseNode<string> {
     readonly kind = "color";
     /** The value carries alpha as `#rrggbbaa`, and the row gets an opacity
      *  track beside the swatch. */
     alpha(): this;
 }
+/** A fixed-choice leaf, built by `f.enum`; a select unless `.radio()`. */
 declare class EnumNode<T extends string> extends BaseNode<T> {
     readonly kind = "enum";
     /** Render as a segmented control rather than a select. */
@@ -195,7 +203,7 @@ declare const f: {
      *  Groups nest as deeply as the schema wants. */
     group: <const S extends ConfigShape>(children: S) => GroupNode<S>;
     /** A leaf of a kind a lab supplies the control for, through `controls`. */
-    custom: <T>(kind: string, def: T, validate?: (leaf: ToolPrefLeaf, config: Record<string, unknown>) => string[]) => CustomNode<T>;
+    custom: <T>(kind: string, def: T, validate?: (leaf: PrefLeaf, config: Record<string, unknown>) => string[]) => CustomNode<T>;
     /** Collect leaves and groups into an instrument's config. */
     schema<S extends ConfigShape>(nodes: S): ConfigSchema<InferConfig<S>>;
 };
@@ -234,7 +242,7 @@ declare function withValueAtPath<T>(config: T, path: string, value: unknown): T;
 declare function fillConfigDefaults<T>(stored: unknown, defaults: T): T;
 /** A node in a resolved schema tree, by dotted path. Structural rather than
  *  `isPrefLeaf` so this stays free of a runtime import. */
-declare function schemaNodeAtPath(group: ToolPrefGroup, path: string): ToolPrefLeaf | ToolPrefGroup | undefined;
+declare function schemaNodeAtPath(group: PrefGroup, path: string): PrefLeaf | PrefGroup | undefined;
 
 /**
  * Resolve a schema into the vocabulary weasel-ui renders, running each leaf
@@ -276,7 +284,7 @@ declare function applyRules(seed: LeafPatch, ctx: Omit<ConfigRuleContext, 'leaf'
 interface SectionTree {
     /** The rail's schema. Top-level children are the schema's root sections,
      *  followed by any root node no section claimed. */
-    group: ToolPrefGroup;
+    group: PrefGroup;
     /** `config` renested to mirror `group` — the value tree `PrefsForm` takes. */
     values: Record<string, unknown>;
     /** The config path a path within `group` stands for. */

package/dist/config/index.js

@@ -1,7 +1,7 @@
-export { sectionTree, useConfigSchema } from '../chunk-GOZLNM4L.js';
+export { sectionTree, useConfigSchema } from '../chunk-E6NARGU7.js';
 import '../chunk-Z76KEZAX.js';
-export { BaseNode, BooleanNode, ColorNode, CustomNode, EnumNode, GroupNode, ListNode, NumberNode, StringNode, ValueNode, applyRules, builtinRules, f, isConfigBranch, resolveConfigSchema, titleCase, useResolvedConfig } from '../chunk-FZ7YFQN7.js';
-export { fromConfigFields, isLeafVisible } from '../chunk-KMJ7RWD3.js';
-export { auto, autoPathsOf, fillConfigDefaults, hasConfigPath, isAuto, resolveAutoConfig, schemaNodeAtPath, valueAtPath, withValueAtPath } from '../chunk-Y23G2VZL.js';
+export { BaseNode, BooleanNode, ColorNode, CustomNode, EnumNode, GroupNode, ListNode, NumberNode, StringNode, ValueNode, applyRules, builtinRules, f, isConfigBranch, resolveConfigSchema, titleCase, useResolvedConfig } from '../chunk-YCFKW5RX.js';
+export { fromConfigFields, isLeafVisible } from '../chunk-WLMDTI2Q.js';
+export { auto, autoPathsOf, fillConfigDefaults, hasConfigPath, isAuto, resolveAutoConfig, schemaNodeAtPath, valueAtPath, withValueAtPath } from '../chunk-READTDQX.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/controls/index.d.ts

@@ -1,13 +1,61 @@
+import { StanceProps, PropertyRowLayout, PropertyDensity, PropertyAlign } from '@weasel-js/ui';
 import * as react from 'react';
-import { ReactNode } from 'react';
-import { StanceProps } from '../passthrough/weasel-ui.js';
-import { PropertyRowLayout } from '../index.js';
-import { PropertyDensity, PropertyAlign } from '../passthrough/weasel-ui.js';
-import { a as ConfigField, I as InDialogOptions } from '../_dts/types-CRPSGFAp.js';
+import { ReactNode, ReactElement } from 'react';
+import { a as ConfigField, I as InDialogOptions } from '../_dts/types-BUBSIZuV.js';
 import { ResolvedConfig, ControlRenderer } from '../config/index.js';
-export { f as CheckboxField, g as ColorField, k as ConfigFieldType, s as NumberField, u as SelectField, v as SelectOption, w as SliderField, T as TextField } from '../_dts/types-CRPSGFAp.js';
-import '@weasel-js/theme';
-import '@weasel-js/core';
+export { e as CheckboxField, f as ColorField, j as ConfigFieldType, s as NumberField, u as SelectField, v as SelectOption, w as SliderField, T as TextField } from '../_dts/types-BUBSIZuV.js';
+import '@weasel-js/quantity';
+
+/** One column of a {@link ControlMatrix}: a config group, every one the same shape. */
+interface ControlMatrixColumn {
+    /** Config path prefix of this column's group, e.g. `'looks.window'`. */
+    key: string;
+    /** Short header shown at narrow width, e.g. `'Win'`. */
+    label: string;
+    /** Full name, for the header's tooltip and accessible name, e.g. `'Window'`. */
+    title?: string;
+}
+/** One row of a {@link ControlMatrix}: a setting every column's group may hold. */
+interface ControlMatrixRow {
+    /** Path of the setting inside each column's group, e.g. `'background'` or `'fill.colorBy'`. */
+    key: string;
+    /** Row label. Defaults to the leaf's own name from the schema. */
+    label?: string;
+}
+interface ControlMatrixProps extends StanceProps {
+    /** Heads the matrix. With `title`, `stance` or `tone` given it sits in a
+     *  `<PropertyPanel>`, as a `ControlPanel` does. */
+    title?: ReactNode;
+    /** The whole resolved schema. A cell's leaf is looked up at
+     *  `${column.key}.${row.key}`; a cell with none draws a dash. */
+    schema: ResolvedConfig;
+    /** The scopes. The first is the fallback the others inherit from: its cells
+     *  never inherit, and its header is emphasized. */
+    columns: readonly ControlMatrixColumn[];
+    rows: readonly ControlMatrixRow[];
+    /** Values to show, already resolved: an inherited cell's value is the one it
+     *  inherits. */
+    config: Record<string, unknown>;
+    /** Full dotted paths whose cells inherit, drawn ghosted. */
+    auto: ReadonlySet<string>;
+    /** Writes a value, which pins the cell, or labkit's `auto` sentinel, which
+     *  unpins it. */
+    setConfig: (path: string, value: unknown) => void;
+    /** Clicking a column header. Without it the headers are plain text. */
+    onColumnClick?: (column: ControlMatrixColumn) => void;
+    /** What an inherited cell's tooltip says. Defaults to `from <first column>`. */
+    inheritHint?: (column: ControlMatrixColumn) => string;
+    className?: string;
+}
+/**
+ * One setting across several config groups of the same shape: settings down
+ * the side, scopes across the top, a compact read-only cell at each crossing.
+ * A cell inherits from the first column until it is pinned; inherited cells
+ * draw ghosted. Click a cell to edit it with the control a `ControlPanel` would
+ * draw (a boolean flips and a color opens its picker in place); editing pins,
+ * and the popover's Inherit button — or Option/Alt-click on the cell — unpins.
+ */
+declare function ControlMatrix({ title, stance, tone, schema, columns, rows, config, auto, setConfig, onColumnClick, inheritHint, className, }: ControlMatrixProps): ReactElement;
 
 /** How a panel packs its rows into the two-column property grid.
  *   - `'auto'`: narrow controls (numbers, checkboxes, dropdowns, colors) sit
@@ -90,4 +138,5 @@ declare function summarizeValue(value: unknown): string;
  */
 declare function inDialog(body: ControlRenderer, opts?: InDialogOptions): ControlRenderer;
 
-export { ConfigField, ControlPanel, InDialogOptions, inDialog, summarizeValue };
+export { ConfigField, ControlMatrix, ControlPanel, InDialogOptions, inDialog, summarizeValue };
+export type { ControlMatrixColumn, ControlMatrixProps, ControlMatrixRow };

package/dist/controls/index.js

@@ -1,7 +1,9 @@
-export { ControlPanel, inDialog, summarizeValue } from '../chunk-T5IBSPAM.js';
-import '../chunk-KMJ7RWD3.js';
-import '../chunk-Y23G2VZL.js';
-import '../chunk-MIM5R4ZT.js';
-import '../chunk-275JRRVD.js';
+export { ControlMatrix } from '../chunk-WFALF2X2.js';
+export { ControlPanel, inDialog, summarizeValue } from '../chunk-WWJDPNZZ.js';
+import '../chunk-WLMDTI2Q.js';
+import '../chunk-READTDQX.js';
+import '../chunk-U6UQVGFP.js';
+import '../chunk-E23Q6A3Y.js';
+import '../chunk-XVUKDSYV.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/dragdrop/index.d.ts

@@ -1,19 +1,25 @@
-import { n as PaletteItem, o as DragFeedback, q as DragDropCapability } from '../_dts/types-CSm9jgol.js';
+import { l as PaletteItem, m as DragFeedback, n as DragDropCapability } from '../_dts/index-DCMA4Fy1.js';
 import { WorldSpec } from '../canvas/index.js';
 import { Point, ViewTransform } from '../index.js';
 import * as react from 'react';
 import { RefObject, PointerEvent, ReactPortal } from 'react';
+import '@weasel-js/ui';
 import '@weasel-js/core';
-import '../_dts/PrefsRow.d-TOZ7BgD9.js';
 import '@weasel-js/theme';
-import '../_dts/types-CRPSGFAp.js';
+import '../_dts/types-BUBSIZuV.js';
+import '@weasel-js/quantity';
+import '@weasel-js/geom';
 import '../_dts/types-DJ79Tg5J.js';
 
+/** A palette drag in progress. `screenPos` is in client pixels; `feedback` is
+ *  the last `onDragOver` answer — `null` off the canvas or without one. */
 interface DragState {
     item: PaletteItem;
     screenPos: Point;
     feedback: DragFeedback | null;
 }
+/** Inputs to `useDragDrop`: the capability, the element that counts as the
+ *  drop target, and the trial state a drop rewrites. */
 interface UseDragDropArgs<TS, TC> {
     capability: DragDropCapability<TS, TC>;
     canvasContainerRef: RefObject<HTMLElement | null>;
@@ -26,27 +32,41 @@ interface UseDragDropArgs<TS, TC> {
     setState: (next: TS | ((prev: TS) => TS)) => void;
     emit: (event: string) => void;
 }
+/** The live drag, and the handler a palette item calls on pointerdown. */
 interface UseDragDropResult {
     drag: DragState | null;
     startDrag: (item: PaletteItem, e: PointerEvent) => void;
 }
+/**
+ * Run palette-to-canvas drags for a `DragDropCapability`. Releasing over the
+ * container converts the pointer to world coordinates, applies `onDrop`'s
+ * state and emits `'canvas.itemAdded'`; releasing anywhere else, or a canceled
+ * gesture, drops nothing. `onDragOver` is probed at most once per frame.
+ */
 declare function useDragDrop<TS, TC>({ capability, canvasContainerRef, view, state, config, setState, emit, worldSpec, }: UseDragDropArgs<TS, TC>): UseDragDropResult;
+/** Props for `DragOverlay`. */
 interface DragOverlayProps {
     drag: DragState | null;
 }
+/** The ghost for `drag`, or nothing when no drag is live. */
 declare function DragOverlay({ drag }: DragOverlayProps): react.JSX.Element | null;
 
+/** Props for `DragGhost`. `screenPos` is in client pixels. */
 interface DragGhostProps {
     item: PaletteItem;
     screenPos: Point;
 }
+/** The dragged item's label, portaled to `document.body` just below-right of
+ *  `screenPos`. Renders nothing until mounted, so it is SSR-safe. */
 declare function DragGhost({ item, screenPos }: DragGhostProps): ReactPortal | null;
 
+/** Props for `Palette`. `onDragStart` is usually `useDragDrop`'s `startDrag`. */
 interface PaletteProps {
     items: PaletteItem[];
     onDragStart: (item: PaletteItem, e: PointerEvent) => void;
     className?: string;
 }
+/** One button per item, each starting a drag on pointerdown. */
 declare function Palette({ items, onDragStart, className }: PaletteProps): react.JSX.Element;
 
 export { DragDropCapability, DragFeedback, DragGhost, DragOverlay, Palette, PaletteItem, useDragDrop };

package/dist/dragdrop/index.js

@@ -1,5 +1,6 @@
-export { DragGhost, DragOverlay, Palette, useDragDrop } from '../chunk-WPLAANH4.js';
-import '../chunk-AWQG7FCC.js';
-import '../chunk-24W5VEJW.js';
+export { DragGhost, DragOverlay, Palette, useDragDrop } from '../chunk-2N7UBSS2.js';
+import '../chunk-FG3EXZDV.js';
+import '../chunk-ULYYNWGP.js';
+import '../chunk-XVUKDSYV.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map