@livestore/livestore 0.0.12 → 0.0.14

package/dist/react/useQuery.js

@@ -0,0 +1,42 @@
+import { isEqual } from 'lodash-es';
+import React from 'react';
+import { useStore } from './LiveStoreContext.js';
+import { extractStackInfoFromStackTrace, originalStackLimit } from './utils/extractStackInfoFromStackTrace.js';
+import { useStateRefWithReactiveInput } from './utils/useStateRefWithReactiveInput.js';
+export const useQuery = (query) => {
+    const { store } = useStore();
+    // TODO proper otel context
+    const initialResult = React.useMemo(() => query.run(), [query]);
+    // We know the query has a result by the time we use it; so we can synchronously populate a default state
+    const [valueRef, setValue] = useStateRefWithReactiveInput(initialResult);
+    const subscriptionInfo = React.useMemo(() => {
+        Error.stackTraceLimit = 10;
+        // eslint-disable-next-line unicorn/error-message
+        const stack = new Error().stack;
+        Error.stackTraceLimit = originalStackLimit;
+        return { stack: extractStackInfoFromStackTrace(stack) };
+    }, []);
+    // Subscribe to future updates for this query
+    React.useEffect(() => {
+        return store.otel.tracer.startActiveSpan(`LiveStore:useQuery:${query.label}`, 
+        // `LiveStore:useQuery:${labelForKey(query.componentKey)}:${query.label}`,
+        { attributes: { label: query.label } }, store.otel.queriesSpanContext, (span) => {
+            query.activeSubscriptions.add(subscriptionInfo);
+            const unsub = store.subscribe(query, (v) => {
+                // NOTE: we return a reference to the result object within LiveStore;
+                // this implies that app code must not mutate the results, or else
+                // there may be weird reactivity bugs.
+                if (isEqual(v, valueRef.current) === false) {
+                    setValue(v);
+                }
+            }, undefined, { label: query.label });
+            return () => {
+                query.activeSubscriptions.delete(subscriptionInfo);
+                unsub();
+                span.end();
+            };
+        });
+    }, [subscriptionInfo, query, setValue, store, valueRef]);
+    return valueRef.current;
+};
+//# sourceMappingURL=useQuery.js.map

package/dist/react/useQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useQuery.js","sourceRoot":"","sources":["../../src/react/useQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAChD,OAAO,EAAE,8BAA8B,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAA;AAC9G,OAAO,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAA;AAEtF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAU,KAA+B,EAAW,EAAE;IAC5E,MAAM,EAAE,KAAK,EAAE,GAAG,QAAQ,EAAE,CAAA;IAE5B,2BAA2B;IAC3B,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IAE/D,yGAAyG;IACzG,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,4BAA4B,CAAU,aAAa,CAAC,CAAA;IAEjF,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;QAC1C,KAAK,CAAC,eAAe,GAAG,EAAE,CAAA;QAC1B,iDAAiD;QACjD,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC,KAAM,CAAA;QAChC,KAAK,CAAC,eAAe,GAAG,kBAAkB,CAAA;QAC1C,OAAO,EAAE,KAAK,EAAE,8BAA8B,CAAC,KAAK,CAAC,EAAE,CAAA;IACzD,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,6CAA6C;IAC7C,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CACtC,sBAAsB,KAAK,CAAC,KAAK,EAAE;QACnC,0EAA0E;QAC1E,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE,EACtC,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAC7B,CAAC,IAAI,EAAE,EAAE;YACP,KAAK,CAAC,mBAAmB,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;YAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAC3B,KAAK,EACL,CAAC,CAAC,EAAE,EAAE;gBACJ,qEAAqE;gBACrE,kEAAkE;gBAClE,sCAAsC;gBACtC,IAAI,OAAO,CAAC,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,KAAK,EAAE;oBAC1C,QAAQ,CAAC,CAAC,CAAC,CAAA;iBACZ;YACH,CAAC,EACD,SAAS,EACT,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CACvB,CAAA;YACD,OAAO,GAAG,EAAE;gBACV,KAAK,CAAC,mBAAmB,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAA;gBAClD,KAAK,EAAE,CAAA;gBACP,IAAI,CAAC,GAAG,EAAE,CAAA;YACZ,CAAC,CAAA;QACH,CAAC,CACF,CAAA;IACH,CAAC,EAAE,CAAC,gBAAgB,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAA;IAExD,OAAO,QAAQ,CAAC,OAAO,CAAA;AACzB,CAAC,CAAA"}

