@graphrefly/graphrefly 0.25.0 → 0.27.0

package/dist/{index-DKE1EATr.d.cts → index-CI3DprxP.d.cts}

@@ -1,184 +1,6 @@
-import { N as Node } from './node-B-f-Lu-k.cjs';
-import { G as Graph } from './graph-D-3JIQme.cjs';
-
-/** Pluggable measurement backend. */
-interface MeasurementAdapter {
-    measureSegment(text: string, font: string): {
-        width: number;
-    };
-    /** Optional; adapters may omit for read-only / stateless measurement. */
-    clearCache?(): void;
-}
-/** Mutable counters for `analyzeAndMeasure` cache hit ratio (hits / (hits + misses)). */
-type SegmentMeasureStats = {
-    hits: number;
-    misses: number;
-};
-/** Break kind for each segment (ported from Pretext analysis.ts). */
-type SegmentBreakKind = "text" | "space" | "zero-width-break" | "soft-hyphen" | "hard-break";
-/** A measured text segment ready for line breaking. */
-type PreparedSegment = {
-    text: string;
-    width: number;
-    kind: SegmentBreakKind;
-    /** Grapheme widths for overflow-wrap: break-word (null if single grapheme). */
-    graphemeWidths: number[] | null;
-};
-/** A laid-out line with start/end cursors. */
-type LayoutLine = {
-    text: string;
-    width: number;
-    startSegment: number;
-    startGrapheme: number;
-    endSegment: number;
-    endGrapheme: number;
-};
-/** Per-character position for hit testing. */
-type CharPosition = {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    line: number;
-};
-/** Full layout result from the line-breaks derived node. */
-type LineBreaksResult = {
-    lines: LayoutLine[];
-    lineCount: number;
-};
-/**
- * A position within `PreparedSegment[]` — segment + grapheme offset.
- * `graphemeIndex: 0` at segment boundaries.
- *
- * Used by {@link layoutNextLine} for cursor-based line walking; needed when
- * lines have varying widths (multi-column flow, text wrapping around obstacles).
- */
-type LayoutCursor = {
-    segmentIndex: number;
-    graphemeIndex: number;
-};
-/** A horizontal span `[left, right]` in pixels — used by flow-layout slot carving. */
-type Interval = {
-    left: number;
-    right: number;
-};
-/** Result of a single `layoutNextLine` call. */
-type LayoutNextLineResult = {
-    text: string;
-    width: number;
-    start: LayoutCursor;
-    end: LayoutCursor;
-};
-/** Optional context for `layoutNextLine` — enables soft-hyphen visible-hyphen rendering. */
-type LayoutNextLineContext = {
-    adapter?: MeasurementAdapter;
-    font?: string;
-    cache?: Map<string, Map<string, number>>;
-};
-/** Result of the reactive layout graph's describe-accessible state. */
-type ReactiveLayoutBundle = {
-    graph: Graph;
-    /** Set input text. */
-    setText: (text: string) => void;
-    /** Set CSS font string. */
-    setFont: (font: string) => void;
-    /** Set line height (px). */
-    setLineHeight: (lineHeight: number) => void;
-    /** Set max width constraint (px). */
-    setMaxWidth: (maxWidth: number) => void;
-    /** Segments node. */
-    segments: Node<PreparedSegment[]>;
-    /** Line breaks node. */
-    lineBreaks: Node<LineBreaksResult>;
-    /** Total height node. */
-    height: Node<number>;
-    /** Per-character positions node. */
-    charPositions: Node<CharPosition[]>;
-};
-/**
- * Merge segmentation pieces: sticky punctuation, CJK per-grapheme splitting,
- * and produce the final measured segment list.
- */
-declare function analyzeAndMeasure(text: string, font: string, adapter: MeasurementAdapter, cache: Map<string, Map<string, number>>, stats?: SegmentMeasureStats): PreparedSegment[];
-/**
- * Greedy line-breaking algorithm.
- *
- * Walks segments left to right, accumulating width. Breaks when a segment would
- * overflow maxWidth. Supports:
- * - Trailing space hang (spaces don't trigger breaks)
- * - overflow-wrap: break-word via grapheme widths
- * - Soft hyphens (break opportunity, adds visible hyphen width)
- * - Hard breaks (forced newline)
- */
-declare function computeLineBreaks(segments: PreparedSegment[], maxWidth: number, adapter: MeasurementAdapter, font: string, cache: Map<string, Map<string, number>>): LineBreaksResult;
-/**
- * Lay out the next single line starting from `cursor`, fitting into `slotWidth`.
- *
- * Unlike `computeLineBreaks`, which consumes whole text with one `maxWidth`,
- * this is the cursor-based primitive needed when successive lines have different
- * widths (multi-column flow, text wrapping around shape obstacles, mixed
- * column+pullquote layouts).
- *
- * Returns `null` when the cursor is past all segments (text exhausted).
- * At a hard-break with no preceding content, returns an empty line and advances
- * the cursor past the break so the caller can continue.
- *
- * ```ts
- * let cursor: LayoutCursor = { segmentIndex: 0, graphemeIndex: 0 };
- * while (true) {
- *   const line = layoutNextLine(segments, cursor, availableWidth);
- *   if (line === null) break;
- *   render(line);
- *   cursor = line.end;
- * }
- * ```
- */
-declare function layoutNextLine(segments: PreparedSegment[], cursor: LayoutCursor, slotWidth: number, ctx?: LayoutNextLineContext): LayoutNextLineResult | null;
-/**
- * Subtract blocked horizontal intervals from a base interval, producing
- * remaining ordered, non-overlapping slots wide enough to fit text.
- *
- * Pure geometry — no text dependency. Used by flow-layout to turn obstacle
- * intersections into per-line layout slots.
- *
- * ```ts
- * carveTextLineSlots({left: 0, right: 600}, [{left: 200, right: 280}])
- * // → [{left: 0, right: 200}, {left: 280, right: 600}]
- * ```
- */
-declare function carveTextLineSlots(base: Interval, blocked: Interval[], minSlotWidth?: number): Interval[];
-/** Compute per-character x,y positions from line breaks and segments. */
-declare function computeCharPositions(lineBreaks: LineBreaksResult, segments: PreparedSegment[], lineHeight: number): CharPosition[];
-type ReactiveLayoutOptions = {
-    /** Measurement backend (required). */
-    adapter: MeasurementAdapter;
-    /** Graph name (default: "reactive-layout"). */
-    name?: string;
-    /** Initial text. */
-    text?: string;
-    /** Initial CSS font string. */
-    font?: string;
-    /** Initial line height in px. */
-    lineHeight?: number;
-    /** Initial max width in px (clamped to ≥ 0). */
-    maxWidth?: number;
-};
-/**
- * Create a reactive text layout graph.
- *
- * ```
- * Graph("reactive-layout")
- * ├── state("text")
- * ├── state("font")
- * ├── state("line-height")
- * ├── state("max-width")
- * ├── derived("segments")      — text + font → PreparedSegment[]
- * ├── derived("line-breaks")   — segments + max-width → LineBreaksResult
- * ├── derived("height")        — line-breaks → number
- * └── derived("char-positions") — line-breaks + segments → CharPosition[]
- * ```
- */
-declare function reactiveLayout(opts: ReactiveLayoutOptions): ReactiveLayoutBundle;
+import { M as MeasurementAdapter, P as PreparedSegment, L as LineBreaksResult, C as CharPosition, a as LayoutCursor, I as Interval, b as LayoutLine, c as LayoutNextLineContext, d as LayoutNextLineResult, R as ReactiveLayoutBundle, e as ReactiveLayoutOptions, S as SegmentBreakKind, f as SegmentMeasureStats, g as analyzeAndMeasure, h as carveTextLineSlots, i as computeCharPositions, j as computeLineBreaks, l as layoutNextLine, r as reactiveLayout } from './reactive-layout-MQP--J3F.cjs';
+import { N as Node } from './node-BmerH3kS.cjs';
+import { a as Graph } from './graph-DNCrvZSn.cjs';
 
 /**
  * MeasurementAdapter implementations (roadmap §7.1 — pluggable backends).
@@ -606,7 +428,7 @@ type index_CanvasMeasureAdapter = CanvasMeasureAdapter;
 declare const index_CanvasMeasureAdapter: typeof CanvasMeasureAdapter;
 type index_CanvasMeasureAdapterOptions = CanvasMeasureAdapterOptions;
 type index_CanvasModule = CanvasModule;
-type index_CharPosition = CharPosition;
+declare const index_CharPosition: typeof CharPosition;
 type index_CircleObstacle = CircleObstacle;
 type index_CliMeasureAdapter = CliMeasureAdapter;
 declare const index_CliMeasureAdapter: typeof CliMeasureAdapter;
@@ -618,14 +440,14 @@ type index_FlowLinesResult = FlowLinesResult;
 type index_ImageMeasurer = ImageMeasurer;
 type index_ImageSizeAdapter = ImageSizeAdapter;
 declare const index_ImageSizeAdapter: typeof ImageSizeAdapter;
-type index_Interval = Interval;
-type index_LayoutCursor = LayoutCursor;
-type index_LayoutLine = LayoutLine;
-type index_LayoutNextLineContext = LayoutNextLineContext;
-type index_LayoutNextLineResult = LayoutNextLineResult;
-type index_LineBreaksResult = LineBreaksResult;
+declare const index_Interval: typeof Interval;
+declare const index_LayoutCursor: typeof LayoutCursor;
+declare const index_LayoutLine: typeof LayoutLine;
+declare const index_LayoutNextLineContext: typeof LayoutNextLineContext;
+declare const index_LayoutNextLineResult: typeof LayoutNextLineResult;
+declare const index_LineBreaksResult: typeof LineBreaksResult;
 type index_MeasuredBlock = MeasuredBlock;
-type index_MeasurementAdapter = MeasurementAdapter;
+declare const index_MeasurementAdapter: typeof MeasurementAdapter;
 type index_NodeCanvasMeasureAdapter = NodeCanvasMeasureAdapter;
 declare const index_NodeCanvasMeasureAdapter: typeof NodeCanvasMeasureAdapter;
 type index_Obstacle = Obstacle;
@@ -634,16 +456,16 @@ type index_PositionedLine = PositionedLine;
 type index_PrecomputedAdapter = PrecomputedAdapter;
 declare const index_PrecomputedAdapter: typeof PrecomputedAdapter;
 type index_PrecomputedAdapterOptions = PrecomputedAdapterOptions;
-type index_PreparedSegment = PreparedSegment;
+declare const index_PreparedSegment: typeof PreparedSegment;
 type index_ReactiveBlockLayoutBundle = ReactiveBlockLayoutBundle;
 type index_ReactiveBlockLayoutOptions = ReactiveBlockLayoutOptions;
 type index_ReactiveFlowLayoutBundle = ReactiveFlowLayoutBundle;
 type index_ReactiveFlowLayoutOptions = ReactiveFlowLayoutOptions;
-type index_ReactiveLayoutBundle = ReactiveLayoutBundle;
-type index_ReactiveLayoutOptions = ReactiveLayoutOptions;
+declare const index_ReactiveLayoutBundle: typeof ReactiveLayoutBundle;
+declare const index_ReactiveLayoutOptions: typeof ReactiveLayoutOptions;
 type index_RectObstacle = RectObstacle;
-type index_SegmentBreakKind = SegmentBreakKind;
-type index_SegmentMeasureStats = SegmentMeasureStats;
+declare const index_SegmentBreakKind: typeof SegmentBreakKind;
+declare const index_SegmentMeasureStats: typeof SegmentMeasureStats;
 type index_SvgBoundsAdapter = SvgBoundsAdapter;
 declare const index_SvgBoundsAdapter: typeof SvgBoundsAdapter;
 type index_SvgMeasurer = SvgMeasurer;
@@ -663,7 +485,7 @@ declare const index_reactiveFlowLayout: typeof reactiveFlowLayout;
 declare const index_reactiveLayout: typeof reactiveLayout;
 declare const index_rectIntervalForBand: typeof rectIntervalForBand;
 declare namespace index {
-  export { type index_BlockAdapters as BlockAdapters, index_CanvasMeasureAdapter as CanvasMeasureAdapter, type index_CanvasMeasureAdapterOptions as CanvasMeasureAdapterOptions, type index_CanvasModule as CanvasModule, type index_CharPosition as CharPosition, type index_CircleObstacle as CircleObstacle, index_CliMeasureAdapter as CliMeasureAdapter, type index_CliMeasureAdapterOptions as CliMeasureAdapterOptions, type index_ContentBlock as ContentBlock, type index_FlowColumns as FlowColumns, type index_FlowContainer as FlowContainer, type index_FlowLinesResult as FlowLinesResult, type index_ImageMeasurer as ImageMeasurer, index_ImageSizeAdapter as ImageSizeAdapter, type index_Interval as Interval, type index_LayoutCursor as LayoutCursor, type index_LayoutLine as LayoutLine, type index_LayoutNextLineContext as LayoutNextLineContext, type index_LayoutNextLineResult as LayoutNextLineResult, type index_LineBreaksResult as LineBreaksResult, type index_MeasuredBlock as MeasuredBlock, type index_MeasurementAdapter as MeasurementAdapter, index_NodeCanvasMeasureAdapter as NodeCanvasMeasureAdapter, type index_Obstacle as Obstacle, type index_PositionedBlock as PositionedBlock, type index_PositionedLine as PositionedLine, index_PrecomputedAdapter as PrecomputedAdapter, type index_PrecomputedAdapterOptions as PrecomputedAdapterOptions, type index_PreparedSegment as PreparedSegment, type index_ReactiveBlockLayoutBundle as ReactiveBlockLayoutBundle, type index_ReactiveBlockLayoutOptions as ReactiveBlockLayoutOptions, type index_ReactiveFlowLayoutBundle as ReactiveFlowLayoutBundle, type index_ReactiveFlowLayoutOptions as ReactiveFlowLayoutOptions, type index_ReactiveLayoutBundle as ReactiveLayoutBundle, type index_ReactiveLayoutOptions as ReactiveLayoutOptions, type index_RectObstacle as RectObstacle, type index_SegmentBreakKind as SegmentBreakKind, type index_SegmentMeasureStats as SegmentMeasureStats, index_SvgBoundsAdapter as SvgBoundsAdapter, type index_SvgMeasurer as SvgMeasurer, index_analyzeAndMeasure as analyzeAndMeasure, index_carveTextLineSlots as carveTextLineSlots, index_circleIntervalForBand as circleIntervalForBand, index_computeBlockFlow as computeBlockFlow, index_computeCharPositions as computeCharPositions, index_computeFlowLines as computeFlowLines, index_computeLineBreaks as computeLineBreaks, index_computeTotalHeight as computeTotalHeight, index_layoutNextLine as layoutNextLine, index_measureBlock as measureBlock, index_measureBlocks as measureBlocks, index_reactiveBlockLayout as reactiveBlockLayout, index_reactiveFlowLayout as reactiveFlowLayout, index_reactiveLayout as reactiveLayout, index_rectIntervalForBand as rectIntervalForBand };
+  export { type index_BlockAdapters as BlockAdapters, index_CanvasMeasureAdapter as CanvasMeasureAdapter, type index_CanvasMeasureAdapterOptions as CanvasMeasureAdapterOptions, type index_CanvasModule as CanvasModule, index_CharPosition as CharPosition, type index_CircleObstacle as CircleObstacle, index_CliMeasureAdapter as CliMeasureAdapter, type index_CliMeasureAdapterOptions as CliMeasureAdapterOptions, type index_ContentBlock as ContentBlock, type index_FlowColumns as FlowColumns, type index_FlowContainer as FlowContainer, type index_FlowLinesResult as FlowLinesResult, type index_ImageMeasurer as ImageMeasurer, index_ImageSizeAdapter as ImageSizeAdapter, index_Interval as Interval, index_LayoutCursor as LayoutCursor, index_LayoutLine as LayoutLine, index_LayoutNextLineContext as LayoutNextLineContext, index_LayoutNextLineResult as LayoutNextLineResult, index_LineBreaksResult as LineBreaksResult, type index_MeasuredBlock as MeasuredBlock, index_MeasurementAdapter as MeasurementAdapter, index_NodeCanvasMeasureAdapter as NodeCanvasMeasureAdapter, type index_Obstacle as Obstacle, type index_PositionedBlock as PositionedBlock, type index_PositionedLine as PositionedLine, index_PrecomputedAdapter as PrecomputedAdapter, type index_PrecomputedAdapterOptions as PrecomputedAdapterOptions, index_PreparedSegment as PreparedSegment, type index_ReactiveBlockLayoutBundle as ReactiveBlockLayoutBundle, type index_ReactiveBlockLayoutOptions as ReactiveBlockLayoutOptions, type index_ReactiveFlowLayoutBundle as ReactiveFlowLayoutBundle, type index_ReactiveFlowLayoutOptions as ReactiveFlowLayoutOptions, index_ReactiveLayoutBundle as ReactiveLayoutBundle, index_ReactiveLayoutOptions as ReactiveLayoutOptions, type index_RectObstacle as RectObstacle, index_SegmentBreakKind as SegmentBreakKind, index_SegmentMeasureStats as SegmentMeasureStats, index_SvgBoundsAdapter as SvgBoundsAdapter, type index_SvgMeasurer as SvgMeasurer, index_analyzeAndMeasure as analyzeAndMeasure, index_carveTextLineSlots as carveTextLineSlots, index_circleIntervalForBand as circleIntervalForBand, index_computeBlockFlow as computeBlockFlow, index_computeCharPositions as computeCharPositions, index_computeFlowLines as computeFlowLines, index_computeLineBreaks as computeLineBreaks, index_computeTotalHeight as computeTotalHeight, index_layoutNextLine as layoutNextLine, index_measureBlock as measureBlock, index_measureBlocks as measureBlocks, index_reactiveBlockLayout as reactiveBlockLayout, index_reactiveFlowLayout as reactiveFlowLayout, index_reactiveLayout as reactiveLayout, index_rectIntervalForBand as rectIntervalForBand };
 }
 
-export { reactiveFlowLayout as $, type RectObstacle as A, type BlockAdapters as B, CanvasMeasureAdapter as C, type SegmentMeasureStats as D, SvgBoundsAdapter as E, type FlowColumns as F, type SvgMeasurer as G, analyzeAndMeasure as H, type ImageMeasurer as I, carveTextLineSlots as J, circleIntervalForBand as K, type LayoutCursor as L, type MeasurementAdapter as M, NodeCanvasMeasureAdapter as N, type Obstacle as O, type PositionedBlock as P, computeBlockFlow as Q, type ReactiveBlockLayoutBundle as R, type SegmentBreakKind as S, computeCharPositions as T, computeFlowLines as U, computeLineBreaks as V, computeTotalHeight as W, layoutNextLine as X, measureBlock as Y, measureBlocks as Z, reactiveBlockLayout as _, type CanvasMeasureAdapterOptions as a, reactiveLayout as a0, rectIntervalForBand as a1, type CanvasModule as b, type CharPosition as c, type CircleObstacle as d, CliMeasureAdapter as e, type CliMeasureAdapterOptions as f, type ContentBlock as g, type FlowContainer as h, index as i, type FlowLinesResult as j, ImageSizeAdapter as k, type Interval as l, type LayoutLine as m, type LayoutNextLineContext as n, type LayoutNextLineResult as o, type LineBreaksResult as p, type MeasuredBlock as q, type PositionedLine as r, PrecomputedAdapter as s, type PrecomputedAdapterOptions as t, type PreparedSegment as u, type ReactiveBlockLayoutOptions as v, type ReactiveFlowLayoutBundle as w, type ReactiveFlowLayoutOptions as x, type ReactiveLayoutBundle as y, type ReactiveLayoutOptions as z };
+export { rectIntervalForBand as A, type BlockAdapters as B, CanvasMeasureAdapter as C, type FlowColumns as F, type ImageMeasurer as I, type MeasuredBlock as M, NodeCanvasMeasureAdapter as N, type Obstacle as O, type PositionedBlock as P, type ReactiveBlockLayoutBundle as R, SvgBoundsAdapter as S, type CanvasMeasureAdapterOptions as a, type CanvasModule as b, type CircleObstacle as c, CliMeasureAdapter as d, type CliMeasureAdapterOptions as e, type ContentBlock as f, type FlowContainer as g, type FlowLinesResult as h, index as i, ImageSizeAdapter as j, type PositionedLine as k, PrecomputedAdapter as l, type PrecomputedAdapterOptions as m, type ReactiveBlockLayoutOptions as n, type ReactiveFlowLayoutBundle as o, type ReactiveFlowLayoutOptions as p, type RectObstacle as q, type SvgMeasurer as r, circleIntervalForBand as s, computeBlockFlow as t, computeFlowLines as u, computeTotalHeight as v, measureBlock as w, measureBlocks as x, reactiveBlockLayout as y, reactiveFlowLayout as z };

package/dist/{index-AMWewNDe.d.cts → index-CO8uBlUh.d.cts}

@@ -1,5 +1,5 @@
-import { k as GraphReFlyConfig } from './node-B-f-Lu-k.cjs';
-import { r as GraphPersistSnapshot, g as GraphCheckpointRecord, D as DescribeFilter, e as GRAPH_META_SEGMENT, G as Graph, f as GraphActorOptions, b as GraphAttachStorageOptions, h as GraphDescribeOptions, i as GraphDescribeOutput, j as GraphDiagramDirection, k as GraphDiagramOptions, l as GraphDiffChange, m as GraphDiffResult, n as GraphFactoryContext, o as GraphNodeFactory, p as GraphObserveAll, q as GraphObserveOne, a as GraphOptions, d as GraphProfileOptions, c as GraphProfileResult, s as GraphVersionChange, t as GraphWALDiff, N as NodeProfile, O as ObserveDetail, u as ObserveEvent, v as ObserveOptions, w as ObserveResult, x as ObserveTheme, y as ObserveThemeName, R as ReachableDirection, z as ReachableOptions, T as TraceEntry, A as diffForWAL, B as graphProfile, C as reachable } from './graph-D-3JIQme.cjs';
+import { j as GraphReFlyConfig } from './node-BmerH3kS.cjs';
+import { s as GraphPersistSnapshot, l as GraphCheckpointRecord, a as Graph, T as TopologyEvent, C as CausalChain, h as CausalStep, D as DescribeFilter, E as ExplainPathOptions, i as GRAPH_META_SEGMENT, j as GraphActorOptions, k as GraphAttachStorageOptions, b as GraphDescribeOptions, c as GraphDescribeOutput, m as GraphDiagramDirection, n as GraphDiagramOptions, o as GraphDiffChange, g as GraphDiffResult, p as GraphFactoryContext, f as GraphNodeFactory, q as GraphObserveAll, r as GraphObserveOne, G as GraphOptions, e as GraphProfileOptions, d as GraphProfileResult, t as GraphVersionChange, u as GraphWALDiff, N as NodeProfile, O as ObserveDetail, v as ObserveEvent, w as ObserveOptions, x as ObserveResult, y as ObserveTheme, z as ObserveThemeName, R as ReachableDirection, A as ReachableOptions, S as SNAPSHOT_VERSION, B as TraceEntry, F as diffForWAL, H as explainPath, I as graphProfile, J as reachable } from './graph-DNCrvZSn.cjs';
 
 /**
  * Approximate in-memory size estimation for arbitrary JS values.
@@ -254,14 +254,39 @@ declare function registerBuiltinCodecs(config: GraphReFlyConfig): void;
  */
 declare function replayWAL(entries: readonly WALEntry[]): GraphPersistSnapshot;
 
