@thi.ng/fibers 1.0.5 → 1.0.6

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-06-21T19:34:38Z
+- **Last updated**: 2024-06-29T09:28:36Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.

package/README.md

@@ -7,7 +7,7 @@
 [![Mastodon Follow](https://img.shields.io/mastodon/follow/109331703950160316?domain=https%3A%2F%2Fmastodon.thi.ng&style=social)](https://mastodon.thi.ng/@toxi)
 
 > [!NOTE]
-> This is one of 193 standalone projects, maintained as part
+> This is one of 189 standalone projects, maintained as part
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >

package/fiber.d.ts

@@ -79,8 +79,8 @@ export declare class Fiber<T = any> implements IDeref<Maybe<T>>, IID<string>, IN
      * {@link Fiber.childForID}.
      *
      * @example
-     * ```ts
-     * import { fiber } from "@thi.ng/fibers";
+     * ```ts tangle:../export/fork.ts
+     * import { fiber, wait } from "@thi.ng/fibers";
      *
      * fiber(function* (ctx) {
      *   console.log("main start")
@@ -205,7 +205,7 @@ export declare class Fiber<T = any> implements IDeref<Maybe<T>>, IID<string>, IN
      * `handler` must only manage a single execution step, not multiple.
      *
      * @example
-     * ```ts
+     * ```ts tangle:../export/run-with.ts
      * import { fiber } from "@thi.ng/fibers";
      *
      * // start with custom higher frequency handler

package/fiber.js

@@ -141,8 +141,8 @@ let Fiber = class {
    * {@link Fiber.childForID}.
    *
    * @example
-   * ```ts
-   * import { fiber } from "@thi.ng/fibers";
+   * ```ts tangle:../export/fork.ts
+   * import { fiber, wait } from "@thi.ng/fibers";
    *
    * fiber(function* (ctx) {
    *   console.log("main start")
@@ -365,7 +365,7 @@ let Fiber = class {
    * `handler` must only manage a single execution step, not multiple.
    *
    * @example
-   * ```ts
+   * ```ts tangle:../export/run-with.ts
    * import { fiber } from "@thi.ng/fibers";
    *
    * // start with custom higher frequency handler

package/ops.d.ts

@@ -95,14 +95,14 @@ export declare const timeSlice: (body: MaybeFiber, maxTime: number, opts?: Parti
  * given `consume` function in order to process these values further.
  *
  * @example
- * ```ts
+ * ```ts tangle:../export/timeslice-iterable.ts
  * import { timeSliceIterable } from "@thi.ng/fibers";
  * import { range } from "@thi.ng/transducers";
  *
  * // consume & batch process iterable in 16ms time slices
  * timeSliceIterable(
  *   range(1_000_000),
- *   (chunk) => console.log(chunk),
+ *   (chunk) => console.log("items:", chunk.length),
  *   16
  * ).run();
  * ```
@@ -181,15 +181,15 @@ export declare class Shuffle extends Fiber {
  * [`SYSTEM`](https://docs.thi.ng/umbrella/random/variables/SYSTEM.html).
  *
  * @example
- * ```ts
+ * ```ts tangle:../export/shuffle.ts
  * import { shuffle } from "@thi.ng/fibers";
  * import { repeatedly } from "@thi.ng/transducers";
  *
- * // create & run fiber with 4 children, executing in random order
+ * // create & run fiber with 16 children, executing in random order
  * shuffle(
  *   repeatedly(
- *     (id) => function*() { while(true) { console.log(`worker #{id}`); yield; } },
- *     4
+ *     (id) => function*() { while(true) { console.log(`worker #${id}`); yield; } },
+ *     16
  *   )
  * ).run()
  *
@@ -224,8 +224,8 @@ export declare const shuffle: (fibers: Iterable<MaybeFiber>, opts?: Partial<Fibe
  * `catch` handler indicating the error has been dealt with.
  *
  * @example
- * ```ts
- * import { asPromise } from "@thi.ng/fibers";
+ * ```ts tangle:../export/as-promise.ts
+ * import { asPromise, wait } from "@thi.ng/fibers";
  *
  * (async () => {
  *   // create & spawn task/fiber

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/fibers",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "Process hierarchies & operators for cooperative multitasking",
   "type": "module",
   "module": "./index.js",
@@ -36,15 +36,15 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.11.3",
-    "@thi.ng/arrays": "^2.9.7",
-    "@thi.ng/bench": "^3.5.7",
-    "@thi.ng/buffers": "^0.1.4",
-    "@thi.ng/checks": "^3.6.5",
-    "@thi.ng/errors": "^2.5.8",
-    "@thi.ng/idgen": "^2.2.42",
-    "@thi.ng/logger": "^3.0.13",
-    "@thi.ng/random": "^3.8.1"
+    "@thi.ng/api": "^8.11.4",
+    "@thi.ng/arrays": "^2.9.8",
+    "@thi.ng/bench": "^3.5.8",
+    "@thi.ng/buffers": "^0.1.5",
+    "@thi.ng/checks": "^3.6.6",
+    "@thi.ng/errors": "^2.5.9",
+    "@thi.ng/idgen": "^2.2.43",
+    "@thi.ng/logger": "^3.0.14",
+    "@thi.ng/random": "^3.8.2"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.47.0",
@@ -113,5 +113,5 @@
     "status": "alpha",
     "year": 2023
   },
-  "gitHead": "154c95cf9d6bab32174498ec3b5b5d87e42be7f9\n"
+  "gitHead": "7b950c112fba0b2e7c450765b15624c3382f1354\n"
 }