@weasel-js/labkit 1.3.0 → 1.4.0-pre.0

package/dist/layers/index.d.ts

@@ -1,11 +1,12 @@
-import { g as LayerDescriptor } from '../_dts/types-BttTIent.js';
-export { L as LayerCapability } from '../_dts/types-BttTIent.js';
+import { E as LayerDescriptor } from '../_dts/frac-Cp3NivlC.js';
+export { B as LayerCapability } from '../_dts/frac-Cp3NivlC.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import 'react';
-import '../_dts/types-DCGEcMO_.js';
-import '../_dts/PrefsForm-BYa6cWnO.js';
-import '../_dts/types-1Sdxy_Pv.js';
+import '../_dts/types-D6s4b7if.js';
+import '../_dts/PrefsForm-BkUJZx0A.js';
+import '../_dts/types-DYMaEvM5.js';
 import '../_dts/types-DJ79Tg5J.js';
+import '../_dts/types-C-gh9Ap-.js';
 
 /** Props for `<LayerList>`. */
 interface LayerListProps {

package/dist/layers/index.js

@@ -1,6 +1,6 @@
-export { LayerList } from '../chunk-BMW4TDP5.js';
+export { LayerList } from '../chunk-JDDIZSLL.js';
 import '../chunk-SBXNQW4G.js';
-import '../chunk-RGT4EJIB.js';
-import '../chunk-QCICIHEO.js';
+import '../chunk-HEORBLVT.js';
+import '../chunk-ROQDRXKW.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/loupe/index.d.ts

@@ -0,0 +1,187 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ae as LoupeMode, V as ViewTransform, W as WorldFrame, c as WorldSpec, a2 as ViewportSize, K as LoupeRenderArgs, N as ResolvedLoupe } from '../_dts/frac-Cp3NivlC.js';
+export { L as LOUPE_DEFAULTS, G as LoupeCapability, J as LoupeDeclaration, ab as resolveLoupe } from '../_dts/frac-Cp3NivlC.js';
+import { c as CanvasStackSurface, C as CanvasLayerDescriptor } from '../_dts/CanvasStackContext-DtAn_3O-.js';
+import { RefObject, ReactNode } from 'react';
+import '../_dts/types-D6s4b7if.js';
+import '../_dts/PrefsForm-BkUJZx0A.js';
+import '../_dts/types-DYMaEvM5.js';
+import '../_dts/types-DJ79Tg5J.js';
+import '../_dts/types-C-gh9Ap-.js';
+
+/** A point on the magnified surface, in its own CSS pixels. */
+interface LoupePoint {
+    x: number;
+    y: number;
+}
+
+/** Props for `<CanvasLoupe>`. */
+interface CanvasLoupeProps {
+    aim: LoupePoint;
+    factor: number;
+    mode: LoupeMode;
+    diameter: number;
+    /** The stack being magnified: its layers, its pixels, and its measured box. */
+    surface: CanvasStackSurface;
+    view: ViewTransform;
+    frame: WorldFrame;
+    worldSpec?: WorldSpec;
+}
+/**
+ * Paints a lens over a `<CanvasStack>` by re-drawing the stack's layers through
+ * a zoomed camera — so the magnified content is as sharp as the original, at
+ * any factor. `pixel` mode enlarges what the stack presented instead.
+ */
+declare function CanvasLoupe({ aim, factor, mode, diameter, surface, view, frame, worldSpec, }: CanvasLoupeProps): react_jsx_runtime.JSX.Element;
+
+/** The camera a round lens of `diameter` shows a magnified region through, and
+ *  the coordinate system it is read in — the instrument's own `WorldSpec`,
+ *  resolved against the lens rather than the stack. */
+interface LensCamera {
+    view: ViewTransform;
+    frame: WorldFrame;
+}
+/**
+ * What a lens aimed at `aim` renders the stack's layers through.
+ *
+ * The lens is its own viewport, so the world spec resolves against its box: an
+ * instrument centred on its viewport is centred in the lens too.
+ */
+declare function lensCamera(aim: LoupePoint, outer: ViewTransform, outerFrame: WorldFrame, factor: number, diameter: number, worldSpec?: WorldSpec): LensCamera;
+/** A rectangle in a backing store's own device pixels. */
+interface SourceRect {
+    sx: number;
+    sy: number;
+    sw: number;
+    sh: number;
+}
+/**
+ * The region a pixel-mode lens copies out of a presented canvas: the `diameter
+ * / factor` CSS px around `aim`, in that canvas' backing-store pixels.
+ */
+declare function lensSourceRect(aim: LoupePoint, factor: number, diameter: number, dpr: number): SourceRect;
+/**
+ * The colour a stack presents at a point: the topmost visible layer with
+ * anything opaque there, or `null` when every layer is transparent — which is
+ * the honest answer for a point showing nothing but the workspace behind.
+ */
+declare function sampleStack(layers: readonly CanvasLayerDescriptor[], canvases: Map<string, HTMLCanvasElement>, p: LoupePoint, dpr: number): string | null;
+/** Redraw the stack into a lens' own canvas. `mode` decides whether the layers
+ *  are re-run at the lens camera or their presented pixels are enlarged. */
+declare function drawCanvasLens(ctx: CanvasRenderingContext2D, opts: {
+    aim: LoupePoint;
+    factor: number;
+    diameter: number;
+    dpr: number;
+    mode: 'vector' | 'pixel';
+    outer: ViewTransform;
+    outerFrame?: WorldFrame;
+    worldSpec?: WorldSpec;
+    layers: readonly CanvasLayerDescriptor[];
+    canvases: Map<string, HTMLCanvasElement>;
+}): void;
+
+/** Props for `<DomLoupe>`. */
+interface DomLoupeProps {
+    aim: LoupePoint;
+    factor: number;
+    mode: LoupeMode;
+    diameter: number;
+    /** The host the instrument draws into, which the stage reproduces. */
+    size: ViewportSize;
+    /** The trial's own camera. */
+    view: ViewTransform;
+    frame?: WorldFrame;
+    state: unknown;
+    config: unknown;
+    render: (args: LoupeRenderArgs) => React.ReactNode;
+}
+/**
+ * Paints a lens over DOM content by asking the instrument to draw itself again
+ * at a magnified camera.
+ *
+ * The stage is a full copy of the host, so the instrument's own layout still
+ * holds; the camera is composed about the aimed point, which keeps that point
+ * where it already was, and the stage is then slid by `diameter / 2 - aim` to
+ * bring it to the middle of the lens.
+ */
+declare function DomLoupe({ aim, factor, mode, diameter, size, view, frame, state, config, render, }: DomLoupeProps): react_jsx_runtime.JSX.Element;
+
+/** Props for `<LoupeBubble>`. */
+interface LoupeBubbleProps {
+    /** Where the lens is aimed, in its container's own pixels. */
+    aim: LoupePoint;
+    diameter: number;
+    hostRef?: RefObject<HTMLDivElement | null>;
+    children: ReactNode;
+}
+/**
+ * The lens itself: a circle centred on the aimed point, clipping whatever a
+ * painter draws into it.
+ *
+ * It takes no pointer events, so the pan, the wheel and anything underneath
+ * keep working while it is up — and it is `aria-hidden`, since it magnifies
+ * content already on the page rather than adding any.
+ */
+declare function LoupeBubble({ aim, diameter, hostRef, children }: LoupeBubbleProps): react_jsx_runtime.JSX.Element;
+
+/** Props for `<TrialLoupe>`. */
+interface TrialLoupeProps {
+    capability: ResolvedLoupe;
+    /** Whether the trial's loupe is turned on. Hold-to-peek shows it anyway. */
+    enabled: boolean;
+    state: unknown;
+    config: unknown;
+    /** The trial's own camera. */
+    view: ViewTransform;
+    worldSpec?: WorldSpec;
+    /** The element the lens tracks. A loupe mounted inside a `<CanvasStack>`
+     *  takes the stack's own element instead, and this goes unused. */
+    hostRef?: RefObject<HTMLElement | null>;
+}
+/**
+ * A trial's loupe, painted by whichever painter suits its content: the canvas
+ * stack it is mounted inside, or the instrument's own `render` at a magnified
+ * camera.
+ */
+declare function TrialLoupe({ capability, enabled, state, config, view, worldSpec, hostRef, }: TrialLoupeProps): react_jsx_runtime.JSX.Element | null;
+
+/** Options for {@link useLoupe}. */
+interface UseLoupeOptions {
+    capability: ResolvedLoupe;
+    /** The element the lens tracks the pointer across. */
+    hostRef: RefObject<HTMLElement | null>;
+    /** Whether the loupe is turned on. Hold-to-peek shows it regardless. */
+    enabled: boolean;
+    /** Hex colour at a host point. Omitted, the loupe reports no colour — which
+     *  is the honest answer for a surface with no pixels to read. */
+    sample?: (p: LoupePoint) => string | null;
+}
+/** A loupe as a React view reads it. */
+interface LoupeState {
+    /** Whether the lens should be drawn. */
+    visible: boolean;
+    /** Where it is aimed, in the host's own pixels. */
+    aim: LoupePoint;
+    factor: number;
+    mode: LoupeMode;
+    color: string | null;
+    setMode: (mode: LoupeMode) => void;
+    setFactor: (factor: number) => void;
+    /** Sample what the lens shows at a point inside it. */
+    pick: (p?: LoupePoint) => string | null;
+}
+/**
+ * Binds `@weasel-js/loupe`'s model to a host element and drives it from the
+ * pointer, the peek key and the wheel.
+ *
+ * These are plain listeners rather than gesture bindings because labkit trials
+ * do not route input through the dispatcher — see the loupe entry under
+ * "Selection, actions & UI panels" in `docs/TODO.md`. They are all in this one
+ * hook so that when trial input does go through it, this is the only file to
+ * rewrite.
+ */
+declare function useLoupe({ capability, hostRef, enabled, sample }: UseLoupeOptions): LoupeState;
+
+export { CanvasLoupe, DomLoupe, LoupeBubble, LoupeRenderArgs, ResolvedLoupe, TrialLoupe, drawCanvasLens, lensCamera, lensSourceRect, sampleStack, useLoupe };
+export type { CanvasLoupeProps, DomLoupeProps, LensCamera, LoupeBubbleProps, LoupeState, SourceRect, TrialLoupeProps, UseLoupeOptions };

