@graphrefly/graphrefly 0.17.0 → 0.19.0

package/dist/{index-BmoUvOGN.d.ts → index-CvKzv0AW.d.ts}

@@ -1,4 +1,65 @@
-import { m as Messages, N as Node, n as NodeDescribeKind, o as NodeGuard, a as NodeOptions, a6 as NodeInspectorHook, q as NodeStatus, A as Actor, r as NodeTransportOptions, p as NodeSink, S as SubscribeHints, c as NodeFn, C as CLEANUP_RESULT, d as COMPLETE, e as CleanupResult, D as DATA, f as DEFAULT_ACTOR, g as DIRTY, h as DescribeDetail, i as DescribeField, j as DescribeNodeOutput, E as ERROR, G as GuardAction, k as GuardDenied, l as GuardDeniedDetails, H as HashFn, I as INVALIDATE, M as Message, b as NodeActions, s as NodeVersionInfo, O as OnMessageHandler, P as PAUSE, t as PolicyAllow, u as PolicyDeny, v as PolicyRuleData, R as RESOLVED, w as RESUME, T as TEARDOWN, V as V0, x as V1, y as VersioningLevel, z as VersioningOptions, B as accessHintForGuard, F as advanceVersion, J as cleanupResult, K as createVersioning, L as defaultHash, Q as describeNode, U as isKnownMessageType, W as isPhase2Message, X as isTerminalMessage, Y as isV1, Z as knownMessageTypes, _ as messageTier, $ as metaSnapshot, a0 as node, a1 as normalizeActor, a2 as policy, a3 as policyFromRules, a4 as propagatesToMeta, a5 as resolveDescribeFields } from './meta-BV4pj9ML.js';
+import { b as NodeActions, N as Node, a as NodeOptions, l as Messages, a4 as NodeBase, q as NodeTransportOptions, A as Actor, C as CLEANUP_RESULT, c as COMPLETE, d as CleanupResult, D as DATA, e as DEFAULT_ACTOR, f as DIRTY, g as DescribeDetail, h as DescribeField, i as DescribeNodeOutput, E as ERROR, G as GuardAction, j as GuardDenied, k as GuardDeniedDetails, H as HashFn, I as INVALIDATE, M as Message, m as NodeDescribeKind, n as NodeGuard, o as NodeSink, p as NodeStatus, r as NodeVersionInfo, O as OnMessageHandler, P as PAUSE, s as PolicyAllow, t as PolicyDeny, u as PolicyRuleData, R as RESOLVED, v as RESUME, S as START, w as SubscribeHints, T as TEARDOWN, V as V0, x as V1, y as VersioningLevel, z as VersioningOptions, B as accessHintForGuard, F as advanceVersion, J as cleanupResult, K as createVersioning, L as defaultHash, Q as isKnownMessageType, U as isLocalOnly, W as isPhase2Message, X as isTerminalMessage, Y as isV1, Z as knownMessageTypes, _ as messageTier, $ as normalizeActor, a0 as policy, a1 as policyFromRules, a2 as propagatesToMeta, a3 as resolveDescribeFields } from './meta-BnG7XAaE.js';
+
+/**
+ * `NodeImpl` — the canonical node primitive for static (compile-time known)
+ * dependency graphs. Covers state, producer, derived, effect, operator, and
+ * passthrough shapes from a single class.
+ *
+ * Lifecycle machinery (subscribe + START handshake + `_downInternal` pipeline)
+ * lives in {@link NodeBase}. This file only adds:
+ * - Dep-wave tracking via pre-set dirty masks (first run and subsequent waves
+ *   share the same code path — see `_connectUpstream` + `_handleDepMessages`)
+ * - `_runFn` with identity-skip optimization on `_lastDepValues`
+ * - Producer start/stop tied to sink count
+ * - ROM/RAM cache semantics: compute nodes clear `_cached` on disconnect,
+ *   state sources preserve it (see `_onDeactivate`).
+ *
+ * See GRAPHREFLY-SPEC §§2.1–2.8 and COMPOSITION-GUIDE §§1, 9.
+ */
+
+/**
+ * Compute function passed to `node(deps, fn, opts?)`.
+ *
+ * @returns A value to emit, `undefined` to skip emission, or a cleanup
+ *   function invoked before the next run or on teardown.
+ */
+type NodeFn<T = unknown> = (deps: readonly unknown[], actions: NodeActions) => T | undefined | (() => void);
+/**
+ * Creates a reactive {@link Node} — the single GraphReFly primitive (§2).
+ *
+ * Typical shapes: `node([])` / `node([], opts)` for a manual source;
+ * `node(producerFn, opts)` for a producer; `node(deps, computeFn, opts)` for
+ * derived nodes and operators.
+ *
+ * @param depsOrFn - Dependency nodes, a {@link NodeFn} (producer), or {@link NodeOptions} alone.
+ * @param fnOrOpts - With deps: compute function or options. Omitted for producer-only form.
+ * @param optsArg - Options when both `deps` and `fn` are provided.
+ * @returns `Node<T>` — lazy until subscribed.
+ *
+ * @remarks
+ * **Protocol:** START handshake, DIRTY / DATA / RESOLVED ordering, completion,
+ * and batch deferral follow `~/src/graphrefly/GRAPHREFLY-SPEC.md`.
+ *
+ * **`equals` and mutable values:** The default `Object.is` identity check is
+ * correct for the common immutable-value case. If your node produces mutable
+ * objects, provide a custom `equals` — otherwise `Object.is` always returns
+ * `true` for the same reference and the node emits `RESOLVED` instead of `DATA`.
+ *
+ * **ROM/RAM (§2.2):** State nodes (no fn) preserve their cache across
+ * disconnect — runtime writes survive. Compute nodes (derived, producer)
+ * clear their cache on disconnect; reconnect re-runs fn.
+ *
+ * @example
+ * ```ts
+ * import { node, state } from "@graphrefly/graphrefly-ts";
+ *
+ * const a = state(1);
+ * const b = node([a], ([x]) => (x as number) + 1);
+ * ```
+ *
+ * @category core
+ */
+declare function node<T = unknown>(depsOrFn?: readonly Node[] | NodeFn<T> | NodeOptions, fnOrOpts?: NodeFn<T> | NodeOptions, optsArg?: NodeOptions): Node<T>;
 
 /**
  * Returns whether the current call stack is inside a batch scope **or** while
@@ -55,9 +116,9 @@ declare function batch(fn: () => void): void;
 /**
  * Splits a message array into three groups by signal tier (see `messages.ts`):
  *
- * - **immediate** — tier 0–1: DIRTY, INVALIDATE, PAUSE, RESUME, TEARDOWN, unknown
- * - **deferred** — tier 2: DATA, RESOLVED (phase-2, deferred inside `batch()`)
- * - **terminal** — tier 3: COMPLETE, ERROR (delivered after phase-2)
+ * - **immediate** — tier 0–2, 5: START, DIRTY, INVALIDATE, PAUSE, RESUME, TEARDOWN, unknown
+ * - **deferred** — tier 3: DATA, RESOLVED (phase-2, deferred inside `batch()`)
+ * - **terminal** — tier 4: COMPLETE, ERROR (delivered after phase-2)
  *
  * Order within each group is preserved.
  *
@@ -83,10 +144,10 @@ declare function partitionForBatch(messages: Messages): {
  * Delivers messages downstream through `sink`, applying batch semantics and
  * canonical tier-based ordering (see `messages.ts`):
  *
- * 1. **Immediate** (tier 0–1, 4): DIRTY, INVALIDATE, PAUSE, RESUME, TEARDOWN,
+ * 1. **Immediate** (tier 0–2, 5): START, DIRTY, INVALIDATE, PAUSE, RESUME, TEARDOWN,
  *    unknown — delivered synchronously.
- * 2. **Phase-2** (tier 2): DATA, RESOLVED — deferred while `isBatching()`.
- * 3. **Terminal** (tier 3): COMPLETE, ERROR — always delivered after phase-2.
+ * 2. **Phase-2** (tier 3): DATA, RESOLVED — deferred while `isBatching()`.
+ * 3. **Terminal** (tier 4): COMPLETE, ERROR — always delivered after phase-2.
  *    When batching, terminal is queued after deferred phase-2 in the pending list.
  *    When not batching, terminal is delivered after phase-2 synchronously.
  *
@@ -225,12 +286,19 @@ declare function wallClockNs(): number;
 /**
  * `dynamicNode` — runtime dep tracking with diamond resolution (Phase 0.3b).
  *
- * Unlike `node()` where deps are fixed at construction, `dynamicNode` discovers
- * deps at runtime via a tracking `get()` proxy. After each recompute, deps are
- * diffed: new deps are connected, removed deps are disconnected, and bitmasks
- * are rebuilt. Kept deps retain their subscriptions (no teardown/reconnect churn).
- *
- * This ports callbag-recharge's `dynamicDerived` pattern to GraphReFly's protocol.
+ * Unlike `node()` where deps are fixed at construction, `dynamicNode`
+ * discovers deps at runtime via a tracking `get()` proxy. After each
+ * recompute, deps are diffed: new deps are connected, removed deps are
+ * disconnected, and bitmasks are rebuilt.
+ *
+ * Shares subscribe / sink / lifecycle machinery with {@link NodeImpl} via
+ * {@link NodeBase}. The only things that diverge from static nodes:
+ * - deps are discovered inside `_runFn` via a tracking `get` proxy
+ * - `_rewire` installs subscriptions lazily during `_runFn`
+ * - during rewire, new dep messages are **buffered** (option C from the
+ *   Apr-2026 refactor); after rewire we scan the buffer for DATA values
+ *   that differ from what fn tracked, and re-run fn if any found
+ *   (bounded by `MAX_RERUN`)
  */
 
 /**
@@ -253,10 +321,14 @@ type DynamicNodeOptions = Pick<NodeOptions, "name" | "equals" | "meta" | "resubs
  * - New deps (not in previous set) are subscribed
  * - Removed deps (not in current set) are unsubscribed
  * - Kept deps retain their existing subscriptions
- * - Bitmasks are rebuilt to match the new dep set
  *
- * The node participates fully in diamond resolution via the standard two-phase
- * DIRTY/RESOLVED protocol across all dynamically-tracked deps.
+ * The node participates in diamond resolution via the pre-set dirty mask
+ * (shared with {@link NodeImpl}).
+ *
+ * **Lazy-dep composition:** when a tracked dep is itself a lazy compute node
+ * whose first subscribe causes a fresh value to arrive, the rewire buffer
+ * detects the discrepancy and re-runs fn once so it observes the real value.
+ * Capped at {@link MAX_RERUN} iterations.
  *
  * @param fn - Compute function receiving a tracking `get` proxy.
  * @param opts - Optional configuration.
@@ -270,7 +342,6 @@ type DynamicNodeOptions = Pick<NodeOptions, "name" | "equals" | "meta" | "resubs
  * const a = state(1);
  * const b = state(2);
  *
- * // Deps change based on cond's value
  * const d = dynamicNode((get) => {
  *   const useA = get(cond);
  *   return useA ? get(a) : get(b);
@@ -281,75 +352,48 @@ type DynamicNodeOptions = Pick<NodeOptions, "name" | "equals" | "meta" | "resubs
  */
 declare function dynamicNode<T = unknown>(fn: DynamicNodeFn<T>, opts?: DynamicNodeOptions): Node<T>;
 /** @internal — exported for {@link describeNode} `instanceof` check. */
