@codeleap/store 6.8.0 → 7.0.1

package/dist/array.js

@@ -0,0 +1,30 @@
+/**
+ * Returns a `Proxy` that mirrors every property access on the atom's current array value.
+ *
+ * When a function property (e.g. `push`, `splice`, `sort`) is accessed, the proxy wraps the call so that after the native method executes it writes the mutated array back to the store with `store.set`.
+ * This makes mutating array methods reactive: callers interact with a familiar `Array` API while nanostores' subscriber notifications fire automatically.
+ *
+ * Non-function properties (indices, `length`, etc.) are forwarded as-is.
+ */
+export function arrayHandler(store) {
+    return new Proxy([], {
+        get(target, p, receiver) {
+            const val = store.get();
+            const property = val[p];
+            if (typeof property == 'function') {
+                return (...args) => {
+                    const r = val[p](...args);
+                    store.set(val);
+                    return r;
+                };
+            }
+            return property;
+        }
+    });
+}
+/**
+ * Complete list of own property names on `Array.prototype`.
+ * Used by the `globalState` proxy to detect when a caller is accessing an array method so it can delegate to `arrayHandler` instead of the raw atom.
+ */
+export const arrayOps = Object.getOwnPropertyNames(Array.prototype);
+//# sourceMappingURL=array.js.map

package/dist/array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.js","sourceRoot":"","sources":["../src/array.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAkB,KAAsB;IAClE,OAAO,IAAI,KAAK,CAAC,EAAE,EAAE;QACnB,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ;YACrB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,EAAkC,CAAA;YAEvD,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,CAAA;YAEvB,IAAG,OAAO,QAAQ,IAAI,UAAU,EAAE,CAAC;gBACjC,OAAO,CAAC,GAAG,IAAe,EAAE,EAAE;oBAC5B,MAAM,CAAC,GAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;oBAE1B,KAAK,CAAC,GAAG,CAAC,GAAQ,CAAC,CAAA;oBAEnB,OAAO,CAAC,CAAA;gBACV,CAAC,CAAA;YACH,CAAC;YAED,OAAO,QAAQ,CAAA;QACjB,CAAC;KACF,CAAC,CAAA;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA"}

package/dist/globalState.js

@@ -0,0 +1,71 @@
+import { useStore } from '@nanostores/react';
+import { setPersistentEngine, persistentAtom } from '@nanostores/persistent';
+import { atom } from 'nanostores';
+import { stateAssign, useStateSelector } from './utils';
+import { arrayHandler, arrayOps } from './array';
+const defaultConfig = {
+    persistKey: undefined,
+};
+/**
+ * Registers the storage engine used by all persistent atoms in this process.
+ * Must be called once at app startup — before any `globalState` with a `persistKey` is created — otherwise the persistent atom falls back to an in-memory store.
+ * Thin re-export of `@nanostores/persistent`'s `setPersistentEngine`.
+ */
+export const setGlobalStatePersistor = setPersistentEngine;
+/**
+ * Creates a `GlobalState<T>` atom backed by nanostores.
+ *
+ * The returned value is a `Proxy` over the raw atom that intercepts property access to:
+ * - Route `use` / `get` through optional selector functions so components subscribe only to the slice they need.
+ * - Merge partial updates on `set` for object atoms (primitives and arrays are replaced outright).
+ * - Expose `reset` as an alias for the raw `WritableAtom.set`, bypassing merge logic.
+ * - Forward any `Array.prototype` property access to `arrayHandler`, which commits mutations back to the store.
+ *
+ * When `config.persistKey` is provided, the atom is created with `persistentAtom` and serialised via `JSON.stringify` / `JSON.parse`.
+ * Call `setGlobalStatePersistor` before using persistence so the engine is ready.
+ */
+export function globalState(value, config = defaultConfig) {
+    const { persistKey } = config;
+    const isPersistState = typeof persistKey === 'string';
+    const store = isPersistState ? persistentAtom(persistKey, value, {
+        encode: JSON.stringify,
+        decode: JSON.parse,
+    }) : atom(value);
+    return new Proxy(store, {
+        get(target, prop, receiver) {
+            if (prop === 'use') {
+                return (selector) => {
+                    if (!selector)
+                        return useStore(target);
+                    return useStateSelector(target, selector);
+                };
+            }
+            if (prop === 'get') {
+                return (selector) => {
+                    if (!selector)
+                        return target.get();
+                    return selector(target.get());
+                };
+            }
+            if (prop === 'set') {
+                return (newValue) => {
+                    const value = stateAssign(newValue, target.get());
+                    target.set(value);
+                };
+            }
+            if (prop == 'reset') {
+                return Reflect.get(target, 'set', receiver);
+            }
+            if (arrayOps.includes(prop)) {
+                const currentValue = target.get();
+                if (!Array.isArray(currentValue)) {
+                    throw new Error('Cannot call array methods on a non array store');
+                }
+                const handle = arrayHandler(target);
+                return Reflect.get(handle, prop, receiver);
+            }
+            return Reflect.get(target, prop, receiver);
+        },
+    });
+}
+//# sourceMappingURL=globalState.js.map

