atomaric 0.0.8 → 0.0.10

package/build/atomaric.js

@@ -1,38 +1,51 @@
-const a = {};
-window.addEventListener("storage", (t) => {
-  t.key === null || a[t.key] === void 0 || a[t.key](t);
-});
-class m {
-  constructor(s, i) {
+class v {
+  constructor(s, n) {
     if (this._defaultValue = s, this.subscribers = /* @__PURE__ */ new Set(), this.save = () => {
-    }, this.invokeSubscriber = (e) => e(this.value), this.get = () => this.value, this.toggle = () => this.set(!this.value), this.inkrement = (e) => this.set(this.value + e), this.subscribe = (e) => (this.subscribers.add(e), () => {
+    }, this.invokeSubscriber = (e) => e(this.value), this.do = {}, this.get = () => this.value, this.toggle = () => this.set(!this.value), this.inkrement = (e) => this.set(this.value + e), this.subscribe = (e) => (this.subscribers.add(e), () => {
       this.subscribers.delete(e);
-    }), this.set = (e, l) => {
-      const r = typeof e == "function" ? e(this.value) : e;
-      r === this.value || r === void 0 || typeof r == "number" && isNaN(r) || (this.value = r, this.subscribers.forEach(this.invokeSubscriber, this), l !== !0 && this.save(r));
-    }, this.setDeferred = (e, l = 500, r, S = !0) => {
-      S && this.debounceTimeout === void 0 && this.set(e, r), clearTimeout(this.debounceTimeout), this.debounceTimeout = setTimeout(() => {
-        this.set(e, r), delete this.debounceTimeout;
-      }, l);
-    }, this.value = s, typeof s != "boolean" && (this.toggle = () => {
+    }), this.set = (e, h) => {
+      const o = typeof e == "function" ? e(this.value) : e;
+      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 = (e, h = 500, o, g = !0) => {
+      g && this.debounceTimeout === void 0 && this.set(e, o), clearTimeout(this.debounceTimeout), this.debounceTimeout = setTimeout(() => {
+        this.set(e, o), delete this.debounceTimeout;
+      }, h);
+    }, typeof n == "object") {
+      const e = "do" in n ? n.do(this.get, this.set) : {};
+      this.do = s instanceof Set ? {
+        ...e,
+        add: (h) => {
+          const o = new Set(this.value), g = o.add(h);
+          return this.set(o), g;
+        },
+        delete: (h) => {
+          const o = new Set(this.value), g = o.delete(h);
+          return this.set(o), g;
+        },
+        clear: () => {
+          this.set(/* @__PURE__ */ new Set());
+        }
+      } : e;
+    }
+    if (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 o = null, h = !0, f = !0, u = s instanceof Set ? (e) => new Set(JSON.parse(e)) : (e) => JSON.parse(e), c = s instanceof Set ? (e) => {
+    }, n == null) return;
+    let r = null, c = !0, b = !0, u = !1, f = s instanceof Set ? (e) => new Set(JSON.parse(e)) : (e) => JSON.parse(e), d = s instanceof Set ? (e) => {
       if (e instanceof Set) return JSON.stringify(Array.from(e));
       throw console.error(e), "The value is not Set instance";
     } : (e) => JSON.stringify(e);
-    if (typeof i == "string" ? o = i : i.storeKey !== void 0 && (h = i.warnOnDuplicateStoreKey ?? !0, f = i.listenStorageChanges ?? !0, o = i.storeKey, u = i.parseValue ?? u, c = i.stringifyValue ?? c), o === null) return;
-    const n = `atom/${o}`;
-    let g = !0;
-    this.get = () => {
-      if (this.get = () => this.value, g) {
-        g = !1;
+    if (typeof n == "string" ? r = n : "storeKey" in n && (c = n.warnOnDuplicateStoreKey ?? !0, b = n.listenStorageChanges ?? !0, r = n.storeKey, f = n.parseValue ?? f, d = n.stringifyValue ?? d, u = n.unchangable ?? u), r === null) return;
+    const l = `atom/${r}`;
+    let m = !0;
+    if (this.get = () => {
+      if (this.get = () => this.value, m) {
+        m = !1;
         try {
-          this.value = n in localStorage ? u(localStorage[n]) : s;
+          this.value = l in i ? f(i[l]) : s;
         } catch {
-          console.warn("Invalid json value", localStorage[n]);
+          console.warn("Invalid json value", i[l]);
         }
       }
       return this.value;
@@ -41,41 +54,87 @@ class m {
         this.reset();
         return;
       }
-      localStorage[n] = c(e);
+      i[l] = d(e);
     }, this.reset = () => {
-      delete localStorage[n], this.set(s, !0);
-    }, h && a[n] !== void 0 && console.warn(
-      "Duplicate Atom key",
-      typeof i == "string" ? i : i.storeKey
-    ), f && (a[n] = (e) => {
-      if (e.newValue === null) {
-        this.reset();
-        return;
-      }
-      try {
-        this.set(u(e.newValue));
-      } catch {
-        console.warn("Invalid json value", e.newValue);
-      }
-    });
+      delete i[l], this.set(s, !0);
+    }, c && a[l] !== void 0 && console.warn("Duplicate Atom key", r), a[l] = {}, b)
+      if (u) {
+        let e = !1;
+        a[l].unchangable = () => {
+          e || (e = !0, i[l] = d(this.value), setTimeout(() => e = !1, 100));
+        }, k();
+      } else
+        a[l].updatable = (e) => {
+          if (e.newValue === null) {
+            this.reset();
+            return;
+          }
+          try {
+            this.set(f(e.newValue));
+          } catch {
+            console.warn("Invalid json value", e.newValue);
+          }
+        };
   }
   get defaultValue() {
     return this._defaultValue;
   }
 }
-let b = () => {
+const i = window.localStorage, a = {};
+window.addEventListener("storage", (t) => {
+  var s, n, r, c;
+  t.key !== null && ((n = (s = a[t.key]) == null ? void 0 : s.unchangable) == null || n.call(s), (c = (r = a[t.key]) == null ? void 0 : r.updatable) == null || c.call(r, t));
+});
+const w = i.setItem.bind(i), I = i.removeItem.bind(i);
+i.setItem = (t, s) => {
+  var n;
+  ((n = a[t]) == null ? void 0 : n.unchangable) === void 0 && w.call(i, t, s);
+};
+i.removeItem = (t) => {
+  var s;
+  ((s = a[t]) == null ? void 0 : s.unchangable) === void 0 && I.call(i, t);
+};
+const k = /* @__PURE__ */ (() => {
+  let t = !1;
+  return () => {
+    if (t) return;
+    t = !0;
+    let s;
+    const n = () => {
+      let r = i.length;
+      const c = () => {
+        r !== i.length && (r = i.length, Object.keys(a).forEach((b) => {
+          var u, f;
+          b in i || (f = (u = a[b]) == null ? void 0 : u.unchangable) == null || f.call(u);
+        }));
+      };
+      c(), s = setInterval(c, 100);
+    };
+    window.addEventListener("focus", () => clearInterval(s)), window.addEventListener("blur", n);
+  };
+})();
+(() => {
+  const t = (n) => {
+    var r, c;
+    n in i || (c = (r = a[n]) == null ? void 0 : r.unchangable) == null || c.call(r);
+  }, s = () => Object.keys(a).forEach(t);
+  Object.defineProperty(window, "localStorage", {
+    get: () => (Promise.resolve().then(s), i)
+  });
+})();
+let S = () => {
   throw "call configureAtomaric() before all!";
 };
-const w = (t) => b = t.useSyncExternalStore, d = (t) => b(t.subscribe, t.get), v = (t) => t.set, y = (t) => t.setDeferred, k = (t) => t.get, A = (t) => t.toggle, T = (t) => t.inkrement, D = (t) => [d(t), v(t)], N = (t, s) => new m(t, s);
+const E = (t) => S = t.useSyncExternalStore, y = (t) => S(t.subscribe, t.get), A = (t) => t.set, T = (t) => t.setDeferred, p = (t) => t.get, D = (t) => t.toggle, j = (t) => t.inkrement, N = (t) => [y(t), A(t)], C = (t, s) => new v(t, s);
 export {
-  m as Atom,
-  N as atom,
-  w as configureAtomaric,
-  D as useAtom,
-  k as useAtomGet,
-  T as useAtomInkrement,
-  v as useAtomSet,
-  y as useAtomSetDeferred,
-  A as useAtomToggle,
-  d as useAtomValue
+  v as Atom,
+  C as atom,
+  E as configureAtomaric,
+  N as useAtom,
+  p as useAtomGet,
+  j as useAtomInkrement,
+  A as useAtomSet,
+  T as useAtomSetDeferred,
+  D as useAtomToggle,
+  y as useAtomValue
 };

package/build/atomaric.umd.cjs

@@ -1 +1 @@
-(function(s,o){typeof exports=="object"&&typeof module<"u"?o(exports):typeof define=="function"&&define.amd?define(["exports"],o):(s=typeof globalThis<"u"?globalThis:s||self,o(s.atomaric={}))})(this,function(s){"use strict";const o={};window.addEventListener("storage",t=>{t.key===null||o[t.key]===void 0||o[t.key](t)});class f{constructor(i,n){if(this._defaultValue=i,this.subscribers=new Set,this.save=()=>{},this.invokeSubscriber=e=>e(this.value),this.get=()=>this.value,this.toggle=()=>this.set(!this.value),this.inkrement=e=>this.set(this.value+e),this.subscribe=e=>(this.subscribers.add(e),()=>{this.subscribers.delete(e)}),this.set=(e,a)=>{const r=typeof e=="function"?e(this.value):e;r===this.value||r===void 0||typeof r=="number"&&isNaN(r)||(this.value=r,this.subscribers.forEach(this.invokeSubscriber,this),a!==!0&&this.save(r))},this.setDeferred=(e,a=500,r,E=!0)=>{E&&this.debounceTimeout===void 0&&this.set(e,r),clearTimeout(this.debounceTimeout),this.debounceTimeout=setTimeout(()=>{this.set(e,r),delete this.debounceTimeout},a)},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 l=null,b=!0,d=!0,c=i instanceof Set?e=>new Set(JSON.parse(e)):e=>JSON.parse(e),h=i instanceof Set?e=>{if(e instanceof Set)return JSON.stringify(Array.from(e));throw console.error(e),"The value is not Set instance"}:e=>JSON.stringify(e);if(typeof n=="string"?l=n:n.storeKey!==void 0&&(b=n.warnOnDuplicateStoreKey??!0,d=n.listenStorageChanges??!0,l=n.storeKey,c=n.parseValue??c,h=n.stringifyValue??h),l===null)return;const u=`atom/${l}`;let A=!0;this.get=()=>{if(this.get=()=>this.value,A){A=!1;try{this.value=u in localStorage?c(localStorage[u]):i}catch{console.warn("Invalid json value",localStorage[u])}}return this.value},this.save=e=>{if(e===i){this.reset();return}localStorage[u]=h(e)},this.reset=()=>{delete localStorage[u],this.set(i,!0)},b&&o[u]!==void 0&&console.warn("Duplicate Atom key",typeof n=="string"?n:n.storeKey),d&&(o[u]=e=>{if(e.newValue===null){this.reset();return}try{this.set(c(e.newValue))}catch{console.warn("Invalid json value",e.newValue)}})}get defaultValue(){return this._defaultValue}}let m=()=>{throw"call configureAtomaric() before all!"};const y=t=>m=t.useSyncExternalStore,g=t=>m(t.subscribe,t.get),S=t=>t.set,v=t=>t.setDeferred,w=t=>t.get,k=t=>t.toggle,T=t=>t.inkrement,D=t=>[g(t),S(t)],N=(t,i)=>new f(t,i);s.Atom=f,s.atom=N,s.configureAtomaric=y,s.useAtom=D,s.useAtomGet=w,s.useAtomInkrement=T,s.useAtomSet=S,s.useAtomSetDeferred=v,s.useAtomToggle=k,s.useAtomValue=g,Object.defineProperty(s,Symbol.toStringTag,{value:"Module"})});
+(function(o,m){typeof exports=="object"&&typeof module<"u"?m(exports):typeof define=="function"&&define.amd?define(["exports"],m):(o=typeof globalThis<"u"?globalThis:o||self,m(o.atomaric={}))})(this,function(o){"use strict";class m{constructor(s,n){if(this._defaultValue=s,this.subscribers=new Set,this.save=()=>{},this.invokeSubscriber=e=>e(this.value),this.do={},this.get=()=>this.value,this.toggle=()=>this.set(!this.value),this.inkrement=e=>this.set(this.value+e),this.subscribe=e=>(this.subscribers.add(e),()=>{this.subscribers.delete(e)}),this.set=(e,f)=>{const u=typeof e=="function"?e(this.value):e;u===this.value||u===void 0||typeof u=="number"&&isNaN(u)||(this.value=u,this.subscribers.forEach(this.invokeSubscriber,this),f!==!0&&this.save(u))},this.setDeferred=(e,f=500,u,b=!0)=>{b&&this.debounceTimeout===void 0&&this.set(e,u),clearTimeout(this.debounceTimeout),this.debounceTimeout=setTimeout(()=>{this.set(e,u),delete this.debounceTimeout},f)},typeof n=="object"){const e="do"in n?n.do(this.get,this.set):{};this.do=s instanceof Set?{...e,add:f=>{const u=new Set(this.value),b=u.add(f);return this.set(u),b},delete:f=>{const u=new Set(this.value),b=u.delete(f);return this.set(u),b},clear:()=>{this.set(new Set)}}:e}if(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)},n==null)return;let r=null,c=!0,g=!0,h=!1,d=s instanceof Set?e=>new Set(JSON.parse(e)):e=>JSON.parse(e),S=s instanceof Set?e=>{if(e instanceof Set)return JSON.stringify(Array.from(e));throw console.error(e),"The value is not Set instance"}:e=>JSON.stringify(e);if(typeof n=="string"?r=n:"storeKey"in n&&(c=n.warnOnDuplicateStoreKey??!0,g=n.listenStorageChanges??!0,r=n.storeKey,d=n.parseValue??d,S=n.stringifyValue??S,h=n.unchangable??h),r===null)return;const l=`atom/${r}`;let y=!0;if(this.get=()=>{if(this.get=()=>this.value,y){y=!1;try{this.value=l in i?d(i[l]):s}catch{console.warn("Invalid json value",i[l])}}return this.value},this.save=e=>{if(e===s){this.reset();return}i[l]=S(e)},this.reset=()=>{delete i[l],this.set(s,!0)},c&&a[l]!==void 0&&console.warn("Duplicate Atom key",r),a[l]={},g)if(h){let e=!1;a[l].unchangable=()=>{e||(e=!0,i[l]=S(this.value),setTimeout(()=>e=!1,100))},T()}else a[l].updatable=e=>{if(e.newValue===null){this.reset();return}try{this.set(d(e.newValue))}catch{console.warn("Invalid json value",e.newValue)}}}get defaultValue(){return this._defaultValue}}const i=window.localStorage,a={};window.addEventListener("storage",t=>{var s,n,r,c;t.key!==null&&((n=(s=a[t.key])==null?void 0:s.unchangable)==null||n.call(s),(c=(r=a[t.key])==null?void 0:r.updatable)==null||c.call(r,t))});const I=i.setItem.bind(i),k=i.removeItem.bind(i);i.setItem=(t,s)=>{var n;((n=a[t])==null?void 0:n.unchangable)===void 0&&I.call(i,t,s)},i.removeItem=t=>{var s;((s=a[t])==null?void 0:s.unchangable)===void 0&&k.call(i,t)};const T=(()=>{let t=!1;return()=>{if(t)return;t=!0;let s;const n=()=>{let r=i.length;const c=()=>{r!==i.length&&(r=i.length,Object.keys(a).forEach(g=>{var h,d;g in i||(d=(h=a[g])==null?void 0:h.unchangable)==null||d.call(h)}))};c(),s=setInterval(c,100)};window.addEventListener("focus",()=>clearInterval(s)),window.addEventListener("blur",n)}})();(()=>{const t=n=>{var r,c;n in i||(c=(r=a[n])==null?void 0:r.unchangable)==null||c.call(r)},s=()=>Object.keys(a).forEach(t);Object.defineProperty(window,"localStorage",{get:()=>(Promise.resolve().then(s),i)})})();let v=()=>{throw"call configureAtomaric() before all!"};const E=t=>v=t.useSyncExternalStore,w=t=>v(t.subscribe,t.get),A=t=>t.set,j=t=>t.setDeferred,D=t=>t.get,N=t=>t.toggle,p=t=>t.inkrement,C=t=>[w(t),A(t)],J=(t,s)=>new m(t,s);o.Atom=m,o.atom=J,o.configureAtomaric=E,o.useAtom=C,o.useAtomGet=D,o.useAtomInkrement=p,o.useAtomSet=A,o.useAtomSetDeferred=j,o.useAtomToggle=N,o.useAtomValue=w,Object.defineProperty(o,Symbol.toStringTag,{value:"Module"})});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "atomaric",
   "description": "Manage your project state",
-  "version": "0.0.8",
+  "version": "0.0.10",
   "type": "module",
   "main": "./build/atomaric.umd.cjs",
   "module": "./build/atomaric.js",
@@ -23,7 +23,7 @@
     "manager"
   ],
   "scripts": {
-    "start": "vite --port 8378 --host",
+    "dev": "vite --port 8378 --host",
     "build": "tsc && vite build",
     "preview": "vite preview"
   },

package/types/model.d.ts

@@ -2,15 +2,30 @@ type Sunscriber<Value> = (value: Value) => void;
 
 export type AtomStoreKey = `${string}${string}:${string}${string}`;
 
-export type AtomOptions<Value> = {
-  storeKey?: AtomStoreKey;
+export type AtomOptions<Value, Actions extends Record<string, Function>> = {
   /** **default: true** */
   warnOnDuplicateStoreKey?: boolean;
-  /** **default: true** */
+  /** will update value if localStorage value is changed
+   * **default: true**
+   */
   listenStorageChanges?: boolean;
+  /** map localStorage string value to Value */
   parseValue?: (stringifiedValue: string) => Value;
+  /** map Value to localStorage string value */
   stringifyValue?: (value: Value) => string;
-};
+  /** can not to change localStorage value in dev tools
+   * **default: false**
+   */
+  unchangable?: boolean;
+} & (
+  | {
+      /** save in localStorage by this key */
+      storeKey: AtomStoreKey;
+    }
+  | {
+      do: (get: () => Value, set: (value: Value) => void) => Actions;
+    }
+);
 
 export type AtomSetMethod<Value> = (value: Value | ((prev: Value) => Value), isPreventSave?: boolean) => void;
 export type AtomSetDeferredMethod<Value> = (
@@ -22,8 +37,14 @@ export type AtomSetDeferredMethod<Value> = (
 
 export type AtomSubscribeMethod<Value> = (subscriber: Sunscriber<Value>) => () => void;
 
-export class Atom<Value> {
-  constructor(defaultValue: Value, storeKeyOrOptions: AtomStoreKey | undefined | AtomOptions<Value>);
+export type SetActions<Value> = {
+  add: (value: Value) => Set<Value>;
+  delete: (value: Value) => boolean;
+  clear: () => void;
+};
+
+export class Atom<Value, Actions extends Record<string, Function>> {
+  constructor(defaultValue: Value, storeKeyOrOptions: AtomStoreKey | undefined | AtomOptions<Value, Actions>);
 
   readonly defaultValue: Value;
   readonly get: () => Value;
@@ -33,6 +54,7 @@ export class Atom<Value> {
   readonly toggle: () => void;
   readonly inkrement: (delta: number) => void;
   readonly subscribe: AtomSubscribeMethod<Value>;
+  do: Actions & (Value extends Set<infer V> ? SetActions<V> : {});
 }
 
 export function useAtomValue<Value>(atom: Atom<Value>): Value;
@@ -44,8 +66,13 @@ export function useAtomInkrement(atom: Atom<number>): (typeof atom)['inkrement']
 
 export function useAtom<Value>(atom: Atom<Value>): [Value, (typeof atom)['set']];
 
-export type StoreKeyOrOptions<Value> = `${string}${string}:${string}${string}` | AtomOptions<Value>;
+export type StoreKeyOrOptions<Value, Actions extends Record<string, Function>> =
+  | `${string}${string}:${string}${string}`
+  | AtomOptions<Value, Actions>;
 
-export function atom<Value>(value: Value, storeKeyOrOptions?: StoreKeyOrOptions<Value>): Atom<Value>;
+export function atom<Value, Actions extends Record<string, Function>>(
+  value: Value,
+  storeKeyOrOptions?: StoreKeyOrOptions<Value, Actions>,
+): Atom<Value, Actions>;
 
 export function configureAtomaric(hooks: { useSyncExternalStore: typeof useSyncExternalStore }): void;