-declare class DynamicNodeImpl<T = unknown> implements Node<T> {
-    private readonly _optsName;
-    private _registryName;
-    readonly _describeKind: NodeDescribeKind | undefined;
-    readonly meta: Record<string, Node>;
+declare class DynamicNodeImpl<T = unknown> extends NodeBase<T> {
     private readonly _fn;
-    private readonly _equals;
-    private readonly _resubscribable;
-    private readonly _resetOnTeardown;
     private readonly _autoComplete;
-    private readonly _onMessage;
-    private readonly _onResubscribe;
-    /** @internal — read by {@link describeNode} for `accessHintForGuard`. */
-    readonly _guard: NodeGuard | undefined;
-    private _lastMutation;
-    private _inspectorHook;
-    private _sinkCount;
-    private _singleDepSinkCount;
-    private _singleDepSinks;
-    private readonly _actions;
-    private readonly _boundDownToSinks;
-    private _cached;
-    private _status;
-    private _terminal;
-    private _connected;
-    private _rewiring;
-    private _deps;
+    /** @internal Read by `describeNode`. */
+    _deps: Node[];
     private _depUnsubs;
     private _depIndexMap;
-    private _dirtyBits;
-    private _settledBits;
-    private _completeBits;
-    private _sinks;
+    private _depDirtyBits;
+    private _depSettledBits;
+    private _depCompleteBits;
+    private _running;
+    private _rewiring;
+    private _bufferedDepMessages;
+    private _trackedValues;
+    private _rerunCount;
     constructor(fn: DynamicNodeFn<T>, opts: DynamicNodeOptions);
-    get name(): string | undefined;
-    /** @internal */
-    _assignRegistryName(localName: string): void;
-    /**
-     * @internal Attach/remove inspector hook for graph-level observability.
-     * Returns a disposer that restores the previous hook.
-     */
-    _setInspectorHook(hook?: NodeInspectorHook): () => void;
-    get status(): NodeStatus;
-    get lastMutation(): Readonly<{
-        actor: Actor;
-        timestamp_ns: number;
-    }> | undefined;
-    /** Versioning not yet supported on DynamicNodeImpl. */
+    protected _createMetaNode(key: string, initialValue: unknown, opts: NodeOptions): Node;
+    /** Versioning not supported on DynamicNodeImpl (override base). */
     get v(): undefined;
-    hasGuard(): boolean;
-    allowsObserve(actor: Actor): boolean;
-    get(): T | undefined;
-    down(messages: Messages, options?: NodeTransportOptions): void;
-    private _downInternal;
-    private _canSkipDirty;
-    subscribe(sink: NodeSink, hints?: SubscribeHints): () => void;
     up(messages: Messages, options?: NodeTransportOptions): void;
+    protected _upInternal(messages: Messages): void;
     unsubscribe(): void;
-    private _downToSinks;
-    private _handleLocalLifecycle;
-    /** Propagate a signal to all companion meta nodes (best-effort). */
-    private _propagateToMeta;
-    private _downAutoValue;
-    private _connect;
+    protected _onActivate(): void;
+    protected _doDeactivate(): void;
     private _disconnect;
     private _runFn;
     private _rewire;
     private _handleDepMessages;
+    /**
+     * Update dep masks for a message without triggering `_runFn` — used
+     * during post-rewire drain so the wave state is consistent with the
+     * buffered activation cascade without recursing.
+     */
+    private _updateMasksForMessage;
     private _allDirtySettled;
+    /**
+     * True if any current dep value differs from what the last `_runFn`
+     * saw via `get()`. Used to suppress redundant re-runs when deferred
+     * handshake messages arrive after `_rewire` for a dep whose value
+     * already matches `_trackedValues`.
+     */
+    private _depValuesDifferFromTracked;
 }
 
 /**
@@ -523,7 +567,7 @@ declare const index_Messages: typeof Messages;
 declare const index_Node: typeof Node;
 declare const index_NodeActions: typeof NodeActions;
 declare const index_NodeDescribeKind: typeof NodeDescribeKind;
-declare const index_NodeFn: typeof NodeFn;
+type index_NodeFn<T = unknown> = NodeFn<T>;
 declare const index_NodeGuard: typeof NodeGuard;
 declare const index_NodeOptions: typeof NodeOptions;
 declare const index_NodeSink: typeof NodeSink;
@@ -540,6 +584,7 @@ declare const index_RESOLVED: typeof RESOLVED;
 declare const index_RESUME: typeof RESUME;
 type index_ResettableTimer = ResettableTimer;
 declare const index_ResettableTimer: typeof ResettableTimer;
+declare const index_START: typeof START;
 declare const index_SubscribeHints: typeof SubscribeHints;
 declare const index_TEARDOWN: typeof TEARDOWN;
 declare const index_V0: typeof V0;
@@ -554,18 +599,17 @@ declare const index_cleanupResult: typeof cleanupResult;
 declare const index_createVersioning: typeof createVersioning;
 declare const index_defaultHash: typeof defaultHash;
 declare const index_derived: typeof derived;
-declare const index_describeNode: typeof describeNode;
 declare const index_downWithBatch: typeof downWithBatch;
 declare const index_dynamicNode: typeof dynamicNode;
 declare const index_effect: typeof effect;
 declare const index_isBatching: typeof isBatching;
 declare const index_isKnownMessageType: typeof isKnownMessageType;
+declare const index_isLocalOnly: typeof isLocalOnly;
 declare const index_isPhase2Message: typeof isPhase2Message;
 declare const index_isTerminalMessage: typeof isTerminalMessage;
 declare const index_isV1: typeof isV1;
 declare const index_knownMessageTypes: typeof knownMessageTypes;
 declare const index_messageTier: typeof messageTier;
-declare const index_metaSnapshot: typeof metaSnapshot;
 declare const index_monotonicNs: typeof monotonicNs;
 declare const index_node: typeof node;
 declare const index_normalizeActor: typeof normalizeActor;
@@ -579,7 +623,7 @@ declare const index_resolveDescribeFields: typeof resolveDescribeFields;
 declare const index_state: typeof state;
 declare const index_wallClockNs: typeof wallClockNs;
 declare namespace index {
-  export { index_Actor as Actor, type index_BridgeOptions as BridgeOptions, index_CLEANUP_RESULT as CLEANUP_RESULT, index_COMPLETE as COMPLETE, index_CleanupResult as CleanupResult, index_DATA as DATA, index_DEFAULT_ACTOR as DEFAULT_ACTOR, index_DEFAULT_DOWN as DEFAULT_DOWN, index_DIRTY as DIRTY, index_DescribeDetail as DescribeDetail, index_DescribeField as DescribeField, index_DescribeNodeOutput as DescribeNodeOutput, type index_DownStrategy as DownStrategy, type index_DynGet as DynGet, type index_DynamicNodeFn as DynamicNodeFn, index_DynamicNodeImpl as DynamicNodeImpl, type index_DynamicNodeOptions as DynamicNodeOptions, index_ERROR as ERROR, index_GuardAction as GuardAction, index_GuardDenied as GuardDenied, index_GuardDeniedDetails as GuardDeniedDetails, index_HashFn as HashFn, index_INVALIDATE as INVALIDATE, index_Message as Message, index_Messages as Messages, index_Node as Node, index_NodeActions as NodeActions, index_NodeDescribeKind as NodeDescribeKind, index_NodeFn as NodeFn, index_NodeGuard as NodeGuard, index_NodeOptions as NodeOptions, index_NodeSink as NodeSink, index_NodeStatus as NodeStatus, index_NodeTransportOptions as NodeTransportOptions, index_NodeVersionInfo as NodeVersionInfo, index_OnMessageHandler as OnMessageHandler, index_PAUSE as PAUSE, type index_PipeOperator as PipeOperator, index_PolicyAllow as PolicyAllow, index_PolicyDeny as PolicyDeny, index_PolicyRuleData as PolicyRuleData, index_RESOLVED as RESOLVED, index_RESUME as RESUME, index_ResettableTimer as ResettableTimer, index_SubscribeHints as SubscribeHints, index_TEARDOWN as TEARDOWN, index_V0 as V0, index_V1 as V1, index_VersioningLevel as VersioningLevel, index_VersioningOptions as VersioningOptions, index_accessHintForGuard as accessHintForGuard, index_advanceVersion as advanceVersion, index_batch as batch, index_bridge as bridge, index_cleanupResult as cleanupResult, index_createVersioning as createVersioning, index_defaultHash as defaultHash, index_derived as derived, index_describeNode as describeNode, index_downWithBatch as downWithBatch, index_dynamicNode as dynamicNode, index_effect as effect, index_isBatching as isBatching, index_isKnownMessageType as isKnownMessageType, index_isPhase2Message as isPhase2Message, index_isTerminalMessage as isTerminalMessage, index_isV1 as isV1, index_knownMessageTypes as knownMessageTypes, index_messageTier as messageTier, index_metaSnapshot as metaSnapshot, index_monotonicNs as monotonicNs, index_node as node, index_normalizeActor as normalizeActor, index_partitionForBatch as partitionForBatch, index_pipe as pipe, index_policy as policy, index_policyFromRules as policyFromRules, index_producer as producer, index_propagatesToMeta as propagatesToMeta, index_resolveDescribeFields as resolveDescribeFields, index_state as state, index_wallClockNs as wallClockNs };
+  export { index_Actor as Actor, type index_BridgeOptions as BridgeOptions, index_CLEANUP_RESULT as CLEANUP_RESULT, index_COMPLETE as COMPLETE, index_CleanupResult as CleanupResult, index_DATA as DATA, index_DEFAULT_ACTOR as DEFAULT_ACTOR, index_DEFAULT_DOWN as DEFAULT_DOWN, index_DIRTY as DIRTY, index_DescribeDetail as DescribeDetail, index_DescribeField as DescribeField, index_DescribeNodeOutput as DescribeNodeOutput, type index_DownStrategy as DownStrategy, type index_DynGet as DynGet, type index_DynamicNodeFn as DynamicNodeFn, index_DynamicNodeImpl as DynamicNodeImpl, type index_DynamicNodeOptions as DynamicNodeOptions, index_ERROR as ERROR, index_GuardAction as GuardAction, index_GuardDenied as GuardDenied, index_GuardDeniedDetails as GuardDeniedDetails, index_HashFn as HashFn, index_INVALIDATE as INVALIDATE, index_Message as Message, index_Messages as Messages, index_Node as Node, index_NodeActions as NodeActions, index_NodeDescribeKind as NodeDescribeKind, type index_NodeFn as NodeFn, index_NodeGuard as NodeGuard, index_NodeOptions as NodeOptions, index_NodeSink as NodeSink, index_NodeStatus as NodeStatus, index_NodeTransportOptions as NodeTransportOptions, index_NodeVersionInfo as NodeVersionInfo, index_OnMessageHandler as OnMessageHandler, index_PAUSE as PAUSE, type index_PipeOperator as PipeOperator, index_PolicyAllow as PolicyAllow, index_PolicyDeny as PolicyDeny, index_PolicyRuleData as PolicyRuleData, index_RESOLVED as RESOLVED, index_RESUME as RESUME, index_ResettableTimer as ResettableTimer, index_START as START, index_SubscribeHints as SubscribeHints, index_TEARDOWN as TEARDOWN, index_V0 as V0, index_V1 as V1, index_VersioningLevel as VersioningLevel, index_VersioningOptions as VersioningOptions, index_accessHintForGuard as accessHintForGuard, index_advanceVersion as advanceVersion, index_batch as batch, index_bridge as bridge, index_cleanupResult as cleanupResult, index_createVersioning as createVersioning, index_defaultHash as defaultHash, index_derived as derived, index_downWithBatch as downWithBatch, index_dynamicNode as dynamicNode, index_effect as effect, index_isBatching as isBatching, index_isKnownMessageType as isKnownMessageType, index_isLocalOnly as isLocalOnly, index_isPhase2Message as isPhase2Message, index_isTerminalMessage as isTerminalMessage, index_isV1 as isV1, index_knownMessageTypes as knownMessageTypes, index_messageTier as messageTier, index_monotonicNs as monotonicNs, index_node as node, index_normalizeActor as normalizeActor, index_partitionForBatch as partitionForBatch, index_pipe as pipe, index_policy as policy, index_policyFromRules as policyFromRules, index_producer as producer, index_propagatesToMeta as propagatesToMeta, index_resolveDescribeFields as resolveDescribeFields, index_state as state, index_wallClockNs as wallClockNs };
 }
 
-export { type BridgeOptions as B, DEFAULT_DOWN as D, type PipeOperator as P, ResettableTimer as R, type DownStrategy as a, type DynGet as b, type DynamicNodeFn as c, DynamicNodeImpl as d, type DynamicNodeOptions as e, batch as f, bridge as g, derived as h, index as i, downWithBatch as j, dynamicNode as k, effect as l, isBatching as m, monotonicNs as n, pipe as o, partitionForBatch as p, producer as q, state as s, wallClockNs as w };
+export { type BridgeOptions as B, DEFAULT_DOWN as D, type NodeFn as N, type PipeOperator as P, ResettableTimer as R, type DownStrategy as a, type DynGet as b, type DynamicNodeFn as c, DynamicNodeImpl as d, type DynamicNodeOptions as e, batch as f, bridge as g, derived as h, index as i, downWithBatch as j, dynamicNode as k, effect as l, isBatching as m, monotonicNs as n, node as o, partitionForBatch as p, pipe as q, producer as r, state as s, wallClockNs as w };

package/dist/{index-4OIX-q0C.d.cts → index-UudxGnzc.d.cts}

@@ -1,4 +1,4 @@
-import { r as GraphPersistSnapshot, G as Graph, A as AutoCheckpointAdapter, D as DescribeFilter, d as GRAPH_META_SEGMENT, e as GraphActorOptions, b as GraphAutoCheckpointHandle, c as GraphAutoCheckpointOptions, f as GraphCheckpointRecord, g as GraphDescribeOptions, h as GraphDescribeOutput, i as GraphDiagramDirection, j as GraphDiagramOptions, k as GraphDiffChange, l as GraphDiffResult, m as GraphDumpOptions, n as GraphFactoryContext, o as GraphNodeFactory, p as GraphObserveAll, q as GraphObserveOne, a as GraphOptions, s as GraphSpyHandle, t as GraphSpyOptions, u as GraphSpyTheme, v as GraphSpyThemeName, O as ObserveDetail, w as ObserveEvent, x as ObserveOptions, y as ObserveResult, R as ReachableDirection, z as ReachableOptions, T as TraceEntry, B as reachable } from './graph-fCsaaVIa.cjs';
+import { t as GraphPersistSnapshot, A as AutoCheckpointAdapter, D as DescribeFilter, f as GRAPH_META_SEGMENT, G as Graph, g as GraphActorOptions, b as GraphAutoCheckpointHandle, c as GraphAutoCheckpointOptions, h as GraphCheckpointRecord, i as GraphDescribeOptions, j as GraphDescribeOutput, k as GraphDiagramDirection, l as GraphDiagramOptions, m as GraphDiffChange, n as GraphDiffResult, o as GraphDumpOptions, p as GraphFactoryContext, q as GraphNodeFactory, r as GraphObserveAll, s as GraphObserveOne, a as GraphOptions, e as GraphProfileOptions, d as GraphProfileResult, 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, B as graphProfile, C as reachable } from './graph-KsTe57nI.cjs';
 
 /**
  * GraphCodec — pluggable serialization for graph snapshots (Phase 8.6).
@@ -178,65 +178,6 @@ declare function negotiateCodec(localPreference: readonly GraphCodec[], remoteCo
  */
 declare function replayWAL(entries: readonly WALEntry[]): GraphPersistSnapshot;
 
-/**
- * Graph profiling and inspection utilities.
- *
- * Provides per-node memory estimation, connectivity stats, and hotspot
- * detection. Non-invasive — reads from `describe()` and node internals
- * without modifying state.
- *
- * @module
- */
-
-/** Per-node profile entry. */
-interface NodeProfile {
-    /** Qualified path within the graph. */
-    path: string;
-    /** Node type (state, derived, producer, effect). */
-    type: string;
-    /** Node status (disconnected, dirty, settled, errored, completed). */
-    status: string;
-    /** Approximate retained bytes for the node's cached value. */
-    valueSizeBytes: number;
-    /** Number of downstream subscribers (sinks). */
-    subscriberCount: number;
-    /** Number of upstream dependencies. */
-    depCount: number;
-}
-/** Aggregate graph profile. */
-interface GraphProfileResult {
-    /** Total node count. */
-    nodeCount: number;
-    /** Total edge count. */
-    edgeCount: number;
-    /** Subgraph count. */
-    subgraphCount: number;
-    /** All node profiles. */
-    nodes: NodeProfile[];
-    /** Total approximate value memory across all nodes. */
-    totalValueSizeBytes: number;
-    /** Nodes sorted by valueSizeBytes descending (top N). */
-    hotspots: NodeProfile[];
-}
-/** Options for {@link graphProfile}. */
-interface GraphProfileOptions {
-    /** Limit hotspot list (default 10). */
-    topN?: number;
-    /** Include subgraph nodes recursively (default true). */
-    recursive?: boolean;
-}
-/**
- * Profile a graph's memory and connectivity characteristics.
- *
- * Uses `describe({ detail: "standard" })` for node metadata and direct
- * `NodeImpl` access for subscriber counts and cached values.
- *
- * @param graph - The graph to profile.
- * @param opts - Optional configuration.
- * @returns Aggregate profile with per-node details and hotspots.
- */
-declare function graphProfile(graph: Graph, opts?: GraphProfileOptions): GraphProfileResult;
-
 /**
  * Approximate in-memory size estimation for arbitrary JS values.
  *
@@ -287,19 +228,17 @@ declare const index_GraphObserveAll: typeof GraphObserveAll;
 declare const index_GraphObserveOne: typeof GraphObserveOne;
 declare const index_GraphOptions: typeof GraphOptions;
 declare const index_GraphPersistSnapshot: typeof GraphPersistSnapshot;
-type index_GraphProfileOptions = GraphProfileOptions;
-type index_GraphProfileResult = GraphProfileResult;
-declare const index_GraphSpyHandle: typeof GraphSpyHandle;
-declare const index_GraphSpyOptions: typeof GraphSpyOptions;
-declare const index_GraphSpyTheme: typeof GraphSpyTheme;
-declare const index_GraphSpyThemeName: typeof GraphSpyThemeName;
+declare const index_GraphProfileOptions: typeof GraphProfileOptions;
+declare const index_GraphProfileResult: typeof GraphProfileResult;
 declare const index_JsonCodec: typeof JsonCodec;
 type index_LazyGraphCodec = LazyGraphCodec;
-type index_NodeProfile = NodeProfile;
+declare const index_NodeProfile: typeof NodeProfile;
 declare const index_ObserveDetail: typeof ObserveDetail;
 declare const index_ObserveEvent: typeof ObserveEvent;
 declare const index_ObserveOptions: typeof ObserveOptions;
 declare const index_ObserveResult: typeof ObserveResult;
+declare const index_ObserveTheme: typeof ObserveTheme;
+declare const index_ObserveThemeName: typeof ObserveThemeName;
 declare const index_ReachableDirection: typeof ReachableDirection;
 declare const index_ReachableOptions: typeof ReachableOptions;
 declare const index_TraceEntry: typeof TraceEntry;
@@ -312,7 +251,7 @@ declare const index_reachable: typeof reachable;
 declare const index_replayWAL: typeof replayWAL;
 declare const index_sizeof: typeof sizeof;
 declare namespace index {
-  export { index_AutoCheckpointAdapter as AutoCheckpointAdapter, type index_DeltaCheckpoint as DeltaCheckpoint, index_DescribeFilter as DescribeFilter, type index_EvictedSubgraphInfo as EvictedSubgraphInfo, type index_EvictionPolicy as EvictionPolicy, index_GRAPH_META_SEGMENT as GRAPH_META_SEGMENT, index_Graph as Graph, index_GraphActorOptions as GraphActorOptions, index_GraphAutoCheckpointHandle as GraphAutoCheckpointHandle, index_GraphAutoCheckpointOptions as GraphAutoCheckpointOptions, index_GraphCheckpointRecord as GraphCheckpointRecord, type index_GraphCodec as GraphCodec, index_GraphDescribeOptions as GraphDescribeOptions, index_GraphDescribeOutput as GraphDescribeOutput, index_GraphDiagramDirection as GraphDiagramDirection, index_GraphDiagramOptions as GraphDiagramOptions, index_GraphDiffChange as GraphDiffChange, index_GraphDiffResult as GraphDiffResult, index_GraphDumpOptions as GraphDumpOptions, index_GraphFactoryContext as GraphFactoryContext, index_GraphNodeFactory as GraphNodeFactory, index_GraphObserveAll as GraphObserveAll, index_GraphObserveOne as GraphObserveOne, index_GraphOptions as GraphOptions, index_GraphPersistSnapshot as GraphPersistSnapshot, type index_GraphProfileOptions as GraphProfileOptions, type index_GraphProfileResult as GraphProfileResult, index_GraphSpyHandle as GraphSpyHandle, index_GraphSpyOptions as GraphSpyOptions, index_GraphSpyTheme as GraphSpyTheme, index_GraphSpyThemeName as GraphSpyThemeName, index_JsonCodec as JsonCodec, type index_LazyGraphCodec as LazyGraphCodec, type index_NodeProfile as NodeProfile, index_ObserveDetail as ObserveDetail, index_ObserveEvent as ObserveEvent, index_ObserveOptions as ObserveOptions, index_ObserveResult as ObserveResult, index_ReachableDirection as ReachableDirection, index_ReachableOptions as ReachableOptions, index_TraceEntry as TraceEntry, type index_WALEntry as WALEntry, index_createDagCborCodec as createDagCborCodec, index_createDagCborZstdCodec as createDagCborZstdCodec, index_graphProfile as graphProfile, index_negotiateCodec as negotiateCodec, index_reachable as reachable, index_replayWAL as replayWAL, index_sizeof as sizeof };
+  export { index_AutoCheckpointAdapter as AutoCheckpointAdapter, type index_DeltaCheckpoint as DeltaCheckpoint, index_DescribeFilter as DescribeFilter, type index_EvictedSubgraphInfo as EvictedSubgraphInfo, type index_EvictionPolicy as EvictionPolicy, index_GRAPH_META_SEGMENT as GRAPH_META_SEGMENT, index_Graph as Graph, index_GraphActorOptions as GraphActorOptions, index_GraphAutoCheckpointHandle as GraphAutoCheckpointHandle, index_GraphAutoCheckpointOptions as GraphAutoCheckpointOptions, index_GraphCheckpointRecord as GraphCheckpointRecord, type index_GraphCodec as GraphCodec, index_GraphDescribeOptions as GraphDescribeOptions, index_GraphDescribeOutput as GraphDescribeOutput, index_GraphDiagramDirection as GraphDiagramDirection, index_GraphDiagramOptions as GraphDiagramOptions, index_GraphDiffChange as GraphDiffChange, index_GraphDiffResult as GraphDiffResult, index_GraphDumpOptions as GraphDumpOptions, index_GraphFactoryContext as GraphFactoryContext, index_GraphNodeFactory as GraphNodeFactory, index_GraphObserveAll as GraphObserveAll, index_GraphObserveOne as GraphObserveOne, index_GraphOptions as GraphOptions, index_GraphPersistSnapshot as GraphPersistSnapshot, index_GraphProfileOptions as GraphProfileOptions, index_GraphProfileResult as GraphProfileResult, index_JsonCodec as JsonCodec, type index_LazyGraphCodec as LazyGraphCodec, index_NodeProfile as NodeProfile, index_ObserveDetail as ObserveDetail, index_ObserveEvent as ObserveEvent, index_ObserveOptions as ObserveOptions, index_ObserveResult as ObserveResult, index_ObserveTheme as ObserveTheme, index_ObserveThemeName as ObserveThemeName, index_ReachableDirection as ReachableDirection, index_ReachableOptions as ReachableOptions, index_TraceEntry as TraceEntry, type index_WALEntry as WALEntry, index_createDagCborCodec as createDagCborCodec, index_createDagCborZstdCodec as createDagCborZstdCodec, index_graphProfile as graphProfile, index_negotiateCodec as negotiateCodec, index_reachable as reachable, index_replayWAL as replayWAL, index_sizeof as sizeof };
 }
 
-export { type DeltaCheckpoint as D, type EvictedSubgraphInfo as E, type GraphProfileResult as G, JsonCodec as J, type LazyGraphCodec as L, type NodeProfile as N, type WALEntry as W, type GraphProfileOptions as a, type EvictionPolicy as b, type GraphCodec as c, createDagCborCodec as d, createDagCborZstdCodec as e, graphProfile as g, index as i, negotiateCodec as n, replayWAL as r, sizeof as s };
+export { type DeltaCheckpoint as D, type EvictedSubgraphInfo as E, type GraphCodec as G, JsonCodec as J, type LazyGraphCodec as L, type WALEntry as W, type EvictionPolicy as a, createDagCborZstdCodec as b, createDagCborCodec as c, index as i, negotiateCodec as n, replayWAL as r, sizeof as s };

package/dist/{index-DlGMf_Qe.d.cts → index-VHA43cGP.d.cts}

@@ -1,5 +1,5 @@
-import { N as Node } from './meta-BV4pj9ML.cjs';
-import { G as Graph } from './graph-fCsaaVIa.cjs';
+import { N as Node } from './meta-BnG7XAaE.cjs';
+import { G as Graph } from './graph-KsTe57nI.cjs';
 
 /** Pluggable measurement backend. */
 interface MeasurementAdapter {