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

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

@@ -0,0 +1,162 @@
+import { P as PrefRenderer, T as ToolPrefLeaf, a as ToolPrefGroup } from './PrefsForm-BYa6cWnO.js';
+
+/**
+ * Renders the control cell for one config leaf. Identical to weasel-ui's
+ * `PrefRenderer` on purpose — aliased rather than redeclared so the two
+ * cannot drift.
+ */
+type ControlRenderer = PrefRenderer;
+/** One labeled choice in an `enum` leaf. */
+interface ConfigOption {
+    value: string;
+    label: string;
+}
+/** Everything a leaf can carry beyond its kind and default. A flat union of
+ *  every `Pref*` leaf's extras, plus labkit's own `debounceMs`. */
+interface Annotations {
+    name?: string;
+    description?: string;
+    hidden?: boolean;
+    block?: boolean;
+    pair?: string;
+    min?: number;
+    max?: number;
+    step?: number;
+    control?: string;
+    options?: readonly ConfigOption[];
+    placeholder?: string;
+    maxLength?: number;
+    /** Milliseconds to debounce a string leaf's live writes. Default 150. */
+    debounceMs?: number;
+}
+/** What a rule contributes. `kind` is honored only while it is still unset,
+ *  which is what makes `f.value` claimable and a kinded factory final. */
+type LeafPatch = Annotations & {
+    kind?: string;
+};
+/** What a rule is given for the leaf it is deciding about. */
+interface ConfigRuleContext {
+    /** The config key this leaf writes. */
+    key: string;
+    /** Dotted path within the schema. Equal to `key` while schemas are flat. */
+    path: string;
+    /** The leaf's default value. A rule may read it but never change it. */
+    default: unknown;
+    /** What earlier rules and the author's own annotations have settled. */
+    leaf: Readonly<LeafPatch>;
+}
+/**
+ * Decides part of how a leaf is presented. Returns a patch, or null to
+ * abstain. Merging is gap-filling: a property already settled is never
+ * overwritten, so the author's annotations beat every rule and a consumer's
+ * rules beat labkit's built-ins.
+ */
+type ConfigRule = (ctx: ConfigRuleContext) => LeafPatch | null;
+/** A presentational bucket of leaves, rendered under one heading. */
+interface SectionSpec {
+    label: string;
+    paths: readonly string[];
+}
+/** A schema resolved against a set of rules: the vocabulary weasel-ui renders,
+ *  plus the three things labkit keeps on the side because `PrefLeaf` has no
+ *  field for them. */
+interface ResolvedConfig {
+    /** Flat: every leaf is a direct child, so a leaf's path is its config key. */
+    group: ToolPrefGroup;
+    sections: readonly SectionSpec[];
+    showIf: ReadonlyMap<string, (config: Record<string, unknown>) => boolean>;
+    /** Node-level `.render` overrides, keyed by path. */
+    renderers: Readonly<Record<string, ControlRenderer>>;
+}
+/** Per-node extras that do not belong on a `PrefLeaf`. */
+interface NodeOptions {
+    section?: string;
+    showIf?: (config: Record<string, unknown>) => boolean;
+    render?: ControlRenderer;
+    validate?: (leaf: ToolPrefLeaf) => string[];
+}
+/** The builder's leaf: a kind (or null, to be decided by rules), a default,
+ *  an annotation bag, and the extras above. */
+interface ConfigNode<T = unknown> {
+    readonly kind: string | null;
+    readonly default: T;
+    readonly annotations: Readonly<Annotations>;
+    readonly options: Readonly<NodeOptions>;
+}
+/** The value type a node produces. */
+type NodeValue<N> = N extends ConfigNode<infer T> ? T : never;
+/** The config type a builder shape produces. */
+type InferConfig<S> = {
+    [K in keyof S]: NodeValue<S[K]>;
+};
+/** An instrument's config, declared once. */
+interface ConfigSchema<TC> {
+    readonly nodes: Readonly<Record<string, ConfigNode>>;
+    /** The starting config — what `defaultConfig()` would have returned. */
+    defaults(): TC;
+}
+/** The config type behind a schema: `ConfigOf<typeof sceneConfig>`. */
+type ConfigOf<S> = S extends ConfigSchema<infer TC> ? TC : never;
+
+/** 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 { Annotations as A, ConfigNode as C, InferConfig as I, LeafPatch as L, NodeOptions as N, ResolvedConfig as R, SectionSpec as S, TextField as T, ControlRenderer as a, ConfigOption as b, ConfigSchema as c, ConfigField as d, ConfigRule as e, ConfigRuleContext as f, CheckboxField as g, ColorField as h, ConfigFieldBase as i, ConfigFieldType as j, ConfigOf as k, NodeValue as l, NumberField as m, SelectField as n, SelectOption as o, SliderField as p };

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

@@ -0,0 +1,56 @@
+/** What a running job reports as it goes. `total` may arrive at any point and may
+ *  arrive more than once; a job that cannot count up front simply never sends it.
+ *
+ *  `failed` is a first-class event rather than a thrown error because these
+ *  failures are per item: a run with two failed items is a partial success, and
+ *  its other items are worth showing. */
+type JobEvent<T> = {
+    kind: 'total';
+    total: number;
+} | {
+    kind: 'item';
+    item: T;
+} | {
+    kind: 'failed';
+    index: number;
+    error: string;
+};
+/** Where a job is. `idle` before its first run and after a cancel; `done` when the
+ *  iterable finished, whether or not items failed along the way. */
+type JobStatus = 'idle' | 'running' | 'done' | 'error';
+/** Declares that an instrument has work too slow to do during a render: what to
+ *  run, when to re-run it, and how each result folds into state. */
+interface JobCapability<TS = unknown, TC = unknown, TItem = unknown> {
+    /** Re-run whenever this value changes, compared element-wise. A job with no
+     *  `key` runs only when something calls `start()`. */
+    key?: (config: TC, state: TS) => readonly unknown[];
+    /** Start on mount and on every `key` change. Default false. */
+    auto?: boolean;
+    run: (args: {
+        config: TC;
+        state: TS;
+        signal: AbortSignal;
+    }) => AsyncIterable<JobEvent<TItem>>;
+    /** Fold one result into state. Called once per `item` event, in arrival order. */
+    onItem: (item: TItem, state: TS) => TS;
+}
+/** One item that failed, and why. */
+interface JobFailure {
+    index: number;
+    error: string;
+}
+/** What `RenderContext.job` exposes. Present only when the instrument declares the
+ *  capability; `undefined` otherwise. */
+interface JobHandle {
+    status: JobStatus;
+    done: number;
+    /** Null until the job reports a total, and forever if it never does. */
+    total: number | null;
+    failures: readonly JobFailure[];
+    /** The error that ended the run, when `status` is `'error'`. */
+    error: string | null;
+    start: () => void;
+    cancel: () => void;
+}
+
+export type { JobHandle as J, JobCapability as a, JobEvent as b, JobFailure as c, JobStatus as d };

