@glissade/scene 0.20.0 → 0.20.1

package/dist/describe.js

@@ -1,5 +1,4 @@
-import { a as Path, c as Video, i as ImageNode, o as Rect, r as Group, s as Text, t as Circle } from "./nodes.js";
-import { n as NODE_CONSTRUCTION_PROP_NAMES, t as BASE_CONSTRUCTION_PROP_NAMES } from "./constructionProps.js";
+import { _ as NODE_CONSTRUCTION_PROP_NAMES, a as Path, c as Video, g as BASE_CONSTRUCTION_PROP_NAMES, i as ImageNode, o as Rect, r as Group, s as Text, t as Circle } from "./nodes.js";
 import { easings, listValueTypes } from "@glissade/core";
 //#region src/describe.ts
 /**
@@ -23,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.20.0";
+const RAW_VERSION = "0.20.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) {
@@ -328,9 +327,9 @@ const HELPERS = [
 	},
 	{
 		name: "splitText",
-		summary: "Split a Text node into per-word / per-char parts you can animate individually (kinetic typography). Tree-shaken off the base scene index.",
+		summary: "Split a Text node into per-word / per-line / per-grapheme parts you can animate individually (kinetic typography). Pass { measurer } (or call setTextMeasurer first) so part geometry uses the real backend, not the estimating fallback. Tree-shaken off the base scene index.",
 		import: "@glissade/scene/type",
-		usage: "splitText(text: Text, opts?: { by?: 'word'|'char' }): Node[]"
+		usage: "splitText(text: Text | TextProps, opts?: { by?: 'word'|'line'|'grapheme', id?: string, measurer?: TextMeasurer }): { node: Group, children: Text[], parts: SplitPart[], targets(prop): string[] }"
 	},
 	{
 		name: "Grid",

package/dist/diagnostics.js

@@ -1,4 +1,4 @@
-import { L as createDisplayListBuilder, V as collapseReplacer, r as Group } from "./nodes.js";
+import { G as collapseReplacer, V as createDisplayListBuilder, 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/grid.d.ts

@@ -1,4 +1,4 @@
-import { B as NodeProps, i as Group, z as Node } from "./nodes.js";
+import { V as NodeProps, i as Group, z as Node } from "./nodes.js";
 
 //#region src/grid.d.ts
 

package/dist/identity.js

@@ -1,4 +1,4 @@
-import { L as createDisplayListBuilder } from "./nodes.js";
+import { V 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 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 { $ 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 { 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, 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, __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 };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { A as hashStr, B as validateFilters, C as segmentWords, D as arcLength, E as SketchValidationError, F as validateSketch, G as invert, H as IDENTITY, I as FilterValidationError, K as matEquals, L as createDisplayListBuilder, M as roughen, N as sketchStrokes, O as flatten, P as validateHachure, R as filtersToCanvasFilter, S as segmentGraphemes, U as applyToPoint, V as collapseReplacer, W as fromTRS, _ 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 multiply, r as Group, s as Text, t as Circle, u as pathFromSegs, v as estimatingMeasurer, w as setDefaultMeasurer, x as quantize, z as glow } from "./nodes.js";
+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 { 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";
@@ -1353,4 +1353,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, 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, 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/layoutCtors.d.ts

@@ -1,5 +1,5 @@
 import { r as DisplayListBuilder } from "./displayList.js";
-import { B as NodeProps, L as EvalContext, V as PropInit, W as TextMeasurer, i as Group, z as Node } from "./nodes.js";
+import { G as TextMeasurer, H as PropInit, L as EvalContext, V as NodeProps, i as Group, z as Node } from "./nodes.js";
 import { r as LayoutContainerSpec } from "./layoutEngine.js";
 import { BindableSignal } from "@glissade/core";
 

package/dist/layoutCtors.js

@@ -1,4 +1,4 @@
-import { r as Group, y as fallbackMeasurer } from "./nodes.js";
+import { C as fallbackMeasurer, r as Group } from "./nodes.js";
 import { r as requireLayoutEngine } from "./layoutEngine.js";
 import { computed, signal } from "@glissade/core";
 //#region src/layoutCtors.ts
@@ -30,7 +30,7 @@ import { computed, signal } from "@glissade/core";
 * BEFORE the flow — their dominant use is backgrounds. Flowed paint order is
 * zIndex-sorted; flow order is array order.
 */