package/dist/loupe/index.js

@@ -0,0 +1,7 @@
+export { CanvasLoupe, DomLoupe, LOUPE_DEFAULTS, LoupeBubble, TrialLoupe, drawCanvasLens, lensCamera, lensSourceRect, resolveLoupe, sampleStack, useLoupe } from '../chunk-EQIB2PGC.js';
+import '../chunk-CTRKTLYZ.js';
+import '../chunk-2AYGEN57.js';
+import '../chunk-CQLQPQ4P.js';
+import '../chunk-ROQDRXKW.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/loupe/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/passthrough/weasel-canvas.d.ts

@@ -1,6 +1,8 @@
-import { N as Node, V as View, P as Path, D as DrawCommand, S as Scene, B as Bounds, a as ViewportDims, b as PathDrawCommand } from '../_dts/DrawCommand-DBB45NfN.js';
+import { N as Node, P as Path, S as Scene } from '../_dts/types-C-gh9Ap-.js';
+import { V as View, D as DrawCommand, P as PathDrawCommand } from '../_dts/DrawCommand-B3bskUsC.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Ref } from 'react';
+import { B as Bounds, V as ViewportDims } from '../_dts/fitViewToBounds-dZ2UDB6e.js';
 
 /**
  * NodeShape — the **shape trait's** registry. Each trait of a node

package/dist/passthrough/weasel-canvas.js

@@ -1,3 +1,3 @@
-export { FALLBACK_FIT_VIEW, MinimapCanvas, SceneViewCanvas, buildSceneViewCommands, computeFitView, computeIndicatorCommand, renderSceneToCanvas } from '../chunk-QCICIHEO.js';
+export { FALLBACK_FIT_VIEW, MinimapCanvas, SceneViewCanvas, buildSceneViewCommands, computeFitView, computeIndicatorCommand, renderSceneToCanvas } from '../chunk-ROQDRXKW.js';
 //# sourceMappingURL=weasel-canvas.js.map
 //# sourceMappingURL=weasel-canvas.js.map

package/dist/passthrough/weasel-ui.d.ts

@@ -1,11 +1,15 @@
-import { T as ToolPrefLeaf, a as ToolPrefGroup } from '../_dts/PrefsForm-BYa6cWnO.js';
-export { b as BuiltinPref, c as PrefBoolean, d as PrefBooleanControl, e as PrefColor, f as PrefCustom, g as PrefEnum, h as PrefEnumControl, i as PrefEnumEncoding, j as PrefKind, k as PrefNumber, l as PrefNumberControl, m as PrefNumberUnit, n as PrefObject, o as PrefPaint, p as PrefRenderContext, P as PrefRenderer, q as PrefString, r as PrefStringControl } from '../_dts/PrefsForm-BYa6cWnO.js';
+import { T as ToolPrefLeaf, a as ToolPrefGroup } from '../_dts/PrefsForm-BkUJZx0A.js';
+export { b as BuiltinPref, c as PrefBoolean, d as PrefBooleanControl, e as PrefColor, f as PrefCustom, g as PrefEnum, h as PrefEnumControl, i as PrefEnumEncoding, j as PrefKind, k as PrefNumber, l as PrefNumberControl, m as PrefNumberUnit, n as PrefObject, o as PrefPaint, p as PrefRenderContext, P as PrefRenderer, q as PrefString, r as PrefStringControl } from '../_dts/PrefsForm-BkUJZx0A.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
-import { MutableRefObject, ReactNode, CSSProperties, ButtonHTMLAttributes, ReactElement, KeyboardEvent, PointerEvent as PointerEvent$1, RefCallback, RefObject } from 'react';
+import { MutableRefObject, ReactNode, CSSProperties, ButtonHTMLAttributes, ReactElement, KeyboardEvent, RefObject, PointerEvent as PointerEvent$1, RefCallback } from 'react';
 export { LayerStack, LayerStackItem, LayerStackProps } from '../ui/layers/index.js';
-import { V as View, D as DrawCommand, O as Op, c as NodeId, P as Path, S as Scene, H as History, B as Bounds } from '../_dts/DrawCommand-DBB45NfN.js';
-import { TextFieldProps, ValidationResult, CheckboxProps as CheckboxProps$1, SwitchProps as SwitchProps$1, TabProps as TabProps$1, TabListProps as TabListProps$1, TabPanelProps as TabPanelProps$1, TabsProps as TabsProps$1, RadioProps as RadioProps$1, RadioGroupProps as RadioGroupProps$1, NumberFieldProps as NumberFieldProps$1, SelectProps as SelectProps$1, ListBoxItemProps, ComboBoxProps as ComboBoxProps$1, SliderProps as SliderProps$1, ModalOverlayProps, DialogProps as DialogProps$1 } from 'react-aria-components';
+import { O as Op, a as NodeId, P as Path, S as Scene, H as History } from '../_dts/types-C-gh9Ap-.js';
+import { V as View, D as DrawCommand } from '../_dts/DrawCommand-B3bskUsC.js';
+import { B as Bounds } from '../_dts/fitViewToBounds-dZ2UDB6e.js';
+import { K as KitInsertShape } from '../_dts/shapeKinds-Cx_rxwsa.js';
+import { TextFieldProps, ValidationResult, CheckboxProps as CheckboxProps$1, SwitchProps as SwitchProps$1, TabProps as TabProps$1, TabListProps as TabListProps$1, TabPanelProps as TabPanelProps$1, TabsProps as TabsProps$1, RadioProps as RadioProps$1, RadioGroupProps as RadioGroupProps$1, NumberFieldProps as NumberFieldProps$1, SelectProps as SelectProps$1, ListBoxItemProps, ComboBoxProps as ComboBoxProps$1, SliderProps as SliderProps$1, ModalOverlayProps, DialogProps as DialogProps$1, PopoverProps } from 'react-aria-components';
+export { DialogTrigger as CalloutTrigger } from 'react-aria-components';
 
 /**
  * Namespaced, opt-in console tracing. Off by default; production builds
@@ -1037,86 +1041,6 @@ interface PasteSpec {
  *  the `Action` type. */
 type GestureSpec = KeySpec$1 | KeyHeldSpec | WheelSpec | ClickSpec | DoubleClickSpec | ContextMenuSpec | DragSpec | PointerDownSpec | LongPressSpec | MultiTouchSpec | MultiTouchTapSpec | DropSpec | PasteSpec;
 