package/dist/globalState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalState.js","sourceRoot":"","sources":["../src/globalState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAC5E,OAAO,EAAE,IAAI,EAAgB,MAAM,YAAY,CAAA;AAE/C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AACvD,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEhD,MAAM,aAAa,GAAsB;IACvC,UAAU,EAAE,SAAS;CACtB,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,mBAAmB,CAAA;AAE1D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAI,KAAQ,EAAE,SAA4B,aAAa;IAChF,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAA;IAE7B,MAAM,cAAc,GAAG,OAAO,UAAU,KAAK,QAAQ,CAAA;IAErD,MAAM,KAAK,GAAG,cAAc,CAAC,CAAC,CAAC,cAAc,CAAI,UAAU,EAAE,KAAK,EAAE;QAClE,MAAM,EAAE,IAAI,CAAC,SAAS;QACtB,MAAM,EAAE,IAAI,CAAC,KAAK;KACnB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAEhB,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE;QACtB,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ;YACxB,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;gBACnB,OAAO,CAAC,QAAgC,EAAE,EAAE;oBAC1C,IAAI,CAAC,QAAQ;wBAAE,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAA;oBACtC,OAAO,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;gBAC3C,CAAC,CAAA;YACH,CAAC;YAED,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;gBACnB,OAAO,CAAC,QAAgC,EAAE,EAAE;oBAC1C,IAAI,CAAC,QAAQ;wBAAE,OAAO,MAAM,CAAC,GAAG,EAAE,CAAA;oBAClC,OAAO,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAA;gBAC/B,CAAC,CAAA;YACH,CAAC;YAED,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;gBACnB,OAAO,CAAC,QAAiC,EAAE,EAAE;oBAC3C,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAA;oBACjD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;gBACnB,CAAC,CAAA;YACH,CAAC;YAED,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC;gBACpB,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAA;YAC7C,CAAC;YAED,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAc,CAAC,EAAE,CAAC;gBACtC,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,EAAE,CAAA;gBAEjC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;oBACjC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;gBACnE,CAAC;gBAED,MAAM,MAAM,GAAG,YAAY,CAAC,MAA6B,CAAC,CAAA;gBAE1D,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;YAC5C,CAAC;YAED,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;QAC5C,CAAC;KACF,CAA8B,CAAA;AACjC,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from './globalState';
+export * from './types';
+export * from './utils';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.js

