@weasel-js/labkit 1.2.0 → 1.3.0

package/dist/chunk-BMW4TDP5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/layers/LayerList.tsx"],"names":["n"],"mappings":"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","file":"chunk-BMW4TDP5.js","sourcesContent":["import { type PointerEvent, useRef, useState } from 'react';\nimport type { LayerDescriptor } from '../instrument/types';\nimport { DragHandleGlyph } from '../passthrough/weasel-ui';\n\n/** Props for `<LayerList>`. */\nexport interface LayerListProps {\n  layers: LayerDescriptor[];\n  visibility: Record<string, boolean>;\n  onReorder: (newOrder: LayerDescriptor[]) => void;\n  onToggle: (id: string, visible: boolean) => void;\n  className?: string;\n}\n\ninterface DragState {\n  pointerId: number;\n  fromIndex: number;\n  startY: number;\n  /** Row height plus row gap, measured when the drag starts. */\n  pitch: number;\n}\n\n/** A reorderable list of layers with per-layer visibility toggles. Layers\n *  marked `alwaysOn` are pinned and cannot be reordered or hidden. */\nexport function LayerList({ layers, visibility, onReorder, onToggle, className }: LayerListProps) {\n  const reorderable = layers.filter((l) => !l.alwaysOn);\n  const pinned = layers.filter((l) => l.alwaysOn);\n  const [dragIndex, setDragIndex] = useState<number | null>(null);\n  const dragRef = useRef<DragState | null>(null);\n\n  if (layers.length === 0) {\n    return (\n      <div className={className ? `lk-layer-list ${className}` : 'lk-layer-list'}>\n        <div className=\"lk-layer-list__empty\">No layers</div>\n      </div>\n    );\n  }\n\n  const startDrag = (e: PointerEvent<HTMLElement>, index: number) => {\n    e.currentTarget.setPointerCapture(e.pointerId);\n    // Measured at grab time rather than hardcoded: a restyle that changes row\n    // height or gap would otherwise silently skew every drag distance.\n    const row = e.currentTarget.closest('.lk-layer-list__row');\n    const list = row?.parentElement;\n    const gap = list ? Number.parseFloat(getComputedStyle(list).rowGap) || 0 : 0;\n    const pitch = row ? row.getBoundingClientRect().height + gap : 0;\n    dragRef.current = {\n      pointerId: e.pointerId,\n      fromIndex: index,\n      startY: e.clientY,\n      pitch: pitch > 0 ? pitch : 1,\n    };\n    setDragIndex(index);\n  };\n\n  const moveDrag = (e: PointerEvent<HTMLElement>) => {\n    const drag = dragRef.current;\n    if (!drag || drag.pointerId !== e.pointerId) return;\n    const delta = Math.round((e.clientY - drag.startY) / drag.pitch);\n    const target = Math.min(reorderable.length - 1, Math.max(0, drag.fromIndex + delta));\n    setDragIndex(target);\n  };\n\n  const endDrag = (e: PointerEvent<HTMLElement>) => {\n    const drag = dragRef.current;\n    if (!drag || drag.pointerId !== e.pointerId) return;\n    if (e.currentTarget.hasPointerCapture(e.pointerId)) {\n      e.currentTarget.releasePointerCapture(e.pointerId);\n    }\n    if (dragIndex !== null && dragIndex !== drag.fromIndex) {\n      const next = [...reorderable];\n      const [moved] = next.splice(drag.fromIndex, 1);\n      if (moved) next.splice(dragIndex, 0, moved);\n      onReorder([...next, ...pinned]);\n    }\n    dragRef.current = null;\n    setDragIndex(null);\n  };\n\n  return (\n    <div className={className ? `lk-layer-list ${className}` : 'lk-layer-list'}>\n      {reorderable.map((layer, i) => {\n        const isDragging = dragIndex === i;\n        return (\n          <div\n            key={layer.id}\n            className={\n              isDragging ? 'lk-layer-list__row lk-layer-list__row--dragging' : 'lk-layer-list__row'\n            }\n          >\n            <button\n              type=\"button\"\n              className=\"lk-layer-list__handle\"\n              aria-label={`Reorder ${layer.label}`}\n              onPointerDown={(e) => startDrag(e, i)}\n              onPointerMove={moveDrag}\n              onPointerUp={endDrag}\n            >\n              <DragHandleGlyph size={13} />\n            </button>\n            <input\n              className=\"lk-layer-list__check\"\n              type=\"checkbox\"\n              checked={visibility[layer.id] !== false}\n              onChange={(e) => onToggle(layer.id, e.target.checked)}\n              aria-label={`Toggle ${layer.label}`}\n            />\n            <span className=\"lk-layer-list__label\">{layer.label}</span>\n          </div>\n        );\n      })}\n      {pinned.map((layer) => (\n        <div key={layer.id} className=\"lk-layer-list__row lk-layer-list__row--pinned\">\n          <span className=\"lk-layer-list__lock\" role=\"img\" aria-label=\"Always on\">\n            🔒\n          </span>\n          <span className=\"lk-layer-list__label\">{layer.label}</span>\n        </div>\n      ))}\n    </div>\n  );\n}\n"]}

package/dist/chunk-JDROYQM3.js

@@ -0,0 +1,266 @@
+import { CanvasStackContext } from './chunk-CPUJ3QXL.js';
+import { _, f } from './chunk-RGT4EJIB.js';
+import { useVisibleRaf } from './chunk-QCICIHEO.js';
+import { useState, useRef, useEffect, useContext, useCallback } from 'react';
+import { jsx, jsxs } from 'react/jsx-runtime';
+
+// src/primitives/fpsAverage.ts
+function rollingAverage(samples) {
+  if (samples.length === 0) return 0;
+  const sum = samples.reduce((acc, n) => acc + n, 0);
+  return Math.round(sum / samples.length);
+}
+var SAMPLE_WINDOW = 30;
+function FpsMeter() {
+  const [fps, setFps] = useState(0);
+  const samplesRef = useRef([]);
+  const lastTimeRef = useRef(null);
+  const rootRef = useRef(null);
+  const loop = useVisibleRaf(
+    (time) => {
+      const last = lastTimeRef.current;
+      if (last !== null) {
+        const delta = time - last;
+        if (delta > 0) {
+          const samples = samplesRef.current;
+          samples.push(1e3 / delta);
+          if (samples.length > SAMPLE_WINDOW) samples.shift();
+          setFps(rollingAverage(samples));
+        }
+      }
+      lastTimeRef.current = time;
+      loop.request();
+    },
+    {
+      target: rootRef,
+      // The gap spent suspended is not a frame that took an hour to draw.
+      onResume: () => {
+        lastTimeRef.current = null;
+      }
+    }
+  );
+  useEffect(() => {
+    loop.request();
+    return () => loop.cancel();
+  }, [loop]);
+  return /* @__PURE__ */ jsx("div", { className: "lk-fps-meter", ref: rootRef, children: /* @__PURE__ */ jsxs("span", { className: "lk-fps-meter-value", children: [
+    "FPS ",
+    fps
+  ] }) });
+}
+function niceNumber(n) {
+  if (n <= 0) return 1;
+  const exp = Math.floor(Math.log10(n));
+  const fraction = n / 10 ** exp;
+  let nice;
+  if (fraction < 1.5) nice = 1;
+  else if (fraction < 3.5) nice = 2;
+  else if (fraction < 7.5) nice = 5;
+  else nice = 10;
+  return nice * 10 ** exp;
+}
+function ScaleIndicator({
+  zoom,
+  pixelsPerUnit = 1,
+  unit = "px",
+  targetWidth = 100
+}) {
+  const ctxValue = useContext(CanvasStackContext);
+  const effectiveZoom = zoom ?? ctxValue?.view.zoom ?? 1;
+  const effectivePxPerUnit = pixelsPerUnit * effectiveZoom;
+  const targetUnits = targetWidth / effectivePxPerUnit;
+  const niceUnits = niceNumber(targetUnits);
+  const barWidth = niceUnits * effectivePxPerUnit;
+  return /* @__PURE__ */ jsxs("div", { className: "lk-scale-indicator", role: "img", "aria-label": `Scale: ${niceUnits} ${unit}`, children: [
+    /* @__PURE__ */ jsx("div", { className: "lk-scale-indicator-bar", style: { width: `${barWidth}px` } }),
+    /* @__PURE__ */ jsxs("span", { className: "lk-scale-indicator-label", children: [
+      niceUnits,
+      " ",
+      unit
+    ] })
+  ] });
+}
+var toTrack = (zoom) => Math.log2(zoom);
+var fromTrack = (v) => 2 ** v;
+var clamp = (v, lo, hi) => Math.max(lo, Math.min(hi, v));
+function ZoomControl({
+  zoom,
+  onZoomChange,
+  onZoomCommit,
+  min = 0.1,
+  max = 8,
+  className
+}) {
+  const commit = onZoomCommit ?? onZoomChange;
+  const emit = (track, done) => {
+    const next = clamp(fromTrack(track), min, max);
+    (done ? commit : onZoomChange)(next);
+  };
+  return /* @__PURE__ */ jsxs("div", { className: `lk-zoom${className ? ` ${className}` : ""}`, children: [
+    /* @__PURE__ */ jsx(
+      _,
+      {
+        className: "lk-zoom__slider",
+        ariaLabel: "Zoom",
+        min: toTrack(min),
+        max: toTrack(max),
+        stops: [-2, -1, 0, 1, 2],
+        thumbs: [{ value: clamp(toTrack(zoom), toTrack(min), toTrack(max)) }],
+        onInput: (next) => emit(next[0].value, false),
+        onChange: (next) => emit(next[0].value, true),
+        readoutPlacement: "none"
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      f,
+      {
+        className: "lk-zoom__field",
+        "aria-label": "Zoom",
+        value: zoom,
+        minValue: min,
+        maxValue: max,
+        step: 0.01,
+        hideSteppers: true,
+        formatOptions: { style: "percent", maximumFractionDigits: 0 },
+        onChange: (next) => {
+          if (!Number.isFinite(next)) return;
+          commit(clamp(next, min, max));
+        }
+      }
+    )
+  ] });
+}
+function StatusBar({ children }) {
+  return /* @__PURE__ */ jsx("div", { className: "lk-status-bar", children });
+}
+function Section({ children, end }) {
+  return /* @__PURE__ */ jsx("span", { className: `lk-status-bar-section${end ? " lk-status-bar-section--end" : ""}`, children });
+}
+StatusBar.Section = Section;
+function nextIndex(current, key, count) {
+  if (count === 0) return null;
+  switch (key) {
+    case "ArrowRight":
+      return (current + 1) % count;
+    case "ArrowLeft":
+      return (current - 1 + count) % count;
+    case "Home":
+      return 0;
+    case "End":
+      return count - 1;
+    default:
+      return null;
+  }
+}
+function useRovingTabIndex() {
+  const ref = useRef(null);
+  const stop = useRef(0);
+  const items = useCallback(
+    () => ref.current ? Array.from(
+      ref.current.querySelectorAll('button:not([disabled]), [role="button"]')
+    ) : [],
+    []
+  );
+  const setTabStop = useCallback(
+    (index) => {
+      const found = items();
+      const at = Math.min(Math.max(index, 0), Math.max(found.length - 1, 0));
+      stop.current = at;
+      for (const [i, el] of found.entries()) el.tabIndex = i === at ? 0 : -1;
+    },
+    [items]
+  );
+  useEffect(() => {
+    const resync = () => {
+      const focused = items().indexOf(document.activeElement);
+      setTabStop(focused === -1 ? stop.current : focused);
+    };
+    resync();
+    if (!ref.current) return;
+    const mo = new MutationObserver(resync);
+    mo.observe(ref.current, { childList: true, subtree: true, attributeFilter: ["disabled"] });
+    return () => mo.disconnect();
+  }, [items, setTabStop]);
+  const onKeyDown = useCallback(
+    (e) => {
+      const found = items();
+      const current = found.indexOf(document.activeElement);
+      const next = nextIndex(current === -1 ? 0 : current, e.key, found.length);
+      if (next === null) return;
+      e.preventDefault();
+      found[next]?.focus();
+      setTabStop(next);
+    },
+    [items, setTabStop]
+  );
+  return { ref, onKeyDown };
+}
+function Toolbar({ children, "aria-label": ariaLabel }) {
+  const { ref, onKeyDown } = useRovingTabIndex();
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      ref,
+      className: "lk-toolbar",
+      role: "toolbar",
+      "aria-label": ariaLabel,
+      onKeyDown,
+      children
+    }
+  );
+}
+function Title({ children }) {
+  return /* @__PURE__ */ jsx("span", { className: "lk-toolbar-title", children });
+}
+function Group({ children, end, "aria-label": ariaLabel }) {
+  return (
+    // biome-ignore lint/a11y/useSemanticElements: a group inside role="toolbar" is the APG pattern; the rule is local and cannot see the parent. <fieldset> means form controls, needs a <legend> to be named, and its UA min-width breaks flex children.
+    /* @__PURE__ */ jsx(
+      "div",
+      {
+        className: `lk-toolbar-group${end ? " lk-toolbar-group--end" : ""}`,
+        role: "group",
+        "aria-label": ariaLabel,
+        children
+      }
+    )
+  );
+}
+function Button({
+  children,
+  onClick,
+  disabled,
+  title,
+  "aria-label": ariaLabel,
+  variant = "default",
+  iconOnly
+}) {
+  const cls = [
+    "lk-toolbar-button",
+    variant === "danger" && "lk-toolbar-button--danger",
+    iconOnly && "lk-toolbar-button--icon"
+  ].filter(Boolean).join(" ");
+  return /* @__PURE__ */ jsx(
+    "button",
+    {
+      type: "button",
+      className: cls,
+      onClick,
+      disabled,
+      title,
+      "aria-label": ariaLabel ?? title,
+      children
+    }
+  );
+}
+function Spacer() {
+  return /* @__PURE__ */ jsx("span", { className: "lk-toolbar-spacer", "aria-hidden": "true" });
+}
+Toolbar.Title = Title;
+Toolbar.Group = Group;
+Toolbar.Button = Button;
+Toolbar.Spacer = Spacer;
+
+export { FpsMeter, ScaleIndicator, StatusBar, Toolbar, ZoomControl };
+//# sourceMappingURL=chunk-JDROYQM3.js.map
+//# sourceMappingURL=chunk-JDROYQM3.js.map

