@weasel-js/labkit 1.7.3 → 1.8.1

package/README.md

@@ -74,6 +74,20 @@ names another substrate: `localStorageAdapter`, `sessionStorageAdapter`,
 `urlHashAdapter`, or your own `StorageAdapter` over a server. The lab renders
 `fallback` while it loads. Leave `storageKey` off and nothing persists.
 
+### Presenting a lab
+
+`<Lab present>` shows one trial and nothing else — no lab chrome, no trial
+chrome, a transparent ground — for embedding a lab as a figure. `?present` in
+the page's URL does the same, so one build serves both the lab and its embed.
+`seed={{ instrument, config, state, view }}` says what that trial opens on. A
+stored lab presents from records of its own (`storageKey` + `':present'`), so
+an embed never shows a visitor their last session in the full lab or writes
+into it; changing the seed reopens the trial on it for returning visitors.
+
+Inside any lab, `usePresentation()` gives `{ active, enter, exit }`: `enter`
+presents the focused trial and Escape returns. Nothing unmounts either way, so
+a canvas keeps its context and a clock its place.
+
 A widget's own state persists the same way through `usePersistedState(name,
 initial)`, which is `useState` whose value survives a reload — kept per trial
 inside one, and plain `useState` wherever no `<Lab>` or `<Persistence>` is
@@ -279,6 +293,16 @@ import { LabShell, Workspace } from '@weasel-js/labkit';
 </LabShell>;
 ```
 
+Every tile has an expand button in its corner that shows it large over the
+page; Escape, a click in the margin, or the close button puts it back. The tile
+is lifted into the browser's top layer rather than remounted, so a WebGL
+context inside it keeps running and only sees its box grow. A double-click
+opens it too where you ask for that — `expandOnDoubleClick={(id) => id ===
+'output'}` for an image tile. Turn the lightbox off with `lightbox={false}`, or
+per tile with `lightbox={(id) => …}`; the same behavior is available outside a
+workspace as `<Lightbox>`. In a `<Lab>` every trial has the toggle in its title
+bar, and its shared-surface pixels — annotation marks, a 3D view — come along.
+
 `<Toolbar>`, `<Sidebar>`, `<StatusBar>`, `<FpsMeter>`, `<ScaleIndicator>`,
 `<Legend>`, `<FloatingPanel>`, `<ZoomControl>` and the `@weasel-js/ui` property
 rows re-exported from the root are all usable this way. `<Trial>` is not: it

package/dist/_dts/{CanvasStackContext-Cjy6I-Iv.d.ts → CanvasStackContext-B05ZM04l.d.ts}

@@ -1,12 +1,14 @@
 import * as react from 'react';
 import { RefObject } from 'react';
-import { a as ViewTransform, W as WorldFrame, b as WorldSpec } from './index-DCMA4Fy1.js';
+import { a as ViewTransform, W as WorldFrame, b as WorldSpec } from './index-8geQNQet.js';
 
 /** One layer of a canvas stack: its id, whether it is currently shown, and how
  *  it paints itself. */
 interface CanvasLayerDescriptor {
     id: string;
     visible: boolean;
+    /** Repaint on every `ticks` frame, not only when `render` or the view change. */
+    timed?: boolean;
     render: (ctx: CanvasRenderingContext2D, view: ViewTransform, frame: WorldFrame) => void;
 }
 

package/dist/_dts/{Stage-D6t7o0pF.d.ts → Stage-CIJlbjrE.d.ts}

@@ -1,8 +1,8 @@
 import * as react from 'react';
 import { RefObject, ReactNode } from 'react';
 import { ViewApi, Yoke } from '@weasel-js/core';
-import { W as WorldFrame, P as Point, a as ViewTransform, b as WorldSpec, V as ViewportSize } from './index-DCMA4Fy1.js';
-import { C as CanvasLayerDescriptor } from './CanvasStackContext-Cjy6I-Iv.js';
+import { W as WorldFrame, P as Point, a as ViewTransform, b as WorldSpec, V as ViewportSize } from './index-8geQNQet.js';
+import { C as CanvasLayerDescriptor } from './CanvasStackContext-B05ZM04l.js';
 
 /** The view id the stage publishes its pointer under. */
 declare const STAGE_VIEW_ID = "stage";
@@ -102,12 +102,14 @@ interface CanvasStackProps {
     /** A yoke to join, from `useYoke()`: cameras on one yoke share their tool
      *  and gesture in flight. Omitted, this one keeps its own. */
     yoke?: Yoke;
+    /** Frames after each of which every `timed` layer repaints — a trial clock's. */
+    ticks?: (fn: () => void) => () => void;
 }
 /** 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 and device pixel ratio; pan and zoom route through weasel's
  *  gesture dispatcher (`<CameraInput>`). */