+/**
+ * Subscribe to structural changes across `graph` and every transitively
+ * mounted subgraph. `cb` fires on every {@link TopologyEvent} from any
+ * graph in the tree. Newly-mounted subgraphs are auto-wired when their
+ * parent emits `{kind: "added", nodeKind: "mount"}`; newly-unmounted
+ * subgraphs' subscriptions are disposed via the parent's
+ * `{kind: "removed", nodeKind: "mount"}` event plus the returned
+ * `GraphRemoveAudit`.
+ *
+ * The callback receives a third argument `prefix`: the `::`-delimited
+ * path from the root watched graph to the emitter, ending with `"::"`
+ * (empty string when the event comes from the root itself). Compute
+ * a qualified path for an added/removed entry as `prefix + event.name`.
+ *
+ * @param graph - Root graph to watch.
+ * @param cb - Receives `(event, emitterGraph, prefix)`.
+ * @returns Dispose function — tears down every active subscription.
+ *
+ * @category observability
+ */
+declare function watchTopologyTree(graph: Graph, cb: (event: TopologyEvent, emitter: Graph, prefix: string) => void): () => void;
+
 /**
  * Graph container: registry, wiring, introspection (Phase 1).
  */
 
+declare const index_CausalChain: typeof CausalChain;
+declare const index_CausalStep: typeof CausalStep;
 declare const index_DescribeFilter: typeof DescribeFilter;
 declare const index_ENVELOPE_VERSION: typeof ENVELOPE_VERSION;
 type index_EvictedSubgraphInfo = EvictedSubgraphInfo;
 type index_EvictionPolicy = EvictionPolicy;