package/dist/chunk-JDROYQM3.js.map

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

package/dist/{chunk-THBG7FQZ.js → chunk-LGKRIUSW.js}

@@ -1,3 +1,4 @@
+import { useVisibleRaf } from './chunk-QCICIHEO.js';
 import { createContext, useContext, useCallback, useRef, useEffect } from 'react';
 
 // src/surface/composeRects.ts
@@ -53,7 +54,6 @@ function useTiledSurface({ onFrame }) {
   const rects = useRef(/* @__PURE__ */ new Map());
   const dirty = useRef(/* @__PURE__ */ new Set());
   const needsMeasure = useRef(true);
-  const raf = useRef(0);
   const observer = useRef(null);
   const lastDpr = useRef(0);
   const onFrameRef = useRef(onFrame);
@@ -71,10 +71,8 @@ function useTiledSurface({ onFrame }) {
     rects.current = next;
     return changed;
   }, []);
-  const schedule = useCallback(() => {
-    if (raf.current) return;
-    raf.current = requestAnimationFrame(() => {
-      raf.current = 0;
+  const frameLoop = useVisibleRaf(
+    () => {
       const el = container.current;
       if (!el) {
         dirty.current.clear();
@@ -98,8 +96,14 @@ function useTiledSurface({ onFrame }) {
         size: { width: box.width, height: box.height }
       });
       dirty.current.clear();
-    });
-  }, [measure]);
+    },
+    // The host attaches its container through `containerRef`, which may land
+    // well after this hook's first effect; the gate re-resolves it per request.
+    { target: () => container.current }
+  );
+  const schedule = useCallback(() => {
+    frameLoop.request();
+  }, [frameLoop]);
   const invalidate = useCallback(
     (id) => {
       dirty.current.add(id);
@@ -155,13 +159,12 @@ function useTiledSurface({ onFrame }) {
     return () => {
       ro.disconnect();
       observer.current = null;
-      if (raf.current) cancelAnimationFrame(raf.current);
-      raf.current = 0;
+      frameLoop.cancel();
     };
-  }, [schedule]);
+  }, [schedule, frameLoop]);
   return { invalidate, invalidateAll, invalidateRects, registerTile, containerRef };
 }
 
 export { SurfaceContext, composeRects, rectsEqual, toDeviceRect, useSurface, useSurfaceOptional, useSurfaceTile, useTiledSurface };
