@graphrefly/graphrefly 0.16.0 → 0.18.0

package/dist/{meta-BV4pj9ML.d.cts → meta-npl5b97j.d.cts}

@@ -616,57 +616,5 @@ type DescribeDetail = "minimal" | "standard" | "full";
 type DescribeField = "type" | "status" | "value" | "deps" | "meta" | "v" | "guard" | "lastMutation" | `meta.${string}`;
 /** Resolve which fields to include based on detail level or explicit field list. */
 declare function resolveDescribeFields(detail?: DescribeDetail, fields?: readonly DescribeField[]): Set<string> | null;
-/**
- * Reads the current cached value of every companion meta field on a node,
- * suitable for merging into `describe()`-style JSON (GRAPHREFLY-SPEC §2.3, §3.6).
- *
- * @remarks
- * Values come from {@link Node.get}, which returns the **last settled** cache.
- * If a meta field is in `"dirty"` status (DIRTY received, DATA pending), the
- * snapshot contains the *previous* value — check `node.meta[key].status` when
- * freshness matters. Avoid calling mid-batch for the same reason.
- *
- * Meta nodes are **not** terminated when their parent receives COMPLETE or
- * ERROR — they remain writable so callers can record post-mortem metadata
- * (e.g. `meta.error`). They *are* torn down when the parent receives TEARDOWN.
- *
- * @param node - The node whose meta fields to snapshot.
- * @returns Plain object of `{ key: value }` pairs (empty if no meta defined).
- * Keys whose companion node's {@link Node.get} throws are omitted.
- *
- * @example
- * ```ts
- * import { core } from "@graphrefly/graphrefly-ts";
- *
- * const n = core.node({ initial: 0, meta: { tag: "a" } });
- * core.metaSnapshot(n); // { tag: "a" }
- * ```
- */
-declare function metaSnapshot(node: Node): Record<string, unknown>;
-/**
- * Builds a single-node slice of `Graph.describe()` JSON (structure + `meta` snapshot).
- * Parity with graphrefly-py `describe_node`.
- *
- * `type` is inferred from factory configuration, optional `describeKind` in node options,
- * and the last `manualEmitUsed` hint (operator vs derived). {@link effect} sets
- * `describeKind: "effect"`. Nodes not created by {@link node} fall back to `type: "state"` and empty `deps`.
- *
- * @param node - Any `Node` to introspect.
- * @returns `DescribeNodeOutput` suitable for merging into graph describe maps.
- *
- * @example
- * ```ts
- * import { describeNode, state } from "@graphrefly/graphrefly-ts";
- *
- * describeNode(state(0));
- * ```
- */
-/**
- * Builds a single-node slice for `Graph.describe()`.
- *
- * @param node - Node to introspect.
- * @param includeFields - Set of fields to include, or `null` for all. When omitted, all fields are included (legacy behavior).
- */
-declare function describeNode(node: Node, includeFields?: Set<string> | null): DescribeNodeOutput;
 
-export { metaSnapshot as $, type Actor as A, accessHintForGuard as B, CLEANUP_RESULT as C, DATA as D, ERROR as E, advanceVersion as F, type GuardAction as G, type HashFn as H, INVALIDATE as I, cleanupResult as J, createVersioning as K, defaultHash as L, type Message as M, type Node as N, type OnMessageHandler as O, PAUSE as P, describeNode as Q, RESOLVED as R, type SubscribeHints as S, TEARDOWN as T, isKnownMessageType as U, type V0 as V, isPhase2Message as W, isTerminalMessage as X, isV1 as Y, knownMessageTypes as Z, messageTier as _, type NodeOptions as a, node as a0, normalizeActor as a1, policy as a2, policyFromRules as a3, propagatesToMeta as a4, resolveDescribeFields as a5, type NodeInspectorHook as a6, type NodeActions as b, type NodeFn as c, COMPLETE as d, type CleanupResult as e, DEFAULT_ACTOR as f, DIRTY as g, type DescribeDetail as h, type DescribeField as i, type DescribeNodeOutput as j, GuardDenied as k, type GuardDeniedDetails as l, type Messages as m, type NodeDescribeKind as n, type NodeGuard as o, type NodeSink as p, type NodeStatus as q, type NodeTransportOptions as r, type NodeVersionInfo as s, type PolicyAllow as t, type PolicyDeny as u, type PolicyRuleData as v, RESUME as w, type V1 as x, type VersioningLevel as y, type VersioningOptions as z };
+export { normalizeActor as $, type Actor as A, accessHintForGuard as B, CLEANUP_RESULT as C, DATA as D, ERROR as E, advanceVersion as F, type GuardAction as G, type HashFn as H, INVALIDATE as I, cleanupResult as J, createVersioning as K, defaultHash as L, type Message as M, type Node as N, type OnMessageHandler as O, PAUSE as P, isKnownMessageType as Q, RESOLVED as R, type SubscribeHints as S, TEARDOWN as T, isPhase2Message as U, type V0 as V, isTerminalMessage as W, isV1 as X, knownMessageTypes as Y, messageTier as Z, node as _, type NodeOptions as a, policy as a0, policyFromRules as a1, propagatesToMeta as a2, resolveDescribeFields as a3, type NodeInspectorHook as a4, type NodeActions as b, type NodeFn as c, COMPLETE as d, type CleanupResult as e, DEFAULT_ACTOR as f, DIRTY as g, type DescribeDetail as h, type DescribeField as i, type DescribeNodeOutput as j, GuardDenied as k, type GuardDeniedDetails as l, type Messages as m, type NodeDescribeKind as n, type NodeGuard as o, type NodeSink as p, type NodeStatus as q, type NodeTransportOptions as r, type NodeVersionInfo as s, type PolicyAllow as t, type PolicyDeny as u, type PolicyRuleData as v, RESUME as w, type V1 as x, type VersioningLevel as y, type VersioningOptions as z };

