quidproquo-web-react 0.1.12 → 0.1.14

package/lib/commonjs/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/commonjs/runtime/useQpqRuntime.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useQpqRuntime = useQpqRuntime;
+const react_1 = require("react");
+const useQpqAreaBinding_1 = require("./useQpqAreaBinding");
+function useQpqRuntime(definition, instanceName, getActionProcessors) {
+    const { subscribe, getCurrentState, dispatch, resolver } = (0, useQpqAreaBinding_1.useQpqAreaBinding)(definition, instanceName, getActionProcessors);
+    const state = (0, react_1.useSyncExternalStore)(subscribe, getCurrentState, getCurrentState);
+    // Api generators are memoized to prevent unnecessary re-renders.
+    const [memoedApiGenerators] = (0, react_1.useState)(() => definition.api);
+    // Wrap and remap each API generator using the resolver.
+    const api = (0, react_1.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/commonjs/runtime/useQpqRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useQpqRuntime.js","sourceRoot":"","sources":["../../../src/runtime/useQpqRuntime.ts"],"names":[],"mappings":";;AAOA,sCA6BC;AApCD,iCAAgE;AAKhE,2DAAwD;AAExD,SAAgB,aAAa,CAC3B,UAAuD,EACvD,YAAqB,EACrB,mBAAgE;IAEhE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAA,qCAAiB,EAAC,UAAU,EAAE,YAAY,EAAE,mBAAmB,CAAC,CAAC;IAE5H,MAAM,KAAK,GAAG,IAAA,4BAAoB,EAAC,SAAS,EAAE,eAAe,EAAE,eAAe,CAAC,CAAC;IAEhF,iEAAiE;IACjE,MAAM,CAAC,mBAAmB,CAAC,GAAG,IAAA,gBAAQ,EAAC,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAE7D,wDAAwD;IACxD,MAAM,GAAG,GAAG,IAAA,eAAO,EAAC,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/commonjs/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/commonjs/runtime/useQpqRuntimeComputed.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useQpqRuntimeComputed = useQpqRuntimeComputed;
+const react_1 = require("react");
+const useEffectCallback_1 = require("../hooks/useEffectCallback");
+const useQpqAreaBinding_1 = require("./useQpqAreaBinding");
+function useQpqRuntimeComputed(computed, instanceName) {
+    const { subscribe, getCurrentState } = (0, useQpqAreaBinding_1.useQpqAreaBinding)(computed.definition, instanceName);
+    const sliceCache = (0, react_1.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 = (0, useEffectCallback_1.useEffectCallback)(computeStableSlice);
+    return (0, react_1.useSyncExternalStore)(subscribe, getSlice, getSlice);
+}
+//# sourceMappingURL=useQpqRuntimeComputed.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useQpqRuntimeComputed.js","sourceRoot":"","sources":["../../../src/runtime/useQpqRuntimeComputed.ts"],"names":[],"mappings":";;AAaA,sDAwBC;AAnCD,iCAAqD;AAErD,kEAA+D;AAE/D,2DAAwD;AAOxD,SAAgB,qBAAqB,CAAiB,QAA4C,EAAE,YAAqB;IACvH,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,IAAA,qCAAiB,EAAC,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAE5F,MAAM,UAAU,GAAG,IAAA,cAAM,EAA4C,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,IAAA,qCAAiB,EAAC,kBAAkB,CAAC,CAAC;IAEvD,OAAO,IAAA,4BAAoB,EAAC,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/commonjs/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/commonjs/store/QpqStoreProvider.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QpqStoreProvider = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const createQpqStore_1 = require("./createQpqStore");
+const qpqStoreContext_1 = require("./qpqStoreContext");
+const QpqStoreProvider = ({ store, children }) => {
+    const [ownStore] = (0, react_1.useState)(createQpqStore_1.createQpqStore);
+    return (0, jsx_runtime_1.jsx)(qpqStoreContext_1.qpqStoreContext.Provider, { value: store !== null && store !== void 0 ? store : ownStore, children: children });
+};
+exports.QpqStoreProvider = QpqStoreProvider;
+//# sourceMappingURL=QpqStoreProvider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QpqStoreProvider.js","sourceRoot":"","sources":["../../../src/store/QpqStoreProvider.tsx"],"names":[],"mappings":";;;;AAAA,iCAA4C;AAE5C,qDAA4D;AAC5D,uDAAoD;AAS7C,MAAM,gBAAgB,GAAG,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAyB,EAAE,EAAE;IAC7E,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAC,+BAAc,CAAC,CAAC;IAE5C,OAAO,uBAAC,iCAAe,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,QAAQ,YAAG,QAAQ,GAA4B,CAAC;AACnG,CAAC,CAAC;AAJW,QAAA,gBAAgB,oBAI3B","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/commonjs/store/connectQpqStoreToReduxDevTools.d.ts

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

package/lib/commonjs/store/connectQpqStoreToReduxDevTools.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectQpqStoreToReduxDevTools = void 0;
+// 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.
+const connectQpqStoreToReduxDevTools = (store, name = 'qpq-store') => {
+    var _a;
+    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 (_a) {
+            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) => {
+        var _a;
+        const snapshot = message.state ? parseSerializedState(message.state) : undefined;
+        if (!snapshot) {
+            return;
+        }
+        isJumpedAwayFromHead = ((_a = message.payload) === null || _a === void 0 ? void 0 : _a.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) => {
+        var _a, _b;
+        if (message.type !== 'DISPATCH') {
+            return;
+        }
+        const payloadType = (_a = message.payload) === null || _a === void 0 ? void 0 : _a.type;
+        if (payloadType === 'JUMP_TO_ACTION' || payloadType === 'JUMP_TO_STATE') {
+            handleJump(message);
+            return;
+        }
+        if (payloadType === 'LOCK_CHANGES') {
+            isLockedByUser = ((_b = message.payload) === null || _b === void 0 ? void 0 : _b.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 = (_a = connection.subscribe) === null || _a === void 0 ? void 0 : _a.call(connection, 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 === null || unsubscribeDevTools === void 0 ? void 0 : unsubscribeDevTools();
+    };
+};
+exports.connectQpqStoreToReduxDevTools = connectQpqStoreToReduxDevTools;
+//# sourceMappingURL=connectQpqStoreToReduxDevTools.js.map

package/lib/commonjs/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/commonjs/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/commonjs/store/createQpqStore.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createQpqStore = createQpqStore;
+const connectQpqStoreToReduxDevTools_1 = require("./connectQpqStoreToReduxDevTools");
+// process.env is only defined when a bundler injects it, so reach through
+// globalThis rather than referencing process directly.
+const isDevEnvironment = () => {
+    var _a, _b;
+    const nodeEnv = (_b = (_a = globalThis.process) === null || _a === void 0 ? void 0 : _a.env) === null || _b === void 0 ? void 0 : _b.NODE_ENV;
+    return nodeEnv !== 'production';
+};
+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) => { var _a; return (_a = areas.get(areaKey)) === null || _a === void 0 ? void 0 : _a.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 === null || options === void 0 ? void 0 : options.devToolsName) {
+        (0, connectQpqStoreToReduxDevTools_1.connectQpqStoreToReduxDevTools)(store, options.devToolsName);
+    }
+    return store;
+}
+//# sourceMappingURL=createQpqStore.js.map

package/lib/commonjs/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/commonjs/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/commonjs/store/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./connectQpqStoreToReduxDevTools"), exports);
+__exportStar(require("./createQpqStore"), exports);
+__exportStar(require("./qpqStoreContext"), exports);
+__exportStar(require("./QpqStoreProvider"), exports);
+__exportStar(require("./useQpqStore"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/store/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mEAAiD;AACjD,mDAAiC;AACjC,oDAAkC;AAClC,qDAAmC;AACnC,gDAA8B","sourcesContent":["export * from './connectQpqStoreToReduxDevTools';\nexport * from './createQpqStore';\nexport * from './qpqStoreContext';\nexport * from './QpqStoreProvider';\nexport * from './useQpqStore';\n"]}

package/lib/commonjs/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/commonjs/store/qpqStoreContext.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.qpqStoreContext = void 0;
+const react_1 = require("react");
+exports.qpqStoreContext = (0, react_1.createContext)(null);
+//# sourceMappingURL=qpqStoreContext.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qpqStoreContext.js","sourceRoot":"","sources":["../../../src/store/qpqStoreContext.ts"],"names":[],"mappings":";;;AAEA,iCAAsC;AAIzB,QAAA,eAAe,GAAG,IAAA,qBAAa,EAAqB,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/commonjs/store/useQpqStore.d.ts

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

package/lib/commonjs/store/useQpqStore.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useQpqStore = void 0;
+const react_1 = require("react");
+const qpqStoreContext_1 = require("./qpqStoreContext");
+const useQpqStore = () => {
+    const store = (0, react_1.useContext)(qpqStoreContext_1.qpqStoreContext);
+    if (!store) {
+        throw new Error('useQpqStore must be used inside a QpqStoreProvider');
+    }
+    return store;
+};
+exports.useQpqStore = useQpqStore;
+//# sourceMappingURL=useQpqStore.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useQpqStore.js","sourceRoot":"","sources":["../../../src/store/useQpqStore.ts"],"names":[],"mappings":";;;AAAA,iCAAmC;AAGnC,uDAAoD;AAE7C,MAAM,WAAW,GAAG,GAAa,EAAE;IACxC,MAAM,KAAK,GAAG,IAAA,kBAAU,EAAC,iCAAe,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;AARW,QAAA,WAAW,eAQtB","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/commonjs/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/commonjs/useFieldBinding/useFieldBinding.js

@@ -2,9 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useFieldBinding = void 0;
 const react_1 = require("react");
-const createQpqRuntimeDefinition_1 = require("../hooks/asmj/createQpqRuntimeDefinition");
+const useQpqRuntimeComputed_1 = require("../runtime/useQpqRuntimeComputed");
 const useFieldBinding = (computedAtom, someSetter, valueExtractor) => {
-    const computedValue = (0, createQpqRuntimeDefinition_1.useQpqRuntimeComputed)(computedAtom);
+    const computedValue = (0, useQpqRuntimeComputed_1.useQpqRuntimeComputed)(computedAtom);
     const [value, setValue] = (0, react_1.useState)(computedValue);
     const handleChange = (event, ...args) => {
         const newValue = valueExtractor ? valueExtractor(event, ...args) : event.target.value;

package/lib/commonjs/useFieldBinding/useFieldBinding.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFieldBinding.js","sourceRoot":"","sources":["../../../src/useFieldBinding/useFieldBinding.ts"],"names":[],"mappings":";;;AAAA,iCAA4C;AAE5C,yFAAqG;AAE9F,MAAM,eAAe,GAAG,CAC7B,YAA2C,EAC3C,UAA8C,EAC9C,cAAgD,EACP,EAAE;IAC3C,MAAM,aAAa,GAAG,IAAA,kDAAqB,EAAC,YAAY,CAAC,CAAC;IAE1D,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAI,aAAa,CAAC,CAAC;IAErD,MAAM,YAAY,GAAG,CAAC,KAAQ,EAAE,GAAG,IAAW,EAAE,EAAE;QAChD,MAAM,QAAQ,GAAM,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAE,KAAa,CAAC,MAAM,CAAC,KAAK,CAAC;QAClG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACnB,UAAU,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC,CAAC;IAEF,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,uEAAuE;QACvE,0EAA0E;QAC1E,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC1B,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;IAEpB,OAAO,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;AAC/B,CAAC,CAAC;AAtBW,QAAA,eAAe,mBAsB1B","sourcesContent":["import { useEffect, useState } from 'react';\n\nimport { QpqRuntimeComputed, useQpqRuntimeComputed } from '../hooks/asmj/createQpqRuntimeDefinition';\n\nexport const useFieldBinding = <TState, V, E = any>(\n  computedAtom: QpqRuntimeComputed<TState, V>,\n  someSetter: (value: V) => Promise<void> | void,\n  valueExtractor?: (event: E, ...args: any[]) => V,\n): [V, (event: E, ...args: any[]) => void] => {\n  const computedValue = useQpqRuntimeComputed(computedAtom);\n\n  const [value, setValue] = useState<V>(computedValue);\n\n  const handleChange = (event: E, ...args: any[]) => {\n    const newValue: V = valueExtractor ? valueExtractor(event, ...args) : (event as any).target.value;\n    setValue(newValue);\n    someSetter(newValue);\n  };\n\n  useEffect(() => {\n    // React bails out when the value is unchanged, so no equality guard is\n    // needed — and local edits (which also change `value`) don't re-run this.\n    setValue(computedValue);\n  }, [computedValue]);\n\n  return [value, handleChange];\n};\n"]}
+{"version":3,"file":"useFieldBinding.js","sourceRoot":"","sources":["../../../src/useFieldBinding/useFieldBinding.ts"],"names":[],"mappings":";;;AAAA,iCAA4C;AAG5C,4EAAyE;AAElE,MAAM,eAAe,GAAG,CAC7B,YAA2C,EAC3C,UAA8C,EAC9C,cAAgD,EACP,EAAE;IAC3C,MAAM,aAAa,GAAG,IAAA,6CAAqB,EAAC,YAAY,CAAC,CAAC;IAE1D,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAI,aAAa,CAAC,CAAC;IAErD,MAAM,YAAY,GAAG,CAAC,KAAQ,EAAE,GAAG,IAAW,EAAE,EAAE;QAChD,MAAM,QAAQ,GAAM,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAE,KAAa,CAAC,MAAM,CAAC,KAAK,CAAC;QAClG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACnB,UAAU,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC,CAAC;IAEF,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,uEAAuE;QACvE,0EAA0E;QAC1E,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC1B,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;IAEpB,OAAO,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;AAC/B,CAAC,CAAC;AAtBW,QAAA,eAAe,mBAsB1B","sourcesContent":["import { useEffect, useState } from 'react';\n\nimport { QpqRuntimeComputed } from '../runtime/createQpqRuntimeComputed';\nimport { useQpqRuntimeComputed } from '../runtime/useQpqRuntimeComputed';\n\nexport const useFieldBinding = <TState, V, E = any>(\n  computedAtom: QpqRuntimeComputed<TState, V>,\n  someSetter: (value: V) => Promise<void> | void,\n  valueExtractor?: (event: E, ...args: any[]) => V,\n): [V, (event: E, ...args: any[]) => void] => {\n  const computedValue = useQpqRuntimeComputed(computedAtom);\n\n  const [value, setValue] = useState<V>(computedValue);\n\n  const handleChange = (event: E, ...args: any[]) => {\n    const newValue: V = valueExtractor ? valueExtractor(event, ...args) : (event as any).target.value;\n    setValue(newValue);\n    someSetter(newValue);\n  };\n\n  useEffect(() => {\n    // React bails out when the value is unchanged, so no equality guard is\n    // needed — and local edits (which also change `value`) don't re-run this.\n    setValue(computedValue);\n  }, [computedValue]);\n\n  return [value, handleChange];\n};\n"]}

package/lib/commonjs/useSharedQueryParams/sharedQueryParamsRuntime.d.ts

@@ -1,3 +1,3 @@
-export declare const sharedQueryParamsRuntime: import("../hooks/asmj/createQpqRuntimeDefinition").QpqRuntimeDefinition<import("./logic").SharedQueryParamsState, import("./logic").SharedQueryParamsSetParamEffect, {
+export declare const sharedQueryParamsRuntime: import("../runtime/createQpqRuntimeDefinition").QpqRuntimeDefinition<import("./logic").SharedQueryParamsState, import("./logic").SharedQueryParamsSetParamEffect, {
     askSetParam: typeof import("./logic/runtime/askSetParam").askSetParam;
 }>;

package/lib/commonjs/useSharedQueryParams/sharedQueryParamsRuntime.js

@@ -1,8 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.sharedQueryParamsRuntime = void 0;
-const createQpqRuntimeDefinition_1 = require("../hooks/asmj/createQpqRuntimeDefinition");
+const createQpqRuntimeDefinition_1 = require("../runtime/createQpqRuntimeDefinition");
 const runtime_1 = require("./logic/runtime");
 const logic_1 = require("./logic");
-exports.sharedQueryParamsRuntime = (0, createQpqRuntimeDefinition_1.createQpqRuntimeDefinition)(runtime_1.sharedQueryParamsLogic, logic_1.sharedQueryParamsInitalState, logic_1.sharedQueryParamsReducer);
+exports.sharedQueryParamsRuntime = (0, createQpqRuntimeDefinition_1.createQpqRuntimeDefinition)({
+    uniqueName: 'qpq/web-react/sharedQueryParams',
+    api: runtime_1.sharedQueryParamsLogic,
+    initialState: logic_1.sharedQueryParamsInitalState,
+    reducer: logic_1.sharedQueryParamsReducer,
+});
 //# sourceMappingURL=sharedQueryParamsRuntime.js.map