@glissade/scene 0.19.0-pre.2 → 0.19.0-pre.3

package/dist/describe.js

@@ -22,7 +22,7 @@ import { easings, listValueTypes } from "@glissade/core";
 * never pulled onto the base embed path — a scene that never calls `describe()`
 * pays zero bytes for it.
 */
-const RAW_VERSION = "0.19.0-pre.2";
+const RAW_VERSION = "0.19.0-pre.3";
 const PACKAGE_VERSION = RAW_VERSION.includes("GLISSADE_".concat("VERSION")) ? "0.0.0-dev" : RAW_VERSION;
 /** Arity of a value type's numeric repr: vec2/vec2-arc → 2, number → 1; others (color/paint/path/string/boolean) carry no scalar arity. */
 function arityOf(type) {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { C as Mat2x3, D as matEquals, E as invert, O as multiply, S as IDENTITY, T as fromTRS, _ as StrokeStyle, a as FilterSpec, b as glow, c as MeshInterpolation, d as Paint, f as PathSeg, g as ShaderRef, h as ResourceId, i as DrawCommand, l as MeshPaint, m as Resource, n as DisplayList, o as FilterValidationError, p as Rect$1, r as DisplayListBuilder, s as FontSpec, t as BlendMode, u as MeshPoint, v as createDisplayListBuilder, w as applyToPoint, x as validateFilters, y as filtersToCanvasFilter } from "./displayList.js";
-import { A as resolveSketch, B as NodeProps, C as Polyline, D as arcLength, E as SketchValidationError, F as AnchorSpec, G as TextMetricsLite, H as resolveAnchor, I as BindablePropTarget, J as quantize, K as breakLines, L as EvalContext, M as sketchStrokes, N as validateHachure, O as flatten, P as validateSketch, R as HitArea, S as HachureSpec, T as SketchStyle, U as MEASURE_QUANTUM_PX, V as PropInit, W as TextMeasurer, X as segmentWords, Y as segmentGraphemes, Z as setDefaultMeasurer, _ as WordBox, a as ImageNode, b as revealSchedule, c as Path, d as RevealMark, f as ShapeProps, g as VideoProps, h as Video, i as Group, j as roughen, k as hachureLines, l as PathProps, m as TextProps, n as Custom, o as ImageProps, p as Text, q as estimatingMeasurer, r as GraphemeBox, s as LineBox, t as Circle, u as Rect, v as coercePathData, w as ResolvedSketch, x as roundedRectSegs, y as pathFromSegs, z as Node } from "./nodes.js";
+import { $ as setDefaultMeasurer, A as resolveSketch, B as NodeProps, C as Polyline, D as arcLength, E as SketchValidationError, F as AnchorSpec, G as TextMetricsLite, H as resolveAnchor, I as BindablePropTarget, J as estimatingMeasurer, K as __resetEstimateWarnings, L as EvalContext, M as sketchStrokes, N as validateHachure, O as flatten, P as validateSketch, Q as segmentWords, R as HitArea, S as HachureSpec, T as SketchStyle, U as MEASURE_QUANTUM_PX, V as PropInit, W as TextMeasurer, X as quantize, Y as isEstimatingMeasurer, Z as segmentGraphemes, _ as WordBox, a as ImageNode, b as revealSchedule, c as Path, d as RevealMark, f as ShapeProps, g as VideoProps, h as Video, i as Group, j as roughen, k as hachureLines, l as PathProps, m as TextProps, n as Custom, o as ImageProps, p as Text, q as breakLines, r as GraphemeBox, s as LineBox, t as Circle, u as Rect, v as coercePathData, w as ResolvedSketch, x as roundedRectSegs, y as pathFromSegs, z as Node } from "./nodes.js";
 import { a as LayoutEngineMissingError, c as requireLayoutEngine, i as LayoutEngine, l as setLayoutEngine, n as LayoutChildSpec, r as LayoutContainerSpec, s as getLayoutEngine, t as LayoutBox } from "./layoutEngine.js";
 import { BindableSignal, BoundTimeline, CompiledTimeline, CoverageReport, EaseSpec, FontMode, FontUsage, MeshPaint as MeshPaint$1, PathValue, Playhead, Rng, Timeline, Track, Vec2 } from "@glissade/core";
 import { ChannelOverride, Clip } from "@glissade/core/clips";
@@ -907,4 +907,4 @@ declare function meshRasterSize(bw: number, bh: number): {
   h: number;
 };
 //#endregion
-export { ALL_FILTER_KINDS, type AnchorSpec, type BackendCaps, type BindablePropTarget, type BlendMode, type CacheColdResult, type CanvasLike, Circle, ColdAssetError, type CommandDelta, type Ctx2DLike, Custom, DL_SNAPSHOT_VERSION, DeterminismViolationError, type DisplayDiff, type DisplayList, type DisplayListBuilder, type DlSnapshot, DlSnapshotError, type DrawCommand, type DrawOnEachOptions, type DrawOnOptions, DuplicateNodeIdError, type EachBox, type EachContext, type EachDistribute, EachError, type EachLayout, type EachMotion, type EachOpts, type EachResult, type EditMark, type EvalContext, type FieldChange, type FilterKind, type FilterSpec, FilterValidationError, FollowPath, type FollowPathProps, type FontByteLoader, type FontSpec, type GraphemeBox, Group, type GuardMode, type HachureSpec, Highlight, type HighlightProps, type HitArea, IDENTITY, ImageNode as Image, ImageNode, type ImageDataLike, type ImageHandle, type ImageProps, type LayoutBox, type LayoutChildSpec, type LayoutContainerSpec, type LayoutEngine, LayoutEngineMissingError, type LineBox, MEASURE_QUANTUM_PX, MESH_DOWNSCALE, MESH_SHEPARD_POWER, MESH_SIGMA, type Mat2x3, type MeshInterpolation, type MeshPaint, type MeshPoint, NODE_TAXONOMY, Node, type NodeProps, type NodeTypeName, type Paint, Path, type PathLike, type PathProps, type PathSampler, type PathSeg, type Place, type Polyline, type PropInit, Raster2D, type Raster2DHost, Rect, type Rect$1 as RectShape, type RenderBackend, ReservedNodeIdError, type ResolvedSketch, type Resource, type ResourceId, type RevealMark, type Scene, type SceneInit, type SceneModule, type ShaderCaps, ShaderEffect, type ShaderEffectProps, type ShaderRef, type ShapeProps, type SketchStyle, SketchValidationError, type StepMark, type StrokeStyle, Text, TextCursor, type TextCursorProps, type TextMeasurer, type TextMetricsLite, type TextProps, TokenHighlight, type TokenHighlightProps, TokenMatchError, type TokenRange, type TypeEdit, type TypewriterResult, type ValidateSceneFontsOptions, Video, type VideoFrameSource, type VideoProps, type WordBox, applyToPoint, arcLength, auditCacheCold, bindScene, breakLines, coercePathData, collapseReplacer, collectLocalizedTextUsages, collectTextUsages, createDisplayListBuilder, createScene, diffDisplayLists, drawOn, drawOnEach, each, estimatingMeasurer, evaluate, filtersToCanvasFilter, flatten, followPath, fontString, formatDisplayDiff, fromTRS, getLayoutEngine, glow, hachureLines, highlight, invert, matEquals, matchTokenRun, meshRasterSize, motionPath, multiply, parseDisplaySnapshot, pathFromSegs, pathLength, pointAtLength, quantize, rasterizeMesh, requireLayoutEngine, resolveAnchor, resolveSketch, revealSchedule, roughen, roundedRectSegs, segmentGraphemes, segmentWords, serializeDisplayList, setDefaultMeasurer, setLayoutEngine, sketchStrokes, textCursor, tokenHighlight, typewriter, validateFilters, validateHachure, validateSceneFonts, validateSketch, withDeterminismGuards };
+export { ALL_FILTER_KINDS, type AnchorSpec, type BackendCaps, type BindablePropTarget, type BlendMode, type CacheColdResult, type CanvasLike, Circle, ColdAssetError, type CommandDelta, type Ctx2DLike, Custom, DL_SNAPSHOT_VERSION, DeterminismViolationError, type DisplayDiff, type DisplayList, type DisplayListBuilder, type DlSnapshot, DlSnapshotError, type DrawCommand, type DrawOnEachOptions, type DrawOnOptions, DuplicateNodeIdError, type EachBox, type EachContext, type EachDistribute, EachError, type EachLayout, type EachMotion, type EachOpts, type EachResult, type EditMark, type EvalContext, type FieldChange, type FilterKind, type FilterSpec, FilterValidationError, FollowPath, type FollowPathProps, type FontByteLoader, type FontSpec, type GraphemeBox, Group, type GuardMode, type HachureSpec, Highlight, type HighlightProps, type HitArea, IDENTITY, ImageNode as Image, ImageNode, type ImageDataLike, type ImageHandle, type ImageProps, type LayoutBox, type LayoutChildSpec, type LayoutContainerSpec, type LayoutEngine, LayoutEngineMissingError, type LineBox, MEASURE_QUANTUM_PX, MESH_DOWNSCALE, MESH_SHEPARD_POWER, MESH_SIGMA, type Mat2x3, type MeshInterpolation, type MeshPaint, type MeshPoint, NODE_TAXONOMY, Node, type NodeProps, type NodeTypeName, type Paint, Path, type PathLike, type PathProps, type PathSampler, type PathSeg, type Place, type Polyline, type PropInit, Raster2D, type Raster2DHost, Rect, type Rect$1 as RectShape, type RenderBackend, ReservedNodeIdError, type ResolvedSketch, type Resource, type ResourceId, type RevealMark, type Scene, type SceneInit, type SceneModule, type ShaderCaps, ShaderEffect, type ShaderEffectProps, type ShaderRef, type ShapeProps, type SketchStyle, SketchValidationError, type StepMark, type StrokeStyle, Text, TextCursor, type TextCursorProps, type TextMeasurer, type TextMetricsLite, type TextProps, TokenHighlight, type TokenHighlightProps, TokenMatchError, type TokenRange, type TypeEdit, type TypewriterResult, type ValidateSceneFontsOptions, Video, type VideoFrameSource, type VideoProps, type WordBox, __resetEstimateWarnings, applyToPoint, arcLength, auditCacheCold, bindScene, breakLines, coercePathData, collapseReplacer, collectLocalizedTextUsages, collectTextUsages, createDisplayListBuilder, createScene, diffDisplayLists, drawOn, drawOnEach, each, estimatingMeasurer, evaluate, filtersToCanvasFilter, flatten, followPath, fontString, formatDisplayDiff, fromTRS, getLayoutEngine, glow, hachureLines, highlight, invert, isEstimatingMeasurer, matEquals, matchTokenRun, meshRasterSize, motionPath, multiply, parseDisplaySnapshot, pathFromSegs, pathLength, pointAtLength, quantize, rasterizeMesh, requireLayoutEngine, resolveAnchor, resolveSketch, revealSchedule, roughen, roundedRectSegs, segmentGraphemes, segmentWords, serializeDisplayList, setDefaultMeasurer, setLayoutEngine, sketchStrokes, textCursor, tokenHighlight, typewriter, validateFilters, validateHachure, validateSceneFonts, validateSketch, withDeterminismGuards };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { A as sketchStrokes, B as collapseReplacer, C as SketchValidationError, D as hashStr, E as hachureLines, F as filtersToCanvasFilter, G as IDENTITY, H as formatDisplayDiff, I as glow, J as invert, K as applyToPoint, L as validateFilters, M as validateSketch, N as FilterValidationError, O as resolveSketch, P as createDisplayListBuilder, R as DL_SNAPSHOT_VERSION, S as setDefaultMeasurer, T as flatten, U as parseDisplaySnapshot, V as diffDisplayLists, W as serializeDisplayList, X as multiply, Y as matEquals, _ as estimatingMeasurer, a as Path, b as segmentGraphemes, c as Video, d as revealSchedule, f as roundedRectSegs, g as breakLines, h as MEASURE_QUANTUM_PX, i as ImageNode, j as validateHachure, k as roughen, l as coercePathData, m as resolveAnchor, n as Custom, o as Rect, p as Node, q as fromTRS, r as Group, s as Text, t as Circle, u as pathFromSegs, v as fallbackMeasurer, w as arcLength, x as segmentWords, y as quantize, z as DlSnapshotError } from "./nodes.js";
+import { $ as multiply, A as hashStr, B as validateFilters, C as segmentWords, D as arcLength, E as SketchValidationError, F as validateSketch, G as formatDisplayDiff, H as DlSnapshotError, I as FilterValidationError, J as IDENTITY, K as parseDisplaySnapshot, L as createDisplayListBuilder, M as roughen, N as sketchStrokes, O as flatten, P as validateHachure, Q as matEquals, R as filtersToCanvasFilter, S as segmentGraphemes, U as collapseReplacer, V as DL_SNAPSHOT_VERSION, W as diffDisplayLists, X as fromTRS, Y as applyToPoint, Z as invert, _ as breakLines, a as Path, b as isEstimatingMeasurer, c as Video, d as revealSchedule, f as roundedRectSegs, g as __resetEstimateWarnings, h as MEASURE_QUANTUM_PX, i as ImageNode, j as resolveSketch, k as hachureLines, l as coercePathData, m as resolveAnchor, n as Custom, o as Rect, p as Node, q as serializeDisplayList, r as Group, s as Text, t as Circle, u as pathFromSegs, v as estimatingMeasurer, w as setDefaultMeasurer, x as quantize, y as fallbackMeasurer, z as glow } from "./nodes.js";
 import { i as setLayoutEngine, n as getLayoutEngine, r as requireLayoutEngine, t as LayoutEngineMissingError } from "./layoutEngine.js";
 import { bindTimeline, buildFontRegistry, compileTimeline, createPlayhead, emitDevWarning, evaluateAt, key, lerpColor, oklabToRgba, parseCmap, parseColor, random, rgbaToOklab, signal, stagger, track, validateFonts, vec2Signal } from "@glissade/core";
 //#region src/taxonomy.ts
@@ -1857,4 +1857,4 @@ var Raster2D = class {
 	}
 };
 //#endregion