package/dist/react/useTemporaryQuery.d.ts

@@ -0,0 +1,8 @@
+import type { ILiveStoreQuery } from '../reactiveQueries/base-class.js';
+/**
+ * Creates a query, subscribes and destroys it when the component unmounts.
+ *
+ * Make sure `makeQuery` is a memoized function.
+ */
+export declare const useTemporaryQuery: <TResult>(makeQuery: () => ILiveStoreQuery<TResult>) => TResult;
+//# sourceMappingURL=useTemporaryQuery.d.ts.map

package/dist/react/useTemporaryQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTemporaryQuery.d.ts","sourceRoot":"","sources":["../../src/react/useTemporaryQuery.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAA;AAGvE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,iEAU7B,CAAA"}

package/dist/react/useTemporaryQuery.js

@@ -0,0 +1,17 @@
+import React from 'react';
+import { useQuery } from './useQuery.js';
+/**
+ * Creates a query, subscribes and destroys it when the component unmounts.
+ *
+ * Make sure `makeQuery` is a memoized function.
+ */
+export const useTemporaryQuery = (makeQuery) => {
+    const query = React.useMemo(() => makeQuery(), [makeQuery]);
+    React.useEffect(() => {
+        return () => {
+            query.destroy();
+        };
+    }, [query]);
+    return useQuery(query);
+};
+//# sourceMappingURL=useTemporaryQuery.js.map

package/dist/react/useTemporaryQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTemporaryQuery.js","sourceRoot":"","sources":["../../src/react/useTemporaryQuery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAU,SAAyC,EAAW,EAAE;IAC/F,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAA;IAE3D,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,OAAO,GAAG,EAAE;YACV,KAAK,CAAC,OAAO,EAAE,CAAA;QACjB,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IAEX,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAA;AACxB,CAAC,CAAA"}

package/dist/react/utils/extractNamesFromStackTrace.d.ts

@@ -0,0 +1,3 @@
+export declare const originalStackLimit: number;
+export declare const extractNamesFromStackTrace: (stackTrace: string) => string[];
+//# sourceMappingURL=extractNamesFromStackTrace.d.ts.map

package/dist/react/utils/extractNamesFromStackTrace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractNamesFromStackTrace.d.ts","sourceRoot":"","sources":["../../../src/react/utils/extractNamesFromStackTrace.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,QAAwB,CAAA;AAqBvD,eAAO,MAAM,0BAA0B,eAAgB,MAAM,KAAG,MAAM,EAoBrE,CAAA"}

package/dist/react/utils/extractNamesFromStackTrace.js

