@graphrefly/ts 0.0.2 → 0.0.3

package/dist/core/index.d.cts

@@ -1,4 +1,4 @@
-export { C as Ctx, a as CtxState, D as Dispatcher, H as Handle, f as HandleStat, N as Node, m as NodeFn, n as NodeOptions, o as NodeVersion, p as NodeVersionHashFn, q as NodeVersionJson, r as NodeVersionV0, s as NodeVersionV1, t as NodeVersioningLevel, u as NodeVersioningPolicy, P as Pool, v as PoolKind, R as RewireNext, S as Sink, B as Status, T as TerminalData, W as WaveData, Z as defaultDispatcher, _ as defaultNodeVersionHash, $ as depBatch, a0 as depCount, a1 as depLatest, a2 as depTerminal, a3 as depWaves, a5 as dynamicNode, a7 as isTerminalComplete, a8 as isTerminalError, a9 as isTerminalNone, aa as node, ab as terminalErrorValue } from '../types-BS6CyR-x.cjs';
+export { C as Ctx, a as CtxState, D as Dispatcher, H as Handle, f as HandleStat, N as Node, m as NodeFn, n as NodeOptions, o as NodeVersion, p as NodeVersionHashFn, q as NodeVersionJson, r as NodeVersionV0, s as NodeVersionV1, t as NodeVersioningLevel, u as NodeVersioningPolicy, P as Pool, v as PoolKind, R as RewireNext, S as Sink, B as Status, T as TerminalData, W as WaveData, Z as defaultDispatcher, _ as defaultNodeVersionHash, $ as depBatch, a0 as depCount, a1 as depLatest, a2 as depTerminal, a3 as depWaves, a5 as dynamicNode, a7 as isTerminalComplete, a8 as isTerminalError, a9 as isTerminalNone, aa as node, ab as terminalErrorValue } from '../types-CTN3XoMl.cjs';
 export { L as LockId, M as Message, a as MessageType, P as PullDemand, S as SENTINEL, T as TIER_CONTROL, b as TIER_NOTIFICATION, c as TIER_SETTLE, d as TIER_START, e as TIER_TEARDOWN, f as TIER_TERMINAL, g as TIER_VALUE, W as Wave, h as errorPayload, i as isDeferredTier, j as isInvalidErrorPayload, k as isPauseBufferedTier, l as isTerminal, m as isUpAllowed, n as isValueTier, o as messageTier } from '../messages-CAzUPPJM.cjs';
 
 /**
@@ -19,7 +19,28 @@ interface BatchCtx {
     /** Discard all deferred emissions in this batch instead of committing. */
     rollback(): void;
 }
-/** Run `fn` as a batch (D12). DATA deferred to commit; throw/rollback discards. */
+/**
+ * Run updates as one coalesced batch.
+ *
+ * @param fn - Synchronous callback that performs node updates and may call `rollback()`.
+ * @returns The callback return value when the batch commits.
+ * @example
+ * ```ts
+ * import { batch, graph } from "@graphrefly/ts";
+ *
+ * const g = graph();
+ * const left = g.state(0);
+ * const right = g.state(0);
+ *
+ * batch(() => {
+ *   left.set(1);
+ *   right.set(2);
+ * });
+ * ```
+ * @remarks **Coalescing:** DATA/RESOLVED/INVALIDATE settle slices are deferred until commit so
+ *   shared downstream nodes recompute once for the batch.
+ * @category core
+ */
 declare function batch<R>(fn: (bctx: BatchCtx) => R): R;
 
 export { type BatchCtx, batch };

package/dist/core/index.d.ts