-export { ALL_FILTER_KINDS, Circle, ColdAssetError, Custom, DL_SNAPSHOT_VERSION, DeterminismViolationError, DlSnapshotError, DuplicateNodeIdError, EachError, FilterValidationError, FollowPath, Group, Highlight, IDENTITY, ImageNode as Image, ImageNode, LayoutEngineMissingError, MEASURE_QUANTUM_PX, MESH_DOWNSCALE, MESH_SHEPARD_POWER, MESH_SIGMA, NODE_TAXONOMY, Node, Path, Raster2D, Rect, ReservedNodeIdError, ShaderEffect, SketchValidationError, Text, TextCursor, TokenHighlight, TokenMatchError, Video, applyToPoint, arcLength, auditCacheCold, bindScene, breakLines, coercePathData, collapseReplacer, collectLocalizedTextUsages, collectTextUsages, createDisplayListBuilder, createScene, diffDisplayLists, drawOn, drawOnEach, each, estimatingMeasurer, evaluate, filtersToCanvasFilter, flatten, followPath, fontString, formatDisplayDiff, fromTRS, getLayoutEngine, glow, hachureLines, highlight, invert, matEquals, matchTokenRun, meshRasterSize, motionPath, multiply, parseDisplaySnapshot, pathFromSegs, pathLength, pointAtLength, quantize, rasterizeMesh, requireLayoutEngine, resolveAnchor, resolveSketch, revealSchedule, roughen, roundedRectSegs, segmentGraphemes, segmentWords, serializeDisplayList, setDefaultMeasurer, setLayoutEngine, sketchStrokes, textCursor, tokenHighlight, typewriter, validateFilters, validateHachure, validateSceneFonts, validateSketch, withDeterminismGuards };
+export { ALL_FILTER_KINDS, Circle, ColdAssetError, Custom, DL_SNAPSHOT_VERSION, DeterminismViolationError, DlSnapshotError, DuplicateNodeIdError, EachError, FilterValidationError, FollowPath, Group, Highlight, IDENTITY, ImageNode as Image, ImageNode, LayoutEngineMissingError, MEASURE_QUANTUM_PX, MESH_DOWNSCALE, MESH_SHEPARD_POWER, MESH_SIGMA, NODE_TAXONOMY, Node, Path, Raster2D, Rect, ReservedNodeIdError, ShaderEffect, SketchValidationError, Text, TextCursor, TokenHighlight, TokenMatchError, Video, __resetEstimateWarnings, applyToPoint, arcLength, auditCacheCold, bindScene, breakLines, coercePathData, collapseReplacer, collectLocalizedTextUsages, collectTextUsages, createDisplayListBuilder, createScene, diffDisplayLists, drawOn, drawOnEach, each, estimatingMeasurer, evaluate, filtersToCanvasFilter, flatten, followPath, fontString, formatDisplayDiff, fromTRS, getLayoutEngine, glow, hachureLines, highlight, invert, isEstimatingMeasurer, matEquals, matchTokenRun, meshRasterSize, motionPath, multiply, parseDisplaySnapshot, pathFromSegs, pathLength, pointAtLength, quantize, rasterizeMesh, requireLayoutEngine, resolveAnchor, resolveSketch, revealSchedule, roughen, roundedRectSegs, segmentGraphemes, segmentWords, serializeDisplayList, setDefaultMeasurer, setLayoutEngine, sketchStrokes, textCursor, tokenHighlight, typewriter, validateFilters, validateHachure, validateSceneFonts, validateSketch, withDeterminismGuards };

