dharma-core 0.7.1 → 0.9.0

package/README.md

@@ -31,4 +31,4 @@ decrement();
 unsubscribe();
 ```
 
-[Read the documentation](https://fransek.github.io/dharma/modules/dharma-core.html)
+[Read the documentation](https://dharma.fransek.dev/)

package/dist/cjs/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./lib/createStore";
+export * from "./lib/derive";
 export * from "./lib/merge";
 export * from "./lib/types";

package/dist/cjs/index.js

@@ -1,10 +1,12 @@
 'use strict';
 
 var createStore = require('./lib/createStore.js');
+var derive = require('./lib/derive.js');
 var merge = require('./lib/merge.js');
 
 
 
 exports.createStore = createStore.createStore;
+exports.derive = derive.derive;
 exports.merge = merge.merge;
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;"}

package/dist/cjs/lib/createStorageAdapter.d.ts

@@ -1,5 +1,5 @@
 import { SetState, StoreConfig } from "./types";
-export declare const createStorageAdapter: <TState extends object, TActions extends object = Record<never, never>>(config: StoreConfig<TState, TActions>, get: () => TState, set: SetState<TState>) => {
+export declare const createStorageAdapter: <TState, TActions>(config: StoreConfig<TState, TActions>, get: () => TState, set: SetState<TState>) => {
     onLoad: () => Promise<void>;
     onChange: (newState: TState) => Promise<void>;
     onAttach: () => void;

package/dist/cjs/lib/createStorageAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"createStorageAdapter.js","sources":["../../../src/lib/createStorageAdapter.ts"],"sourcesContent":["import { SetState, StorageAPI, StoreConfig } from \"./types\";\nimport { warn } from \"./warn\";\n\nexport const createStorageAdapter = <\n  TState extends object,\n  TActions extends object = Record<never, never>,\n>(\n  config: StoreConfig<TState, TActions>,\n  get: () => TState,\n  set: SetState<TState>,\n) => {\n  if (!config.persist) {\n    return null;\n  }\n\n  const IS_BROWSER = typeof window !== \"undefined\";\n\n  const storage =\n    config.storage ?? (IS_BROWSER ? (localStorage as StorageAPI) : undefined);\n\n  if (!storage) {\n    warn(\n      \"No storage provider found. If this happened during SSR, you can safely ignore this warning.\",\n    );\n    return null;\n  }\n\n  const { key, serializer = JSON, initialState } = config;\n  const initKey = `init_${key}`;\n\n  const onLoad = async () => {\n    try {\n      let initialStateSnapshot = storage.getItem(initKey);\n      const initialStateString = serializer.stringify(initialState);\n\n      if (initialStateSnapshot instanceof Promise) {\n        initialStateSnapshot = await initialStateSnapshot;\n      }\n\n      if (initialStateSnapshot !== initialStateString) {\n        storage.setItem(initKey, initialStateString);\n        storage.removeItem(key);\n      }\n    } catch {\n      warn(\n        \"Failed to initialize snapshots. If this happened during SSR, you can safely ignore this warning.\",\n      );\n    }\n  };\n\n  const syncWithSnapshot = async () => {\n    try {\n      let currentSnapshot = storage.getItem(key);\n\n      if (currentSnapshot instanceof Promise) {\n        currentSnapshot = await currentSnapshot;\n      }\n\n      if (currentSnapshot && currentSnapshot !== serializer.stringify(get())) {\n        set(serializer.parse(currentSnapshot));\n      }\n    } catch {\n      warn(\"Failed to update state from snapshot\");\n    }\n  };\n\n  const onAttach = () => {\n    syncWithSnapshot();\n\n    if (IS_BROWSER) {\n      window.addEventListener(\"focus\", syncWithSnapshot);\n    }\n  };\n\n  const onChange = async (newState: TState) => {\n    try {\n      let currentSnapshot = storage.getItem(key);\n      const newSnapshot = serializer.stringify(newState);\n\n      if (currentSnapshot instanceof Promise) {\n        currentSnapshot = await currentSnapshot;\n      }\n\n      if (newSnapshot !== currentSnapshot) {\n        storage.setItem(key, newSnapshot);\n      }\n    } catch {\n      warn(\"Failed to update snapshot\");\n    }\n  };\n\n  const onDetach = () => {\n    if (IS_BROWSER) {\n      window.removeEventListener(\"focus\", syncWithSnapshot);\n    }\n  };\n\n  return {\n    onLoad,\n    onChange,\n    onAttach,\n    onDetach,\n  };\n};\n"],"names":["warn"],"mappings":";;;;AAGO,MAAM,oBAAoB,GAAG,CAIlC,MAAqC,EACrC,GAAiB,EACjB,GAAqB,KACnB;AACF,IAAA,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;AACnB,QAAA,OAAO,IAAI;IACb;AAEA,IAAA,MAAM,UAAU,GAAG,OAAO,MAAM,KAAK,WAAW;AAEhD,IAAA,MAAM,OAAO,GACX,MAAM,CAAC,OAAO,KAAK,UAAU,GAAI,YAA2B,GAAG,SAAS,CAAC;IAE3E,IAAI,CAAC,OAAO,EAAE;QACZA,SAAI,CACF,6FAA6F,CAC9F;AACD,QAAA,OAAO,IAAI;IACb;IAEA,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,EAAE,YAAY,EAAE,GAAG,MAAM;AACvD,IAAA,MAAM,OAAO,GAAG,CAAA,KAAA,EAAQ,GAAG,EAAE;AAE7B,IAAA,MAAM,MAAM,GAAG,YAAW;AACxB,QAAA,IAAI;YACF,IAAI,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;YACnD,MAAM,kBAAkB,GAAG,UAAU,CAAC,SAAS,CAAC,YAAY,CAAC;AAE7D,YAAA,IAAI,oBAAoB,YAAY,OAAO,EAAE;gBAC3C,oBAAoB,GAAG,MAAM,oBAAoB;YACnD;AAEA,YAAA,IAAI,oBAAoB,KAAK,kBAAkB,EAAE;AAC/C,gBAAA,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB,CAAC;AAC5C,gBAAA,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YACzB;QACF;AAAE,QAAA,MAAM;YACNA,SAAI,CACF,kGAAkG,CACnG;QACH;AACF,IAAA,CAAC;AAED,IAAA,MAAM,gBAAgB,GAAG,YAAW;AAClC,QAAA,IAAI;YACF,IAAI,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;AAE1C,YAAA,IAAI,eAAe,YAAY,OAAO,EAAE;gBACtC,eAAe,GAAG,MAAM,eAAe;YACzC;AAEA,YAAA,IAAI,eAAe,IAAI,eAAe,KAAK,UAAU,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE;gBACtE,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YACxC;QACF;AAAE,QAAA,MAAM;YACNA,SAAI,CAAC,sCAAsC,CAAC;QAC9C;AACF,IAAA,CAAC;IAED,MAAM,QAAQ,GAAG,MAAK;AACpB,QAAA,gBAAgB,EAAE;QAElB,IAAI,UAAU,EAAE;AACd,YAAA,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,CAAC;QACpD;AACF,IAAA,CAAC;AAED,IAAA,MAAM,QAAQ,GAAG,OAAO,QAAgB,KAAI;AAC1C,QAAA,IAAI;YACF,IAAI,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;YAC1C,MAAM,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC;AAElD,YAAA,IAAI,eAAe,YAAY,OAAO,EAAE;gBACtC,eAAe,GAAG,MAAM,eAAe;YACzC;AAEA,YAAA,IAAI,WAAW,KAAK,eAAe,EAAE;AACnC,gBAAA,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC;YACnC;QACF;AAAE,QAAA,MAAM;YACNA,SAAI,CAAC,2BAA2B,CAAC;QACnC;AACF,IAAA,CAAC;IAED,MAAM,QAAQ,GAAG,MAAK;QACpB,IAAI,UAAU,EAAE;AACd,YAAA,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,CAAC;QACvD;AACF,IAAA,CAAC;IAED,OAAO;QACL,MAAM;QACN,QAAQ;QACR,QAAQ;QACR,QAAQ;KACT;AACH;;;;"}
+{"version":3,"file":"createStorageAdapter.js","sources":["../../../src/lib/createStorageAdapter.ts"],"sourcesContent":["import { SetState, StorageAPI, StoreConfig } from \"./types\";\nimport { warn } from \"./warn\";\n\nexport const createStorageAdapter = <TState, TActions>(\n  config: StoreConfig<TState, TActions>,\n  get: () => TState,\n  set: SetState<TState>,\n) => {\n  if (!config.persist) {\n    return null;\n  }\n\n  const IS_BROWSER = typeof window !== \"undefined\";\n\n  const storage =\n    config.storage ?? (IS_BROWSER ? (localStorage as StorageAPI) : undefined);\n\n  if (!storage) {\n    warn(\n      \"No storage provider found. If this happened during SSR, you can safely ignore this warning.\",\n    );\n    return null;\n  }\n\n  const { key, serializer = JSON, initialState } = config;\n  const initKey = `init_${key}`;\n\n  const onLoad = async () => {\n    try {\n      let initialStateSnapshot = storage.getItem(initKey);\n      const initialStateString = serializer.stringify(initialState);\n\n      if (initialStateSnapshot instanceof Promise) {\n        initialStateSnapshot = await initialStateSnapshot;\n      }\n\n      if (initialStateSnapshot !== initialStateString) {\n        storage.setItem(initKey, initialStateString);\n        storage.removeItem(key);\n      }\n    } catch {\n      warn(\n        \"Failed to initialize snapshots. If this happened during SSR, you can safely ignore this warning.\",\n      );\n    }\n  };\n\n  const syncWithSnapshot = async () => {\n    try {\n      let currentSnapshot = storage.getItem(key);\n\n      if (currentSnapshot instanceof Promise) {\n        currentSnapshot = await currentSnapshot;\n      }\n\n      if (currentSnapshot && currentSnapshot !== serializer.stringify(get())) {\n        set(serializer.parse(currentSnapshot));\n      }\n    } catch {\n      warn(\"Failed to update state from snapshot\");\n    }\n  };\n\n  const onAttach = () => {\n    syncWithSnapshot();\n\n    if (IS_BROWSER) {\n      window.addEventListener(\"focus\", syncWithSnapshot);\n    }\n  };\n\n  const onChange = async (newState: TState) => {\n    try {\n      let currentSnapshot = storage.getItem(key);\n      const newSnapshot = serializer.stringify(newState);\n\n      if (currentSnapshot instanceof Promise) {\n        currentSnapshot = await currentSnapshot;\n      }\n\n      if (newSnapshot !== currentSnapshot) {\n        storage.setItem(key, newSnapshot);\n      }\n    } catch {\n      warn(\"Failed to update snapshot\");\n    }\n  };\n\n  const onDetach = () => {\n    if (IS_BROWSER) {\n      window.removeEventListener(\"focus\", syncWithSnapshot);\n    }\n  };\n\n  return {\n    onLoad,\n    onChange,\n    onAttach,\n    onDetach,\n  };\n};\n"],"names":["warn"],"mappings":";;;;AAGO,MAAM,oBAAoB,GAAG,CAClC,MAAqC,EACrC,GAAiB,EACjB,GAAqB,KACnB;AACF,IAAA,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;AACnB,QAAA,OAAO,IAAI;IACb;AAEA,IAAA,MAAM,UAAU,GAAG,OAAO,MAAM,KAAK,WAAW;AAEhD,IAAA,MAAM,OAAO,GACX,MAAM,CAAC,OAAO,KAAK,UAAU,GAAI,YAA2B,GAAG,SAAS,CAAC;IAE3E,IAAI,CAAC,OAAO,EAAE;QACZA,SAAI,CACF,6FAA6F,CAC9F;AACD,QAAA,OAAO,IAAI;IACb;IAEA,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,EAAE,YAAY,EAAE,GAAG,MAAM;AACvD,IAAA,MAAM,OAAO,GAAG,CAAA,KAAA,EAAQ,GAAG,EAAE;AAE7B,IAAA,MAAM,MAAM,GAAG,YAAW;AACxB,QAAA,IAAI;YACF,IAAI,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;YACnD,MAAM,kBAAkB,GAAG,UAAU,CAAC,SAAS,CAAC,YAAY,CAAC;AAE7D,YAAA,IAAI,oBAAoB,YAAY,OAAO,EAAE;gBAC3C,oBAAoB,GAAG,MAAM,oBAAoB;YACnD;AAEA,YAAA,IAAI,oBAAoB,KAAK,kBAAkB,EAAE;AAC/C,gBAAA,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB,CAAC;AAC5C,gBAAA,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YACzB;QACF;AAAE,QAAA,MAAM;YACNA,SAAI,CACF,kGAAkG,CACnG;QACH;AACF,IAAA,CAAC;AAED,IAAA,MAAM,gBAAgB,GAAG,YAAW;AAClC,QAAA,IAAI;YACF,IAAI,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;AAE1C,YAAA,IAAI,eAAe,YAAY,OAAO,EAAE;gBACtC,eAAe,GAAG,MAAM,eAAe;YACzC;AAEA,YAAA,IAAI,eAAe,IAAI,eAAe,KAAK,UAAU,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE;gBACtE,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YACxC;QACF;AAAE,QAAA,MAAM;YACNA,SAAI,CAAC,sCAAsC,CAAC;QAC9C;AACF,IAAA,CAAC;IAED,MAAM,QAAQ,GAAG,MAAK;AACpB,QAAA,gBAAgB,EAAE;QAElB,IAAI,UAAU,EAAE;AACd,YAAA,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,CAAC;QACpD;AACF,IAAA,CAAC;AAED,IAAA,MAAM,QAAQ,GAAG,OAAO,QAAgB,KAAI;AAC1C,QAAA,IAAI;YACF,IAAI,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;YAC1C,MAAM,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC;AAElD,YAAA,IAAI,eAAe,YAAY,OAAO,EAAE;gBACtC,eAAe,GAAG,MAAM,eAAe;YACzC;AAEA,YAAA,IAAI,WAAW,KAAK,eAAe,EAAE;AACnC,gBAAA,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC;YACnC;QACF;AAAE,QAAA,MAAM;YACNA,SAAI,CAAC,2BAA2B,CAAC;QACnC;AACF,IAAA,CAAC;IAED,MAAM,QAAQ,GAAG,MAAK;QACpB,IAAI,UAAU,EAAE;AACd,YAAA,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,CAAC;QACvD;AACF,IAAA,CAAC;IAED,OAAO;QACL,MAAM;QACN,QAAQ;QACR,QAAQ;QACR,QAAQ;KACT;AACH;;;;"}

package/dist/cjs/lib/createStore.d.ts

@@ -6,79 +6,6 @@ import { Store, StoreConfig } from "./types";
  *
  * @returns {Store<TState, TActions>} The created store with state management methods.
  *
- * @example
- * Basic usage:
- * ```ts
- * import { createStore } from "dharma-core";
- *
- * const store = createStore({
- *   initialState: { count: 0 },
- *   defineActions: ({ set }) => ({
- *     increment: () => set((state) => ({ count: state.count + 1 })),
- *     decrement: () => set((state) => ({ count: state.count - 1 })),
- *   }),
- * });
- * ```
- *
- * @example
- * Lifecycle hooks:
- * ```ts
- * import { createStore } from "dharma-core";
- * import { State } from "./types";
- *
- * const initialState: State = { data: null, loading: true, error: null };
- *
- * const store = createStore({
- *   initialState,
- *   onAttach: async ({ set }) => {
- *     try {
- *       const response = await fetch("https://api.example.com/data");
- *       const data = await response.json();
- *       set({ data, loading: false });
- *     } catch (error) {
- *       set({ error, loading: false });
- *     }
- *   },
- *   onDetach: ({ reset }) => reset(),
- * });
- * ```
- *
- * @example
- * Persisting state:
- * ```ts
- * import { createStore } from "dharma-core";
- *
- * const store = createStore({
- *   persist: true,
- *   key: "count",
- *   initialState: { count: 0 },
- *   defineActions: ({ set }) => ({
- *     increment: () => set((state) => ({ count: state.count + 1 })),
- *     decrement: () => set((state) => ({ count: state.count - 1 })),
- *   }),
- * });
- * ```
- *
- * **Note:** The state needs to be serializable by whatever serializer you choose (JSON by default).
- * If you need something more versatile I would recommend using a library like [superjson](https://github.com/flightcontrolhq/superjson).
- *
- * @example
- * Custom storage and serializer:
- * ```ts
- * import { createStore } from "dharma-core";
- * import superjson from "superjson";
- *
- * const store = createStore({
- *   persist: true,
- *   key: "count",
- *   storage: sessionStorage,
- *   serializer: superjson,
- *   initialState: { count: 0 },
- *   defineActions: ({ set }) => ({
- *     increment: () => set((state) => ({ count: state.count + 1 })),
- *     decrement: () => set((state) => ({ count: state.count - 1 })),
- *   }),
- * });
- * ```
+ * @see {@link https://dharma.fransek.dev/core/createstore/}
  */
-export declare const createStore: <TState extends object, TActions extends object = Record<never, never>>(config: StoreConfig<TState, TActions>) => Store<TState, TActions>;
+export declare const createStore: <TState, TActions = undefined>(config: StoreConfig<TState, TActions>) => Store<TState, TActions>;

package/dist/cjs/lib/createStore.js

@@ -10,80 +10,7 @@ var merge = require('./merge.js');
  *
  * @returns {Store<TState, TActions>} The created store with state management methods.
  *
- * @example
- * Basic usage:
- * ```ts
- * import { createStore } from "dharma-core";
- *
- * const store = createStore({
- *   initialState: { count: 0 },
- *   defineActions: ({ set }) => ({
- *     increment: () => set((state) => ({ count: state.count + 1 })),
- *     decrement: () => set((state) => ({ count: state.count - 1 })),
- *   }),
- * });
- * ```
- *
- * @example
- * Lifecycle hooks:
- * ```ts
- * import { createStore } from "dharma-core";
- * import { State } from "./types";
- *
- * const initialState: State = { data: null, loading: true, error: null };
- *
- * const store = createStore({
- *   initialState,
- *   onAttach: async ({ set }) => {
- *     try {
- *       const response = await fetch("https://api.example.com/data");
- *       const data = await response.json();
- *       set({ data, loading: false });
- *     } catch (error) {
- *       set({ error, loading: false });
- *     }
- *   },
- *   onDetach: ({ reset }) => reset(),
- * });
- * ```
- *
- * @example
- * Persisting state:
- * ```ts
- * import { createStore } from "dharma-core";
- *
- * const store = createStore({
- *   persist: true,
- *   key: "count",
- *   initialState: { count: 0 },
- *   defineActions: ({ set }) => ({
- *     increment: () => set((state) => ({ count: state.count + 1 })),
- *     decrement: () => set((state) => ({ count: state.count - 1 })),
- *   }),
- * });
- * ```
- *
- * **Note:** The state needs to be serializable by whatever serializer you choose (JSON by default).
- * If you need something more versatile I would recommend using a library like [superjson](https://github.com/flightcontrolhq/superjson).
- *
- * @example
- * Custom storage and serializer:
- * ```ts
- * import { createStore } from "dharma-core";
- * import superjson from "superjson";
- *
- * const store = createStore({
- *   persist: true,
- *   key: "count",
- *   storage: sessionStorage,
- *   serializer: superjson,
- *   initialState: { count: 0 },
- *   defineActions: ({ set }) => ({
- *     increment: () => set((state) => ({ count: state.count + 1 })),
- *     decrement: () => set((state) => ({ count: state.count - 1 })),
- *   }),
- * });
- * ```
+ * @see {@link https://dharma.fransek.dev/core/createstore/}
  */
 const createStore = (config) => {
     const { initialState, defineActions, onLoad, onAttach, onDetach, onChange } = config;
@@ -105,9 +32,7 @@ const createStore = (config) => {
         return state;
     };
     const listeners = new Set();
-    const actions = defineActions
-        ? defineActions({ set, get, reset })
-        : {};
+    const actions = defineActions?.({ set, get, reset });
     const storageAdapter = createStorageAdapter.createStorageAdapter(config, get, set);
     const subscribe = (listener) => {
         if (listeners.size === 0) {
@@ -137,8 +62,6 @@ const createStore = (config) => {
     storageAdapter?.onLoad();
     return {
         get,
-        set,
-        reset,
         subscribe,
         actions,
     };

package/dist/cjs/lib/createStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"createStore.js","sources":["../../../src/lib/createStore.ts"],"sourcesContent":["import { createStorageAdapter } from \"./createStorageAdapter\";\nimport { merge } from \"./merge\";\nimport { Listener, StateModifier, Store, StoreConfig } from \"./types\";\n\n/**\n * Creates a store with an initial state and actions that can modify the state.\n *\n * @param {StoreConfig<TState, TActions>} [config] - The configuration for the store.\n *\n * @returns {Store<TState, TActions>} The created store with state management methods.\n *\n * @example\n * Basic usage:\n * ```ts\n * import { createStore } from \"dharma-core\";\n *\n * const store = createStore({\n *   initialState: { count: 0 },\n *   defineActions: ({ set }) => ({\n *     increment: () => set((state) => ({ count: state.count + 1 })),\n *     decrement: () => set((state) => ({ count: state.count - 1 })),\n *   }),\n * });\n * ```\n *\n * @example\n * Lifecycle hooks:\n * ```ts\n * import { createStore } from \"dharma-core\";\n * import { State } from \"./types\";\n *\n * const initialState: State = { data: null, loading: true, error: null };\n *\n * const store = createStore({\n *   initialState,\n *   onAttach: async ({ set }) => {\n *     try {\n *       const response = await fetch(\"https://api.example.com/data\");\n *       const data = await response.json();\n *       set({ data, loading: false });\n *     } catch (error) {\n *       set({ error, loading: false });\n *     }\n *   },\n *   onDetach: ({ reset }) => reset(),\n * });\n * ```\n *\n * @example\n * Persisting state:\n * ```ts\n * import { createStore } from \"dharma-core\";\n *\n * const store = createStore({\n *   persist: true,\n *   key: \"count\",\n *   initialState: { count: 0 },\n *   defineActions: ({ set }) => ({\n *     increment: () => set((state) => ({ count: state.count + 1 })),\n *     decrement: () => set((state) => ({ count: state.count - 1 })),\n *   }),\n * });\n * ```\n *\n * **Note:** The state needs to be serializable by whatever serializer you choose (JSON by default).\n * If you need something more versatile I would recommend using a library like [superjson](https://github.com/flightcontrolhq/superjson).\n *\n * @example\n * Custom storage and serializer:\n * ```ts\n * import { createStore } from \"dharma-core\";\n * import superjson from \"superjson\";\n *\n * const store = createStore({\n *   persist: true,\n *   key: \"count\",\n *   storage: sessionStorage,\n *   serializer: superjson,\n *   initialState: { count: 0 },\n *   defineActions: ({ set }) => ({\n *     increment: () => set((state) => ({ count: state.count + 1 })),\n *     decrement: () => set((state) => ({ count: state.count - 1 })),\n *   }),\n * });\n * ```\n */\nexport const createStore = <\n  TState extends object,\n  TActions extends object = Record<never, never>,\n>(\n  config: StoreConfig<TState, TActions>,\n): Store<TState, TActions> => {\n  const { initialState, defineActions, onLoad, onAttach, onDetach, onChange } =\n    config;\n\n  let state = initialState;\n\n  const get = () => state;\n\n  const setSilently = (stateModifier: StateModifier<TState>) => {\n    state = merge(state, stateModifier);\n    return state;\n  };\n\n  const set = (stateModifier: StateModifier<TState>) => {\n    setSilently(stateModifier);\n    dispatch();\n    return state;\n  };\n\n  const resetSilently = () => setSilently(initialState);\n\n  const reset = () => {\n    resetSilently();\n    dispatch();\n    return state;\n  };\n\n  const listeners = new Set<Listener<TState>>();\n  const actions = defineActions\n    ? defineActions({ set, get, reset })\n    : ({} as TActions);\n  const storageAdapter = createStorageAdapter(config, get, set);\n\n  const subscribe = (listener: Listener<TState>) => {\n    if (listeners.size === 0) {\n      onAttach?.({ state, set, reset });\n      storageAdapter?.onAttach();\n    }\n\n    listener(state);\n    listeners.add(listener);\n\n    return () => {\n      listeners.delete(listener);\n\n      if (listeners.size === 0) {\n        onDetach?.({ state, set, reset });\n        storageAdapter?.onDetach();\n      }\n    };\n  };\n\n  const dispatch = () => {\n    onChange?.({\n      state,\n      set: setSilently,\n      reset: resetSilently,\n    });\n    storageAdapter?.onChange(state);\n    listeners.forEach((listener) => listener(state));\n  };\n\n  onLoad?.({ state, set, reset });\n  storageAdapter?.onLoad();\n\n  return {\n    get,\n    set,\n    reset,\n    subscribe,\n    actions,\n  };\n};\n"],"names":["merge","createStorageAdapter"],"mappings":";;;;;AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiFG;AACI,MAAM,WAAW,GAAG,CAIzB,MAAqC,KACV;AAC3B,IAAA,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,GACzE,MAAM;IAER,IAAI,KAAK,GAAG,YAAY;AAExB,IAAA,MAAM,GAAG,GAAG,MAAM,KAAK;AAEvB,IAAA,MAAM,WAAW,GAAG,CAAC,aAAoC,KAAI;AAC3D,QAAA,KAAK,GAAGA,WAAK,CAAC,KAAK,EAAE,aAAa,CAAC;AACnC,QAAA,OAAO,KAAK;AACd,IAAA,CAAC;AAED,IAAA,MAAM,GAAG,GAAG,CAAC,aAAoC,KAAI;QACnD,WAAW,CAAC,aAAa,CAAC;AAC1B,QAAA,QAAQ,EAAE;AACV,QAAA,OAAO,KAAK;AACd,IAAA,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,WAAW,CAAC,YAAY,CAAC;IAErD,MAAM,KAAK,GAAG,MAAK;AACjB,QAAA,aAAa,EAAE;AACf,QAAA,QAAQ,EAAE;AACV,QAAA,OAAO,KAAK;AACd,IAAA,CAAC;AAED,IAAA,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB;IAC7C,MAAM,OAAO,GAAG;UACZ,aAAa,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE;UAChC,EAAe;IACpB,MAAM,cAAc,GAAGC,yCAAoB,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC;AAE7D,IAAA,MAAM,SAAS,GAAG,CAAC,QAA0B,KAAI;AAC/C,QAAA,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE;YACxB,QAAQ,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;YACjC,cAAc,EAAE,QAAQ,EAAE;QAC5B;QAEA,QAAQ,CAAC,KAAK,CAAC;AACf,QAAA,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;AAEvB,QAAA,OAAO,MAAK;AACV,YAAA,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC;AAE1B,YAAA,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE;gBACxB,QAAQ,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;gBACjC,cAAc,EAAE,QAAQ,EAAE;YAC5B;AACF,QAAA,CAAC;AACH,IAAA,CAAC;IAED,MAAM,QAAQ,GAAG,MAAK;AACpB,QAAA,QAAQ,GAAG;YACT,KAAK;AACL,YAAA,GAAG,EAAE,WAAW;AAChB,YAAA,KAAK,EAAE,aAAa;AACrB,SAAA,CAAC;AACF,QAAA,cAAc,EAAE,QAAQ,CAAC,KAAK,CAAC;AAC/B,QAAA,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,KAAK,CAAC,CAAC;AAClD,IAAA,CAAC;IAED,MAAM,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IAC/B,cAAc,EAAE,MAAM,EAAE;IAExB,OAAO;QACL,GAAG;QACH,GAAG;QACH,KAAK;QACL,SAAS;QACT,OAAO;KACR;AACH;;;;"}
+{"version":3,"file":"createStore.js","sources":["../../../src/lib/createStore.ts"],"sourcesContent":["import { createStorageAdapter } from \"./createStorageAdapter\";\nimport { merge } from \"./merge\";\nimport { Listener, StateModifier, Store, StoreConfig } from \"./types\";\n\n/**\n * Creates a store with an initial state and actions that can modify the state.\n *\n * @param {StoreConfig<TState, TActions>} [config] - The configuration for the store.\n *\n * @returns {Store<TState, TActions>} The created store with state management methods.\n *\n * @see {@link https://dharma.fransek.dev/core/createstore/}\n */\nexport const createStore = <TState, TActions = undefined>(\n  config: StoreConfig<TState, TActions>,\n): Store<TState, TActions> => {\n  const { initialState, defineActions, onLoad, onAttach, onDetach, onChange } =\n    config;\n\n  let state = initialState;\n\n  const get = () => state;\n\n  const setSilently = (stateModifier: StateModifier<TState>) => {\n    state = merge(state, stateModifier);\n    return state;\n  };\n\n  const set = (stateModifier: StateModifier<TState>) => {\n    setSilently(stateModifier);\n    dispatch();\n    return state;\n  };\n\n  const resetSilently = () => setSilently(initialState);\n\n  const reset = () => {\n    resetSilently();\n    dispatch();\n    return state;\n  };\n\n  const listeners = new Set<Listener<TState>>();\n  const actions = defineActions?.({ set, get, reset }) as TActions;\n  const storageAdapter = createStorageAdapter(config, get, set);\n\n  const subscribe = (listener: Listener<TState>) => {\n    if (listeners.size === 0) {\n      onAttach?.({ state, set, reset });\n      storageAdapter?.onAttach();\n    }\n\n    listener(state);\n    listeners.add(listener);\n\n    return () => {\n      listeners.delete(listener);\n\n      if (listeners.size === 0) {\n        onDetach?.({ state, set, reset });\n        storageAdapter?.onDetach();\n      }\n    };\n  };\n\n  const dispatch = () => {\n    onChange?.({\n      state,\n      set: setSilently,\n      reset: resetSilently,\n    });\n    storageAdapter?.onChange(state);\n    listeners.forEach((listener) => listener(state));\n  };\n\n  onLoad?.({ state, set, reset });\n  storageAdapter?.onLoad();\n\n  return {\n    get,\n    subscribe,\n    actions,\n  };\n};\n"],"names":["merge","createStorageAdapter"],"mappings":";;;;;AAIA;;;;;;;;AAQG;AACI,MAAM,WAAW,GAAG,CACzB,MAAqC,KACV;AAC3B,IAAA,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,GACzE,MAAM;IAER,IAAI,KAAK,GAAG,YAAY;AAExB,IAAA,MAAM,GAAG,GAAG,MAAM,KAAK;AAEvB,IAAA,MAAM,WAAW,GAAG,CAAC,aAAoC,KAAI;AAC3D,QAAA,KAAK,GAAGA,WAAK,CAAC,KAAK,EAAE,aAAa,CAAC;AACnC,QAAA,OAAO,KAAK;AACd,IAAA,CAAC;AAED,IAAA,MAAM,GAAG,GAAG,CAAC,aAAoC,KAAI;QACnD,WAAW,CAAC,aAAa,CAAC;AAC1B,QAAA,QAAQ,EAAE;AACV,QAAA,OAAO,KAAK;AACd,IAAA,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,WAAW,CAAC,YAAY,CAAC;IAErD,MAAM,KAAK,GAAG,MAAK;AACjB,QAAA,aAAa,EAAE;AACf,QAAA,QAAQ,EAAE;AACV,QAAA,OAAO,KAAK;AACd,IAAA,CAAC;AAED,IAAA,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB;AAC7C,IAAA,MAAM,OAAO,GAAG,aAAa,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,CAAa;IAChE,MAAM,cAAc,GAAGC,yCAAoB,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC;AAE7D,IAAA,MAAM,SAAS,GAAG,CAAC,QAA0B,KAAI;AAC/C,QAAA,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE;YACxB,QAAQ,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;YACjC,cAAc,EAAE,QAAQ,EAAE;QAC5B;QAEA,QAAQ,CAAC,KAAK,CAAC;AACf,QAAA,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;AAEvB,QAAA,OAAO,MAAK;AACV,YAAA,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC;AAE1B,YAAA,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE;gBACxB,QAAQ,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;gBACjC,cAAc,EAAE,QAAQ,EAAE;YAC5B;AACF,QAAA,CAAC;AACH,IAAA,CAAC;IAED,MAAM,QAAQ,GAAG,MAAK;AACpB,QAAA,QAAQ,GAAG;YACT,KAAK;AACL,YAAA,GAAG,EAAE,WAAW;AAChB,YAAA,KAAK,EAAE,aAAa;AACrB,SAAA,CAAC;AACF,QAAA,cAAc,EAAE,QAAQ,CAAC,KAAK,CAAC;AAC/B,QAAA,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,KAAK,CAAC,CAAC;AAClD,IAAA,CAAC;IAED,MAAM,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IAC/B,cAAc,EAAE,MAAM,EAAE;IAExB,OAAO;QACL,GAAG;QACH,SAAS;QACT,OAAO;KACR;AACH;;;;"}