-declare function CanvasStack({ layers, view: viewProp, onViewChange, worldSpec, minZoom, maxZoom, width, height, className, onResize, onHitTest, children, yoke, }: CanvasStackProps): react.JSX.Element;
+declare function CanvasStack({ layers, view: viewProp, onViewChange, worldSpec, minZoom, maxZoom, width, height, className, onResize, onHitTest, children, yoke, ticks, }: CanvasStackProps): react.JSX.Element;
 
 /** Bounds and coordinate system a {@link zoomAt} works in. */
 interface ZoomAtOptions {

package/dist/_dts/{index-DCMA4Fy1.d.ts → index-8geQNQet.d.ts}

@@ -1,8 +1,8 @@
 import { StanceProps } from '@weasel-js/ui';
-import { View, DrawCommand, Scene, PointerContextValue } from '@weasel-js/core';
+import { History, View, DrawCommand, Scene, PointerContextValue } from '@weasel-js/core';
 import { RefObject, ComponentType, ReactNode } from 'react';
 import { ColorModePreference } from '@weasel-js/theme';
-import { R as ResolvedConfig, n as ConfigPath, V as ValueAtPath, a as ConfigField, C as ConfigSchema } from './types-BUBSIZuV.js';
+import { R as ResolvedConfig, n as ConfigPath, V as ValueAtPath, a as ConfigField, C as ConfigSchema } from './types-DUfQ0isU.js';
 import { Rect } from '@weasel-js/geom';
 import { J as JobHandle, a as JobCapability } from './types-DJ79Tg5J.js';
 
@@ -36,12 +36,6 @@ declare function undockPanel(panels: UndockedPanels, trialId: string, sectionId:
  *  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. */
@@ -90,7 +84,16 @@ interface TrialRecord<TS = unknown, TC = unknown, TV = unknown> {
      *  no `annotations` — or declares its own `storage`. Not in `state`, which
      *  belongs to the instrument and is typed as such. */
     annotations?: unknown;
-    undoStack: UndoStack;
+    /** This trial's undo history over `state`, made by the trial on its first
+     *  snapshot. Session-only: absent on a new, cloned, swapped or reloaded
+     *  trial, which is how each starts with an empty history. */
+    history?: History;
+    /** Where the trial's clock stood at its last rate or seek change, for a
+     *  trial whose instrument declares `clock`. */
+    clock?: {
+        elapsed: number;
+        rate: number;
+    };
 }
 /** A named, saved copy of a trial's config and state, restorable into any
  *  trial running the same instrument. */
@@ -206,7 +209,7 @@ type InstrumentSerializers = Record<string, {
 } | undefined>;
 /** A trial as it is persisted: everything but the undo history, which is
  *  session-only. */
-type SerializedTrial = Omit<TrialRecord, 'undoStack'>;
+type SerializedTrial = Omit<TrialRecord, 'history'>;
 /** Everything a lab persists, under one key, at a known version. */
 interface LabDocument {
     version: number;
@@ -776,6 +779,13 @@ interface TrialChromeContext extends ToolSlotContext, SidebarSlotContext {
     /** Whether the trial's loupe is turned on. */
     loupeOn: boolean;
     toggleLoupe: () => void;
+    /** Whether the trial sits in a `<Lightbox>` — every `<Workspace>` tile does
+     *  unless the workspace turned it off. The expand toggle is offered only
+     *  while it does. */
+    canExpand: boolean;
+    /** Whether the trial is showing in its lightbox. */
+    expanded: boolean;
+    toggleExpanded: () => void;
     /** The instrument's controls, resolved against the lab's rules. Always
      *  populated: a legacy `configSchema()` is adapted into the same shape. */
     configSchema: ResolvedConfig;
@@ -808,6 +818,56 @@ interface TrialChromeContext extends ToolSlotContext, SidebarSlotContext {
     close: () => void;
 }
 
+/**
+ * What an instrument declares to get a clock: how long a pass runs, how many
+ * passes, and how it opens. Shaped like a blits voice spec.
+ */
+interface ClockCapability {
+    /** ms per pass. Omitted, the run never ends. */
+    duration?: number;
+    /** Passes: `true` endless, `false` one, `n` that many. Default `false`. */
+    loop?: boolean | number;
+    /** The rate it opens at; `0`, the default, opens paused. */
+    rate?: number;
+    /** `false` for an instrument whose state is built up by running, so time can
+     *  only move by running: no seek and no negative rate. Default `true`. */
+    seekable?: boolean;
+}
+/**
+ * A trial's time. A position (`elapsed`) moved by a signed `rate`, synced by
+ * the lab's frame loop once a frame. Named after blits' owner handle and
+ * `Ticked`, so a blits ticker can drive one and blits voices can play under it.
+ */
+interface TrialClock {
+    /** ms the trial has played, rate applied, counted across passes. */
+    readonly elapsed: number;
+    /** Which pass `elapsed` falls in, 0 first; the last once the run is over. */
+    readonly pass: number;
+    /** How far through its pass, 0 to 1; 1 once the run is over. 0 with no duration. */
+    readonly phase: number;
+    /** Signed: 0 pauses and a negative rate plays backward. A write changes speed
+     *  at once and replaces any ramp. */
+    rate: number;
+    /** Passes, as `ClockCapability.loop`. */
+    loop: boolean | number;
+    /** Move `rate` to `to` linearly over `over` real ms; position stays continuous. */
+    ramp(to: number, over: number): void;
+    /** Move to `elapsed` ms from the start, clamped to the run. Never runs state
+     *  forward to meet it. Throws on a clock that is not seekable. */
+    seek(elapsed: number): void;
+    /** The frame loop reports the time, once a frame. */
+    sync(timestamp: number): void;
+    /** The time between now and the next sync does not count. */
+    rebase(): void;
+    /** Another frame would change nothing: paused, no ramp, nothing changed since
+     *  the last sync. */
+    readonly inert: boolean;
+    /** Called when a change needs frames again, once until the next sync. */
+    onWake(fn: () => void): () => void;
+    /** Called on a rate, seek or loop change, and when the run ends; never per frame. */
+    subscribe(fn: () => void): () => void;
+}
+
 /**
  * A tool a trial can be in. labkit's own — core's `ToolsApi` carries hotkey
  * slots, ambient tools, eligibility tiers and canvas overlay layers, all bound
@@ -862,6 +922,8 @@ interface RenderContext<TS = unknown, TC = unknown> {
          * reading it works over either view.
          */
         pointer: PointerContextValue;
+        /** The trial's clock, present when the instrument declares `clock`. */
+        clock?: TrialClock;
     };
     emit: (event: string) => void;
     /** Present only when the instrument declares a `job`. */
@@ -874,10 +936,17 @@ interface RenderContext<TS = unknown, TC = unknown> {
  *  set `ctx.lineWidth = 1 / zoom` to keep a hairline hairline. */
 interface CanvasLayer<TS = unknown, TC = unknown> {
     id: string;
+    /** Redraw every frame the trial's clock moves, not only when state, config
+     *  or the view change. For a layer that reads `elapsed`, `pass` or `phase`. */
+    timed?: boolean;
     draw: (ctx: CanvasRenderingContext2D, args: {
         state: TS;
         config: TC;
         zoom: number;
+        /** The trial clock's, as `TrialClock` has them; 0 with no clock. */
+        elapsed: number;
+        pass: number;
+        phase: number;
     }) => void;
 }
 /** Declares that an instrument draws to a canvas: its layers, and where the
@@ -1023,6 +1092,9 @@ interface Instrument<TS = unknown, TC = unknown, TItem = unknown> {
     annotations?: AnnotationsCapability<TS, TC>;
     /** Chrome this instrument contributes beyond what its capabilities imply. */
     chrome?: TrialContribution[];
+    /** Gives the trial a clock: playback time that layers, renderers and chrome
+     *  read and drive. */
+    clock?: ClockCapability;
     /** Work too slow to do during a render. The runtime starts it, aborts it on
      *  unmount and on a `key` change, and renders progress into the trial. */
     job?: JobCapability<TS, TC, TItem>;
@@ -1032,5 +1104,5 @@ interface Instrument<TS = unknown, TC = unknown, TItem = unknown> {
  *  an `Instrument<unknown, unknown>[]`; it is contained to this alias. */
 type InstrumentList = readonly Instrument<any, any, any>[];
 
-export { DEFAULT_FRAME as D, fracEncloses as aA, fracToWorld as aB, isAuto as aC, markCommands as aD, roundFrac as aE, worldToFrac as aF, annotationsFromJSON as av, auto as aw, createAnnotationScene as ax, createAnnotationStore as ay, fracContains as az, dockPanel as j, applyCamera as k, panelKey as p, resolveFrame as r, undockPanel as u };
-export type { AnnotationSelectionMode as $, AnnotationMeaning as A, CaptureResult as B, CreateLabStoreOptions as C, PaintableMark as E, AnnotationTarget as F, AnnotationsApi as G, AnnotationsCapability as H, InstrumentSerializers as I, TrialInfo as J, TrialTool as K, LabDocument as L, Migration as M, AnnotationKind as N, Instrument as O, Point as P, LabDensity as Q, TrialContribution as R, SerializedTrial as S, TrialRecord as T, UndoStack as U, ViewportSize as V, WorldFrame as W, Annotation as X, AnnotationInit as Y, AnnotationPatch as Z, AnnotationQuery as _, ViewTransform as a, AnnotationStatus as a0, AnnotationStoreOptions as a1, AnnotationTargetInfo as a2, AnnotationToolId as a3, Auto as a4, CanvasCapability as a5, CanvasLayer as a6, CaptureDeps as a7, ContributionBase as a8, FracPoint as a9, FracRect as aa, HitResult as ab, IconComponent as ac, LayerCapability as ad, LayerDescriptor as ae, RegionContribution as af, RenderContext as ag, SerializedAnnotations as ah, SidebarSection as ai, SidebarSlotContext as aj, StageCapability as ak, StatusReadout as al, SystemEvent as am, ToolCapability as an, ToolItem as ao, ToolSlotContext as ap, ToolbarItem as aq, TrialChromeContext as ar, TrialRegion as as, UndoCapability as at, ViewportControl as au, WorldSpec as b, StorageAdapter as c, LabStoreState as d, SavedSnapshot as e, StorageChange as f, TrialStateHandle as g, UndockedPanel as h, UndockedPanels as i, PaletteItem as l, DragFeedback as m, DragDropCapability as n, LabMode as o, InstrumentList as q, InstrumentHooks as s, AnnotationData as t, WorldRect as v, MarkStyle as w, MarkScene as x, CaptureSource as y, CaptureOptions as z };
+export { DEFAULT_FRAME as D, fracContains as aA, fracEncloses as aB, fracToWorld as aC, isAuto as aD, markCommands as aE, roundFrac as aF, worldToFrac as aG, annotationsFromJSON as aw, auto as ax, createAnnotationScene as ay, createAnnotationStore as az, dockPanel as i, applyCamera as j, panelKey as p, resolveFrame as r, undockPanel as u };
+export type { AnnotationSelectionMode as $, AnnotationMeaning as A, PaintableMark as B, CreateLabStoreOptions as C, AnnotationTarget as E, AnnotationsApi as F, AnnotationsCapability as G, TrialInfo as H, InstrumentSerializers as I, TrialTool as J, AnnotationKind as K, LabDocument as L, Migration as M, TrialClock as N, Instrument as O, Point as P, LabDensity as Q, TrialContribution as R, SerializedTrial as S, TrialRecord as T, UndockedPanel as U, ViewportSize as V, WorldFrame as W, Annotation as X, AnnotationInit as Y, AnnotationPatch as Z, AnnotationQuery as _, ViewTransform as a, AnnotationStatus as a0, AnnotationStoreOptions as a1, AnnotationTargetInfo as a2, AnnotationToolId as a3, Auto as a4, CanvasCapability as a5, CanvasLayer as a6, CaptureDeps as a7, ClockCapability as a8, ContributionBase as a9, FracPoint as aa, FracRect as ab, HitResult as ac, IconComponent as ad, LayerCapability as ae, LayerDescriptor as af, RegionContribution as ag, RenderContext as ah, SerializedAnnotations as ai, SidebarSection as aj, SidebarSlotContext as ak, StageCapability as al, StatusReadout as am, SystemEvent as an, ToolCapability as ao, ToolItem as ap, ToolSlotContext as aq, ToolbarItem as ar, TrialChromeContext as as, TrialRegion as at, UndoCapability as au, ViewportControl as av, WorldSpec as b, StorageAdapter as c, LabStoreState as d, SavedSnapshot as e, StorageChange as f, TrialStateHandle as g, UndockedPanels as h, PaletteItem as k, DragFeedback as l, DragDropCapability as m, LabMode as n, InstrumentList as o, InstrumentHooks as q, AnnotationData as s, WorldRect as t, MarkStyle as v, MarkScene as w, CaptureSource as x, CaptureOptions as y, CaptureResult as z };

package/dist/_dts/{index-BTmaRy6a.d.ts → index-DRi3V5sN.d.ts}

@@ -1,10 +1,11 @@
-import { c as ControlRenderer, b as ConfigRule } from './types-BUBSIZuV.js';
-import { O as Instrument, ar as TrialChromeContext, R as TrialContribution, T as TrialRecord, q as InstrumentList, e as SavedSnapshot, o as LabMode, ap as ToolSlotContext, a8 as ContributionBase, aq as ToolbarItem, ao as ToolItem, ai as SidebarSection, al as StatusReadout, K as TrialTool, af as RegionContribution, aj as SidebarSlotContext } from './index-DCMA4Fy1.js';
+import { c as ControlRenderer, b as ConfigRule } from './types-DUfQ0isU.js';
+import { O as Instrument, as as TrialChromeContext, R as TrialContribution, T as TrialRecord, o as InstrumentList, e as SavedSnapshot, n as LabMode, aq as ToolSlotContext, a9 as ContributionBase, ar as ToolbarItem, ap as ToolItem, aj as SidebarSection, am as StatusReadout, J as TrialTool, ag as RegionContribution, ak as SidebarSlotContext } from './index-8geQNQet.js';
 import * as react from 'react';
 import { ReactNode } from 'react';
 
 /** Built-in ids contributed only while runtime state says so — the loupe
- *  toggle appears once a lens mounts, after the trial's first render. */
+ *  toggle appears once a lens mounts, after the trial's first render, and the
+ *  expand toggle only inside a lightbox. */
 declare const TRANSIENT_BUILTINS: ReadonlySet<string>;
 /**
  * The contributions a trial gets from what its instrument declared. This is
@@ -208,7 +209,8 @@ interface StatusRegionProps<TCtx = TrialChromeContext> {
     /** Which region's readouts to lay out; the lab's footer is `footer`. */
     region?: string;
 }
-/** Lays a bar's readouts out. */
+/** Lays a bar's readouts out. The first one marked `end`, and every one after
+ *  it, sits at the far end. */
 declare function StatusRegion<TCtx = TrialChromeContext>({ contributions, ctx, region, }: StatusRegionProps<TCtx>): react.JSX.Element | null;
 
 /** Which end of the title bar a `<TitleBarRegion>` lays out: `'lead'` renders

package/dist/_dts/{types-BUBSIZuV.d.ts → types-DUfQ0isU.d.ts}

@@ -1,4 +1,4 @@
-import { Display } from '@weasel-js/quantity';
+import { Display, InfinityText } from '@weasel-js/quantity';
 import { PrefNumberUnit, PrefRenderer, PrefLeaf, PrefGroup } from '@weasel-js/ui';
 import { ReactNode } from 'react';
 
@@ -34,6 +34,10 @@ interface Annotations {
     /** Display-unit conversion for a number stored in a canonical unit — the
      *  value, its bounds and its step all convert at the control's edge. */
     unit?: PrefNumberUnit;
+    /** Which end of a number's slider stands for infinity. */
+    endless?: 'min' | 'max' | 'both';
+    /** The word a number's infinity shows as — `'never'`. Default `∞`. */
+    infinity?: InfinityText;
     /** A color leaf's value carries alpha (`#rrggbbaa`) and its row edits it. */
     alpha?: boolean;
     control?: string;

package/dist/_dts/{useTrialState-Bh8bzFgE.d.ts → useTrialState-Ar0AFpCe.d.ts}

@@ -1,42 +1,47 @@
-import { c as StorageAdapter, d as LabStoreState, T as TrialRecord, e as SavedSnapshot, o as LabMode, h as UndockedPanel, q as InstrumentList, s as InstrumentHooks, C as CreateLabStoreOptions, g as TrialStateHandle } from './index-DCMA4Fy1.js';
+import { d as LabStoreState, T as TrialRecord, e as SavedSnapshot, n as LabMode, U as UndockedPanel, o as InstrumentList, q as InstrumentHooks, C as CreateLabStoreOptions, c as StorageAdapter, g as TrialStateHandle } from './index-8geQNQet.js';
 import * as react from 'react';
 import { ReactNode, ReactElement, Dispatch, SetStateAction } from 'react';
+import { History } from '@weasel-js/core';
 import { StoreApi } from 'zustand/vanilla';
 
-/** Persist to `localStorage`, one JSON value per record. Survives a reload and
- *  reaches other tabs through the `storage` event. */
-declare const localStorageAdapter: StorageAdapter;
-/** Persist to `sessionStorage` — 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. Changes to the fragment made elsewhere — a pasted
- *  link, back and forward — arrive through `hashchange`. */
-declare const urlHashAdapter: StorageAdapter;
-/** An in-memory store, discarded on reload. Values are copied in and out, as a
- *  real substrate would. Adapters built over one shared `backing` hear each
- *  other's writes — two tabs, for a test. */
-declare function createMemoryAdapter(backing?: Map<string, unknown>): StorageAdapter;
-/** Persists nothing and reads back nothing. */
-declare const noneAdapter: StorageAdapter;
-/** Options for `createIndexedDbAdapter`. */
-interface IndexedDbAdapterOptions {
-    /** Default `'labkit'`. */
-    database?: string;
-    /** Default `'records'`. One object store per database: a store added to a
-     *  database that already exists is not created. */
-    store?: string;
+/** One record changing, as a cache listener hears it. `value` is `undefined`
+ *  for a delete. `local` changes were made through this cache; `remote` ones
+ *  came from another writer. */
+interface RecordChange {
+    name: string;
+    value: unknown;
+    origin: 'local' | 'remote';
+}
+/**
+ * Every record under one prefix, held in memory: the only thing that talks to
+ * a `StorageAdapter`. Names are keys with the prefix removed.
+ *
+ * Writes land in memory at once and reach storage on a debounce. The newest
+ * write to a record wins: another writer's change to a record with a write
+ * still queued here is ignored, since the queued write lands after it.
+ */
+interface RecordCache {
+    readonly prefix: string;
+    /** False once writing is off — the records could not be read, or were
+     *  written by a newer labkit — so nothing here can overwrite them. */
+    readonly writable: boolean;
+    has(name: string): boolean;
+    get(name: string): unknown;
+    /** Every record whose name starts with `namePrefix`. */
+    entries(namePrefix?: string): [string, unknown][];
+    set(name: string, value: unknown): void;
+    delete(name: string): void;
+    subscribe(listener: (changes: RecordChange[]) => void): () => void;
+    /** Send queued writes now. */
+    flush(): Promise<void>;
+    /** Send queued writes and stop hearing other writers. */
+    close(): Promise<void>;
 }
-/** Persist to IndexedDB, which stores structured-clone values natively — typed
- *  arrays, `Map`s, `Blob`s — and holds far more than localStorage. Other tabs
- *  hear writes through a `BroadcastChannel`. The database opens on first use. */
-declare function createIndexedDbAdapter({ database, store, }?: IndexedDbAdapterOptions): StorageAdapter;
-/** IndexedDB under the default database and store. */
-declare const indexedDbAdapter: 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;
+    addTrial: (record: Omit<TrialRecord, 'history'>) => 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
@@ -49,7 +54,13 @@ interface LabStoreActions {
     /** 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;
+    /** Give a trial the undo history it made on its first snapshot. */
+    setTrialHistory: (id: string, history: History) => void;
+    /** Record where a trial's clock stands. */
+    updateTrialClock: (id: string, clock: {
+        elapsed: number;
+        rate: number;
+    }) => void;
     setTrialInstrument: (id: string, instrumentName: string) => void;
     saveSnapshot: (trialId: string, name: string) => void;
     loadSnapshot: (snapshotId: string, trialId: string) => void;
@@ -78,6 +89,58 @@ type LabStore = StoreApi<LabStoreState & LabStoreActions>;
  *  it. */
 declare function createLabStore(options?: CreateLabStoreOptions): LabStore;
 
+/** Options for `openLabStore`. `storageKey` names the lab, so two labs on one
+ *  origin keep separate records. */
+interface OpenLabStoreOptions extends Omit<CreateLabStoreOptions, 'initial'> {
+    storageKey: string;
+    storage: StorageAdapter;
+}
+/** A lab store bound to its records. */
+interface OpenedLabStore {
+    store: LabStore;
+    /** Every record of the lab, `usePersistedState` values included. */
+    records: RecordCache;
+    /** Send queued writes and stop hearing other writers. */
+    close(): Promise<void>;
+}
+/**
+ * Read a stored lab and return a store bound to it: every change to the store
+ * is written as the records it touched, and another writer's records are
+ * applied back into the store. A lab stored before records existed is folded
+ * forward on the way in.
+ */
+declare function openLabStore(options: OpenLabStoreOptions): Promise<OpenedLabStore>;
+
+/** Persist to `localStorage`, one JSON value per record. Survives a reload and
+ *  reaches other tabs through the `storage` event. */
+declare const localStorageAdapter: StorageAdapter;
+/** Persist to `sessionStorage` — 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. Changes to the fragment made elsewhere — a pasted
+ *  link, back and forward — arrive through `hashchange`. */
+declare const urlHashAdapter: StorageAdapter;
+/** An in-memory store, discarded on reload. Values are copied in and out, as a
+ *  real substrate would. Adapters built over one shared `backing` hear each
+ *  other's writes — two tabs, for a test. */
+declare function createMemoryAdapter(backing?: Map<string, unknown>): StorageAdapter;
+/** Persists nothing and reads back nothing. */
+declare const noneAdapter: StorageAdapter;
+/** Options for `createIndexedDbAdapter`. */
+interface IndexedDbAdapterOptions {
+    /** Default `'labkit'`. */
+    database?: string;
+    /** Default `'records'`. One object store per database: a store added to a
+     *  database that already exists is not created. */
+    store?: string;
+}
+/** Persist to IndexedDB, which stores structured-clone values natively — typed
+ *  arrays, `Map`s, `Blob`s — and holds far more than localStorage. Other tabs
+ *  hear writes through a `BroadcastChannel`. The database opens on first use. */
+declare function createIndexedDbAdapter({ database, store, }?: IndexedDbAdapterOptions): StorageAdapter;
+/** IndexedDB under the default database and store. */
+declare const indexedDbAdapter: StorageAdapter;
+
 type LabStoreCtx = {
     store: LabStore;
 } | null;
@@ -112,62 +175,6 @@ declare function labDocumentKey(storageKey: string): string;
  *  loses state loudly rather than silently. */
 declare function quarantineKey(storageKey: string): string;
 
-/** One record changing, as a cache listener hears it. `value` is `undefined`
- *  for a delete. `local` changes were made through this cache; `remote` ones
- *  came from another writer. */
-interface RecordChange {
-    name: string;
-    value: unknown;
-    origin: 'local' | 'remote';
-}
-/**
- * Every record under one prefix, held in memory: the only thing that talks to
- * a `StorageAdapter`. Names are keys with the prefix removed.
- *
- * Writes land in memory at once and reach storage on a debounce. The newest
- * write to a record wins: another writer's change to a record with a write
- * still queued here is ignored, since the queued write lands after it.
- */
-interface RecordCache {
-    readonly prefix: string;
-    /** False once writing is off — the records could not be read, or were
-     *  written by a newer labkit — so nothing here can overwrite them. */
-    readonly writable: boolean;
-    has(name: string): boolean;
-    get(name: string): unknown;
-    /** Every record whose name starts with `namePrefix`. */
-    entries(namePrefix?: string): [string, unknown][];
-    set(name: string, value: unknown): void;
-    delete(name: string): void;
-    subscribe(listener: (changes: RecordChange[]) => void): () => void;
-    /** Send queued writes now. */
-    flush(): Promise<void>;
-    /** Send queued writes and stop hearing other writers. */
-    close(): Promise<void>;
-}
-
-/** Options for `openLabStore`. `storageKey` names the lab, so two labs on one
- *  origin keep separate records. */
-interface OpenLabStoreOptions extends Omit<CreateLabStoreOptions, 'initial'> {
-    storageKey: string;
-    storage: StorageAdapter;
-}
-/** A lab store bound to its records. */
-interface OpenedLabStore {
-    store: LabStore;
-    /** Every record of the lab, `usePersistedState` values included. */
-    records: RecordCache;
-    /** Send queued writes and stop hearing other writers. */
-    close(): Promise<void>;
-}
-/**
- * Read a stored lab and return a store bound to it: every change to the store
- * is written as the records it touched, and another writer's records are
- * applied back into the store. A lab stored before records existed is folded
- * forward on the way in.
- */
-declare function openLabStore(options: OpenLabStoreOptions): Promise<OpenedLabStore>;
-
 /** Props for `<Persistence>`. */
 interface PersistenceProps {
     /** Names the records, as `<Lab storageKey>` does. A lab and a

package/dist/canvas/index.d.ts

@@ -1,13 +1,13 @@
-export { C as CameraContext, a as CameraContextValue, b as CameraInput, c as CameraInputProps, d as CameraPublishContext, e as CameraRegistry, f as CameraRegistryContext, g as CameraScope, h as CameraView, i as CameraViewOptions, j as CanvasStack, k as CanvasStackProps, S as STAGE_VIEW_ID, l as Stage, m as StageProps, Z as ZoomAtOptions, n as ZoomRange, o as centerOn, p as createCameraRegistry, q as fitStage, s as screenToWorld, u as useCameraView, r as usePublishCamera, w as worldToScreen, z as zoomAt } from '../_dts/Stage-D6t7o0pF.js';
+export { C as CameraContext, a as CameraContextValue, b as CameraInput, c as CameraInputProps, d as CameraPublishContext, e as CameraRegistry, f as CameraRegistryContext, g as CameraScope, h as CameraView, i as CameraViewOptions, j as CanvasStack, k as CanvasStackProps, S as STAGE_VIEW_ID, l as Stage, m as StageProps, Z as ZoomAtOptions, n as ZoomRange, o as centerOn, p as createCameraRegistry, q as fitStage, s as screenToWorld, u as useCameraView, r as usePublishCamera, w as worldToScreen, z as zoomAt } from '../_dts/Stage-CIJlbjrE.js';
 import * as react from 'react';
-export { C as CanvasLayerDescriptor, a as CanvasStackContext, b as CanvasStackContextValue, c as CanvasStackSurface } from '../_dts/CanvasStackContext-Cjy6I-Iv.js';
+export { C as CanvasLayerDescriptor, a as CanvasStackContext, b as CanvasStackContextValue, c as CanvasStackSurface } from '../_dts/CanvasStackContext-B05ZM04l.js';
 import { View } from '@weasel-js/core';
-import { W as WorldFrame } from '../_dts/index-DCMA4Fy1.js';
+import { W as WorldFrame } from '../_dts/index-8geQNQet.js';
 import { Point, ViewTransform } from '../index.js';
-export { D as DEFAULT_FRAME, V as ViewportSize, b as WorldSpec, k as applyCamera, r as resolveFrame } from '../_dts/index-DCMA4Fy1.js';
+export { D as DEFAULT_FRAME, V as ViewportSize, b as WorldSpec, j as applyCamera, r as resolveFrame } from '../_dts/index-8geQNQet.js';
 import '@weasel-js/ui';
 import '@weasel-js/theme';
-import '../_dts/types-BUBSIZuV.js';
+import '../_dts/types-DUfQ0isU.js';
 import '@weasel-js/quantity';
 import '@weasel-js/geom';
 import '../_dts/types-DJ79Tg5J.js';

package/dist/canvas/index.js

@@ -1,7 +1,7 @@
-export { CanvasStack, LinkedCursor, Stage, fitStage } from '../chunk-T6DLGEJB.js';
+export { CanvasStack, LinkedCursor, Stage, fitStage } from '../chunk-XWR2P6MR.js';
 export { centerOn, zoomAt } from '../chunk-ROGJWDQA.js';
 export { screenToWorld, worldToScreen } from '../chunk-FG3EXZDV.js';
-import '../chunk-WIG6XHJ7.js';
+import '../chunk-6IIKLXBZ.js';
 export { CameraContext, CameraInput, CameraPublishContext, CameraRegistryContext, CameraScope, CameraWheelContext, STAGE_VIEW_ID, clampZoomAbout, createCameraRegistry, frameLocalToWorld, fromCameraView, toCameraView, useCameraView, usePublishCamera } from '../chunk-VYVGVBGY.js';
 export { DEFAULT_FRAME, applyCamera, resolveFrame } from '../chunk-ULYYNWGP.js';
 export { CanvasStackContext } from '../chunk-ZQIHJXP4.js';

package/dist/chrome/index.d.ts

@@ -1,6 +1,6 @@
-export { a as LabAsideRegion, b as LabChromeContext, L as LabContribution, e as LabFooterRegion, f as LabHeaderRegion, g as LabRegion, h as LabRegionProps, i as LabSidebarRegion, P as PaletteRegion, j as PaletteRegionProps, S as SidebarRegion, k as SidebarRegionProps, l as StatusRegion, m as StatusRegionProps, T as TRANSIENT_BUILTINS, n as TitleBarPlacement, o as TitleBarRegion, p as TitleBarRegionProps, q as ToolbarRegion, r as ToolbarRegionProps, V as ViewportRegion, s as ViewportRegionProps, u as builtinContributions, x as contributionsIn, y as labContributions, z as mergeContributions, D as suppressContributions, E as toolContributions, F as useLabChromeContext } from '../_dts/index-BTmaRy6a.js';
-export { a8 as ContributionBase, ac as IconComponent, af as RegionContribution, ai as SidebarSection, aj as SidebarSlotContext, al as StatusReadout, ao as ToolItem, ap as ToolSlotContext, aq as ToolbarItem, ar as TrialChromeContext, R as TrialContribution, as as TrialRegion, au as ViewportControl } from '../_dts/index-DCMA4Fy1.js';
-import '../_dts/types-BUBSIZuV.js';
+export { a as LabAsideRegion, b as LabChromeContext, L as LabContribution, e as LabFooterRegion, f as LabHeaderRegion, g as LabRegion, h as LabRegionProps, i as LabSidebarRegion, P as PaletteRegion, j as PaletteRegionProps, S as SidebarRegion, k as SidebarRegionProps, l as StatusRegion, m as StatusRegionProps, T as TRANSIENT_BUILTINS, n as TitleBarPlacement, o as TitleBarRegion, p as TitleBarRegionProps, q as ToolbarRegion, r as ToolbarRegionProps, V as ViewportRegion, s as ViewportRegionProps, u as builtinContributions, x as contributionsIn, y as labContributions, z as mergeContributions, D as suppressContributions, E as toolContributions, F as useLabChromeContext } from '../_dts/index-DRi3V5sN.js';
+export { a9 as ContributionBase, ad as IconComponent, ag as RegionContribution, aj as SidebarSection, ak as SidebarSlotContext, am as StatusReadout, ap as ToolItem, aq as ToolSlotContext, ar as ToolbarItem, as as TrialChromeContext, R as TrialContribution, at as TrialRegion, av as ViewportControl } from '../_dts/index-8geQNQet.js';
+import '../_dts/types-DUfQ0isU.js';
 import '@weasel-js/quantity';
 import '@weasel-js/ui';
 import 'react';

package/dist/chrome/index.js

@@ -1,16 +1,16 @@
-export { LabAsideRegion, LabFooterRegion, LabHeaderRegion, LabSidebarRegion, PaletteRegion, SidebarRegion, StatusRegion, TRANSIENT_BUILTINS, TitleBarRegion, ToolbarRegion, ViewportRegion, builtinContributions, contributionsIn, labContributions, mergeContributions, suppressContributions, toolContributions, useLabChromeContext } from '../chunk-4X44DMRS.js';
+export { LabAsideRegion, LabFooterRegion, LabHeaderRegion, LabSidebarRegion, PaletteRegion, SidebarRegion, StatusRegion, TRANSIENT_BUILTINS, TitleBarRegion, ToolbarRegion, ViewportRegion, builtinContributions, contributionsIn, labContributions, mergeContributions, suppressContributions, toolContributions, useLabChromeContext } from '../chunk-RN7T7OBO.js';
 import '../chunk-3RY6WL5T.js';
-import '../chunk-4TJ34FXA.js';
+import '../chunk-RXO5UEGT.js';
 import '../chunk-CZZPXUOU.js';
-import '../chunk-PMLZP7RT.js';
-import '../chunk-XSJJTXNA.js';
+import '../chunk-7ALJOVGP.js';
+import '../chunk-YZA73U4A.js';
 import '../chunk-Z76KEZAX.js';
 import '../chunk-WLMDTI2Q.js';
 import '../chunk-READTDQX.js';
 import '../chunk-ZQIHJXP4.js';
 import '../chunk-2YILQ7Y5.js';
-import '../chunk-IRMPZIYU.js';
-import '../chunk-E23Q6A3Y.js';
-import '../chunk-XVUKDSYV.js';
+import '../chunk-V4SMGEYY.js';
+import '../chunk-VCK5T6EP.js';
+import '../chunk-AVOILDN2.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map