atomirx 0.1.1 → 0.1.2

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-BZEnfIcB.cjs"),o=require("./onErrorHook-DHBASmYw.cjs");exports.AllAtomsRejectedError=e.AllAtomsRejectedError;exports.atom=e.atom;exports.batch=e.batch;exports.define=e.define;exports.derived=e.derived;exports.effect=e.effect;exports.emitter=e.emitter;exports.getAtomState=e.getAtomState;exports.isAtom=e.isAtom;exports.isDerived=e.isDerived;exports.isFulfilled=e.isFulfilled;exports.isPending=e.isPending;exports.isPool=e.isPool;exports.isRejected=e.isRejected;exports.isScopedAtom=e.isScopedAtom;exports.pool=e.pool;exports.promisesEqual=e.promisesEqual;exports.readonly=e.readonly;exports.select=e.select;exports.trackPromise=e.trackPromise;exports.unwrap=e.unwrap;exports.onCreateHook=o.onCreateHook;exports.onErrorHook=o.onErrorHook;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-B1Kum0se.cjs"),r=require("./onErrorHook-DHBASmYw.cjs");exports.AllAtomsRejectedError=e.AllAtomsRejectedError;exports.abortable=e.abortable;exports.atom=e.atom;exports.batch=e.batch;exports.createAbortError=e.createAbortError;exports.createRejectedPromise=e.createRejectedPromise;exports.createResolvedPromise=e.createResolvedPromise;exports.define=e.define;exports.derived=e.derived;exports.effect=e.effect;exports.emitter=e.emitter;exports.event=e.event;exports.getAtomState=e.getAtomState;exports.isAbortError=e.isAbortError;exports.isAtom=e.isAtom;exports.isDerived=e.isDerived;exports.isEvent=e.isEvent;exports.isFulfilled=e.isFulfilled;exports.isPending=e.isPending;exports.isPool=e.isPool;exports.isRejected=e.isRejected;exports.isScopedAtom=e.isScopedAtom;exports.pool=e.pool;exports.promisesEqual=e.promisesEqual;exports.readonly=e.readonly;exports.select=e.select;exports.trackPromise=e.trackPromise;exports.unwrap=e.unwrap;exports.onCreateHook=r.onCreateHook;exports.onErrorHook=r.onErrorHook;

package/dist/index.d.ts

@@ -1,17 +1,21 @@
+export { abortable, isAbortError, createAbortError } from './core/abortable';
+export type { AbortableOptions, AbortablePromise } from './core/abortable';
 export { atom, readonly } from './core/atom';
 export { batch } from './core/batch';
 export { define } from './core/define';
 export { derived, type DerivedContext } from './core/derived';
 export { effect, type EffectContext } from './core/effect';
 export { emitter } from './core/emitter';
+export { event, isEvent } from './core/event';
+export type { EventOptions } from './core/event';
 export { isAtom, isDerived } from './core/isAtom';
 export { pool, isPool } from './core/pool';
 export { select, AllAtomsRejectedError, isScopedAtom, type Condition, } from './core/select';
 export { getAtomState } from './core/getAtomState';
-export { isPending, isFulfilled, isRejected, trackPromise, unwrap, } from './core/promiseCache';
-export type { Atom, AtomMeta, AtomOptions, AtomState, AtomValue, AnyAtom, DerivedAtom, DerivedAtomMeta, DerivedOptions, EffectOptions, Equality, EqualityShorthand, Getter, KeyedResult, MutableAtom, MutableAtomMeta, Pipeable, Pool, PoolEvent, PoolMeta, PoolOptions, SelectStateResult, SettledResult, ScopedAtom, } from './core/types';
+export { isPending, isFulfilled, isRejected, trackPromise, unwrap, createResolvedPromise, createRejectedPromise, } from './core/promiseCache';
+export type { Atom, AtomMeta, AtomOptions, AtomState, AtomValue, AnyAtom, DerivedAtom, DerivedAtomMeta, DerivedOptions, EffectOptions, Equality, EqualityShorthand, Event, EventMeta, Getter, KeyedResult, MutableAtom, MutableAtomMeta, Pipeable, Pool, PoolEvent, PoolMeta, PoolOptions, SelectStateResult, SettledResult, ScopedAtom, } from './core/types';
 export { onCreateHook } from './core/onCreateHook';
-export type { CreateInfo, MutableInfo, DerivedInfo, EffectInfo, ModuleInfo, } from './core/onCreateHook';
+export type { CreateInfo, MutableInfo, DerivedInfo, EffectInfo, EventInfo, ModuleInfo, } from './core/onCreateHook';
 export { onErrorHook } from './core/onErrorHook';
 export type { ErrorInfo } from './core/onErrorHook';
 export type { SelectContext, SelectOutput, SelectResult, ReactiveSelector as ContextSelectorFn, SafeResult, } from './core/select';

package/dist/index.js