package/dist/layout.js

@@ -1,4 +1,4 @@
-import { r as Group, v as fallbackMeasurer } from "./nodes.js";
+import { r as Group, y as fallbackMeasurer } from "./nodes.js";
 import { i as setLayoutEngine, n as getLayoutEngine, r as requireLayoutEngine, t as LayoutEngineMissingError } from "./layoutEngine.js";
 import { computed, signal } from "@glissade/core";
 //#region src/layout.ts

package/dist/nodes.d.ts

@@ -33,6 +33,25 @@ declare function setDefaultMeasurer(m: TextMeasurer | null): void;
 /** The default-or-estimating chain end; internal fallback for measurer pulls. */
 
 declare const estimatingMeasurer: TextMeasurer;
+/**
+ * True when `m` is the per-character ESTIMATING fallback (the module singleton)
+ * — i.e. no real backend measurer and no registered `defaultMeasurer` was
+ * available. Identity-compare so a real backend or a `setDefaultMeasurer`-
+ * registered measurer never trips it.
+ */
+declare function isEstimatingMeasurer(m: TextMeasurer): boolean;
+/**
+ * One-shot dev-warning when a build-time geometry getter resolved its measurer
+ * to the rough per-character estimate (no backend, no `setDefaultMeasurer`).
+ * `site` keys the de-dupe so each distinct caller warns at most once. Silent
+ * when a real measurer is in play — the estimate is the only footgun here.
+ */
+
+/**
+ * Test-only: clear the one-shot de-dupe so the estimate warning can re-assert.
+ * @internal
+ */
+declare function __resetEstimateWarnings(): void;
 /**
  * The draw-path word segmentation (Intl.Segmenter boundaries, punctuation
  * glued to its predecessor) — exported so Text.wordBoxes() boxes EXACTLY the
@@ -719,4 +738,4 @@ interface RevealMark {
  */
 declare function revealSchedule(text: Text, reveal: Track<number>, measurer?: TextMeasurer): RevealMark[];
 //#endregion
