@thi.ng/fibers 1.0.2 → 1.0.4

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-04-23T07:02:18Z
+- **Last updated**: 2024-05-08T18:24:31Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.

package/README.md

@@ -23,6 +23,7 @@
     - [Channels](#channels)
     - [CSP ping/pong example](#csp-pingpong-example)
 - [Status](#status)
+- [Related packages](#related-packages)
 - [Installation](#installation)
 - [Dependencies](#dependencies)
 - [Usage examples](#usage-examples)
@@ -371,6 +372,11 @@ if (res !== undefined) {
 
 [Search or submit any issues for this package](https://github.com/thi-ng/umbrella/issues?q=%5Bfibers%5D+in%3Atitle)
 
+## Related packages
+
+- [@thi.ng/csp](https://github.com/thi-ng/umbrella/tree/develop/packages/csp) - Primitives & operators for Communicating Sequential Processes based on async/await and async iterables
+- [@thi.ng/transducers-async](https://github.com/thi-ng/umbrella/tree/develop/packages/transducers-async) - Async versions of various highly composable transducers, reducers and iterators
+
 ## Installation
 
 ```bash

package/csp.js

@@ -84,13 +84,11 @@ class Channel {
   close(wait = true) {
     const chan = this;
     return fiber(function* (ctx) {
-      if (chan.state >= STATE_CLOSING)
-        return;
+      if (chan.state >= STATE_CLOSING) return;
       if (wait) {
         ctx.logger?.debug("waiting to close...");
         chan.state = STATE_CLOSING;
-        while (chan.buffer.readable())
-          yield;
+        while (chan.buffer.readable()) yield;
       }
       chan.state = STATE_CLOSED;
       chan.buffer.clear();

package/fiber.js

@@ -5,8 +5,7 @@ var __decorateClass = (decorators, target, key, kind) => {
   for (var i = decorators.length - 1, decorator; i >= 0; i--)
     if (decorator = decorators[i])
       result = (kind ? decorator(target, key, result) : decorator(result)) || result;
-  if (kind && result)
-    __defProp(target, key, result);
+  if (kind && result) __defProp(target, key, result);
   return result;
 };
 import { INotifyMixin } from "@thi.ng/api/mixins/inotify";
@@ -64,8 +63,7 @@ let Fiber = class {
     } else {
       this.idgen = DEFAULT_ID_GEN;
     }
-    if (this.idgen)
-      this.id = this.idgen.next();
+    if (this.idgen) this.id = this.idgen.next();
     this.gen = isFunction(gen) ? gen(this) : gen;
   }
   /**
@@ -73,8 +71,7 @@ let Fiber = class {
    * Then return this fiber's value.
    */
   *[Symbol.iterator]() {
-    while (this.state <= STATE_ACTIVE && this.next() <= STATE_ACTIVE)
-      yield;
+    while (this.state <= STATE_ACTIVE && this.next() <= STATE_ACTIVE) yield;
     return this.value;
   }
   /**
@@ -178,8 +175,7 @@ let Fiber = class {
    * @param opts
    */
   fork(body, opts) {
-    if (!this.isActive())
-      illegalState(`fiber (id: ${this.id}) not active`);
+    if (!this.isActive()) illegalState(`fiber (id: ${this.id}) not active`);
     let $fiber;
     if (body instanceof Fiber) {
       if (body.parent)
@@ -218,8 +214,7 @@ let Fiber = class {
    */
   *join() {
     this.logger?.debug("waiting for children...");
-    while (this.children.length)
-      yield;
+    while (this.children.length) yield;
   }
   /**
    * Processes a single iteration of this fiber and any of its children. Does
@@ -246,16 +241,14 @@ let Fiber = class {
               if (child.state > STATE_ACTIVE || child.next() > STATE_ACTIVE) {
                 children.splice(i, 1);
                 n--;
-              } else
-                i++;
+              } else i++;
             }
           } else if (this.autoTerminate) {
             this.cancel();
             break;
           }
           const res = this.gen ? this.gen.next(this) : NO_RESULT;
-          if (res.done)
-            this.done(res.value);
+          if (res.done) this.done(res.value);
         } catch (e) {
           this.catch(e);
         }
@@ -283,11 +276,9 @@ let Fiber = class {
    * Function is a no-op if the fiber is not active anymore.
    */
   cancel() {
-    if (!this.isActive())
-      return;
+    if (!this.isActive()) return;
     this.logger?.debug("cancel", this.id);
-    for (let child of this.children)
-      child.cancel();
+    for (let child of this.children) child.cancel();
     this.deinit();
     this.state = STATE_CANCELED;
     this.idgen?.free(this.id);
@@ -304,12 +295,10 @@ let Fiber = class {
    * @param value
    */
   done(value) {
-    if (!this.isActive())
-      return;
+    if (!this.isActive()) return;
     this.logger?.debug("done", this.id, value);
     this.value = value;
-    for (let child of this.children)
-      child.done();
+    for (let child of this.children) child.done();
     this.deinit();
     this.state = STATE_DONE;
     this.idgen?.free(this.id);
@@ -328,11 +317,9 @@ let Fiber = class {
    * @param err
    */
   catch(err) {
-    if (this.state >= STATE_ERROR || this.user?.catch?.(this, err))
-      return;
+    if (this.state >= STATE_ERROR || this.user?.catch?.(this, err)) return;
     this.logger ? this.logger.severe(`error ${this.id}:`, err) : console.warn(`error ${this.id}:`, err);
-    for (let child of this.children)
-      child.cancel();
+    for (let child of this.children) child.cancel();
     this.state = STATE_ERROR;
     this.error = err;
     this.deinit();

package/ops.js

@@ -10,23 +10,18 @@ import { Fiber, fiber } from "./fiber.js";
 const wait = (delay) => delay !== void 0 ? untilPromise(
   new Promise((resolve) => setTimeout(resolve, delay))
 ) : fiber(function* () {
-  while (true)
-    yield;
+  while (true) yield;
 });
 function* waitFrames(delay) {
-  while (delay-- > 0)
-    yield;
+  while (delay-- > 0) yield;
 }
 const sequence = (fibers, opts) => fiber(function* (ctx) {
   for (let fiber2 of fibers) {
     const $fiber = ctx.fork(fiber2);
-    while ($fiber.isActive())
-      yield;
-    if ($fiber.state === STATE_ERROR)
-      throw $fiber.error;
+    while ($fiber.isActive()) yield;
+    if ($fiber.state === STATE_ERROR) throw $fiber.error;
     ctx.value = $fiber.value;
-    if ($fiber.state > STATE_DONE || ctx.state > STATE_ACTIVE)
-      break;
+    if ($fiber.state > STATE_DONE || ctx.state > STATE_ACTIVE) break;
   }
   return ctx.value;
 }, opts);
@@ -34,8 +29,7 @@ const first = (fibers, opts) => fiber(function* (ctx) {
   const $fibers = [...fibers].map((f) => ctx.fork(f));
   while (true) {
     for (let f of $fibers) {
-      if (!f.isActive())
-        return f;
+      if (!f.isActive()) return f;
     }
     yield;
   }
@@ -74,12 +68,10 @@ const timeSliceIterable = (src, consume, maxTime, opts) => fiber(function* () {
   }
 }, opts);
 function* until(pred) {
-  while (!pred())
-    yield;
+  while (!pred()) yield;
 }
 function* untilState(state, pred) {
-  while (!pred(state))
-    yield;
+  while (!pred(state)) yield;
 }
 const untilPromise = (promise, opts) => fiber(function* (ctx) {
   let error;
@@ -88,8 +80,7 @@ const untilPromise = (promise, opts) => fiber(function* (ctx) {
     (e) => error = e
   );
   while (true) {
-    if (error)
-      throw error;
+    if (error) throw error;
     yield;
   }
 }, opts);
@@ -114,8 +105,7 @@ class Shuffle extends Fiber {
     this.forkAll(...fibers);
   }
   next() {
-    if (!this.isActive())
-      return this.state;
+    if (!this.isActive()) return this.state;
     $shuffle(this.children, this.children.length, this.rnd);
     return super.next();
   }
@@ -129,8 +119,7 @@ const asPromise = (task, opts) => new Promise((resolve, reject) => {
       ctx.state < STATE_ERROR && resolve(ctx.deref());
     },
     catch: (ctx, e) => {
-      if (opts?.catch && opts.catch(ctx, e))
-        return true;
+      if (opts?.catch && opts.catch(ctx, e)) return true;
       reject(e);
       return false;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/fibers",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Process hierarchies & operators for cooperative multitasking",
   "type": "module",
   "module": "./index.js",
@@ -36,21 +36,21 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.11.1",
-    "@thi.ng/arrays": "^2.9.5",
-    "@thi.ng/bench": "^3.5.5",
-    "@thi.ng/buffers": "^0.1.2",
-    "@thi.ng/checks": "^3.6.3",
-    "@thi.ng/errors": "^2.5.6",
-    "@thi.ng/idgen": "^2.2.40",
-    "@thi.ng/logger": "^3.0.11",
-    "@thi.ng/random": "^3.7.5"
+    "@thi.ng/api": "^8.11.2",
+    "@thi.ng/arrays": "^2.9.6",
+    "@thi.ng/bench": "^3.5.6",
+    "@thi.ng/buffers": "^0.1.3",
+    "@thi.ng/checks": "^3.6.4",
+    "@thi.ng/errors": "^2.5.7",
+    "@thi.ng/idgen": "^2.2.41",
+    "@thi.ng/logger": "^3.0.12",
+    "@thi.ng/random": "^3.8.0"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.43.0",
-    "esbuild": "^0.20.2",
-    "typedoc": "^0.25.12",
-    "typescript": "^5.4.3"
+    "@microsoft/api-extractor": "^7.43.2",
+    "esbuild": "^0.21.1",
+    "typedoc": "^0.25.13",
+    "typescript": "^5.4.5"
   },
   "keywords": [
     "blocking",
@@ -106,8 +106,12 @@
     }
   },
   "thi.ng": {
+    "related": [
+      "csp",
+      "transducers-async"
+    ],
     "status": "alpha",
     "year": 2023
   },
-  "gitHead": "5dd66c18a3862a3af69a5b2f49563f7cbdd960c2\n"
+  "gitHead": "df34b4a9e650cc7323575356de207d78933bdcf3\n"
 }