@weasel-js/labkit 1.4.4 → 1.5.1

package/dist/layers/index.d.ts

@@ -1,12 +1,10 @@
-import { E as LayerDescriptor } from '../_dts/frac-z7ker2Vx.js';
-export { B as LayerCapability } from '../_dts/frac-z7ker2Vx.js';
+import { aa as LayerDescriptor } from '../_dts/frac-B4okC2lX.js';
+export { a9 as LayerCapability } from '../_dts/frac-B4okC2lX.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import 'react';
-import '../_dts/types-B9_zrHmb.js';
+import '../_dts/types-DzoNY1pO.js';
 import '@weasel-js/core';
-import '../_dts/PrefsForm.d-DDHFANkc.js';
-import '../_dts/types-x92Kfeme.js';
-import '../_dts/types-BP2OCcpg.js';
+import '../_dts/PrefsForm.d-DPy9I8It.js';
 import '../_dts/types-DJ79Tg5J.js';
 
 /** A layer that may itself contain layers. A plain `LayerDescriptor` is one

package/dist/layers/index.js

@@ -1,5 +1,5 @@
-export { LayerList } from '../chunk-BKFVHKJH.js';
+export { LayerList } from '../chunk-MDVTK5U3.js';
 import '../chunk-SBXNQW4G.js';
-import '../chunk-W3ECWC2K.js';
+import '../chunk-T3EC2DXD.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/loupe/index.d.ts

@@ -1,13 +1,11 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ae as LoupePoint, af as LoupeMode, V as ViewTransform, W as WorldFrame, c as WorldSpec, a2 as ViewportSize, K as LoupeRenderArgs, N as ResolvedLoupe } from '../_dts/frac-z7ker2Vx.js';
-export { L as LOUPE_DEFAULTS, G as LoupeCapability, J as LoupeDeclaration, ab as resolveLoupe } from '../_dts/frac-z7ker2Vx.js';
-import { c as CanvasStackSurface, C as CanvasLayerDescriptor } from '../_dts/CanvasStackContext-kTEZvEgE.js';
+import { aG as LoupePoint, aH as LoupeMode, k as ViewTransform, W as WorldFrame, a as WorldSpec, V as ViewportSize, ad as LoupeRenderArgs, ag as ResolvedLoupe } from '../_dts/frac-B4okC2lX.js';
+export { a8 as LOUPE_DEFAULTS, ab as LoupeCapability, ac as LoupeDeclaration, aD as resolveLoupe } from '../_dts/frac-B4okC2lX.js';
+import { c as CanvasStackSurface, C as CanvasLayerDescriptor } from '../_dts/CanvasStackContext-CJNMS6mz.js';
 import { RefObject, ReactNode } from 'react';
-import '../_dts/types-B9_zrHmb.js';
-import '@weasel-js/core';
-import '../_dts/PrefsForm.d-DDHFANkc.js';
-import '../_dts/types-x92Kfeme.js';
-import '../_dts/types-BP2OCcpg.js';
+import { Action } from '@weasel-js/core';
+import '../_dts/types-DzoNY1pO.js';
+import '../_dts/PrefsForm.d-DPy9I8It.js';
 import '../_dts/types-DJ79Tg5J.js';
 
 /** Props for `<CanvasLoupe>`. */