@@ -0,0 +1,67 @@
+import { useStore } from '@nanostores/react';
+import { useMemo } from 'react';
+/** Type guard that distinguishes a functional setter from a plain value so `resolveSetter` can call it correctly. */
+function isFunctionSetter(x) {
+    return typeof x === 'function';
+}
+/** Evaluates a `StateSetter`: calls it with `currentValue` if it is a function, otherwise returns it as-is. */
+function resolveSetter(setter, currentValue) {
+    if (isFunctionSetter(setter)) {
+        return setter(currentValue);
+    }
+    return setter;
+}
+/**
+ * Resolves `newValue` against `stateValue` and returns the next state.
+ *
+ * For object atoms the resolved value is shallow-merged onto the existing state, so callers only need to supply changed keys.
+ * For primitives and arrays the resolved value replaces the current state entirely.
+ */
+export function stateAssign(newValue, stateValue) {
+    const resolvedValue = resolveSetter(newValue, stateValue);
+    if (typeof stateValue === 'object' && stateValue !== null) {
+        return Object.assign(Object.assign({}, stateValue), resolvedValue);
+    }
+    return resolvedValue;
+}
+/**
+ * Derives a virtual `WritableAtom<R>` that projects a slice of a parent atom through `selector`.
+ *
+ * - `get` — applies `selector` to the parent snapshot without subscribing.
+ * - `listen` — subscribes to the parent atom and calls `listener` with the projected value on every change.
+ * - `set` — requires a `deselector` to map the slice value back to a `Partial<T>`, then merges it into the parent atom via `stateAssign`. Throws if `deselector` is absent.
+ *
+ * The returned object satisfies the `WritableAtom<R>` interface so it can be passed anywhere a nanostores atom is expected, including `useStore`.
+ */
+export const createStateSlice = (store, selector, deselector) => ({
+    get: () => selector(store.get()),
+    listen: (listener) => {
+        return store.listen((state) => {
+            listener(selector(state));
+        });
+    },
+    set(v) {
+        if (!deselector) {
+            throw new Error('[createStateSelector] deselector must be implemented to call set on state slices');
+        }
+        const parsed = deselector(v);
+        const newValue = stateAssign(parsed, store.get());
+        store.set(newValue);
+    },
+    get value() {
+        return store.value;
+    }
+});
+/**
+ * React hook that subscribes a component to a derived slice of an atom.
+ *
+ * Internally it memoises a `createStateSlice` projection keyed on `selector` identity, then passes the virtual atom to `useStore`.
+ * Components re-render only when the selected value changes — not on every atom update — which avoids the cost of subscribing to the full atom shape.
+ *
+ * Caution: because the slice is memoised on `selector` reference, prefer stable (module-level or `useCallback`) selector functions to avoid unnecessary slice recreation.
+ */
+export function useStateSelector(store, selector) {
+    const slice = useMemo(() => createStateSlice(store, selector), [selector]);
+    return useStore(slice);
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAE5C,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAG/B,qHAAqH;AACrH,SAAS,gBAAgB,CAAI,CAAM;IACjC,OAAO,OAAO,CAAC,KAAK,UAAU,CAAA;AAChC,CAAC;AAED,+GAA+G;AAC/G,SAAS,aAAa,CAAI,MAAsB,EAAE,YAAc;IAC9D,IAAI,gBAAgB,CAAI,MAAM,CAAC,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,YAAY,CAAC,CAAA;IAC7B,CAAC;IAED,OAAO,MAAW,CAAA;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAI,QAAiC,EAAE,UAAa;IAC7E,MAAM,aAAa,GAAG,aAAa,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;IACzD,IACE,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,IAAI,EACrD,CAAC;QACD,OAAO,gCACF,UAAU,GACV,aAAa,CACZ,CAAA;IACR,CAAC;IAED,OAAO,aAAkB,CAAA;AAC3B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,KAAQ,EACR,QAAyB,EACzB,UAAsC,EACtC,EAAE,CAAC,CAAC;IACF,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IAChC,MAAM,EAAE,CAAC,QAA4B,EAAE,EAAE;QACvC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YAC5B,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;QAC3B,CAAC,CAAC,CAAA;IACJ,CAAC;IACD,GAAG,CAAC,CAAI;QACN,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAA;QACrG,CAAC;QAED,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;QAE5B,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAA;QAEjD,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACrB,CAAC;IACD,IAAI,KAAK;QACP,OAAO,KAAK,CAAC,KAAK,CAAA;IACpB,CAAC;CACkB,CAAA,CAAA;AAEvB;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAQ,EACR,QAAyB;IAEzB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;IAE1E,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAA;AACxB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@codeleap/store",
-  "version": "6.8.0",
-  "main": "src/index.ts",
+  "version": "7.0.1",
+  "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
@@ -22,7 +22,7 @@
     "directory": "packages/store"
   },
   "devDependencies": {
-    "@codeleap/config": "6.8.0",
+    "@codeleap/config": "7.0.1",
     "ts-node-dev": "1.1.8"
   },
   "scripts": {