@weasel-js/labkit 1.4.4 → 1.5.1

package/dist/passthrough/weasel-ui.js

@@ -1,4 +1,4 @@
 import '../chunk-SBXNQW4G.js';
-export { m as ActionBar, r8 as ActionsBar, Lt as Badge, a3 as Button, g3 as Callout, l5 as CalloutTrigger, o as Checkbox, g2 as ComboBox, v3 as ComboBoxItem, L as CurveEditor, s2 as DataGrid, l3 as Dialog, r5 as Disclosure, i2 as DisclosureRow, n4 as DragHandleGlyph, Je as EDGE_PROFILES, n2 as Field, t as ICON_PATHS, r as Icon, u2 as Input, s3 as KeyCap, c2 as KeySequence, c3 as LayerStack, e2 as MINUS_SIGN, f2 as NumberField, r7 as OptionsBar, f3 as Plot2D, n7 as PointPlotter, r9 as Powerline, u3 as Radio, l as RadioGroup, l2 as RangeSlider, g as Select, b2 as SelectItem, n5 as Sidebar, s4 as SidebarPanel, y2 as Slider, a2 as Switch, c4 as Tab, s5 as TabList, l4 as TabPanel, o4 as Tabs, r6 as ToggleBar, o3 as ToolButton, n6 as ToolGroup, _2 as ToolPalette, Jn as chromaAt, u4 as detectPlatform, a as dlog, r3 as fieldClasses, t3 as formatNumber, d2 as formatShortcut, u5 as formatShortcutParts, o2 as inferKeycapKind, i as isDebugEnabled, t2 as isPrefLeaf, e as keyGlyph, p2 as keySpecFromKey, d as keySpecsFromMods, qn as oklchToHex, v2 as paintGradientTrack, n3 as prefValueAtPath, s as useReorderDragList, a4 as useRovingTabIndex, r4 as visiblePrefSubtree } from '../chunk-W3ECWC2K.js';
+export { m as ActionBar, r8 as ActionsBar, Lt as Badge, a5 as Button, g3 as Callout, l8 as CalloutTrigger, o2 as Checkbox, y2 as ComboBox, S3 as ComboBoxItem, L2 as CurveEditor, s2 as DataGrid, l5 as Dialog, r6 as Disclosure, i3 as DisclosureRow, n4 as DragHandleGlyph, Je as EDGE_PROFILES, n2 as Field, t as ICON_PATHS, o as Icon, u2 as Input, s3 as KeyCap, c3 as KeySequence, c4 as LayerStack, e as MINUS_SIGN, l7 as MenuButton, g2 as NumberField, r7 as OptionsBar, w2 as Plot2D, n8 as PointPlotter, r10 as Powerline, u3 as Radio, l3 as RadioGroup, l4 as RangeSlider, g as Select, b3 as SelectItem, n5 as Sidebar, s4 as SidebarPanel, b2 as Slider, a4 as Switch, c6 as Tab, s5 as TabList, l6 as TabPanel, o5 as Tabs, r3 as ToggleBar, o4 as ToolButton, n7 as ToolGroup, _2 as ToolPalette, Ar as chromaAt, u4 as detectPlatform, a as dlog, r4 as fieldClasses, t2 as formatNumber, d2 as formatShortcut, u5 as formatShortcutParts, o3 as inferKeycapKind, i as isDebugEnabled, n3 as isPrefLeaf, e3 as keyGlyph, p2 as keySpecFromKey, d as keySpecsFromMods, kr as oklchToHex, v2 as paintGradientTrack, r5 as prefValueAtPath, jr as useAsyncOptions, s as useReorderDragList, a3 as useRovingTabIndex, i2 as visiblePrefSubtree } from '../chunk-T3EC2DXD.js';
 //# sourceMappingURL=weasel-ui.js.map
 //# sourceMappingURL=weasel-ui.js.map

package/dist/primitives/index.d.ts

