@weasel-js/labkit 1.4.3 → 1.5.0

package/dist/state/index.js

@@ -1,10 +1,11 @@
-import { createLabStore } from '../chunk-5TROQVQ2.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-5TROQVQ2.js';
+import { openLabStore } from '../chunk-67SJLMC7.js';
+export { CURRENT_DOCUMENT_VERSION, createLabStore, dockPanel, labDocumentKey, openLabStore, panelKey, quarantineKey, undockPanel, useTrialState } from '../chunk-67SJLMC7.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-E44SU6XS.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 { jsx, Fragment } from 'react/jsx-runtime';
 
 var SINGLETON_INSTRUMENT = "__singleton__";
 function SingletonExperimentProvider({
@@ -13,13 +14,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 +29,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"]}