@fluixi/devtools 0.2.0-alpha.3 → 0.2.0-alpha.5

package/dist/dom.mjs

@@ -0,0 +1,183 @@
+// src/dom.ts
+var LOC_TAG = "__fx_loc";
+function locationOf(element) {
+  return element[LOC_TAG];
+}
+var DOM_BUDGET = 200;
+function describeElement(element) {
+  let out = element.tagName.toLowerCase();
+  if (element.id) out += `#${element.id}`;
+  const classes = element.classList;
+  if (classes.length > 0) {
+    out += `.${classes[0]}`;
+    if (classes.length > 1) out += `.${classes[1]}`;
+  }
+  return out;
+}
+function describeAll(graph, roots, writtenBy, kinds, extraFor) {
+  const owners = /* @__PURE__ */ new Map();
+  const writers = /* @__PURE__ */ new Map();
+  const rendered = /* @__PURE__ */ new Map();
+  for (const node of graph.values()) {
+    if (kinds.has(node.kind)) {
+      const found = roots(node.id);
+      rendered.set(node.id, found);
+      for (const element of found) if (!owners.has(element)) owners.set(element, node.id);
+      continue;
+    }
+    for (const element of writtenBy(node.id)) {
+      const held = writers.get(element);
+      if (held) held.push(node.id);
+      else writers.set(element, [node.id]);
+    }
+  }
+  const { claimed, containers } = claimOrphans(graph, rendered, writtenBy, kinds, owners);
+  const claims = /* @__PURE__ */ new Map();
+  for (const [element, id] of claimed) {
+    const held = claims.get(id);
+    if (held) held.push(element);
+    else claims.set(id, [element]);
+  }
+  const landing = landings(graph, rendered, writtenBy, kinds, claimed, containers);
+  const out = /* @__PURE__ */ new Map();
+  for (const node of graph.values()) {
+    if (!kinds.has(node.kind)) continue;
+    const budget = { left: DOM_BUDGET };
+    const walk = (element) => {
+      const owner = owners.get(element) ?? claimed.get(element);
+      const where = locationOf(element);
+      if (owner !== void 0 && owner !== node.id) {
+        return { label: describeElement(element), children: [], owner, element, ...where ? { at: where } : {} };
+      }
+      if (containers.has(element)) {
+        return { label: describeElement(element), children: [], container: true, element, ...where ? { at: where } : {} };
+      }
+      const children = [];
+      const kids = element.children;
+      for (let i = 0, n = kids.length; i < n && budget.left > 0; i++) {
+        budget.left -= 1;
+        children.push(walk(kids[i]));
+      }
+      const writes = writers.get(element);
+      const extra = extraFor?.(element);
+      const inside = landing.get(element)?.filter((id) => within(graph, id, node.id));
+      return {
+        label: describeElement(element),
+        children,
+        element,
+        ...where ? { at: where } : {},
+        ...writes?.length ? { writes } : {},
+        ...inside?.length ? { inside } : {},
+        ...extra ? { extra } : {}
+      };
+    };
+    out.set(node.id, [...rendered.get(node.id) ?? [], ...claims.get(node.id) ?? []].map(walk));
+  }
+  return out;
+}
+function within(graph, id, ancestor) {
+  const seen = /* @__PURE__ */ new Set();
+  for (let at = graph.get(id)?.createdIn; at !== void 0 && !seen.has(at); at = graph.get(at)?.createdIn) {
+    if (at === ancestor) return true;
+    seen.add(at);
+  }
+  return false;
+}
+function landings(graph, rendered, writtenBy, kinds, claimed, containers) {
+  const claimers = new Set(claimed.values());
+  const landing = /* @__PURE__ */ new Map();
+  for (const node of graph.values()) {
+    if (!kinds.has(node.kind) || (rendered.get(node.id) ?? []).length) continue;
+    if (claimers.has(node.id)) continue;
+    let shallowest;
+    let best = Infinity;
+    for (const element of writtenBy(node.id)) {
+      if (containers.has(element)) continue;
+      const depth = depthInDocument(element);
+      if (depth < best) {
+        best = depth;
+        shallowest = element;
+      }
+    }
+    if (!shallowest) continue;
+    const held = landing.get(shallowest);
+    if (held) held.push(node.id);
+    else landing.set(shallowest, [node.id]);
+  }
+  for (const [element, ids] of landing) {
+    landing.set(element, ids.filter((id) => !ids.some((other) => other !== id && within(graph, id, other))));
+  }
+  return landing;
+}
+function tagDepths(graph, kinds) {
+  const depth = /* @__PURE__ */ new Map();
+  const of = (id, seen) => {
+    const held = depth.get(id);
+    if (held !== void 0) return held;
+    if (seen.has(id)) return 0;
+    seen.add(id);
+    const parent = graph.get(id)?.createdIn;
+    const value = parent === void 0 ? 0 : of(parent, seen) + 1;
+    depth.set(id, value);
+    return value;
+  };
+  for (const node of graph.values()) if (kinds.has(node.kind)) of(node.id, /* @__PURE__ */ new Set());
+  return depth;
+}
+function depthInDocument(element) {
+  let steps = 0;
+  for (let at = element.parentElement; at; at = at.parentElement) steps++;
+  return steps;
+}
+function claimOrphans(graph, rendered, writtenBy, kinds, owners) {
+  const depth = tagDepths(graph, kinds);
+  const wraps = (element) => {
+    for (const owned of owners.keys()) if (element !== owned && element.contains(owned)) return true;
+    return false;
+  };
+  const writing = /* @__PURE__ */ new Map();
+  for (const node of graph.values()) {
+    if (!kinds.has(node.kind) || (rendered.get(node.id) ?? []).length) continue;
+    for (const element of writtenBy(node.id)) {
+      if (owners.has(element)) continue;
+      const held = writing.get(element);
+      if (held) held.push(node.id);
+      else writing.set(element, [node.id]);
+    }
+  }
+  const claimed = /* @__PURE__ */ new Map();
+  const containers = /* @__PURE__ */ new Set();
+  const covered = (element) => {
+    for (let at = element.parentElement; at; at = at.parentElement) {
+      if (owners.has(at) || claimed.has(at)) return true;
+    }
+    return false;
+  };
+  const order = [...writing.keys()].sort((a, b) => depthInDocument(a) - depthInDocument(b));
+  for (const element of order) {
+    if (covered(element)) continue;
+    const ids = writing.get(element);
+    const container = wraps(element);
+    const pick = ids.reduce((best, id) => {
+      const a = depth.get(id) ?? 0;
+      const b = depth.get(best) ?? 0;
+      return container ? a < b ? id : best : a > b ? id : best;
+    });
+    claimed.set(element, pick);
+    if (container) containers.add(element);
+  }
+  return { claimed, containers };
+}
+function withoutElements(nodes) {
+  return nodes.map(({ element, children, ...rest }) => ({
+    ...rest,
+    children: withoutElements(children)
+  }));
+}
+export {
+  DOM_BUDGET,
+  describeAll,
+  describeElement,
+  tagDepths,
+  withoutElements
+};

