@graphrefly/ts 0.0.1 → 0.0.3

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

@@ -1,581 +1,37 @@
-import { DataIssue } from '../../data/index.cjs';
-import { d as Graph } from '../../graph-DCEWh4T2.cjs';
-import { N as Node } from '../../types-CcPIn7sy.cjs';
+export { C as CapabilityMeasureAdapter, a as CellMeasureAdapter, I as ImageSizeAdapter, b as InjectedMeasureAdapter, P as PrecomputedMeasureAdapter, S as SvgBoundsAdapter, c as analyzeAndMeasure, d as blockAdaptersProvider, e as blockMeasurementProvider, E as blockedIntervalsForBand, f as capabilityTextMeasurements, g as carveTextLineSlots, h as cellTextMeasurements, i as circleIntervalForBand, F as columnGeometry, j as computeBlockFlow, k as computeCharPositions, l as computeFlowLines, m as computeLineBreaks, n as computeTotalHeight, o as imageSizeMeasurements, p as injectedTextMeasurements, G as inputNode, H as latestMeasurementValue, q as layoutNextLine, r as measureBlock, s as measureBlocks, J as measurementIssue, K as measurementOk, t as mergeMeasurements, u as precomputedTextMeasurements, v as reactiveBlockLayout, w as reactiveFlowLayout, x as reactiveLayout, y as readinessMeasurements, z as readinessTextMeasurements, A as rectIntervalForBand, L as sanitizeFlowColumns, M as sanitizeFlowContainer, N as sanitizeObstacles, O as scopedName, B as svgBoundsMeasurements, Q as textMeasurementFacts, D as textMeasurementProvider, R as tryMeasureHyphenWidth, T as validMeasurementSize } from '../../measurements-B_gJfD8h.cjs';
+import { a1 as SegmentAdapter, a2 as SegmentBreakKind, a5 as Size, M as MeasureBlockOptions, z as MeasurementAdapter } from '../../types-CMnzoL54.cjs';
+export { B as BLOCKS_MEASUREMENT_KIND, a as BaseContentBlock, b as BlockAdapters, c as BlockAdaptersProviderOptions, d as BlockMeasurementProviderOptions, e as BlocksMeasurement, C as CapabilityTextMeasurementsOptions, f as CellMeasureAdapterOptions, g as CellTextMeasurementsOptions, af as CharPosition, h as CircleObstacle, i as ComputeFlowLinesOptions, j as ContentBlock, F as FlowColumns, k as FlowContainer, l as FlowLinesResult, I as IMAGE_SIZE_MEASUREMENT_KIND, m as ImageContentBlock, n as ImageMeasurer, o as ImageSizeLookup, p as ImageSizeMeasurementTarget, q as ImageSizeMeasurementsOptions, r as InjectedMeasureAdapterOptions, s as InjectedTextMeasurementsOptions, ag as Interval, L as LayoutCursor, t as LayoutLine, u as LayoutNextLineContext, v as LayoutNextLineResult, w as LineBreaksResult, x as MeasureFn, y as MeasuredBlock, A as MeasurementFact, D as MeasurementIssue, E as MeasurementReadiness, G as MeasurementResult, H as Measurements, J as MergeMeasurementsOptions, O as Obstacle, P as PositionedBlock, K as PositionedLine, N as PrecomputedMeasureAdapterOptions, Q as PrecomputedTextMeasurementsOptions, R as PreparedSegment, S as READINESS_MEASUREMENT_KIND, T as ReactiveBlockLayoutBundle, U as ReactiveBlockLayoutOptions, V as ReactiveFlowLayoutBundle, W as ReactiveFlowLayoutOptions, X as ReactiveLayoutBundle, Y as ReactiveLayoutOptions, Z as ReadinessMeasurementsOptions, _ as ReadinessTextMeasurementsOptions, $ as RectObstacle, a0 as SVG_BOUNDS_MEASUREMENT_KIND, a3 as SegmentInfo, a4 as SegmentMeasureStats, a6 as SvgBoundsMeasurementTarget, a7 as SvgBoundsMeasurementsOptions, a8 as SvgContentBlock, a9 as SvgMeasurer, aa as TEXT_SEGMENTS_MEASUREMENT_KIND, ab as TextContentBlock, ac as TextMeasureCapability, ad as TextMeasurementProviderOptions, ae as TextSegmentsMeasurement } from '../../types-CMnzoL54.cjs';
+import { C as Ctx } from '../../types-CTN3XoMl.cjs';
+import '../../data/index.cjs';
+import '../../graph-C1C-wb0L.cjs';
 import '../../core/index.cjs';
 import '../../messages-CAzUPPJM.cjs';
 import '../../codec-BB7p8fJc.cjs';
