@graphrefly/ts 0.0.1 → 0.0.3

package/dist/measurements-BWAnochv.d.ts

@@ -0,0 +1,294 @@
+import { z as MeasurementAdapter, ac as TextMeasureCapability, f as CellMeasureAdapterOptions, n as ImageMeasurer, o as ImageSizeLookup, a5 as Size, x as MeasureFn, r as InjectedMeasureAdapterOptions, N as PrecomputedMeasureAdapterOptions, a9 as SvgMeasurer, y as MeasuredBlock, P as PositionedBlock, j as ContentBlock, M as MeasureBlockOptions, U as ReactiveBlockLayoutOptions, T as ReactiveBlockLayoutBundle, W as ReactiveFlowLayoutOptions, V as ReactiveFlowLayoutBundle, Y as ReactiveLayoutOptions, X as ReactiveLayoutBundle, h as CircleObstacle, ag as Interval, R as PreparedSegment, i as ComputeFlowLinesOptions, l as FlowLinesResult, $ as RectObstacle, O as Obstacle, k as FlowContainer, F as FlowColumns, a4 as SegmentMeasureStats, a1 as SegmentAdapter, w as LineBreaksResult, af as CharPosition, L as LayoutCursor, u as LayoutNextLineContext, v as LayoutNextLineResult, c as BlockAdaptersProviderOptions, b as BlockAdapters, d as BlockMeasurementProviderOptions, H as Measurements, C as CapabilityTextMeasurementsOptions, g as CellTextMeasurementsOptions, q as ImageSizeMeasurementsOptions, s as InjectedTextMeasurementsOptions, J as MergeMeasurementsOptions, Q as PrecomputedTextMeasurementsOptions, Z as ReadinessMeasurementsOptions, _ as ReadinessTextMeasurementsOptions, a7 as SvgBoundsMeasurementsOptions, ad as TextMeasurementProviderOptions, D as MeasurementIssue, G as MeasurementResult } from './types-ePlD2uyT.js';
+import { DataIssue } from './data/index.js';
+import { d as Graph } from './graph-CS0b4V9B.js';
+import { N as Node } from './types-DChxk1vK.js';
+
+/** Adapter that wraps a caller-owned synchronous measurement function. */
+declare class InjectedMeasureAdapter implements MeasurementAdapter {
+    private readonly measure;
+    private readonly shouldCache;
+    private readonly cache;
+    constructor(measure: MeasureFn, opts?: InjectedMeasureAdapterOptions);
+    measureSegment(text: string, font: string): {
+        readonly width: number;
+    };
+    clearCache(): void;
+}
+/** Deterministic adapter backed by caller-supplied width metrics. */
+declare class PrecomputedMeasureAdapter implements MeasurementAdapter {
+    private readonly metrics;
+    private readonly fallback;
+    private readonly cellWidth;
+    constructor(opts: PrecomputedMeasureAdapterOptions);
+    measureSegment(text: string, font: string): {
+        readonly width: number;
+    };
+}
+/** Fixed-cell adapter for CLI, snapshots, and tests. */
+declare class CellMeasureAdapter implements MeasurementAdapter {
+    private readonly cellWidth;
+    private readonly wideCellWidth;
+    private readonly tabCells;
+    constructor(opts?: CellMeasureAdapterOptions);
+    measureSegment(text: string): {
+        readonly width: number;
+    };
+}
+/** Adapter over a caller-owned platform capability such as NodeCanvas, Skia, or RN text APIs. */
+declare class CapabilityMeasureAdapter implements MeasurementAdapter {
+    private readonly capability;
+    constructor(capability: TextMeasureCapability);
+    measureSegment(text: string, font: string): {
+        readonly width: number;
+    };
+    clearCache(): void;
+}
+/**
+ * Minimal string-based SVG bounds reader for explicit width/height or viewBox.
+ *
+ * This is not a DOM SVG parser and does not resolve external resources.
+ */
+declare class SvgBoundsAdapter implements SvgMeasurer {
+    measureSvg(svg: string): Size;
+}
+/** Image measurer backed by explicit caller-provided dimensions; it never loads images. */
+declare class ImageSizeAdapter implements ImageMeasurer {
+    private readonly sizes;
+    constructor(sizes: ImageSizeLookup | Record<string, Size>);
+    measureImage(src: string): Size;
+}
+
+/** Measure one text/image/SVG block using only explicit or injected synchronous adapters. */
+declare function measureBlock(block: ContentBlock, opts: MeasureBlockOptions): MeasuredBlock;
+/** Measure a block list while sharing a measurement cache across text blocks. */
+declare function measureBlocks(blocks: readonly ContentBlock[], opts: MeasureBlockOptions): readonly MeasuredBlock[];
+/** Stack measured blocks vertically with margins and a fixed gap. */
+declare function computeBlockFlow(blocks: readonly MeasuredBlock[], gap?: number): readonly PositionedBlock[];
+/** Compute the bottom edge of a positioned block flow. */
+declare function computeTotalHeight(blocks: readonly PositionedBlock[]): number;
+
+/**
+ * Create a graph-visible single-column text layout bundle.
+ *
+ * @param opts - Requires a graph and a graph-visible `measurements` node, plus optional
+ *   `lineHeight`, `maxWidth`, `targetId`, `segmentAdapter`, and bundle `name`.
+ * @returns A `ReactiveLayoutBundle` containing input nodes, setters, and graph-visible output
+ *   nodes for segments, line breaks, height, and character positions.
+ * @example
+ * ```ts
+ * import { graph } from "@graphrefly/ts";
+ * import {
+ *   cellTextMeasurements,
+ *   reactiveLayout,
+ * } from "@graphrefly/ts/solutions/reactive-layout";
+ *
+ * const g = graph({ name: "article" });
+ * const text = g.state("Hello GraphReFly", { name: "text" });
+ * const font = g.state("16px system-ui", { name: "font" });
+ * const measurements = cellTextMeasurements({ graph: g, text, font });
+ *
+ * const layout = reactiveLayout({ graph: g, measurements, maxWidth: 320, lineHeight: 20 });
+ * layout.setMaxWidth(280);
+ * ```
+ * @remarks **Graph-visible:** This creates ordinary state/output nodes only; it does not add
+ *   protocol behavior, hidden subscriptions, GraphSpec ownership, storage, or platform globals.
+ * @category solutions
+ */
+declare function reactiveLayout(opts: ReactiveLayoutOptions): ReactiveLayoutBundle;
+/**
+ * Create a graph-visible vertical block layout bundle over the same DOM-free core.
+ *
+ * @param opts - Requires a graph and a graph-visible block `measurements` node, plus optional
+ *   `gap`, `targetId`, and bundle `name`.
+ * @returns A `ReactiveBlockLayoutBundle` containing the gap input, measured block output,
+ *   positioned block flow, and total height node.
+ * @example
+ * ```ts
+ * import { graph } from "@graphrefly/ts";
+ * import {
+ *   blockAdaptersProvider,
+ *   blockMeasurementProvider,
+ *   reactiveBlockLayout,
+ *   type MeasurementAdapter,
+ * } from "@graphrefly/ts/solutions/reactive-layout";
+ *
+ * const g = graph({ name: "cards" });
+ * const blocks = g.state([{ id: "title", kind: "text", text: "Hello" }]);
+ * const maxWidth = g.state(320);
+ * const text = g.state<MeasurementAdapter>({
+ *   measureSegment: (segment) => ({ width: segment.length * 8 }),
+ * });
+ * const measurements = blockMeasurementProvider({
+ *   graph: g,
+ *   blocks,
+ *   maxWidth,
+ *   adapters: blockAdaptersProvider({ graph: g, text }),
+ * });
+ *
+ * const layout = reactiveBlockLayout({ graph: g, measurements, gap: 12 });
+ * layout.setGap(16);
+ * ```
+ * @remarks **DOM-free:** Image/SVG sizing is explicit or injected; no async image loading or
+ *   DOM SVG parsing occurs in the core layout bundle.
+ * @category solutions
+ */
+declare function reactiveBlockLayout(opts: ReactiveBlockLayoutOptions): ReactiveBlockLayoutBundle;
+/** Create a graph-visible multi-column flow layout bundle with rectangle/circle obstacles. */
+declare function reactiveFlowLayout(opts: ReactiveFlowLayoutOptions): ReactiveFlowLayoutBundle;
+
+declare function columnGeometry(container: FlowContainer, columns: FlowColumns | undefined): {
+    readonly paddingX: number;
+    readonly paddingY: number;
+    readonly count: number;
+    readonly gap: number;
+    readonly width: number;
+    readonly height: number;
+    readonly columnWidth: number;
+};
+declare function sanitizeFlowContainer(container: FlowContainer): FlowContainer;
+declare function sanitizeFlowColumns(columns: FlowColumns): FlowColumns;
+declare function sanitizeObstacles(obstacles: readonly Obstacle[]): readonly Obstacle[];
+/** Intersect a circle obstacle with a horizontal line band. */
+declare function circleIntervalForBand(obstacle: CircleObstacle, bandTop: number, bandBottom: number): Interval | null;
+/** Intersect a rectangle obstacle with a horizontal line band. */
+declare function rectIntervalForBand(obstacle: RectObstacle, bandTop: number, bandBottom: number): Interval | null;
+declare function blockedIntervalsForBand(obstacles: readonly Obstacle[], bandTop: number, bandBottom: number): Interval[];
+/** Flow prepared text through columns and carved obstacle slots. */
+declare function computeFlowLines(segments: readonly PreparedSegment[], opts: ComputeFlowLinesOptions): FlowLinesResult;
+
+/**
+ * Segment text and measure every resulting segment with a caller-owned synchronous adapter.
+ *
+ * @param text - Text to normalize, segment, and measure.
+ * @param font - Font descriptor passed through to the measurement adapter.
+ * @param adapter - Synchronous measurement adapter used for each segment or grapheme.
+ * @param cache - Caller-owned cache keyed by font and segment text.
+ * @param stats - Optional cache hit/miss accounting object updated during measurement.
+ * @param segmentAdapter - Optional segmentation adapter; defaults to the built-in adapter.
+ * @returns A prepared segment list with widths, break kinds, and optional grapheme widths for
+ *   word-like segments.
+ * @example
+ * ```ts
+ * import { analyzeAndMeasure } from "@graphrefly/ts/solutions/reactive-layout";
+ *
+ * const segments = analyzeAndMeasure(
+ *   "Hello world",
+ *   "16px system-ui",
+ *   { measureSegment: (segment) => ({ width: segment.length * 8 }) },
+ *   new Map(),
+ * );
+ * ```
+ * @remarks **Caller-owned adapter:** Measurement stays synchronous and host-injected; browser
+ *   Canvas, Skia, React Native, or test adapters live outside this helper.
+ * @category solutions
+ */
+declare function analyzeAndMeasure(text: string, font: string, adapter: MeasurementAdapter, cache: Map<string, Map<string, number>>, stats?: SegmentMeasureStats, segmentAdapter?: SegmentAdapter): PreparedSegment[];
+/**
+ * Compute greedy single-column line breaks over prepared segments.
+ *
+ * @param segments - Prepared segments from `analyzeAndMeasure` or a measurement provider.
+ * @param maxWidth - Maximum line width in pixels; non-finite or negative values produce no useful
+ *   width budget.
+ * @param opts - Optional hyphen width and segment adapter for grapheme-aware slicing.
+ * @returns A `LineBreaksResult` containing ordered layout lines and the line count.
+ * @example
+ * ```ts
+ * import { analyzeAndMeasure, computeLineBreaks } from "@graphrefly/ts/solutions/reactive-layout";
+ *
+ * const segments = analyzeAndMeasure(
+ *   "Hello world",
+ *   "16px system-ui",
+ *   { measureSegment: (segment) => ({ width: segment.length * 8 }) },
+ *   new Map(),
+ * );
+ * const lineBreaks = computeLineBreaks(segments, 64);
+ * ```
+ * @remarks **Pure helper:** This does not subscribe, schedule, or emit messages; reactive bundles
+ *   call it from ordinary graph nodes.
+ * @category solutions
+ */
+declare function computeLineBreaks(segments: readonly PreparedSegment[], maxWidth: number, opts?: {
+    readonly hyphenWidth?: number;
+    readonly segmentAdapter?: SegmentAdapter;
+}): LineBreaksResult;
+/** Lay out one line from a cursor, returning the next cursor for continuation. */
+declare function layoutNextLine(segments: readonly PreparedSegment[], cursor: LayoutCursor, slotWidth: number, ctx?: LayoutNextLineContext): LayoutNextLineResult | null;
+/** Subtract obstacle intervals from a horizontal text band. */
+declare function carveTextLineSlots(base: Interval, blocked: readonly Interval[], minSlotWidth?: number): Interval[];
+/**
+ * Compute per-grapheme boxes for already-broken lines.
+ *
+ * @param lineBreaks - Line break result whose cursors identify the visible grapheme ranges.
+ * @param segments - Prepared segments used to produce the line breaks.
+ * @param lineHeight - Height assigned to every line box.
+ * @param segmentAdapter - Optional segmentation adapter; defaults to the built-in adapter.
+ * @returns Character-position boxes in visual order, each with `x`, `y`, `width`, `height`, and
+ *   zero-based line index.
+ * @example
+ * ```ts
+ * import {
+ *   analyzeAndMeasure,
+ *   computeCharPositions,
+ *   computeLineBreaks,
+ * } from "@graphrefly/ts/solutions/reactive-layout";
+ *
+ * const segments = analyzeAndMeasure(
+ *   "Hello world",
+ *   "16px system-ui",
+ *   { measureSegment: (segment) => ({ width: segment.length * 8 }) },
+ *   new Map(),
+ * );
+ * const lineBreaks = computeLineBreaks(segments, 64);
+ * const positions = computeCharPositions(lineBreaks, segments, 20);
+ * ```
+ * @remarks **Already measured:** Widths come from the prepared segments; this helper only maps the
+ *   line cursors into per-grapheme rectangles.
+ * @category solutions
+ */
+declare function computeCharPositions(lineBreaks: LineBreaksResult, segments: readonly PreparedSegment[], lineHeight: number, segmentAdapter?: SegmentAdapter): readonly CharPosition[];
+
+declare function measurementIssue(code: string, message: string, targetId: string, measurementKind: string, opts?: {
+    readonly source?: string;
+    readonly details?: unknown;
+    readonly metadata?: Record<string, unknown>;
+    readonly severity?: DataIssue["severity"];
+}): MeasurementIssue;
+declare function measurementOk<T>(targetId: string, measurementKind: string, value: T, opts?: {
+    readonly source?: string;
+    readonly metadata?: Record<string, unknown>;
+}): MeasurementResult<T>;
+declare function latestMeasurementValue<T>(measurements: Measurements, targetId: string, measurementKind: string): T | undefined;
+declare function tryMeasureHyphenWidth(adapter: MeasurementAdapter, font: string): number | undefined;
+declare function validMeasurementSize(size: Size, label: string): Size;
+declare function textMeasurementFacts(text: string, font: string, adapter: MeasurementAdapter, cache: Map<string, Map<string, number>>, segmentAdapter: SegmentAdapter, targetId: string, source: string): Measurements;
+declare function inputNode<T>(g: Graph, input: T | Node<T> | undefined, fallback: T, name: string): {
+    readonly node: Node<T>;
+    readonly set: (value: T) => void;
+};
+declare function scopedName(scope: string, local: string): string;
+/** Generic sync text measurement provider that emits graph-visible measurement facts. */
+declare function textMeasurementProvider(opts: TextMeasurementProviderOptions): Node<Measurements>;
+/** Provider helper for caller-injected synchronous text measurement. */
+declare function injectedTextMeasurements(opts: InjectedTextMeasurementsOptions): Node<Measurements>;
+/** Provider helper for deterministic precomputed text metrics. */
+declare function precomputedTextMeasurements(opts: PrecomputedTextMeasurementsOptions): Node<Measurements>;
+/** Provider helper for fixed-cell terminal/snapshot text measurement. */
+declare function cellTextMeasurements(opts: CellTextMeasurementsOptions): Node<Measurements>;
+/** Provider helper for caller-injected platform text capability nodes. */
+declare function capabilityTextMeasurements(opts: CapabilityTextMeasurementsOptions): Node<Measurements>;
+/** Provider helper that makes readiness facts an explicit measurement dependency. */
+declare function readinessTextMeasurements(opts: ReadinessTextMeasurementsOptions): Node<Measurements>;
+/** Provider helper that emits graph-visible readiness facts without measuring layout. */
+declare function readinessMeasurements(opts: ReadinessMeasurementsOptions): Node<Measurements>;
+/** Provider helper for image-size facts from caller-owned synchronous image measurers. */
+declare function imageSizeMeasurements(opts: ImageSizeMeasurementsOptions): Node<Measurements>;
+/** Provider helper for SVG bounds facts from caller-owned synchronous SVG measurers. */
+declare function svgBoundsMeasurements(opts: SvgBoundsMeasurementsOptions): Node<Measurements>;
+/** Merge provider fact nodes into the single measurements node consumed by layout bundles. */
+declare function mergeMeasurements(opts: MergeMeasurementsOptions): Node<Measurements>;
+/** Compose optional block measurement capability nodes into one graph-visible adapter node. */
+declare function blockAdaptersProvider(opts: BlockAdaptersProviderOptions): Node<BlockAdapters>;
+/** Provider helper for block measurement facts over declared block/max-width deps. */
+declare function blockMeasurementProvider(opts: BlockMeasurementProviderOptions): Node<Measurements>;
+
+export { rectIntervalForBand as A, svgBoundsMeasurements as B, CapabilityMeasureAdapter as C, textMeasurementProvider as D, blockedIntervalsForBand as E, columnGeometry as F, inputNode as G, latestMeasurementValue as H, ImageSizeAdapter as I, measurementIssue as J, measurementOk as K, sanitizeFlowColumns as L, sanitizeFlowContainer as M, sanitizeObstacles as N, scopedName as O, PrecomputedMeasureAdapter as P, textMeasurementFacts as Q, tryMeasureHyphenWidth as R, SvgBoundsAdapter as S, validMeasurementSize as T, CellMeasureAdapter as a, InjectedMeasureAdapter as b, analyzeAndMeasure as c, blockAdaptersProvider as d, blockMeasurementProvider as e, capabilityTextMeasurements as f, carveTextLineSlots as g, cellTextMeasurements as h, circleIntervalForBand as i, computeBlockFlow as j, computeCharPositions as k, computeFlowLines as l, computeLineBreaks as m, computeTotalHeight as n, imageSizeMeasurements as o, injectedTextMeasurements as p, layoutNextLine as q, measureBlock as r, measureBlocks as s, mergeMeasurements as t, precomputedTextMeasurements as u, reactiveBlockLayout as v, reactiveFlowLayout as w, reactiveLayout as x, readinessMeasurements as y, readinessTextMeasurements as z };