package/dist/export.cjs

@@ -0,0 +1,221 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/export.ts
+var export_exports = {};
+__export(export_exports, {
+  exportGraph: () => exportGraph,
+  graphToJson: () => graphToJson
+});
+module.exports = __toCommonJS(export_exports);
+
+// src/instrument.ts
+var import_signal = require("@fluixi/reactive/signal");
+var import_store = require("@fluixi/reactive/store");
+
+// src/source.ts
+var MARKS = "__FLUIXI_DEVTOOLS_MARKS__";
+var host = globalThis;
+var shared = host[MARKS] ?? {
+  pending: null,
+  expiring: false,
+  components: /* @__PURE__ */ new Map()
+};
+host[MARKS] = shared;
+
+// src/format.ts
+var MAX_DEPTH = 3;
+var MAX_ENTRIES = 8;
+function domName(v) {
+  if (typeof v?.nodeType !== "number" || typeof v.nodeName !== "string") return null;
+  return v.tagName ? `<${v.tagName.toLowerCase()}>` : `#${v.nodeName.toLowerCase()}`;
+}
+function fnName(v) {
+  return v.name ? `ƒ ${v.name}()` : "ƒ";
+}
+function className(v) {
+  const name = v.constructor?.name;
+  return name && name !== "Object" ? `${name} ` : "";
+}
+function primitive(v) {
+  if (v === null) return "null";
+  switch (typeof v) {
+    case "undefined":
+      return "undefined";
+    case "string":
+      return JSON.stringify(v);
+    case "number":
+    case "boolean":
+      return String(v);
+    case "bigint":
+      return `${v}n`;
+    case "symbol":
+      return v.toString();
+    case "function":
+      return fnName(v);
+    default:
+      return null;
+  }
+}
+function walk(value, depth, seen) {
+  const simple = primitive(value);
+  if (simple !== null) return simple;
+  const object = value;
+  if (seen.has(object)) return "[circular]";
+  const dom = domName(object);
+  if (dom) return dom;
+  if (object instanceof Date) return Number.isNaN(object.getTime()) ? "Invalid Date" : object.toISOString();
+  if (object instanceof RegExp) return String(object);
+  if (object instanceof Error) return `${object.name}: ${object.message}`;
+  if (object instanceof Promise) return "Promise";
+  if (ArrayBuffer.isView(object)) {
+    return `${className(object).trim()}(${object.length ?? ""})`;
+  }
+  if (depth >= MAX_DEPTH) return Array.isArray(object) ? "[…]" : "{…}";
+  seen.add(object);
+  try {
+    if (Array.isArray(object)) {
+      const shown2 = object.slice(0, MAX_ENTRIES).map((item) => walk(item, depth + 1, seen));
+      if (object.length > MAX_ENTRIES) shown2.push("…");
+      return `[${shown2.join(", ")}]`;
+    }
+    if (object instanceof Map) {
+      const shown2 = [];
+      for (const [k, v] of object) {
+        if (shown2.length === MAX_ENTRIES) {
+          shown2.push("…");
+          break;
+        }
+        shown2.push(`${walk(k, depth + 1, seen)} => ${walk(v, depth + 1, seen)}`);
+      }
+      return `Map(${object.size}) {${shown2.join(", ")}}`;
+    }
+    if (object instanceof Set) {
+      const shown2 = [];
+      for (const item of object) {
+        if (shown2.length === MAX_ENTRIES) {
+          shown2.push("…");
+          break;
+        }
+        shown2.push(walk(item, depth + 1, seen));
+      }
+      return `Set(${object.size}) {${shown2.join(", ")}}`;
+    }
+    const keys = Object.keys(object);
+    const shown = keys.slice(0, MAX_ENTRIES).map((key) => {
+      let read;
+      try {
+        read = walk(object[key], depth + 1, seen);
+      } catch {
+        read = "[unreadable]";
+      }
+      return `${key}: ${read}`;
+    });
+    if (keys.length > MAX_ENTRIES) shown.push("…");
+    return `${className(object)}{${shown.join(", ")}}`;
+  } finally {
+    seen.delete(object);
+  }
+}
+function formatValue(value, limit = 240) {
+  let text;
+  try {
+    text = walk(value, 0, /* @__PURE__ */ new Set());
+  } catch {
+    text = "[unreadable]";
+  }
+  return text.length > limit ? `${text.slice(0, limit - 1)}…` : text;
+}
+
+// src/instrument.ts
+var CORE_STATE = { 0: "clean", 1: "check", 2: "dirty" };
+function nodeVersion(n) {
+  return n.core && typeof n.core.version === "number" ? n.core.version : n.runs;
+}
+function nodeState(n) {
+  return n.core && typeof n.core.state === "number" ? CORE_STATE[n.core.state] : void 0;
+}
+
+// src/export.ts
+var at = (source) => {
+  if (!source) return void 0;
+  const where = `${source.file ?? ""}:${source.line ?? ""}:${source.column ?? ""}`;
+  const out = source.compiled;
+  const same = out?.line === source.line && out?.column === source.column;
+  return out && !same ? `${where} (out ${out.line ?? ""}:${out.column ?? ""})` : where;
+};
+function naming(graph) {
+  const seen = /* @__PURE__ */ new Map();
+  for (const node of graph.values()) seen.set(node.label, (seen.get(node.label) ?? 0) + 1);
+  return (id) => {
+    const node = graph.get(id);
+    if (!node) return `#${id}`;
+    return (seen.get(node.label) ?? 0) > 1 ? `${node.label}#${node.id}` : node.label;
+  };
+}
+function exportGraph(graph, options = {}) {
+  const limit = options.limit ?? 400;
+  const name = naming(graph);
+  const nodes = [...graph.values()].map((node) => {
+    let value = node.detail ?? node.value;
+    if (node.read) {
+      try {
+        value = formatValue(node.read(), limit);
+      } catch {
+      }
+    }
+    const feeds = [...node.deps].map(name);
+    const wrote = [...node.writes].map(name);
+    const state = nodeState(node);
+    return {
+      id: node.id,
+      label: node.label,
+      kind: node.kind,
+      ...node.authored === false ? { authored: false } : {},
+      ...value ? { value } : {},
+      ...node.runs ? { runs: node.runs } : {},
+      // Only a node with a core has one; a static node would report a version of 0.
+      ...node.core?.version !== void 0 ? { version: nodeVersion(node) } : {},
+      ...state ? { state } : {},
+      ...feeds.length ? { reads: feeds } : {},
+      ...wrote.length ? { writes: wrote } : {},
+      ...node.createdIn !== void 0 ? { madeIn: name(node.createdIn) } : {},
+      ...at(node.source) ? { source: at(node.source) } : {},
+      ...at(node.declaredAt) ? { declaredAt: at(node.declaredAt) } : {},
+      ...at(node.usedAt) ? { usedAt: at(node.usedAt) } : {},
+      ...node.targets?.length ? {
+        updates: node.targets.map((target) => {
+          const what = target.name ? `${target.name} of ${target.element}` : target.element;
+          const where = at(target.source);
+          return where ? `${what} — ${where}` : what;
+        })
+      } : {},
+      ...node.setAt?.length ? { setAt: node.setAt.map((s) => at(s)).filter(Boolean) } : {}
+    };
+  });
+  return {
+    t: Date.now(),
+    from: options.fromSource ? "source" : "running application",
+    nodes,
+    ...options.events?.length ? { events: [...options.events] } : {}
+  };
+}
+function graphToJson(graph, options = {}) {
+  return JSON.stringify(exportGraph(graph, options), null, 2);
+}