package/dist/_dts/{useTrialState-DYe2vUwN.d.ts → useTrialState-CsGMjhu9.d.ts}

@@ -1,96 +1,8 @@
+import { a as StorageAdapter, b as LabStoreState, T as TrialRecord, c as SavedSnapshot, e as LabMode, I as InstrumentSerializers, C as CreateLabStoreOptions, d as TrialStateHandle } from './types-1Sdxy_Pv.js';
 import * as react from 'react';
 import { ReactNode, ReactElement } from 'react';
 import { StoreApi } from 'zustand/vanilla';
 
-/** A trial's undo history, as snapshots of its state either side of the
- *  present. */
-interface UndoStack {
-    past: unknown[];
-    future: unknown[];
-}
-/** 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> {
-    id: string;
-    instrumentName: string;
-    config: TC;
-    state: TS;
-    view: {
-        zoom: number;
-        pan: {
-            x: number;
-            y: number;
-        };
-    };
-    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;
-    /** Per-trial tile extents, keyed by trial id. Opaque here — the
-     *  shape belongs to whatever lays the trials out. */
-    layout: Record<string, unknown>;
-}
-/** 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;
-    setConfig: (key: keyof TC, value: TC[keyof TC]) => 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;
-}
-/** Per-instrument serialize/deserialize hooks, keyed by instrument name. An
- *  instrument whose state is already JSON-safe needs no entry. */
-type InstrumentSerializers = Record<string, {
-    serialize?: (state: unknown) => unknown;
-    deserialize?: (data: 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>;
-    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>;
-
 /** Persist to `localStorage` — state survives a reload and a new tab. Falls
  *  back to no-ops when storage is unavailable. */
 declare const localStorageAdapter: StorageAdapter;
@@ -112,7 +24,7 @@ interface LabStoreActions {
     removeTrial: (id: string) => void;
     updateTrialState: <TS>(id: string, next: TS | ((prev: TS) => TS)) => void;
     updateTrialConfig: <TC>(id: string, key: keyof TC, value: TC[keyof TC]) => void;
-    updateTrialView: (id: string, view: TrialRecord['view']) => void;
+    updateTrialView: (id: string, view: 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;
@@ -120,6 +32,8 @@ interface LabStoreActions {
     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;
 }
 /** A lab's store: its state and actions, plus the hook instruments use to
@@ -171,5 +85,5 @@ declare function quarantineKey(storageKey: string): string;
  *  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, LabStoreContext as e, LabStoreProvider as f, TrialIdContext as i, TrialIdProvider as j, createLabStore as l, createMemoryAdapter as m, labDocumentKey as n, localStorageAdapter as o, noneAdapter as p, quarantineKey as q, useLabStore as r, sessionStorageAdapter as s, useTrialId as t, urlHashAdapter as u, useTrialState as v };
-export type { InstrumentSerializers as I, LabDocument as L, Migration as M, SerializedTrial as S, TrialRecord as T, UndoStack as U, StorageAdapter as a, CreateLabStoreOptions as b, LabStore as c, LabStoreActions as d, LabStoreState as g, SavedSnapshot as h, TrialStateHandle as k, LabMode as w };
+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/canvas/index.d.ts

@@ -1,8 +1,11 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { V as ViewTransform, e as Point } from '../_dts/index-iAP6XbH3.js';
-import '../_dts/types-x92Kfeme.js';
+import { V as ViewTransform, g as Point } from '../_dts/index-DgcNdEdh.js';
+import '../_dts/types-AHlQxBNN.js';
+import '../_dts/PrefsForm-BYa6cWnO.js';
+import '../_dts/types-1Sdxy_Pv.js';
+import '../_dts/types-DJ79Tg5J.js';
 
 /** One layer of a canvas stack: its id, whether it is currently shown, and how
  *  it paints itself. */
@@ -17,6 +20,8 @@ interface CanvasStackProps {
     layers: CanvasLayerDescriptor[];
     view: ViewTransform;
     onViewChange: (v: ViewTransform) => void;
+    minZoom?: number;
+    maxZoom?: number;
     width?: number | string;
     height?: number | string;
     className?: string;
@@ -26,7 +31,7 @@ interface CanvasStackProps {
 /** Stacks one `<canvas>` per layer and drives them from a shared view, so a
  *  layer that changes rarely is not redrawn with one that changes every frame.
  *  Handles sizing, device pixel ratio, and pan/zoom. */
-declare function CanvasStack({ layers, view, onViewChange, width, height, className, onHitTest, children, }: CanvasStackProps): react_jsx_runtime.JSX.Element;
+declare function CanvasStack({ layers, view, onViewChange, minZoom, maxZoom, width, height, className, onHitTest, children, }: CanvasStackProps): react_jsx_runtime.JSX.Element;
 
 /** What a canvas stack publishes to its children — currently the view, so
  *  DOM overlays can position themselves in the same coordinates. */

package/dist/canvas/index.js

@@ -1,4 +1,5 @@
-export { CanvasStack, screenToWorld, worldToScreen } from '../chunk-574LJAV4.js';
+export { CanvasStack, screenToWorld, worldToScreen } from '../chunk-NS54R52R.js';
 export { CanvasStackContext } from '../chunk-CPUJ3QXL.js';
+import '../chunk-Z6HJ5FEM.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/chrome/index.d.ts

@@ -0,0 +1,86 @@
+import { a as ControlRenderer } from '../_dts/types-AHlQxBNN.js';
+import { I as Instrument, m as TrialChromeContext, T as TrialContribution } from '../_dts/index-DgcNdEdh.js';
+export { e as IconComponent, S as SidebarSection, h as StatusReadout, k as ToolItem, l as ToolbarItem, n as TrialRegion, o as ViewportControl } from '../_dts/index-DgcNdEdh.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import '../_dts/PrefsForm-BYa6cWnO.js';
+import 'react';
+import '../_dts/types-1Sdxy_Pv.js';
+import '../_dts/types-DJ79Tg5J.js';
+
+/**
+ * The contributions a trial gets from what its instrument declared. This is
+ * the whole "declaring a capability provides the chrome" rule — it replaces
+ * the presence checks that used to be spread across the runtime.
+ */
+declare function builtinContributions(instrument: Instrument, ctx: TrialChromeContext, controls?: Record<string, ControlRenderer>): TrialContribution[];
+
+/**
+ * Concatenate contribution bundles into one list, preserving order — order
+ * decides how a region lays its contributions out, so it is part of the
+ * result, not an accident of it.
+ *
+ * Throws on a duplicate id rather than dropping one: a contribution silently
+ * losing to a later bundle is the failure a registry exists to prevent.
+ */
+declare function mergeContributions(...bundles: readonly TrialContribution[][]): TrialContribution[];
+/**
+ * Drop contributions by id. Throws when an id is not present: a typo that
+ * silently suppresses nothing is the same class of bug as a duplicate id
+ * silently winning.
+ */
+declare function suppressContributions(bundle: readonly TrialContribution[], ids: readonly string[]): TrialContribution[];
+
+/** Props for `<PaletteRegion>`. */
+interface PaletteRegionProps {
+    contributions: readonly TrialContribution[];
+    ctx: TrialChromeContext;
+}
+/** A trial's tool strip. Selection lives in the trial's or the lab's tool
+ *  slot; this region only reflects it. */
+declare function PaletteRegion({ contributions, ctx }: PaletteRegionProps): react_jsx_runtime.JSX.Element | null;
+
+/** Props for `<SidebarRegion>`. */
+interface SidebarRegionProps {
+    contributions: readonly TrialContribution[];
+    ctx: TrialChromeContext;
+}
+/** Lays a trial's `sidebar` contributions out as titled, collapsible sections. */
+declare function SidebarRegion({ contributions, ctx }: SidebarRegionProps): react_jsx_runtime.JSX.Element | null;
+
+/** Props for `<StatusRegion>`. */
+interface StatusRegionProps {
+    contributions: readonly TrialContribution[];
+    ctx: TrialChromeContext;
+}
+/** Lays a trial's `status` contributions out as readouts. */
+declare function StatusRegion({ contributions, ctx }: StatusRegionProps): react_jsx_runtime.JSX.Element | null;
+
+/** Props for `<TitleBarRegion>`. */
+interface TitleBarRegionProps {
+    contributions: readonly TrialContribution[];
+    ctx: TrialChromeContext;
+}
+/** Lays a trial's `titlebar` contributions out, at the far end of the bar. */
+declare function TitleBarRegion({ contributions, ctx }: TitleBarRegionProps): react_jsx_runtime.JSX.Element | null;
+
+/** Props for `<ToolbarRegion>`. */
+interface ToolbarRegionProps {
+    contributions: readonly TrialContribution[];
+    ctx: TrialChromeContext;
+}
+/** Lays a trial's `toolbar` contributions out, grouped by their `group`. */
+declare function ToolbarRegion({ contributions, ctx }: ToolbarRegionProps): react_jsx_runtime.JSX.Element | null;
+
+/** Props for `<ViewportRegion>`. */
+interface ViewportRegionProps {
+    contributions: readonly TrialContribution[];
+    ctx: TrialChromeContext;
+}
+/**
+ * Controls acting on the view of a trial. Anchored inside the content well
+ * rather than in the toolbar, which acts on the trial itself.
+ */
+declare function ViewportRegion({ contributions, ctx }: ViewportRegionProps): react_jsx_runtime.JSX.Element | null;
+
+export { PaletteRegion, SidebarRegion, StatusRegion, TitleBarRegion, ToolbarRegion, TrialChromeContext, TrialContribution, ViewportRegion, builtinContributions, mergeContributions, suppressContributions };
+export type { PaletteRegionProps, SidebarRegionProps, StatusRegionProps, TitleBarRegionProps, ToolbarRegionProps, ViewportRegionProps };

package/dist/chrome/index.js

@@ -0,0 +1,8 @@
+export { PaletteRegion, SidebarRegion, StatusRegion, TitleBarRegion, ToolbarRegion, ViewportRegion, builtinContributions, mergeContributions, suppressContributions } from '../chunk-PO6L3NSH.js';
+import '../chunk-O7NVSCLN.js';
+import '../chunk-ZZAYVX4X.js';
+import '../chunk-TLGRYALP.js';
+import '../chunk-CPUJ3QXL.js';
+import '../chunk-Z6HJ5FEM.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/chrome/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/{chunk-3TYUJR7Z.js → chunk-4TMMVIDM.js}

@@ -278,6 +278,7 @@ function createLabStore(options) {
     savedSnapshots: hydratedSnapshots,
     mode: hydratedMode,
     layout: hydratedLayout,
+    activeToolId: null,
     addTrial: (record) => {
       set((s) => ({
         trials: [...s.trials, { ...record, undoStack: emptyUndoStack() }]
@@ -293,6 +294,7 @@ function createLabStore(options) {
         trials: s.trials.map((w) => {
           if (w.id !== id) return w;
           const nextState = typeof next === "function" ? next(w.state) : next;
+          if (Object.is(nextState, w.state)) return w;
           return { ...w, state: nextState };
         })
       }));
@@ -312,7 +314,7 @@ function createLabStore(options) {
     },
     updateTrialView: (id, view) => {
       set((s) => ({
-        trials: s.trials.map((w) => w.id === id ? { ...w, view } : w)
+        trials: s.trials.map((w) => w.id === id && !Object.is(view, w.view) ? { ...w, view } : w)
       }));
       scheduleFlush();
     },
@@ -386,6 +388,10 @@ function createLabStore(options) {
       set({ mode });
       scheduleFlush();
     },
+    setLabTool: (id) => set({ activeToolId: id }),
+    setTrialTool: (trialId, id) => set((s) => ({
+      trials: s.trials.map((t) => t.id === trialId ? { ...t, activeToolId: id } : t)
+    })),
     setLayout: (layout) => {
       set({ layout });
       scheduleFlush();
@@ -484,5 +490,5 @@ function useTrialState() {
 }
 
 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 };
-//# sourceMappingURL=chunk-3TYUJR7Z.js.map
-//# sourceMappingURL=chunk-3TYUJR7Z.js.map
+//# sourceMappingURL=chunk-4TMMVIDM.js.map
+//# sourceMappingURL=chunk-4TMMVIDM.js.map

package/dist/chunk-4TMMVIDM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/state/helpers.ts","../src/state/adapters.ts","../src/state/context.tsx","../src/state/document.ts","../src/state/store.ts","../src/state/useTrialState.ts"],"names":["useContext","useStore"],"mappings":"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","file":"chunk-4TMMVIDM.js","sourcesContent":["import type { InstrumentSerializers, SerializedTrial, TrialRecord, UndoStack } from './types';\n\n/** The storage key a lab writes one of its buckets under. Namespaced by\n *  `storageKey` so two labs sharing an origin do not collide. */\nexport function labStorageKey(\n  storageKey: string,\n  bucket: 'workspaces' | 'saves' | 'theme' | 'layout',\n): string {\n  return `lk:${storageKey}:${bucket}`;\n}\n\n/** Encode a string for the URL fragment. */\nexport function encodeUrlHash(value: string): string {\n  return btoa(encodeURIComponent(value));\n}\n\n/** Decode a URL fragment written by `encodeUrlHash`, or `null` if it is\n *  malformed. */\nexport function decodeUrlHash(hash: string): string | null {\n  if (!hash) return null;\n  try {\n    return decodeURIComponent(atob(hash));\n  } catch {\n    return null;\n  }\n}\n\n/** A fresh, empty undo history. */\nexport function emptyUndoStack(): UndoStack {\n  return { past: [], future: [] };\n}\n\n/** Serialize trials for storage, running each instrument's own serializer\n *  over its state. Undo history is deliberately dropped — it does not survive\n *  a reload. */\nexport function serializeTrials(\n  trials: TrialRecord[],\n  serializers: InstrumentSerializers,\n): SerializedTrial[] {\n  return trials.map(({ undoStack: _undo, ...w }) => {\n    const s = serializers[w.instrumentName];\n    return { ...w, state: s?.serialize ? s.serialize(w.state) : w.state };\n  });\n}\n\n/** Rebuild trials from storage, running each instrument's deserializer\n *  over its state and starting each with an empty undo history. Returns an\n *  empty list rather than throwing on malformed input. */\nexport function deserializeTrials(\n  records: SerializedTrial[],\n  deserializers: InstrumentSerializers,\n): TrialRecord[] {\n  if (!Array.isArray(records)) {\n    console.warn('[labkit] deserializeTrials: not an array, returning empty list');\n    return [];\n  }\n  return records.map((r) => {\n    const d = deserializers[r.instrumentName];\n    return {\n      ...r,\n      state: d?.deserialize ? d.deserialize(r.state) : r.state,\n      undoStack: emptyUndoStack(),\n    };\n  });\n}\n","import { decodeUrlHash, encodeUrlHash } from './helpers';\nimport type { StorageAdapter } from './types';\n\n/** Persist to `localStorage` — state survives a reload and a new tab. Falls\n *  back to no-ops when storage is unavailable. */\nexport const localStorageAdapter: StorageAdapter = {\n  read: (key) => {\n    try {\n      return localStorage.getItem(key);\n    } catch {\n      return null;\n    }\n  },\n  write: (key, value) => {\n    try {\n      localStorage.setItem(key, value);\n    } catch (e) {\n      console.warn('[labkit] localStorage write failed:', e);\n    }\n  },\n  delete: (key) => {\n    try {\n      localStorage.removeItem(key);\n    } catch {\n      /* ignore */\n    }\n  },\n};\n\n/** Persist to `sessionStorage` — state survives a reload but not a new tab. */\nexport const sessionStorageAdapter: StorageAdapter = {\n  read: (key) => {\n    try {\n      return sessionStorage.getItem(key);\n    } catch {\n      return null;\n    }\n  },\n  write: (key, value) => {\n    try {\n      sessionStorage.setItem(key, value);\n    } catch (e) {\n      console.warn('[labkit] sessionStorage write failed:', e);\n    }\n  },\n  delete: (key) => {\n    try {\n      sessionStorage.removeItem(key);\n    } catch {\n      /* ignore */\n    }\n  },\n};\n\nconst URL_HASH_GUARD = typeof window !== 'undefined';\n\nfunction readHashMap(): Record<string, string> {\n  if (!URL_HASH_GUARD) return {};\n  const raw = decodeUrlHash(window.location.hash.replace(/^#/, ''));\n  if (!raw) return {};\n  try {\n    return JSON.parse(raw) as Record<string, string>;\n  } catch {\n    return {};\n  }\n}\n\nfunction writeHashMap(map: Record<string, string>): void {\n  if (!URL_HASH_GUARD) return;\n  const encoded = encodeUrlHash(JSON.stringify(map));\n  window.history.replaceState(null, '', `#${encoded}`);\n}\n\n/** Persist into the URL fragment, so the page's link carries its state and\n *  can be shared or bookmarked. */\nexport const urlHashAdapter: StorageAdapter = {\n  read: (key) => readHashMap()[key] ?? null,\n  write: (key, value) => {\n    const map = readHashMap();\n    map[key] = value;\n    writeHashMap(map);\n  },\n  delete: (key) => {\n    const map = readHashMap();\n    delete map[key];\n    writeHashMap(map);\n  },\n};\n\n/** An in-memory store, discarded on reload. For tests, and for labs that\n *  should start fresh every time. */\nexport function createMemoryAdapter(): StorageAdapter {\n  const store = new Map<string, string>();\n  return {\n    read: (key) => store.get(key) ?? null,\n    write: (key, value) => {\n      store.set(key, value);\n    },\n    delete: (key) => {\n      store.delete(key);\n    },\n  };\n}\n\n/** Persists nothing and reads back nothing. */\nexport const noneAdapter: StorageAdapter = {\n  read: () => null,\n  write: () => {},\n  delete: () => {},\n};\n","import { createContext, type ReactElement, type ReactNode, useContext } from 'react';\nimport { useStore } from 'zustand/react';\nimport type { LabStore } from './store';\nimport type { LabStoreState } from './types';\n\ntype LabStoreCtx = { store: LabStore } | null;\n\n/** Context carrying the lab store. Prefer `useLabStore`; this is exported for\n *  code that needs to read the context without subscribing. */\nexport const LabStoreContext = createContext<LabStoreCtx>(null);\n\n/** Provides a lab store to its subtree. */\nexport function LabStoreProvider({\n  store,\n  children,\n}: {\n  store: LabStore;\n  children: ReactNode;\n}): ReactElement {\n  return <LabStoreContext.Provider value={{ store }}>{children}</LabStoreContext.Provider>;\n}\n\n/** Subscribe to the whole lab store. Throws outside a `<LabStoreProvider>`. */\nexport function useLabStore(): LabStoreState & ReturnType<LabStore['getState']> {\n  const ctx = useContext(LabStoreContext);\n  if (!ctx) throw new Error('[labkit] useLabStore must be used inside <LabStoreProvider>');\n  return useStore(ctx.store);\n}\n\n/** Context carrying which trial the subtree belongs to. */\nexport const TrialIdContext = createContext<string | null>(null);\n\n/** Names the trial its subtree belongs to, so an instrument's hooks can\n *  find their own record in the store without being passed an id. */\nexport function TrialIdProvider({\n  trialId,\n  children,\n}: {\n  trialId: string;\n  children: ReactNode;\n}): ReactElement {\n  return <TrialIdContext.Provider value={trialId}>{children}</TrialIdContext.Provider>;\n}\n\n/** The id of the trial this component is inside. Throws outside a\n *  `<TrialIdProvider>`. */\nexport function useTrialId(): string {\n  const id = useContext(TrialIdContext);\n  if (!id) throw new Error('[labkit] useTrialId must be used inside <TrialIdProvider>');\n  return id;\n}\n","import { labStorageKey } from './helpers';\nimport type {\n  LabDocument,\n  LabMode,\n  Migration,\n  SavedSnapshot,\n  SerializedTrial,\n  StorageAdapter,\n} from './types';\n\n/** Bumped whenever the persisted shape changes; every bump needs a migration. */\nexport const CURRENT_DOCUMENT_VERSION = 2;\n\n/** The one key a lab persists under. The `:doc` suffix keeps it out of the\n *  legacy bucket namespace, where a lab named `a:saves` would otherwise write\n *  its document over lab `a`'s saves bucket. */\nexport function labDocumentKey(storageKey: string): string {\n  return `lk:${storageKey}:doc`;\n}\n\n/** Where a document that failed to migrate is set aside, so a bad migration\n *  loses state loudly rather than silently. */\nexport function quarantineKey(storageKey: string): string {\n  return `lk:${storageKey}:quarantine`;\n}\n\n/** A fresh document at the current version. */\nexport function emptyDocument(mode: LabMode): LabDocument {\n  return {\n    version: CURRENT_DOCUMENT_VERSION,\n    trials: [],\n    saves: [],\n    layout: {},\n    mode,\n  };\n}\n\n/** What a migration run produced: the migrated document, or why it refused. */\nexport type MigrationOutcome =\n  | { ok: true; doc: Record<string, unknown>; migrated: boolean }\n  | { ok: false; reason: 'future' | 'failed'; error?: unknown };\n\n/** Walk a document forward to `target`, one migration at a time. A version\n *  above `target` is refused rather than parsed under a shape it may not\n *  have. */\nexport function runMigrations(\n  raw: Record<string, unknown>,\n  migrations: Migration[],\n  target: number,\n): MigrationOutcome {\n  const from = typeof raw.version === 'number' ? raw.version : 0;\n  if (from > target) return { ok: false, reason: 'future' };\n  if (from === target) return { ok: true, doc: raw, migrated: false };\n\n  let doc = raw;\n  try {\n    for (let v = from; v < target; v++) {\n      const migration = migrations[v];\n      if (!migration) throw new Error(`[labkit] no migration from version ${v}`);\n      doc = migration(doc);\n    }\n  } catch (error) {\n    return { ok: false, reason: 'failed', error };\n  }\n  return { ok: true, doc, migrated: true };\n}\n\nconst LEGACY_BUCKETS = ['workspaces', 'saves', 'layout', 'theme'] as const;\n\nfunction parseOr<T>(raw: string | null, fallback: T, bucket: string): T {\n  if (raw === null) return fallback;\n  try {\n    return JSON.parse(raw) as T;\n  } catch {\n    console.warn(`[labkit] unparseable legacy bucket \"${bucket}\", dropping it`);\n    return fallback;\n  }\n}\n\n/** Assemble a version-0 document out of the four pre-document keys, or null\n *  if none of them is present. `fallbackMode` is used when the theme key is\n *  absent or holds something unrecognized; `interstellar` passes through\n *  untouched for `migrateV0toV1` to coerce. */\nexport function readLegacyDocument(\n  storage: StorageAdapter,\n  storageKey: string,\n  fallbackMode: LabMode,\n): Record<string, unknown> | null {\n  const present = LEGACY_BUCKETS.some((b) => storage.read(labStorageKey(storageKey, b)) !== null);\n  if (!present) return null;\n\n  const rawMode = storage.read(labStorageKey(storageKey, 'theme'));\n  const mode =\n    rawMode === 'light' || rawMode === 'dark' || rawMode === 'auto' || rawMode === 'interstellar'\n      ? rawMode\n      : fallbackMode;\n\n  return {\n    version: 0,\n    workspaces: parseOr(storage.read(labStorageKey(storageKey, 'workspaces')), [], 'workspaces'),\n    saves: parseOr(storage.read(labStorageKey(storageKey, 'saves')), [], 'saves'),\n    layout: parseOr(storage.read(labStorageKey(storageKey, 'layout')), {}, 'layout'),\n    mode,\n  };\n}\n\n/** Delete the four pre-document keys, but only once `expectedDocument` is\n *  confirmed to be exactly what is stored under the document key — a\n *  read-back, not a trust of the write that produced it. On any mismatch\n *  (write failed, landed partially, or never happened) it deletes nothing,\n *  warns, and returns `false` so the legacy buckets stay as a recoverable\n *  copy. Deletion itself is read back too — `StorageAdapter.delete` is\n *  optional, so an adapter without it leaves the keys in place — and `true`\n *  is returned only once all four are actually gone. */\nexport function deleteLegacyKeys(\n  storage: StorageAdapter,\n  storageKey: string,\n  expectedDocument: string,\n): boolean {\n  const actual = storage.read(labDocumentKey(storageKey));\n  if (actual !== expectedDocument) {\n    console.warn(\n      `[labkit] keeping legacy keys for \"${storageKey}\": could not confirm the migrated document was written`,\n    );\n    return false;\n  }\n  let allGone = true;\n  for (const bucket of LEGACY_BUCKETS) {\n    const key = labStorageKey(storageKey, bucket);\n    storage.delete?.(key);\n    if (storage.read(key) !== null) allGone = false;\n  }\n  return allGone;\n}\n\n/** Set `raw` aside under the quarantine key, reading it back to confirm it\n *  landed. Returns `false` when it did not — a full disk is exactly when a\n *  document goes unreadable — so the caller can leave the original alone\n *  rather than overwrite the only copy of it. */\nexport function quarantineDocument(\n  storage: StorageAdapter,\n  storageKey: string,\n  raw: string,\n): boolean {\n  storage.write(quarantineKey(storageKey), raw);\n  return storage.read(quarantineKey(storageKey)) === raw;\n}\n\n/** Fill in whatever a document is missing or holds the wrong shape of, so a\n *  hydrated store never sees `undefined` where a section should be. Applied to\n *  every document, migrated or already current. */\nexport function normalizeDocument(\n  doc: Record<string, unknown>,\n  fallbackMode: LabMode,\n): LabDocument {\n  const mode =\n    doc.mode === 'light' || doc.mode === 'dark' || doc.mode === 'auto' ? doc.mode : fallbackMode;\n  return {\n    version: CURRENT_DOCUMENT_VERSION,\n    trials: Array.isArray(doc.trials) ? (doc.trials as SerializedTrial[]) : [],\n    saves: Array.isArray(doc.saves) ? (doc.saves as SavedSnapshot[]) : [],\n    layout:\n      doc.layout && typeof doc.layout === 'object' ? (doc.layout as Record<string, unknown>) : {},\n    mode,\n  };\n}\n\n/** Version 0 (four loose keys) to version 1 (one document). Normalizes the\n *  mode, including `interstellar` — the dark mode's name back when it was a\n *  theme. Coerces against version 1's own field names rather than reusing\n *  `normalizeDocument`, which produces the current shape and would drop\n *  `workspaces` from a document it labels version 1. */\nexport function migrateV0toV1(doc: Record<string, unknown>): Record<string, unknown> {\n  const raw = doc.mode === 'interstellar' ? 'dark' : doc.mode;\n  const mode = raw === 'light' || raw === 'dark' || raw === 'auto' ? raw : 'auto';\n  return {\n    version: 1,\n    workspaces: Array.isArray(doc.workspaces) ? doc.workspaces : [],\n    saves: Array.isArray(doc.saves) ? doc.saves : [],\n    layout: doc.layout && typeof doc.layout === 'object' ? doc.layout : {},\n    mode,\n  };\n}\n\n/** Version 1 to version 2: the vocabulary refresh renamed a tile from\n *  workspace to trial. Only the records field moves; a record's own fields are\n *  unchanged. */\nexport function migrateV1toV2(doc: Record<string, unknown>): Record<string, unknown> {\n  const { workspaces, ...rest } = doc;\n  return { ...rest, trials: Array.isArray(workspaces) ? workspaces : [], version: 2 };\n}\n\n/** Index `i` migrates a version-`i` document to version `i + 1`. */\nexport const MIGRATIONS: Migration[] = [migrateV0toV1, migrateV1toV2];\n","import { createStore, type StoreApi } from 'zustand/vanilla';\nimport {\n  CURRENT_DOCUMENT_VERSION,\n  deleteLegacyKeys,\n  emptyDocument,\n  labDocumentKey,\n  MIGRATIONS,\n  normalizeDocument,\n  quarantineDocument,\n  readLegacyDocument,\n  runMigrations,\n} from './document';\nimport { deserializeTrials, emptyUndoStack, serializeTrials } from './helpers';\nimport type {\n  CreateLabStoreOptions,\n  InstrumentSerializers,\n  LabDocument,\n  LabMode,\n  LabStoreState,\n  SavedSnapshot,\n  TrialRecord,\n} from './types';\n\n/** Every mutation a lab store supports: managing trials, saving and\n *  restoring snapshots, and setting the color mode. */\nexport interface LabStoreActions {\n  addTrial: (record: Omit<TrialRecord, 'undoStack'>) => void;\n  removeTrial: (id: string) => void;\n  updateTrialState: <TS>(id: string, next: TS | ((prev: TS) => TS)) => void;\n  updateTrialConfig: <TC>(id: string, key: keyof TC, value: TC[keyof TC]) => void;\n  updateTrialView: (id: string, view: unknown) => void;\n  updateTrialUndoStack: (\n    id: string,\n    next: TrialRecord['undoStack'] | ((prev: TrialRecord['undoStack']) => TrialRecord['undoStack']),\n  ) => void;\n  setTrialInstrument: (id: string, instrumentName: string) => void;\n  saveSnapshot: (trialId: string, name: string) => void;\n  loadSnapshot: (snapshotId: string, trialId: string) => void;\n  deleteSnapshot: (snapshotId: string) => void;\n  listSnapshots: (trialId?: string) => SavedSnapshot[];\n  setMode: (mode: LabMode) => void;\n  setLabTool: (id: string | null) => void;\n  setTrialTool: (trialId: string, id: string | null) => void;\n  setLayout: (layout: Record<string, unknown>) => void;\n}\n\n/** A lab's store: its state and actions, plus the hook instruments use to\n *  register how their state is serialized. */\nexport type LabStore = StoreApi<LabStoreState & LabStoreActions> & {\n  registerSerializers: (s: InstrumentSerializers) => void;\n};\n\n/** Build a lab store, hydrating from storage if anything was saved under the\n *  same key. Writes back are debounced. */\nexport function createLabStore(options: CreateLabStoreOptions): LabStore {\n  let serializers: InstrumentSerializers = {};\n  let flushTimer: ReturnType<typeof setTimeout> | null = null;\n\n  const hydration = hydrateDocument(options);\n  const hydrated = hydration.document;\n  const persistDisabled = hydration.persistDisabled;\n  // Cleared once the legacy keys are actually gone; see the flush.\n  let foldedFromLegacy = hydration.foldedFromLegacy;\n\n  const hydratedTrials = deserializeTrials(hydrated.trials, serializers);\n  const hydratedSnapshots = hydrated.saves;\n  const hydratedLayout = hydrated.layout;\n  const hydratedMode = hydrated.mode;\n\n  const store = createStore<LabStoreState & LabStoreActions>()((set, get) => ({\n    trials: hydratedTrials,\n    savedSnapshots: hydratedSnapshots,\n    mode: hydratedMode,\n    layout: hydratedLayout,\n    activeToolId: null,\n\n    addTrial: (record) => {\n      set((s) => ({\n        trials: [...s.trials, { ...record, undoStack: emptyUndoStack() }],\n      }));\n      scheduleFlush();\n    },\n\n    removeTrial: (id) => {\n      set((s) => ({ trials: s.trials.filter((w) => w.id !== id) }));\n      scheduleFlush();\n    },\n\n    updateTrialState: (id, next) => {\n      set((s) => ({\n        trials: s.trials.map((w) => {\n          if (w.id !== id) return w;\n          const nextState =\n            typeof next === 'function' ? (next as (prev: unknown) => unknown)(w.state) : next;\n          // An updater that returns its input means \"nothing changed\", and must not\n          // cost a new record: the trial re-renders on record identity, so\n          // allocating here turns the standard React bail-out into a render loop.\n          if (Object.is(nextState, w.state)) return w;\n          return { ...w, state: nextState };\n        }),\n      }));\n      scheduleFlush();\n    },\n\n    updateTrialConfig: (id, key, value) => {\n      set((s) => ({\n        trials: s.trials.map((w) => {\n          if (w.id !== id) return w;\n          return {\n            ...w,\n            config: { ...(w.config as Record<string, unknown>), [key as string]: value },\n          };\n        }),\n      }));\n      scheduleFlush();\n    },\n\n    updateTrialView: (id, view) => {\n      set((s) => ({\n        trials: s.trials.map((w) => (w.id === id && !Object.is(view, w.view) ? { ...w, view } : w)),\n      }));\n      scheduleFlush();\n    },\n\n    updateTrialUndoStack: (id, next) => {\n      set((s) => ({\n        trials: s.trials.map((w) => {\n          if (w.id !== id) return w;\n          const undoStack =\n            typeof next === 'function'\n              ? (next as (prev: TrialRecord['undoStack']) => TrialRecord['undoStack'])(w.undoStack)\n              : next;\n          return { ...w, undoStack };\n        }),\n      }));\n    },\n\n    setTrialInstrument: (id, instrumentName) => {\n      set((s) => ({\n        trials: s.trials.map((w) => (w.id === id ? { ...w, instrumentName } : w)),\n      }));\n      scheduleFlush();\n    },\n\n    saveSnapshot: (trialId, name) => {\n      const trial = get().trials.find((w) => w.id === trialId);\n      if (!trial) return;\n      const reg = serializers[trial.instrumentName];\n      const serializedState = reg?.serialize\n        ? reg.serialize(trial.state)\n        : structuredClone(trial.state);\n      const clonedConfig = structuredClone(trial.config);\n      const lastAt = get().savedSnapshots.reduce((m, sn) => (sn.savedAt > m ? sn.savedAt : m), 0);\n      const savedAt = Math.max(Date.now(), lastAt + 1);\n      const snapshot: SavedSnapshot = {\n        id: crypto.randomUUID(),\n        name,\n        trialId,\n        instrumentName: trial.instrumentName,\n        config: clonedConfig,\n        state: serializedState,\n        savedAt,\n      };\n      set((s) => ({ savedSnapshots: [...s.savedSnapshots, snapshot] }));\n      scheduleFlush();\n    },\n\n    loadSnapshot: (snapshotId, trialId) => {\n      const snapshot = get().savedSnapshots.find((sn) => sn.id === snapshotId);\n      if (!snapshot) return;\n      const trial = get().trials.find((w) => w.id === trialId);\n      if (!trial) return;\n      if (snapshot.instrumentName !== trial.instrumentName) {\n        console.warn(\n          `[labkit] loadSnapshot: instrument mismatch (snapshot=${snapshot.instrumentName}, trial=${trial.instrumentName}); refusing to load`,\n        );\n        return;\n      }\n      const reg = serializers[snapshot.instrumentName];\n      const restoredState = reg?.deserialize ? reg.deserialize(snapshot.state) : snapshot.state;\n      set((s) => ({\n        trials: s.trials.map((w) =>\n          w.id === trialId ? { ...w, state: restoredState, config: snapshot.config } : w,\n        ),\n      }));\n      scheduleFlush();\n    },\n\n    deleteSnapshot: (snapshotId) => {\n      set((s) => ({\n        savedSnapshots: s.savedSnapshots.filter((sn) => sn.id !== snapshotId),\n      }));\n      scheduleFlush();\n    },\n\n    listSnapshots: (trialId) => {\n      const all = get().savedSnapshots;\n      const filtered = trialId ? all.filter((sn) => sn.trialId === trialId) : all;\n      return [...filtered].sort((a, b) => b.savedAt - a.savedAt);\n    },\n\n    setMode: (mode) => {\n      set({ mode });\n      scheduleFlush();\n    },\n\n    setLabTool: (id) => set({ activeToolId: id }),\n\n    setTrialTool: (trialId, id) =>\n      set((s) => ({\n        trials: s.trials.map((t) => (t.id === trialId ? { ...t, activeToolId: id } : t)),\n      })),\n\n    setLayout: (layout) => {\n      set({ layout });\n      scheduleFlush();\n    },\n  }));\n\n  function scheduleFlush(): void {\n    if (persistDisabled) return;\n    if (flushTimer) clearTimeout(flushTimer);\n    flushTimer = setTimeout(() => {\n      const s = store.getState();\n      const document: LabDocument = {\n        version: CURRENT_DOCUMENT_VERSION,\n        trials: serializeTrials(s.trials, serializers),\n        saves: s.savedSnapshots,\n        layout: s.layout,\n        mode: s.mode,\n      };\n      const serialized = JSON.stringify(document);\n      options.storage.write(labDocumentKey(options.storageKey), serialized);\n      if (foldedFromLegacy && deleteLegacyKeys(options.storage, options.storageKey, serialized)) {\n        foldedFromLegacy = false;\n      }\n      flushTimer = null;\n    }, 300);\n  }\n\n  // A lab opened and closed without a single mutation still completes its\n  // fold; the flush is what removes the legacy keys.\n  if (foldedFromLegacy) scheduleFlush();\n\n  return Object.assign(store, {\n    registerSerializers(s: InstrumentSerializers) {\n      serializers = s;\n    },\n  });\n}\n\ninterface HydrateResult {\n  document: LabDocument;\n  /** True when flushing would destroy the only copy of something: a document\n   *  newer than this code understands, or an unusable one whose quarantine\n   *  copy did not land. */\n  persistDisabled: boolean;\n  foldedFromLegacy: boolean;\n}\n\n/** Copy an unusable document aside, and report whether the store may go on\n *  persisting. A failed quarantine write means the copy in storage is the only\n *  one there is, so the store must not overwrite it. */\nfunction setAside(\n  options: CreateLabStoreOptions,\n  raw: string,\n  why: string,\n  error?: unknown,\n): boolean {\n  const quarantined = quarantineDocument(options.storage, options.storageKey, raw);\n  const message = quarantined\n    ? `[labkit] ${why}; quarantined it and starting empty`\n    : `[labkit] ${why} and could not be quarantined; leaving it in place and not persisting`;\n  if (error === undefined) console.warn(message);\n  else console.warn(message, error);\n  return quarantined;\n}\n\nfunction hydrateDocument(options: CreateLabStoreOptions): HydrateResult {\n  const fallback = emptyDocument(options.initialMode ?? 'auto');\n  const raw = options.storage.read(labDocumentKey(options.storageKey));\n\n  let parsed: Record<string, unknown> | null = null;\n  if (raw !== null) {\n    try {\n      parsed = JSON.parse(raw) as Record<string, unknown>;\n    } catch {\n      const persistDisabled = !setAside(options, raw, 'lab document is unparseable');\n      return { document: fallback, persistDisabled, foldedFromLegacy: false };\n    }\n  } else {\n    parsed = readLegacyDocument(options.storage, options.storageKey, options.initialMode ?? 'auto');\n  }\n\n  if (parsed === null) {\n    return { document: fallback, persistDisabled: false, foldedFromLegacy: false };\n  }\n\n  const foldedFromLegacy = raw === null;\n  const outcome = runMigrations(parsed, MIGRATIONS, CURRENT_DOCUMENT_VERSION);\n\n  if (!outcome.ok) {\n    if (outcome.reason === 'future') {\n      console.warn(\n        '[labkit] lab document is from a newer version of labkit; starting empty and leaving it alone',\n      );\n      return { document: fallback, persistDisabled: true, foldedFromLegacy: false };\n    }\n    const stored = JSON.stringify(parsed);\n    const persistDisabled = !setAside(\n      options,\n      stored,\n      'lab document failed to migrate',\n      outcome.error,\n    );\n    return { document: fallback, persistDisabled, foldedFromLegacy: false };\n  }\n\n  return {\n    document: normalizeDocument(outcome.doc, options.initialMode ?? 'auto'),\n    persistDisabled: false,\n    foldedFromLegacy,\n  };\n}\n","import { useContext } from 'react';\nimport { useStore } from 'zustand/react';\nimport { LabStoreContext, TrialIdContext } from './context';\nimport type { TrialStateHandle } from './types';\n\n/** An instrument's own state and config, plus setters. Reads the surrounding\n *  trial id, so an instrument never has to know which trial it is\n *  running in. Throws outside a lab store and trial. */\nexport function useTrialState<TS = unknown, TC = unknown>(): TrialStateHandle<TS, TC> {\n  const ctx = useContext(LabStoreContext);\n  if (!ctx) throw new Error('[labkit] useTrialState must be used inside <LabStoreProvider>');\n\n  const trialId = useContext(TrialIdContext);\n  if (!trialId) throw new Error('[labkit] useTrialState must be used inside <TrialIdProvider>');\n\n  const record = useStore(ctx.store, (s) => s.trials.find((w) => w.id === trialId));\n\n  if (!record) throw new Error(`[labkit] No trial found with id \"${trialId}\"`);\n\n  const updateTrialState = useStore(ctx.store, (s) => s.updateTrialState);\n  const updateTrialConfig = useStore(ctx.store, (s) => s.updateTrialConfig);\n\n  return {\n    state: record.state as TS,\n    config: record.config as TC,\n    setState: (next) => updateTrialState(trialId, next as Parameters<typeof updateTrialState>[1]),\n    setConfig: (key, value) => updateTrialConfig(trialId, key as never, value as never),\n  };\n}\n"]}