@thi.ng/rstream 8.3.8 → 8.3.10

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-02-25T14:07:53Z
+- **Last updated**: 2024-03-02T14:05:52Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.

package/README.md

@@ -1,16 +1,5 @@
 <!-- This file is generated - DO NOT EDIT! -->
 <!-- Please see: https://github.com/thi-ng/umbrella/blob/develop/CONTRIBUTING.md#changes-to-readme-files -->
-> [!IMPORTANT]
-> ‼️ Announcing the thi.ng user survey 2024 📋
->
-> [Please participate in the survey here!](https://forms.gle/XacbSDEmQMPZg8197)\
-> (open until end of February)
->
-> **To achieve a better sample size, I'd highly appreciate if you could
-> circulate the link to this survey in your own networks.**
->
-> [Discussion](https://github.com/thi-ng/umbrella/discussions/447)
-
 # ![@thi.ng/rstream](https://media.thi.ng/umbrella/banners-20230807/thing-rstream.svg?86471843)
 
 [![npm version](https://img.shields.io/npm/v/@thi.ng/rstream.svg)](https://www.npmjs.com/package/@thi.ng/rstream)
@@ -22,7 +11,7 @@
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >
-> 🚀 Help me to work full-time on these projects by [sponsoring me on
+> 🚀 Please help me to work full-time on these projects by [sponsoring me on
 > GitHub](https://github.com/sponsors/postspectacular). Thank you! ❤️
 
 - [About](#about)
@@ -146,6 +135,9 @@ src.transform({ xform: map(...), error: handleError });
    (transducer) must now be given as part of the options object:
 
 ```ts
+import { reactive, trace } from "@thi.ng/rstream";
+import { filter } from "@thi.ng/transducers";
+
 const src = reactive(1);
 
 // old
@@ -160,6 +152,9 @@ src.subscribe(trace("foo"), { xform: filter((x) => x < 10), id: "child-sub" });
    similarity to above.
 
 ```ts
+import { pubsub } from "@thi.ng/rstream";
+import { map } from "@thi.ng/transducers";
+
 type Event = { id: string; value: any; };
 
 const src = pubsub<Event>({ topic: (e) => e.id });
@@ -352,6 +347,8 @@ triggered manually (from outside the stream), in which case the user
 should call `stream.next()` to cause value propagation.
 
 ```ts
+import { stream, trace } from "@thi.ng/rstream";
+
 a = stream<number>((s) => {
     s.next(1);
     s.next(2);
@@ -411,14 +408,19 @@ too). Subscriptions can be:
 - implement the @thi.ng/api `IDeref` interface
 
 ```ts
+import { subscription, trace } from "@thi.ng/rstream";
+import { filter } from "@thi.ng/transducers";
+
 // as reactive value mechanism (same as with stream() above)
 s = subscription<any, any>();
 s.subscribe(trace("s1"));
-s.subscribe(trace("s2"), tx.filter((x) => x > 25));
+s.subscribe(trace("s2"), filter((x) => x > 25));
 
 // external trigger
 s.next(23);
 // s1 23
+// (s2 doesn't receive value here due to its filter)
+
 s.next(42);
 // s2 42
 // s1 42
@@ -468,12 +470,15 @@ function returns `null` / `undefined`, no further action will be taken
 ignored).
 
 ```ts
+import { metastream, fromIterable, trace } from "@thi.ng/rstream";
+import { repeat } from "@thi.ng/transducers";
+
 // transform each received odd number into a stream
 // producing 3 copies of that number in the metastream
 // even numbers are ignored
 a = metastream<number, string>(
   (x) => (x & 1)
-    ? fromIterable(tx.repeat("odd: " + x, 3), { delay: 100 })
+    ? fromIterable(repeat("odd: " + x, 3), { delay: 100 })
     : null
 );
 
@@ -502,14 +507,17 @@ inputs. This keeps them alive and allows for dynamic switching between
 them.
 
 ```ts
+import { metastream, fromIterable, trace, CloseMode } from "@thi.ng/rstream";
+import { repeat } from "@thi.ng/transducers";
+
 // infinite inputs
 a = fromIterable(
-  tx.repeat("a"),
+  repeat("a"),
   { delay: 1000, closeOut: CloseMode.NEVER }
 );
 
 b = fromIterable(
-  tx.repeat("b"),
+  repeat("b"),
   { delay: 1000, closeOut: CloseMode.NEVER }
 );
 
@@ -543,6 +551,8 @@ done, but this behavior can be overridden via the `close` option, using
 `CloseMode` enums.
 
 ```ts
+import { merge, fromIterable, trace } from "@thi.ng/rstream";
+
 merge({
     // input streams w/ different frequencies
     src: [
@@ -567,10 +577,13 @@ transducer](https://docs.thi.ng/umbrella/transducers/functions/labeled.html) for
 each input to create a stream of labeled values and track their provenance:
 
 ```ts
+import { merge, fromIterable, trace } from "@thi.ng/rstream";
+import { labeled } from "@thi.ng/transducers";
+
 merge({
     src: [
-        fromIterable([1, 2, 3]).transform(tx.labeled("a")),
-        fromIterable([10, 20, 30]).transform(tx.labeled("b")),
+        fromIterable([1, 2, 3]).transform(labeled("a")),
+        fromIterable([10, 20, 30]).transform(labeled("b")),
     ]
 }).subscribe(trace());
 // ["a", 1]
@@ -593,12 +606,13 @@ as new input to the merge and then automatically remove once that stream
 is exhausted.
 
 ```ts
+import { merge, stream, fromIterable, trace } from "@thi.ng/rstream";
 import { repeat } from "@thi.ng/transducers";
 
 // stream source w/ transducer mapping values to new streams
 a = stream().map((x) => fromIterable(repeat(x, 3)));
 // simple 1Hz counter
-b = fromInterval(1000);
+b = fromInterval(1000).map((x) => "b" + x);
 
 merge({ src: [a, b] }).subscribe(trace());
 // 0
@@ -641,6 +655,8 @@ calls `done()` when the last active input is done, but this behavior can
 be overridden via the `close` constructor option, using `CloseMode` enums.
 
 ```ts
+import { sync, stream, trace } from "@thi.ng/rstream";
+
 const a = stream();
 const b = stream();
 s = sync<any,any>({ src: { a, b } }).subscribe(trace("result: "));
@@ -703,6 +719,8 @@ topic function and `a` & `b` as subscribers for truthy (`a`) and falsy
 `b` values.
 
 ```ts
+import { bisect, fromIterable, trace } from "@thi.ng/rstream";
+
 fromIterable([1, 2, 3, 4]).subscribe(
     bisect((x) => !!(x & 1), trace("odd"), trace("even"))
 );
@@ -719,6 +737,8 @@ first created as `Subscription` (if not already) and a reference kept
 prior to calling `bisect()`.
 
 ```ts
+import { bisect, fromIterable, subscription, trace } from "@thi.ng/rstream";
+
 const odd = subscription();
 const even = subscription();
 odd.subscribe(trace("odd"));
@@ -752,6 +772,11 @@ optional predicate can be used to only trigger for specific values /
 conditions.
 
 ```ts
+import {
+    merge, fromEvent, fromRAF,
+    sidechainPartition, trace
+} from "@thi.ng/rstream";
+
 // queue event processing to only execute during the
 // requestAnimationFrame cycle (RAF)
 sidechainPartition(
@@ -766,7 +791,21 @@ sidechainPartition(
 ).subscribe(trace());
 ```
 
-Since v8.0.0 there's [`syncRAF()`](https://docs.thi.ng/umbrella/rstream/functions/syncRAF-1.html)
+Since v8.0.0 there's
+[`syncRAF()`](https://docs.thi.ng/umbrella/rstream/functions/syncRAF-1.html),
+which allows the above to be simplified to:
+
+```ts
+import { merge, fromEvent, syncRAF, trace } from "@thi.ng/rstream";
+
+syncRAF(
+    merge([
+        fromEvent(document, "mousemove"),
+        fromEvent(document, "mousedown"),
+        fromEvent(document, "mouseup")
+    ])
+).subscribe(trace());
+```
 
 #### Input toggling, controlled by sidechain
 
@@ -782,6 +821,8 @@ will be toggled on/off. Whilst switched off, no input values will be
 forwarded.
 
 ```ts
+import { sidechainToggle, fromInterval, trace } from "@thi.ng/rstream";
+
 // use slower interval stream to toggle faster main stream on/off
 sidechainToggle(fromInterval(500), fromInterval(1000)).subscribe(trace());
 // 0
@@ -800,6 +841,8 @@ Buffers the most recent value received and only forwards it downstream whenever
 a new control value is received from the sidechain.
 
 ```ts
+import { sidechainTrigger, reactive, stream, trace } from "@thi.ng/rstream";
+
 const src = reactive("payload");
 
 const side = stream();
@@ -843,6 +886,8 @@ self.addEventListener("message", (e) => {
 ##### main.ts
 
 ```ts
+import { forkJoin, trace } from "@thi.ng/rstream";
+
 const src = stream<number[]>();
 
 // fork worker jobs & re-join results
@@ -909,6 +954,8 @@ handler will be called, which _might_ put this subscription into an error
 state and stop it from receiving new values.
 
 ```ts
+import { subscription, State } from "@thi.ng/rstream";
+
 src = subscription({ next(x) { throw x; } });
 
 // triggers error, caught by subscription wrapper

package/object.d.ts

@@ -66,7 +66,7 @@ export interface StreamObjOpts<T, K extends Keys<T>> extends CommonOpts {
  * The structure of the returned object is
  * {@link StreamObj | as follows}:
  *
- * ```ts
+ * ```text
  * {
  *   streams: { ... },
  *   next(x): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/rstream",
-  "version": "8.3.8",
+  "version": "8.3.10",
   "description": "Reactive streams & subscription primitives for constructing dataflow graphs / pipelines",
   "type": "module",
   "module": "./index.js",
@@ -39,14 +39,14 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.9.26",
-    "@thi.ng/arrays": "^2.8.3",
-    "@thi.ng/associative": "^6.3.43",
-    "@thi.ng/atom": "^5.2.33",
-    "@thi.ng/checks": "^3.5.0",
-    "@thi.ng/errors": "^2.4.18",
-    "@thi.ng/logger": "^3.0.3",
-    "@thi.ng/transducers": "^8.9.7"
+    "@thi.ng/api": "^8.9.27",
+    "@thi.ng/arrays": "^2.8.5",
+    "@thi.ng/associative": "^6.3.45",
+    "@thi.ng/atom": "^5.2.35",
+    "@thi.ng/checks": "^3.5.1",
+    "@thi.ng/errors": "^2.4.19",
+    "@thi.ng/logger": "^3.0.4",
+    "@thi.ng/transducers": "^8.9.9"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.40.1",
@@ -214,5 +214,5 @@
     ],
     "year": 2017
   },
-  "gitHead": "6e20f80dd9df1c8055ffa3c1e4d6f7598add0c0b\n"
+  "gitHead": "df9e312af741d87e6b450afcfea6a6e381662b1e\n"
 }