package/dist/export.d.ts

@@ -2,7 +2,7 @@
  * The graph as something to paste somewhere else.
  *
  * A panel shows one node at a time; a bug report needs all of them at once. This is the whole
- * graph as plain json — values, kinds, ownership, sources, what each node reaches in the
+ * graph as plain json: values, kinds, ownership, sources, what each node reaches in the
  * document and where it is written from.
  *
  * Names rather than ids wherever a reader has to follow a reference: `deps: ["count"]` can be
@@ -23,7 +23,7 @@ interface ExportedNode {
     id: number;
     label: string;
     kind: string;
-    /** Absent when the framework named it — see RNode.authored. */
+    /** Absent when the framework named it: see RNode.authored. */
     authored?: boolean;
     value?: string;
     runs?: number;

package/dist/export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../src/export.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAA0B,KAAK,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,MAAM,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAC/B,kFAAkF;IAClF,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAsBD,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,mDAAmD;IACnD,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,IAAI,EAAE,QAAQ,GAAG,qBAAqB,CAAC;CACxC;AAED,mCAAmC;AACnC,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAE,aAAkB,GAAG,aAAa,CAoDjG;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAE1F"}
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../src/export.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAA0B,KAAK,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,MAAM,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAC/B,kFAAkF;IAClF,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAsBD,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,mDAAmD;IACnD,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,IAAI,EAAE,QAAQ,GAAG,qBAAqB,CAAC;CACxC;AAED,mCAAmC;AACnC,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAE,aAAkB,GAAG,aAAa,CAoDjG;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAE1F"}

package/dist/export.js

@@ -2,7 +2,7 @@
  * The graph as something to paste somewhere else.
  *
  * A panel shows one node at a time; a bug report needs all of them at once. This is the whole
- * graph as plain json — values, kinds, ownership, sources, what each node reaches in the
+ * graph as plain json: values, kinds, ownership, sources, what each node reaches in the
  * document and where it is written from.
  *
  * Names rather than ids wherever a reader has to follow a reference: `deps: ["count"]` can be

package/dist/export.mjs

@@ -0,0 +1,209 @@
+// src/instrument.ts
+import {
+  createSignal,
+  createMemo,
+  createEffect,
+  createResource,
+  createRoot,
+  untrack,
+  onCleanup,
+  getOwner,
+  runWithOwner,
+  Signal
+} from "@fluixi/reactive/signal";
+import { createStore } from "@fluixi/reactive/store";
+
+// src/source.ts
+var MARKS = "__FLUIXI_DEVTOOLS_MARKS__";
+var host = globalThis;
+var shared = host[MARKS] ?? {
+  pending: null,
+  expiring: false,
+  components: /* @__PURE__ */ new Map()
+};
+host[MARKS] = shared;
+
+// src/format.ts
+var MAX_DEPTH = 3;
+var MAX_ENTRIES = 8;
+function domName(v) {
+  if (typeof v?.nodeType !== "number" || typeof v.nodeName !== "string") return null;
+  return v.tagName ? `<${v.tagName.toLowerCase()}>` : `#${v.nodeName.toLowerCase()}`;
+}
+function fnName(v) {
+  return v.name ? `ƒ ${v.name}()` : "ƒ";
+}
+function className(v) {
+  const name = v.constructor?.name;
+  return name && name !== "Object" ? `${name} ` : "";
+}
+function primitive(v) {
+  if (v === null) return "null";
+  switch (typeof v) {
+    case "undefined":
+      return "undefined";
+    case "string":
+      return JSON.stringify(v);
+    case "number":
+    case "boolean":
+      return String(v);
+    case "bigint":
+      return `${v}n`;
+    case "symbol":
+      return v.toString();
+    case "function":
+      return fnName(v);
+    default:
+      return null;
+  }
+}
+function walk(value, depth, seen) {
+  const simple = primitive(value);
+  if (simple !== null) return simple;
+  const object = value;
+  if (seen.has(object)) return "[circular]";
+  const dom = domName(object);
+  if (dom) return dom;
+  if (object instanceof Date) return Number.isNaN(object.getTime()) ? "Invalid Date" : object.toISOString();
+  if (object instanceof RegExp) return String(object);
+  if (object instanceof Error) return `${object.name}: ${object.message}`;
+  if (object instanceof Promise) return "Promise";
+  if (ArrayBuffer.isView(object)) {
+    return `${className(object).trim()}(${object.length ?? ""})`;
+  }
+  if (depth >= MAX_DEPTH) return Array.isArray(object) ? "[…]" : "{…}";
+  seen.add(object);
+  try {
+    if (Array.isArray(object)) {
+      const shown2 = object.slice(0, MAX_ENTRIES).map((item) => walk(item, depth + 1, seen));
+      if (object.length > MAX_ENTRIES) shown2.push("…");
+      return `[${shown2.join(", ")}]`;
+    }
+    if (object instanceof Map) {
+      const shown2 = [];
+      for (const [k, v] of object) {
+        if (shown2.length === MAX_ENTRIES) {
+          shown2.push("…");
+          break;
+        }
+        shown2.push(`${walk(k, depth + 1, seen)} => ${walk(v, depth + 1, seen)}`);
+      }
+      return `Map(${object.size}) {${shown2.join(", ")}}`;
+    }
+    if (object instanceof Set) {
+      const shown2 = [];
+      for (const item of object) {
+        if (shown2.length === MAX_ENTRIES) {
+          shown2.push("…");
+          break;
+        }
+        shown2.push(walk(item, depth + 1, seen));
+      }
+      return `Set(${object.size}) {${shown2.join(", ")}}`;
+    }
+    const keys = Object.keys(object);
+    const shown = keys.slice(0, MAX_ENTRIES).map((key) => {
+      let read;
+      try {
+        read = walk(object[key], depth + 1, seen);
+      } catch {
+        read = "[unreadable]";
+      }
+      return `${key}: ${read}`;
+    });
+    if (keys.length > MAX_ENTRIES) shown.push("…");
+    return `${className(object)}{${shown.join(", ")}}`;
+  } finally {
+    seen.delete(object);
+  }
+}
+function formatValue(value, limit = 240) {
+  let text;
+  try {
+    text = walk(value, 0, /* @__PURE__ */ new Set());
+  } catch {
+    text = "[unreadable]";
+  }
+  return text.length > limit ? `${text.slice(0, limit - 1)}…` : text;
+}
+
+// src/instrument.ts
+var CORE_STATE = { 0: "clean", 1: "check", 2: "dirty" };
+function nodeVersion(n) {
+  return n.core && typeof n.core.version === "number" ? n.core.version : n.runs;
+}
+function nodeState(n) {
+  return n.core && typeof n.core.state === "number" ? CORE_STATE[n.core.state] : void 0;
+}
+
+// src/export.ts
+var at = (source) => {
+  if (!source) return void 0;
+  const where = `${source.file ?? ""}:${source.line ?? ""}:${source.column ?? ""}`;
+  const out = source.compiled;
+  const same = out?.line === source.line && out?.column === source.column;
+  return out && !same ? `${where} (out ${out.line ?? ""}:${out.column ?? ""})` : where;
+};
+function naming(graph) {
+  const seen = /* @__PURE__ */ new Map();
+  for (const node of graph.values()) seen.set(node.label, (seen.get(node.label) ?? 0) + 1);
+  return (id) => {
+    const node = graph.get(id);
+    if (!node) return `#${id}`;
+    return (seen.get(node.label) ?? 0) > 1 ? `${node.label}#${node.id}` : node.label;
+  };
+}
+function exportGraph(graph, options = {}) {
+  const limit = options.limit ?? 400;
+  const name = naming(graph);
+  const nodes = [...graph.values()].map((node) => {
+    let value = node.detail ?? node.value;
+    if (node.read) {
+      try {
+        value = formatValue(node.read(), limit);
+      } catch {
+      }
+    }
+    const feeds = [...node.deps].map(name);
+    const wrote = [...node.writes].map(name);
+    const state = nodeState(node);
+    return {
+      id: node.id,
+      label: node.label,
+      kind: node.kind,
+      ...node.authored === false ? { authored: false } : {},
+      ...value ? { value } : {},
+      ...node.runs ? { runs: node.runs } : {},
+      // Only a node with a core has one; a static node would report a version of 0.
+      ...node.core?.version !== void 0 ? { version: nodeVersion(node) } : {},
+      ...state ? { state } : {},
+      ...feeds.length ? { reads: feeds } : {},
+      ...wrote.length ? { writes: wrote } : {},
+      ...node.createdIn !== void 0 ? { madeIn: name(node.createdIn) } : {},
+      ...at(node.source) ? { source: at(node.source) } : {},
+      ...at(node.declaredAt) ? { declaredAt: at(node.declaredAt) } : {},
+      ...at(node.usedAt) ? { usedAt: at(node.usedAt) } : {},
+      ...node.targets?.length ? {
+        updates: node.targets.map((target) => {
+          const what = target.name ? `${target.name} of ${target.element}` : target.element;
+          const where = at(target.source);
+          return where ? `${what} — ${where}` : what;
+        })
+      } : {},
+      ...node.setAt?.length ? { setAt: node.setAt.map((s) => at(s)).filter(Boolean) } : {}
+    };
+  });
+  return {
+    t: Date.now(),
+    from: options.fromSource ? "source" : "running application",
+    nodes,
+    ...options.events?.length ? { events: [...options.events] } : {}
+  };
+}
+function graphToJson(graph, options = {}) {
+  return JSON.stringify(exportGraph(graph, options), null, 2);
+}
+export {
+  exportGraph,
+  graphToJson
+};