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

package/dist/passthrough/weasel-ui.js

@@ -1,4 +1,4 @@
-export { m as ActionBar, r3 as ActionsBar, Ft as Badge, a as Button, o3 as Checkbox, p4 as ComboBox, m2 as ComboBoxItem, F as CurveEditor, u as DataGrid, c3 as Dialog, qe as EDGE_PROFILES, n as Field, u3 as Input, s as KeyCap, c2 as KeySequence, o2 as MINUS_SIGN, f2 as NumberField, r2 as OptionsBar, _ as Plot2D, n4 as PointPlotter, r4 as Powerline, u4 as Radio, l as RadioGroup, l2 as RangeSlider, p3 as Select, h as SelectItem, n2 as Sidebar, o4 as SidebarPanel, v as Slider, a3 as Switch, c4 as Tab, s3 as TabList, l3 as TabPanel, o6 as Tabs, r as ToggleBar, o5 as ToolButton, n3 as ToolGroup, _2 as ToolPalette, He as chromaAt, u2 as detectPlatform, p as dlog, r5 as fieldClasses, s2 as formatNumber, d2 as formatShortcut, u5 as formatShortcutParts, o as inferKeycapKind, f as isDebugEnabled, e as keyGlyph, p2 as keySpecFromKey, d as keySpecsFromMods, Ve as oklchToHex, p5 as paintGradientTrack, c as useReorderDragList, a2 as useRovingTabIndex } from '../chunk-73KA7WBO.js';
-import '../chunk-BOHF3PQO.js';
+export { m as ActionBar, r4 as ActionsBar, It as Badge, a3 as Button, o2 as Checkbox, p4 as ComboBox, m2 as ComboBoxItem, F as CurveEditor, u3 as DataGrid, c as Dialog, Je as EDGE_PROFILES, n as Field, u as Input, s2 as KeyCap, c3 as KeySequence, o as MINUS_SIGN, f2 as NumberField, r3 as OptionsBar, _ as Plot2D, n4 as PointPlotter, r5 as Powerline, u2 as Radio, l as RadioGroup, l2 as RangeSlider, p2 as Select, h as SelectItem, n2 as Sidebar, o4 as SidebarPanel, v as Slider, a2 as Switch, c4 as Tab, s3 as TabList, l3 as TabPanel, o6 as Tabs, r as ToggleBar, o5 as ToolButton, n3 as ToolGroup, _2 as ToolPalette, tn as chromaAt, u4 as detectPlatform, p as dlog, r2 as fieldClasses, s as formatNumber, d2 as formatShortcut, u5 as formatShortcutParts, o3 as inferKeycapKind, f as isDebugEnabled, b as isPrefLeaf, e as keyGlyph, p3 as keySpecFromKey, d as keySpecsFromMods, en as oklchToHex, v2 as paintGradientTrack, x as prefValueAtPath, c2 as useReorderDragList, a as useRovingTabIndex, S as visiblePrefSubtree } from '../chunk-TLGRYALP.js';
+import '../chunk-Z6HJ5FEM.js';
 //# sourceMappingURL=weasel-ui.js.map
 //# sourceMappingURL=weasel-ui.js.map

package/dist/primitives/index.d.ts

@@ -1,9 +1,62 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, MouseEventHandler } from 'react';
+import { Corner } from 'windease';
+import { J as JobHandle } from '../_dts/types-DJ79Tg5J.js';
+
+/** Props for `<FloatingPanel>`. */
+interface FloatingPanelProps {
+    children: ReactNode;
+    /** Corner it rests in before it has ever been dragged. Default `'bottom-left'`. */
+    anchor?: Corner;
+    /** Corners that may capture it. Default: all four. */
+    snapCorners?: readonly Corner[];
+    /** Pixels in from a corner when snapped. Default 12. */
+    inset?: number;
+    /** localStorage key to remember its position under. Omit to forget on reload. */
+    storageKey?: string;
+    className?: string;
+}
+/**
+ * A draggable box that floats over its offset parent and snaps to its corners.
+ *
+ * Drives windease's `floatingStrategy` as a pure function rather than mounting a
+ * windease container: a lab overlay has one item and no zone tree, so the node
+ * model would be all cost. Pointer handling is therefore this component's, and
+ * windease's own affordance rendering never participates.
+ */
+declare function FloatingPanel({ children, anchor, snapCorners, inset, storageKey, className, }: FloatingPanelProps): react_jsx_runtime.JSX.Element;
 
 /** A live frame-rate readout, averaged over the last 30 frames. */
 declare function FpsMeter(): react_jsx_runtime.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_runtime.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_runtime.JSX.Element;
