floppy-disk 2.0.0-alpha.3 → 2.0.0-beta.1

package/README.md

@@ -663,7 +663,17 @@ const useCartStore = createStore(({ set, get }) => ({
 }));
 ```
 
-You don't need to memoize the reactivity selector.
+Don't use conditional reactivity selector.
+
+```jsx
+function Cat({ isSomething }) {
+  const { age } = useCatStore(isSomething ? (state) => [state.age] : null); // ❌
+  const { age } = useCatStore((state) => (isSomething ? [state.age] : [state.isSleeping])); // ❌
+  return <div>Cat's age: {age}</div>;
+}
+```
+
+No need to memoize the reactivity selector.
 
 ```jsx
 function Cat() {
@@ -673,11 +683,12 @@ function Cat() {
 }
 ```
 
-Don't use conditional reactivity selector.
+No need to memoize the store key / query key.
 
 ```jsx
-function Cat({ isSomething }) {
-  const { age } = useCatStore(isSomething ? (state) => [state.age] : null); // ❌
-  return <div>Cat's age: {age}</div>;
+function PokemonsPage() {
+  const queryKey = useMemo(() => ({ generation: 'ii', sort: 'asc' }), []); // ❌
+  const { isLoading, data } = usePokemonsQuery(queryKey);
+  return <div>...</div>;
 }
 ```

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

@@ -21,7 +21,6 @@ export type QueryState<TKey extends StoreKey = StoreKey, TResponse = any, TData
      * You can ignore this if your query is not paginated.
      */
     fetchNextPage: () => void;
-    markAsStale: () => void;
     /**
      * Set query state (data, error, etc) to initial state.
      */
@@ -153,6 +152,14 @@ export type UseQuery<TKey extends StoreKey = StoreKey, TResponse = any, TData =
         key?: TKey;
         response: TResponse;
     }) => void;
+    /**
+     * Set query state (data, error, etc) to initial state.
+     */
+    reset: () => void;
+    /**
+     * Set query state (data, error, etc) to initial state.
+     */
+    resetSpecificKey: (key?: TKey | null) => void;
     /**
      * Invalidate query means marking a query as stale, and will refetch only if the query is active (has subscriber)
      */

package/esm/react/create-query.js

@@ -206,7 +206,6 @@ export const createQuery = (queryFn, options = {}) => {
             fetch,
             forceFetch,
             fetchNextPage,
-            markAsStale: () => set({ responseUpdatedAt: null }),
             reset: () => set(INITIAL_QUERY_STATE),
         };
     }, (() => {
@@ -283,6 +282,15 @@ export const createQuery = (queryFn, options = {}) => {
             });
         });
     };
+    useQuery.reset = () => {
+        useQuery.getStores().forEach((store) => {
+            store.set(INITIAL_QUERY_STATE);
+        });
+    };
+    useQuery.resetSpecificKey = (key) => {
+        const store = useQuery.getStore(key);
+        store.set(INITIAL_QUERY_STATE);
+    };
     useQuery.invalidate = () => {
         useQuery.getStores().forEach((store) => {
             const { set, getSubscribers } = store;

package/lib/react/create-query.d.ts

@@ -21,7 +21,6 @@ export type QueryState<TKey extends StoreKey = StoreKey, TResponse = any, TData
      * You can ignore this if your query is not paginated.
      */
     fetchNextPage: () => void;
-    markAsStale: () => void;
     /**
      * Set query state (data, error, etc) to initial state.
      */
@@ -153,6 +152,14 @@ export type UseQuery<TKey extends StoreKey = StoreKey, TResponse = any, TData =
         key?: TKey;
         response: TResponse;
     }) => void;
+    /**
+     * Set query state (data, error, etc) to initial state.
+     */
+    reset: () => void;
+    /**
+     * Set query state (data, error, etc) to initial state.
+     */
+    resetSpecificKey: (key?: TKey | null) => void;
     /**
      * Invalidate query means marking a query as stale, and will refetch only if the query is active (has subscriber)
      */

package/lib/react/create-query.js

@@ -209,7 +209,6 @@ const createQuery = (queryFn, options = {}) => {
             fetch,
             forceFetch,
             fetchNextPage,
-            markAsStale: () => set({ responseUpdatedAt: null }),
             reset: () => set(INITIAL_QUERY_STATE),
         };
     }, (() => {
@@ -286,6 +285,15 @@ const createQuery = (queryFn, options = {}) => {
             });
         });
     };
+    useQuery.reset = () => {
+        useQuery.getStores().forEach((store) => {
+            store.set(INITIAL_QUERY_STATE);
+        });
+    };
+    useQuery.resetSpecificKey = (key) => {
+        const store = useQuery.getStore(key);
+        store.set(INITIAL_QUERY_STATE);
+    };
     useQuery.invalidate = () => {
         useQuery.getStores().forEach((store) => {
             const { set, getSubscribers } = store;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "floppy-disk",
-  "version": "2.0.0-alpha.3",
+  "version": "2.0.0-beta.1",
   "description": "FloppyDisk - lightweight, simple, and powerful state management library",
   "keywords": [
     "state",