+declare const index_ExplainPathOptions: typeof ExplainPathOptions;
 declare const index_GRAPH_META_SEGMENT: typeof GRAPH_META_SEGMENT;
 declare const index_Graph: typeof Graph;
 declare const index_GraphActorOptions: typeof GraphActorOptions;
@@ -296,6 +321,8 @@ declare const index_ObserveThemeName: typeof ObserveThemeName;
 declare const index_ReachableDirection: typeof ReachableDirection;
 declare const index_ReachableOptions: typeof ReachableOptions;
 declare const index_SIZEOF_SYMBOL: typeof SIZEOF_SYMBOL;
+declare const index_SNAPSHOT_VERSION: typeof SNAPSHOT_VERSION;
+declare const index_TopologyEvent: typeof TopologyEvent;
 declare const index_TraceEntry: typeof TraceEntry;
 type index_WALEntry = WALEntry;
 declare const index_createDagCborCodec: typeof createDagCborCodec;
@@ -303,13 +330,15 @@ declare const index_createDagCborZstdCodec: typeof createDagCborZstdCodec;
 declare const index_decodeEnvelope: typeof decodeEnvelope;
 declare const index_diffForWAL: typeof diffForWAL;
 declare const index_encodeEnvelope: typeof encodeEnvelope;
+declare const index_explainPath: typeof explainPath;
 declare const index_graphProfile: typeof graphProfile;
 declare const index_reachable: typeof reachable;
 declare const index_registerBuiltinCodecs: typeof registerBuiltinCodecs;
 declare const index_replayWAL: typeof replayWAL;
 declare const index_sizeof: typeof sizeof;