package/dist/cjs/lib/deeplyEquals.d.ts

@@ -0,0 +1 @@
+export declare const deeplyEquals: (a: unknown, b: unknown) => boolean;

package/dist/cjs/lib/deeplyEquals.js

@@ -0,0 +1,49 @@
+'use strict';
+
+const deeplyEquals = (a, b) => {
+    if (a === b) {
+        return true;
+    }
+    if (a === null ||
+        b === null ||
+        typeof a !== "object" ||
+        typeof b !== "object") {
+        return false;
+    }
+    const protoA = Object.getPrototypeOf(a);
+    const protoB = Object.getPrototypeOf(b);
+    if (protoA !== protoB) {
+        return false;
+    }
+    if (protoA === Array.prototype) {
+        const arrA = a;
+        const arrB = b;
+        if (arrA.length !== arrB.length)
+            return false;
+        for (let i = 0; i < arrA.length; i++) {
+            if (!deeplyEquals(arrA[i], arrB[i]))
+                return false;
+        }
+        return true;
+    }
+    if (protoA !== Object.prototype) {
+        return false;
+    }
+    const keysA = Object.keys(a);
+    const keysB = Object.keys(b);
+    if (keysA.length !== keysB.length) {
+        return false;
+    }
+    for (const key of keysA) {
+        if (!keysB.includes(key)) {
+            return false;
+        }
+        if (!deeplyEquals(a[key], b[key])) {
+            return false;
+        }
+    }
+    return true;
+};
+
+exports.deeplyEquals = deeplyEquals;
+//# sourceMappingURL=deeplyEquals.js.map