-export { resolveSketch as A, NodeProps as B, Polyline as C, arcLength as D, SketchValidationError as E, AnchorSpec as F, TextMetricsLite as G, resolveAnchor as H, BindablePropTarget as I, quantize as J, breakLines as K, EvalContext as L, sketchStrokes as M, validateHachure as N, flatten as O, validateSketch as P, HitArea as R, HachureSpec as S, SketchStyle as T, MEASURE_QUANTUM_PX as U, PropInit as V, TextMeasurer as W, segmentWords as X, segmentGraphemes as Y, setDefaultMeasurer as Z, WordBox as _, ImageNode as a, revealSchedule as b, Path as c, RevealMark as d, ShapeProps as f, VideoProps as g, Video as h, Group as i, roughen as j, hachureLines as k, PathProps as l, TextProps as m, Custom as n, ImageProps as o, Text as p, estimatingMeasurer as q, GraphemeBox as r, LineBox as s, Circle as t, Rect as u, coercePathData as v, ResolvedSketch as w, roundedRectSegs as x, pathFromSegs as y, Node as z };
+export { setDefaultMeasurer as $, resolveSketch as A, NodeProps as B, Polyline as C, arcLength as D, SketchValidationError as E, AnchorSpec as F, TextMetricsLite as G, resolveAnchor as H, BindablePropTarget as I, estimatingMeasurer as J, __resetEstimateWarnings as K, EvalContext as L, sketchStrokes as M, validateHachure as N, flatten as O, validateSketch as P, segmentWords as Q, HitArea as R, HachureSpec as S, SketchStyle as T, MEASURE_QUANTUM_PX as U, PropInit as V, TextMeasurer as W, quantize as X, isEstimatingMeasurer as Y, segmentGraphemes as Z, WordBox as _, ImageNode as a, revealSchedule as b, Path as c, RevealMark as d, ShapeProps as f, VideoProps as g, Video as h, Group as i, roughen as j, hachureLines as k, PathProps as l, TextProps as m, Custom as n, ImageProps as o, Text as p, breakLines as q, GraphemeBox as r, LineBox as s, Circle as t, Rect as u, coercePathData as v, ResolvedSketch as w, roundedRectSegs as x, pathFromSegs as y, Node as z };