-//# sourceMappingURL=chunk-THBG7FQZ.js.map
-//# sourceMappingURL=chunk-THBG7FQZ.js.map
+//# sourceMappingURL=chunk-LGKRIUSW.js.map
+//# sourceMappingURL=chunk-LGKRIUSW.js.map

package/dist/chunk-LGKRIUSW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/surface/composeRects.ts","../src/surface/deviceRect.ts","../src/surface/SurfaceContext.ts","../src/surface/useSurfaceTile.ts","../src/surface/useTiledSurface.ts"],"names":["useCallback"],"mappings":"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","file":"chunk-LGKRIUSW.js","sourcesContent":["import type { Box, Rect } from './rect';\n\n/** Every tile's box expressed against the container's origin. */\nexport function composeRects(container: Box, tiles: ReadonlyMap<string, Box>): Map<string, Rect> {\n  const out = new Map<string, Rect>();\n  for (const [id, tile] of tiles) {\n    out.set(id, {\n      x: tile.left - container.left,\n      y: tile.top - container.top,\n      w: tile.width,\n      h: tile.height,\n    });\n  }\n  return out;\n}\n\nexport function rectsEqual(a: Rect | undefined, b: Rect): boolean {\n  return a !== undefined && a.x === b.x && a.y === b.y && a.w === b.w && a.h === b.h;\n}\n","import type { Rect } from './rect';\n\n/**\n * A DOM rect as a GL viewport rect: origin at the bottom-left, every edge snapped\n * to the device-pixel grid. Still CSS pixels, because three.js applies its own\n * pixel ratio — snapping here is what stops a tile and its neighbour rounding\n * apart and leaving a hairline column between them.\n */\nexport function toDeviceRect(rect: Rect, surfaceHeight: number, dpr: number): Rect {\n  const snap = (v: number) => Math.round(v * dpr) / dpr;\n  const x = snap(rect.x);\n  const y = snap(surfaceHeight - rect.y - rect.h);\n  return {\n    x,\n    y,\n    w: snap(rect.x + rect.w) - x,\n    h: snap(surfaceHeight - rect.y) - y,\n  };\n}\n","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","import { useCallback, useContext } from 'react';\nimport { SurfaceContext } from './SurfaceContext';\nimport type { SurfaceHandle } from './useTiledSurface';\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 * 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 */\nexport function useSurfaceTile(id: string): (el: HTMLElement | null) => void {\n  const surface = useSurfaceOptional();\n  return useCallback(\n    (el: HTMLElement | null) => {\n      surface?.registerTile(id, el);\n    },\n    [surface, id],\n  );\n}\n","import { useVisibleRaf } from '@weasel-js/core';\nimport { useCallback, useEffect, useRef } from 'react';\nimport { composeRects, rectsEqual } from './composeRects';\nimport type { Box, Rect } from './rect';\n\n/** What a surface owner is handed once per animation frame. `rects` carries every\n *  tile, not only the dirty ones: a scissored draw has to know where it is drawing\n *  relative to a surface that may have resized under it. */\nexport interface SurfaceFrame {\n  dirty: ReadonlySet<string>;\n  rects: ReadonlyMap<string, Rect>;\n  dpr: number;\n  size: { width: number; height: number };\n}\n\n/** The invalidators and the two ref callbacks that publish geometry. */\nexport interface SurfaceHandle {\n  /** Mark one tile for redraw. */\n  invalidate: (id: string) => void;\n  /** Mark every tile — what a resize or a tile-set change means. */\n  invalidateAll: () => void;\n  /** Re-measure before the next frame. The escape hatch for a host that knows it\n   *  moved something a ResizeObserver cannot see. */\n  invalidateRects: () => void;\n  registerTile: (id: string, el: HTMLElement | null) => void;\n  containerRef: (el: HTMLElement | null) => void;\n}\n\nexport interface UseTiledSurfaceOptions {\n  onFrame: (frame: SurfaceFrame) => void;\n}\n\nexport function useTiledSurface({ onFrame }: UseTiledSurfaceOptions): SurfaceHandle {\n  const container = useRef<HTMLElement | null>(null);\n  const tiles = useRef(new Map<string, HTMLElement>());\n  const rects = useRef(new Map<string, Rect>());\n  const dirty = useRef(new Set<string>());\n  const needsMeasure = useRef(true);\n  const observer = useRef<ResizeObserver | null>(null);\n  const lastDpr = useRef(0);\n\n  // Held in a ref so a caller passing an inline closure does not re-create every\n  // callback below on each render.\n  const onFrameRef = useRef(onFrame);\n  onFrameRef.current = onFrame;\n\n  const measure = useCallback((): boolean => {\n    const el = container.current;\n    if (!el) return false;\n    const boxes = new Map<string, Box>();\n    for (const [id, tile] of tiles.current) boxes.set(id, tile.getBoundingClientRect());\n    const next = composeRects(el.getBoundingClientRect(), boxes);\n    let changed = next.size !== rects.current.size;\n    for (const [id, rect] of next) {\n      if (!rectsEqual(rects.current.get(id), rect)) changed = true;\n    }\n    rects.current = next;\n    return changed;\n  }, []);\n\n  const frameLoop = useVisibleRaf(\n    () => {\n      const el = container.current;\n      if (!el) {\n        dirty.current.clear();\n        return;\n      }\n      if (needsMeasure.current) {\n        needsMeasure.current = false;\n        if (measure()) for (const id of rects.current.keys()) dirty.current.add(id);\n      }\n      const dpr = globalThis.devicePixelRatio ?? 1;\n      if (dpr !== lastDpr.current) {\n        lastDpr.current = dpr;\n        for (const id of rects.current.keys()) dirty.current.add(id);\n      }\n      if (dirty.current.size === 0) return;\n      const box = el.getBoundingClientRect();\n      onFrameRef.current({\n        dirty: new Set(dirty.current),\n        rects: new Map(rects.current),\n        dpr,\n        size: { width: box.width, height: box.height },\n      });\n      dirty.current.clear();\n    },\n    // The host attaches its container through `containerRef`, which may land\n    // well after this hook's first effect; the gate re-resolves it per request.\n    { target: () => container.current },\n  );\n\n  const schedule = useCallback(() => {\n    frameLoop.request();\n  }, [frameLoop]);\n\n  const invalidate = useCallback(\n    (id: string) => {\n      dirty.current.add(id);\n      schedule();\n    },\n    [schedule],\n  );\n\n  const invalidateAll = useCallback(() => {\n    for (const id of tiles.current.keys()) dirty.current.add(id);\n    schedule();\n  }, [schedule]);\n\n  const invalidateRects = useCallback(() => {\n    needsMeasure.current = true;\n    schedule();\n  }, [schedule]);\n\n  const registerTile = useCallback(\n    (id: string, el: HTMLElement | null) => {\n      const known = tiles.current.get(id);\n      if (known === el) return;\n      if (known) observer.current?.unobserve(known);\n      if (el) {\n        tiles.current.set(id, el);\n        observer.current?.observe(el);\n      } else {\n        tiles.current.delete(id);\n        rects.current.delete(id);\n        dirty.current.delete(id);\n      }\n      needsMeasure.current = true;\n      schedule();\n    },\n    [schedule],\n  );\n\n  const containerRef = useCallback(\n    (el: HTMLElement | null) => {\n      if (container.current === el) return;\n      if (container.current) observer.current?.unobserve(container.current);\n      container.current = el;\n      if (el) observer.current?.observe(el);\n      needsMeasure.current = true;\n      schedule();\n    },\n    [schedule],\n  );\n\n  useEffect(() => {\n    const ro = new ResizeObserver(() => {\n      needsMeasure.current = true;\n      schedule();\n    });\n    observer.current = ro;\n    if (container.current) ro.observe(container.current);\n    for (const el of tiles.current.values()) ro.observe(el);\n    return () => {\n      ro.disconnect();\n      observer.current = null;\n      frameLoop.cancel();\n    };\n  }, [schedule, frameLoop]);\n\n  return { invalidate, invalidateAll, invalidateRects, registerTile, containerRef };\n}\n"]}