@graphrefly/graphrefly 0.5.0 → 0.7.0

package/dist/{chunk-6W5SGIGB.js → chunk-BLCXEMAD.js}

@@ -1,6 +1,7 @@
 import {
-  describeNode
-} from "./chunk-O3PI7W45.js";
+  describeNode,
+  resolveDescribeFields
+} from "./chunk-47YJEZUJ.js";
 import {
   COMPLETE,
   DATA,
@@ -15,7 +16,7 @@ import {
   messageTier,
   monotonicNs,
   state
-} from "./chunk-5X3LAO3B.js";
+} from "./chunk-3EVXOI5C.js";
 
 // src/graph/graph.ts
 var PATH_SEP = "::";
@@ -203,6 +204,23 @@ function resolveSpyTheme(theme) {
     reset: theme.reset ?? ""
   };
 }
+function resolveObserveDetail(opts) {
+  if (opts == null) return {};
+  const detail = opts.detail;
+  if (detail === "full") {
+    return {
+      ...opts,
+      structured: opts.structured ?? true,
+      timeline: opts.timeline ?? true,
+      causal: opts.causal ?? true,
+      derived: opts.derived ?? true
+    };
+  }
+  if (detail === "minimal") {
+    return { ...opts, structured: opts.structured ?? true };
+  }
+  return opts;
+}
 function assertLocalName(name, graphName, label) {
   if (name === "") {
     throw new Error(`Graph "${graphName}": ${label} name must be non-empty`);
@@ -400,6 +418,22 @@ var Graph = class _Graph {
       if (this._defaultVersioningLevel != null) {
         node._applyVersioning(this._defaultVersioningLevel);
       }
+      if (node._deps.length > 0) {
+        for (const dep of node._deps) {
+          for (const [depName, depNode] of this._nodes) {
+            if (depNode === dep) {
+              this._edges.add(edgeKey(depName, name));
+              break;
+            }
+          }
+        }
+      }
+      for (const [otherName, otherNode] of this._nodes) {
+        if (otherName === name) continue;
+        if (otherNode instanceof NodeImpl && otherNode._deps.includes(node)) {
+          this._edges.add(edgeKey(name, otherName));
+        }
+      }
     }
   }
   /**
@@ -786,6 +820,9 @@ var Graph = class _Graph {
   describe(options) {
     const actor = options?.actor;
     const filter = options?.filter;
+    const includeFields = resolveDescribeFields(options?.detail, options?.fields);
+    const isSpec = options?.format === "spec";
+    const effectiveFields = isSpec ? resolveDescribeFields("minimal") : includeFields;
     const targets = [];
     this._collectObserveTargets("", targets);
     const nodeToPath = /* @__PURE__ */ new Map();
@@ -795,7 +832,7 @@ var Graph = class _Graph {
     const nodes = {};
     for (const [p, n] of targets) {
       if (actor != null && !n.allowsObserve(actor)) continue;
-      const raw = describeNode(n);
+      const raw = describeNode(n, effectiveFields);
       const deps = n instanceof NodeImpl ? n._deps.map((d) => nodeToPath.get(d) ?? d.name ?? "") : [];
       const { name: _name, ...rest } = raw;
       const entry = { ...rest, deps };
@@ -816,7 +853,7 @@ var Graph = class _Graph {
               continue;
             }
             if (normalizedKey === "metaHas") {
-              if (!Object.hasOwn(entry.meta, String(fv))) {
+              if (!Object.hasOwn(entry.meta ?? {}, String(fv))) {
                 match = false;
                 break;
               }
@@ -849,11 +886,24 @@ var Graph = class _Graph {
       const prefix = `${sg}${PATH_SEP}`;
       return [...nodeKeys].some((k) => k === sg || k.startsWith(prefix));
     }) : allSubgraphs;
+    const graph = this;
+    const baseOpts = options;
     return {
       name: this.name,
       nodes,
       edges,
-      subgraphs
+      subgraphs,
+      expand(detailOrFields) {
+        const merged = { ...baseOpts, format: void 0 };
+        if (Array.isArray(detailOrFields)) {
+          merged.fields = detailOrFields;
+          merged.detail = void 0;
+        } else {
+          merged.detail = detailOrFields;
+          merged.fields = void 0;
+        }
+        return graph.describe(merged);
+      }
     };
   }
   _collectSubgraphs(prefix) {
@@ -906,14 +956,15 @@ var Graph = class _Graph {
   observe(pathOrOpts, options) {
     if (typeof pathOrOpts === "string") {
       const path = pathOrOpts;
-      const actor2 = options?.actor;
+      const resolved = resolveObserveDetail(options);
+      const actor2 = resolved.actor;
       const target = this.resolve(path);
       if (actor2 != null && !target.allowsObserve(actor2)) {
         throw new GuardDenied({ actor: actor2, action: "observe", nodeName: path });
       }
-      const wantsStructured2 = options?.structured === true || options?.timeline === true || options?.causal === true || options?.derived === true;
+      const wantsStructured2 = resolved.structured === true || resolved.timeline === true || resolved.causal === true || resolved.derived === true || resolved.detail === "minimal" || resolved.detail === "full";
       if (wantsStructured2 && _Graph.inspectorEnabled) {
-        return this._createObserveResult(path, target, options);
+        return this._createObserveResult(path, target, resolved);
       }
       return {
         subscribe(sink) {
@@ -929,11 +980,11 @@ var Graph = class _Graph {
         }
       };
     }
-    const opts = pathOrOpts;
-    const actor = opts?.actor;
-    const wantsStructured = opts?.structured === true || opts?.timeline === true || opts?.causal === true || opts?.derived === true;
+    const opts = resolveObserveDetail(pathOrOpts);
+    const actor = opts.actor;
+    const wantsStructured = opts.structured === true || opts.timeline === true || opts.causal === true || opts.derived === true || opts.detail === "minimal" || opts.detail === "full";
     if (wantsStructured && _Graph.inspectorEnabled) {
-      return this._createObserveResultForAll(opts ?? {});
+      return this._createObserveResultForAll(opts);
     }
     return {
       subscribe: (sink) => {
@@ -965,6 +1016,7 @@ var Graph = class _Graph {
     const timeline = options.timeline === true;
     const causal = options.causal === true;
     const derived = options.derived === true;
+    const minimal = options.detail === "minimal";
     const result = {
       values: {},
       dirtyCount: 0,
@@ -1010,6 +1062,11 @@ var Graph = class _Graph {
         if (t === DATA) {
           result.values[path] = m[1];
           result.events.push({ type: "data", path, data: m[1], ...base, ...withCausal });
+        } else if (minimal) {
+          if (t === DIRTY) result.dirtyCount++;
+          else if (t === RESOLVED) result.resolvedCount++;
+          else if (t === COMPLETE && !result.errored) result.completedCleanly = true;
+          else if (t === ERROR) result.errored = true;
         } else if (t === DIRTY) {
           result.dirtyCount++;
           result.events.push({ type: "dirty", path, ...base });
@@ -1025,6 +1082,8 @@ var Graph = class _Graph {
         }
       }
     });
+    const graph = this;
+    const basePath = path;
     return {
       get values() {
         return result.values;
@@ -1047,11 +1106,28 @@ var Graph = class _Graph {
       dispose() {
         unsub();
         detachInspectorHook?.();
+      },
+      expand(extra) {
+        unsub();
+        detachInspectorHook?.();
+        const merged = { ...options };
+        if (typeof extra === "string") {
+          merged.detail = extra;
+        } else {
+          Object.assign(merged, extra);
+        }
+        const resolvedTarget = graph.resolve(basePath);
+        return graph._createObserveResult(
+          basePath,
+          resolvedTarget,
+          resolveObserveDetail(merged)
+        );
       }
     };
   }
   _createObserveResultForAll(options) {
     const timeline = options.timeline === true;
+    const minimal = options.detail === "minimal";
     const result = {
       values: {},
       dirtyCount: 0,
@@ -1073,6 +1149,11 @@ var Graph = class _Graph {
           if (t === DATA) {
             result.values[path] = m[1];
             result.events.push({ type: "data", path, data: m[1], ...base });
+          } else if (minimal) {
+            if (t === DIRTY) result.dirtyCount++;
+            else if (t === RESOLVED) result.resolvedCount++;
+            else if (t === COMPLETE && !result.errored) result.completedCleanly = true;
+            else if (t === ERROR) result.errored = true;
           } else if (t === DIRTY) {
             result.dirtyCount++;
             result.events.push({ type: "dirty", path, ...base });
@@ -1089,6 +1170,7 @@ var Graph = class _Graph {
         }
       })
     );
+    const graph = this;
     return {
       get values() {
         return result.values;
@@ -1110,6 +1192,16 @@ var Graph = class _Graph {
       },
       dispose() {
         for (const u of unsubs) u();
+      },
+      expand(extra) {
+        for (const u of unsubs) u();
+        const merged = { ...options };
+        if (typeof extra === "string") {
+          merged.detail = extra;
+        } else {
+          Object.assign(merged, extra);
+        }
+        return graph._createObserveResultForAll(resolveObserveDetail(merged));
       }
     };
   }
@@ -1185,6 +1277,9 @@ var Graph = class _Graph {
         },
         dispose() {
           stop2();
+        },
+        expand() {
+          throw new Error("expand() requires inspector mode (Graph.inspectorEnabled = true)");
         }
       };
       const pushEvent = (path, message) => {
@@ -1285,16 +1380,16 @@ var Graph = class _Graph {
    * @returns Rendered graph text.
    */
   dumpGraph(options = {}) {
-    const described = this.describe({
+    const { expand: _, ...described } = this.describe({
       actor: options.actor,
-      filter: options.filter
+      filter: options.filter,
+      detail: "standard"
     });
     const includeEdges = options.includeEdges ?? true;
     const includeSubgraphs = options.includeSubgraphs ?? true;
     if (options.format === "json") {
       const payload = {
-        name: described.name,
-        nodes: described.nodes,
+        ...described,
         edges: includeEdges ? described.edges : [],
         subgraphs: includeSubgraphs ? described.subgraphs : []
       };
@@ -1364,10 +1459,11 @@ var Graph = class _Graph {
    * @returns Persistable snapshot with sorted keys.
    */
   snapshot() {
-    const d = this.describe();
+    const { expand: _, ...d } = this.describe({ detail: "full" });
     const sortedNodes = {};
     for (const key of Object.keys(d.nodes).sort()) {
-      sortedNodes[key] = d.nodes[key];
+      const { lastMutation: _lm, guard: _g, ...node } = d.nodes[key];
+      sortedNodes[key] = node;
     }
     const sortedSubgraphs = [...d.subgraphs].sort();
     return { ...d, version: 1, nodes: sortedNodes, subgraphs: sortedSubgraphs };
@@ -1521,16 +1617,22 @@ var Graph = class _Graph {
       if (!pending) return;
       pending = false;
       try {
-        const described = this.describe();
+        const { expand: _expand, ...raw } = this.describe({ detail: "full" });
+        const cleanNodes = {};
+        for (const [p, n] of Object.entries(raw.nodes)) {
+          const { lastMutation: _lm, guard: _g, ...node } = n;
+          cleanNodes[p] = node;
+        }
+        const described = { ...raw, nodes: cleanNodes };
         const snapshot = { ...described, version: SNAPSHOT_VERSION };
         seq += 1;
         const shouldCompact = lastDescribe == null || seq % compactEvery === 0;
         if (shouldCompact) {
-          adapter.save({ mode: "full", snapshot, seq });
+          adapter.save(this.name, { mode: "full", snapshot, seq });
         } else {
           const previous = lastDescribe;
           if (previous == null) return;
-          adapter.save({
+          adapter.save(this.name, {
             mode: "diff",
             diff: _Graph.diff(previous, described),
             snapshot,
@@ -1551,8 +1653,10 @@ var Graph = class _Graph {
       const triggeredByTier = messages.some((m) => messageTier(m[0]) >= 2);
       if (!triggeredByTier) return;
       if (options.filter) {
-        const described = this.describe().nodes[path];
-        if (described == null || !options.filter(path, described)) return;
+        const nd = this.resolve(path);
+        if (nd == null) return;
+        const described = describeNode(nd, resolveDescribeFields("standard"));
+        if (!options.filter(path, described)) return;
       }
       schedule();
     });
@@ -1790,4 +1894,4 @@ export {
   Graph,
   reachable
 };
-//# sourceMappingURL=chunk-6W5SGIGB.js.map
+//# sourceMappingURL=chunk-BLCXEMAD.js.map