@@ -56,7 +54,7 @@ interface SourceRect {
  */
 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
+ * The color 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.
  */
@@ -120,6 +118,53 @@ interface LoupeBubbleProps {
  */
 declare function LoupeBubble({ aim, diameter, hostRef, children }: LoupeBubbleProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * The loupe's two bindable interactions, as `Action` descriptors the gesture
+ * dispatcher routes: hold a key to peek, and walk the magnification with the
+ * wheel.
+ *
+ * Free of React so the routing can be tested without a DOM.
+ */
+
+/** Canonical id of the hold-to-peek action. */
+declare const LOUPE_PEEK_ID = "loupe.peek";
+/** Canonical id of the wheel-magnify action. */
+declare const LOUPE_MAGNIFY_ID = "loupe.magnify";
+/** What the actions do to a live loupe. Every member is read through the
+ *  object on each invocation, so one stable instance serves the life of the
+ *  registration. */
+interface LoupeInputApi {
+    /** Whether the lens is up. The wheel belongs to the loupe only while it is;
+     *  otherwise `loupe.magnify` declines and the dispatcher leaves the event
+     *  unhandled, which is what hands it back to the lab's own pan/zoom. */
+    shown: () => boolean;
+    /** Raise or drop the hold-to-peek flag. */
+    setPeeking: (on: boolean) => void;
+    /** Multiply the magnification by one wheel notch of `deltaY`. */
+    magnifyBy: (deltaY: number) => void;
+}
+/**
+ * Build the loupe's actions. `peekKey` is a `KeyboardEvent.key`; passing
+ * `null` omits `loupe.peek` entirely rather than registering a binding no key
+ * can match.
+ */
+declare function createLoupeActions(input: LoupeInputApi, peekKey: string | null): readonly Action[];
+
+/** Props for `<LoupeGestures>`. */
+interface LoupeGesturesProps {
+    /** The element the dispatcher listens on — the same one the lens tracks. */
+    hostRef: RefObject<HTMLElement | null>;
+    input: LoupeInputApi;
+    /** `KeyboardEvent.key` for hold-to-peek, or `null` for no peek binding. */
+    peekKey: string | null;
+}
+/**
+ * The loupe's input, routed. Render it inside a `<WeaselProvider isolate>` —
+ * with no registry in scope it renders nothing rather than registering
+ * actions that could never fire.
+ */
+declare function LoupeGestures(props: LoupeGesturesProps): react_jsx_runtime.JSX.Element | null;
+
 /** Props for `<TrialLoupe>`. */
 interface TrialLoupeProps {
     capability: ResolvedLoupe;
@@ -139,7 +184,7 @@ interface TrialLoupeProps {
  * 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;
+declare function TrialLoupe({ capability, enabled, state, config, view, worldSpec, hostRef, }: TrialLoupeProps): react_jsx_runtime.JSX.Element;
 
 /** Options for {@link useLoupe}. */
 interface UseLoupeOptions {
@@ -148,7 +193,7 @@ interface UseLoupeOptions {
     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
+    /** Hex color at a host point. Omitted, the loupe reports no color — which
      *  is the honest answer for a surface with no pixels to read. */
     sample?: (p: LoupePoint) => string | null;
 }
@@ -165,18 +210,22 @@ interface LoupeState {
     setFactor: (factor: number) => void;
     /** Sample what the lens shows at a point inside it. */
     pick: (p?: LoupePoint) => string | null;
+    /** What `<LoupeGestures>` drives the lens through. Stable for the life of
+     *  the hook, so registering the actions on it does not churn. */
+    input: LoupeInputApi;
 }
 /**
- * Binds `@weasel-js/loupe`'s model to a host element and drives it from the
- * pointer, the peek key and the wheel.
+ * Binds `@weasel-js/loupe`'s model to a host element and tracks the pointer
+ * across it.
  *
- * 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.
+ * The peek key and the wheel are not here: they are `loupe.peek` and
+ * `loupe.magnify`, routed through the gesture dispatcher that
+ * `<LoupeGestures>` mounts on the same host. Aiming stays a plain listener
+ * because a hover is not a gesture the grammar names — `GESTURE_DESCRIPTORS`
+ * has no continuous-motion entry, and inventing one to carry the lens' aim
+ * would be an input taxonomy change, not a loupe change.
  */
 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 };
+export { CanvasLoupe, DomLoupe, LOUPE_MAGNIFY_ID, LOUPE_PEEK_ID, LoupeBubble, LoupeGestures, LoupeRenderArgs, ResolvedLoupe, TrialLoupe, createLoupeActions, drawCanvasLens, lensCamera, lensSourceRect, sampleStack, useLoupe };
+export type { CanvasLoupeProps, DomLoupeProps, LensCamera, LoupeBubbleProps, LoupeGesturesProps, LoupeInputApi, LoupeState, SourceRect, TrialLoupeProps, UseLoupeOptions };

package/dist/loupe/index.js

@@ -1,5 +1,5 @@
-export { CanvasLoupe, DomLoupe, LOUPE_DEFAULTS, LoupeBubble, TrialLoupe, drawCanvasLens, lensCamera, lensSourceRect, resolveLoupe, sampleStack, useLoupe } from '../chunk-TJ7QY3OC.js';
-import '../chunk-CTRKTLYZ.js';
+export { CanvasLoupe, DomLoupe, LOUPE_DEFAULTS, LOUPE_MAGNIFY_ID, LOUPE_PEEK_ID, LoupeBubble, LoupeGestures, TrialLoupe, createLoupeActions, drawCanvasLens, lensCamera, lensSourceRect, resolveLoupe, sampleStack, useLoupe } from '../chunk-ERFMC6WU.js';
+import '../chunk-H6ZAOWNE.js';
 import '../chunk-2AYGEN57.js';
 import '../chunk-CQLQPQ4P.js';
 //# sourceMappingURL=index.js.map