@graphrefly/graphrefly 0.22.0 → 0.23.0

package/dist/graph/index.d.cts

@@ -1,5 +1,5 @@
-export { E as ENVELOPE_VERSION, a as EvictedSubgraphInfo, b as EvictionPolicy, G as GraphCodec, J as JsonCodec, L as LazyGraphCodec, O as SIZEOF_OVERHEAD, S as SIZEOF_SYMBOL, W as WALEntry, c as createDagCborCodec, d as createDagCborZstdCodec, e as decodeEnvelope, f as encodeEnvelope, r as registerBuiltinCodecs, g as replayWAL, s as sizeof } from '../index-Dy04P4W3.cjs';
-export { D as DescribeFilter, e as GRAPH_META_SEGMENT, G as Graph, f as GraphActorOptions, b as GraphAttachStorageOptions, g as GraphCheckpointRecord, h as GraphDescribeOptions, i as GraphDescribeOutput, j as GraphDiagramDirection, k as GraphDiagramOptions, l as GraphDiffChange, m as GraphDiffResult, n as GraphFactoryContext, o as GraphNodeFactory, p as GraphObserveAll, q as GraphObserveOne, a as GraphOptions, r as GraphPersistSnapshot, d as GraphProfileOptions, c as GraphProfileResult, s as GraphVersionChange, t as GraphWALDiff, N as NodeProfile, O as ObserveDetail, u as ObserveEvent, v as ObserveOptions, w as ObserveResult, x as ObserveTheme, y as ObserveThemeName, R as ReachableDirection, z as ReachableOptions, T as TraceEntry, A as diffForWAL, B as graphProfile, C as reachable } from '../graph-ab1yPwIB.cjs';
-import '../node-C5UD5MGq.cjs';
-import '../meta--fr9sxRM.cjs';
-import '../storage-Bew05Xy6.cjs';
+export { E as ENVELOPE_VERSION, a as EvictedSubgraphInfo, b as EvictionPolicy, G as GraphCodec, J as JsonCodec, L as LazyGraphCodec, O as SIZEOF_OVERHEAD, S as SIZEOF_SYMBOL, W as WALEntry, c as createDagCborCodec, d as createDagCborZstdCodec, e as decodeEnvelope, f as encodeEnvelope, r as registerBuiltinCodecs, g as replayWAL, s as sizeof } from '../index-BFGjXbiP.cjs';
+export { D as DescribeFilter, e as GRAPH_META_SEGMENT, G as Graph, f as GraphActorOptions, b as GraphAttachStorageOptions, g as GraphCheckpointRecord, h as GraphDescribeOptions, i as GraphDescribeOutput, j as GraphDiagramDirection, k as GraphDiagramOptions, l as GraphDiffChange, m as GraphDiffResult, n as GraphFactoryContext, o as GraphNodeFactory, p as GraphObserveAll, q as GraphObserveOne, a as GraphOptions, r as GraphPersistSnapshot, d as GraphProfileOptions, c as GraphProfileResult, s as GraphVersionChange, t as GraphWALDiff, N as NodeProfile, O as ObserveDetail, u as ObserveEvent, v as ObserveOptions, w as ObserveResult, x as ObserveTheme, y as ObserveThemeName, R as ReachableDirection, z as ReachableOptions, T as TraceEntry, A as diffForWAL, B as graphProfile, C as reachable } from '../graph-BtdSRHUc.cjs';
+import '../node-C7PD3sn9.cjs';
+import '../meta-B-Lbs4-O.cjs';
+import '../storage-DIgAr7M_.cjs';

package/dist/graph/index.d.ts

@@ -1,5 +1,5 @@
-export { E as ENVELOPE_VERSION, a as EvictedSubgraphInfo, b as EvictionPolicy, G as GraphCodec, J as JsonCodec, L as LazyGraphCodec, O as SIZEOF_OVERHEAD, S as SIZEOF_SYMBOL, W as WALEntry, c as createDagCborCodec, d as createDagCborZstdCodec, e as decodeEnvelope, f as encodeEnvelope, r as registerBuiltinCodecs, g as replayWAL, s as sizeof } from '../index-DsGxLfwL.js';
-export { D as DescribeFilter, e as GRAPH_META_SEGMENT, G as Graph, f as GraphActorOptions, b as GraphAttachStorageOptions, g as GraphCheckpointRecord, h as GraphDescribeOptions, i as GraphDescribeOutput, j as GraphDiagramDirection, k as GraphDiagramOptions, l as GraphDiffChange, m as GraphDiffResult, n as GraphFactoryContext, o as GraphNodeFactory, p as GraphObserveAll, q as GraphObserveOne, a as GraphOptions, r as GraphPersistSnapshot, d as GraphProfileOptions, c as GraphProfileResult, s as GraphVersionChange, t as GraphWALDiff, N as NodeProfile, O as ObserveDetail, u as ObserveEvent, v as ObserveOptions, w as ObserveResult, x as ObserveTheme, y as ObserveThemeName, R as ReachableDirection, z as ReachableOptions, T as TraceEntry, A as diffForWAL, B as graphProfile, C as reachable } from '../graph-DFr0diXB.js';
-import '../node-C5UD5MGq.js';
-import '../meta-n3FoVWML.js';
-import '../storage-C9fZfMfM.js';
+export { E as ENVELOPE_VERSION, a as EvictedSubgraphInfo, b as EvictionPolicy, G as GraphCodec, J as JsonCodec, L as LazyGraphCodec, O as SIZEOF_OVERHEAD, S as SIZEOF_SYMBOL, W as WALEntry, c as createDagCborCodec, d as createDagCborZstdCodec, e as decodeEnvelope, f as encodeEnvelope, r as registerBuiltinCodecs, g as replayWAL, s as sizeof } from '../index-CkElcUY6.js';
+export { D as DescribeFilter, e as GRAPH_META_SEGMENT, G as Graph, f as GraphActorOptions, b as GraphAttachStorageOptions, g as GraphCheckpointRecord, h as GraphDescribeOptions, i as GraphDescribeOutput, j as GraphDiagramDirection, k as GraphDiagramOptions, l as GraphDiffChange, m as GraphDiffResult, n as GraphFactoryContext, o as GraphNodeFactory, p as GraphObserveAll, q as GraphObserveOne, a as GraphOptions, r as GraphPersistSnapshot, d as GraphProfileOptions, c as GraphProfileResult, s as GraphVersionChange, t as GraphWALDiff, N as NodeProfile, O as ObserveDetail, u as ObserveEvent, v as ObserveOptions, w as ObserveResult, x as ObserveTheme, y as ObserveThemeName, R as ReachableDirection, z as ReachableOptions, T as TraceEntry, A as diffForWAL, B as graphProfile, C as reachable } from '../graph-CEO2FkLY.js';
+import '../node-C7PD3sn9.js';
+import '../meta-3QjzotRv.js';
+import '../storage-CHT5WE9m.js';