@@ -1,4 +1,4 @@
-export { C as Ctx, a as CtxState, D as Dispatcher, H as Handle, f as HandleStat, N as Node, m as NodeFn, n as NodeOptions, o as NodeVersion, p as NodeVersionHashFn, q as NodeVersionJson, r as NodeVersionV0, s as NodeVersionV1, t as NodeVersioningLevel, u as NodeVersioningPolicy, P as Pool, v as PoolKind, R as RewireNext, S as Sink, B as Status, T as TerminalData, W as WaveData, Z as defaultDispatcher, _ as defaultNodeVersionHash, $ as depBatch, a0 as depCount, a1 as depLatest, a2 as depTerminal, a3 as depWaves, a5 as dynamicNode, a7 as isTerminalComplete, a8 as isTerminalError, a9 as isTerminalNone, aa as node, ab as terminalErrorValue } from '../types-C9NOgNJw.js';
+export { C as Ctx, a as CtxState, D as Dispatcher, H as Handle, f as HandleStat, N as Node, m as NodeFn, n as NodeOptions, o as NodeVersion, p as NodeVersionHashFn, q as NodeVersionJson, r as NodeVersionV0, s as NodeVersionV1, t as NodeVersioningLevel, u as NodeVersioningPolicy, P as Pool, v as PoolKind, R as RewireNext, S as Sink, B as Status, T as TerminalData, W as WaveData, Z as defaultDispatcher, _ as defaultNodeVersionHash, $ as depBatch, a0 as depCount, a1 as depLatest, a2 as depTerminal, a3 as depWaves, a5 as dynamicNode, a7 as isTerminalComplete, a8 as isTerminalError, a9 as isTerminalNone, aa as node, ab as terminalErrorValue } from '../types-DChxk1vK.js';
 export { L as LockId, M as Message, a as MessageType, P as PullDemand, S as SENTINEL, T as TIER_CONTROL, b as TIER_NOTIFICATION, c as TIER_SETTLE, d as TIER_START, e as TIER_TEARDOWN, f as TIER_TERMINAL, g as TIER_VALUE, W as Wave, h as errorPayload, i as isDeferredTier, j as isInvalidErrorPayload, k as isPauseBufferedTier, l as isTerminal, m as isUpAllowed, n as isValueTier, o as messageTier } from '../messages-CAzUPPJM.js';
 
 /**
@@ -19,7 +19,28 @@ interface BatchCtx {
     /** Discard all deferred emissions in this batch instead of committing. */
     rollback(): void;
 }
-/** Run `fn` as a batch (D12). DATA deferred to commit; throw/rollback discards. */
+/**
+ * Run updates as one coalesced batch.
+ *
+ * @param fn - Synchronous callback that performs node updates and may call `rollback()`.
+ * @returns The callback return value when the batch commits.
+ * @example
+ * ```ts
+ * import { batch, graph } from "@graphrefly/ts";
+ *
+ * const g = graph();
+ * const left = g.state(0);
+ * const right = g.state(0);
+ *
+ * batch(() => {
+ *   left.set(1);
+ *   right.set(2);
+ * });
+ * ```
+ * @remarks **Coalescing:** DATA/RESOLVED/INVALIDATE settle slices are deferred until commit so
+ *   shared downstream nodes recompute once for the batch.
+ * @category core
+ */
 declare function batch<R>(fn: (bctx: BatchCtx) => R): R;
 
 export { type BatchCtx, batch };

package/dist/core/index.js

