@spearwolf/shadow-objects 0.34.0 → 0.35.0

package/src/inspect/createKernelSnapshot.js

@@ -0,0 +1,247 @@
+import { beQuiet } from "@spearwolf/signalize";
+import { Registry } from "../in-the-dark/Registry.js";
+import {
+  NodeBudget,
+  normalizeInspectRequest
+} from "./normalizeInspectRequest.js";
+import { serializeValue } from "./serializeValue.js";
+const toContextName = (name) => typeof name === "symbol" ? { symbol: name.description ?? "" } : name;
+const routesOnValue = (val) => val != null && val !== false && val !== "";
+const holdsValue = (val) => val != null;
+const isWorkerRealm = () => typeof globalThis.WorkerGlobalScope !== "undefined";
+function createKernelSnapshot(kernel, request) {
+  return beQuiet(() => new KernelSnapshotBuilder(kernel, normalizeInspectRequest(request)).build());
+}
+class KernelSnapshotBuilder {
+  #kernel;
+  #req;
+  #budget;
+  #visited = /* @__PURE__ */ new Set();
+  #truncation = [];
+  #descriptions = /* @__PURE__ */ new Map();
+  #budgetNoted = false;
+  constructor(kernel, req) {
+    this.#kernel = kernel;
+    this.#req = req;
+    this.#budget = new NodeBudget(req.maxNodes);
+  }
+  build() {
+    const all = this.#kernel.traverseLevelOrderBFS();
+    const { filter } = this.#req;
+    const nodes = filter === void 0 ? this.#walk(all) : [];
+    const snapshot = {
+      takenAt: Date.now(),
+      thread: isWorkerRealm() ? "worker" : "main",
+      counts: {
+        entities: all.length,
+        roots: all.filter((e) => !e.hasParent).length,
+        shadowObjects: all.reduce((sum, e) => sum + this.#describe(e.uuid).length, 0)
+      },
+      roots: nodes,
+      globalContexts: this.#globalContexts(all)
+    };
+    if (this.#req.include.has("registry")) {
+      snapshot.registry = { ...this.#kernel.registry.describe(), isDefault: Registry.isDefault(this.#kernel.registry) };
+    }
+    if (this.#truncation.length > 0) snapshot.truncation = this.#truncation;
+    if (filter !== void 0) snapshot.search = this.#search(all, filter);
+    return snapshot;
+  }
+  #walk(all) {
+    const roots = this.#roots(all);
+    const named = this.#req.rootUuids !== void 0;
+    const nodes = [];
+    for (const root of roots) {
+      if (this.#visited.has(root.uuid)) continue;
+      if (!this.#budget.take()) {
+        this.#noteBudget(void 0);
+        break;
+      }
+      const node = this.#node(root, 0);
+      if (named) node.ancestors = this.#ancestors(root);
+      nodes.push(node);
+    }
+    return nodes;
+  }
+  /** The chain above an entity, top down, without the entity itself. */
+  #ancestors(entity) {
+    const chain = [];
+    for (let ancestor = entity.parent; ancestor !== void 0; ancestor = ancestor.parent) {
+      chain.unshift({ uuid: ancestor.uuid, token: this.#kernel.tokenOf(ancestor.uuid) ?? "" });
+    }
+    return chain;
+  }
+  #search(all, filter) {
+    const matches = [];
+    let total = 0;
+    for (const entity of all) {
+      if (!this.#matches(entity, filter)) continue;
+      total++;
+      if (matches.length < filter.limit) {
+        const token = this.#kernel.tokenOf(entity.uuid) ?? "";
+        matches.push({ uuid: entity.uuid, token, path: [...this.#ancestors(entity).map((a) => a.token), token] });
+      }
+    }
+    return { matches, total };
+  }
+  #matches(entity, filter) {
+    const { token, propName, shadowObject, contextName } = filter;
+    if (token !== void 0 && this.#kernel.tokenOf(entity.uuid) !== token) return false;
+    if (propName !== void 0 && !entity.propKeys().includes(propName)) return false;
+    if (shadowObject !== void 0 && !this.#describe(entity.uuid).some((d) => d.displayName === shadowObject)) return false;
+    if (contextName !== void 0 && !entity.contextNames().includes(contextName)) return false;
+    return true;
+  }
+  #roots(all) {
+    const { rootUuids } = this.#req;
+    if (rootUuids === void 0) return all.filter((e) => !e.hasParent);
+    const roots = [];
+    for (const uuid of rootUuids) {
+      const entity = this.#kernel.findEntity(uuid);
+      if (entity === void 0) {
+        this.#truncation.push({ reason: "unknown-root", uuid, message: `the kernel holds no entity "${uuid}"` });
+      } else {
+        roots.push(entity);
+      }
+    }
+    return roots;
+  }
+  #noteBudget(uuid) {
+    if (this.#budgetNoted) return;
+    this.#budgetNoted = true;
+    const note = {
+      reason: "max-nodes",
+      message: `maxNodes ${this.#req.maxNodes} reached; ask again with rootUuids below the last node written`
+    };
+    if (uuid !== void 0) note.uuid = uuid;
+    this.#truncation.push(note);
+  }
+  #describe(uuid) {
+    let descriptions = this.#descriptions.get(uuid);
+    if (descriptions === void 0) {
+      descriptions = this.#kernel.describeShadowObjects(uuid);
+      this.#descriptions.set(uuid, descriptions);
+    }
+    return descriptions;
+  }
+  #serialize(val) {
+    return serializeValue(val, this.#req.limits);
+  }
+  #node(entity, depth) {
+    const { uuid } = entity;
+    this.#visited.add(uuid);
+    const node = {
+      uuid,
+      token: this.#kernel.tokenOf(uuid) ?? "",
+      order: entity.order,
+      autoDestructionOnParentRemoval: entity.autoDestructionOnParentRemoval,
+      childCount: entity.children.length
+    };
+    if (entity.parentUuid !== void 0) node.parentUuid = entity.parentUuid;
+    const { include } = this.#req;
+    if (include.has("props")) node.props = this.#props(entity);
+    if (include.has("shadowObjects")) node.shadowObjects = this.#describe(uuid).map(toShadowObjectSnapshot);
+    if (include.has("contexts")) node.contexts = this.#contexts(entity);
+    if (depth < this.#req.maxDepth) {
+      this.#children(entity, node, depth);
+    } else if (entity.children.length > 0) {
+      this.#truncation.push({
+        reason: "max-depth",
+        uuid,
+        message: `the children of "${uuid}" were not walked: maxDepth ${this.#req.maxDepth} reached; ask again with rootUuids: ["${uuid}"]`
+      });
+    }
+    return node;
+  }
+  #children(entity, node, depth) {
+    const children = [];
+    const omitted = [];
+    for (const child of entity.children) {
+      if (this.#kernel.findEntity(child.uuid) === void 0) {
+        omitted.push({ uuid: child.uuid, reason: "not-in-kernel" });
+        continue;
+      }
+      if (this.#visited.has(child.uuid)) {
+        omitted.push({ uuid: child.uuid, reason: "already-in-graph" });
+        continue;
+      }
+      if (!this.#budget.take()) {
+        this.#noteBudget(entity.uuid);
+        break;
+      }
+      children.push(this.#node(child, depth + 1));
+    }
+    node.children = children;
+    if (omitted.length > 0) node.omittedChildren = omitted;
+  }
+  #props(entity) {
+    return entity.propEntries().map(([name, val]) => ({ name, value: this.#serialize(val), routes: routesOnValue(val) }));
+  }
+  #contexts(entity) {
+    const descriptions = this.#describe(entity.uuid);
+    return entity.contextNames().map((name) => {
+      const ctx = entity.describeContext(name);
+      const snapshot = {
+        name: toContextName(name),
+        effective: this.#serialize(ctx.effective),
+        providedBy: descriptions.filter((d) => d.providesContexts.includes(name)).map((d) => d.displayName),
+        source: this.#sourceOf(entity, name, ctx.provided)
+      };
+      if (ctx.provided !== void 0) snapshot.provided = this.#serialize(ctx.provided);
+      if (ctx.inherited !== void 0) snapshot.inherited = this.#serialize(ctx.inherited);
+      return snapshot;
+    });
+  }
+  #sourceOf(entity, name, provided) {
+    if (holdsValue(provided)) return { kind: "self" };
+    for (let ancestor = entity.parent; ancestor !== void 0; ancestor = ancestor.parent) {
+      if (holdsValue(ancestor.describeContext(name)?.provided)) return { kind: "ancestor", uuid: ancestor.uuid };
+    }
+    if (holdsValue(this.#kernel.describeRootContext(name)?.value)) return { kind: "global" };
+    return { kind: "none" };
+  }
+  #globalContexts(all) {
+    const contributors = /* @__PURE__ */ new Map();
+    for (const entity of all) {
+      for (const name of entity.globalContextNames()) {
+        let byEntity = contributors.get(name);
+        if (byEntity === void 0) contributors.set(name, byEntity = /* @__PURE__ */ new Map());
+        byEntity.set(entity.describeGlobalContext(name).signal, entity);
+      }
+    }
+    const snapshots = [];
+    for (const name of this.#kernel.rootContextNames()) {
+      const chain = this.#kernel.describeRootContext(name);
+      if (chain.signals.length === 0) continue;
+      const byEntity = contributors.get(name);
+      const providers = [];
+      for (const signal of chain.signals) {
+        const entity = byEntity?.get(signal);
+        if (entity === void 0) continue;
+        providers.push({
+          uuid: entity.uuid,
+          providedBy: this.#describe(entity.uuid).filter((d) => d.providesGlobalContexts.includes(name)).map((d) => d.displayName),
+          value: this.#serialize(entity.describeGlobalContext(name).value)
+        });
+      }
+      snapshots.push({ name: toContextName(name), value: this.#serialize(chain.value), providers });
+    }
+    return snapshots;
+  }
+}
+const toShadowObjectSnapshot = (d) => ({
+  displayName: d.displayName,
+  definedUnder: d.definedUnder,
+  usesProperties: d.usesProperties,
+  usesContexts: d.usesContexts.map(toContextName),
+  usesParentContexts: d.usesParentContexts.map(toContextName),
+  providesContexts: d.providesContexts.map(toContextName),
+  providesGlobalContexts: d.providesGlobalContexts.map(toContextName),
+  hooks: d.hooks
+});
+export {
+  createKernelSnapshot,
+  routesOnValue,
+  toContextName
+};
+//# sourceMappingURL=createKernelSnapshot.js.map

package/src/inspect/createKernelSnapshot.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/inspect/createKernelSnapshot.ts"],
+  "sourcesContent": ["import {beQuiet, type SignalLike} from '@spearwolf/signalize';\nimport type {Entity} from '../in-the-dark/Entity.js';\nimport type {Kernel} from '../in-the-dark/Kernel.js';\nimport {Registry} from '../in-the-dark/Registry.js';\nimport type {ShadowObjectDescription} from '../types.js';\nimport {\n  NodeBudget,\n  type NormalizedEntityFilter,\n  type NormalizedInspectRequest,\n  normalizeInspectRequest,\n} from './normalizeInspectRequest.js';\nimport {serializeValue} from './serializeValue.js';\nimport type {\n  ContextName,\n  EntityContextSnapshot,\n  EntityContextSource,\n  EntityMatch,\n  EntityNodeSnapshot,\n  EntitySearchSnapshot,\n  GlobalContextSnapshot,\n  InspectRequest,\n  KernelSnapshot,\n  PropSnapshot,\n  SerializedValue,\n  ShadowObjectSnapshot,\n  TruncationNote,\n} from './types.js';\n\n/** A string name as it is; a symbol as its description, marked as such. */\nexport const toContextName = (name: string | symbol): ContextName =>\n  typeof name === 'symbol' ? {symbol: name.description ?? ''} : name;\n\n/** The rule `Entity.truthyProps()` routes by. */\nexport const routesOnValue = (val: unknown): boolean => val != null && val !== false && val !== '';\n\n/** The rule `SignalsPath` resolves a chain by: a provider holding `null` is passed over. */\nconst holdsValue = (val: unknown): boolean => val != null;\n\nconst isWorkerRealm = (): boolean => typeof (globalThis as {WorkerGlobalScope?: unknown}).WorkerGlobalScope !== 'undefined';\n\n/**\n * A plain-data picture of the Entity Tree behind a Kernel, cut by the limits of the request: every\n * visited Entity with its properties, Shadow Objects and Entity Contexts, the global context chains,\n * and the Registry. Synchronous, read-only, and quiet -- no signal read here subscribes anything.\n *\n * The walk follows the rules of `getEntityGraph()`: every Entity appears once, a child the Kernel no\n * longer holds or the walk has already placed is named under `omittedChildren`. What this adds is\n * the depth and node budget, and the `truncation` notes that say where a budget cut the walk.\n */\nexport function createKernelSnapshot(kernel: Kernel, request?: InspectRequest): KernelSnapshot {\n  return beQuiet(() => new KernelSnapshotBuilder(kernel, normalizeInspectRequest(request)).build());\n}\n\nclass KernelSnapshotBuilder {\n  readonly #kernel: Kernel;\n  readonly #req: NormalizedInspectRequest;\n  readonly #budget: NodeBudget;\n  readonly #visited = new Set<string>();\n  readonly #truncation: TruncationNote[] = [];\n  readonly #descriptions = new Map<string, ShadowObjectDescription[]>();\n  #budgetNoted = false;\n\n  constructor(kernel: Kernel, req: NormalizedInspectRequest) {\n    this.#kernel = kernel;\n    this.#req = req;\n    this.#budget = new NodeBudget(req.maxNodes);\n  }\n\n  build(): KernelSnapshot {\n    const all = this.#kernel.traverseLevelOrderBFS();\n    const {filter} = this.#req;\n\n    // a search reads every entity and ships none of the tree: the matches are the answer\n    const nodes = filter === undefined ? this.#walk(all) : [];\n\n    const snapshot: KernelSnapshot = {\n      takenAt: Date.now(),\n      thread: isWorkerRealm() ? 'worker' : 'main',\n      counts: {\n        entities: all.length,\n        roots: all.filter((e) => !e.hasParent).length,\n        shadowObjects: all.reduce((sum, e) => sum + this.#describe(e.uuid).length, 0),\n      },\n      roots: nodes,\n      globalContexts: this.#globalContexts(all),\n    };\n\n    if (this.#req.include.has('registry')) {\n      snapshot.registry = {...this.#kernel.registry.describe(), isDefault: Registry.isDefault(this.#kernel.registry)};\n    }\n    if (this.#truncation.length > 0) snapshot.truncation = this.#truncation;\n    if (filter !== undefined) snapshot.search = this.#search(all, filter);\n\n    return snapshot;\n  }\n\n  #walk(all: Entity[]): EntityNodeSnapshot[] {\n    const roots = this.#roots(all);\n    const named = this.#req.rootUuids !== undefined;\n\n    const nodes: EntityNodeSnapshot[] = [];\n    for (const root of roots) {\n      // a root reached through an earlier root's subtree (a back-edge into the root set) drops\n      // from the top level without a note, same as `getEntityGraph()`'s top-level `visited` check\n      if (this.#visited.has(root.uuid)) continue;\n      if (!this.#budget.take()) {\n        this.#noteBudget(undefined);\n        break;\n      }\n      const node = this.#node(root, 0);\n      // only a caller that named the root wants to know what is above it\n      if (named) node.ancestors = this.#ancestors(root);\n      nodes.push(node);\n    }\n    return nodes;\n  }\n\n  /** The chain above an entity, top down, without the entity itself. */\n  #ancestors(entity: Entity): {uuid: string; token: string}[] {\n    const chain: {uuid: string; token: string}[] = [];\n    // the parent chain is a chain: Entity.assertAttachableTo() refuses a parent that is a descendant\n    for (let ancestor = entity.parent; ancestor !== undefined; ancestor = ancestor.parent) {\n      chain.unshift({uuid: ancestor.uuid, token: this.#kernel.tokenOf(ancestor.uuid) ?? ''});\n    }\n    return chain;\n  }\n\n  #search(all: Entity[], filter: NormalizedEntityFilter): EntitySearchSnapshot {\n    const matches: EntityMatch[] = [];\n    let total = 0;\n    for (const entity of all) {\n      if (!this.#matches(entity, filter)) continue;\n      total++;\n      if (matches.length < filter.limit) {\n        const token = this.#kernel.tokenOf(entity.uuid) ?? '';\n        matches.push({uuid: entity.uuid, token, path: [...this.#ancestors(entity).map((a) => a.token), token]});\n      }\n    }\n    return {matches, total};\n  }\n\n  #matches(entity: Entity, filter: NormalizedEntityFilter): boolean {\n    const {token, propName, shadowObject, contextName} = filter;\n    if (token !== undefined && this.#kernel.tokenOf(entity.uuid) !== token) return false;\n    if (propName !== undefined && !entity.propKeys().includes(propName)) return false;\n    if (shadowObject !== undefined && !this.#describe(entity.uuid).some((d) => d.displayName === shadowObject)) return false;\n    if (contextName !== undefined && !entity.contextNames().includes(contextName)) return false;\n    return true;\n  }\n\n  #roots(all: Entity[]): Entity[] {\n    const {rootUuids} = this.#req;\n    if (rootUuids === undefined) return all.filter((e) => !e.hasParent);\n\n    const roots: Entity[] = [];\n    for (const uuid of rootUuids) {\n      const entity = this.#kernel.findEntity(uuid);\n      if (entity === undefined) {\n        this.#truncation.push({reason: 'unknown-root', uuid, message: `the kernel holds no entity \"${uuid}\"`});\n      } else {\n        roots.push(entity);\n      }\n    }\n    return roots;\n  }\n\n  #noteBudget(uuid: string | undefined): void {\n    if (this.#budgetNoted) return;\n    this.#budgetNoted = true;\n    const note: TruncationNote = {\n      reason: 'max-nodes',\n      message: `maxNodes ${this.#req.maxNodes} reached; ask again with rootUuids below the last node written`,\n    };\n    if (uuid !== undefined) note.uuid = uuid;\n    this.#truncation.push(note);\n  }\n\n  #describe(uuid: string): ShadowObjectDescription[] {\n    let descriptions = this.#descriptions.get(uuid);\n    if (descriptions === undefined) {\n      descriptions = this.#kernel.describeShadowObjects(uuid);\n      this.#descriptions.set(uuid, descriptions);\n    }\n    return descriptions;\n  }\n\n  #serialize(val: unknown): SerializedValue {\n    return serializeValue(val, this.#req.limits);\n  }\n\n  #node(entity: Entity, depth: number): EntityNodeSnapshot {\n    const {uuid} = entity;\n    this.#visited.add(uuid);\n\n    const node: EntityNodeSnapshot = {\n      uuid,\n      token: this.#kernel.tokenOf(uuid) ?? '',\n      order: entity.order,\n      autoDestructionOnParentRemoval: entity.autoDestructionOnParentRemoval,\n      childCount: entity.children.length,\n    };\n    if (entity.parentUuid !== undefined) node.parentUuid = entity.parentUuid;\n\n    const {include} = this.#req;\n    if (include.has('props')) node.props = this.#props(entity);\n    if (include.has('shadowObjects')) node.shadowObjects = this.#describe(uuid).map(toShadowObjectSnapshot);\n    if (include.has('contexts')) node.contexts = this.#contexts(entity);\n\n    if (depth < this.#req.maxDepth) {\n      this.#children(entity, node, depth);\n    } else if (entity.children.length > 0) {\n      this.#truncation.push({\n        reason: 'max-depth',\n        uuid,\n        message: `the children of \"${uuid}\" were not walked: maxDepth ${this.#req.maxDepth} reached; ask again with rootUuids: [\"${uuid}\"]`,\n      });\n    }\n\n    return node;\n  }\n\n  #children(entity: Entity, node: EntityNodeSnapshot, depth: number): void {\n    const children: EntityNodeSnapshot[] = [];\n    const omitted: NonNullable<EntityNodeSnapshot['omittedChildren']> = [];\n\n    for (const child of entity.children) {\n      // the kernel lookup first, so a uuid the kernel does not hold is named at every parent that\n      // lists it -- the same order `getEntityGraph()` keeps\n      if (this.#kernel.findEntity(child.uuid) === undefined) {\n        omitted.push({uuid: child.uuid, reason: 'not-in-kernel'});\n        continue;\n      }\n      if (this.#visited.has(child.uuid)) {\n        omitted.push({uuid: child.uuid, reason: 'already-in-graph'});\n        continue;\n      }\n      if (!this.#budget.take()) {\n        this.#noteBudget(entity.uuid);\n        break;\n      }\n      children.push(this.#node(child, depth + 1));\n    }\n\n    node.children = children;\n    if (omitted.length > 0) node.omittedChildren = omitted;\n  }\n\n  #props(entity: Entity): PropSnapshot[] {\n    return entity.propEntries().map(([name, val]) => ({name, value: this.#serialize(val), routes: routesOnValue(val)}));\n  }\n\n  #contexts(entity: Entity): EntityContextSnapshot[] {\n    const descriptions = this.#describe(entity.uuid);\n\n    return entity.contextNames().map((name) => {\n      // the entity holds the name, `contextNames()` just said so\n      const ctx = entity.describeContext(name)!;\n      const snapshot: EntityContextSnapshot = {\n        name: toContextName(name),\n        effective: this.#serialize(ctx.effective),\n        providedBy: descriptions.filter((d) => d.providesContexts.includes(name)).map((d) => d.displayName),\n        source: this.#sourceOf(entity, name, ctx.provided),\n      };\n      if (ctx.provided !== undefined) snapshot.provided = this.#serialize(ctx.provided);\n      if (ctx.inherited !== undefined) snapshot.inherited = this.#serialize(ctx.inherited);\n      return snapshot;\n    });\n  }\n\n  #sourceOf(entity: Entity, name: string | symbol, provided: unknown): EntityContextSource {\n    if (holdsValue(provided)) return {kind: 'self'};\n    // the parent chain is a chain: Entity.assertAttachableTo() refuses a parent that is a descendant\n    for (let ancestor = entity.parent; ancestor !== undefined; ancestor = ancestor.parent) {\n      if (holdsValue(ancestor.describeContext(name)?.provided)) return {kind: 'ancestor', uuid: ancestor.uuid};\n    }\n    if (holdsValue(this.#kernel.describeRootContext(name)?.value)) return {kind: 'global'};\n    return {kind: 'none'};\n  }\n\n  #globalContexts(all: Entity[]): GlobalContextSnapshot[] {\n    // signal -> contributing entity, per name; the chain hands out the same signal objects\n    const contributors = new Map<string | symbol, Map<SignalLike<any>, Entity>>();\n    for (const entity of all) {\n      for (const name of entity.globalContextNames()) {\n        let byEntity = contributors.get(name);\n        if (byEntity === undefined) contributors.set(name, (byEntity = new Map()));\n        byEntity.set(entity.describeGlobalContext(name)!.signal, entity);\n      }\n    }\n\n    const snapshots: GlobalContextSnapshot[] = [];\n    for (const name of this.#kernel.rootContextNames()) {\n      const chain = this.#kernel.describeRootContext(name)!;\n      // a chain without members is the lookup stub a root entity's `useContext()` leaves behind\n      if (chain.signals.length === 0) continue;\n\n      const byEntity = contributors.get(name);\n      const providers: GlobalContextSnapshot['providers'] = [];\n      for (const signal of chain.signals) {\n        const entity = byEntity?.get(signal);\n        if (entity === undefined) continue;\n        providers.push({\n          uuid: entity.uuid,\n          providedBy: this.#describe(entity.uuid)\n            .filter((d) => d.providesGlobalContexts.includes(name))\n            .map((d) => d.displayName),\n          value: this.#serialize(entity.describeGlobalContext(name)!.value),\n        });\n      }\n      snapshots.push({name: toContextName(name), value: this.#serialize(chain.value), providers});\n    }\n    return snapshots;\n  }\n}\n\nconst toShadowObjectSnapshot = (d: ShadowObjectDescription): ShadowObjectSnapshot => ({\n  displayName: d.displayName,\n  definedUnder: d.definedUnder,\n  usesProperties: d.usesProperties,\n  usesContexts: d.usesContexts.map(toContextName),\n  usesParentContexts: d.usesParentContexts.map(toContextName),\n  providesContexts: d.providesContexts.map(toContextName),\n  providesGlobalContexts: d.providesGlobalContexts.map(toContextName),\n  hooks: d.hooks,\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/src/inspect/createViewSnapshot.d.ts

@@ -0,0 +1,10 @@
+import type { ComponentContext } from '../view/ComponentContext.js';
+import type { InspectRequest, ViewSnapshot } from './types.js';
+/**
+ * A plain-data picture of the component tree a `ComponentContext` holds, cut by the limits of the
+ * request. Structure comes from the live components; properties come from the Component Memory,
+ * which holds the last committed state -- a component created and not yet synced has no `props`.
+ * Reads only; the pending changes are never built.
+ */
+export declare function createViewSnapshot(context: ComponentContext, request?: InspectRequest): ViewSnapshot;
+//# sourceMappingURL=createViewSnapshot.d.ts.map

package/src/inspect/createViewSnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createViewSnapshot.d.ts","sourceRoot":"","sources":["../../../src/inspect/createViewSnapshot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,6BAA6B,CAAC;AAKlE,OAAO,KAAK,EAAC,cAAc,EAAuD,YAAY,EAAC,MAAM,YAAY,CAAC;AAkClH;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,YAAY,CAEpG"}

package/src/inspect/createViewSnapshot.js

@@ -0,0 +1,143 @@
+import { SHAE_ENT } from "../elements/constants.js";
+import { routesOnValue } from "./createKernelSnapshot.js";
+import { NodeBudget, normalizeInspectRequest } from "./normalizeInspectRequest.js";
+import { serializeValue } from "./serializeValue.js";
+const SIMPLE_ID = /^[A-Za-z_][\w-]*$/;
+const selectorPath = (el) => {
+  const parts = [];
+  for (let node = el; node !== null; node = node.parentElement) {
+    if (node.id && SIMPLE_ID.test(node.id)) {
+      parts.unshift(`#${node.id}`);
+      break;
+    }
+    const parent = node.parentElement;
+    if (parent === null) {
+      parts.unshift(node.localName);
+      break;
+    }
+    const sameTag = Array.from(parent.children).filter((sibling) => sibling.localName === node.localName);
+    parts.unshift(`${node.localName}:nth-of-type(${sameTag.indexOf(node) + 1})`);
+  }
+  return parts.join(" > ");
+};
+const indexEntElements = () => {
+  const index = /* @__PURE__ */ new Map();
+  if (typeof document === "undefined") return index;
+  for (const el of Array.from(document.querySelectorAll(SHAE_ENT))) {
+    const uuid = el.uuid;
+    if (typeof uuid === "string" && !index.has(uuid)) index.set(uuid, selectorPath(el));
+  }
+  return index;
+};
+function createViewSnapshot(context, request) {
+  return new ViewSnapshotBuilder(context, normalizeInspectRequest(request)).build();
+}
+class ViewSnapshotBuilder {
+  #ctx;
+  #req;
+  #budget;
+  #visited = /* @__PURE__ */ new Set();
+  #truncation = [];
+  #elements;
+  #budgetNoted = false;
+  constructor(ctx, req) {
+    this.#ctx = ctx;
+    this.#req = req;
+    this.#budget = new NodeBudget(req.maxNodes);
+    this.#elements = indexEntElements();
+  }
+  build() {
+    const all = this.#ctx.traverseLevelOrderBFS();
+    const roots = this.#roots(all);
+    const nodes = [];
+    for (const root of roots) {
+      if (this.#visited.has(root.uuid)) continue;
+      if (!this.#budget.take()) {
+        this.#noteBudget(root.parent?.uuid);
+        break;
+      }
+      nodes.push(this.#node(root, 0));
+    }
+    const snapshot = {
+      takenAt: Date.now(),
+      counts: { components: all.length, roots: all.filter((c) => c.parent === void 0).length },
+      roots: nodes
+    };
+    if (this.#truncation.length > 0) snapshot.truncation = this.#truncation;
+    return snapshot;
+  }
+  #roots(all) {
+    const { rootUuids } = this.#req;
+    if (rootUuids === void 0) return all.filter((c) => c.parent === void 0);
+    const byUuid = new Map(all.map((c) => [c.uuid, c]));
+    const roots = [];
+    for (const uuid of rootUuids) {
+      const component = byUuid.get(uuid);
+      if (component === void 0) {
+        this.#truncation.push({ reason: "unknown-root", uuid, message: `the component context holds no component "${uuid}"` });
+      } else {
+        roots.push(component);
+      }
+    }
+    return roots;
+  }
+  #noteBudget(uuid) {
+    if (this.#budgetNoted) return;
+    this.#budgetNoted = true;
+    const note = {
+      reason: "max-nodes",
+      message: `maxNodes ${this.#req.maxNodes} reached; ask again with rootUuids below the last node written`
+    };
+    if (uuid !== void 0) note.uuid = uuid;
+    this.#truncation.push(note);
+  }
+  #node(component, depth) {
+    const { uuid } = component;
+    this.#visited.add(uuid);
+    const children = this.#ctx.getChildren(component);
+    const node = { uuid, token: component.token, order: component.order, childCount: children.length };
+    if (component.parent !== void 0) node.parentUuid = component.parent.uuid;
+    const element = this.#elements.get(uuid);
+    if (element !== void 0) node.element = element;
+    if (this.#req.include.has("props")) {
+      const props = this.#props(uuid);
+      if (props !== void 0) node.props = props;
+    }
+    if (depth < this.#req.maxDepth) {
+      const walked = [];
+      const omitted = [];
+      for (const child of children) {
+        if (this.#visited.has(child.uuid)) {
+          omitted.push({ uuid: child.uuid, reason: "already-in-graph" });
+          continue;
+        }
+        if (!this.#budget.take()) {
+          this.#noteBudget(uuid);
+          break;
+        }
+        walked.push(this.#node(child, depth + 1));
+      }
+      node.children = walked;
+      if (omitted.length > 0) node.omittedChildren = omitted;
+    } else if (children.length > 0) {
+      this.#truncation.push({
+        reason: "max-depth",
+        uuid,
+        message: `the children of "${uuid}" were not walked: maxDepth ${this.#req.maxDepth} reached; ask again with rootUuids: ["${uuid}"]`
+      });
+    }
+    return node;
+  }
+  #props(uuid) {
+    const properties = this.#ctx.getComponentState(uuid)?.properties;
+    if (properties === void 0) return void 0;
+    return properties.map((entry) => {
+      const val = entry.length === 2 ? entry[1] : void 0;
+      return { name: entry[0], value: serializeValue(val, this.#req.limits), routes: routesOnValue(val) };
+    });
+  }
+}
+export {
+  createViewSnapshot
+};
+//# sourceMappingURL=createViewSnapshot.js.map

package/src/inspect/createViewSnapshot.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/inspect/createViewSnapshot.ts"],
+  "sourcesContent": ["import {SHAE_ENT} from '../elements/constants.js';\nimport type {ComponentContext} from '../view/ComponentContext.js';\nimport type {ViewComponent} from '../view/ViewComponent.js';\nimport {routesOnValue} from './createKernelSnapshot.js';\nimport {NodeBudget, type NormalizedInspectRequest, normalizeInspectRequest} from './normalizeInspectRequest.js';\nimport {serializeValue} from './serializeValue.js';\nimport type {InspectRequest, PropSnapshot, TruncationNote, ViewComponentSnapshot, ViewSnapshot} from './types.js';\n\nconst SIMPLE_ID = /^[A-Za-z_][\\w-]*$/;\n\n/** A selector path from the nearest ancestor with a simple id (or the document root) down to `el`. */\nconst selectorPath = (el: Element): string => {\n  const parts: string[] = [];\n  for (let node: Element | null = el; node !== null; node = node.parentElement) {\n    if (node.id && SIMPLE_ID.test(node.id)) {\n      parts.unshift(`#${node.id}`);\n      break;\n    }\n    const parent = node.parentElement;\n    if (parent === null) {\n      parts.unshift(node.localName);\n      break;\n    }\n    const sameTag = Array.from(parent.children).filter((sibling) => sibling.localName === node!.localName);\n    parts.unshift(`${node.localName}:nth-of-type(${sameTag.indexOf(node) + 1})`);\n  }\n  return parts.join(' > ');\n};\n\n/** uuid -> selector path of the `<shae-ent>` carrying it. Empty without a document, and for elements inside shadow roots (the query pierces none, open or closed). */\nconst indexEntElements = (): Map<string, string> => {\n  const index = new Map<string, string>();\n  if (typeof document === 'undefined') return index;\n  for (const el of Array.from(document.querySelectorAll(SHAE_ENT))) {\n    const uuid = (el as {uuid?: unknown}).uuid;\n    if (typeof uuid === 'string' && !index.has(uuid)) index.set(uuid, selectorPath(el));\n  }\n  return index;\n};\n\n/**\n * A plain-data picture of the component tree a `ComponentContext` holds, cut by the limits of the\n * request. Structure comes from the live components; properties come from the Component Memory,\n * which holds the last committed state -- a component created and not yet synced has no `props`.\n * Reads only; the pending changes are never built.\n */\nexport function createViewSnapshot(context: ComponentContext, request?: InspectRequest): ViewSnapshot {\n  return new ViewSnapshotBuilder(context, normalizeInspectRequest(request)).build();\n}\n\nclass ViewSnapshotBuilder {\n  readonly #ctx: ComponentContext;\n  readonly #req: NormalizedInspectRequest;\n  readonly #budget: NodeBudget;\n  readonly #visited = new Set<string>();\n  readonly #truncation: TruncationNote[] = [];\n  readonly #elements: Map<string, string>;\n  #budgetNoted = false;\n\n  constructor(ctx: ComponentContext, req: NormalizedInspectRequest) {\n    this.#ctx = ctx;\n    this.#req = req;\n    this.#budget = new NodeBudget(req.maxNodes);\n    this.#elements = indexEntElements();\n  }\n\n  build(): ViewSnapshot {\n    const all = this.#ctx.traverseLevelOrderBFS();\n    const roots = this.#roots(all);\n\n    const nodes: ViewComponentSnapshot[] = [];\n    for (const root of roots) {\n      // a root reached through an earlier root's subtree drops from the top level without a note,\n      // the way the Kernel builder drops one\n      if (this.#visited.has(root.uuid)) continue;\n      if (!this.#budget.take()) {\n        this.#noteBudget(root.parent?.uuid);\n        break;\n      }\n      nodes.push(this.#node(root, 0));\n    }\n\n    const snapshot: ViewSnapshot = {\n      takenAt: Date.now(),\n      counts: {components: all.length, roots: all.filter((c) => c.parent === undefined).length},\n      roots: nodes,\n    };\n    if (this.#truncation.length > 0) snapshot.truncation = this.#truncation;\n    return snapshot;\n  }\n\n  #roots(all: ViewComponent[]): ViewComponent[] {\n    const {rootUuids} = this.#req;\n    if (rootUuids === undefined) return all.filter((c) => c.parent === undefined);\n\n    const byUuid = new Map(all.map((c) => [c.uuid, c]));\n    const roots: ViewComponent[] = [];\n    for (const uuid of rootUuids) {\n      const component = byUuid.get(uuid);\n      if (component === undefined) {\n        this.#truncation.push({reason: 'unknown-root', uuid, message: `the component context holds no component \"${uuid}\"`});\n      } else {\n        roots.push(component);\n      }\n    }\n    return roots;\n  }\n\n  #noteBudget(uuid: string | undefined): void {\n    if (this.#budgetNoted) return;\n    this.#budgetNoted = true;\n    const note: TruncationNote = {\n      reason: 'max-nodes',\n      message: `maxNodes ${this.#req.maxNodes} reached; ask again with rootUuids below the last node written`,\n    };\n    if (uuid !== undefined) note.uuid = uuid;\n    this.#truncation.push(note);\n  }\n\n  #node(component: ViewComponent, depth: number): ViewComponentSnapshot {\n    const {uuid} = component;\n    this.#visited.add(uuid);\n    const children = this.#ctx.getChildren(component);\n\n    // the setter coerces a missing token to VoidToken, so the getter never actually reads back undefined --\n    // TS 7's inference of the split accessor widens the read type regardless\n    const node: ViewComponentSnapshot = {uuid, token: component.token!, order: component.order, childCount: children.length};\n    if (component.parent !== undefined) node.parentUuid = component.parent.uuid;\n\n    const element = this.#elements.get(uuid);\n    if (element !== undefined) node.element = element;\n\n    if (this.#req.include.has('props')) {\n      const props = this.#props(uuid);\n      if (props !== undefined) node.props = props;\n    }\n\n    if (depth < this.#req.maxDepth) {\n      const walked: ViewComponentSnapshot[] = [];\n      const omitted: NonNullable<ViewComponentSnapshot['omittedChildren']> = [];\n      for (const child of children) {\n        // `addToChildren()` writes a children list without taking the child out of the one it\n        // already stands in, so a component can be reached twice and a list can point at an ancestor\n        if (this.#visited.has(child.uuid)) {\n          omitted.push({uuid: child.uuid, reason: 'already-in-graph'});\n          continue;\n        }\n        if (!this.#budget.take()) {\n          this.#noteBudget(uuid);\n          break;\n        }\n        walked.push(this.#node(child, depth + 1));\n      }\n      node.children = walked;\n      if (omitted.length > 0) node.omittedChildren = omitted;\n    } else if (children.length > 0) {\n      this.#truncation.push({\n        reason: 'max-depth',\n        uuid,\n        message: `the children of \"${uuid}\" were not walked: maxDepth ${this.#req.maxDepth} reached; ask again with rootUuids: [\"${uuid}\"]`,\n      });\n    }\n\n    return node;\n  }\n\n  #props(uuid: string): PropSnapshot[] | undefined {\n    const properties = this.#ctx.getComponentState(uuid)?.properties;\n    if (properties === undefined) return undefined;\n    return properties.map((entry) => {\n      const val = entry.length === 2 ? entry[1] : undefined;\n      return {name: entry[0], value: serializeValue(val, this.#req.limits), routes: routesOnValue(val)};\n    });\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/src/inspect/normalizeInspectRequest.d.ts

@@ -0,0 +1,32 @@
+import type { InspectInclude, InspectRequest, SerializeLimits } from './types.js';
+export declare const InspectDefaults: Readonly<{
+    maxDepth: 4;
+    maxDepthCap: 64;
+    maxNodes: 250;
+    maxMatches: 50;
+}>;
+export interface NormalizedInspectRequest {
+    include: Set<InspectInclude>;
+    rootUuids: string[] | undefined;
+    maxDepth: number;
+    maxNodes: number;
+    limits: SerializeLimits;
+    filter: NormalizedEntityFilter | undefined;
+}
+/** A filter with every criterion present, `undefined` where the caller gave none, and the limit filled in. */
+export interface NormalizedEntityFilter {
+    token: string | undefined;
+    propName: string | undefined;
+    shadowObject: string | undefined;
+    contextName: string | undefined;
+    limit: number;
+}
+/** Fills the defaults of spec §8.1 in and clamps what the caller gave. */
+export declare const normalizeInspectRequest: (request?: InspectRequest) => NormalizedInspectRequest;
+/** Counts the nodes a walk may still emit. `take()` answers `false` once the budget is spent. */
+export declare class NodeBudget {
+    #private;
+    constructor(max: number);
+    take(): boolean;
+}
+//# sourceMappingURL=normalizeInspectRequest.d.ts.map

package/src/inspect/normalizeInspectRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeInspectRequest.d.ts","sourceRoot":"","sources":["../../../src/inspect/normalizeInspectRequest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,cAAc,EAAE,cAAc,EAAE,eAAe,EAAC,MAAM,YAAY,CAAC;AAE9F,eAAO,MAAM,eAAe;;;;;EAK1B,CAAC;AAIH,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,sBAAsB,GAAG,SAAS,CAAC;CAC5C;AAED,8GAA8G;AAC9G,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;CACf;AA+BD,0EAA0E;AAC1E,eAAO,MAAM,uBAAuB,aAAc,cAAc,KAAG,wBAOjE,CAAC;AAEH,iGAAiG;AACjG,qBAAa,UAAU;;IAGrB,YAAY,GAAG,EAAE,MAAM,EAEtB;IAED,IAAI,IAAI,OAAO,CAId;CACF"}

package/src/inspect/normalizeInspectRequest.js

@@ -0,0 +1,55 @@
+import { resolveSerializeLimits } from "./serializeValue.js";
+const InspectDefaults = Object.freeze({
+  maxDepth: 4,
+  maxDepthCap: 64,
+  maxNodes: 250,
+  maxMatches: 50
+});
+const AllIncludes = ["props", "shadowObjects", "contexts", "registry"];
+const clampDepth = (depth) => {
+  if (depth === void 0) return InspectDefaults.maxDepth;
+  if (!Number.isFinite(depth)) return InspectDefaults.maxDepthCap;
+  return Math.min(InspectDefaults.maxDepthCap, Math.max(0, Math.floor(depth)));
+};
+const clampNodes = (nodes) => {
+  if (nodes === void 0) return InspectDefaults.maxNodes;
+  if (!Number.isFinite(nodes)) return Number.MAX_SAFE_INTEGER;
+  return Math.max(1, Math.floor(nodes));
+};
+const clampMatches = (limit) => {
+  if (limit === void 0) return InspectDefaults.maxMatches;
+  if (!Number.isFinite(limit)) return Number.MAX_SAFE_INTEGER;
+  return Math.max(1, Math.floor(limit));
+};
+const normalizeFilter = (filter) => filter === void 0 ? void 0 : {
+  token: filter.token,
+  propName: filter.propName,
+  shadowObject: filter.shadowObject,
+  contextName: filter.contextName,
+  limit: clampMatches(filter.limit)
+};
+const normalizeInspectRequest = (request) => ({
+  include: new Set(request?.include ?? AllIncludes),
+  rootUuids: request?.rootUuids,
+  maxDepth: clampDepth(request?.maxDepth),
+  maxNodes: clampNodes(request?.maxNodes),
+  limits: resolveSerializeLimits(request?.values),
+  filter: normalizeFilter(request?.filter)
+});
+class NodeBudget {
+  #left;
+  constructor(max) {
+    this.#left = max;
+  }
+  take() {
+    if (this.#left <= 0) return false;
+    this.#left--;
+    return true;
+  }
+}
+export {
+  InspectDefaults,
+  NodeBudget,
+  normalizeInspectRequest
+};
+//# sourceMappingURL=normalizeInspectRequest.js.map

package/src/inspect/normalizeInspectRequest.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/inspect/normalizeInspectRequest.ts"],
+  "sourcesContent": ["import {resolveSerializeLimits} from './serializeValue.js';\nimport type {EntityFilter, InspectInclude, InspectRequest, SerializeLimits} from './types.js';\n\nexport const InspectDefaults = Object.freeze({\n  maxDepth: 4,\n  maxDepthCap: 64,\n  maxNodes: 250,\n  maxMatches: 50,\n});\n\nconst AllIncludes: readonly InspectInclude[] = ['props', 'shadowObjects', 'contexts', 'registry'];\n\nexport interface NormalizedInspectRequest {\n  include: Set<InspectInclude>;\n  rootUuids: string[] | undefined;\n  maxDepth: number;\n  maxNodes: number;\n  limits: SerializeLimits;\n  filter: NormalizedEntityFilter | undefined;\n}\n\n/** A filter with every criterion present, `undefined` where the caller gave none, and the limit filled in. */\nexport interface NormalizedEntityFilter {\n  token: string | undefined;\n  propName: string | undefined;\n  shadowObject: string | undefined;\n  contextName: string | undefined;\n  limit: number;\n}\n\nconst clampDepth = (depth: number | undefined): number => {\n  if (depth === undefined) return InspectDefaults.maxDepth;\n  if (!Number.isFinite(depth)) return InspectDefaults.maxDepthCap;\n  return Math.min(InspectDefaults.maxDepthCap, Math.max(0, Math.floor(depth)));\n};\n\nconst clampNodes = (nodes: number | undefined): number => {\n  if (nodes === undefined) return InspectDefaults.maxNodes;\n  if (!Number.isFinite(nodes)) return Number.MAX_SAFE_INTEGER;\n  return Math.max(1, Math.floor(nodes));\n};\n\nconst clampMatches = (limit: number | undefined): number => {\n  if (limit === undefined) return InspectDefaults.maxMatches;\n  if (!Number.isFinite(limit)) return Number.MAX_SAFE_INTEGER;\n  return Math.max(1, Math.floor(limit));\n};\n\nconst normalizeFilter = (filter: EntityFilter | undefined): NormalizedEntityFilter | undefined =>\n  filter === undefined\n    ? undefined\n    : {\n        token: filter.token,\n        propName: filter.propName,\n        shadowObject: filter.shadowObject,\n        contextName: filter.contextName,\n        limit: clampMatches(filter.limit),\n      };\n\n/** Fills the defaults of spec \u00A78.1 in and clamps what the caller gave. */\nexport const normalizeInspectRequest = (request?: InspectRequest): NormalizedInspectRequest => ({\n  include: new Set(request?.include ?? AllIncludes),\n  rootUuids: request?.rootUuids,\n  maxDepth: clampDepth(request?.maxDepth),\n  maxNodes: clampNodes(request?.maxNodes),\n  limits: resolveSerializeLimits(request?.values),\n  filter: normalizeFilter(request?.filter),\n});\n\n/** Counts the nodes a walk may still emit. `take()` answers `false` once the budget is spent. */\nexport class NodeBudget {\n  #left: number;\n\n  constructor(max: number) {\n    this.#left = max;\n  }\n\n  take(): boolean {\n    if (this.#left <= 0) return false;\n    this.#left--;\n    return true;\n  }\n}\n"],
+  "mappings": "AAAA,SAAQ,8BAA6B;AAG9B,MAAM,kBAAkB,OAAO,OAAO;AAAA,EAC3C,UAAU;AAAA,EACV,aAAa;AAAA,EACb,UAAU;AAAA,EACV,YAAY;AACd,CAAC;AAED,MAAM,cAAyC,CAAC,SAAS,iBAAiB,YAAY,UAAU;AAoBhG,MAAM,aAAa,CAAC,UAAsC;AACxD,MAAI,UAAU,OAAW,QAAO,gBAAgB;AAChD,MAAI,CAAC,OAAO,SAAS,KAAK,EAAG,QAAO,gBAAgB;AACpD,SAAO,KAAK,IAAI,gBAAgB,aAAa,KAAK,IAAI,GAAG,KAAK,MAAM,KAAK,CAAC,CAAC;AAC7E;AAEA,MAAM,aAAa,CAAC,UAAsC;AACxD,MAAI,UAAU,OAAW,QAAO,gBAAgB;AAChD,MAAI,CAAC,OAAO,SAAS,KAAK,EAAG,QAAO,OAAO;AAC3C,SAAO,KAAK,IAAI,GAAG,KAAK,MAAM,KAAK,CAAC;AACtC;AAEA,MAAM,eAAe,CAAC,UAAsC;AAC1D,MAAI,UAAU,OAAW,QAAO,gBAAgB;AAChD,MAAI,CAAC,OAAO,SAAS,KAAK,EAAG,QAAO,OAAO;AAC3C,SAAO,KAAK,IAAI,GAAG,KAAK,MAAM,KAAK,CAAC;AACtC;AAEA,MAAM,kBAAkB,CAAC,WACvB,WAAW,SACP,SACA;AAAA,EACE,OAAO,OAAO;AAAA,EACd,UAAU,OAAO;AAAA,EACjB,cAAc,OAAO;AAAA,EACrB,aAAa,OAAO;AAAA,EACpB,OAAO,aAAa,OAAO,KAAK;AAClC;AAGC,MAAM,0BAA0B,CAAC,aAAwD;AAAA,EAC9F,SAAS,IAAI,IAAI,SAAS,WAAW,WAAW;AAAA,EAChD,WAAW,SAAS;AAAA,EACpB,UAAU,WAAW,SAAS,QAAQ;AAAA,EACtC,UAAU,WAAW,SAAS,QAAQ;AAAA,EACtC,QAAQ,uBAAuB,SAAS,MAAM;AAAA,EAC9C,QAAQ,gBAAgB,SAAS,MAAM;AACzC;AAGO,MAAM,WAAW;AAAA,EACtB;AAAA,EAEA,YAAY,KAAa;AACvB,SAAK,QAAQ;AAAA,EACf;AAAA,EAEA,OAAgB;AACd,QAAI,KAAK,SAAS,EAAG,QAAO;AAC5B,SAAK;AACL,WAAO;AAAA,EACT;AACF;",
+  "names": []
+}

package/src/inspect/serializeValue.d.ts

@@ -0,0 +1,13 @@
+import type { SerializedValue, SerializeLimits } from './types.js';
+export declare const SerializeDefaults: SerializeLimits;
+export declare const resolveSerializeLimits: (limits?: Partial<SerializeLimits>) => SerializeLimits;
+/**
+ * Turns any value into plain, JSON-safe data under a set of limits. Never throws, for any value: a
+ * getter that throws while it is read, a revoked proxy, a trap that refuses -- whatever inspecting a
+ * value costs, the throw becomes an error entry in place of the value.
+ *
+ * The rules and their order are the ones spec §7 lists. Cycles are detected along the current
+ * path, so a sub-object shared between two keys appears twice rather than as `$circular`.
+ */
+export declare function serializeValue(value: unknown, limits?: Partial<SerializeLimits>): SerializedValue;
+//# sourceMappingURL=serializeValue.d.ts.map

package/src/inspect/serializeValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializeValue.d.ts","sourceRoot":"","sources":["../../../src/inspect/serializeValue.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,eAAe,EAAE,eAAe,EAAC,MAAM,YAAY,CAAC;AAEjE,eAAO,MAAM,iBAAiB,EAAE,eAK9B,CAAC;AAMH,eAAO,MAAM,sBAAsB,YAAa,OAAO,CAAC,eAAe,CAAC,KAAG,eAKzE,CAAC;AAwBH;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAEjG"}