+declare const index_watchTopologyTree: typeof watchTopologyTree;
 declare namespace index {
-  export { index_DescribeFilter as DescribeFilter, index_ENVELOPE_VERSION as ENVELOPE_VERSION, type index_EvictedSubgraphInfo as EvictedSubgraphInfo, type index_EvictionPolicy as EvictionPolicy, index_GRAPH_META_SEGMENT as GRAPH_META_SEGMENT, index_Graph as Graph, index_GraphActorOptions as GraphActorOptions, index_GraphAttachStorageOptions as GraphAttachStorageOptions, index_GraphCheckpointRecord as GraphCheckpointRecord, type index_GraphCodec as GraphCodec, index_GraphDescribeOptions as GraphDescribeOptions, index_GraphDescribeOutput as GraphDescribeOutput, index_GraphDiagramDirection as GraphDiagramDirection, index_GraphDiagramOptions as GraphDiagramOptions, index_GraphDiffChange as GraphDiffChange, index_GraphDiffResult as GraphDiffResult, index_GraphFactoryContext as GraphFactoryContext, index_GraphNodeFactory as GraphNodeFactory, index_GraphObserveAll as GraphObserveAll, index_GraphObserveOne as GraphObserveOne, index_GraphOptions as GraphOptions, index_GraphPersistSnapshot as GraphPersistSnapshot, index_GraphProfileOptions as GraphProfileOptions, index_GraphProfileResult as GraphProfileResult, index_GraphVersionChange as GraphVersionChange, index_GraphWALDiff as GraphWALDiff, index_JsonCodec as JsonCodec, type index_LazyGraphCodec as LazyGraphCodec, index_NodeProfile as NodeProfile, index_ObserveDetail as ObserveDetail, index_ObserveEvent as ObserveEvent, index_ObserveOptions as ObserveOptions, index_ObserveResult as ObserveResult, index_ObserveTheme as ObserveTheme, index_ObserveThemeName as ObserveThemeName, index_ReachableDirection as ReachableDirection, index_ReachableOptions as ReachableOptions, OVERHEAD as SIZEOF_OVERHEAD, index_SIZEOF_SYMBOL as SIZEOF_SYMBOL, index_TraceEntry as TraceEntry, type index_WALEntry as WALEntry, index_createDagCborCodec as createDagCborCodec, index_createDagCborZstdCodec as createDagCborZstdCodec, index_decodeEnvelope as decodeEnvelope, index_diffForWAL as diffForWAL, index_encodeEnvelope as encodeEnvelope, index_graphProfile as graphProfile, index_reachable as reachable, index_registerBuiltinCodecs as registerBuiltinCodecs, index_replayWAL as replayWAL, index_sizeof as sizeof };
+  export { index_CausalChain as CausalChain, index_CausalStep as CausalStep, index_DescribeFilter as DescribeFilter, index_ENVELOPE_VERSION as ENVELOPE_VERSION, type index_EvictedSubgraphInfo as EvictedSubgraphInfo, type index_EvictionPolicy as EvictionPolicy, index_ExplainPathOptions as ExplainPathOptions, index_GRAPH_META_SEGMENT as GRAPH_META_SEGMENT, index_Graph as Graph, index_GraphActorOptions as GraphActorOptions, index_GraphAttachStorageOptions as GraphAttachStorageOptions, index_GraphCheckpointRecord as GraphCheckpointRecord, type index_GraphCodec as GraphCodec, index_GraphDescribeOptions as GraphDescribeOptions, index_GraphDescribeOutput as GraphDescribeOutput, index_GraphDiagramDirection as GraphDiagramDirection, index_GraphDiagramOptions as GraphDiagramOptions, index_GraphDiffChange as GraphDiffChange, index_GraphDiffResult as GraphDiffResult, index_GraphFactoryContext as GraphFactoryContext, index_GraphNodeFactory as GraphNodeFactory, index_GraphObserveAll as GraphObserveAll, index_GraphObserveOne as GraphObserveOne, index_GraphOptions as GraphOptions, index_GraphPersistSnapshot as GraphPersistSnapshot, index_GraphProfileOptions as GraphProfileOptions, index_GraphProfileResult as GraphProfileResult, index_GraphVersionChange as GraphVersionChange, index_GraphWALDiff as GraphWALDiff, index_JsonCodec as JsonCodec, type index_LazyGraphCodec as LazyGraphCodec, index_NodeProfile as NodeProfile, index_ObserveDetail as ObserveDetail, index_ObserveEvent as ObserveEvent, index_ObserveOptions as ObserveOptions, index_ObserveResult as ObserveResult, index_ObserveTheme as ObserveTheme, index_ObserveThemeName as ObserveThemeName, index_ReachableDirection as ReachableDirection, index_ReachableOptions as ReachableOptions, OVERHEAD as SIZEOF_OVERHEAD, index_SIZEOF_SYMBOL as SIZEOF_SYMBOL, index_SNAPSHOT_VERSION as SNAPSHOT_VERSION, index_TopologyEvent as TopologyEvent, index_TraceEntry as TraceEntry, type index_WALEntry as WALEntry, index_createDagCborCodec as createDagCborCodec, index_createDagCborZstdCodec as createDagCborZstdCodec, index_decodeEnvelope as decodeEnvelope, index_diffForWAL as diffForWAL, index_encodeEnvelope as encodeEnvelope, index_explainPath as explainPath, index_graphProfile as graphProfile, index_reachable as reachable, index_registerBuiltinCodecs as registerBuiltinCodecs, index_replayWAL as replayWAL, index_sizeof as sizeof, index_watchTopologyTree as watchTopologyTree };
 }
 