@@ -1,27 +1,34 @@
-import { A as e, c as o, f as r, g as t, h as i, j as l, k as m, o as d, i as c, l as n, u as f, q as p, m as A, v as k, n as u, p as g, z as j, e as v, s as x, x as E, y as P } from "./index-BbPZhsDl.js";
-import { o as q, a as y } from "./onErrorHook-BGGy3tqK.js";
+import { A as a, c as o, g as r, j as t, f as i, G as l, F as m, k as c, l as d, m as n, n as A, o as f, y as p, e as E, i as v, q as b, p as P, B as j, z as k, v as u, C as R, x as g, u as x, H, h, s as q, D as y, E as C } from "./index-DbZ2r2Im.js";
+import { o as F, a as S } from "./onErrorHook-BGGy3tqK.js";
 export {
-  e as AllAtomsRejectedError,
-  o as atom,
-  r as batch,
-  t as define,
-  i as derived,
-  l as effect,
-  m as emitter,
-  d as getAtomState,
-  c as isAtom,
-  n as isDerived,
-  f as isFulfilled,
-  p as isPending,
-  A as isPool,
-  k as isRejected,
-  u as isScopedAtom,
-  q as onCreateHook,
-  y as onErrorHook,
-  g as pool,
-  j as promisesEqual,
-  v as readonly,
-  x as select,
-  E as trackPromise,
-  P as unwrap
+  a as AllAtomsRejectedError,
+  o as abortable,
+  r as atom,
+  t as batch,
+  i as createAbortError,
+  l as createRejectedPromise,
+  m as createResolvedPromise,
+  c as define,
+  d as derived,
+  n as effect,
+  A as emitter,
+  f as event,
+  p as getAtomState,
+  E as isAbortError,
+  v as isAtom,
+  b as isDerived,
+  P as isEvent,
+  j as isFulfilled,
+  k as isPending,
+  u as isPool,
+  R as isRejected,
+  g as isScopedAtom,
+  F as onCreateHook,
+  S as onErrorHook,
+  x as pool,
+  H as promisesEqual,
+  h as readonly,
+  q as select,
+  y as trackPromise,
+  C as unwrap
 };

package/dist/react/index.cjs

