@thi.ng/fibers 0.2.3 → 0.3.1

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2023-08-12T13:14:08Z
+- **Last updated**: 2023-08-22T14:39:27Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,14 @@ 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.
 
+## [0.3.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/fibers@0.3.0) (2023-08-14)
+
+#### 🚀 Features
+
+- update .run() default handlers ([6137e7a](https://github.com/thi-ng/umbrella/commit/6137e7a))
+  - use `setImmediate()` as default for non-browser env
+  - update tests
+
 ## [0.2.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/fibers@0.2.0) (2023-08-10)
 
 #### 🚀 Features

package/README.md

@@ -8,7 +8,7 @@
 [![Mastodon Follow](https://img.shields.io/mastodon/follow/109331703950160316?domain=https%3A%2F%2Fmastodon.thi.ng&style=social)](https://mastodon.thi.ng/@toxi)
 
 This project is part of the
-[@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo.
+[@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo and anti-framework.
 
 - [About](#about)
   - [Basic usage](#basic-usage)
@@ -376,7 +376,7 @@ For Node.js REPL:
 const fibers = await import("@thi.ng/fibers");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 2.25 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 2.27 KB
 
 ## Dependencies
 
@@ -397,9 +397,10 @@ directory are using this package.
 
 A selection:
 
-| Screenshot                                                                                                          | Description                                 | Live demo                                          | Source                                                                          |
-|:--------------------------------------------------------------------------------------------------------------------|:--------------------------------------------|:---------------------------------------------------|:--------------------------------------------------------------------------------|
-| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/fiber-basics.png" width="240"/> | Fiber-based cooperative multitasking basics | [Demo](https://demo.thi.ng/umbrella/fiber-basics/) | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/fiber-basics) |
+| Screenshot                                                                                                            | Description                                                       | Live demo                                            | Source                                                                            |
+|:----------------------------------------------------------------------------------------------------------------------|:------------------------------------------------------------------|:-----------------------------------------------------|:----------------------------------------------------------------------------------|
+| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/ascii-raymarch.jpg" width="240"/> | ASCII art raymarching with thi.ng/shader-ast & thi.ng/text-canvas | [Demo](https://demo.thi.ng/umbrella/ascii-raymarch/) | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/ascii-raymarch) |
+| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/fiber-basics.png" width="240"/>   | Fiber-based cooperative multitasking basics                       | [Demo](https://demo.thi.ng/umbrella/fiber-basics/)   | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/fiber-basics)   |
 
 ## API
 

package/fiber.d.ts

@@ -163,13 +163,19 @@ export declare class Fiber<T = any> implements IDeref<T | undefined>, IID<string
     removeListener(id: FiberEventType, fn: Listener<FiberEventType>, scope?: any): boolean;
     notify(event: $Event<FiberEventType>): boolean;
     /**
-     * Calls {@link Fiber.runWith} using default loop handlers
-     * (`requestAnimationFrame()` in browsers, `setTimeout(fn, 16)` otherwise).
+     * Calls {@link Fiber.runWith} using default loop handlers.
+     *
+     * @remarks
+     * Current default handlers:
+     *
+     * - `requestAnimationFrame()` in browsers
+     * - `setImmediate()` in NodeJs
+     * - `setTimeout(fn, 1)` otherwise
      */
     run(): this;
     /**
      * Starts fiber execution using the provided higher-order loop/interval
-     * `handler` (e.g. see {@link Fiber.start}).
+     * `handler` (e.g. see {@link Fiber.run}).
      *
      * @remarks
      * That given `handler` is used to repeatedly schedule the next execution of

package/fiber.js

@@ -299,17 +299,25 @@ export let Fiber = Fiber_1 = class Fiber {
     // @ts-ignore mixin
     notify(event) { }
     /**
-     * Calls {@link Fiber.runWith} using default loop handlers
-     * (`requestAnimationFrame()` in browsers, `setTimeout(fn, 16)` otherwise).
+     * Calls {@link Fiber.runWith} using default loop handlers.
+     *
+     * @remarks
+     * Current default handlers:
+     *
+     * - `requestAnimationFrame()` in browsers
+     * - `setImmediate()` in NodeJs
+     * - `setTimeout(fn, 1)` otherwise
      */
     run() {
         return this.runWith(typeof requestAnimationFrame === "function"
             ? requestAnimationFrame
-            : (fn) => setTimeout(fn, 16));
+            : typeof setImmediate === "function"
+                ? setImmediate
+                : (fn) => setTimeout(fn, 1));
     }
     /**
      * Starts fiber execution using the provided higher-order loop/interval
-     * `handler` (e.g. see {@link Fiber.start}).
+     * `handler` (e.g. see {@link Fiber.run}).
      *
      * @remarks
      * That given `handler` is used to repeatedly schedule the next execution of

package/ops.d.ts

@@ -107,10 +107,9 @@ export declare function untilState<T>(state: T, pred: Predicate<T>): Generator<u
  * Returns a fiber which "blocks" until the given `promise` resolves or rejects.
  * In the latter case, the fiber will throw the received error.
  *
- * @remove
- * If the erroring fiber was added directly to a {@link FiberPool}, the error
- * will be logged and the fiber removed. See {@link FiberPool.update} for
- * details.
+ * @remarks
+ * If the fiber was added to a parent {@link Fiber}, the error will be logged
+ * and the fiber removed from the parent. See {@link Fiber.next} for details.
  *
  * @param promise
  */

package/ops.js

@@ -156,10 +156,9 @@ export function* untilState(state, pred) {
  * Returns a fiber which "blocks" until the given `promise` resolves or rejects.
  * In the latter case, the fiber will throw the received error.
  *
- * @remove
- * If the erroring fiber was added directly to a {@link FiberPool}, the error
- * will be logged and the fiber removed. See {@link FiberPool.update} for
- * details.
+ * @remarks
+ * If the fiber was added to a parent {@link Fiber}, the error will be logged
+ * and the fiber removed from the parent. See {@link Fiber.next} for details.
  *
  * @param promise
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/fibers",
-  "version": "0.2.3",
+  "version": "0.3.1",
   "description": "Process hierarchies & operators for cooperative multitasking",
   "type": "module",
   "module": "./index.js",
@@ -34,18 +34,18 @@
     "test": "testament test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.9.3",
-    "@thi.ng/arrays": "^2.5.19",
-    "@thi.ng/bench": "^3.4.4",
-    "@thi.ng/checks": "^3.4.3",
-    "@thi.ng/errors": "^2.3.3",
-    "@thi.ng/idgen": "^2.2.4",
-    "@thi.ng/logger": "^1.4.19",
-    "@thi.ng/random": "^3.6.1"
+    "@thi.ng/api": "^8.9.4",
+    "@thi.ng/arrays": "^2.5.20",
+    "@thi.ng/bench": "^3.4.5",
+    "@thi.ng/checks": "^3.4.4",
+    "@thi.ng/errors": "^2.3.4",
+    "@thi.ng/idgen": "^2.2.5",
+    "@thi.ng/logger": "^1.4.20",
+    "@thi.ng/random": "^3.6.2"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.36.4",
-    "@thi.ng/testament": "^0.3.21",
+    "@thi.ng/testament": "^0.3.22",
     "rimraf": "^5.0.1",
     "tools": "^0.0.1",
     "typedoc": "^0.24.8",
@@ -108,5 +108,5 @@
     "status": "alpha",
     "year": 2023
   },
-  "gitHead": "4154283d772824d4b57d4b7ab97be22a6e1ffdd7\n"
+  "gitHead": "74cfe3fb8de5bfcbfc1109e67604541cbd7b77aa\n"
 }