@@ -0,0 +1,40 @@
+export const originalStackLimit = Error.stackTraceLimit;
+/*
+Example stack trace:
+
+Error
+    at https://localhost:8081/@fs/Users/schickling/Code/overtone/submodules/livestore/packages/@livestore/livestore/dist/react/useQuery.js?t=1699550216884:18:23
+    at mountMemo (https://localhost:8081/node_modules/.vite-web/deps/chunk-M23HUTQV.js?v=3eb66ed6:12817:27)
+    at Object.useMemo (https://localhost:8081/node_modules/.vite-web/deps/chunk-M23HUTQV.js?v=3eb66ed6:13141:24)
+    at Object.useMemo (https://localhost:8081/node_modules/.vite-web/deps/chunk-4WADDZ2G.js?v=3eb66ed6:1094:29)
+    at useQuery (https://localhost:8081/@fs/Users/schickling/Code/overtone/submodules/livestore/packages/@livestore/livestore/dist/react/useQuery.js?t=1699550216884:13:33)
+    at useAppState (https://localhost:8081/src/db/AppState.ts?t=1699550216884:17:34)
+    at useRoute (https://localhost:8081/src/db/AppState.ts?t=1699550216884:74:22)
+    at RouteLink (https://localhost:8081/src/components/Link.tsx?t=1699550216884:36:7)
+    at renderWithHooks (https://localhost:8081/node_modules/.vite-web/deps/chunk-M23HUTQV.js?v=3eb66ed6:12171:26)
+    at mountIndeterminateComponent (https://localhost:8081/node_modules/.vite-web/deps/chunk-M23HUTQV.js?v=3eb66ed6:14921:21)
+  
+Approach:
+  - Start filtering at `at useQuery` (including)
+  - Stop filtering at `at renderWithHooks` (excluding)
+ */
+export const extractNamesFromStackTrace = (stackTrace) => {
+    const namePattern = / at (\w+)/g;
+    let match;
+    const names = [];
+    let hasReachedStart = false;
+    while ((match = namePattern.exec(stackTrace)) !== null) {
+        if (match[1]?.startsWith('use')) {
+            hasReachedStart = true;
+            // match[1] contains the captured group, which is the name we want to extract
+            names.unshift(match[1]);
+        }
+        else if (hasReachedStart) {
+            // We've reached the end of the `use*` functions, so we're adding the component name and stop
+            names.unshift(match[1]);
+            break;
+        }
+    }
+    return names;
+};
+//# sourceMappingURL=extractNamesFromStackTrace.js.map

package/dist/react/utils/extractNamesFromStackTrace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractNamesFromStackTrace.js","sourceRoot":"","sources":["../../../src/react/utils/extractNamesFromStackTrace.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC,eAAe,CAAA;AAEvD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,UAAkB,EAAY,EAAE;IACzE,MAAM,WAAW,GAAG,YAAY,CAAA;IAChC,IAAI,KAA6B,CAAA;IACjC,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,eAAe,GAAG,KAAK,CAAA;IAE3B,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,KAAK,IAAI,EAAE;QACtD,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE;YAC/B,eAAe,GAAG,IAAI,CAAA;YAEtB,6EAA6E;YAC7E,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;SACxB;aAAM,IAAI,eAAe,EAAE;YAC1B,6FAA6F;YAC7F,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAA;YACxB,MAAK;SACN;KACF;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA"}

package/dist/react/utils/extractStackInfoFromStackTrace.d.ts

@@ -0,0 +1,7 @@
+export declare const originalStackLimit: number;
+export type StackInfo = {
+    name: string;
+    filePath: string;
+};
+export declare const extractStackInfoFromStackTrace: (stackTrace: string) => StackInfo[];
+//# sourceMappingURL=extractStackInfoFromStackTrace.d.ts.map

package/dist/react/utils/extractStackInfoFromStackTrace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractStackInfoFromStackTrace.d.ts","sourceRoot":"","sources":["../../../src/react/utils/extractStackInfoFromStackTrace.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,QAAwB,CAAA;AAEvD,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAqBD,eAAO,MAAM,8BAA8B,eAAgB,MAAM,KAAG,SAAS,EAoB5E,CAAA"}

package/dist/react/utils/extractStackInfoFromStackTrace.js

