@graphrefly/graphrefly 0.25.0 → 0.26.0

package/dist/patterns/reactive-layout/index.d.cts

@@ -1,5 +1,6 @@
-export { B as BlockAdapters, C as CanvasMeasureAdapter, a as CanvasMeasureAdapterOptions, b as CanvasModule, c as CharPosition, d as CircleObstacle, e as CliMeasureAdapter, f as CliMeasureAdapterOptions, g as ContentBlock, F as FlowColumns, h as FlowContainer, j as FlowLinesResult, I as ImageMeasurer, k as ImageSizeAdapter, l as Interval, L as LayoutCursor, m as LayoutLine, n as LayoutNextLineContext, o as LayoutNextLineResult, p as LineBreaksResult, q as MeasuredBlock, M as MeasurementAdapter, N as NodeCanvasMeasureAdapter, O as Obstacle, P as PositionedBlock, r as PositionedLine, s as PrecomputedAdapter, t as PrecomputedAdapterOptions, u as PreparedSegment, R as ReactiveBlockLayoutBundle, v as ReactiveBlockLayoutOptions, w as ReactiveFlowLayoutBundle, x as ReactiveFlowLayoutOptions, y as ReactiveLayoutBundle, z as ReactiveLayoutOptions, A as RectObstacle, S as SegmentBreakKind, D as SegmentMeasureStats, E as SvgBoundsAdapter, G as SvgMeasurer, H as analyzeAndMeasure, J as carveTextLineSlots, K as circleIntervalForBand, Q as computeBlockFlow, T as computeCharPositions, U as computeFlowLines, V as computeLineBreaks, W as computeTotalHeight, X as layoutNextLine, Y as measureBlock, Z as measureBlocks, _ as reactiveBlockLayout, $ as reactiveFlowLayout, a0 as reactiveLayout, a1 as rectIntervalForBand } from '../../index-DKE1EATr.cjs';
-import '../../node-B-f-Lu-k.cjs';
-import '../../graph-D-3JIQme.cjs';
-import '../../meta-DWbkoq1s.cjs';
-import '../../storage-BuTdpCI1.cjs';
+export { B as BlockAdapters, C as CanvasMeasureAdapter, a as CanvasMeasureAdapterOptions, b as CanvasModule, c as CircleObstacle, d as CliMeasureAdapter, e as CliMeasureAdapterOptions, f as ContentBlock, F as FlowColumns, g as FlowContainer, h as FlowLinesResult, I as ImageMeasurer, j as ImageSizeAdapter, M as MeasuredBlock, N as NodeCanvasMeasureAdapter, O as Obstacle, P as PositionedBlock, k as PositionedLine, l as PrecomputedAdapter, m as PrecomputedAdapterOptions, R as ReactiveBlockLayoutBundle, n as ReactiveBlockLayoutOptions, o as ReactiveFlowLayoutBundle, p as ReactiveFlowLayoutOptions, q as RectObstacle, S as SvgBoundsAdapter, r as SvgMeasurer, s as circleIntervalForBand, t as computeBlockFlow, u as computeFlowLines, v as computeTotalHeight, w as measureBlock, x as measureBlocks, y as reactiveBlockLayout, z as reactiveFlowLayout, A as rectIntervalForBand } from '../../index-C8mdwMXc.cjs';
+export { C as CharPosition, I as Interval, a as LayoutCursor, b as LayoutLine, c as LayoutNextLineContext, d as LayoutNextLineResult, L as LineBreaksResult, M as MeasurementAdapter, P as PreparedSegment, 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-BaOQefHu.cjs';
+import '../../node-C_IBuvX2.cjs';
+import '../../graph-6tZ5jEzr.cjs';
+import '../../meta-C0-8XW6Q.cjs';
+import '../../storage-DiqWHzVI.cjs';

package/dist/patterns/reactive-layout/index.d.ts

@@ -1,5 +1,6 @@
-export { B as BlockAdapters, C as CanvasMeasureAdapter, a as CanvasMeasureAdapterOptions, b as CanvasModule, c as CharPosition, d as CircleObstacle, e as CliMeasureAdapter, f as CliMeasureAdapterOptions, g as ContentBlock, F as FlowColumns, h as FlowContainer, j as FlowLinesResult, I as ImageMeasurer, k as ImageSizeAdapter, l as Interval, L as LayoutCursor, m as LayoutLine, n as LayoutNextLineContext, o as LayoutNextLineResult, p as LineBreaksResult, q as MeasuredBlock, M as MeasurementAdapter, N as NodeCanvasMeasureAdapter, O as Obstacle, P as PositionedBlock, r as PositionedLine, s as PrecomputedAdapter, t as PrecomputedAdapterOptions, u as PreparedSegment, R as ReactiveBlockLayoutBundle, v as ReactiveBlockLayoutOptions, w as ReactiveFlowLayoutBundle, x as ReactiveFlowLayoutOptions, y as ReactiveLayoutBundle, z as ReactiveLayoutOptions, A as RectObstacle, S as SegmentBreakKind, D as SegmentMeasureStats, E as SvgBoundsAdapter, G as SvgMeasurer, H as analyzeAndMeasure, J as carveTextLineSlots, K as circleIntervalForBand, Q as computeBlockFlow, T as computeCharPositions, U as computeFlowLines, V as computeLineBreaks, W as computeTotalHeight, X as layoutNextLine, Y as measureBlock, Z as measureBlocks, _ as reactiveBlockLayout, $ as reactiveFlowLayout, a0 as reactiveLayout, a1 as rectIntervalForBand } from '../../index-OXImXMq6.js';
-import '../../node-B-f-Lu-k.js';
-import '../../graph-B6NFqv3z.js';
-import '../../meta-CnkLA_43.js';
-import '../../storage-F2X1U1x0.js';
+export { B as BlockAdapters, C as CanvasMeasureAdapter, a as CanvasMeasureAdapterOptions, b as CanvasModule, c as CircleObstacle, d as CliMeasureAdapter, e as CliMeasureAdapterOptions, f as ContentBlock, F as FlowColumns, g as FlowContainer, h as FlowLinesResult, I as ImageMeasurer, j as ImageSizeAdapter, M as MeasuredBlock, N as NodeCanvasMeasureAdapter, O as Obstacle, P as PositionedBlock, k as PositionedLine, l as PrecomputedAdapter, m as PrecomputedAdapterOptions, R as ReactiveBlockLayoutBundle, n as ReactiveBlockLayoutOptions, o as ReactiveFlowLayoutBundle, p as ReactiveFlowLayoutOptions, q as RectObstacle, S as SvgBoundsAdapter, r as SvgMeasurer, s as circleIntervalForBand, t as computeBlockFlow, u as computeFlowLines, v as computeTotalHeight, w as measureBlock, x as measureBlocks, y as reactiveBlockLayout, z as reactiveFlowLayout, A as rectIntervalForBand } from '../../index-BW1z3BN9.js';
+export { C as CharPosition, I as Interval, a as LayoutCursor, b as LayoutLine, c as LayoutNextLineContext, d as LayoutNextLineResult, L as LineBreaksResult, M as MeasurementAdapter, P as PreparedSegment, 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-D9gejYXE.js';
+import '../../node-C_IBuvX2.js';
+import '../../graph-DQ69XU0g.js';
+import '../../meta-BGqSZ7mt.js';
+import '../../storage-BMycWEh2.js';

package/dist/patterns/reactive-layout/index.js

@@ -5,28 +5,31 @@ import {
   NodeCanvasMeasureAdapter,
   PrecomputedAdapter,
   SvgBoundsAdapter,
-  analyzeAndMeasure,
-  carveTextLineSlots,
   circleIntervalForBand,
   computeBlockFlow,
-  computeCharPositions,
   computeFlowLines,
-  computeLineBreaks,
   computeTotalHeight,
-  layoutNextLine,
   measureBlock,
   measureBlocks,
   reactiveBlockLayout,
   reactiveFlowLayout,
-  reactiveLayout,
   rectIntervalForBand
-} from "../../chunk-TKE3JGOH.js";
-import "../../chunk-HWPIFSW2.js";
-import "../../chunk-L2GLW2U7.js";
-import "../../chunk-XOFWRC73.js";
-import "../../chunk-H4RVA4VE.js";
+} from "../../chunk-ZQMEI34O.js";
+import {
+  analyzeAndMeasure,
+  carveTextLineSlots,
+  computeCharPositions,
+  computeLineBreaks,
+  layoutNextLine,
+  reactiveLayout
+} from "../../chunk-LCE3GF5P.js";
+import "../../chunk-JSCT3CR4.js";
+import "../../chunk-BVZYTZ5H.js";
+import "../../chunk-THTWHNU4.js";
 import "../../chunk-7TAQJHQV.js";
-import "../../chunk-5DJTTKX3.js";
+import "../../chunk-VYPWMZ6H.js";
+import "../../chunk-PHOUUNK7.js";
+import "../../chunk-SX52TAR4.js";
 export {
   CanvasMeasureAdapter,
   CliMeasureAdapter,

package/dist/reactive-layout-BaOQefHu.d.cts

@@ -0,0 +1,183 @@
+import { N as Node } from './node-C_IBuvX2.cjs';
+import { G as Graph } from './graph-6tZ5jEzr.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;
+
+export { type CharPosition as C, type Interval as I, type LineBreaksResult as L, type MeasurementAdapter as M, type PreparedSegment as P, type ReactiveLayoutBundle as R, type SegmentBreakKind as S, type LayoutCursor as a, type LayoutLine as b, type LayoutNextLineContext as c, type LayoutNextLineResult as d, type ReactiveLayoutOptions as e, type SegmentMeasureStats as f, analyzeAndMeasure as g, carveTextLineSlots as h, computeCharPositions as i, computeLineBreaks as j, layoutNextLine as l, reactiveLayout as r };

package/dist/reactive-layout-D9gejYXE.d.ts

@@ -0,0 +1,183 @@
+import { N as Node } from './node-C_IBuvX2.js';
+import { G as Graph } from './graph-DQ69XU0g.js';
+
+/** 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;
+
+export { type CharPosition as C, type Interval as I, type LineBreaksResult as L, type MeasurementAdapter as M, type PreparedSegment as P, type ReactiveLayoutBundle as R, type SegmentBreakKind as S, type LayoutCursor as a, type LayoutLine as b, type LayoutNextLineContext as c, type LayoutNextLineResult as d, type ReactiveLayoutOptions as e, type SegmentMeasureStats as f, analyzeAndMeasure as g, carveTextLineSlots as h, computeCharPositions as i, computeLineBreaks as j, layoutNextLine as l, reactiveLayout as r };

package/dist/{storage-BuTdpCI1.d.cts → storage-BMycWEh2.d.ts}

@@ -1,4 +1,4 @@
-import { N as Node } from './node-B-f-Lu-k.cjs';
+import { N as Node } from './node-C_IBuvX2.js';
 
 /**
  * Storage tier primitive — unified persistence surface (roadmap §3.1).
@@ -28,6 +28,14 @@ interface StorageTier {
     save(key: string, data: unknown): void | Promise<void>;
     /** Delete a value. Optional — tiers without `clear` are append/overwrite-only. */
     clear?(key: string): void | Promise<void>;
+    /**
+     * Enumerate known keys. Optional — tiers that only address a single record
+     * (e.g. `indexedDbStorage`) or that can't cheaply enumerate (e.g. a remote
+     * write-only sink) may omit it. Callers that require enumeration (the
+     * surface `snapshot.list()` helper, MCP `graphrefly_snapshot_list`, CLI
+     * `graphrefly snapshot list`) should check before calling.
+     */
+    list?(): readonly string[] | Promise<readonly string[]>;
     /**
      * Debounce saves on this tier (ms). Hot tier: `0` (sync-through).
      * Warm: `1000`. Cold: `60000`. Each tier holds its own last-save baseline,

package/dist/{storage-F2X1U1x0.d.ts → storage-DiqWHzVI.d.cts}

@@ -1,4 +1,4 @@
-import { N as Node } from './node-B-f-Lu-k.js';
+import { N as Node } from './node-C_IBuvX2.cjs';
 
 /**
  * Storage tier primitive — unified persistence surface (roadmap §3.1).
@@ -28,6 +28,14 @@ interface StorageTier {
     save(key: string, data: unknown): void | Promise<void>;
     /** Delete a value. Optional — tiers without `clear` are append/overwrite-only. */
     clear?(key: string): void | Promise<void>;
+    /**
+     * Enumerate known keys. Optional — tiers that only address a single record
+     * (e.g. `indexedDbStorage`) or that can't cheaply enumerate (e.g. a remote
+     * write-only sink) may omit it. Callers that require enumeration (the
+     * surface `snapshot.list()` helper, MCP `graphrefly_snapshot_list`, CLI
+     * `graphrefly snapshot list`) should check before calling.
+     */
+    list?(): readonly string[] | Promise<readonly string[]>;
     /**
      * Debounce saves on this tier (ms). Hot tier: `0` (sync-through).
      * Warm: `1000`. Cold: `60000`. Each tier holds its own last-save baseline,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@graphrefly/graphrefly",
-	"version": "0.25.0",
+	"version": "0.26.0",
 	"packageManager": "pnpm@10.33.0+sha512.10568bb4a6afb58c9eb3630da90cc9516417abebd3fabbe6739f0ae795728da1491e9db5a544c76ad8eb7570f5c4bb3d6c637b2cb41bfdcdb47fa823c8649319",
 	"description": "Reactive harness layer for agent workflows. Describe automations in plain language, trace every decision, enforce policies, persist checkpoints. Zero dependencies.",
 	"repository": {
@@ -47,6 +47,16 @@
 				"default": "./dist/extra/index.cjs"
 			}
 		},
+		"./extra/sources": {
+			"import": {
+				"types": "./dist/extra/sources.d.ts",
+				"default": "./dist/extra/sources.js"
+			},
+			"require": {
+				"types": "./dist/extra/sources.d.cts",
+				"default": "./dist/extra/sources.cjs"
+			}
+		},
 		"./graph": {
 			"import": {
 				"types": "./dist/graph/index.d.ts",
@@ -77,6 +87,16 @@
 				"default": "./dist/compat/jotai/index.cjs"
 			}
 		},
+		"./compat/nanostores": {
+			"import": {
+				"types": "./dist/compat/nanostores/index.d.ts",
+				"default": "./dist/compat/nanostores/index.js"
+			},
+			"require": {
+				"types": "./dist/compat/nanostores/index.d.cts",
+				"default": "./dist/compat/nanostores/index.cjs"
+			}
+		},
 		"./compat/zustand": {
 			"import": {
 				"types": "./dist/compat/zustand/index.d.ts",
@@ -137,7 +157,7 @@
 				"default": "./dist/compat/nestjs/index.cjs"
 			}
 		},
-		"./reactive-layout": {
+		"./patterns/reactive-layout": {
 			"import": {
 				"types": "./dist/patterns/reactive-layout/index.d.ts",
 				"default": "./dist/patterns/reactive-layout/index.js"
@@ -146,6 +166,16 @@
 				"types": "./dist/patterns/reactive-layout/index.d.cts",
 				"default": "./dist/patterns/reactive-layout/index.cjs"
 			}
+		},
+		"./patterns/demo-shell": {
+			"import": {
+				"types": "./dist/patterns/demo-shell.d.ts",
+				"default": "./dist/patterns/demo-shell.js"
+			},
+			"require": {
+				"types": "./dist/patterns/demo-shell.d.cts",
+				"default": "./dist/patterns/demo-shell.cjs"
+			}
 		}
 	},
 	"files": [