@graphrefly/graphrefly 0.47.1 → 0.48.0

package/dist/presets/resilience/index.d.cts

@@ -3,7 +3,7 @@ import { Graph, GraphOptions } from '@graphrefly/pure-ts/graph';
 import { N as NodeOrValue } from '../../_internal-B23BagFd.cjs';
 import { c as RetryState, b as RetryOptions } from '../../retry-DWuhjvsA.cjs';
 import { S as StatusValue } from '../../status-U-rUI79b.cjs';
-import { k as TimeoutState, h as RateLimiterState, e as RateLimiterOptions, B as BudgetConstraint, F as FallbackInput } from '../../rate-limiter-DpVbSYdH.cjs';
+import { k as TimeoutState, h as RateLimiterState, e as RateLimiterOptions, B as BudgetConstraint, F as FallbackInput } from '../../rate-limiter-DC26FM8J.cjs';
 import { B as BreakerState, a as CircuitBreakerOptions } from '../../breaker-ugSdq54q.cjs';
 import '../../backoff-Bnb9OoPh.cjs';
 
@@ -65,13 +65,17 @@ interface ResilientPipelineOptions<T> {
      * Admission control — at most `maxEvents` `DATA` per `windowNs`. See
      * {@link rateLimiter}.
      *
-     * `maxBuffer` is optional at the pipeline layer (defaults to `Infinity`,
-     * preserving the historical unbounded behavior). Pass an explicit positive
-     * integer to opt in to a bounded queue.
+     * **`maxBuffer` is required in BOTH the value form and the Node form** —
+     * forwarded directly to {@link rateLimiter}, which is fail-loud (D4): an
+     * un-seeded opts Node, or a value/cached value omitting `maxBuffer`, throws
+     * `RangeError` at construction. Pass a finite positive integer for a bounded
+     * queue, or the literal `Infinity` to explicitly opt in to unbounded (the
+     * silent bounded/unbounded lock is the most common rateLimiter
+     * mis-configuration). There is **no value-vs-Node asymmetry and no legacy
+     * `?? Infinity` convenience injection** — both forms match the primitive's
+     * fail-loud contract (F-B-root, 2026-05-18 smell sweep).
      */
-    rateLimit?: NodeOrValue<Omit<RateLimiterOptions, "maxBuffer"> & {
-        maxBuffer?: number;
-    }>;
+    rateLimit?: NodeOrValue<RateLimiterOptions>;
     /** Cost/constraint gate. See {@link budgetGate}. */
     budget?: NodeOrValue<ReadonlyArray<BudgetConstraint>>;
     /** Circuit breaker — fail-fast when the downstream resource is unhealthy. See {@link circuitBreaker}. */
@@ -187,7 +191,7 @@ declare class ResilientPipelineGraph<T> extends Graph {
  * @example
  * ```ts
  * const safeFetch = resilientPipeline(fetchNode, {
- *   rateLimit: { maxEvents: 10, windowNs: NS_PER_SEC },
+ *   rateLimit: { maxEvents: 10, windowNs: NS_PER_SEC, maxBuffer: 100 },
  *   breaker: { failureThreshold: 5 },
  *   retry: { count: 3, backoff: "exponential" },
  *   timeoutMs: 10_000,

package/dist/presets/resilience/index.d.ts

@@ -3,7 +3,7 @@ import { Graph, GraphOptions } from '@graphrefly/pure-ts/graph';
 import { N as NodeOrValue } from '../../_internal-B23BagFd.js';
 import { c as RetryState, b as RetryOptions } from '../../retry-BDbRZ_gx.js';
 import { S as StatusValue } from '../../status-U-rUI79b.js';
-import { k as TimeoutState, h as RateLimiterState, e as RateLimiterOptions, B as BudgetConstraint, F as FallbackInput } from '../../rate-limiter-CEALq4N1.js';
+import { k as TimeoutState, h as RateLimiterState, e as RateLimiterOptions, B as BudgetConstraint, F as FallbackInput } from '../../rate-limiter-DyWpwpQP.js';
 import { B as BreakerState, a as CircuitBreakerOptions } from '../../breaker-C9skL3d8.js';
 import '../../backoff-Bnb9OoPh.js';
 
@@ -65,13 +65,17 @@ interface ResilientPipelineOptions<T> {
      * Admission control — at most `maxEvents` `DATA` per `windowNs`. See
      * {@link rateLimiter}.
      *
-     * `maxBuffer` is optional at the pipeline layer (defaults to `Infinity`,
-     * preserving the historical unbounded behavior). Pass an explicit positive
-     * integer to opt in to a bounded queue.
+     * **`maxBuffer` is required in BOTH the value form and the Node form** —
+     * forwarded directly to {@link rateLimiter}, which is fail-loud (D4): an
+     * un-seeded opts Node, or a value/cached value omitting `maxBuffer`, throws
+     * `RangeError` at construction. Pass a finite positive integer for a bounded
+     * queue, or the literal `Infinity` to explicitly opt in to unbounded (the
+     * silent bounded/unbounded lock is the most common rateLimiter
+     * mis-configuration). There is **no value-vs-Node asymmetry and no legacy
+     * `?? Infinity` convenience injection** — both forms match the primitive's
+     * fail-loud contract (F-B-root, 2026-05-18 smell sweep).
      */
-    rateLimit?: NodeOrValue<Omit<RateLimiterOptions, "maxBuffer"> & {
-        maxBuffer?: number;
-    }>;
+    rateLimit?: NodeOrValue<RateLimiterOptions>;
     /** Cost/constraint gate. See {@link budgetGate}. */
     budget?: NodeOrValue<ReadonlyArray<BudgetConstraint>>;
     /** Circuit breaker — fail-fast when the downstream resource is unhealthy. See {@link circuitBreaker}. */
@@ -187,7 +191,7 @@ declare class ResilientPipelineGraph<T> extends Graph {
  * @example
  * ```ts
  * const safeFetch = resilientPipeline(fetchNode, {
- *   rateLimit: { maxEvents: 10, windowNs: NS_PER_SEC },
+ *   rateLimit: { maxEvents: 10, windowNs: NS_PER_SEC, maxBuffer: 100 },
  *   breaker: { failureThreshold: 5 },
  *   retry: { count: 3, backoff: "exponential" },
  *   timeoutMs: 10_000,

package/dist/presets/resilience/index.js

@@ -2,14 +2,14 @@ import "../../chunk-KRNQ6RGQ.js";
 import {
   ResilientPipelineGraph,
   resilientPipeline
-} from "../../chunk-6XZYT4SW.js";
-import "../../chunk-RJOG4IJU.js";
-import "../../chunk-RAGGHLCV.js";
-import "../../chunk-FMPF42Q4.js";
-import "../../chunk-Y52CS6YA.js";
-import "../../chunk-Z4YXAUDN.js";
+} from "../../chunk-X6ESZDR6.js";
+import "../../chunk-T5URUIIY.js";
+import "../../chunk-GUNIRPEJ.js";
+import "../../chunk-JA67ZQG2.js";
+import "../../chunk-KUFXLAEY.js";
 import "../../chunk-TSBFTJKM.js";
 import "../../chunk-P5LBT622.js";
+import "../../chunk-FMPF42Q4.js";
 import "../../chunk-AZDQPQ3V.js";
 export {
   ResilientPipelineGraph,

package/dist/{rate-limiter-DpVbSYdH.d.cts → rate-limiter-DC26FM8J.d.cts}

@@ -532,9 +532,18 @@ type RateLimiterBundle<T> = {
  * @param opts - Rate + bounded-buffer configuration. `maxBuffer` is required (use `Infinity` to opt in to unbounded).
  * @returns `{ node, droppedCount }` bundle. Subscribe to `node` for the throttled stream and to `droppedCount` for backpressure pressure.
  *
- * @throws {RangeError} when `maxEvents` / `windowNs` is non-positive, when `maxBuffer` is omitted, or when `maxBuffer` is a finite value < 1.
+ * @throws {RangeError} when `maxEvents` / `windowNs` is non-positive, when
+ * `maxBuffer` is omitted, when `maxBuffer` is a finite value < 1, or when
+ * `opts` is a Node (reactive form) with **no cached value at construction**
+ * (D4 — the mode + initial cap are locked from `.cache` at construction;
+ * seed the opts Node with `initial`).
  *
  * @remarks
+ * **Reactive opts (Node form) must be seeded.** Mode (bounded vs unbounded)
+ * and the initial cap are read from `opts.cache` at construction and the swap
+ * handler rejects mode toggles. An un-seeded opts Node therefore throws at
+ * construction rather than silently locking bounded `maxBuffer: 1` (D4).
+ *
  * **Terminal:** `COMPLETE` / `ERROR` cancel the refill timer, drop the pending queue,
  * reset `droppedCount` to `0`, and propagate.
  *

package/dist/{rate-limiter-CEALq4N1.d.ts → rate-limiter-DyWpwpQP.d.ts}

@@ -532,9 +532,18 @@ type RateLimiterBundle<T> = {
  * @param opts - Rate + bounded-buffer configuration. `maxBuffer` is required (use `Infinity` to opt in to unbounded).
  * @returns `{ node, droppedCount }` bundle. Subscribe to `node` for the throttled stream and to `droppedCount` for backpressure pressure.
  *
- * @throws {RangeError} when `maxEvents` / `windowNs` is non-positive, when `maxBuffer` is omitted, or when `maxBuffer` is a finite value < 1.
+ * @throws {RangeError} when `maxEvents` / `windowNs` is non-positive, when
+ * `maxBuffer` is omitted, when `maxBuffer` is a finite value < 1, or when
+ * `opts` is a Node (reactive form) with **no cached value at construction**
+ * (D4 — the mode + initial cap are locked from `.cache` at construction;
+ * seed the opts Node with `initial`).
  *
  * @remarks
+ * **Reactive opts (Node form) must be seeded.** Mode (bounded vs unbounded)
+ * and the initial cap are read from `opts.cache` at construction and the swap
+ * handler rejects mode toggles. An un-seeded opts Node therefore throws at
+ * construction rather than silently locking bounded `maxBuffer: 1` (D4).
+ *
  * **Terminal:** `COMPLETE` / `ERROR` cancel the refill timer, drop the pending queue,
  * reset `droppedCount` to `0`, and propagate.
  *

package/dist/{reactive-layout-fswlBUvX.d.ts → reactive-layout-BBBWH0V_.d.cts}

@@ -21,6 +21,73 @@ interface MeasurementAdapter {
     /** Optional; adapters may omit for read-only / stateless measurement. */
     clearCache?(): void;
 }
+/**
+ * A single segmented piece — the structurally-narrowed common shape across
+ * `Intl.Segmenter`'s `Intl.SegmentData` and host-provided polyfills.
+ *
+ * Drops `input` (redundant — the caller already has the text) and narrows
+ * `isWordLike` to "may be missing" so grapheme-granularity callers ignore it
+ * cleanly.
+ */
+type SegmentInfo = {
+    /** The segmented substring. */
+    segment: string;
+    /** Code-unit offset of `segment` within the input. */
+    index: number;
+    /** True if the word-granularity segment looks like a word (letters / kana / etc.). Always undefined for grapheme granularity. */
+    isWordLike?: boolean;
+};
+/**
+ * Pluggable text-segmentation backend (separate from {@link MeasurementAdapter}
+ * because measurement and segmentation are different host concerns —
+ * Skia/Canvas measure widths, ICU segments graphemes/words).
+ *
+ * **Why this exists (DS-2026-05-20 — `optimizations.md` 🟠 (d)).**
+ * `reactive-layout`'s default backend uses `new Intl.Segmenter(...)` for word /
+ * grapheme iteration. Hermes (iOS 26.5 / RN 0.83) ships **without**
+ * `Intl.Segmenter` — `typeof Intl.Segmenter === "undefined"` — and the
+ * constructor throws `Cannot read property 'prototype' of undefined`. This
+ * interface lets RN/Hermes consumers inject their own segmenter (typically a
+ * polyfill wrapper) so the substrate never touches the missing global.
+ *
+ * **Contract:** sync, pure, idempotent. `segmentWords` must mirror
+ * `Intl.Segmenter(undefined, { granularity: "word" }).segment(text)`'s shape
+ * (an iterable of `{ segment, index, isWordLike }`); `segmentGraphemes`
+ * mirrors `{ granularity: "grapheme" }`. The reference implementation is
+ * {@link IntlSegmentAdapter}.
+ *
+ * **Polyfill recipe (RN/Hermes consumer userland — NOT shipped here per the
+ * `bigintJsonCodecFor` userland-binding precedent):**
+ *
+ * ```ts
+ * // Userland — at app entry, before any reactive-layout import:
+ * import "intl-segmenter-polyfill/dist/polyfill"; // or @formatjs/intl-segmenter
+ * // Then the substrate's default IntlSegmentAdapter works:
+ * import { reactiveLayout } from "@graphrefly/graphrefly/utils/reactive-layout";
+ * ```
+ *
+ * Or, without polyfilling the global (preferred — keeps ICU bytes scoped):
+ *
+ * ```ts
+ * // Userland — wrap any segmenter implementation:
+ * import { createIntlSegmenterPolyfill } from "intl-segmenter-polyfill";
+ * import type { SegmentAdapter, SegmentInfo } from "@graphrefly/graphrefly/utils/reactive-layout";
+ *
+ * const wordSeg = await createIntlSegmenterPolyfill({ granularity: "word" });
+ * const graphemeSeg = await createIntlSegmenterPolyfill({ granularity: "grapheme" });
+ * const segmentAdapter: SegmentAdapter = {
+ *   segmentWords: (text) => wordSeg.segment(text) as Iterable<SegmentInfo>,
+ *   segmentGraphemes: (text) => graphemeSeg.segment(text) as Iterable<SegmentInfo>,
+ * };
+ * reactiveLayout({ adapter, segmentAdapter, ... });
+ * ```
+ */
+interface SegmentAdapter {
+    /** Word-granularity segmentation — yields `{ segment, index, isWordLike }`. */
+    segmentWords(text: string): Iterable<SegmentInfo>;
+    /** Grapheme-granularity segmentation — yields `{ segment, index }`. `isWordLike` is unused / undefined. */
+    segmentGraphemes(text: string): Iterable<SegmentInfo>;
+}
 /** Mutable counters for `analyzeAndMeasure` cache hit ratio (hits / (hits + misses)). */
 type SegmentMeasureStats = {
     hits: number;
@@ -86,6 +153,13 @@ type LayoutNextLineContext = {
     adapter?: MeasurementAdapter;
     font?: string;
     cache?: Map<string, Map<string, number>>;
+    /**
+     * Optional {@link SegmentAdapter} for grapheme slicing during partial-segment
+     * line builds. Defaults to {@link IntlSegmentAdapter} (lazy module shared);
+     * Hermes / RN consumers wire their own to avoid the missing-`Intl.Segmenter`
+     * runtime throw — see {@link SegmentAdapter} JSDoc.
+     */
+    segmentAdapter?: SegmentAdapter;
 };
 /** Result of the reactive layout graph's describe-accessible state. */
 type ReactiveLayoutBundle = {
@@ -111,7 +185,7 @@ type ReactiveLayoutBundle = {
  * 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[];
+declare function analyzeAndMeasure(text: string, font: string, adapter: MeasurementAdapter, cache: Map<string, Map<string, number>>, stats?: SegmentMeasureStats, segmentAdapter?: SegmentAdapter): PreparedSegment[];
 /**
  * Greedy line-breaking algorithm.
  *
@@ -122,7 +196,7 @@ declare function analyzeAndMeasure(text: string, font: string, adapter: Measurem
  * - 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;
+declare function computeLineBreaks(segments: PreparedSegment[], maxWidth: number, adapter: MeasurementAdapter, font: string, cache: Map<string, Map<string, number>>, segmentAdapter?: SegmentAdapter): LineBreaksResult;
 /**
  * Lay out the next single line starting from `cursor`, fitting into `slotWidth`.
  *
@@ -160,10 +234,17 @@ declare function layoutNextLine(segments: PreparedSegment[], cursor: LayoutCurso
  */
 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[];
+declare function computeCharPositions(lineBreaks: LineBreaksResult, segments: PreparedSegment[], lineHeight: number, segmentAdapter?: SegmentAdapter): CharPosition[];
 type ReactiveLayoutOptions = {
     /** Measurement backend (required). */
     adapter: MeasurementAdapter;
+    /**
+     * Segmentation backend (optional). Defaults to a lazy {@link IntlSegmentAdapter}
+     * (uses platform `Intl.Segmenter`). **Required on Hermes / RN** where
+     * `Intl.Segmenter` is undefined — wire a polyfilled {@link SegmentAdapter}
+     * here. See {@link SegmentAdapter} JSDoc for the polyfill recipe.
+     */
+    segmentAdapter?: SegmentAdapter;
     /** Graph name (default: "reactive-layout"). */
     name?: string;
     /** Initial text. */
@@ -192,4 +273,4 @@ type ReactiveLayoutOptions = {
  */
 declare function reactiveLayout(opts: ReactiveLayoutOptions): ReactiveLayoutBundle;
 
-export { type CharPosition as C, type Interval as I, type LayoutCursor as L, type MeasurementAdapter as M, type PreparedSegment as P, type ReactiveLayoutBundle as R, type SegmentBreakKind as S, type LayoutLine as a, type LayoutNextLineContext as b, type LayoutNextLineResult as c, type LineBreaksResult 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 };
+export { type CharPosition as C, type Interval as I, type LayoutCursor as L, type MeasurementAdapter as M, type PreparedSegment as P, type ReactiveLayoutBundle as R, type SegmentAdapter as S, type LayoutLine as a, type LayoutNextLineContext as b, type LayoutNextLineResult as c, type LineBreaksResult as d, type ReactiveLayoutOptions as e, type SegmentBreakKind as f, type SegmentInfo as g, type SegmentMeasureStats as h, analyzeAndMeasure as i, carveTextLineSlots as j, computeCharPositions as k, computeLineBreaks as l, layoutNextLine as m, reactiveLayout as r };

package/dist/{reactive-layout-fswlBUvX.d.cts → reactive-layout-BBBWH0V_.d.ts}

@@ -21,6 +21,73 @@ interface MeasurementAdapter {
     /** Optional; adapters may omit for read-only / stateless measurement. */
     clearCache?(): void;
 }
+/**
+ * A single segmented piece — the structurally-narrowed common shape across
+ * `Intl.Segmenter`'s `Intl.SegmentData` and host-provided polyfills.
+ *
+ * Drops `input` (redundant — the caller already has the text) and narrows
+ * `isWordLike` to "may be missing" so grapheme-granularity callers ignore it
+ * cleanly.
+ */
+type SegmentInfo = {
+    /** The segmented substring. */
+    segment: string;
+    /** Code-unit offset of `segment` within the input. */
+    index: number;
+    /** True if the word-granularity segment looks like a word (letters / kana / etc.). Always undefined for grapheme granularity. */
+    isWordLike?: boolean;
+};
+/**
+ * Pluggable text-segmentation backend (separate from {@link MeasurementAdapter}
+ * because measurement and segmentation are different host concerns —
+ * Skia/Canvas measure widths, ICU segments graphemes/words).
+ *
+ * **Why this exists (DS-2026-05-20 — `optimizations.md` 🟠 (d)).**
+ * `reactive-layout`'s default backend uses `new Intl.Segmenter(...)` for word /
+ * grapheme iteration. Hermes (iOS 26.5 / RN 0.83) ships **without**
+ * `Intl.Segmenter` — `typeof Intl.Segmenter === "undefined"` — and the
+ * constructor throws `Cannot read property 'prototype' of undefined`. This
+ * interface lets RN/Hermes consumers inject their own segmenter (typically a
+ * polyfill wrapper) so the substrate never touches the missing global.
+ *
+ * **Contract:** sync, pure, idempotent. `segmentWords` must mirror
+ * `Intl.Segmenter(undefined, { granularity: "word" }).segment(text)`'s shape
+ * (an iterable of `{ segment, index, isWordLike }`); `segmentGraphemes`
+ * mirrors `{ granularity: "grapheme" }`. The reference implementation is
+ * {@link IntlSegmentAdapter}.
+ *
+ * **Polyfill recipe (RN/Hermes consumer userland — NOT shipped here per the
+ * `bigintJsonCodecFor` userland-binding precedent):**
+ *
+ * ```ts
+ * // Userland — at app entry, before any reactive-layout import:
+ * import "intl-segmenter-polyfill/dist/polyfill"; // or @formatjs/intl-segmenter
+ * // Then the substrate's default IntlSegmentAdapter works:
+ * import { reactiveLayout } from "@graphrefly/graphrefly/utils/reactive-layout";
+ * ```
+ *
+ * Or, without polyfilling the global (preferred — keeps ICU bytes scoped):
+ *
+ * ```ts
+ * // Userland — wrap any segmenter implementation:
+ * import { createIntlSegmenterPolyfill } from "intl-segmenter-polyfill";
+ * import type { SegmentAdapter, SegmentInfo } from "@graphrefly/graphrefly/utils/reactive-layout";
+ *
+ * const wordSeg = await createIntlSegmenterPolyfill({ granularity: "word" });
+ * const graphemeSeg = await createIntlSegmenterPolyfill({ granularity: "grapheme" });
+ * const segmentAdapter: SegmentAdapter = {
+ *   segmentWords: (text) => wordSeg.segment(text) as Iterable<SegmentInfo>,
+ *   segmentGraphemes: (text) => graphemeSeg.segment(text) as Iterable<SegmentInfo>,
+ * };
+ * reactiveLayout({ adapter, segmentAdapter, ... });
+ * ```
+ */
+interface SegmentAdapter {
+    /** Word-granularity segmentation — yields `{ segment, index, isWordLike }`. */
+    segmentWords(text: string): Iterable<SegmentInfo>;
+    /** Grapheme-granularity segmentation — yields `{ segment, index }`. `isWordLike` is unused / undefined. */
+    segmentGraphemes(text: string): Iterable<SegmentInfo>;
+}
 /** Mutable counters for `analyzeAndMeasure` cache hit ratio (hits / (hits + misses)). */
 type SegmentMeasureStats = {
     hits: number;
@@ -86,6 +153,13 @@ type LayoutNextLineContext = {
     adapter?: MeasurementAdapter;
     font?: string;
     cache?: Map<string, Map<string, number>>;
+    /**
+     * Optional {@link SegmentAdapter} for grapheme slicing during partial-segment
+     * line builds. Defaults to {@link IntlSegmentAdapter} (lazy module shared);
+     * Hermes / RN consumers wire their own to avoid the missing-`Intl.Segmenter`
+     * runtime throw — see {@link SegmentAdapter} JSDoc.
+     */
+    segmentAdapter?: SegmentAdapter;
 };
 /** Result of the reactive layout graph's describe-accessible state. */
 type ReactiveLayoutBundle = {
@@ -111,7 +185,7 @@ type ReactiveLayoutBundle = {
  * 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[];
+declare function analyzeAndMeasure(text: string, font: string, adapter: MeasurementAdapter, cache: Map<string, Map<string, number>>, stats?: SegmentMeasureStats, segmentAdapter?: SegmentAdapter): PreparedSegment[];
 /**
  * Greedy line-breaking algorithm.
  *
@@ -122,7 +196,7 @@ declare function analyzeAndMeasure(text: string, font: string, adapter: Measurem
  * - 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;
+declare function computeLineBreaks(segments: PreparedSegment[], maxWidth: number, adapter: MeasurementAdapter, font: string, cache: Map<string, Map<string, number>>, segmentAdapter?: SegmentAdapter): LineBreaksResult;
 /**
  * Lay out the next single line starting from `cursor`, fitting into `slotWidth`.
  *
@@ -160,10 +234,17 @@ declare function layoutNextLine(segments: PreparedSegment[], cursor: LayoutCurso
  */
 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[];
+declare function computeCharPositions(lineBreaks: LineBreaksResult, segments: PreparedSegment[], lineHeight: number, segmentAdapter?: SegmentAdapter): CharPosition[];
 type ReactiveLayoutOptions = {
     /** Measurement backend (required). */
     adapter: MeasurementAdapter;
+    /**
+     * Segmentation backend (optional). Defaults to a lazy {@link IntlSegmentAdapter}
+     * (uses platform `Intl.Segmenter`). **Required on Hermes / RN** where
+     * `Intl.Segmenter` is undefined — wire a polyfilled {@link SegmentAdapter}
+     * here. See {@link SegmentAdapter} JSDoc for the polyfill recipe.
+     */
+    segmentAdapter?: SegmentAdapter;
     /** Graph name (default: "reactive-layout"). */
     name?: string;
     /** Initial text. */
@@ -192,4 +273,4 @@ type ReactiveLayoutOptions = {
  */
 declare function reactiveLayout(opts: ReactiveLayoutOptions): ReactiveLayoutBundle;
 
-export { type CharPosition as C, type Interval as I, type LayoutCursor as L, type MeasurementAdapter as M, type PreparedSegment as P, type ReactiveLayoutBundle as R, type SegmentBreakKind as S, type LayoutLine as a, type LayoutNextLineContext as b, type LayoutNextLineResult as c, type LineBreaksResult 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 };
+export { type CharPosition as C, type Interval as I, type LayoutCursor as L, type MeasurementAdapter as M, type PreparedSegment as P, type ReactiveLayoutBundle as R, type SegmentAdapter as S, type LayoutLine as a, type LayoutNextLineContext as b, type LayoutNextLineResult as c, type LineBreaksResult as d, type ReactiveLayoutOptions as e, type SegmentBreakKind as f, type SegmentInfo as g, type SegmentMeasureStats as h, analyzeAndMeasure as i, carveTextLineSlots as j, computeCharPositions as k, computeLineBreaks as l, layoutNextLine as m, reactiveLayout as r };