floppy-disk 1.2.0 → 1.3.0-beta.1

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

@@ -15,6 +15,12 @@ export type UseStore<T extends StoreData> = {
     set: (value: SetStoreData<T>, silent?: boolean) => void;
     subscribe: (fn: (state: T) => void, selectDeps?: SelectDeps<T>) => () => void;
     getSubscribers: () => Subscribers<T>;
+    /**
+     * Set default values inside a component.
+     *
+     * IMPORTANT NOTE: Put this on the root component or parent component, before any component subscribed!
+     */
+    setDefaultValues: (values: SetStoreData<T>) => void;
     Watch: (props: WatchProps<T>) => any;
 };
 export declare const createStore: <T extends StoreData>(initializer: StoreInitializer<T>, options?: InitStoreOptions<T> & {

package/esm/react/create-store.js

@@ -16,6 +16,16 @@ export const createStore = (initializer, options = {}) => {
     useStore.set = set;
     useStore.subscribe = subscribe;
     useStore.getSubscribers = getSubscribers;
+    useStore.setDefaultValues = (value) => {
+        // eslint-disable-next-line react-hooks/rules-of-hooks
+        useState(() => {
+            const subscribers = getSubscribers();
+            if (subscribers.size > 0) {
+                console.warn('Put setDefaultValues on the root component or parent component, before any component subscribed!');
+            }
+            set(value);
+        });
+    };
     const Watch = ({ selectDeps, render }) => {
         const store = useStore(selectDeps);
         return render(store);

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

@@ -1,5 +1,6 @@
 import { InitStoreOptions, SelectDeps, SetStoreData, StoreData, Subscribers } from '../vanilla';
 import { WatchProps } from './create-store';
+type Maybe<T> = T | null | undefined;
 export type StoreKey = Record<string, any> | undefined;
 export type StoresInitializer<TKey extends StoreKey = StoreKey, T extends StoreData = StoreData> = (api: {
     key: TKey;
@@ -15,20 +16,28 @@ export type UseStores<TKey extends StoreKey = StoreKey, T extends StoreData = St
      *
      * IMPORTANT NOTE: `selectDeps` must not be changed after initialization.
      */
-    (...args: [TKey?, SelectDeps<T>?] | [SelectDeps<T>?]): T;
-    get: (key?: TKey) => T;
+    (...args: [Maybe<TKey>, SelectDeps<T>?] | [SelectDeps<T>?]): T;
+    get: (key?: Maybe<TKey>) => T;
     getAll: () => T[];
     getAllWithSubscriber: () => T[];
-    set: (key: TKey, value: SetStoreData<T>, silent?: boolean) => void;
+    set: (key: Maybe<TKey>, value: SetStoreData<T>, silent?: boolean) => void;
     setAll: (value: SetStoreData<T>, silent?: boolean) => void;
-    subscribe: (key: TKey, fn: (state: T) => void, selectDeps?: SelectDeps<T>) => () => void;
-    getSubscribers: (key: TKey) => Subscribers<T>;
+    subscribe: (key: Maybe<TKey>, fn: (state: T) => void, selectDeps?: SelectDeps<T>) => () => void;
+    getSubscribers: (key: Maybe<TKey>) => Subscribers<T>;
+    /**
+     * Set default values inside a component.
+     *
+     * IMPORTANT NOTE: Put this on the root component or parent component, before any component subscribed!
+     */
+    setDefaultValues: (key: Maybe<TKey>, values: SetStoreData<T>) => void;
     Watch: (props: WatchProps<T> & {
-        storeKey?: TKey;
+        storeKey?: Maybe<TKey>;
     }) => any;
 };
 export type CreateStoresOptions<TKey extends StoreKey = StoreKey, T extends StoreData = StoreData> = InitStoreOptions<T> & {
     onBeforeChangeKey?: (nextKey: TKey, prevKey: TKey) => void;
     defaultDeps?: SelectDeps<T>;
+    hashKeyFn?: (obj: TKey) => string;
 };
 export declare const createStores: <TKey extends StoreKey = StoreKey, T extends StoreData = StoreData>(initializer: StoresInitializer<TKey, T>, options?: CreateStoresOptions<TKey, T>) => UseStores<TKey, T>;
+export {};

package/esm/react/create-stores.js

@@ -3,10 +3,11 @@ import { noop } from '../utils';
 import { initStore, } from '../vanilla';
 const hashStoreKey = (obj) => JSON.stringify(obj, Object.keys(obj).sort());
 export const createStores = (initializer, options = {}) => {
-    const { onBeforeChangeKey = noop, defaultDeps } = options;
+    const { onBeforeChangeKey = noop, defaultDeps, hashKeyFn = hashStoreKey } = options;
     const stores = new Map();
-    const getStore = (key) => {
-        const normalizedKey = hashStoreKey(key);
+    const getStore = (_key) => {
+        const key = _key || {};
+        const normalizedKey = hashKeyFn(key);
         if (!stores.has(normalizedKey)) {
             stores.set(normalizedKey, initStore((api) => initializer({ key, ...api }), options));
         }
@@ -16,9 +17,9 @@ export const createStores = (initializer, options = {}) => {
      * IMPORTANT NOTE: selectDeps function must not be changed after initialization.
      */
     const useStores = (...args) => {
-        const [_key = {}, selectDeps = defaultDeps] = (typeof args[0] === 'function' ? [{}, args[0]] : args);
-        const key = _key;
-        const normalizedKey = hashStoreKey(key);
+        const [_key, selectDeps = defaultDeps] = (typeof args[0] === 'function' ? [{}, args[0]] : args);
+        const key = _key || {};
+        const normalizedKey = hashKeyFn(key);
         // eslint-disable-next-line react-hooks/exhaustive-deps
         const { get, subscribe } = useMemo(() => getStore(key), [normalizedKey]);
         const [state, setState] = useState(get);
@@ -37,7 +38,7 @@ export const createStores = (initializer, options = {}) => {
         }, [normalizedKey]);
         return state;
     };
-    useStores.get = (key = {}) => {
+    useStores.get = (key) => {
         const store = getStore(key);
         return store.get();
     };
@@ -57,7 +58,7 @@ export const createStores = (initializer, options = {}) => {
         });
         return allStores;
     };
-    useStores.set = (key = {}, value, silent) => {
+    useStores.set = (key, value, silent) => {
         const store = getStore(key);
         store.set(value, silent);
     };
@@ -66,15 +67,26 @@ export const createStores = (initializer, options = {}) => {
             store.set(value, silent);
         });
     };
-    useStores.subscribe = (key = {}, fn, selectDeps) => {
+    useStores.subscribe = (key, fn, selectDeps) => {
         const store = getStore(key);
         return store.subscribe(fn, selectDeps);
     };
-    useStores.getSubscribers = (key = {}) => {
+    useStores.getSubscribers = (key) => {
         const store = getStore(key);
         return store.getSubscribers();
     };
-    const Watch = ({ storeKey = {}, selectDeps, render }) => {
+    useStores.setDefaultValues = (key, value) => {
+        // eslint-disable-next-line react-hooks/rules-of-hooks
+        useState(() => {
+            const store = getStore(key);
+            const subscribers = store.getSubscribers();
+            if (subscribers.size > 0) {
+                console.warn('Put setDefaultValues on the root component or parent component, before any component subscribed!');
+            }
+            store.set(value);
+        });
+    };
+    const Watch = ({ storeKey, selectDeps, render }) => {
         const store = useStores(storeKey, selectDeps);
         return render(store);
     };

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

@@ -15,6 +15,12 @@ export type UseStore<T extends StoreData> = {
     set: (value: SetStoreData<T>, silent?: boolean) => void;
     subscribe: (fn: (state: T) => void, selectDeps?: SelectDeps<T>) => () => void;
     getSubscribers: () => Subscribers<T>;
+    /**
+     * Set default values inside a component.
+     *
+     * IMPORTANT NOTE: Put this on the root component or parent component, before any component subscribed!
+     */
+    setDefaultValues: (values: SetStoreData<T>) => void;
     Watch: (props: WatchProps<T>) => any;
 };
 export declare const createStore: <T extends StoreData>(initializer: StoreInitializer<T>, options?: InitStoreOptions<T> & {

package/lib/react/create-store.js

@@ -19,6 +19,16 @@ const createStore = (initializer, options = {}) => {
     useStore.set = set;
     useStore.subscribe = subscribe;
     useStore.getSubscribers = getSubscribers;
+    useStore.setDefaultValues = (value) => {
+        // eslint-disable-next-line react-hooks/rules-of-hooks
+        (0, react_1.useState)(() => {
+            const subscribers = getSubscribers();
+            if (subscribers.size > 0) {
+                console.warn('Put setDefaultValues on the root component or parent component, before any component subscribed!');
+            }
+            set(value);
+        });
+    };
     const Watch = ({ selectDeps, render }) => {
         const store = useStore(selectDeps);
         return render(store);

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

@@ -1,5 +1,6 @@
 import { InitStoreOptions, SelectDeps, SetStoreData, StoreData, Subscribers } from '../vanilla';
 import { WatchProps } from './create-store';
+type Maybe<T> = T | null | undefined;
 export type StoreKey = Record<string, any> | undefined;
 export type StoresInitializer<TKey extends StoreKey = StoreKey, T extends StoreData = StoreData> = (api: {
     key: TKey;
@@ -15,20 +16,28 @@ export type UseStores<TKey extends StoreKey = StoreKey, T extends StoreData = St
      *
      * IMPORTANT NOTE: `selectDeps` must not be changed after initialization.
      */
-    (...args: [TKey?, SelectDeps<T>?] | [SelectDeps<T>?]): T;
-    get: (key?: TKey) => T;
+    (...args: [Maybe<TKey>, SelectDeps<T>?] | [SelectDeps<T>?]): T;
+    get: (key?: Maybe<TKey>) => T;
     getAll: () => T[];
     getAllWithSubscriber: () => T[];
-    set: (key: TKey, value: SetStoreData<T>, silent?: boolean) => void;
+    set: (key: Maybe<TKey>, value: SetStoreData<T>, silent?: boolean) => void;
     setAll: (value: SetStoreData<T>, silent?: boolean) => void;
-    subscribe: (key: TKey, fn: (state: T) => void, selectDeps?: SelectDeps<T>) => () => void;
-    getSubscribers: (key: TKey) => Subscribers<T>;
+    subscribe: (key: Maybe<TKey>, fn: (state: T) => void, selectDeps?: SelectDeps<T>) => () => void;
+    getSubscribers: (key: Maybe<TKey>) => Subscribers<T>;
+    /**
+     * Set default values inside a component.
+     *
+     * IMPORTANT NOTE: Put this on the root component or parent component, before any component subscribed!
+     */
+    setDefaultValues: (key: Maybe<TKey>, values: SetStoreData<T>) => void;
     Watch: (props: WatchProps<T> & {
-        storeKey?: TKey;
+        storeKey?: Maybe<TKey>;
     }) => any;
 };
 export type CreateStoresOptions<TKey extends StoreKey = StoreKey, T extends StoreData = StoreData> = InitStoreOptions<T> & {
     onBeforeChangeKey?: (nextKey: TKey, prevKey: TKey) => void;
     defaultDeps?: SelectDeps<T>;
+    hashKeyFn?: (obj: TKey) => string;
 };
 export declare const createStores: <TKey extends StoreKey = StoreKey, T extends StoreData = StoreData>(initializer: StoresInitializer<TKey, T>, options?: CreateStoresOptions<TKey, T>) => UseStores<TKey, T>;
+export {};

package/lib/react/create-stores.js

@@ -6,10 +6,11 @@ const utils_1 = require("../utils");
 const vanilla_1 = require("../vanilla");
 const hashStoreKey = (obj) => JSON.stringify(obj, Object.keys(obj).sort());
 const createStores = (initializer, options = {}) => {
-    const { onBeforeChangeKey = utils_1.noop, defaultDeps } = options;
+    const { onBeforeChangeKey = utils_1.noop, defaultDeps, hashKeyFn = hashStoreKey } = options;
     const stores = new Map();
-    const getStore = (key) => {
-        const normalizedKey = hashStoreKey(key);
+    const getStore = (_key) => {
+        const key = _key || {};
+        const normalizedKey = hashKeyFn(key);
         if (!stores.has(normalizedKey)) {
             stores.set(normalizedKey, (0, vanilla_1.initStore)((api) => initializer({ key, ...api }), options));
         }
@@ -19,9 +20,9 @@ const createStores = (initializer, options = {}) => {
      * IMPORTANT NOTE: selectDeps function must not be changed after initialization.
      */
     const useStores = (...args) => {
-        const [_key = {}, selectDeps = defaultDeps] = (typeof args[0] === 'function' ? [{}, args[0]] : args);
-        const key = _key;
-        const normalizedKey = hashStoreKey(key);
+        const [_key, selectDeps = defaultDeps] = (typeof args[0] === 'function' ? [{}, args[0]] : args);
+        const key = _key || {};
+        const normalizedKey = hashKeyFn(key);
         // eslint-disable-next-line react-hooks/exhaustive-deps
         const { get, subscribe } = (0, react_1.useMemo)(() => getStore(key), [normalizedKey]);
         const [state, setState] = (0, react_1.useState)(get);
@@ -40,7 +41,7 @@ const createStores = (initializer, options = {}) => {
         }, [normalizedKey]);
         return state;
     };
-    useStores.get = (key = {}) => {
+    useStores.get = (key) => {
         const store = getStore(key);
         return store.get();
     };
@@ -60,7 +61,7 @@ const createStores = (initializer, options = {}) => {
         });
         return allStores;
     };
-    useStores.set = (key = {}, value, silent) => {
+    useStores.set = (key, value, silent) => {
         const store = getStore(key);
         store.set(value, silent);
     };
@@ -69,15 +70,26 @@ const createStores = (initializer, options = {}) => {
             store.set(value, silent);
         });
     };
-    useStores.subscribe = (key = {}, fn, selectDeps) => {
+    useStores.subscribe = (key, fn, selectDeps) => {
         const store = getStore(key);
         return store.subscribe(fn, selectDeps);
     };
-    useStores.getSubscribers = (key = {}) => {
+    useStores.getSubscribers = (key) => {
         const store = getStore(key);
         return store.getSubscribers();
     };
-    const Watch = ({ storeKey = {}, selectDeps, render }) => {
+    useStores.setDefaultValues = (key, value) => {
+        // eslint-disable-next-line react-hooks/rules-of-hooks
+        (0, react_1.useState)(() => {
+            const store = getStore(key);
+            const subscribers = store.getSubscribers();
+            if (subscribers.size > 0) {
+                console.warn('Put setDefaultValues on the root component or parent component, before any component subscribed!');
+            }
+            store.set(value);
+        });
+    };
+    const Watch = ({ storeKey, selectDeps, render }) => {
         const store = useStores(storeKey, selectDeps);
         return render(store);
     };

package/package.json

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