-import '../../describe-DYMw_l1C.cjs';
+import '../../describe-BumQ-3_0.cjs';
 
-/**
- * Synchronous text measurement contract for the D181 reactive-layout solution core.
- *
- * Implementations are injected by the caller; the universal subpath never imports DOM,
- * Canvas, React Native, storage, GraphSpec, or async image loading.
- */
-interface MeasurementAdapter {
-    measureSegment(text: string, font: string): {
-        readonly width: number;
-    };
-    clearCache?(): void;
-}
-/** Caller-owned platform text capability, for NodeCanvas/Skia/RN-style wrappers. */
-interface TextMeasureCapability {
-    measureText(text: string, font: string): number | {
-        readonly width: number;
-    };
-    clearCache?(): void;
-}
-/** One text segment returned by a caller-provided segmenter. */
-interface SegmentInfo {
-    readonly segment: string;
-    readonly index: number;
-    readonly isWordLike?: boolean;
-}
-/** Synchronous word/grapheme segmentation contract for hosts without Intl.Segmenter. */
-interface SegmentAdapter {
-    segmentWords(text: string): Iterable<SegmentInfo>;
-    segmentGraphemes(text: string): Iterable<SegmentInfo>;
-}
-/** Layout segment class used by the line breaker. */
-type SegmentBreakKind = "text" | "space" | "zero-width-break" | "soft-hyphen" | "hard-break";
-/** Measured text run consumed by pure line/block/flow helpers. */
-interface PreparedSegment {
-    readonly text: string;
-    readonly width: number;
-    readonly kind: SegmentBreakKind;
-    readonly graphemeWidths: readonly number[] | null;
-}
-/** One laid-out line with segment/grapheme cursor bounds. */
-interface LayoutLine {
-    readonly text: string;
-    readonly width: number;
-    readonly startSegment: number;
-    readonly startGrapheme: number;
-    readonly endSegment: number;
-    readonly endGrapheme: number;
-}
-/** Positioned grapheme box for hit testing or custom renderers. */
-interface CharPosition {
-    readonly x: number;
-    readonly y: number;
-    readonly width: number;
-    readonly height: number;
-    readonly line: number;
-}
-/** Result emitted by `reactiveLayout().lineBreaks`. */
-interface LineBreaksResult {
-    readonly lines: readonly LayoutLine[];
-    readonly lineCount: number;
-}
-/** Cursor into a prepared segment array. */
-interface LayoutCursor {
-    readonly segmentIndex: number;
-    readonly graphemeIndex: number;
-}
-/** Pure helper result for one `layoutNextLine` step. */
-interface LayoutNextLineResult {
-    readonly text: string;
-    readonly width: number;
-    readonly start: LayoutCursor;
-    readonly end: LayoutCursor;
-}
-/** Horizontal interval used by obstacle carving. */
-interface Interval {
-    readonly left: number;
-    readonly right: number;
-}
-declare const TEXT_SEGMENTS_MEASUREMENT_KIND = "text-segments";
-declare const BLOCKS_MEASUREMENT_KIND = "blocks";
-/** Measurement kind for standalone readiness facts. */
-declare const READINESS_MEASUREMENT_KIND = "readiness";
-/** Measurement kind for standalone image-size facts. */
-declare const IMAGE_SIZE_MEASUREMENT_KIND = "image-size";
-/** Measurement kind for standalone SVG-bounds facts. */
-declare const SVG_BOUNDS_MEASUREMENT_KIND = "svg-bounds";
-interface TextSegmentsMeasurement {
-    readonly segments: readonly PreparedSegment[];
-    readonly hyphenWidth?: number;
-}
-interface BlocksMeasurement {
-    readonly blocks: readonly MeasuredBlock[];
-}
-interface MeasurementResult<T = unknown> {
-    readonly kind: "ok";
-    readonly targetId: string;
-    readonly measurementKind: string;
-    readonly value: T;
-    readonly source?: string;
-    readonly metadata?: Record<string, unknown>;
-}
-interface MeasurementIssue extends DataIssue {
-    readonly subjectId: string;
-    readonly measurementKind: string;
-}
-type MeasurementFact<T = unknown> = MeasurementResult<T> | MeasurementIssue;
-type Measurements = readonly MeasurementFact[];
-interface MergeMeasurementsOptions {
-    readonly graph: Graph;
-    readonly sources: readonly Node<Measurements>[];
-    readonly name?: string;
-}
-interface TextMeasurementProviderOptions {
-    readonly graph: Graph;
-    readonly text: Node<string>;
-    readonly font: Node<string>;
-    readonly adapter: Node<MeasurementAdapter>;
-    readonly segmentAdapter?: Node<SegmentAdapter>;
-    readonly targetId?: string;
-    readonly source?: string;
-    readonly name?: string;
-}
-interface InjectedTextMeasurementsOptions extends Omit<TextMeasurementProviderOptions, "adapter"> {
-    readonly measure: MeasureFn;
-    readonly cache?: boolean;
-}
-interface PrecomputedTextMeasurementsOptions extends Omit<TextMeasurementProviderOptions, "adapter">, PrecomputedMeasureAdapterOptions {
-}
-interface CellTextMeasurementsOptions extends Omit<TextMeasurementProviderOptions, "adapter">, CellMeasureAdapterOptions {
-}
-interface CapabilityTextMeasurementsOptions extends Omit<TextMeasurementProviderOptions, "adapter"> {
-    readonly capability: Node<TextMeasureCapability>;
-}
-interface MeasurementReadiness {
-    readonly ready: boolean;
-    readonly code?: string;
-    readonly message?: string;
-    readonly source?: string;
-    readonly details?: unknown;
-    readonly metadata?: Record<string, unknown>;
-}
-/** Options for projecting readiness into graph-visible measurement facts. */
-interface ReadinessMeasurementsOptions {
-    readonly graph: Graph;
-    readonly readiness: Node<MeasurementReadiness>;
-    readonly targetId?: string;
-    readonly measurementKind?: string;
-    readonly source?: string;
-    readonly name?: string;
-}
-interface ReadinessTextMeasurementsOptions extends TextMeasurementProviderOptions {
-    readonly readiness: Node<MeasurementReadiness>;
-}
-/** Minimal caller-owned lookup for explicit image sizes. */
-interface ImageSizeLookup {
-    get(src: string): Size | undefined;
-}
-/** One image-size fact target for `imageSizeMeasurements`. */
-interface ImageSizeMeasurementTarget {
-    readonly id?: string;
-    readonly src: string;
-    readonly metadata?: Record<string, unknown>;
-}
-/** Options for projecting image-size facts from a caller-owned synchronous measurer. */
-interface ImageSizeMeasurementsOptions {
-    readonly graph: Graph;
-    readonly images: Node<readonly ImageSizeMeasurementTarget[]>;
-    readonly measurer: Node<ImageMeasurer>;
-    readonly measurementKind?: string;
-    readonly source?: string;
-    readonly name?: string;
-}
-/** One SVG-bounds fact target for `svgBoundsMeasurements`. */
-interface SvgBoundsMeasurementTarget {
-    readonly id?: string;
-    readonly svg: string;
-    readonly metadata?: Record<string, unknown>;
-}
-/** Options for projecting SVG bounds from a caller-owned synchronous measurer. */
-interface SvgBoundsMeasurementsOptions {
-    readonly graph: Graph;
-    readonly svgs: Node<readonly SvgBoundsMeasurementTarget[]>;
-    readonly measurer: Node<SvgMeasurer>;
-    readonly measurementKind?: string;
-    readonly source?: string;
-    readonly name?: string;
-}
-interface BlockMeasurementProviderOptions {
-    readonly graph: Graph;
-    readonly blocks: Node<readonly ContentBlock[]>;
-    readonly maxWidth: Node<number>;
-    readonly adapters: Node<BlockAdapters>;
-    readonly segmentAdapter?: Node<SegmentAdapter>;
-    readonly font?: Node<string>;
-    readonly lineHeight?: Node<number>;
-    readonly targetId?: string;
-    readonly source?: string;
-    readonly name?: string;
-}
-interface BlockAdaptersProviderOptions {
-    readonly graph: Graph;
-    readonly text?: Node<MeasurementAdapter>;
-    readonly svg?: Node<SvgMeasurer>;
-    readonly image?: Node<ImageMeasurer>;
-    readonly name?: string;
-}
-/**
- * Graph-visible bundle returned by `reactiveLayout`.
- *
- * The setters are state-node sugar over real graph inputs; the output nodes are ordinary
- * inspectable nodes visible through `graph.describe()`.
- */
-interface ReactiveLayoutBundle {
-    readonly graph: Graph;
-    readonly input: {
-        readonly lineHeight: Node<number>;
-        readonly maxWidth: Node<number>;
-        readonly measurements: Node<Measurements>;
-    };
-    setLineHeight(lineHeight: number): void;
-    setMaxWidth(maxWidth: number): void;
-    readonly segments: Node<readonly PreparedSegment[]>;
-    readonly lineBreaks: Node<LineBreaksResult>;
-    readonly height: Node<number>;
-    readonly charPositions: Node<readonly CharPosition[]>;
-}
-/** Optional context shared by pure line-breaking helpers. */
-interface LayoutNextLineContext {
-    readonly adapter?: MeasurementAdapter;
-    readonly font?: string;
-    readonly cache?: Map<string, Map<string, number>>;
-    readonly hyphenWidth?: number;
-    readonly segmentAdapter?: SegmentAdapter;
-}
-/** Cache accounting object callers can pass into `analyzeAndMeasure`. */
-interface SegmentMeasureStats {
-    hits: number;
-    misses: number;
-}
-/** Options for the single-column reactive text layout bundle. */
-interface ReactiveLayoutOptions {
-    readonly measurements: Node<Measurements>;
-    readonly graph: Graph;
-    readonly segmentAdapter?: SegmentAdapter;
-    readonly targetId?: string;
-    readonly name?: string;
-    readonly lineHeight?: number | Node<number>;
-    readonly maxWidth?: number | Node<number>;
-}
-/** Host text measurement function accepted by `InjectedMeasureAdapter`. */
-type MeasureFn = (text: string, font: string) => number | {
-    readonly width: number;
-};
-/** Options for caller-injected synchronous measurement. */
-interface InjectedMeasureAdapterOptions {
-    readonly cache?: boolean;
-}
-/** Options for deterministic precomputed text metrics. */
-interface PrecomputedMeasureAdapterOptions {
-    readonly metrics: ReadonlyMap<string, number> | Record<string, number>;
-    readonly fallback?: "per-char" | "error";
-    readonly cellWidth?: number;
-}
-/** Fixed-cell measurement options for terminal/snapshot rendering. */
-interface CellMeasureAdapterOptions {
-    readonly cellWidth?: number;
-    readonly wideCellWidth?: number;
-    readonly tabCells?: number;
-}
-/** Width/height pair in CSS-like pixels. */
-interface Size {
-    readonly width: number;
-    readonly height: number;
-}
-/** Synchronous SVG measurement seam; no DOM parser is provided by the core. */
-interface SvgMeasurer {
-    measureSvg(svg: string): Size;
-}
-/** Synchronous image measurement seam; no loading/fetching is provided by the core. */
-interface ImageMeasurer {
-    measureImage(src: string): Size;
-}
-/** Optional per-kind block measurement adapters. */
-interface BlockAdapters {
-    readonly text?: MeasurementAdapter;
-    readonly svg?: SvgMeasurer;
-    readonly image?: ImageMeasurer;
-}
-/** Shared spacing/id fields for block layout inputs. */
-interface BaseContentBlock {
-    readonly id?: string;
-    readonly marginTop?: number;
-    readonly marginBottom?: number;
-}
-/** Text block input for `measureBlock` and `reactiveBlockLayout`. */
-interface TextContentBlock extends BaseContentBlock {
-    readonly kind: "text";
-    readonly text: string;
-    readonly font?: string;
-    readonly lineHeight?: number;
-    readonly maxWidth?: number;
-}
-/** Image block input with explicit dimensions or an injected `ImageMeasurer`. */
-interface ImageContentBlock extends BaseContentBlock {
-    readonly kind: "image";
-    readonly src: string;
-    readonly width?: number;
-    readonly height?: number;
-    readonly maxWidth?: number;
-}
-/** SVG block input with explicit dimensions or an injected `SvgMeasurer`. */
-interface SvgContentBlock extends BaseContentBlock {
-    readonly kind: "svg";
-    readonly svg: string;
-    readonly width?: number;
-    readonly height?: number;
-    readonly maxWidth?: number;
-}
-/** Heterogeneous block-layout input. */
-type ContentBlock = TextContentBlock | ImageContentBlock | SvgContentBlock;
-/** Measured block produced by `measureBlock` or `measureBlocks`. */
-interface MeasuredBlock {
-    readonly block: ContentBlock;
-    readonly kind: ContentBlock["kind"];
-    readonly id?: string;
-    readonly width: number;
-    readonly height: number;
-    readonly marginTop: number;
-    readonly marginBottom: number;
-    readonly segments?: readonly PreparedSegment[];
-    readonly lineBreaks?: LineBreaksResult;
-    readonly charPositions?: readonly CharPosition[];
-}
-/** Block with vertical-flow coordinates. */
-interface PositionedBlock extends MeasuredBlock {
-    readonly x: number;
-    readonly y: number;
-}
-/** Options for pure block measurement helpers. */
-interface MeasureBlockOptions {
-    readonly adapter?: MeasurementAdapter;
-    readonly adapters?: BlockAdapters;
-    readonly font?: string;
-    readonly lineHeight?: number;
-    readonly maxWidth?: number;
-    readonly cache?: Map<string, Map<string, number>>;
-    readonly hyphenWidth?: number;
-    readonly segmentAdapter?: SegmentAdapter;
-}
-/** Options for the graph-visible block layout bundle. */
-interface ReactiveBlockLayoutOptions {
-    readonly measurements: Node<Measurements>;
-    readonly graph: Graph;
-    readonly targetId?: string;
-    readonly name?: string;
-    readonly gap?: number | Node<number>;
-}
-/** Graph-visible vertical block layout bundle. */
-interface ReactiveBlockLayoutBundle {
-    readonly graph: Graph;
-    readonly input: {
-        readonly gap: Node<number>;
-        readonly measurements: Node<Measurements>;
-    };
-    setGap(gap: number): void;
-    readonly measuredBlocks: Node<readonly MeasuredBlock[]>;
-    readonly blockFlow: Node<readonly PositionedBlock[]>;
-    readonly totalHeight: Node<number>;
-}
-/** Circular obstacle for flow layout slot carving. */
-interface CircleObstacle {
-    readonly kind: "circle";
-    readonly cx: number;
-    readonly cy: number;
-    readonly r: number;
-}
-/** Rectangular obstacle for flow layout slot carving. */
-interface RectObstacle {
-    readonly kind: "rect";
-    readonly x: number;
-    readonly y: number;
-    readonly width: number;
-    readonly height: number;
-}
-/** Obstacle shape accepted by flow layout. */
-type Obstacle = CircleObstacle | RectObstacle;
-/** Flow container geometry. */
-interface FlowContainer {
-    readonly width: number;
-    readonly height: number;
-    readonly paddingX?: number;
-    readonly paddingY?: number;
-}
-/** Optional column geometry for flow layout. */
-interface FlowColumns {
-    readonly count?: number;
-    readonly gap?: number;
-}
-/** Positioned line emitted by `computeFlowLines` / `reactiveFlowLayout`. */
-interface PositionedLine extends LayoutLine {
-    readonly x: number;
-    readonly y: number;
-    readonly slotWidth: number;
-    readonly columnIndex: number;
-}
-/** Flow layout result plus the continuation cursor. */
-interface FlowLinesResult {
-    readonly lines: readonly PositionedLine[];
-    readonly cursor: LayoutCursor;
-    readonly done: boolean;
-}
-/** Options for pure flow layout computation. */
-interface ComputeFlowLinesOptions {
-    readonly container: FlowContainer;
-    readonly columns?: FlowColumns;
-    readonly obstacles?: readonly Obstacle[];
-    readonly lineHeight: number;
-    readonly minSlotWidth?: number;
-    readonly hyphenWidth?: number;
-    readonly segmentAdapter?: SegmentAdapter;
-}
-/** Options for the graph-visible flow layout bundle. */
-interface ReactiveFlowLayoutOptions {
-    readonly measurements: Node<Measurements>;
-    readonly graph: Graph;
-    readonly segmentAdapter?: SegmentAdapter;
-    readonly targetId?: string;
-    readonly name?: string;
-    readonly lineHeight?: number | Node<number>;
-    readonly container?: FlowContainer | Node<FlowContainer>;
-    readonly columns?: FlowColumns | Node<FlowColumns>;
-    readonly obstacles?: readonly Obstacle[] | Node<readonly Obstacle[]>;
-    readonly minSlotWidth?: number;
-}
-/** Graph-visible multi-column flow layout bundle. */
-interface ReactiveFlowLayoutBundle {
-    readonly graph: Graph;
-    readonly input: {
-        readonly lineHeight: Node<number>;
-        readonly container: Node<FlowContainer>;
-        readonly columns: Node<FlowColumns>;
-        readonly obstacles: Node<readonly Obstacle[]>;
-        readonly measurements: Node<Measurements>;
-    };
-    setLineHeight(lineHeight: number): void;
-    setContainer(container: FlowContainer): void;
-    setColumns(columns: FlowColumns): void;
-    setObstacles(obstacles: readonly Obstacle[]): void;
-    readonly segments: Node<readonly PreparedSegment[]>;
-    readonly flowLines: Node<FlowLinesResult>;
-}
-/** 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;
-}
-/** 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>;
-/** Segment text and measure every resulting segment with a caller-owned synchronous adapter. */
-declare function analyzeAndMeasure(text: string, font: string, adapter: MeasurementAdapter, cache: Map<string, Map<string, number>>, stats?: SegmentMeasureStats, segmentAdapter?: SegmentAdapter): PreparedSegment[];
-/** Greedy single-column line breaking over prepared segments. */
-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. */
-declare function computeCharPositions(lineBreaks: LineBreaksResult, segments: readonly PreparedSegment[], lineHeight: number, segmentAdapter?: SegmentAdapter): readonly CharPosition[];
-/** 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;
-/** 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;
-/** Flow prepared text through columns and carved obstacle slots. */
-declare function computeFlowLines(segments: readonly PreparedSegment[], opts: ComputeFlowLinesOptions): FlowLinesResult;
-/**
- * Create a graph-visible single-column text layout bundle.
- *
- * D181: this adds ordinary state/output nodes only; it does not add protocol behavior,
- * hidden subscriptions, GraphSpec ownership, storage, or platform globals.
- */
-declare function reactiveLayout(opts: ReactiveLayoutOptions): ReactiveLayoutBundle;
-/**
- * Create a graph-visible vertical block layout bundle over the same DOM-free core.
- *
- * Image/SVG sizing is explicit or injected; no async image loading or DOM SVG parsing occurs.
- */
-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 const kinsokuStart: Set<string>;
+declare const leftStickyPunctuation: Set<string>;
+declare function isCJK(text: string): boolean;
+declare function normalizeWhitespace(text: string): string;
+declare function segmentText(text: string, segmentAdapter: SegmentAdapter): {
+    readonly texts: string[];
+    readonly isWordLike: boolean[];
+    readonly kinds: SegmentBreakKind[];
+}[];
+declare function createDefaultSegmentAdapter(): SegmentAdapter;
+declare function getDefaultSegmentAdapter(): SegmentAdapter;
+declare function measuredWidth(value: number | {
+    readonly width: number;
+}): number;
+declare function metricKey(text: string, font: string): string;
+
+declare function nonNegativeFinite(value: number, fallback: number): number;
+declare function finiteNumber(value: number, fallback: number): number;
+declare function emitLayoutError(ctx: Ctx, error: unknown, fallback: string): void;
+declare function positiveFinite(value: number, fallback: number): number;
+declare function clampDimension(value: number | undefined): number;
+declare function fitSize(size: Size, maxWidth: number): Size;
+declare function blockMaxWidth(blockMaxWidth: number | undefined, maxWidth: number): number;
+declare function resolveTextAdapter(opts: MeasureBlockOptions): MeasurementAdapter;
 