+
 /** Props for `<ScaleIndicator>`. */
 interface ScaleIndicatorProps {
     /** Current view zoom factor. If omitted, reads from CanvasStackContext. Defaults to 1. */
@@ -38,33 +91,74 @@ interface StatusBarProps {
 /** A footer strip for readouts. Fill it with `<StatusBar.Section>`. */
 declare function StatusBar({ children }: StatusBarProps): react_jsx_runtime.JSX.Element;
 declare namespace StatusBar {
-    var Section: ({ children }: SectionProps) => react_jsx_runtime.JSX.Element;
+    var Section: ({ children, end }: StatusBarSectionProps) => react_jsx_runtime.JSX.Element;
 }
-interface SectionProps {
+/** 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.Button>` and `<Toolbar.Spacer>`. */
-declare function Toolbar({ children }: ToolbarProps): react_jsx_runtime.JSX.Element;
+ *  `<Toolbar.Group>`, `<Toolbar.Button>` and `<Toolbar.Spacer>`. */
+declare function Toolbar({ children, 'aria-label': ariaLabel }: ToolbarProps): react_jsx_runtime.JSX.Element;
 declare namespace Toolbar {
     var Title: ({ children }: TitleProps) => react_jsx_runtime.JSX.Element;
-    var Button: ({ children, onClick, disabled, title }: ButtonProps) => 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 Spacer: () => react_jsx_runtime.JSX.Element;
 }
 interface TitleProps {
     children: ReactNode;
 }
-interface ButtonProps {
+/** 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;
+}
+
+/** 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, max, className, }: ZoomControlProps): react_jsx_runtime.JSX.Element;
 
-export { FpsMeter, ScaleIndicator, Sidebar, StatusBar, Toolbar };
-export type { ScaleIndicatorProps, SidebarProps, StatusBarProps, ToolbarProps };
+export { FloatingPanel, FpsMeter, JobProgress, Legend, ScaleIndicator, Sidebar, StatusBar, Toolbar, ZoomControl };
+export type { FloatingPanelProps, JobProgressProps, LegendEntry, LegendMark, LegendProps, ScaleIndicatorProps, SidebarProps, StatusBarProps, StatusBarSectionProps, ToolbarButtonProps, ToolbarGroupProps, ToolbarProps, ZoomControlProps };

package/dist/primitives/index.js

@@ -1,4 +1,7 @@
-export { FpsMeter, ScaleIndicator, Sidebar, StatusBar, Toolbar } from '../chunk-PMAU3SEE.js';
+export { FloatingPanel, JobProgress, Legend, Sidebar } from '../chunk-RVNN4CHQ.js';
+export { FpsMeter, ScaleIndicator, StatusBar, Toolbar, ZoomControl } from '../chunk-O7NVSCLN.js';
+import '../chunk-TLGRYALP.js';
 import '../chunk-CPUJ3QXL.js';
+import '../chunk-Z6HJ5FEM.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/state/index.d.ts

@@ -1,5 +1,6 @@
-import { S as SerializedTrial, I as InstrumentSerializers, T as TrialRecord, U as UndoStack, a as StorageAdapter } from '../_dts/useTrialState-BMNIx3Cy.js';
-export { C as CURRENT_DOCUMENT_VERSION, b as CreateLabStoreOptions, L as LabDocument, c as LabStore, d as LabStoreActions, e as LabStoreContext, f as LabStoreProvider, g as LabStoreState, M as Migration, h as SavedSnapshot, i as TrialIdContext, j as TrialIdProvider, k as TrialStateHandle, l as createLabStore, m as createMemoryAdapter, n as labDocumentKey, o as localStorageAdapter, p as noneAdapter, q as quarantineKey, s as sessionStorageAdapter, u as urlHashAdapter, r as useLabStore, t as useTrialId, v as useTrialState } from '../_dts/useTrialState-BMNIx3Cy.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-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';
 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-VUU5UXHE.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-VUU5UXHE.js';
+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 { useRef } from 'react';
 import { jsx } from 'react/jsx-runtime';