@weasel-js/labkit 1.6.0 → 1.7.0

package/dist/chunk-ZIFPHIWZ.js

@@ -0,0 +1,302 @@
+import { useSurfaceOptional } from './chunk-WIG6XHJ7.js';
+import { CameraContext, pointerElsewhere, STAGE_VIEW_ID, normalize2DView, useCameraView, CameraScope, CameraInput } from './chunk-UNAZSLWE.js';
+import { resolveFrame, DEFAULT_FRAME } from './chunk-24W5VEJW.js';
+import { CanvasStackContext } from './chunk-CQLQPQ4P.js';
+import { useContext, useRef, useState, useEffect, useMemo } from 'react';
+import { usePointerPosition, crosshairRects, useVisibleRaf } from '@weasel-js/core';
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+var ARMS = ["left", "right", "up", "down"];
+function LinkedCursor() {
+  const camera = useContext(CameraContext);
+  const pointer = usePointerPosition();
+  if (!camera) return null;
+  const local = pointerElsewhere(pointer, STAGE_VIEW_ID, camera.frame);
+  if (!local) return null;
+  const v = camera.view.get();
+  const x = (local.x - v.x) * v.scale.x;
+  const y = (local.y * camera.frame.yDir - v.y) * v.scale.y;
+  const { halo, bars } = crosshairRects(x, y, 1);
+  const arms = ARMS.map((name, i) => ({ name, halo: halo[i], bar: bars[i] }));
+  return /* @__PURE__ */ jsxs("svg", { className: "lk-linked-cursor", "aria-hidden": "true", children: [
+    arms.map(
+      ({ name, halo: r }) => r ? /* @__PURE__ */ jsx(
+        "rect",
+        {
+          className: "lk-linked-cursor__halo",
+          x: r.x,
+          y: r.y,
+          width: r.w,
+          height: r.h
+        },
+        `halo-${name}`
+      ) : null
+    ),
+    arms.map(
+      ({ name, bar: r }) => r ? /* @__PURE__ */ jsx(
+        "rect",
+        {
+          className: "lk-linked-cursor__bar",
+          x: r.x,
+          y: r.y,
+          width: r.w,
+          height: r.h
+        },
+        `bar-${name}`
+      ) : null
+    )
+  ] });
+}
+function useLayerScheduler({
+  layers,
+  view,
+  frame = DEFAULT_FRAME,
+  canvasRefs,
+  size,
+  host
+}) {
+  const dirty = useRef(/* @__PURE__ */ new Set());
+  const lastRenderRef = useRef(/* @__PURE__ */ new Map());
+  useEffect(() => {
+    for (const layer of layers) {
+      const prev = lastRenderRef.current.get(layer.id);
+      if (prev !== layer.render) dirty.current.add(layer.id);
+      lastRenderRef.current.set(layer.id, layer.render);
+    }
+    for (const id of [...lastRenderRef.current.keys()]) {
+      if (!layers.find((l) => l.id === id)) lastRenderRef.current.delete(id);
+    }
+  }, [layers]);
+  useEffect(() => {
+    for (const layer of layers) dirty.current.add(layer.id);
+  }, [view, frame, size, layers]);
+  const frameLoop = useVisibleRaf(
+    () => {
+      if (dirty.current.size === 0) return;
+      const map = canvasRefs.current;
+      if (!map) {
+        dirty.current.clear();
+        return;
+      }
+      for (const layer of layers) {
+        if (!dirty.current.has(layer.id)) continue;
+        if (!layer.visible) continue;
+        const canvas = map.get(layer.id);
+        if (!canvas) continue;
+        const ctx = canvas.getContext("2d");
+        if (!ctx) continue;
+        ctx.save();
+        ctx.setTransform(size.dpr, 0, 0, size.dpr, 0, 0);
+        ctx.clearRect(0, 0, size.width, size.height);
+        layer.render(ctx, view, frame);
+        ctx.restore();
+      }
+      dirty.current.clear();
+    },
+    { target: host }
+  );
+  useEffect(() => {
+    if (dirty.current.size > 0) frameLoop.request();
+  });
+}
+function CanvasStack({
+  layers,
+  view: viewProp,
+  onViewChange,
+  worldSpec,
+  minZoom,
+  maxZoom,
+  width = "100%",
+  height = "100%",
+  className,
+  onResize,
+  onHitTest,
+  children,
+  yoke
+}) {
+  const view = normalize2DView(viewProp);
+  const containerRef = useRef(null);
+  const canvasMap = useRef(/* @__PURE__ */ new Map());
+  const [size, setSize] = useState({ width: 0, height: 0, dpr: 1 });
+  const setCanvasRef = (id, el) => {
+    if (el) canvasMap.current.set(id, el);
+    else canvasMap.current.delete(id);
+  };
+  useEffect(() => {
+    const el = containerRef.current;
+    if (!el) return;
+    const update = () => {
+      const rect = el.getBoundingClientRect();
+      const dpr = window.devicePixelRatio ?? 1;
+      setSize((prev) => {
+        if (prev.width === rect.width && prev.height === rect.height && prev.dpr === dpr) {
+          return prev;
+        }
+        return { width: rect.width, height: rect.height, dpr };
+      });
+    };
+    update();
+    if (typeof ResizeObserver === "undefined") return;
+    const ro = new ResizeObserver(update);
+    ro.observe(el);
+    return () => ro.disconnect();
+  }, []);
+  const onResizeRef = useRef(onResize);
+  onResizeRef.current = onResize;
+  useEffect(() => {
+    if (size.width === 0 && size.height === 0) return;
+    onResizeRef.current?.({ width: size.width, height: size.height });
+  }, [size.width, size.height]);
+  const frame = useMemo(() => resolveFrame(worldSpec, size), [worldSpec, size]);
+  const camera = useCameraView({
+    view: viewProp,
+    onViewChange,
+    frame,
+    hostRef: containerRef,
+    minZoom,
+    maxZoom
+  });
+  const cameraCtx = useMemo(
+    () => ({ view: camera, frame, element: () => containerRef.current }),
+    [camera, frame]
+  );
+  useLayerScheduler({ layers, view, frame, canvasRefs: canvasMap, size, host: containerRef });
+  const ctxValue = useMemo(
+    () => ({
+      view,
+      frame,
+      surface: { element: containerRef, size, canvases: canvasMap, layers }
+    }),
+    [view, frame, size, layers]
+  );
+  const containerStyle = { width, height };
+  const canvasPx = {
+    width: Math.max(0, Math.round(size.width * size.dpr)),
+    height: Math.max(0, Math.round(size.height * size.dpr))
+  };
+  const canvasCss = {
+    width: size.width,
+    height: size.height
+  };
+  return /* @__PURE__ */ jsx(CameraScope, { yoke, children: /* @__PURE__ */ jsx(CameraContext.Provider, { value: cameraCtx, children: /* @__PURE__ */ jsxs(CanvasStackContext.Provider, { value: ctxValue, children: [
+    /* @__PURE__ */ jsx(CameraInput, { hostRef: containerRef, camera, frame, onTap: onHitTest }),
+    /* @__PURE__ */ jsxs(
+      "div",
+      {
+        ref: containerRef,
+        className: className ? `lk-canvas-stack ${className}` : "lk-canvas-stack",
+        style: containerStyle,
+        children: [
+          layers.map((layer) => /* @__PURE__ */ jsx(
+            "canvas",
+            {
+              ref: (el) => setCanvasRef(layer.id, el),
+              className: "lk-canvas-stack__canvas",
+              width: canvasPx.width,
+              height: canvasPx.height,
+              style: { ...canvasCss, display: layer.visible ? "block" : "none" }
+            },
+            layer.id
+          )),
+          /* @__PURE__ */ jsx(LinkedCursor, {}),
+          /* @__PURE__ */ jsx("div", { className: "lk-canvas-stack__overlay", children })
+        ]
+      }
+    )
+  ] }) }) });
+}
+function fitStage(size, viewport) {
+  if (!(size.width > 0 && size.height > 0 && viewport.width > 0 && viewport.height > 0)) {
+    return { zoom: 1, pan: { x: 0, y: 0 } };
+  }
+  const zoom = Math.min(1, viewport.width / size.width, viewport.height / size.height);
+  return {
+    zoom,
+    pan: {
+      x: (viewport.width - size.width * zoom) / 2,
+      y: (viewport.height - size.height * zoom) / 2
+    }
+  };
+}
+function Stage({
+  size,
+  view: viewProp,
+  onViewChange,
+  minZoom,
+  maxZoom,
+  onResize,
+  hostRef,
+  overlay,
+  children,
+  yoke
+}) {
+  const view = normalize2DView(viewProp);
+  const host = useRef(null);
+  const surface = useSurfaceOptional();
+  const camera = useCameraView({
+    view: viewProp,
+    onViewChange,
+    frame: DEFAULT_FRAME,
+    hostRef: host,
+    minZoom,
+    maxZoom
+  });
+  const cameraCtx = useMemo(
+    () => ({
+      view: camera,
+      frame: DEFAULT_FRAME,
+      element: () => host.current,
+      content: { x: 0, y: 0, width: size.width, height: size.height }
+    }),
+    [camera, size.width, size.height]
+  );
+  const onResizeRef = useRef(onResize);
+  onResizeRef.current = onResize;
+  useEffect(() => {
+    const el = host.current;
+    if (!el) return;
+    const measure = () => {
+      const rect = el.getBoundingClientRect();
+      if (rect.width > 0 && rect.height > 0) {
+        onResizeRef.current?.({ width: rect.width, height: rect.height });
+      }
+    };
+    measure();
+    if (typeof ResizeObserver === "undefined") return;
+    const ro = new ResizeObserver(measure);
+    ro.observe(el);
+    return () => ro.disconnect();
+  }, []);
+  useEffect(() => {
+    surface?.invalidateRects();
+  }, [surface, view.zoom, view.pan.x, view.pan.y]);
+  const cameraVars = {
+    ["--lk-stage-x"]: `${view.pan.x}px`,
+    ["--lk-stage-y"]: `${view.pan.y}px`,
+    ["--lk-stage-zoom"]: String(view.zoom),
+    ["--lk-stage-w"]: `${size.width}px`,
+    ["--lk-stage-h"]: `${size.height}px`
+  };
+  return /* @__PURE__ */ jsx(CameraScope, { yoke, children: /* @__PURE__ */ jsxs(CameraContext.Provider, { value: cameraCtx, children: [
+    /* @__PURE__ */ jsx(CameraInput, { hostRef: host, camera, frame: DEFAULT_FRAME }),
+    /* @__PURE__ */ jsxs(
+      "div",
+      {
+        ref: (el) => {
+          host.current = el;
+          if (hostRef) hostRef.current = el;
+        },
+        className: "lk-stage",
+        children: [
+          /* @__PURE__ */ jsx("div", { className: "lk-stage__content", style: cameraVars, children }),
+          /* @__PURE__ */ jsx(LinkedCursor, {}),
+          overlay
+        ]
+      }
+    )
+  ] }) });
+}
+
+export { CanvasStack, LinkedCursor, Stage, fitStage };
+//# sourceMappingURL=chunk-ZIFPHIWZ.js.map
+//# sourceMappingURL=chunk-ZIFPHIWZ.js.map