package/dist/{meta-BV4pj9ML.d.ts → meta-npl5b97j.d.ts}

@@ -616,57 +616,5 @@ type DescribeDetail = "minimal" | "standard" | "full";
 type DescribeField = "type" | "status" | "value" | "deps" | "meta" | "v" | "guard" | "lastMutation" | `meta.${string}`;
 /** Resolve which fields to include based on detail level or explicit field list. */
 declare function resolveDescribeFields(detail?: DescribeDetail, fields?: readonly DescribeField[]): Set<string> | null;
-/**
- * Reads the current cached value of every companion meta field on a node,
- * suitable for merging into `describe()`-style JSON (GRAPHREFLY-SPEC §2.3, §3.6).
- *
- * @remarks
- * Values come from {@link Node.get}, which returns the **last settled** cache.
- * If a meta field is in `"dirty"` status (DIRTY received, DATA pending), the
- * snapshot contains the *previous* value — check `node.meta[key].status` when
- * freshness matters. Avoid calling mid-batch for the same reason.
- *
- * Meta nodes are **not** terminated when their parent receives COMPLETE or
- * ERROR — they remain writable so callers can record post-mortem metadata
- * (e.g. `meta.error`). They *are* torn down when the parent receives TEARDOWN.
- *
- * @param node - The node whose meta fields to snapshot.
- * @returns Plain object of `{ key: value }` pairs (empty if no meta defined).
- * Keys whose companion node's {@link Node.get} throws are omitted.
- *
- * @example
- * ```ts
- * import { core } from "@graphrefly/graphrefly-ts";
- *
- * const n = core.node({ initial: 0, meta: { tag: "a" } });
- * core.metaSnapshot(n); // { tag: "a" }
- * ```
- */
-declare function metaSnapshot(node: Node): Record<string, unknown>;
-/**
- * Builds a single-node slice of `Graph.describe()` JSON (structure + `meta` snapshot).
- * Parity with graphrefly-py `describe_node`.
- *
- * `type` is inferred from factory configuration, optional `describeKind` in node options,
- * and the last `manualEmitUsed` hint (operator vs derived). {@link effect} sets
- * `describeKind: "effect"`. Nodes not created by {@link node} fall back to `type: "state"` and empty `deps`.
- *
- * @param node - Any `Node` to introspect.
- * @returns `DescribeNodeOutput` suitable for merging into graph describe maps.
- *
- * @example
- * ```ts
- * import { describeNode, state } from "@graphrefly/graphrefly-ts";
- *
- * describeNode(state(0));
- * ```
- */
-/**
- * Builds a single-node slice for `Graph.describe()`.
- *
- * @param node - Node to introspect.
- * @param includeFields - Set of fields to include, or `null` for all. When omitted, all fields are included (legacy behavior).
- */
-declare function describeNode(node: Node, includeFields?: Set<string> | null): DescribeNodeOutput;
 