-/**
- * The kit's built-in shape kinds — one table, every other spelling derived.
- *
- * Lives in `core/` rather than beside the shape tools because both layers ask
- * questions of the same set: the interactions layer decides whether
- * `insertAction` can paint a live preview for a kind, and the canvas layer
- * decides which shape tools `useBuiltinShapeTools` mounts and what
- * `BUNDLE_TOOLS` / `defaultNodeRouting` / `defaultNodeProperties` enumerate.
- *
- * This module imports nothing on purpose: `useBuiltinShapeTools` imports the
- * package barrel, so anything barrel-reachable that needs these lists at
- * module-evaluation time must not route through it.
- */
-/** What the kit knows about one built-in shape kind. */
-interface ShapeKindDescriptor {
-    /** Mounted as a built-in shape tool by `useBuiltinShapeTools`, and so a
-     *  member of `BuiltinShapeToolId` / `KIT_SHAPE_KINDS`. `image` is false:
-     *  `useImageTool` needs a `src` and can't be auto-mounted. */
-    readonly tool: boolean;
-    /** `insertAction` emits an `insertPreview` overlay for this kind, and the
-     *  dispatcher overlay layer knows how to draw it. Kinds without one still
-     *  commit; they just have no live drag preview (`pen` and `lasso` don't
-     *  route through `insertAction` at all). */
-    readonly insertPreview: boolean;
-}
-/**
- * Declaration order is the enumeration order of every derived list —
- * `KIT_SHAPE_KINDS`, and through it `defaultNodeRouting` /
- * `defaultNodeProperties` / `BUNDLE_TOOLS.exhaustive`.
- */
-declare const SHAPE_KINDS: {
-    readonly rect: {
-        readonly tool: true;
-        readonly insertPreview: true;
-    };
-    readonly ellipse: {
-        readonly tool: true;
-        readonly insertPreview: true;
-    };
-    readonly line: {
-        readonly tool: true;
-        readonly insertPreview: true;
-    };
-    readonly polygon: {
-        readonly tool: true;
-        readonly insertPreview: true;
-    };
-    readonly star: {
-        readonly tool: true;
-        readonly insertPreview: true;
-    };
-    readonly pen: {
-        readonly tool: true;
-        readonly insertPreview: false;
-    };
-    readonly pencil: {
-        readonly tool: true;
-        readonly insertPreview: true;
-    };
-    readonly lasso: {
-        readonly tool: true;
-        readonly insertPreview: false;
-    };
-    readonly text: {
-        readonly tool: true;
-        readonly insertPreview: true;
-    };
-    readonly image: {
-        readonly tool: false;
-        readonly insertPreview: true;
-    };
-};
-/** The keys of a shape-kind table whose descriptor sets `F` to `true`. */
-type ShapeKindsWhere<T, F extends keyof ShapeKindDescriptor> = {
-    [K in keyof T]: T[K] extends Record<F, true> ? K : never;
-}[keyof T];
-/** The insert kinds the kit's dispatcher overlay layer knows how to render.
- *  Consumer-defined kinds fall outside it: no live preview, commit unaffected. */
-type KitInsertShape = ShapeKindsWhere<typeof SHAPE_KINDS, 'insertPreview'>;
-
 /** A 2D point in either world or screen coordinates. */
 interface Point2 {
     x: number;
@@ -1718,10 +1642,59 @@ interface PoseProjection<TPose> {
     supportsRotation?(pose: TPose): boolean;
 }
 
+/** All easings in one bag — useful for demos / pickers. */
+declare const EASINGS: {
+    readonly linear: EasingFn;
+    readonly easeInQuad: EasingFn;
+    readonly easeOutQuad: EasingFn;
+    readonly easeInOutQuad: EasingFn;
+    readonly easeInCubic: EasingFn;
+    readonly easeOutCubic: EasingFn;
+    readonly easeInOutCubic: EasingFn;
+    readonly easeInQuart: EasingFn;
+    readonly easeOutQuart: EasingFn;
+    readonly easeInOutQuart: EasingFn;
+    readonly easeInQuint: EasingFn;
+    readonly easeOutQuint: EasingFn;
+    readonly easeInOutQuint: EasingFn;
+    readonly easeInSine: EasingFn;
+    readonly easeOutSine: EasingFn;
+    readonly easeInOutSine: EasingFn;
+    readonly easeInExpo: EasingFn;
+    readonly easeOutExpo: EasingFn;
+    readonly easeInOutExpo: EasingFn;
+    readonly easeInCirc: EasingFn;
+    readonly easeOutCirc: EasingFn;
+    readonly easeInOutCirc: EasingFn;
+    readonly easeInBack: EasingFn;
+    readonly easeOutBack: EasingFn;
+    readonly easeInOutBack: EasingFn;
+    readonly easeInElastic: EasingFn;
+    readonly easeOutElastic: EasingFn;
+    readonly easeInOutElastic: EasingFn;
+    readonly easeInBounce: EasingFn;
+    readonly easeOutBounce: EasingFn;
+    readonly easeInOutBounce: EasingFn;
+};
+/** The name of one of the built-in easing curves. */
+type EasingName = keyof typeof EASINGS;
+
+/** Cubic-bezier control points, CSS `cubic-bezier()` order. The curve's two
+ *  endpoints are implicit at (0,0) and (1,1). */
+interface BezierEasing {
+    /** `readonly` so an `as const` preset is assignable; nothing ever writes it. */
+    bezier: readonly [number, number, number, number];
+}
+/** An easing curve as a value: a function, the name of a built-in, or control
+ *  points. Anything an editor has to name, show or serialize must not be a bare
+ *  function, which is why the union exists. */
+type EasingSpec = EasingFn | EasingName | BezierEasing;
+
 /** An easing curve: maps normalized progress `t ∈ [0, 1]` to eased progress.
  *  Curves may leave the 0–1 range in the middle (back, elastic) but should
  *  pass through 0 at 0 and 1 at 1. */
 type EasingFn = (t: number) => number;
+
 /** Factory interpolator: built ONCE at tween start with (from, to), the returned
  *  function is called with `t ∈ [0, 1]` each frame. Use for interpolators with
  *  expensive setup (color-space conversion, path-string parsing) — d3-interpolate's
@@ -1734,7 +1707,7 @@ interface ViewAnimationOptions {
     /** Duration in ms. Default 250. */
     ms?: number;
     /** Easing curve. Default `easeOutCubic`. */
-    easing?: EasingFn;
+    easing?: EasingSpec;
     /** Replace the kit's log-scale / fixed-anchor curve. */
     interpolator?: InterpolatorFactory<View>;
     /** Fires when the target is reached. Not called on cancel. */
@@ -3956,6 +3929,13 @@ type Thumb = {
     label?: string;
     shape?: ThumbShape;
     bounds?: [number, number] | ((ctx: BoundsCtx) => [number, number]);
+    /**
+     * Spoken form of `value`, published as `aria-valuetext`. Required by ARIA
+     * whenever `value` is not the quantity the user is choosing — an index into
+     * a value list, a log-scaled position — since `aria-valuenow` alone then
+     * announces a number that means nothing.
+     */
+    valueText?: string;
 };
 /**
  * Passed to a thumb's `bounds` function: the full thumb list and this thumb's
@@ -3981,7 +3961,13 @@ type TrackCtx = {
  *
  * `stops` are attractors: a drag that passes within a few pixels of one lands
  * on it, and the arrow keys move stop to stop. `step` still quantizes the
- * values between them.
+ * values between them. Each one is drawn on the track as a mark; pass
+ * `showStops: false` for a track whose own paint already reads as the stops.
+ *
+ * `trackClick: 'move-nearest'` makes a press on bare track send the closest
+ * thumb there and continue as a drag. It is off by default because on a
+ * multi-thumb editor a stray click would yank a stop the user was not aiming
+ * at; `onAddThumb`, where it is set, keeps the track press.
  *
  * `constraint: 'ordered'` keeps thumbs from crossing each other. Supplying
  * `onAddThumb` makes a click on empty track create a thumb, and supplying
@@ -3997,6 +3983,8 @@ type SliderProps<T extends Thumb = Thumb> = {
     max: number;
     step?: number;
     stops?: number[];
+    showStops?: boolean;
+    trackClick?: 'none' | 'move-nearest';
     constraint?: 'free' | 'ordered';
     onAddThumb?: (atValue: number) => T | null;
     onRemoveThumb?: (index: number) => boolean;
@@ -4684,8 +4672,8 @@ type RangeSliderProps = Omit<SliderProps$1, 'children' | 'className'> & {
 };
 /**
  * Linear range slider on React Aria. Single-value by default; pass an array
- * to `value` / `defaultValue` for multi-thumb. Distinct from the kit's
- * canvas-scrub `Slider`, which is shaped for tool-canvas interactions.
+ * to `value` / `defaultValue` for multi-thumb. Distinct from `Slider`, which
+ * is fully controlled and gives each thumb its own bounds and readout.
  */
 declare function RangeSlider(props: RangeSliderProps): react_jsx_runtime.JSX.Element;
 
@@ -4717,6 +4705,65 @@ type DialogProps = Omit<ModalOverlayProps, 'children' | 'className'> & {
  */
 declare function Dialog(props: DialogProps): react_jsx_runtime.JSX.Element;
 
+/** Accent color of a {@link Callout}'s border and arrow. */
+type CalloutTone = 'info' | 'warning' | 'danger';
+
+/** Props for {@link Callout}, on top of React Aria's `Popover` props. */
+type CalloutProps = Omit<PopoverProps, 'children' | 'className' | 'isNonModal' | 'triggerRef'> & {
+    children?: ReactNode;
+    className?: string;
+    /** Optional heading rendered above the body. */
+    title?: ReactNode;
+    /** Footer slot — typically action buttons. */
+    footer?: ReactNode;
+    /** Accent tone for border + arrow. Default `info`. */
+    tone?: CalloutTone;
+    /**
+     * `true` — blocks interaction with the rest of the app until dismissed;
+     * inner dialog is `role="alertdialog"`. `false` (default) — non-blocking:
+     * the app stays interactive; Esc / outside click / close button dismiss.
+     */
+    modal?: boolean;
+    /**
+     * Show the × button. Defaults to `!modal`. In programmatic
+     * `triggerRef`/`anchorRect` modes the close button needs controlled open
+     * (`isOpen` + `onOpenChange`); with only `defaultOpen` it has no open-state
+     * setter to call and cannot close.
+     */
+    showCloseButton?: boolean;
+    /**
+     * The user asked for this callout to go away — the × button or Escape.
+     *
+     * Distinct from `onOpenChange`, which a non-modal popover *also* fires when
+     * interaction or focus merely leaves it. On a canvas that's every click on
+     * the artwork, so a consumer that pins `isOpen` and treats `onOpenChange`
+     * as dismissal retires messages nobody read. Use this instead: it fires
+     * only on a deliberate act, and never on incidental focus loss.
+     */
+    onDismiss?: () => void;
+    /** Anchor to an arbitrary element (programmatic use, with `isOpen`). */
+    triggerRef?: RefObject<Element | null>;
+    /**
+     * Anchor to a client-coordinate rect — e.g. a scene node's on-screen box.
+     * The callout re-anchors whenever this rect changes, so a consumer that
+     * recomputes it on pan, zoom, or scene edits keeps the arrow on its target.
+     * Takes precedence over `triggerRef`.
+     */
+    anchorRect?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+};
+/**
+ * Anchored callout with an arrow pointing at its source — a trigger
+ * element, an arbitrary `triggerRef`, or a client-space `anchorRect`.
+ * Wraps React Aria Popover + Dialog; positioning, collision flipping,
+ * dismissal, and focus behavior come from the underlying primitives.
+ */
+declare function Callout(props: CalloutProps): react_jsx_runtime.JSX.Element;
+
 /**
  * Coordinate transforms (model ↔ plot) for Plot2D. Pure / deterministic —
  * no DOM, no React, no state.
@@ -5144,5 +5191,5 @@ declare const MINUS_SIGN = "\u2212";
  */
 declare function formatNumber(value: number, options?: Intl.NumberFormatOptions): string;
 
-export { ActionBar, ActionsBar, Badge, Button, Checkbox, ComboBox, ComboBoxItem, CurveEditor, DataGrid, Dialog, DragHandleGlyph, EDGE_PROFILES, Field, Input, KeyCap, KeySequence, MINUS_SIGN, NumberField, OptionsBar, Plot2D, PointPlotter, Powerline, ToolPrefGroup as PrefGroup, ToolPrefLeaf as PrefLeaf, Radio, RadioGroup, RangeSlider, Select, SelectItem, Sidebar, SidebarPanel, Slider, Switch, Tab, TabList, TabPanel, Tabs, ToggleBar, ToolButton, ToolGroup, ToolPalette, chromaAt, detectPlatform, dlog, fieldClasses, formatNumber, formatShortcut, formatShortcutParts, inferKeycapKind, isDebugEnabled, isPrefLeaf, keyGlyph, keySpecFromKey, keySpecsFromMods, oklchToHex, paintGradientTrack, prefValueAtPath, useReorderDragList, useRovingTabIndex, visiblePrefSubtree };
-export type { ActionBarProps, ActionsBarItem, ActionsBarProps, ActionsBarSize, ActionsBarVariant, AddPointMode, AnchorRenderProps, AxesSettings, BadgeProps, BadgeShape, BadgeSize, BadgeTone, BadgeVariant, BoundsCtx, BuiltInEdgeName, ButtonProps, ButtonSize, ButtonVariant, CheckboxProps, ChromaCurve, ChromaCurvePoint, ComboBoxItemProps, ComboBoxOption, ComboBoxProps, ControlPoint, CurveDomain, CurveEditorProps, DataGridColumn, DataGridProps, DialogProps, DragHandleGlyphProps, EdgeCap, EdgeProfile, EndpointMode, FieldOrientation, FieldProps, FillSettings, GradientTrackOpts, GridSettings, InputProps, InterpolationMode, KeyCapProps, KeyCapVariant, KeySequenceProps, KeySpec, KeycapKind, LayerListItem, LogicalMod, LogicalModSpec, NumberFieldProps, OptionsBarItem, OptionsBarProps, OptionsBarSize, OptionsBarVariant, Platform, Plot2DCoords, Plot2DHandle, Plot2DProps, PointPlotterProps, PowerlineProps, PowerlineSegment, RadioGroupProps, RadioProps, RangeSliderProps, ReorderDragHandlers, ReorderDragState, RovingItem, RovingTabIndex, SelectItemProps, SelectOption, SelectProps, SidebarPanelProps, SidebarProps, SliderProps, SwitchProps, TabListProps, TabPanelProps, TabProps, TabsProps, Thumb, ThumbRenderCtx, ThumbShape, ToggleBarItem, ToggleBarProps, ToggleBarSize, ToggleBarVariant, ToolButtonProps, ToolGroupProps, ToolPaletteProps, TrackCtx, UseReorderDragListOptions, UseRovingTabIndexOptions };
+export { ActionBar, ActionsBar, Badge, Button, Callout, Checkbox, ComboBox, ComboBoxItem, CurveEditor, DataGrid, Dialog, DragHandleGlyph, EDGE_PROFILES, Field, Input, KeyCap, KeySequence, MINUS_SIGN, NumberField, OptionsBar, Plot2D, PointPlotter, Powerline, ToolPrefGroup as PrefGroup, ToolPrefLeaf as PrefLeaf, Radio, RadioGroup, RangeSlider, Select, SelectItem, Sidebar, SidebarPanel, Slider, Switch, Tab, TabList, TabPanel, Tabs, ToggleBar, ToolButton, ToolGroup, ToolPalette, chromaAt, detectPlatform, dlog, fieldClasses, formatNumber, formatShortcut, formatShortcutParts, inferKeycapKind, isDebugEnabled, isPrefLeaf, keyGlyph, keySpecFromKey, keySpecsFromMods, oklchToHex, paintGradientTrack, prefValueAtPath, useReorderDragList, useRovingTabIndex, visiblePrefSubtree };
+export type { ActionBarProps, ActionsBarItem, ActionsBarProps, ActionsBarSize, ActionsBarVariant, AddPointMode, AnchorRenderProps, AxesSettings, BadgeProps, BadgeShape, BadgeSize, BadgeTone, BadgeVariant, BoundsCtx, BuiltInEdgeName, ButtonProps, ButtonSize, ButtonVariant, CalloutProps, CheckboxProps, ChromaCurve, ChromaCurvePoint, ComboBoxItemProps, ComboBoxOption, ComboBoxProps, ControlPoint, CurveDomain, CurveEditorProps, DataGridColumn, DataGridProps, DialogProps, DragHandleGlyphProps, EdgeCap, EdgeProfile, EndpointMode, FieldOrientation, FieldProps, FillSettings, GradientTrackOpts, GridSettings, InputProps, InterpolationMode, KeyCapProps, KeyCapVariant, KeySequenceProps, KeySpec, KeycapKind, LayerListItem, LogicalMod, LogicalModSpec, NumberFieldProps, OptionsBarItem, OptionsBarProps, OptionsBarSize, OptionsBarVariant, Platform, Plot2DCoords, Plot2DHandle, Plot2DProps, PointPlotterProps, PowerlineProps, PowerlineSegment, RadioGroupProps, RadioProps, RangeSliderProps, ReorderDragHandlers, ReorderDragState, RovingItem, RovingTabIndex, SelectItemProps, SelectOption, SelectProps, SidebarPanelProps, SidebarProps, SliderProps, SwitchProps, TabListProps, TabPanelProps, TabProps, TabsProps, Thumb, ThumbRenderCtx, ThumbShape, ToggleBarItem, ToggleBarProps, ToggleBarSize, ToggleBarVariant, ToolButtonProps, ToolGroupProps, ToolPaletteProps, TrackCtx, UseReorderDragListOptions, UseRovingTabIndexOptions };

package/dist/passthrough/weasel-ui.js

@@ -1,5 +1,5 @@
 import '../chunk-SBXNQW4G.js';
-export { m as ActionBar, r4 as ActionsBar, It as Badge, a4 as Button, o as Checkbox, p3 as ComboBox, m3 as ComboBoxItem, F as CurveEditor, s as DataGrid, c as Dialog, n2 as DragHandleGlyph, Je as EDGE_PROFILES, n as Field, u as Input, s2 as KeyCap, c2 as KeySequence, c3 as LayerStack, e as MINUS_SIGN, f as NumberField, r3 as OptionsBar, f2 as Plot2D, n5 as PointPlotter, r5 as Powerline, u2 as Radio, l as RadioGroup, l2 as RangeSlider, p as Select, h as SelectItem, n3 as Sidebar, o3 as SidebarPanel, _ as Slider, a3 as Switch, c4 as Tab, s3 as TabList, l3 as TabPanel, o5 as Tabs, r as ToggleBar, o4 as ToolButton, n4 as ToolGroup, _3 as ToolPalette, Sn as chromaAt, u3 as detectPlatform, a as dlog, r2 as fieldClasses, t as formatNumber, d2 as formatShortcut, u4 as formatShortcutParts, o2 as inferKeycapKind, i as isDebugEnabled, b as isPrefLeaf, e2 as keyGlyph, p2 as keySpecFromKey, d as keySpecsFromMods, xn as oklchToHex, v as paintGradientTrack, x as prefValueAtPath, i2 as useReorderDragList, a2 as useRovingTabIndex, S as visiblePrefSubtree } from '../chunk-RGT4EJIB.js';
-import '../chunk-QCICIHEO.js';
+export { m as ActionBar, r4 as ActionsBar, It as Badge, a3 as Button, h2 as Callout, c5 as CalloutTrigger, o as Checkbox, p3 as ComboBox, m3 as ComboBoxItem, F as CurveEditor, s as DataGrid, c as Dialog, n2 as DragHandleGlyph, Je as EDGE_PROFILES, n as Field, u as Input, s2 as KeyCap, c2 as KeySequence, c3 as LayerStack, e2 as MINUS_SIGN, f as NumberField, r3 as OptionsBar, f2 as Plot2D, n5 as PointPlotter, r5 as Powerline, u2 as Radio, l as RadioGroup, l2 as RangeSlider, p as Select, h as SelectItem, n3 as Sidebar, s3 as SidebarPanel, _2 as Slider, a2 as Switch, c4 as Tab, s4 as TabList, l3 as TabPanel, o4 as Tabs, r2 as ToggleBar, o3 as ToolButton, n4 as ToolGroup, _4 as ToolPalette, In as chromaAt, u3 as detectPlatform, a as dlog, r as fieldClasses, t as formatNumber, d2 as formatShortcut, u4 as formatShortcutParts, o2 as inferKeycapKind, i as isDebugEnabled, b2 as isPrefLeaf, e as keyGlyph, p2 as keySpecFromKey, d as keySpecsFromMods, Fn as oklchToHex, v2 as paintGradientTrack, x2 as prefValueAtPath, i2 as useReorderDragList, a4 as useRovingTabIndex, S as visiblePrefSubtree } from '../chunk-HEORBLVT.js';
+import '../chunk-ROQDRXKW.js';
 //# sourceMappingURL=weasel-ui.js.map
 //# sourceMappingURL=weasel-ui.js.map

package/dist/primitives/index.d.ts

@@ -113,7 +113,7 @@ declare function Toolbar({ children, 'aria-label': ariaLabel }: ToolbarProps): r
 declare namespace Toolbar {
     var Title: ({ children }: TitleProps) => react_jsx_runtime.JSX.Element;
     var Group: ({ children, end, "aria-label": ariaLabel }: ToolbarGroupProps) => react_jsx_runtime.JSX.Element;
-    var Button: ({ children, onClick, disabled, title, "aria-label": ariaLabel, variant, iconOnly, }: ToolbarButtonProps) => react_jsx_runtime.JSX.Element;
+    var Button: ({ children, onClick, disabled, title, "aria-label": ariaLabel, variant, iconOnly, pressed, }: ToolbarButtonProps) => react_jsx_runtime.JSX.Element;
     var Spacer: () => react_jsx_runtime.JSX.Element;
 }
 interface TitleProps {
@@ -138,6 +138,8 @@ interface ToolbarButtonProps {
     variant?: 'default' | 'danger';
     /** Square, for a button whose whole content is one glyph. */
     iconOnly?: boolean;
+    /** Makes this a toggle: `aria-pressed`, and held down while true. */
+    pressed?: boolean;
 }
 
 /** Props for `<ZoomControl>`. */

package/dist/primitives/index.js

@@ -1,8 +1,8 @@
-export { FloatingPanel, JobProgress, Legend, Sidebar } from '../chunk-QRYPXSGP.js';
-export { FpsMeter, ScaleIndicator, StatusBar, Toolbar, ZoomControl } from '../chunk-JDROYQM3.js';
-import '../chunk-CPUJ3QXL.js';
+export { FloatingPanel, JobProgress, Legend, Sidebar } from '../chunk-3P5TTTA7.js';
+export { FpsMeter, ScaleIndicator, StatusBar, Toolbar, ZoomControl } from '../chunk-6JMU56CU.js';
 import '../chunk-SBXNQW4G.js';
-import '../chunk-RGT4EJIB.js';
-import '../chunk-QCICIHEO.js';
+import '../chunk-HEORBLVT.js';
+import '../chunk-CQLQPQ4P.js';
+import '../chunk-ROQDRXKW.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/state/index.d.ts

@@ -1,6 +1,6 @@
-export { C as CURRENT_DOCUMENT_VERSION, L as LabStore, a as LabStoreActions, b as LabStoreContext, c as LabStoreProvider, T as TrialIdContext, d as TrialIdProvider, e as createLabStore, f as createMemoryAdapter, l as labDocumentKey, g as localStorageAdapter, n as noneAdapter, q as quarantineKey, s as sessionStorageAdapter, u as urlHashAdapter, h as useLabStore, i as useTrialId, j as useTrialState } from '../_dts/useTrialState-CsGMjhu9.js';
-import { S as SerializedTrial, I as InstrumentSerializers, T as TrialRecord, U as UndoStack, a as StorageAdapter } from '../_dts/types-1Sdxy_Pv.js';
-export { C as CreateLabStoreOptions, L as LabDocument, b as LabStoreState, M as Migration, c as SavedSnapshot, d as TrialStateHandle } from '../_dts/types-1Sdxy_Pv.js';
+export { C as CURRENT_DOCUMENT_VERSION, L as LabStore, a as LabStoreActions, b as LabStoreContext, c as LabStoreProvider, T as TrialIdContext, d as TrialIdProvider, e as createLabStore, f as createMemoryAdapter, l as labDocumentKey, g as localStorageAdapter, n as noneAdapter, q as quarantineKey, s as sessionStorageAdapter, u as urlHashAdapter, h as useLabStore, i as useTrialId, j as useTrialState } from '../_dts/useTrialState-gmMvZqPc.js';
+import { S as SerializedTrial, I as InstrumentSerializers, T as TrialRecord, U as UndoStack, a as StorageAdapter } from '../_dts/types-DYMaEvM5.js';
+export { C as CreateLabStoreOptions, L as LabDocument, b as LabStoreState, M as Migration, c as SavedSnapshot, d as TrialStateHandle, e as UndockedPanel, f as UndockedPanels, g as dockPanel, p as panelKey, u as undockPanel } from '../_dts/types-DYMaEvM5.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 import 'zustand/vanilla';

package/dist/state/index.js

@@ -1,5 +1,5 @@
-import { createLabStore, LabStoreProvider, TrialIdProvider } from '../chunk-4TMMVIDM.js';
-export { CURRENT_DOCUMENT_VERSION, LabStoreContext, LabStoreProvider, TrialIdContext, TrialIdProvider, createLabStore, createMemoryAdapter, decodeUrlHash, deserializeTrials, emptyUndoStack, encodeUrlHash, labDocumentKey, labStorageKey, localStorageAdapter, noneAdapter, quarantineKey, serializeTrials, sessionStorageAdapter, urlHashAdapter, useLabStore, useTrialId, useTrialState } from '../chunk-4TMMVIDM.js';
+import { createLabStore, LabStoreProvider, TrialIdProvider } from '../chunk-XJ6N32QP.js';
+export { CURRENT_DOCUMENT_VERSION, LabStoreContext, LabStoreProvider, TrialIdContext, TrialIdProvider, createLabStore, createMemoryAdapter, decodeUrlHash, deserializeTrials, dockPanel, emptyUndoStack, encodeUrlHash, labDocumentKey, labStorageKey, localStorageAdapter, noneAdapter, panelKey, quarantineKey, serializeTrials, sessionStorageAdapter, undockPanel, urlHashAdapter, useLabStore, useTrialId, useTrialState } from '../chunk-XJ6N32QP.js';
 import { useRef } from 'react';
 import { jsx } from 'react/jsx-runtime';