@graphrefly/graphrefly 0.9.0 → 0.11.0

package/dist/{chunk-WYI7YW54.js → chunk-2OTXEZQO.js}

@@ -1,7 +1,7 @@
 import {
   describeNode,
   resolveDescribeFields
-} from "./chunk-LR2CLSEF.js";
+} from "./chunk-OHUECHWY.js";
 import {
   COMPLETE,
   DATA,
@@ -16,7 +16,7 @@ import {
   messageTier,
   monotonicNs,
   state
-} from "./chunk-QTZSBQGJ.js";
+} from "./chunk-UG2QZMRN.js";
 
 // src/graph/graph.ts
 var PATH_SEP = "::";
@@ -1902,4 +1902,4 @@ export {
   Graph,
   reachable
 };
-//# sourceMappingURL=chunk-WYI7YW54.js.map
+//# sourceMappingURL=chunk-2OTXEZQO.js.map

package/dist/{chunk-TZLX4KIT.js → chunk-2VHNCFGG.js}

@@ -32,7 +32,7 @@ import {
   toArray,
   toMessages$,
   toObservable
-} from "./chunk-YWTP2XRJ.js";
+} from "./chunk-5WXTWOD7.js";
 import {
   ResettableTimer
 } from "./chunk-WZ2Z2CRV.js";
@@ -59,7 +59,7 @@ import {
   producer,
   state,
   wallClockNs
-} from "./chunk-QTZSBQGJ.js";
+} from "./chunk-UG2QZMRN.js";
 
 // src/extra/index.ts
 var extra_exports = {};
@@ -6265,4 +6265,4 @@ export {
   workerSelf,
   extra_exports
 };
-//# sourceMappingURL=chunk-TZLX4KIT.js.map
+//# sourceMappingURL=chunk-2VHNCFGG.js.map

package/dist/{chunk-XCZPGOVP.js → chunk-3WACHRHV.js}

@@ -1,6 +1,6 @@
 import {
   Graph
-} from "./chunk-WYI7YW54.js";
+} from "./chunk-2OTXEZQO.js";
 import {
   DATA,
   INVALIDATE,
@@ -10,7 +10,7 @@ import {
   emitWithBatch,
   monotonicNs,
   state
-} from "./chunk-QTZSBQGJ.js";
+} from "./chunk-UG2QZMRN.js";
 
 // src/patterns/reactive-layout/index.ts
 var reactive_layout_exports = {};
@@ -1094,4 +1094,4 @@ export {
   reactiveBlockLayout,
   reactive_layout_exports
 };
-//# sourceMappingURL=chunk-XCZPGOVP.js.map
+//# sourceMappingURL=chunk-3WACHRHV.js.map

package/dist/{chunk-YWTP2XRJ.js → chunk-5WXTWOD7.js}

@@ -11,7 +11,7 @@ import {
   producer,
   state,
   wallClockNs
-} from "./chunk-QTZSBQGJ.js";
+} from "./chunk-UG2QZMRN.js";
 
 // src/extra/observable.ts
 import { Observable } from "rxjs";
@@ -778,4 +778,4 @@ export {
   reactiveLog,
   logSlice
 };
-//# sourceMappingURL=chunk-YWTP2XRJ.js.map
+//# sourceMappingURL=chunk-5WXTWOD7.js.map

package/dist/{chunk-E7OH6ZAZ.js → chunk-FMVFRP7L.js}