-export { ENVELOPE_VERSION as E, type GraphCodec as G, JsonCodec as J, type LazyGraphCodec as L, OVERHEAD as O, SIZEOF_SYMBOL as S, type WALEntry as W, type EvictedSubgraphInfo as a, type EvictionPolicy as b, createDagCborCodec as c, createDagCborZstdCodec as d, decodeEnvelope as e, encodeEnvelope as f, replayWAL as g, index as i, registerBuiltinCodecs as r, sizeof as s };
+export { ENVELOPE_VERSION as E, type GraphCodec as G, JsonCodec as J, type LazyGraphCodec as L, OVERHEAD as O, SIZEOF_SYMBOL as S, type WALEntry as W, type EvictedSubgraphInfo as a, type EvictionPolicy as b, createDagCborCodec as c, createDagCborZstdCodec as d, decodeEnvelope as e, encodeEnvelope as f, replayWAL as g, index as i, registerBuiltinCodecs as r, sizeof as s, watchTopologyTree as w };

package/dist/index-CxFrXH4m.d.ts

@@ -0,0 +1,45 @@
+import { N as Node } from './node-BmerH3kS.js';
+
+/** Svelte store contract — implements the minimal `subscribe` method. */
+interface SvelteReadable<T> {
+    subscribe(run: (value: T) => void): () => void;
+}
+/** Svelte writable store contract. */
+interface SvelteWritable<T> extends SvelteReadable<T> {
+    set(value: T): void;
+    update(updater: (value: T) => T): void;
+}
+/**
+ * Subscribe to a `Node<T>` as a Svelte readable store (implements Svelte store contract).
+ * Subscription lifecycle is tied to Svelte store unsubscription (not node terminal messages).
+ */
+declare function useSubscribe<T>(node: Node<T>): SvelteReadable<T | undefined | null>;
+/**
+ * Bind a writable `Node<T>` as a Svelte writable store.
+ * Reads and writes adapt seamlessly.
+ * Setter/update always forward `[[DIRTY], [DATA, value]]`, including `value === undefined`.
+ * Subscription lifecycle is tied to Svelte store unsubscription (not node terminal messages).
+ */
+declare function useStore<T>(node: Node<T>): SvelteWritable<T | undefined | null>;
+/** Maps a key to an object of nodes. Used by `useSubscribeRecord`. */
+type NodeFactory<K, R extends Record<string, any>> = (key: K) => {
+    [P in keyof R]: Node<R[P]>;
+};
+/**
+ * Subscribe to a dynamic keyed record of nodes as a Svelte readable store.
+ * Re-subscribes all per-key fields whenever `keysNode` changes.
+ * Key re-sync is gated to settled batches (`messageTier >= 3`) to avoid DIRTY-phase churn.
+ */
+declare function useSubscribeRecord<K extends string, R extends Record<string, any>>(keysNode: Node<K[]>, factory: NodeFactory<K, R>): SvelteReadable<Record<K, R>>;
+
+type index_NodeFactory<K, R extends Record<string, any>> = NodeFactory<K, R>;
+type index_SvelteReadable<T> = SvelteReadable<T>;
+type index_SvelteWritable<T> = SvelteWritable<T>;
+declare const index_useStore: typeof useStore;
+declare const index_useSubscribe: typeof useSubscribe;
+declare const index_useSubscribeRecord: typeof useSubscribeRecord;
+declare namespace index {
+  export { type index_NodeFactory as NodeFactory, type index_SvelteReadable as SvelteReadable, type index_SvelteWritable as SvelteWritable, index_useStore as useStore, index_useSubscribe as useSubscribe, index_useSubscribeRecord as useSubscribeRecord };
+}
+
+export { type NodeFactory as N, type SvelteReadable as S, type SvelteWritable as a, useSubscribe as b, useSubscribeRecord as c, index as i, useStore as u };

