@weasel-js/labkit 1.0.4 → 1.1.0

package/dist/chunk-3TYUJR7Z.js

@@ -0,0 +1,488 @@
+import { createContext, useContext } from 'react';
+import { useStore } from 'zustand/react';
+import { jsx } from 'react/jsx-runtime';
+import { createStore } from 'zustand/vanilla';
+
+// src/state/helpers.ts
+function labStorageKey(storageKey, bucket) {
+  return `lk:${storageKey}:${bucket}`;
+}
+function encodeUrlHash(value) {
+  return btoa(encodeURIComponent(value));
+}
+function decodeUrlHash(hash) {
+  if (!hash) return null;
+  try {
+    return decodeURIComponent(atob(hash));
+  } catch {
+    return null;
+  }
+}
+function emptyUndoStack() {
+  return { past: [], future: [] };
+}
+function serializeTrials(trials, serializers) {
+  return trials.map(({ undoStack: _undo, ...w }) => {
+    const s = serializers[w.instrumentName];
+    return { ...w, state: s?.serialize ? s.serialize(w.state) : w.state };
+  });
+}
+function deserializeTrials(records, deserializers) {
+  if (!Array.isArray(records)) {
+    console.warn("[labkit] deserializeTrials: not an array, returning empty list");
+    return [];
+  }
+  return records.map((r) => {
+    const d = deserializers[r.instrumentName];
+    return {
+      ...r,
+      state: d?.deserialize ? d.deserialize(r.state) : r.state,
+      undoStack: emptyUndoStack()
+    };
+  });
+}
+
+// src/state/adapters.ts
+var localStorageAdapter = {
+  read: (key) => {
+    try {
+      return localStorage.getItem(key);
+    } catch {
+      return null;
+    }
+  },
+  write: (key, value) => {
+    try {
+      localStorage.setItem(key, value);
+    } catch (e) {
+      console.warn("[labkit] localStorage write failed:", e);
+    }
+  },
+  delete: (key) => {
+    try {
+      localStorage.removeItem(key);
+    } catch {
+    }
+  }
+};
+var sessionStorageAdapter = {
+  read: (key) => {
+    try {
+      return sessionStorage.getItem(key);
+    } catch {
+      return null;
+    }
+  },
+  write: (key, value) => {
+    try {
+      sessionStorage.setItem(key, value);
+    } catch (e) {
+      console.warn("[labkit] sessionStorage write failed:", e);
+    }
+  },
+  delete: (key) => {
+    try {
+      sessionStorage.removeItem(key);
+    } catch {
+    }
+  }
+};
+var URL_HASH_GUARD = typeof window !== "undefined";
+function readHashMap() {
+  if (!URL_HASH_GUARD) return {};
+  const raw = decodeUrlHash(window.location.hash.replace(/^#/, ""));
+  if (!raw) return {};
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+function writeHashMap(map) {
+  if (!URL_HASH_GUARD) return;
+  const encoded = encodeUrlHash(JSON.stringify(map));
+  window.history.replaceState(null, "", `#${encoded}`);
+}
+var urlHashAdapter = {
+  read: (key) => readHashMap()[key] ?? null,
+  write: (key, value) => {
+    const map = readHashMap();
+    map[key] = value;
+    writeHashMap(map);
+  },
+  delete: (key) => {
+    const map = readHashMap();
+    delete map[key];
+    writeHashMap(map);
+  }
+};
+function createMemoryAdapter() {
+  const store = /* @__PURE__ */ new Map();
+  return {
+    read: (key) => store.get(key) ?? null,
+    write: (key, value) => {
+      store.set(key, value);
+    },
+    delete: (key) => {
+      store.delete(key);
+    }
+  };
+}
+var noneAdapter = {
+  read: () => null,
+  write: () => {
+  },
+  delete: () => {
+  }
+};
+var LabStoreContext = createContext(null);
+function LabStoreProvider({
+  store,
+  children
+}) {
+  return /* @__PURE__ */ jsx(LabStoreContext.Provider, { value: { store }, children });
+}
+function useLabStore() {
+  const ctx = useContext(LabStoreContext);
+  if (!ctx) throw new Error("[labkit] useLabStore must be used inside <LabStoreProvider>");
+  return useStore(ctx.store);
+}
+var TrialIdContext = createContext(null);
+function TrialIdProvider({
+  trialId,
+  children
+}) {
+  return /* @__PURE__ */ jsx(TrialIdContext.Provider, { value: trialId, children });
+}
+function useTrialId() {
+  const id = useContext(TrialIdContext);
+  if (!id) throw new Error("[labkit] useTrialId must be used inside <TrialIdProvider>");
+  return id;
+}
+
+// src/state/document.ts
+var CURRENT_DOCUMENT_VERSION = 2;
+function labDocumentKey(storageKey) {
+  return `lk:${storageKey}:doc`;
+}
+function quarantineKey(storageKey) {
+  return `lk:${storageKey}:quarantine`;
+}
+function emptyDocument(mode) {
+  return {
+    version: CURRENT_DOCUMENT_VERSION,
+    trials: [],
+    saves: [],
+    layout: {},
+    mode
+  };
+}
+function runMigrations(raw, migrations, target) {
+  const from = typeof raw.version === "number" ? raw.version : 0;
+  if (from > target) return { ok: false, reason: "future" };
+  if (from === target) return { ok: true, doc: raw, migrated: false };
+  let doc = raw;
+  try {
+    for (let v = from; v < target; v++) {
+      const migration = migrations[v];
+      if (!migration) throw new Error(`[labkit] no migration from version ${v}`);
+      doc = migration(doc);
+    }
+  } catch (error) {
+    return { ok: false, reason: "failed", error };
+  }
+  return { ok: true, doc, migrated: true };
+}
+var LEGACY_BUCKETS = ["workspaces", "saves", "layout", "theme"];
+function parseOr(raw, fallback, bucket) {
+  if (raw === null) return fallback;
+  try {
+    return JSON.parse(raw);
+  } catch {
+    console.warn(`[labkit] unparseable legacy bucket "${bucket}", dropping it`);
+    return fallback;
+  }
+}
+function readLegacyDocument(storage, storageKey, fallbackMode) {
+  const present = LEGACY_BUCKETS.some((b) => storage.read(labStorageKey(storageKey, b)) !== null);
+  if (!present) return null;
+  const rawMode = storage.read(labStorageKey(storageKey, "theme"));
+  const mode = rawMode === "light" || rawMode === "dark" || rawMode === "auto" || rawMode === "interstellar" ? rawMode : fallbackMode;
+  return {
+    version: 0,
+    workspaces: parseOr(storage.read(labStorageKey(storageKey, "workspaces")), [], "workspaces"),
+    saves: parseOr(storage.read(labStorageKey(storageKey, "saves")), [], "saves"),
+    layout: parseOr(storage.read(labStorageKey(storageKey, "layout")), {}, "layout"),
+    mode
+  };
+}
+function deleteLegacyKeys(storage, storageKey, expectedDocument) {
+  const actual = storage.read(labDocumentKey(storageKey));
+  if (actual !== expectedDocument) {
+    console.warn(
+      `[labkit] keeping legacy keys for "${storageKey}": could not confirm the migrated document was written`
+    );
+    return false;
+  }
+  let allGone = true;
+  for (const bucket of LEGACY_BUCKETS) {
+    const key = labStorageKey(storageKey, bucket);
+    storage.delete?.(key);
+    if (storage.read(key) !== null) allGone = false;
+  }
+  return allGone;
+}
+function quarantineDocument(storage, storageKey, raw) {
+  storage.write(quarantineKey(storageKey), raw);
+  return storage.read(quarantineKey(storageKey)) === raw;
+}
+function normalizeDocument(doc, fallbackMode) {
+  const mode = doc.mode === "light" || doc.mode === "dark" || doc.mode === "auto" ? doc.mode : fallbackMode;
+  return {
+    version: CURRENT_DOCUMENT_VERSION,
+    trials: Array.isArray(doc.trials) ? doc.trials : [],
+    saves: Array.isArray(doc.saves) ? doc.saves : [],
+    layout: doc.layout && typeof doc.layout === "object" ? doc.layout : {},
+    mode
+  };
+}
+function migrateV0toV1(doc) {
+  const raw = doc.mode === "interstellar" ? "dark" : doc.mode;
+  const mode = raw === "light" || raw === "dark" || raw === "auto" ? raw : "auto";
+  return {
+    version: 1,
+    workspaces: Array.isArray(doc.workspaces) ? doc.workspaces : [],
+    saves: Array.isArray(doc.saves) ? doc.saves : [],
+    layout: doc.layout && typeof doc.layout === "object" ? doc.layout : {},
+    mode
+  };
+}
+function migrateV1toV2(doc) {
+  const { workspaces, ...rest } = doc;
+  return { ...rest, trials: Array.isArray(workspaces) ? workspaces : [], version: 2 };
+}
+var MIGRATIONS = [migrateV0toV1, migrateV1toV2];
+function createLabStore(options) {
+  let serializers = {};
+  let flushTimer = null;
+  const hydration = hydrateDocument(options);
+  const hydrated = hydration.document;
+  const persistDisabled = hydration.persistDisabled;
+  let foldedFromLegacy = hydration.foldedFromLegacy;
+  const hydratedTrials = deserializeTrials(hydrated.trials, serializers);
+  const hydratedSnapshots = hydrated.saves;
+  const hydratedLayout = hydrated.layout;
+  const hydratedMode = hydrated.mode;
+  const store = createStore()((set, get) => ({
+    trials: hydratedTrials,
+    savedSnapshots: hydratedSnapshots,
+    mode: hydratedMode,
+    layout: hydratedLayout,
+    addTrial: (record) => {
+      set((s) => ({
+        trials: [...s.trials, { ...record, undoStack: emptyUndoStack() }]
+      }));
+      scheduleFlush();
+    },
+    removeTrial: (id) => {
+      set((s) => ({ trials: s.trials.filter((w) => w.id !== id) }));
+      scheduleFlush();
+    },
+    updateTrialState: (id, next) => {
+      set((s) => ({
+        trials: s.trials.map((w) => {
+          if (w.id !== id) return w;
+          const nextState = typeof next === "function" ? next(w.state) : next;
+          return { ...w, state: nextState };
+        })
+      }));
+      scheduleFlush();
+    },
+    updateTrialConfig: (id, key, value) => {
+      set((s) => ({
+        trials: s.trials.map((w) => {
+          if (w.id !== id) return w;
+          return {
+            ...w,
+            config: { ...w.config, [key]: value }
+          };
+        })
+      }));
+      scheduleFlush();
+    },
+    updateTrialView: (id, view) => {
+      set((s) => ({
+        trials: s.trials.map((w) => w.id === id ? { ...w, view } : w)
+      }));
+      scheduleFlush();
+    },
+    updateTrialUndoStack: (id, next) => {
+      set((s) => ({
+        trials: s.trials.map((w) => {
+          if (w.id !== id) return w;
+          const undoStack = typeof next === "function" ? next(w.undoStack) : next;
+          return { ...w, undoStack };
+        })
+      }));
+    },
+    setTrialInstrument: (id, instrumentName) => {
+      set((s) => ({
+        trials: s.trials.map((w) => w.id === id ? { ...w, instrumentName } : w)
+      }));
+      scheduleFlush();
+    },
+    saveSnapshot: (trialId, name) => {
+      const trial = get().trials.find((w) => w.id === trialId);
+      if (!trial) return;
+      const reg = serializers[trial.instrumentName];
+      const serializedState = reg?.serialize ? reg.serialize(trial.state) : structuredClone(trial.state);
+      const clonedConfig = structuredClone(trial.config);
+      const lastAt = get().savedSnapshots.reduce((m, sn) => sn.savedAt > m ? sn.savedAt : m, 0);
+      const savedAt = Math.max(Date.now(), lastAt + 1);
+      const snapshot = {
+        id: crypto.randomUUID(),
+        name,
+        trialId,
+        instrumentName: trial.instrumentName,
+        config: clonedConfig,
+        state: serializedState,
+        savedAt
+      };
+      set((s) => ({ savedSnapshots: [...s.savedSnapshots, snapshot] }));
+      scheduleFlush();
+    },
+    loadSnapshot: (snapshotId, trialId) => {
+      const snapshot = get().savedSnapshots.find((sn) => sn.id === snapshotId);
+      if (!snapshot) return;
+      const trial = get().trials.find((w) => w.id === trialId);
+      if (!trial) return;
+      if (snapshot.instrumentName !== trial.instrumentName) {
+        console.warn(
+          `[labkit] loadSnapshot: instrument mismatch (snapshot=${snapshot.instrumentName}, trial=${trial.instrumentName}); refusing to load`
+        );
+        return;
+      }
+      const reg = serializers[snapshot.instrumentName];
+      const restoredState = reg?.deserialize ? reg.deserialize(snapshot.state) : snapshot.state;
+      set((s) => ({
+        trials: s.trials.map(
+          (w) => w.id === trialId ? { ...w, state: restoredState, config: snapshot.config } : w
+        )
+      }));
+      scheduleFlush();
+    },
+    deleteSnapshot: (snapshotId) => {
+      set((s) => ({
+        savedSnapshots: s.savedSnapshots.filter((sn) => sn.id !== snapshotId)
+      }));
+      scheduleFlush();
+    },
+    listSnapshots: (trialId) => {
+      const all = get().savedSnapshots;
+      const filtered = trialId ? all.filter((sn) => sn.trialId === trialId) : all;
+      return [...filtered].sort((a, b) => b.savedAt - a.savedAt);
+    },
+    setMode: (mode) => {
+      set({ mode });
+      scheduleFlush();
+    },
+    setLayout: (layout) => {
+      set({ layout });
+      scheduleFlush();
+    }
+  }));
+  function scheduleFlush() {
+    if (persistDisabled) return;
+    if (flushTimer) clearTimeout(flushTimer);
+    flushTimer = setTimeout(() => {
+      const s = store.getState();
+      const document = {
+        version: CURRENT_DOCUMENT_VERSION,
+        trials: serializeTrials(s.trials, serializers),
+        saves: s.savedSnapshots,
+        layout: s.layout,
+        mode: s.mode
+      };
+      const serialized = JSON.stringify(document);
+      options.storage.write(labDocumentKey(options.storageKey), serialized);
+      if (foldedFromLegacy && deleteLegacyKeys(options.storage, options.storageKey, serialized)) {
+        foldedFromLegacy = false;
+      }
+      flushTimer = null;
+    }, 300);
+  }
+  if (foldedFromLegacy) scheduleFlush();
+  return Object.assign(store, {
+    registerSerializers(s) {
+      serializers = s;
+    }
+  });
+}
+function setAside(options, raw, why, error) {
+  const quarantined = quarantineDocument(options.storage, options.storageKey, raw);
+  const message = quarantined ? `[labkit] ${why}; quarantined it and starting empty` : `[labkit] ${why} and could not be quarantined; leaving it in place and not persisting`;
+  if (error === void 0) console.warn(message);
+  else console.warn(message, error);
+  return quarantined;
+}
+function hydrateDocument(options) {
+  const fallback = emptyDocument(options.initialMode ?? "auto");
+  const raw = options.storage.read(labDocumentKey(options.storageKey));
+  let parsed = null;
+  if (raw !== null) {
+    try {
+      parsed = JSON.parse(raw);
+    } catch {
+      const persistDisabled = !setAside(options, raw, "lab document is unparseable");
+      return { document: fallback, persistDisabled, foldedFromLegacy: false };
+    }
+  } else {
+    parsed = readLegacyDocument(options.storage, options.storageKey, options.initialMode ?? "auto");
+  }
+  if (parsed === null) {
+    return { document: fallback, persistDisabled: false, foldedFromLegacy: false };
+  }
+  const foldedFromLegacy = raw === null;
+  const outcome = runMigrations(parsed, MIGRATIONS, CURRENT_DOCUMENT_VERSION);
+  if (!outcome.ok) {
+    if (outcome.reason === "future") {
+      console.warn(
+        "[labkit] lab document is from a newer version of labkit; starting empty and leaving it alone"
+      );
+      return { document: fallback, persistDisabled: true, foldedFromLegacy: false };
+    }
+    const stored = JSON.stringify(parsed);
+    const persistDisabled = !setAside(
+      options,
+      stored,
+      "lab document failed to migrate",
+      outcome.error
+    );
+    return { document: fallback, persistDisabled, foldedFromLegacy: false };
+  }
+  return {
+    document: normalizeDocument(outcome.doc, options.initialMode ?? "auto"),
+    persistDisabled: false,
+    foldedFromLegacy
+  };
+}
+function useTrialState() {
+  const ctx = useContext(LabStoreContext);
+  if (!ctx) throw new Error("[labkit] useTrialState must be used inside <LabStoreProvider>");
+  const trialId = useContext(TrialIdContext);
+  if (!trialId) throw new Error("[labkit] useTrialState must be used inside <TrialIdProvider>");
+  const record = useStore(ctx.store, (s) => s.trials.find((w) => w.id === trialId));
+  if (!record) throw new Error(`[labkit] No trial found with id "${trialId}"`);
+  const updateTrialState = useStore(ctx.store, (s) => s.updateTrialState);
+  const updateTrialConfig = useStore(ctx.store, (s) => s.updateTrialConfig);
+  return {
+    state: record.state,
+    config: record.config,
+    setState: (next) => updateTrialState(trialId, next),
+    setConfig: (key, value) => updateTrialConfig(trialId, key, value)
+  };
+}
+
+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

package/dist/chunk-3TYUJR7Z.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-3TYUJR7Z.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: TrialRecord['view']) => 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  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\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          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 ? { ...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    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"]}