@graphrefly/graphrefly 0.21.0 → 0.23.0

package/dist/meta-3QjzotRv.d.ts

@@ -0,0 +1,41 @@
+import { v as NodeDescribeKind, N as Node, A as Actor } from './node-C7PD3sn9.js';
+
+/**
+ * JSON-shaped slice of a node for `Graph.describe()`
+ * (GRAPHREFLY-SPEC §3.6, Appendix B).
+ */
+type DescribeNodeOutput = {
+    type: NodeDescribeKind;
+    status?: Node["status"];
+    deps: string[];
+    meta?: Record<string, unknown>;
+    name?: string;
+    value?: unknown;
+    /** True when the node is in `"sentinel"` state (no value ever). */
+    sentinel?: boolean;
+    v?: {
+        id: string;
+        version: number;
+        cid?: string;
+        prev?: string | null;
+    };
+    guard?: string;
+    lastMutation?: Readonly<{
+        actor: Actor;
+        timestamp_ns: number;
+    }>;
+    /**
+     * Latest reason annotation attached via `graph.trace(path, reason)`,
+     * when present. Populated by `Graph.describe` only — `describeNode`
+     * has no graph context.
+     */
+    reason?: string;
+};
+/** Detail level for progressive disclosure (Phase 3.3b). */
+type DescribeDetail = "minimal" | "standard" | "full";
+/** Valid field names for `describe({ fields: [...] })`. */
+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;
+
+export { type DescribeDetail as D, type DescribeField as a, type DescribeNodeOutput as b, resolveDescribeFields as r };

package/dist/meta-B-Lbs4-O.d.cts

@@ -0,0 +1,41 @@
+import { v as NodeDescribeKind, N as Node, A as Actor } from './node-C7PD3sn9.cjs';
+
+/**
+ * JSON-shaped slice of a node for `Graph.describe()`
+ * (GRAPHREFLY-SPEC §3.6, Appendix B).
+ */
+type DescribeNodeOutput = {
+    type: NodeDescribeKind;
+    status?: Node["status"];
+    deps: string[];
+    meta?: Record<string, unknown>;
+    name?: string;
+    value?: unknown;
+    /** True when the node is in `"sentinel"` state (no value ever). */
+    sentinel?: boolean;
+    v?: {
+        id: string;
+        version: number;
+        cid?: string;
+        prev?: string | null;
+    };
+    guard?: string;
+    lastMutation?: Readonly<{
+        actor: Actor;
+        timestamp_ns: number;
+    }>;
+    /**
+     * Latest reason annotation attached via `graph.trace(path, reason)`,
+     * when present. Populated by `Graph.describe` only — `describeNode`
+     * has no graph context.
+     */
+    reason?: string;
+};
+/** Detail level for progressive disclosure (Phase 3.3b). */
+type DescribeDetail = "minimal" | "standard" | "full";
+/** Valid field names for `describe({ fields: [...] })`. */
+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;
+
+export { type DescribeDetail as D, type DescribeField as a, type DescribeNodeOutput as b, resolveDescribeFields as r };