-var Layout = class extends Group {
+var Layout = class Layout extends Group {
 	/** CLI/host detection marker — avoids importing this entry just to instanceof. */
 	static isLayoutNode = true;
 	/**
@@ -77,6 +77,7 @@ var Layout = class extends Group {
 		this.registerTarget("height", this.height, "number");
 		this.registerTarget("gap", this.gap, "number");
 		this.registerTarget("padding", this.padding, "number");
+		if (new.target === Layout) this.checkProps(props);
 	}
 	intrinsicSize(measurer) {
 		if (!this.autoWidth && !this.autoHeight) return {

package/dist/motion.d.ts

@@ -1,4 +1,4 @@
-import { B as NodeProps, V as PropInit, c as Path, z as Node } from "./nodes.js";
+import { H as PropInit, V as NodeProps, c as Path, z as Node } from "./nodes.js";
 import { BindableSignal, PathValue, Vec2 } from "@glissade/core";
 
 //#region src/motionPath.d.ts

package/dist/nodes.d.ts

@@ -150,6 +150,15 @@ type HitArea = {
   y: number;
   r: number;
 };
+/**
+ * Thrown by a node constructor when it's passed an unknown prop key (the
+ * construction-time sibling of the timeline builder's `TimelineValidationError`).
+ * Names the offending key(s), the node type, and the valid props. See
+ * {@link Node.checkProps}.
+ */
+declare class NodeConstructionError extends Error {
+  constructor(message: string);
+}
 declare abstract class Node {
   #private;
   readonly id: string | undefined;
@@ -221,6 +230,24 @@ declare abstract class Node {
     path: string;
     expects: ValueTypeId | readonly ValueTypeId[] | undefined;
   }[];
+  /**
+   * Fail-loud guard against UNKNOWN construction props — the sibling of the
+   * timeline builder's unknown-option guard (`to(…, { eaze })` throws). Without
+   * it a node silently drops a misnamed prop: `new Rect({ size:[80,80] })` keeps
+   * width/height at 0 → an invisible node, no warning (a real footgun the docs
+   * even shipped). Each BUILT-IN node calls this at the END of its constructor,
+   * guarded by `new.target === <ThisClass>` so it runs ONLY for the exact leaf
+   * type (an intermediate base like `Group` skips it when a `Layout` is being
+   * constructed — `Layout` validates itself with its own fuller target set; and
+   * user `Custom`/external subclasses, whose `new.target` matches no built-in,
+   * are never validated, keeping that extension seam lenient).
+   *
+   * The allow-list is {@link acceptedConstructionKeys} — built from the live
+   * `registerTarget` set + the construction-prop name sets, so it can't drift
+   * from what the constructors actually honor. Must be called after the leaf has
+   * registered all its targets (i.e. last), so the animatable keys are present.
+   */
+  protected checkProps(props: object): void;
   /** Subclass drawing: emit own commands (and children for containers). */
   protected abstract draw(out: DisplayListBuilder, ctx: EvalContext): void;
   /**
@@ -795,4 +822,4 @@ interface RevealMark {
  */
 declare function revealSchedule(text: Text, reveal: Track<number>, measurer?: TextMeasurer): RevealMark[];
 //#endregion
-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 };
+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 };

package/dist/nodes.js

@@ -669,6 +669,125 @@ function breakLines(text, font, maxWidth, measurer) {
 	return lines;
 }
 //#endregion
+//#region src/constructionProps.ts
+/**
+* The SLIM construction-prop NAME set (0.20) — the embed-path-safe half of the
+* describe() schema. A construction prop (`animatable: false`) is passed to a
+* node's constructor and is NEVER a track target; binding one is rejected.
+*
+* This module carries ONLY the per-node-type set of construction-prop NAMES
+* (plus the shared base set), nothing else — no value types, no `required`
+* flags, no manifest scaffolding. That keeps it tiny: it rides on the
+* embed/bind path (the bind guard imports it to turn a generic UnboundTarget
+* into a friendlier "that's a construction prop" message), so it must stay
+* byte-cheap. `describe.ts` imports the SAME sets and layers its richer
+* per-prop metadata (type/required) on top, so the manifest and this lookup
+* can't drift.
+*/
+/**
+* Base `NodeProps` construction-prop names shared by EVERY node — set once at
+* `new Node({...})`, never animatable (none is a registered target).
+*/
+const BASE_CONSTRUCTION_PROP_NAMES = [
+	"id",
+	"blend",
+	"filters",
+	"anchor",
+	"cache"
+];
+/**
+* Each built-in node's OWN construction-prop names (the base set is merged in
+* separately, via {@link isConstructionProp}). Keyed by the describe TYPE NAME
+* (e.g. `Image`, not the `ImageNode` class name).
+*/
+const SKETCH = [
+	"sketch",
+	"sketchFill",
+	"sketchSeed"
+];
+const LAYOUT = [
+	"direction",
+	"justify",
+	"align",
+	"children"
+];
+const NODE_CONSTRUCTION_PROP_NAMES = {
+	Group: ["children"],
+	Rect: SKETCH,
+	Circle: SKETCH,
+	Path: SKETCH,
+	Text: [
+		"fontFamily",
+		"fontWeight",
+		"fontStyle",
+		"align",
+		"lineHeight",
+		"fontVariationSettings"
+	],
+	Image: ["assetId"],
+	Video: [
+		"assetId",
+		"at",
+		"trimStart",
+		"playbackRate",
+		"clipDuration",
+		"sourceFps"
+	],
+	Layout: LAYOUT,
+	Stack: LAYOUT,
+	Row: LAYOUT,
+	Column: LAYOUT
+};
+/**
+* Is `prop` a KNOWN construction-only prop for a node of describe-type
+* `typeName`? True for the shared base set or that type's own set. Used by the
+* bind guard to special-case the unbound-target error: a construction prop gets
+* a "set it at construction" message instead of the generic one.
+*/
+function isConstructionProp(typeName, prop) {
+	if (BASE_CONSTRUCTION_PROP_NAMES.includes(prop)) return true;
+	const own = NODE_CONSTRUCTION_PROP_NAMES[typeName];
+	return own !== void 0 && own.includes(prop);
+}
+/**
+* Construction keys that are NEITHER a construction-prop name NOR the same-named
+* animatable target — so the `acceptedConstructionKeys` union below would miss
+* them and the constructor guard would false-positive. Today this is ONLY
+* `Path`: you construct it with `{ data }`, but its animatable target is
+* registered as `d` (so `d` is in the target set, `data` is in neither). Without
+* this alias `new Path({ data })` would wrongly throw.
+*/
+const CONSTRUCTION_KEY_ALIASES = { Path: ["data"] };
+/**
+* The FULL set of prop keys a node of describe-type `typeName` accepts at
+* CONSTRUCTION — the allow-list the node constructor guard ({@link Node.checkProps})
+* validates incoming `props` against, so an unknown key throws instead of being
+* silently dropped (the `new Rect({ size:[…] })` → invisible-box footgun).
+*
+* It's the union of three drift-free sources, so it can never disagree with what
+* the constructors actually honor:
+*  - the shared base construction props + this type's own construction props
+*    (the SAME name sets `describe()` and the bind guard read);
+*  - the **un-dotted** names of this node's registered animatable targets
+*    (`targetPaths` — the live `registerTarget` set; animatable props are settable
+*    at construction too). A dotted sub-path like `position.x` collapses to its
+*    head `position`: the dotted form is a TWEEN target (`to('id/position.x', …)`),
+*    never a constructor key, so it is correctly NOT accepted at construction;
+*  - the per-type construction-key aliases above (Path's `data`).
+*/
+function acceptedConstructionKeys(typeName, targetPaths) {
+	const keys = new Set(BASE_CONSTRUCTION_PROP_NAMES);
+	const own = NODE_CONSTRUCTION_PROP_NAMES[typeName];
+	if (own !== void 0) for (const k of own) keys.add(k);
+	const alias = CONSTRUCTION_KEY_ALIASES[typeName];
+	if (alias !== void 0) for (const k of alias) keys.add(k);
+	for (const path of targetPaths) {
+		const dot = path.indexOf(".");
+		keys.add(dot === -1 ? path : path.slice(0, dot));
+	}
+	return keys;
+}
+//#endregion
 //#region src/node.ts
 /**
 * Scene-graph node base (DESIGN.md §3.1): every animatable property is a
@@ -704,6 +823,18 @@ function initVec2(sig, init) {
 	else if (init !== void 0) sig.set(init);
 	return sig;
 }
+/**
+* Thrown by a node constructor when it's passed an unknown prop key (the
+* construction-time sibling of the timeline builder's `TimelineValidationError`).
+* Names the offending key(s), the node type, and the valid props. See
+* {@link Node.checkProps}.
+*/
+var NodeConstructionError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "NodeConstructionError";
+	}
+};
 var Node = class {
 	id;
 	position;
@@ -817,6 +948,32 @@ var Node = class {
 		}));
 	}
 	/**
+	* Fail-loud guard against UNKNOWN construction props — the sibling of the
+	* timeline builder's unknown-option guard (`to(…, { eaze })` throws). Without
+	* it a node silently drops a misnamed prop: `new Rect({ size:[80,80] })` keeps
+	* width/height at 0 → an invisible node, no warning (a real footgun the docs
+	* even shipped). Each BUILT-IN node calls this at the END of its constructor,
+	* guarded by `new.target === <ThisClass>` so it runs ONLY for the exact leaf
+	* type (an intermediate base like `Group` skips it when a `Layout` is being
+	* constructed — `Layout` validates itself with its own fuller target set; and
+	* user `Custom`/external subclasses, whose `new.target` matches no built-in,
+	* are never validated, keeping that extension seam lenient).
+	*
+	* The allow-list is {@link acceptedConstructionKeys} — built from the live
+	* `registerTarget` set + the construction-prop name sets, so it can't drift
+	* from what the constructors actually honor. Must be called after the leaf has
+	* registered all its targets (i.e. last), so the animatable keys are present.
+	*/
+	checkProps(props) {
+		const accepted = acceptedConstructionKeys(this.describeType, this.targets.keys());
+		let unknown;
+		for (const k of Object.keys(props)) if (!accepted.has(k)) (unknown ??= []).push(k);
+		if (unknown !== void 0) {
+			const valid = [...accepted].sort().join(", ");
+			throw new NodeConstructionError(`new ${this.describeType}({ … }): unknown construction ${unknown.length > 1 ? "props" : "prop"} ${unknown.map((k) => `'${k}'`).join(", ")}. Valid ${this.describeType} props: ${valid}. (Animatable sub-paths like 'position.x' are timeline targets — to('<id>/position.x', …) — not construction keys; set the whole 'position' at construction.)`);
+		}
+	}
+	/**
 	* Natural size for flex flow (§3.2); null = not flowable (a Layout parent
 	* emits such children absolutely, untouched).
 	*/
