atomaric 0.0.15 → 0.0.16

package/build/atomaric.js

@@ -3,7 +3,7 @@ class C {
     let _ = s, g, p = () => {
     };
     const D = (e) => _ = e, m = () => _;
-    this.get = () => m();
+    this.get = () => m(), Object.defineProperty(this, "do", { get: () => N() }), Object.defineProperty(this, "defaultValue", { get: () => s });
     let N = () => {
       let e = null;
       typeof s == "number" ? e = w(
@@ -59,7 +59,6 @@ class C {
       ) : {}, ...e };
       return N = () => c, c;
     };
-    Object.defineProperty(this, "do", { get: () => N() }), Object.defineProperty(this, "defaultValue", { get: () => s });
     const S = /* @__PURE__ */ new Set(), j = (e) => e(this.get());
     this.subscribe = (e) => (S.add(e), () => (S.delete(e), void 0));
     const i = (e, a) => {
@@ -111,12 +110,11 @@ class C {
     });
   }
 }
-const f = window.localStorage, h = {}, I = (t) => t;
+const f = window.localStorage, h = {}, I = (t) => t, w = (t, s) => t;
 window.addEventListener("storage", (t) => {
   var s;
   t.key === null || t.newValue === t.oldValue || (s = h[t.key]) == null || s.call(h, t);
 });
-const w = (t, s) => t;
 let E = () => {
   throw "call configureAtomaric() before all!";
 };

package/build/atomaric.umd.cjs

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

package/package.json

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

package/types/model.d.ts

@@ -19,6 +19,7 @@ export type AtomOptions<Value, Actions extends Record<string, Function> = {}> =
       storeKey: AtomStoreKey;
     }
   | {
+      /** declare your custom actions */
       do: (get: () => Value, set: (value: Value, isPreventSave?: boolean) => void) => Actions;
     }
 );
@@ -57,8 +58,8 @@ export type ArrayActions<Value> = UpdateAction<Value[]> & {
   filter: (filter?: (value: Value, index: number, array: Value[]) => any) => void;
 };
 
-export type DefaultActions<Value> = Value extends Set<infer V>
-  ? SetActions<V>
+export type DefaultActions<Value> = Value extends Set<infer Val>
+  ? SetActions<Val>
   : Value extends boolean
   ? BooleanActions<Value>
   : Value extends (infer Val)[]
@@ -68,27 +69,36 @@ export type DefaultActions<Value> = Value extends Set<infer V>
   : {};
 
 export class Atom<Value, Actions extends Record<string, Function> = {}> {
-  constructor(defaultValue: Value, storeKeyOrOptions: AtomStoreKey | undefined | AtomOptions<Value, Actions>);
+  constructor(defaultValue: Value, storeKeyOrOptions: StoreKeyOrOptions<Value, Actions> | undefined);
 
   readonly defaultValue: Value;
   readonly get: () => Value;
   readonly set: AtomSetMethod<Value>;
   readonly setDeferred: AtomSetDeferredMethod<Value>;
+  /** set default (initial) value as current */
   readonly reset: () => void;
+  /** subscribe on value changes */
   readonly subscribe: AtomSubscribeMethod<Value>;
-  do: Actions & DefaultActions<Value>;
+  /** your custom actions */
+  readonly do: Actions & DefaultActions<Value>;
 }
 
+export function useAtom<Value>(atom: Atom<Value>): [Value, AtomSetMethod<Value>];
+
+/** observable atom 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 useAtomDo<Value>(atom: Atom<Value>): (typeof atom)['do'];
 
-export function useAtom<Value>(atom: Atom<Value>): [Value, (typeof atom)['set']];
+export function useAtomSet<Value>(atom: Atom<Value>): AtomSetMethod<Value>;
+export function useAtomSetDeferred<Value>(atom: Atom<Value>): AtomSetDeferredMethod<Value>;
+export function useAtomGet<Value>(atom: Atom<Value>): () => Value;
+
+/** get your custom actions */
+export function useAtomDo<Value, Actions extends Record<string, Function> = {}>(
+  atom: Atom<Value, Actions>,
+): Actions & DefaultActions<Value>;
 
 export type StoreKeyOrOptions<Value, Actions extends Record<string, Function> = {}> =
-  | `${string}${string}:${string}${string}`
+  | AtomStoreKey
   | AtomOptions<Value, Actions>;
 
 export function atom<Value, Actions extends Record<string, Function> = {}>(
@@ -96,4 +106,4 @@ export function atom<Value, Actions extends Record<string, Function> = {}>(
   storeKeyOrOptions?: StoreKeyOrOptions<Value, Actions>,
 ): Atom<Value, Actions>;
 
-export function configureAtomaric(hooks: { useSyncExternalStore: typeof useSyncExternalStore }): void;
+export function configureAtomaric(options: { useSyncExternalStore: typeof useSyncExternalStore }): void;