package/dist/nodes.js

@@ -662,6 +662,13 @@ function sketchStrokes(segs, style, seed) {
 //#endregion
 //#region src/text.ts
 /**
+* Text measurement + line breaking (DESIGN.md §3.6). Shaping is delegated to
+* the canvas implementation; line breaking is OURS, driven by the injected
+* TextMeasurer so the breaker always measures with the rasterizer that will
+* draw. Layout-feeding measurements are quantized (0.5px) so sub-pixel
+* advance drift between Skia/HarfBuzz versions cannot move whole layouts.
+*/
+/**
 * §3.6 measurement quantum (px). Scene-owned pre-measure quantizes every
 * layout-feeding advance to this grid ONCE, then hands Yoga frozen integers —
 * so sub-pixel measureText drift between Skia/HarfBuzz versions cannot move a
@@ -701,6 +708,35 @@ const estimatingMeasurer = { measureText(text, font) {
 		descent: font.size * .2
 	};
 } };
+/**
+* True when `m` is the per-character ESTIMATING fallback (the module singleton)
+* — i.e. no real backend measurer and no registered `defaultMeasurer` was
+* available. Identity-compare so a real backend or a `setDefaultMeasurer`-
+* registered measurer never trips it.
+*/
+function isEstimatingMeasurer(m) {
+	return m === estimatingMeasurer;
+}
+const warnedEstimate = /* @__PURE__ */ new Set();
+/**
+* One-shot dev-warning when a build-time geometry getter resolved its measurer
+* to the rough per-character estimate (no backend, no `setDefaultMeasurer`).
+* `site` keys the de-dupe so each distinct caller warns at most once. Silent
+* when a real measurer is in play — the estimate is the only footgun here.
+*/
+function warnIfEstimating(m, site) {
+	if (!isEstimatingMeasurer(m)) return;
+	if (warnedEstimate.has(site)) return;
+	warnedEstimate.add(site);
+	emitDevWarning(`${site}: no text measurer available — using a rough per-character estimate; pass { measurer } or call after setTextMeasurer()/setDefaultMeasurer() for exact layout.`);
+}
+/**
+* Test-only: clear the one-shot de-dupe so the estimate warning can re-assert.
+* @internal
+*/
+function __resetEstimateWarnings() {
+	warnedEstimate.clear();
+}
 let wordSegmenter;
 /**
 * The draw-path word segmentation (Intl.Segmenter boundaries, punctuation
@@ -1787,6 +1823,7 @@ var Text = class extends Node {
 	*/
 	lineBoxes(measurer) {
 		const m = measurer ?? this.measurerSource?.() ?? fallbackMeasurer();
+		if (measurer === void 0) warnIfEstimating(m, "Text.lineBoxes");
 		const text = this.text();
 		if (!text) return [];
 		const font = {
@@ -1825,6 +1862,7 @@ var Text = class extends Node {
 	*/
 	wordBoxes(measurer) {
 		const m = measurer ?? this.measurerSource?.() ?? fallbackMeasurer();
+		if (measurer === void 0) warnIfEstimating(m, "Text.wordBoxes");
 		const text = this.text();
 		if (!text) return [];
 		const font = {
@@ -1879,6 +1917,7 @@ var Text = class extends Node {
 	*/
 	graphemeBoxes(measurer) {
 		const m = measurer ?? this.measurerSource?.() ?? fallbackMeasurer();
+		if (measurer === void 0) warnIfEstimating(m, "Text.graphemeBoxes");
 		const text = this.text();
 		if (!text) return [];
 		const font = {
@@ -2120,4 +2159,4 @@ function revealSchedule(text, reveal, measurer) {
 	return marks;
 }
 //#endregion
-export { sketchStrokes as A, collapseReplacer as B, SketchValidationError as C, hashStr as D, hachureLines as E, filtersToCanvasFilter as F, IDENTITY as G, formatDisplayDiff as H, glow as I, invert as J, applyToPoint as K, validateFilters as L, validateSketch as M, FilterValidationError as N, resolveSketch as O, createDisplayListBuilder as P, DL_SNAPSHOT_VERSION as R, setDefaultMeasurer as S, flatten as T, parseDisplaySnapshot as U, diffDisplayLists as V, serializeDisplayList as W, multiply as X, matEquals as Y, estimatingMeasurer as _, Path as a, segmentGraphemes as b, Video as c, revealSchedule as d, roundedRectSegs as f, breakLines as g, MEASURE_QUANTUM_PX as h, ImageNode as i, validateHachure as j, roughen as k, coercePathData as l, resolveAnchor as m, Custom as n, Rect as o, Node as p, fromTRS as q, Group as r, Text as s, Circle as t, pathFromSegs as u, fallbackMeasurer as v, arcLength as w, segmentWords as x, quantize as y, DlSnapshotError as z };
+export { multiply as $, hashStr as A, validateFilters as B, segmentWords as C, arcLength as D, SketchValidationError as E, validateSketch as F, formatDisplayDiff as G, DlSnapshotError as H, FilterValidationError as I, IDENTITY as J, parseDisplaySnapshot as K, createDisplayListBuilder as L, roughen as M, sketchStrokes as N, flatten as O, validateHachure as P, matEquals as Q, filtersToCanvasFilter as R, segmentGraphemes as S, warnIfEstimating as T, collapseReplacer as U, DL_SNAPSHOT_VERSION as V, diffDisplayLists as W, fromTRS as X, applyToPoint as Y, invert as Z, breakLines as _, Path as a, isEstimatingMeasurer as b, Video as c, revealSchedule as d, roundedRectSegs as f, __resetEstimateWarnings as g, MEASURE_QUANTUM_PX as h, ImageNode as i, resolveSketch as j, hachureLines as k, coercePathData as l, resolveAnchor as m, Custom as n, Rect as o, Node as p, serializeDisplayList as q, Group as r, Text as s, Circle as t, pathFromSegs as u, estimatingMeasurer as v, setDefaultMeasurer as w, quantize as x, fallbackMeasurer as y, glow as z };

package/dist/type.js

@@ -1,4 +1,4 @@
-import { r as Group, s as Text, v as fallbackMeasurer, y as quantize } from "./nodes.js";
+import { T as warnIfEstimating, r as Group, s as Text, x as quantize, y as fallbackMeasurer } from "./nodes.js";
 //#region src/type.ts
 /**
 * `@glissade/scene/type` — `splitText()`: build-time split-text sub-targets
@@ -45,6 +45,7 @@ function splitText(source, opts = {}) {
 	if (id === void 0) throw new SplitTextError("splitText() needs a stable id — pass { id } or give the source Text an id (the parts bind tracks against ${id}/${i})");
 	const by = opts.by ?? "word";
 	const m = opts.measurer ?? text.measurerSource?.() ?? fallbackMeasurer();
+	warnIfEstimating(m, "splitText");
 	const font = {
 		fontFamily: text.fontFamily,
 		fontSize: text.fontSize(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/scene",
-  "version": "0.19.0-pre.2",
+  "version": "0.19.0-pre.3",
   "description": "glissade scene graph: nodes, transforms, DisplayList emission. Renderer-agnostic; zero DOM/Node dependencies.",
   "license": "Apache-2.0",
   "engines": {
@@ -35,7 +35,7 @@
   ],
   "dependencies": {
     "yoga-layout": "^3.2.1",
-    "@glissade/core": "0.19.0-pre.2"
+    "@glissade/core": "0.19.0-pre.3"
   },
   "repository": {
     "type": "git",