@weasel-js/labkit 1.4.4 → 1.5.0

package/dist/{chunk-U3IYHIAE.js → chunk-TQBBYTAF.js}

@@ -1,75 +1,10 @@
+import { fromConfigFields, isLeafVisible } from './chunk-UU3NJO6N.js';
 import { schemaNodeAtPath, valueAtPath } from './chunk-E44SU6XS.js';
-import { T2, H, t2, M2, L2, I, N2, A2, F, D, P2 } from './chunk-W3ECWC2K.js';
+import { E2, U2, n3, N2, R, L, P3, j2, I, O, F } from './chunk-S2SHZRD7.js';
 import { isBuiltinToolPref } from '@weasel-js/core';
 import { useMemo, Fragment as Fragment$1, useState, useRef, useEffect } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 
-// src/config/fromConfigField.ts
-function toLeaf(field) {
-  const base = { name: field.label, description: "" };
-  switch (field.type) {
-    case "slider":
-      return {
-        ...base,
-        kind: "number",
-        control: "slider",
-        min: field.min,
-        max: field.max,
-        step: field.step
-      };
-    case "number":
-      return {
-        ...base,
-        kind: "number",
-        control: "input",
-        min: field.min,
-        max: field.max,
-        step: field.step
-      };
-    case "checkbox":
-      return { ...base, kind: "boolean", control: "checkbox" };
-    case "select":
-      return { ...base, kind: "enum", options: field.options };
-    case "text":
-      return {
-        ...base,
-        kind: "string",
-        placeholder: field.placeholder,
-        maxLength: field.maxLength,
-        debounceMs: field.debounceMs
-      };
-    case "color":
-      return { ...base, kind: "color" };
-    default:
-      return { ...base, kind: field.type };
-  }
-}
-function fromConfigFields(fields) {
-  const children = {};
-  for (const field of fields) {
-    const patch = toLeaf(field);
-    for (const key of Object.keys(patch)) {
-      if (patch[key] === void 0) {
-        delete patch[key];
-      }
-    }
-    children[field.key] = { ...patch, default: field.default };
-  }
-  return {
-    group: { name: "", children },
-    sections: [],
-    showIf: /* @__PURE__ */ new Map(),
-    renderers: {}
-  };
-}
-
-// src/config/visible.ts
-function isLeafVisible(resolved, path, config, showHidden = false) {
-  const node = schemaNodeAtPath(resolved.group, path);
-  if (node && "hidden" in node && node.hidden === true && !showHidden) return false;
-  const predicate = resolved.showIf.get(path);
-  return predicate ? predicate(config) : true;
-}
 function ControlPanel({
   schema,
   fields,
@@ -101,7 +36,7 @@ function ControlPanel({
     const found = schemaNodeAtPath(resolved.group, path);
     if (!found) return null;
     if (!isLeafVisible(resolved, path, config, showHidden)) return null;
-    if (t2(found)) {
+    if (n3(found)) {
       return /* @__PURE__ */ jsx(
         ControlRow,
         {
@@ -118,7 +53,7 @@ function ControlPanel({
       );
     }
     if (found.name === "") return /* @__PURE__ */ jsx(Fragment$1, { children: body(found, path) }, path);
-    return /* @__PURE__ */ jsx(H, { title: found.name, ...fold(path), children: body(found, path) }, path);
+    return /* @__PURE__ */ jsx(U2, { title: found.name, ...fold(path), children: body(found, path) }, path);
   };
   const body = (group, at) => {
     const sections = resolved.sections.filter((s) => s.at === at);
@@ -127,7 +62,7 @@ function ControlPanel({
     return /* @__PURE__ */ jsxs(Fragment, { children: [
       paths.filter((p) => !sectioned.has(p)).map(node),
       sections.map((section) => /* @__PURE__ */ jsx(
-        H,
+        U2,
         {
           title: section.label,
           ...fold(sectionKey(section), section.collapsed),
@@ -138,7 +73,7 @@ function ControlPanel({
     ] });
   };
   return /* @__PURE__ */ jsx(
-    T2,
+    E2,
     {
       pack: gridPack,
       density,
@@ -181,15 +116,17 @@ function ControlRow({
       const max = extra(leaf, "max");
       const step = extra(leaf, "step");
       const suffix = extra(leaf, "suffix");
+      const notation = extra(leaf, "format");
       if (extra(leaf, "control") === "slider" && min !== void 0 && max !== void 0) {
         return /* @__PURE__ */ jsx(
-          A2,
+          j2,
           {
             label,
             value: read(),
             min,
             max,
             step,
+            notation,
             unit: suffix,
             onChange: write,
             layout,
@@ -201,7 +138,7 @@ function ControlRow({
       const lo = min ?? Number.NEGATIVE_INFINITY;
       const hi = max ?? Number.POSITIVE_INFINITY;
       return /* @__PURE__ */ jsx(
-        F,
+        I,
         {
           label,
           value: read(),
@@ -209,7 +146,7 @@ function ControlRow({
           max,
           step,
           unit: suffix,
-          onChange: (n) => write(Math.min(hi, Math.max(lo, n))),
+          onChange: (n2) => write(Math.min(hi, Math.max(lo, n2))),
           layout,
           description
         }
@@ -217,7 +154,7 @@ function ControlRow({
     }
     case "boolean":
       return /* @__PURE__ */ jsx(
-        N2,
+        P3,
         {
           label,
           value: read(),
@@ -229,7 +166,7 @@ function ControlRow({
     case "enum": {
       const options = extra(leaf, "options") ?? [];
       const segmented = extra(leaf, "control") === "radio";
-      const Row = segmented ? L2 : I;
+      const Row = segmented ? R : L;
       return /* @__PURE__ */ jsx(
         Row,
         {
@@ -258,7 +195,7 @@ function ControlRow({
       );
     case "color":
       return /* @__PURE__ */ jsx(
-        M2,
+        N2,
         {
           label,
           value: read(),
@@ -283,7 +220,7 @@ function UnwiredRow({
   kind,
   description
 }) {
-  return /* @__PURE__ */ jsx(D, { label, description, children: /* @__PURE__ */ jsxs("span", { className: "lk-control-panel__unknown", children: [
+  return /* @__PURE__ */ jsx(O, { label, description, children: /* @__PURE__ */ jsxs("span", { className: "lk-control-panel__unknown", children: [
     "no control for \u201C",
     kind,
     "\u201D"
@@ -315,7 +252,7 @@ function DebouncedTextRow({
     []
   );
   return /* @__PURE__ */ jsx(
-    P2,
+    F,
     {
       label,
       layout,
@@ -338,6 +275,6 @@ function DebouncedTextRow({
   );
 }
 
-export { ControlPanel, fromConfigFields, isLeafVisible };
-//# sourceMappingURL=chunk-U3IYHIAE.js.map
-//# sourceMappingURL=chunk-U3IYHIAE.js.map
+export { ControlPanel };
+//# sourceMappingURL=chunk-TQBBYTAF.js.map
+//# sourceMappingURL=chunk-TQBBYTAF.js.map

package/dist/chunk-TQBBYTAF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/controls/ControlPanel.tsx"],"names":["n","Fragment","U","E","value","j","P","N"],"mappings":"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","file":"chunk-TQBBYTAF.js","sourcesContent":["import { isBuiltinToolPref } from '@weasel-js/core';\nimport {\n  CheckboxRow,\n  ColorRow,\n  isPrefLeaf,\n  NumberRow,\n  type PrefGroup,\n  type PrefLeaf,\n  type PrefNumberFormat,\n  type PropertyAlign,\n  type PropertyDensity,\n  PropertyGroup,\n  PropertyList,\n  type PropertyListPack,\n  PropertyRow,\n  type PropertyRowLayout,\n  SelectRow,\n  SliderRow,\n  TextRow,\n  ToggleRow,\n} from '@weasel-js/ui';\nimport { Fragment, type ReactNode, useEffect, useMemo, useRef, useState } from 'react';\nimport { fromConfigFields } from '../config/fromConfigField';\nimport { schemaNodeAtPath, valueAtPath } from '../config/path';\nimport type { ControlRenderer, ResolvedConfig, SectionSpec } from '../config/types';\nimport { isLeafVisible } from '../config/visible';\nimport type { ConfigField } from './types';\n\n/** How a panel packs its rows into the two-column property grid.\n *   - `'auto'`: narrow controls (numbers, checkboxes, dropdowns, colors) sit\n *     two per row; the ones that need the width — text, sliders, segmented\n *     toggles — span it.\n *   - `'pairs'`: every row pairs. A control that needs the full width says so\n *     itself, with `<PropertyRow span>`.\n *   - `'one-up'`: one control per row, colors excepted.\n */\nexport type ControlPack = 'auto' | 'pairs' | 'one-up';\n\nexport interface ControlPanelProps<TC extends Record<string, unknown>> {\n  /** The instrument's resolved config schema. */\n  schema?: ResolvedConfig;\n  /** @deprecated Pass `schema`. A field list is adapted into one internally. */\n  fields?: ConfigField[];\n  config: TC;\n  /** Writes one value. The path is dotted for a leaf inside an `f.group`, and\n   *  the bare key for one at the root. */\n  setConfig: (path: string, value: unknown) => void;\n  /**\n   * Control overrides and app-defined kinds, PrefsForm-style. Keys are config\n   * paths (checked first) or leaf kinds. A renderer returning `null` collapses\n   * the row; entries override the built-in rows on collision.\n   */\n  renderers?: Record<string, ControlRenderer>;\n  /** How rows pack into the two-column grid. Defaults to `'pairs'`. */\n  pack?: ControlPack;\n  /**\n   * Where a row's label sits relative to its control. Unset takes each row's\n   * own orientation — `block` (label above, which is what leaves a paired row\n   * room for its value) for most, `inline` for colors and checkboxes.\n   */\n  layout?: PropertyRowLayout;\n  /** Room the rows get. Passed straight to the property list. */\n  density?: PropertyDensity;\n  /** Cross-axis alignment of an inline row's label and control. */\n  align?: PropertyAlign;\n  /**\n   * Fold each section away behind a twisty, starting `'open'` or `'closed'`.\n   * Unset draws the heading alone, as the panel always has — unless a section\n   * in the schema declares how it opens, which makes that section foldable on\n   * its own and outranks this for that one section.\n   */\n  collapse?: 'open' | 'closed';\n  /**\n   * Which sections are folded, keyed as `onCollapse` reports them. Given, the\n   * panel keeps no state of its own: every toggle arrives at `onCollapse`\n   * instead, which is where a lab that remembers a trial's sections writes\n   * them.\n   */\n  collapsed?: Readonly<Record<string, boolean>>;\n  /** A fold moved. The key is a section's label — prefixed by its group's\n   *  dotted path when the section sits inside one — or a group's own path. */\n  onCollapse?: (key: string, collapsed: boolean) => void;\n  /** Draw leaves marked `hidden`. */\n  showHidden?: boolean;\n  className?: string;\n}\n\n/** Render an instrument's config schema as a stack of controls, each writing\n *  back through `setConfig`. Built on the property rows, so a lab's controls\n *  are the same aligned, themed rows the rest of the kit uses. */\nexport function ControlPanel<TC extends Record<string, unknown>>({\n  schema,\n  fields,\n  config,\n  setConfig,\n  renderers,\n  pack = 'pairs',\n  layout,\n  density,\n  align,\n  collapse,\n  collapsed,\n  onCollapse,\n  showHidden = false,\n  className,\n}: ControlPanelProps<TC>) {\n  const resolved = useMemo(() => schema ?? fromConfigFields(fields ?? []), [schema, fields]);\n\n  const gridPack: PropertyListPack = pack === 'one-up' ? 'auto-color' : 'pairs';\n  // A section that declares how it opens is foldable whether or not the lab\n  // asked for folds — there is nothing else for the declaration to mean.\n  const folds =\n    collapse !== undefined ||\n    collapsed !== undefined ||\n    onCollapse !== undefined ||\n    resolved.sections.some((s) => s.collapsed !== undefined);\n  const startsFolded = collapse === 'closed';\n\n  const fold = (key: string, declared?: boolean) => ({\n    pack: gridPack,\n    collapsible: folds,\n    defaultCollapsed: declared ?? startsFolded,\n    collapsed: collapsed ? (collapsed[key] ?? declared ?? startsFolded) : undefined,\n    onCollapsedChange: onCollapse ? (next: boolean) => onCollapse(key, next) : undefined,\n  });\n\n  /** One node, which is either a group to recurse into or a row to draw. */\n  const node = (path: string): ReactNode => {\n    const found = schemaNodeAtPath(resolved.group, path);\n    if (!found) return null;\n    if (!isLeafVisible(resolved, path, config as Record<string, unknown>, showHidden)) return null;\n    if (isPrefLeaf(found)) {\n      return (\n        <ControlRow\n          key={path}\n          path={path}\n          leaf={found}\n          resolved={resolved}\n          config={config}\n          setConfig={setConfig}\n          renderers={renderers}\n          pack={pack}\n          layout={layout}\n        />\n      );\n    }\n    // A group with no name organizes without heading it — core's rule for an\n    // empty `PrefGroup.name` — so it contributes its rows and no chrome.\n    if (found.name === '') return <Fragment key={path}>{body(found, path)}</Fragment>;\n    return (\n      <PropertyGroup key={path} title={found.name} {...fold(path)}>\n        {body(found, path)}\n      </PropertyGroup>\n    );\n  };\n\n  /** One group's children: its loose nodes, then its sections. */\n  const body = (group: PrefGroup, at: string): ReactNode => {\n    const sections = resolved.sections.filter((s) => s.at === at);\n    const sectioned = new Set(sections.flatMap((s) => s.paths));\n    const paths = Object.keys(group.children).map((key) => (at === '' ? key : `${at}.${key}`));\n    return (\n      <>\n        {paths.filter((p) => !sectioned.has(p)).map(node)}\n        {sections.map((section) => (\n          <PropertyGroup\n            key={sectionKey(section)}\n            title={section.label}\n            {...fold(sectionKey(section), section.collapsed)}\n          >\n            {section.paths.map(node)}\n          </PropertyGroup>\n        ))}\n      </>\n    );\n  };\n\n  return (\n    <PropertyList\n      pack={gridPack}\n      density={density}\n      align={align}\n      className={className ? `lk-control-panel ${className}` : 'lk-control-panel'}\n    >\n      {body(resolved.group, '')}\n    </PropertyList>\n  );\n}\n\n/** How a section is keyed for folding: its label at the root, and its group's\n *  path in front of it anywhere else, so two groups may both have an\n *  `Advanced`. */\nfunction sectionKey(section: SectionSpec): string {\n  return section.at === '' ? section.label : `${section.at}.${section.label}`;\n}\n\ninterface ControlRowProps<TC extends Record<string, unknown>> {\n  path: string;\n  leaf: PrefLeaf;\n  resolved: ResolvedConfig;\n  config: TC;\n  setConfig: (path: string, value: unknown) => void;\n  renderers?: Record<string, ControlRenderer>;\n  pack: ControlPack;\n  layout?: PropertyRowLayout;\n}\n\n/** Reads a labkit-only extra off a leaf. `PrefLeaf` has no field for these,\n *  and extra keys survive the resolve pass at runtime. */\nfunction extra<T>(leaf: PrefLeaf, key: string): T | undefined {\n  return (leaf as unknown as Record<string, T | undefined>)[key];\n}\n\nfunction ControlRow<TC extends Record<string, unknown>>({\n  path,\n  leaf,\n  resolved,\n  config,\n  setConfig,\n  renderers,\n  pack,\n  layout,\n}: ControlRowProps<TC>) {\n  const write = (value: unknown): void => setConfig(path, value);\n  const fallback = extra<unknown>(leaf, 'default');\n  const value = valueAtPath(config, path) ?? fallback;\n\n  // Most specific wins, and within a tier the lab's entry beats the\n  // instrument's: controls[path] -> node .render -> controls[kind] -> built-in.\n  const custom = renderers?.[path] ?? resolved.renderers[path] ?? renderers?.[leaf.kind];\n  // A custom row places itself like any other; one that needs the full width\n  // says so with `<PropertyRow span>`, which is the same opt-out a built-in has.\n  if (custom) return custom({ path, pref: leaf, value, setValue: write });\n\n  const label = leaf.name;\n  const description = leaf.description;\n  const read = <T,>(): T => value as T;\n  // `auto` gives the whole width to the controls that read badly at half of a\n  // sidebar's: free text, a slider track, a segmented toggle. `pairs` doesn't.\n  const wide = pack === 'auto';\n\n  if (!isBuiltinToolPref(leaf))\n    return <UnwiredRow label={label} kind={leaf.kind} description={description} />;\n\n  switch (leaf.kind) {\n    case 'number': {\n      const min = extra<number>(leaf, 'min');\n      const max = extra<number>(leaf, 'max');\n      const step = extra<number>(leaf, 'step');\n      const suffix = extra<string>(leaf, 'suffix');\n      const notation = extra<PrefNumberFormat>(leaf, 'format');\n      if (extra<string>(leaf, 'control') === 'slider' && min !== undefined && max !== undefined) {\n        return (\n          <SliderRow\n            label={label}\n            value={read<number>()}\n            min={min}\n            max={max}\n            step={step}\n            notation={notation}\n            unit={suffix}\n            onChange={write}\n            layout={layout}\n            span={wide}\n            description={description}\n          />\n        );\n      }\n      // NumberRow commits every keystroke and does not clamp, so the bounds a\n      // schema declares are enforced here — an instrument should never be\n      // handed a config value outside the range it asked for.\n      const lo = min ?? Number.NEGATIVE_INFINITY;\n      const hi = max ?? Number.POSITIVE_INFINITY;\n      return (\n        <NumberRow\n          label={label}\n          value={read<number>()}\n          min={min}\n          max={max}\n          step={step}\n          unit={suffix}\n          onChange={(n) => write(Math.min(hi, Math.max(lo, n)))}\n          layout={layout}\n          description={description}\n        />\n      );\n    }\n    case 'boolean':\n      return (\n        <CheckboxRow\n          label={label}\n          value={read<boolean>()}\n          onChange={write}\n          layout={layout}\n          description={description}\n        />\n      );\n    case 'enum': {\n      const options = extra<readonly { value: string; label: string }[]>(leaf, 'options') ?? [];\n      const segmented = extra<string>(leaf, 'control') === 'radio';\n      const Row = segmented ? ToggleRow : SelectRow;\n      return (\n        <Row\n          label={label}\n          value={read<string>()}\n          options={options}\n          onChange={write}\n          layout={layout}\n          span={segmented && wide}\n          description={description}\n        />\n      );\n    }\n    case 'string':\n      return (\n        <DebouncedTextRow\n          leaf={leaf}\n          label={label}\n          value={read<string>()}\n          write={write}\n          layout={layout}\n          span={wide}\n          description={description}\n        />\n      );\n    case 'color':\n      return (\n        <ColorRow\n          label={label}\n          value={read<string>()}\n          onChange={write}\n          layout={layout}\n          description={description}\n        />\n      );\n    case 'paint':\n    case 'object':\n      // Declined: a hex swatch would write a solid over a gradient, and a flat\n      // row would write one field into a half-built object. Override with\n      // `render` to edit either.\n      return <UnwiredRow label={label} kind={leaf.kind} description={description} />;\n    default: {\n      // Not reachable while every built-in kind has an arm — and a new kind\n      // that lacks one is a compile error here, never a blank row.\n      const _exhaustive: never = leaf;\n      throw new Error(\n        `ControlPanel: no control for built-in pref kind \"${(_exhaustive as { kind: string }).kind}\"`,\n      );\n    }\n  }\n}\n\n/** A leaf this panel has no control for is named rather than dropped: a silent\n *  gap reads as \"this control does not exist\". */\nfunction UnwiredRow({\n  label,\n  kind,\n  description,\n}: {\n  label: string;\n  kind: string;\n  description?: string;\n}) {\n  return (\n    <PropertyRow label={label} description={description}>\n      <span className=\"lk-control-panel__unknown\">no control for “{kind}”</span>\n    </PropertyRow>\n  );\n}\n\n/** Text writes are debounced so typing does not re-run the instrument on every\n *  keystroke, which means the row is locally controlled between commits and has\n *  to notice when the config changes underneath it. */\nfunction DebouncedTextRow({\n  leaf,\n  label,\n  value,\n  write,\n  layout,\n  span,\n  description,\n}: {\n  leaf: PrefLeaf;\n  label: string;\n  value: string;\n  write: (value: unknown) => void;\n  layout?: PropertyRowLayout;\n  span?: boolean;\n  description?: string;\n}) {\n  const debounceMs = extra<number>(leaf, 'debounceMs') ?? 150;\n  const [local, setLocal] = useState(value);\n  const timer = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const lastExternal = useRef(value);\n\n  useEffect(() => {\n    if (value !== lastExternal.current) {\n      lastExternal.current = value;\n      setLocal(value);\n    }\n  }, [value]);\n\n  useEffect(\n    () => () => {\n      if (timer.current) clearTimeout(timer.current);\n    },\n    [],\n  );\n\n  return (\n    <TextRow\n      label={label}\n      layout={layout}\n      span={span}\n      description={description}\n      value={local}\n      placeholder={extra<string>(leaf, 'placeholder')}\n      maxLength={extra<number>(leaf, 'maxLength')}\n      onChange={(next) => {\n        setLocal(next);\n        if (timer.current) clearTimeout(timer.current);\n        const commit = () => {\n          lastExternal.current = next;\n          write(next);\n        };\n        if (debounceMs === 0) commit();\n        else timer.current = setTimeout(commit, debounceMs);\n      }}\n    />\n  );\n}\n"]}

package/dist/chunk-UU3NJO6N.js

@@ -0,0 +1,72 @@
+import { schemaNodeAtPath } from './chunk-E44SU6XS.js';
+
+// src/config/fromConfigField.ts
+function toLeaf(field) {
+  const base = { name: field.label, description: "" };
+  switch (field.type) {
+    case "slider":
+      return {
+        ...base,
+        kind: "number",
+        control: "slider",
+        min: field.min,
+        max: field.max,
+        step: field.step
+      };
+    case "number":
+      return {
+        ...base,
+        kind: "number",
+        control: "input",
+        min: field.min,
+        max: field.max,
+        step: field.step
+      };
+    case "checkbox":
+      return { ...base, kind: "boolean", control: "checkbox" };
+    case "select":
+      return { ...base, kind: "enum", options: field.options };
+    case "text":
+      return {
+        ...base,
+        kind: "string",
+        placeholder: field.placeholder,
+        maxLength: field.maxLength,
+        debounceMs: field.debounceMs
+      };
+    case "color":
+      return { ...base, kind: "color" };
+    default:
+      return { ...base, kind: field.type };
+  }
+}
+function fromConfigFields(fields) {
+  const children = {};
+  for (const field of fields) {
+    const patch = toLeaf(field);
+    for (const key of Object.keys(patch)) {
+      if (patch[key] === void 0) {
+        delete patch[key];
+      }
+    }
+    children[field.key] = { ...patch, default: field.default };
+  }
+  return {
+    group: { name: "", children },
+    sections: [],
+    showIf: /* @__PURE__ */ new Map(),
+    renderers: {}
+  };
+}
+
+// src/config/visible.ts
+function isLeafVisible(resolved, path, config, showHidden = false) {
+  const node = schemaNodeAtPath(resolved.group, path);
+  if (node && "hidden" in node && node.hidden === true && !showHidden) return false;
+  const predicate = resolved.showIf.get(path);
+  return predicate ? predicate(config) : true;
+}
+
+export { fromConfigFields, isLeafVisible };
+//# sourceMappingURL=chunk-UU3NJO6N.js.map
+//# sourceMappingURL=chunk-UU3NJO6N.js.map

package/dist/chunk-UU3NJO6N.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/fromConfigField.ts","../src/config/visible.ts"],"names":[],"mappings":";;;AAOA,SAAS,OAAO,KAAA,EAA+B;AAC7C,EAAA,MAAM,OAAO,EAAE,IAAA,EAAM,KAAA,CAAM,KAAA,EAAO,aAAa,EAAA,EAAG;AAClD,EAAA,QAAQ,MAAM,IAAA;AAAM,IAClB,KAAK,QAAA;AACH,MAAA,OAAO;AAAA,QACL,GAAG,IAAA;AAAA,QACH,IAAA,EAAM,QAAA;AAAA,QACN,OAAA,EAAS,QAAA;AAAA,QACT,KAAK,KAAA,CAAM,GAAA;AAAA,QACX,KAAK,KAAA,CAAM,GAAA;AAAA,QACX,MAAM,KAAA,CAAM;AAAA,OACd;AAAA,IACF,KAAK,QAAA;AACH,MAAA,OAAO;AAAA,QACL,GAAG,IAAA;AAAA,QACH,IAAA,EAAM,QAAA;AAAA,QACN,OAAA,EAAS,OAAA;AAAA,QACT,KAAK,KAAA,CAAM,GAAA;AAAA,QACX,KAAK,KAAA,CAAM,GAAA;AAAA,QACX,MAAM,KAAA,CAAM;AAAA,OACd;AAAA,IACF,KAAK,UAAA;AACH,MAAA,OAAO,EAAE,GAAG,IAAA,EAAM,IAAA,EAAM,SAAA,EAAW,SAAS,UAAA,EAAW;AAAA,IACzD,KAAK,QAAA;AACH,MAAA,OAAO,EAAE,GAAG,IAAA,EAAM,MAAM,MAAA,EAAQ,OAAA,EAAS,MAAM,OAAA,EAAQ;AAAA,IACzD,KAAK,MAAA;AACH,MAAA,OAAO;AAAA,QACL,GAAG,IAAA;AAAA,QACH,IAAA,EAAM,QAAA;AAAA,QACN,aAAa,KAAA,CAAM,WAAA;AAAA,QACnB,WAAW,KAAA,CAAM,SAAA;AAAA,QACjB,YAAY,KAAA,CAAM;AAAA,OACpB;AAAA,IACF,KAAK,OAAA;AACH,MAAA,OAAO,EAAE,GAAG,IAAA,EAAM,IAAA,EAAM,OAAA,EAAQ;AAAA,IAClC;AAGE,MAAA,OAAO,EAAE,GAAG,IAAA,EAAM,IAAA,EAAO,MAAsB,IAAA,EAAK;AAAA;AAE1D;AASO,SAAS,iBAAiB,MAAA,EAAgD;AAC/E,EAAA,MAAM,WAAqC,EAAC;AAC5C,EAAA,KAAA,MAAW,SAAS,MAAA,EAAQ;AAC1B,IAAA,MAAM,KAAA,GAAQ,OAAO,KAAK,CAAA;AAC1B,IAAA,KAAA,MAAW,GAAA,IAAO,MAAA,CAAO,IAAA,CAAK,KAAK,CAAA,EAAG;AACpC,MAAA,IAAK,KAAA,CAAkC,GAAG,CAAA,KAAM,MAAA,EAAW;AACzD,QAAA,OAAQ,MAAkC,GAAG,CAAA;AAAA,MAC/C;AAAA,IACF;AACA,IAAA,QAAA,CAAS,KAAA,CAAM,GAAG,CAAA,GAAI,EAAE,GAAG,KAAA,EAAO,OAAA,EAAS,MAAM,OAAA,EAAQ;AAAA,EAC3D;AACA,EAAA,OAAO;AAAA,IACL,KAAA,EAAO,EAAE,IAAA,EAAM,EAAA,EAAI,QAAA,EAAS;AAAA,IAC5B,UAAU,EAAC;AAAA,IACX,MAAA,sBAAY,GAAA,EAAI;AAAA,IAChB,WAAW;AAAC,GACd;AACF;;;AC9DO,SAAS,aAAA,CACd,QAAA,EACA,IAAA,EACA,MAAA,EACA,aAAa,KAAA,EACJ;AACT,EAAA,MAAM,IAAA,GAAO,gBAAA,CAAiB,QAAA,CAAS,KAAA,EAAO,IAAI,CAAA;AAClD,EAAA,IAAI,IAAA,IAAQ,YAAY,IAAA,IAAQ,IAAA,CAAK,WAAW,IAAA,IAAQ,CAAC,YAAY,OAAO,KAAA;AAC5E,EAAA,MAAM,SAAA,GAAY,QAAA,CAAS,MAAA,CAAO,GAAA,CAAI,IAAI,CAAA;AAC1C,EAAA,OAAO,SAAA,GAAY,SAAA,CAAU,MAAM,CAAA,GAAI,IAAA;AACzC","file":"chunk-UU3NJO6N.js","sourcesContent":["import type { PrefLeaf } from '@weasel-js/ui';\nimport type { ConfigField } from '../controls/types';\nimport type { LeafPatch, ResolvedConfig } from './types';\n\n/** One `ConfigField` as the `Pref*` vocabulary spells it. The two describe the\n *  same thing; `ConfigField` just keys on the control where `PrefLeaf`\n *  separates the value's kind from how it is presented. */\nfunction toLeaf(field: ConfigField): LeafPatch {\n  const base = { name: field.label, description: '' };\n  switch (field.type) {\n    case 'slider':\n      return {\n        ...base,\n        kind: 'number',\n        control: 'slider',\n        min: field.min,\n        max: field.max,\n        step: field.step,\n      };\n    case 'number':\n      return {\n        ...base,\n        kind: 'number',\n        control: 'input',\n        min: field.min,\n        max: field.max,\n        step: field.step,\n      };\n    case 'checkbox':\n      return { ...base, kind: 'boolean', control: 'checkbox' };\n    case 'select':\n      return { ...base, kind: 'enum', options: field.options };\n    case 'text':\n      return {\n        ...base,\n        kind: 'string',\n        placeholder: field.placeholder,\n        maxLength: field.maxLength,\n        debounceMs: field.debounceMs,\n      };\n    case 'color':\n      return { ...base, kind: 'color' };\n    default:\n      // A schema can arrive from outside TypeScript. Carry the kind through\n      // so a lab-supplied renderer can still claim it.\n      return { ...base, kind: (field as ConfigField).type };\n  }\n}\n\n/**\n * Adapt a legacy `configSchema(): ConfigField[]` into the resolved shape, so\n * both instrument paths reach one renderer.\n *\n * Rules do not run here: a hand-written `ConfigField` already states its label\n * and control, which is everything the rule chain would have inferred.\n */\nexport function fromConfigFields(fields: readonly ConfigField[]): ResolvedConfig {\n  const children: Record<string, PrefLeaf> = {};\n  for (const field of fields) {\n    const patch = toLeaf(field);\n    for (const key of Object.keys(patch)) {\n      if ((patch as Record<string, unknown>)[key] === undefined) {\n        delete (patch as Record<string, unknown>)[key];\n      }\n    }\n    children[field.key] = { ...patch, default: field.default } as PrefLeaf;\n  }\n  return {\n    group: { name: '', children },\n    sections: [],\n    showIf: new Map(),\n    renderers: {},\n  };\n}\n","import { schemaNodeAtPath } from './path';\nimport type { ResolvedConfig } from './types';\n\n/**\n * Whether the row at a dotted path should be drawn right now. A group answers\n * for its whole subtree — hiding one hides everything under it.\n *\n * `hidden` is the node's own static flag; `showIf` is the schema's predicate\n * over the live config. Both are presentational — a hidden leaf keeps its\n * value and the instrument still reads it.\n */\nexport function isLeafVisible(\n  resolved: ResolvedConfig,\n  path: string,\n  config: Record<string, unknown>,\n  showHidden = false,\n): boolean {\n  const node = schemaNodeAtPath(resolved.group, path);\n  if (node && 'hidden' in node && node.hidden === true && !showHidden) return false;\n  const predicate = resolved.showIf.get(path);\n  return predicate ? predicate(config) : true;\n}\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-TJ7QY3OC.js → chunk-ZPH5WTWF.js}

@@ -1,7 +1,7 @@
-import { centerOn, zoomAt } from './chunk-CTRKTLYZ.js';
+import { centerOn, zoomAt } from './chunk-H6ZAOWNE.js';
 import { resolveFrame, screenToWorld, DEFAULT_FRAME } from './chunk-2AYGEN57.js';
 import { CanvasStackContext } from './chunk-CQLQPQ4P.js';
-import { useVisibleRaf } from '@weasel-js/core';
+import { useVisibleRaf, normalizeZoom } from '@weasel-js/core';
 import { useRef, useEffect, useReducer, useCallback, useContext, useMemo, useState } from 'react';
 import { jsx } from 'react/jsx-runtime';
 
@@ -177,8 +177,6 @@ function useHostSize(ref) {
   }, [ref]);
   return size;
 }
-
-// ../loupe/dist/index.js
 function loupeSourcePoint(p, rect, aim, factor) {
   return {
     x: aim.x + (p.x - (rect.x + rect.w / 2)) / factor,
@@ -188,25 +186,32 @@ function loupeSourcePoint(p, rect, aim, factor) {
 function createLoupeModel(opts) {
   const { surface } = opts;
   let mode = opts.mode ?? "vector";
-  let factor = opts.factor ?? 8;
+  let factor = normalizeZoom(opts.factor ?? 8);
   let aim = { x: 0, y: 0 };
   let color = null;
   let disposed = false;
-  const clamp = (n) => Math.min(
+  let aimUnsampled = false;
+  const clamp = (n) => normalizeZoom(Math.min(
     opts.maxFactor ?? Number.POSITIVE_INFINITY,
     Math.max(opts.minFactor ?? Number.NEGATIVE_INFINITY, n)
-  );
-  const teardown = () => {
-    if (disposed) return;
-    disposed = true;
-    opts.onDispose?.();
-  };
+  ));
   const sampleColor = () => {
     const hex = surface.sample(aim);
     if (hex === null || hex === color) return;
     color = hex;
     opts.onColorChange?.(hex);
   };
+  const unsubscribeFrame = surface.subscribeFrame?.(() => {
+    if (!aimUnsampled) return;
+    aimUnsampled = false;
+    sampleColor();
+  });
+  const teardown = () => {
+    if (disposed) return;
+    disposed = true;
+    unsubscribeFrame?.();
+    opts.onDispose?.();
+  };
   return {
     get mode() {
       return mode;
@@ -239,7 +244,8 @@ function createLoupeModel(opts) {
       if (surface.hidden()) return;
       if (surface.covers(p)) return;
       aim = p;
-      sampleColor();
+      if (unsubscribeFrame) aimUnsampled = true;
+      else sampleColor();
       surface.changed();
     },
     pick(p) {
@@ -454,5 +460,5 @@ function resolveLoupe(declared) {
 }
 
 export { CanvasLoupe, DomLoupe, LOUPE_DEFAULTS, LoupeBubble, TrialLoupe, drawCanvasLens, lensCamera, lensSourceRect, resolveLoupe, sampleStack, useLoupe };
-//# sourceMappingURL=chunk-TJ7QY3OC.js.map
-//# sourceMappingURL=chunk-TJ7QY3OC.js.map
+//# sourceMappingURL=chunk-ZPH5WTWF.js.map
+//# sourceMappingURL=chunk-ZPH5WTWF.js.map

package/dist/chunk-ZPH5WTWF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/loupe/canvasLens.ts","../src/loupe/CanvasLoupe.tsx","../src/loupe/DomLoupe.tsx","../src/loupe/LoupeBubble.tsx","../src/loupe/useHostSize.ts","../../loupe/src/geometry.ts","../../loupe/src/model.ts","../src/loupe/useLoupe.ts","../src/loupe/TrialLoupe.tsx","../src/loupe/types.ts"],"names":["jsx","useEffect","useRef"],"mappings":"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","file":"chunk-ZPH5WTWF.js","sourcesContent":["import type { LoupePoint } from '@weasel-js/loupe';\nimport { centerOn } from '../canvas/camera';\nimport { screenToWorld } from '../canvas/canvasCoords';\nimport type { CanvasLayerDescriptor } from '../canvas/useLayerScheduler';\nimport { DEFAULT_FRAME, resolveFrame, type WorldFrame, type WorldSpec } from '../canvas/worldSpec';\nimport type { ViewTransform } from '../instrument/types';\n\n/** The camera a round lens of `diameter` shows a magnified region through, and\n *  the coordinate system it is read in — the instrument's own `WorldSpec`,\n *  resolved against the lens rather than the stack. */\nexport interface LensCamera {\n  view: ViewTransform;\n  frame: WorldFrame;\n}\n\n/**\n * What a lens aimed at `aim` renders the stack's layers through.\n *\n * The lens is its own viewport, so the world spec resolves against its box: an\n * instrument centred on its viewport is centred in the lens too.\n */\nexport function lensCamera(\n  aim: LoupePoint,\n  outer: ViewTransform,\n  outerFrame: WorldFrame,\n  factor: number,\n  diameter: number,\n  worldSpec?: WorldSpec,\n): LensCamera {\n  const size = { width: diameter, height: diameter };\n  const frame = resolveFrame(worldSpec, size);\n  const world = screenToWorld(aim, outer, outerFrame);\n  return { view: centerOn(world, outer.zoom * factor, size, frame), frame };\n}\n\n/** A rectangle in a backing store's own device pixels. */\nexport interface SourceRect {\n  sx: number;\n  sy: number;\n  sw: number;\n  sh: number;\n}\n\n/**\n * The region a pixel-mode lens copies out of a presented canvas: the `diameter\n * / factor` CSS px around `aim`, in that canvas' backing-store pixels.\n */\nexport function lensSourceRect(\n  aim: LoupePoint,\n  factor: number,\n  diameter: number,\n  dpr: number,\n): SourceRect {\n  const span = diameter / factor;\n  return {\n    sx: (aim.x - span / 2) * dpr,\n    sy: (aim.y - span / 2) * dpr,\n    sw: span * dpr,\n    sh: span * dpr,\n  };\n}\n\n/**\n * The color a stack presents at a point: the topmost visible layer with\n * anything opaque there, or `null` when every layer is transparent — which is\n * the honest answer for a point showing nothing but the workspace behind.\n */\nexport function sampleStack(\n  layers: readonly CanvasLayerDescriptor[],\n  canvases: Map<string, HTMLCanvasElement>,\n  p: LoupePoint,\n  dpr: number,\n): string | null {\n  for (let i = layers.length - 1; i >= 0; i--) {\n    const layer = layers[i];\n    if (!layer.visible) continue;\n    const canvas = canvases.get(layer.id);\n    if (!canvas) continue;\n    const ctx = canvas.getContext('2d', { willReadFrequently: true });\n    if (!ctx) continue;\n    const x = Math.floor(p.x * dpr);\n    const y = Math.floor(p.y * dpr);\n    if (x < 0 || y < 0 || x >= canvas.width || y >= canvas.height) continue;\n    const [r, g, b, a] = ctx.getImageData(x, y, 1, 1).data;\n    if (a === 0) continue;\n    return `#${[r, g, b].map((c) => c.toString(16).padStart(2, '0')).join('')}`;\n  }\n  return null;\n}\n\n/** Redraw the stack into a lens' own canvas. `mode` decides whether the layers\n *  are re-run at the lens camera or their presented pixels are enlarged. */\nexport function drawCanvasLens(\n  ctx: CanvasRenderingContext2D,\n  opts: {\n    aim: LoupePoint;\n    factor: number;\n    diameter: number;\n    dpr: number;\n    mode: 'vector' | 'pixel';\n    outer: ViewTransform;\n    outerFrame?: WorldFrame;\n    worldSpec?: WorldSpec;\n    layers: readonly CanvasLayerDescriptor[];\n    canvases: Map<string, HTMLCanvasElement>;\n  },\n): void {\n  const { aim, factor, diameter, dpr, mode, outer, layers, canvases } = opts;\n  ctx.save();\n  ctx.setTransform(dpr, 0, 0, dpr, 0, 0);\n  ctx.clearRect(0, 0, diameter, diameter);\n\n  if (mode === 'pixel') {\n    const { sx, sy, sw, sh } = lensSourceRect(aim, factor, diameter, dpr);\n    ctx.imageSmoothingEnabled = false;\n    for (const layer of layers) {\n      if (!layer.visible) continue;\n      const canvas = canvases.get(layer.id);\n      if (!canvas || canvas.width === 0 || canvas.height === 0) continue;\n      ctx.drawImage(canvas, sx, sy, sw, sh, 0, 0, diameter, diameter);\n    }\n    ctx.restore();\n    return;\n  }\n\n  const lens = lensCamera(\n    aim,\n    outer,\n    opts.outerFrame ?? DEFAULT_FRAME,\n    factor,\n    diameter,\n    opts.worldSpec,\n  );\n  for (const layer of layers) {\n    if (!layer.visible) continue;\n    ctx.save();\n    layer.render(ctx, lens.view, lens.frame);\n    ctx.restore();\n  }\n  ctx.restore();\n}\n","import { useVisibleRaf } from '@weasel-js/core';\nimport type { LoupeMode, LoupePoint } from '@weasel-js/loupe';\nimport { useEffect, useRef } from 'react';\nimport type { CanvasStackSurface } from '../canvas/CanvasStackContext';\nimport type { WorldFrame, WorldSpec } from '../canvas/worldSpec';\nimport type { ViewTransform } from '../instrument/types';\nimport { drawCanvasLens } from './canvasLens';\n\n/** Props for `<CanvasLoupe>`. */\nexport interface CanvasLoupeProps {\n  aim: LoupePoint;\n  factor: number;\n  mode: LoupeMode;\n  diameter: number;\n  /** The stack being magnified: its layers, its pixels, and its measured box. */\n  surface: CanvasStackSurface;\n  view: ViewTransform;\n  frame: WorldFrame;\n  worldSpec?: WorldSpec;\n}\n\n/**\n * Paints a lens over a `<CanvasStack>` by re-drawing the stack's layers through\n * a zoomed camera — so the magnified content is as sharp as the original, at\n * any factor. `pixel` mode enlarges what the stack presented instead.\n */\nexport function CanvasLoupe({\n  aim,\n  factor,\n  mode,\n  diameter,\n  surface,\n  view,\n  frame,\n  worldSpec,\n}: CanvasLoupeProps) {\n  const canvasRef = useRef<HTMLCanvasElement | null>(null);\n  const dpr = surface.size.dpr;\n\n  // Whatever the stack redraws every frame, the lens has to redraw too — an\n  // instrument that animates from its own loop never re-renders this component.\n  const args = { aim, factor, mode, diameter, dpr, view, frame, worldSpec, surface };\n  const argsRef = useRef(args);\n  argsRef.current = args;\n\n  const loop = useVisibleRaf(\n    () => {\n      loop.request();\n      const canvas = canvasRef.current;\n      const ctx = canvas?.getContext('2d');\n      const canvases = argsRef.current.surface.canvases.current;\n      if (!ctx || !canvases) return;\n      const a = argsRef.current;\n      drawCanvasLens(ctx, {\n        aim: a.aim,\n        factor: a.factor,\n        diameter: a.diameter,\n        dpr: a.dpr,\n        mode: a.mode,\n        outer: a.view,\n        outerFrame: a.frame,\n        worldSpec: a.worldSpec,\n        layers: a.surface.layers,\n        canvases,\n      });\n    },\n    { target: canvasRef },\n  );\n\n  useEffect(() => {\n    loop.request();\n    return () => loop.cancel();\n  }, [loop]);\n\n  return (\n    <canvas\n      ref={canvasRef}\n      className=\"lk-loupe__canvas\"\n      width={Math.max(1, Math.round(diameter * dpr))}\n      height={Math.max(1, Math.round(diameter * dpr))}\n    />\n  );\n}\n","import type { LoupeMode, LoupePoint } from '@weasel-js/loupe';\nimport type { CSSProperties } from 'react';\nimport { zoomAt } from '../canvas/camera';\nimport type { ViewportSize, WorldFrame } from '../canvas/worldSpec';\nimport type { ViewTransform } from '../instrument/types';\nimport type { LoupeRenderArgs } from './types';\n\n/** Props for `<DomLoupe>`. */\nexport interface DomLoupeProps {\n  aim: LoupePoint;\n  factor: number;\n  mode: LoupeMode;\n  diameter: number;\n  /** The host the instrument draws into, which the stage reproduces. */\n  size: ViewportSize;\n  /** The trial's own camera. */\n  view: ViewTransform;\n  frame?: WorldFrame;\n  state: unknown;\n  config: unknown;\n  render: (args: LoupeRenderArgs) => React.ReactNode;\n}\n\n/**\n * Paints a lens over DOM content by asking the instrument to draw itself again\n * at a magnified camera.\n *\n * The stage is a full copy of the host, so the instrument's own layout still\n * holds; the camera is composed about the aimed point, which keeps that point\n * where it already was, and the stage is then slid by `diameter / 2 - aim` to\n * bring it to the middle of the lens.\n */\nexport function DomLoupe({\n  aim,\n  factor,\n  mode,\n  diameter,\n  size,\n  view,\n  frame,\n  state,\n  config,\n  render,\n}: DomLoupeProps) {\n  const style: CSSProperties = {\n    width: `${size.width}px`,\n    height: `${size.height}px`,\n    transform: `translate(${diameter / 2 - aim.x}px, ${diameter / 2 - aim.y}px)`,\n  };\n  return (\n    <div className=\"lk-loupe__stage\" style={style}>\n      {render({\n        state,\n        config,\n        view: zoomAt(view, factor, aim, { frame }),\n        factor,\n        mode,\n        size,\n      })}\n    </div>\n  );\n}\n","import type { LoupePoint } from '@weasel-js/loupe';\nimport type { CSSProperties, ReactNode, RefObject } from 'react';\n\n/** Props for `<LoupeBubble>`. */\nexport interface LoupeBubbleProps {\n  /** Where the lens is aimed, in its container's own pixels. */\n  aim: LoupePoint;\n  diameter: number;\n  hostRef?: RefObject<HTMLDivElement | null>;\n  children: ReactNode;\n}\n\n/**\n * The lens itself: a circle centred on the aimed point, clipping whatever a\n * painter draws into it.\n *\n * It takes no pointer events, so the pan, the wheel and anything underneath\n * keep working while it is up — and it is `aria-hidden`, since it magnifies\n * content already on the page rather than adding any.\n */\nexport function LoupeBubble({ aim, diameter, hostRef, children }: LoupeBubbleProps) {\n  const style: CSSProperties = {\n    width: `${diameter}px`,\n    height: `${diameter}px`,\n    transform: `translate(${aim.x - diameter / 2}px, ${aim.y - diameter / 2}px)`,\n  };\n  return (\n    <div ref={hostRef} className=\"lk-loupe\" style={style} aria-hidden=\"true\">\n      {children}\n    </div>\n  );\n}\n","import { type RefObject, useEffect, useState } from 'react';\nimport type { ViewportSize } from '../canvas/worldSpec';\n\nconst ZERO: ViewportSize = { width: 0, height: 0 };\n\n/** An element's CSS-pixel box, kept current. `{0, 0}` until it is measured, and\n *  wherever `ResizeObserver` is absent. */\nexport function useHostSize(ref: RefObject<HTMLElement | null>): ViewportSize {\n  const [size, setSize] = useState<ViewportSize>(ZERO);\n\n  useEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    const update = (): void => {\n      const rect = el.getBoundingClientRect();\n      setSize((prev) =>\n        prev.width === rect.width && prev.height === rect.height\n          ? prev\n          : { width: rect.width, height: rect.height },\n      );\n    };\n    update();\n    if (typeof ResizeObserver === 'undefined') return;\n    const ro = new ResizeObserver(update);\n    ro.observe(el);\n    return () => ro.disconnect();\n  }, [ref]);\n\n  return size;\n}\n","import type { View } from '@weasel-js/core';\n\n/** A point on the magnified surface, in its own CSS pixels. */\nexport interface LoupePoint {\n  x: number;\n  y: number;\n}\n\n/** The lens' rectangle on that surface. */\nexport interface LoupeRect extends LoupePoint {\n  w: number;\n  h: number;\n}\n\n/**\n * The inner `View` a loupe renders its content through: the outer view's\n * magnification times `factor`, positioned so `target` sits at the center of\n * a viewport the size of `rect`.\n */\nexport function loupeInnerView(\n  target: LoupePoint,\n  outer: View,\n  rect: LoupeRect,\n  factor: number,\n): View {\n  const scale = { x: outer.scale.x * factor, y: outer.scale.y * factor };\n  return {\n    x: target.x - rect.w / 2 / scale.x,\n    y: target.y - rect.h / 2 / scale.y,\n    scale,\n  };\n}\n\n/**\n * Where on the outer surface a point inside the lens is looking, in\n * screen-space CSS px.\n *\n * The inverse of {@link loupeInnerView}: the lens centers `aim` in `rect` and\n * magnifies by `factor`, and the outer view's own scale cancels out of the\n * round trip — so this needs no `View`.\n */\nexport function loupeSourcePoint(\n  p: LoupePoint,\n  rect: LoupeRect,\n  aim: LoupePoint,\n  factor: number,\n): LoupePoint {\n  return {\n    x: aim.x + (p.x - (rect.x + rect.w / 2)) / factor,\n    y: aim.y + (p.y - (rect.y + rect.h / 2)) / factor,\n  };\n}\n","import { normalizeZoom } from '@weasel-js/core';\nimport { type LoupePoint, type LoupeRect, loupeSourcePoint } from './geometry';\n\n/** How a loupe magnifies. `'vector'` re-renders the source through a zoomed-in\n *  view, so content stays sharp at any factor; `'pixel'` blows up the actual\n *  pixels the surface presented. */\nexport type LoupeMode = 'vector' | 'pixel';\n\n/**\n * What a loupe needs from the surface it magnifies. A painter implements it,\n * and the model asks nothing about how the lens is drawn — only where it is,\n * what colour is under a point, and whether anyone can still see it.\n */\nexport interface LoupeSurface {\n  /** The lens' rectangle, or `null` while it has none. */\n  lens(): LoupeRect | null;\n  /**\n   * Does the lens itself cover this point? A stationary lens does over its own\n   * frame, which is what the freeze rule below is for; a lens that follows the\n   * pointer never covers it and answers `false`.\n   */\n  covers(p: LoupePoint): boolean;\n  /** Hex colour at a surface point, or `null` when the surface cannot say. */\n  sample(p: LoupePoint): string | null;\n  /** Is the lens off screen? Aims are ignored while it is. */\n  hidden(): boolean;\n  /** Is the lens gone for good? The model tears itself down when it is. */\n  gone(): boolean;\n  /** Something the painter must redraw for has changed. */\n  changed(): void;\n  /**\n   * Run `fn` after each frame the surface lands; returns an unsubscribe.\n   * Implement it when `sample` reads pixels that only show an aim once a\n   * frame has painted — a framebuffer read back. The model then samples the\n   * aim on the next landed frame, so `color` settles a frame after the aim.\n   * Omit it when `sample` can answer for a fresh aim right away.\n   */\n  subscribeFrame?(fn: () => void): () => void;\n}\n\n/** Options for {@link createLoupeModel}. */\nexport interface LoupeModelOptions {\n  surface: LoupeSurface;\n  mode?: LoupeMode;\n  /** Magnification. Default 8. Always positive and finite: a factor that is\n   *  not becomes `ZOOM_FLOOR`, the same rule a view's zoom follows. */\n  factor?: number;\n  /** Bounds `setFactor` clamps to. Unset means bounded only by that rule. */\n  minFactor?: number;\n  maxFactor?: number;\n  /** Called with the hex colour under the aim point whenever it changes. */\n  onColorChange?: (hex: string) => void;\n  /** Called when a pick lands — an eyedropper on the magnified surface. Where\n   *  the colour goes is the consumer's business. */\n  onPick?: (hex: string) => void;\n  /** Called when the model tears itself down because the surface reported the\n   *  lens gone, so the painter can drop what it was holding. */\n  onDispose?: () => void;\n}\n\n/** Where a loupe is aimed, how far it magnifies, and what colour it is over. */\nexport interface LoupeModel {\n  readonly mode: LoupeMode;\n  readonly factor: number;\n  /** Last aimed point, in the surface's CSS px. */\n  readonly aim: LoupePoint;\n  /** Hex colour under the aim point. `null` until something answers. */\n  readonly color: string | null;\n  setMode(mode: LoupeMode): void;\n  setFactor(factor: number): void;\n  /** Aim at a surface point. Ignored while the lens covers it, is hidden, or\n   *  the model is disposed. */\n  aimAt(p: LoupePoint): void;\n  /** Sample what the lens shows at `p`, a point inside it, and report that to\n   *  `onPick`. Omit `p` to pick at the aim point. Leaves the aim, and `color`,\n   *  alone. */\n  pick(p?: LoupePoint): string | null;\n  dispose(): void;\n}\n\n/**\n * Build the loupe's model over a surface. It holds the state a magnifier has —\n * aim, factor, mode, colour — and none of the drawing.\n */\nexport function createLoupeModel(opts: LoupeModelOptions): LoupeModel {\n  const { surface } = opts;\n  let mode: LoupeMode = opts.mode ?? 'vector';\n  let factor = normalizeZoom(opts.factor ?? 8);\n  let aim: LoupePoint = { x: 0, y: 0 };\n  let color: string | null = null;\n  let disposed = false;\n  let aimUnsampled = false;\n\n  const clamp = (n: number): number =>\n    normalizeZoom(Math.min(opts.maxFactor ?? Number.POSITIVE_INFINITY,\n                           Math.max(opts.minFactor ?? Number.NEGATIVE_INFINITY, n)));\n\n  const sampleColor = () => {\n    const hex = surface.sample(aim);\n    if (hex === null || hex === color) return;\n    color = hex;\n    opts.onColorChange?.(hex);\n  };\n\n  const unsubscribeFrame = surface.subscribeFrame?.(() => {\n    if (!aimUnsampled) return;\n    aimUnsampled = false;\n    sampleColor();\n  });\n\n  const teardown = () => {\n    if (disposed) return;\n    disposed = true;\n    unsubscribeFrame?.();\n    opts.onDispose?.();\n  };\n\n  return {\n    get mode() { return mode; },\n    get factor() { return factor; },\n    get aim() { return aim; },\n    get color() { return color; },\n\n    setMode(next) {\n      if (disposed || next === mode) return;\n      mode = next;\n      surface.changed();\n    },\n\n    setFactor(next) {\n      if (disposed) return;\n      factor = clamp(next);\n      surface.changed();\n    },\n\n    aimAt(p) {\n      if (disposed) return;\n      // A lens can be taken away by whatever owns it, without coming back\n      // through `dispose`. Follow it down rather than keep sampling for a\n      // magnifier nobody can see.\n      if (surface.gone()) { teardown(); return; }\n      if (surface.hidden()) return;\n      if (surface.covers(p)) return;\n      aim = p;\n      if (unsubscribeFrame) aimUnsampled = true;\n      else sampleColor();\n      surface.changed();\n    },\n\n    pick(p) {\n      if (disposed) return null;\n      let at = aim;\n      if (p) {\n        const rect = surface.lens();\n        if (!rect) return null;\n        at = loupeSourcePoint(p, rect, aim, factor);\n        // The lens is part of the picture the surface presents. A point near\n        // its frame maps back underneath it, and sampling there reports the\n        // lens' own chrome as artwork.\n        if (surface.covers(at)) return null;\n      }\n      const hex = surface.sample(at);\n      if (hex !== null) opts.onPick?.(hex);\n      return hex;\n    },\n\n    dispose: teardown,\n  };\n}\n","import {\n  createLoupeModel,\n  type LoupeMode,\n  type LoupeModel,\n  type LoupePoint,\n} from '@weasel-js/loupe';\nimport { type RefObject, useCallback, useEffect, useReducer, useRef } from 'react';\nimport type { ResolvedLoupe } from './types';\n\n/** Options for {@link useLoupe}. */\nexport interface UseLoupeOptions {\n  capability: ResolvedLoupe;\n  /** The element the lens tracks the pointer across. */\n  hostRef: RefObject<HTMLElement | null>;\n  /** Whether the loupe is turned on. Hold-to-peek shows it regardless. */\n  enabled: boolean;\n  /** Hex color at a host point. Omitted, the loupe reports no color — which\n   *  is the honest answer for a surface with no pixels to read. */\n  sample?: (p: LoupePoint) => string | null;\n}\n\n/** A loupe as a React view reads it. */\nexport interface LoupeState {\n  /** Whether the lens should be drawn. */\n  visible: boolean;\n  /** Where it is aimed, in the host's own pixels. */\n  aim: LoupePoint;\n  factor: number;\n  mode: LoupeMode;\n  color: string | null;\n  setMode: (mode: LoupeMode) => void;\n  setFactor: (factor: number) => void;\n  /** Sample what the lens shows at a point inside it. */\n  pick: (p?: LoupePoint) => string | null;\n}\n\n/** How fast the wheel walks the magnification. Gentler than the pan-zoom\n *  wheel: the lens' whole range is one order of magnitude. */\nconst WHEEL_RATE = 0.002;\n\n/**\n * Binds `@weasel-js/loupe`'s model to a host element and drives it from the\n * pointer, the peek key and the wheel.\n *\n * These are plain listeners rather than gesture bindings because labkit trials\n * do not route input through the dispatcher — see the loupe entry under\n * \"Selection, actions & UI panels\" in `docs/TODO.md`. They are all in this one\n * hook so that when trial input does go through it, this is the only file to\n * rewrite.\n */\nexport function useLoupe({ capability, hostRef, enabled, sample }: UseLoupeOptions): LoupeState {\n  const [, bump] = useReducer((n: number) => n + 1, 0);\n\n  const overRef = useRef(false);\n  const peekingRef = useRef(false);\n  const enabledRef = useRef(enabled);\n  enabledRef.current = enabled;\n  const sampleRef = useRef(sample);\n  sampleRef.current = sample;\n  const onColorChangeRef = useRef(capability.onColorChange);\n  onColorChangeRef.current = capability.onColorChange;\n\n  // Reads nothing but refs, so it is stable and an effect may depend on it.\n  const shown = useCallback(\n    (): boolean => overRef.current && (enabledRef.current || peekingRef.current),\n    [],\n  );\n\n  const modelRef = useRef<LoupeModel | null>(null);\n  if (modelRef.current === null) {\n    modelRef.current = createLoupeModel({\n      mode: capability.mode,\n      factor: capability.factor,\n      minFactor: capability.minFactor,\n      maxFactor: capability.maxFactor,\n      onColorChange: (hex) => onColorChangeRef.current?.(hex),\n      surface: {\n        lens: () => {\n          const d = diameterRef.current;\n          const { x, y } = modelRef.current?.aim ?? { x: 0, y: 0 };\n          return { x: x - d / 2, y: y - d / 2, w: d, h: d };\n        },\n        // The lens follows the pointer and is painted over the host rather than\n        // into it, so it is never part of the picture being magnified.\n        covers: () => false,\n        sample: (p) => sampleRef.current?.(p) ?? null,\n        hidden: () => !shown(),\n        gone: () => goneRef.current,\n        changed: bump,\n      },\n    });\n  }\n  const model = modelRef.current;\n\n  const diameterRef = useRef(capability.diameter);\n  diameterRef.current = capability.diameter;\n  const goneRef = useRef(false);\n\n  // The model holds no resources, and `dispose` is one-way — so unmounting only\n  // reports the lens gone. Disposing here instead leaves React's mount / unmount\n  // / remount in StrictMode with a permanently dead model that silently ignores\n  // every aim.\n  useEffect(() => {\n    goneRef.current = false;\n    return () => {\n      goneRef.current = true;\n    };\n  }, []);\n\n  // Turning the loupe off with the pointer still inside must put the lens away,\n  // and the model only reconsiders on an aim.\n  useEffect(() => {\n    if (!enabled && !peekingRef.current) bump();\n  }, [enabled]);\n\n  useEffect(() => {\n    const host = hostRef.current;\n    if (!host) return;\n\n    const onPointerMove = (e: PointerEvent): void => {\n      overRef.current = true;\n      const rect = host.getBoundingClientRect();\n      model.aimAt({ x: e.clientX - rect.left, y: e.clientY - rect.top });\n      if (!shown()) return;\n      bump();\n    };\n    const onPointerLeave = (): void => {\n      overRef.current = false;\n      bump();\n    };\n    const onWheel = (e: WheelEvent): void => {\n      if (!shown()) return;\n      // Ahead of the stack's own pan-zoom, which is a React handler on this same\n      // element: capture runs first, and stopping propagation keeps the event\n      // from reaching React's root listener at all.\n      e.preventDefault();\n      e.stopPropagation();\n      model.setFactor(model.factor * Math.exp(-e.deltaY * WHEEL_RATE));\n    };\n\n    host.addEventListener('pointermove', onPointerMove);\n    host.addEventListener('pointerleave', onPointerLeave);\n    host.addEventListener('wheel', onWheel, { capture: true, passive: false });\n    return () => {\n      host.removeEventListener('pointermove', onPointerMove);\n      host.removeEventListener('pointerleave', onPointerLeave);\n      host.removeEventListener('wheel', onWheel, { capture: true });\n    };\n  }, [hostRef, model, shown]);\n\n  const peekKey = capability.peekKey;\n  useEffect(() => {\n    if (peekKey == null) return;\n    const setPeeking = (next: boolean): void => {\n      if (peekingRef.current === next) return;\n      peekingRef.current = next;\n      bump();\n    };\n    const onKeyDown = (e: KeyboardEvent): void => {\n      if (e.key === peekKey) setPeeking(true);\n    };\n    const onKeyUp = (e: KeyboardEvent): void => {\n      if (e.key === peekKey) setPeeking(false);\n    };\n    // A key held while the window loses focus never sends its keyup, so the\n    // peek would stay on until the key was pressed and released again.\n    const onBlur = (): void => setPeeking(false);\n\n    window.addEventListener('keydown', onKeyDown);\n    window.addEventListener('keyup', onKeyUp);\n    window.addEventListener('blur', onBlur);\n    return () => {\n      window.removeEventListener('keydown', onKeyDown);\n      window.removeEventListener('keyup', onKeyUp);\n      window.removeEventListener('blur', onBlur);\n    };\n  }, [peekKey]);\n\n  return {\n    visible: shown(),\n    aim: model.aim,\n    factor: model.factor,\n    mode: model.mode,\n    color: model.color,\n    setMode: model.setMode,\n    setFactor: model.setFactor,\n    pick: model.pick,\n  };\n}\n","import { type RefObject, useContext, useMemo } from 'react';\nimport { CanvasStackContext } from '../canvas/CanvasStackContext';\nimport type { WorldSpec } from '../canvas/worldSpec';\nimport type { ViewTransform } from '../instrument/types';\nimport { CanvasLoupe } from './CanvasLoupe';\nimport { sampleStack } from './canvasLens';\nimport { DomLoupe } from './DomLoupe';\nimport { LoupeBubble } from './LoupeBubble';\nimport type { ResolvedLoupe } from './types';\nimport { useHostSize } from './useHostSize';\nimport { useLoupe } from './useLoupe';\n\n/** Props for `<TrialLoupe>`. */\nexport interface TrialLoupeProps {\n  capability: ResolvedLoupe;\n  /** Whether the trial's loupe is turned on. Hold-to-peek shows it anyway. */\n  enabled: boolean;\n  state: unknown;\n  config: unknown;\n  /** The trial's own camera. */\n  view: ViewTransform;\n  worldSpec?: WorldSpec;\n  /** The element the lens tracks. A loupe mounted inside a `<CanvasStack>`\n   *  takes the stack's own element instead, and this goes unused. */\n  hostRef?: RefObject<HTMLElement | null>;\n}\n\n/** Stable stand-in, so a loupe with nothing to track does not re-bind its\n *  listeners on every render. */\nconst NO_HOST: RefObject<HTMLElement | null> = { current: null };\n\n/**\n * A trial's loupe, painted by whichever painter suits its content: the canvas\n * stack it is mounted inside, or the instrument's own `render` at a magnified\n * camera.\n */\nexport function TrialLoupe({\n  capability,\n  enabled,\n  state,\n  config,\n  view,\n  worldSpec,\n  hostRef,\n}: TrialLoupeProps) {\n  const stack = useContext(CanvasStackContext);\n  const surface = capability.render ? undefined : stack?.surface;\n  const host = surface?.element ?? hostRef ?? NO_HOST;\n\n  const sample = useMemo(() => {\n    if (!surface) return undefined;\n    return (p: { x: number; y: number }): string | null => {\n      const canvases = surface.canvases.current;\n      return canvases ? sampleStack(surface.layers, canvases, p, surface.size.dpr) : null;\n    };\n  }, [surface]);\n\n  const loupe = useLoupe({ capability, hostRef: host, enabled, sample });\n  const measured = useHostSize(host);\n  const size = surface?.size ?? measured;\n\n  if (!loupe.visible) return null;\n\n  return (\n    <LoupeBubble aim={loupe.aim} diameter={capability.diameter}>\n      {capability.render ? (\n        <DomLoupe\n          aim={loupe.aim}\n          factor={loupe.factor}\n          mode={loupe.mode}\n          diameter={capability.diameter}\n          size={size}\n          view={view}\n          frame={stack?.frame}\n          state={state}\n          config={config}\n          render={capability.render}\n        />\n      ) : surface && stack ? (\n        <CanvasLoupe\n          aim={loupe.aim}\n          factor={loupe.factor}\n          mode={loupe.mode}\n          diameter={capability.diameter}\n          surface={surface}\n          view={stack.view}\n          frame={stack.frame}\n          worldSpec={worldSpec}\n        />\n      ) : null}\n    </LoupeBubble>\n  );\n}\n","import type { LoupeMode } from '@weasel-js/loupe';\nimport type { ReactNode } from 'react';\nimport type { ViewportSize } from '../canvas/worldSpec';\nimport type { ViewTransform } from '../instrument/types';\n\n/** What a DOM instrument's loupe `render` is handed: the same data its own\n *  `render` gets, and the camera to draw it through. */\nexport interface LoupeRenderArgs<TS = unknown, TC = unknown> {\n  state: TS;\n  config: TC;\n  /** The trial's own camera composed with the magnification, about the aimed\n   *  point — so drawing the same content through it magnifies in place. */\n  view: ViewTransform;\n  /** The magnification on its own, for whatever must not scale with the\n   *  camera. */\n  factor: number;\n  mode: LoupeMode;\n  /** The size of the viewport `view` is written for: the trial's content well,\n   *  not the lens. The lens shows a circle cut out of it. */\n  size: ViewportSize;\n}\n\n/**\n * Declares that an instrument can be magnified.\n *\n * With no `render`, the loupe re-draws the instrument's canvas layers through a\n * zoomed camera, so it stays sharp at any factor. An instrument whose content is\n * DOM supplies `render` instead: given a camera, draw me again.\n */\nexport interface LoupeCapability<TS = unknown, TC = unknown> {\n  render?: (args: LoupeRenderArgs<TS, TC>) => ReactNode;\n  /** Opening magnification, clamped to the bounds below. Default 6. */\n  factor?: number;\n  /** What the wheel clamps to. Defaults 2 and 32. */\n  minFactor?: number;\n  maxFactor?: number;\n  /** `'vector'` (default) re-renders the content magnified; `'pixel'` blows up\n   *  the pixels the instrument presented. A `render` loupe is always vector —\n   *  DOM has no framebuffer to enlarge. */\n  mode?: LoupeMode;\n  /** Lens diameter in CSS px. Default 200. */\n  diameter?: number;\n  /** Held for a momentary peek while the loupe is off. Default `'Alt'`; `null`\n   *  turns hold-to-peek off. Matched against `KeyboardEvent.key`. */\n  peekKey?: string | null;\n  /** Called with the color under the aim, wherever the surface can say. The\n   *  canvas painter reads it back; a DOM loupe has no pixels to sample. */\n  onColorChange?: (hex: string) => void;\n}\n\n/** An instrument's loupe declaration. `true` takes every default. */\nexport type LoupeDeclaration<TS = unknown, TC = unknown> = true | LoupeCapability<TS, TC>;\n\n/** A {@link LoupeCapability} with every default filled in. */\nexport interface ResolvedLoupe<TS = unknown, TC = unknown> {\n  render?: (args: LoupeRenderArgs<TS, TC>) => ReactNode;\n  onColorChange?: (hex: string) => void;\n  factor: number;\n  minFactor: number;\n  maxFactor: number;\n  mode: LoupeMode;\n  diameter: number;\n  peekKey: string | null;\n}\n\nexport const LOUPE_DEFAULTS = {\n  factor: 6,\n  minFactor: 2,\n  maxFactor: 32,\n  mode: 'vector',\n  diameter: 200,\n  peekKey: 'Alt',\n} as const satisfies Omit<ResolvedLoupe, 'render' | 'onColorChange'>;\n\nexport function resolveLoupe<TS, TC>(declared: LoupeDeclaration<TS, TC>): ResolvedLoupe<TS, TC> {\n  const cap = declared === true ? {} : declared;\n  const minFactor = cap.minFactor ?? LOUPE_DEFAULTS.minFactor;\n  const maxFactor = cap.maxFactor ?? LOUPE_DEFAULTS.maxFactor;\n  return {\n    render: cap.render,\n    onColorChange: cap.onColorChange,\n    minFactor,\n    maxFactor,\n    factor: Math.min(maxFactor, Math.max(minFactor, cap.factor ?? LOUPE_DEFAULTS.factor)),\n    diameter: cap.diameter ?? LOUPE_DEFAULTS.diameter,\n    peekKey: cap.peekKey === undefined ? LOUPE_DEFAULTS.peekKey : cap.peekKey,\n    // A DOM loupe has no framebuffer, so `pixel` would have nothing to enlarge.\n    mode: cap.render ? 'vector' : (cap.mode ?? LOUPE_DEFAULTS.mode),\n  };\n}\n"]}