@@ -0,0 +1,40 @@
+export const originalStackLimit = Error.stackTraceLimit;
+/*
+Example stack trace:
+
+Error
+    at https://localhost:8081/@fs/Users/schickling/Code/overtone/submodules/livestore/packages/@livestore/livestore/dist/react/useQuery.js?t=1699550216884:18:23
+    at mountMemo (https://localhost:8081/node_modules/.vite-web/deps/chunk-M23HUTQV.js?v=3eb66ed6:12817:27)
+    at Object.useMemo (https://localhost:8081/node_modules/.vite-web/deps/chunk-M23HUTQV.js?v=3eb66ed6:13141:24)
+    at Object.useMemo (https://localhost:8081/node_modules/.vite-web/deps/chunk-4WADDZ2G.js?v=3eb66ed6:1094:29)
+    at useQuery (https://localhost:8081/@fs/Users/schickling/Code/overtone/submodules/livestore/packages/@livestore/livestore/dist/react/useQuery.js?t=1699550216884:13:33)
+    at useAppState (https://localhost:8081/src/db/AppState.ts?t=1699550216884:17:34)
+    at useRoute (https://localhost:8081/src/db/AppState.ts?t=1699550216884:74:22)
+    at RouteLink (https://localhost:8081/src/components/Link.tsx?t=1699550216884:36:7)
+    at renderWithHooks (https://localhost:8081/node_modules/.vite-web/deps/chunk-M23HUTQV.js?v=3eb66ed6:12171:26)
+    at mountIndeterminateComponent (https://localhost:8081/node_modules/.vite-web/deps/chunk-M23HUTQV.js?v=3eb66ed6:14921:21)
+  
+Approach:
+  - Start filtering at `at useQuery` (including)
+  - Stop filtering at `at renderWithHooks` (excluding)
+ */
+export const extractStackInfoFromStackTrace = (stackTrace) => {
+    const namePattern = /at (\S+) \((.+)\)/g;
+    let match;
+    const stackInfoArr = [];
+    let hasReachedStart = false;
+    while ((match = namePattern.exec(stackTrace)) !== null) {
+        const [, name, filePath] = match;
+        if (name.startsWith('use')) {
+            hasReachedStart = true;
+            stackInfoArr.unshift({ name, filePath });
+        }
+        else if (hasReachedStart) {
+            // We've reached the end of the `use*` functions, so we're adding the component name and stop
+            stackInfoArr.unshift({ name, filePath });
+            break;
+        }
+    }
+    return stackInfoArr;
+};
+//# sourceMappingURL=extractStackInfoFromStackTrace.js.map

package/dist/react/utils/extractStackInfoFromStackTrace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractStackInfoFromStackTrace.js","sourceRoot":"","sources":["../../../src/react/utils/extractStackInfoFromStackTrace.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC,eAAe,CAAA;AAOvD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,UAAkB,EAAe,EAAE;IAChF,MAAM,WAAW,GAAG,oBAAoB,CAAA;IACxC,IAAI,KAA6B,CAAA;IACjC,MAAM,YAAY,GAAgB,EAAE,CAAA;IACpC,IAAI,eAAe,GAAG,KAAK,CAAA;IAE3B,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,KAAK,IAAI,EAAE;QACtD,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,KAAwC,CAAA;QACnE,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE;YAC1B,eAAe,GAAG,IAAI,CAAA;YAEtB,YAAY,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;SACzC;aAAM,IAAI,eAAe,EAAE;YAC1B,6FAA6F;YAC7F,YAAY,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;YACxC,MAAK;SACN;KACF;IAED,OAAO,YAAY,CAAA;AACrB,CAAC,CAAA"}

package/dist/react/utils/useStateRefWithReactiveInput.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+/**
+ * A variant of `React.useState` which allows the `inputState` to change over time as well.
+ * Important: This hook is synchronous / single-render-pass (i.e. doesn't use `useEffect` or `setState` directly).
+ *
+ * Notes:
+ * - The output state is always reset to the input state in case the input state changes (i.e. the previous "external" `setStateAndRerender` call is forgotten)
+ * - This hook might not work properly with React Suspense
+ * - Also see this Tweet for more potential problems: https://twitter.com/schickling/status/1677317711104278528
+ *
+ */
+export declare const useStateRefWithReactiveInput: <T>(inputState: T) => [React.MutableRefObject<T>, (newState: T | ((prev: T) => T)) => void];
+//# sourceMappingURL=useStateRefWithReactiveInput.d.ts.map

package/dist/react/utils/useStateRefWithReactiveInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStateRefWithReactiveInput.d.ts","sourceRoot":"","sources":["../../../src/react/utils/useStateRefWithReactiveInput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB;;;;;;;;;GASG;AACH,eAAO,MAAM,4BAA4B,wFAE0B,IAAI,CAwBtE,CAAA"}

package/dist/react/utils/useStateRefWithReactiveInput.js