package/dist/cjs/lib/deeplyEquals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deeplyEquals.js","sources":["../../../src/lib/deeplyEquals.ts"],"sourcesContent":["export const deeplyEquals = (a: unknown, b: unknown): boolean => {\n  if (a === b) {\n    return true;\n  }\n\n  if (\n    a === null ||\n    b === null ||\n    typeof a !== \"object\" ||\n    typeof b !== \"object\"\n  ) {\n    return false;\n  }\n\n  const protoA = Object.getPrototypeOf(a);\n  const protoB = Object.getPrototypeOf(b);\n\n  if (protoA !== protoB) {\n    return false;\n  }\n\n  if (protoA === Array.prototype) {\n    const arrA = a as unknown[];\n    const arrB = b as unknown[];\n    if (arrA.length !== arrB.length) return false;\n    for (let i = 0; i < arrA.length; i++) {\n      if (!deeplyEquals(arrA[i], arrB[i])) return false;\n    }\n    return true;\n  }\n\n  if (protoA !== Object.prototype) {\n    return false;\n  }\n\n  const keysA = Object.keys(a);\n  const keysB = Object.keys(b);\n\n  if (keysA.length !== keysB.length) {\n    return false;\n  }\n\n  for (const key of keysA) {\n    if (!keysB.includes(key)) {\n      return false;\n    }\n    if (\n      !deeplyEquals(\n        (a as Record<string, unknown>)[key],\n        (b as Record<string, unknown>)[key],\n      )\n    ) {\n      return false;\n    }\n  }\n\n  return true;\n};\n"],"names":[],"mappings":";;MAAa,YAAY,GAAG,CAAC,CAAU,EAAE,CAAU,KAAa;AAC9D,IAAA,IAAI,CAAC,KAAK,CAAC,EAAE;AACX,QAAA,OAAO,IAAI;IACb;IAEA,IACE,CAAC,KAAK,IAAI;AACV,QAAA,CAAC,KAAK,IAAI;QACV,OAAO,CAAC,KAAK,QAAQ;AACrB,QAAA,OAAO,CAAC,KAAK,QAAQ,EACrB;AACA,QAAA,OAAO,KAAK;IACd;IAEA,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;AAEvC,IAAA,IAAI,MAAM,KAAK,MAAM,EAAE;AACrB,QAAA,OAAO,KAAK;IACd;AAEA,IAAA,IAAI,MAAM,KAAK,KAAK,CAAC,SAAS,EAAE;QAC9B,MAAM,IAAI,GAAG,CAAc;QAC3B,MAAM,IAAI,GAAG,CAAc;AAC3B,QAAA,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;AAAE,YAAA,OAAO,KAAK;AAC7C,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;AACpC,YAAA,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;AAAE,gBAAA,OAAO,KAAK;QACnD;AACA,QAAA,OAAO,IAAI;IACb;AAEA,IAAA,IAAI,MAAM,KAAK,MAAM,CAAC,SAAS,EAAE;AAC/B,QAAA,OAAO,KAAK;IACd;IAEA,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAE5B,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE;AACjC,QAAA,OAAO,KAAK;IACd;AAEA,IAAA,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE;QACvB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;AACxB,YAAA,OAAO,KAAK;QACd;AACA,QAAA,IACE,CAAC,YAAY,CACV,CAA6B,CAAC,GAAG,CAAC,EAClC,CAA6B,CAAC,GAAG,CAAC,CACpC,EACD;AACA,YAAA,OAAO,KAAK;QACd;IACF;AAEA,IAAA,OAAO,IAAI;AACb;;;;"}