@@ -1034,7 +1191,7 @@ function roundedRectSegs(x, y, w, h, r) {
 		["Z"]
 	];
 }
-var Group = class extends Node {
+var Group = class Group extends Node {
 	/**
 	* Taxonomy name pinned as a STRING LITERAL (not the inherited
 	* `constructor.name`): the minified `@glissade/browser` IIFE mangles class
@@ -1057,6 +1214,7 @@ var Group = class extends Node {
 		super(props);
 		this.children = props.children ?? [];
 		for (const child of this.children) child.parent = this;
+		if (new.target === Group) this.checkProps(props);
 	}
 	/** Record the structural version as a dependency — call inside a computed
 	* that walks `children` so add()/remove() invalidate it. */
@@ -1368,7 +1526,7 @@ function pathFromSegs(segs) {
 	}
 	return contours;
 }
-var Rect = class extends Shape {
+var Rect = class Rect extends Shape {
 	/** Taxonomy name pinned literally (survives IIFE minification — see {@link Group}). */
 	get describeType() {
 		return "Rect";
@@ -1385,6 +1543,7 @@ var Rect = class extends Shape {
 		this.registerTarget("width", this.width, "number");
 		this.registerTarget("height", this.height, "number");
 		this.registerTarget("cornerRadius", this.cornerRadius, "number");
+		if (new.target === Rect) this.checkProps(props);
 	}
 	intrinsicSize() {
 		return {
@@ -1399,7 +1558,7 @@ var Rect = class extends Shape {
 		return roundedRectSegs(-w / 2, -h / 2, w, h, r);
 	}
 };
-var Circle = class extends Shape {
+var Circle = class Circle extends Shape {
 	/** Taxonomy name pinned literally (survives IIFE minification — see {@link Group}). */
 	get describeType() {
 		return "Circle";
@@ -1409,6 +1568,7 @@ var Circle = class extends Shape {
 		super(props);
 		this.radius = initProp(signal(0), props.radius);
 		this.registerTarget("radius", this.radius, "number");
+		if (new.target === Circle) this.checkProps(props);
 	}
 	intrinsicSize() {
 		const d = this.radius() * 2;
@@ -1436,7 +1596,7 @@ var Circle = class extends Shape {
 * of native path morphs. Coordinates are node-local (the node origin is
 * wherever the author put 0,0); flow placement uses the control-point bounds.
 */
-var Path = class extends Shape {
+var Path = class Path extends Shape {
 	/** Taxonomy name pinned literally (survives IIFE minification — see {@link Group}). */
 	get describeType() {
 		return "Path";
@@ -1448,6 +1608,7 @@ var Path = class extends Shape {
 		const coerced = typeof init === "function" ? () => coercePathData(init()) : init !== void 0 ? coercePathData(init) : void 0;
 		this.data = initProp(signal([]), coerced);
 		this.registerTarget("d", this.data, "path");
+		if (new.target === Path) this.checkProps(props);
 	}
 	/** Control-point bounding box (conservative: contains the true curve). */
 	bounds() {
@@ -1533,7 +1694,7 @@ var Path = class extends Shape {
 		return segs;
 	}
 };
-var ImageNode = class extends Node {
+var ImageNode = class ImageNode extends Node {
 	/** Marks this node as referencing a kind 'image' timeline asset (§2.3). */
 	static assetKind = "image";
 	/** Public taxonomy name is `Image` (the class is `ImageNode`). */
@@ -1550,6 +1711,7 @@ var ImageNode = class extends Node {
 		this.height = initProp(signal(0), props.height);
 		this.registerTarget("width", this.width, "number");
 		this.registerTarget("height", this.height, "number");
+		if (new.target === ImageNode) this.checkProps(props);
 	}
 	intrinsicSize() {
 		return {
@@ -1582,7 +1744,7 @@ var ImageNode = class extends Node {
 * frame-indexed media-time arithmetic — mediaT = trimStart + (t - at) * rate —
 * and references the exact source-grid frame; backends resolve it.
 */
-var Video = class extends Node {
+var Video = class Video extends Node {
 	/** Marks this node as referencing a kind 'video' timeline asset (§3.8). */
 	static assetKind = "video";
 	/** Taxonomy name pinned literally (survives IIFE minification — see {@link Group}). */
@@ -1609,6 +1771,7 @@ var Video = class extends Node {
 		this.height = initProp(signal(0), props.height);
 		this.registerTarget("width", this.width, "number");
 		this.registerTarget("height", this.height, "number");
+		if (new.target === Video) this.checkProps(props);
 	}
 	/** Frame-indexed media time for timeline time t; null when outside the clip. */
 	mediaTime(t) {
@@ -1642,7 +1805,7 @@ var Video = class extends Node {
 		});
 	}
 };
-var Text = class extends Node {
+var Text = class Text extends Node {
 	/** Taxonomy name pinned literally (survives IIFE minification — see {@link Group}). */
 	get describeType() {
 		return "Text";
@@ -1685,6 +1848,7 @@ var Text = class extends Node {
 		this.registerTarget("fontSize", this.fontSize, "number");
 		this.registerTarget("reveal", this.reveal, "number");
 		this.registerTarget("revealFraction", this.revealFraction, "number");
+		if (new.target === Text) this.checkProps(props);
 	}
 	/**
 	* The per-draw {@link FontSpec} — the single construction point every measure
@@ -2067,4 +2231,4 @@ function revealSchedule(text, reveal, measurer) {
 	return marks;
 }
 //#endregion
-export { hashStr as A, validateFilters as B, segmentWords as C, arcLength as D, SketchValidationError as E, validateSketch as F, invert as G, IDENTITY as H, FilterValidationError as I, matEquals as K, createDisplayListBuilder as L, roughen as M, sketchStrokes as N, flatten as O, validateHachure as P, filtersToCanvasFilter as R, segmentGraphemes as S, warnIfEstimating as T, applyToPoint as U, collapseReplacer as V, fromTRS as W, 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, multiply 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 };
+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 };

package/dist/scene.d.ts

@@ -1,5 +1,5 @@
 import { n as DisplayList } from "./displayList.js";
-import { I as BindablePropTarget, W as TextMeasurer, i as Group, z as Node } from "./nodes.js";
+import { G as TextMeasurer, I as BindablePropTarget, i as Group, z as Node } from "./nodes.js";
 import { BoundTimeline, CompiledTimeline, Playhead, Timeline } from "@glissade/core";
 
 //#region src/scene.d.ts

package/dist/scene.js

@@ -1,5 +1,4 @@
-import { L as createDisplayListBuilder, r as Group, y as fallbackMeasurer } from "./nodes.js";
-import { r as isConstructionProp } from "./constructionProps.js";
+import { C as fallbackMeasurer, V as createDisplayListBuilder, r as Group, v as isConstructionProp } from "./nodes.js";
 import { bindTimeline, compileTimeline, createPlayhead, evaluateAt, signal } from "@glissade/core";
 //#region src/scene.ts
 /**

package/dist/tokens.d.ts

@@ -1,5 +1,5 @@
 import { r as DisplayListBuilder } from "./displayList.js";
-import { B as NodeProps, L as EvalContext, V as PropInit, _ as WordBox, p as Text, z as Node } from "./nodes.js";
+import { H as PropInit, L as EvalContext, V as NodeProps, _ as WordBox, p as Text, z as Node } from "./nodes.js";
 import { Vec2 } from "@glissade/core";
 
 //#region src/tokenHighlight.d.ts

package/dist/tokens.js

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

package/dist/type.d.ts

@@ -1,4 +1,4 @@
-import { W as TextMeasurer, _ as WordBox, i as Group, m as TextProps, p as Text, r as GraphemeBox, s as LineBox } from "./nodes.js";
+import { G as TextMeasurer, _ as WordBox, i as Group, m as TextProps, p as Text, r as GraphemeBox, s as LineBox } from "./nodes.js";
 
 //#region src/type.d.ts
 

package/dist/type.js

@@ -1,4 +1,4 @@
-import { T as warnIfEstimating, r as Group, s as Text, x as quantize, y as fallbackMeasurer } from "./nodes.js";
+import { C as fallbackMeasurer, T as quantize, k as warnIfEstimating, r as Group, s as Text } from "./nodes.js";
 //#region src/type.ts
 /**
 * `@glissade/scene/type` — `splitText()`: build-time split-text sub-targets
@@ -46,6 +46,11 @@ function splitText(source, opts = {}) {
 	const id = opts.id ?? text.id;
 	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";
+	if (![
+		"word",
+		"line",
+		"grapheme"
+	].includes(by)) throw new SplitTextError(`splitText() got an unknown { by: ${JSON.stringify(by)} } — valid values are 'word', 'line', 'grapheme'.`);
 	const m = opts.measurer ?? text.measurerSource?.() ?? fallbackMeasurer();
 	warnIfEstimating(m, "splitText");
 	const font = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/scene",
-  "version": "0.20.0",
+  "version": "0.20.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.20.0"
+    "@glissade/core": "0.20.1"
   },
   "repository": {
     "type": "git",

package/dist/constructionProps.js

@@ -1,82 +0,0 @@
-//#region src/constructionProps.ts
-/**
-* The SLIM construction-prop NAME set (0.20) — the embed-path-safe half of the
-* describe() schema. A construction prop (`animatable: false`) is passed to a
-* node's constructor and is NEVER a track target; binding one is rejected.
-*
-* This module carries ONLY the per-node-type set of construction-prop NAMES
-* (plus the shared base set), nothing else — no value types, no `required`
-* flags, no manifest scaffolding. That keeps it tiny: it rides on the
-* embed/bind path (the bind guard imports it to turn a generic UnboundTarget
-* into a friendlier "that's a construction prop" message), so it must stay
-* byte-cheap. `describe.ts` imports the SAME sets and layers its richer
-* per-prop metadata (type/required) on top, so the manifest and this lookup
-* can't drift.
-*/
-/**
-* Base `NodeProps` construction-prop names shared by EVERY node — set once at
-* `new Node({...})`, never animatable (none is a registered target).
-*/
-const BASE_CONSTRUCTION_PROP_NAMES = [
-	"id",
-	"blend",
-	"filters",
-	"anchor",
-	"cache"
-];
-/**
-* Each built-in node's OWN construction-prop names (the base set is merged in
-* separately, via {@link isConstructionProp}). Keyed by the describe TYPE NAME
-* (e.g. `Image`, not the `ImageNode` class name).
-*/
-const SKETCH = [
-	"sketch",
-	"sketchFill",
-	"sketchSeed"
-];
-const LAYOUT = [
-	"direction",
-	"justify",
-	"align",
-	"children"
-];
-const NODE_CONSTRUCTION_PROP_NAMES = {
-	Group: ["children"],
-	Rect: SKETCH,
-	Circle: SKETCH,
-	Path: SKETCH,
-	Text: [
-		"fontFamily",
-		"fontWeight",
-		"fontStyle",
-		"align",
-		"lineHeight",
-		"fontVariationSettings"
-	],
-	Image: ["assetId"],
-	Video: [
-		"assetId",
-		"at",
-		"trimStart",
-		"playbackRate",
-		"clipDuration",
-		"sourceFps"
-	],
-	Layout: LAYOUT,
-	Stack: LAYOUT,
-	Row: LAYOUT,
-	Column: LAYOUT
-};
-/**
-* Is `prop` a KNOWN construction-only prop for a node of describe-type
-* `typeName`? True for the shared base set or that type's own set. Used by the
-* bind guard to special-case the unbound-target error: a construction prop gets
-* a "set it at construction" message instead of the generic one.
-*/
-function isConstructionProp(typeName, prop) {
-	if (BASE_CONSTRUCTION_PROP_NAMES.includes(prop)) return true;
-	const own = NODE_CONSTRUCTION_PROP_NAMES[typeName];
-	return own !== void 0 && own.includes(prop);
-}
-//#endregion
-export { NODE_CONSTRUCTION_PROP_NAMES as n, isConstructionProp as r, BASE_CONSTRUCTION_PROP_NAMES as t };