quidproquo-web-react 0.1.12 → 0.1.13

package/lib/esm/runtime/useQpqAreaBinding.js

@@ -0,0 +1,68 @@
+import { useCallback, useContext, useEffect } from 'react';
+import { useEffectCallback } from '../hooks/useEffectCallback';
+import { useQpq } from '../hooks/useQpq';
+import { useQpqStore } from '../store/useQpqStore';
+import { getStateActionProcessor } from './actionProcessor';
+import { BubbleReducerDispatchContext } from './BubbleReducerDispatchContext';
+import { getQpqRuntimeAreaKey } from './getQpqRuntimeAreaKey';
+// Shared by every hook that reads an area (full runtime and selectors alike):
+// all readers refcount the area and any of them can be the first bind that
+// seeds initial state and runs onInit.
+export function useQpqAreaBinding(definition, instanceName, getActionProcessors) {
+    const store = useQpqStore();
+    const areaKey = getQpqRuntimeAreaKey(definition, instanceName);
+    // Before the bind effect fires (or after a late unbind) the area does not
+    // exist yet; render against the definition's initial state.
+    const getCurrentState = useEffectCallback(() => store.hasArea(areaKey) ? store.getAreaState(areaKey) : definition.initialState);
+    const parentDispatch = useContext(BubbleReducerDispatchContext);
+    // Reduce with the module's reducer; handled effects publish the new state to
+    // the store, unhandled ones bubble up the component tree.
+    const dispatchThroughReducer = (action) => {
+        const [newState, handled] = definition.reducer(getCurrentState(), action);
+        if (handled) {
+            store.setAreaState(areaKey, newState);
+        }
+        else {
+            parentDispatch(action);
+        }
+    };
+    const dispatch = useEffectCallback(dispatchThroughReducer);
+    // State processors always; then the definition's processors (needed by
+    // onInit regardless of which binder runs it); then per-binding extras.
+    const mergedProcessors = async (qpqConfig, dynamicModuleLoader) => {
+        const resolvers = [
+            getStateActionProcessor(dispatch, getCurrentState),
+            definition.getActionProcessors?.(dispatch, getCurrentState),
+            getActionProcessors?.(dispatch, getCurrentState),
+        ];
+        let processors = {};
+        for (const resolver of resolvers) {
+            if (resolver) {
+                processors = { ...processors, ...(await resolver(qpqConfig, dynamicModuleLoader)) };
+            }
+        }
+        return processors;
+    };
+    const resolver = useQpq(mergedProcessors);
+    const runInitStory = useEffectCallback(() => {
+        if (definition.onInit) {
+            resolver(definition.onInit)();
+        }
+    });
+    // Identity must change with the area so useSyncExternalStore resubscribes.
+    const subscribe = useCallback((listener) => store.subscribe(areaKey, listener), [store, areaKey]);
+    useEffect(() => {
+        const isFirstBind = store.bindArea(areaKey, definition.initialState);
+        // A frozen store means devtools time travel: components popping in while
+        // scrubbing must render the restored moment, not fetch the present.
+        if (isFirstBind && !store.isFrozen()) {
+            runInitStory();
+        }
+        return () => store.unbindArea(areaKey);
+        // Rebind only when the target area changes; resolver or definition
+        // identity churn must not unbind (and wipe) live state.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [store, areaKey]);
+    return { subscribe, getCurrentState, dispatch, resolver };
+}
+//# sourceMappingURL=useQpqAreaBinding.js.map

package/lib/esm/runtime/useQpqAreaBinding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useQpqAreaBinding.js","sourceRoot":"","sources":["../../../src/runtime/useQpqAreaBinding.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAE9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAU9D,8EAA8E;AAC9E,2EAA2E;AAC3E,uCAAuC;AACvC,MAAM,UAAU,iBAAiB,CAC/B,UAAuD,EACvD,YAAqB,EACrB,mBAAgE;IAEhE,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,oBAAoB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAE/D,0EAA0E;IAC1E,4DAA4D;IAC5D,MAAM,eAAe,GAAG,iBAAiB,CAAC,GAAW,EAAE,CACrD,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAE,KAAK,CAAC,YAAY,CAAC,OAAO,CAAY,CAAC,CAAC,CAAC,UAAU,CAAC,YAAY,CAC3F,CAAC;IAEF,MAAM,cAAc,GAAG,UAAU,CAAC,4BAA4B,CAAC,CAAC;IAEhE,6EAA6E;IAC7E,0DAA0D;IAC1D,MAAM,sBAAsB,GAAG,CAAC,MAAe,EAAQ,EAAE;QACvD,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,MAAM,CAAC,CAAC;QAE1E,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,cAAc,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,iBAAiB,CAAC,sBAAsB,CAAC,CAAC;IAE3D,uEAAuE;IACvE,uEAAuE;IACvE,MAAM,gBAAgB,GAAgC,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,EAAE;QAC7F,MAAM,SAAS,GAAG;YAChB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,CAAC;YAClD,UAAU,CAAC,mBAAmB,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC;YAC3D,mBAAmB,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC;SACjD,CAAC;QAEF,IAAI,UAAU,GAAwB,EAAE,CAAC;QACzC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,QAAQ,EAAE,CAAC;gBACb,UAAU,GAAG,EAAE,GAAG,UAAU,EAAE,GAAG,CAAC,MAAM,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC;YACtF,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAE1C,MAAM,YAAY,GAAG,iBAAiB,CAAC,GAAG,EAAE;QAC1C,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACtB,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,2EAA2E;IAC3E,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,QAAoB,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAE9G,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC;QAErE,yEAAyE;QACzE,oEAAoE;QACpE,IAAI,WAAW,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;YACrC,YAAY,EAAE,CAAC;QACjB,CAAC;QAED,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACvC,mEAAmE;QACnE,wDAAwD;QACxD,uDAAuD;IACzD,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAErB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAC5D,CAAC","sourcesContent":["import { ActionProcessorList, ActionProcessorListResolver, StoryResolver } from 'quidproquo-core';\n\nimport { useCallback, useContext, useEffect } from 'react';\n\nimport { useEffectCallback } from '../hooks/useEffectCallback';\nimport { useQpq } from '../hooks/useQpq';\nimport { useQpqStore } from '../store/useQpqStore';\nimport { getStateActionProcessor } from './actionProcessor';\nimport { ActionProcessorListResolverFactory } from './ActionProcessorListResolverFactory';\nimport { BubbleReducerDispatchContext } from './BubbleReducerDispatchContext';\nimport { QpqRuntimeDefinition } from './createQpqRuntimeDefinition';\nimport { getQpqRuntimeAreaKey } from './getQpqRuntimeAreaKey';\nimport { QpqApi } from './QpqMappedApi';\n\nexport type QpqAreaBinding<TState, TAction> = {\n  subscribe: (listener: () => void) => () => void;\n  getCurrentState: () => TState;\n  dispatch: (action: TAction) => void;\n  resolver: StoryResolver;\n};\n\n// Shared by every hook that reads an area (full runtime and selectors alike):\n// all readers refcount the area and any of them can be the first bind that\n// seeds initial state and runs onInit.\nexport function useQpqAreaBinding<TState, TAction, TApi extends QpqApi>(\n  definition: QpqRuntimeDefinition<TState, TAction, TApi>,\n  instanceName?: string,\n  getActionProcessors?: ActionProcessorListResolverFactory<TState>,\n): QpqAreaBinding<TState, TAction> {\n  const store = useQpqStore();\n  const areaKey = getQpqRuntimeAreaKey(definition, instanceName);\n\n  // Before the bind effect fires (or after a late unbind) the area does not\n  // exist yet; render against the definition's initial state.\n  const getCurrentState = useEffectCallback((): TState =>\n    store.hasArea(areaKey) ? (store.getAreaState(areaKey) as TState) : definition.initialState,\n  );\n\n  const parentDispatch = useContext(BubbleReducerDispatchContext);\n\n  // Reduce with the module's reducer; handled effects publish the new state to\n  // the store, unhandled ones bubble up the component tree.\n  const dispatchThroughReducer = (action: TAction): void => {\n    const [newState, handled] = definition.reducer(getCurrentState(), action);\n\n    if (handled) {\n      store.setAreaState(areaKey, newState);\n    } else {\n      parentDispatch(action);\n    }\n  };\n  const dispatch = useEffectCallback(dispatchThroughReducer);\n\n  // State processors always; then the definition's processors (needed by\n  // onInit regardless of which binder runs it); then per-binding extras.\n  const mergedProcessors: ActionProcessorListResolver = async (qpqConfig, dynamicModuleLoader) => {\n    const resolvers = [\n      getStateActionProcessor(dispatch, getCurrentState),\n      definition.getActionProcessors?.(dispatch, getCurrentState),\n      getActionProcessors?.(dispatch, getCurrentState),\n    ];\n\n    let processors: ActionProcessorList = {};\n    for (const resolver of resolvers) {\n      if (resolver) {\n        processors = { ...processors, ...(await resolver(qpqConfig, dynamicModuleLoader)) };\n      }\n    }\n\n    return processors;\n  };\n\n  const resolver = useQpq(mergedProcessors);\n\n  const runInitStory = useEffectCallback(() => {\n    if (definition.onInit) {\n      resolver(definition.onInit)();\n    }\n  });\n\n  // Identity must change with the area so useSyncExternalStore resubscribes.\n  const subscribe = useCallback((listener: () => void) => store.subscribe(areaKey, listener), [store, areaKey]);\n\n  useEffect(() => {\n    const isFirstBind = store.bindArea(areaKey, definition.initialState);\n\n    // A frozen store means devtools time travel: components popping in while\n    // scrubbing must render the restored moment, not fetch the present.\n    if (isFirstBind && !store.isFrozen()) {\n      runInitStory();\n    }\n\n    return () => store.unbindArea(areaKey);\n    // Rebind only when the target area changes; resolver or definition\n    // identity churn must not unbind (and wipe) live state.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [store, areaKey]);\n\n  return { subscribe, getCurrentState, dispatch, resolver };\n}\n"]}

package/lib/esm/runtime/useQpqRuntime.d.ts

@@ -0,0 +1,4 @@
+import { ActionProcessorListResolverFactory } from './ActionProcessorListResolverFactory';
+import { QpqRuntimeDefinition } from './createQpqRuntimeDefinition';
+import { QpqApi, QpqMappedApi } from './QpqMappedApi';
+export declare function useQpqRuntime<TState, TAction, TApi extends QpqApi>(definition: QpqRuntimeDefinition<TState, TAction, TApi>, instanceName?: string, getActionProcessors?: ActionProcessorListResolverFactory<TState>): [QpqMappedApi<TApi>, TState, (action: TAction) => void];

package/lib/esm/runtime/useQpqRuntime.js

@@ -0,0 +1,25 @@
+import { useMemo, useState, useSyncExternalStore } from 'react';
+import { useQpqAreaBinding } from './useQpqAreaBinding';
+export function useQpqRuntime(definition, instanceName, getActionProcessors) {
+    const { subscribe, getCurrentState, dispatch, resolver } = useQpqAreaBinding(definition, instanceName, getActionProcessors);
+    const state = useSyncExternalStore(subscribe, getCurrentState, getCurrentState);
+    // Api generators are memoized to prevent unnecessary re-renders.
+    const [memoedApiGenerators] = useState(() => definition.api);
+    // Wrap and remap each API generator using the resolver.
+    const api = useMemo(() => {
+        const wrapped = {};
+        for (const key in memoedApiGenerators) {
+            if (Object.prototype.hasOwnProperty.call(memoedApiGenerators, key)) {
+                // Remove the 'ask' prefix and lower-case the first character.
+                const withoutAsk = key.slice(3); // e.g., "FetchTodos"
+                const newKey = withoutAsk.charAt(0).toLowerCase() + withoutAsk.slice(1); // "fetchTodos"
+                // We know newKey matches our mapped type so we can assign.
+                // (A type assertion is used here to quiet the compiler.)
+                wrapped[newKey] = resolver(memoedApiGenerators[key]);
+            }
+        }
+        return wrapped;
+    }, [resolver, memoedApiGenerators]);
+    return [api, state, dispatch];
+}
+//# sourceMappingURL=useQpqRuntime.js.map

package/lib/esm/runtime/useQpqRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useQpqRuntime.js","sourceRoot":"","sources":["../../../src/runtime/useQpqRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAKhE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,UAAU,aAAa,CAC3B,UAAuD,EACvD,YAAqB,EACrB,mBAAgE;IAEhE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,iBAAiB,CAAC,UAAU,EAAE,YAAY,EAAE,mBAAmB,CAAC,CAAC;IAE5H,MAAM,KAAK,GAAG,oBAAoB,CAAC,SAAS,EAAE,eAAe,EAAE,eAAe,CAAC,CAAC;IAEhF,iEAAiE;IACjE,MAAM,CAAC,mBAAmB,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAE7D,wDAAwD;IACxD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;QACvB,MAAM,OAAO,GAAwB,EAAE,CAAC;QACxC,KAAK,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;YACtC,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,mBAAmB,EAAE,GAAG,CAAC,EAAE,CAAC;gBACnE,8DAA8D;gBAC9D,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,qBAAqB;gBACtD,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe;gBACxF,2DAA2D;gBAC3D,yDAAyD;gBACzD,OAAO,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,mBAAmB,CAAC,GAAU,CAAC,CAAQ,CAAC;YACrE,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAEpC,OAAO,CAAC,GAAyB,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC","sourcesContent":["import { useMemo, useState, useSyncExternalStore } from 'react';\n\nimport { ActionProcessorListResolverFactory } from './ActionProcessorListResolverFactory';\nimport { QpqRuntimeDefinition } from './createQpqRuntimeDefinition';\nimport { QpqApi, QpqMappedApi } from './QpqMappedApi';\nimport { useQpqAreaBinding } from './useQpqAreaBinding';\n\nexport function useQpqRuntime<TState, TAction, TApi extends QpqApi>(\n  definition: QpqRuntimeDefinition<TState, TAction, TApi>,\n  instanceName?: string,\n  getActionProcessors?: ActionProcessorListResolverFactory<TState>,\n): [QpqMappedApi<TApi>, TState, (action: TAction) => void] {\n  const { subscribe, getCurrentState, dispatch, resolver } = useQpqAreaBinding(definition, instanceName, getActionProcessors);\n\n  const state = useSyncExternalStore(subscribe, getCurrentState, getCurrentState);\n\n  // Api generators are memoized to prevent unnecessary re-renders.\n  const [memoedApiGenerators] = useState(() => definition.api);\n\n  // Wrap and remap each API generator using the resolver.\n  const api = useMemo(() => {\n    const wrapped: Record<string, any> = {};\n    for (const key in memoedApiGenerators) {\n      if (Object.prototype.hasOwnProperty.call(memoedApiGenerators, key)) {\n        // Remove the 'ask' prefix and lower-case the first character.\n        const withoutAsk = key.slice(3); // e.g., \"FetchTodos\"\n        const newKey = withoutAsk.charAt(0).toLowerCase() + withoutAsk.slice(1); // \"fetchTodos\"\n        // We know newKey matches our mapped type so we can assign.\n        // (A type assertion is used here to quiet the compiler.)\n        wrapped[newKey] = resolver(memoedApiGenerators[key as any]) as any;\n      }\n    }\n    return wrapped;\n  }, [resolver, memoedApiGenerators]);\n\n  return [api as QpqMappedApi<TApi>, state, dispatch];\n}\n"]}

package/lib/esm/runtime/useQpqRuntimeComputed.d.ts

@@ -0,0 +1,2 @@
+import { QpqRuntimeComputed } from './createQpqRuntimeComputed';
+export declare function useQpqRuntimeComputed<TState, TSlice>(computed: QpqRuntimeComputed<TState, TSlice>, instanceName?: string): TSlice;

package/lib/esm/runtime/useQpqRuntimeComputed.js

@@ -0,0 +1,23 @@
+import { useRef, useSyncExternalStore } from 'react';
+import { useEffectCallback } from '../hooks/useEffectCallback';
+import { useQpqAreaBinding } from './useQpqAreaBinding';
+export function useQpqRuntimeComputed(computed, instanceName) {
+    const { subscribe, getCurrentState } = useQpqAreaBinding(computed.definition, instanceName);
+    const sliceCache = useRef(null);
+    // The snapshot returns a referentially stable slice so the component only
+    // re-renders when its slice actually changes, not on every area update.
+    const computeStableSlice = () => {
+        const state = getCurrentState();
+        const cached = sliceCache.current;
+        if (cached && Object.is(cached.state, state)) {
+            return cached.slice;
+        }
+        const slice = computed.compute(state);
+        const stableSlice = cached && Object.is(cached.slice, slice) ? cached.slice : slice;
+        sliceCache.current = { state, slice: stableSlice };
+        return stableSlice;
+    };
+    const getSlice = useEffectCallback(computeStableSlice);
+    return useSyncExternalStore(subscribe, getSlice, getSlice);
+}
+//# sourceMappingURL=useQpqRuntimeComputed.js.map

package/lib/esm/runtime/useQpqRuntimeComputed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useQpqRuntimeComputed.js","sourceRoot":"","sources":["../../../src/runtime/useQpqRuntimeComputed.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAOxD,MAAM,UAAU,qBAAqB,CAAiB,QAA4C,EAAE,YAAqB;IACvH,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,iBAAiB,CAAC,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAE5F,MAAM,UAAU,GAAG,MAAM,CAA4C,IAAI,CAAC,CAAC;IAE3E,0EAA0E;IAC1E,wEAAwE;IACxE,MAAM,kBAAkB,GAAG,GAAW,EAAE;QACtC,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC;QAElC,IAAI,MAAM,IAAI,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;YAC7C,OAAO,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,WAAW,GAAG,MAAM,IAAI,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;QAEpF,UAAU,CAAC,OAAO,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QACnD,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;IAEvD,OAAO,oBAAoB,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC7D,CAAC","sourcesContent":["import { Nullable } from 'quidproquo-core';\n\nimport { useRef, useSyncExternalStore } from 'react';\n\nimport { useEffectCallback } from '../hooks/useEffectCallback';\nimport { QpqRuntimeComputed } from './createQpqRuntimeComputed';\nimport { useQpqAreaBinding } from './useQpqAreaBinding';\n\ntype SliceCacheEntry<TState, TSlice> = {\n  state: TState;\n  slice: TSlice;\n};\n\nexport function useQpqRuntimeComputed<TState, TSlice>(computed: QpqRuntimeComputed<TState, TSlice>, instanceName?: string): TSlice {\n  const { subscribe, getCurrentState } = useQpqAreaBinding(computed.definition, instanceName);\n\n  const sliceCache = useRef<Nullable<SliceCacheEntry<TState, TSlice>>>(null);\n\n  // The snapshot returns a referentially stable slice so the component only\n  // re-renders when its slice actually changes, not on every area update.\n  const computeStableSlice = (): TSlice => {\n    const state = getCurrentState();\n    const cached = sliceCache.current;\n\n    if (cached && Object.is(cached.state, state)) {\n      return cached.slice;\n    }\n\n    const slice = computed.compute(state);\n    const stableSlice = cached && Object.is(cached.slice, slice) ? cached.slice : slice;\n\n    sliceCache.current = { state, slice: stableSlice };\n    return stableSlice;\n  };\n  const getSlice = useEffectCallback(computeStableSlice);\n\n  return useSyncExternalStore(subscribe, getSlice, getSlice);\n}\n"]}

package/lib/esm/store/QpqStoreProvider.d.ts

@@ -0,0 +1,8 @@
+import { ReactNode } from 'react';
+import { QpqStore } from './createQpqStore';
+type QpqStoreProviderProps = {
+    store?: QpqStore;
+    children: ReactNode;
+};
+export declare const QpqStoreProvider: ({ store, children }: QpqStoreProviderProps) => import("react").JSX.Element;
+export {};

package/lib/esm/store/QpqStoreProvider.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useState } from 'react';
+import { createQpqStore } from './createQpqStore';
+import { qpqStoreContext } from './qpqStoreContext';
+export const QpqStoreProvider = ({ store, children }) => {
+    const [ownStore] = useState(createQpqStore);
+    return _jsx(qpqStoreContext.Provider, { value: store ?? ownStore, children: children });
+};
+//# sourceMappingURL=QpqStoreProvider.js.map

package/lib/esm/store/QpqStoreProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QpqStoreProvider.js","sourceRoot":"","sources":["../../../src/store/QpqStoreProvider.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAa,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAY,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AASpD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAyB,EAAE,EAAE;IAC7E,MAAM,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAC;IAE5C,OAAO,KAAC,eAAe,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,IAAI,QAAQ,YAAG,QAAQ,GAA4B,CAAC;AACnG,CAAC,CAAC","sourcesContent":["import { ReactNode, useState } from 'react';\n\nimport { createQpqStore, QpqStore } from './createQpqStore';\nimport { qpqStoreContext } from './qpqStoreContext';\n\ntype QpqStoreProviderProps = {\n  // Pass a store the app created itself when imperative (non-react) code also\n  // needs to read it; omitted, the provider creates and owns one.\n  store?: QpqStore;\n  children: ReactNode;\n};\n\nexport const QpqStoreProvider = ({ store, children }: QpqStoreProviderProps) => {\n  const [ownStore] = useState(createQpqStore);\n\n  return <qpqStoreContext.Provider value={store ?? ownStore}>{children}</qpqStoreContext.Provider>;\n};\n"]}

package/lib/esm/store/connectQpqStoreToReduxDevTools.d.ts

@@ -0,0 +1,2 @@
+import type { QpqStore } from './createQpqStore';
+export declare const connectQpqStoreToReduxDevTools: (store: QpqStore, name?: string) => (() => void);

package/lib/esm/store/connectQpqStoreToReduxDevTools.js

@@ -0,0 +1,137 @@
+// The buttons we can honour. Skip/reorder stay off: they need replaying the
+// effect log through the binders' reducers, which live outside the store.
+const DEVTOOLS_FEATURES = {
+    pause: false,
+    lock: true,
+    persist: false,
+    export: true,
+    import: false,
+    jump: true,
+    skip: false,
+    reorder: false,
+    dispatch: false,
+    test: false,
+};
+// Wires a qpq store to the Redux DevTools browser extension: the devtools
+// state pane shows the ENTIRE app state (one key per bound area), every
+// seed / set_state / release lands as a named action with diffs, and the
+// jump/slider controls time travel the store.
+//
+// Time travel freezes the world automatically: any jump away from the newest
+// action freezes the store (live writes dropped, releases deferred, onInit
+// skipped, sends muted), and jumping back to the newest action thaws it.
+// While frozen, restores can resurrect released areas at count 0, so
+// components popping in render the historical state instead of fetching.
+// The extension's lock button is a manual freeze with the same semantics,
+// and COMMIT adopts whatever is on screen as the new present.
+//
+// A noop returning a noop when the extension is not installed, so call it
+// unconditionally right after creating the store.
+export const connectQpqStoreToReduxDevTools = (store, name = 'qpq-store') => {
+    const extension = globalThis.__REDUX_DEVTOOLS_EXTENSION__;
+    if (!extension) {
+        return () => { };
+    }
+    const connection = extension.connect({ name, features: DEVTOOLS_FEATURES });
+    // Mirrors the extension's action ids (@@INIT is 0, each send increments,
+    // init resets) so a jump back onto the newest action is recognisable as
+    // "back at head". If a jump arrives without an actionId the store stays
+    // frozen; lock-off or COMMIT are the manual ways out.
+    let latestActionId = 0;
+    let isJumpedAwayFromHead = false;
+    let isLockedByUser = false;
+    const syncFrozen = () => {
+        if (isJumpedAwayFromHead || isLockedByUser) {
+            store.freeze();
+        }
+        else {
+            store.thaw();
+        }
+    };
+    const restoreSnapshot = (snapshot) => {
+        for (const [areaKey, areaState] of Object.entries(snapshot)) {
+            store.restoreAreaState(areaKey, areaState);
+        }
+    };
+    const parseSerializedState = (serializedState) => {
+        try {
+            return JSON.parse(serializedState);
+        }
+        catch {
+            console.warn('qpq store devtools: could not parse time-travel state, ignoring jump');
+            return undefined;
+        }
+    };
+    // RESET returns to this baseline; COMMIT moves it to the present.
+    let committedSnapshot = store.getSnapshot();
+    connection.init(committedSnapshot);
+    const handleJump = (message) => {
+        const snapshot = message.state ? parseSerializedState(message.state) : undefined;
+        if (!snapshot) {
+            return;
+        }
+        isJumpedAwayFromHead = message.payload?.actionId !== latestActionId;
+        // Freeze before restoring so a jump into the past can resurrect released
+        // areas; on the jump back to head, restore first and thaw after so the
+        // sweep sees final bind counts.
+        if (isJumpedAwayFromHead) {
+            syncFrozen();
+            restoreSnapshot(snapshot);
+        }
+        else {
+            restoreSnapshot(snapshot);
+            syncFrozen();
+        }
+    };
+    const handleDevToolsMessage = (message) => {
+        if (message.type !== 'DISPATCH') {
+            return;
+        }
+        const payloadType = message.payload?.type;
+        if (payloadType === 'JUMP_TO_ACTION' || payloadType === 'JUMP_TO_STATE') {
+            handleJump(message);
+            return;
+        }
+        if (payloadType === 'LOCK_CHANGES') {
+            isLockedByUser = message.payload?.status === true;
+            syncFrozen();
+            return;
+        }
+        // Adopt whatever is on screen (possibly a jumped-to past) as the new
+        // present: thaw first so the sweep runs, then rebase the baseline.
+        if (payloadType === 'COMMIT') {
+            isJumpedAwayFromHead = false;
+            syncFrozen();
+            committedSnapshot = store.getSnapshot();
+            connection.init(committedSnapshot);
+            latestActionId = 0;
+            return;
+        }
+        if (payloadType === 'ROLLBACK' || payloadType === 'RESET') {
+            const snapshot = payloadType === 'ROLLBACK' && message.state ? parseSerializedState(message.state) : committedSnapshot;
+            if (!snapshot) {
+                return;
+            }
+            restoreSnapshot(snapshot);
+            isJumpedAwayFromHead = false;
+            syncFrozen();
+            connection.init(store.getSnapshot());
+            latestActionId = 0;
+        }
+    };
+    const unsubscribeDevTools = connection.subscribe?.(handleDevToolsMessage);
+    const unsubscribeStore = store.subscribeToStore((event) => {
+        // Frozen means the world is on pause: seeds from pop-ins mid-scrub are
+        // history echoes, not new activity, and must not grow the action log.
+        if (store.isFrozen()) {
+            return;
+        }
+        latestActionId += 1;
+        connection.send({ type: `${event.type}: ${event.areaKey}` }, store.getSnapshot());
+    });
+    return () => {
+        unsubscribeStore();
+        unsubscribeDevTools?.();
+    };
+};
+//# sourceMappingURL=connectQpqStoreToReduxDevTools.js.map

package/lib/esm/store/connectQpqStoreToReduxDevTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectQpqStoreToReduxDevTools.js","sourceRoot":"","sources":["../../../src/store/connectQpqStoreToReduxDevTools.ts"],"names":[],"mappings":"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","sourcesContent":["// Type-only: createQpqStore imports this module at runtime (to honour\n// devToolsName), so the back-edge must stay erasable.\nimport type { QpqStore } from './createQpqStore';\n\ntype ReduxDevToolsMessage = {\n  type: string;\n  payload?: { type?: string; actionId?: number; status?: boolean };\n  state?: string;\n};\n\ntype ReduxDevToolsConnection = {\n  init(state: unknown): void;\n  send(action: { type: string }, state: unknown): void;\n  subscribe?(listener: (message: ReduxDevToolsMessage) => void): (() => void) | undefined;\n};\n\ntype ReduxDevToolsExtension = {\n  connect(options: { name: string; features?: Record<string, boolean> }): ReduxDevToolsConnection;\n};\n\n// The buttons we can honour. Skip/reorder stay off: they need replaying the\n// effect log through the binders' reducers, which live outside the store.\nconst DEVTOOLS_FEATURES: Record<string, boolean> = {\n  pause: false,\n  lock: true,\n  persist: false,\n  export: true,\n  import: false,\n  jump: true,\n  skip: false,\n  reorder: false,\n  dispatch: false,\n  test: false,\n};\n\n// Wires a qpq store to the Redux DevTools browser extension: the devtools\n// state pane shows the ENTIRE app state (one key per bound area), every\n// seed / set_state / release lands as a named action with diffs, and the\n// jump/slider controls time travel the store.\n//\n// Time travel freezes the world automatically: any jump away from the newest\n// action freezes the store (live writes dropped, releases deferred, onInit\n// skipped, sends muted), and jumping back to the newest action thaws it.\n// While frozen, restores can resurrect released areas at count 0, so\n// components popping in render the historical state instead of fetching.\n// The extension's lock button is a manual freeze with the same semantics,\n// and COMMIT adopts whatever is on screen as the new present.\n//\n// A noop returning a noop when the extension is not installed, so call it\n// unconditionally right after creating the store.\nexport const connectQpqStoreToReduxDevTools = (store: QpqStore, name: string = 'qpq-store'): (() => void) => {\n  const extension = (globalThis as { __REDUX_DEVTOOLS_EXTENSION__?: ReduxDevToolsExtension }).__REDUX_DEVTOOLS_EXTENSION__;\n\n  if (!extension) {\n    return () => {};\n  }\n\n  const connection = extension.connect({ name, features: DEVTOOLS_FEATURES });\n\n  // Mirrors the extension's action ids (@@INIT is 0, each send increments,\n  // init resets) so a jump back onto the newest action is recognisable as\n  // \"back at head\". If a jump arrives without an actionId the store stays\n  // frozen; lock-off or COMMIT are the manual ways out.\n  let latestActionId = 0;\n  let isJumpedAwayFromHead = false;\n  let isLockedByUser = false;\n\n  const syncFrozen = (): void => {\n    if (isJumpedAwayFromHead || isLockedByUser) {\n      store.freeze();\n    } else {\n      store.thaw();\n    }\n  };\n\n  const restoreSnapshot = (snapshot: Record<string, unknown>): void => {\n    for (const [areaKey, areaState] of Object.entries(snapshot)) {\n      store.restoreAreaState(areaKey, areaState);\n    }\n  };\n\n  const parseSerializedState = (serializedState: string): Record<string, unknown> | undefined => {\n    try {\n      return JSON.parse(serializedState) as Record<string, unknown>;\n    } catch {\n      console.warn('qpq store devtools: could not parse time-travel state, ignoring jump');\n      return undefined;\n    }\n  };\n\n  // RESET returns to this baseline; COMMIT moves it to the present.\n  let committedSnapshot = store.getSnapshot();\n  connection.init(committedSnapshot);\n\n  const handleJump = (message: ReduxDevToolsMessage): void => {\n    const snapshot = message.state ? parseSerializedState(message.state) : undefined;\n    if (!snapshot) {\n      return;\n    }\n\n    isJumpedAwayFromHead = message.payload?.actionId !== latestActionId;\n\n    // Freeze before restoring so a jump into the past can resurrect released\n    // areas; on the jump back to head, restore first and thaw after so the\n    // sweep sees final bind counts.\n    if (isJumpedAwayFromHead) {\n      syncFrozen();\n      restoreSnapshot(snapshot);\n    } else {\n      restoreSnapshot(snapshot);\n      syncFrozen();\n    }\n  };\n\n  const handleDevToolsMessage = (message: ReduxDevToolsMessage): void => {\n    if (message.type !== 'DISPATCH') {\n      return;\n    }\n\n    const payloadType = message.payload?.type;\n\n    if (payloadType === 'JUMP_TO_ACTION' || payloadType === 'JUMP_TO_STATE') {\n      handleJump(message);\n      return;\n    }\n\n    if (payloadType === 'LOCK_CHANGES') {\n      isLockedByUser = message.payload?.status === true;\n      syncFrozen();\n      return;\n    }\n\n    // Adopt whatever is on screen (possibly a jumped-to past) as the new\n    // present: thaw first so the sweep runs, then rebase the baseline.\n    if (payloadType === 'COMMIT') {\n      isJumpedAwayFromHead = false;\n      syncFrozen();\n      committedSnapshot = store.getSnapshot();\n      connection.init(committedSnapshot);\n      latestActionId = 0;\n      return;\n    }\n\n    if (payloadType === 'ROLLBACK' || payloadType === 'RESET') {\n      const snapshot = payloadType === 'ROLLBACK' && message.state ? parseSerializedState(message.state) : committedSnapshot;\n      if (!snapshot) {\n        return;\n      }\n\n      restoreSnapshot(snapshot);\n      isJumpedAwayFromHead = false;\n      syncFrozen();\n      connection.init(store.getSnapshot());\n      latestActionId = 0;\n    }\n  };\n  const unsubscribeDevTools = connection.subscribe?.(handleDevToolsMessage);\n\n  const unsubscribeStore = store.subscribeToStore((event) => {\n    // Frozen means the world is on pause: seeds from pop-ins mid-scrub are\n    // history echoes, not new activity, and must not grow the action log.\n    if (store.isFrozen()) {\n      return;\n    }\n\n    latestActionId += 1;\n    connection.send({ type: `${event.type}: ${event.areaKey}` }, store.getSnapshot());\n  });\n\n  return () => {\n    unsubscribeStore();\n    unsubscribeDevTools?.();\n  };\n};\n"]}

package/lib/esm/store/createQpqStore.d.ts

@@ -0,0 +1,22 @@
+export type QpqStoreEvent = {
+    type: 'seed' | 'set_state' | 'release';
+    areaKey: string;
+};
+export type QpqStoreOptions = {
+    devToolsName?: string;
+};
+export type QpqStore = {
+    hasArea(areaKey: string): boolean;
+    getAreaState(areaKey: string): unknown;
+    setAreaState(areaKey: string, state: unknown): void;
+    restoreAreaState(areaKey: string, state: unknown): void;
+    bindArea(areaKey: string, initialState: unknown): boolean;
+    unbindArea(areaKey: string): void;
+    subscribe(areaKey: string, listener: () => void): () => void;
+    subscribeToStore(listener: (event: QpqStoreEvent) => void): () => void;
+    getSnapshot(): Record<string, unknown>;
+    freeze(): void;
+    thaw(): void;
+    isFrozen(): boolean;
+};
+export declare function createQpqStore(options?: QpqStoreOptions): QpqStore;

package/lib/esm/store/createQpqStore.js

@@ -0,0 +1,156 @@
+import { connectQpqStoreToReduxDevTools } from './connectQpqStoreToReduxDevTools';
+// process.env is only defined when a bundler injects it, so reach through
+// globalThis rather than referencing process directly.
+const isDevEnvironment = () => {
+    const nodeEnv = globalThis.process?.env?.NODE_ENV;
+    return nodeEnv !== 'production';
+};
+export function createQpqStore(options) {
+    const areas = new Map();
+    // Listener lifetime is independent of area lifetime: React subscribes and
+    // binds in separate effects, and an area can be deleted and re-seeded while
+    // a subscriber from the same commit is still attached.
+    const listenersByArea = new Map();
+    // Store-wide observers (devtools, logging) hear every mutation with what
+    // happened; per-area subscribers just hear that their area changed.
+    const storeListeners = new Set();
+    let frozen = false;
+    const notifyArea = (areaKey) => {
+        const listeners = listenersByArea.get(areaKey);
+        if (!listeners) {
+            return;
+        }
+        for (const listener of [...listeners]) {
+            listener();
+        }
+    };
+    const notifyStore = (event) => {
+        for (const listener of [...storeListeners]) {
+            listener(event);
+        }
+    };
+    const store = {
+        hasArea: (areaKey) => areas.has(areaKey),
+        getAreaState: (areaKey) => areas.get(areaKey)?.state,
+        setAreaState: (areaKey, state) => {
+            // Frozen: the app is displaying a devtools-restored moment; live writes
+            // (in-flight stories, late fetches, websocket pushes) lose, silently,
+            // so they cannot repaint the past.
+            if (frozen) {
+                return;
+            }
+            const area = areas.get(areaKey);
+            // Smart pointer semantics: unbound state does not exist, late writers
+            // (in-flight stories, websocket pushes) lose.
+            if (!area) {
+                if (isDevEnvironment()) {
+                    console.warn(`qpq store: dropped set_state for unbound area "${areaKey}"`);
+                }
+                return;
+            }
+            area.state = state;
+            notifyArea(areaKey);
+            notifyStore({ type: 'set_state', areaKey });
+        },
+        restoreAreaState: (areaKey, state) => {
+            const area = areas.get(areaKey);
+            if (area) {
+                area.state = state;
+                notifyArea(areaKey);
+                return;
+            }
+            // While frozen a restore may resurrect an area that was released before
+            // the freeze: it sits at count 0 so a component popping in binds it
+            // (count 0 -> 1, NOT a first bind) and renders the historical state
+            // instead of fetching. Thaw sweeps whatever is still unbound.
+            if (frozen) {
+                areas.set(areaKey, { count: 0, state });
+                notifyArea(areaKey);
+            }
+        },
+        bindArea: (areaKey, initialState) => {
+            const area = areas.get(areaKey);
+            if (area) {
+                area.count += 1;
+                return false;
+            }
+            areas.set(areaKey, { count: 1, state: initialState });
+            // An unmount can delete the area in the same commit a mount re-seeds
+            // it; subscribers must re-read or they keep rendering the deleted state.
+            notifyArea(areaKey);
+            notifyStore({ type: 'seed', areaKey });
+            return true;
+        },
+        unbindArea: (areaKey) => {
+            const area = areas.get(areaKey);
+            if (!area) {
+                return;
+            }
+            area.count -= 1;
+            if (area.count > 0) {
+                return;
+            }
+            // Frozen: defer the delete (entry stays at count 0) so scrubbing
+            // forward can rebind without losing state; thaw does the sweep.
+            if (frozen) {
+                return;
+            }
+            areas.delete(areaKey);
+            notifyStore({ type: 'release', areaKey });
+        },
+        subscribe: (areaKey, listener) => {
+            let listeners = listenersByArea.get(areaKey);
+            if (!listeners) {
+                listeners = new Set();
+                listenersByArea.set(areaKey, listeners);
+            }
+            listeners.add(listener);
+            const capturedListeners = listeners;
+            return () => {
+                capturedListeners.delete(listener);
+                // Only drop the map entry if it still holds this set; another
+                // subscriber may have recreated it after we emptied out.
+                if (capturedListeners.size === 0 && listenersByArea.get(areaKey) === capturedListeners) {
+                    listenersByArea.delete(areaKey);
+                }
+            };
+        },
+        subscribeToStore: (listener) => {
+            storeListeners.add(listener);
+            return () => {
+                storeListeners.delete(listener);
+            };
+        },
+        // The entire live app state as one plain object, one key per bound area.
+        getSnapshot: () => {
+            const snapshot = {};
+            for (const [areaKey, area] of areas) {
+                snapshot[areaKey] = area.state;
+            }
+            return snapshot;
+        },
+        freeze: () => {
+            frozen = true;
+        },
+        thaw: () => {
+            if (!frozen) {
+                return;
+            }
+            frozen = false;
+            // Sweep the deferred releases and time-travel resurrections nothing is
+            // bound to any more.
+            for (const [areaKey, area] of [...areas]) {
+                if (area.count <= 0) {
+                    areas.delete(areaKey);
+                    notifyStore({ type: 'release', areaKey });
+                }
+            }
+        },
+        isFrozen: () => frozen,
+    };
+    if (options?.devToolsName) {
+        connectQpqStoreToReduxDevTools(store, options.devToolsName);
+    }
+    return store;
+}
+//# sourceMappingURL=createQpqStore.js.map

package/lib/esm/store/createQpqStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createQpqStore.js","sourceRoot":"","sources":["../../../src/store/createQpqStore.ts"],"names":[],"mappings":"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","sourcesContent":["import { connectQpqStoreToReduxDevTools } from './connectQpqStoreToReduxDevTools';\n\nexport type QpqStoreEvent = {\n  type: 'seed' | 'set_state' | 'release';\n  areaKey: string;\n};\n\nexport type QpqStoreOptions = {\n  // Connect to the Redux DevTools browser extension under this instance name.\n  // Opt-in so anonymous stores (tests, provider-owned) stay unconnected.\n  devToolsName?: string;\n};\n\nexport type QpqStore = {\n  hasArea(areaKey: string): boolean;\n  getAreaState(areaKey: string): unknown;\n  setAreaState(areaKey: string, state: unknown): void;\n  // Time-travel/hydration escape hatch: writes even while frozen, emits no\n  // store event, and while frozen may resurrect an unbound area at count 0.\n  restoreAreaState(areaKey: string, state: unknown): void;\n  bindArea(areaKey: string, initialState: unknown): boolean;\n  unbindArea(areaKey: string): void;\n  subscribe(areaKey: string, listener: () => void): () => void;\n  subscribeToStore(listener: (event: QpqStoreEvent) => void): () => void;\n  getSnapshot(): Record<string, unknown>;\n  // Frozen = the world is on pause (devtools time travel): live writes are\n  // dropped, releases are deferred, and binders skip onInit. Thaw resumes\n  // normal behaviour and sweeps areas nothing is bound to any more.\n  freeze(): void;\n  thaw(): void;\n  isFrozen(): boolean;\n};\n\ntype QpqStoreAreaEntry = {\n  count: number;\n  state: unknown;\n};\n\n// process.env is only defined when a bundler injects it, so reach through\n// globalThis rather than referencing process directly.\nconst isDevEnvironment = (): boolean => {\n  const nodeEnv = (globalThis as { process?: { env?: { NODE_ENV?: string } } }).process?.env?.NODE_ENV;\n  return nodeEnv !== 'production';\n};\n\nexport function createQpqStore(options?: QpqStoreOptions): QpqStore {\n  const areas = new Map<string, QpqStoreAreaEntry>();\n\n  // Listener lifetime is independent of area lifetime: React subscribes and\n  // binds in separate effects, and an area can be deleted and re-seeded while\n  // a subscriber from the same commit is still attached.\n  const listenersByArea = new Map<string, Set<() => void>>();\n\n  // Store-wide observers (devtools, logging) hear every mutation with what\n  // happened; per-area subscribers just hear that their area changed.\n  const storeListeners = new Set<(event: QpqStoreEvent) => void>();\n\n  let frozen = false;\n\n  const notifyArea = (areaKey: string): void => {\n    const listeners = listenersByArea.get(areaKey);\n    if (!listeners) {\n      return;\n    }\n\n    for (const listener of [...listeners]) {\n      listener();\n    }\n  };\n\n  const notifyStore = (event: QpqStoreEvent): void => {\n    for (const listener of [...storeListeners]) {\n      listener(event);\n    }\n  };\n\n  const store: QpqStore = {\n    hasArea: (areaKey: string): boolean => areas.has(areaKey),\n\n    getAreaState: (areaKey: string): unknown => areas.get(areaKey)?.state,\n\n    setAreaState: (areaKey: string, state: unknown): void => {\n      // Frozen: the app is displaying a devtools-restored moment; live writes\n      // (in-flight stories, late fetches, websocket pushes) lose, silently,\n      // so they cannot repaint the past.\n      if (frozen) {\n        return;\n      }\n\n      const area = areas.get(areaKey);\n\n      // Smart pointer semantics: unbound state does not exist, late writers\n      // (in-flight stories, websocket pushes) lose.\n      if (!area) {\n        if (isDevEnvironment()) {\n          console.warn(`qpq store: dropped set_state for unbound area \"${areaKey}\"`);\n        }\n        return;\n      }\n\n      area.state = state;\n      notifyArea(areaKey);\n      notifyStore({ type: 'set_state', areaKey });\n    },\n\n    restoreAreaState: (areaKey: string, state: unknown): void => {\n      const area = areas.get(areaKey);\n      if (area) {\n        area.state = state;\n        notifyArea(areaKey);\n        return;\n      }\n\n      // While frozen a restore may resurrect an area that was released before\n      // the freeze: it sits at count 0 so a component popping in binds it\n      // (count 0 -> 1, NOT a first bind) and renders the historical state\n      // instead of fetching. Thaw sweeps whatever is still unbound.\n      if (frozen) {\n        areas.set(areaKey, { count: 0, state });\n        notifyArea(areaKey);\n      }\n    },\n\n    bindArea: (areaKey: string, initialState: unknown): boolean => {\n      const area = areas.get(areaKey);\n      if (area) {\n        area.count += 1;\n        return false;\n      }\n\n      areas.set(areaKey, { count: 1, state: initialState });\n\n      // An unmount can delete the area in the same commit a mount re-seeds\n      // it; subscribers must re-read or they keep rendering the deleted state.\n      notifyArea(areaKey);\n      notifyStore({ type: 'seed', areaKey });\n\n      return true;\n    },\n\n    unbindArea: (areaKey: string): void => {\n      const area = areas.get(areaKey);\n      if (!area) {\n        return;\n      }\n\n      area.count -= 1;\n      if (area.count > 0) {\n        return;\n      }\n\n      // Frozen: defer the delete (entry stays at count 0) so scrubbing\n      // forward can rebind without losing state; thaw does the sweep.\n      if (frozen) {\n        return;\n      }\n\n      areas.delete(areaKey);\n      notifyStore({ type: 'release', areaKey });\n    },\n\n    subscribe: (areaKey: string, listener: () => void): (() => void) => {\n      let listeners = listenersByArea.get(areaKey);\n      if (!listeners) {\n        listeners = new Set();\n        listenersByArea.set(areaKey, listeners);\n      }\n\n      listeners.add(listener);\n\n      const capturedListeners = listeners;\n      return () => {\n        capturedListeners.delete(listener);\n\n        // Only drop the map entry if it still holds this set; another\n        // subscriber may have recreated it after we emptied out.\n        if (capturedListeners.size === 0 && listenersByArea.get(areaKey) === capturedListeners) {\n          listenersByArea.delete(areaKey);\n        }\n      };\n    },\n\n    subscribeToStore: (listener: (event: QpqStoreEvent) => void): (() => void) => {\n      storeListeners.add(listener);\n      return () => {\n        storeListeners.delete(listener);\n      };\n    },\n\n    // The entire live app state as one plain object, one key per bound area.\n    getSnapshot: (): Record<string, unknown> => {\n      const snapshot: Record<string, unknown> = {};\n      for (const [areaKey, area] of areas) {\n        snapshot[areaKey] = area.state;\n      }\n      return snapshot;\n    },\n\n    freeze: (): void => {\n      frozen = true;\n    },\n\n    thaw: (): void => {\n      if (!frozen) {\n        return;\n      }\n\n      frozen = false;\n\n      // Sweep the deferred releases and time-travel resurrections nothing is\n      // bound to any more.\n      for (const [areaKey, area] of [...areas]) {\n        if (area.count <= 0) {\n          areas.delete(areaKey);\n          notifyStore({ type: 'release', areaKey });\n        }\n      }\n    },\n\n    isFrozen: (): boolean => frozen,\n  };\n\n  if (options?.devToolsName) {\n    connectQpqStoreToReduxDevTools(store, options.devToolsName);\n  }\n\n  return store;\n}\n"]}

package/lib/esm/store/index.d.ts

@@ -0,0 +1,5 @@
+export * from './connectQpqStoreToReduxDevTools';
+export * from './createQpqStore';
+export * from './qpqStoreContext';
+export * from './QpqStoreProvider';
+export * from './useQpqStore';

package/lib/esm/store/index.js

@@ -0,0 +1,6 @@
+export * from './connectQpqStoreToReduxDevTools';
+export * from './createQpqStore';
+export * from './qpqStoreContext';
+export * from './QpqStoreProvider';
+export * from './useQpqStore';
+//# sourceMappingURL=index.js.map

package/lib/esm/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/store/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC","sourcesContent":["export * from './connectQpqStoreToReduxDevTools';\nexport * from './createQpqStore';\nexport * from './qpqStoreContext';\nexport * from './QpqStoreProvider';\nexport * from './useQpqStore';\n"]}

package/lib/esm/store/qpqStoreContext.d.ts

@@ -0,0 +1,3 @@
+import { Nullable } from 'quidproquo-core';
+import { QpqStore } from './createQpqStore';
+export declare const qpqStoreContext: import("react").Context<Nullable<QpqStore>>;

package/lib/esm/store/qpqStoreContext.js

@@ -0,0 +1,3 @@
+import { createContext } from 'react';
+export const qpqStoreContext = createContext(null);
+//# sourceMappingURL=qpqStoreContext.js.map

package/lib/esm/store/qpqStoreContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qpqStoreContext.js","sourceRoot":"","sources":["../../../src/store/qpqStoreContext.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAItC,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAqB,IAAI,CAAC,CAAC","sourcesContent":["import { Nullable } from 'quidproquo-core';\n\nimport { createContext } from 'react';\n\nimport { QpqStore } from './createQpqStore';\n\nexport const qpqStoreContext = createContext<Nullable<QpqStore>>(null);\n"]}

package/lib/esm/store/useQpqStore.d.ts

@@ -0,0 +1,2 @@
+import { QpqStore } from './createQpqStore';
+export declare const useQpqStore: () => QpqStore;

package/lib/esm/store/useQpqStore.js

@@ -0,0 +1,10 @@
+import { useContext } from 'react';
+import { qpqStoreContext } from './qpqStoreContext';
+export const useQpqStore = () => {
+    const store = useContext(qpqStoreContext);
+    if (!store) {
+        throw new Error('useQpqStore must be used inside a QpqStoreProvider');
+    }
+    return store;
+};
+//# sourceMappingURL=useQpqStore.js.map

package/lib/esm/store/useQpqStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useQpqStore.js","sourceRoot":"","sources":["../../../src/store/useQpqStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAGnC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,CAAC,MAAM,WAAW,GAAG,GAAa,EAAE;IACxC,MAAM,KAAK,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IAE1C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC","sourcesContent":["import { useContext } from 'react';\n\nimport { QpqStore } from './createQpqStore';\nimport { qpqStoreContext } from './qpqStoreContext';\n\nexport const useQpqStore = (): QpqStore => {\n  const store = useContext(qpqStoreContext);\n\n  if (!store) {\n    throw new Error('useQpqStore must be used inside a QpqStoreProvider');\n  }\n\n  return store;\n};\n"]}

package/lib/esm/useFieldBinding/useFieldBinding.d.ts

@@ -1,2 +1,2 @@
-import { QpqRuntimeComputed } from '../hooks/asmj/createQpqRuntimeDefinition';
+import { QpqRuntimeComputed } from '../runtime/createQpqRuntimeComputed';
 export declare const useFieldBinding: <TState, V, E = any>(computedAtom: QpqRuntimeComputed<TState, V>, someSetter: (value: V) => Promise<void> | void, valueExtractor?: (event: E, ...args: any[]) => V) => [V, (event: E, ...args: any[]) => void];

package/lib/esm/useFieldBinding/useFieldBinding.js

@@ -1,5 +1,5 @@
 import { useEffect, useState } from 'react';
-import { useQpqRuntimeComputed } from '../hooks/asmj/createQpqRuntimeDefinition';
+import { useQpqRuntimeComputed } from '../runtime/useQpqRuntimeComputed';
 export const useFieldBinding = (computedAtom, someSetter, valueExtractor) => {
     const computedValue = useQpqRuntimeComputed(computedAtom);
     const [value, setValue] = useState(computedValue);