@glissade/scene 0.22.0 → 0.23.0-pre.1

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.22.0";
+const RAW_VERSION = "0.23.0-pre.1";
 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) {
@@ -297,6 +297,12 @@ const BUILDER_METHODS = [
 * IIFE. Copy is kept verbatim from `docs/discovery.md` so docs and manifest agree.
 */
 const HELPERS = [
+	{
+		name: "measureWrappedText",
+		summary: "Measure how a STRING wraps to a width — size a bubble/card to wrapped text WITHOUT a Text node or re-implementing line breaking (uses the renderer's own wrapper). For a Text NODE, use text.measuredSize(measurer)/lineBoxes(measurer)/wordBoxes(measurer) instead.",
+		import: "@glissade/scene",
+		usage: "scene.measureWrappedText(text, font, width, lineHeight = 1.25): { width, lines: string[], height, ascent, descent }  —  node-free; or measureWrappedText(text, font, width, lineHeight, measurer) standalone. width<=0 = no wrap (only explicit \\n). Text node analogue: text.measuredSize(measurer) -> { w, h }."
+	},
 	{
 		name: "createPlayer",
 		summary: "Build the transport object (play / pause / seek / rate / loop / marker + cue callbacks) directly — what mount() returns as mounted.player.",

package/dist/diagnostics.js

@@ -1,4 +1,4 @@
-import { G as collapseReplacer, V as createDisplayListBuilder, r as Group } from "./nodes.js";
+import { H as createDisplayListBuilder, K as collapseReplacer, r as Group } from "./nodes.js";
 import { a as evaluate } from "./scene.js";
 //#region src/displayDiff.ts
 /** A flat, stable JSON value for one command with its resource ids INLINED to content. */

package/dist/identity.js

@@ -1,4 +1,4 @@
-import { V as createDisplayListBuilder } from "./nodes.js";
+import { H as createDisplayListBuilder } from "./nodes.js";
 import { r as bindScene } from "./scene.js";
 import { evaluateAt } from "@glissade/core";
 //#region src/identity.ts

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 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 { t as collapseReplacer } from "./collapseReplacer.js";
-import { $ as segmentWords, A as resolveSketch, B as NodeConstructionError, C as Polyline, D as arcLength, E as SketchValidationError, F as AnchorSpec, G as TextMeasurer, H as PropInit, I as BindablePropTarget, J as breakLines, K as TextMetricsLite, L as EvalContext, M as sketchStrokes, N as validateHachure, O as flatten, P as validateSketch, Q as segmentGraphemes, R as HitArea, S as HachureSpec, T as SketchStyle, U as resolveAnchor, V as NodeProps, W as MEASURE_QUANTUM_PX, X as isEstimatingMeasurer, Y as estimatingMeasurer, Z as quantize, _ as WordBox, a as ImageNode, b as revealSchedule, c as Path, d as RevealMark, et as setDefaultMeasurer, 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 __resetEstimateWarnings, 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 quantize, A as resolveSketch, B as NodeConstructionError, C as Polyline, D as arcLength, E as SketchValidationError, F as AnchorSpec, G as TextMeasurer, H as PropInit, I as BindablePropTarget, J as __resetEstimateWarnings, K as TextMetricsLite, L as EvalContext, M as sketchStrokes, N as validateHachure, O as flatten, P as validateSketch, Q as measureWrappedText, R as HitArea, S as HachureSpec, T as SketchStyle, U as resolveAnchor, V as NodeProps, W as MEASURE_QUANTUM_PX, X as estimatingMeasurer, Y as breakLines, Z as isEstimatingMeasurer, _ as WordBox, a as ImageNode, b as revealSchedule, c as Path, d as RevealMark, et as segmentGraphemes, 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, nt as setDefaultMeasurer, o as ImageProps, p as Text, q as WrappedTextMetrics, r as GraphemeBox, s as LineBox, t as Circle, tt as segmentWords, u as Rect, v as coercePathData, w as ResolvedSketch, x as roundedRectSegs, y as pathFromSegs, z as Node } from "./nodes.js";
 import { a as SceneModule, c as evaluate, i as SceneInit, n as ReservedNodeIdError, o as bindScene, r as Scene, s as createScene, t as DuplicateNodeIdError } from "./scene.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, CoverageReport, EaseSpec, FontMode, FontUsage, MeshPaint as MeshPaint$1, Rng, Timeline, Track } from "@glissade/core";
@@ -619,4 +619,4 @@ declare function meshRasterSize(bw: number, bh: number): {
   h: number;
 };
 //#endregion
-export { ALL_FILTER_KINDS, type AnchorSpec, type BackendCaps, type BindablePropTarget, type BlendMode, type CanvasLike, Circle, ColdAssetError, type Ctx2DLike, Custom, DeterminismViolationError, type DisplayList, type DisplayListBuilder, 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 FilterKind, type FilterSpec, FilterValidationError, 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, NodeConstructionError, type NodeProps, type NodeTypeName, type Paint, Path, type PathLike, type PathProps, 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, type TypeEdit, type TypewriterResult, type ValidateSceneFontsOptions, Video, type VideoFrameSource, type VideoProps, type WordBox, __resetEstimateWarnings, applyToPoint, arcLength, bindScene, breakLines, coercePathData, collapseReplacer, collectLocalizedTextUsages, collectTextUsages, createDisplayListBuilder, createScene, drawOn, drawOnEach, each, estimatingMeasurer, evaluate, filtersToCanvasFilter, flatten, fontString, fromTRS, getLayoutEngine, glow, hachureLines, highlight, invert, isEstimatingMeasurer, matEquals, meshRasterSize, multiply, pathFromSegs, quantize, rasterizeMesh, requireLayoutEngine, resolveAnchor, resolveSketch, revealSchedule, roughen, roundedRectSegs, segmentGraphemes, segmentWords, setDefaultMeasurer, setLayoutEngine, sketchStrokes, textCursor, typewriter, validateFilters, validateHachure, validateSceneFonts, validateSketch, withDeterminismGuards };
+export { ALL_FILTER_KINDS, type AnchorSpec, type BackendCaps, type BindablePropTarget, type BlendMode, type CanvasLike, Circle, ColdAssetError, type Ctx2DLike, Custom, DeterminismViolationError, type DisplayList, type DisplayListBuilder, 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 FilterKind, type FilterSpec, FilterValidationError, 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, NodeConstructionError, type NodeProps, type NodeTypeName, type Paint, Path, type PathLike, type PathProps, 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, type TypeEdit, type TypewriterResult, type ValidateSceneFontsOptions, Video, type VideoFrameSource, type VideoProps, type WordBox, type WrappedTextMetrics, __resetEstimateWarnings, applyToPoint, arcLength, bindScene, breakLines, coercePathData, collapseReplacer, collectLocalizedTextUsages, collectTextUsages, createDisplayListBuilder, createScene, drawOn, drawOnEach, each, estimatingMeasurer, evaluate, filtersToCanvasFilter, flatten, fontString, fromTRS, getLayoutEngine, glow, hachureLines, highlight, invert, isEstimatingMeasurer, matEquals, measureWrappedText, meshRasterSize, multiply, pathFromSegs, quantize, rasterizeMesh, requireLayoutEngine, resolveAnchor, resolveSketch, revealSchedule, roughen, roundedRectSegs, segmentGraphemes, segmentWords, setDefaultMeasurer, setLayoutEngine, sketchStrokes, textCursor, typewriter, validateFilters, validateHachure, validateSceneFonts, validateSketch, withDeterminismGuards };

package/dist/index.js

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

package/dist/nodes.d.ts

@@ -1,5 +1,5 @@
 import { C as Mat2x3, a as FilterSpec, d as Paint, f as PathSeg, g as ShaderRef, r as DisplayListBuilder, s as FontSpec, t as BlendMode } from "./displayList.js";
-import { BindableSignal, PathValue, ReadonlySignal, Rng, Track, ValueTypeId, Vec2, Vec2Signal } from "@glissade/core";
+import { BindableSignal, FontAxes, PathValue, ReadonlySignal, Rng, Track, ValueTypeId, Vec2, Vec2Signal } from "@glissade/core";
 
 //#region src/text.d.ts
 
@@ -71,6 +71,31 @@ declare function segmentGraphemes(text: string): string[];
  * intra-word breaking in v1).
  */
 declare function breakLines(text: string, font: FontSpec, maxWidth: number | undefined, measurer: TextMeasurer): string[];
+/** Wrapped-text metrics: the box a string occupies when wrapped to `width`,
+ *  plus the laid-out lines — so a consumer can size a container (bubble/card)
+ *  to wrapped text WITHOUT a Text node or re-implementing line breaking. */
+interface WrappedTextMetrics {
+  /** Box width: the wrap `width` when wrapping, else the widest line's ink. */
+  width: number;
+  /** The wrapped lines (the SAME breaks the renderer draws — `breakLines`). */
+  lines: string[];
+  /** Box height: `quantize(fontSize * lineHeight) * lineCount` (the draw grid). */
+  height: number;
+  /** Max line ascent above the first baseline (font metric; for baseline align). */
+  ascent: number;
+  /** Max line descent below the baseline. */
+  descent: number;
+}
+/**
+ * Measure how `text` wraps to `width` with `font`, returning `{ width, lines,
+ * height, ascent, descent }` — the node-free analogue of `Text.measuredSize`/
+ * `lineBoxes`, for sizing a container to wrapped text. Reuses {@link breakLines}
+ * + the injected `measurer` (so breaks match what the rasterizer draws) — the
+ * exact `Text.intrinsicSize` steps. `width <= 0` = no wrap (only explicit '\n').
+ * `lineHeight` is a multiple of `font.size` (it lives on the Text node, not
+ * `FontSpec`, so it's a parameter here).
+ */
+declare function measureWrappedText(text: string, font: FontSpec, width: number, lineHeight: number, measurer: TextMeasurer): WrappedTextMetrics;
 //#endregion
 //#region src/node.d.ts
 /**
@@ -657,14 +682,23 @@ interface TextProps extends NodeProps {
    * `ctx.fontVariationSettings`) renders the axes; the browser DOM 2D context
    * has no such property, so axes are best-effort there (a guarded no-op, never
    * a throw). OMITTED when unset, so default Text emits a byte-identical
-   * FontSpec. Axes are STATIC only in 0.20 — **animatable** axes (a `wght`
-   * track, `opsz` driven by size, …) are deferred to 1.0 (an opaque CSS string
-   * isn't lerp-able); a track targeting `<id>/fontVariationSettings` hard-throws
-   * `UnboundTargetError` today (no property signal resolves to it). For a
-   * dynamic weight, use the discrete `fontWeight` named instances your font
-   * ships.
+   * FontSpec. This is the STATIC form (an opaque CSS string isn't lerp-able);
+   * to ANIMATE an axis (`wght`, `opsz`, …), use {@link fontAxes} instead — a
+   * structured, per-axis-interpolated map (0.23). When both are given, `fontAxes`
+   * (if non-empty) wins.
    */
   fontVariationSettings?: string;
+  /**
+   * Variable-font axes as a STRUCTURED, ANIMATABLE map — `{ wght: 700, opsz: 14 }`
+   * (0.23). Unlike the opaque {@link fontVariationSettings} string, this is a
+   * lerp-able value type (`fontAxes`): a track on `<id>/fontAxes` interpolates
+   * each axis per-frame, formatted to the CSS `font-variation-settings` string at
+   * draw (so backends are unchanged). Both keyframes of a track must declare the
+   * SAME axis tags (a mismatched set snaps + warns, like path/paint topology).
+   * Empty/unset ⇒ omitted, so default Text stays byte-identical. Track target
+   * `<id>/fontAxes`, value type `fontAxes`.
+   */
+  fontAxes?: PropInit<FontAxes>;
   /** Horizontal alignment about the node position; default 'left'. */
   align?: 'left' | 'center' | 'right';
   /** Wrap width in px; unset = no wrapping (explicit \n still breaks). */
@@ -711,6 +745,9 @@ declare class Text extends Node {
   readonly fontStyle: 'normal' | 'italic';
   /** Static variable-font axes (CSS `font-variation-settings`); undefined = none. */
   readonly fontVariationSettings: string | undefined;
+  /** Animatable variable-font axes (track target `<id>/fontAxes`); empty = none.
+   *  When non-empty, overrides {@link fontVariationSettings} in the FontSpec. */
+  readonly fontAxes: BindableSignal<FontAxes>;
   readonly align: 'left' | 'center' | 'right';
   readonly width: BindableSignal<number>;
   readonly lineHeight: number;
@@ -842,4 +879,4 @@ interface RevealMark {
  */
 declare function revealSchedule(text: Text, reveal: Track<number>, measurer?: TextMeasurer): RevealMark[];
 //#endregion
-export { segmentWords as $, resolveSketch as A, NodeConstructionError as B, Polyline as C, arcLength as D, SketchValidationError as E, AnchorSpec as F, TextMeasurer as G, PropInit as H, BindablePropTarget as I, breakLines as J, TextMetricsLite as K, EvalContext as L, sketchStrokes as M, validateHachure as N, flatten as O, validateSketch as P, segmentGraphemes as Q, HitArea as R, HachureSpec as S, SketchStyle as T, resolveAnchor as U, NodeProps as V, MEASURE_QUANTUM_PX as W, isEstimatingMeasurer as X, estimatingMeasurer as Y, quantize as Z, WordBox as _, ImageNode as a, revealSchedule as b, Path as c, RevealMark as d, setDefaultMeasurer as et, 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, __resetEstimateWarnings 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 { quantize as $, resolveSketch as A, NodeConstructionError as B, Polyline as C, arcLength as D, SketchValidationError as E, AnchorSpec as F, TextMeasurer as G, PropInit as H, BindablePropTarget as I, __resetEstimateWarnings as J, TextMetricsLite as K, EvalContext as L, sketchStrokes as M, validateHachure as N, flatten as O, validateSketch as P, measureWrappedText as Q, HitArea as R, HachureSpec as S, SketchStyle as T, resolveAnchor as U, NodeProps as V, MEASURE_QUANTUM_PX as W, estimatingMeasurer as X, breakLines as Y, isEstimatingMeasurer as Z, WordBox as _, ImageNode as a, revealSchedule as b, Path as c, RevealMark as d, segmentGraphemes as et, 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, setDefaultMeasurer as nt, ImageProps as o, Text as p, WrappedTextMetrics as q, GraphemeBox as r, LineBox as s, Circle as t, segmentWords as tt, Rect as u, coercePathData as v, ResolvedSketch as w, roundedRectSegs as x, pathFromSegs as y, Node as z };

package/dist/nodes.js

@@ -668,6 +668,35 @@ function breakLines(text, font, maxWidth, measurer) {
 	}
 	return lines;
 }
+/**
+* Measure how `text` wraps to `width` with `font`, returning `{ width, lines,
+* height, ascent, descent }` — the node-free analogue of `Text.measuredSize`/
+* `lineBoxes`, for sizing a container to wrapped text. Reuses {@link breakLines}
+* + the injected `measurer` (so breaks match what the rasterizer draws) — the
+* exact `Text.intrinsicSize` steps. `width <= 0` = no wrap (only explicit '\n').
+* `lineHeight` is a multiple of `font.size` (it lives on the Text node, not
+* `FontSpec`, so it's a parameter here).
+*/
+function measureWrappedText(text, font, width, lineHeight, measurer) {
+	const lines = breakLines(text, font, width > 0 ? width : void 0, measurer);
+	let widest = 0;
+	let ascent = 0;
+	let descent = 0;
+	for (const line of lines) {
+		const m = measurer.measureText(line, font);
+		const w = quantize(m.width);
+		if (w > widest) widest = w;
+		if (m.ascent > ascent) ascent = m.ascent;
+		if (m.descent > descent) descent = m.descent;
+	}
+	return {
+		width: width > 0 ? width : widest,
+		lines,
+		height: quantize(font.size * lineHeight) * lines.length,
+		ascent,
+		descent
+	};
+}
 //#endregion
 //#region src/constructionProps.ts
 /**
@@ -1815,6 +1844,12 @@ var Video = class Video extends Node {
 		});
 	}
 };
+/** Format a variable-font axis map → the CSS `font-variation-settings` string,
+*  `'"wght" 700, "opsz" 14'`. Axis tags are SORTED so the same axes always emit
+*  the same string regardless of insertion order — a deterministic FontSpec. */
+function formatFontAxes(axes) {
+	return Object.keys(axes).sort().map((tag) => `"${tag}" ${axes[tag]}`).join(", ");
+}
 var Text = class Text extends Node {
 	/** Taxonomy name pinned literally (survives IIFE minification — see {@link Group}). */
 	get describeType() {
@@ -1828,6 +1863,9 @@ var Text = class Text extends Node {
 	fontStyle;
 	/** Static variable-font axes (CSS `font-variation-settings`); undefined = none. */
 	fontVariationSettings;
+	/** Animatable variable-font axes (track target `<id>/fontAxes`); empty = none.
+	*  When non-empty, overrides {@link fontVariationSettings} in the FontSpec. */
+	fontAxes;
 	align;
 	width;
 	lineHeight;
@@ -1849,6 +1887,7 @@ var Text = class Text extends Node {
 		this.fontWeight = props.fontWeight ?? 400;
 		this.fontStyle = props.fontStyle ?? "normal";
 		this.fontVariationSettings = props.fontVariationSettings;
+		this.fontAxes = initProp(signal({}), props.fontAxes);
 		this.align = props.align ?? "left";
 		this.width = initProp(signal(0), props.width);
 		this.lineHeight = props.lineHeight ?? 1.25;
@@ -1861,6 +1900,7 @@ var Text = class Text extends Node {
 		this.registerTarget("fontSize", this.fontSize, "number");
 		this.registerTarget("reveal", this.reveal, "number");
 		this.registerTarget("revealFraction", this.revealFraction, "number");
+		this.registerTarget("fontAxes", this.fontAxes, "fontAxes");
 		if (new.target === Text) this.checkProps(props);
 	}
 	/**
@@ -1871,12 +1911,14 @@ var Text = class Text extends Node {
 	* golden corpus depends on it).
 	*/
 	fontSpec() {
+		const axes = this.fontAxes();
+		const fvs = Object.keys(axes).length > 0 ? formatFontAxes(axes) : this.fontVariationSettings;
 		return {
 			family: this.fontFamily,
 			size: this.fontSize(),
 			weight: this.fontWeight,
 			...this.fontStyle === "italic" ? { style: "italic" } : {},
-			...this.fontVariationSettings !== void 0 ? { fontVariationSettings: this.fontVariationSettings } : {},
+			...fvs !== void 0 ? { fontVariationSettings: fvs } : {},
 			...this.letterSpacing !== void 0 ? { letterSpacing: this.letterSpacing } : {}
 		};
 	}
@@ -2245,4 +2287,4 @@ function revealSchedule(text, reveal, measurer) {
 	return marks;
 }
 //#endregion
-export { SketchValidationError as A, FilterValidationError as B, fallbackMeasurer as C, segmentWords as D, segmentGraphemes as E, resolveSketch as F, collapseReplacer as G, filtersToCanvasFilter as H, roughen as I, fromTRS as J, IDENTITY as K, sketchStrokes as L, flatten as M, hachureLines as N, setDefaultMeasurer as O, hashStr as P, validateHachure as R, estimatingMeasurer as S, quantize as T, glow as U, createDisplayListBuilder as V, validateFilters as W, matEquals as X, invert as Y, multiply as Z, NODE_CONSTRUCTION_PROP_NAMES as _, Path as a, __resetEstimateWarnings as b, Video as c, revealSchedule as d, roundedRectSegs as f, BASE_CONSTRUCTION_PROP_NAMES as g, resolveAnchor as h, ImageNode as i, arcLength as j, warnIfEstimating as k, coercePathData as l, NodeConstructionError as m, Custom as n, Rect as o, Node as p, applyToPoint as q, Group as r, Text as s, Circle as t, pathFromSegs as u, isConstructionProp as v, isEstimatingMeasurer as w, breakLines as x, MEASURE_QUANTUM_PX as y, validateSketch as z };
+export { warnIfEstimating as A, validateSketch as B, fallbackMeasurer as C, segmentGraphemes as D, quantize as E, hashStr as F, validateFilters as G, createDisplayListBuilder as H, resolveSketch as I, applyToPoint as J, collapseReplacer as K, roughen as L, arcLength as M, flatten as N, segmentWords as O, hachureLines as P, multiply as Q, sketchStrokes as R, estimatingMeasurer as S, measureWrappedText as T, filtersToCanvasFilter as U, FilterValidationError as V, glow as W, invert as X, fromTRS as Y, matEquals as Z, NODE_CONSTRUCTION_PROP_NAMES as _, Path as a, __resetEstimateWarnings as b, Video as c, revealSchedule as d, roundedRectSegs as f, BASE_CONSTRUCTION_PROP_NAMES as g, resolveAnchor as h, ImageNode as i, SketchValidationError as j, setDefaultMeasurer as k, coercePathData as l, NodeConstructionError as m, Custom as n, Rect as o, Node as p, IDENTITY as q, Group as r, Text as s, Circle as t, pathFromSegs as u, isConstructionProp as v, isEstimatingMeasurer as w, breakLines as x, MEASURE_QUANTUM_PX as y, validateHachure as z };

package/dist/scene.d.ts

@@ -1,5 +1,5 @@
-import { n as DisplayList } from "./displayList.js";
-import { G as TextMeasurer, I as BindablePropTarget, i as Group, z as Node } from "./nodes.js";
+import { n as DisplayList, s as FontSpec } from "./displayList.js";
+import { G as TextMeasurer, I as BindablePropTarget, i as Group, q as WrappedTextMetrics, z as Node } from "./nodes.js";
 import { BoundTimeline, CompiledTimeline, Playhead, Timeline } from "@glissade/core";
 
 //#region src/scene.d.ts
@@ -20,6 +20,14 @@ interface Scene {
    */
   setTextMeasurer(measurer: TextMeasurer): void;
   readonly textMeasurer: TextMeasurer;
+  /**
+   * Measure how `text` wraps to `width` with `font`, using THIS scene's measurer
+   * — `{ width, lines, height, ascent, descent }`. Size a container (bubble/card)
+   * to wrapped text WITHOUT a Text node (the node-free analogue of
+   * `Text.measuredSize`/`lineBoxes`). `lineHeight` is a multiple of `font.size`,
+   * default 1.25.
+   */
+  measureWrappedText(text: string, font: FontSpec, width: number, lineHeight?: number): WrappedTextMetrics;
 }
 declare class DuplicateNodeIdError extends Error {
   constructor(id: string);

package/dist/scene.js

@@ -1,4 +1,4 @@
-import { C as fallbackMeasurer, V as createDisplayListBuilder, r as Group, v as isConstructionProp } from "./nodes.js";
+import { C as fallbackMeasurer, H as createDisplayListBuilder, T as measureWrappedText, r as Group, v as isConstructionProp } from "./nodes.js";
 import { bindTimeline, compileTimeline, createPlayhead, evaluateAt, signal } from "@glissade/core";
 //#region src/scene.ts
 /**
@@ -52,7 +52,8 @@ function createScene(init) {
 		},
 		get textMeasurer() {
 			return measurer.peek() ?? fallbackMeasurer();
-		}
+		},
+		measureWrappedText: (text, font, width, lineHeight = 1.25) => measureWrappedText(text, font, width, lineHeight, measurer.peek() ?? fallbackMeasurer())
 	};
 }
 const bindings = /* @__PURE__ */ new WeakMap();

package/dist/tokens.js

@@ -1,4 +1,4 @@
-import { K as IDENTITY, X as matEquals, f as roundedRectSegs, p as Node } from "./nodes.js";
+import { Z as matEquals, f as roundedRectSegs, p as Node, q as IDENTITY } from "./nodes.js";
 import { signal, vec2Signal } from "@glissade/core";
 //#region src/tokenHighlight.ts
 /**

package/dist/type.js

@@ -1,4 +1,4 @@
-import { C as fallbackMeasurer, T as quantize, k as warnIfEstimating, r as Group, s as Text } from "./nodes.js";
+import { A as warnIfEstimating, C as fallbackMeasurer, E as quantize, r as Group, s as Text } from "./nodes.js";
 //#region src/type.ts
 /**
 * `@glissade/scene/type` — `splitText()`: build-time split-text sub-targets

package/package.json

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