package/dist/cjs/lib/derive.d.ts

@@ -0,0 +1,16 @@
+import { DerivedStore, Store } from "./types";
+/**
+ * Creates a derived store from an existing store.
+ *
+ * A derived store computes its state based on the original store's state using a derive function.
+ * The derived store's value is memoized and only recomputed when requested.
+ *
+ * @param store - The original store to derive from
+ * @param deriveFn - A function that computes the derived state from the original state
+ * @param dependencyFn - Optional function that returns an array of dependencies. If provided, the derived state will only be recomputed when these dependencies change
+ *
+ * @returns A new store containing the derived state
+ *
+ * @see {@link https://dharma.fransek.dev/core/derive/}
+ */
+export declare const derive: <TState, TActions, TDerived>(store: Store<TState, TActions>, deriveFn: (state: TState) => TDerived, dependencyFn?: (state: TState) => unknown[]) => DerivedStore<TDerived>;

package/dist/cjs/lib/derive.js

@@ -0,0 +1,81 @@
+'use strict';
+
+var deeplyEquals = require('./deeplyEquals.js');
+
+/**
+ * Creates a derived store from an existing store.
+ *
+ * A derived store computes its state based on the original store's state using a derive function.
+ * The derived store's value is memoized and only recomputed when requested.
+ *
+ * @param store - The original store to derive from
+ * @param deriveFn - A function that computes the derived state from the original state
+ * @param dependencyFn - Optional function that returns an array of dependencies. If provided, the derived state will only be recomputed when these dependencies change
+ *
+ * @returns A new store containing the derived state
+ *
+ * @see {@link https://dharma.fransek.dev/core/derive/}
+ */
+const derive = (store, deriveFn, dependencyFn) => {
+    let memo;
+    let prev;
+    let isStale = true;
+    let unsubscribe;
+    const listeners = new Set();
+    const compute = () => {
+        memo = deriveFn(store.get());
+        isStale = false;
+        return memo;
+    };
+    const get = () => {
+        if (!dependencyFn) {
+            if (isStale) {
+                return compute();
+            }
+            return memo;
+        }
+        const next = dependencyFn(store.get());
+        isStale &&= !prev || !deeplyEquals.deeplyEquals(prev, next);
+        if (isStale) {
+            prev = next;
+            return compute();
+        }
+        return memo;
+    };
+    const subscribe = (listener) => {
+        if (listeners.size === 0) {
+            mount();
+        }
+        listener(get());
+        listeners.add(listener);
+        return () => {
+            listeners.delete(listener);
+            if (listeners.size === 0) {
+                unmount();
+            }
+        };
+    };
+    const mount = () => {
+        if (!unsubscribe) {
+            unsubscribe = store.subscribe(() => {
+                isStale = true;
+                listeners.forEach((listener) => listener(get()));
+            });
+        }
+    };
+    const unmount = () => {
+        unsubscribe?.();
+        unsubscribe = undefined;
+    };
+    return {
+        get,
+        subscribe,
+        actions: {
+            mount,
+            unmount,
+        },
+    };
+};
+
+exports.derive = derive;
+//# sourceMappingURL=derive.js.map