@@ -0,0 +1,38 @@
+import React from 'react';
+/**
+ * A variant of `React.useState` which allows the `inputState` to change over time as well.
+ * Important: This hook is synchronous / single-render-pass (i.e. doesn't use `useEffect` or `setState` directly).
+ *
+ * Notes:
+ * - The output state is always reset to the input state in case the input state changes (i.e. the previous "external" `setStateAndRerender` call is forgotten)
+ * - This hook might not work properly with React Suspense
+ * - Also see this Tweet for more potential problems: https://twitter.com/schickling/status/1677317711104278528
+ *
+ */
+export const useStateRefWithReactiveInput = (inputState) => {
+    const [_, rerender] = React.useState(0);
+    const lastKnownInputStateRef = React.useRef(inputState);
+    const stateRef = React.useRef(inputState);
+    if (lastKnownInputStateRef.current !== inputState) {
+        lastKnownInputStateRef.current = inputState;
+        // NOTE we don't need to re-render here, because the component is already re-rendering due to the `inputState` change
+        stateRef.current = inputState;
+    }
+    const setStateAndRerender = React.useCallback((newState) => {
+        // @ts-expect-error https://github.com/microsoft/TypeScript/issues/37663
+        const val = typeof newState === 'function' ? newState(stateRef.current) : newState;
+        stateRef.current = val;
+        rerender((c) => c + 1);
+    }, [rerender]);
+    return [stateRef, setStateAndRerender];
+};
+// Down-side of this implementation: Double render pass due to `setState` call (which forces a re-render)
+// Keeping around for now in case `useStateRefWithReactiveInput` doesn't work out
+// const _useStateWithReactiveInput = <T>(inputState: T): [T, (newState: T | ((prev: T) => T)) => void] => {
+//   const [externalState, setExternalState] = React.useState(inputState)
+//   if (externalState !== inputState) {
+//     setExternalState(inputState)
+//   }
+//   return [externalState, setExternalState]
+// }
+//# sourceMappingURL=useStateRefWithReactiveInput.js.map

package/dist/react/utils/useStateRefWithReactiveInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStateRefWithReactiveInput.js","sourceRoot":"","sources":["../../../src/react/utils/useStateRefWithReactiveInput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAC1C,UAAa,EAC0D,EAAE;IACzE,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;IAEvC,MAAM,sBAAsB,GAAG,KAAK,CAAC,MAAM,CAAI,UAAU,CAAC,CAAA;IAC1D,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAI,UAAU,CAAC,CAAA;IAE5C,IAAI,sBAAsB,CAAC,OAAO,KAAK,UAAU,EAAE;QACjD,sBAAsB,CAAC,OAAO,GAAG,UAAU,CAAA;QAE3C,qHAAqH;QACrH,QAAQ,CAAC,OAAO,GAAG,UAAU,CAAA;KAC9B;IAED,MAAM,mBAAmB,GAAG,KAAK,CAAC,WAAW,CAC3C,CAAC,QAA8B,EAAE,EAAE;QACjC,wEAAwE;QACxE,MAAM,GAAG,GAAG,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;QAClF,QAAQ,CAAC,OAAO,GAAG,GAAG,CAAA;QACtB,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IACxB,CAAC,EACD,CAAC,QAAQ,CAAC,CACX,CAAA;IAED,OAAO,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAA;AACxC,CAAC,CAAA;AAED,yGAAyG;AACzG,iFAAiF;AACjF,4GAA4G;AAC5G,yEAAyE;AAEzE,wCAAwC;AACxC,mCAAmC;AACnC,MAAM;AAEN,6CAA6C;AAC7C,IAAI"}

package/dist/reactive.d.ts

