@weasel-js/labkit 1.6.0 → 1.7.0

package/dist/_dts/{useTrialState-CP4jfuKl.d.ts → useTrialState-CTZPgeZ7.d.ts}

@@ -1,8 +1,7 @@
-import { d as StorageAdapter, f as LabStoreState, T as TrialRecord, g as SavedSnapshot, s as LabMode, j as UndockedPanel, t as InstrumentList, v as InstrumentHooks, C as CreateLabStoreOptions, i as TrialStateHandle } from './frac-DTRq7Xpb.js';
+import { c as StorageAdapter, e as LabStoreState, T as TrialRecord, f as SavedSnapshot, s as LabMode, i as UndockedPanel, t as InstrumentList, v as InstrumentHooks, C as CreateLabStoreOptions, h as TrialStateHandle } from './types-CSm9jgol.js';
 import * as react from 'react';
 import { ReactNode, ReactElement, Dispatch, SetStateAction } from 'react';
 import { StoreApi } from 'zustand/vanilla';
-import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /** Persist to `localStorage`, one JSON value per record. Survives a reload and
  *  reaches other tabs through the `storage` event. */
@@ -182,7 +181,7 @@ interface PersistenceProps {
 }
 /** Persisted values for a page with no lab: `usePersistedState` below it keeps
  *  what it holds across a reload. Both props are read once, at mount. */
