@thi.ng/interceptors 3.2.78 → 3.2.80

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2025-01-29T16:25:48Z
+- **Last updated**: 2025-02-13T16:03:11Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.

package/event-bus.d.ts

@@ -2,32 +2,30 @@ import type { IDeref, IObjectOf, Maybe } from "@thi.ng/api";
 import type { IAtom } from "@thi.ng/atom";
 import { type EffectDef, type EffectPriority, type Event, type EventDef, type IDispatch, type Interceptor, type InterceptorContext, type InterceptorFn, type SideEffect } from "./api.js";
 /**
- * Batched event processor for using composable interceptors for event
- * handling and side effects to execute the result of handled events.
+ * Batched event processor for using composable interceptors for event handling
+ * and side effects to execute the result of handled events.
  *
  * @remarks
- * Events processed by this class are simple 2-element tuples/arrays of
- * this form: `["event-id", payload?]`, where the `payload` is optional
- * and can be of any type.
+ * Events processed by this class are simple 2-element tuples/arrays of this
+ * form: `["event-id", payload?]`, where the `payload` is optional and can be of
+ * any type.
  *
- * Events are processed by registered handlers which transform each
- * event into a number of side effect descriptions to be executed later.
- * This separation ensures event handlers themselves are pure functions
- * and leads to more efficient reuse of side effecting operations. The
- * pure data nature until the last stage of processing (the application
- * side effects) too means that event flow can be much easier inspected
- * and debugged.
+ * Events are processed by registered handlers which transform each event into a
+ * number of side effect descriptions to be executed later. This separation
+ * ensures event handlers themselves are pure functions and leads to more
+ * efficient reuse of side effecting operations. The pure data nature until the
+ * last stage of processing (the application side effects) too means that event
+ * flow can be much easier inspected and debugged.
  *
- * In this model a single event handler itself is an array of objects
- * with `pre` and/or `post` keys and functions attached to each key.
- * These functions are called interceptors, since each intercepts the
- * processing of an event and can contribute their own side effects.
- * Each event's interceptor chain is processed bi-directionally (`pre`
- * in forward, `post` in reverse order) and the effects returned from
- * each interceptor are merged/collected. The outcome of this setup is a
- * more aspect-oriented, composable approach to event handling and
- * allows to inject common, re-usable behaviors for multiple event types
- * (logging, validation, undo/redo triggers etc.).
+ * In this model a single event handler itself is an array of objects with `pre`
+ * and/or `post` keys and functions attached to each key. These functions are
+ * called interceptors, since each intercepts the processing of an event and can
+ * contribute their own side effects. Each event's interceptor chain is
+ * processed bi-directionally (`pre` in forward, `post` in reverse order) and
+ * the effects returned from each interceptor are merged/collected. The outcome
+ * of this setup is a more aspect-oriented, composable approach to event
+ * handling and allows to inject common, re-usable behaviors for multiple event
+ * types (logging, validation, undo/redo triggers etc.).
  *
  * Side effects are only processed after all event handlers have run.
  * Furthermore, their order of execution can be configured with optional
@@ -40,18 +38,17 @@ import { type EffectDef, type EffectPriority, type Event, type EventDef, type ID
  * - {@link StatelessEventBus.processEffects}
  * - {@link StatelessEventBus.mergeEffects}
  *
- * The overall approach of this type of event processing is heavily
- * based on the pattern initially pioneered by @Day8/re-frame, with the
- * following differences:
+ * The overall approach of this type of event processing is heavily based on the
+ * pattern initially pioneered by @Day8/re-frame, with the following
+ * differences:
  *
- * - stateless (see {@link EventBus} for the more common stateful
- *   alternative)
+ * - stateless (see {@link EventBus} for the more common stateful alternative)
  * - standalone implementation (no assumptions about surrounding
  *   context/framework)
  * - manual control over event queue processing
  * - supports event cancellation (via FX_CANCEL side effect)
- * - side effect collection (multiple side effects for same effect type
- *   per frame)
+ * - side effect collection (multiple side effects for same effect type per
+ *   frame)
  * - side effect priorities (to control execution order)
  * - dynamic addition/removal of handlers & effects
  */
@@ -345,7 +342,7 @@ export declare class EventBus extends StatelessEventBus implements IDeref<any>,
      * #### `EV_SET_VALUE`
      *
      * Resets state path to provided value. See
-     * [`setIn()`](https://docs.thi.ng/umbrella/paths/functions/setIn.html).
+     * [`setIn`](https://docs.thi.ng/umbrella/paths/functions/setIn.html).
      *
      * Example event definition:
      * ```js
@@ -358,7 +355,7 @@ export declare class EventBus extends StatelessEventBus implements IDeref<any>,
      *
      * Updates a state path's value with provided function and optional extra
      * arguments. See
-     * [`updateIn()`](https://docs.thi.ng/umbrella/paths/functions/updateIn.html).
+     * [`updateIn`](https://docs.thi.ng/umbrella/paths/functions/updateIn.html).
      *
      * Example event definition:
      * ```js

package/event-bus.js

@@ -517,7 +517,7 @@ class EventBus extends StatelessEventBus {
    * #### `EV_SET_VALUE`
    *
    * Resets state path to provided value. See
-   * [`setIn()`](https://docs.thi.ng/umbrella/paths/functions/setIn.html).
+   * [`setIn`](https://docs.thi.ng/umbrella/paths/functions/setIn.html).
    *
    * Example event definition:
    * ```js
@@ -530,7 +530,7 @@ class EventBus extends StatelessEventBus {
    *
    * Updates a state path's value with provided function and optional extra
    * arguments. See
-   * [`updateIn()`](https://docs.thi.ng/umbrella/paths/functions/updateIn.html).
+   * [`updateIn`](https://docs.thi.ng/umbrella/paths/functions/updateIn.html).
    *
    * Example event definition:
    * ```js

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/interceptors",
-  "version": "3.2.78",
+  "version": "3.2.80",
   "description": "Interceptor based event bus, side effect & immutable state handling",
   "type": "module",
   "module": "./index.js",
@@ -42,16 +42,16 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.11.19",
-    "@thi.ng/atom": "^5.3.20",
-    "@thi.ng/checks": "^3.6.22",
-    "@thi.ng/errors": "^2.5.25",
-    "@thi.ng/logger": "^3.0.30",
-    "@thi.ng/paths": "^5.2.0"
+    "@thi.ng/api": "^8.11.20",
+    "@thi.ng/atom": "^5.3.21",
+    "@thi.ng/checks": "^3.6.23",
+    "@thi.ng/errors": "^2.5.26",
+    "@thi.ng/logger": "^3.1.1",
+    "@thi.ng/paths": "^5.2.1"
   },
   "devDependencies": {
-    "esbuild": "^0.24.2",
-    "typedoc": "^0.27.6",
+    "esbuild": "^0.25.0",
+    "typedoc": "^0.27.7",
     "typescript": "^5.7.3"
   },
   "keywords": [
@@ -97,5 +97,5 @@
     "status": "completed",
     "year": 2016
   },
-  "gitHead": "fc1d498e8d4b690db873c30cc594352a804e7a65\n"
+  "gitHead": "9a0b33253fef092aaf301decf6ecd54317874d4c\n"
 }