package/dist/measurements-B_gJfD8h.d.cts

@@ -0,0 +1,294 @@
+import { z as MeasurementAdapter, ac as TextMeasureCapability, f as CellMeasureAdapterOptions, n as ImageMeasurer, o as ImageSizeLookup, a5 as Size, x as MeasureFn, r as InjectedMeasureAdapterOptions, N as PrecomputedMeasureAdapterOptions, a9 as SvgMeasurer, y as MeasuredBlock, P as PositionedBlock, j as ContentBlock, M as MeasureBlockOptions, U as ReactiveBlockLayoutOptions, T as ReactiveBlockLayoutBundle, W as ReactiveFlowLayoutOptions, V as ReactiveFlowLayoutBundle, Y as ReactiveLayoutOptions, X as ReactiveLayoutBundle, h as CircleObstacle, ag as Interval, R as PreparedSegment, i as ComputeFlowLinesOptions, l as FlowLinesResult, $ as RectObstacle, O as Obstacle, k as FlowContainer, F as FlowColumns, a4 as SegmentMeasureStats, a1 as SegmentAdapter, w as LineBreaksResult, af as CharPosition, L as LayoutCursor, u as LayoutNextLineContext, v as LayoutNextLineResult, c as BlockAdaptersProviderOptions, b as BlockAdapters, d as BlockMeasurementProviderOptions, H as Measurements, C as CapabilityTextMeasurementsOptions, g as CellTextMeasurementsOptions, q as ImageSizeMeasurementsOptions, s as InjectedTextMeasurementsOptions, J as MergeMeasurementsOptions, Q as PrecomputedTextMeasurementsOptions, Z as ReadinessMeasurementsOptions, _ as ReadinessTextMeasurementsOptions, a7 as SvgBoundsMeasurementsOptions, ad as TextMeasurementProviderOptions, D as MeasurementIssue, G as MeasurementResult } from './types-CMnzoL54.cjs';
+import { DataIssue } from './data/index.cjs';
+import { d as Graph } from './graph-C1C-wb0L.cjs';
+import { N as Node } from './types-CTN3XoMl.cjs';
+
+/** Adapter that wraps a caller-owned synchronous measurement function. */
+declare class InjectedMeasureAdapter implements MeasurementAdapter {
+    private readonly measure;
+    private readonly shouldCache;
+    private readonly cache;
+    constructor(measure: MeasureFn, opts?: InjectedMeasureAdapterOptions);
+    measureSegment(text: string, font: string): {
+        readonly width: number;
+    };
+    clearCache(): void;
+}
+/** Deterministic adapter backed by caller-supplied width metrics. */
+declare class PrecomputedMeasureAdapter implements MeasurementAdapter {
+    private readonly metrics;
+    private readonly fallback;
+    private readonly cellWidth;
+    constructor(opts: PrecomputedMeasureAdapterOptions);
+    measureSegment(text: string, font: string): {
+        readonly width: number;
+    };
+}
+/** Fixed-cell adapter for CLI, snapshots, and tests. */
+declare class CellMeasureAdapter implements MeasurementAdapter {
+    private readonly cellWidth;
+    private readonly wideCellWidth;
+    private readonly tabCells;
+    constructor(opts?: CellMeasureAdapterOptions);
+    measureSegment(text: string): {
+        readonly width: number;
+    };
+}
+/** Adapter over a caller-owned platform capability such as NodeCanvas, Skia, or RN text APIs. */
+declare class CapabilityMeasureAdapter implements MeasurementAdapter {
+    private readonly capability;
+    constructor(capability: TextMeasureCapability);
+    measureSegment(text: string, font: string): {
+        readonly width: number;
+    };
+    clearCache(): void;
+}
+/**
+ * Minimal string-based SVG bounds reader for explicit width/height or viewBox.
+ *
+ * This is not a DOM SVG parser and does not resolve external resources.
+ */
+declare class SvgBoundsAdapter implements SvgMeasurer {
+    measureSvg(svg: string): Size;
+}
+/** Image measurer backed by explicit caller-provided dimensions; it never loads images. */
+declare class ImageSizeAdapter implements ImageMeasurer {
+    private readonly sizes;
+    constructor(sizes: ImageSizeLookup | Record<string, Size>);
+    measureImage(src: string): Size;
+}
+
+/** Measure one text/image/SVG block using only explicit or injected synchronous adapters. */
+declare function measureBlock(block: ContentBlock, opts: MeasureBlockOptions): MeasuredBlock;
+/** Measure a block list while sharing a measurement cache across text blocks. */
+declare function measureBlocks(blocks: readonly ContentBlock[], opts: MeasureBlockOptions): readonly MeasuredBlock[];
+/** Stack measured blocks vertically with margins and a fixed gap. */
+declare function computeBlockFlow(blocks: readonly MeasuredBlock[], gap?: number): readonly PositionedBlock[];
+/** Compute the bottom edge of a positioned block flow. */
+declare function computeTotalHeight(blocks: readonly PositionedBlock[]): number;
+
+/**
+ * Create a graph-visible single-column text layout bundle.
+ *
+ * @param opts - Requires a graph and a graph-visible `measurements` node, plus optional
+ *   `lineHeight`, `maxWidth`, `targetId`, `segmentAdapter`, and bundle `name`.
+ * @returns A `ReactiveLayoutBundle` containing input nodes, setters, and graph-visible output
+ *   nodes for segments, line breaks, height, and character positions.
+ * @example
+ * ```ts
+ * import { graph } from "@graphrefly/ts";
+ * import {
+ *   cellTextMeasurements,
+ *   reactiveLayout,
+ * } from "@graphrefly/ts/solutions/reactive-layout";
+ *
+ * const g = graph({ name: "article" });
+ * const text = g.state("Hello GraphReFly", { name: "text" });
+ * const font = g.state("16px system-ui", { name: "font" });
+ * const measurements = cellTextMeasurements({ graph: g, text, font });
+ *
+ * const layout = reactiveLayout({ graph: g, measurements, maxWidth: 320, lineHeight: 20 });
+ * layout.setMaxWidth(280);
+ * ```
+ * @remarks **Graph-visible:** This creates ordinary state/output nodes only; it does not add
+ *   protocol behavior, hidden subscriptions, GraphSpec ownership, storage, or platform globals.
+ * @category solutions
+ */
+declare function reactiveLayout(opts: ReactiveLayoutOptions): ReactiveLayoutBundle;
+/**
+ * Create a graph-visible vertical block layout bundle over the same DOM-free core.
+ *
+ * @param opts - Requires a graph and a graph-visible block `measurements` node, plus optional
+ *   `gap`, `targetId`, and bundle `name`.
+ * @returns A `ReactiveBlockLayoutBundle` containing the gap input, measured block output,
+ *   positioned block flow, and total height node.
+ * @example
+ * ```ts
+ * import { graph } from "@graphrefly/ts";
+ * import {
+ *   blockAdaptersProvider,
+ *   blockMeasurementProvider,
+ *   reactiveBlockLayout,
+ *   type MeasurementAdapter,
+ * } from "@graphrefly/ts/solutions/reactive-layout";
+ *
+ * const g = graph({ name: "cards" });
+ * const blocks = g.state([{ id: "title", kind: "text", text: "Hello" }]);
+ * const maxWidth = g.state(320);
+ * const text = g.state<MeasurementAdapter>({
+ *   measureSegment: (segment) => ({ width: segment.length * 8 }),
+ * });
+ * const measurements = blockMeasurementProvider({
+ *   graph: g,
+ *   blocks,
+ *   maxWidth,
+ *   adapters: blockAdaptersProvider({ graph: g, text }),
+ * });
+ *
+ * const layout = reactiveBlockLayout({ graph: g, measurements, gap: 12 });
+ * layout.setGap(16);
+ * ```
+ * @remarks **DOM-free:** Image/SVG sizing is explicit or injected; no async image loading or
+ *   DOM SVG parsing occurs in the core layout bundle.
+ * @category solutions
+ */
+declare function reactiveBlockLayout(opts: ReactiveBlockLayoutOptions): ReactiveBlockLayoutBundle;
+/** Create a graph-visible multi-column flow layout bundle with rectangle/circle obstacles. */
+declare function reactiveFlowLayout(opts: ReactiveFlowLayoutOptions): ReactiveFlowLayoutBundle;
+
+declare function columnGeometry(container: FlowContainer, columns: FlowColumns | undefined): {
+    readonly paddingX: number;
+    readonly paddingY: number;
+    readonly count: number;
+    readonly gap: number;
+    readonly width: number;
+    readonly height: number;
+    readonly columnWidth: number;
+};
+declare function sanitizeFlowContainer(container: FlowContainer): FlowContainer;
+declare function sanitizeFlowColumns(columns: FlowColumns): FlowColumns;
+declare function sanitizeObstacles(obstacles: readonly Obstacle[]): readonly Obstacle[];
+/** Intersect a circle obstacle with a horizontal line band. */
+declare function circleIntervalForBand(obstacle: CircleObstacle, bandTop: number, bandBottom: number): Interval | null;
+/** Intersect a rectangle obstacle with a horizontal line band. */
+declare function rectIntervalForBand(obstacle: RectObstacle, bandTop: number, bandBottom: number): Interval | null;
+declare function blockedIntervalsForBand(obstacles: readonly Obstacle[], bandTop: number, bandBottom: number): Interval[];
+/** Flow prepared text through columns and carved obstacle slots. */
+declare function computeFlowLines(segments: readonly PreparedSegment[], opts: ComputeFlowLinesOptions): FlowLinesResult;
+
+/**
+ * Segment text and measure every resulting segment with a caller-owned synchronous adapter.
+ *
+ * @param text - Text to normalize, segment, and measure.
+ * @param font - Font descriptor passed through to the measurement adapter.
+ * @param adapter - Synchronous measurement adapter used for each segment or grapheme.
+ * @param cache - Caller-owned cache keyed by font and segment text.
+ * @param stats - Optional cache hit/miss accounting object updated during measurement.
+ * @param segmentAdapter - Optional segmentation adapter; defaults to the built-in adapter.
+ * @returns A prepared segment list with widths, break kinds, and optional grapheme widths for
+ *   word-like segments.
+ * @example
+ * ```ts
+ * import { analyzeAndMeasure } from "@graphrefly/ts/solutions/reactive-layout";
+ *
+ * const segments = analyzeAndMeasure(
+ *   "Hello world",
+ *   "16px system-ui",
+ *   { measureSegment: (segment) => ({ width: segment.length * 8 }) },
+ *   new Map(),
+ * );
+ * ```
+ * @remarks **Caller-owned adapter:** Measurement stays synchronous and host-injected; browser
+ *   Canvas, Skia, React Native, or test adapters live outside this helper.
+ * @category solutions
+ */
+declare function analyzeAndMeasure(text: string, font: string, adapter: MeasurementAdapter, cache: Map<string, Map<string, number>>, stats?: SegmentMeasureStats, segmentAdapter?: SegmentAdapter): PreparedSegment[];
+/**
+ * Compute greedy single-column line breaks over prepared segments.
+ *
+ * @param segments - Prepared segments from `analyzeAndMeasure` or a measurement provider.
+ * @param maxWidth - Maximum line width in pixels; non-finite or negative values produce no useful
+ *   width budget.
+ * @param opts - Optional hyphen width and segment adapter for grapheme-aware slicing.
+ * @returns A `LineBreaksResult` containing ordered layout lines and the line count.
+ * @example
+ * ```ts
+ * import { analyzeAndMeasure, computeLineBreaks } from "@graphrefly/ts/solutions/reactive-layout";
+ *
+ * const segments = analyzeAndMeasure(
+ *   "Hello world",
+ *   "16px system-ui",
+ *   { measureSegment: (segment) => ({ width: segment.length * 8 }) },
+ *   new Map(),
+ * );
+ * const lineBreaks = computeLineBreaks(segments, 64);
+ * ```
+ * @remarks **Pure helper:** This does not subscribe, schedule, or emit messages; reactive bundles
+ *   call it from ordinary graph nodes.
+ * @category solutions
+ */
+declare function computeLineBreaks(segments: readonly PreparedSegment[], maxWidth: number, opts?: {
+    readonly hyphenWidth?: number;
+    readonly segmentAdapter?: SegmentAdapter;
+}): LineBreaksResult;
+/** Lay out one line from a cursor, returning the next cursor for continuation. */
+declare function layoutNextLine(segments: readonly PreparedSegment[], cursor: LayoutCursor, slotWidth: number, ctx?: LayoutNextLineContext): LayoutNextLineResult | null;
+/** Subtract obstacle intervals from a horizontal text band. */
+declare function carveTextLineSlots(base: Interval, blocked: readonly Interval[], minSlotWidth?: number): Interval[];
+/**
+ * Compute per-grapheme boxes for already-broken lines.
+ *
+ * @param lineBreaks - Line break result whose cursors identify the visible grapheme ranges.
+ * @param segments - Prepared segments used to produce the line breaks.
+ * @param lineHeight - Height assigned to every line box.
+ * @param segmentAdapter - Optional segmentation adapter; defaults to the built-in adapter.
+ * @returns Character-position boxes in visual order, each with `x`, `y`, `width`, `height`, and
+ *   zero-based line index.
+ * @example
+ * ```ts
+ * import {
+ *   analyzeAndMeasure,
+ *   computeCharPositions,
+ *   computeLineBreaks,
+ * } from "@graphrefly/ts/solutions/reactive-layout";
+ *
+ * const segments = analyzeAndMeasure(
+ *   "Hello world",
+ *   "16px system-ui",
+ *   { measureSegment: (segment) => ({ width: segment.length * 8 }) },
+ *   new Map(),
+ * );
+ * const lineBreaks = computeLineBreaks(segments, 64);
+ * const positions = computeCharPositions(lineBreaks, segments, 20);
+ * ```
+ * @remarks **Already measured:** Widths come from the prepared segments; this helper only maps the
+ *   line cursors into per-grapheme rectangles.
+ * @category solutions
+ */
+declare function computeCharPositions(lineBreaks: LineBreaksResult, segments: readonly PreparedSegment[], lineHeight: number, segmentAdapter?: SegmentAdapter): readonly CharPosition[];
+
+declare function measurementIssue(code: string, message: string, targetId: string, measurementKind: string, opts?: {
+    readonly source?: string;
+    readonly details?: unknown;
+    readonly metadata?: Record<string, unknown>;
+    readonly severity?: DataIssue["severity"];
+}): MeasurementIssue;
+declare function measurementOk<T>(targetId: string, measurementKind: string, value: T, opts?: {
+    readonly source?: string;
+    readonly metadata?: Record<string, unknown>;
+}): MeasurementResult<T>;
+declare function latestMeasurementValue<T>(measurements: Measurements, targetId: string, measurementKind: string): T | undefined;
+declare function tryMeasureHyphenWidth(adapter: MeasurementAdapter, font: string): number | undefined;
+declare function validMeasurementSize(size: Size, label: string): Size;
+declare function textMeasurementFacts(text: string, font: string, adapter: MeasurementAdapter, cache: Map<string, Map<string, number>>, segmentAdapter: SegmentAdapter, targetId: string, source: string): Measurements;
+declare function inputNode<T>(g: Graph, input: T | Node<T> | undefined, fallback: T, name: string): {
+    readonly node: Node<T>;
+    readonly set: (value: T) => void;
+};
+declare function scopedName(scope: string, local: string): string;
+/** Generic sync text measurement provider that emits graph-visible measurement facts. */
+declare function textMeasurementProvider(opts: TextMeasurementProviderOptions): Node<Measurements>;
+/** Provider helper for caller-injected synchronous text measurement. */
+declare function injectedTextMeasurements(opts: InjectedTextMeasurementsOptions): Node<Measurements>;
+/** Provider helper for deterministic precomputed text metrics. */
+declare function precomputedTextMeasurements(opts: PrecomputedTextMeasurementsOptions): Node<Measurements>;
+/** Provider helper for fixed-cell terminal/snapshot text measurement. */
+declare function cellTextMeasurements(opts: CellTextMeasurementsOptions): Node<Measurements>;
+/** Provider helper for caller-injected platform text capability nodes. */
+declare function capabilityTextMeasurements(opts: CapabilityTextMeasurementsOptions): Node<Measurements>;
+/** Provider helper that makes readiness facts an explicit measurement dependency. */
+declare function readinessTextMeasurements(opts: ReadinessTextMeasurementsOptions): Node<Measurements>;
+/** Provider helper that emits graph-visible readiness facts without measuring layout. */
+declare function readinessMeasurements(opts: ReadinessMeasurementsOptions): Node<Measurements>;
+/** Provider helper for image-size facts from caller-owned synchronous image measurers. */
+declare function imageSizeMeasurements(opts: ImageSizeMeasurementsOptions): Node<Measurements>;
+/** Provider helper for SVG bounds facts from caller-owned synchronous SVG measurers. */
+declare function svgBoundsMeasurements(opts: SvgBoundsMeasurementsOptions): Node<Measurements>;
+/** Merge provider fact nodes into the single measurements node consumed by layout bundles. */
+declare function mergeMeasurements(opts: MergeMeasurementsOptions): Node<Measurements>;
+/** Compose optional block measurement capability nodes into one graph-visible adapter node. */
+declare function blockAdaptersProvider(opts: BlockAdaptersProviderOptions): Node<BlockAdapters>;
+/** Provider helper for block measurement facts over declared block/max-width deps. */
+declare function blockMeasurementProvider(opts: BlockMeasurementProviderOptions): Node<Measurements>;
+
+export { rectIntervalForBand as A, svgBoundsMeasurements as B, CapabilityMeasureAdapter as C, textMeasurementProvider as D, blockedIntervalsForBand as E, columnGeometry as F, inputNode as G, latestMeasurementValue as H, ImageSizeAdapter as I, measurementIssue as J, measurementOk as K, sanitizeFlowColumns as L, sanitizeFlowContainer as M, sanitizeObstacles as N, scopedName as O, PrecomputedMeasureAdapter as P, textMeasurementFacts as Q, tryMeasureHyphenWidth as R, SvgBoundsAdapter as S, validMeasurementSize as T, CellMeasureAdapter as a, InjectedMeasureAdapter as b, analyzeAndMeasure as c, blockAdaptersProvider as d, blockMeasurementProvider as e, capabilityTextMeasurements as f, carveTextLineSlots as g, cellTextMeasurements as h, circleIntervalForBand as i, computeBlockFlow as j, computeCharPositions as k, computeFlowLines as l, computeLineBreaks as m, computeTotalHeight as n, imageSizeMeasurements as o, injectedTextMeasurements as p, layoutNextLine as q, measureBlock as r, measureBlocks as s, mergeMeasurements as t, precomputedTextMeasurements as u, reactiveBlockLayout as v, reactiveFlowLayout as w, reactiveLayout as x, readinessMeasurements as y, readinessTextMeasurements as z };