package/dist/chunk-ZIFPHIWZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/canvas/LinkedCursor.tsx","../src/canvas/useLayerScheduler.ts","../src/canvas/CanvasStack.tsx","../src/canvas/Stage.tsx"],"names":["useRef","useEffect","jsx","jsxs","useMemo"],"mappings":"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","file":"chunk-ZIFPHIWZ.js","sourcesContent":["import { crosshairRects, usePointerPosition } from '@weasel-js/core';\nimport { useContext } from 'react';\nimport { CameraContext, pointerElsewhere, STAGE_VIEW_ID } from './CameraInput';\n\n/** `crosshairRects` returns its four arms in this order. */\nconst ARMS = ['left', 'right', 'up', 'down'] as const;\n\n/**\n * The other side of a linked cursor: a crosshair on the camera's own element\n * wherever the shared pointer is over some other view — an overview, say. The\n * same crosshair core paints on a weasel canvas.\n */\nexport function LinkedCursor() {\n  const camera = useContext(CameraContext);\n  const pointer = usePointerPosition();\n  if (!camera) return null;\n  const local = pointerElsewhere(pointer, STAGE_VIEW_ID, camera.frame);\n  if (!local) return null;\n  // `pointerElsewhere` hands back the instrument's world; the camera works\n  // frame-local, and the map is its own inverse.\n  const v = camera.view.get();\n  const x = (local.x - v.x) * v.scale.x;\n  const y = (local.y * camera.frame.yDir - v.y) * v.scale.y;\n  const { halo, bars } = crosshairRects(x, y, 1);\n  const arms = ARMS.map((name, i) => ({ name, halo: halo[i], bar: bars[i] }));\n  return (\n    <svg className=\"lk-linked-cursor\" aria-hidden=\"true\">\n      {arms.map(({ name, halo: r }) =>\n        r ? (\n          <rect\n            key={`halo-${name}`}\n            className=\"lk-linked-cursor__halo\"\n            x={r.x}\n            y={r.y}\n            width={r.w}\n            height={r.h}\n          />\n        ) : null,\n      )}\n      {arms.map(({ name, bar: r }) =>\n        r ? (\n          <rect\n            key={`bar-${name}`}\n            className=\"lk-linked-cursor__bar\"\n            x={r.x}\n            y={r.y}\n            width={r.w}\n            height={r.h}\n          />\n        ) : null,\n      )}\n    </svg>\n  );\n}\n","import { useVisibleRaf } from '@weasel-js/core';\nimport { type RefObject, useEffect, useRef } from 'react';\nimport type { ViewTransform } from '../instrument/types';\nimport { DEFAULT_FRAME, type WorldFrame } from './worldSpec';\n\n/** One layer of a canvas stack: its id, whether it is currently shown, and how\n *  it paints itself. */\nexport interface CanvasLayerDescriptor {\n  id: string;\n  visible: boolean;\n  render: (ctx: CanvasRenderingContext2D, view: ViewTransform, frame: WorldFrame) => void;\n}\n\ninterface SchedulerOptions {\n  layers: CanvasLayerDescriptor[];\n  view: ViewTransform;\n  /** The instrument's coordinate system, resolved against `size`. */\n  frame?: WorldFrame;\n  canvasRefs: RefObject<Map<string, HTMLCanvasElement>>;\n  size: { width: number; height: number; dpr: number };\n  /** The element the stack occupies. Given one, the scheduler also stops while\n   *  the stack sits outside the viewport. */\n  host?: RefObject<Element | null>;\n}\n\nexport function useLayerScheduler({\n  layers,\n  view,\n  frame = DEFAULT_FRAME,\n  canvasRefs,\n  size,\n  host,\n}: SchedulerOptions): void {\n  const dirty = useRef<Set<string>>(new Set());\n  const lastRenderRef = useRef<Map<string, CanvasLayerDescriptor['render']>>(new Map());\n\n  useEffect(() => {\n    for (const layer of layers) {\n      const prev = lastRenderRef.current.get(layer.id);\n      if (prev !== layer.render) dirty.current.add(layer.id);\n      lastRenderRef.current.set(layer.id, layer.render);\n    }\n    for (const id of [...lastRenderRef.current.keys()]) {\n      if (!layers.find((l) => l.id === id)) lastRenderRef.current.delete(id);\n    }\n  }, [layers]);\n\n  // biome-ignore lint/correctness/useExhaustiveDependencies: re-mark dirty when view or size changes\n  useEffect(() => {\n    for (const layer of layers) dirty.current.add(layer.id);\n  }, [view, frame, size, layers]);\n\n  // Painting only what is dirty is not the same as doing nothing: a hidden tab\n  // still commits React updates, and the effect above marks every layer dirty\n  // on any view or size change. The gate is what actually stops the work.\n  const frameLoop = useVisibleRaf(\n    () => {\n      if (dirty.current.size === 0) return;\n      const map = canvasRefs.current;\n      if (!map) {\n        dirty.current.clear();\n        return;\n      }\n      for (const layer of layers) {\n        if (!dirty.current.has(layer.id)) continue;\n        if (!layer.visible) continue;\n        const canvas = map.get(layer.id);\n        if (!canvas) continue;\n        const ctx = canvas.getContext('2d');\n        if (!ctx) continue;\n        ctx.save();\n        ctx.setTransform(size.dpr, 0, 0, size.dpr, 0, 0);\n        ctx.clearRect(0, 0, size.width, size.height);\n        layer.render(ctx, view, frame);\n        ctx.restore();\n      }\n      dirty.current.clear();\n    },\n    { target: host },\n  );\n\n  useEffect(() => {\n    if (dirty.current.size > 0) frameLoop.request();\n  });\n}\n","import type { Yoke } from '@weasel-js/core';\nimport { type CSSProperties, type ReactNode, useEffect, useMemo, useRef, useState } from 'react';\nimport type { Point, ViewTransform } from '../instrument/types';\nimport { normalize2DView } from '../state/view';\nimport { CameraContext, CameraInput, CameraScope, useCameraView } from './CameraInput';\nimport { CanvasStackContext } from './CanvasStackContext';\nimport { LinkedCursor } from './LinkedCursor';\nimport { type CanvasLayerDescriptor, useLayerScheduler } from './useLayerScheduler';\nimport { resolveFrame, type ViewportSize, type WorldSpec } from './worldSpec';\n\n/** Props for `<CanvasStack>`. */\nexport interface CanvasStackProps {\n  layers: CanvasLayerDescriptor[];\n  view: ViewTransform;\n  onViewChange: (v: ViewTransform) => void;\n  /** The instrument's coordinate system. Omitted, world (0,0) sits at the\n   *  element's top-left with y running down. */\n  worldSpec?: WorldSpec;\n  minZoom?: number;\n  maxZoom?: number;\n  width?: number | string;\n  height?: number | string;\n  className?: string;\n  /** Fired whenever the stack is measured, so a consumer can place a view that\n   *  only makes sense in terms of the viewport. */\n  onResize?: (size: ViewportSize) => void;\n  onHitTest?: (worldPos: Point) => void;\n  children?: ReactNode;\n  /** A yoke to join, from `useYoke()`: cameras on one yoke share their tool\n   *  and gesture in flight. Omitted, this one keeps its own. */\n  yoke?: Yoke;\n}\n\n/** Stacks one `<canvas>` per layer and drives them from a shared view, so a\n *  layer that changes rarely is not redrawn with one that changes every frame.\n *  Handles sizing and device pixel ratio; pan and zoom route through weasel's\n *  gesture dispatcher (`<CameraInput>`). */\nexport function CanvasStack({\n  layers,\n  view: viewProp,\n  onViewChange,\n  worldSpec,\n  minZoom,\n  maxZoom,\n  width = '100%',\n  height = '100%',\n  className,\n  onResize,\n  onHitTest,\n  children,\n  yoke,\n}: CanvasStackProps) {\n  const view = normalize2DView(viewProp);\n  const containerRef = useRef<HTMLDivElement | null>(null);\n  const canvasMap = useRef<Map<string, HTMLCanvasElement>>(new Map());\n  const [size, setSize] = useState({ width: 0, height: 0, dpr: 1 });\n\n  const setCanvasRef = (id: string, el: HTMLCanvasElement | null): void => {\n    if (el) canvasMap.current.set(id, el);\n    else canvasMap.current.delete(id);\n  };\n\n  useEffect(() => {\n    const el = containerRef.current;\n    if (!el) return;\n    const update = () => {\n      const rect = el.getBoundingClientRect();\n      const dpr = window.devicePixelRatio ?? 1;\n      setSize((prev) => {\n        if (prev.width === rect.width && prev.height === rect.height && prev.dpr === dpr) {\n          return prev;\n        }\n        return { width: rect.width, height: rect.height, dpr };\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  }, []);\n\n  const onResizeRef = useRef(onResize);\n  onResizeRef.current = onResize;\n  useEffect(() => {\n    if (size.width === 0 && size.height === 0) return;\n    onResizeRef.current?.({ width: size.width, height: size.height });\n  }, [size.width, size.height]);\n\n  const frame = useMemo(() => resolveFrame(worldSpec, size), [worldSpec, size]);\n\n  const camera = useCameraView({\n    view: viewProp,\n    onViewChange,\n    frame,\n    hostRef: containerRef,\n    minZoom,\n    maxZoom,\n  });\n  const cameraCtx = useMemo(\n    () => ({ view: camera, frame, element: () => containerRef.current }),\n    [camera, frame],\n  );\n  useLayerScheduler({ layers, view, frame, canvasRefs: canvasMap, size, host: containerRef });\n\n  const ctxValue = useMemo(\n    () => ({\n      view,\n      frame,\n      surface: { element: containerRef, size, canvases: canvasMap, layers },\n    }),\n    [view, frame, size, layers],\n  );\n\n  const containerStyle: CSSProperties = { width, height };\n  const canvasPx = {\n    width: Math.max(0, Math.round(size.width * size.dpr)),\n    height: Math.max(0, Math.round(size.height * size.dpr)),\n  };\n  const canvasCss: CSSProperties = {\n    width: size.width,\n    height: size.height,\n  };\n\n  return (\n    <CameraScope yoke={yoke}>\n      <CameraContext.Provider value={cameraCtx}>\n        <CanvasStackContext.Provider value={ctxValue}>\n          <CameraInput hostRef={containerRef} camera={camera} frame={frame} onTap={onHitTest} />\n          <div\n            ref={containerRef}\n            className={className ? `lk-canvas-stack ${className}` : 'lk-canvas-stack'}\n            style={containerStyle}\n          >\n            {layers.map((layer) => (\n              <canvas\n                key={layer.id}\n                ref={(el) => setCanvasRef(layer.id, el)}\n                className=\"lk-canvas-stack__canvas\"\n                width={canvasPx.width}\n                height={canvasPx.height}\n                style={{ ...canvasCss, display: layer.visible ? 'block' : 'none' }}\n              />\n            ))}\n            <LinkedCursor />\n            <div className=\"lk-canvas-stack__overlay\">{children}</div>\n          </div>\n        </CanvasStackContext.Provider>\n      </CameraContext.Provider>\n    </CameraScope>\n  );\n}\n","import type { Yoke } from '@weasel-js/core';\nimport { type CSSProperties, type ReactNode, useEffect, useMemo, useRef } from 'react';\nimport type { ViewTransform } from '../instrument/types';\nimport { normalize2DView } from '../state/view';\nimport { useSurfaceOptional } from '../surface/useSurfaceTile';\nimport { CameraContext, CameraInput, CameraScope, useCameraView } from './CameraInput';\nimport { LinkedCursor } from './LinkedCursor';\nimport { DEFAULT_FRAME, type ViewportSize } from './worldSpec';\n\n/** Props for `<Stage>`. */\nexport interface StageProps {\n  /** The content's own size in CSS pixels, at zoom 1. */\n  size: ViewportSize;\n  view: ViewTransform;\n  onViewChange: (v: ViewTransform) => void;\n  minZoom?: number;\n  maxZoom?: number;\n  /** Fired whenever the stage's viewport is measured at a non-zero size. */\n  onResize?: (viewport: ViewportSize) => void;\n  /** Handed the viewport element, for a consumer tracking the pointer over it. */\n  hostRef?: { current: HTMLDivElement | null };\n  /** Drawn over the content in viewport pixels, outside the camera. */\n  overlay?: ReactNode;\n  children?: ReactNode;\n  /** A yoke to join, from `useYoke()`: cameras on one yoke share their tool\n   *  and gesture in flight. Omitted, this one keeps its own. */\n  yoke?: Yoke;\n}\n\n/**\n * The camera a stage opens at: the content centered in its viewport, shrunk to\n * fit if it has to be and never enlarged past its own size.\n */\nexport function fitStage(size: ViewportSize, viewport: ViewportSize): ViewTransform {\n  if (!(size.width > 0 && size.height > 0 && viewport.width > 0 && viewport.height > 0)) {\n    return { zoom: 1, pan: { x: 0, y: 0 } };\n  }\n  const zoom = Math.min(1, viewport.width / size.width, viewport.height / size.height);\n  return {\n    zoom,\n    pan: {\n      x: (viewport.width - size.width * zoom) / 2,\n      y: (viewport.height - size.height * zoom) / 2,\n    },\n  };\n}\n\n/**\n * DOM content of a fixed size, panned and zoomed by a camera — what\n * `<CanvasStack>` is for layers drawn to a canvas. Pan and zoom route through\n * weasel's gesture dispatcher (`<CameraInput>`). The content is laid out at\n * its own size and transformed, so everything inside keeps its layout and a\n * measurement of any element in it reports where it is actually drawn.\n */\nexport function Stage({\n  size,\n  view: viewProp,\n  onViewChange,\n  minZoom,\n  maxZoom,\n  onResize,\n  hostRef,\n  overlay,\n  children,\n  yoke,\n}: StageProps) {\n  const view = normalize2DView(viewProp);\n  const host = useRef<HTMLDivElement | null>(null);\n  const surface = useSurfaceOptional();\n  const camera = useCameraView({\n    view: viewProp,\n    onViewChange,\n    frame: DEFAULT_FRAME,\n    hostRef: host,\n    minZoom,\n    maxZoom,\n  });\n  const cameraCtx = useMemo(\n    () => ({\n      view: camera,\n      frame: DEFAULT_FRAME,\n      element: () => host.current,\n      content: { x: 0, y: 0, width: size.width, height: size.height },\n    }),\n    [camera, size.width, size.height],\n  );\n\n  const onResizeRef = useRef(onResize);\n  onResizeRef.current = onResize;\n  useEffect(() => {\n    const el = host.current;\n    if (!el) return;\n    const measure = () => {\n      const rect = el.getBoundingClientRect();\n      if (rect.width > 0 && rect.height > 0) {\n        onResizeRef.current?.({ width: rect.width, height: rect.height });\n      }\n    };\n    measure();\n    if (typeof ResizeObserver === 'undefined') return;\n    const ro = new ResizeObserver(measure);\n    ro.observe(el);\n    return () => ro.disconnect();\n  }, []);\n\n  // A transform moves every tile inside the content without resizing anything,\n  // and a ResizeObserver reports only resizes.\n  // biome-ignore lint/correctness/useExhaustiveDependencies: the camera is the trigger, not an input — the effect re-measures whenever it moves.\n  useEffect(() => {\n    surface?.invalidateRects();\n  }, [surface, view.zoom, view.pan.x, view.pan.y]);\n\n  // The camera changes every frame of a pan, and a transform has nowhere to\n  // live but the element's own style: set as custom properties the stylesheet\n  // reads.\n  const cameraVars = {\n    ['--lk-stage-x' as string]: `${view.pan.x}px`,\n    ['--lk-stage-y' as string]: `${view.pan.y}px`,\n    ['--lk-stage-zoom' as string]: String(view.zoom),\n    ['--lk-stage-w' as string]: `${size.width}px`,\n    ['--lk-stage-h' as string]: `${size.height}px`,\n  } as CSSProperties;\n\n  return (\n    <CameraScope yoke={yoke}>\n      <CameraContext.Provider value={cameraCtx}>\n        <CameraInput hostRef={host} camera={camera} frame={DEFAULT_FRAME} />\n        <div\n          ref={(el) => {\n            host.current = el;\n            if (hostRef) hostRef.current = el;\n          }}\n          className=\"lk-stage\"\n        >\n          <div className=\"lk-stage__content\" style={cameraVars}>\n            {children}\n          </div>\n          <LinkedCursor />\n          {overlay}\n        </div>\n      </CameraContext.Provider>\n    </CameraScope>\n  );\n}\n"]}

package/dist/config/index.d.ts

@@ -1,11 +1,12 @@
-import { a2 as Auto, O as Instrument } from '../_dts/frac-DTRq7Xpb.js';
-export { ax as auto, aD as isAuto } from '../_dts/frac-DTRq7Xpb.js';
-import { R as ResolvedConfig, l as ConfigNode, A as Annotations, N as NodeOptions, v as SectionOption, C as ControlRenderer, n as ConfigOption, p as ConfigShape, h as ConfigBranch, B as BranchAnnotations, e as BranchOptions, c as ConfigSchema, I as InferConfig, i as ConfigEntry, b as ConfigField, d as ConfigRule, L as LeafPatch, o as ConfigRuleContext } from '../_dts/types-B7y8hX1D.js';
-export { m as ConfigOf, a as ConfigPath, E as EntryValue, q as NodeValue, S as SectionSpec, V as ValueAtPath } from '../_dts/types-B7y8hX1D.js';
-import { ToolPrefNumberFormat, ToolPrefNumberUnit, ToolPrefLeaf, ToolPrefGroup } from '@weasel-js/core';
-import { I as InDialogOptions } from '../_dts/inDialog-D5ZKGjiD.js';
+import { a5 as Auto } from '../_dts/types-CSm9jgol.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';
+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';
 import 'react';
-import '../_dts/PrefsRow.d-DFpPIeIC.js';
 import '@weasel-js/theme';
 import '../_dts/types-DJ79Tg5J.js';
 
@@ -80,9 +81,9 @@ declare class NumberNode extends BaseNode<number> {
     /** A display suffix for the value — `'px'`, `'ms'`, `'°'`. Presentation only:
      *  it is never parsed, and the stored value stays a plain number. */
     suffix(suffix: string): this;
-    /** Show the value in a named format — `'compact'` reads `2.00M`. Presentation
-     *  only: the stored value stays a plain number, and a typed `2.5m` reads back. */
-    format(format: ToolPrefNumberFormat): this;
+    /** Show, speak and read the value through a display — `compact()` reads
+     *  `2.00M`. Presentation only: the stored value stays a plain number. */
+    display(display: Display): this;
     /**
      * Store the value in one unit and edit it in another — radians stored,
      * degrees typed. `min`, `max` and `step` are declared in the stored unit
@@ -157,6 +158,9 @@ declare class GroupNode<S extends ConfigShape> implements ConfigBranch<S> {
     /** Show this group only while the predicate holds. Presentational — every
      *  value beneath it stays in config and the instrument still reads it. */
     showIf(predicate: (config: Record<string, unknown>) => boolean): GroupNode<S>;
+    /** Put a button on the group's heading that returns every value beneath it
+     *  to its default, leaving the rest of the config alone. */
+    resettable(): GroupNode<S>;
 }
 /**
  * Builds an instrument's config: the values, their types, and how each is
@@ -202,37 +206,12 @@ declare const f: {
  *
  * Rules do not run here: a hand-written `ConfigField` already states its label
  * and control, which is everything the rule chain would have inferred.
- */
-declare function fromConfigFields(fields: readonly ConfigField[]): ResolvedConfig;
-
-/**
- * A resolved schema rearranged so its sections are groups.
- *
- * `PrefsForm`'s rail navigates the schema tree — top-level groups are its
- * items, their group children indent under them. A resolved schema keeps its
- * sections beside the tree instead, so a flat schema's rail comes out as one
- * unnamed item however many headings the panel draws. This puts the sections
- * where the rail looks for them.
- */
-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;
-    /** `config` renested to mirror `group` — the value tree `PrefsForm` takes. */
-    values: Record<string, unknown>;
-    /** The config path a path within `group` stands for. */
-    pathAt: (railPath: string) => string;
-}
-/**
- * Turn a resolved schema's root sections into the top level of a `PrefGroup`,
- * for `PrefsForm`'s rail layout.
  *
- * A section naming a group brings that group in whole, so it lands as an
- * indented rail item; a section naming a leaf drops it loose into the
- * section's own pane. Sections nested under a group are left alone — they
- * bucket rows inside a pane, which is the panel's job and not the rail's.
+ * A dotted `key` is a config path, as it is to every read and write, so its
+ * leaf is filed under headless groups at that path rather than as one child
+ * whose name contains dots — which no path lookup would find.
  */