@@ -1 +1 @@
-"use strict";var F=Object.defineProperty;var z=(r,e,n)=>e in r?F(r,e,{enumerable:!0,configurable:!0,writable:!0,value:n}):r[e]=n;var w=(r,e,n)=>z(r,typeof e!="symbol"?e+"":e,n);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("react"),t=require("../index-BZEnfIcB.cjs"),y=require("../onDispatchHook-C8yLzr-o.cjs"),d=require("react/jsx-runtime"),H=require("../onErrorHook-DHBASmYw.cjs");function C(r,e){const n=t.isAtom(r)?({read:p})=>p(r):r,m=t.resolveEquality(e??"shallow"),s=o.useRef(n),R=o.useRef(m);s.current=n,R.current=m;const a=o.useRef(new Map),u=o.useRef(new Set),c=o.useRef([]),b=o.useRef(new Map),l=o.useRef({value:void 0,initialized:!1}),A=o.useCallback(()=>{const{result:p}=t.select(s.current);if(u.current=p._atomDeps,b.current=p._poolDeps,p.promise!==void 0)throw p.promise;if(p.error!==void 0)throw p.error;const E=p.value;return(!l.current.initialized||!R.current(E,l.current.value))&&(l.current={value:E,initialized:!0}),l.current.value},[]),k=o.useCallback(p=>{const E=a.current,g=()=>{const{result:f}=t.select(s.current);u.current=f._atomDeps,b.current=f._poolDeps,i(),p()},i=()=>{const f=u.current,v=b.current;for(const[h,D]of E)f.has(h)||(D(),E.delete(h));for(const h of f)E.has(h)||E.set(h,h.on(g));for(const h of c.current)h();c.current=[];for(const[h,D]of v)for(const x of D)c.current.push(h._onRemove(x,g))};return i(),()=>{for(const f of E.values())f();E.clear();for(const f of c.current)f();c.current=[]}},[]);return o.useSyncExternalStore(k,A,A)}function _(r){return r==null?Object.is:Array.isArray(r)?"shallow":r instanceof Date?t.deepEqual:typeof r=="object"?t.shallowEqual:Object.is}function I(r,e){const n=o.useRef({}),m=o.useRef(null);m.current===null&&(m.current={});const s=n.current,R=m.current;for(const a of Object.keys(r)){const u=r[a],c=s[a];if(typeof u=="function"){const[k]=t.tryStabilize(c,u,()=>!1);s[a]={value:k},R[a]=k;continue}const b=e==null?void 0:e[a],l=b?t.resolveEquality(b):t.resolveEquality(_(u)),[A]=t.tryStabilize(c,u,l);s[a]={value:A},R[a]=A}for(const a of Object.keys(s))a in r||(delete s[a],delete R[a]);return R}const P={status:"idle",result:void 0,error:void 0},T={status:"loading",result:void 0,error:void 0};function L(r,e){switch(e.type){case"START":return T;case"SUCCESS":return{status:"success",result:e.result,error:void 0};case"ERROR":return{status:"error",result:void 0,error:e.error};case"RESET":return P;default:return r}}function M(r,e={}){const{lazy:n=!0,exclusive:m=!0,deps:s=[]}=e,R=n?P:T,[a,u]=o.useReducer(L,R),c=o.useRef(null),b=o.useRef(r);b.current=r;const l=o.useCallback(()=>{const i=c.current;return i?(i.abort(),c.current=null,!0):!1},[]),A=(n?[]:s??[]).filter(t.isAtom),k=C(({read:i})=>A.map(f=>i(f))),p=o.useCallback(()=>{var v,h,D,x,q,O;m&&l();const i=new AbortController;c.current=i,u({type:"START"}),(h=(v=y.onDispatchHook).current)==null||h.call(v,{type:"start",meta:e.meta,deps:s});let f;try{f=b.current(t.withUse({signal:i.signal}))}catch(j){return u({type:"ERROR",error:j}),(x=(D=y.onDispatchHook).current)==null||x.call(D,{type:"error",meta:e.meta,deps:s,error:j}),Object.assign(Promise.reject(j),{abort:()=>i.abort()})}if(t.isPromiseLike(f)){const j=f;return(O=(q=y.onDispatchHook).current)==null||O.call(q,{type:"loading",meta:e.meta,deps:s}),j.then(S=>{c.current===i&&(u({type:"SUCCESS",result:S}),y.onDispatchHook.current&&y.onDispatchHook.current({type:"resolved",meta:e.meta,deps:s}))},S=>{if(S instanceof DOMException&&S.name==="AbortError"){(c.current===null||c.current===i)&&(u({type:"ERROR",error:S}),y.onDispatchHook.current&&y.onDispatchHook.current({type:"abort",meta:e.meta,deps:s,error:S}));return}c.current===i&&(u({type:"ERROR",error:S}),y.onDispatchHook.current&&y.onDispatchHook.current({type:"rejected",meta:e.meta,deps:s,error:S}))}),Object.assign(j,{abort:()=>{i.abort(),c.current===i&&(c.current=null)}})}else y.onDispatchHook.current&&y.onDispatchHook.current({type:"success",meta:e.meta,deps:s});return u({type:"SUCCESS",result:f}),Object.assign(Promise.resolve(f),{abort:()=>i.abort()})},[m,l]),E=(s??[]).filter(i=>!t.isAtom(i));o.useEffect(()=>{n||p()},[n,...k,...E]),o.useEffect(()=>()=>{m&&l()},[m,l]);const g=o.useCallback(()=>{m&&l(),u({type:"RESET"})},[m,l]);return Object.assign(p,{...a,abort:l,reset:g})}function U(r,e){const n=e===void 0?void 0:typeof e=="object"&&e!==null&&!Array.isArray(e)&&("equals"in e||"loading"in e||"error"in e)?e:{equals:e};return d.jsx(J,{selectorOrAtom:r,options:n})}class V extends o.Component{constructor(){super(...arguments);w(this,"state",{error:null})}static getDerivedStateFromError(n){return{error:n}}componentDidCatch(n,m){}render(){if(this.state.error!==null&&this.props.onError)return d.jsx(d.Fragment,{children:this.props.onError({error:this.state.error})});if(this.state.error!==null)throw this.state.error;return this.props.children}}function W(r){const e=C(r.selector,r.equals);return d.jsx(d.Fragment,{children:e??null})}function B(r){return d.jsx(d.Fragment,{children:r.render()})}function G(r){return r.fallback?d.jsx(o.Suspense,{fallback:d.jsx(B,{render:r.fallback}),children:r.children}):d.jsx(d.Fragment,{children:r.children})}function N(r){return r.onError?d.jsx(V,{onError:r.onError,children:r.children}):d.jsx(d.Fragment,{children:r.children})}const J=o.memo(function(e){var u,c,b,l;const n=o.useRef(e.selectorOrAtom);n.current=e.selectorOrAtom;const m=t.isAtom(e.selectorOrAtom),s=(u=e.options)==null?void 0:u.deps,R=m?[e.selectorOrAtom,...s??[]]:s??[{}],a=o.useCallback(A=>t.isAtom(n.current)?A.read(n.current):n.current(A),R);return d.jsx(N,{onError:(c=e.options)==null?void 0:c.error,children:d.jsx(G,{fallback:(b=e.options)==null?void 0:b.loading,children:d.jsx(W,{selector:a,equals:(l=e.options)==null?void 0:l.equals})})})},(r,e)=>t.shallowEqual(r.selectorOrAtom,e.selectorOrAtom)&&t.shallowEqual(r.options,e.options));exports.AllAtomsRejectedError=t.AllAtomsRejectedError;exports.atom=t.atom;exports.batch=t.batch;exports.define=t.define;exports.derived=t.derived;exports.effect=t.effect;exports.emitter=t.emitter;exports.getAtomState=t.getAtomState;exports.isAtom=t.isAtom;exports.isDerived=t.isDerived;exports.isFulfilled=t.isFulfilled;exports.isPending=t.isPending;exports.isPool=t.isPool;exports.isRejected=t.isRejected;exports.isScopedAtom=t.isScopedAtom;exports.pool=t.pool;exports.promisesEqual=t.promisesEqual;exports.readonly=t.readonly;exports.select=t.select;exports.trackPromise=t.trackPromise;exports.unwrap=t.unwrap;exports.onCreateHook=H.onCreateHook;exports.onErrorHook=H.onErrorHook;exports.rx=U;exports.useAction=M;exports.useSelector=C;exports.useStable=I;
+"use strict";var F=Object.defineProperty;var z=(r,e,n)=>e in r?F(r,e,{enumerable:!0,configurable:!0,writable:!0,value:n}):r[e]=n;var w=(r,e,n)=>z(r,typeof e!="symbol"?e+"":e,n);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("react"),t=require("../index-B1Kum0se.cjs"),A=require("../onDispatchHook-C8yLzr-o.cjs"),d=require("react/jsx-runtime"),H=require("../onErrorHook-DHBASmYw.cjs");function C(r,e){const n=t.isAtom(r)?({read:b})=>b(r):r,m=t.resolveEquality(e??"shallow"),s=o.useRef(n),h=o.useRef(m);s.current=n,h.current=m;const a=o.useRef(new Map),u=o.useRef(new Set),c=o.useRef([]),R=o.useRef(new Map),l=o.useRef({value:void 0,initialized:!1}),y=o.useCallback(()=>{const{result:b}=t.select(s.current);if(u.current=b._atomDeps,R.current=b._poolDeps,b.promise!==void 0)throw b.promise;if(b.error!==void 0)throw b.error;const E=b.value;return(!l.current.initialized||!h.current(E,l.current.value))&&(l.current={value:E,initialized:!0}),l.current.value},[]),k=o.useCallback(b=>{const E=a.current,D=()=>{const{result:f}=t.select(s.current);u.current=f._atomDeps,R.current=f._poolDeps,i(),b()},i=()=>{const f=u.current,g=R.current;for(const[p,v]of E)f.has(p)||(v(),E.delete(p));for(const p of f)E.has(p)||E.set(p,p.on(D));for(const p of c.current)p();c.current=[];for(const[p,v]of g)for(const x of v)c.current.push(p._onRemove(x,D))};return i(),()=>{for(const f of E.values())f();E.clear();for(const f of c.current)f();c.current=[]}},[]);return o.useSyncExternalStore(k,y,y)}function _(r){return r==null?Object.is:Array.isArray(r)?"shallow":r instanceof Date?t.deepEqual:typeof r=="object"?t.shallowEqual:Object.is}function I(r,e){const n=o.useRef({}),m=o.useRef(null);m.current===null&&(m.current={});const s=n.current,h=m.current;for(const a of Object.keys(r)){const u=r[a],c=s[a];if(typeof u=="function"){const[k]=t.tryStabilize(c,u,()=>!1);s[a]={value:k},h[a]=k;continue}const R=e==null?void 0:e[a],l=R?t.resolveEquality(R):t.resolveEquality(_(u)),[y]=t.tryStabilize(c,u,l);s[a]={value:y},h[a]=y}for(const a of Object.keys(s))a in r||(delete s[a],delete h[a]);return h}const P={status:"idle",result:void 0,error:void 0},T={status:"loading",result:void 0,error:void 0};function L(r,e){switch(e.type){case"START":return T;case"SUCCESS":return{status:"success",result:e.result,error:void 0};case"ERROR":return{status:"error",result:void 0,error:e.error};case"RESET":return P;default:return r}}function M(r,e={}){const{lazy:n=!0,exclusive:m=!0,deps:s=[]}=e,h=n?P:T,[a,u]=o.useReducer(L,h),c=o.useRef(null),R=o.useRef(r);R.current=r;const l=o.useCallback(()=>{const i=c.current;return i?(i.abort(),c.current=null,!0):!1},[]),y=(n?[]:s??[]).filter(t.isAtom),k=C(({read:i})=>y.map(f=>i(f))),b=o.useCallback(()=>{var g,p,v,x,q,O;m&&l();const i=new AbortController;c.current=i,u({type:"START"}),(p=(g=A.onDispatchHook).current)==null||p.call(g,{type:"start",meta:e.meta,deps:s});let f;try{f=R.current(t.withUse({signal:i.signal}))}catch(j){return u({type:"ERROR",error:j}),(x=(v=A.onDispatchHook).current)==null||x.call(v,{type:"error",meta:e.meta,deps:s,error:j}),Object.assign(Promise.reject(j),{abort:()=>i.abort()})}if(t.isPromiseLike(f)){const j=f;return(O=(q=A.onDispatchHook).current)==null||O.call(q,{type:"loading",meta:e.meta,deps:s}),j.then(S=>{c.current===i&&(u({type:"SUCCESS",result:S}),A.onDispatchHook.current&&A.onDispatchHook.current({type:"resolved",meta:e.meta,deps:s}))},S=>{if(S instanceof DOMException&&S.name==="AbortError"){(c.current===null||c.current===i)&&(u({type:"ERROR",error:S}),A.onDispatchHook.current&&A.onDispatchHook.current({type:"abort",meta:e.meta,deps:s,error:S}));return}c.current===i&&(u({type:"ERROR",error:S}),A.onDispatchHook.current&&A.onDispatchHook.current({type:"rejected",meta:e.meta,deps:s,error:S}))}),Object.assign(j,{abort:()=>{i.abort(),c.current===i&&(c.current=null)}})}else A.onDispatchHook.current&&A.onDispatchHook.current({type:"success",meta:e.meta,deps:s});return u({type:"SUCCESS",result:f}),Object.assign(Promise.resolve(f),{abort:()=>i.abort()})},[m,l]),E=(s??[]).filter(i=>!t.isAtom(i));o.useEffect(()=>{n||b()},[n,...k,...E]),o.useEffect(()=>()=>{m&&l()},[m,l]);const D=o.useCallback(()=>{m&&l(),u({type:"RESET"})},[m,l]);return Object.assign(b,{...a,abort:l,reset:D})}function U(r,e){const n=e===void 0?void 0:typeof e=="object"&&e!==null&&!Array.isArray(e)&&("equals"in e||"loading"in e||"error"in e)?e:{equals:e};return d.jsx(J,{selectorOrAtom:r,options:n})}class V extends o.Component{constructor(){super(...arguments);w(this,"state",{error:null})}static getDerivedStateFromError(n){return{error:n}}componentDidCatch(n,m){}render(){if(this.state.error!==null&&this.props.onError)return d.jsx(d.Fragment,{children:this.props.onError({error:this.state.error})});if(this.state.error!==null)throw this.state.error;return this.props.children}}function W(r){const e=C(r.selector,r.equals);return d.jsx(d.Fragment,{children:e??null})}function B(r){return d.jsx(d.Fragment,{children:r.render()})}function G(r){return r.fallback?d.jsx(o.Suspense,{fallback:d.jsx(B,{render:r.fallback}),children:r.children}):d.jsx(d.Fragment,{children:r.children})}function N(r){return r.onError?d.jsx(V,{onError:r.onError,children:r.children}):d.jsx(d.Fragment,{children:r.children})}const J=o.memo(function(e){var u,c,R,l;const n=o.useRef(e.selectorOrAtom);n.current=e.selectorOrAtom;const m=t.isAtom(e.selectorOrAtom),s=(u=e.options)==null?void 0:u.deps,h=m?[e.selectorOrAtom,...s??[]]:s??[{}],a=o.useCallback(y=>t.isAtom(n.current)?y.read(n.current):n.current(y),h);return d.jsx(N,{onError:(c=e.options)==null?void 0:c.error,children:d.jsx(G,{fallback:(R=e.options)==null?void 0:R.loading,children:d.jsx(W,{selector:a,equals:(l=e.options)==null?void 0:l.equals})})})},(r,e)=>t.shallowEqual(r.selectorOrAtom,e.selectorOrAtom)&&t.shallowEqual(r.options,e.options));exports.AllAtomsRejectedError=t.AllAtomsRejectedError;exports.abortable=t.abortable;exports.atom=t.atom;exports.batch=t.batch;exports.createAbortError=t.createAbortError;exports.createRejectedPromise=t.createRejectedPromise;exports.createResolvedPromise=t.createResolvedPromise;exports.define=t.define;exports.derived=t.derived;exports.effect=t.effect;exports.emitter=t.emitter;exports.event=t.event;exports.getAtomState=t.getAtomState;exports.isAbortError=t.isAbortError;exports.isAtom=t.isAtom;exports.isDerived=t.isDerived;exports.isEvent=t.isEvent;exports.isFulfilled=t.isFulfilled;exports.isPending=t.isPending;exports.isPool=t.isPool;exports.isRejected=t.isRejected;exports.isScopedAtom=t.isScopedAtom;exports.pool=t.pool;exports.promisesEqual=t.promisesEqual;exports.readonly=t.readonly;exports.select=t.select;exports.trackPromise=t.trackPromise;exports.unwrap=t.unwrap;exports.onCreateHook=H.onCreateHook;exports.onErrorHook=H.onErrorHook;exports.rx=U;exports.useAction=M;exports.useSelector=C;exports.useStable=I;