@@ -0,0 +1,134 @@
+import type { PrettifyFlat } from '@livestore/utils';
+import type * as otel from '@opentelemetry/api';
+import { BoundArray } from './bounded-collections.js';
+export declare const NOT_REFRESHED_YET: unique symbol;
+export type NOT_REFRESHED_YET = typeof NOT_REFRESHED_YET;
+export type GetAtom = <T>(atom: Atom<T, any>, otelContext?: otel.Context) => T;
+export type Ref<T> = {
+    _tag: 'ref';
+    id: string;
+    isDirty: false;
+    previousResult: T;
+    height: 0;
+    computeResult: () => T;
+    sub: Set<Atom<any, TODO>>;
+    super: Set<Atom<any, TODO> | Effect>;
+    label?: string;
+    /** Container for meta information (e.g. the LiveStore Store) */
+    meta?: any;
+    equal: (a: T, b: T) => boolean;
+};
+type BaseThunk<TResult, TContext> = {
+    _tag: 'thunk';
+    id: string;
+    isDirty: boolean;
+    height: number;
+    computeResult: (otelContext?: otel.Context) => TResult;
+    previousResult: TResult | NOT_REFRESHED_YET;
+    sub: Set<Atom<any, TContext>>;
+    super: Set<Atom<any, TContext> | Effect>;
+    label?: string;
+    /** Container for meta information (e.g. the LiveStore Store) */
+    meta?: any;
+    equal: (a: TResult, b: TResult) => boolean;
+    recomputations: number;
+    __getResult: any;
+};
+export type Thunk<T, TContext> = BaseThunk<T, TContext>;
+export type Atom<T, TContext> = Ref<T> | Thunk<T, TContext>;
+export type Effect = {
+    _tag: 'effect';
+    id: string;
+    doEffect: (otelContext?: otel.Context) => void;
+    sub: Set<Atom<any, TODO>>;
+};
+export type Taggable<T extends string = string> = {
+    _tag: T;
+};
+export type ReactiveGraphOptions = {
+    effectsWrapper?: (runEffects: () => void) => void;
+};
+export type AtomDebugInfo<TDebugThunkInfo extends Taggable> = {
+    atom: SerializedAtom;
+    resultChanged: boolean;
+    durationMs: number;
+    debugInfo: TDebugThunkInfo;
+};
+export type RefreshDebugInfo<TDebugRefreshReason extends Taggable, TDebugThunkInfo extends Taggable> = {
+    /** Currently only used for easier handling in React (e.g. as key) */
+    id: string;
+    reason: TDebugRefreshReason;
+    refreshedAtoms: AtomDebugInfo<TDebugThunkInfo>[];
+    skippedRefresh: boolean;
+    durationMs: number;
+    /** Note we're using a regular `Date.now()` timestamp here as it's faster to produce and we don't need the fine accuracy */
+    completedTimestamp: number;
+    graphSnapshot: ReactiveGraphSnapshot;
+};
+export type RefreshReasonWithGenericReasons<T extends Taggable> = T | {
+    _tag: 'makeThunk';
+    label?: string;
+} | {
+    _tag: 'makeEffect';
+    label?: string;
+} | {
+    _tag: 'unknown';
+};
+export declare const unknownRefreshReason: () => {
+    _tag: "unknown";
+};
+export type SerializedAtom = Readonly<PrettifyFlat<Pick<Atom<unknown, TODO>, '_tag' | 'height' | 'id' | 'label' | 'meta'> & {
+    sub: string[];
+    super: string[];
+}>>;
+export type SerializedEffect = Readonly<PrettifyFlat<Pick<Effect, '_tag' | 'id'>>>;
+type ReactiveGraphSnapshot = {
+    readonly atoms: SerializedAtom[];
+};
+export declare class ReactiveGraph<TDebugRefreshReason extends Taggable, TDebugThunkInfo extends Taggable, TContext = {}> {
+    readonly atoms: Set<Atom<any, TContext>>;
+    effectsWrapper: (runEffects: () => void) => void;
+    context: TContext | undefined;
+    debugRefreshInfos: BoundArray<RefreshDebugInfo<RefreshReasonWithGenericReasons<TDebugRefreshReason>, TDebugThunkInfo>>;
+    constructor(options: ReactiveGraphOptions);
+    makeRef<T>(val: T, options?: {
+        label?: string;
+        meta?: unknown;
+        equal?: (a: T, b: T) => boolean;
+    }): Ref<T>;
+    makeThunk<T>(getResult_: (get: GetAtom, addDebugInfo: (debugInfo: TDebugThunkInfo) => void, ctx: TContext, otelContext: otel.Context | undefined) => T, options?: {
+        label?: string;
+        meta?: any;
+        equal?: (a: T, b: T) => boolean;
+        /** Debug info for initializing the thunk (i.e. running it the first time) */
+        debugRefreshReason?: RefreshReasonWithGenericReasons<TDebugRefreshReason>;
+    } | undefined): Thunk<T, TContext>;
+    destroy(node: Atom<any, TContext> | Effect): void;
+    makeEffect(doEffect: (get: GetAtom, otelContext?: otel.Context) => void, options?: {
+        label?: string;
+        debugRefreshReason?: RefreshReasonWithGenericReasons<TDebugRefreshReason>;
+    } | undefined): Effect;
+    setRef<T>(ref: Ref<T>, val: T, options?: {
+        debugRefreshReason?: TDebugRefreshReason;
+        otelContext?: otel.Context;
+    } | undefined): void;
+    setRefs<T>(refs: [Ref<T>, T][], options?: {
+        debugRefreshReason?: TDebugRefreshReason;
+        otelContext?: otel.Context;
+    } | undefined): void;
+    /**
+     * Update the graph to be consistent with the current values of the root atoms.
+     * Generally we run this after a ref is updated.
+     * At the end of the refresh, we run any effects that were scheduled.
+     *
+     * @param roots Root atoms to start the refresh from
+     */
+    label(atom: Atom<any, TContext> | Effect): string;
+    addEdge(superComp: Atom<any, TContext> | Effect, subComp: Atom<any, TContext>): void;
+    removeEdge(superComp: Atom<any, TContext> | Effect, subComp: Atom<any, TContext>): void;
+    updateAtomHeight(atom: Atom<any, TContext> | Effect): void;
+    private getSnapshot;
+    get atomsCount(): number;
+}
+export {};
+//# sourceMappingURL=reactive.d.ts.map