package/dist/index-D8wS_PeY.d.cts

@@ -0,0 +1,121 @@
+import { i as index$2 } from './index-ByQxazQJ.cjs';
+import { i as index$3 } from './index-DO_6JN9Z.cjs';
+import { i as index$4 } from './index-DlLp-2Xn.cjs';
+import { i as index$5 } from './index-DYme44FM.cjs';
+import { N as Node } from './node-BmerH3kS.cjs';
+import { i as index$6 } from './index-Xi3u0HCQ.cjs';
+import { i as index$7 } from './index-VHqptjhu.cjs';
+import { i as index$8 } from './index-B1tloyhO.cjs';
+import { i as index$9 } from './index-B6EhDnjH.cjs';
+
+/**
+ * Options for creating signals.
+ *
+ * @category compat
+ */
+interface SignalOptions {
+    /** Optional identifier for the underlying node. */
+    name?: string;
+    /** Custom equality function for change detection. */
+    equals?: (a: any, b: any) => boolean;
+}
+/**
+ * Common interface for all reactive signals.
+ *
+ * @category compat
+ */
+interface AnySignal<T> {
+    /** Returns the current value of the signal. */
+    get(): T;
+    /** @internal The underlying GraphReFly node. */
+    _node: Node<T>;
+}
+/**
+ * TC39 `Signal.State` — a writable signal backed by a GraphReFly `state` node.
+ * Automatically registers itself as a dependency if read inside a `Computed`.
+ *
+ * @example
+ * ```ts
+ * const count = new Signal.State(0);
+ * count.get(); // 0
+ * count.set(1);
+ * count.get(); // 1
+ * ```
+ */
+declare class SignalState<T> implements AnySignal<T> {
+    /** @internal */
+    _node: Node<T>;
+    private readonly _equals;
+    constructor(initial: T, opts?: SignalOptions);
+    get(): T;
+    set(value: T): void;
+}
+/**
+ * TC39 `Signal.Computed` — a read-only signal backed by `dynamicNode`.
+ * Automatically tracks dependencies when `get()` is called on other signals
+ * during its computation.
+ *
+ * @example
+ * ```ts
+ * const count = new Signal.State(0);
+ * const doubled = new Signal.Computed(() => count.get() * 2);
+ * ```
+ */
+declare class SignalComputed<T> implements AnySignal<T> {
+    /** @internal */
+    _node: Node<T>;
+    constructor(computation: () => T, opts?: SignalOptions);
+    get(): T;
+}
+/**
+ * TC39 Signals-compatible namespace. Wraps GraphReFly primitives.
+ * Provides auto-tracking conforming to the TS39 signals proposal.
+ *
+ * @category compat
+ */
+declare const Signal: {
+    readonly State: typeof SignalState;
+    readonly Computed: typeof SignalComputed;
+    /**
+     * Subscribes to changes on a signal.
+     * Returns an unsubscribe callback.
+     *
+     * @example
+     * ```ts
+     * const count = new Signal.State(0);
+     * const unsub = Signal.sub(count, v => console.log(v));
+     * ```
+     */
+    readonly sub: <T>(signal: AnySignal<T>, callback: ((value: T) => void) | {
+        data?: (value: T) => void;
+        error?: (err: unknown) => void;
+        complete?: () => void;
+    }) => (() => void);
+};
+
+type index$1_AnySignal<T> = AnySignal<T>;
+declare const index$1_Signal: typeof Signal;
+type index$1_SignalComputed<T> = SignalComputed<T>;
+declare const index$1_SignalComputed: typeof SignalComputed;
+type index$1_SignalOptions = SignalOptions;
+type index$1_SignalState<T> = SignalState<T>;
+declare const index$1_SignalState: typeof SignalState;
+declare namespace index$1 {
+  export { type index$1_AnySignal as AnySignal, index$1_Signal as Signal, index$1_SignalComputed as SignalComputed, type index$1_SignalOptions as SignalOptions, index$1_SignalState as SignalState };
+}
+
+/**
+ * Compat layer: compatibility wrappers for other state management libraries (Phase 5.1b).
+ *
+ * Framework adapters are optional peers. Install only what you use:
+ * - `@graphrefly/graphrefly-ts/compat/react` -> `react`, `react-dom`
+ * - `@graphrefly/graphrefly-ts/compat/vue` -> `vue`
+ * - `@graphrefly/graphrefly-ts/compat/svelte` -> `svelte`
+ * - `@graphrefly/graphrefly-ts/compat/solid` -> `solid-js`
+ */
+
+declare namespace index {
+  export { index$2 as jotai, index$3 as nanostores, index$4 as nestjs, index$5 as react, index$1 as signals, index$6 as solid, index$7 as svelte, index$8 as vue, index$9 as zustand };
+}
+
+export { index$1 as a, index as i };