-declare function sectionTree(resolved: ResolvedConfig, config: Record<string, unknown>, showHidden?: boolean): SectionTree;
+declare function fromConfigFields(fields: readonly ConfigField[]): ResolvedConfig;
 
 /** The value at a dotted path. `undefined` when a segment is missing or the
  *  walk hits something that is not a record. */
@@ -285,6 +264,35 @@ declare const builtinRules: readonly ConfigRule[];
  */
 declare function applyRules(seed: LeafPatch, ctx: Omit<ConfigRuleContext, 'leaf'>, rules: readonly ConfigRule[]): LeafPatch;
 
+/**
+ * A resolved schema rearranged so its sections are groups.
+ *
+ * `PrefsForm`'s rail navigates the schema tree — top-level groups are its
+ * items, their group children indent under them. A resolved schema keeps its
+ * sections beside the tree instead, so a flat schema's rail comes out as one
+ * unnamed item however many headings the panel draws. This puts the sections
+ * where the rail looks for them.
+ */
+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;
+    /** `config` renested to mirror `group` — the value tree `PrefsForm` takes. */
+    values: Record<string, unknown>;
+    /** The config path a path within `group` stands for. */
+    pathAt: (railPath: string) => string;
+}
+/**
+ * Turn a resolved schema's root sections into the top level of a `PrefGroup`,
+ * for `PrefsForm`'s rail layout.
+ *
+ * A section naming a group brings that group in whole, so it lands as an
+ * indented rail item; a section naming a leaf drops it loose into the
+ * section's own pane. Sections nested under a group are left alone — they
+ * bucket rows inside a pane, which is the panel's job and not the rail's.
+ */
+declare function sectionTree(resolved: ResolvedConfig, config: Record<string, unknown>, showHidden?: boolean): SectionTree;
+
 /**
  * An instrument's controls, resolved against the surrounding lab's rules.
  *
@@ -314,5 +322,5 @@ declare function useResolvedConfig<TC>(schema: ResolvedConfig | undefined, confi
  */
 declare function isLeafVisible(resolved: ResolvedConfig, path: string, config: Record<string, unknown>, showHidden?: boolean): boolean;
 
