atomaric 0.0.4 → 0.0.6

package/README.md

@@ -1,19 +1,29 @@
-## 🕹️Installation and usage
+## 🕹️Installation
 
 ```sh
 npm install atomaric
 ```
 
-### usage
+## usage
 
-```ts
-import { atom, useAtomValue } from 'atomaric';
+```tsx
+import { atom, useAtom, configureAtomaric } from 'atomaric';
+import { useSyncExternalStore } from 'react';
 
-const nameAtom = atom('World');
+configureAtomaric({ useSyncExternalStore }); // do this before all
+
+const nameAtom = atom(
+  'World',
+  'greats:name', // optional localStorage key
+);
 
 function App() {
-  const [name, setIsOpen] = useAtomValue(nameAtom);
+  const [name, setIsOpen] = useAtom(nameAtom);
 
-  return <div onClick={() => setIsOpen(isOpen => (name === 'World' ? 'Man' : 'World'))}>Hello, {name}</div>;
+  return (
+    <div onClick={() => setIsOpen(isOpen => (name === 'World' ? 'Man' : 'World'))}>
+      Hello <span className="color-accent">{name}</span>
+    </div>
+  );
 }
 ```

package/build/atomaric.js

@@ -1,32 +1,36 @@
-const u = {};
+const h = {};
 window.addEventListener("storage", (e) => {
-  e.key === null || u[e.key] === void 0 || u[e.key](e);
+  e.key === null || h[e.key] === void 0 || h[e.key](e);
 });
-class g {
-  constructor(s, i) {
+class f {
+  constructor(s, r) {
     if (this._defaultValue = s, this.subscribers = /* @__PURE__ */ new Set(), this.save = () => {
     }, this.invokeSubscriber = (t) => t(this.value), this.get = () => this.value, this.toggle = () => this.set(!this.value), this.inkrement = (t) => this.set(this.value + t), this.subscribe = (t) => (this.subscribers.add(t), () => {
       this.subscribers.delete(t);
-    }), this.set = (t, l) => {
-      const o = typeof t == "function" ? t(this.value) : t;
-      o === this.value || o === void 0 || typeof o == "number" && isNaN(o) || (this.value = o, this.subscribers.forEach(this.invokeSubscriber, this), l !== !0 && this.save(o));
+    }), this.set = (t, u) => {
+      const i = typeof t == "function" ? t(this.value) : t;
+      i === this.value || i === void 0 || typeof i == "number" && isNaN(i) || (this.value = i, this.subscribers.forEach(this.invokeSubscriber, this), u !== !0 && this.save(i));
+    }, this.setDeferred = (t, u = 500, i, b = !0) => {
+      b && this.debounceTimeout === void 0 && this.set(t, i), clearTimeout(this.debounceTimeout), this.debounceTimeout = setTimeout(() => {
+        this.set(t, i), delete this.debounceTimeout;
+      }, u);
     }, this.value = s, typeof s != "boolean" && (this.toggle = () => {
     }), typeof s != "number" && (this.inkrement = () => {
     }), this.reset = () => {
       this.set(s, !0), this.subscribers.forEach(this.invokeSubscriber, this);
-    }, i == null) return;
-    let n = null, a = !0, h = !0;
-    if (typeof i == "string" ? n = i : i.storeKey !== void 0 && (a = i.warnOnDuplicateStoreKey ?? !0, h = i.listenStorageChanges ?? !0, n = i.storeKey), n === null) return;
-    const r = `atom/${n}`;
-    this.value = r in localStorage ? JSON.parse(localStorage[r]) : s, this.save = (t) => {
+    }, r == null) return;
+    let n = null, c = !0, l = !0;
+    if (typeof r == "string" ? n = r : r.storeKey !== void 0 && (c = r.warnOnDuplicateStoreKey ?? !0, l = r.listenStorageChanges ?? !0, n = r.storeKey), n === null) return;
+    const o = `atom/${n}`;
+    this.value = o in localStorage ? JSON.parse(localStorage[o]) : s, this.save = (t) => {
       if (t === s) {
         this.reset();
         return;
       }
-      localStorage[r] = JSON.stringify(t);
+      localStorage[o] = JSON.stringify(t);
     }, this.reset = () => {
-      delete localStorage[r], this.set(s, !0);
-    }, a && u[r] !== void 0 && console.warn("Duplicate Atom key", i), h && (u[r] = (t) => {
+      delete localStorage[o], this.set(s, !0);
+    }, c && h[o] !== void 0 && console.warn("Duplicate Atom key", r), l && (h[o] = (t) => {
       if (t.newValue === null) {
         this.reset();
         return;
@@ -42,18 +46,19 @@ class g {
     return this._defaultValue;
   }
 }
-let c = () => {
-  throw "you meed pass react useSyncExternalStore hook func in registerReactHooks() before all actions";
+let a = () => {
+  throw "call configureAtomaric() before all!";
 };
-const f = (e) => c = e.useSyncExternalStore, b = (e) => c(e.subscribe, e.get), S = (e) => e.set, k = (e) => e.get, m = (e) => e.toggle, v = (e) => e.inkrement, y = (e) => [b(e), S(e)], w = (e, s) => new g(e, s);
+const S = (e) => a = e.useSyncExternalStore, g = (e) => a(e.subscribe, e.get), m = (e) => e.set, d = (e) => e.setDeferred, v = (e) => e.get, k = (e) => e.toggle, w = (e) => e.inkrement, y = (e) => [g(e), m(e)], A = (e, s) => new f(e, s);
 export {
-  g as Atom,
-  w as atom,
-  f as registerReactHooks,
+  f as Atom,
+  A as atom,
+  S as configureAtomaric,
   y as useAtom,
-  k as useAtomGet,
-  v as useAtomInkrement,
-  S as useAtomSet,
-  m as useAtomToggle,
-  b as useAtomValue
+  v as useAtomGet,
+  w as useAtomInkrement,
+  m as useAtomSet,
+  d as useAtomSetDeferred,
+  k as useAtomToggle,
+  g as useAtomValue
 };

package/build/atomaric.umd.cjs

@@ -1 +1 @@
-(function(s,n){typeof exports=="object"&&typeof module<"u"?n(exports):typeof define=="function"&&define.amd?define(["exports"],n):(s=typeof globalThis<"u"?globalThis:s||self,n(s.atomaric={}))})(this,function(s){"use strict";const n={};window.addEventListener("storage",e=>{e.key===null||n[e.key]===void 0||n[e.key](e)});class a{constructor(i,o){if(this._defaultValue=i,this.subscribers=new Set,this.save=()=>{},this.invokeSubscriber=t=>t(this.value),this.get=()=>this.value,this.toggle=()=>this.set(!this.value),this.inkrement=t=>this.set(this.value+t),this.subscribe=t=>(this.subscribers.add(t),()=>{this.subscribers.delete(t)}),this.set=(t,b)=>{const u=typeof t=="function"?t(this.value):t;u===this.value||u===void 0||typeof u=="number"&&isNaN(u)||(this.value=u,this.subscribers.forEach(this.invokeSubscriber,this),b!==!0&&this.save(u))},this.value=i,typeof i!="boolean"&&(this.toggle=()=>{}),typeof i!="number"&&(this.inkrement=()=>{}),this.reset=()=>{this.set(i,!0),this.subscribers.forEach(this.invokeSubscriber,this)},o==null)return;let l=null,g=!0,m=!0;if(typeof o=="string"?l=o:o.storeKey!==void 0&&(g=o.warnOnDuplicateStoreKey??!0,m=o.listenStorageChanges??!0,l=o.storeKey),l===null)return;const r=`atom/${l}`;this.value=r in localStorage?JSON.parse(localStorage[r]):i,this.save=t=>{if(t===i){this.reset();return}localStorage[r]=JSON.stringify(t)},this.reset=()=>{delete localStorage[r],this.set(i,!0)},g&&n[r]!==void 0&&console.warn("Duplicate Atom key",o),m&&(n[r]=t=>{if(t.newValue===null){this.reset();return}try{this.set(JSON.parse(t.newValue))}catch{console.warn("Invalid json value",t.newValue)}})}get defaultValue(){return this._defaultValue}}let c=()=>{throw"you meed pass react useSyncExternalStore hook func in registerReactHooks() before all actions"};const S=e=>c=e.useSyncExternalStore,h=e=>c(e.subscribe,e.get),f=e=>e.set,d=e=>e.get,y=e=>e.toggle,k=e=>e.inkrement,v=e=>[h(e),f(e)],A=(e,i)=>new a(e,i);s.Atom=a,s.atom=A,s.registerReactHooks=S,s.useAtom=v,s.useAtomGet=d,s.useAtomInkrement=k,s.useAtomSet=f,s.useAtomToggle=y,s.useAtomValue=h,Object.defineProperty(s,Symbol.toStringTag,{value:"Module"})});
+(function(s,r){typeof exports=="object"&&typeof module<"u"?r(exports):typeof define=="function"&&define.amd?define(["exports"],r):(s=typeof globalThis<"u"?globalThis:s||self,r(s.atomaric={}))})(this,function(s){"use strict";const r={};window.addEventListener("storage",e=>{e.key===null||r[e.key]===void 0||r[e.key](e)});class l{constructor(i,n){if(this._defaultValue=i,this.subscribers=new Set,this.save=()=>{},this.invokeSubscriber=t=>t(this.value),this.get=()=>this.value,this.toggle=()=>this.set(!this.value),this.inkrement=t=>this.set(this.value+t),this.subscribe=t=>(this.subscribers.add(t),()=>{this.subscribers.delete(t)}),this.set=(t,h)=>{const o=typeof t=="function"?t(this.value):t;o===this.value||o===void 0||typeof o=="number"&&isNaN(o)||(this.value=o,this.subscribers.forEach(this.invokeSubscriber,this),h!==!0&&this.save(o))},this.setDeferred=(t,h=500,o,T=!0)=>{T&&this.debounceTimeout===void 0&&this.set(t,o),clearTimeout(this.debounceTimeout),this.debounceTimeout=setTimeout(()=>{this.set(t,o),delete this.debounceTimeout},h)},this.value=i,typeof i!="boolean"&&(this.toggle=()=>{}),typeof i!="number"&&(this.inkrement=()=>{}),this.reset=()=>{this.set(i,!0),this.subscribers.forEach(this.invokeSubscriber,this)},n==null)return;let c=null,b=!0,d=!0;if(typeof n=="string"?c=n:n.storeKey!==void 0&&(b=n.warnOnDuplicateStoreKey??!0,d=n.listenStorageChanges??!0,c=n.storeKey),c===null)return;const u=`atom/${c}`;this.value=u in localStorage?JSON.parse(localStorage[u]):i,this.save=t=>{if(t===i){this.reset();return}localStorage[u]=JSON.stringify(t)},this.reset=()=>{delete localStorage[u],this.set(i,!0)},b&&r[u]!==void 0&&console.warn("Duplicate Atom key",n),d&&(r[u]=t=>{if(t.newValue===null){this.reset();return}try{this.set(JSON.parse(t.newValue))}catch{console.warn("Invalid json value",t.newValue)}})}get defaultValue(){return this._defaultValue}}let a=()=>{throw"call configureAtomaric() before all!"};const g=e=>a=e.useSyncExternalStore,f=e=>a(e.subscribe,e.get),m=e=>e.set,S=e=>e.setDeferred,A=e=>e.get,y=e=>e.toggle,v=e=>e.inkrement,k=e=>[f(e),m(e)],w=(e,i)=>new l(e,i);s.Atom=l,s.atom=w,s.configureAtomaric=g,s.useAtom=k,s.useAtomGet=A,s.useAtomInkrement=v,s.useAtomSet=m,s.useAtomSetDeferred=S,s.useAtomToggle=y,s.useAtomValue=f,Object.defineProperty(s,Symbol.toStringTag,{value:"Module"})});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "atomaric",
   "description": "Manage your project state",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "type": "module",
   "main": "./build/atomaric.umd.cjs",
   "module": "./build/atomaric.js",

package/types/model.d.ts

@@ -10,20 +10,32 @@ export type AtomOptions = {
   listenStorageChanges?: boolean;
 };
 
+export type AtomSetMethod<Value> = (value: Value | ((prev: Value) => Value), isPreventSave?: boolean) => void;
+export type AtomSetDeferredMethod<Value> = (
+  value: Value | ((prev: Value) => Value),
+  debounceMs?: number,
+  isPreventSave?: boolean,
+  isInitInvoke?: boolean,
+) => void;
+
+export type AtomSubscribeMethod<Value> = (subscriber: Sunscriber<Value>) => () => void;
+
 export class Atom<Value> {
   constructor(defaultValue: Value, storeKeyOrOptions: AtomStoreKey | undefined | AtomOptions);
 
   readonly defaultValue: Value;
   readonly get: () => Value;
+  readonly set: AtomSetMethod<Value>;
+  readonly setDeferred: AtomSetDeferredMethod<Value>;
   readonly reset: () => void;
   readonly toggle: () => void;
   readonly inkrement: (delta: number) => void;
-  readonly subscribe: (sub: Sunscriber<Value>) => () => void;
-  readonly set: (value: Value | ((prev: Value) => Value), isPreventSave?: boolean) => void;
+  readonly subscribe: AtomSubscribeMethod<Value>;
 }
 
 export function useAtomValue<Value>(atom: Atom<Value>): Value;
 export function useAtomSet<Value>(atom: Atom<Value>): (typeof atom)['set'];
+export function useAtomSetDeferred<Value>(atom: Atom<Value>): (typeof atom)['setDeferred'];
 export function useAtomGet<Value>(atom: Atom<Value>): (typeof atom)['get'];
 export function useAtomToggle(atom: Atom<boolean>): (typeof atom)['toggle'];
 export function useAtomInkrement(atom: Atom<number>): (typeof atom)['inkrement'];
@@ -35,4 +47,4 @@ export function atom<Value>(
   storeKeyOrOptions?: `${string}${string}:${string}${string}` | AtomOptions,
 ): Atom<Value>;
 
-export function registerReactHooks(hooks: { useSyncExternalStore: typeof useSyncExternalStore }): void;
+export function configureAtomaric(hooks: { useSyncExternalStore: typeof useSyncExternalStore }): void;