package/dist/cjs/lib/derive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.js","sources":["../../../src/lib/derive.ts"],"sourcesContent":["import { deeplyEquals } from \"./deeplyEquals\";\nimport { DerivedStore, Listener, Store } from \"./types\";\n\n/**\n * Creates a derived store from an existing store.\n *\n * A derived store computes its state based on the original store's state using a derive function.\n * The derived store's value is memoized and only recomputed when requested.\n *\n * @param store - The original store to derive from\n * @param deriveFn - A function that computes the derived state from the original state\n * @param dependencyFn - Optional function that returns an array of dependencies. If provided, the derived state will only be recomputed when these dependencies change\n *\n * @returns A new store containing the derived state\n *\n * @see {@link https://dharma.fransek.dev/core/derive/}\n */\nexport const derive = <TState, TActions, TDerived>(\n  store: Store<TState, TActions>,\n  deriveFn: (state: TState) => TDerived,\n  dependencyFn?: (state: TState) => unknown[],\n): DerivedStore<TDerived> => {\n  let memo: TDerived | undefined;\n  let prev: unknown[] | undefined;\n  let isStale = true;\n  let unsubscribe: (() => void) | undefined;\n  const listeners = new Set<Listener<TDerived>>();\n\n  const compute = () => {\n    memo = deriveFn(store.get());\n    isStale = false;\n    return memo;\n  };\n\n  const get = () => {\n    if (!dependencyFn) {\n      if (isStale) {\n        return compute();\n      }\n\n      return memo as TDerived;\n    }\n\n    const next = dependencyFn(store.get());\n    isStale &&= !prev || !deeplyEquals(prev, next);\n\n    if (isStale) {\n      prev = next;\n      return compute();\n    }\n\n    return memo as TDerived;\n  };\n\n  const subscribe = (listener: Listener<TDerived>) => {\n    if (listeners.size === 0) {\n      mount();\n    }\n\n    listener(get());\n    listeners.add(listener);\n\n    return () => {\n      listeners.delete(listener);\n\n      if (listeners.size === 0) {\n        unmount();\n      }\n    };\n  };\n\n  const mount = () => {\n    if (!unsubscribe) {\n      unsubscribe = store.subscribe(() => {\n        isStale = true;\n        listeners.forEach((listener) => listener(get()));\n      });\n    }\n  };\n\n  const unmount = () => {\n    unsubscribe?.();\n    unsubscribe = undefined;\n  };\n\n  return {\n    get,\n    subscribe,\n    actions: {\n      mount,\n      unmount,\n    },\n  };\n};\n"],"names":["deeplyEquals"],"mappings":";;;;AAGA;;;;;;;;;;;;;AAaG;AACI,MAAM,MAAM,GAAG,CACpB,KAA8B,EAC9B,QAAqC,EACrC,YAA2C,KACjB;AAC1B,IAAA,IAAI,IAA0B;AAC9B,IAAA,IAAI,IAA2B;IAC/B,IAAI,OAAO,GAAG,IAAI;AAClB,IAAA,IAAI,WAAqC;AACzC,IAAA,MAAM,SAAS,GAAG,IAAI,GAAG,EAAsB;IAE/C,MAAM,OAAO,GAAG,MAAK;QACnB,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAC5B,OAAO,GAAG,KAAK;AACf,QAAA,OAAO,IAAI;AACb,IAAA,CAAC;IAED,MAAM,GAAG,GAAG,MAAK;QACf,IAAI,CAAC,YAAY,EAAE;YACjB,IAAI,OAAO,EAAE;gBACX,OAAO,OAAO,EAAE;YAClB;AAEA,YAAA,OAAO,IAAgB;QACzB;QAEA,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC,IAAI,IAAI,CAACA,yBAAY,CAAC,IAAI,EAAE,IAAI,CAAC;QAE9C,IAAI,OAAO,EAAE;YACX,IAAI,GAAG,IAAI;YACX,OAAO,OAAO,EAAE;QAClB;AAEA,QAAA,OAAO,IAAgB;AACzB,IAAA,CAAC;AAED,IAAA,MAAM,SAAS,GAAG,CAAC,QAA4B,KAAI;AACjD,QAAA,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE;AACxB,YAAA,KAAK,EAAE;QACT;AAEA,QAAA,QAAQ,CAAC,GAAG,EAAE,CAAC;AACf,QAAA,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;AAEvB,QAAA,OAAO,MAAK;AACV,YAAA,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC;AAE1B,YAAA,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE;AACxB,gBAAA,OAAO,EAAE;YACX;AACF,QAAA,CAAC;AACH,IAAA,CAAC;IAED,MAAM,KAAK,GAAG,MAAK;QACjB,IAAI,CAAC,WAAW,EAAE;AAChB,YAAA,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,MAAK;gBACjC,OAAO,GAAG,IAAI;AACd,gBAAA,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;AAClD,YAAA,CAAC,CAAC;QACJ;AACF,IAAA,CAAC;IAED,MAAM,OAAO,GAAG,MAAK;QACnB,WAAW,IAAI;QACf,WAAW,GAAG,SAAS;AACzB,IAAA,CAAC;IAED,OAAO;QACL,GAAG;QACH,SAAS;AACT,QAAA,OAAO,EAAE;YACP,KAAK;YACL,OAAO;AACR,SAAA;KACF;AACH;;;;"}

