nanoeffects 0.13.0 → 0.14.0

package/README.md

@@ -87,8 +87,9 @@ Start with the [Guide](docs/guide.md) (bus → policies → effects → modules)
 | Retry, timeout, wait for events | [Effects](docs/effects.md) |
 | Domain logic off the UI | [Actions, commands, modules](docs/actions.md) |
 | Redux / Zustand / MobX | [Stores](docs/stores.md) |
+| See what ran and why (console, Redux DevTools) | [Tracing](docs/tracing.md) |
 
-[Full index, package entries, tracing](docs/README.md) · [Examples](examples/README.md) · [Why nanoeffects exists](docs/motivation.md)
+[Full index and package entries](docs/README.md) · [Examples](examples/README.md) · [Why nanoeffects exists](docs/motivation.md)
 
 - **Tiny.** `createBus` is about 1.4 kB gzip (1.3 kB brotli); other entries load only when imported.
 - **Cancellation first.** Aborting a task aborts its children and drops its result.

package/dist/actions.d.ts

@@ -1,6 +1,6 @@
 import { B as EventMap, G as Task, T as EventKey, U as PayloadOf, c as WithScope, h as Bus, n as Free, o as Scope, r as FreeActionCreator, t as ActionCreator } from "./action-creator-CQlFgQm4.js";
-import { r as Scoped, t as FieldsOfScope } from "./types-bzocBVYc.js";
-import { a as createModule, c as CarryingCalls, d as commandsPlugin, f as createCommand, l as MadeCommand, n as ModuleApi, o as modulePlugin, r as ModuleContext, s as Binding, t as Module, u as bindHandler } from "./module-woawvR28.js";
+import { r as Scoped, t as FieldsOfScope } from "./types-C7ukMwE-.js";
+import { a as createModule, c as CarryingCalls, d as commandsPlugin, f as createCommand, l as MadeCommand, n as ModuleApi, o as modulePlugin, r as ModuleContext, s as Binding, t as Module, u as bindHandler } from "./module-COv9ZSzS.js";
 import { t as OriginOptions } from "./origin-key-CxK0SkeG.js";
 //#region src/actions/action.d.ts
 type ScopedCreator<P, T extends string, F> = [P] extends [Free] ? FreeActionCreator<T, F> & WithScope<F> : ActionCreator<P, T, PayloadOf<P>, F> & WithScope<F>;

package/dist/context-types-qXxr_Grf.d.ts

@@ -0,0 +1,14 @@
+import { B as EventMap, x as ContextOf } from "./action-creator-CQlFgQm4.js";
+//#region src/core/context-types.d.ts
+/** What a function that makes the fields of a task gets to see. */
+type ContextTask = {
+  type: string;
+  payload?: unknown;
+};
+/**
+ * `unknown` when none of the `fields` is already a context field of the bus,
+ * else `never`: the call does not compile. Used as `bus: Bus<E> & NoClash<…>`.
+ */
+type NoClash<Fields extends object, E extends EventMap> = [keyof Fields & keyof ContextOf<E>] extends [never] ? unknown : never;
+//#endregion
+export { NoClash as n, ContextTask as t };

package/dist/context.d.ts

@@ -0,0 +1,25 @@
+import { B as EventMap, N as WithContext, h as Bus } from "./action-creator-CQlFgQm4.js";
+import { n as NoClash, t as ContextTask } from "./context-types-qXxr_Grf.js";
+//#region src/context/plugin.d.ts
+/**
+ * Puts `fields` on the context of every task of the bus: a store, a client, a
+ * logger. The types come from the value, so the event map needs no
+ * `WithContext`. Returns the same bus, typed with the fields. A function gets
+ * `{ type, payload }` of the task and returns its fields.
+ *
+ * Several uses merge with each other, with the `context` option of `createBus`
+ * and with `effectsPlugin`. A name that the bus already has is a type error. The
+ * fields of the library (`signal`, `emit`, `run`, …) win, and a field that the
+ * context already has is not replaced.
+ *
+ * @example
+ * ```ts
+ * type Events = { "user/loaded": User };
+ *
+ * const bus = createBus<Events>().use(contextPlugin({ store }));
+ * bus.on("user/loaded", (user, { store }) => store.put(user)); // ctx.store: Store
+ * ```
+ */
+export declare const contextPlugin: <Fields extends object>(fields: Fields | ((task: ContextTask) => Fields)) => <E extends EventMap>(bus: Bus<E> & NoClash<Fields, E>) => Bus<E & WithContext<Fields>>;
+//#endregion
+export type { ContextTask, NoClash };