-declare function Persistence({ storageKey, storage, fallback, children }: PersistenceProps): react_jsx_runtime.JSX.Element;
+declare function Persistence({ storageKey, storage, fallback, children }: PersistenceProps): react.JSX.Element;
 
 /** Options for `usePersistedState`. */
 interface PersistedStateOptions {

package/dist/canvas/index.d.ts

@@ -1,12 +1,13 @@
+export { C as CameraContext, a as CameraContextValue, b as CameraInput, c as CameraInputProps, d as CameraPublishContext, e as CameraRegistry, f as CameraRegistryContext, g as CameraScope, h as CameraView, i as CameraViewOptions, j as CanvasStack, k as CanvasStackProps, S as STAGE_VIEW_ID, l as Stage, m as StageProps, Z as ZoomAtOptions, n as ZoomRange, o as centerOn, p as createCameraRegistry, q as fitStage, s as screenToWorld, u as useCameraView, r as usePublishCamera, w as worldToScreen, z as zoomAt } from '../_dts/Stage-CCWfQQWM.js';
 import * as react from 'react';
-export { C as CanvasStack, a as CanvasStackProps, P as PanZoomHandlers, S as Stage, b as StageProps, U as UsePanZoomOptions, Z as ZoomAtOptions, c as centerOn, f as fitStage, s as screenToWorld, u as usePanZoom, w as worldToScreen, z as zoomAt } from '../_dts/usePanZoom-Bq73pwFe.js';
-export { C as CanvasLayerDescriptor, a as CanvasStackContext, b as CanvasStackContextValue, c as CanvasStackSurface } from '../_dts/CanvasStackContext-DQgcH1ny.js';
-export { D as DEFAULT_FRAME, V as ViewportSize, W as WorldFrame, b as WorldSpec, c as applyCamera, r as resolveFrame } from '../_dts/frac-DTRq7Xpb.js';
-import 'react/jsx-runtime';
-import '../_dts/PrefsRow.d-DFpPIeIC.js';
+export { C as CanvasLayerDescriptor, a as CanvasStackContext, b as CanvasStackContextValue, c as CanvasStackSurface } from '../_dts/CanvasStackContext-D2jnIwfk.js';
+import { View } from '@weasel-js/core';
+import { W as WorldFrame } from '../_dts/types-CSm9jgol.js';
+import { Point, ViewTransform } from '../index.js';
+export { D as DEFAULT_FRAME, V as ViewportSize, l as WorldSpec, m as applyCamera, r as resolveFrame } from '../_dts/types-CSm9jgol.js';
+import '../_dts/PrefsRow.d-TOZ7BgD9.js';
 import '@weasel-js/theme';
-import '@weasel-js/core';
-import '../_dts/types-B7y8hX1D.js';
+import '../_dts/types-CRPSGFAp.js';
 import '../_dts/types-DJ79Tg5J.js';
 
 /** Where a trial's camera takes a wheel event from outside its own element. */
@@ -21,5 +22,36 @@ type CameraWheelSlot = {
  */
 declare const CameraWheelContext: react.Context<CameraWheelSlot | null>;
 
-export { CameraWheelContext };
+/**
+ * labkit's camera as a weasel `View`, so core's viewport actions drive it.
+ *
+ * labkit places a world point on screen at
+ * `originPx + pan + zoom * (x, yDir * y)`. A weasel `View` places one at
+ * `(p - (x, y)) * scale`. Over *frame-local* coordinates — the world with `y`
+ * multiplied by `yDir` — the two are the same affine map, which is all a pan
+ * or a zoom about a screen point needs.
+ */
+
+/** The weasel `View` equal to `view` under `frame`. */
+declare function toCameraView(view: ViewTransform, frame?: WorldFrame): View;
+/** The labkit camera equal to weasel `view` under `frame`. */
+declare function fromCameraView(view: View, frame?: WorldFrame): ViewTransform;
+/** A frame-local point in the instrument's world, and back — the map is its
+ *  own inverse. */
+declare function frameLocalToWorld(p: Point, frame?: WorldFrame): Point;
+/**
+ * `next` with its zoom held to [`min`, `max`], about the screen point the step
+ * from `prev` was anchored on, so a zoom that hits a bound stays anchored where
+ * the pointer is. A pan (equal scales) passes through.
+ */
+declare function clampZoomAbout(prev: View, next: View, min: number, max: number): View;
+
+/**
+ * The other side of a linked cursor: a crosshair on the camera's own element
+ * wherever the shared pointer is over some other view — an overview, say. The
+ * same crosshair core paints on a weasel canvas.
+ */
+declare function LinkedCursor(): react.JSX.Element | null;
+
+export { CameraWheelContext, LinkedCursor, WorldFrame, clampZoomAbout, frameLocalToWorld, fromCameraView, toCameraView };
 export type { CameraWheelSlot };

package/dist/canvas/index.js

@@ -1,7 +1,9 @@
-export { CameraWheelContext, CanvasStack, Stage, fitStage, usePanZoom } from '../chunk-TT5C5S6R.js';
-export { centerOn, zoomAt } from '../chunk-H6ZAOWNE.js';
-export { DEFAULT_FRAME, applyCamera, resolveFrame, screenToWorld, worldToScreen } from '../chunk-2AYGEN57.js';
+export { CanvasStack, LinkedCursor, Stage, fitStage } from '../chunk-ZIFPHIWZ.js';
+export { centerOn, zoomAt } from '../chunk-JVBYV6TL.js';
+export { screenToWorld, worldToScreen } from '../chunk-AWQG7FCC.js';
 import '../chunk-WIG6XHJ7.js';
+export { CameraContext, CameraInput, CameraPublishContext, CameraRegistryContext, CameraScope, CameraWheelContext, STAGE_VIEW_ID, clampZoomAbout, createCameraRegistry, frameLocalToWorld, fromCameraView, toCameraView, useCameraView, usePublishCamera } from '../chunk-UNAZSLWE.js';
+export { DEFAULT_FRAME, applyCamera, resolveFrame } from '../chunk-24W5VEJW.js';
 export { CanvasStackContext } from '../chunk-CQLQPQ4P.js';
 import '../chunk-2YILQ7Y5.js';
 //# sourceMappingURL=index.js.map

package/dist/chrome/index.d.ts

@@ -1,9 +1,8 @@
-export { a as LabAsideRegion, b as LabChromeContext, L as LabContribution, e as LabFooterRegion, f as LabHeaderRegion, g as LabRegion, h as LabRegionProps, i as LabSidebarRegion, P as PaletteRegion, j as PaletteRegionProps, S as SidebarRegion, k as SidebarRegionProps, l as StatusRegion, m as StatusRegionProps, T as TitleBarPlacement, n as TitleBarRegion, o as TitleBarRegionProps, p as ToolbarRegion, q as ToolbarRegionProps, V as ViewportRegion, r as ViewportRegionProps, t as builtinContributions, w as contributionsIn, x as labContributions, y as mergeContributions, C as suppressContributions, D as toolContributions, E as useLabChromeContext } from '../_dts/index-B0--8PEM.js';
-export { a6 as ContributionBase, aa as IconComponent, af as RegionContribution, aj as SidebarSection, ak as SidebarSlotContext, am as StatusReadout, ap as ToolItem, aq as ToolSlotContext, ar as ToolbarItem, as as TrialChromeContext, R as TrialContribution, at as TrialRegion, av as ViewportControl } from '../_dts/frac-DTRq7Xpb.js';
-import '../_dts/types-B7y8hX1D.js';
-import '@weasel-js/core';
-import '../_dts/PrefsRow.d-DFpPIeIC.js';
+export { a as LabAsideRegion, b as LabChromeContext, L as LabContribution, e as LabFooterRegion, f as LabHeaderRegion, g as LabRegion, h as LabRegionProps, i as LabSidebarRegion, P as PaletteRegion, j as PaletteRegionProps, S as SidebarRegion, k as SidebarRegionProps, l as StatusRegion, m as StatusRegionProps, T as TitleBarPlacement, n as TitleBarRegion, o as TitleBarRegionProps, p as ToolbarRegion, q as ToolbarRegionProps, V as ViewportRegion, r as ViewportRegionProps, t as builtinContributions, w as contributionsIn, x as labContributions, y as mergeContributions, C as suppressContributions, D as toolContributions, E as useLabChromeContext } from '../_dts/index-CsYqUHD3.js';
+export { a9 as ContributionBase, ad as IconComponent, ak as RegionContribution, ao as SidebarSection, ap as SidebarSlotContext, ar as StatusReadout, au as ToolItem, av as ToolSlotContext, aw as ToolbarItem, ax as TrialChromeContext, Y as TrialContribution, ay as TrialRegion, aA as ViewportControl } from '../_dts/types-CSm9jgol.js';
+import '../_dts/types-CRPSGFAp.js';
+import '../_dts/PrefsRow.d-TOZ7BgD9.js';
 import '@weasel-js/theme';
 import 'react';
-import 'react/jsx-runtime';
+import '@weasel-js/core';
 import '../_dts/types-DJ79Tg5J.js';

package/dist/chrome/index.js

@@ -1,13 +1,15 @@
-export { LabAsideRegion, LabFooterRegion, LabHeaderRegion, LabSidebarRegion, PaletteRegion, SidebarRegion, StatusRegion, TitleBarRegion, ToolbarRegion, ViewportRegion, builtinContributions, contributionsIn, labContributions, mergeContributions, suppressContributions, toolContributions, useLabChromeContext } from '../chunk-H5VIV7MQ.js';
-import '../chunk-3FI7Y4R4.js';
-import '../chunk-SBXNQW4G.js';
+export { LabAsideRegion, LabFooterRegion, LabHeaderRegion, LabSidebarRegion, PaletteRegion, SidebarRegion, StatusRegion, TitleBarRegion, ToolbarRegion, ViewportRegion, builtinContributions, contributionsIn, labContributions, mergeContributions, suppressContributions, toolContributions, useLabChromeContext } from '../chunk-I5DUQ5HM.js';
+import '../chunk-3RY6WL5T.js';
+import '../chunk-7BO7HNGF.js';
+import '../chunk-CZZPXUOU.js';
 import '../chunk-RWNDDKOH.js';
-import '../chunk-HFRE4QQV.js';
+import '../chunk-T5IBSPAM.js';
 import '../chunk-Z76KEZAX.js';
-import '../chunk-VQ47KWD5.js';
-import '../chunk-AWH3SRPW.js';
+import '../chunk-KMJ7RWD3.js';
+import '../chunk-Y23G2VZL.js';
 import '../chunk-CQLQPQ4P.js';
 import '../chunk-2YILQ7Y5.js';
-import '../chunk-WUJXJC5O.js';
+import '../chunk-MIM5R4ZT.js';
+import '../chunk-275JRRVD.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/chunk-24W5VEJW.js

@@ -0,0 +1,18 @@
+// src/canvas/worldSpec.ts
+var DEFAULT_FRAME = { originPx: { x: 0, y: 0 }, yDir: 1 };
+function resolveFrame(spec, size) {
+  if (!spec) return DEFAULT_FRAME;
+  const origin = spec.origin ?? { x: 0, y: 0 };
+  return {
+    originPx: { x: origin.x * size.width, y: origin.y * size.height },
+    yDir: spec.yAxis === "up" ? -1 : 1
+  };
+}
+function applyCamera(ctx, view, frame = DEFAULT_FRAME) {
+  ctx.translate(frame.originPx.x + view.pan.x, frame.originPx.y + view.pan.y);
+  ctx.scale(view.zoom, view.zoom * frame.yDir);
+}
+
+export { DEFAULT_FRAME, applyCamera, resolveFrame };
+//# sourceMappingURL=chunk-24W5VEJW.js.map
+//# sourceMappingURL=chunk-24W5VEJW.js.map

package/dist/chunk-24W5VEJW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/canvas/worldSpec.ts"],"names":[],"mappings":";AA2BO,IAAM,aAAA,GAA4B,EAAE,QAAA,EAAU,EAAE,CAAA,EAAG,GAAG,CAAA,EAAG,CAAA,EAAE,EAAG,IAAA,EAAM,CAAA;AAEpE,SAAS,YAAA,CAAa,MAA6B,IAAA,EAAgC;AACxF,EAAA,IAAI,CAAC,MAAM,OAAO,aAAA;AAClB,EAAA,MAAM,SAAS,IAAA,CAAK,MAAA,IAAU,EAAE,CAAA,EAAG,CAAA,EAAG,GAAG,CAAA,EAAE;AAC3C,EAAA,OAAO;AAAA,IACL,QAAA,EAAU,EAAE,CAAA,EAAG,MAAA,CAAO,CAAA,GAAI,IAAA,CAAK,KAAA,EAAO,CAAA,EAAG,MAAA,CAAO,CAAA,GAAI,IAAA,CAAK,MAAA,EAAO;AAAA,IAChE,IAAA,EAAM,IAAA,CAAK,KAAA,KAAU,IAAA,GAAO,EAAA,GAAK;AAAA,GACnC;AACF;AAIO,SAAS,WAAA,CACd,GAAA,EACA,IAAA,EACA,KAAA,GAAoB,aAAA,EACd;AACN,EAAA,GAAA,CAAI,SAAA,CAAU,KAAA,CAAM,QAAA,CAAS,CAAA,GAAI,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,KAAA,CAAM,QAAA,CAAS,CAAA,GAAI,IAAA,CAAK,GAAA,CAAI,CAAC,CAAA;AAC1E,EAAA,GAAA,CAAI,MAAM,IAAA,CAAK,IAAA,EAAM,IAAA,CAAK,IAAA,GAAO,MAAM,IAAI,CAAA;AAC7C","file":"chunk-24W5VEJW.js","sourcesContent":["import type { Point, ViewTransform } from '../instrument/types';\n\n/** How an instrument's world sits on the canvas, independent of the camera.\n *  The defaults reproduce the convention labkit shipped before this existed:\n *  world (0,0) at the element's top-left, y growing downward. */\nexport interface WorldSpec {\n  /** Where world (0,0) sits at `pan` zero, as a fraction of the viewport.\n   *  `{x:0,y:0}` top-left (default); `{x:0.5,y:0.5}` centre. */\n  origin?: Point;\n  /** Which way the world y axis runs on screen. Default `'down'`. */\n  yAxis?: 'down' | 'up';\n}\n\n/** A viewport's CSS-pixel size. */\nexport interface ViewportSize {\n  width: number;\n  height: number;\n}\n\n/** A `WorldSpec` resolved against a viewport: what the coordinate helpers,\n *  the camera and the wheel all read. */\nexport interface WorldFrame {\n  /** Screen position of world (0,0) at `pan` zero. */\n  originPx: Point;\n  yDir: 1 | -1;\n}\n\nexport const DEFAULT_FRAME: WorldFrame = { originPx: { x: 0, y: 0 }, yDir: 1 };\n\nexport function resolveFrame(spec: WorldSpec | undefined, size: ViewportSize): WorldFrame {\n  if (!spec) return DEFAULT_FRAME;\n  const origin = spec.origin ?? { x: 0, y: 0 };\n  return {\n    originPx: { x: origin.x * size.width, y: origin.y * size.height },\n    yDir: spec.yAxis === 'up' ? -1 : 1,\n  };\n}\n\n/** Put a 2D context into the instrument's world coordinates, so a layer's\n *  `draw` works in them. Must stay the exact inverse of `screenToWorld`. */\nexport function applyCamera(\n  ctx: CanvasRenderingContext2D,\n  view: ViewTransform,\n  frame: WorldFrame = DEFAULT_FRAME,\n): void {\n  ctx.translate(frame.originPx.x + view.pan.x, frame.originPx.y + view.pan.y);\n  ctx.scale(view.zoom, view.zoom * frame.yDir);\n}\n"]}