@weasel-js/labkit 1.4.3 → 1.5.0

package/src/trial/TrialBody.tsx

@@ -1,14 +1,9 @@
-import { type ReactNode, useEffect, useMemo, useRef } from 'react';
-import { asNodeId, createNode, Store, stripStrategy } from 'windease';
-import { type ChromeMap, Container, Provider, StrategyRegistryProvider } from 'windease/react';
-
-const ZONE_ID = asNodeId('lk-trial-body');
-const SIDEBAR_ID = asNodeId('lk-trial-sidebar');
-const CONTENT_ID = asNodeId('lk-trial-content');
-const STRATEGIES = { strip: stripStrategy as never };
+import type { ReactNode } from 'react';
+import { Split, type SplitProps } from '../primitives/Split';
 
 /** Props for `<TrialBody>`. */
-export interface TrialBodyProps {
+export interface TrialBodyProps
+  extends Omit<SplitProps, 'sidebar' | 'children' | 'className' | 'sidebarClassName' | 'label'> {
   /** The sidebar region's sections. */
   sidebar: ReactNode;
   /** The instrument's own output. */
@@ -16,140 +11,21 @@ export interface TrialBodyProps {
   /** Extra class on the content pane — `Trial` marks a canvas instrument's
    *  well flush. */
   contentClassName?: string;
-  /** The sidebar's current extent in pixels. Omit for an unpersisted lab: 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 instrument 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 trial's sidebar and content 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.
- */
-export function TrialBody({
-  sidebar,
-  children,
-  contentClassName,
-  width,
-  defaultWidth = 320,
-  minWidth = 140,
-  maxWidth = 720,
-  contentMinWidth = 160,
-  onWidthChange,
-  viewport,
-}: TrialBodyProps) {
-  // The cross-axis half of every size hint below is inert: a horizontal strip
-  // stretches its panes to the container's height and never reads `h`.
-  const storeRef = useRef<Store | null>(null);
-  if (storeRef.current === null) {
-    const store = new Store();
-    store.registerNode(
-      createNode({
-        kind: 'zone',
-        id: ZONE_ID,
-        container: { strategyId: 'strip', config: { axis: 'x', resizable: true } },
-      }),
-    );
-    store.registerNode(
-      createNode({
-        kind: 'sidebar',
-        id: SIDEBAR_ID,
-        parentId: ZONE_ID,
-        meta: { title: 'Sidebar' },
-        placement: { size: { w: width ?? defaultWidth } },
-        hints: { minSize: { w: minWidth, h: 0 }, maxSize: { w: maxWidth, h: 0 } },
-      }),
-    );
-    store.registerNode(
-      createNode({
-        kind: 'content',
-        id: CONTENT_ID,
-        parentId: ZONE_ID,
-        meta: { title: 'Content' },
-        hints: { minSize: { w: contentMinWidth, h: 0 } },
-      }),
-    );
-    store.showNode(SIDEBAR_ID);
-    store.showNode(CONTENT_ID);
-    storeRef.current = store;
-  }
-  const store = storeRef.current;
-
-  // What the store last held, so the placement event can tell a drag from the
-  // echo of our own write and a controlled `width` does not fight the seam.
-  const widthRef = useRef(width ?? defaultWidth);
-
-  useEffect(() => {
-    store.setHints(SIDEBAR_ID, {
-      minSize: { w: minWidth, h: 0 },
-      maxSize: { w: maxWidth, h: 0 },
-    });
-    store.setHints(CONTENT_ID, { minSize: { w: contentMinWidth, h: 0 } });
-  }, [store, minWidth, maxWidth, contentMinWidth]);
-
-  useEffect(() => {
-    if (width === undefined || width === widthRef.current) return;
-    widthRef.current = width;
-    store.patchPlacement(SIDEBAR_ID, { size: { w: width } });
-  }, [store, width]);
-
-  const onWidthChangeRef = useRef(onWidthChange);
-  onWidthChangeRef.current = onWidthChange;
-  useEffect(
-    () =>
-      store.events.on('node.placementChanged', () => {
-        const next = (store.getPlacement(SIDEBAR_ID)?.size as { w?: number } | undefined)?.w;
-        if (typeof next !== 'number' || next === widthRef.current) return;
-        widthRef.current = next;
-        onWidthChangeRef.current?.(next);
-      }),
-    [store],
-  );
-
-  const chrome = useMemo<ChromeMap>(
-    () => ({
-      sidebar: () => <div className="lk-trial__sidebar">{sidebar}</div>,
-      content: () => (
-        <div
-          className={
-            contentClassName ? `lk-trial__content ${contentClassName}` : 'lk-trial__content'
-          }
-        >
-          {children}
-        </div>
-      ),
-    }),
-    [sidebar, children, contentClassName],
-  );
-
+/** A trial's sidebar and content as a `Split`, wearing the trial's classes. */
+export function TrialBody({ sidebar, children, contentClassName, ...rest }: TrialBodyProps) {
   return (
-    <Provider store={store}>
-      <StrategyRegistryProvider strategies={STRATEGIES}>
-        <Container
-          parentId={ZONE_ID}
-          chrome={chrome}
-          className="lk-trial__panes windease-zone"
-          affordances
-          viewport={viewport}
-        />
-      </StrategyRegistryProvider>
-    </Provider>
+    <Split
+      {...rest}
+      sidebar={sidebar}
+      className="lk-trial__panes"
+      sidebarClassName="lk-trial__sidebar"
+      contentClassName={
+        contentClassName ? `lk-trial__content ${contentClassName}` : 'lk-trial__content'
+      }
+    >
+      {children}
+    </Split>
   );
 }

package/src/trial/TrialChrome.tsx

@@ -17,7 +17,7 @@ import { useLabContext } from '../lab/LabContext';
 import { JobProgress } from '../primitives/JobProgress';
 import { LabStoreContext } from '../state/context';
 import type { TrialRecord } from '../state/types';
-import { as2DView } from '../state/view';
+import { as2DView, withZoom } from '../state/view';
 import { TrialBody } from './TrialBody';
 import { TrialTitleBar } from './TrialTitleBar';
 import { UndockedSections } from './UndockedSections';
@@ -111,13 +111,13 @@ export function TrialChrome({
 
   const configSchema = useConfigSchema(instrument);
 
-  const title = record.title ?? record.instrumentName;
+  const title = record.title ?? instrument.title ?? instrument.name;
   const collapsedSections = record.collapsedSections ?? NO_SECTIONS;
 
   const ctx = useMemo<TrialChromeContext>(() => {
     const setZoom = (z: number): void => {
       if (!view2d) return;
-      updateTrialView(trialId, { ...view2d, zoom: z });
+      updateTrialView(trialId, withZoom(view2d, z));
     };
     return {
       trialId,
@@ -225,6 +225,7 @@ export function TrialChrome({
   return (
     <section
       className="lk-trial"
+      data-trial-id={trialId}
       aria-label={`Trial ${title}`}
       tabIndex={-1}
       onKeyDown={handleKeyDown}
@@ -243,7 +244,9 @@ export function TrialChrome({
         <TrialBody
           width={record.sidebarWidth}
           onWidthChange={(w) => updateTrialSidebarWidth(trialId, w)}
-          contentClassName={instrument.canvas ? 'lk-trial__content--flush' : undefined}
+          contentClassName={
+            instrument.canvas || instrument.stage ? 'lk-trial__content--flush' : undefined
+          }
           sidebar={
             <>
               <SidebarRegion contributions={inRegion('sidebar')} ctx={ctx} />

package/src/trial/trialOps.ts

@@ -1,5 +1,6 @@
 import { fillConfigDefaults } from '../config/path';
 import type { Instrument, InstrumentList } from '../instrument/types';
+import { newId } from '../state/helpers';
 import type { TrialRecord } from '../state/types';
 
 const DEFAULT_VIEW = { zoom: 1, pan: { x: 0, y: 0 } } as const;
@@ -13,10 +14,12 @@ function findInstrument(instruments: InstrumentList, name: string): Instrument {
 }
 
 function initialView(instrument: Instrument): TrialRecord['view'] {
-  const declared = instrument.canvas?.initialView;
+  const stage = instrument.canvas ? undefined : instrument.stage;
+  const declared = instrument.canvas?.initialView ?? stage?.initialView;
   // A function needs the canvas size, which no trial has at creation. `null`
   // is the unplaced marker; `Trial` resolves it on the first non-empty size.
-  if (typeof declared === 'function') return null;
+  // A stage that names no view is fitted, which needs that size too.
+  if (typeof declared === 'function' || (stage && declared === undefined)) return null;
   return declared ? structuredClone(declared) : { ...DEFAULT_VIEW, pan: { ...DEFAULT_VIEW.pan } };
 }
 
@@ -47,7 +50,7 @@ export function addTrial(
   const config = seedConfig(instrument.defaultConfig(), options.config);
   const state = instrument.initialState(config);
   const record: TrialRecord = {
-    id: crypto.randomUUID(),
+    id: newId(),
     instrumentName,
     config,
     state,
@@ -66,7 +69,7 @@ export function cloneTrial(trials: TrialRecord[], id: string): TrialRecord[] {
   if (!source) return trials;
   const clone: TrialRecord = {
     ...source,
-    id: crypto.randomUUID(),
+    id: newId(),
     config: structuredClone(source.config),
     state: structuredClone(source.state),
     view: structuredClone(source.view),

package/dist/_dts/types-BP2OCcpg.d.ts

@@ -1,155 +0,0 @@
-import { C as ConfigPath, V as ValueAtPath } from './types-B9_zrHmb.js';
-
-/** A sidebar section torn out of its trial, and where it went. */
-interface UndockedPanel {
-    trialId: string;
-    sectionId: string;
-    as: 'tile' | 'floating';
-}
-/** Undocked panels, keyed by {@link panelKey}. */
-type UndockedPanels = Record<string, UndockedPanel>;
-declare function panelKey(trialId: string, sectionId: string): string;
-declare function undockPanel(panels: UndockedPanels, trialId: string, sectionId: string, as?: UndockedPanel['as']): UndockedPanels;
-/** Dock one section back, or — with no `sectionId` — every panel the trial
- *  owns, which is what closing a trial wants. */
-declare function dockPanel(panels: UndockedPanels, trialId: string, sectionId?: string): UndockedPanels;
-
-/** A trial's undo history, as snapshots of its state either side of the
- *  present. */
-interface UndoStack {
-    past: unknown[];
-    future: unknown[];
-}
-/** The trial a per-trial call is coming from. `id` is the id `useTileId`
- *  scopes a surface tile under, so a consumer keying its own per-trial
- *  registry and labkit's tiles agree on the key. */
-interface TrialInfo<TV = unknown> {
-    id: string;
-    /** The trial's view, in whatever shape the instrument keeps it. */
-    view: TV;
-}
-/** One trial as the store holds it: which instrument it runs, that
- *  instrument's config and state, the camera, and the undo history. */
-interface TrialRecord<TS = unknown, TC = unknown, TV = unknown> {
-    id: string;
-    instrumentName: string;
-    config: TC;
-    state: TS;
-    /** Opaque to labkit: persisted, restored on Reset and handed to the instrument,
-     *  but never read into. A 3D lab puts an orbit here and keeps all three. */
-    view: TV;
-    /** The config `addTrial` opened this trial on, overlaid on the instrument's
-     *  defaults. Kept so Reset restores the trial's own subject rather than the
-     *  bare defaults. */
-    configSeed?: Partial<TC>;
-    /** This trial's own tool slot. Undefined means it reads the lab's. */
-    activeToolId?: string | null;
-    /** The extent the trial's sidebar was last dragged to, in pixels. Undefined
-     *  until someone moves the seam. */
-    sidebarWidth?: number;
-    /** What the title bar reads. Undefined — the state a trial opens in, and the
-     *  one `setTitle(null)` returns it to — means the instrument's name. */
-    title?: string | null;
-    /** Which of the trial's collapsible sections are folded, keyed as
-     *  `TrialChromeContext.collapsedSections` describes. A key that is absent
-     *  takes the section's own default. */
-    collapsedSections?: Record<string, boolean>;
-    /** The marks on this trial's annotation targets, as `AnnotationsApi.toJSON`
-     *  wrote them. Opaque here, and absent for a trial whose instrument declares
-     *  no `annotations` — or declares its own `storage`. Not in `state`, which
-     *  belongs to the instrument and is typed as such. */
-    annotations?: unknown;
-    undoStack: UndoStack;
-}
-/** A named, saved copy of a trial's config and state, restorable into any
- *  trial running the same instrument. */
-interface SavedSnapshot {
-    id: string;
-    name: string;
-    trialId: string;
-    instrumentName: string;
-    config: unknown;
-    state: unknown;
-    savedAt: number;
-}
-/** `auto` follows the OS; the other two are an explicit choice. */
-type LabMode = 'auto' | 'light' | 'dark';
-/** Everything a lab persists: its trials, its saved snapshots, and the
- *  chosen color mode. */
-interface LabStoreState {
-    trials: TrialRecord[];
-    savedSnapshots: SavedSnapshot[];
-    mode: LabMode;
-    /** The lab's tool slot — what a trial with no slot of its own resolves to. */
-    activeToolId: string | null;
-    /** Per-trial tile extents, keyed by trial id. Opaque here — the
-     *  shape belongs to whatever lays the trials out. */
-    layout: Record<string, unknown>;
-    /** Sidebar sections torn out of their trial. A panel here is not rendered in
-     *  its trial's sidebar; the workspace renders it instead. */
-    undockedPanels: UndockedPanels;
-}
-/** Where a lab persists itself. Implementations are keyed string storage and
- *  nothing more, so the same store works against localStorage, the URL hash,
- *  or memory. */
-interface StorageAdapter {
-    read(key: string): string | null;
-    write(key: string, value: string): void;
-    delete?(key: string): void;
-}
-/** What `useTrialState` hands an instrument: its state and config, with
- *  a setter for each. */
-interface TrialStateHandle<TS, TC> {
-    state: TS;
-    setState: (next: TS | ((prev: TS) => TS)) => void;
-    config: TC;
-    /** Write one config value, by dotted path — `'grid.size'` for a leaf under
-     *  an `f.group`, `'cellSize'` for one at the root. */
-    setConfig: <P extends ConfigPath<TC> & string>(path: P, value: ValueAtPath<TC, P>) => void;
-}
-/** Options for `createLabStore`. `storageKey` namespaces the keys written, so
- *  two labs on one origin do not collide. */
-interface CreateLabStoreOptions {
-    storageKey: string;
-    storage: StorageAdapter;
-    initialMode?: LabMode;
-    /** Each instrument's default config, keyed by instrument name, used to fill
-     *  the gaps in a stored one. A config saved before its schema grew a branch
-     *  arrives holding that branch's defaults rather than `undefined`, and keeps
-     *  whatever keys the schema has since stopped naming. `<Lab>` collects these
-     *  off its `instruments`. */
-    configDefaults?: Record<string, () => unknown>;
-    /** How each instrument's state survives a reload. Hydration is the first
-     *  thing `createLabStore` does, so these have to arrive with the store —
-     *  anything registered afterwards is already too late to read the document
-     *  it was built from. `<Lab>` collects them off its `instruments`. */
-    serializers?: InstrumentSerializers;
-}
-/** Per-instrument serialize/deserialize hooks, keyed by instrument name. An
- *  instrument whose state is already JSON-safe needs no entry. `deserialize`
- *  is handed the config the state was saved against — a trial's own for a
- *  reload, the snapshot's for a load — since a state rebuilt without it can
- *  disagree with the settings sitting next to it. */
-type InstrumentSerializers = Record<string, {
-    serialize?: (state: unknown) => unknown;
-    deserialize?: (data: unknown, config: unknown) => unknown;
-} | undefined>;
-/** A trial as it is persisted: everything but the undo history, which is
- *  session-only. */
-type SerializedTrial = Omit<TrialRecord, 'undoStack'>;
-/** Everything a lab persists, under one key, at a known version. */
-interface LabDocument {
-    version: number;
-    trials: SerializedTrial[];
-    saves: SavedSnapshot[];
-    layout: Record<string, unknown>;
-    /** Sidebar sections torn out of their trial, keyed by trial and section. */
-    undockedPanels: UndockedPanels;
-    mode: LabMode;
-}
-/** Migrates a document one version forward. Index `i` in the chain takes a
- *  version-`i` document to version `i + 1`. */
-type Migration = (doc: Record<string, unknown>) => Record<string, unknown>;
-
-export { dockPanel as g, panelKey as p, undockPanel as u };
-export type { CreateLabStoreOptions as C, InstrumentSerializers as I, LabDocument as L, Migration as M, SerializedTrial as S, TrialRecord as T, UndoStack as U, StorageAdapter as a, LabStoreState as b, SavedSnapshot as c, TrialStateHandle as d, UndockedPanel as e, UndockedPanels as f, LabMode as h, TrialInfo as i };

package/dist/_dts/types-x92Kfeme.d.ts

@@ -1,62 +0,0 @@
-/** Which control a config field is edited with. */
-type ConfigFieldType = 'slider' | 'checkbox' | 'select' | 'number' | 'text' | 'color';
-/** What every config field carries: the config key it writes, the label shown
- *  beside it, and which control renders it. */
-interface ConfigFieldBase {
-    key: string;
-    label: string;
-    type: ConfigFieldType;
-}
-/** A bounded number edited by dragging. */
-interface SliderField extends ConfigFieldBase {
-    type: 'slider';
-    default: number;
-    min: number;
-    max: number;
-    step?: number;
-}
-/** A boolean. */
-interface CheckboxField extends ConfigFieldBase {
-    type: 'checkbox';
-    default: boolean;
-}
-/** One choice in a select field. */
-interface SelectOption {
-    value: string;
-    label: string;
-}
-/** A fixed set of labeled choices. */
-interface SelectField extends ConfigFieldBase {
-    type: 'select';
-    default: string;
-    options: SelectOption[];
-}
-/** A number typed directly, optionally bounded. Use a slider field instead
- *  when the range matters more than the exact value. */
-interface NumberField extends ConfigFieldBase {
-    type: 'number';
-    default: number;
-    min?: number;
-    max?: number;
-    step?: number;
-}
-/** A free-text string. Writes are debounced so typing does not re-run the
- *  instrument on every keystroke. */
-interface TextField extends ConfigFieldBase {
-    type: 'text';
-    default: string;
-    placeholder?: string;
-    maxLength?: number;
-    /** Milliseconds to debounce live setConfig calls. Default 150 ms. Set to 0 to disable. */
-    debounceMs?: number;
-}
-/** A color, as a CSS color string. */
-interface ColorField extends ConfigFieldBase {
-    type: 'color';
-    default: string;
-}
-/** One field of an instrument's config schema. The schema is what the control
- *  panel renders, and what `validateConfigSchema` checks. */
-type ConfigField = SliderField | CheckboxField | SelectField | NumberField | TextField | ColorField;
-
-export type { ConfigField as C, NumberField as N, SelectField as S, TextField as T, CheckboxField as a, ColorField as b, ConfigFieldBase as c, ConfigFieldType as d, SelectOption as e, SliderField as f };

package/dist/_dts/useTrialState-D6Vb3T-g.d.ts

@@ -1,99 +0,0 @@
-import { a as StorageAdapter, b as LabStoreState, T as TrialRecord, c as SavedSnapshot, h as LabMode, e as UndockedPanel, C as CreateLabStoreOptions, d as TrialStateHandle } from './types-BP2OCcpg.js';
-import * as react from 'react';
-import { ReactNode, ReactElement } from 'react';
-import { StoreApi } from 'zustand/vanilla';
-
-/** Persist to `localStorage` — state survives a reload and a new tab. Falls
- *  back to no-ops when storage is unavailable. */
-declare const localStorageAdapter: StorageAdapter;
-/** Persist to `sessionStorage` — state survives a reload but not a new tab. */
-declare const sessionStorageAdapter: StorageAdapter;
-/** Persist into the URL fragment, so the page's link carries its state and
- *  can be shared or bookmarked. */
-declare const urlHashAdapter: StorageAdapter;
-/** An in-memory store, discarded on reload. For tests, and for labs that
- *  should start fresh every time. */
-declare function createMemoryAdapter(): StorageAdapter;
-/** Persists nothing and reads back nothing. */
-declare const noneAdapter: StorageAdapter;
-
-/** Every mutation a lab store supports: managing trials, saving and
- *  restoring snapshots, and setting the color mode. */
-interface LabStoreActions {
-    addTrial: (record: Omit<TrialRecord, 'undoStack'>) => void;
-    removeTrial: (id: string) => void;
-    updateTrialState: <TS>(id: string, next: TS | ((prev: TS) => TS)) => void;
-    /** Write one config value. `path` is dotted for a value nested under an
-     *  `f.group`, and the bare key for one at the root. */
-    updateTrialConfig: (id: string, path: string, value: unknown) => void;
-    updateTrialView: (id: string, view: unknown) => void;
-    updateTrialSidebarWidth: (id: string, width: number) => void;
-    /** Retitle a trial. `null` returns it to its instrument's name. */
-    setTrialTitle: (id: string, title: string | null) => void;
-    /** Fold or unfold one of a trial's sections. */
-    setTrialSectionCollapsed: (id: string, key: string, collapsed: boolean) => void;
-    updateTrialAnnotations: (id: string, doc: unknown) => void;
-    updateTrialUndoStack: (id: string, next: TrialRecord['undoStack'] | ((prev: TrialRecord['undoStack']) => TrialRecord['undoStack'])) => void;
-    setTrialInstrument: (id: string, instrumentName: string) => void;
-    saveSnapshot: (trialId: string, name: string) => void;
-    loadSnapshot: (snapshotId: string, trialId: string) => void;
-    deleteSnapshot: (snapshotId: string) => void;
-    listSnapshots: (trialId?: string) => SavedSnapshot[];
-    setMode: (mode: LabMode) => void;
-    setLabTool: (id: string | null) => void;
-    setTrialTool: (trialId: string, id: string | null) => void;
-    setLayout: (layout: Record<string, unknown>) => void;
-    /** Tear a sidebar section out of its trial. Default target is a workspace tile. */
-    undockPanel: (trialId: string, sectionId: string, as?: UndockedPanel['as']) => void;
-    /** Put one section back, or — with no `sectionId` — every panel the trial owns. */
-    dockPanel: (trialId: string, sectionId?: string) => void;
-}
-/** A lab's store: its state and its actions. How each instrument's state is
- *  serialized comes in through `CreateLabStoreOptions.serializers`. */
-type LabStore = StoreApi<LabStoreState & LabStoreActions>;
-/** Build a lab store, hydrating from storage if anything was saved under the
- *  same key. Writes back are debounced. */
-declare function createLabStore(options: CreateLabStoreOptions): LabStore;
-
-type LabStoreCtx = {
-    store: LabStore;
-} | null;
-/** Context carrying the lab store. Prefer `useLabStore`; this is exported for
- *  code that needs to read the context without subscribing. */
-declare const LabStoreContext: react.Context<LabStoreCtx>;
-/** Provides a lab store to its subtree. */
-declare function LabStoreProvider({ store, children, }: {
-    store: LabStore;
-    children: ReactNode;
-}): ReactElement;
-/** Subscribe to the whole lab store. Throws outside a `<LabStoreProvider>`. */
-declare function useLabStore(): LabStoreState & ReturnType<LabStore['getState']>;
-/** Context carrying which trial the subtree belongs to. */
-declare const TrialIdContext: react.Context<string | null>;
-/** Names the trial its subtree belongs to, so an instrument's hooks can
- *  find their own record in the store without being passed an id. */
-declare function TrialIdProvider({ trialId, children, }: {
-    trialId: string;
-    children: ReactNode;
-}): ReactElement;
-/** The id of the trial this component is inside. Throws outside a
- *  `<TrialIdProvider>`. */
-declare function useTrialId(): string;
-
-/** Bumped whenever the persisted shape changes; every bump needs a migration. */
-declare const CURRENT_DOCUMENT_VERSION = 3;
-/** The one key a lab persists under. The `:doc` suffix keeps it out of the
- *  legacy bucket namespace, where a lab named `a:saves` would otherwise write
- *  its document over lab `a`'s saves bucket. */
-declare function labDocumentKey(storageKey: string): string;
-/** Where a document that failed to migrate is set aside, so a bad migration
- *  loses state loudly rather than silently. */
-declare function quarantineKey(storageKey: string): string;
-
-/** An instrument's own state and config, plus setters. Reads the surrounding
- *  trial id, so an instrument never has to know which trial it is
- *  running in. Throws outside a lab store and trial. */
-declare function useTrialState<TS = unknown, TC = unknown>(): TrialStateHandle<TS, TC>;
-
-export { CURRENT_DOCUMENT_VERSION as C, TrialIdContext as T, LabStoreContext as b, LabStoreProvider as c, TrialIdProvider as d, createLabStore as e, createMemoryAdapter as f, localStorageAdapter as g, useLabStore as h, useTrialId as i, useTrialState as j, labDocumentKey as l, noneAdapter as n, quarantineKey as q, sessionStorageAdapter as s, urlHashAdapter as u };
-export type { LabStore as L, LabStoreActions as a };

package/dist/chunk-2RQPGOQF.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/primitives/useRovingTabIndex.ts","../src/primitives/Toolbar.tsx","../src/primitives/fpsAverage.ts","../src/primitives/FpsMeter.tsx","../src/primitives/ScaleIndicator.tsx","../src/primitives/ZoomControl.tsx","../src/primitives/StatusBar.tsx"],"names":["useRef","useEffect","jsx","jsxs","y","f"],"mappings":"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","file":"chunk-2RQPGOQF.js","sourcesContent":["import { type KeyboardEvent, useCallback, useEffect, useRef } from 'react';\n\n/** Which axis a toolbar's arrow keys walk. Matches `aria-orientation`. */\nexport type RovingOrientation = 'horizontal' | 'vertical';\n\n/** Where a key takes focus within `count` items, or null if it does not move it.\n *\n *  Only the arrows on the toolbar's own axis move focus — APG leaves the\n *  cross-axis arrows to the page, so a vertical strip does not swallow\n *  ArrowLeft. `Home` / `End` work on both. */\nexport function nextIndex(\n  current: number,\n  key: string,\n  count: number,\n  orientation: RovingOrientation = 'horizontal',\n): number | null {\n  if (count === 0) return null;\n  const forward = orientation === 'vertical' ? 'ArrowDown' : 'ArrowRight';\n  const back = orientation === 'vertical' ? 'ArrowUp' : 'ArrowLeft';\n  if (key === forward) return (current + 1) % count;\n  if (key === back) return (current - 1 + count) % count;\n  if (key === 'Home') return 0;\n  if (key === 'End') return count - 1;\n  return null;\n}\n\n/**\n * The APG roving-tabindex contract: exactly one item in the tab order, arrows\n * moving focus within. `tabIndex` is written onto the DOM nodes rather than\n * threaded through props, because the items are arbitrary children — the\n * container never sees them as a list it could index.\n */\nexport function useRovingTabIndex<T extends HTMLElement>(\n  orientation: RovingOrientation = 'horizontal',\n) {\n  const ref = useRef<T | null>(null);\n  const stop = useRef(0);\n\n  const items = useCallback(\n    (): HTMLElement[] =>\n      ref.current\n        ? Array.from(\n            ref.current.querySelectorAll<HTMLElement>('button:not([disabled]), [role=\"button\"]'),\n          )\n        : [],\n    [],\n  );\n\n  const setTabStop = useCallback(\n    (index: number) => {\n      const found = items();\n      const at = Math.min(Math.max(index, 0), Math.max(found.length - 1, 0));\n      stop.current = at;\n      for (const [i, el] of found.entries()) el.tabIndex = i === at ? 0 : -1;\n    },\n    [items],\n  );\n\n  // Re-establish the tab stop whenever the item set changes — a trial's toolbar\n  // contributions are dynamic, and `disabled` moves a button in and out of the\n  // set without touching the child list. The focused item keeps the stop.\n  useEffect(() => {\n    const resync = () => {\n      const focused = items().indexOf(document.activeElement as HTMLElement);\n      setTabStop(focused === -1 ? stop.current : focused);\n    };\n    resync();\n    if (!ref.current) return;\n    const mo = new MutationObserver(resync);\n    mo.observe(ref.current, { childList: true, subtree: true, attributeFilter: ['disabled'] });\n    return () => mo.disconnect();\n  }, [items, setTabStop]);\n\n  const onKeyDown = useCallback(\n    (e: KeyboardEvent<T>) => {\n      const found = items();\n      const current = found.indexOf(document.activeElement as HTMLElement);\n      const next = nextIndex(current === -1 ? 0 : current, e.key, found.length, orientation);\n      if (next === null) return;\n      e.preventDefault();\n      found[next]?.focus();\n      setTabStop(next);\n    },\n    [items, setTabStop, orientation],\n  );\n\n  return { ref, onKeyDown };\n}\n","import type { MouseEventHandler, ReactNode } from 'react';\nimport { useRovingTabIndex } from './useRovingTabIndex';\n\n/** Props for `<Toolbar>`. */\nexport interface ToolbarProps {\n  children: ReactNode;\n  /** Names the toolbar for assistive tech. Required by the APG pattern when a\n   *  view holds more than one. */\n  'aria-label'?: string;\n}\n\n/** A horizontal bar of controls. Fill it with `<Toolbar.Title>`,\n *  `<Toolbar.Group>`, `<Toolbar.Button>` and `<Toolbar.Spacer>`. */\nexport function Toolbar({ children, 'aria-label': ariaLabel }: ToolbarProps) {\n  const { ref, onKeyDown } = useRovingTabIndex<HTMLDivElement>();\n  return (\n    <div\n      ref={ref}\n      className=\"lk-toolbar\"\n      role=\"toolbar\"\n      aria-label={ariaLabel}\n      onKeyDown={onKeyDown}\n    >\n      {children}\n    </div>\n  );\n}\n\ninterface TitleProps {\n  children: ReactNode;\n}\nfunction Title({ children }: TitleProps) {\n  return <span className=\"lk-toolbar-title\">{children}</span>;\n}\n\n/** Props for `<Toolbar.Group>`. */\nexport interface ToolbarGroupProps {\n  children: ReactNode;\n  /** Pushes this group, and everything after it, to the far end. */\n  end?: boolean;\n  'aria-label'?: string;\n}\n\n/** Related controls, kept tight and ruled off from their neighbors. Group\n *  rather than separate with repeated `<Toolbar.Spacer>`: consecutive spacers\n *  share the free space, so every gap collapses to the same slack and the bar\n *  reads as one undifferentiated run. */\nfunction Group({ children, end, 'aria-label': ariaLabel }: ToolbarGroupProps) {\n  return (\n    // biome-ignore lint/a11y/useSemanticElements: a group inside role=\"toolbar\" is the APG pattern; the rule is local and cannot see the parent. <fieldset> means form controls, needs a <legend> to be named, and its UA min-width breaks flex children.\n    <div\n      className={`lk-toolbar-group${end ? ' lk-toolbar-group--end' : ''}`}\n      role=\"group\"\n      aria-label={ariaLabel}\n    >\n      {children}\n    </div>\n  );\n}\n\n/** Props for `<Toolbar.Button>`. */\nexport interface ToolbarButtonProps {\n  children: ReactNode;\n  onClick: MouseEventHandler<HTMLButtonElement>;\n  disabled?: boolean;\n  title?: string;\n  /** Required when `children` is an icon with no text of its own. */\n  'aria-label'?: string;\n  /** `danger` reddens on hover — for actions that discard work. */\n  variant?: 'default' | 'danger';\n  /** Square, for a button whose whole content is one glyph. */\n  iconOnly?: boolean;\n  /** Makes this a toggle: `aria-pressed`, and held down while true. */\n  pressed?: boolean;\n}\n\nfunction Button({\n  children,\n  onClick,\n  disabled,\n  title,\n  'aria-label': ariaLabel,\n  variant = 'default',\n  iconOnly,\n  pressed,\n}: ToolbarButtonProps) {\n  const cls = [\n    'lk-toolbar-button',\n    variant === 'danger' && 'lk-toolbar-button--danger',\n    iconOnly && 'lk-toolbar-button--icon',\n    pressed && 'lk-toolbar-button--pressed',\n  ]\n    .filter(Boolean)\n    .join(' ');\n  return (\n    <button\n      type=\"button\"\n      className={cls}\n      onClick={onClick}\n      disabled={disabled}\n      title={title}\n      aria-label={ariaLabel ?? title}\n      aria-pressed={pressed}\n    >\n      {children}\n    </button>\n  );\n}\n\nfunction Spacer() {\n  return <span className=\"lk-toolbar-spacer\" aria-hidden=\"true\" />;\n}\n\n/** A label within a toolbar. */\nToolbar.Title = Title;\n/** A ruled-off run of related controls. */\nToolbar.Group = Group;\n/** A button within a toolbar. */\nToolbar.Button = Button;\n/** Flexible space that pushes what follows to the far end of the toolbar. */\nToolbar.Spacer = Spacer;\n","export function rollingAverage(samples: readonly number[]): number {\n  if (samples.length === 0) return 0;\n  const sum = samples.reduce((acc, n) => acc + n, 0);\n  return Math.round(sum / samples.length);\n}\n","import { useVisibleRaf } from '@weasel-js/core';\nimport { useEffect, useRef, useState } from 'react';\nimport { rollingAverage } from './fpsAverage';\n\nconst SAMPLE_WINDOW = 30;\n\n/** A live frame-rate readout, averaged over the last 30 frames. */\nexport function FpsMeter() {\n  const [fps, setFps] = useState(0);\n  const samplesRef = useRef<number[]>([]);\n  const lastTimeRef = useRef<number | null>(null);\n  const rootRef = useRef<HTMLDivElement | null>(null);\n\n  const loop = useVisibleRaf(\n    (time) => {\n      const last = lastTimeRef.current;\n      if (last !== null) {\n        const delta = time - last;\n        if (delta > 0) {\n          const samples = samplesRef.current;\n          samples.push(1000 / delta);\n          if (samples.length > SAMPLE_WINDOW) samples.shift();\n          setFps(rollingAverage(samples));\n        }\n      }\n      lastTimeRef.current = time;\n      loop.request();\n    },\n    {\n      target: rootRef,\n      // The gap spent suspended is not a frame that took an hour to draw.\n      onResume: () => {\n        lastTimeRef.current = null;\n      },\n    },\n  );\n\n  useEffect(() => {\n    loop.request();\n    return () => loop.cancel();\n  }, [loop]);\n\n  return (\n    <div className=\"lk-fps-meter\" ref={rootRef}>\n      <span className=\"lk-fps-meter-value\">FPS {fps}</span>\n    </div>\n  );\n}\n","import { useContext } from 'react';\nimport { CanvasStackContext } from '../canvas/CanvasStackContext';\n\n/** Props for `<ScaleIndicator>`. */\nexport interface ScaleIndicatorProps {\n  /** Current view zoom factor. If omitted, reads from CanvasStackContext. Defaults to 1. */\n  zoom?: number;\n  /** World pixels per unit at zoom=1. Default: 1. */\n  pixelsPerUnit?: number;\n  /** Unit label. Default: 'px'. */\n  unit?: string;\n  /** Target bar width in display pixels. Default: 100. */\n  targetWidth?: number;\n}\n\n// Rounds n to a \"nice\" number — 1, 2, 5, 10, 20, 50, ...\nfunction niceNumber(n: number): number {\n  if (n <= 0) return 1;\n  const exp = Math.floor(Math.log10(n));\n  const fraction = n / 10 ** exp;\n  let nice: number;\n  if (fraction < 1.5) nice = 1;\n  else if (fraction < 3.5) nice = 2;\n  else if (fraction < 7.5) nice = 5;\n  else nice = 10;\n  return nice * 10 ** exp;\n}\n\n/** A scale bar: a labeled rule showing how far a round number of world units\n *  is at the current zoom. Reads the zoom from the surrounding canvas stack\n *  unless one is passed. */\nexport function ScaleIndicator({\n  zoom,\n  pixelsPerUnit = 1,\n  unit = 'px',\n  targetWidth = 100,\n}: ScaleIndicatorProps) {\n  const ctxValue = useContext(CanvasStackContext);\n  const effectiveZoom = zoom ?? ctxValue?.view.zoom ?? 1;\n  const effectivePxPerUnit = pixelsPerUnit * effectiveZoom;\n  const targetUnits = targetWidth / effectivePxPerUnit;\n  const niceUnits = niceNumber(targetUnits);\n  const barWidth = niceUnits * effectivePxPerUnit;\n  return (\n    <div className=\"lk-scale-indicator\" role=\"img\" aria-label={`Scale: ${niceUnits} ${unit}`}>\n      <div className=\"lk-scale-indicator-bar\" style={{ width: `${barWidth}px` }} />\n      <span className=\"lk-scale-indicator-label\">\n        {niceUnits} {unit}\n      </span>\n    </div>\n  );\n}\n","import { NumberField, Slider } from '../passthrough/weasel-ui';\n\n/** Props for `<ZoomControl>`. */\nexport interface ZoomControlProps {\n  /** Current zoom as a scale factor: 1 is actual size. */\n  zoom: number;\n  /** Fired continuously while the slider drags. */\n  onZoomChange: (zoom: number) => void;\n  /** Fired when a drag settles or the field is committed. Defaults to\n   *  `onZoomChange`. */\n  onZoomCommit?: (zoom: number) => void;\n  /** Smallest selectable zoom. Defaults to 0.1 (10%). */\n  min?: number;\n  /** Largest selectable zoom. Defaults to 8 (800%). */\n  max?: number;\n  className?: string;\n}\n\n// Zoom is perceptually geometric — halving is as big a step as doubling — so\n// the slider runs on log2 and 100% lands mid-track for a symmetric range.\nconst toTrack = (zoom: number): number => Math.log2(zoom);\nconst fromTrack = (v: number): number => 2 ** v;\n\nconst clamp = (v: number, lo: number, hi: number): number => Math.max(lo, Math.min(hi, v));\n\n/** Zoom as a log-scaled slider with an editable percentage beside it. Pair it\n *  with zoom-in / zoom-out buttons in a `<Toolbar.Group>`; this component owns\n *  only the continuous part. */\nexport function ZoomControl({\n  zoom,\n  onZoomChange,\n  onZoomCommit,\n  min = 0.1,\n  max = 8,\n  className,\n}: ZoomControlProps) {\n  const commit = onZoomCommit ?? onZoomChange;\n  const emit = (track: number, done: boolean): void => {\n    const next = clamp(fromTrack(track), min, max);\n    (done ? commit : onZoomChange)(next);\n  };\n\n  return (\n    <div className={`lk-zoom${className ? ` ${className}` : ''}`}>\n      <Slider\n        className=\"lk-zoom__slider\"\n        ariaLabel=\"Zoom\"\n        density=\"slim\"\n        min={toTrack(min)}\n        max={toTrack(max)}\n        // Detents at the octaves plus actual size, so 25/50/100/200/400% are\n        // reachable by drag rather than only by typing.\n        stops={[-2, -1, 0, 1, 2]}\n        thumbs={[{ value: clamp(toTrack(zoom), toTrack(min), toTrack(max)) }]}\n        onInput={(next) => emit(next[0].value, false)}\n        onChange={(next) => emit(next[0].value, true)}\n        readoutPlacement=\"none\"\n      />\n      {/* `style: 'percent'` formats a fraction, so the field carries the scale\n          factor itself and renders 0.5 as \"50%\". */}\n      <NumberField\n        className=\"lk-zoom__field\"\n        width=\"fit\"\n        aria-label=\"Zoom\"\n        value={zoom}\n        minValue={min}\n        maxValue={max}\n        step={0.01}\n        hideSteppers\n        ghost\n        formatOptions={{ style: 'percent', maximumFractionDigits: 0 }}\n        onChange={(next) => {\n          if (!Number.isFinite(next)) return;\n          commit(clamp(next, min, max));\n        }}\n      />\n    </div>\n  );\n}\n","import type { ReactNode } from 'react';\n\n/** Props for `<StatusBar>`. */\nexport interface StatusBarProps {\n  children: ReactNode;\n}\n\n/** A footer strip for readouts. Fill it with `<StatusBar.Section>`. */\nexport function StatusBar({ children }: StatusBarProps) {\n  return <div className=\"lk-status-bar\">{children}</div>;\n}\n\n/** Props for `<StatusBar.Section>`. */\nexport interface StatusBarSectionProps {\n  children: ReactNode;\n  /** Pushes this section, and everything after it, to the far end. */\n  end?: boolean;\n}\nfunction Section({ children, end }: StatusBarSectionProps) {\n  return (\n    <span className={`lk-status-bar-section${end ? ' lk-status-bar-section--end' : ''}`}>\n      {children}\n    </span>\n  );\n}\n\n/** One readout within a status bar. */\nStatusBar.Section = Section;\n"]}