atomaric 0.0.24 → 0.0.25

package/build/atomaric.js

@@ -1,140 +1,140 @@
-const x = (t, e, i) => {
-  let l = null;
-  typeof t == "number" ? l = y(
+const x = (t, e, c) => {
+  let u = null;
+  typeof t == "number" ? u = y(
     {
-      increment: (s) => {
-        e.set(+e.get() + (s ?? 0));
+      increment: (n) => {
+        e.set(+e.get() + (n ?? 0));
       }
     }
-  ) : typeof t == "boolean" ? l = y(
+  ) : typeof t == "boolean" ? u = y(
     {
       toggle: () => {
         e.set(!e.get());
       }
     }
-  ) : Array.isArray(t) ? l = y(
+  ) : Array.isArray(t) ? u = y(
     {
-      push: (...s) => {
-        e.set(e.get().concat(s));
+      push: (...n) => {
+        e.set(e.get().concat(n));
       },
-      unshift: (...s) => {
-        e.set(s.concat(e.get()));
+      unshift: (...n) => {
+        e.set(n.concat(e.get()));
       },
-      update: (s) => {
+      update: (n) => {
         const r = e.get().slice();
-        s(r), e.set(r);
+        n(r), e.set(r);
       },
-      filter: (s) => {
-        e.set(e.get().filter(s ?? J));
+      filter: (n) => {
+        e.set(e.get().filter(n ?? J));
       }
     }
-  ) : t instanceof Set ? l = y(
+  ) : t instanceof Set ? u = y(
     {
-      add: (s) => {
-        e.set(new Set(e.get()).add(s));
+      add: (n) => {
+        e.set(new Set(e.get()).add(n));
       },
-      delete: (s) => {
+      delete: (n) => {
         const r = new Set(e.get());
-        r.delete(s), e.set(r);
+        r.delete(n), e.set(r);
       },
       clear: () => {
         e.set(/* @__PURE__ */ new Set());
       },
-      update: (s) => {
+      update: (n) => {
         const r = new Set(e.get());
-        s(r), e.set(r);
+        n(r), e.set(r);
       }
     }
-  ) : t instanceof Object && (l = y(
+  ) : t instanceof Object && (u = y(
     {
-      setPartial: (s) => e.set((r) => ({
+      setPartial: (n) => e.set((r) => ({
         ...r,
-        ...typeof s == "function" ? s(e.get()) : s
+        ...typeof n == "function" ? n(e.get()) : n
       }))
     }
   ));
-  const a = typeof i == "object" && i != null && "do" in i ? i.do(
-    (s, r) => e.set(s, r),
+  const f = typeof c == "object" && c != null && "do" in c ? c.do(
+    (n, r) => e.set(n, r),
     () => e.get(),
     void 0,
-    (s, r, g) => e.setDeferred(s, r, g)
+    (n, r, g) => e.setDeferred(n, r, g)
   ) : null, d = {};
-  return a && Object.keys(a).forEach((s) => Object.defineProperty(d, s, { get: () => a[s] })), l && Object.keys(l).forEach(
-    (s) => Object.defineProperty(d, s, { get: () => l[s] })
+  return f && Object.keys(f).forEach((n) => Object.defineProperty(d, n, { get: () => f[n] })), u && Object.keys(u).forEach(
+    (n) => Object.defineProperty(d, n, { get: () => u[n] })
   ), d;
 }, J = (t) => t, y = (t, e) => t;
 class F {
-  constructor(e, i) {
-    const l = (n) => r = n, a = () => r, d = /* @__PURE__ */ new Set(), s = (n) => n(h());
+  constructor(e, c) {
+    const u = (s) => r = s, f = () => r, d = /* @__PURE__ */ new Set(), n = (s) => s(h());
     let r = e, g, v = () => {
-    }, h = () => a(), C = () => {
-      const n = x(e, this, i);
-      return C = () => n, n;
+    }, h = () => f(), C = () => {
+      const s = x(e, this, c);
+      return C = () => s, s;
     };
     const I = new Proxy(this, {
-      get: (n, o) => o === "do" ? C() : n[o],
+      get: (s, l) => l === "do" ? C() : s[l],
       set: P
-    }), S = (n, o) => {
-      const f = typeof n == "function" ? n(h()) : n;
-      if (!(f === h() || f === void 0 || typeof f == "number" && isNaN(f))) {
-        l(f), d.forEach(s, this);
+    }), S = (s, l) => {
+      const a = typeof s == "function" ? s(h()) : s;
+      if (!(a === h() || a === void 0 || typeof a == "number" && isNaN(a))) {
+        u(a), d.forEach(n, this);
         try {
-          E.postMessage({ key: u, value: a() });
+          E.postMessage({ key: i, value: f() });
         } catch {
         }
-        o !== !0 && v(f);
+        l !== !0 && v(a);
       }
     };
-    if (this.set = (n, o) => S(n, o), this.get = () => h(), this.defaultValue = e, this.subscribe = (n) => (d.add(n), () => {
-      d.delete(n);
+    if (this.set = (s, l) => S(s, l), this.get = () => h(), this.initialValue = e, this.isInitialValue = () => e === f(), this.subscribe = (s) => (d.add(s), () => {
+      d.delete(s);
     }), this.reset = () => {
-      S(e, !0), d.forEach(s, this);
-    }, this.setDeferred = (n, o = 500, f, T = !0) => {
-      T && g === void 0 && S(n, f), clearTimeout(g), g = setTimeout(() => {
-        S(n, f), g = void 0;
-      }, o);
-    }, i == null) return I;
-    let b = null, m = !0, D = !0, j = !1, A = e instanceof Set ? (n) => new Set(JSON.parse(n)) : (n) => JSON.parse(n), _ = e instanceof Set ? (n) => {
-      if (n instanceof Set) return JSON.stringify(Array.from(n));
-      throw console.error(n), "The value is not Set instance";
-    } : (n) => JSON.stringify(n);
-    if (typeof i == "string" ? b = i : "storeKey" in i && (m = i.warnOnDuplicateStoreKey ?? m, D = i.listenStorageChanges ?? D, b = i.storeKey, A = i.parseValue ?? A, _ = i.stringifyValue ?? _, j = i.unchangable ?? j), b === null) return I;
-    const u = `atom/${b}`;
+      S(e, !0), d.forEach(n, this);
+    }, this.setDeferred = (s, l = 500, a, T = !0) => {
+      T && g === void 0 && S(s, a), clearTimeout(g), g = setTimeout(() => {
+        S(s, a), g = void 0;
+      }, l);
+    }, c == null) return I;
+    let b = null, m = !0, D = !0, j = !1, A = e instanceof Set ? (s) => new Set(JSON.parse(s)) : (s) => JSON.parse(s), _ = e instanceof Set ? (s) => {
+      if (s instanceof Set) return JSON.stringify(Array.from(s));
+      throw console.error(s), "The value is not Set instance";
+    } : (s) => JSON.stringify(s);
+    if (typeof c == "string" ? b = c : "storeKey" in c && (m = c.warnOnDuplicateStoreKey ?? m, D = c.listenStorageChanges ?? D, b = c.storeKey, A = c.parseValue ?? A, _ = c.stringifyValue ?? _, j = c.unchangable ?? j), b === null) return I;
+    const i = `atom/${b}`;
     let N = !0;
     if (h = () => {
-      if (h = () => a(), N) {
+      if (h = () => f(), N) {
         N = !1;
         try {
-          l(u in c ? A(c[u]) : e);
+          u(i in o ? A(o[i]) : e);
         } catch {
-          console.warn("Invalid json value", c[u]);
+          console.warn("Invalid json value", o[i]);
         }
       }
-      return a();
-    }, v = (n) => {
-      if (n === e) {
+      return f();
+    }, v = (s) => {
+      if (s === e) {
         this.reset();
         return;
       }
-      c[u] = _(n);
+      o[i] = _(s);
     }, this.reset = () => {
-      delete c[u], S(e, !0);
-    }, m && w[u] !== void 0 && console.warn("Duplicate Atom key", b), D)
+      delete o[i], S(e, !0);
+    }, m && w[i] !== void 0 && console.warn("Duplicate Atom key", b), D)
       if (j) {
-        let n = !1, o;
-        p[u] = this, w[u] = () => {
-          clearTimeout(o), o = setTimeout(() => n = !1, 10), !n && (n = !0, c[u] = _(a()));
+        let s = !1, l;
+        p[i] = this, w[i] = () => {
+          clearTimeout(l), l = setTimeout(() => s = !1, 10), !s && (s = !0, o[i] = _(f()));
         };
       } else
-        w[u] = (n) => {
-          if (n.newValue === null) {
+        w[i] = (s) => {
+          if (s.newValue === null) {
             this.reset();
             return;
           }
           try {
-            S(A(n.newValue));
+            S(A(s.newValue));
           } catch {
-            console.warn("Invalid json value", n.newValue);
+            console.warn("Invalid json value", s.newValue);
           }
         };
     return I;
@@ -148,19 +148,19 @@ try {
   });
 } catch {
 }
-const c = window.localStorage, w = {}, p = {}, P = (t, e) => {
+const o = window.localStorage, w = {}, p = {}, P = (t, e) => {
   throw `${e} is readonly property`;
 };
 window.addEventListener("storage", (t) => {
   var e;
   t.key === null || t.newValue === t.oldValue || (e = w[t.key]) == null || e.call(w, t);
 });
-const H = c.setItem.bind(c), L = c.removeItem.bind(c);
-c.setItem = (t, e) => {
-  p[t] === void 0 && H.call(c, t, e);
+const H = o.setItem.bind(o), L = o.removeItem.bind(o);
+o.setItem = (t, e) => {
+  p[t] === void 0 && H.call(o, t, e);
 };
-c.removeItem = (t) => {
-  p[t] === void 0 && L.call(c, t);
+o.removeItem = (t) => {
+  p[t] === void 0 && L.call(o, t);
 };
 let k = () => {
   throw "call configureAtomaric() before all!";

package/build/atomaric.umd.cjs

@@ -1 +1 @@
-(function(o,b){typeof exports=="object"&&typeof module<"u"?b(exports):typeof define=="function"&&define.amd?define(["exports"],b):(o=typeof globalThis<"u"?globalThis:o||self,b(o.atomaric={}))})(this,function(o){"use strict";const b=(t,e,i)=>{let u=null;typeof t=="number"?u=y({increment:s=>{e.set(+e.get()+(s??0))}}):typeof t=="boolean"?u=y({toggle:()=>{e.set(!e.get())}}):Array.isArray(t)?u=y({push:(...s)=>{e.set(e.get().concat(s))},unshift:(...s)=>{e.set(s.concat(e.get()))},update:s=>{const r=e.get().slice();s(r),e.set(r)},filter:s=>{e.set(e.get().filter(s??H))}}):t instanceof Set?u=y({add:s=>{e.set(new Set(e.get()).add(s))},delete:s=>{const r=new Set(e.get());r.delete(s),e.set(r)},clear:()=>{e.set(new Set)},update:s=>{const r=new Set(e.get());s(r),e.set(r)}}):t instanceof Object&&(u=y({setPartial:s=>e.set(r=>({...r,...typeof s=="function"?s(e.get()):s}))}));const a=typeof i=="object"&&i!=null&&"do"in i?i.do((s,r)=>e.set(s,r),()=>e.get(),void 0,(s,r,S)=>e.setDeferred(s,r,S)):null,g={};return a&&Object.keys(a).forEach(s=>Object.defineProperty(g,s,{get:()=>a[s]})),u&&Object.keys(u).forEach(s=>Object.defineProperty(g,s,{get:()=>u[s]})),g},H=t=>t,y=(t,e)=>t;class C{constructor(e,i){const u=n=>r=n,a=()=>r,g=new Set,s=n=>n(w());let r=e,S,P=()=>{},w=()=>a(),F=()=>{const n=b(e,this,i);return F=()=>n,n};const p=new Proxy(this,{get:(n,l)=>l==="do"?F():n[l],set:L}),A=(n,l)=>{const d=typeof n=="function"?n(w()):n;if(!(d===w()||d===void 0||typeof d=="number"&&isNaN(d))){u(d),g.forEach(s,this);try{I.postMessage({key:f,value:a()})}catch{}l!==!0&&P(d)}};if(this.set=(n,l)=>A(n,l),this.get=()=>w(),this.defaultValue=e,this.subscribe=n=>(g.add(n),()=>{g.delete(n)}),this.reset=()=>{A(e,!0),g.forEach(s,this)},this.setDeferred=(n,l=500,d,G=!0)=>{G&&S===void 0&&A(n,d),clearTimeout(S),S=setTimeout(()=>{A(n,d),S=void 0},l)},i==null)return p;let m=null,T=!0,v=!0,E=!1,D=e instanceof Set?n=>new Set(JSON.parse(n)):n=>JSON.parse(n),j=e instanceof Set?n=>{if(n instanceof Set)return JSON.stringify(Array.from(n));throw console.error(n),"The value is not Set instance"}:n=>JSON.stringify(n);if(typeof i=="string"?m=i:"storeKey"in i&&(T=i.warnOnDuplicateStoreKey??T,v=i.listenStorageChanges??v,m=i.storeKey,D=i.parseValue??D,j=i.stringifyValue??j,E=i.unchangable??E),m===null)return p;const f=`atom/${m}`;let V=!0;if(w=()=>{if(w=()=>a(),V){V=!1;try{u(f in c?D(c[f]):e)}catch{console.warn("Invalid json value",c[f])}}return a()},P=n=>{if(n===e){this.reset();return}c[f]=j(n)},this.reset=()=>{delete c[f],A(e,!0)},T&&h[f]!==void 0&&console.warn("Duplicate Atom key",m),v)if(E){let n=!1,l;_[f]=this,h[f]=()=>{clearTimeout(l),l=setTimeout(()=>n=!1,10),!n&&(n=!0,c[f]=j(a()))}}else h[f]=n=>{if(n.newValue===null){this.reset();return}try{A(D(n.newValue))}catch{console.warn("Invalid json value",n.newValue)}};return p}}let I;try{I=new BroadcastChannel("updateHere"),I.addEventListener("message",t=>{var e;(e=_[t.data.key])==null||e.set(t.data.value,!0)})}catch{}const c=window.localStorage,h={},_={},L=(t,e)=>{throw`${e} is readonly property`};window.addEventListener("storage",t=>{var e;t.key===null||t.newValue===t.oldValue||(e=h[t.key])==null||e.call(h,t)});const M=c.setItem.bind(c),$=c.removeItem.bind(c);c.setItem=(t,e)=>{_[t]===void 0&&M.call(c,t,e)},c.removeItem=t=>{_[t]===void 0&&$.call(c,t)};let N=()=>{throw"call configureAtomaric() before all!"};const B=t=>N=t.useSyncExternalStore,k=t=>N(t.subscribe,t.get),J=t=>t.set,U=t=>t.setDeferred,q=t=>t.get,z=t=>t.do,Q=t=>[k(t),J(t)],R=(t,e)=>new C(t,e);o.Atom=C,o.atom=R,o.configureAtomaric=B,o.useAtom=Q,o.useAtomDo=z,o.useAtomGet=q,o.useAtomSet=J,o.useAtomSetDeferred=U,o.useAtomValue=k,Object.defineProperty(o,Symbol.toStringTag,{value:"Module"})});
+(function(c,b){typeof exports=="object"&&typeof module<"u"?b(exports):typeof define=="function"&&define.amd?define(["exports"],b):(c=typeof globalThis<"u"?globalThis:c||self,b(c.atomaric={}))})(this,function(c){"use strict";const b=(t,e,o)=>{let i=null;typeof t=="number"?i=y({increment:s=>{e.set(+e.get()+(s??0))}}):typeof t=="boolean"?i=y({toggle:()=>{e.set(!e.get())}}):Array.isArray(t)?i=y({push:(...s)=>{e.set(e.get().concat(s))},unshift:(...s)=>{e.set(s.concat(e.get()))},update:s=>{const r=e.get().slice();s(r),e.set(r)},filter:s=>{e.set(e.get().filter(s??H))}}):t instanceof Set?i=y({add:s=>{e.set(new Set(e.get()).add(s))},delete:s=>{const r=new Set(e.get());r.delete(s),e.set(r)},clear:()=>{e.set(new Set)},update:s=>{const r=new Set(e.get());s(r),e.set(r)}}):t instanceof Object&&(i=y({setPartial:s=>e.set(r=>({...r,...typeof s=="function"?s(e.get()):s}))}));const a=typeof o=="object"&&o!=null&&"do"in o?o.do((s,r)=>e.set(s,r),()=>e.get(),void 0,(s,r,S)=>e.setDeferred(s,r,S)):null,g={};return a&&Object.keys(a).forEach(s=>Object.defineProperty(g,s,{get:()=>a[s]})),i&&Object.keys(i).forEach(s=>Object.defineProperty(g,s,{get:()=>i[s]})),g},H=t=>t,y=(t,e)=>t;class C{constructor(e,o){const i=n=>r=n,a=()=>r,g=new Set,s=n=>n(w());let r=e,S,P=()=>{},w=()=>a(),F=()=>{const n=b(e,this,o);return F=()=>n,n};const p=new Proxy(this,{get:(n,u)=>u==="do"?F():n[u],set:L}),A=(n,u)=>{const d=typeof n=="function"?n(w()):n;if(!(d===w()||d===void 0||typeof d=="number"&&isNaN(d))){i(d),g.forEach(s,this);try{j.postMessage({key:f,value:a()})}catch{}u!==!0&&P(d)}};if(this.set=(n,u)=>A(n,u),this.get=()=>w(),this.initialValue=e,this.isInitialValue=()=>e===a(),this.subscribe=n=>(g.add(n),()=>{g.delete(n)}),this.reset=()=>{A(e,!0),g.forEach(s,this)},this.setDeferred=(n,u=500,d,G=!0)=>{G&&S===void 0&&A(n,d),clearTimeout(S),S=setTimeout(()=>{A(n,d),S=void 0},u)},o==null)return p;let m=null,T=!0,v=!0,E=!1,D=e instanceof Set?n=>new Set(JSON.parse(n)):n=>JSON.parse(n),I=e instanceof Set?n=>{if(n instanceof Set)return JSON.stringify(Array.from(n));throw console.error(n),"The value is not Set instance"}:n=>JSON.stringify(n);if(typeof o=="string"?m=o:"storeKey"in o&&(T=o.warnOnDuplicateStoreKey??T,v=o.listenStorageChanges??v,m=o.storeKey,D=o.parseValue??D,I=o.stringifyValue??I,E=o.unchangable??E),m===null)return p;const f=`atom/${m}`;let V=!0;if(w=()=>{if(w=()=>a(),V){V=!1;try{i(f in l?D(l[f]):e)}catch{console.warn("Invalid json value",l[f])}}return a()},P=n=>{if(n===e){this.reset();return}l[f]=I(n)},this.reset=()=>{delete l[f],A(e,!0)},T&&h[f]!==void 0&&console.warn("Duplicate Atom key",m),v)if(E){let n=!1,u;_[f]=this,h[f]=()=>{clearTimeout(u),u=setTimeout(()=>n=!1,10),!n&&(n=!0,l[f]=I(a()))}}else h[f]=n=>{if(n.newValue===null){this.reset();return}try{A(D(n.newValue))}catch{console.warn("Invalid json value",n.newValue)}};return p}}let j;try{j=new BroadcastChannel("updateHere"),j.addEventListener("message",t=>{var e;(e=_[t.data.key])==null||e.set(t.data.value,!0)})}catch{}const l=window.localStorage,h={},_={},L=(t,e)=>{throw`${e} is readonly property`};window.addEventListener("storage",t=>{var e;t.key===null||t.newValue===t.oldValue||(e=h[t.key])==null||e.call(h,t)});const M=l.setItem.bind(l),$=l.removeItem.bind(l);l.setItem=(t,e)=>{_[t]===void 0&&M.call(l,t,e)},l.removeItem=t=>{_[t]===void 0&&$.call(l,t)};let N=()=>{throw"call configureAtomaric() before all!"};const B=t=>N=t.useSyncExternalStore,k=t=>N(t.subscribe,t.get),J=t=>t.set,U=t=>t.setDeferred,q=t=>t.get,z=t=>t.do,Q=t=>[k(t),J(t)],R=(t,e)=>new C(t,e);c.Atom=C,c.atom=R,c.configureAtomaric=B,c.useAtom=Q,c.useAtomDo=z,c.useAtomGet=q,c.useAtomSet=J,c.useAtomSetDeferred=U,c.useAtomValue=k,Object.defineProperty(c,Symbol.toStringTag,{value:"Module"})});

package/package.json

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

package/types/model.d.ts

@@ -44,30 +44,40 @@ export type AtomSetDeferredMethod<Value> = (
 export type AtomSubscribeMethod<Value> = (subscriber: Sunscriber<Value>) => () => void;
 
 export type UpdateAction<Value> = {
+  /** transform current taken value */
   update: (updater: (value: Value) => void) => void;
 };
 
 export type NumberActions<Value> = {
+  /** pass the 2 to increment on 2, pass the -2 to decrement on 2 */
   increment: (delta?: number) => void;
 };
 
 export type ObjectActions<Value> = {
+  /** pass partial object to update some fields */
   setPartial: (value: Partial<Value> | ((value: Value) => Partial<Value>)) => void;
 };
 
 export type BooleanActions = {
+  /** toggle current value between true/false */
   toggle: () => void;
 };
 
 export type SetActions<Value> = UpdateAction<Value> & {
+  /** like the Set.prototype.add() method */
   add: (value: Value) => void;
+  /** like the Set.prototype.delete() method */
   delete: (value: Value) => void;
+  /** like the Set.prototype.clear() method */
   clear: () => void;
 };
 
 export type ArrayActions<Value> = UpdateAction<Value[]> & {
+  /** like the Array.prototype.push() method */
   push: (...values: Value[]) => void;
+  /** like the Array.prototype.unshift() method */
   unshift: (...values: Value[]) => void;
+  /** like the Array.prototype.filter() method, but callback is optional - (it) => !!it */
   filter: (filter?: (value: Value, index: number, array: Value[]) => any) => void;
 };
 
@@ -84,18 +94,24 @@ export type DefaultActions<Value> = Value extends Set<infer Val>
   : {};
 
 declare class Atom<Value, Actions extends Record<string, Function> = {}> {
-  constructor(defaultValue: Value, storeKeyOrOptions: StoreKeyOrOptions<Value, Actions> | undefined);
+  constructor(initialValue: Value, storeKeyOrOptions: StoreKeyOrOptions<Value, Actions> | undefined);
 
-  readonly defaultValue: Value;
+  /** initial value */
+  readonly initialValue: Value;
+  /** get current value */
   readonly get: () => Value;
+  /** set current value */
   readonly set: AtomSetMethod<Value>;
+  /** set current value with debounce */
   readonly setDeferred: AtomSetDeferredMethod<Value>;
-  /** set default (initial) value as current */
+  /** set current value as default (initial) */
   readonly reset: () => void;
   /** subscribe on value changes */
   readonly subscribe: AtomSubscribeMethod<Value>;
   /** your custom actions */
   readonly do: Actions & DefaultActions<Value>;
+  /** check is current value not changed */
+  readonly isInitialValue: () => boolean;
 }
 
 export function useAtom<Value>(atom: Atom<Value>): [Value, AtomSetMethod<Value>];
@@ -121,4 +137,5 @@ export function atom<Value, Actions extends Record<string, Function> = {}>(
   storeKeyOrOptions?: StoreKeyOrOptions<Value, Actions>,
 ): Atom<Value, Actions>;
 
+/** invoke this function before all atom usages */
 export function configureAtomaric(options: { useSyncExternalStore: typeof useSyncExternalStore }): void;