@weasel-js/labkit 1.3.0 → 1.4.0-pre.1

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

@@ -1,314 +0,0 @@
-import { ComponentType, ReactNode } from 'react';
-import { R as ResolvedConfig, C as ConfigField, a as ConfigSchema } from './types-DCGEcMO_.js';
-import { c as SavedSnapshot } from './types-1Sdxy_Pv.js';
-import { J as JobHandle, a as JobCapability } from './types-DJ79Tg5J.js';
-
-/** A named position in a trial's chrome. Content is not a region — that is
- *  the instrument. */
-type TrialRegion = 'titlebar' | 'toolbar' | 'palette' | 'sidebar' | 'viewport' | 'status';
-/** An icon component taking a pixel size, as `@weasel-js/ui` glyphs do. */
-type IconComponent = ComponentType<{
-    size?: number;
-}>;
-/** A button in the trial toolbar. */
-interface ToolbarItem {
-    icon: IconComponent;
-    label: string;
-    /** Shown in the tooltip. Not bound here — the trial owns its keymap. */
-    shortcut?: string;
-    disabled?: boolean;
-    /** Reddens on hover. For actions that discard work. */
-    danger?: boolean;
-    /** Render the label beside the glyph rather than only in the tooltip. */
-    showLabel?: boolean;
-    onActivate: () => void;
-}
-/** A selectable tool in the palette region. */
-interface ToolItem {
-    icon: IconComponent;
-    label: string;
-    shortcut?: string;
-    disabled?: boolean;
-}
-/** A titled block in the sidebar. */
-interface SidebarSection {
-    title: string;
-    /** Starts collapsed. The open/closed state itself is the region's. */
-    defaultCollapsed?: boolean;
-    body: ReactNode;
-}
-/** A control acting on the view of the trial, not on the trial. */
-interface ViewportControl {
-    icon: IconComponent;
-    label: string;
-    disabled?: boolean;
-    onActivate: () => void;
-}
-/** A readout in the status bar. */
-interface StatusReadout {
-    /** Short enough for a status bar. Rendered as text. */
-    text: string;
-    /** Tooltip. */
-    title?: string;
-}
-/** What every contribution shares. */
-interface ContributionBase {
-    id: string;
-    /** Groups sort by first appearance; items sort within a group by
-     *  declaration order. Contributions with no group sort after grouped ones. */
-    group?: string;
-    /** Pushes this contribution, and its group, to the far end of the region. */
-    end?: boolean;
-}
-/**
- * A contribution is data the chrome renders, keyed to a region. Supplying
- * `render` instead of `item` opts out of the chrome's layout — deliberate,
- * and visible in the declaration.
- */
-type TrialContribution = (ContributionBase & {
-    region: 'titlebar';
-    item: ToolbarItem;
-    render?: never;
-}) | (ContributionBase & {
-    region: 'toolbar';
-    item: ToolbarItem;
-    render?: never;
-}) | (ContributionBase & {
-    region: 'palette';
-    item: ToolItem;
-    render?: never;
-}) | (ContributionBase & {
-    region: 'sidebar';
-    item: SidebarSection;
-    render?: never;
-}) | (ContributionBase & {
-    region: 'viewport';
-    item: ViewportControl;
-    render?: never;
-}) | (ContributionBase & {
-    region: 'status';
-    item: StatusReadout;
-    render?: never;
-}) | (ContributionBase & {
-    region: TrialRegion;
-    item?: never;
-    render: (ctx: TrialChromeContext) => ReactNode;
-});
-/**
- * Everything a contribution can read about the trial it is being rendered
- * into. Replaces the three separate slot contexts, which each carried a
- * hand-picked subset.
- */
-interface TrialChromeContext {
-    trialId: string;
-    instrumentName: string;
-    isLastTrial: boolean;
-    /** Null when the trial holds a view that is not the 2D one. */
-    zoom: number | null;
-    setZoom: (z: number) => void;
-    canUndo: boolean;
-    canRedo: boolean;
-    undo: () => void;
-    redo: () => void;
-    /** The instrument's controls, resolved against the lab's rules. Always
-     *  populated: a legacy `configSchema()` is adapted into the same shape. */
-    configSchema: ResolvedConfig;
-    /** @deprecated Read `configSchema`. Empty for an instrument declaring
-     *  `config`, since a builder schema has no `ConfigField[]` form. */
-    configFields: ConfigField[];
-    config: unknown;
-    setConfig: (key: string, value: unknown) => void;
-    savedSnapshots: SavedSnapshot[];
-    saveSnapshot: (name?: string) => void;
-    loadSnapshot: (snapshotId: string) => void;
-    clone: () => void;
-    reset: () => void;
-    close: () => void;
-    /** Resolved active tool: the trial's slot, or the lab's when the trial has
-     *  none. Null when neither holds one. */
-    activeToolId: string | null;
-    setActiveTool: (id: string) => 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
- * to the gesture dispatcher, and a labkit instrument is an arbitrary canvas or
- * DOM tree rather than a weasel scene.
- */
-interface TrialTool {
-    id: string;
-    label: string;
-    icon: IconComponent;
-    /** Shown in the tooltip. Not bound here — the instrument owns its keymap. */
-    shortcut?: string;
-    /** Presentation grouping in the palette. Ungrouped tools sort after grouped. */
-    group?: string;
-}
-/** What an instrument declares to get a palette region. */
-interface ToolCapability {
-    tools: TrialTool[];
-    /** Which tool a fresh trial starts in. Defaults to the first. */
-    initial?: string;
-}
-
-/** What an instrument's `render` is handed: its state and config, the setters
- *  for both, the trial it is mounted in, and a way to emit named events. */
-interface RenderContext<TS = unknown, TC = unknown> {
-    state: TS;
-    config: TC;
-    setState: (next: TS | ((prev: TS) => TS)) => void;
-    setConfig: (key: keyof TC, value: unknown) => void;
-    trial: {
-        id: string;
-        /** The trial's view, in whatever shape this instrument chose. labkit persists
-         *  it and restores it on Reset without ever reading into it. */
-        view: unknown;
-        setView: (next: unknown) => void;
-        /** 2D convenience over `view`. Reads 1 and writes nothing when the trial holds
-         *  a view that is not the 2D one. */
-        zoom: number;
-        setZoom: (z: number) => void;
-        /** Resolved active tool: this trial's slot, or the lab's. Null when neither
-         *  holds one. */
-        activeToolId: string | null;
-    };
-    emit: (event: string) => void;
-    /** Present only when the instrument declares a `job`. */
-    job?: JobHandle;
-}
-/** One 2D canvas layer of an instrument, drawn in declaration order.
- *
- *  `draw` is called with the camera already applied, so it works in world
- *  coordinates. `zoom` is passed for the things that must not scale with it —
- *  set `ctx.lineWidth = 1 / zoom` to keep a hairline hairline. */
-interface CanvasLayer<TS = unknown, TC = unknown> {
-    id: string;
-    draw: (ctx: CanvasRenderingContext2D, args: {
-        state: TS;
-        config: TC;
-        zoom: number;
-    }) => void;
-}
-/** Declares that an instrument draws to a canvas: its layers, and where the
- *  view starts. */
-interface CanvasCapability<TS = unknown, TC = unknown> {
-    layers: CanvasLayer<TS, TC>[];
-    initialView?: {
-        zoom: number;
-        pan: {
-            x: number;
-            y: number;
-        };
-    };
-    /** Widens `usePanZoom`'s default clamp; the opening zoom stays reachable
-     *  regardless of these. */
-    minZoom?: number;
-    maxZoom?: number;
-}
-/** Declares which of an instrument's layers the trial should offer
- *  show/hide controls for. */
-interface LayerCapability {
-    /** In list order. A bare string is a layer id that doubles as its own label;
-     *  give a descriptor instead to label a layer or mark it `alwaysOn`. */
-    ids: readonly (string | LayerDescriptor)[];
-}
-/** Declares that an instrument accepts items dragged from a palette: what the
- *  palette offers, what a drop does to the state, and — optionally — live
- *  feedback during the drag and the ability to drag existing items back out. */
-interface DragDropCapability<TS = unknown, TC = unknown> {
-    palette: PaletteItem[] | ((state: TS, config: TC) => PaletteItem[]);
-    onDrop: (worldPos: Point, item: PaletteItem, state: TS, config: TC) => TS;
-    onDragOver?: (worldPos: Point, item: PaletteItem, state: TS, config: TC) => DragFeedback | null;
-    pickUp?: (hit: HitResult, state: TS, config: TC) => {
-        item: PaletteItem;
-        state: TS;
-    } | null;
-}
-/** Declares that an instrument's state is undoable: which emitted events
- *  snapshot it, and how many snapshots to keep. */
-interface UndoCapability {
-    snapshotOn?: string[];
-    maxDepth?: number;
-}
-/** The name of an event an instrument emits through `RenderContext.emit`. */
-type SystemEvent = string;
-/** A point in world coordinates. */
-type Point = {
-    x: number;
-    y: number;
-};
-/** What a hit-test found, and where. */
-type HitResult = {
-    hit: boolean;
-    layerId?: string;
-    pointId?: string;
-};
-/** A trial's camera. */
-type ViewTransform = {
-    zoom: number;
-    pan: Point;
-};
-/** A layer as the layer list shows it. `alwaysOn` layers cannot be hidden. */
-type LayerDescriptor = {
-    id: string;
-    label: string;
-    alwaysOn?: boolean;
-};
-/** One draggable entry in an instrument's palette. */
-type PaletteItem = {
-    id: string;
-    label: string;
-    data?: unknown;
-};
-/** Whether a drop would be accepted at the current position, and why not if
- *  it would not. */
-type DragFeedback = {
-    ok: boolean;
-    reason?: string;
-};
-/**
- * An instrument: one self-contained interactive experiment a lab can host.
- *
- * It owns two pieces of data — `config`, the settings the control panel edits,
- * and `state`, what the experiment is currently doing — and renders from both.
- * The optional capability fields declare what else it wants from the runtime:
- * a canvas, a layer list, palette drag-and-drop, undo. Declaring a capability
- * is what makes the trial provide the corresponding chrome.
- */
-interface Instrument<TS = unknown, TC = unknown, TItem = unknown> {
-    name: string;
-    defaultConfig: () => TC;
-    initialState: (config: TC) => TS;
-    /** The instrument's config, declared once: values, types and controls.
-     *  Supplying this makes `defaultConfig` optional — `defineInstrument`
-     *  synthesizes it. Prefer it over `defaultConfig` + `configSchema`. */
-    config?: ConfigSchema<TC>;
-    /** @deprecated Declare `config` instead; this repeats what `TC` already
-     *  says and nothing holds the two to one answer. */
-    configSchema?: () => ConfigField[];
-    /** The instrument's DOM. With `canvas`, this renders as an overlay above the
-     *  layers rather than instead of them; return `null` for canvas only. */
-    render: (ctx: RenderContext<TS, TC>) => ReactNode;
-    onConfigChange?: (config: TC, prev: TC, state: TS) => TS;
-    serialize?: (state: TS) => unknown;
-    deserialize?: (data: unknown, config: TC) => TS;
-    canvas?: CanvasCapability<TS, TC>;
-    layers?: LayerCapability;
-    dragDrop?: DragDropCapability<TS, TC>;
-    undo?: UndoCapability;
-    /** Tools this instrument offers. Declaring them gives the trial a palette
-     *  region and its own tool slot. */
-    tools?: ToolCapability;
-    /** Chrome this instrument contributes beyond what its capabilities imply. */
-    chrome?: TrialContribution[];
-    /** 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>;
-}
-/** Instruments as a lab receives them. `any` rather than `unknown` because
- *  parameter contravariance keeps a `defineInstrument<TS, TC>` result out of
- *  an `Instrument<unknown, unknown>[]`; it is contained to this alias. */
-type InstrumentList = readonly Instrument<any, any, any>[];
-
-export type { CanvasCapability as C, DragFeedback as D, HitResult as H, Instrument as I, LayerCapability as L, PaletteItem as P, RenderContext as R, SidebarSection as S, TrialContribution as T, UndoCapability as U, ViewTransform as V, Point as a, DragDropCapability as b, InstrumentList as c, TrialTool as d, CanvasLayer as e, IconComponent as f, LayerDescriptor as g, StatusReadout as h, SystemEvent as i, ToolCapability as j, ToolItem as k, ToolbarItem as l, TrialChromeContext as m, TrialRegion as n, ViewportControl as o };

package/dist/chunk-3XXPU73K.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/dragdrop/DragGhost.tsx","../src/dragdrop/DragDropRuntime.tsx","../src/dragdrop/Palette.tsx"],"names":["useState","useEffect","jsx"],"mappings":"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","file":"chunk-3XXPU73K.js","sourcesContent":["import { type ReactPortal, useEffect, useState } from 'react';\nimport { createPortal } from 'react-dom';\nimport type { PaletteItem, Point } from '../instrument/types';\n\nexport interface DragGhostProps {\n  item: PaletteItem;\n  screenPos: Point;\n}\n\nexport function DragGhost({ item, screenPos }: DragGhostProps): ReactPortal | null {\n  const [mounted, setMounted] = useState(false);\n  useEffect(() => setMounted(true), []);\n  if (!mounted || typeof document === 'undefined') return null;\n  const style = {\n    left: `${screenPos.x + 12}px`,\n    top: `${screenPos.y + 12}px`,\n  };\n  return createPortal(\n    <div className=\"lk-drag-ghost\" style={style}>\n      <span className=\"lk-drag-ghost__label\">{item.label}</span>\n    </div>,\n    document.body,\n  );\n}\n","import { useVisibleRaf } from '@weasel-js/core';\nimport { type RefObject, useCallback, useEffect, useRef, useState } from 'react';\nimport { screenToWorld } from '../canvas/canvasCoords';\nimport type {\n  DragDropCapability,\n  DragFeedback,\n  PaletteItem,\n  Point,\n  ViewTransform,\n} from '../instrument/types';\nimport { DragGhost } from './DragGhost';\n\nexport interface DragState {\n  item: PaletteItem;\n  screenPos: Point;\n  feedback: DragFeedback | null;\n}\n\nexport interface UseDragDropArgs<TS, TC> {\n  capability: DragDropCapability<TS, TC>;\n  canvasContainerRef: RefObject<HTMLElement | null>;\n  view: ViewTransform;\n  state: TS;\n  config: TC;\n  setState: (next: TS | ((prev: TS) => TS)) => void;\n  emit: (event: string) => void;\n}\n\nexport interface UseDragDropResult {\n  drag: DragState | null;\n  startDrag: (item: PaletteItem, originScreenPos: Point) => void;\n}\n\nexport function useDragDrop<TS, TC>({\n  capability,\n  canvasContainerRef,\n  view,\n  state,\n  config,\n  setState,\n  emit,\n}: UseDragDropArgs<TS, TC>): UseDragDropResult {\n  const [drag, setDrag] = useState<DragState | null>(null);\n  const dragRef = useRef<DragState | null>(null);\n  dragRef.current = drag;\n  /** The move the next frame will resolve. Doubles as the throttle's flag:\n   *  non-null means a frame is already queued. */\n  const pendingPos = useRef<Point | null>(null);\n\n  const isOverCanvas = useCallback(\n    (screenPos: Point): boolean => {\n      const el = canvasContainerRef.current;\n      if (!el) return false;\n      const r = el.getBoundingClientRect();\n      return (\n        screenPos.x >= r.left &&\n        screenPos.x <= r.right &&\n        screenPos.y >= r.top &&\n        screenPos.y <= r.bottom\n      );\n    },\n    [canvasContainerRef],\n  );\n\n  const screenToWorldFromContainer = useCallback(\n    (screenPos: Point): Point | null => {\n      const el = canvasContainerRef.current;\n      if (!el) return null;\n      const r = el.getBoundingClientRect();\n      return screenToWorld({ x: screenPos.x - r.left, y: screenPos.y - r.top }, view);\n    },\n    [canvasContainerRef, view],\n  );\n\n  const frameLoop = useVisibleRaf(() => {\n    const screenPos = pendingPos.current;\n    pendingPos.current = null;\n    const active = dragRef.current;\n    if (!active || !screenPos) return;\n    let feedback: DragFeedback | null = null;\n    if (capability.onDragOver && isOverCanvas(screenPos)) {\n      const world = screenToWorldFromContainer(screenPos);\n      if (world) feedback = capability.onDragOver(world, active.item, state, config);\n    }\n    setDrag({ ...active, screenPos, feedback });\n  });\n\n  useEffect(() => {\n    if (!drag) return;\n    const handleMove = (e: PointerEvent) => {\n      const screenPos = { x: e.clientX, y: e.clientY };\n      const current = dragRef.current;\n      if (!current) return;\n      if (pendingPos.current !== null) {\n        // A frame is already queued: keep the ghost under the cursor and let\n        // that frame probe the drop target from the newest position.\n        pendingPos.current = screenPos;\n        dragRef.current = { ...current, screenPos };\n        setDrag(dragRef.current);\n        return;\n      }\n      pendingPos.current = screenPos;\n      frameLoop.request();\n    };\n    const handleUp = (e: PointerEvent) => {\n      const screenPos = { x: e.clientX, y: e.clientY };\n      const active = dragRef.current;\n      if (!active) return;\n      pendingPos.current = null;\n      frameLoop.cancel();\n      if (isOverCanvas(screenPos)) {\n        const world = screenToWorldFromContainer(screenPos);\n        if (world) {\n          const nextState = capability.onDrop(world, active.item, state, config);\n          setState(nextState);\n          emit('canvas.itemAdded');\n        }\n      }\n      setDrag(null);\n    };\n    window.addEventListener('pointermove', handleMove);\n    window.addEventListener('pointerup', handleUp);\n    return () => {\n      window.removeEventListener('pointermove', handleMove);\n      window.removeEventListener('pointerup', handleUp);\n    };\n  }, [\n    drag,\n    capability,\n    state,\n    config,\n    setState,\n    emit,\n    frameLoop,\n    isOverCanvas,\n    screenToWorldFromContainer,\n  ]);\n\n  const startDrag = useCallback((item: PaletteItem, originScreenPos: Point) => {\n    setDrag({ item, screenPos: originScreenPos, feedback: null });\n  }, []);\n\n  return { drag, startDrag };\n}\n\nexport interface DragOverlayProps {\n  drag: DragState | null;\n}\n\nexport function DragOverlay({ drag }: DragOverlayProps) {\n  if (!drag) return null;\n  return <DragGhost item={drag.item} screenPos={drag.screenPos} />;\n}\n","import type { PaletteItem, Point } from '../instrument/types';\n\nexport interface PaletteProps {\n  items: PaletteItem[];\n  onDragStart: (item: PaletteItem, originScreenPos: Point) => void;\n  className?: string;\n}\n\nexport function Palette({ items, onDragStart, className }: PaletteProps) {\n  return (\n    <div className={className ? `lk-palette ${className}` : 'lk-palette'}>\n      {items.map((item) => (\n        <button\n          type=\"button\"\n          key={item.id}\n          className=\"lk-palette__item\"\n          onPointerDown={(e) => {\n            e.preventDefault();\n            onDragStart(item, { x: e.clientX, y: e.clientY });\n          }}\n        >\n          <span className=\"lk-palette__label\">{item.label}</span>\n        </button>\n      ))}\n    </div>\n  );\n}\n"]}

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

@@ -1 +0,0 @@
-{"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"]}