@weasel-js/labkit 1.6.0 → 1.6.1

package/dist/chunk-DWMSB4CA.js

@@ -0,0 +1,228 @@
+import { DEFAULT_FRAME } from './chunk-24W5VEJW.js';
+import { createContext, useContext, useRef, useMemo, useEffect } from 'react';
+import { normalizeZoom, usePointerContext, DepRegistryProvider, ActionsProvider, ActiveToolContextProvider, PointerContextProvider, useActionsRegistry, useDepSource, makeViewportZoomAction, viewportDragPanAction, useGestureDispatcher } from '@weasel-js/core';
+import { jsx, Fragment } from 'react/jsx-runtime';
+
+var CameraWheelContext = createContext(null);
+var DEFAULT_VIEW = { zoom: 1, pan: { x: 0, y: 0 } };
+function as2DView(view) {
+  if (typeof view !== "object" || view === null) return null;
+  const v = view;
+  if (typeof v.zoom !== "number") return null;
+  if (typeof v.pan !== "object" || v.pan === null) return null;
+  if (typeof v.pan.x !== "number" || typeof v.pan.y !== "number") return null;
+  return normalize2DView({ zoom: v.zoom, pan: { x: v.pan.x, y: v.pan.y } });
+}
+function normalize2DView(view) {
+  const zoom = normalizeZoom(view.zoom);
+  const x = Number.isFinite(view.pan.x) ? view.pan.x : 0;
+  const y = Number.isFinite(view.pan.y) ? view.pan.y : 0;
+  if (zoom === view.zoom && x === view.pan.x && y === view.pan.y) return view;
+  return { zoom, pan: { x, y } };
+}
+function withZoom(view, zoom) {
+  return normalize2DView({ zoom, pan: view.pan });
+}
+
+// src/canvas/cameraView.ts
+function toCameraView(view, frame = DEFAULT_FRAME) {
+  const v = normalize2DView(view);
+  return {
+    x: -(frame.originPx.x + v.pan.x) / v.zoom,
+    y: -(frame.originPx.y + v.pan.y) / v.zoom,
+    scale: { x: v.zoom, y: v.zoom }
+  };
+}
+function fromCameraView(view, frame = DEFAULT_FRAME) {
+  const zoom = view.scale.x;
+  return {
+    zoom,
+    pan: { x: -view.x * zoom - frame.originPx.x, y: -view.y * zoom - frame.originPx.y }
+  };
+}
+function frameLocalToWorld(p, frame = DEFAULT_FRAME) {
+  return { x: p.x, y: p.y * frame.yDir };
+}
+function clampZoomAbout(prev, next, min, max) {
+  const s0 = prev.scale.x;
+  const s1 = next.scale.x;
+  const clamped = Math.min(max, Math.max(min, s1));
+  if (clamped === s1) return next;
+  if (s0 === s1) return { ...next, scale: { x: clamped, y: clamped } };
+  const inv = 1 / s0 - 1 / s1;
+  const px = (next.x - prev.x) / inv;
+  const py = (next.y - prev.y) / inv;
+  return {
+    x: prev.x + px / s0 - px / clamped,
+    y: prev.y + py / s0 - py / clamped,
+    scale: { x: clamped, y: clamped }
+  };
+}
+var STAGE_VIEW_ID = "stage";
+var CameraContext = createContext(null);
+var CameraScopeContext = createContext(false);
+function CameraScope({ children }) {
+  const inScope = useContext(CameraScopeContext);
+  const pointer = usePointerContext();
+  if (inScope) return /* @__PURE__ */ jsx(Fragment, { children });
+  const scoped = /* @__PURE__ */ jsx(CameraScopeContext.Provider, { value: true, children });
+  return /* @__PURE__ */ jsx(DepRegistryProvider, { children: /* @__PURE__ */ jsx(ActionsProvider, { children: /* @__PURE__ */ jsx(ActiveToolContextProvider, { children: pointer ? scoped : /* @__PURE__ */ jsx(PointerContextProvider, { children: scoped }) }) }) });
+}
+function isPositiveFinite(n) {
+  return Number.isFinite(n) && n > 0;
+}
+function useCameraView({
+  view,
+  onViewChange,
+  frame,
+  hostRef,
+  minZoom = 0.1,
+  maxZoom = 32
+}) {
+  const live = useRef({ view: normalize2DView(view), onViewChange, frame });
+  live.current = { view: normalize2DView(view), onViewChange, frame };
+  const initialZoom = useRef(isPositiveFinite(view.zoom) ? view.zoom : null);
+  const bounds = useRef({ min: minZoom, max: maxZoom });
+  const opening = initialZoom.current;
+  bounds.current = {
+    min: opening == null ? minZoom : Math.min(minZoom, opening),
+    max: opening == null ? maxZoom : Math.max(maxZoom, opening)
+  };
+  return useMemo(() => {
+    const get = () => toCameraView(live.current.view, live.current.frame);
+    return {
+      get,
+      set: (next) => {
+        const { min, max } = bounds.current;
+        const clamped = clampZoomAbout(get(), next, min, max);
+        const vt = fromCameraView(clamped, live.current.frame);
+        live.current.view = vt;
+        live.current.onViewChange(vt);
+      },
+      hostSize: () => {
+        const r = hostRef.current?.getBoundingClientRect();
+        return r ? { width: r.width, height: r.height } : null;
+      }
+    };
+  }, [hostRef]);
+}
+var TAP_ID = "camera.tap";
+var NO_TOOLS = /* @__PURE__ */ new Map();
+var CHANNELS = { contextMenu: false, ingest: false };
+function CameraInput(props) {
+  const registry = useActionsRegistry();
+  if (!registry) return null;
+  return /* @__PURE__ */ jsx(CameraDispatch, { ...props, registry });
+}
+function CameraDispatch({
+  hostRef,
+  camera,
+  frame,
+  onTap,
+  registry
+}) {
+  const frameRef = useRef(frame);
+  frameRef.current = frame;
+  const onTapRef = useRef(onTap);
+  onTapRef.current = onTap;
+  useDepSource("view", () => camera);
+  useDepSource("rootView", () => camera);
+  const actions = useMemo(() => {
+    const zoom = makeViewportZoomAction({
+      wheel: "plain",
+      min: 1e-9,
+      max: Number.POSITIVE_INFINITY
+    });
+    const wheelOnly = zoom.defaultBinding.filter(
+      (b) => b.spec.kind === "wheel" || b.spec.kind === "pinch"
+    );
+    const tap = {
+      id: TAP_ID,
+      label: "Tap the canvas",
+      defaultBinding: { kind: "click" },
+      invoker: {
+        timing: "immediate",
+        run: (_deps, params) => {
+          const p = params;
+          if (p?.worldX === void 0 || p.worldY === void 0) return;
+          onTapRef.current?.(frameLocalToWorld({ x: p.worldX, y: p.worldY }, frameRef.current));
+        }
+      }
+    };
+    return [
+      viewportDragPanAction,
+      { ...zoom, defaultBinding: wheelOnly },
+      tap
+    ];
+  }, []);
+  useEffect(() => {
+    const offs = actions.map((a) => registry.register(a));
+    return () => {
+      for (const off of offs) off();
+    };
+  }, [registry, actions]);
+  const clientToWorld = useMemo(
+    () => (cx, cy) => {
+      const r = hostRef.current?.getBoundingClientRect();
+      const v = camera.get();
+      return {
+        x: (cx - (r?.left ?? 0)) / v.scale.x + v.x,
+        y: (cy - (r?.top ?? 0)) / v.scale.y + v.y
+      };
+    },
+    [hostRef, camera]
+  );
+  useGestureDispatcher({
+    canvasRef: hostRef,
+    actions: registry,
+    toolsById: NO_TOOLS,
+    clientToWorld,
+    channels: CHANNELS
+  });
+  usePublishPointer(hostRef, clientToWorld, frame, STAGE_VIEW_ID);
+  const wheelSlot = useContext(CameraWheelContext);
+  useEffect(() => {
+    if (!wheelSlot) return;
+    const forward = (e) => {
+      hostRef.current?.dispatchEvent(new WheelEvent("wheel", e));
+    };
+    wheelSlot.current = forward;
+    return () => {
+      if (wheelSlot.current === forward) wheelSlot.current = null;
+    };
+  }, [wheelSlot, hostRef]);
+  return null;
+}
+function usePublishPointer(hostRef, clientToLocal, frame, viewId) {
+  const store = usePointerContext();
+  const frameRef = useRef(frame);
+  frameRef.current = frame;
+  const toLocal = useRef(clientToLocal);
+  toLocal.current = clientToLocal;
+  useEffect(() => {
+    const el = hostRef.current;
+    if (!el || !store) return;
+    const onMove = (e) => {
+      const w = frameLocalToWorld(toLocal.current(e.clientX, e.clientY), frameRef.current);
+      store.set({ worldX: w.x, worldY: w.y, viewId });
+    };
+    const onLeave = (e) => {
+      if (e.buttons !== 0) return;
+      if (store.get()?.viewId === viewId) store.set(null);
+    };
+    el.addEventListener("pointermove", onMove);
+    el.addEventListener("pointerleave", onLeave);
+    return () => {
+      el.removeEventListener("pointermove", onMove);
+      el.removeEventListener("pointerleave", onLeave);
+    };
+  }, [hostRef, store, viewId]);
+}
+function pointerElsewhere(p, viewId, frame) {
+  if (!p || p.viewId === viewId) return null;
+  return frameLocalToWorld({ x: p.worldX, y: p.worldY }, frame);
+}
+
+export { CameraContext, CameraInput, CameraScope, CameraScopeContext, CameraWheelContext, DEFAULT_VIEW, STAGE_VIEW_ID, as2DView, clampZoomAbout, frameLocalToWorld, fromCameraView, normalize2DView, pointerElsewhere, toCameraView, useCameraView, usePublishPointer, withZoom };
+//# sourceMappingURL=chunk-DWMSB4CA.js.map
+//# sourceMappingURL=chunk-DWMSB4CA.js.map

