@nlozgachev/pipelined 0.49.0 → 0.50.0

package/dist/{chunk-EPT3GYGN.mjs → chunk-6N27QZFK.mjs}

@@ -4,7 +4,7 @@ import {
   Result,
   Task,
   isNonEmptyArr
-} from "./chunk-IHLH2XYQ.mjs";
+} from "./chunk-U64ASY7P.mjs";
 
 // src/Data/Arr.ts
 var ArrMaybe;

package/dist/{chunk-IHLH2XYQ.mjs → chunk-U64ASY7P.mjs}

@@ -1737,22 +1737,35 @@ var Stream;
 ((Stream2) => {
   Stream2.make = (options) => ({
     options,
-    _listeners: /* @__PURE__ */ new Set()
+    _listeners: /* @__PURE__ */ new Set(),
+    _queue: [],
+    _isEmitting: false
   });
   Stream2.emit = (target, message) => {
     const targets = Array.isArray(target) ? target : [target];
     const msg = message;
     for (const stream of targets) {
-      const listeners = Array.from(stream._listeners);
-      for (const listener of listeners) {
+      stream._queue.push(msg);
+      if (!stream._isEmitting) {
+        stream._isEmitting = true;
         try {
-          listener(msg);
-        } catch (err2) {
-          if (stream.options?.onError) {
-            stream.options.onError(err2);
-          } else {
-            throw err2;
+          while (stream._queue.length > 0) {
+            const nextMsg = stream._queue.shift();
+            const listeners = Array.from(stream._listeners);
+            for (const listener of listeners) {
+              try {
+                listener(nextMsg);
+              } catch (err2) {
+                if (stream.options?.onError) {
+                  stream.options.onError(err2);
+                } else {
+                  throw err2;
+                }
+              }
+            }
           }
+        } finally {
+          stream._isEmitting = false;
         }
       }
     }
@@ -1779,6 +1792,7 @@ var Stream;
     const isStrict = options?.strict ?? false;
     const isOnce = options?.once ?? false;
     const resetKinds = options?.reset ? new Set(Array.isArray(options.reset) ? options.reset : [options.reset]) : null;
+    const optionalKinds = options?.optional ? new Set(Array.isArray(options.optional) ? options.optional : [options.optional]) : null;
     const createMatcher = (onMatch) => {
       let sequenceIndex = 0;
       return (msg) => {
@@ -1792,7 +1806,17 @@ var Stream;
           }
           return;
         }
-        const expectedKind = eventList[sequenceIndex];
+        let expectedKind = eventList[sequenceIndex];
+        if (expectedKind !== msg.kind && optionalKinds !== null) {
+          let lookaheadIndex = sequenceIndex;
+          while (lookaheadIndex < eventList.length && optionalKinds.has(eventList[lookaheadIndex]) && eventList[lookaheadIndex] !== msg.kind) {
+            lookaheadIndex++;
+          }
+          if (lookaheadIndex < eventList.length && eventList[lookaheadIndex] === msg.kind) {
+            sequenceIndex = lookaheadIndex;
+            expectedKind = eventList[sequenceIndex];
+          }
+        }
         if (msg.kind === expectedKind) {
           sequenceIndex++;
           if (sequenceIndex === eventList.length) {

package/dist/core.d.mts

@@ -2490,6 +2490,10 @@ type Stream<S extends Record<string, unknown>> = {
     readonly options?: Stream.Options;
     /** @internal */
     readonly _listeners: Set<(msg: Stream.Message<S>) => void>;
+    /** @internal */
+    readonly _queue: Array<Stream.Message<S>>;
+    /** @internal */
+    _isEmitting: boolean;
 };
 declare namespace Stream {
     /**
@@ -2517,6 +2521,8 @@ declare namespace Stream {
         readonly once?: boolean;
         /** Event kind(s) that reset sequence tracking to index 0. */
         readonly reset?: (keyof S & string) | ReadonlyArray<keyof S & string>;
+        /** Event kind(s) in the sequence that may be present or skipped. */
+        readonly optional?: (keyof S & string) | ReadonlyArray<keyof S & string>;
     };
     /**
      * Handle for an active stateful subscription.
@@ -2558,6 +2564,8 @@ declare namespace Stream {
     /**
      * Emits a message payload to one or more target streams.
      *
+     * Uses a synchronous breadth-first trampoline queue to handle re-entrant emissions deterministically.
+     *
      * @example
      * ```ts
      * Stream.emit(streamA, {

package/dist/core.d.ts

@@ -2490,6 +2490,10 @@ type Stream<S extends Record<string, unknown>> = {
     readonly options?: Stream.Options;
     /** @internal */
     readonly _listeners: Set<(msg: Stream.Message<S>) => void>;
+    /** @internal */
+    readonly _queue: Array<Stream.Message<S>>;
+    /** @internal */
+    _isEmitting: boolean;
 };
 declare namespace Stream {
     /**
@@ -2517,6 +2521,8 @@ declare namespace Stream {
         readonly once?: boolean;
         /** Event kind(s) that reset sequence tracking to index 0. */
         readonly reset?: (keyof S & string) | ReadonlyArray<keyof S & string>;
+        /** Event kind(s) in the sequence that may be present or skipped. */
+        readonly optional?: (keyof S & string) | ReadonlyArray<keyof S & string>;
     };
     /**
      * Handle for an active stateful subscription.
@@ -2558,6 +2564,8 @@ declare namespace Stream {
     /**
      * Emits a message payload to one or more target streams.
      *
+     * Uses a synchronous breadth-first trampoline queue to handle re-entrant emissions deterministically.
+     *
      * @example
      * ```ts
      * Stream.emit(streamA, {

package/dist/core.js

@@ -1811,22 +1811,35 @@ var Stream;
 ((Stream2) => {
   Stream2.make = (options) => ({
     options,
-    _listeners: /* @__PURE__ */ new Set()
+    _listeners: /* @__PURE__ */ new Set(),
+    _queue: [],
+    _isEmitting: false
   });
   Stream2.emit = (target, message) => {
     const targets = Array.isArray(target) ? target : [target];
     const msg = message;
     for (const stream of targets) {
-      const listeners = Array.from(stream._listeners);
-      for (const listener of listeners) {
+      stream._queue.push(msg);
+      if (!stream._isEmitting) {
+        stream._isEmitting = true;
         try {
-          listener(msg);
-        } catch (err2) {
-          if (stream.options?.onError) {
-            stream.options.onError(err2);
-          } else {
-            throw err2;
+          while (stream._queue.length > 0) {
+            const nextMsg = stream._queue.shift();
+            const listeners = Array.from(stream._listeners);
+            for (const listener of listeners) {
+              try {
+                listener(nextMsg);
+              } catch (err2) {
+                if (stream.options?.onError) {
+                  stream.options.onError(err2);
+                } else {
+                  throw err2;
+                }
+              }
+            }
           }
+        } finally {
+          stream._isEmitting = false;
         }
       }
     }
@@ -1853,6 +1866,7 @@ var Stream;
     const isStrict = options?.strict ?? false;
     const isOnce = options?.once ?? false;
     const resetKinds = options?.reset ? new Set(Array.isArray(options.reset) ? options.reset : [options.reset]) : null;
+    const optionalKinds = options?.optional ? new Set(Array.isArray(options.optional) ? options.optional : [options.optional]) : null;
     const createMatcher = (onMatch) => {
       let sequenceIndex = 0;
       return (msg) => {
@@ -1866,7 +1880,17 @@ var Stream;
           }
           return;
         }
-        const expectedKind = eventList[sequenceIndex];
+        let expectedKind = eventList[sequenceIndex];
+        if (expectedKind !== msg.kind && optionalKinds !== null) {
+          let lookaheadIndex = sequenceIndex;
+          while (lookaheadIndex < eventList.length && optionalKinds.has(eventList[lookaheadIndex]) && eventList[lookaheadIndex] !== msg.kind) {
+            lookaheadIndex++;
+          }
+          if (lookaheadIndex < eventList.length && eventList[lookaheadIndex] === msg.kind) {
+            sequenceIndex = lookaheadIndex;
+            expectedKind = eventList[sequenceIndex];
+          }
+        }
         if (msg.kind === expectedKind) {
           sequenceIndex++;
           if (sequenceIndex === eventList.length) {

package/dist/core.mjs

@@ -24,7 +24,7 @@ import {
   These,
   Tuple,
   Validation
-} from "./chunk-IHLH2XYQ.mjs";
+} from "./chunk-U64ASY7P.mjs";
 import "./chunk-DENXUTKL.mjs";
 export {
   Combinable,

package/dist/data.mjs

@@ -7,8 +7,8 @@ import {
   Rec,
   Str,
   Uniq
-} from "./chunk-EPT3GYGN.mjs";
-import "./chunk-IHLH2XYQ.mjs";
+} from "./chunk-6N27QZFK.mjs";
+import "./chunk-U64ASY7P.mjs";
 import "./chunk-DENXUTKL.mjs";
 export {
   Arr,

package/dist/index.js

@@ -2293,22 +2293,35 @@ var Stream;
 ((Stream2) => {
   Stream2.make = (options) => ({
     options,
-    _listeners: /* @__PURE__ */ new Set()
+    _listeners: /* @__PURE__ */ new Set(),
+    _queue: [],
+    _isEmitting: false
   });
   Stream2.emit = (target, message) => {
     const targets = Array.isArray(target) ? target : [target];
     const msg = message;
     for (const stream of targets) {
-      const listeners = Array.from(stream._listeners);
-      for (const listener of listeners) {
+      stream._queue.push(msg);
+      if (!stream._isEmitting) {
+        stream._isEmitting = true;
         try {
-          listener(msg);
-        } catch (err2) {
-          if (stream.options?.onError) {
-            stream.options.onError(err2);
-          } else {
-            throw err2;
+          while (stream._queue.length > 0) {
+            const nextMsg = stream._queue.shift();
+            const listeners = Array.from(stream._listeners);
+            for (const listener of listeners) {
+              try {
+                listener(nextMsg);
+              } catch (err2) {
+                if (stream.options?.onError) {
+                  stream.options.onError(err2);
+                } else {
+                  throw err2;
+                }
+              }
+            }
           }
+        } finally {
+          stream._isEmitting = false;
         }
       }
     }
@@ -2335,6 +2348,7 @@ var Stream;
     const isStrict = options?.strict ?? false;
     const isOnce = options?.once ?? false;
     const resetKinds = options?.reset ? new Set(Array.isArray(options.reset) ? options.reset : [options.reset]) : null;
+    const optionalKinds = options?.optional ? new Set(Array.isArray(options.optional) ? options.optional : [options.optional]) : null;
     const createMatcher = (onMatch) => {
       let sequenceIndex = 0;
       return (msg) => {
@@ -2348,7 +2362,17 @@ var Stream;
           }
           return;
         }
-        const expectedKind = eventList[sequenceIndex];
+        let expectedKind = eventList[sequenceIndex];
+        if (expectedKind !== msg.kind && optionalKinds !== null) {
+          let lookaheadIndex = sequenceIndex;
+          while (lookaheadIndex < eventList.length && optionalKinds.has(eventList[lookaheadIndex]) && eventList[lookaheadIndex] !== msg.kind) {
+            lookaheadIndex++;
+          }
+          if (lookaheadIndex < eventList.length && eventList[lookaheadIndex] === msg.kind) {
+            sequenceIndex = lookaheadIndex;
+            expectedKind = eventList[sequenceIndex];
+          }
+        }
         if (msg.kind === expectedKind) {
           sequenceIndex++;
           if (sequenceIndex === eventList.length) {

package/dist/index.mjs

@@ -39,7 +39,7 @@ import {
   Rec,
   Str,
   Uniq
-} from "./chunk-EPT3GYGN.mjs";
+} from "./chunk-6N27QZFK.mjs";
 import {
   Combinable,
   Deferred,
@@ -66,7 +66,7 @@ import {
   These,
   Tuple,
   Validation
-} from "./chunk-IHLH2XYQ.mjs";
+} from "./chunk-U64ASY7P.mjs";
 import {
   Brand,
   Duration,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nlozgachev/pipelined",
-	"version": "0.49.0",
+	"version": "0.50.0",
 	"description": "Opinionated functional abstractions for TypeScript",
 	"license": "BSD-3-Clause",
 	"homepage": "https://pipelined.lozgachev.dev",
@@ -18,7 +18,7 @@
 	"types": "./dist/index.d.ts",
 	"sideEffects": false,
 	"engines": {
-		"node": ">=24"
+		"node": ">=24.19.0"
 	},
 	"files": [
 		"dist"
@@ -68,24 +68,44 @@
 		"docs:build": "pnpm --filter pipelined-docs build"
 	},
 	"devDependencies": {
-		"@size-limit/file": "12.1.0",
-		"@types/node": "25.9.3",
-		"@vitest/coverage-v8": "4.1.8",
-		"bumpp": "11.1.0",
-		"dprint": "0.54.0",
-		"fast-check": "4.8.0",
-		"oxlint": "1.69.0",
-		"size-limit": "12.1.0",
+		"@size-limit/file": "13.0.3",
+		"@types/node": "26.2.0",
+		"@vitest/coverage-v8": "4.1.10",
+		"bumpp": "12.2.0",
+		"dprint": "0.55.2",
+		"fast-check": "4.9.0",
+		"oxlint": "1.78.0",
+		"size-limit": "13.0.3",
 		"tsup": "8.5.1",
 		"typescript": "6.0.3",
-		"vitest": "4.1.8"
+		"vitest": "4.1.10"
 	},
 	"size-limit": [
-		{ "path": "dist/index.js", "limit": "25 KB", "gzip": true },
-		{ "path": "dist/core.js", "limit": "16 KB", "gzip": true },
-		{ "path": "dist/composition.js", "limit": "4 KB", "gzip": true },
-		{ "path": "dist/data.js", "limit": "13 KB", "gzip": true },
-		{ "path": "dist/types.js", "limit": "2 KB", "gzip": true }
+		{
+			"path": "dist/index.js",
+			"limit": "25 KB",
+			"gzip": true
+		},
+		{
+			"path": "dist/core.js",
+			"limit": "16 KB",
+			"gzip": true
+		},
+		{
+			"path": "dist/composition.js",
+			"limit": "4 KB",
+			"gzip": true
+		},
+		{
+			"path": "dist/data.js",
+			"limit": "13 KB",
+			"gzip": true
+		},
+		{
+			"path": "dist/types.js",
+			"limit": "2 KB",
+			"gzip": true
+		}
 	],
 	"packageManager": "pnpm@11.6.0+sha512.9a36518224080c6fe5165afdcfe79bfa118c29be703f3f462b1e32efe1e98e47e8750b148e08286250aad4113cc7993ca413c4e2cd447752708c2ee5751bc95f"
 }