-export { Annotations, Auto, BaseNode, BooleanNode, BranchAnnotations, BranchOptions, ColorNode, ConfigBranch, ConfigEntry, ConfigNode, ConfigOption, ConfigRule, ConfigRuleContext, ConfigSchema, ConfigShape, ControlRenderer, CustomNode, EnumNode, GroupNode, InferConfig, LeafPatch, ListNode, NodeOptions, NumberNode, ResolvedConfig, StringNode, ValueNode, applyRules, autoPathsOf, builtinRules, f, fillConfigDefaults, fromConfigFields, hasConfigPath, isConfigBranch, isLeafVisible, resolveAutoConfig, resolveConfigSchema, schemaNodeAtPath, sectionTree, titleCase, useConfigSchema, useResolvedConfig, valueAtPath, withValueAtPath };
+export { Annotations, Auto, BaseNode, BooleanNode, BranchAnnotations, BranchOptions, ColorNode, ConfigBranch, ConfigEntry, ConfigNode, ConfigOption, ConfigRule, ConfigRuleContext, ConfigSchema, ConfigShape, ControlRenderer, CustomNode, EnumNode, GroupNode, InDialogOptions, InferConfig, LeafPatch, ListNode, NodeOptions, NumberNode, ResolvedConfig, SectionOption, StringNode, ValueNode, applyRules, autoPathsOf, builtinRules, f, fillConfigDefaults, fromConfigFields, hasConfigPath, isConfigBranch, isLeafVisible, resolveAutoConfig, resolveConfigSchema, schemaNodeAtPath, sectionTree, titleCase, useConfigSchema, useResolvedConfig, valueAtPath, withValueAtPath };
 export type { SectionTree };

