@weasel-js/labkit 1.7.0 → 1.7.1

package/dist/passthrough/weasel-ui.js

@@ -1,5 +1,6 @@
 import '../chunk-CZZPXUOU.js';
-export { v as ActionBar, Xt as Badge, c as Button, a10 as ButtonBar, a9 as COLOR_MODE_OPTIONS, _2 as Callout, d4 as CalloutTrigger, o5 as Checkbox, a2 as CloseButton, s2 as ColorModeControl, y2 as ComboBox, S2 as ComboBoxItem, L as CurveEditor, f as DataGrid, d2 as Dialog, i2 as Disclosure, r as DisclosureMark, a3 as DisclosureRow, a5 as DragGhost, n4 as DragGrip, Ze as EDGE_PROFILES, n5 as Field, p3 as GestureRoute, n as ICON_PATHS, l as Icon, u3 as Input, f2 as KeyCap, p as KeySequence, E3 as LayerList, c2 as ListEditor, MINUS_SIGN, d3 as MenuButton, y as NumberField, r3 as OptionsBar, w as Plot2D, n9 as PointPlotter, r4 as Powerline, I2 as PrefsDialog, j as PrefsForm, u4 as Radio, l4 as RadioGroup, l7 as RangeSlider, E2 as Select, L2 as SelectItem, n6 as Sidebar, a11 as SidebarPanel, S as Slider, a8 as Switch, c6 as Tab, s4 as TabList, l6 as TabPanel, o6 as Tabs, o3 as ThemeSwitcher, a7 as ToggleBar, o4 as ToolButton, n8 as ToolGroup, h2 as ToolPalette, Z2 as chromaAt, o2 as detectPlatform, a as dlog, r2 as fieldClasses, formatNumber, n2 as formatShortcut, t as formatShortcutParts, f4 as gestureRouteSegments, d as inferKeycapKind, i as isDebugEnabled, s3 as isPrefLeaf, e as keyGlyph, l3 as keySpecFromKey, s as keySpecsFromMods, m as keySpecsFromShortcut, x3 as moveLayers, X2 as oklchToHex, C2 as paintGradientTrack, c3 as prefValueAtPath, x as sampleByInterpolation, wi as useAsyncOptions, u2 as useReorderDragList, a6 as useRovingTabIndex, l5 as visiblePrefSubtree } from '../chunk-MIM5R4ZT.js';
-import '../chunk-275JRRVD.js';
+export { b2 as ActionBar, Xt as Badge, c as Button, a9 as ButtonBar, a8 as COLOR_MODE_OPTIONS, v2 as Callout, f4 as CalloutTrigger, c5 as Checkbox, a2 as CloseButton, s2 as ColorModeControl, b4 as ComboBox, C2 as ComboBoxItem, L as CurveEditor, f as DataGrid, d3 as Dialog, i2 as Disclosure, r as DisclosureMark, a3 as DisclosureRow, a5 as DragGhost, n4 as DragGrip, Ze as EDGE_PROFILES, n5 as Field, p3 as GestureRoute, n as ICON_PATHS, l as Icon, u2 as Input, f2 as KeyCap, p as KeySequence, D2 as LayerList, l5 as ListEditor, MINUS_SIGN, p4 as MenuButton, y as NumberField, r3 as OptionsBar, w as Plot2D, n9 as PointPlotter, r4 as Powerline, R2 as PrefsDialog, j2 as PrefsForm, u3 as Radio, l4 as RadioGroup, l9 as RangeSlider, O2 as Select, B2 as SelectItem, n6 as Sidebar, a10 as SidebarPanel, S as Slider, a7 as Switch, c6 as Tab, s3 as TabList, l8 as TabPanel, o5 as Tabs, o3 as ThemeSwitcher, a6 as ToggleBar, o4 as ToolButton, n8 as ToolGroup, h4 as ToolPalette, Z2 as chromaAt, o2 as detectPlatform, a as dlog, r2 as fieldClasses, formatNumber, n2 as formatShortcut, t as formatShortcutParts, f3 as gestureRouteSegments, d2 as inferKeycapKind, i as isDebugEnabled, c3 as isPrefLeaf, e as keyGlyph, l3 as keySpecFromKey, s as keySpecsFromMods, m as keySpecsFromShortcut, S2 as moveLayers, X2 as oklchToHex, D as paintGradientTrack, l6 as prefValueAtPath, x as sampleByInterpolation, Bi as useAsyncOptions, d as useReorderDragList, c2 as useRovingTabIndex, u4 as visiblePrefSubtree } from '../chunk-4KSC7NXL.js';
+import '../chunk-E23Q6A3Y.js';
+import '../chunk-XVUKDSYV.js';
 //# sourceMappingURL=weasel-ui.js.map
 //# sourceMappingURL=weasel-ui.js.map

