yuustate 3.10.1 → 3.11.0

package/esm/react/create-query.d.mts

@@ -72,7 +72,11 @@ type Internal<TData, TError> = {
     garbageCollectionTimeoutId?: number;
     rollbackData?: TData | undefined;
 };
-type AdditionalStoreApi<TData, TError> = {
+type AdditionalStoreApi<TData, TError, TVariable extends StoreKey = never> = {
+    /**
+     * The original query variable used to create this store.
+     */
+    variable: TVariable;
     /**
      * A deterministic hash string derived from the query variable.
      *
@@ -205,7 +209,7 @@ type AdditionalStoreApi<TData, TError> = {
  * @remarks
  * Controls caching, retry behavior, lifecycle, and side effects of an async operation.
  */
-export type QueryOptions<TData, TVariable extends StoreKey, TError = Error> = InitStoreOptions<QueryState<TData, TError>, AdditionalStoreApi<TData, TError>> & {
+export type QueryOptions<TData, TVariable extends StoreKey, TError = Error> = InitStoreOptions<QueryState<TData, TError>, AdditionalStoreApi<TData, TError, TVariable>> & {
     /**
      * Time (in milliseconds) that data is considered fresh.
      *
@@ -357,6 +361,10 @@ export declare const createQuery: <TData, TVariable extends StoreKey = never, TE
     getState: () => QueryState<TData, TError>;
     subscribe: (subscriber: import("../vanilla.d.mts").Subscriber<QueryState<TData, TError>>) => () => void;
     getSubscriberCount: () => number;
+    /**
+     * The original query variable used to create this store.
+     */
+    variable: TVariable;
     /**
      * A deterministic hash string derived from the query variable.
      *
@@ -490,6 +498,15 @@ export declare const createQuery: <TData, TVariable extends StoreKey = never, TE
      * - Useful for bulk refetching.
      */
     executeAll: (options?: {
+        /**
+         * Optional predicate to select which query to execute.
+         */
+        filter?: (variable: TVariable) => boolean;
+        /**
+         * Whether to start a new execution instead of reusing an ongoing one.
+         *
+         * @default true
+         */
         overwriteOngoingExecution?: boolean;
     }) => void;
     /**
@@ -499,6 +516,15 @@ export declare const createQuery: <TData, TVariable extends StoreKey = never, TE
      * - Only re-fetches stale queries.
      */
     revalidateAll: (options?: {
+        /**
+         * Optional predicate to select which query to revalidate.
+         */
+        filter?: (variable: TVariable) => boolean;
+        /**
+         * Whether to start a new execution instead of reusing an ongoing one.
+         *
+         * @default true
+         */
         overwriteOngoingExecution?: boolean;
     }) => void;
     /**
@@ -509,11 +535,25 @@ export declare const createQuery: <TData, TVariable extends StoreKey = never, TE
      * - Invalidated queries bypass `staleTime` until successfully executed again.
      */
     invalidateAll: (options?: {
+        /**
+         * Optional predicate to select which query to invalidate.
+         */
+        filter?: (variable: TVariable) => boolean;
+        /**
+         * Whether to start a new execution instead of reusing an ongoing one.
+         *
+         * @default true
+         */
         overwriteOngoingExecution?: boolean;
     }) => void;
     /**
      * Resets all query instances.
      */
-    resetAll: () => void;
+    resetAll: (options?: {
+        /**
+         * Optional predicate to select which query to reset.
+         */
+        filter?: (variable: TVariable) => boolean;
+    }) => void;
 };
 export {};

package/esm/react.mjs

@@ -51,7 +51,7 @@ const useStoreStateProxy = (storeState) => {
 };
 const useStoreStateWithInitializer = (store, initialState) => {
   const initiatedAt = useRef(new WeakMap([[store, 0]]));
-  useEffect(() => {
+  useIsomorphicLayoutEffect(() => {
     if (initialState === void 0 || initiatedAt.current.get(store)) return;
     store.setState(initialState);
     initiatedAt.current.set(store, Date.now());
@@ -63,8 +63,21 @@ const useStoreStateWithInitializer = (store, initialState) => {
 const useStoreState = (store, options = {}) => {
   const [state] = useStoreStateWithInitializer(store, options.initialState);
   const [trackedState, usedPathsRef] = useStoreStateProxy(state);
-  const snapshotRef = useRef(store.getState());
-  const getSnapshot = () => snapshotRef.current;
+  const snapshotRef = useRef(state);
+  const getSnapshot = () => {
+    const prevState = snapshotRef.current;
+    const nextState = store.getState();
+    const paths = compressPaths(usedPathsRef.current);
+    for (const path of paths) {
+      const prevVal = getValueByPath(prevState, path);
+      const nextVal = getValueByPath(nextState, path);
+      if (!Object.is(prevVal, nextVal)) {
+        snapshotRef.current = nextState;
+        break;
+      }
+    }
+    return snapshotRef.current;
+  };
   useSyncExternalStore(
     useCallback(
       (onStoreChange) => {
@@ -105,6 +118,7 @@ const createStores = (initialState, options) => {
     let store;
     if (stores.has(keyHash)) {
       store = stores.get(keyHash);
+      store.key = key;
     } else {
       store = initStore(
         initialState,
@@ -404,12 +418,14 @@ const createQuery = (queryFn, options = {}) => {
     let store;
     if (stores.has(variableHash)) {
       store = stores.get(variableHash);
+      store.variable = variable;
     } else {
       store = initStore(
         initialState,
         configureStoreEvents(variableHash)
         // Intentionally using as any: don't want to add generic on `initStore`
       );
+      store.variable = variable;
       store.variableHash = variableHash;
       stores.set(variableHash, store);
       const apis = getApis(store, variable);
@@ -509,6 +525,7 @@ const createQuery = (queryFn, options = {}) => {
       }
     });
   };
+  const shouldApplyToStore = (store, filter) => filter ? filter(store.variable) : true;
   return Object.assign(getStore, {
     /**
      * Executes all query instances.
@@ -516,8 +533,12 @@ const createQuery = (queryFn, options = {}) => {
      * @remarks
      * - Useful for bulk refetching.
      */
-    executeAll: (options2) => {
-      stores.forEach((store) => store.execute(options2));
+    executeAll: (options2 = {}) => {
+      const { filter, ...restOptions } = options2;
+      stores.forEach((store) => {
+        if (!shouldApplyToStore(store, filter)) return;
+        store.execute(restOptions);
+      });
     },
     /**
      * Revalidates all query instances.
@@ -525,8 +546,12 @@ const createQuery = (queryFn, options = {}) => {
      * @remarks
      * - Only re-fetches stale queries.
      */
-    revalidateAll: (options2) => {
-      stores.forEach((store) => store.revalidate(options2));
+    revalidateAll: (options2 = {}) => {
+      const { filter, ...restOptions } = options2;
+      stores.forEach((store) => {
+        if (!shouldApplyToStore(store, filter)) return;
+        store.revalidate(restOptions);
+      });
     },
     /**
      * Invalidates all query instances.
@@ -535,14 +560,22 @@ const createQuery = (queryFn, options = {}) => {
      * - Marks all queries as invalidated and triggers revalidation if active.
      * - Invalidated queries bypass `staleTime` until successfully executed again.
      */
-    invalidateAll: (options2) => {
-      stores.forEach((store) => store.invalidate(options2));
+    invalidateAll: (options2 = {}) => {
+      const { filter, ...restOptions } = options2;
+      stores.forEach((store) => {
+        if (!shouldApplyToStore(store, filter)) return;
+        store.invalidate(restOptions);
+      });
     },
     /**
      * Resets all query instances.
      */
-    resetAll: () => {
-      stores.forEach((store) => store.reset());
+    resetAll: (options2 = {}) => {
+      const { filter } = options2;
+      stores.forEach((store) => {
+        if (!shouldApplyToStore(store, filter)) return;
+        store.reset();
+      });
     }
   });
 };

package/package.json

@@ -2,7 +2,7 @@
   "name": "yuustate",
   "description": "Lightweight unified state management for sync and async data.",
   "private": false,
-  "version": "3.10.1",
+  "version": "3.11.0",
   "keywords": [
     "utilities",
     "store",

package/react/create-query.d.ts

@@ -72,7 +72,11 @@ type Internal<TData, TError> = {
     garbageCollectionTimeoutId?: number;
     rollbackData?: TData | undefined;
 };
-type AdditionalStoreApi<TData, TError> = {
+type AdditionalStoreApi<TData, TError, TVariable extends StoreKey = never> = {
+    /**
+     * The original query variable used to create this store.
+     */
+    variable: TVariable;
     /**
      * A deterministic hash string derived from the query variable.
      *
@@ -205,7 +209,7 @@ type AdditionalStoreApi<TData, TError> = {
  * @remarks
  * Controls caching, retry behavior, lifecycle, and side effects of an async operation.
  */
-export type QueryOptions<TData, TVariable extends StoreKey, TError = Error> = InitStoreOptions<QueryState<TData, TError>, AdditionalStoreApi<TData, TError>> & {
+export type QueryOptions<TData, TVariable extends StoreKey, TError = Error> = InitStoreOptions<QueryState<TData, TError>, AdditionalStoreApi<TData, TError, TVariable>> & {
     /**
      * Time (in milliseconds) that data is considered fresh.
      *
@@ -357,6 +361,10 @@ export declare const createQuery: <TData, TVariable extends StoreKey = never, TE
     getState: () => QueryState<TData, TError>;
     subscribe: (subscriber: import("../vanilla.ts").Subscriber<QueryState<TData, TError>>) => () => void;
     getSubscriberCount: () => number;
+    /**
+     * The original query variable used to create this store.
+     */
+    variable: TVariable;
     /**
      * A deterministic hash string derived from the query variable.
      *
@@ -490,6 +498,15 @@ export declare const createQuery: <TData, TVariable extends StoreKey = never, TE
      * - Useful for bulk refetching.
      */
     executeAll: (options?: {
+        /**
+         * Optional predicate to select which query to execute.
+         */
+        filter?: (variable: TVariable) => boolean;
+        /**
+         * Whether to start a new execution instead of reusing an ongoing one.
+         *
+         * @default true
+         */
         overwriteOngoingExecution?: boolean;
     }) => void;
     /**
@@ -499,6 +516,15 @@ export declare const createQuery: <TData, TVariable extends StoreKey = never, TE
      * - Only re-fetches stale queries.
      */
     revalidateAll: (options?: {
+        /**
+         * Optional predicate to select which query to revalidate.
+         */
+        filter?: (variable: TVariable) => boolean;
+        /**
+         * Whether to start a new execution instead of reusing an ongoing one.
+         *
+         * @default true
+         */
         overwriteOngoingExecution?: boolean;
     }) => void;
     /**
@@ -509,11 +535,25 @@ export declare const createQuery: <TData, TVariable extends StoreKey = never, TE
      * - Invalidated queries bypass `staleTime` until successfully executed again.
      */
     invalidateAll: (options?: {
+        /**
+         * Optional predicate to select which query to invalidate.
+         */
+        filter?: (variable: TVariable) => boolean;
+        /**
+         * Whether to start a new execution instead of reusing an ongoing one.
+         *
+         * @default true
+         */
         overwriteOngoingExecution?: boolean;
     }) => void;
     /**
      * Resets all query instances.
      */
-    resetAll: () => void;
+    resetAll: (options?: {
+        /**
+         * Optional predicate to select which query to reset.
+         */
+        filter?: (variable: TVariable) => boolean;
+    }) => void;
 };
 export {};

package/react.js

@@ -53,7 +53,7 @@ const useStoreStateProxy = (storeState) => {
 };
 const useStoreStateWithInitializer = (store, initialState) => {
   const initiatedAt = react.useRef(new WeakMap([[store, 0]]));
-  react.useEffect(() => {
+  useIsomorphicLayoutEffect(() => {
     if (initialState === void 0 || initiatedAt.current.get(store)) return;
     store.setState(initialState);
     initiatedAt.current.set(store, Date.now());
@@ -65,8 +65,21 @@ const useStoreStateWithInitializer = (store, initialState) => {
 const useStoreState = (store, options = {}) => {
   const [state] = useStoreStateWithInitializer(store, options.initialState);
   const [trackedState, usedPathsRef] = useStoreStateProxy(state);
-  const snapshotRef = react.useRef(store.getState());
-  const getSnapshot = () => snapshotRef.current;
+  const snapshotRef = react.useRef(state);
+  const getSnapshot = () => {
+    const prevState = snapshotRef.current;
+    const nextState = store.getState();
+    const paths = compressPaths(usedPathsRef.current);
+    for (const path of paths) {
+      const prevVal = getValueByPath(prevState, path);
+      const nextVal = getValueByPath(nextState, path);
+      if (!Object.is(prevVal, nextVal)) {
+        snapshotRef.current = nextState;
+        break;
+      }
+    }
+    return snapshotRef.current;
+  };
   react.useSyncExternalStore(
     react.useCallback(
       (onStoreChange) => {
@@ -107,6 +120,7 @@ const createStores = (initialState, options) => {
     let store;
     if (stores.has(keyHash)) {
       store = stores.get(keyHash);
+      store.key = key;
     } else {
       store = vanilla.initStore(
         initialState,
@@ -406,12 +420,14 @@ const createQuery = (queryFn, options = {}) => {
     let store;
     if (stores.has(variableHash)) {
       store = stores.get(variableHash);
+      store.variable = variable;
     } else {
       store = vanilla.initStore(
         initialState,
         configureStoreEvents(variableHash)
         // Intentionally using as any: don't want to add generic on `initStore`
       );
+      store.variable = variable;
       store.variableHash = variableHash;
       stores.set(variableHash, store);
       const apis = getApis(store, variable);
@@ -511,6 +527,7 @@ const createQuery = (queryFn, options = {}) => {
       }
     });
   };
+  const shouldApplyToStore = (store, filter) => filter ? filter(store.variable) : true;
   return Object.assign(getStore, {
     /**
      * Executes all query instances.
@@ -518,8 +535,12 @@ const createQuery = (queryFn, options = {}) => {
      * @remarks
      * - Useful for bulk refetching.
      */
-    executeAll: (options2) => {
-      stores.forEach((store) => store.execute(options2));
+    executeAll: (options2 = {}) => {
+      const { filter, ...restOptions } = options2;
+      stores.forEach((store) => {
+        if (!shouldApplyToStore(store, filter)) return;
+        store.execute(restOptions);
+      });
     },
     /**
      * Revalidates all query instances.
@@ -527,8 +548,12 @@ const createQuery = (queryFn, options = {}) => {
      * @remarks
      * - Only re-fetches stale queries.
      */
-    revalidateAll: (options2) => {
-      stores.forEach((store) => store.revalidate(options2));
+    revalidateAll: (options2 = {}) => {
+      const { filter, ...restOptions } = options2;
+      stores.forEach((store) => {
+        if (!shouldApplyToStore(store, filter)) return;
+        store.revalidate(restOptions);
+      });
     },
     /**
      * Invalidates all query instances.
@@ -537,14 +562,22 @@ const createQuery = (queryFn, options = {}) => {
      * - Marks all queries as invalidated and triggers revalidation if active.
      * - Invalidated queries bypass `staleTime` until successfully executed again.
      */
-    invalidateAll: (options2) => {
-      stores.forEach((store) => store.invalidate(options2));
+    invalidateAll: (options2 = {}) => {
+      const { filter, ...restOptions } = options2;
+      stores.forEach((store) => {
+        if (!shouldApplyToStore(store, filter)) return;
+        store.invalidate(restOptions);
+      });
     },
     /**
      * Resets all query instances.
      */
-    resetAll: () => {
-      stores.forEach((store) => store.reset());
+    resetAll: (options2 = {}) => {
+      const { filter } = options2;
+      stores.forEach((store) => {
+        if (!shouldApplyToStore(store, filter)) return;
+        store.reset();
+      });
     }
   });
 };