@graphrefly/ts 0.0.2 → 0.0.3

package/dist/{measurements-C0mAvWU1.d.cts → measurements-B_gJfD8h.d.cts}

@@ -1,7 +1,7 @@
-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-BWK2ay3e.cjs';
+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-CWK3HLPB.cjs';
-import { N as Node } from './types-BS6CyR-x.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 {
@@ -70,14 +70,67 @@ declare function computeTotalHeight(blocks: readonly PositionedBlock[]): number;
 /**
  * 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.
+ * @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.
  *
- * Image/SVG sizing is explicit or injected; no async image loading or DOM SVG parsing occurs.
+ * @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. */
@@ -103,9 +156,57 @@ declare function blockedIntervalsForBand(obstacles: readonly Obstacle[], bandTop
 /** 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. */
+/**
+ * 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[];
-/** Greedy single-column line breaking over prepared segments. */
+/**
+ * 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;
@@ -114,7 +215,36 @@ declare function computeLineBreaks(segments: readonly PreparedSegment[], maxWidt
 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. */
+/**
+ * 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?: {

package/dist/messaging/index.d.cts

@@ -1,12 +1,12 @@
-import { d as Graph } from '../graph-CWK3HLPB.cjs';
-import { N as Node } from '../types-BS6CyR-x.cjs';
-import { e as EventMessageOptions, E as EventMessage, d as MessageBus, f as MessageBusTopicPage, g as MessageBusOptions, T as ToTopicOptions, h as ToTopicBundle } from '../types-BhveCMg5.cjs';
-export { C as CONTEXT_TOPIC, D as DEFERRED_TOPIC, I as INJECTIONS_TOPIC, J as JsonSchema, b as MessageBusAvailablePage, i as MessageBusAvailableParams, j as MessageBusCatalogEntry, k as MessageBusCatalogPage, l as MessageBusCatalogParams, a as MessageBusCommand, m as MessageBusCursor, n as MessageBusDeadLetterEntry, o as MessageBusDeadLetterPage, p as MessageBusDeadLetterParams, q as MessageBusDedupePolicy, M as MessageBusMessage, r as MessageBusPageParams, s as MessageBusPullProjection, t as MessageBusRetentionPolicy, u as MessageBusStatus, v as MessageBusSubscription, w as MessageBusTopicParams, x as MessageBusTopicPolicy, y as MessageBusTopicProjection, c as MessageEnvelope, P as PROMPTS_TOPIC, R as RESPONSES_TOPIC, S as SPAWNS_TOPIC, z as STANDARD_TOPICS, A as StandardTopic, B as TODOS_TOPIC, F as TopicMessage } from '../types-BhveCMg5.cjs';
+import { d as Graph } from '../graph-C1C-wb0L.cjs';
+import { N as Node } from '../types-CTN3XoMl.cjs';
+import { e as EventMessageOptions, E as EventMessage, d as MessageBus, f as MessageBusTopicPage, g as MessageBusOptions, T as ToTopicOptions, h as ToTopicBundle } from '../types-BAw2QVVE.cjs';
+export { C as CONTEXT_TOPIC, D as DEFERRED_TOPIC, I as INJECTIONS_TOPIC, J as JsonSchema, b as MessageBusAvailablePage, i as MessageBusAvailableParams, j as MessageBusCatalogEntry, k as MessageBusCatalogPage, l as MessageBusCatalogParams, a as MessageBusCommand, m as MessageBusCursor, n as MessageBusDeadLetterEntry, o as MessageBusDeadLetterPage, p as MessageBusDeadLetterParams, q as MessageBusDedupePolicy, M as MessageBusMessage, r as MessageBusPageParams, s as MessageBusPullProjection, t as MessageBusRetentionPolicy, u as MessageBusStatus, v as MessageBusSubscription, w as MessageBusTopicParams, x as MessageBusTopicPolicy, y as MessageBusTopicProjection, c as MessageEnvelope, P as PROMPTS_TOPIC, R as RESPONSES_TOPIC, S as SPAWNS_TOPIC, z as STANDARD_TOPICS, A as StandardTopic, B as TODOS_TOPIC, F as TopicMessage } from '../types-BAw2QVVE.cjs';
 import { DataIssue } from '../data/index.cjs';
 import '../core/index.cjs';
 import '../messages-CAzUPPJM.cjs';
 import '../codec-BB7p8fJc.cjs';
-import '../describe-CQRrkv-Q.cjs';
+import '../describe-BumQ-3_0.cjs';
 
 declare function eventMessage<T>(type: string, payload: T, opts: EventMessageOptions): EventMessage<T>;
 declare function isEventMessage(value: unknown): value is EventMessage;

package/dist/messaging/index.d.ts

@@ -1,12 +1,12 @@
-import { d as Graph } from '../graph-ho5sotHP.js';
-import { N as Node } from '../types-C9NOgNJw.js';
-import { e as EventMessageOptions, E as EventMessage, d as MessageBus, f as MessageBusTopicPage, g as MessageBusOptions, T as ToTopicOptions, h as ToTopicBundle } from '../types-CTsQ8Ww4.js';
-export { C as CONTEXT_TOPIC, D as DEFERRED_TOPIC, I as INJECTIONS_TOPIC, J as JsonSchema, b as MessageBusAvailablePage, i as MessageBusAvailableParams, j as MessageBusCatalogEntry, k as MessageBusCatalogPage, l as MessageBusCatalogParams, a as MessageBusCommand, m as MessageBusCursor, n as MessageBusDeadLetterEntry, o as MessageBusDeadLetterPage, p as MessageBusDeadLetterParams, q as MessageBusDedupePolicy, M as MessageBusMessage, r as MessageBusPageParams, s as MessageBusPullProjection, t as MessageBusRetentionPolicy, u as MessageBusStatus, v as MessageBusSubscription, w as MessageBusTopicParams, x as MessageBusTopicPolicy, y as MessageBusTopicProjection, c as MessageEnvelope, P as PROMPTS_TOPIC, R as RESPONSES_TOPIC, S as SPAWNS_TOPIC, z as STANDARD_TOPICS, A as StandardTopic, B as TODOS_TOPIC, F as TopicMessage } from '../types-CTsQ8Ww4.js';
+import { d as Graph } from '../graph-CS0b4V9B.js';
+import { N as Node } from '../types-DChxk1vK.js';
+import { e as EventMessageOptions, E as EventMessage, d as MessageBus, f as MessageBusTopicPage, g as MessageBusOptions, T as ToTopicOptions, h as ToTopicBundle } from '../types-DRu7SnLV.js';
+export { C as CONTEXT_TOPIC, D as DEFERRED_TOPIC, I as INJECTIONS_TOPIC, J as JsonSchema, b as MessageBusAvailablePage, i as MessageBusAvailableParams, j as MessageBusCatalogEntry, k as MessageBusCatalogPage, l as MessageBusCatalogParams, a as MessageBusCommand, m as MessageBusCursor, n as MessageBusDeadLetterEntry, o as MessageBusDeadLetterPage, p as MessageBusDeadLetterParams, q as MessageBusDedupePolicy, M as MessageBusMessage, r as MessageBusPageParams, s as MessageBusPullProjection, t as MessageBusRetentionPolicy, u as MessageBusStatus, v as MessageBusSubscription, w as MessageBusTopicParams, x as MessageBusTopicPolicy, y as MessageBusTopicProjection, c as MessageEnvelope, P as PROMPTS_TOPIC, R as RESPONSES_TOPIC, S as SPAWNS_TOPIC, z as STANDARD_TOPICS, A as StandardTopic, B as TODOS_TOPIC, F as TopicMessage } from '../types-DRu7SnLV.js';
 import { DataIssue } from '../data/index.js';
 import '../core/index.js';
 import '../messages-CAzUPPJM.js';
 import '../codec-BB7p8fJc.js';
-import '../describe-B_A5fbXH.js';
+import '../describe-cYr_Z5zm.js';
 
 declare function eventMessage<T>(type: string, payload: T, opts: EventMessageOptions): EventMessage<T>;
 declare function isEventMessage(value: unknown): value is EventMessage;