@thi.ng/csp 3.2.44 → 3.3.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2025-09-01T16:38:35Z
+- **Last updated**: 2025-10-07T11:51:57Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -11,6 +11,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.
 
+## [3.3.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/csp@3.3.0) (2025-10-07)
+
+#### 🚀 Features
+
+- update `select()`, shuffle inputs, update deps ([bbfad51](https://github.com/thi-ng/umbrella/commit/bbfad51))
+  - add [@thi.ng/arrays](https://github.com/thi-ng/umbrella/tree/main/packages/arrays) dependency
+  - update docs
+
 ### [3.2.13](https://github.com/thi-ng/umbrella/tree/@thi.ng/csp@3.2.13) (2024-10-17)
 
 #### ♻️ Refactoring

package/ops.d.ts

@@ -69,7 +69,11 @@ export declare const pipe: <T, DEST extends IWriteable<T> & IClosable>(src: Asyn
  * Takes one or more input channels and attempts to read from all of them at
  * once (via {@link Channel.race}, a blocking op). Returns a promise which
  * resolves once one of the inputs becomes available or was closed, selects that
- * channel to read from it and returns tuple of `[value, channel]`.
+ * channel to read from it and returns tuple of `[value, channel]`. If the
+ * selected channel already is closed, returns `[undefined, channel]`.
+ *
+ * @remarks
+ * Since v3.3.0 inputs are automatically shuffled to avoid selection bias.
  *
  * @param input - first input
  * @param rest - other inputs

package/ops.js

@@ -1,3 +1,4 @@
+import { shuffle } from "@thi.ng/arrays/shuffle";
 import { assert } from "@thi.ng/errors/assert";
 import { Channel } from "./channel.js";
 const broadcast = async (src, dest, close = true) => {
@@ -70,7 +71,7 @@ const pipe = (src, dest, close = true) => {
   return dest;
 };
 const select = async (input, ...rest) => {
-  const inputs = [input, ...rest];
+  const inputs = shuffle([input, ...rest]);
   const sel = await Promise.race(inputs.map((x) => x.race()));
   for (let chan of inputs) {
     if (chan !== sel) chan.races.shift();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/csp",
-  "version": "3.2.44",
+  "version": "3.3.0",
   "description": "Primitives & operators for Communicating Sequential Processes based on async/await and async iterables",
   "type": "module",
   "module": "./index.js",
@@ -44,6 +44,7 @@
   },
   "dependencies": {
     "@thi.ng/api": "^8.12.2",
+    "@thi.ng/arrays": "^2.13.11",
     "@thi.ng/buffers": "^1.0.21",
     "@thi.ng/checks": "^3.7.18",
     "@thi.ng/errors": "^2.5.42"
@@ -108,5 +109,5 @@
     "status": "beta",
     "year": 2016
   },
-  "gitHead": "e215a3e8de3809736ba0042c93bd8703a5a1a337\n"
+  "gitHead": "fbf4b46ba8a5ecff8c5423f4c2d158d208d20fc8\n"
 }