nanoeffects 0.19.1 → 0.21.0

package/dist/{plugin-Sy8z9IId.d.ts → plugin-D9UTzGRG.d.ts}

@@ -1,5 +1,5 @@
-import { N as WithContext, R as EventMap, b as Context, d as Effects, h as Bus, l as BoundForm, z as Keys } from "./action-creator-HFA_LZOH.js";
-import { n as NoClash } from "./context-types-BNcs43eY.js";
+import { B as Keys, N as WithContext, b as Context, d as Effects, h as Bus, l as BoundForm, z as EventMap } from "./action-creator-Bpa8BUS9.js";
+import { n as NoClash } from "./context-types-BKIH5a8s.js";
 //#region src/utils/delay.d.ts
 /**
  * Resolves after `ms`, or rejects early if `ctx.signal` aborts. `ms` can be a

package/dist/policies.d.ts

@@ -1,5 +1,5 @@
-import { R as EventMap, U as Task } from "./action-creator-HFA_LZOH.js";
-import { n as withPolicy, t as PolicyFunction } from "./with-policy-C_mX7S54.js";
+import { W as Task, z as EventMap } from "./action-creator-Bpa8BUS9.js";
+import { n as withPolicy, t as PolicyFunction } from "./with-policy-BeH8wCkX.js";
 //#region src/policies/keyed.d.ts
 /** Options shared by every policy that can keep its state per key. */
 type KeyOption<P> = {
@@ -10,6 +10,14 @@ type KeyOption<P> = {
    */
   key?: (payload: P) => unknown;
 };
+/** Options of a policy called without a task: `key` is left out. */
+type Unkeyed<O> = Omit<O, "key"> & {
+  key?: undefined;
+};
+/** Options of a policy called without a task, with a `key` that tells the payload type. */
+type Keyed<O, P> = O & {
+  key: (payload: P) => unknown;
+};
 //#endregion
 //#region src/policies/debounce.d.ts
 type DebounceResult<R> = Promise<R | undefined> | Promise<Awaited<R> | undefined> | undefined;
@@ -19,6 +27,10 @@ type DebounceOptions<P = never> = KeyOption<P> & {
   /** Run the last call of a burst after `ms` of quiet. Default `true`. */
   trailing?: boolean;
 };
+/** What `debounce(ms)` returns: it turns a task into a `debounce` task. */
+type DebounceWrapper = <P, E extends EventMap, R>(fn: Task<P, E, R>) => Task<P, E, DebounceResult<R>>;
+/** What `debounce(ms, { key })` returns: the payload type comes from `key`. */
+type KeyedDebounceWrapper<P> = <E extends EventMap, R>(fn: Task<P, E, R>) => Task<P, E, DebounceResult<R>>;
 /**
  * Waits for `ms` of quiet, then runs; a new call restarts the wait and drops
  * the previous. With `leading` the first call of a burst runs at once, and the
@@ -39,14 +51,24 @@ type DebounceOptions<P = never> = KeyOption<P> & {
  * bus.emit("input", "re"); // only the last call runs, 300 ms after it
  * ```
  */
-export declare const debounce: <P, E extends EventMap, R>(ms: number, fn: Task<P, E, R>, options?: DebounceOptions<P>) => Task<P, E, DebounceResult<R>>;
+export declare function debounce<P, E extends EventMap, R>(ms: number, fn: Task<P, E, R>, options?: DebounceOptions<P>): Task<P, E, DebounceResult<R>>;
+export declare function debounce(ms: number, options?: Unkeyed<DebounceOptions>): DebounceWrapper;
+export declare function debounce<P>(ms: number, options: Keyed<DebounceOptions<P>, P>): KeyedDebounceWrapper<P>;
 //#endregion
 //#region src/policies/latest.d.ts
 type LatestOptions<P = never> = KeyOption<P>;
+type LatestResult<R> = R | Promise<Awaited<R> | undefined> | undefined;
+/** What `latest()` returns: it turns a task into a `latest` task. */
+type LatestWrapper = <P, E extends EventMap, R>(fn: Task<P, E, R>) => Task<P, E, LatestResult<R>>;
+/** What `latest({ key })` returns: the payload type comes from `key`. */
+type KeyedLatestWrapper<P> = <E extends EventMap, R>(fn: Task<P, E, R>) => Task<P, E, LatestResult<R>>;
 /**
  * Aborts the previous run when a new call arrives; stale results are dropped.
  * With `options.key` each key has its own latest run.
  *
+ * Called without the task, `latest()` returns a function that takes the task,
+ * so `usePolicy(callback, latest())` has no `(task) => ...` to get wrong.
+ *
  * @example
  * ```ts
  * bus.on(
@@ -62,12 +84,21 @@ type LatestOptions<P = never> = KeyOption<P>;
  *
  * // one latest run per user instead of one for all
  * bus.on("load", latest(loadUser, { key: (user) => user.id }));
+ *
+ * // without the task: for a hook that builds the task itself
+ * const search = usePolicy(runSearch, latest());
  * ```
  */
-export declare const latest: <P, E extends EventMap, R>(fn: Task<P, E, R>, options?: LatestOptions<P>) => Task<P, E, R | Promise<Awaited<R> | undefined> | undefined>;
+export declare function latest<P, E extends EventMap, R>(fn: Task<P, E, R>, options?: LatestOptions<P>): Task<P, E, LatestResult<R>>;
+export declare function latest(options?: Unkeyed<LatestOptions>): LatestWrapper;
+export declare function latest<P>(options: Keyed<LatestOptions<P>, P>): KeyedLatestWrapper<P>;
 //#endregion
 //#region src/policies/leading.d.ts
 type LeadingOptions<P = never> = KeyOption<P>;
+/** What `leading()` returns: it turns a task into a `leading` task. */
+type LeadingWrapper = <P, E extends EventMap, R>(fn: Task<P, E, R>) => Task<P, E, R | Promise<Awaited<R>> | undefined>;
+/** What `leading({ key })` returns: the payload type comes from `key`. */
+type KeyedLeadingWrapper<P> = <E extends EventMap, R>(fn: Task<P, E, R>) => Task<P, E, R | Promise<Awaited<R>> | undefined>;
 /**
  * Drops new calls while the task is still running. The lock is released when
  * the run settles or when its task is aborted, whichever comes first, so a
@@ -87,7 +118,9 @@ type LeadingOptions<P = never> = KeyOption<P>;
  * bus.emit("save", draft); // dropped while the first save is in flight
  * ```
  */
-export declare const leading: <P, E extends EventMap, R>(fn: Task<P, E, R>, options?: LeadingOptions<P>) => Task<P, E, R | Promise<Awaited<R>> | undefined>;
+export declare function leading<P, E extends EventMap, R>(fn: Task<P, E, R>, options?: LeadingOptions<P>): Task<P, E, R | Promise<Awaited<R>> | undefined>;
+export declare function leading(options?: Unkeyed<LeadingOptions>): LeadingWrapper;
+export declare function leading<P>(options: Keyed<LeadingOptions<P>, P>): KeyedLeadingWrapper<P>;
 //#endregion
 //#region src/policies/queue.d.ts
 type QueueOptions<P = never> = KeyOption<P> & {
@@ -102,6 +135,10 @@ type QueueOptions<P = never> = KeyOption<P> & {
    */
   overflow?: "drop-new" | "drop-old";
 };
+/** What `queue()` returns: it turns a task into a `queue` task. */
+type QueueWrapper = <P, E extends EventMap, R>(fn: Task<P, E, R>) => Task<P, E, Promise<Awaited<R> | undefined>>;
+/** What `queue({ key })` returns: the payload type comes from `key`. */
+type KeyedQueueWrapper<P> = <E extends EventMap, R>(fn: Task<P, E, R>) => Task<P, E, Promise<Awaited<R> | undefined>>;
 /**
  * Runs calls one after another, in the order they arrived: a call starts when
  * fewer than `concurrency` calls are running. Every call returns a promise with
@@ -132,7 +169,9 @@ type QueueOptions<P = never> = KeyOption<P> & {
  * bus.emit("save", b); // waits for a, then runs
  * ```
  */
-export declare const queue: <P, E extends EventMap, R>(fn: Task<P, E, R>, options?: QueueOptions<P>) => Task<P, E, Promise<Awaited<R> | undefined>>;
+export declare function queue<P, E extends EventMap, R>(fn: Task<P, E, R>, options?: QueueOptions<P>): Task<P, E, Promise<Awaited<R> | undefined>>;
+export declare function queue(options?: Unkeyed<QueueOptions>): QueueWrapper;
+export declare function queue<P>(options: Keyed<QueueOptions<P>, P>): KeyedQueueWrapper<P>;
 //#endregion
 //#region src/policies/throttle.d.ts
 type ThrottleOptions<P = never> = KeyOption<P> & {
@@ -141,6 +180,10 @@ type ThrottleOptions<P = never> = KeyOption<P> & {
   /** Run the latest call made while waiting, at the end of the window. Default `true`. */
   trailing?: boolean;
 };
+/** What `throttle(ms)` returns: it turns a task into a `throttle` task. */
+type ThrottleWrapper = <P, E extends EventMap, R>(fn: Task<P, E, R>) => Task<P, E, R | Promise<R | undefined> | undefined>;
+/** What `throttle(ms, { key })` returns: the payload type comes from `key`. */
+type KeyedThrottleWrapper<P> = <E extends EventMap, R>(fn: Task<P, E, R>) => Task<P, E, R | Promise<R | undefined> | undefined>;
 /**
  * At most one run per `ms`, with the semantics of lodash `throttle` (and
  * patronum): a call made when the throttle is idle, that is, at least `ms`
@@ -167,6 +210,8 @@ type ThrottleOptions<P = never> = KeyOption<P> & {
  * bus.emit("scroll", 30); // runs once the 200 ms window closes
  * ```
  */
-export declare const throttle: <P, E extends EventMap, R>(ms: number, fn: Task<P, E, R>, options?: ThrottleOptions<P>) => Task<P, E, R | Promise<R | undefined> | undefined>;
+export declare function throttle<P, E extends EventMap, R>(ms: number, fn: Task<P, E, R>, options?: ThrottleOptions<P>): Task<P, E, R | Promise<R | undefined> | undefined>;
+export declare function throttle(ms: number, options?: Unkeyed<ThrottleOptions>): ThrottleWrapper;
+export declare function throttle<P>(ms: number, options: Keyed<ThrottleOptions<P>, P>): KeyedThrottleWrapper<P>;
 //#endregion
 export { type DebounceOptions, type LatestOptions, type LeadingOptions, type PolicyFunction, type QueueOptions, type ThrottleOptions, withPolicy };

package/dist/policies.js

@@ -1 +1 @@
-import{i as e,o as t,s as n,t as r,u as i}from"./context-CJGW6OWj.js";import{n as a,r as o,t as s}from"./delay-BnBdGPh7.js";import{n as c,t as l}from"./promise-CSLpzwSR.js";import{n as u,t as d}from"./lifecycle-key-8iX8RUVD.js";import{t as f}from"./with-policy-CW50Edgk.js";const p=e=>Reflect.get(e,d),m=e=>{p(e)?.start()},h=(e,n,r)=>(m(e),t(e,n,r)),g=(e,t)=>{n(e,t,`drop`),p(e)?.drop()},_=(e,t)=>{p(e)?.done(t)},v=(e,t,n)=>{let r=p(e);t?r?.cancel(n):r?.drop()},y=e=>(Reflect.set(e,u,!0),e),b=()=>{},x=(e,t)=>{let n=/* @__PURE__ */ new Map;return(r,i)=>{let a=e(r),o=n.get(a);if(!o){let e=t(()=>{n.get(a)===e&&n.delete(a)});o=e,n.set(a,e)}return o(r,i)}},S=(e,t)=>y(e?x(e,t):t(b)),C=(e,t={})=>S(t.key,t=>w(`latest`,(t,n,r)=>(r(),e(t,n)),t)),w=(t,a,o=b)=>{let s=null;return(l,u)=>{if(s?.abort(),u.signal.aborted)return;let{ctx:d,unlink:f}=e(u);s=d;let p=r(d,t),h=!1,g=()=>{d.signal.aborted||(h=!0,m(d),n(d,t,`start`))};i(d,e=>{v(d,h,e),p(h?`cancel`:`drop`)});let _=()=>{f(),s===d&&(s=null,o())},y=e=>{if(!d.signal.aborted)return p(h?`done`:`drop`),e};try{let e=a(l,d,g);return c(e)?Promise.resolve(e).then(y,e=>{if(!d.signal.aborted)throw p(`error`,e),e}).finally(_):(_(),y(e))}catch(e){if(_(),d.signal.aborted)return;throw p(`error`,e),e}}},T=(e,t,n={})=>S(n.key,r=>D(e,t,n,r)),E=(e,t,n,r)=>{let i=r!==b,s=null,c=null;return(l,u)=>{if(u.signal.aborted)return;let d=Date.now(),f=s===null||d-s>=e||d-s<0;return s=d,c!==null&&a(c),c=i?o(r,e):null,n&&f?Promise.resolve(h(u,`debounce`,()=>t(l,u))):(g(u,`debounce`),Promise.resolve(void 0))}},D=(e,t,n,r)=>{let a=n.leading??!1,o=n.trailing??!0;if(!o)return E(e,t,a,r);let c=!1,l=0,u=w(`debounce`,([n,r],a,u)=>{let d=l;return i(a,()=>{l===d&&(c=!1)}),s(a,e).then(()=>{if(c=!1,o&&!r)return u(),t(n,a)})},r);return(e,n)=>{if(n.signal.aborted)return;let r=a&&!c;c=!0,l++;let i=u([e,r],n);return r?Promise.resolve(h(n,`debounce`,()=>t(e,n))):i}},O=(e,t={})=>S(t.key,t=>{let n=null;return(r,a)=>{if(a.signal.aborted)return;if(n){g(a,`leading`);return}let o={};n=o;let s=()=>{c(),n===o&&(n=null,t())},c=i(a,s);try{return l(h(a,`leading`,()=>e(r,a)),s)}catch(e){throw s(),e}}}),k=(e,t={})=>S(t.key,n=>A(e,t,n)),A=(e,t,n)=>{let r=t.concurrency??1,a=t.limit??1/0,o=[],s=0,c=()=>{for(;s<r;){let e=o.shift();if(!e)return;e.start()}};return(l,u)=>new Promise((d,f)=>{if(u.signal.aborted){d(void 0);return}let p=b,m=()=>{p(),g(u,`queue`),d(void 0)},v=()=>{if(p(),u.signal.aborted){m();return}s++;let t=!0,r=()=>{t&&(t=!1,s--,c(),s===0&&o.length===0&&n())},a=i(u,()=>{r(),d(void 0)}),g;try{g=Promise.resolve(h(u,`queue`,()=>e(l,u)))}catch(e){g=Promise.reject(e)}let v=()=>{a(),r()};g.then(e=>{_(u,{value:e}),v(),d(u.signal.aborted?void 0:e)},e=>{_(u,{error:e}),v(),u.signal.aborted?d(void 0):f(e)})};if(s<r){v();return}if(o.length>=a){if(t.overflow!==`drop-old`||a<=0){m();return}o.shift()?.drop()}let y={start:v,drop:m};o.push(y),p=i(u,()=>{let e=o.indexOf(y);e>=0&&o.splice(e,1),m()})})},j=(e,t,n={})=>S(n.key,r=>M(e,t,n,r)),M=(e,t,n,r)=>{let i=n.leading??!0,s=n.trailing??!0,c=r!==b,l=null,u=0,d=null,f=null,p=null,m=!1,_=t=>l===null||t-l>=e||t-l<0||t-u>=e,v=e=>g(e,`throttle`),y=()=>{let e=p;p=null,e&&(v(e.ctx),e.resolve())},x=(e,t)=>(y(),new Promise((n,r)=>{p={payload:e,ctx:t,resolve:n,reject:r}})),S=(e,n,r)=>{y(),u=r,m=!0;try{return h(n,`throttle`,()=>t(e,n))}finally{m=!1}},C=()=>{c&&(f=o(w,e))},w=()=>{if(f=null,!c||d!==null||p)return;let t=Date.now(),n=Math.max(e-(t-(l??-1/0)),e-(t-u));n<=0?r():f=o(w,n)},T=e=>{d=null;let t=p;if(s&&t&&!t.ctx.signal.aborted){p=null;try{t.resolve(S(t.payload,t.ctx,e))}catch(e){t.reject(e)}}else y();w()},E=()=>{let t=Date.now();_(t)?T(t):d=o(E,Math.min(e-(t-(l??t)),e-(t-u)))},D=()=>{f!==null&&(a(f),f=null)},O=(e,t)=>{if(!s)v(t);else return x(e,t)},k=(e,t,n,r)=>{if(!r)v(t);else if(u=n,C(),!i)v(t);else return S(e,t,n)},A=(t,n,r,s)=>s&&d!==null?(a(d),d=o(E,e),S(t,n,r)):d===null&&(d=o(E,e),s&&(u=r,i))?S(t,n,r):O(t,n);return(e,t)=>{if(t.signal.aborted)return;let n=Date.now(),r=!m&&_(n);return l=n,D(),s?A(e,t,n,r):k(e,t,n,r)}};export{T as debounce,C as latest,O as leading,k as queue,j as throttle,f as withPolicy};
+import{i as e,o as t,s as n,t as r,u as i}from"./context-CJGW6OWj.js";import{n as a,r as o,t as s}from"./delay-BnBdGPh7.js";import{n as c,t as l}from"./promise-CSLpzwSR.js";import{n as u,t as d}from"./lifecycle-key-8iX8RUVD.js";import{t as f}from"./with-policy-CW50Edgk.js";const p=e=>Reflect.get(e,d),m=e=>{p(e)?.start()},h=(e,n,r)=>(m(e),t(e,n,r)),g=(e,t)=>{n(e,t,`drop`),p(e)?.drop()},_=(e,t)=>{p(e)?.done(t)},v=(e,t,n)=>{let r=p(e);t?r?.cancel(n):r?.drop()},y=e=>(Reflect.set(e,u,!0),e),b=()=>{},x=(e,t,n)=>typeof e==`function`?n(e,t??{}):t=>n(t,e??{}),S=(e,t)=>{let n=/* @__PURE__ */ new Map;return(r,i)=>{let a=e(r),o=n.get(a);if(!o){let e=t(()=>{n.get(a)===e&&n.delete(a)});o=e,n.set(a,e)}return o(r,i)}},C=(e,t)=>y(e?S(e,t):t(b));function w(e,t){return x(e,t,T)}const T=(e,t)=>C(t.key,t=>E(`latest`,(t,n,r)=>(r(),e(t,n)),t)),E=(t,a,o=b)=>{let s=null;return(l,u)=>{if(s?.abort(),u.signal.aborted)return;let{ctx:d,unlink:f}=e(u);s=d;let p=r(d,t),h=!1,g=()=>{d.signal.aborted||(h=!0,m(d),n(d,t,`start`))};i(d,e=>{v(d,h,e),p(h?`cancel`:`drop`)});let _=()=>{f(),s===d&&(s=null,o())},y=e=>{if(!d.signal.aborted)return p(h?`done`:`drop`),e};try{let e=a(l,d,g);return c(e)?Promise.resolve(e).then(y,e=>{if(!d.signal.aborted)throw p(`error`,e),e}).finally(_):(_(),y(e))}catch(e){if(_(),d.signal.aborted)return;throw p(`error`,e),e}}};function D(e,t,n){return x(t,n,(t,n)=>O(e,t,n))}const O=(e,t,n)=>C(n.key,r=>A(e,t,n,r)),k=(e,t,n,r)=>{let i=r!==b,s=null,c=null;return(l,u)=>{if(u.signal.aborted)return;let d=Date.now(),f=s===null||d-s>=e||d-s<0;return s=d,c!==null&&a(c),c=i?o(r,e):null,n&&f?Promise.resolve(h(u,`debounce`,()=>t(l,u))):(g(u,`debounce`),Promise.resolve(void 0))}},A=(e,t,n,r)=>{let a=n.leading??!1,o=n.trailing??!0;if(!o)return k(e,t,a,r);let c=!1,l=0,u=E(`debounce`,([n,r],a,u)=>{let d=l;return i(a,()=>{l===d&&(c=!1)}),s(a,e).then(()=>{if(c=!1,o&&!r)return u(),t(n,a)})},r);return(e,n)=>{if(n.signal.aborted)return;let r=a&&!c;c=!0,l++;let i=u([e,r],n);return r?Promise.resolve(h(n,`debounce`,()=>t(e,n))):i}};function j(e,t){return x(e,t,M)}const M=(e,t)=>C(t.key,t=>{let n=null;return(r,a)=>{if(a.signal.aborted)return;if(n){g(a,`leading`);return}let o={};n=o;let s=()=>{c(),n===o&&(n=null,t())},c=i(a,s);try{return l(h(a,`leading`,()=>e(r,a)),s)}catch(e){throw s(),e}}});function N(e,t){return x(e,t,P)}const P=(e,t)=>C(t.key,n=>F(e,t,n)),F=(e,t,n)=>{let r=t.concurrency??1,a=t.limit??1/0,o=[],s=0,c=()=>{for(;s<r;){let e=o.shift();if(!e)return;e.start()}};return(l,u)=>new Promise((d,f)=>{if(u.signal.aborted){d(void 0);return}let p=b,m=()=>{p(),g(u,`queue`),d(void 0)},v=()=>{if(p(),u.signal.aborted){m();return}s++;let t=!0,r=()=>{t&&(t=!1,s--,c(),s===0&&o.length===0&&n())},a=i(u,()=>{r(),d(void 0)}),g;try{g=Promise.resolve(h(u,`queue`,()=>e(l,u)))}catch(e){g=Promise.reject(e)}let v=()=>{a(),r()};g.then(e=>{_(u,{value:e}),v(),d(u.signal.aborted?void 0:e)},e=>{_(u,{error:e}),v(),u.signal.aborted?d(void 0):f(e)})};if(s<r){v();return}if(o.length>=a){if(t.overflow!==`drop-old`||a<=0){m();return}o.shift()?.drop()}let y={start:v,drop:m};o.push(y),p=i(u,()=>{let e=o.indexOf(y);e>=0&&o.splice(e,1),m()})})};function I(e,t,n){return x(t,n,(t,n)=>L(e,t,n))}const L=(e,t,n)=>C(n.key,r=>R(e,t,n,r)),R=(e,t,n,r)=>{let i=n.leading??!0,s=n.trailing??!0,c=r!==b,l=null,u=0,d=null,f=null,p=null,m=!1,_=t=>l===null||t-l>=e||t-l<0||t-u>=e,v=e=>g(e,`throttle`),y=()=>{let e=p;p=null,e&&(v(e.ctx),e.resolve())},x=(e,t)=>(y(),new Promise((n,r)=>{p={payload:e,ctx:t,resolve:n,reject:r}})),S=(e,n,r)=>{y(),u=r,m=!0;try{return h(n,`throttle`,()=>t(e,n))}finally{m=!1}},C=()=>{c&&(f=o(w,e))},w=()=>{if(f=null,!c||d!==null||p)return;let t=Date.now(),n=Math.max(e-(t-(l??-1/0)),e-(t-u));n<=0?r():f=o(w,n)},T=e=>{d=null;let t=p;if(s&&t&&!t.ctx.signal.aborted){p=null;try{t.resolve(S(t.payload,t.ctx,e))}catch(e){t.reject(e)}}else y();w()},E=()=>{let t=Date.now();_(t)?T(t):d=o(E,Math.min(e-(t-(l??t)),e-(t-u)))},D=()=>{f!==null&&(a(f),f=null)},O=(e,t)=>{if(!s)v(t);else return x(e,t)},k=(e,t,n,r)=>{if(!r)v(t);else if(u=n,C(),!i)v(t);else return S(e,t,n)},A=(t,n,r,s)=>s&&d!==null?(a(d),d=o(E,e),S(t,n,r)):d===null&&(d=o(E,e),s&&(u=r,i))?S(t,n,r):O(t,n);return(e,t)=>{if(t.signal.aborted)return;let n=Date.now(),r=!m&&_(n);return l=n,D(),s?A(e,t,n,r):k(e,t,n,r)}};export{D as debounce,w as latest,j as leading,N as queue,I as throttle,f as withPolicy};

package/dist/react.d.ts

@@ -1,6 +1,7 @@
-import { R as EventMap, T as EventKey, U as Task, h as Bus, r as FreeActionCreator, t as ActionCreator } from "./action-creator-HFA_LZOH.js";
+import { T as EventKey, W as Task, h as Bus, r as FreeActionCreator, t as ActionCreator, z as EventMap } from "./action-creator-Bpa8BUS9.js";
 import { t as OriginOptions } from "./origin-key-CxK0SkeG.js";
-import { t as PolicyFunction } from "./with-policy-C_mX7S54.js";
+import { t as PolicyFunction } from "./with-policy-BeH8wCkX.js";
+import { t as StateOf } from "./state-of-C19H6BoV.js";
 //#region src/react/plugin.d.ts
 /** Tells whether two values are the same: `Object.is` unless the caller gives another. */
 type Equals<V> = (previous: V, next: V) => boolean;
@@ -46,8 +47,6 @@ type ReactApi<E extends EventMap> = {
 };
 /** What `useEventState` returns: the pair of `useState`, with the payload of the event as state. */
 type EventState<P> = [P, (next: P | ((previous: P) => P)) => void];
-type Widen<S> = [S] extends [never[]] ? unknown[] : S;
-type StateOf<P, S> = unknown extends P ? Widen<S> : P;
 /**
  * Adds `bus.useEmitter(event, value)`: a hook that tells the bus when a value of
  * a component changes, without the traps of `useEffect(() => emit(value), [value])`
@@ -86,9 +85,11 @@ export declare const reactPlugin: () => <E extends EventMap>(bus: Bus<E>) => Bus
  * render. This hook keeps the policy across renders and calls the `callback` of
  * the latest render, so an inline callback sees fresh props and state.
  *
- * `make` gets a task that runs the callback and returns the policy built around
- * it. It runs once, and again when an item of `deps` changes: list there what
- * `make` reads, such as the wait time. The pending calls of the old function are
+ * `make` builds the policy around the callback. Pass a policy called without
+ * its task (`debounce(300)`, `latest()`), or a function `(task) => policy` for
+ * a combined policy such as `(task) => throttle(100, latest(task))`; `task`
+ * runs the callback. `make` runs once, and again when an item of `deps`
+ * changes: list there what it reads, such as the wait time. The pending calls of the old function are
  * cancelled then, and when the component unmounts. Needs `react` 18 or newer.
  *
  * @example
@@ -100,7 +101,7 @@ export declare const reactPlugin: () => <E extends EventMap>(bus: Bus<E>) => Bus
  *   const [results, setResults] = useState([]);
  *   const onChange = usePolicy(
  *     async (query: string) => setResults(await search(query)), // latest render's callback
- *     (task) => debounce(wait, task), // the policy, made once per wait
+ *     debounce(wait), // the policy, made once per wait
  *     [wait],
  *   );
  *   return <input onChange={(event) => onChange(event.target.value)} />;

package/dist/redux.d.ts

@@ -1,4 +1,4 @@
-import { R as EventMap, h as Bus } from "./action-creator-HFA_LZOH.js";
+import { h as Bus, z as EventMap } from "./action-creator-Bpa8BUS9.js";
 import { t as OriginOptions } from "./origin-key-CxK0SkeG.js";
 //#region src/store/redux/middleware.d.ts
 /** What Redux passes through a middleware: an action is a plain object with a `type`. */

package/dist/scope.d.ts

@@ -1,5 +1,5 @@
-import { R as EventMap, a as EmitScope, d as Effects, f as Signaled, h as Bus, o as Scope, u as Effect } from "./action-creator-HFA_LZOH.js";
-import { n as ScopeSlots, r as Scoped } from "./types-DaZT158m.js";
+import { P as WithSignal, a as EmitScope, d as Effects, f as Signaled, h as Bus, o as Scope, u as Effect, z as EventMap } from "./action-creator-Bpa8BUS9.js";
+import { n as ScopeSlots, r as Scoped } from "./types-CbdJKC2z.js";
 //#region src/scope/effect.d.ts
 /**
  * Marks a function whose first parameter is `{ signal }` as an effect, so that
@@ -14,7 +14,7 @@ import { n as ScopeSlots, r as Scoped } from "./types-DaZT158m.js";
  *
  * @example
  * ```ts
- * const first = effect(<T>(ctx: { signal: AbortSignal }, items: T[]) => items[0]);
+ * const first = effect(<T>(ctx: WithSignal, items: T[]) => items[0]);
  *
  * const getUser = createCommand(
  *   "user/get",
@@ -23,7 +23,7 @@ import { n as ScopeSlots, r as Scoped } from "./types-DaZT158m.js";
  * );
  * ```
  */
-export declare function effect<A extends unknown[], R>(fn: (ctx: Signaled, ...args: A) => R): (...args: A) => R;
+export declare function effect<A extends unknown[], R>(fn: (ctx: WithSignal, ...args: A) => R): (...args: A) => R;
 //#endregion
 //#region src/scope/plugin.d.ts
 /**

package/dist/signal.d.ts

@@ -1,4 +1,4 @@
-import { C as Emit, E as EventLike, R as EventMap, a as EmitScope, c as WithScope, h as Bus, v as CommandCall } from "./action-creator-HFA_LZOH.js";
+import { C as Emit, E as EventLike, a as EmitScope, c as WithScope, h as Bus, v as CommandCall, z as EventMap } from "./action-creator-Bpa8BUS9.js";
 //#region src/signal/plugin.d.ts
 /** What the second argument of `emit` takes besides the fields of a scope. */
 type SignalOption = {

package/dist/state-of-C19H6BoV.d.ts

@@ -0,0 +1,10 @@
+//#region src/core/state-of.d.ts
+type Widen<S> = [S] extends [never[]] ? unknown[] : S;
+/**
+ * The type of the state that keeps the last payload of an event (`useEventState`,
+ * `useEventRef`): the payload type when the event has one, and otherwise the type of the
+ * initial value, widened, so a creator without a payload type still gives a typed state.
+ */
+type StateOf<P, S> = unknown extends P ? Widen<S> : P;
+//#endregion
+export { StateOf as t };

package/dist/trace.d.ts

@@ -1,4 +1,4 @@
-import { G as TraceEvent, H as Phase, I as Tracer, K as TraceLogger, L as EffectName, R as EventMap, W as Trace, h as Bus } from "./action-creator-HFA_LZOH.js";
+import { G as Trace, K as TraceEvent, L as Tracer, R as EffectName, U as Phase, h as Bus, q as TraceLogger, z as EventMap } from "./action-creator-Bpa8BUS9.js";
 //#region src/trace/console.d.ts
 type ConsoleLoggerOptions = {
   /** Defaults to `globalThis.console`. */

package/dist/{types-DaZT158m.d.ts → types-CbdJKC2z.d.ts}

@@ -1,5 +1,5 @@
-import { R as EventMap, d as Effects, o as Scope, s as WithFields } from "./action-creator-HFA_LZOH.js";
-import { t as BoundOf } from "./plugin-Sy8z9IId.js";
+import { d as Effects, o as Scope, s as WithFields, z as EventMap } from "./action-creator-Bpa8BUS9.js";
+import { t as BoundOf } from "./plugin-D9UTzGRG.js";
 //#region src/scope/types.d.ts
 /**
  * The slots `scopePlugin` fills for `modulePlugin`. They are not on `Bus`: a bus

package/dist/vue.d.ts

@@ -0,0 +1,72 @@
+import { T as EventKey, h as Bus, r as FreeActionCreator, t as ActionCreator, z as EventMap } from "./action-creator-Bpa8BUS9.js";
+import { t as OriginOptions } from "./origin-key-CxK0SkeG.js";
+import { t as StateOf } from "./state-of-C19H6BoV.js";
+import { ShallowRef, WatchSource, WatchStopHandle } from "vue";
+//#region src/vue/plugin.d.ts
+/** Tells whether two values are the same. */
+type Equals<V> = (previous: V, next: V) => boolean;
+/** The third argument of `watchEmitter`. */
+type WatchEmitterOptions<V> = OriginOptions & {
+  /** Tells whether a new value is the same as the previous one, for a new object with the same fields. */
+  equals?: Equals<V>;
+};
+/** What `vuePlugin` adds to the bus. */
+type VueApi<E extends EventMap> = {
+  /**
+   * Watches a ref or a getter and emits `event` with its new value when it changes. It
+   * does not emit when it is called, and it stops with the effect scope (a component) that
+   * called it. Like Vue's `watch`, it runs before the next render, so several changes in
+   * one tick emit once, with the last value. The method does not read `this`, so
+   * `export const { watchEmitter } = bus` gives a free function. It returns the function
+   * that stops it early.
+   */
+  watchEmitter: {
+    <K extends EventKey<E>>(source: WatchSource<E[K]>, event: K, options?: WatchEmitterOptions<E[K]>): WatchStopHandle;
+    /** A creator without a payload type: the payload comes from the event map. */
+    <K extends EventKey<E>>(source: WatchSource<E[K]>, creator: FreeActionCreator<K>, options?: WatchEmitterOptions<E[K]>): WatchStopHandle;
+    <P, T extends string>(source: WatchSource<P>, creator: ActionCreator<P, T>, options?: WatchEmitterOptions<P>): WatchStopHandle;
+  };
+  /**
+   * A ref that starts as `initial`, and that every emit of `event` sets to its payload
+   * while the effect scope (a component) that called it lives. A function payload is stored,
+   * not called. The bus keeps no values, so an event emitted before the call is not seen. It
+   * is state of one component, not a store. The method does not read `this`, so
+   * `export const { useEventRef } = bus` gives a free function.
+   */
+  useEventRef: {
+    <K extends EventKey<E>, S>(event: K, initial: StateOf<E[K], S>): ShallowRef<StateOf<E[K], S>>;
+    /** A creator without a payload type: the payload comes from the event map. */
+    <K extends EventKey<E>, S>(creator: FreeActionCreator<K>, initial: StateOf<E[K], S>): ShallowRef<StateOf<E[K], S>>;
+    <P, T extends string>(creator: ActionCreator<P, T>, initial: P): ShallowRef<P>;
+  };
+};
+/**
+ * Adds `bus.watchEmitter(source, event)` and `bus.useEventRef(event, initial)`: the two
+ * jobs of a Vue component with the bus. `watchEmitter` tells the bus when a value of the
+ * component changes, and `useEventRef` keeps the last payload of an event in a ref. Pass
+ * `{ equals }` to `watchEmitter` for values that `Object.is` tells apart although they are
+ * the same, and `{ traceId }` and `{ traceGroupId }` to name the subscription and the flow
+ * in the trace of the bus. Needs `vue` 3.3 or newer. Returns the same bus.
+ *
+ * @example
+ * ```ts
+ * import { createBus } from "nanoeffects";
+ * import { createAction } from "nanoeffects/actions";
+ * import { vuePlugin } from "nanoeffects/vue";
+ * import { ref } from "vue";
+ *
+ * export const bus = createBus().use(vuePlugin());
+ * export const { watchEmitter, useEventRef } = bus; // free functions
+ *
+ * const nameChanged = createAction<string>("name/changed");
+ * const nameSaved = createAction<string[]>("name/saved");
+ *
+ * // inside setup():
+ * const name = ref("Adam");
+ * watchEmitter(name, nameChanged); // nameChanged("…") on every change of name, not on mount
+ * const saved = useEventRef(nameSaved, []); // Ref<string[]>, set by every nameSaved
+ * ```
+ */
+export declare const vuePlugin: () => <E extends EventMap>(bus: Bus<E>) => Bus<E> & VueApi<E>;
+//#endregion
+export type { VueApi };

package/dist/vue.js

@@ -0,0 +1 @@
+import{t as e}from"./origin-key-BbWN3gmN.js";import{onScopeDispose as t,shallowRef as n,watch as r}from"vue";const i=()=>i=>{function a(t,n,a){return r(t,(t,r)=>{let o=r,s=t;if(a?.equals?.(o,s))return;let c=typeof n==`function`?n(s):{type:n,payload:t},l=Reflect.get(i,e);l?l(c,a??{}):i.emit(c)})}function o(e,r){let a=n(r),o=e;return t(i.on(o,e=>{a.value=e})),a}return Object.assign(i,{watchEmitter:a,useEventRef:o})};export{i as vuePlugin};

package/dist/{with-policy-C_mX7S54.d.ts → with-policy-BeH8wCkX.d.ts}

@@ -1,4 +1,4 @@
-import { R as EventMap, U as Task, V as PayloadOf } from "./action-creator-HFA_LZOH.js";
+import { H as PayloadOf, W as Task, z as EventMap } from "./action-creator-Bpa8BUS9.js";
 //#region src/policies/with-policy.d.ts
 /** What `withPolicy` returns: the task as a plain function that can be cancelled. */
 type PolicyFunction<P, R> = {

package/docs/README.md

@@ -18,6 +18,7 @@ Code for every guide step: [`examples/guide.ts`](../examples/guide.ts) (type-che
 | Domain logic off the UI | [Actions, commands, modules](actions.md) |
 | Already on Redux / Zustand / MobX / Pinia | [Stores](stores.md) |
 | A React form with async checks | [Build a sign-up form in React](react.md) |
+| A Vue app | [Use nanoeffects in a Vue app](vue.md) |
 | Old responses overwrite new ones | [Cancel stale requests](cancel-stale-requests.md) |
 | Debounced input that must also cancel the old request | [Debounce and abort](debounce-and-abort.md) |
 | A second click sends a second request | [Prevent a double submit](prevent-double-submit.md) |
@@ -32,6 +33,7 @@ Code for every guide step: [`examples/guide.ts`](../examples/guide.ts) (type-che
 - [Effects and cancellation](effects.md) — `retry`, `timeout`, `poll`, `take`, `all`, …
 - [Actions, commands, jobs and modules](actions.md)
 - [Sign-up form in React](react.md) — one form: races, double submit, retry
+- [nanoeffects in a Vue app](vue.md) — `watchEmitter` and `useEventRef`
 - [Context fields](context.md) — store or client on every task
 - [Use the bus from a class](oop.md) — `extendBus`, `@WithBus`, `@On`, and `dispose()` for the subscriptions of an instance
 - [TypeScript in many files](typescript.md) — keep the types of the bus in commands and modules

package/docs/actions.md

@@ -6,6 +6,8 @@ If you only need `on` / `emit` or policies, stay in the [Guide](guide.md) until
 
 Recipe without a UI framework: [`examples/modules.ts`](../examples/modules.ts).
 
+A chat with four domains, jobs under policies and effects, and a stream tied to a module: [Build a chat with domains, modules and a small server](chat-example.md).
+
 A whole project with two domains, a job and React as a thin layer: `npm create nanoeffects@latest my-app -- --template domains-ts` (see [Start a project from a template](starter.md#start-with-domains)).
 
 ## Return a value from `emit` with a command
@@ -252,11 +254,39 @@ app.commands.handle(getUser, fakeUser); // in a test
 app.dispose(); // unmounts every module
 ```
 
+`mount` and `unmount` take any number of modules. Use it to start the domains of an app yourself, at the moment you choose and in the order you give, when you do not give them to `modulePlugin`:
+
+```js
+import { createModule } from "nanoeffects/actions";
+import { app } from "./bus";
+
+const userModule = createModule("user", (m) => {
+  m.on("user/loaded", (user) => console.log(user));
+});
+const orderModule = createModule("order", (m) => {
+  m.on("order/placed", (order) => console.log(order));
+});
+
+// mount — start both modules, left to right
+const stop = app.mount(userModule, orderModule);
+
+// the returned function stops them again, last mounted first (orderModule, then userModule)
+stop();
+
+// the same for modules that you already have in an array: spread it
+const modules = [userModule, orderModule];
+app.mount(...modules);
+app.unmount(...modules); // also in reverse order
+```
+
+If the `setup` of one module throws, the modules of that call that were already mounted are unmounted again and the error is thrown, so a call mounts all of its modules or none. A module that is mounted already is skipped.
+
 - **Unmounting undoes everything** the module did: subscriptions, bound commands, sub-modules, and background tasks (aborted).
 - **A module is known by its name.** Mounting a module whose name is taken replaces the mounted one (see [Hot reload](hmr.md)).
 - **Registry.** If `bus.use(commandsPlugin())` ran first, that registry is used; otherwise the module plugin attaches its own. Either way it is `bus.commands` and `app.commands`.
 - A disposed app cannot mount modules.
-- **The given modules are mounted on the first use** of the app or the bus (the first `bus.emit`, or a call of `mount`, `unmount`, `isMounted`, `dispose`, or the read of `commands`), so the plugins you use after `modulePlugin` still reach them. The `bus.on` calls made in between are held and made right after, so the listeners of a module stay ahead of them. See [using plugins in any order](plugins.md#use-them-in-any-order).
+- **The given modules are mounted at the end of the block that made the app**, or at the first use of the app or the bus if that comes first (the first `bus.emit`, or a call of `mount`, `unmount`, `isMounted`, `dispose`, or the read of `commands`). Nothing needs to use the app: `bus.use(modulePlugin([a, b]))` is enough to start them. The plugins that you use after `modulePlugin` in the same block still reach them, because the modules wait until that block has finished. A plugin used after an `await` can come too late: use every plugin before the first `await`. The `bus.on` calls made in between are held and made right after, so the listeners of a module stay ahead of them. See [using plugins in any order](plugins.md#use-them-in-any-order).
+- **To mount by hand instead**, pass no modules: `modulePlugin()` starts nothing, and `app.mount(...)` starts the modules when you want.
 - Module context = task context plus `handle`, `use`, and `spawn`:
   - `handle` — give a command a handler (contract, or override).
   - `use` — bring sub-modules and commands that carry a handler; the returned function undoes that call.