-export { BLOCKS_MEASUREMENT_KIND, type BaseContentBlock, type BlockAdapters, type BlockAdaptersProviderOptions, type BlockMeasurementProviderOptions, type BlocksMeasurement, CapabilityMeasureAdapter, type CapabilityTextMeasurementsOptions, CellMeasureAdapter, type CellMeasureAdapterOptions, type CellTextMeasurementsOptions, type CharPosition, type CircleObstacle, type ComputeFlowLinesOptions, type ContentBlock, type FlowColumns, type FlowContainer, type FlowLinesResult, IMAGE_SIZE_MEASUREMENT_KIND, type ImageContentBlock, type ImageMeasurer, ImageSizeAdapter, type ImageSizeLookup, type ImageSizeMeasurementTarget, type ImageSizeMeasurementsOptions, InjectedMeasureAdapter, type InjectedMeasureAdapterOptions, type InjectedTextMeasurementsOptions, type Interval, type LayoutCursor, type LayoutLine, type LayoutNextLineContext, type LayoutNextLineResult, type LineBreaksResult, type MeasureBlockOptions, type MeasureFn, type MeasuredBlock, type MeasurementAdapter, type MeasurementFact, type MeasurementIssue, type MeasurementReadiness, type MeasurementResult, type Measurements, type MergeMeasurementsOptions, type Obstacle, type PositionedBlock, type PositionedLine, PrecomputedMeasureAdapter, type PrecomputedMeasureAdapterOptions, type PrecomputedTextMeasurementsOptions, type PreparedSegment, READINESS_MEASUREMENT_KIND, type ReactiveBlockLayoutBundle, type ReactiveBlockLayoutOptions, type ReactiveFlowLayoutBundle, type ReactiveFlowLayoutOptions, type ReactiveLayoutBundle, type ReactiveLayoutOptions, type ReadinessMeasurementsOptions, type ReadinessTextMeasurementsOptions, type RectObstacle, SVG_BOUNDS_MEASUREMENT_KIND, type SegmentAdapter, type SegmentBreakKind, type SegmentInfo, type SegmentMeasureStats, type Size, SvgBoundsAdapter, type SvgBoundsMeasurementTarget, type SvgBoundsMeasurementsOptions, type SvgContentBlock, type SvgMeasurer, TEXT_SEGMENTS_MEASUREMENT_KIND, type TextContentBlock, type TextMeasureCapability, type TextMeasurementProviderOptions, type TextSegmentsMeasurement, analyzeAndMeasure, blockAdaptersProvider, blockMeasurementProvider, capabilityTextMeasurements, carveTextLineSlots, cellTextMeasurements, circleIntervalForBand, computeBlockFlow, computeCharPositions, computeFlowLines, computeLineBreaks, computeTotalHeight, imageSizeMeasurements, injectedTextMeasurements, layoutNextLine, measureBlock, measureBlocks, mergeMeasurements, precomputedTextMeasurements, reactiveBlockLayout, reactiveFlowLayout, reactiveLayout, readinessMeasurements, readinessTextMeasurements, rectIntervalForBand, svgBoundsMeasurements, textMeasurementProvider };
+export { MeasureBlockOptions, MeasurementAdapter, SegmentAdapter, SegmentBreakKind, Size, blockMaxWidth, clampDimension, createDefaultSegmentAdapter, emitLayoutError, finiteNumber, fitSize, getDefaultSegmentAdapter, isCJK, kinsokuStart, leftStickyPunctuation, measuredWidth, metricKey, nonNegativeFinite, normalizeWhitespace, positiveFinite, resolveTextAdapter, segmentText };