package/dist/react/index.js

@@ -1,16 +1,16 @@
 var M = Object.defineProperty;
 var V = (r, e, t) => e in r ? M(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t;
-var _ = (r, e, t) => V(r, typeof e != "symbol" ? e + "" : e, t);
-import { useRef as p, useCallback as D, useSyncExternalStore as W, useReducer as B, useEffect as P, memo as G, Suspense as N, Component as J } from "react";
-import { i as O, r as w, s as F, t as I, d as K, a as q, w as Q, b as X } from "../index-BbPZhsDl.js";
-import { A as he, c as Re, f as Ee, g as ye, h as Se, j as Ae, k as ve, o as ge, l as De, u as Oe, q as je, m as ke, v as xe, n as Ce, p as we, z as qe, e as Te, x as ze, y as _e } from "../index-BbPZhsDl.js";
+var P = (r, e, t) => V(r, typeof e != "symbol" ? e + "" : e, t);
+import { useRef as b, useCallback as D, useSyncExternalStore as B, useReducer as G, useEffect as _, memo as W, Suspense as N, Component as J } from "react";
+import { i as O, r as w, s as F, t as I, d as K, a as q, w as Q, b as X } from "../index-DbZ2r2Im.js";
+import { A as he, c as Re, g as Ee, j as ye, f as Se, G as Ae, F as ve, k as ge, l as De, m as Oe, n as je, o as Ce, y as ke, e as xe, q as we, p as qe, B as Te, z as ze, v as Pe, C as _e, x as Fe, u as Ie, H as He, h as Le, D as Ue, E as Me } from "../index-DbZ2r2Im.js";
 import { o as E } from "../onDispatchHook-SKbiIUaJ.js";
-import { jsx as b, Fragment as j } from "react/jsx-runtime";
-import { o as Fe, a as Ie } from "../onErrorHook-BGGy3tqK.js";
-function L(r, e) {
-  const t = O(r) ? ({ read: f }) => f(r) : r, l = w(e ?? "shallow"), n = p(t), h = p(l);
+import { jsx as p, Fragment as j } from "react/jsx-runtime";
+import { o as Be, a as Ge } from "../onErrorHook-BGGy3tqK.js";
+function H(r, e) {
+  const t = O(r) ? ({ read: f }) => f(r) : r, l = w(e ?? "shallow"), n = b(t), h = b(l);
   n.current = t, h.current = l;
-  const u = p(/* @__PURE__ */ new Map()), s = p(/* @__PURE__ */ new Set()), o = p([]), m = p(/* @__PURE__ */ new Map()), a = p({
+  const a = b(/* @__PURE__ */ new Map()), s = b(/* @__PURE__ */ new Set()), o = b([]), m = b(/* @__PURE__ */ new Map()), u = b({
     value: void 0,
     initialized: !1
   }), y = D(() => {
@@ -20,23 +20,23 @@ function L(r, e) {
     if (f.error !== void 0)
       throw f.error;
     const R = f.value;
-    return (!a.current.initialized || !h.current(R, a.current.value)) && (a.current = { value: R, initialized: !0 }), a.current.value;
+    return (!u.current.initialized || !h.current(R, u.current.value)) && (u.current = { value: R, initialized: !0 }), u.current.value;
   }, []), A = D((f) => {
-    const R = u.current, k = () => {
+    const R = a.current, C = () => {
       const { result: i } = F(n.current);
       s.current = i._atomDeps, m.current = i._poolDeps, c(), f();
     }, c = () => {
-      const i = s.current, x = m.current;
+      const i = s.current, k = m.current;
       for (const [d, v] of R)
         i.has(d) || (v(), R.delete(d));
       for (const d of i)
-        R.has(d) || R.set(d, d.on(k));
+        R.has(d) || R.set(d, d.on(C));
       for (const d of o.current)
         d();
       o.current = [];
-      for (const [d, v] of x)
-        for (const C of v)
-          o.current.push(d._onRemove(C, k));
+      for (const [d, v] of k)
+        for (const x of v)
+          o.current.push(d._onRemove(x, C));
     };
     return c(), () => {
       for (const i of R.values())
@@ -47,17 +47,17 @@ function L(r, e) {
       o.current = [];
     };
   }, []);
-  return W(A, y, y);
+  return B(A, y, y);
 }
 function Y(r) {
   return r == null ? Object.is : Array.isArray(r) ? "shallow" : r instanceof Date ? K : typeof r == "object" ? q : Object.is;
 }
 function fe(r, e) {
-  const t = p({}), l = p(null);
+  const t = b({}), l = b(null);
   l.current === null && (l.current = {});
   const n = t.current, h = l.current;
-  for (const u of Object.keys(r)) {
-    const s = r[u], o = n[u];
+  for (const a of Object.keys(r)) {
+    const s = r[a], o = n[a];
     if (typeof s == "function") {
       const [A] = I(
         o,
@@ -65,25 +65,25 @@ function fe(r, e) {
         () => !1
         // Equality doesn't matter for functions
       );
-      n[u] = { value: A }, h[u] = A;
+      n[a] = { value: A }, h[a] = A;
       continue;
     }
-    const m = e == null ? void 0 : e[u], a = m ? w(m) : w(Y(s)), [y] = I(
+    const m = e == null ? void 0 : e[a], u = m ? w(m) : w(Y(s)), [y] = I(
       o,
       s,
-      a
+      u
     );
-    n[u] = { value: y }, h[u] = y;
+    n[a] = { value: y }, h[a] = y;
   }
-  for (const u of Object.keys(n))
-    u in r || (delete n[u], delete h[u]);
+  for (const a of Object.keys(n))
+    a in r || (delete n[a], delete h[a]);
   return h;
 }
-const U = {
+const L = {
   status: "idle",
   result: void 0,
   error: void 0
-}, H = {
+}, U = {
   status: "loading",
   result: void 0,
   error: void 0
@@ -91,7 +91,7 @@ const U = {
 function Z(r, e) {
   switch (e.type) {
     case "START":
-      return H;
+      return U;
     case "SUCCESS":
       return {
         status: "success",
@@ -105,30 +105,30 @@ function Z(r, e) {
         error: e.error
       };
     case "RESET":
-      return U;
+      return L;
     default:
       return r;
   }
 }
 function de(r, e = {}) {
-  const { lazy: t = !0, exclusive: l = !0, deps: n = [] } = e, h = t ? U : H, [u, s] = B(
+  const { lazy: t = !0, exclusive: l = !0, deps: n = [] } = e, h = t ? L : U, [a, s] = G(
     Z,
     h
-  ), o = p(null), m = p(r);
+  ), o = b(null), m = b(r);
   m.current = r;
-  const a = D(() => {
+  const u = D(() => {
     const c = o.current;
     return c ? (c.abort(), o.current = null, !0) : !1;
-  }, []), y = (t ? [] : n ?? []).filter(O), A = L(({ read: c }) => y.map((i) => c(i))), f = D(() => {
-    var x, d, v, C, T, z;
-    l && a();
+  }, []), y = (t ? [] : n ?? []).filter(O), A = H(({ read: c }) => y.map((i) => c(i))), f = D(() => {
+    var k, d, v, x, T, z;
+    l && u();
     const c = new AbortController();
-    o.current = c, s({ type: "START" }), (d = (x = E).current) == null || d.call(x, { type: "start", meta: e.meta, deps: n });
+    o.current = c, s({ type: "START" }), (d = (k = E).current) == null || d.call(k, { type: "start", meta: e.meta, deps: n });
     let i;
     try {
       i = m.current(Q({ signal: c.signal }));
     } catch (g) {
-      return s({ type: "ERROR", error: g }), (C = (v = E).current) == null || C.call(v, {
+      return s({ type: "ERROR", error: g }), (x = (v = E).current) == null || x.call(v, {
         type: "error",
         meta: e.meta,
         deps: n,
@@ -182,24 +182,24 @@ function de(r, e = {}) {
     return s({ type: "SUCCESS", result: i }), Object.assign(Promise.resolve(i), {
       abort: () => c.abort()
     });
-  }, [l, a]), R = (n ?? []).filter((c) => !O(c));
-  P(() => {
+  }, [l, u]), R = (n ?? []).filter((c) => !O(c));
+  _(() => {
     t || f();
-  }, [t, ...A, ...R]), P(() => () => {
-    l && a();
-  }, [l, a]);
-  const k = D(() => {
-    l && a(), s({ type: "RESET" });
-  }, [l, a]);
+  }, [t, ...A, ...R]), _(() => () => {
+    l && u();
+  }, [l, u]);
+  const C = D(() => {
+    l && u(), s({ type: "RESET" });
+  }, [l, u]);
   return Object.assign(f, {
-    ...u,
-    abort: a,
-    reset: k
+    ...a,
+    abort: u,
+    reset: C
   });
 }
 function me(r, e) {
   const t = e === void 0 ? void 0 : typeof e == "object" && e !== null && !Array.isArray(e) && ("equals" in e || "loading" in e || "error" in e) ? e : { equals: e };
-  return /* @__PURE__ */ b(
+  return /* @__PURE__ */ p(
     oe,
     {
       selectorOrAtom: r,
@@ -210,7 +210,7 @@ function me(r, e) {
 class $ extends J {
   constructor() {
     super(...arguments);
-    _(this, "state", { error: null });
+    P(this, "state", { error: null });
   }
   static getDerivedStateFromError(t) {
     return { error: t };
@@ -220,64 +220,71 @@ class $ extends J {
   }
   render() {
     if (this.state.error !== null && this.props.onError)
-      return /* @__PURE__ */ b(j, { children: this.props.onError({ error: this.state.error }) });
+      return /* @__PURE__ */ p(j, { children: this.props.onError({ error: this.state.error }) });
     if (this.state.error !== null)
       throw this.state.error;
     return this.props.children;
   }
 }
 function ee(r) {
-  const e = L(r.selector, r.equals);
-  return /* @__PURE__ */ b(j, { children: e ?? null });
+  const e = H(r.selector, r.equals);
+  return /* @__PURE__ */ p(j, { children: e ?? null });
 }
 function re(r) {
-  return /* @__PURE__ */ b(j, { children: r.render() });
+  return /* @__PURE__ */ p(j, { children: r.render() });
 }
 function te(r) {
-  return r.fallback ? /* @__PURE__ */ b(N, { fallback: /* @__PURE__ */ b(re, { render: r.fallback }), children: r.children }) : /* @__PURE__ */ b(j, { children: r.children });
+  return r.fallback ? /* @__PURE__ */ p(N, { fallback: /* @__PURE__ */ p(re, { render: r.fallback }), children: r.children }) : /* @__PURE__ */ p(j, { children: r.children });
 }
 function ne(r) {
-  return r.onError ? /* @__PURE__ */ b($, { onError: r.onError, children: r.children }) : /* @__PURE__ */ b(j, { children: r.children });
+  return r.onError ? /* @__PURE__ */ p($, { onError: r.onError, children: r.children }) : /* @__PURE__ */ p(j, { children: r.children });
 }
-const oe = G(
+const oe = W(
   function(e) {
-    var s, o, m, a;
-    const t = p(e.selectorOrAtom);
+    var s, o, m, u;
+    const t = b(e.selectorOrAtom);
     t.current = e.selectorOrAtom;
-    const l = O(e.selectorOrAtom), n = (s = e.options) == null ? void 0 : s.deps, h = l ? [e.selectorOrAtom, ...n ?? []] : n ?? [{}], u = D(
+    const l = O(e.selectorOrAtom), n = (s = e.options) == null ? void 0 : s.deps, h = l ? [e.selectorOrAtom, ...n ?? []] : n ?? [{}], a = D(
       (y) => O(t.current) ? y.read(t.current) : t.current(y),
       h
     );
-    return /* @__PURE__ */ b(ne, { onError: (o = e.options) == null ? void 0 : o.error, children: /* @__PURE__ */ b(te, { fallback: (m = e.options) == null ? void 0 : m.loading, children: /* @__PURE__ */ b(ee, { selector: u, equals: (a = e.options) == null ? void 0 : a.equals }) }) });
+    return /* @__PURE__ */ p(ne, { onError: (o = e.options) == null ? void 0 : o.error, children: /* @__PURE__ */ p(te, { fallback: (m = e.options) == null ? void 0 : m.loading, children: /* @__PURE__ */ p(ee, { selector: a, equals: (u = e.options) == null ? void 0 : u.equals }) }) });
   },
   (r, e) => q(r.selectorOrAtom, e.selectorOrAtom) && q(r.options, e.options)
 );
 export {
   he as AllAtomsRejectedError,
-  Re as atom,
-  Ee as batch,
-  ye as define,
-  Se as derived,
-  Ae as effect,
-  ve as emitter,
-  ge as getAtomState,
+  Re as abortable,
+  Ee as atom,
+  ye as batch,
+  Se as createAbortError,
+  Ae as createRejectedPromise,
+  ve as createResolvedPromise,
+  ge as define,
+  De as derived,
+  Oe as effect,
+  je as emitter,
+  Ce as event,
+  ke as getAtomState,
+  xe as isAbortError,
   O as isAtom,
-  De as isDerived,
-  Oe as isFulfilled,
-  je as isPending,
-  ke as isPool,
-  xe as isRejected,
-  Ce as isScopedAtom,
-  Fe as onCreateHook,
-  Ie as onErrorHook,
-  we as pool,
-  qe as promisesEqual,
-  Te as readonly,
+  we as isDerived,
+  qe as isEvent,
+  Te as isFulfilled,
+  ze as isPending,
+  Pe as isPool,
+  _e as isRejected,
+  Fe as isScopedAtom,
+  Be as onCreateHook,
+  Ge as onErrorHook,
+  Ie as pool,
+  He as promisesEqual,
+  Le as readonly,
   me as rx,
   F as select,
-  ze as trackPromise,
-  _e as unwrap,
+  Ue as trackPromise,
+  Me as unwrap,
   de as useAction,
-  L as useSelector,
+  H as useSelector,
   fe as useStable
 };

package/package.json

@@ -17,7 +17,7 @@
     "url": "https://github.com/linq2js/atomirx"
   },
   "homepage": "https://github.com/linq2js/atomirx",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "bin": {
     "atomirx": "./bin/cli.js"
   },

package/skills/atomirx/SKILL.md

@@ -106,6 +106,7 @@ main();
 | `atom<T>(initial)` | Mutable state                  | No           |
 | `derived(fn)`      | Computed value                 | Yes (lazy)   |
 | `effect(fn)`       | Side effects on changes        | Yes (eager)  |
+| `event<T>(opts)`   | Block until fired              | Yes          |
 | `select(fn)`       | One-time read, no subscription | No           |
 | `pool(fn, opts)`   | Parameterized atoms with GC    | Per-entry    |
 | `batch(fn)`        | Group updates, single notify   | No           |
@@ -113,25 +114,131 @@ main();
 | `onCreateHook`     | Track atom/effect creation     | No           |
 | `onErrorHook`      | Global error handling          | No           |
 
+## Events (Block Until Fired)
+
+Events block computation until `fire()` is called. Useful for user-driven workflows.
+
+### event vs atom\<Promise\<T\>\>
+
+| Aspect | `atom<Promise<T>>` | `event<T>` |
+|--------|-------------------|------------|
+| Initial state | Promise you provide | Pending (no data) |
+| Set value | `.set(promise)` | `.fire(data)` |
+| First update | Replaces promise | Resolves pending |
+| Get last value | Track yourself | `.last()` built-in |
+| Use case | Async data fetching | User signals |
+
+### Event API
+
+| Method | Description |
+|--------|-------------|
+| `fire(payload)` | Fire event with payload |
+| `get()` | Current promise (may be resolved) |
+| `next()` | Pending promise for next meaningful fire |
+| `on(listener)` | Subscribe to changes |
+| `last()` | Last fired payload |
+| `fireCount` | Count of meaningful fires |
+| `sealed()` | True if `once` and already fired |
+
+### get() vs next()
+
+| | `get()` | `next()` |
+|--|---------|----------|
+| Returns | Current promise | Pending promise |
+| After fire | Same resolved | New pending |
+| Use case | Reactive | Imperative |
+
+`next()` respects `equals` - duplicate fires won't resolve.
+
+```typescript
+import { event, derived, effect } from "atomirx";
+
+// Create event
+const submitEvent = event<FormData>({ meta: { key: "form.submit" } });
+const cancelEvent = event({ meta: { key: "form.cancel" } }); // void payload
+
+// In derived - suspends until fire()
+const result$ = derived(({ read }) => {
+  const data = read(submitEvent); // Blocks until submitEvent.fire(data)
+  return processForm(data);
+});
+
+// In effect - suspends until fire()
+effect(({ read }) => {
+  const data = read(submitEvent);
+  console.log("Form submitted:", data);
+});
+
+// Race multiple events
+const outcome$ = derived(({ race }) => {
+  const { key, value } = race({
+    submit: submitEvent,
+    cancel: cancelEvent,
+  });
+  return key === "cancel" ? null : processForm(value);
+});
+
+// Fire the event (from user action)
+function handleSubmit(data: FormData) {
+  submitEvent.fire(data);
+}
+
+// Imperative awaiting with next()
+async function processClicks() {
+  while (true) {
+    const data = await clickEvent.next();
+    handleClick(data);
+  }
+}
+```
+
+### once Option (One-Time Events)
+
+```typescript
+const initEvent = event<Config>({ once: true });
+
+initEvent.fire(config);   // Promise resolved
+initEvent.fire(config2);  // No-op (already fired)
+initEvent.get();          // Same resolved promise
+initEvent.next();         // Same resolved promise
+
+// Late subscriber - triggers immediately
+initEvent.on(() => console.log("init done")); // Logs immediately
+```
+
+| Behavior | `once: false` | `once: true` |
+|----------|--------------|--------------|
+| Multiple `fire()` | New promises | First only |
+| `next()` after fire | New pending | Same resolved |
+| `on()` after fire | Normal | Triggers immediately |
+
+**Key Points:**
+- `read(event)` suspends until `fire()` is called (like waiting for staleValue)
+- Works with `race()`, `all()` for waiting on multiple user actions
+- Each `fire()` after the first creates a new promise → triggers reactive updates
+- Use `equals` option to dedupe identical payloads
+- Use `once: true` for one-time events (init, login)
+- **NOT for promise flow control** (timeouts, retries) — use `abortable()` for those
+
 ## SelectContext Methods
 
 **Works identically in `derived()`, `effect()`, `useSelector()`, `rx()`.** Learn once, use everywhere.
 
-| Method      | Signature                 | Behavior                         |
-| ----------- | ------------------------- | -------------------------------- |
-| `read()`    | `read(atom$)`             | Read + track dependency          |
-| `ready()`   | `ready(atom$)` or with fn | Wait for non-null (suspends)     |
-| `from()`    | `from(pool, params)`      | Get ScopedAtom from pool         |
-| `track()`   | `track(atom$)`            | Track without reading            |
-| `untrack()` | `untrack(atom$)` or fn    | Read/exec without tracking       |
-| `safe()`    | `safe(() => expr)`        | Catch errors, preserve Suspense  |
-| `all()`     | `all([a$, b$])`           | Wait for all (Promise.all)       |
-| `any()`     | `any({ a: a$, b: b$ })`   | First ready (Promise.any)        |
-| `race()`    | `race({ a: a$, b: b$ })`  | First settled (Promise.race)     |
-| `settled()` | `settled([a$, b$])`       | All results (Promise.allSettled) |
-| `state()`   | `state(atom$)`            | Get state without throwing       |
-| `and()`     | `and([cond1, cond2])`     | Logical AND, short-circuit       |
-| `or()`      | `or([cond1, cond2])`      | Logical OR, short-circuit        |
+| Method      | Signature                        | Behavior                                  |
+| ----------- | -------------------------------- | ----------------------------------------- |
+| `read()`    | `read(atom$)`                    | Read + track dependency                   |
+| `ready()`   | `ready(atom$)` or `ready(array)` | Wait for non-null (suspends)              |
+| `from()`    | `from(pool, params)`             | Get ScopedAtom from pool                  |
+| `track()`   | `track(atom$)`                   | Track without reading                     |
+| `untrack()` | `untrack(atom$)` or fn           | Read/exec without tracking                |
+| `safe()`    | `safe(() => expr)`               | Catch errors, preserve Suspense           |
+| `all()`     | `all([a$, b$])`                  | Wait for all (Promise.all)                |
+| `any()`     | `any({ a: a$, b: b$ })`          | First ready (discriminated union)         |
+| `race()`    | `race({ a: a$, b: b$ })`         | First settled (discriminated union)       |
+| `settled()` | `settled([a$, b$])`              | All results (Promise.allSettled)          |
+| `state()`   | `state(atom$)`                   | Get state without throwing                |
+| `and()`     | `and([cond1, cond2])`            | Logical AND, short-circuit                |
+| `or()`      | `or([cond1, cond2])`             | Logical OR, short-circuit                 |
 
 ```typescript
 // Same pattern works everywhere
@@ -149,6 +256,38 @@ effect(pattern);
 }
 ```
 
+### race()/any() Discriminated Union
+
+`race()` and `any()` return discriminated unions — checking `key` narrows `value` type:
+
+```typescript
+const result = race({ num: numAtom$, str: strAtom$ });
+
+if (result.key === "num") {
+  result.value; // narrowed to number
+} else {
+  result.value; // narrowed to string
+}
+
+// Tuple destructuring also works
+const [winner, value] = result;
+```
+
+### ready() with Async Utilities
+
+Use `ready()` to ensure values from `all()`, `race()`, or `any()` are non-null:
+
+```typescript
+// ready() + all() — suspend if any value is null/undefined
+const [user, posts] = ready(all([user$, posts$]));
+
+// ready() + race() — suspend if winning value is null, preserves narrowing
+const result = ready(race({ cache: cache$, api: api$ }));
+if (result.key === "cache") {
+  result.value; // narrowed to cache type (non-null)
+}
+```
+
 ## read() vs ready() vs state()
 
 | Method    | On null/undefined | On loading     | Use Case             |