package/dist/config/index.js

@@ -1,8 +1,7 @@
-export { sectionTree, useConfigSchema } from '../chunk-USO6TERP.js';
+export { sectionTree, useConfigSchema } from '../chunk-GOZLNM4L.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-BVL7Y574.js';
-export { fromConfigFields, isLeafVisible } from '../chunk-VQ47KWD5.js';
-export { auto, autoPathsOf, fillConfigDefaults, hasConfigPath, isAuto, resolveAutoConfig, schemaNodeAtPath, valueAtPath, withValueAtPath } from '../chunk-AWH3SRPW.js';
-import '../chunk-WUJXJC5O.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';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/controls/index.d.ts

@@ -1,9 +1,93 @@
-export { C as ControlPanel } from '../_dts/index-DINmCuLA.js';
-export { I as InDialogOptions, i as inDialog, s as summarizeValue } from '../_dts/inDialog-D5ZKGjiD.js';
-export { f as CheckboxField, g as ColorField, b as ConfigField, k as ConfigFieldType, r as NumberField, s as SelectField, t as SelectOption, u as SliderField, T as TextField } from '../_dts/types-B7y8hX1D.js';
-import 'react/jsx-runtime';
-import 'react';
-import '../_dts/PrefsRow.d-DFpPIeIC.js';
+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 { 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';
-import '../_dts/number.d-OeQYQoUO.js';
+
+/** How a panel packs its rows into the two-column property grid.
+ *   - `'auto'`: narrow controls (numbers, checkboxes, dropdowns, colors) sit
+ *     two per row; the ones that need the width — text, sliders, segmented
+ *     toggles — span it.
+ *   - `'pairs'`: every row pairs. A control that needs the full width says so
+ *     itself, with `<PropertyRow span>`.
+ *   - `'one-up'`: one control per row, colors excepted.
+ */
+type ControlPack = 'auto' | 'pairs' | 'one-up';
+interface ControlPanelProps<TC extends Record<string, unknown>> extends StanceProps {
+    /** The instrument's resolved config schema. */
+    schema?: ResolvedConfig;
+    /** @deprecated Pass `schema`. A field list is adapted into one internally. */
+    fields?: ConfigField[];
+    config: TC;
+    /** Writes one value. The path is dotted for a leaf inside an `f.group`, and
+     *  the bare key for one at the root. */
+    setConfig: (path: string, value: unknown) => void;
+    /**
+     * Control overrides and app-defined kinds, PrefsForm-style. Keys are config
+     * paths (checked first) or leaf kinds. A renderer returning `null` collapses
+     * the row; entries override the built-in rows on collision.
+     */
+    renderers?: Record<string, ControlRenderer>;
+    /** How rows pack into the two-column grid. Defaults to `'pairs'`. */
+    pack?: ControlPack;
+    /**
+     * Where a row's label sits relative to its control. Unset takes each row's
+     * own orientation — `block` (label above, which is what leaves a paired row
+     * room for its value) for most, `inline` for colors and checkboxes.
+     */
+    layout?: PropertyRowLayout;
+    /** Room the rows get. Passed straight to the property list. */
+    density?: PropertyDensity;
+    /** Cross-axis alignment of an inline row's label and control. */
+    align?: PropertyAlign;
+    /**
+     * Fold each section away behind a twisty, starting `'open'` or `'closed'`.
+     * Unset draws the heading alone, as the panel always has — unless a section
+     * in the schema declares how it opens, which makes that section foldable on
+     * its own and outranks this for that one section.
+     */
+    collapse?: 'open' | 'closed';
+    /**
+     * Which sections are folded, keyed as `onCollapse` reports them. Given, the
+     * panel keeps no state of its own: every toggle arrives at `onCollapse`
+     * instead, which is where a lab that remembers a trial's sections writes
+     * them.
+     */
+    collapsed?: Readonly<Record<string, boolean>>;
+    /** A fold moved. The key is a section's label — prefixed by its group's
+     *  dotted path when the section sits inside one — or a group's own path. */
+    onCollapse?: (key: string, collapsed: boolean) => void;
+    /** Dotted paths currently unpinned. A row in this set hides its control and
+     *  reads out `auto`, and clicking its label writes the sentinel back through
+     *  `setConfig`. Omitted, the panel keeps the set itself: the labels still
+     *  toggle and the sentinel never reaches `setConfig`, which would otherwise
+     *  store it as the row's value. */
+    auto?: ReadonlySet<string>;
+    /** Draw leaves marked `hidden`. */
+    showHidden?: boolean;
+    /** Heads the panel. With `title`, `stance` or `tone` given, the rows sit in a
+     *  `<PropertyPanel>` carrying them; with none, they are the bare list. */
+    title?: ReactNode;
+    className?: string;
+}
+/** Render an instrument's config schema as a stack of controls, each writing
+ *  back through `setConfig`. Built on the property rows, so a lab's controls
+ *  are the same aligned, themed rows the rest of the kit uses. */
+declare function ControlPanel<TC extends Record<string, unknown>>({ schema, fields, config, setConfig, renderers, pack, layout, density, align, collapse, collapsed, onCollapse, auto: given, showHidden, title, stance, tone, className, }: ControlPanelProps<TC>): react.JSX.Element;
+
+/** The one-line summary a dialog row shows when it is given none. */
+declare function summarizeValue(value: unknown): string;
+/**
+ * Moves a control into a modal: the row becomes a button showing a summary of
+ * the value, and the button opens a dialog whose body is `body`, handed the
+ * same context a row renderer gets. For a leaf whose editor will never fit a
+ * sidebar row.
+ */
+declare function inDialog(body: ControlRenderer, opts?: InDialogOptions): ControlRenderer;
+
+export { ConfigField, ControlPanel, InDialogOptions, inDialog, summarizeValue };

package/dist/controls/index.js

@@ -1,6 +1,7 @@
-export { ControlPanel } from '../chunk-HFRE4QQV.js';
-import '../chunk-VQ47KWD5.js';
-export { inDialog, summarizeValue } from '../chunk-AWH3SRPW.js';
-import '../chunk-WUJXJC5O.js';
+export { ControlPanel, inDialog, summarizeValue } from '../chunk-T5IBSPAM.js';
+import '../chunk-KMJ7RWD3.js';
+import '../chunk-Y23G2VZL.js';
+import '../chunk-MIM5R4ZT.js';
+import '../chunk-275JRRVD.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/dragdrop/index.d.ts

@@ -1,10 +1,12 @@
-import { P as PaletteItem, n as Point, o as DragFeedback, q as DragDropCapability, m as ViewTransform, b as WorldSpec } from '../_dts/frac-DTRq7Xpb.js';
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import { n as PaletteItem, o as DragFeedback, q as DragDropCapability } from '../_dts/types-CSm9jgol.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 '../_dts/PrefsRow.d-DFpPIeIC.js';
-import '@weasel-js/theme';
 import '@weasel-js/core';
-import '../_dts/types-B7y8hX1D.js';
+import '../_dts/PrefsRow.d-TOZ7BgD9.js';
+import '@weasel-js/theme';
+import '../_dts/types-CRPSGFAp.js';
 import '../_dts/types-DJ79Tg5J.js';
 
 interface DragState {
@@ -32,7 +34,7 @@ declare function useDragDrop<TS, TC>({ capability, canvasContainerRef, view, sta
 interface DragOverlayProps {
     drag: DragState | null;
 }
-declare function DragOverlay({ drag }: DragOverlayProps): react_jsx_runtime.JSX.Element | null;
+declare function DragOverlay({ drag }: DragOverlayProps): react.JSX.Element | null;
 
 interface DragGhostProps {
     item: PaletteItem;
@@ -45,7 +47,7 @@ interface PaletteProps {
     onDragStart: (item: PaletteItem, e: PointerEvent) => void;
     className?: string;
 }
-declare function Palette({ items, onDragStart, className }: PaletteProps): react_jsx_runtime.JSX.Element;
+declare function Palette({ items, onDragStart, className }: PaletteProps): react.JSX.Element;
 
 export { DragDropCapability, DragFeedback, DragGhost, DragOverlay, Palette, PaletteItem, useDragDrop };
 export type { DragGhostProps, DragOverlayProps, DragState, PaletteProps, UseDragDropArgs, UseDragDropResult };