atomaric 0.0.9 → 0.0.11

package/build/atomaric.js

@@ -1,81 +1,192 @@
-const c = {};
-window.addEventListener("storage", (t) => {
-  t.key === null || c[t.key] === void 0 || c[t.key](t);
-});
-class d {
-  constructor(i, s) {
-    if (this._defaultValue = i, 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), () => {
+class C {
+  constructor(s) {
+    this.value = s;
+  }
+  getValue() {
+    return this.value;
+  }
+  setValue(s) {
+    this.value = s;
+  }
+}
+class T extends C {
+  constructor(s, n) {
+    super(s), this._defaultValue = s, this.subscribers = /* @__PURE__ */ new Set(), this.save = () => {
+    }, this.invokeSubscriber = (e) => e(this.get()), this.do = {}, this.get = () => super.getValue(), 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, m = !0) => {
-      m && this.debounceTimeout === void 0 && this.set(e, r), clearTimeout(this.debounceTimeout), this.debounceTimeout = setTimeout(() => {
-        this.set(e, r), delete this.debounceTimeout;
-      }, l);
-    }, 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);
-    }, s == null) return;
-    let o = null, f = !0, g = !0, h = !1, u = i instanceof Set ? (e) => new Set(JSON.parse(e)) : (e) => JSON.parse(e), a = i instanceof Set ? (e) => {
+    }), this.set = (e, i) => {
+      const l = typeof e == "function" ? e(this.get()) : e;
+      l === this.get() || l === void 0 || typeof l == "number" && isNaN(l) || (super.setValue(l), this.subscribers.forEach(this.invokeSubscriber, this), i !== !0 && this.save(l));
+    }, this.setDeferred = (e, i = 500, l, k = !0) => {
+      k && this.debounceTimeout === void 0 && this.set(e, l), clearTimeout(this.debounceTimeout), this.debounceTimeout = setTimeout(() => {
+        this.set(e, l), delete this.debounceTimeout;
+      }, i);
+    };
+    const c = (e, i) => i;
+    let h = null;
+    typeof s == "number" && (h = c(s, {
+      increment: (e) => {
+        this.set(+this.get() + (e ?? 0));
+      }
+    })), typeof s == "boolean" && (h = c(s, {
+      toggle: () => {
+        this.set(!this.get());
+      }
+    })), Array.isArray(s) && (h = c(s, {
+      push: (e) => {
+        this.set([...this.get(), e]);
+      },
+      unshift: (e) => {
+        this.set([e, ...this.get()]);
+      },
+      update: (e) => {
+        const i = [...this.get()];
+        e(i), this.set(i);
+      },
+      filter: (e) => {
+        this.set(this.get().filter(e ?? U));
+      }
+    })), s instanceof Set && (h = c(s, {
+      add: (e) => {
+        const i = new Set(this.get());
+        i.add(e), this.set(i);
+      },
+      delete: (e) => {
+        const i = new Set(this.get());
+        i.delete(e), this.set(i);
+      },
+      clear: () => {
+        this.set(/* @__PURE__ */ new Set());
+      },
+      update: (e) => {
+        const i = new Set(this.get());
+        e(i), this.set(i);
+      }
+    }));
+    const E = typeof n == "object" && "do" in n ? n.do(
+      () => this.get(),
+      (e, i) => this.set(e, i)
+    ) : {};
+    if (this.do = {
+      ...E,
+      ...h
+    }, this.reset = () => {
+      this.set(s, !0), this.subscribers.forEach(this.invokeSubscriber, this);
+    }, n == null) return;
+    let d = null, m = !0, S = !0, b = !1, g = s instanceof Set ? (e) => new Set(JSON.parse(e)) : (e) => JSON.parse(e), f = 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 s == "string" ? o = s : s.storeKey !== void 0 && (f = s.warnOnDuplicateStoreKey ?? !0, g = s.listenStorageChanges ?? !0, o = s.storeKey, u = s.parseValue ?? u, a = s.stringifyValue ?? a, h = s.unchangable ?? h), o === null) return;
-    const n = `atom/${o}`;
-    let b = !0;
-    this.get = () => {
-      if (this.get = () => this.value, b) {
-        b = !1;
+    if (typeof n == "string" ? d = n : "storeKey" in n && (m = n.warnOnDuplicateStoreKey ?? !0, S = n.listenStorageChanges ?? !0, d = n.storeKey, g = n.parseValue ?? g, f = n.stringifyValue ?? f, b = n.unchangable ?? b), d === null) return;
+    const o = `atom/${d}`;
+    let v = !0;
+    if (this.get = () => {
+      if (this.get = () => super.getValue(), v) {
+        v = !1;
         try {
-          this.value = n in localStorage ? u(localStorage[n]) : i;
+          super.setValue(o in r ? g(r[o]) : s);
         } catch {
-          console.warn("Invalid json value", localStorage[n]);
+          console.warn("Invalid json value", r[o]);
         }
       }
-      return this.value;
+      return super.getValue();
     }, this.save = (e) => {
-      if (e === i) {
+      if (e === s) {
         this.reset();
         return;
       }
-      localStorage[n] = a(e);
+      r[o] = f(e), I(o);
     }, this.reset = () => {
-      delete localStorage[n], this.set(i, !0);
-    }, f && c[n] !== void 0 && console.warn(
-      "Duplicate Atom key",
-      typeof s == "string" ? s : s.storeKey
-    ), g && (c[n] = h ? () => localStorage[n] = a(this.value) : (e) => {
-      if (e.newValue === null) {
-        this.reset();
-        return;
-      }
-      try {
-        this.set(u(e.newValue));
-      } catch {
-        console.warn("Invalid json value", e.newValue);
-      }
-    });
+      delete r[o], this.set(s, !0);
+    }, m && u[o] !== void 0 && console.warn("Duplicate Atom key", d), u[o] = {}, S)
+      if (b) {
+        let e, i = !1;
+        u[o].updateUnchangable = () => {
+          try {
+            this.set(g(r[o]), !0);
+          } catch {
+          }
+        }, a[o] = () => {
+          i || (i = !0, r[o] = f(this.get()), clearTimeout(e), e = setTimeout(() => i = !1, 100));
+        }, N();
+      } else
+        u[o].updatable = (e) => {
+          if (e.newValue === null) {
+            this.reset();
+            return;
+          }
+          try {
+            this.set(g(e.newValue));
+          } catch {
+            console.warn("Invalid json value", e.newValue);
+          }
+        };
   }
   get defaultValue() {
     return this._defaultValue;
   }
 }