@@ -5,8 +5,9 @@ import {
   describeNode,
   metaSnapshot,
   resolveDescribeFields
-} from "./chunk-LR2CLSEF.js";
+} from "./chunk-OHUECHWY.js";
 import {
+  CLEANUP_RESULT,
   COMPLETE,
   DATA,
   DEFAULT_ACTOR,
@@ -23,6 +24,7 @@ import {
   accessHintForGuard,
   advanceVersion,
   batch,
+  cleanupResult,
   createVersioning,
   defaultHash,
   derived,
@@ -47,14 +49,16 @@ import {
   propagatesToMeta,
   state,
   wallClockNs
-} from "./chunk-QTZSBQGJ.js";
+} from "./chunk-UG2QZMRN.js";
 
 // src/core/index.ts
 var core_exports = {};
 __export(core_exports, {
+  CLEANUP_RESULT: () => CLEANUP_RESULT,
   COMPLETE: () => COMPLETE,
   DATA: () => DATA,
   DEFAULT_ACTOR: () => DEFAULT_ACTOR,
+  DEFAULT_DOWN: () => DEFAULT_DOWN,
   DIRTY: () => DIRTY,
   DynamicNodeImpl: () => DynamicNodeImpl,
   ERROR: () => ERROR,
@@ -68,6 +72,8 @@ __export(core_exports, {
   accessHintForGuard: () => accessHintForGuard,
   advanceVersion: () => advanceVersion,
   batch: () => batch,
+  bridge: () => bridge,
+  cleanupResult: () => cleanupResult,
   createVersioning: () => createVersioning,
   defaultHash: () => defaultHash,
   derived: () => derived,
@@ -97,7 +103,60 @@ __export(core_exports, {
   wallClockNs: () => wallClockNs
 });
 
+// src/core/bridge.ts
+var DEFAULT_DOWN = [
+  DATA,
+  DIRTY,
+  RESOLVED,
+  COMPLETE,
+  ERROR,
+  TEARDOWN,
+  PAUSE,
+  RESUME,
+  INVALIDATE
+];
+var STANDARD_TYPES = /* @__PURE__ */ new Set([
+  DATA,
+  DIRTY,
+  RESOLVED,
+  COMPLETE,
+  ERROR,
+  TEARDOWN,
+  PAUSE,
+  RESUME,
+  INVALIDATE
+]);
+function bridge(from, to, opts) {
+  const allowedDown = new Set(opts?.down ?? DEFAULT_DOWN);
+  const onMessage = (msg, _depIndex, _actions) => {
+    const type = msg[0];
+    if (!STANDARD_TYPES.has(type)) {
+      to.down([msg]);
+      return true;
+    }
+    if (type === COMPLETE || type === ERROR) {
+      if (allowedDown.has(type)) {
+        to.down([msg]);
+      }
+      return false;
+    }
+    if (!allowedDown.has(type)) {
+      return true;
+    }
+    to.down([msg]);
+    return true;
+  };
+  return node([from], void 0, {
+    name: opts?.name,
+    describeKind: "effect",
+    onMessage,
+    meta: { _internal: true }
+  });
+}
+
 export {
+  DEFAULT_DOWN,
+  bridge,
   core_exports
 };
-//# sourceMappingURL=chunk-E7OH6ZAZ.js.map
+//# sourceMappingURL=chunk-FMVFRP7L.js.map

package/dist/chunk-FMVFRP7L.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/index.ts","../src/core/bridge.ts"],"sourcesContent":["/**\n * Core layer: message protocol, node primitive, lifecycle (Phase 0).\n */\nexport * from \"./actor.js\";\nexport * from \"./batch.js\";\nexport { type BridgeOptions, bridge, DEFAULT_DOWN } from \"./bridge.js\";\nexport { monotonicNs, wallClockNs } from \"./clock.js\";\nexport * from \"./dynamic-node.js\";\nexport * from \"./guard.js\";\nexport * from \"./messages.js\";\nexport * from \"./meta.js\";\nexport {\n\tCLEANUP_RESULT,\n\ttype CleanupResult,\n\tcleanupResult,\n\ttype Node,\n\ttype NodeActions,\n\ttype NodeDescribeKind,\n\ttype NodeFn,\n\ttype NodeOptions,\n\ttype NodeSink,\n\ttype NodeStatus,\n\ttype NodeTransportOptions,\n\tnode,\n\ttype OnMessageHandler,\n\ttype SubscribeHints,\n} from \"./node.js\";\nexport * from \"./sugar.js\";\nexport { ResettableTimer } from \"./timer.js\";\nexport {\n\tadvanceVersion,\n\tcreateVersioning,\n\tdefaultHash,\n\ttype HashFn,\n\tisV1,\n\ttype NodeVersionInfo,\n\ttype V0,\n\ttype V1,\n\ttype VersioningLevel,\n\ttype VersioningOptions,\n} from \"./versioning.js\";\n","/**\n * bridge — graph-visible message forwarding between two nodes.\n *\n * Replaces ad-hoc `subscribe()` bridges that bypass graph topology.\n * The returned node is an effect that intercepts messages from `from`\n * and forwards them to `to.down()`. Register it with `graph.add()` to\n * make the bridge visible in `describe()` and `snapshot()`.\n *\n * **Upstream path:** The bridge node has `from` as its dep, so anything\n * downstream of the bridge that calls `up()` naturally reaches `from`.\n * If `to` is used as a dep by other nodes and those nodes send `up()`,\n * the messages reach `to`'s deps (not `from`). For full upstream relay\n * across the bridge boundary, wire the bridge as a dep of `to`'s\n * consumers or use `graph.connect()`.\n *\n * **ABAC / guards:** `to.down()` is called without `NodeTransportOptions`,\n * so any ABAC guard on `to` receives `actor = undefined`. Upstream (`up()`)\n * messages propagate through the dep chain the same way — no actor is\n * injected on either path. Both paths are intentionally unguarded; if `to`\n * requires a specific actor, provide a guarded wrapper node and bridge to\n * that instead.\n *\n * **Default forwarding:** All standard message types are forwarded by\n * default, including TEARDOWN, PAUSE, RESUME, and INVALIDATE. Use the\n * `down` option to restrict which types are forwarded. Callers that need\n * to exclude TEARDOWN (e.g. inter-stage wiring in `funnel()`) pass an\n * explicit `down` array without TEARDOWN.\n *\n * @module\n */\n\nimport {\n\tCOMPLETE,\n\tDATA,\n\tDIRTY,\n\tERROR,\n\tINVALIDATE,\n\ttype Message,\n\tPAUSE,\n\tRESOLVED,\n\tRESUME,\n\tTEARDOWN,\n} from \"./messages.js\";\nimport { type Node, type NodeActions, node, type OnMessageHandler } from \"./node.js\";\n\n/** Options for {@link bridge}. */\nexport type BridgeOptions = {\n\t/** Node name (for graph registration / describe). */\n\tname?: string;\n\t/**\n\t * Standard message types to forward downstream. Default: all standard\n\t * types. Unknown (non-standard) types always forward per spec §1.3.6\n\t * regardless of this option.\n\t */\n\tdown?: readonly symbol[];\n};\n\n/** All standard types forwarded by default. Export for callers that\n *  need to customize (e.g. exclude TEARDOWN). */\nexport const DEFAULT_DOWN: readonly symbol[] = [\n\tDATA,\n\tDIRTY,\n\tRESOLVED,\n\tCOMPLETE,\n\tERROR,\n\tTEARDOWN,\n\tPAUSE,\n\tRESUME,\n\tINVALIDATE,\n];\n\n/**\n * All standard message types the bridge understands. Types outside this set\n * are \"unknown\" and must always be forwarded (spec §1.3.6).\n */\nconst STANDARD_TYPES = new Set<symbol>([\n\tDATA,\n\tDIRTY,\n\tRESOLVED,\n\tCOMPLETE,\n\tERROR,\n\tTEARDOWN,\n\tPAUSE,\n\tRESUME,\n\tINVALIDATE,\n]);\n\n/**\n * Create a graph-visible bridge node that forwards messages from `from` to `to`.\n *\n * The bridge is a real node (effect) — it shows up in `describe()`, participates\n * in two-phase push, and cleans up on TEARDOWN. Register it via `graph.add()`\n * to make it part of the graph topology.\n *\n * **Unknown message types** (custom domain signals not in the standard protocol\n * set) are always forwarded to `to`, regardless of the `down` option. This\n * satisfies spec §1.3.6 (\"unknown types forward unchanged\").\n *\n * **COMPLETE / ERROR**: when forwarded, the bridge also transitions to terminal\n * state so graph-wide completion detection works correctly.\n *\n * @param from - Source node to observe.\n * @param to - Target node to forward messages to via `to.down()`.\n * @param opts - Optional configuration.\n * @returns A bridge effect node. Add it to a graph with `graph.add(name, bridge(...))`.\n *\n * @example\n * ```ts\n * import { bridge, state } from \"@graphrefly/graphrefly-ts\";\n *\n * const a = state(0);\n * const b = state(0);\n * const br = bridge(a, b, { name: \"__bridge_a_b\" });\n * graph.add(\"__bridge_a_b\", br);\n * // Now a's messages flow to b, visible in describe()\n * ```\n *\n * @category core\n */\nexport function bridge<T = unknown>(from: Node<T>, to: Node, opts?: BridgeOptions): Node<unknown> {\n\tconst allowedDown = new Set(opts?.down ?? DEFAULT_DOWN);\n\n\tconst onMessage: OnMessageHandler = (\n\t\tmsg: Message,\n\t\t_depIndex: number,\n\t\t_actions: NodeActions,\n\t): boolean => {\n\t\tconst type = msg[0];\n\n\t\t// Unknown types (custom domain signals) always forward — spec §1.3.6.\n\t\tif (!STANDARD_TYPES.has(type)) {\n\t\t\tto.down([msg]);\n\t\t\treturn true;\n\t\t}\n\n\t\t// Terminal types: always transition the bridge to terminal state\n\t\t// (return false → default dispatch). Only forward to `to` if allowed.\n\t\tif (type === COMPLETE || type === ERROR) {\n\t\t\tif (allowedDown.has(type)) {\n\t\t\t\tto.down([msg]);\n\t\t\t}\n\t\t\treturn false;\n\t\t}\n\n\t\t// Known type, not in allowedDown — consume without forwarding.\n\t\tif (!allowedDown.has(type)) {\n\t\t\treturn true;\n\t\t}\n\n\t\t// Forward the message to the target.\n\t\tto.down([msg]);\n\t\treturn true;\n\t};\n\n\treturn node([from as Node], undefined, {\n\t\tname: opts?.name,\n\t\tdescribeKind: \"effect\",\n\t\tonMessage,\n\t\tmeta: { _internal: true },\n\t});\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC2DO,IAAM,eAAkC;AAAA,EAC9C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACD;AAMA,IAAM,iBAAiB,oBAAI,IAAY;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACD,CAAC;AAkCM,SAAS,OAAoB,MAAe,IAAU,MAAqC;AACjG,QAAM,cAAc,IAAI,IAAI,MAAM,QAAQ,YAAY;AAEtD,QAAM,YAA8B,CACnC,KACA,WACA,aACa;AACb,UAAM,OAAO,IAAI,CAAC;AAGlB,QAAI,CAAC,eAAe,IAAI,IAAI,GAAG;AAC9B,SAAG,KAAK,CAAC,GAAG,CAAC;AACb,aAAO;AAAA,IACR;AAIA,QAAI,SAAS,YAAY,SAAS,OAAO;AACxC,UAAI,YAAY,IAAI,IAAI,GAAG;AAC1B,WAAG,KAAK,CAAC,GAAG,CAAC;AAAA,MACd;AACA,aAAO;AAAA,IACR;AAGA,QAAI,CAAC,YAAY,IAAI,IAAI,GAAG;AAC3B,aAAO;AAAA,IACR;AAGA,OAAG,KAAK,CAAC,GAAG,CAAC;AACb,WAAO;AAAA,EACR;AAEA,SAAO,KAAK,CAAC,IAAY,GAAG,QAAW;AAAA,IACtC,MAAM,MAAM;AAAA,IACZ,cAAc;AAAA,IACd;AAAA,IACA,MAAM,EAAE,WAAW,KAAK;AAAA,EACzB,CAAC;AACF;","names":[]}

package/dist/{chunk-LR2CLSEF.js → chunk-OHUECHWY.js}

@@ -2,7 +2,7 @@ import {
   DynamicNodeImpl,
   NodeImpl,
   accessHintForGuard
-} from "./chunk-QTZSBQGJ.js";
+} from "./chunk-UG2QZMRN.js";
 
 // src/core/meta.ts
 function resolveDescribeFields(detail, fields) {
@@ -13,7 +13,6 @@ function resolveDescribeFields(detail, fields) {
     case "full":
       return null;
     // null = include everything
-    case "minimal":
     default:
       return /* @__PURE__ */ new Set(["type", "deps"]);
   }
@@ -103,4 +102,4 @@ export {
   metaSnapshot,
   describeNode
 };
-//# sourceMappingURL=chunk-LR2CLSEF.js.map
+//# sourceMappingURL=chunk-OHUECHWY.js.map

package/dist/chunk-OHUECHWY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/meta.ts"],"sourcesContent":["import type { Actor } from \"./actor.js\";\nimport { DynamicNodeImpl } from \"./dynamic-node.js\";\nimport { accessHintForGuard } from \"./guard.js\";\nimport { type Node, NodeImpl } from \"./node.js\";\n\n/** JSON-shaped slice of a node for Phase 1 `Graph.describe()` (GRAPHREFLY-SPEC §3.6, Appendix B). */\nexport type DescribeNodeOutput = {\n\ttype: \"state\" | \"derived\" | \"producer\" | \"operator\" | \"effect\";\n\tstatus?: Node[\"status\"];\n\tdeps: string[];\n\tmeta?: Record<string, unknown>;\n\tname?: string;\n\tvalue?: unknown;\n\t/** Node versioning info (GRAPHREFLY-SPEC §7). Present only when versioning is enabled. */\n\tv?: { id: string; version: number; cid?: string; prev?: string | null };\n\t/** Guard info (full detail). */\n\tguard?: string;\n\t/** Last mutation attribution (full detail). */\n\tlastMutation?: Readonly<{ actor: Actor; timestamp_ns: number }>;\n};\n\n/**\n * Detail level for `describe()` progressive disclosure (Phase 3.3b).\n * - `\"minimal\"` — type + deps only (default). LLM-friendly.\n * - `\"standard\"` — type, status, value, deps, meta, versioning (`v`).\n * - `\"full\"` — standard + guard, lastMutation.\n */\nexport type DescribeDetail = \"minimal\" | \"standard\" | \"full\";\n\n/**\n * Valid field names for `describe({ fields: [...] })` (Phase 3.3b).\n * Dotted paths like `\"meta.label\"` select specific meta keys.\n */\nexport type DescribeField =\n\t| \"type\"\n\t| \"status\"\n\t| \"value\"\n\t| \"deps\"\n\t| \"meta\"\n\t| \"v\"\n\t| \"guard\"\n\t| \"lastMutation\"\n\t| `meta.${string}`;\n\n/** Resolve which fields to include based on detail level or explicit field list. */\nexport function resolveDescribeFields(\n\tdetail?: DescribeDetail,\n\tfields?: readonly DescribeField[],\n): Set<string> | null {\n\t// Explicit fields override detail level\n\tif (fields != null && fields.length > 0) return new Set(fields);\n\tswitch (detail) {\n\t\tcase \"standard\":\n\t\t\treturn new Set([\"type\", \"status\", \"value\", \"deps\", \"meta\", \"v\"]);\n\t\tcase \"full\":\n\t\t\treturn null; // null = include everything\n\t\tdefault:\n\t\t\treturn new Set([\"type\", \"deps\"]);\n\t}\n}\n\nfunction inferDescribeType(n: NodeImpl): DescribeNodeOutput[\"type\"] {\n\tif (n._describeKind != null) return n._describeKind;\n\tif (!n._hasDeps) return n._fn != null ? \"producer\" : \"state\";\n\tif (n._fn == null) return \"derived\";\n\tif (n._manualEmitUsed) return \"operator\";\n\treturn \"derived\";\n}\n\n/**\n * Reads the current cached value of every companion meta field on a node,\n * suitable for merging into `describe()`-style JSON (GRAPHREFLY-SPEC §2.3, §3.6).\n *\n * @remarks\n * Values come from {@link Node.get}, which returns the **last settled** cache.\n * If a meta field is in `\"dirty\"` status (DIRTY received, DATA pending), the\n * snapshot contains the *previous* value — check `node.meta[key].status` when\n * freshness matters. Avoid calling mid-batch for the same reason.\n *\n * Meta nodes are **not** terminated when their parent receives COMPLETE or\n * ERROR — they remain writable so callers can record post-mortem metadata\n * (e.g. `meta.error`). They *are* torn down when the parent receives TEARDOWN.\n *\n * @param node - The node whose meta fields to snapshot.\n * @returns Plain object of `{ key: value }` pairs (empty if no meta defined).\n * Keys whose companion node's {@link Node.get} throws are omitted.\n *\n * @example\n * ```ts\n * import { core } from \"@graphrefly/graphrefly-ts\";\n *\n * const n = core.node({ initial: 0, meta: { tag: \"a\" } });\n * core.metaSnapshot(n); // { tag: \"a\" }\n * ```\n */\nexport function metaSnapshot(node: Node): Record<string, unknown> {\n\tconst out: Record<string, unknown> = {};\n\tfor (const [key, child] of Object.entries(node.meta)) {\n\t\ttry {\n\t\t\tout[key] = child.get();\n\t\t} catch {\n\t\t\t/* omit key — describe tooling still gets other fields */\n\t\t}\n\t}\n\treturn out;\n}\n\n/**\n * Builds a single-node slice of `Graph.describe()` JSON (structure + `meta` snapshot).\n * Parity with graphrefly-py `describe_node`.\n *\n * `type` is inferred from factory configuration, optional `describeKind` in node options,\n * and the last `manualEmitUsed` hint (operator vs derived). {@link effect} sets\n * `describeKind: \"effect\"`. Nodes not created by {@link node} fall back to `type: \"state\"` and empty `deps`.\n *\n * @param node - Any `Node` to introspect.\n * @returns `DescribeNodeOutput` suitable for merging into graph describe maps.\n *\n * @example\n * ```ts\n * import { describeNode, state } from \"@graphrefly/graphrefly-ts\";\n *\n * describeNode(state(0));\n * ```\n */\n/**\n * Builds a single-node slice for `Graph.describe()`.\n *\n * @param node - Node to introspect.\n * @param includeFields - Set of fields to include, or `null` for all. When omitted, all fields are included (legacy behavior).\n */\nexport function describeNode(node: Node, includeFields?: Set<string> | null): DescribeNodeOutput {\n\tconst all = includeFields == null; // null or undefined → include everything\n\n\t// Specific meta keys requested via dotted paths (e.g. \"meta.label\")\n\tconst metaKeys: string[] | null =\n\t\t!all && includeFields != null\n\t\t\t? [...includeFields].filter((f) => f.startsWith(\"meta.\")).map((f) => f.slice(5))\n\t\t\t: null;\n\tconst wantsMeta = all || includeFields!.has(\"meta\") || (metaKeys != null && metaKeys.length > 0);\n\n\tlet type: DescribeNodeOutput[\"type\"] = \"state\";\n\tlet deps: string[] = [];\n\n\tif (node instanceof NodeImpl) {\n\t\ttype = inferDescribeType(node);\n\t\tdeps = node._deps.map((d) => d.name ?? \"\");\n\t} else if (node instanceof DynamicNodeImpl) {\n\t\ttype = node._describeKind ?? \"derived\";\n\t\tdeps = [];\n\t}\n\n\tconst out: DescribeNodeOutput = { type, deps };\n\n\t// status\n\tif (all || includeFields!.has(\"status\")) {\n\t\tout.status = node.status;\n\t}\n\n\t// Resolve guard once — used by both meta.access hint and standalone guard field\n\tconst guard =\n\t\t(node instanceof NodeImpl && node._guard) ||\n\t\t(node instanceof DynamicNodeImpl && node._guard) ||\n\t\tundefined;\n\n\t// meta\n\tif (wantsMeta) {\n\t\tconst rawMeta: Record<string, unknown> = { ...metaSnapshot(node) };\n\t\tif (guard != null && rawMeta.access === undefined) {\n\t\t\trawMeta.access = accessHintForGuard(guard);\n\t\t}\n\n\t\tif (metaKeys != null && metaKeys.length > 0 && !includeFields!.has(\"meta\")) {\n\t\t\t// Only specific meta keys\n\t\t\tconst filtered: Record<string, unknown> = {};\n\t\t\tfor (const k of metaKeys) {\n\t\t\t\tif (k in rawMeta) filtered[k] = rawMeta[k];\n\t\t\t}\n\t\t\tout.meta = filtered;\n\t\t} else {\n\t\t\tout.meta = rawMeta;\n\t\t}\n\t}\n\n\t// name (always include when present — it's identity, not detail)\n\tif (node.name != null) {\n\t\tout.name = node.name;\n\t}\n\n\t// value\n\tif (all || includeFields!.has(\"value\")) {\n\t\ttry {\n\t\t\tout.value = node.get();\n\t\t} catch {\n\t\t\t/* omit value */\n\t\t}\n\t}\n\n\t// Versioning (GRAPHREFLY-SPEC §7)\n\tif ((all || includeFields!.has(\"v\")) && node.v != null) {\n\t\tconst vInfo: DescribeNodeOutput[\"v\"] = { id: node.v.id, version: node.v.version };\n\t\tif (\"cid\" in node.v) {\n\t\t\tvInfo!.cid = (node.v as { cid: string }).cid;\n\t\t\tvInfo!.prev = (node.v as { prev: string | null }).prev;\n\t\t}\n\t\tout.v = vInfo;\n\t}\n\n\t// Guard info (full detail)\n\tif (all || includeFields!.has(\"guard\")) {\n\t\tif (guard != null) {\n\t\t\tout.guard = accessHintForGuard(guard);\n\t\t}\n\t}\n\n\t// Last mutation attribution (full detail)\n\tif (all || includeFields!.has(\"lastMutation\")) {\n\t\tif (node.lastMutation != null) {\n\t\t\tout.lastMutation = node.lastMutation;\n\t\t}\n\t}\n\n\treturn out;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-UCW3VWMN.js → chunk-PZCDQD2U.js}

@@ -7,10 +7,10 @@ import {
   reactiveLog,
   toMessages$,
   toObservable
-} from "./chunk-YWTP2XRJ.js";
+} from "./chunk-5WXTWOD7.js";
 import {
   Graph
-} from "./chunk-WYI7YW54.js";
+} from "./chunk-2OTXEZQO.js";
 import {
   COMPLETE,
   DATA,
@@ -28,7 +28,7 @@ import {
   policy,
   state,
   wallClockNs
-} from "./chunk-QTZSBQGJ.js";
+} from "./chunk-UG2QZMRN.js";
 
 // src/compat/nestjs/index.ts
 var nestjs_exports = {};
@@ -1369,4 +1369,4 @@ export {
   GraphReflyModule,
   nestjs_exports
 };
-//# sourceMappingURL=chunk-UCW3VWMN.js.map
+//# sourceMappingURL=chunk-PZCDQD2U.js.map

package/dist/{chunk-A2AJJOSJ.js → chunk-U5HFZGAQ.js}

@@ -2,10 +2,10 @@ import {
   GRAPH_META_SEGMENT,
   Graph,
   reachable
-} from "./chunk-WYI7YW54.js";
+} from "./chunk-2OTXEZQO.js";
 import {
   __export
-} from "./chunk-QTZSBQGJ.js";
+} from "./chunk-UG2QZMRN.js";
 
 // src/graph/index.ts
 var graph_exports = {};