package/dist/reactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactive.d.ts","sourceRoot":"","sources":["../src/reactive.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD,OAAO,KAAK,KAAK,IAAI,MAAM,oBAAoB,CAAA;AAG/C,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAGrD,eAAO,MAAM,iBAAiB,eAAkC,CAAA;AAChE,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAA;AAExD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,OAAO,KAAK,CAAC,CAAA;AAE9E,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI;IACnB,IAAI,EAAE,KAAK,CAAA;IACX,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,KAAK,CAAA;IACd,cAAc,EAAE,CAAC,CAAA;IACjB,MAAM,EAAE,CAAC,CAAA;IACT,aAAa,EAAE,MAAM,CAAC,CAAA;IACtB,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAA;IACzB,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gEAAgE;IAChE,IAAI,CAAC,EAAE,GAAG,CAAA;IACV,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAAA;CAC/B,CAAA;AAED,KAAK,SAAS,CAAC,OAAO,EAAE,QAAQ,IAAI;IAClC,IAAI,EAAE,OAAO,CAAA;IACb,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,OAAO,KAAK,OAAO,CAAA;IACtD,cAAc,EAAE,OAAO,GAAG,iBAAiB,CAAA;IAC3C,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAA;IAC7B,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC,CAAA;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gEAAgE;IAChE,IAAI,CAAC,EAAE,GAAG,CAAA;IACV,KAAK,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,KAAK,OAAO,CAAA;IAC1C,cAAc,EAAE,MAAM,CAAA;IAEtB,WAAW,EAAE,GAAG,CAAA;CACjB,CAAA;AAID,MAAM,MAAM,KAAK,CAAC,CAAC,EAAE,QAAQ,IAAI,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;AAGvD,MAAM,MAAM,IAAI,CAAC,CAAC,EAAE,QAAQ,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;AAE3D,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,EAAE,QAAQ,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,OAAO,KAAK,IAAI,CAAA;IAC9C,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAA;AAE7D,MAAM,MAAM,oBAAoB,GAAG;IACjC,cAAc,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,IAAI,KAAK,IAAI,CAAA;CAClD,CAAA;AAED,MAAM,MAAM,aAAa,CAAC,eAAe,SAAS,QAAQ,IAAI;IAC5D,IAAI,EAAE,cAAc,CAAA;IACpB,aAAa,EAAE,OAAO,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,eAAe,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,gBAAgB,CAAC,mBAAmB,SAAS,QAAQ,EAAE,eAAe,SAAS,QAAQ,IAAI;IACrG,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,mBAAmB,CAAA;IAC3B,cAAc,EAAE,aAAa,CAAC,eAAe,CAAC,EAAE,CAAA;IAChD,cAAc,EAAE,OAAO,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,2HAA2H;IAC3H,kBAAkB,EAAE,MAAM,CAAA;IAC1B,aAAa,EAAE,qBAAqB,CAAA;CACrC,CAAA;AAED,MAAM,MAAM,+BAA+B,CAAC,CAAC,SAAS,QAAQ,IAC1D,CAAC,GACD;IACE,IAAI,EAAE,WAAW,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,GACD;IACE,IAAI,EAAE,YAAY,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,GACD;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAA;AAEvB,eAAO,MAAM,oBAAoB;;CAGhC,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,CACnC,YAAY,CACV,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM,CAAC,GAAG;IACvE,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB,CACF,CACF,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;AAElF,KAAK,qBAAqB,GAAG;IAC3B,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,CAAA;CAIjC,CAAA;AAaD,qBAAa,aAAa,CAAC,mBAAmB,SAAS,QAAQ,EAAE,eAAe,SAAS,QAAQ,EAAE,QAAQ,GAAG,EAAE;IAC9G,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAY;IACpD,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,IAAI,KAAK,IAAI,CAAA;IAEhD,OAAO,EAAE,QAAQ,GAAG,SAAS,CAAA;IAE7B,iBAAiB,EAAE,UAAU,CAC3B,gBAAgB,CAAC,+BAA+B,CAAC,mBAAmB,CAAC,EAAE,eAAe,CAAC,CACxF,CAAuB;gBAEZ,OAAO,EAAE,oBAAoB;IAIzC,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAAA;KAAE,GAAG,GAAG,CAAC,CAAC,CAAC;IAoBzG,SAAS,CAAC,CAAC,EACT,UAAU,EAAE,CACV,GAAG,EAAE,OAAO,EACZ,YAAY,EAAE,CAAC,SAAS,EAAE,eAAe,KAAK,IAAI,EAClD,GAAG,EAAE,QAAQ,EACb,WAAW,EAAE,IAAI,CAAC,OAAO,GAAG,SAAS,KAClC,CAAC,EACN,OAAO,CAAC,EACJ;QACE,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,IAAI,CAAC,EAAE,GAAG,CAAA;QACV,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAAA;QAC/B,6EAA6E;QAC7E,kBAAkB,CAAC,EAAE,+BAA+B,CAAC,mBAAmB,CAAC,CAAA;KAC1E,GACD,SAAS,GACZ,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC;IA2FrB,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,MAAM;IAkB1C,UAAU,CACR,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,OAAO,KAAK,IAAI,EAC5D,OAAO,CAAC,EACJ;QACE,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,kBAAkB,CAAC,EAAE,+BAA+B,CAAC,mBAAmB,CAAC,CAAA;KAC1E,GACD,SAAS,GACZ,MAAM;IAoCT,MAAM,CAAC,CAAC,EACN,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EACX,GAAG,EAAE,CAAC,EACN,OAAO,CAAC,EACJ;QACE,kBAAkB,CAAC,EAAE,mBAAmB,CAAA;QACxC,WAAW,CAAC,EAAE,IAAI,CAAC,OAAO,CAAA;KAC3B,GACD,SAAS;IA0Bf,OAAO,CAAC,CAAC,EACP,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EACnB,OAAO,CAAC,EACJ;QACE,kBAAkB,CAAC,EAAE,mBAAmB,CAAA;QACxC,WAAW,CAAC,EAAE,IAAI,CAAC,OAAO,CAAA;KAC3B,GACD,SAAS;IA6Cf;;;;;;OAMG;IAoIH,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,MAAM;IAQxC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC;IAM7E,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC;IAMhF,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,MAAM;IAgBnD,OAAO,CAAC,WAAW,CAIjB;IAEF,IAAI,UAAU,WAEb;CACF"}