-let S = () => {
+const r = window.localStorage, u = {}, a = {};
+window.addEventListener("storage", (t) => {
+  var s, n, c;
+  t.key === null || t.newValue === t.oldValue || ((s = a[t.key]) == null || s.call(a), (c = (n = u[t.key]) == null ? void 0 : n.updatable) == null || c.call(n, t));
+});
+const A = new BroadcastChannel("unchangableChanged");
+A.addEventListener("message", (t) => {
+  var s, n;
+  (n = (s = u[t.data]) == null ? void 0 : s.updateUnchangable) == null || n.call(s);
+});
+const I = (t) => {
+  A.postMessage(t);
+}, D = r.setItem.bind(r), L = r.removeItem.bind(r), j = r.clear.bind(r);
+r.setItem = (t, s) => {
+  a[t] === void 0 && D.call(r, t, s);
+};
+r.removeItem = (t) => {
+  a[t] === void 0 && L.call(r, t);
+};
+r.clear = () => {
+  j(), w();
+};
+let p = r.length;
+const w = () => {
+  p !== r.length && (p = r.length, Object.keys(a).forEach((t) => {
+    t in r || (I(t), a[t]());
+  }));
+}, N = /* @__PURE__ */ (() => {
+  let t = !1;
+  return () => {
+    if (t) return;
+    t = !0;
+    let s;
+    const n = () => {
+      clearInterval(s), s = setInterval(w, 0), w();
+    };
+    n(), window.addEventListener("focus", () => clearInterval(s), !0), window.addEventListener("focus", () => clearInterval(s), !1), window.addEventListener("click", () => clearInterval(s), !1), window.addEventListener("click", () => clearInterval(s), !0), window.addEventListener("blur", n, !0);
+  };
+})();
+(() => {
+  const t = (n) => {
+    var c;
+    n in r || (c = a[n]) == null || c.call(a);
+  }, s = () => Object.keys(u).forEach(t);
+  Object.defineProperty(window, "localStorage", {
+    get: () => (Promise.resolve().then(s), r)
+  });
+})();
+const U = (t) => t;
+let y = () => {
   throw "call configureAtomaric() before all!";
 };
-const y = (t) => S = t.useSyncExternalStore, v = (t) => S(t.subscribe, t.get), w = (t) => t.set, k = (t) => t.setDeferred, A = (t) => t.get, T = (t) => t.toggle, D = (t) => t.inkrement, N = (t) => [v(t), w(t)], E = (t, i) => new d(t, i);
+const J = (t) => y = t.useSyncExternalStore, V = (t) => y(t.subscribe, t.get), x = (t) => t.set, B = (t) => t.setDeferred, G = (t) => t.get, M = (t) => t.do, P = (t) => [V(t), x(t)], R = (t, s) => new T(t, s);
 export {
-  d as Atom,
-  E as atom,
-  y as configureAtomaric,
-  N as useAtom,
-  A as useAtomGet,
-  D as useAtomInkrement,
-  w as useAtomSet,
-  k as useAtomSetDeferred,
-  T as useAtomToggle,
-  v as useAtomValue
+  T as Atom,
+  R as atom,
+  J as configureAtomaric,
+  P as useAtom,
+  M as useAtomDo,
+  G as useAtomGet,
+  x as useAtomSet,
+  B as useAtomSetDeferred,
+  V as useAtomValue
 };

package/build/atomaric.umd.cjs

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

package/package.json

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

package/types/model.d.ts

@@ -2,9 +2,7 @@ type Sunscriber<Value> = (value: Value) => void;
 
 export type AtomStoreKey = `${string}${string}:${string}${string}`;
 
-export type AtomOptions<Value> = {
-  /** save in localStorage by this key */
-  storeKey: AtomStoreKey;
+export type AtomOptions<Value, Actions extends Record<string, Function> = Record<string, Function>> = {
   /** **default: true** */
   warnOnDuplicateStoreKey?: boolean;
   /** will update value if localStorage value is changed
@@ -19,7 +17,15 @@ export type AtomOptions<Value> = {
    * **default: false**
    */
   unchangable?: boolean;
-};
+} & (
+  | {
+      /** save in localStorage by this key */
+      storeKey: AtomStoreKey;
+    }
+  | {
+      do: (get: () => Value, set: (value: Value, isPreventSave?: boolean) => void) => Actions;
+    }
+);
 
 export type AtomSetMethod<Value> = (value: Value | ((prev: Value) => Value), isPreventSave?: boolean) => void;
 export type AtomSetDeferredMethod<Value> = (
@@ -31,30 +37,67 @@ 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 UpdateAction<Value> = {
+  update: (updater: (value: Value) => void) => void;
+};
+
+export type NumberActions<Value> = {
+  increment: (delta?: number) => void;
+};
+
+export type BooleanActions<Value> = {
+  toggle: () => void;
+};
+
+export type SetActions<Value> = UpdateAction<Value> & {
+  add: (value: Value) => void;
+  delete: (value: Value) => void;
+  clear: () => void;
+};
+
+export type ArrayActions<Value> = UpdateAction<Value[]> & {
+  push: (value: Value) => void;
+  unshift: (value: Value) => void;
+  filter: (filter?: (value: Value, index: number, array: Value[]) => any) => void;
+};
+
+export type DefaultActions<Value> = Value extends Set<infer V>
+  ? SetActions<V>
+  : Value extends boolean
+  ? BooleanActions<Value>
+  : Value extends (infer Val)[]
+  ? ArrayActions<Val>
+  : Value extends number
+  ? NumberActions<Value>
+  : {};
+
+export class Atom<Value, Actions extends Record<string, Function>> {
+  constructor(defaultValue: Value, storeKeyOrOptions: AtomStoreKey | undefined | AtomOptions<Value, Actions>);
 
   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: AtomSubscribeMethod<Value>;
+  do: Actions & DefaultActions<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'];
+export function useAtomDo<Value>(atom: Atom<Value>): (typeof atom)['do'];
 
 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;