package/dist/graph/index.js

@@ -1,4 +1,4 @@
-import "../chunk-44HD4BTA.js";
+import "../chunk-2GQLMQVJ.js";
 import {
   GRAPH_META_SEGMENT,
   Graph,
@@ -8,8 +8,8 @@ import {
   graphProfile,
   reachable,
   sizeof
-} from "../chunk-NXC35KC5.js";
-import "../chunk-TH6COGOP.js";
+} from "../chunk-XRFJJ2IU.js";
+import "../chunk-HVBX5KIW.js";
 import "../chunk-7TAQJHQV.js";
 import {
   ENVELOPE_VERSION,
@@ -20,7 +20,7 @@ import {
   encodeEnvelope,
   registerBuiltinCodecs,
   replayWAL
-} from "../chunk-QA3RP5NH.js";
+} from "../chunk-NZMBRXQV.js";
 export {
   ENVELOPE_VERSION,
   GRAPH_META_SEGMENT,

package/dist/{graph-ab1yPwIB.d.cts → graph-BtdSRHUc.d.cts}

@@ -1,6 +1,6 @@
-import { k as GraphReFlyConfig, a6 as VersioningLevel, N as Node, A as Actor, t as Messages, K as NodeSink } from './node-C5UD5MGq.cjs';
-import { b as DescribeNodeOutput, D as DescribeDetail, a as DescribeField } from './meta--fr9sxRM.cjs';
-import { a as StorageTier, S as StorageHandle } from './storage-Bew05Xy6.cjs';
+import { k as GraphReFlyConfig, a6 as VersioningLevel, N as Node, A as Actor, t as Messages, K as NodeSink } from './node-C7PD3sn9.cjs';
+import { b as DescribeNodeOutput, D as DescribeDetail, a as DescribeField } from './meta-B-Lbs4-O.cjs';
+import { a as StorageTier, S as StorageHandle } from './storage-DIgAr7M_.cjs';
 
 /**
  * Graph profiling and inspection utilities.

package/dist/{graph-DFr0diXB.d.ts → graph-CEO2FkLY.d.ts}

@@ -1,6 +1,6 @@
-import { k as GraphReFlyConfig, a6 as VersioningLevel, N as Node, A as Actor, t as Messages, K as NodeSink } from './node-C5UD5MGq.js';
-import { b as DescribeNodeOutput, D as DescribeDetail, a as DescribeField } from './meta-n3FoVWML.js';
-import { a as StorageTier, S as StorageHandle } from './storage-C9fZfMfM.js';
+import { k as GraphReFlyConfig, a6 as VersioningLevel, N as Node, A as Actor, t as Messages, K as NodeSink } from './node-C7PD3sn9.js';
+import { b as DescribeNodeOutput, D as DescribeDetail, a as DescribeField } from './meta-3QjzotRv.js';
+import { a as StorageTier, S as StorageHandle } from './storage-CHT5WE9m.js';
 
 /**
  * Graph profiling and inspection utilities.

package/dist/{index-BvWfZCTt.d.cts → index-B0tfuXwV.d.cts}

@@ -1,6 +1,6 @@
-import { a as NodeOptions, N as Node, M as Message, t as Messages, a6 as VersioningLevel } from './node-C5UD5MGq.cjs';
-import { a as StorageTier, I as IndexedDbStorageSpec, S as StorageHandle, d as dictStorage, f as fileStorage, b as fromIDBRequest, c as fromIDBTransaction, i as indexedDbStorage, m as memoryStorage, s as sqliteStorage } from './storage-Bew05Xy6.cjs';
-import { T as ToObservableOptions, t as toObservable } from './observable-DWydVy5b.cjs';
+import { a as NodeOptions, N as Node, M as Message, t as Messages, a6 as VersioningLevel } from './node-C7PD3sn9.cjs';
+import { a as StorageTier, I as IndexedDbStorageSpec, S as StorageHandle, d as dictStorage, f as fileStorage, b as fromIDBRequest, c as fromIDBTransaction, i as indexedDbStorage, m as memoryStorage, s as sqliteStorage } from './storage-DIgAr7M_.cjs';
+import { T as ToObservableOptions, t as toObservable } from './observable-axpzv1K2.cjs';
 
 /**
  * External-register helpers — the common `register({emit, error, complete})`

package/dist/{index-Dy04P4W3.d.cts → index-BFGjXbiP.d.cts}

@@ -1,5 +1,5 @@
-import { k as GraphReFlyConfig } from './node-C5UD5MGq.cjs';
-import { r as GraphPersistSnapshot, g as GraphCheckpointRecord, D as DescribeFilter, e as GRAPH_META_SEGMENT, G as Graph, f as GraphActorOptions, b as GraphAttachStorageOptions, h as GraphDescribeOptions, i as GraphDescribeOutput, j as GraphDiagramDirection, k as GraphDiagramOptions, l as GraphDiffChange, m as GraphDiffResult, n as GraphFactoryContext, o as GraphNodeFactory, p as GraphObserveAll, q as GraphObserveOne, a as GraphOptions, d as GraphProfileOptions, c as GraphProfileResult, s as GraphVersionChange, t as GraphWALDiff, N as NodeProfile, O as ObserveDetail, u as ObserveEvent, v as ObserveOptions, w as ObserveResult, x as ObserveTheme, y as ObserveThemeName, R as ReachableDirection, z as ReachableOptions, T as TraceEntry, A as diffForWAL, B as graphProfile, C as reachable } from './graph-ab1yPwIB.cjs';
+import { k as GraphReFlyConfig } from './node-C7PD3sn9.cjs';
+import { r as GraphPersistSnapshot, g as GraphCheckpointRecord, D as DescribeFilter, e as GRAPH_META_SEGMENT, G as Graph, f as GraphActorOptions, b as GraphAttachStorageOptions, h as GraphDescribeOptions, i as GraphDescribeOutput, j as GraphDiagramDirection, k as GraphDiagramOptions, l as GraphDiffChange, m as GraphDiffResult, n as GraphFactoryContext, o as GraphNodeFactory, p as GraphObserveAll, q as GraphObserveOne, a as GraphOptions, d as GraphProfileOptions, c as GraphProfileResult, s as GraphVersionChange, t as GraphWALDiff, N as NodeProfile, O as ObserveDetail, u as ObserveEvent, v as ObserveOptions, w as ObserveResult, x as ObserveTheme, y as ObserveThemeName, R as ReachableDirection, z as ReachableOptions, T as TraceEntry, A as diffForWAL, B as graphProfile, C as reachable } from './graph-BtdSRHUc.cjs';
 
 /**
  * Approximate in-memory size estimation for arbitrary JS values.

package/dist/{index-DrJq9B1T.d.cts → index-BPlWVAKY.d.cts}

@@ -1,8 +1,8 @@
-import { T as ToObservableOptions, t as toObservable } from './observable-DWydVy5b.cjs';
+import { T as ToObservableOptions, t as toObservable } from './observable-axpzv1K2.cjs';
 import { OnModuleInit, OnModuleDestroy, ExecutionContext, CanActivate, DynamicModule } from '@nestjs/common';
 import { ModuleRef } from '@nestjs/core';
-import { G as Graph, a as GraphOptions, r as GraphPersistSnapshot } from './graph-ab1yPwIB.cjs';
-import { A as Actor, N as Node } from './node-C5UD5MGq.cjs';
+import { G as Graph, a as GraphOptions, r as GraphPersistSnapshot } from './graph-BtdSRHUc.cjs';
+import { A as Actor, N as Node } from './node-C7PD3sn9.cjs';
 
 /** Class constructor key for decorator registries and Nest `ModuleRef.get()`. */
 type DecoratorHostConstructor = abstract new (...args: unknown[]) => unknown;

package/dist/{index-C9z6rU9P.d.cts → index-BUj3ASVe.d.cts}

@@ -1,28 +1,46 @@
-import { t as Messages, a as NodeOptions, F as FnCtx, N as Node, b as NodeActions, x as NodeFnCleanup, A as Actor, C as COMPLETE, c as COMPLETE_MSG, d as COMPLETE_ONLY_BATCH, D as DATA, e as DEFAULT_ACTOR, f as DIRTY, g as DIRTY_MSG, h as DIRTY_ONLY_BATCH, i as DepRecord, E as ERROR, G as GlobalInspectorEvent, j as GlobalInspectorHook, k as GraphReFlyConfig, l as GuardAction, m as GuardDenied, n as GuardDeniedDetails, H as HashFn, I as INVALIDATE, o as INVALIDATE_MSG, p as INVALIDATE_ONLY_BATCH, M as Message, q as MessageContext, r as MessageTypeRegistration, s as MessageTypeRegistrationInput, u as NodeCtx, v as NodeDescribeKind, w as NodeFn, y as NodeGuard, z as NodeImpl, B as NodeInspectorHook, J as NodeInspectorHookEvent, K as NodeSink, L as NodeStatus, O as NodeTransportOptions, P as NodeVersionInfo, Q as OnMessageHandler, R as OnSubscribeHandler, S as PAUSE, T as PolicyAllow, U as PolicyDeny, V as PolicyRuleData, W as RESOLVED, X as RESOLVED_MSG, Y as RESOLVED_ONLY_BATCH, Z as RESUME, _ as START, $ as START_MSG, a0 as SubscribeContext, a1 as TEARDOWN, a2 as TEARDOWN_MSG, a3 as TEARDOWN_ONLY_BATCH, a4 as V0, a5 as V1, a6 as VersioningLevel, a7 as VersioningOptions, a8 as accessHintForGuard, a9 as advanceVersion, aa as configure, ab as createVersioning, ac as defaultConfig, ad as defaultHash, ae as isV1, af as node, ag as normalizeActor, ah as policy, ai as policyFromRules, aj as registerBuiltins } from './node-C5UD5MGq.cjs';
-import { D as DescribeDetail, a as DescribeField, b as DescribeNodeOutput, r as resolveDescribeFields } from './meta--fr9sxRM.cjs';
+import { t as Messages, a as NodeOptions, F as FnCtx, N as Node, b as NodeActions, x as NodeFnCleanup, A as Actor, C as COMPLETE, c as COMPLETE_MSG, d as COMPLETE_ONLY_BATCH, D as DATA, e as DEFAULT_ACTOR, f as DIRTY, g as DIRTY_MSG, h as DIRTY_ONLY_BATCH, i as DepRecord, E as ERROR, G as GlobalInspectorEvent, j as GlobalInspectorHook, k as GraphReFlyConfig, l as GuardAction, m as GuardDenied, n as GuardDeniedDetails, H as HashFn, I as INVALIDATE, o as INVALIDATE_MSG, p as INVALIDATE_ONLY_BATCH, M as Message, q as MessageContext, r as MessageTypeRegistration, s as MessageTypeRegistrationInput, u as NodeCtx, v as NodeDescribeKind, w as NodeFn, y as NodeGuard, z as NodeImpl, B as NodeInspectorHook, J as NodeInspectorHookEvent, K as NodeSink, L as NodeStatus, O as NodeTransportOptions, P as NodeVersionInfo, Q as OnMessageHandler, R as OnSubscribeHandler, S as PAUSE, T as PolicyAllow, U as PolicyDeny, V as PolicyRuleData, W as RESOLVED, X as RESOLVED_MSG, Y as RESOLVED_ONLY_BATCH, Z as RESUME, _ as START, $ as START_MSG, a0 as SubscribeContext, a1 as TEARDOWN, a2 as TEARDOWN_MSG, a3 as TEARDOWN_ONLY_BATCH, a4 as V0, a5 as V1, a6 as VersioningLevel, a7 as VersioningOptions, a8 as accessHintForGuard, a9 as advanceVersion, aa as configure, ab as createVersioning, ac as defaultConfig, ad as defaultHash, ae as isV1, af as node, ag as normalizeActor, ah as policy, ai as policyFromRules, aj as registerBuiltins } from './node-C7PD3sn9.cjs';
+import { D as DescribeDetail, a as DescribeField, b as DescribeNodeOutput, r as resolveDescribeFields } from './meta-B-Lbs4-O.cjs';
 
 /**
- * Batch deferral for tier-3+ messages.
+ * Batch deferral for tier-3+ messages, plus per-node emit coalescing inside
+ * explicit `batch()` scopes.
  *
  * §1.3.7 — Inside a batch, tier 0–2 signals propagate immediately. Tier 3
  * (DATA/RESOLVED), tier 4 (COMPLETE/ERROR), and tier 5 (TEARDOWN) are queued
  * and drained in ascending phase order after the outermost `batch()` callback
  * returns.
  *
+ * **Per-node emit coalescing (Bug 2 fix, 2026-04-17).** Inside an explicit
+ * `batch()` scope, consecutive emissions from the same node accumulate in
+ * `NodeImpl._batchPendingMessages` instead of each producing a separate
+ * downstream wave. At batch end, each node flushes its accumulated messages
+ * as ONE multi-message `downWithBatch` call — K `.emit()`s to the same
+ * source collapse to K DIRTYs in one tier-1 sink call + K DATAs in one
+ * tier-3 sink call. Downstream nodes' fns run once per wave with the full
+ * `batchData` (dep's `dataBatch` accumulates all K values, fn sees
+ * `[[v1, v2, ..., vK]]`). Resolves the K+1 fan-in over-fire.
+ *
+ * Outside batch — and during drain (where `flushInProgress` is true but
+ * `batchDepth` is 0) — coalescing does NOT apply: each emit goes through
+ * its own `downWithBatch` call and produces its own wave.
+ *
  * **Phase vocabulary:**
  * - Phase 1 = tiers 0–2 — immediate, never queued.
  * - Phase 2 = tier 3 — {@link drainPhase2}. Value settlements.
  * - Phase 3 = tier 4 — {@link drainPhase3}. Terminal signals.
  * - Phase 4 = tier 5 — {@link drainPhase4}. TEARDOWN (unified deferral).
  *
- * Drain rule: lowest non-empty phase first. Re-enqueues during drain bump the
- * loop back to the lowest non-empty phase, preserving "earlier values settle
- * before later terminals/teardown" across callback re-entry.
+ * Drain rule: fire any pending flush hooks first, then the lowest non-empty
+ * phase. Re-enqueues during drain (and hooks registered by reentrant batches
+ * inside subscriber callbacks) bump the loop back to the top so newly-added
+ * hooks and closures get processed.
  *
  * **Pre-sorted input invariant.** `downWithBatch` assumes `messages` is
  * already sorted in ascending tier order (produced by `_frameBatch` in
  * `node.ts`). The walker exploits monotonicity for a single O(n) pass and
- * slices at phase boundaries without re-sorting.
+ * slices at phase boundaries without re-sorting. Flushed multi-emit batches
+ * re-run `_frameBatch` to restore monotonicity (the per-emit framings
+ * accumulate in interleaved order: `[DIRTY, DATA, DIRTY, DATA, ...]`).
  */
 
 /**

package/dist/{index-DLE1Sp-L.d.cts → index-C59uSJAH.d.cts}

@@ -1,5 +1,5 @@
-import { N as Node } from './node-C5UD5MGq.cjs';
-import { G as Graph } from './graph-ab1yPwIB.cjs';
+import { N as Node } from './node-C7PD3sn9.cjs';
+import { G as Graph } from './graph-BtdSRHUc.cjs';
 
 /** Pluggable measurement backend. */
 interface MeasurementAdapter {

package/dist/{index-DsGxLfwL.d.ts → index-CkElcUY6.d.ts}

@@ -1,5 +1,5 @@
-import { k as GraphReFlyConfig } from './node-C5UD5MGq.js';
-import { r as GraphPersistSnapshot, g as GraphCheckpointRecord, D as DescribeFilter, e as GRAPH_META_SEGMENT, G as Graph, f as GraphActorOptions, b as GraphAttachStorageOptions, h as GraphDescribeOptions, i as GraphDescribeOutput, j as GraphDiagramDirection, k as GraphDiagramOptions, l as GraphDiffChange, m as GraphDiffResult, n as GraphFactoryContext, o as GraphNodeFactory, p as GraphObserveAll, q as GraphObserveOne, a as GraphOptions, d as GraphProfileOptions, c as GraphProfileResult, s as GraphVersionChange, t as GraphWALDiff, N as NodeProfile, O as ObserveDetail, u as ObserveEvent, v as ObserveOptions, w as ObserveResult, x as ObserveTheme, y as ObserveThemeName, R as ReachableDirection, z as ReachableOptions, T as TraceEntry, A as diffForWAL, B as graphProfile, C as reachable } from './graph-DFr0diXB.js';
+import { k as GraphReFlyConfig } from './node-C7PD3sn9.js';
+import { r as GraphPersistSnapshot, g as GraphCheckpointRecord, D as DescribeFilter, e as GRAPH_META_SEGMENT, G as Graph, f as GraphActorOptions, b as GraphAttachStorageOptions, h as GraphDescribeOptions, i as GraphDescribeOutput, j as GraphDiagramDirection, k as GraphDiagramOptions, l as GraphDiffChange, m as GraphDiffResult, n as GraphFactoryContext, o as GraphNodeFactory, p as GraphObserveAll, q as GraphObserveOne, a as GraphOptions, d as GraphProfileOptions, c as GraphProfileResult, s as GraphVersionChange, t as GraphWALDiff, N as NodeProfile, O as ObserveDetail, u as ObserveEvent, v as ObserveOptions, w as ObserveResult, x as ObserveTheme, y as ObserveThemeName, R as ReachableDirection, z as ReachableOptions, T as TraceEntry, A as diffForWAL, B as graphProfile, C as reachable } from './graph-CEO2FkLY.js';
 
 /**
  * Approximate in-memory size estimation for arbitrary JS values.

package/dist/{index-HdJx_BjO.d.ts → index-DSPc5rkv.d.ts}

@@ -1,28 +1,46 @@
-import { t as Messages, a as NodeOptions, F as FnCtx, N as Node, b as NodeActions, x as NodeFnCleanup, A as Actor, C as COMPLETE, c as COMPLETE_MSG, d as COMPLETE_ONLY_BATCH, D as DATA, e as DEFAULT_ACTOR, f as DIRTY, g as DIRTY_MSG, h as DIRTY_ONLY_BATCH, i as DepRecord, E as ERROR, G as GlobalInspectorEvent, j as GlobalInspectorHook, k as GraphReFlyConfig, l as GuardAction, m as GuardDenied, n as GuardDeniedDetails, H as HashFn, I as INVALIDATE, o as INVALIDATE_MSG, p as INVALIDATE_ONLY_BATCH, M as Message, q as MessageContext, r as MessageTypeRegistration, s as MessageTypeRegistrationInput, u as NodeCtx, v as NodeDescribeKind, w as NodeFn, y as NodeGuard, z as NodeImpl, B as NodeInspectorHook, J as NodeInspectorHookEvent, K as NodeSink, L as NodeStatus, O as NodeTransportOptions, P as NodeVersionInfo, Q as OnMessageHandler, R as OnSubscribeHandler, S as PAUSE, T as PolicyAllow, U as PolicyDeny, V as PolicyRuleData, W as RESOLVED, X as RESOLVED_MSG, Y as RESOLVED_ONLY_BATCH, Z as RESUME, _ as START, $ as START_MSG, a0 as SubscribeContext, a1 as TEARDOWN, a2 as TEARDOWN_MSG, a3 as TEARDOWN_ONLY_BATCH, a4 as V0, a5 as V1, a6 as VersioningLevel, a7 as VersioningOptions, a8 as accessHintForGuard, a9 as advanceVersion, aa as configure, ab as createVersioning, ac as defaultConfig, ad as defaultHash, ae as isV1, af as node, ag as normalizeActor, ah as policy, ai as policyFromRules, aj as registerBuiltins } from './node-C5UD5MGq.js';
-import { D as DescribeDetail, a as DescribeField, b as DescribeNodeOutput, r as resolveDescribeFields } from './meta-n3FoVWML.js';
+import { t as Messages, a as NodeOptions, F as FnCtx, N as Node, b as NodeActions, x as NodeFnCleanup, A as Actor, C as COMPLETE, c as COMPLETE_MSG, d as COMPLETE_ONLY_BATCH, D as DATA, e as DEFAULT_ACTOR, f as DIRTY, g as DIRTY_MSG, h as DIRTY_ONLY_BATCH, i as DepRecord, E as ERROR, G as GlobalInspectorEvent, j as GlobalInspectorHook, k as GraphReFlyConfig, l as GuardAction, m as GuardDenied, n as GuardDeniedDetails, H as HashFn, I as INVALIDATE, o as INVALIDATE_MSG, p as INVALIDATE_ONLY_BATCH, M as Message, q as MessageContext, r as MessageTypeRegistration, s as MessageTypeRegistrationInput, u as NodeCtx, v as NodeDescribeKind, w as NodeFn, y as NodeGuard, z as NodeImpl, B as NodeInspectorHook, J as NodeInspectorHookEvent, K as NodeSink, L as NodeStatus, O as NodeTransportOptions, P as NodeVersionInfo, Q as OnMessageHandler, R as OnSubscribeHandler, S as PAUSE, T as PolicyAllow, U as PolicyDeny, V as PolicyRuleData, W as RESOLVED, X as RESOLVED_MSG, Y as RESOLVED_ONLY_BATCH, Z as RESUME, _ as START, $ as START_MSG, a0 as SubscribeContext, a1 as TEARDOWN, a2 as TEARDOWN_MSG, a3 as TEARDOWN_ONLY_BATCH, a4 as V0, a5 as V1, a6 as VersioningLevel, a7 as VersioningOptions, a8 as accessHintForGuard, a9 as advanceVersion, aa as configure, ab as createVersioning, ac as defaultConfig, ad as defaultHash, ae as isV1, af as node, ag as normalizeActor, ah as policy, ai as policyFromRules, aj as registerBuiltins } from './node-C7PD3sn9.js';
+import { D as DescribeDetail, a as DescribeField, b as DescribeNodeOutput, r as resolveDescribeFields } from './meta-3QjzotRv.js';
 
 /**
- * Batch deferral for tier-3+ messages.
+ * Batch deferral for tier-3+ messages, plus per-node emit coalescing inside
+ * explicit `batch()` scopes.
  *
  * §1.3.7 — Inside a batch, tier 0–2 signals propagate immediately. Tier 3
  * (DATA/RESOLVED), tier 4 (COMPLETE/ERROR), and tier 5 (TEARDOWN) are queued
  * and drained in ascending phase order after the outermost `batch()` callback
  * returns.
  *
+ * **Per-node emit coalescing (Bug 2 fix, 2026-04-17).** Inside an explicit
+ * `batch()` scope, consecutive emissions from the same node accumulate in
+ * `NodeImpl._batchPendingMessages` instead of each producing a separate
+ * downstream wave. At batch end, each node flushes its accumulated messages
+ * as ONE multi-message `downWithBatch` call — K `.emit()`s to the same
+ * source collapse to K DIRTYs in one tier-1 sink call + K DATAs in one
+ * tier-3 sink call. Downstream nodes' fns run once per wave with the full
+ * `batchData` (dep's `dataBatch` accumulates all K values, fn sees
+ * `[[v1, v2, ..., vK]]`). Resolves the K+1 fan-in over-fire.
+ *
+ * Outside batch — and during drain (where `flushInProgress` is true but
+ * `batchDepth` is 0) — coalescing does NOT apply: each emit goes through
+ * its own `downWithBatch` call and produces its own wave.
+ *
  * **Phase vocabulary:**
  * - Phase 1 = tiers 0–2 — immediate, never queued.
  * - Phase 2 = tier 3 — {@link drainPhase2}. Value settlements.
  * - Phase 3 = tier 4 — {@link drainPhase3}. Terminal signals.
  * - Phase 4 = tier 5 — {@link drainPhase4}. TEARDOWN (unified deferral).
  *
- * Drain rule: lowest non-empty phase first. Re-enqueues during drain bump the
- * loop back to the lowest non-empty phase, preserving "earlier values settle
- * before later terminals/teardown" across callback re-entry.
+ * Drain rule: fire any pending flush hooks first, then the lowest non-empty
+ * phase. Re-enqueues during drain (and hooks registered by reentrant batches
+ * inside subscriber callbacks) bump the loop back to the top so newly-added
+ * hooks and closures get processed.
  *
  * **Pre-sorted input invariant.** `downWithBatch` assumes `messages` is
  * already sorted in ascending tier order (produced by `_frameBatch` in
  * `node.ts`). The walker exploits monotonicity for a single O(n) pass and
- * slices at phase boundaries without re-sorting.
+ * slices at phase boundaries without re-sorting. Flushed multi-emit batches
+ * re-run `_frameBatch` to restore monotonicity (the per-emit framings
+ * accumulate in interleaved order: `[DIRTY, DATA, DIRTY, DATA, ...]`).
  */
 
 /**

package/dist/{index-D36MAQ3f.d.ts → index-DgscL7v0.d.ts}

@@ -1,8 +1,8 @@
-import { T as ToObservableOptions, t as toObservable } from './observable-CQRBtEbq.js';
+import { T as ToObservableOptions, t as toObservable } from './observable-EyO-moQY.js';
 import { OnModuleInit, OnModuleDestroy, ExecutionContext, CanActivate, DynamicModule } from '@nestjs/common';
 import { ModuleRef } from '@nestjs/core';
-import { G as Graph, a as GraphOptions, r as GraphPersistSnapshot } from './graph-DFr0diXB.js';
-import { A as Actor, N as Node } from './node-C5UD5MGq.js';
+import { G as Graph, a as GraphOptions, r as GraphPersistSnapshot } from './graph-CEO2FkLY.js';
+import { A as Actor, N as Node } from './node-C7PD3sn9.js';
 
 /** Class constructor key for decorator registries and Nest `ModuleRef.get()`. */
 type DecoratorHostConstructor = abstract new (...args: unknown[]) => unknown;

package/dist/{index-BbYZma8G.d.ts → index-RXN94sHK.d.ts}

@@ -1,6 +1,6 @@
-import { a as NodeOptions, N as Node, M as Message, t as Messages, a6 as VersioningLevel } from './node-C5UD5MGq.js';
-import { a as StorageTier, I as IndexedDbStorageSpec, S as StorageHandle, d as dictStorage, f as fileStorage, b as fromIDBRequest, c as fromIDBTransaction, i as indexedDbStorage, m as memoryStorage, s as sqliteStorage } from './storage-C9fZfMfM.js';
-import { T as ToObservableOptions, t as toObservable } from './observable-CQRBtEbq.js';
+import { a as NodeOptions, N as Node, M as Message, t as Messages, a6 as VersioningLevel } from './node-C7PD3sn9.js';
+import { a as StorageTier, I as IndexedDbStorageSpec, S as StorageHandle, d as dictStorage, f as fileStorage, b as fromIDBRequest, c as fromIDBTransaction, i as indexedDbStorage, m as memoryStorage, s as sqliteStorage } from './storage-CHT5WE9m.js';
+import { T as ToObservableOptions, t as toObservable } from './observable-EyO-moQY.js';
 
 /**
  * External-register helpers — the common `register({emit, error, complete})`

package/dist/{index-BHm3Ba5q.d.ts → index-jEtF4N7L.d.ts}

@@ -1,5 +1,5 @@
-import { N as Node } from './node-C5UD5MGq.js';
-import { G as Graph } from './graph-DFr0diXB.js';
+import { N as Node } from './node-C7PD3sn9.js';
+import { G as Graph } from './graph-CEO2FkLY.js';
 
 /** Pluggable measurement backend. */
 interface MeasurementAdapter {

package/dist/index.cjs

@@ -544,9 +544,20 @@ var flushInProgress = false;
 var drainPhase2 = [];
 var drainPhase3 = [];
 var drainPhase4 = [];
+var flushHooks = [];
 function isBatching() {
   return batchDepth > 0 || flushInProgress;
 }
+function isExplicitlyBatching() {
+  return batchDepth > 0;
+}
+function registerBatchFlushHook(hook) {
+  if (batchDepth > 0) {
+    flushHooks.push(hook);
+  } else {
+    hook();
+  }
+}
 function batch(fn) {
   batchDepth += 1;
   let threw = false;
@@ -560,6 +571,13 @@ function batch(fn) {
     if (batchDepth === 0) {
       if (threw) {
         if (!flushInProgress) {
+          const hooks = flushHooks.splice(0);
+          for (const h of hooks) {
+            try {
+              h();
+            } catch {
+            }
+          }
           drainPhase2.length = 0;
           drainPhase3.length = 0;
           drainPhase4.length = 0;
@@ -576,7 +594,18 @@ function drainPending() {
   const errors = [];
   let iterations = 0;
   try {
-    while (drainPhase2.length > 0 || drainPhase3.length > 0 || drainPhase4.length > 0) {
+    while (drainPhase2.length > 0 || drainPhase3.length > 0 || drainPhase4.length > 0 || ownsFlush && flushHooks.length > 0) {
+      if (ownsFlush && flushHooks.length > 0) {
+        const hooks = flushHooks.splice(0);
+        for (const h of hooks) {
+          try {
+            h();
+          } catch (e) {
+            errors.push(e);
+          }
+        }
+        continue;
+      }
       iterations += 1;
       if (iterations > MAX_DRAIN_ITERATIONS) {
         drainPhase2.length = 0;
@@ -1266,6 +1295,22 @@ var NodeImpl = class _NodeImpl {
    * treats `0` as "wave settled" — O(1) check for full dep settlement.
    */
   _dirtyDepCount = 0;
+  // --- Per-batch emit accumulator (Bug 2: K+1 fan-in fix) ---
+  /**
+   * Inside an explicit `batch(() => ...)` scope, every `_emit` accumulates
+   * its already-framed messages here instead of dispatching synchronously.
+   * At batch end, `_flushBatchPending` runs (registered via
+   * `registerBatchFlushHook`) and delivers the whole accumulated batch as
+   * one `downWithBatch` call — collapsing what would otherwise be K
+   * separate sink invocations into one. This is the fix for the diamond
+   * fan-in K+1 over-fire.
+   *
+   * `null` outside batch (or after flush). Only ever appended to within
+   * a single explicit batch lifetime; reset to `null` on flush. State
+   * updates (cache, version, status) still happen per-emit via
+   * `_updateState` — only the downstream delivery is coalesced.
+   */
+  _batchPendingMessages = null;
   // --- PAUSE/RESUME lock tracking (C0) ---
   /**
    * Set of active pause locks held against this node. Every `[PAUSE, lockId]`
@@ -1643,7 +1688,10 @@ var NodeImpl = class _NodeImpl {
         dep.unsub = noopUnsub;
         dep.unsub = dep.node.subscribe((msgs) => {
           if (dep.unsub === null) return;
+          const tierOf = this._config.tierOf;
+          let sawSettlement = false;
           for (const m of msgs) {
+            if (tierOf(m[0]) >= 3) sawSettlement = true;
             this._config.onMessage(
               this,
               m,
@@ -1651,6 +1699,7 @@ var NodeImpl = class _NodeImpl {
               this._actions
             );
           }
+          if (sawSettlement) this._maybeRunFnOnSettlement();
         });
         subscribedCount++;
       }
@@ -1705,7 +1754,10 @@ var NodeImpl = class _NodeImpl {
     try {
       record.unsub = depNode.subscribe((msgs) => {
         if (record.unsub === null) return;
+        const tierOf = this._config.tierOf;
+        let sawSettlement = false;
         for (const m of msgs) {
+          if (tierOf(m[0]) >= 3) sawSettlement = true;
           this._config.onMessage(
             this,
             m,
@@ -1713,6 +1765,7 @@ var NodeImpl = class _NodeImpl {
             this._actions
           );
         }
+        if (sawSettlement) this._maybeRunFnOnSettlement();
       });
     } catch (err) {
       record.unsub = null;
@@ -1834,7 +1887,6 @@ var NodeImpl = class _NodeImpl {
       }
       return;
     }
-    this._maybeRunFnOnSettlement();
   }
   // --- Centralized dep-state transitions (A3 settlement counters) ---
   //
@@ -2206,10 +2258,10 @@ var NodeImpl = class _NodeImpl {
           }
         }
         if (immediate.length > 0) {
-          downWithBatch(this._deliverToSinks, immediate, tierOf);
+          this._dispatchOrAccumulate(immediate);
         }
       } else {
-        downWithBatch(this._deliverToSinks, finalMessages, this._config.tierOf);
+        this._dispatchOrAccumulate(finalMessages);
       }
     }
     if (equalsError != null) {
@@ -2332,6 +2384,50 @@ var NodeImpl = class _NodeImpl {
     const snapshot = [...this._sinks];
     for (const sink of snapshot) sink(messages);
   };
+  /**
+   * @internal Dispatch entry point that respects the per-batch emit
+   * accumulator (Bug 2). Inside an explicit `batch()` scope, append to
+   * `_batchPendingMessages` and register a flush hook on first append.
+   * Outside batch — or during a drain (where `flushInProgress` is true
+   * but `batchDepth` is 0) — dispatch synchronously through `downWithBatch`.
+   *
+   * Per-emit state updates (`_frameBatch`, `_updateState`) have already
+   * happened by the time we reach here; only the **downstream delivery**
+   * is coalesced. Cache, version, and status are visible mid-batch on
+   * the emitting node itself.
+   */
+  _dispatchOrAccumulate(messages) {
+    if (isExplicitlyBatching()) {
+      if (this._batchPendingMessages === null) {
+        this._batchPendingMessages = [];
+        registerBatchFlushHook(() => this._flushBatchPending());
+      }
+      for (const m of messages) this._batchPendingMessages.push(m);
+      return;
+    }
+    downWithBatch(this._deliverToSinks, messages, this._config.tierOf);
+  }
+  /**
+   * @internal Flushes the accumulated batch through `downWithBatch` and
+   * clears the pending state. Idempotent — safe to call when pending is
+   * already null or empty (e.g. on a `batch()` throw, where the hook
+   * fires for cleanup but the drainPhase queues are wiped after).
+   *
+   * Critical: the accumulated batch is interleaved per-emit framings like
+   * `[DIRTY, DATA(1), DIRTY, DATA(2)]` — non-monotone tier order. We must
+   * re-frame to sort by tier before handing to `downWithBatch`, which
+   * assumes pre-sorted input. `_frameBatch` also handles the synthetic
+   * DIRTY prepend rule (no-op here — `hasDirty` is true since each
+   * accumulated emit already carries its own DIRTY prefix).
+   */
+  _flushBatchPending() {
+    const pending = this._batchPendingMessages;
+    if (pending === null) return;
+    this._batchPendingMessages = null;
+    if (pending.length === 0) return;
+    const framed = this._frameBatch(pending);
+    downWithBatch(this._deliverToSinks, framed, this._config.tierOf);
+  }
 };
 var isNodeArray = (value) => Array.isArray(value);
 var isNodeOptionsObject = (value) => typeof value === "object" && value != null && !Array.isArray(value);
@@ -7182,6 +7278,10 @@ __export(graph_exports, {
 });
 
 // src/patterns/_internal.ts
+function emitToMeta(metaNode, value) {
+  if (metaNode == null) return;
+  downWithBatch((msgs) => metaNode.down(msgs), [[DATA, value]], defaultConfig.tierOf);
+}
 function tryIncrementBounded(counter, cap) {
   const cur = counter.cache ?? 0;
   if (cur >= cap) return false;
@@ -18324,13 +18424,9 @@ function reactiveLayout(opts) {
       const hitRate = lookups === 0 ? 1 : measureStats.hits / lookups;
       const meta = segmentsNode.meta;
       if (meta) {
-        const hr = hitRate;
-        const len = result.length;
-        const el = elapsed;
-        const tierOf = defaultConfig.tierOf;
-        downWithBatch((msgs) => meta["cache-hit-rate"]?.down(msgs), [[DATA, hr]], tierOf);
-        downWithBatch((msgs) => meta["segment-count"]?.down(msgs), [[DATA, len]], tierOf);
-        downWithBatch((msgs) => meta["layout-time-ns"]?.down(msgs), [[DATA, el]], tierOf);
+        emitToMeta(meta["cache-hit-rate"], hitRate);
+        emitToMeta(meta["segment-count"], result.length);
+        emitToMeta(meta["layout-time-ns"], elapsed);
       }
       actions.emit(result);
       return () => {
@@ -21659,9 +21755,8 @@ function reactiveBlockLayout(opts) {
       const elapsed = monotonicNs() - t0;
       const meta = measuredBlocksNode.meta;
       if (meta) {
-        const tierOf = defaultConfig.tierOf;
-        downWithBatch((msgs) => meta["block-count"]?.down(msgs), [[DATA, result.length]], tierOf);
-        downWithBatch((msgs) => meta["layout-time-ns"]?.down(msgs), [[DATA, elapsed]], tierOf);
+        emitToMeta(meta["block-count"], result.length);
+        emitToMeta(meta["layout-time-ns"], elapsed);
       }
       actions.emit(result);
       return () => {