@thi.ng/rstream 8.2.25 → 8.3.1

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-01-30T21:37:19Z
+- **Last updated**: 2024-02-10T08:59:57Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,13 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+## [8.3.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/rstream@8.3.0) (2024-02-06)
+
+#### 🚀 Features
+
+- update fromRAF() & opts ([27f4cde](https://github.com/thi-ng/umbrella/commit/27f4cde))
+  - update timestamp handling/opts
+
 ### [8.2.8](https://github.com/thi-ng/umbrella/tree/@thi.ng/rstream@8.2.8) (2023-11-09)
 
 #### ♻️ Refactoring

package/README.md

@@ -1,5 +1,15 @@
 <!-- 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)
 
@@ -203,7 +213,7 @@ For Node.js REPL:
 const rstream = await import("@thi.ng/rstream");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 6.13 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 6.15 KB
 
 ## Dependencies
 
@@ -264,6 +274,7 @@ directory are using this package:
 |                                                                                                                                      | rstream based UI updates & state handling                                                               | [Demo](https://demo.thi.ng/umbrella/rstream-hdom/)         | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/rstream-hdom)        |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/rstream-spreadsheet.png" width="240"/>           | rstream based spreadsheet w/ S-expression formula DSL                                                   | [Demo](https://demo.thi.ng/umbrella/rstream-spreadsheet/)  | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/rstream-spreadsheet) |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/rstream-sync.png" width="240"/>                  | Minimal rstream sync() example using rdom                                                               | [Demo](https://demo.thi.ng/umbrella/rstream-sync/)         | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/rstream-sync)        |
+| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/rstream-system-bus.png" width="240"/>            | Declarative component-based system with central rstream-based pubsub event bus                          | [Demo](https://demo.thi.ng/umbrella/rstream-system-bus/)   | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/rstream-system-bus)  |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/shader-ast-workers.jpg" width="240"/>            | Fork-join worker-based raymarch renderer (JS/CPU only)                                                  | [Demo](https://demo.thi.ng/umbrella/shader-ast-workers/)   | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/shader-ast-workers)  |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/simd-plot.png" width="240"/>                     | Fitting, transforming & plotting 10k data points per frame using SIMD                                   | [Demo](https://demo.thi.ng/umbrella/simd-plot/)            | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/simd-plot)           |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/stacked-layout.png" width="240"/>                | Responsive & reactively computed stacked column layout                                                  | [Demo](https://demo.thi.ng/umbrella/stacked-layout/)       | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/stacked-layout)      |

package/metastream.d.ts

@@ -40,7 +40,7 @@ export interface MetaStreamOpts extends CommonOpts {
  * // transform each received odd number into a stream
  * // producing 3 copies of that number in the metastream
  * // even numbers are ignored
- * a = metastream(
+ * a = metaStream(
  *   (x) => (x & 1)
  *     ? fromIterable(tx.repeat(x, 3), { delay: 100 })
  *     : null

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/rstream",
-  "version": "8.2.25",
+  "version": "8.3.1",
   "description": "Reactive streams & subscription primitives for constructing dataflow graphs / pipelines",
   "type": "module",
   "module": "./index.js",
@@ -39,20 +39,20 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.9.22",
-    "@thi.ng/arrays": "^2.7.19",
-    "@thi.ng/associative": "^6.3.35",
-    "@thi.ng/atom": "^5.2.28",
-    "@thi.ng/checks": "^3.4.22",
-    "@thi.ng/errors": "^2.4.15",
-    "@thi.ng/logger": "^2.1.8",
-    "@thi.ng/transducers": "^8.8.26"
+    "@thi.ng/api": "^8.9.23",
+    "@thi.ng/arrays": "^2.7.20",
+    "@thi.ng/associative": "^6.3.37",
+    "@thi.ng/atom": "^5.2.30",
+    "@thi.ng/checks": "^3.4.23",
+    "@thi.ng/errors": "^2.4.16",
+    "@thi.ng/logger": "^2.1.10",
+    "@thi.ng/transducers": "^8.9.1"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.39.0",
-    "esbuild": "^0.19.10",
+    "@microsoft/api-extractor": "^7.40.1",
+    "esbuild": "^0.20.0",
     "rimraf": "^5.0.5",
-    "typedoc": "^0.25.4",
+    "typedoc": "^0.25.7",
     "typescript": "^5.3.3"
   },
   "keywords": [
@@ -214,5 +214,5 @@
     ],
     "year": 2017
   },
-  "gitHead": "a86521dfac00768f7e51a607209325eb72004730\n"
+  "gitHead": "e5e7d5c6ed2eadee7a91d59cbd0c86ce880ab1c5\n"
 }

package/raf.d.ts

@@ -8,6 +8,14 @@ export interface FromRAFOpts extends CommonOpts {
      * @defaultValue false
      */
     timestamp: boolean;
+    /**
+     * Only used if {@link FromRAFOpts.timestamp} is enabled. If given as
+     * number, the value will be subtracted from all emitted timestamps. If this
+     * option is set to true, the timestamps will be automatically zero-adjusted
+     * such that the first emitted value will be zero. If undefined (default),
+     * the browser supplied timestamps will be used as is.
+     */
+    t0: number | boolean;
 }
 /**
  * Yields {@link Stream} of a monotonically increasing counter (or timestamps),

package/raf.js

@@ -1,11 +1,18 @@
 import { isNode } from "@thi.ng/checks/is-node";
+import { isNumber } from "@thi.ng/checks/is-number";
 import { __optsWithID } from "./idgen.js";
 import { fromInterval } from "./interval.js";
 import { stream } from "./stream.js";
 const fromRAF = (opts = {}) => isNode() ? fromInterval(16, opts) : stream((stream2) => {
   let i = 0;
   let isActive = true;
+  let t0 = isNumber(opts.t0) ? opts.t0 : void 0;
   const loop = (time) => {
+    if (opts.timestamp && opts.t0) {
+      if (t0 === void 0)
+        t0 = time;
+      time -= t0;
+    }
     isActive && stream2.next(opts.timestamp ? time : i++);
     isActive && (id = requestAnimationFrame(loop));
   };