@@ -104,4 +104,4 @@ export {
   replayWAL,
   graph_exports
 };
-//# sourceMappingURL=chunk-A2AJJOSJ.js.map
+//# sourceMappingURL=chunk-U5HFZGAQ.js.map

package/dist/{chunk-QTZSBQGJ.js → chunk-UG2QZMRN.js}

@@ -454,6 +454,7 @@ function isV1(info) {
 
 // src/core/node.ts
 var NO_VALUE = /* @__PURE__ */ Symbol.for("graphrefly/NO_VALUE");
+var CLEANUP_RESULT = /* @__PURE__ */ Symbol.for("graphrefly/CLEANUP_RESULT");
 function createIntBitSet() {
   let bits = 0;
   return {
@@ -516,6 +517,12 @@ function createBitSet(size) {
 }
 var isNodeArray = (value) => Array.isArray(value);
 var isNodeOptions = (value) => typeof value === "object" && value != null && !Array.isArray(value);
+function cleanupResult(cleanup, ...args) {
+  const r = { [CLEANUP_RESULT]: true, cleanup };
+  if (args.length > 0) r.value = args[0];
+  return r;
+}
+var isCleanupResult = (value) => typeof value === "object" && value !== null && CLEANUP_RESULT in value;
 var isCleanupFn = (value) => typeof value === "function";
 var statusAfterMessage = (status, msg) => {
   const t = msg[0];
@@ -931,6 +938,14 @@ var NodeImpl = class {
       this._lastDepValues = depValues;
       this._inspectorHook?.({ kind: "run", depValues });
       const out = this._fn(depValues, this._actions);
+      if (isCleanupResult(out)) {
+        this._cleanup = out.cleanup;
+        if (this._manualEmitUsed) return;
+        if ("value" in out) {
+          this._emitAutoValue(out.value);
+        }
+        return;
+      }
       if (isCleanupFn(out)) {
         this._cleanup = out;
         return;
@@ -1617,6 +1632,8 @@ export {
   createVersioning,
   advanceVersion,
   isV1,
+  CLEANUP_RESULT,
+  cleanupResult,
   NodeImpl,
   node,
   dynamicNode,
@@ -1627,4 +1644,4 @@ export {
   effect,
   pipe
 };
-//# sourceMappingURL=chunk-QTZSBQGJ.js.map
+//# sourceMappingURL=chunk-UG2QZMRN.js.map