package/dist/index-DO_6JN9Z.d.cts

@@ -0,0 +1,127 @@
+import { N as Node } from './node-BmerH3kS.cjs';
+
+/**
+ * A Nanostores-compatible atom.
+ *
+ * @category compat
+ */
+interface NanoAtom<T> {
+    /** Get current value. */
+    get(): T;
+    /** Set a new value (writable atoms only). */
+    set(value: T): void;
+    /** Subscribe to value changes. Callback receives the new value.
+     * Returns unsubscribe function. Called immediately with current value. */
+    subscribe(cb: (value: T) => void): () => void;
+    /** Listen to value changes (no immediate call). Returns unsubscribe. */
+    listen(cb: (value: T) => void): () => void;
+    /** The underlying GraphReFly node. */
+    readonly _node: Node<T>;
+}
+/**
+ * A Nanostores-compatible computed store.
+ *
+ * @category compat
+ */
+interface NanoComputed<T> {
+    /** Get current value. */
+    get(): T;
+    /** Subscribe to value changes. Called immediately with current value.
+     * Returns unsubscribe function. */
+    subscribe(cb: (value: T) => void): () => void;
+    /** Listen to value changes (no immediate call). Returns unsubscribe. */
+    listen(cb: (value: T) => void): () => void;
+    /** The underlying GraphReFly node. */
+    readonly _node: Node<T>;
+}
+/**
+ * A Nanostores-compatible map.
+ *
+ * @category compat
+ */
+interface NanoMap<T extends Record<string, unknown>> extends NanoAtom<T> {
+    /** Set a single key. */
+    setKey<K extends keyof T>(key: K, value: T[K]): void;
+}
+/**
+ * Creates a nanostores-compatible atom.
+ *
+ * @param initial - Initial value.
+ * @returns `NanoAtom<T>`
+ *
+ * @category compat
+ */
+declare function atom<T>(initial: T): NanoAtom<T>;
+/**
+ * Creates a nanostores-compatible computed store.
+ *
+ * @param stores - One or more atoms/computed stores.
+ * @param fn - Compute function.
+ * @returns `NanoComputed<T>`
+ *
+ * @category compat
+ */
+declare function computed<T, A>(storeA: NanoAtom<A> | NanoComputed<A>, fn: (a: A) => T): NanoComputed<T>;
+declare function computed<T, A, B>(stores: [NanoAtom<A> | NanoComputed<A>, NanoAtom<B> | NanoComputed<B>], fn: (a: A, b: B) => T): NanoComputed<T>;
+declare function computed<T, A, B, C>(stores: [
+    NanoAtom<A> | NanoComputed<A>,
+    NanoAtom<B> | NanoComputed<B>,
+    NanoAtom<C> | NanoComputed<C>
+], fn: (a: A, b: B, c: C) => T): NanoComputed<T>;
+/**
+ * Creates a nanostores-compatible map.
+ *
+ * @param initial - Initial object value.
+ * @returns `NanoMap<T>`
+ *
+ * @category compat
+ */
+declare function map<T extends Record<string, unknown>>(initial: T): NanoMap<T>;
+/**
+ * Returns the current value of the store.
+ *
+ * @category compat
+ */
+declare function getValue<T>(store: NanoAtom<T> | NanoComputed<T>): T;
+/**
+ * Adds a listener for the store start (first listener connected).
+ *
+ * @category compat
+ */
+declare function onStart(store: NanoAtom<any> | NanoComputed<any>, cb: () => void): void;
+/**
+ * Adds a listener for the store stop (last listener disconnected).
+ *
+ * @category compat
+ */
+declare function onStop(store: NanoAtom<any> | NanoComputed<any>, cb: () => void): void;
+/**
+ * Adds a listener for the store mount (first listener connected).
+ *
+ * @returns A cleanup function called when the last listener is removed.
+ * @category compat
+ */
+declare function onMount(store: NanoAtom<any> | NanoComputed<any>, cb: () => (() => void) | undefined): void;
+/**
+ * Batches multiple store updates.
+ *
+ * @category compat
+ */
+declare function action<Args extends any[], Return>(_store: NanoAtom<any> | NanoComputed<any>, _name: string, fn: (...args: Args) => Return): (...args: Args) => Return;
+
+type index_NanoAtom<T> = NanoAtom<T>;
+type index_NanoComputed<T> = NanoComputed<T>;
+type index_NanoMap<T extends Record<string, unknown>> = NanoMap<T>;
+declare const index_action: typeof action;
+declare const index_atom: typeof atom;
+declare const index_computed: typeof computed;
+declare const index_getValue: typeof getValue;
+declare const index_map: typeof map;
+declare const index_onMount: typeof onMount;
+declare const index_onStart: typeof onStart;
+declare const index_onStop: typeof onStop;
+declare namespace index {
+  export { type index_NanoAtom as NanoAtom, type index_NanoComputed as NanoComputed, type index_NanoMap as NanoMap, index_action as action, index_atom as atom, index_computed as computed, index_getValue as getValue, index_map as map, index_onMount as onMount, index_onStart as onStart, index_onStop as onStop };
+}
+
+export { type NanoAtom as N, type NanoComputed as a, type NanoMap as b, action as c, atom as d, computed as e, onStart as f, getValue as g, onStop as h, index as i, map as m, onMount as o };