package/dist/cjs/lib/merge.d.ts

@@ -6,30 +6,6 @@ import { StateModifier } from "./types";
  * @param {StateModifier<T>} stateModifier - A function or object that modifies the state.
  * @returns {T} The new state object, which is a combination of the current state and the state modifier.
  *
- * @example
- * ```ts
- * import { createStore, merge, StateModifier } from "dharma-core";
- *
- * const store = createStore({
- *   initialState: {
- *     counter: {
- *       count: 0,
- *     },
- *     // ...
- *   },
- *   defineActions: ({ set }) => {
- *     const setCounter = (counter: StateModifier<{ count: number }>) =>
- *       set((state) => ({
- *         counter: merge(state.counter, counter),
- *       }));
- *
- *     return {
- *       increment: () => setCounter((state) => ({ count: state.count + 1 })),
- *       decrement: () => setCounter((state) => ({ count: state.count - 1 })),
- *       // ...
- *     };
- *   },
- * });
- * ```
+ * @see {@link https://dharma.fransek.dev/core/merge/}
  */
-export declare const merge: <T extends object>(currentState: T, stateModifier: StateModifier<T>) => T;
+export declare const merge: <T>(currentState: T, stateModifier: StateModifier<T>) => T;

package/dist/cjs/lib/merge.js

@@ -1,5 +1,7 @@
 'use strict';
 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const isObject = (value) => !!value && typeof value === "object" && !Array.isArray(value);
 /**
  * Merges the current state with a state modifier.
  *
@@ -7,37 +9,20 @@
  * @param {StateModifier<T>} stateModifier - A function or object that modifies the state.
  * @returns {T} The new state object, which is a combination of the current state and the state modifier.
  *
- * @example
- * ```ts
- * import { createStore, merge, StateModifier } from "dharma-core";
- *
- * const store = createStore({
- *   initialState: {
- *     counter: {
- *       count: 0,
- *     },
- *     // ...
- *   },
- *   defineActions: ({ set }) => {
- *     const setCounter = (counter: StateModifier<{ count: number }>) =>
- *       set((state) => ({
- *         counter: merge(state.counter, counter),
- *       }));
- *
- *     return {
- *       increment: () => setCounter((state) => ({ count: state.count + 1 })),
- *       decrement: () => setCounter((state) => ({ count: state.count - 1 })),
- *       // ...
- *     };
- *   },
- * });
- * ```
+ * @see {@link https://dharma.fransek.dev/core/merge/}
  */
 const merge = (currentState, stateModifier) => {
-    const newState = typeof stateModifier === "function"
-        ? stateModifier(currentState)
-        : stateModifier;
-    return { ...currentState, ...newState };
+    if (isObject(stateModifier)) {
+        return { ...currentState, ...stateModifier };
+    }
+    if (typeof stateModifier === "function") {
+        const modifiedState = stateModifier(currentState);
+        if (isObject(modifiedState)) {
+            return { ...currentState, ...modifiedState };
+        }
+        return modifiedState;
+    }
+    return stateModifier;
 };
 
 exports.merge = merge;

package/dist/cjs/lib/merge.js.map

@@ -1 +1 @@
-{"version":3,"file":"merge.js","sources":["../../../src/lib/merge.ts"],"sourcesContent":["import { StateModifier } from \"./types\";\n\n/**\n * Merges the current state with a state modifier.\n *\n * @param {T} currentState - The current state object.\n * @param {StateModifier<T>} stateModifier - A function or object that modifies the state.\n * @returns {T} The new state object, which is a combination of the current state and the state modifier.\n *\n * @example\n * ```ts\n * import { createStore, merge, StateModifier } from \"dharma-core\";\n *\n * const store = createStore({\n *   initialState: {\n *     counter: {\n *       count: 0,\n *     },\n *     // ...\n *   },\n *   defineActions: ({ set }) => {\n *     const setCounter = (counter: StateModifier<{ count: number }>) =>\n *       set((state) => ({\n *         counter: merge(state.counter, counter),\n *       }));\n *\n *     return {\n *       increment: () => setCounter((state) => ({ count: state.count + 1 })),\n *       decrement: () => setCounter((state) => ({ count: state.count - 1 })),\n *       // ...\n *     };\n *   },\n * });\n * ```\n */\nexport const merge = <T extends object>(\n  currentState: T,\n  stateModifier: StateModifier<T>,\n): T => {\n  const newState =\n    typeof stateModifier === \"function\"\n      ? stateModifier(currentState)\n      : stateModifier;\n  return { ...currentState, ...newState };\n};\n"],"names":[],"mappings":";;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCG;MACU,KAAK,GAAG,CACnB,YAAe,EACf,aAA+B,KAC1B;AACL,IAAA,MAAM,QAAQ,GACZ,OAAO,aAAa,KAAK;AACvB,UAAE,aAAa,CAAC,YAAY;UAC1B,aAAa;AACnB,IAAA,OAAO,EAAE,GAAG,YAAY,EAAE,GAAG,QAAQ,EAAE;AACzC;;;;"}
+{"version":3,"file":"merge.js","sources":["../../../src/lib/merge.ts"],"sourcesContent":["import { StateModifier } from \"./types\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst isObject = (value: unknown): value is Record<keyof any, unknown> =>\n  !!value && typeof value === \"object\" && !Array.isArray(value);\n\n/**\n * Merges the current state with a state modifier.\n *\n * @param {T} currentState - The current state object.\n * @param {StateModifier<T>} stateModifier - A function or object that modifies the state.\n * @returns {T} The new state object, which is a combination of the current state and the state modifier.\n *\n * @see {@link https://dharma.fransek.dev/core/merge/}\n */\nexport const merge = <T>(\n  currentState: T,\n  stateModifier: StateModifier<T>,\n): T => {\n  if (isObject(stateModifier)) {\n    return { ...currentState, ...stateModifier };\n  }\n\n  if (typeof stateModifier === \"function\") {\n    const modifiedState = stateModifier(currentState);\n\n    if (isObject(modifiedState)) {\n      return { ...currentState, ...modifiedState };\n    }\n\n    return modifiedState;\n  }\n\n  return stateModifier;\n};\n"],"names":[],"mappings":";;AAEA;AACA,MAAM,QAAQ,GAAG,CAAC,KAAc,KAC9B,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;AAE/D;;;;;;;;AAQG;MACU,KAAK,GAAG,CACnB,YAAe,EACf,aAA+B,KAC1B;AACL,IAAA,IAAI,QAAQ,CAAC,aAAa,CAAC,EAAE;AAC3B,QAAA,OAAO,EAAE,GAAG,YAAY,EAAE,GAAG,aAAa,EAAE;IAC9C;AAEA,IAAA,IAAI,OAAO,aAAa,KAAK,UAAU,EAAE;AACvC,QAAA,MAAM,aAAa,GAAG,aAAa,CAAC,YAAY,CAAC;AAEjD,QAAA,IAAI,QAAQ,CAAC,aAAa,CAAC,EAAE;AAC3B,YAAA,OAAO,EAAE,GAAG,YAAY,EAAE,GAAG,aAAa,EAAE;QAC9C;AAEA,QAAA,OAAO,aAAa;IACtB;AAEA,IAAA,OAAO,aAAa;AACtB;;;;"}

package/dist/cjs/lib/types.d.ts

@@ -1,18 +1,21 @@
-export type Listener<TState extends object> = (state: TState) => void;
-export type SetState<TState extends object> = (stateModifier: StateModifier<TState>) => TState;
-export type Store<TState extends object, TActions extends object> = {
+export type Listener<TState> = (state: TState) => void;
+export type SetState<TState> = (stateModifier: StateModifier<TState>) => TState;
+export type Store<TState, TActions> = {
     /** Returns the current state of the store. */
     get: () => TState;
-    /** Sets the state of the store. */
-    set: SetState<TState>;
-    /** Resets the state of the store to its initial value. */
-    reset: () => TState;
     /** Actions that can modify the state of the store. */
     actions: TActions;
     /** Subscribes to changes in the state of the store. Returns an unsubscribe function. */
     subscribe: (listener: Listener<TState>) => () => void;
 };
-export type StoreEventContext<TState extends object> = {
+export type DerivedStoreActions = {
+    /** Start listening to changes in the original store. Called automatically on the first subscription. */
+    mount: () => void;
+    /** Stop listening to changes in the original store. Called automatically when there are no more subscribers. */
+    unmount: () => void;
+};
+export type DerivedStore<TState> = Store<TState, DerivedStoreActions>;
+export type StoreEventContext<TState> = {
     /** The current state of the store. */
     state: TState;
     /** Sets the state of the store. */
@@ -20,9 +23,9 @@ export type StoreEventContext<TState extends object> = {
     /** Resets the state of the store to its initial value. */
     reset: () => TState;
 };
-export type StoreEventListener<TState extends object> = (context: StoreEventContext<TState>) => void;
-export type StateModifier<TState extends object> = Partial<TState> | ((state: TState) => Partial<TState>);
-export type StateHandler<TState extends object> = {
+export type StoreEventListener<TState> = (context: StoreEventContext<TState>) => void;
+export type StateModifier<TState> = Partial<TState> | ((state: TState) => Partial<TState>);
+export type StateHandler<TState> = {
     /** Returns the current state of the store. */
     get: () => TState;
     /** Sets the state of the store. */
@@ -30,8 +33,8 @@ export type StateHandler<TState extends object> = {
     /** Resets the state of the store to its initial value. */
     reset: () => TState;
 };
-export type DefineActions<TState extends object, TActions> = (stateHandler: StateHandler<TState>) => TActions;
-export type BaseConfig<TState extends object, TActions extends object> = {
+export type DefineActions<TState, TActions> = (stateHandler: StateHandler<TState>) => TActions;
+export type BaseConfig<TState, TActions> = {
     /** The initial state of the store. */
     initialState: TState;
     /** A function that defines actions that can modify the state. */
@@ -59,7 +62,7 @@ export type NoPersistConfig = {
     /** Whether to persist the state of the store. */
     persist?: false;
 };
-export type PersistConfig<TState extends object> = {
+export type PersistConfig<TState> = {
     /** Whether to persist the state of the store. */
     persist: true;
     /** The unique key used to identify this store in storage. Required if `persist` is true. */
@@ -69,4 +72,4 @@ export type PersistConfig<TState extends object> = {
     /** The serializer to use for storing the state. Defaults to JSON. */
     serializer?: Serializer<TState>;
 };
-export type StoreConfig<TState extends object, TActions extends object> = BaseConfig<TState, TActions> & (PersistConfig<TState> | NoPersistConfig);
+export type StoreConfig<TState, TActions> = BaseConfig<TState, TActions> & (PersistConfig<TState> | NoPersistConfig);

package/dist/esm/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./lib/createStore";
+export * from "./lib/derive";
 export * from "./lib/merge";
 export * from "./lib/types";

package/dist/esm/index.js

@@ -1,3 +1,4 @@
 export { createStore } from './lib/createStore.js';
+export { derive } from './lib/derive.js';
 export { merge } from './lib/merge.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/lib/createStorageAdapter.d.ts

@@ -1,5 +1,5 @@
 import { SetState, StoreConfig } from "./types";
-export declare const createStorageAdapter: <TState extends object, TActions extends object = Record<never, never>>(config: StoreConfig<TState, TActions>, get: () => TState, set: SetState<TState>) => {
+export declare const createStorageAdapter: <TState, TActions>(config: StoreConfig<TState, TActions>, get: () => TState, set: SetState<TState>) => {
     onLoad: () => Promise<void>;
     onChange: (newState: TState) => Promise<void>;
     onAttach: () => void;