package/dist/primitives/index.d.ts

@@ -1,5 +1,215 @@
 export { a as FloatingPanel, F as FloatingPanelProps } from '../_dts/FloatingPanel-7j0IcXwz.js';
-export { F as FpsMeter, J as JobProgress, g as JobProgressProps, L as Legend, h as LegendEntry, i as LegendMark, j as LegendProps, R as Readout, k as ReadoutProps, l as ReadoutRow, m as ScaleIndicator, n as ScaleIndicatorProps, o as Split, S as SplitProps, p as StatusBar, q as StatusBarProps, r as StatusBarSectionProps, T as Toolbar, s as ToolbarButtonProps, t as ToolbarGroupProps, u as ToolbarProps, Z as ZoomControl, v as ZoomControlProps } from '../_dts/index-B2Yj5aA0.js';
-import 'react';
+import * as react from 'react';
+import { ReactNode, MouseEventHandler } from 'react';
+import { JobHandle } from '../index.js';
+import { DetailRowStatus, DetailListValues } from '@weasel-js/ui';
 import 'windease';
-import '../_dts/types-DJ79Tg5J.js';
+
+/** A live frame-rate readout, averaged over the last 30 frames. */
+declare function FpsMeter(): react.JSX.Element;
+
+/** Props for `<JobProgress>`. */
+interface JobProgressProps {
+    job: JobHandle;
+    className?: string;
+}
+/** A running job's progress, failures and outcome. Determinate once the job
+ *  reports a total; a job that cannot count up front never sends one, so the
+ *  bar stays indeterminate rather than inventing a denominator. */
+declare function JobProgress({ job, className }: JobProgressProps): react.JSX.Element | null;
+
+/** How a legend entry's swatch is drawn, matching how the thing looks on canvas. */
+type LegendMark = 'line' | 'dash' | 'dot' | 'band';
+/** One row of a legend: a swatch and what it means. */
+interface LegendEntry {
+    key: string;
+    label: string;
+    color: string;
+    /** Defaults to `'line'`. */
+    mark?: LegendMark;
+}
+/** Props for `<Legend>`. */
+interface LegendProps {
+    entries: readonly LegendEntry[];
+    className?: string;
+}
+/** A color key. Presentational only — no handlers, no state, no hover behavior. */
+declare function Legend({ entries, className }: LegendProps): react.JSX.Element;
+
+/** One measurement in a {@link Readout}. */
+interface ReadoutRow {
+    /** React key. Defaults to `label` when that is a string, else the row's index. */
+    key?: string;
+    label: ReactNode;
+    /** `null` or `undefined` keeps the row in place showing an en dash, so the
+     *  readout holds its height while a measurement comes and goes. */
+    value?: ReactNode;
+    /** A dot in the status color before the value. Color is never the only
+     *  signal: the value has to say the same thing in words. */
+    status?: DetailRowStatus;
+    /** `text` sets this row's value as wrapping prose instead of a figure. */
+    values?: DetailListValues;
+}
+/** Props for {@link Readout}. */
+interface ReadoutProps {
+    rows: readonly ReadoutRow[];
+    /** Heading above the rows, which also names the list. */
+    title?: ReactNode;
+    /** Drawn below the rows — a small table, a note. */
+    children?: ReactNode;
+    className?: string;
+}
+/**
+ * Values a lab only reads — measurements shown beside its picture, such as
+ * "Lock margin +47.9°". A {@link DetailList} set as figures: labels take the
+ * params label recipe and `--wzl-params-label-width` rail, so a readout lines
+ * up with a `ControlPanel` beside it, and values sit right-aligned in the mono
+ * face with spaces kept, so figure-space padding aligns a column on its
+ * decimal point. Rows compose by hand as `DetailRow`s inside a `DetailList`
+ * with `values="figures"`.
+ */
+declare function Readout({ rows, title, children, className }: ReadoutProps): react.JSX.Element;
+
+/** Props for `<ScaleIndicator>`. */
+interface ScaleIndicatorProps {
+    /** Current view zoom factor. If omitted, reads from CanvasStackContext. Defaults to 1. */
+    zoom?: number;
+    /** World pixels per unit at zoom=1. Default: 1. */
+    pixelsPerUnit?: number;
+    /** Unit label. Default: 'px'. */
+    unit?: string;
+    /** Target bar width in display pixels. Default: 100. */
+    targetWidth?: number;
+}
+/** A scale bar: a labeled rule showing how far a round number of world units
+ *  is at the current zoom. Reads the zoom from the surrounding canvas stack
+ *  unless one is passed. */
+declare function ScaleIndicator({ zoom, pixelsPerUnit, unit, targetWidth, }: ScaleIndicatorProps): react.JSX.Element;
+
+/** Props for `<Split>`. */
+interface SplitProps {
+    /** The sidebar pane's contents. */
+    sidebar: ReactNode;
+    /** The edge the sidebar sits on. Read once, when the strip mounts. Default `'start'`. */
+    side?: 'start' | 'end';
+    /** The content pane's contents. */
+    children: ReactNode;
+    /** Names the sidebar pane, and through it the seam. Default `'Sidebar'`. */
+    label?: string;
+    /** Extra classes on the strip, which always has `lk-split`. */
+    className?: string;
+    /** The class on the sidebar pane. */
+    sidebarClassName?: string;
+    /** The class on the content pane. */
+    contentClassName?: string;
+    /** The sidebar's current extent in pixels. Omit to leave it unpersisted: the
+     *  seam still works, its result just does not outlive the mount. */
+    width?: number;
+    /** Where the sidebar starts before anyone drags it. */
+    defaultWidth?: number;
+    minWidth?: number;
+    maxWidth?: number;
+    /** How little the content pane may be squeezed to. Reported as the seam's
+     *  reachable maximum, so the drag stops there rather than clamping silently. */
+    contentMinWidth?: number;
+    /** Fires through the drag, not on release: the pane is already there. */
+    onWidthChange?: (width: number) => void;
+    /**
+     * Fixed extent. Omit in an app — the strip measures its own box. Supply it
+     * where nothing measures, notably jsdom, or both panes lay out at zero.
+     */
+    viewport?: {
+        w: number;
+        h: number;
+    };
+}
+/**
+ * A sidebar and a content pane as a two-pane strip with a draggable seam.
+ *
+ * The seam is `stripStrategy`'s own resize affordance, so it arrives as a
+ * `role="separator"` carrying the reachable range, operable by pointer and by
+ * arrows / Home / End, and clamped against the content pane's floor rather
+ * than against the sidebar's alone.
+ */
+declare function Split({ sidebar, children, side, label, className, sidebarClassName, contentClassName, width, defaultWidth, minWidth, maxWidth, contentMinWidth, onWidthChange, viewport, }: SplitProps): react.JSX.Element;
+
+/** Props for `<StatusBar>`. */
+interface StatusBarProps {
+    children: ReactNode;
+}
+/** A footer strip for readouts. Fill it with `<StatusBar.Section>`. */
+declare function StatusBar({ children }: StatusBarProps): react.JSX.Element;
+declare namespace StatusBar {
+    var Section: ({ children, end }: StatusBarSectionProps) => react.JSX.Element;
+}
+/** Props for `<StatusBar.Section>`. */
+interface StatusBarSectionProps {
+    children: ReactNode;
+    /** Pushes this section, and everything after it, to the far end. */
+    end?: boolean;
+}
+
+/** Props for `<Toolbar>`. */
+interface ToolbarProps {
+    children: ReactNode;
+    /** Names the toolbar for assistive tech. Required by the APG pattern when a
+     *  view holds more than one. */
+    'aria-label'?: string;
+}
+/** A horizontal bar of controls. Fill it with `<Toolbar.Title>`,
+ *  `<Toolbar.Group>`, `<Toolbar.Button>` and `<Toolbar.Spacer>`. */
+declare function Toolbar({ children, 'aria-label': ariaLabel }: ToolbarProps): react.JSX.Element;
+declare namespace Toolbar {
+    var Title: ({ children }: TitleProps) => react.JSX.Element;
+    var Group: ({ children, end, "aria-label": ariaLabel }: ToolbarGroupProps) => react.JSX.Element;
+    var Button: ({ children, onClick, disabled, title, "aria-label": ariaLabel, variant, iconOnly, pressed, }: ToolbarButtonProps) => react.JSX.Element;
+    var Spacer: () => react.JSX.Element;
+}
+interface TitleProps {
+    children: ReactNode;
+}
+/** Props for `<Toolbar.Group>`. */
+interface ToolbarGroupProps {
+    children: ReactNode;
+    /** Pushes this group, and everything after it, to the far end. */
+    end?: boolean;
+    'aria-label'?: string;
+}
+/** Props for `<Toolbar.Button>`. */
+interface ToolbarButtonProps {
+    children: ReactNode;
+    onClick: MouseEventHandler<HTMLButtonElement>;
+    disabled?: boolean;
+    title?: string;
+    /** Required when `children` is an icon with no text of its own. */
+    'aria-label'?: string;
+    /** `danger` reddens on hover — for actions that discard work. */
+    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>`. */
+interface ZoomControlProps {
+    /** Current zoom as a scale factor: 1 is actual size. */
+    zoom: number;
+    /** Fired continuously while the slider drags. */
+    onZoomChange: (zoom: number) => void;
+    /** Fired when a drag settles or the field is committed. Defaults to
+     *  `onZoomChange`. */
+    onZoomCommit?: (zoom: number) => void;
+    /** Smallest selectable zoom. Defaults to 0.1 (10%). */
+    min?: number;
+    /** Largest selectable zoom. Defaults to 8 (800%). */
+    max?: number;
+    className?: string;
+}
+/** Zoom as a log-scaled slider with an editable percentage beside it. Pair it
+ *  with zoom-in / zoom-out buttons in a `<Toolbar.Group>`; this component owns
+ *  only the continuous part. */
+declare function ZoomControl({ zoom, onZoomChange, onZoomCommit, min: minProp, max: maxProp, className, }: ZoomControlProps): react.JSX.Element;
+
+export { FpsMeter, JobProgress, Legend, Readout, ScaleIndicator, Split, StatusBar, Toolbar, ZoomControl };
+export type { JobProgressProps, LegendEntry, LegendMark, LegendProps, ReadoutProps, ReadoutRow, ScaleIndicatorProps, SplitProps, StatusBarProps, StatusBarSectionProps, ToolbarButtonProps, ToolbarGroupProps, ToolbarProps, ZoomControlProps };

package/dist/primitives/index.js

@@ -1,11 +1,12 @@
-export { JobProgress, Legend, Readout, Split } from '../chunk-FMK7UQ6V.js';
-export { FloatingPanel } from '../chunk-J7OWWTCW.js';
-export { FpsMeter, ScaleIndicator, StatusBar, Toolbar, ZoomControl } from '../chunk-7BO7HNGF.js';
+export { JobProgress, Legend, Readout, Split } from '../chunk-FB4MIZOO.js';
+export { FloatingPanel } from '../chunk-XE5HJOPL.js';
+export { FpsMeter, ScaleIndicator, StatusBar, Toolbar, ZoomControl } from '../chunk-CEGFXTBD.js';
 import '../chunk-CZZPXUOU.js';
-import '../chunk-RWNDDKOH.js';
-import '../chunk-CQLQPQ4P.js';
+import '../chunk-PMLZP7RT.js';
+import '../chunk-ZQIHJXP4.js';
 import '../chunk-2YILQ7Y5.js';
-import '../chunk-MIM5R4ZT.js';
-import '../chunk-275JRRVD.js';
+import '../chunk-4KSC7NXL.js';
+import '../chunk-E23Q6A3Y.js';
+import '../chunk-XVUKDSYV.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/state/index.d.ts

@@ -1,13 +1,15 @@
-export { C as CURRENT_DOCUMENT_VERSION, I as IndexedDbAdapterOptions, L as LabStore, a as LabStoreActions, b as LabStoreContext, c as LabStoreProvider, O as OpenLabStoreOptions, d as OpenedLabStore, P as PersistedStateOptions, e as Persistence, f as PersistenceProps, R as RecordCache, g as RecordChange, T as TrialIdContext, h as TrialIdProvider, i as createIndexedDbAdapter, j as createLabStore, k as createMemoryAdapter, l as indexedDbAdapter, m as labDocumentKey, n as localStorageAdapter, o as noneAdapter, p as openLabStore, q as quarantineKey, s as sessionStorageAdapter, u as urlHashAdapter, r as useLabStore, t as usePersistedState, v as useTrialId, w as useTrialState } from '../_dts/useTrialState-CTZPgeZ7.js';
-import { S as SerializedTrial, I as InstrumentSerializers, T as TrialRecord, U as UndoStack, c as StorageAdapter } from '../_dts/types-CSm9jgol.js';
-export { C as CreateLabStoreOptions, d as LabDocument, e as LabStoreState, M as Migration, f as SavedSnapshot, g as StorageChange, h as TrialStateHandle, i as UndockedPanel, j as UndockedPanels, k as dockPanel, p as panelKey, u as undockPanel } from '../_dts/types-CSm9jgol.js';
+export { C as CURRENT_DOCUMENT_VERSION, I as IndexedDbAdapterOptions, L as LabStore, a as LabStoreActions, b as LabStoreContext, c as LabStoreProvider, O as OpenLabStoreOptions, d as OpenedLabStore, P as PersistedStateOptions, e as Persistence, f as PersistenceProps, R as RecordCache, g as RecordChange, T as TrialIdContext, h as TrialIdProvider, i as createIndexedDbAdapter, j as createLabStore, k as createMemoryAdapter, l as indexedDbAdapter, m as labDocumentKey, n as localStorageAdapter, o as noneAdapter, p as openLabStore, q as quarantineKey, s as sessionStorageAdapter, u as urlHashAdapter, r as useLabStore, t as usePersistedState, v as useTrialId, w as useTrialState } from '../_dts/useTrialState-Bh8bzFgE.js';
+import { S as SerializedTrial, I as InstrumentSerializers, T as TrialRecord, U as UndoStack, c as StorageAdapter } from '../_dts/index-DCMA4Fy1.js';
+export { C as CreateLabStoreOptions, L as LabDocument, d as LabStoreState, M as Migration, e as SavedSnapshot, f as StorageChange, g as TrialStateHandle, h as UndockedPanel, i as UndockedPanels, j as dockPanel, p as panelKey, u as undockPanel } from '../_dts/index-DCMA4Fy1.js';
 import * as react from 'react';
 import { ReactNode } from 'react';
 import 'zustand/vanilla';
+import '@weasel-js/ui';
 import '@weasel-js/core';
-import '../_dts/PrefsRow.d-TOZ7BgD9.js';
 import '@weasel-js/theme';
-import '../_dts/types-CRPSGFAp.js';
+import '../_dts/types-BUBSIZuV.js';
+import '@weasel-js/quantity';
+import '@weasel-js/geom';
 import '../_dts/types-DJ79Tg5J.js';
 
 /** The storage key a lab writes one of its buckets under. Namespaced by

package/dist/state/index.js

@@ -1,9 +1,9 @@
-import { openLabStore } from '../chunk-YT75VYRD.js';
-export { CURRENT_DOCUMENT_VERSION, createLabStore, dockPanel, labDocumentKey, openLabStore, panelKey, quarantineKey, undockPanel, useTrialState } from '../chunk-YT75VYRD.js';
-import { useWarnIgnoredChange, useOpenOnce, defaultStorage, PersistenceContext } from '../chunk-RWNDDKOH.js';
-export { Persistence, createIndexedDbAdapter, createMemoryAdapter, decodeUrlHash, deserializeTrials, emptyUndoStack, encodeUrlHash, indexedDbAdapter, labStorageKey, localStorageAdapter, noneAdapter, serializeTrials, sessionStorageAdapter, urlHashAdapter, usePersistedState } from '../chunk-RWNDDKOH.js';
-import '../chunk-FZ7YFQN7.js';
-import '../chunk-Y23G2VZL.js';
+import { openLabStore } from '../chunk-IBVRMHW5.js';
+export { CURRENT_DOCUMENT_VERSION, createLabStore, dockPanel, labDocumentKey, openLabStore, panelKey, quarantineKey, undockPanel, useTrialState } from '../chunk-IBVRMHW5.js';
+import { useWarnIgnoredChange, useOpenOnce, defaultStorage, PersistenceContext } from '../chunk-PMLZP7RT.js';
+export { Persistence, createIndexedDbAdapter, createMemoryAdapter, decodeUrlHash, deserializeTrials, emptyUndoStack, encodeUrlHash, indexedDbAdapter, labStorageKey, localStorageAdapter, noneAdapter, serializeTrials, sessionStorageAdapter, urlHashAdapter, usePersistedState } from '../chunk-PMLZP7RT.js';
+import '../chunk-YCFKW5RX.js';
+import '../chunk-READTDQX.js';
 import { LabStoreProvider, TrialIdProvider } from '../chunk-2YILQ7Y5.js';
 export { LabStoreContext, LabStoreProvider, TrialIdContext, TrialIdProvider, useLabStore, useTrialId } from '../chunk-2YILQ7Y5.js';
 import { jsx, Fragment } from 'react/jsx-runtime';