package/dist/chunk-DWMSB4CA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/canvas/CameraWheelContext.ts","../src/state/view.ts","../src/canvas/cameraView.ts","../src/canvas/CameraInput.tsx"],"names":["createContext"],"mappings":"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","file":"chunk-DWMSB4CA.js","sourcesContent":["import { createContext } from 'react';\n\n/** Where a trial's camera takes a wheel event from outside its own element. */\nexport type CameraWheelSlot = { current: ((e: WheelEvent) => void) | null };\n\n/**\n * The trial's camera, for input that lands outside it. An annotation target's\n * input box is portalled into the surface container, so a wheel over a mark\n * never bubbles through the stage or canvas stack it sits on; the box hands\n * the event here instead.\n */\nexport const CameraWheelContext = createContext<CameraWheelSlot | null>(null);\n","import { normalizeZoom } from '@weasel-js/core';\nimport type { ViewTransform } from '../instrument/types';\n\n/** The 2D view labkit has always shipped, and what a trial gets when it names no\n *  other. Re-exported under its own name so a consumer can say which it means. */\nexport type ViewTransform2D = ViewTransform;\n\nexport const DEFAULT_VIEW: ViewTransform2D = { zoom: 1, pan: { x: 0, y: 0 } };\n\n/** A trial's view is opaque to labkit, so anything that needs the 2D shape — the\n *  zoom chrome, `CanvasStack` — asks for it and handles not getting it. */\nexport function as2DView(view: unknown): ViewTransform2D | null {\n  if (typeof view !== 'object' || view === null) return null;\n  const v = view as Partial<ViewTransform2D>;\n  if (typeof v.zoom !== 'number') return null;\n  if (typeof v.pan !== 'object' || v.pan === null) return null;\n  if (typeof v.pan.x !== 'number' || typeof v.pan.y !== 'number') return null;\n  return normalize2DView({ zoom: v.zoom, pan: { x: v.pan.x, y: v.pan.y } });\n}\n\n/** `view` inside the invariant every view holds: a zoom that is not a finite\n *  number of at least `ZOOM_FLOOR` becomes the floor, and a non-finite pan\n *  becomes 0. Returns `view` itself when it already holds. */\nexport function normalize2DView(view: ViewTransform2D): ViewTransform2D {\n  const zoom = normalizeZoom(view.zoom);\n  const x = Number.isFinite(view.pan.x) ? view.pan.x : 0;\n  const y = Number.isFinite(view.pan.y) ? view.pan.y : 0;\n  if (zoom === view.zoom && x === view.pan.x && y === view.pan.y) return view;\n  return { zoom, pan: { x, y } };\n}\n\n/** `view` at a new zoom, through the same rule. */\nexport function withZoom(view: ViewTransform2D, zoom: number): ViewTransform2D {\n  return normalize2DView({ zoom, pan: view.pan });\n}\n","/**\n * labkit's camera as a weasel `View`, so core's viewport actions drive it.\n *\n * labkit places a world point on screen at\n * `originPx + pan + zoom * (x, yDir * y)`. A weasel `View` places one at\n * `(p - (x, y)) * scale`. Over *frame-local* coordinates — the world with `y`\n * multiplied by `yDir` — the two are the same affine map, which is all a pan\n * or a zoom about a screen point needs.\n */\nimport type { View } from '@weasel-js/core';\nimport type { Point, ViewTransform } from '../instrument/types';\nimport { normalize2DView } from '../state/view';\nimport { DEFAULT_FRAME, type WorldFrame } from './worldSpec';\n\n/** The weasel `View` equal to `view` under `frame`. */\nexport function toCameraView(view: ViewTransform, frame: WorldFrame = DEFAULT_FRAME): View {\n  const v = normalize2DView(view);\n  return {\n    x: -(frame.originPx.x + v.pan.x) / v.zoom,\n    y: -(frame.originPx.y + v.pan.y) / v.zoom,\n    scale: { x: v.zoom, y: v.zoom },\n  };\n}\n\n/** The labkit camera equal to weasel `view` under `frame`. */\nexport function fromCameraView(view: View, frame: WorldFrame = DEFAULT_FRAME): ViewTransform {\n  const zoom = view.scale.x;\n  return {\n    zoom,\n    pan: { x: -view.x * zoom - frame.originPx.x, y: -view.y * zoom - frame.originPx.y },\n  };\n}\n\n/** A frame-local point in the instrument's world, and back — the map is its\n *  own inverse. */\nexport function frameLocalToWorld(p: Point, frame: WorldFrame = DEFAULT_FRAME): Point {\n  return { x: p.x, y: p.y * frame.yDir };\n}\n\n/**\n * `next` with its zoom held to [`min`, `max`], about the screen point the step\n * from `prev` was anchored on, so a zoom that hits a bound stays anchored where\n * the pointer is. A pan (equal scales) passes through.\n */\nexport function clampZoomAbout(prev: View, next: View, min: number, max: number): View {\n  const s0 = prev.scale.x;\n  const s1 = next.scale.x;\n  const clamped = Math.min(max, Math.max(min, s1));\n  if (clamped === s1) return next;\n  if (s0 === s1) return { ...next, scale: { x: clamped, y: clamped } };\n  // The screen point both views agree on: p / s0 + x0 = p / s1 + x1.\n  const inv = 1 / s0 - 1 / s1;\n  const px = (next.x - prev.x) / inv;\n  const py = (next.y - prev.y) / inv;\n  // The same point under the clamped scale.\n  return {\n    x: prev.x + px / s0 - px / clamped,\n    y: prev.y + py / s0 - py / clamped,\n    scale: { x: clamped, y: clamped },\n  };\n}\n","/**\n * A labkit camera driven by weasel's dispatcher: drag pans, the wheel zooms\n * about the pointer, a tap reports the world point, and the pointer is\n * published into the store in scope. What `usePanZoom` used to hand-roll.\n */\nimport {\n  type Action,\n  ActionsProvider,\n  type ActionsRegistry,\n  ActiveToolContextProvider,\n  DepRegistryProvider,\n  makeViewportZoomAction,\n  PointerContextProvider,\n  type PointerWorldPos,\n  type Tool,\n  useActionsRegistry,\n  useDepSource,\n  useGestureDispatcher,\n  usePointerContext,\n  type View,\n  type ViewApi,\n  viewportDragPanAction,\n} from '@weasel-js/core';\nimport {\n  createContext,\n  type ReactNode,\n  type RefObject,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n} from 'react';\nimport type { Point, ViewTransform } from '../instrument/types';\nimport { normalize2DView } from '../state/view';\nimport { CameraWheelContext } from './CameraWheelContext';\nimport { clampZoomAbout, frameLocalToWorld, fromCameraView, toCameraView } from './cameraView';\nimport type { ViewportSize, WorldFrame } from './worldSpec';\n\n/** The view id the stage publishes its pointer under. */\nexport const STAGE_VIEW_ID = 'stage';\n\n/**\n * A camera, as the things that sit beside it read it: an overview, a loupe, a\n * linked cursor. Points are *frame-local* — the world with `y` multiplied by\n * `frame.yDir` — which is the space `view` works in.\n */\nexport interface CameraContextValue {\n  /** The camera as a weasel `ViewApi`, clamped to its zoom range. */\n  view: ViewApi;\n  frame: WorldFrame;\n  /** The element the camera's dispatcher listens on. */\n  element: () => HTMLElement | null;\n  /** The content's own rect, frame-local, when it has one — a `<Stage>`'s. */\n  content?: { x: number; y: number; width: number; height: number };\n}\n\n/** The camera around the caller, or `null` outside one. */\nexport const CameraContext = createContext<CameraContextValue | null>(null);\n\n/** Set by a host that already provides one input scope for everything inside\n *  it — a trial — so the camera, the loupe and an overview share it. */\nexport const CameraScopeContext = createContext(false);\n\n/**\n * The actions and deps a camera routes through: the ones a trial provides, or\n * an isolated set of its own. Isolated, because an actions registry holds one\n * dispatcher, and a camera must not take input from a canvas beside it. The\n * pointer store is the exception — one already in scope is kept, since sharing\n * it is the point.\n */\nexport function CameraScope({ children }: { children: ReactNode }) {\n  const inScope = useContext(CameraScopeContext);\n  const pointer = usePointerContext();\n  if (inScope) return <>{children}</>;\n  const scoped = <CameraScopeContext.Provider value={true}>{children}</CameraScopeContext.Provider>;\n  return (\n    <DepRegistryProvider>\n      <ActionsProvider>\n        <ActiveToolContextProvider>\n          {pointer ? scoped : <PointerContextProvider>{scoped}</PointerContextProvider>}\n        </ActiveToolContextProvider>\n      </ActionsProvider>\n    </DepRegistryProvider>\n  );\n}\n\n/** Options for {@link useCameraView}. */\nexport interface CameraViewOptions {\n  view: ViewTransform;\n  onViewChange: (v: ViewTransform) => void;\n  frame: WorldFrame;\n  hostRef: RefObject<HTMLElement | null>;\n  minZoom?: number;\n  maxZoom?: number;\n}\n\nfunction isPositiveFinite(n: number): boolean {\n  return Number.isFinite(n) && n > 0;\n}\n\n/**\n * A labkit camera as a stable `ViewApi`. Its zoom range is widened to keep the\n * opening zoom reachable — captured once, so a zoom-out cannot shrink the\n * range and strand the opening view behind it.\n */\nexport function useCameraView({\n  view,\n  onViewChange,\n  frame,\n  hostRef,\n  minZoom = 0.1,\n  maxZoom = 32,\n}: CameraViewOptions): ViewApi {\n  const live = useRef({ view: normalize2DView(view), onViewChange, frame });\n  live.current = { view: normalize2DView(view), onViewChange, frame };\n  const initialZoom = useRef(isPositiveFinite(view.zoom) ? view.zoom : null);\n  const bounds = useRef({ min: minZoom, max: maxZoom });\n  const opening = initialZoom.current;\n  bounds.current = {\n    min: opening == null ? minZoom : Math.min(minZoom, opening),\n    max: opening == null ? maxZoom : Math.max(maxZoom, opening),\n  };\n\n  return useMemo<ViewApi>(() => {\n    const get = (): View => toCameraView(live.current.view, live.current.frame);\n    return {\n      get,\n      set: (next: View) => {\n        const { min, max } = bounds.current;\n        const clamped = clampZoomAbout(get(), next, min, max);\n        const vt = fromCameraView(clamped, live.current.frame);\n        // Written ahead of the render, so a second event inside one commit\n        // steps from this one.\n        live.current.view = vt;\n        live.current.onViewChange(vt);\n      },\n      hostSize: () => {\n        const r = hostRef.current?.getBoundingClientRect();\n        return r ? { width: r.width, height: r.height } : null;\n      },\n    };\n  }, [hostRef]);\n}\n\nconst TAP_ID = 'camera.tap';\nconst NO_TOOLS: ReadonlyMap<string, Tool> = new Map();\nconst CHANNELS = { contextMenu: false, ingest: false } as const;\n\n/** Props for `<CameraInput>`. */\nexport interface CameraInputProps {\n  hostRef: RefObject<HTMLElement | null>;\n  camera: ViewApi;\n  frame: WorldFrame;\n  /** A primary-button press released without crossing the drag threshold, at\n   *  the world point it landed on. */\n  onTap?: (world: Point) => void;\n}\n\n/**\n * Mounts the dispatcher on `hostRef` and routes the camera's gestures through\n * it. Render it inside a `<CameraScope>`; with no actions registry in scope it\n * renders nothing.\n */\nexport function CameraInput(props: CameraInputProps) {\n  const registry = useActionsRegistry();\n  if (!registry) return null;\n  return <CameraDispatch {...props} registry={registry} />;\n}\n\nfunction CameraDispatch({\n  hostRef,\n  camera,\n  frame,\n  onTap,\n  registry,\n}: CameraInputProps & { registry: ActionsRegistry }) {\n  const frameRef = useRef(frame);\n  frameRef.current = frame;\n  const onTapRef = useRef(onTap);\n  onTapRef.current = onTap;\n\n  useDepSource('view', () => camera);\n  useDepSource('rootView', () => camera);\n\n  const actions = useMemo<Action[]>(() => {\n    // Unclamped here: `camera.set` clamps, to a range widened around the\n    // opening zoom, and anchors the clamp where the wheel was.\n    const zoom = makeViewportZoomAction({\n      wheel: 'plain',\n      min: 1e-9,\n      max: Number.POSITIVE_INFINITY,\n    });\n    // The wheel and the trackpad's two pinch forms only: the zoom keys listen\n    // on the window, and every trial on a page would take them at once.\n    const wheelOnly = (zoom.defaultBinding as { spec: { kind: string } }[]).filter(\n      (b) => b.spec.kind === 'wheel' || b.spec.kind === 'pinch',\n    );\n    const tap: Action = {\n      id: TAP_ID,\n      label: 'Tap the canvas',\n      defaultBinding: { kind: 'click' },\n      invoker: {\n        timing: 'immediate',\n        run: (_deps, params) => {\n          const p = params as { worldX?: number; worldY?: number } | undefined;\n          if (p?.worldX === undefined || p.worldY === undefined) return;\n          onTapRef.current?.(frameLocalToWorld({ x: p.worldX, y: p.worldY }, frameRef.current));\n        },\n      },\n    };\n    return [\n      viewportDragPanAction,\n      { ...zoom, defaultBinding: wheelOnly as Action['defaultBinding'] },\n      tap,\n    ];\n  }, []);\n\n  useEffect(() => {\n    const offs = actions.map((a) => registry.register(a));\n    return () => {\n      for (const off of offs) off();\n    };\n  }, [registry, actions]);\n\n  const clientToWorld = useMemo(\n    () => (cx: number, cy: number) => {\n      const r = hostRef.current?.getBoundingClientRect();\n      const v = camera.get();\n      return {\n        x: (cx - (r?.left ?? 0)) / v.scale.x + v.x,\n        y: (cy - (r?.top ?? 0)) / v.scale.y + v.y,\n      };\n    },\n    [hostRef, camera],\n  );\n\n  useGestureDispatcher({\n    canvasRef: hostRef,\n    actions: registry,\n    toolsById: NO_TOOLS,\n    clientToWorld,\n    channels: CHANNELS,\n  });\n\n  usePublishPointer(hostRef, clientToWorld, frame, STAGE_VIEW_ID);\n\n  // Input that lands outside the camera's element — an annotation target's\n  // box, portalled into the surface — reaches the dispatcher through here.\n  const wheelSlot = useContext(CameraWheelContext);\n  useEffect(() => {\n    if (!wheelSlot) return;\n    const forward = (e: WheelEvent): void => {\n      hostRef.current?.dispatchEvent(new WheelEvent('wheel', e));\n    };\n    wheelSlot.current = forward;\n    return () => {\n      if (wheelSlot.current === forward) wheelSlot.current = null;\n    };\n  }, [wheelSlot, hostRef]);\n\n  return null;\n}\n\n/**\n * Publish the pointer over `hostRef` into the store in scope, in the\n * instrument's world, as `viewId`; clear it when the pointer leaves with no\n * button held.\n */\nexport function usePublishPointer(\n  hostRef: RefObject<HTMLElement | null>,\n  clientToLocal: (cx: number, cy: number) => Point,\n  frame: WorldFrame,\n  viewId: string,\n): void {\n  const store = usePointerContext();\n  const frameRef = useRef(frame);\n  frameRef.current = frame;\n  const toLocal = useRef(clientToLocal);\n  toLocal.current = clientToLocal;\n  useEffect(() => {\n    const el = hostRef.current;\n    if (!el || !store) return;\n    const onMove = (e: PointerEvent): void => {\n      const w = frameLocalToWorld(toLocal.current(e.clientX, e.clientY), frameRef.current);\n      store.set({ worldX: w.x, worldY: w.y, viewId });\n    };\n    const onLeave = (e: PointerEvent): void => {\n      if (e.buttons !== 0) return;\n      if (store.get()?.viewId === viewId) store.set(null);\n    };\n    el.addEventListener('pointermove', onMove);\n    el.addEventListener('pointerleave', onLeave);\n    return () => {\n      el.removeEventListener('pointermove', onMove);\n      el.removeEventListener('pointerleave', onLeave);\n    };\n  }, [hostRef, store, viewId]);\n}\n\n/** The pointer as a frame-local point, or `null` when there is none or it is\n *  over `viewId` itself. */\nexport function pointerElsewhere(\n  p: PointerWorldPos,\n  viewId: string,\n  frame: WorldFrame,\n): Point | null {\n  if (!p || p.viewId === viewId) return null;\n  return frameLocalToWorld({ x: p.worldX, y: p.worldY }, frame);\n}\n\nexport type { ViewportSize };\n"]}

package/dist/{chunk-USO6TERP.js → chunk-GHGO52SO.js}

@@ -1,11 +1,13 @@
 import { LabContext } from './chunk-Z76KEZAX.js';
-import { resolveConfigSchema } from './chunk-BVL7Y574.js';
-import { isLeafVisible, fromConfigFields } from './chunk-VQ47KWD5.js';
-import { valueAtPath } from './chunk-AWH3SRPW.js';
-import { s4 } from './chunk-WUJXJC5O.js';
+import { resolveConfigSchema } from './chunk-O6FFFOHS.js';
+import { isLeafVisible, fromConfigFields } from './chunk-IRTGUQ5O.js';
+import { valueAtPath } from './chunk-TJ77A4A3.js';
 import { useContext, useMemo } from 'react';
 
 // src/config/sectionTree.ts
+function isLeaf(node) {
+  return "kind" in node;
+}
 function slugOf(label, taken) {
   const base = label.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "section";
   if (!taken.has(base)) return base;
@@ -16,7 +18,7 @@ function prune(resolved, group, at, config, showHidden) {
   for (const [key, child] of Object.entries(group.children)) {
     const path = at === "" ? key : `${at}.${key}`;
     if (!isLeafVisible(resolved, path, config, showHidden)) continue;
-    if (s4(child)) {
+    if (isLeaf(child)) {
       children[key] = child;
       continue;
     }
@@ -38,7 +40,7 @@ function sectionTree(resolved, config, showHidden = false) {
       claimed.add(path);
       const child = resolved.group.children[path];
       if (!child || !isLeafVisible(resolved, path, config, showHidden)) continue;
-      if (s4(child)) {
+      if (isLeaf(child)) {
         kept[path] = child;
       } else {
         const subtree = prune(resolved, child, path, config, showHidden);
@@ -55,7 +57,7 @@ function sectionTree(resolved, config, showHidden = false) {
   }
   for (const [key, child] of Object.entries(resolved.group.children)) {
     if (claimed.has(key) || !isLeafVisible(resolved, key, config, showHidden)) continue;
-    if (s4(child)) {
+    if (isLeaf(child)) {
       children[key] = child;
     } else {
       const subtree = prune(resolved, child, key, config, showHidden);
@@ -86,5 +88,5 @@ function useConfigSchema(instrument) {
 }
 
 export { sectionTree, useConfigSchema };
-//# sourceMappingURL=chunk-USO6TERP.js.map
-//# sourceMappingURL=chunk-USO6TERP.js.map
+//# sourceMappingURL=chunk-GHGO52SO.js.map
+//# sourceMappingURL=chunk-GHGO52SO.js.map

package/dist/chunk-GHGO52SO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/sectionTree.ts","../src/config/useConfigSchema.ts"],"names":[],"mappings":"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","file":"chunk-GHGO52SO.js","sourcesContent":["import type { PrefGroup, PrefLeaf } from '@weasel-js/ui';\nimport { valueAtPath } from './path';\nimport type { ResolvedConfig } from './types';\nimport { isLeafVisible } from './visible';\n\n/**\n * A resolved schema rearranged so its sections are groups.\n *\n * `PrefsForm`'s rail navigates the schema tree — top-level groups are its\n * items, their group children indent under them. A resolved schema keeps its\n * sections beside the tree instead, so a flat schema's rail comes out as one\n * unnamed item however many headings the panel draws. This puts the sections\n * where the rail looks for them.\n */\nexport interface SectionTree {\n  /** The rail's schema. Top-level children are the schema's root sections,\n   *  followed by any root node no section claimed. */\n  group: PrefGroup;\n  /** `config` renested to mirror `group` — the value tree `PrefsForm` takes. */\n  values: Record<string, unknown>;\n  /** The config path a path within `group` stands for. */\n  pathAt: (railPath: string) => string;\n}\n\n/** Structural rather than `isPrefLeaf`, so the config entry stays free of a\n *  runtime import from ui. */\nfunction isLeaf(node: PrefLeaf | PrefGroup): node is PrefLeaf {\n  return 'kind' in node;\n}\n\n/** A section label as an object key: no dots, since a dotted path is how every\n *  caller addresses a node, and a label is free to hold one. */\nfunction slugOf(label: string, taken: ReadonlySet<string>): string {\n  const base =\n    label\n      .toLowerCase()\n      .replace(/[^a-z0-9]+/g, '-')\n      .replace(/^-|-$/g, '') || 'section';\n  if (!taken.has(base)) return base;\n  for (let n = 2; ; n += 1) if (!taken.has(`${base}-${n}`)) return `${base}-${n}`;\n}\n\n/** A subtree with everything `showIf` or `hidden` rules out cut away, or null\n *  when that is all of it. A group whose children all went is not a rail item\n *  the reader can open onto nothing. */\nfunction prune(\n  resolved: ResolvedConfig,\n  group: PrefGroup,\n  at: string,\n  config: Record<string, unknown>,\n  showHidden: boolean,\n): PrefGroup | null {\n  const children: PrefGroup['children'] = {};\n  for (const [key, child] of Object.entries(group.children)) {\n    const path = at === '' ? key : `${at}.${key}`;\n    if (!isLeafVisible(resolved, path, config, showHidden)) continue;\n    if (isLeaf(child)) {\n      children[key] = child;\n      continue;\n    }\n    const kept = prune(resolved, child, path, config, showHidden);\n    if (kept) children[key] = kept;\n  }\n  return Object.keys(children).length === 0 ? null : { ...group, children };\n}\n\n/**\n * Turn a resolved schema's root sections into the top level of a `PrefGroup`,\n * for `PrefsForm`'s rail layout.\n *\n * A section naming a group brings that group in whole, so it lands as an\n * indented rail item; a section naming a leaf drops it loose into the\n * section's own pane. Sections nested under a group are left alone — they\n * bucket rows inside a pane, which is the panel's job and not the rail's.\n */\nexport function sectionTree(\n  resolved: ResolvedConfig,\n  config: Record<string, unknown>,\n  showHidden = false,\n): SectionTree {\n  const children: PrefGroup['children'] = {};\n  const values: Record<string, unknown> = {};\n  const slugs = new Set<string>();\n  const claimed = new Set<string>();\n\n  for (const section of resolved.sections) {\n    if (section.at !== '') continue;\n    const kept: PrefGroup['children'] = {};\n    const held: Record<string, unknown> = {};\n    for (const path of section.paths) {\n      claimed.add(path);\n      const child = resolved.group.children[path];\n      if (!child || !isLeafVisible(resolved, path, config, showHidden)) continue;\n      if (isLeaf(child)) {\n        kept[path] = child;\n      } else {\n        const subtree = prune(resolved, child, path, config, showHidden);\n        if (!subtree) continue;\n        kept[path] = subtree;\n      }\n      held[path] = valueAtPath(config, path);\n    }\n    if (Object.keys(kept).length === 0) continue;\n    const slug = slugOf(section.label, slugs);\n    slugs.add(slug);\n    children[slug] = { name: section.label, children: kept };\n    values[slug] = held;\n  }\n\n  // Whatever no section claimed stays at the top level, where `prefRailItems`\n  // gathers loose leaves into one item named for the root.\n  for (const [key, child] of Object.entries(resolved.group.children)) {\n    if (claimed.has(key) || !isLeafVisible(resolved, key, config, showHidden)) continue;\n    if (isLeaf(child)) {\n      children[key] = child;\n    } else {\n      const subtree = prune(resolved, child, key, config, showHidden);\n      if (!subtree) continue;\n      children[key] = subtree;\n    }\n    values[key] = valueAtPath(config, key);\n  }\n\n  return {\n    group: { name: resolved.group.name, children },\n    values,\n    pathAt: (railPath) => {\n      const cut = railPath.indexOf('.');\n      const head = cut === -1 ? railPath : railPath.slice(0, cut);\n      if (!slugs.has(head)) return railPath;\n      return cut === -1 ? '' : railPath.slice(cut + 1);\n    },\n  };\n}\n","import { useContext, useMemo } from 'react';\nimport type { Instrument } from '../instrument/types';\nimport { LabContext } from '../lab/LabContext';\nimport { fromConfigFields } from './fromConfigField';\nimport { resolveConfigSchema } from './resolve';\nimport type { ResolvedConfig } from './types';\n\nconst NO_RULES: readonly [] = [];\n\n/**\n * An instrument's controls, resolved against the surrounding lab's rules.\n *\n * Resolution cannot happen in `defineInstrument` — rules are lab-scoped and\n * that runs at module load — so it happens here, at render. Both instrument\n * paths land in the same shape, so callers never branch on which was used.\n */\nexport function useConfigSchema(\n  // biome-ignore lint/suspicious/noExplicitAny: instruments are stored contravariantly; see InstrumentList\n  instrument: Instrument<any, any, any>, // eslint-disable-line @typescript-eslint/no-explicit-any\n): ResolvedConfig {\n  const lab = useContext(LabContext);\n  const rules = lab?.configRules ?? NO_RULES;\n  return useMemo(\n    () =>\n      instrument.config\n        ? resolveConfigSchema(instrument.config, rules)\n        : fromConfigFields(instrument.configSchema?.() ?? []),\n    [instrument, rules],\n  );\n}\n"]}

package/dist/{chunk-MOLIUNVH.js → chunk-HKV7LRHY.js}

@@ -1,6 +1,6 @@
 import { newId, emptyUndoStack, deserializeTrials, openRecords, labPrefix, documentOfRecords, recordsOfDocument, trialRecord, trialValuesPrefix, saveRecord, LAYOUT_RECORD, UNDOCK_RECORD, META_RECORD, parseRecordName, compareTrialOrder, serializeTrials, labStorageKey } from './chunk-RWNDDKOH.js';
-import { resolveConfigSchema, useResolvedConfig } from './chunk-BVL7Y574.js';
-import { applyConfigWrite, fillConfigDefaults } from './chunk-AWH3SRPW.js';
+import { resolveConfigSchema, useResolvedConfig } from './chunk-O6FFFOHS.js';
+import { applyConfigWrite, fillConfigDefaults } from './chunk-TJ77A4A3.js';
 import { LabStoreContext, TrialIdContext } from './chunk-2YILQ7Y5.js';
 import { createStore } from 'zustand/vanilla';
 import { useContext } from 'react';
@@ -733,5 +733,5 @@ function useTrialState() {
 }
 
 export { CURRENT_DOCUMENT_VERSION, createLabStore, dockPanel, labDocumentKey, openLabStore, panelKey, quarantineKey, undockPanel, unruledConfigSchema, useTrialState };
-//# sourceMappingURL=chunk-MOLIUNVH.js.map
-//# sourceMappingURL=chunk-MOLIUNVH.js.map
+//# sourceMappingURL=chunk-HKV7LRHY.js.map
+//# sourceMappingURL=chunk-HKV7LRHY.js.map