@@ -12,8 +12,10 @@ interface FloatingPanelProps {
     snapCorners?: readonly Corner[];
     /** Pixels in from a corner when snapped. Default 12. */
     inset?: number;
-    /** localStorage key to remember its position under. Omit to forget on reload. */
-    storageKey?: string;
+    /** Name to remember its position under, through `usePersistedState` — so it
+     *  is remembered only inside a lab or a `<Persistence>`. Omit to forget on
+     *  reload. */
+    persist?: string;
     className?: string;
 }
 /**
@@ -24,7 +26,7 @@ interface FloatingPanelProps {
  * model would be all cost. Pointer handling is therefore this component's, and
  * windease's own affordance rendering never participates.
  */
-declare function FloatingPanel({ children, anchor, snapCorners, inset, storageKey, className, }: FloatingPanelProps): react_jsx_runtime.JSX.Element;
+declare function FloatingPanel({ children, anchor, snapCorners, inset, persist, className, }: FloatingPanelProps): react_jsx_runtime.JSX.Element;
 
 /** A live frame-rate readout, averaged over the last 30 frames. */
 declare function FpsMeter(): react_jsx_runtime.JSX.Element;
@@ -84,6 +86,53 @@ interface SidebarProps {
  *  caller's to hold. */
 declare function Sidebar({ children, title, collapsed, onToggle }: SidebarProps): react_jsx_runtime.JSX.Element;
 
+/** Props for `<Split>`. */
+interface SplitProps {
+    /** The sidebar pane's contents. */
+    sidebar: ReactNode;
+    /** The edge the sidebar sits on. Read once, when the strip mounts. Default `'start'`. */
+    side?: 'start' | 'end';
+    /** The content pane's contents. */
+    children: ReactNode;
+    /** Names the sidebar pane, and through it the seam. Default `'Sidebar'`. */
+    label?: string;
+    /** Extra classes on the strip, which always has `lk-split`. */
+    className?: string;
+    /** The class on the sidebar pane. */
+    sidebarClassName?: string;
+    /** The class on the content pane. */
+    contentClassName?: string;
+    /** The sidebar's current extent in pixels. Omit to leave it unpersisted: the
+     *  seam still works, its result just does not outlive the mount. */
+    width?: number;
+    /** Where the sidebar starts before anyone drags it. */
+    defaultWidth?: number;
+    minWidth?: number;
+    maxWidth?: number;
+    /** How little the content pane may be squeezed to. Reported as the seam's
+     *  reachable maximum, so the drag stops there rather than clamping silently. */
+    contentMinWidth?: number;
+    /** Fires through the drag, not on release: the pane is already there. */
+    onWidthChange?: (width: number) => void;
+    /**
+     * Fixed extent. Omit in an app — the strip measures its own box. Supply it
+     * where nothing measures, notably jsdom, or both panes lay out at zero.
+     */
+    viewport?: {
+        w: number;
+        h: number;
+    };
+}
+/**
+ * A sidebar and a content pane as a two-pane strip with a draggable seam.
+ *
+ * The seam is `stripStrategy`'s own resize affordance, so it arrives as a
+ * `role="separator"` carrying the reachable range, operable by pointer and by
+ * arrows / Home / End, and clamped against the content pane's floor rather
+ * than against the sidebar's alone.
+ */
+declare function Split({ sidebar, children, side, label, className, sidebarClassName, contentClassName, width, defaultWidth, minWidth, maxWidth, contentMinWidth, onWidthChange, viewport, }: SplitProps): react_jsx_runtime.JSX.Element;
+
 /** Props for `<StatusBar>`. */
 interface StatusBarProps {
     children: ReactNode;
@@ -160,7 +209,7 @@ interface ZoomControlProps {
 /** Zoom as a log-scaled slider with an editable percentage beside it. Pair it
  *  with zoom-in / zoom-out buttons in a `<Toolbar.Group>`; this component owns
  *  only the continuous part. */
-declare function ZoomControl({ zoom, onZoomChange, onZoomCommit, min, max, className, }: ZoomControlProps): react_jsx_runtime.JSX.Element;
+declare function ZoomControl({ zoom, onZoomChange, onZoomCommit, min: minProp, max: maxProp, className, }: ZoomControlProps): react_jsx_runtime.JSX.Element;
 
-export { FloatingPanel, FpsMeter, JobProgress, Legend, ScaleIndicator, Sidebar, StatusBar, Toolbar, ZoomControl };
-export type { FloatingPanelProps, JobProgressProps, LegendEntry, LegendMark, LegendProps, ScaleIndicatorProps, SidebarProps, StatusBarProps, StatusBarSectionProps, ToolbarButtonProps, ToolbarGroupProps, ToolbarProps, ZoomControlProps };
+export { FloatingPanel, FpsMeter, JobProgress, Legend, ScaleIndicator, Sidebar, Split, StatusBar, Toolbar, ZoomControl };
+export type { FloatingPanelProps, JobProgressProps, LegendEntry, LegendMark, LegendProps, ScaleIndicatorProps, SidebarProps, SplitProps, StatusBarProps, StatusBarSectionProps, ToolbarButtonProps, ToolbarGroupProps, ToolbarProps, ZoomControlProps };

package/dist/primitives/index.js

@@ -1,7 +1,9 @@
-export { FloatingPanel, JobProgress, Legend, Sidebar } from '../chunk-MOM3GOVY.js';
-export { FpsMeter, ScaleIndicator, StatusBar, Toolbar, ZoomControl } from '../chunk-SMHP6XZ4.js';
-import '../chunk-SBXNQW4G.js';
-import '../chunk-W3ECWC2K.js';
+export { FloatingPanel, JobProgress, Legend, Sidebar, Split } from '../chunk-EHGVROVV.js';
+export { FpsMeter, ScaleIndicator, StatusBar, Toolbar, ZoomControl } from '../chunk-UN4U4P63.js';
+import '../chunk-RWNDDKOH.js';
 import '../chunk-CQLQPQ4P.js';
+import '../chunk-2YILQ7Y5.js';
+import '../chunk-SBXNQW4G.js';
+import '../chunk-T3EC2DXD.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/state/index.d.ts

@@ -1,12 +1,13 @@
-export { C as CURRENT_DOCUMENT_VERSION, L as LabStore, a as LabStoreActions, b as LabStoreContext, c as LabStoreProvider, T as TrialIdContext, d as TrialIdProvider, e as createLabStore, f as createMemoryAdapter, l as labDocumentKey, g as localStorageAdapter, n as noneAdapter, q as quarantineKey, s as sessionStorageAdapter, u as urlHashAdapter, h as useLabStore, i as useTrialId, j as useTrialState } from '../_dts/useTrialState-D6Vb3T-g.js';
-import { S as SerializedTrial, I as InstrumentSerializers, T as TrialRecord, U as UndoStack, a as StorageAdapter } from '../_dts/types-BP2OCcpg.js';
-export { C as CreateLabStoreOptions, L as LabDocument, b as LabStoreState, M as Migration, c as SavedSnapshot, d as TrialStateHandle, e as UndockedPanel, f as UndockedPanels, g as dockPanel, p as panelKey, u as undockPanel } from '../_dts/types-BP2OCcpg.js';
+export { C as CURRENT_DOCUMENT_VERSION, I as IndexedDbAdapterOptions, L as LabStore, a as LabStoreActions, b as LabStoreContext, c as LabStoreProvider, O as OpenLabStoreOptions, d as OpenedLabStore, P as PersistedStateOptions, e as Persistence, f as PersistenceProps, R as RecordCache, g as RecordChange, T as TrialIdContext, h as TrialIdProvider, i as createIndexedDbAdapter, j as createLabStore, k as createMemoryAdapter, l as indexedDbAdapter, m as labDocumentKey, n as localStorageAdapter, o as noneAdapter, p as openLabStore, q as quarantineKey, s as sessionStorageAdapter, u as urlHashAdapter, r as useLabStore, t as usePersistedState, v as useTrialId, w as useTrialState } from '../_dts/useTrialState-uLlmaccn.js';
+import { S as SerializedTrial, I as InstrumentSerializers, T as TrialRecord, U as UndoStack, c as StorageAdapter } from '../_dts/frac-B4okC2lX.js';
+export { C as CreateLabStoreOptions, L as LabDocument, d as LabStoreState, M as Migration, e as SavedSnapshot, f as StorageChange, g as TrialStateHandle, h as UndockedPanel, i as UndockedPanels, j as dockPanel, p as panelKey, u as undockPanel } from '../_dts/frac-B4okC2lX.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 import 'zustand/vanilla';
-import '../_dts/types-B9_zrHmb.js';
+import '../_dts/types-DzoNY1pO.js';
 import '@weasel-js/core';
-import '../_dts/PrefsForm.d-DDHFANkc.js';
+import '../_dts/PrefsForm.d-DPy9I8It.js';
+import '../_dts/types-DJ79Tg5J.js';
 
 /** The storage key a lab writes one of its buckets under. Namespaced by
  *  `storageKey` so two labs sharing an origin do not collide. */
@@ -34,17 +35,21 @@ interface SingletonExperimentProviderProps<TS, TC> {
     id: string;
     initialConfig: TC;
     initialState: TS;
-    storage: StorageAdapter;
     storageKey: string;
+    /** Default: IndexedDB, or localStorage where IndexedDB will not open. */
+    storage?: StorageAdapter;
+    /** Rendered until the stored experiment has loaded. Default: nothing. */
+    fallback?: ReactNode;
     children: ReactNode;
 }
 /**
  * One-trial `<Lab>` substitute for single-screen experiments. Mounts
  * a `LabStoreProvider` + `TrialIdProvider` with one synthetic
  * trial, so `useTrialState` works without going through the
- * full `<Lab instruments={...}>` runtime.
+ * full `<Lab instruments={...}>` runtime. `storageKey` and `storage` are read
+ * once, at mount.
  */
-declare function SingletonExperimentProvider<TS, TC>({ id, initialConfig, initialState, storage, storageKey, children, }: SingletonExperimentProviderProps<TS, TC>): react_jsx_runtime.JSX.Element;
+declare function SingletonExperimentProvider<TS, TC>({ id, initialConfig, initialState, storage, storageKey, fallback, children, }: SingletonExperimentProviderProps<TS, TC>): react_jsx_runtime.JSX.Element;
 
 export { InstrumentSerializers, SerializedTrial, SingletonExperimentProvider, StorageAdapter, TrialRecord, UndoStack, decodeUrlHash, deserializeTrials, emptyUndoStack, encodeUrlHash, labStorageKey, serializeTrials };
 export type { SingletonExperimentProviderProps };

package/dist/state/index.js

@@ -1,10 +1,13 @@
-import { createLabStore } from '../chunk-2P6PP5N4.js';
-export { CURRENT_DOCUMENT_VERSION, createLabStore, createMemoryAdapter, decodeUrlHash, deserializeTrials, dockPanel, emptyUndoStack, encodeUrlHash, labDocumentKey, labStorageKey, localStorageAdapter, noneAdapter, panelKey, quarantineKey, serializeTrials, sessionStorageAdapter, undockPanel, urlHashAdapter, useTrialState } from '../chunk-2P6PP5N4.js';
+import { openLabStore } from '../chunk-IXTQI7JX.js';
+export { CURRENT_DOCUMENT_VERSION, createLabStore, dockPanel, labDocumentKey, openLabStore, panelKey, quarantineKey, undockPanel, useTrialState } from '../chunk-IXTQI7JX.js';
+import { useWarnIgnoredChange, useOpenOnce, defaultStorage, PersistenceContext } from '../chunk-RWNDDKOH.js';
+export { Persistence, createIndexedDbAdapter, createMemoryAdapter, decodeUrlHash, deserializeTrials, emptyUndoStack, encodeUrlHash, indexedDbAdapter, labStorageKey, localStorageAdapter, noneAdapter, serializeTrials, sessionStorageAdapter, urlHashAdapter, usePersistedState } from '../chunk-RWNDDKOH.js';
+import '../chunk-ZDHY47EV.js';
+import '../chunk-7PFH3CNM.js';
 import { LabStoreProvider, TrialIdProvider } from '../chunk-2YILQ7Y5.js';
 export { LabStoreContext, LabStoreProvider, TrialIdContext, TrialIdProvider, useLabStore, useTrialId } from '../chunk-2YILQ7Y5.js';
-import '../chunk-E44SU6XS.js';
-import { useRef } from 'react';
-import { jsx } from 'react/jsx-runtime';
+import '../chunk-T3EC2DXD.js';
+import { jsx, Fragment } from 'react/jsx-runtime';
 
 var SINGLETON_INSTRUMENT = "__singleton__";
 function SingletonExperimentProvider({
@@ -13,13 +16,14 @@ function SingletonExperimentProvider({
   initialState,
   storage,
   storageKey,
+  fallback = null,
   children
 }) {
-  const storeRef = useRef(null);
-  if (storeRef.current === null) {
-    const store = createLabStore({ storageKey, storage });
-    if (!store.getState().trials.some((w) => w.id === id)) {
-      store.getState().addTrial({
+  useWarnIgnoredChange("<SingletonExperimentProvider>", { storageKey, storage });
+  const opened = useOpenOnce(async () => {
+    const lab = await openLabStore({ storageKey, storage: storage ?? await defaultStorage() });
+    if (!lab.store.getState().trials.some((w) => w.id === id)) {
+      lab.store.getState().addTrial({
         id,
         instrumentName: SINGLETON_INSTRUMENT,
         config: initialConfig,
@@ -27,9 +31,10 @@ function SingletonExperimentProvider({
         view: { zoom: 1, pan: { x: 0, y: 0 } }
       });
     }
-    storeRef.current = store;
-  }
-  return /* @__PURE__ */ jsx(LabStoreProvider, { store: storeRef.current, children: /* @__PURE__ */ jsx(TrialIdProvider, { trialId: id, children }) });
+    return lab;
+  });
+  if (!opened) return /* @__PURE__ */ jsx(Fragment, { children: fallback });
+  return /* @__PURE__ */ jsx(LabStoreProvider, { store: opened.store, children: /* @__PURE__ */ jsx(PersistenceContext.Provider, { value: opened.records, children: /* @__PURE__ */ jsx(TrialIdProvider, { trialId: id, children }) }) });
 }
 
 export { SingletonExperimentProvider };

package/dist/state/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/state/SingletonExperiment.tsx"],"names":[],"mappings":";;;;;;;;AAKA,IAAM,oBAAA,GAAuB,eAAA;AAoBtB,SAAS,2BAAA,CAAoC;AAAA,EAClD,EAAA;AAAA,EACA,aAAA;AAAA,EACA,YAAA;AAAA,EACA,OAAA;AAAA,EACA,UAAA;AAAA,EACA;AACF,CAAA,EAA6C;AAC3C,EAAA,MAAM,QAAA,GAAW,OAAwB,IAAI,CAAA;AAC7C,EAAA,IAAI,QAAA,CAAS,YAAY,IAAA,EAAM;AAC7B,IAAA,MAAM,KAAA,GAAQ,cAAA,CAAe,EAAE,UAAA,EAAY,SAAS,CAAA;AACpD,IAAA,IAAI,CAAC,KAAA,CAAM,QAAA,EAAS,CAAE,MAAA,CAAO,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,EAAA,KAAO,EAAE,CAAA,EAAG;AACrD,MAAA,KAAA,CAAM,QAAA,GAAW,QAAA,CAAS;AAAA,QACxB,EAAA;AAAA,QACA,cAAA,EAAgB,oBAAA;AAAA,QAChB,MAAA,EAAQ,aAAA;AAAA,QACR,KAAA,EAAO,YAAA;AAAA,QACP,IAAA,EAAM,EAAE,IAAA,EAAM,CAAA,EAAG,GAAA,EAAK,EAAE,CAAA,EAAG,CAAA,EAAG,CAAA,EAAG,CAAA,EAAE;AAAE,OACtC,CAAA;AAAA,IACH;AACA,IAAA,QAAA,CAAS,OAAA,GAAU,KAAA;AAAA,EACrB;AACA,EAAA,uBACE,GAAA,CAAC,gBAAA,EAAA,EAAiB,KAAA,EAAO,QAAA,CAAS,OAAA,EAChC,8BAAC,eAAA,EAAA,EAAgB,OAAA,EAAS,EAAA,EAAK,QAAA,EAAS,CAAA,EAC1C,CAAA;AAEJ","file":"index.js","sourcesContent":["import { type ReactNode, useRef } from 'react';\nimport { LabStoreProvider, TrialIdProvider } from './context';\nimport { createLabStore, type LabStore } from './store';\nimport type { StorageAdapter } from './types';\n\nconst SINGLETON_INSTRUMENT = '__singleton__';\n\n/** Props for `<SingletonExperimentProvider>`. */\nexport interface SingletonExperimentProviderProps<TS, TC> {\n  /** Stable id for the synthetic trial; also doubles as the\n   *  TrialIdContext value. */\n  id: string;\n  initialConfig: TC;\n  initialState: TS;\n  storage: StorageAdapter;\n  storageKey: string;\n  children: ReactNode;\n}\n\n/**\n * One-trial `<Lab>` substitute for single-screen experiments. Mounts\n * a `LabStoreProvider` + `TrialIdProvider` with one synthetic\n * trial, so `useTrialState` works without going through the\n * full `<Lab instruments={...}>` runtime.\n */\nexport function SingletonExperimentProvider<TS, TC>({\n  id,\n  initialConfig,\n  initialState,\n  storage,\n  storageKey,\n  children,\n}: SingletonExperimentProviderProps<TS, TC>) {\n  const storeRef = useRef<LabStore | null>(null);\n  if (storeRef.current === null) {\n    const store = createLabStore({ storageKey, storage });\n    if (!store.getState().trials.some((w) => w.id === id)) {\n      store.getState().addTrial({\n        id,\n        instrumentName: SINGLETON_INSTRUMENT,\n        config: initialConfig,\n        state: initialState,\n        view: { zoom: 1, pan: { x: 0, y: 0 } },\n      });\n    }\n    storeRef.current = store;\n  }\n  return (\n    <LabStoreProvider store={storeRef.current}>\n      <TrialIdProvider trialId={id}>{children}</TrialIdProvider>\n    </LabStoreProvider>\n  );\n}\n"]}
+{"version":3,"sources":["../../src/state/SingletonExperiment.tsx"],"names":[],"mappings":";;;;;;;;;;;AAQA,IAAM,oBAAA,GAAuB,eAAA;AAwBtB,SAAS,2BAAA,CAAoC;AAAA,EAClD,EAAA;AAAA,EACA,aAAA;AAAA,EACA,YAAA;AAAA,EACA,OAAA;AAAA,EACA,UAAA;AAAA,EACA,QAAA,GAAW,IAAA;AAAA,EACX;AACF,CAAA,EAA6C;AAC3C,EAAA,oBAAA,CAAqB,+BAAA,EAAiC,EAAE,UAAA,EAAY,OAAA,EAAS,CAAA;AAC7E,EAAA,MAAM,MAAA,GAAS,YAAY,YAAY;AACrC,IAAA,MAAM,GAAA,GAAM,MAAM,YAAA,CAAa,EAAE,UAAA,EAAY,SAAS,OAAA,IAAY,MAAM,cAAA,EAAe,EAAI,CAAA;AAC3F,IAAA,IAAI,CAAC,GAAA,CAAI,KAAA,CAAM,QAAA,EAAS,CAAE,MAAA,CAAO,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,EAAA,KAAO,EAAE,CAAA,EAAG;AACzD,MAAA,GAAA,CAAI,KAAA,CAAM,QAAA,EAAS,CAAE,QAAA,CAAS;AAAA,QAC5B,EAAA;AAAA,QACA,cAAA,EAAgB,oBAAA;AAAA,QAChB,MAAA,EAAQ,aAAA;AAAA,QACR,KAAA,EAAO,YAAA;AAAA,QACP,IAAA,EAAM,EAAE,IAAA,EAAM,CAAA,EAAG,GAAA,EAAK,EAAE,CAAA,EAAG,CAAA,EAAG,CAAA,EAAG,CAAA,EAAE;AAAE,OACtC,CAAA;AAAA,IACH;AACA,IAAA,OAAO,GAAA;AAAA,EACT,CAAC,CAAA;AACD,EAAA,IAAI,CAAC,MAAA,EAAQ,uBAAO,GAAA,CAAA,QAAA,EAAA,EAAG,QAAA,EAAA,QAAA,EAAS,CAAA;AAChC,EAAA,2BACG,gBAAA,EAAA,EAAiB,KAAA,EAAO,OAAO,KAAA,EAC9B,QAAA,kBAAA,GAAA,CAAC,mBAAmB,QAAA,EAAnB,EAA4B,KAAA,EAAO,MAAA,CAAO,SACzC,QAAA,kBAAA,GAAA,CAAC,eAAA,EAAA,EAAgB,SAAS,EAAA,EAAK,QAAA,EAAS,GAC1C,CAAA,EACF,CAAA;AAEJ","file":"index.js","sourcesContent":["import type { ReactNode } from 'react';\nimport { defaultStorage } from './adapters';\nimport { LabStoreProvider, TrialIdProvider } from './context';\nimport { openLabStore } from './openLabStore';\nimport { PersistenceContext } from './Persistence';\nimport type { StorageAdapter } from './types';\nimport { useOpenOnce, useWarnIgnoredChange } from './useOpenOnce';\n\nconst SINGLETON_INSTRUMENT = '__singleton__';\n\n/** Props for `<SingletonExperimentProvider>`. */\nexport interface SingletonExperimentProviderProps<TS, TC> {\n  /** Stable id for the synthetic trial; also doubles as the\n   *  TrialIdContext value. */\n  id: string;\n  initialConfig: TC;\n  initialState: TS;\n  storageKey: string;\n  /** Default: IndexedDB, or localStorage where IndexedDB will not open. */\n  storage?: StorageAdapter;\n  /** Rendered until the stored experiment has loaded. Default: nothing. */\n  fallback?: ReactNode;\n  children: ReactNode;\n}\n\n/**\n * One-trial `<Lab>` substitute for single-screen experiments. Mounts\n * a `LabStoreProvider` + `TrialIdProvider` with one synthetic\n * trial, so `useTrialState` works without going through the\n * full `<Lab instruments={...}>` runtime. `storageKey` and `storage` are read\n * once, at mount.\n */\nexport function SingletonExperimentProvider<TS, TC>({\n  id,\n  initialConfig,\n  initialState,\n  storage,\n  storageKey,\n  fallback = null,\n  children,\n}: SingletonExperimentProviderProps<TS, TC>) {\n  useWarnIgnoredChange('<SingletonExperimentProvider>', { storageKey, storage });\n  const opened = useOpenOnce(async () => {\n    const lab = await openLabStore({ storageKey, storage: storage ?? (await defaultStorage()) });\n    if (!lab.store.getState().trials.some((w) => w.id === id)) {\n      lab.store.getState().addTrial({\n        id,\n        instrumentName: SINGLETON_INSTRUMENT,\n        config: initialConfig,\n        state: initialState,\n        view: { zoom: 1, pan: { x: 0, y: 0 } },\n      });\n    }\n    return lab;\n  });\n  if (!opened) return <>{fallback}</>;\n  return (\n    <LabStoreProvider store={opened.store}>\n      <PersistenceContext.Provider value={opened.records}>\n        <TrialIdProvider trialId={id}>{children}</TrialIdProvider>\n      </PersistenceContext.Provider>\n    </LabStoreProvider>\n  );\n}\n"]}