-export { metaSnapshot as $, type Actor as A, accessHintForGuard as B, CLEANUP_RESULT as C, DATA as D, ERROR as E, advanceVersion as F, type GuardAction as G, type HashFn as H, INVALIDATE as I, cleanupResult as J, createVersioning as K, defaultHash as L, type Message as M, type Node as N, type OnMessageHandler as O, PAUSE as P, describeNode as Q, RESOLVED as R, type SubscribeHints as S, TEARDOWN as T, isKnownMessageType as U, type V0 as V, isPhase2Message as W, isTerminalMessage as X, isV1 as Y, knownMessageTypes as Z, messageTier as _, type NodeOptions as a, node as a0, normalizeActor as a1, policy as a2, policyFromRules as a3, propagatesToMeta as a4, resolveDescribeFields as a5, type NodeInspectorHook as a6, type NodeActions as b, type NodeFn as c, COMPLETE as d, type CleanupResult as e, DEFAULT_ACTOR as f, DIRTY as g, type DescribeDetail as h, type DescribeField as i, type DescribeNodeOutput as j, GuardDenied as k, type GuardDeniedDetails as l, type Messages as m, type NodeDescribeKind as n, type NodeGuard as o, type NodeSink as p, type NodeStatus as q, type NodeTransportOptions as r, type NodeVersionInfo as s, type PolicyAllow as t, type PolicyDeny as u, type PolicyRuleData as v, RESUME as w, type V1 as x, type VersioningLevel as y, type VersioningOptions as z };
+export { normalizeActor as $, type Actor as A, accessHintForGuard as B, CLEANUP_RESULT as C, DATA as D, ERROR as E, advanceVersion as F, type GuardAction as G, type HashFn as H, INVALIDATE as I, cleanupResult as J, createVersioning as K, defaultHash as L, type Message as M, type Node as N, type OnMessageHandler as O, PAUSE as P, isKnownMessageType as Q, RESOLVED as R, type SubscribeHints as S, TEARDOWN as T, isPhase2Message as U, type V0 as V, isTerminalMessage as W, isV1 as X, knownMessageTypes as Y, messageTier as Z, node as _, type NodeOptions as a, policy as a0, policyFromRules as a1, propagatesToMeta as a2, resolveDescribeFields as a3, type NodeInspectorHook as a4, type NodeActions as b, type NodeFn as c, COMPLETE as d, type CleanupResult as e, DEFAULT_ACTOR as f, DIRTY as g, type DescribeDetail as h, type DescribeField as i, type DescribeNodeOutput as j, GuardDenied as k, type GuardDeniedDetails as l, type Messages as m, type NodeDescribeKind as n, type NodeGuard as o, type NodeSink as p, type NodeStatus as q, type NodeTransportOptions as r, type NodeVersionInfo as s, type PolicyAllow as t, type PolicyDeny as u, type PolicyRuleData as v, RESUME as w, type V1 as x, type VersioningLevel as y, type VersioningOptions as z };

package/dist/observable-DFBCBELR.d.cts

@@ -0,0 +1,36 @@
+import { Observable } from 'rxjs';
+import { N as Node, m as Messages } from './meta-npl5b97j.cjs';
+
+/** Options for {@link toObservable}. */
+type ToObservableOptions = {
+    /**
+     * When `true`, emit raw `Messages` batches instead of extracted `DATA` values.
+     * Terminal batches are still emitted as the final `next()` before the
+     * Observable signal (error/complete).
+     */
+    raw?: boolean;
+};
+/**
+ * Bridge a `Node<T>` to an RxJS `Observable`.
+ *
+ * Default mode emits the node's value on each `DATA` message. Maps `ERROR` to
+ * `subscriber.error()` and `COMPLETE` to `subscriber.complete()`.
+ * Protocol-internal signals (DIRTY, RESOLVED, PAUSE, etc.) are skipped.
+ *
+ * With `{ raw: true }`, emits full `[[Type, Data?], ...]` message batches.
+ * The Observable terminates on ERROR or COMPLETE (the terminal batch is still
+ * emitted as the final `next()` before the Observable signal).
+ *
+ * For graph-level observation, use `toObservable(graph.resolve(path))` or
+ * subscribe to `graph.observe()` directly.
+ *
+ * Unsubscribing the Observable unsubscribes the node.
+ */
+declare function toObservable<T>(node: Node<T>, options?: ToObservableOptions & {
+    raw?: false;
+}): Observable<T>;
+declare function toObservable<T>(node: Node<T>, options: ToObservableOptions & {
+    raw: true;
+}): Observable<Messages>;
+
+export { type ToObservableOptions as T, toObservable as t };

package/dist/observable-oAGygKvc.d.ts

@@ -0,0 +1,36 @@
+import { Observable } from 'rxjs';
+import { N as Node, m as Messages } from './meta-npl5b97j.js';
+
+/** Options for {@link toObservable}. */
+type ToObservableOptions = {
+    /**
+     * When `true`, emit raw `Messages` batches instead of extracted `DATA` values.
+     * Terminal batches are still emitted as the final `next()` before the
+     * Observable signal (error/complete).
+     */
+    raw?: boolean;
+};
+/**
+ * Bridge a `Node<T>` to an RxJS `Observable`.
+ *
+ * Default mode emits the node's value on each `DATA` message. Maps `ERROR` to
+ * `subscriber.error()` and `COMPLETE` to `subscriber.complete()`.
+ * Protocol-internal signals (DIRTY, RESOLVED, PAUSE, etc.) are skipped.
+ *
+ * With `{ raw: true }`, emits full `[[Type, Data?], ...]` message batches.
+ * The Observable terminates on ERROR or COMPLETE (the terminal batch is still
+ * emitted as the final `next()` before the Observable signal).
+ *
+ * For graph-level observation, use `toObservable(graph.resolve(path))` or
+ * subscribe to `graph.observe()` directly.
+ *
+ * Unsubscribing the Observable unsubscribes the node.
+ */
+declare function toObservable<T>(node: Node<T>, options?: ToObservableOptions & {
+    raw?: false;
+}): Observable<T>;
+declare function toObservable<T>(node: Node<T>, options: ToObservableOptions & {
+    raw: true;
+}): Observable<Messages>;
+
+export { type ToObservableOptions as T, toObservable as t };