package/dist/context.js

@@ -0,0 +1 @@
+const e=e=>typeof e==`function`,t=e=>({type:Reflect.get(e,`type`),payload:Reflect.get(e,`payload`)}),n=n=>r=>{let i=r.addContext;return r.addContext=r=>{i?.(r);let a=e(n)?n(t(r)):n;for(let[e,t]of Object.entries(a))e in r||Reflect.set(r,e,t)},r};export{n as contextPlugin};

package/dist/dev.d.ts

@@ -1,5 +1,5 @@
 import { B as EventMap, Y as UnsubscribeCallback, h as Bus } from "./action-creator-CQlFgQm4.js";
-import { i as WithApp, n as ModuleApi } from "./module-woawvR28.js";
+import { i as WithApp, n as ModuleApi } from "./module-COv9ZSzS.js";
 //#region src/dev/types.d.ts
 /** The parts of what `modulePlugin` returned that the diagnostics report. */
 type ReportedApp<E extends EventMap> = Pick<ModuleApi<E>, "mount" | "unmount" | "isMounted">;

package/dist/effects.d.ts

@@ -1,5 +1,5 @@
 import { B as EventMap, G as Task, u as Effect } from "./action-creator-CQlFgQm4.js";
-import { a as RaceStarter, c as all, d as delay, i as take, l as EffectContext, n as effectsPlugin, o as race, r as TakeOptions, s as allSettled, u as Starter } from "./plugin-BrTsPg2Y.js";
+import { a as RaceStarter, c as all, d as delay, i as take, l as EffectContext, n as effectsPlugin, o as race, r as TakeOptions, s as allSettled, u as Starter } from "./plugin-15-kkZp0.js";
 //#region src/utils/onAbort.d.ts
 export declare const onAbort: (ctx: {
   signal?: AbortSignal | undefined;

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 import { A as HandlerRef, B as EventMap, C as Emit, D as EventPayload, E as EventLike, F as commandCall, G as Task, I as createBus, J as TraceLogger, K as Trace, L as Tracer, M as On, N as WithContext, O as EventsOf, P as WithType, R as anyEventType, S as ContextOption, T as EventKey, U as PayloadOf, V as Keys, W as Phase, Y as UnsubscribeCallback, _ as Command, b as Context, g as BusOptions, h as Bus, i as WithPayload, j as Off, k as Handler, m as AnyEvent, p as Action, q as TraceEvent, v as CommandCall, w as Emittable, x as ContextOf, y as Commands, z as EffectName } from "./action-creator-CQlFgQm4.js";
-import { n as NoClash, r as contextPlugin, t as ContextTask } from "./context-plugin-Cphk8jfq.js";
-export { type Action, type AnyEvent, type Bus, type BusOptions, type Command, type CommandCall, type Commands, type Context, type ContextOf, type ContextOption, type ContextTask, type EffectName, type Emit, type Emittable, type EventKey, type EventLike, type EventMap, type EventPayload, type EventsOf, type Handler, type HandlerRef, type Keys, type NoClash, type Off, type On, type PayloadOf, type Phase, type Task, type Trace, type TraceEvent, type TraceLogger, type Tracer, type UnsubscribeCallback, type WithContext, type WithPayload, type WithType, anyEventType, commandCall, contextPlugin, createBus };
+import { n as NoClash, t as ContextTask } from "./context-types-qXxr_Grf.js";
+export { type Action, type AnyEvent, type Bus, type BusOptions, type Command, type CommandCall, type Commands, type Context, type ContextOf, type ContextOption, type ContextTask, type EffectName, type Emit, type Emittable, type EventKey, type EventLike, type EventMap, type EventPayload, type EventsOf, type Handler, type HandlerRef, type Keys, type NoClash, type Off, type On, type PayloadOf, type Phase, type Task, type Trace, type TraceEvent, type TraceLogger, type Tracer, type UnsubscribeCallback, type WithContext, type WithPayload, type WithType, anyEventType, commandCall, createBus };

package/dist/index.js

@@ -1 +1 @@
-import{a as e,r as t,t as n}from"./bus-Cdw5ajKF.js";const r=e=>typeof e==`function`,i=e=>({type:Reflect.get(e,`type`),payload:Reflect.get(e,`payload`)}),a=e=>t=>{let n=t.addContext;return t.addContext=t=>{n?.(t);let a=r(e)?e(i(t)):e;for(let[e,n]of Object.entries(a))e in t||Reflect.set(t,e,n)},t};export{e as anyEventType,n as commandCall,a as contextPlugin,t as createBus};
+export{a as anyEventType,t as commandCall,r as createBus}from"./bus-Cdw5ajKF.js";

package/dist/{module-woawvR28.d.ts → module-COv9ZSzS.d.ts}

@@ -1,5 +1,5 @@
 import { B as EventMap, G as Task, U as PayloadOf, Y as UnsubscribeCallback, _ as Command, b as Context, c as WithScope, h as Bus, o as Scope, v as CommandCall, y as Commands } from "./action-creator-CQlFgQm4.js";
-import { n as ScopeSlots, r as Scoped, t as FieldsOfScope } from "./types-bzocBVYc.js";
+import { n as ScopeSlots, r as Scoped, t as FieldsOfScope } from "./types-C7ukMwE-.js";
 //#region src/actions/command.d.ts
 /** What `createCommand` returns: a command that also tells whether an action is of its type. */
 type MadeCommand<P, R, T extends string> = Command<P, R> & {

package/dist/notrace/actions.d.ts

@@ -1,5 +1,5 @@
 import { B as PayloadOf, C as EventKey, H as Task, K as UnsubscribeCallback, R as EventMap, _ as Commands, a as Scope, g as CommandCall, h as Command, n as Free, o as WithFields, p as Bus, r as FreeActionCreator, s as WithScope, t as ActionCreator, u as Effects, v as Context } from "./action-creator-Ls3Gy3jk.js";
-import { t as BoundOf } from "./plugin-Cw45_-Bo.js";
+import { t as BoundOf } from "./plugin-W4pZY7mM.js";
 import { t as OriginOptions } from "./origin-key-CxK0SkeG.js";
 //#region src/scope/types.d.ts
 /**

package/dist/notrace/context-types-DQYBFJG4.d.ts

@@ -0,0 +1,14 @@
+import { R as EventMap, y as ContextOf } from "./action-creator-Ls3Gy3jk.js";
+//#region src/core/context-types.d.ts
+/** What a function that makes the fields of a task gets to see. */
+type ContextTask = {
+  type: string;
+  payload?: unknown;
+};
+/**
+ * `unknown` when none of the `fields` is already a context field of the bus,
+ * else `never`: the call does not compile. Used as `bus: Bus<E> & NoClash<…>`.
+ */
+type NoClash<Fields extends object, E extends EventMap> = [keyof Fields & keyof ContextOf<E>] extends [never] ? unknown : never;
+//#endregion
+export { NoClash as n, ContextTask as t };

package/dist/notrace/effects.d.ts

@@ -1,5 +1,5 @@
 import { H as Task, R as EventMap, l as Effect } from "./action-creator-Ls3Gy3jk.js";
-import { a as RaceStarter, c as all, d as delay, i as take, l as EffectContext, n as effectsPlugin, o as race, r as TakeOptions, s as allSettled, u as Starter } from "./plugin-Cw45_-Bo.js";
+import { a as RaceStarter, c as all, d as delay, i as take, l as EffectContext, n as effectsPlugin, o as race, r as TakeOptions, s as allSettled, u as Starter } from "./plugin-W4pZY7mM.js";
 //#region src/utils/onAbort.d.ts
 export declare const onAbort: (ctx: {
   signal?: AbortSignal | undefined;

package/dist/notrace/index.d.ts

@@ -1,3 +1,3 @@
 import { A as On, B as PayloadOf, C as EventKey, D as Handler, E as EventsOf, F as Tracer, G as TraceLogger, H as Task, I as anyEventType, K as UnsubscribeCallback, L as EffectName, M as WithType, N as commandCall, O as HandlerRef, P as createBus, R as EventMap, S as Emittable, T as EventPayload, U as Trace, V as Phase, W as TraceEvent, _ as Commands, b as ContextOption, d as Action, f as AnyEvent, g as CommandCall, h as Command, i as WithPayload, j as WithContext, k as Off, m as BusOptions, p as Bus, v as Context, w as EventLike, x as Emit, y as ContextOf, z as Keys } from "./action-creator-Ls3Gy3jk.js";
-import { n as NoClash, r as contextPlugin, t as ContextTask } from "./context-plugin-BQa-wtbj.js";
-export { type Action, type AnyEvent, type Bus, type BusOptions, type Command, type CommandCall, type Commands, type Context, type ContextOf, type ContextOption, type ContextTask, type EffectName, type Emit, type Emittable, type EventKey, type EventLike, type EventMap, type EventPayload, type EventsOf, type Handler, type HandlerRef, type Keys, type NoClash, type Off, type On, type PayloadOf, type Phase, type Task, type Trace, type TraceEvent, type TraceLogger, type Tracer, type UnsubscribeCallback, type WithContext, type WithPayload, type WithType, anyEventType, commandCall, contextPlugin, createBus };
+import { n as NoClash, t as ContextTask } from "./context-types-DQYBFJG4.js";
+export { type Action, type AnyEvent, type Bus, type BusOptions, type Command, type CommandCall, type Commands, type Context, type ContextOf, type ContextOption, type ContextTask, type EffectName, type Emit, type Emittable, type EventKey, type EventLike, type EventMap, type EventPayload, type EventsOf, type Handler, type HandlerRef, type Keys, type NoClash, type Off, type On, type PayloadOf, type Phase, type Task, type Trace, type TraceEvent, type TraceLogger, type Tracer, type UnsubscribeCallback, type WithContext, type WithPayload, type WithType, anyEventType, commandCall, createBus };

package/dist/notrace/index.js

@@ -1 +1 @@
-import{i as e,n as t,t as n}from"./bus-G2AdGObY.js";const r=e=>typeof e==`function`,i=e=>({type:Reflect.get(e,`type`),payload:Reflect.get(e,`payload`)}),a=e=>t=>{let n=t.addContext;return t.addContext=t=>{n?.(t);let a=r(e)?e(i(t)):e;for(let[e,n]of Object.entries(a))e in t||Reflect.set(t,e,n)},t};export{e as anyEventType,n as commandCall,a as contextPlugin,t as createBus};
+export{i as anyEventType,t as commandCall,n as createBus}from"./bus-G2AdGObY.js";

package/dist/notrace/{plugin-Cw45_-Bo.d.ts → plugin-W4pZY7mM.d.ts}

@@ -1,5 +1,5 @@
 import { R as EventMap, c as BoundForm, j as WithContext, p as Bus, u as Effects, v as Context, z as Keys } from "./action-creator-Ls3Gy3jk.js";
-import { n as NoClash } from "./context-plugin-BQa-wtbj.js";
+import { n as NoClash } from "./context-types-DQYBFJG4.js";
 //#region src/utils/delay.d.ts
 /**
  * Resolves after `ms`, or rejects early if `ctx.signal` aborts. `ms` can be a

package/dist/{plugin-BrTsPg2Y.d.ts → plugin-15-kkZp0.d.ts}

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

package/dist/scope.d.ts

@@ -1,5 +1,5 @@
 import { B as EventMap, a as EmitScope, d as Effects, f as Signaled, h as Bus, o as Scope, u as Effect } from "./action-creator-CQlFgQm4.js";
-import { n as ScopeSlots, r as Scoped } from "./types-bzocBVYc.js";
+import { n as ScopeSlots, r as Scoped } from "./types-C7ukMwE-.js";
 //#region src/scope/effect.d.ts
 /**
  * Marks a function whose first parameter is `{ signal }` as an effect, so that

package/dist/{types-bzocBVYc.d.ts → types-C7ukMwE-.d.ts}

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

package/docs/context.md

@@ -25,10 +25,11 @@ To give fields to **one** command, action, job or module, or to replace them for
 
 ## Type the fields (optional)
 
-In TypeScript, `contextPlugin` puts the fields on every task of **this** bus and takes their types from the value you pass. The event map holds only events. It does not wire anything across the app — another bus can have different fields or none.
+In TypeScript, `contextPlugin` (from `nanoeffects/context`) puts the fields on every task of **this** bus and takes their types from the value you pass. The event map holds only events. It does not wire anything across the app — another bus can have different fields or none.
 
 ```ts
-import { contextPlugin, createBus } from "nanoeffects";
+import { createBus } from "nanoeffects";
+import { contextPlugin } from "nanoeffects/context";
 
 // Events — event name → payload
 type Events = { save: Draft };

package/docs/package.md

@@ -9,6 +9,7 @@ Imports are split so you only load what you use. `createBus` stays small; the re
 | `nanoeffects/effects` | `retry`, `timeout`, `poll`, `delay`, `take`, `all`, `allSettled`, `race`, `effectsPlugin` |
 | `nanoeffects/actions` | `createAction`, `createCommand`, `createJob`, `createModule`, `modulePlugin`, `commandsPlugin` |
 | `nanoeffects/match` | `matchPlugin`: `on`, `once` and `off` that take a function which picks the events |
+| `nanoeffects/context` | `contextPlugin`: your own fields (a store, a client) on `ctx` of every task, typed from the value |
 | `nanoeffects/signal` | `signalPlugin`: `emit(call, { signal })` ties the tasks of an emit to an outside `AbortSignal` |
 | `nanoeffects/oop` | `extendBus`, `WithBus`, `On`, `Once`, `disposeBus`: the methods of a bus on a class, with the subscriptions of each instance ended by `dispose()` |
 | `nanoeffects/scope` | `scopePlugin`, `effect`: fields for one command, action, job, module or `emit` (the types `Scope`, `Effect`) |

package/docs/plugins.md

@@ -24,7 +24,8 @@ These four cover what most apps need: shared dependencies, effects, commands and
 Every task gets the same fields on `ctx`: a store, an API client, a logger. The types come from the values. More in [Context fields](context.md).
 
 ```js
-import { contextPlugin, createBus } from "nanoeffects";
+import { createBus } from "nanoeffects";
+import { contextPlugin } from "nanoeffects/context";
 
 // contextPlugin — every handler gets ctx.store
 const bus = createBus().use(contextPlugin({ store }));
@@ -232,7 +233,8 @@ One bus with every plugin that does not need React, in a file of its own. The ev
 
 ```js
 // bus.js
-import { contextPlugin, createBus } from "nanoeffects";
+import { createBus } from "nanoeffects";
+import { contextPlugin } from "nanoeffects/context";
 import {
   commandsPlugin,
   emitterPlugin,

package/docs/stores.md

@@ -131,8 +131,9 @@ The bus, the events, the handlers and the link from the store to the bus are the
 
 ```js
 // bus.js
-import { contextPlugin, createBus } from "nanoeffects";
+import { createBus } from "nanoeffects";
 import { emitterPlugin } from "nanoeffects/actions";
+import { contextPlugin } from "nanoeffects/context";
 import { store } from "./store";
 
 export const bus = createBus()
@@ -513,8 +514,9 @@ export const query = createValue("");
 
 ```js
 // bus.js
-import { contextPlugin, createBus } from "nanoeffects";
+import { createBus } from "nanoeffects";
 import { emitterPlugin } from "nanoeffects/actions";
+import { contextPlugin } from "nanoeffects/context";
 import { query } from "./query";
 
 // emitterPlugin adds bus.emitter; contextPlugin puts `query` on every task as ctx.query

package/docs/tracing.md

@@ -1,6 +1,8 @@
 # Trace tasks
 
-Reference for long-lived apps that need to observe task phases, Redux DevTools, or a build without tracing. Not part of onboarding.
+Find out what your app did and why: which events were emitted, which calls a policy cancelled or dropped, which request failed. You see it in the browser console, in Redux DevTools, or in the Performance panel.
+
+Tracing is optional. A bus works the same without it, and it costs almost nothing until you turn it on. If you only want to see what happens while you develop, jump to [Show every emit](#show-every-emit) and [Configure Redux DevTools](#configure-redux-devtools); the rest of the page is for apps that need to follow a flow or turn tracing off in a build.
 
 ## Attach a tracer
 

package/docs/typescript.md

@@ -70,8 +70,9 @@ At runtime the bus still gives the task its fields. Only the checker does not kn
 <!-- docs-check: skip - a file of examples/typescript-context, type-checked there -->
 ```ts
 // bus.ts
-import { type Context, contextPlugin, createBus, type EventsOf } from "nanoeffects";
+import { type Context, createBus, type EventsOf } from "nanoeffects";
 import { modulePlugin } from "nanoeffects/actions";
+import { contextPlugin } from "nanoeffects/context";
 import { effectsPlugin, race } from "nanoeffects/effects";
 
 // Events: event name → payload; nothing about ctx is written here

package/llms-full.txt

@@ -559,6 +559,7 @@ Imports are split so you only load what you use. `createBus` stays small; the re
 | `nanoeffects/effects` | `retry`, `timeout`, `poll`, `delay`, `take`, `all`, `allSettled`, `race`, `effectsPlugin` |
 | `nanoeffects/actions` | `createAction`, `createCommand`, `createJob`, `createModule`, `modulePlugin`, `commandsPlugin` |
 | `nanoeffects/match` | `matchPlugin`: `on`, `once` and `off` that take a function which picks the events |
+| `nanoeffects/context` | `contextPlugin`: your own fields (a store, a client) on `ctx` of every task, typed from the value |
 | `nanoeffects/signal` | `signalPlugin`: `emit(call, { signal })` ties the tasks of an emit to an outside `AbortSignal` |
 | `nanoeffects/oop` | `extendBus`, `WithBus`, `On`, `Once`, `disposeBus`: the methods of a bus on a class, with the subscriptions of each instance ended by `dispose()` |
 | `nanoeffects/scope` | `scopePlugin`, `effect`: fields for one command, action, job, module or `emit` (the types `Scope`, `Effect`) |
@@ -609,7 +610,8 @@ These four cover what most apps need: shared dependencies, effects, commands and
 Every task gets the same fields on `ctx`: a store, an API client, a logger. The types come from the values. More in [Context fields](context.md).
 
 ```js
-import { contextPlugin, createBus } from "nanoeffects";
+import { createBus } from "nanoeffects";
+import { contextPlugin } from "nanoeffects/context";
 
 // contextPlugin — every handler gets ctx.store
 const bus = createBus().use(contextPlugin({ store }));
@@ -817,7 +819,8 @@ One bus with every plugin that does not need React, in a file of its own. The ev
 
 ```js
 // bus.js
-import { contextPlugin, createBus } from "nanoeffects";
+import { createBus } from "nanoeffects";
+import { contextPlugin } from "nanoeffects/context";
 import {
   commandsPlugin,
   emitterPlugin,
@@ -2189,8 +2192,9 @@ The bus, the events, the handlers and the link from the store to the bus are the
 
 ```js
 // bus.js
-import { contextPlugin, createBus } from "nanoeffects";
+import { createBus } from "nanoeffects";
 import { emitterPlugin } from "nanoeffects/actions";
+import { contextPlugin } from "nanoeffects/context";
 import { store } from "./store";
 
 export const bus = createBus()
@@ -2571,8 +2575,9 @@ export const query = createValue("");
 
 ```js
 // bus.js
-import { contextPlugin, createBus } from "nanoeffects";
+import { createBus } from "nanoeffects";
 import { emitterPlugin } from "nanoeffects/actions";
+import { contextPlugin } from "nanoeffects/context";
 import { query } from "./query";
 
 // emitterPlugin adds bus.emitter; contextPlugin puts `query` on every task as ctx.query
@@ -3101,10 +3106,11 @@ To give fields to **one** command, action, job or module, or to replace them for
 
 ## Type the fields (optional)
 
-In TypeScript, `contextPlugin` puts the fields on every task of **this** bus and takes their types from the value you pass. The event map holds only events. It does not wire anything across the app — another bus can have different fields or none.
+In TypeScript, `contextPlugin` (from `nanoeffects/context`) puts the fields on every task of **this** bus and takes their types from the value you pass. The event map holds only events. It does not wire anything across the app — another bus can have different fields or none.
 
 ```ts
-import { contextPlugin, createBus } from "nanoeffects";
+import { createBus } from "nanoeffects";
+import { contextPlugin } from "nanoeffects/context";
 
 // Events — event name → payload
 type Events = { save: Draft };
@@ -3770,8 +3776,9 @@ At runtime the bus still gives the task its fields. Only the checker does not kn
 <!-- docs-check: skip - a file of examples/typescript-context, type-checked there -->
 ```ts
 // bus.ts
-import { type Context, contextPlugin, createBus, type EventsOf } from "nanoeffects";
+import { type Context, createBus, type EventsOf } from "nanoeffects";
 import { modulePlugin } from "nanoeffects/actions";
+import { contextPlugin } from "nanoeffects/context";
 import { effectsPlugin, race } from "nanoeffects/effects";
 
 // Events: event name → payload; nothing about ctx is written here
@@ -4540,7 +4547,9 @@ Source: docs/tracing.md
 
 # Trace tasks
 
-Reference for long-lived apps that need to observe task phases, Redux DevTools, or a build without tracing. Not part of onboarding.
+Find out what your app did and why: which events were emitted, which calls a policy cancelled or dropped, which request failed. You see it in the browser console, in Redux DevTools, or in the Performance panel.
+
+Tracing is optional. A bus works the same without it, and it costs almost nothing until you turn it on. If you only want to see what happens while you develop, jump to [Show every emit](#show-every-emit) and [Configure Redux DevTools](#configure-redux-devtools); the rest of the page is for apps that need to follow a flow or turn tracing off in a build.
 
 ## Attach a tracer
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "nanoeffects",
-	"version": "0.13.0",
+	"version": "0.14.0",
 	"description": "Cancel stale async work and fix race conditions in event handlers: a typed event bus where every handler is a task with an AbortSignal, plus latest, debounce, throttle, queue, retry, timeout and poll. About 1.4 kB gzip.",
 	"keywords": [
 		"event-bus",
@@ -40,7 +40,7 @@
 		"node": ">=18"
 	},
 	"type": "module",
-	"packageManager": "pnpm@11.13.0",
+	"packageManager": "pnpm@11.28.9",
 	"sideEffects": false,
 	"files": [
 		"dist",
@@ -98,6 +98,10 @@
 			"types": "./dist/signal.d.ts",
 			"import": "./dist/signal.js"
 		},
+		"./context": {
+			"types": "./dist/context.d.ts",
+			"import": "./dist/context.js"
+		},
 		"./oop": {
 			"types": "./dist/oop.d.ts",
 			"import": "./dist/oop.js"
@@ -214,6 +218,11 @@
 			"path": "dist/signal.js",
 			"limit": "0.6 kB"
 		},
+		{
+			"name": "context (plugin)",
+			"path": "dist/context.js",
+			"limit": "0.2 kB"
+		},
 		{
 			"name": "oop (class entry)",
 			"path": "dist/oop.js",

package/dist/context-plugin-Cphk8jfq.d.ts

@@ -1,34 +0,0 @@
-import { B as EventMap, N as WithContext, h as Bus, x as ContextOf } from "./action-creator-CQlFgQm4.js";
-//#region src/core/context-plugin.d.ts
-/** What a function that makes the fields of a task gets to see. */
-type ContextTask = {
-  type: string;
-  payload?: unknown;
-};
-/**
- * `unknown` when none of the `fields` is already a context field of the bus,
- * else `never`: the call does not compile. Used as `bus: Bus<E> & NoClash<…>`.
- */
-type NoClash<Fields extends object, E extends EventMap> = [keyof Fields & keyof ContextOf<E>] extends [never] ? unknown : never;
-/**
- * Puts `fields` on the context of every task of the bus: a store, a client, a
- * logger. The types come from the value, so the event map needs no
- * `WithContext`. Returns the same bus, typed with the fields. A function gets
- * `{ type, payload }` of the task and returns its fields.
- *
- * Several uses merge with each other, with the `context` option of `createBus`
- * and with `effectsPlugin`. A name that the bus already has is a type error. The
- * fields of the library (`signal`, `emit`, `run`, …) win, and a field that the
- * context already has is not replaced.
- *
- * @example
- * ```ts
- * type Events = { "user/loaded": User };
- *
- * const bus = createBus<Events>().use(contextPlugin({ store }));
- * bus.on("user/loaded", (user, { store }) => store.put(user)); // ctx.store: Store
- * ```
- */
-declare const contextPlugin: <Fields extends object>(fields: Fields | ((task: ContextTask) => Fields)) => <E extends EventMap>(bus: Bus<E> & NoClash<Fields, E>) => Bus<E & WithContext<Fields>>;
-//#endregion
-export { NoClash as n, contextPlugin as r, ContextTask as t };

package/dist/notrace/context-plugin-BQa-wtbj.d.ts

@@ -1,34 +0,0 @@
-import { R as EventMap, j as WithContext, p as Bus, y as ContextOf } from "./action-creator-Ls3Gy3jk.js";
-//#region src/core/context-plugin.d.ts
-/** What a function that makes the fields of a task gets to see. */
-type ContextTask = {
-  type: string;
-  payload?: unknown;
-};
-/**
- * `unknown` when none of the `fields` is already a context field of the bus,
- * else `never`: the call does not compile. Used as `bus: Bus<E> & NoClash<…>`.
- */
-type NoClash<Fields extends object, E extends EventMap> = [keyof Fields & keyof ContextOf<E>] extends [never] ? unknown : never;
-/**
- * Puts `fields` on the context of every task of the bus: a store, a client, a
- * logger. The types come from the value, so the event map needs no
- * `WithContext`. Returns the same bus, typed with the fields. A function gets
- * `{ type, payload }` of the task and returns its fields.
- *
- * Several uses merge with each other, with the `context` option of `createBus`
- * and with `effectsPlugin`. A name that the bus already has is a type error. The
- * fields of the library (`signal`, `emit`, `run`, …) win, and a field that the
- * context already has is not replaced.
- *
- * @example
- * ```ts
- * type Events = { "user/loaded": User };
- *
- * const bus = createBus<Events>().use(contextPlugin({ store }));
- * bus.on("user/loaded", (user, { store }) => store.put(user)); // ctx.store: Store
- * ```
- */
-declare const contextPlugin: <Fields extends object>(fields: Fields | ((task: ContextTask) => Fields)) => <E extends EventMap>(bus: Bus<E> & NoClash<Fields, E>) => Bus<E & WithContext<Fields>>;
-//#endregion
-export { NoClash as n, contextPlugin as r, ContextTask as t };