@@ -6,7 +6,7 @@ import {
   defaultNodeVersionHash,
   dynamicNode,
   node
-} from "../chunk-SHZDP2MQ.js";
+} from "../chunk-GXU6WFEJ.js";
 import {
   depBatch,
   depCount,

package/dist/cqrs/index.d.cts

@@ -1,9 +1,9 @@
-import { d as Graph } from '../graph-CWK3HLPB.cjs';
-import { N as Node } from '../types-BS6CyR-x.cjs';
+import { d as Graph } from '../graph-C1C-wb0L.cjs';
+import { N as Node } from '../types-CTN3XoMl.cjs';
 import '../core/index.cjs';
 import '../messages-CAzUPPJM.cjs';
 import '../codec-BB7p8fJc.cjs';
-import '../describe-CQRrkv-Q.cjs';
+import '../describe-BumQ-3_0.cjs';
 
 /**
  * Reusable application-infrastructure CQRS helpers (B63 / D125 / D129).

package/dist/cqrs/index.d.ts

@@ -1,9 +1,9 @@
-import { d as Graph } from '../graph-ho5sotHP.js';
-import { N as Node } from '../types-C9NOgNJw.js';
+import { d as Graph } from '../graph-CS0b4V9B.js';
+import { N as Node } from '../types-DChxk1vK.js';
 import '../core/index.js';
 import '../messages-CAzUPPJM.js';
 import '../codec-BB7p8fJc.js';
-import '../describe-B_A5fbXH.js';
+import '../describe-cYr_Z5zm.js';
 
 /**
  * Reusable application-infrastructure CQRS helpers (B63 / D125 / D129).

package/dist/cqrs/messaging.d.cts

@@ -1,12 +1,12 @@
 import { CqrsCommand, CqrsStatus, CqrsError, CqrsEvent } from './index.cjs';
 import { DataIssue } from '../data/index.cjs';
-import { d as Graph } from '../graph-CWK3HLPB.cjs';
-import { N as Node } from '../types-BS6CyR-x.cjs';
-import { M as MessageBusMessage, a as MessageBusCommand, b as MessageBusAvailablePage } from '../types-BhveCMg5.cjs';
+import { d as Graph } from '../graph-C1C-wb0L.cjs';
+import { N as Node } from '../types-CTN3XoMl.cjs';
+import { M as MessageBusMessage, a as MessageBusCommand, b as MessageBusAvailablePage } from '../types-BAw2QVVE.cjs';
 import '../core/index.cjs';
 import '../messages-CAzUPPJM.cjs';
 import '../codec-BB7p8fJc.cjs';
-import '../describe-CQRrkv-Q.cjs';
+import '../describe-BumQ-3_0.cjs';
 
 /**
  * Optional CQRS-over-messageBus recipe (D350/D351/D353).

package/dist/cqrs/messaging.d.ts

@@ -1,12 +1,12 @@
 import { CqrsCommand, CqrsStatus, CqrsError, CqrsEvent } from './index.js';
 import { DataIssue } from '../data/index.js';
-import { d as Graph } from '../graph-ho5sotHP.js';
-import { N as Node } from '../types-C9NOgNJw.js';
-import { M as MessageBusMessage, a as MessageBusCommand, b as MessageBusAvailablePage } from '../types-CTsQ8Ww4.js';
+import { d as Graph } from '../graph-CS0b4V9B.js';
+import { N as Node } from '../types-DChxk1vK.js';
+import { M as MessageBusMessage, a as MessageBusCommand, b as MessageBusAvailablePage } from '../types-DRu7SnLV.js';
 import '../core/index.js';
 import '../messages-CAzUPPJM.js';
 import '../codec-BB7p8fJc.js';
-import '../describe-B_A5fbXH.js';
+import '../describe-cYr_Z5zm.js';
 
 /**
  * Optional CQRS-over-messageBus recipe (D350/D351/D353).

package/dist/cqrs/work-queue.d.cts

@@ -1,13 +1,13 @@
 import { CqrsCommand, CqrsStatus, CqrsError, CqrsErrorCode } from './index.cjs';
 import { DataIssue } from '../data/index.cjs';
-import { d as Graph } from '../graph-CWK3HLPB.cjs';
-import { N as Node } from '../types-BS6CyR-x.cjs';
-import { W as WorkQueueCommand, a as WorkQueueRecord } from '../types-BXKSAoE1.cjs';
+import { d as Graph } from '../graph-C1C-wb0L.cjs';
+import { N as Node } from '../types-CTN3XoMl.cjs';
+import { W as WorkQueueCommand, a as WorkQueueRecord } from '../types-CV_ohy5T.cjs';
 import '../core/index.cjs';
 import '../messages-CAzUPPJM.cjs';
 import '../codec-BB7p8fJc.cjs';
-import '../describe-CQRrkv-Q.cjs';
-import '../types-BhveCMg5.cjs';
+import '../describe-BumQ-3_0.cjs';
+import '../types-BAw2QVVE.cjs';
 
 /**
  * Optional CQRS-over-workQueue recipe (D350/D352/D353).

package/dist/cqrs/work-queue.d.ts

@@ -1,13 +1,13 @@
 import { CqrsCommand, CqrsStatus, CqrsError, CqrsErrorCode } from './index.js';
 import { DataIssue } from '../data/index.js';
-import { d as Graph } from '../graph-ho5sotHP.js';
-import { N as Node } from '../types-C9NOgNJw.js';
-import { W as WorkQueueCommand, a as WorkQueueRecord } from '../types-BRNKoFHj.js';
+import { d as Graph } from '../graph-CS0b4V9B.js';
+import { N as Node } from '../types-DChxk1vK.js';
+import { W as WorkQueueCommand, a as WorkQueueRecord } from '../types-IhKH0hGW.js';
 import '../core/index.js';
 import '../messages-CAzUPPJM.js';
 import '../codec-BB7p8fJc.js';
-import '../describe-B_A5fbXH.js';
-import '../types-CTsQ8Ww4.js';
+import '../describe-cYr_Z5zm.js';
+import '../types-DRu7SnLV.js';
 
 /**
  * Optional CQRS-over-workQueue recipe (D350/D352/D353).