@glissade/scene 0.13.0 → 0.14.0-pre.1

package/dist/index.d.ts

@@ -653,6 +653,15 @@ declare function tokenHighlight(text: Text, props: Omit<TokenHighlightProps, 'te
 //#region src/fontUsage.d.ts
 /** Walk `scene` for Text nodes; one usage per node carrying its full text. */
 declare function collectTextUsages(scene: Scene): FontUsage[];
+/**
+ * Collect font usages from the POST-localize document's STRING tracks (FIX 3,
+ * 0.14 canary). For every `'string'` track whose target node is a Text node,
+ * emit one usage per distinct localized KEY VALUE under that node's fontFamily —
+ * so a localized CJK message bound to a Latin-only font surfaces as an uncovered
+ * glyph. `collectTextUsages` only sees the authored BASE `node.text()`, which is
+ * resolved BEFORE the localized string tracks bind, so it misses this.
+ */
+declare function collectLocalizedTextUsages(scene: Scene, doc: Timeline): FontUsage[];
 /**
  * Caller-supplied I/O: fetch the raw bytes for a font face URL (the export
  * paths read a file / fetch a URL; this keeps core pure). Returning undefined
@@ -664,6 +673,13 @@ interface ValidateSceneFontsOptions {
   mode?: FontMode;
   /** OS-installed families to treat as registered (case-insensitive). */
   osFamilies?: ReadonlySet<string> | undefined;
+  /**
+   * Additional usages to validate alongside the scene's authored Text (FIX 3):
+   * the POST-localize document's localized string-track values, which the
+   * scene-walk can't see (they bind AFTER `node.text()` is read). Build them
+   * with `collectLocalizedTextUsages(scene, localizedDoc)`.
+   */
+  extraUsages?: readonly FontUsage[] | undefined;
 }
 /**
  * Run §3.6 font validation for a scene + its timeline document. Builds the
@@ -876,4 +892,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, 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, collapseReplacer, 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, 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, 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 };

package/dist/index.js

@@ -48,8 +48,8 @@ var Highlight = class extends Node {
 		this.progress = init$2(signal(1), props.progress);
 		this.padding = props.padding ?? [4, 2];
 		this.cornerRadius = props.cornerRadius ?? 4;
-		this.registerTarget("progress", this.progress);
-		this.registerTarget("color", this.color);
+		this.registerTarget("progress", this.progress, "number");
+		this.registerTarget("color", this.color, "color");
 	}
 	draw(out, ctx) {
 		const progress = Math.min(1, Math.max(0, this.progress()));
@@ -132,7 +132,7 @@ var TextCursor = class extends Node {
 		this.solidWhileTyping = props.solidWhileTyping ?? true;
 		this.caretWidth = props.width ?? 2;
 		this.fill = init$1(signal(""), props.fill);
-		this.registerTarget("fill", this.fill);
+		this.registerTarget("fill", this.fill, "color");
 	}
 	draw(out, ctx) {
 		const head = this.target.revealHead(ctx.measurer);
@@ -288,6 +288,14 @@ function mix(seed, i) {
 	h = Math.imul(h ^ h >>> 15, 1935289751);
 	return (h ^ h >>> 15) >>> 0;
 }
+/**
+* Salt folded into the motion-jitter seed so the per-index jitter rng
+* decorrelates from `ctx.rng` (the factory rng). Both axes derive from
+* `mix(baseSeed, i)`; without a distinct salt they would be the SAME stream,
+* so a factory that draws from `ctx.rng` and a `jitter` callback would see
+* correlated "independent" randomness. An arbitrary fixed odd constant.
+*/
+const JITTER_SALT = 1779033703;
 /** Resolve a built-in layout (or call the escape-hatch fn) to a fraction. */
 function placeAt(layout, i, n) {
 	if (typeof layout === "function") return layout(i, n);
@@ -394,7 +402,7 @@ function each(n, factory, opts) {
 		const start = m.startSec ?? 0;
 		const at = staggerFn(m, n);
 		for (let i = 0; i < n; i++) {
-			const rngI = random(mix(baseSeed, i));
+			const rngI = random(mix(mix(baseSeed, i), JITTER_SALT));
 			const overrides = m.jitter?.(i, rngI, n);
 			const applyOpts = {
 				...overrides !== void 0 ? { overrides } : {},
@@ -815,7 +823,7 @@ var FollowPath = class extends Node {
 		this.progress = signal(1);
 		if (typeof props.progress === "function") this.progress.bindSource(props.progress);
 		else if (props.progress !== void 0) this.progress.set(props.progress);
-		this.registerTarget("progress", this.progress);
+		this.registerTarget("progress", this.progress, "number");
 		const sOpts = props.samplesPerSegment !== void 0 ? { samplesPerSegment: props.samplesPerSegment } : {};
 		const getPath = props.path instanceof Path ? () => props.path.data() : () => props.path;
 		let cachedPath = getPath();
@@ -919,13 +927,13 @@ var TokenHighlight = class extends Node {
 				run,
 				bound: runText(boxes, run)
 			};
-			this.registerTarget(`${id}/fill`, r.fill);
-			this.registerTarget(`${id}/opacity`, r.opacity);
-			this.registerTarget(`${id}/progress`, r.progress);
-			this.registerTarget(`${id}/scale`, r.scale);
-			this.registerTarget(`${id}/offset`, r.offset);
-			this.registerTarget(`${id}/offset.x`, r.offset.x);
-			this.registerTarget(`${id}/offset.y`, r.offset.y);
+			this.registerTarget(`${id}/fill`, r.fill, "color");
+			this.registerTarget(`${id}/opacity`, r.opacity, "number");
+			this.registerTarget(`${id}/progress`, r.progress, "number");
+			this.registerTarget(`${id}/scale`, r.scale, "number");
+			this.registerTarget(`${id}/offset`, r.offset, ["vec2", "vec2-arc"]);
+			this.registerTarget(`${id}/offset.x`, r.offset.x, "number");
+			this.registerTarget(`${id}/offset.y`, r.offset.y, "number");
 			return r;
 		});
 	}
@@ -1065,6 +1073,35 @@ function collectTextUsages(scene) {
 	visit(scene.root);
 	return out;
 }
+/** The node-id of a track target ('<nodeId>/<prop.path>' → '<nodeId>'). */
+function nodeIdOf(target) {
+	const slash = target.indexOf("/");
+	return slash >= 0 ? target.slice(0, slash) : target;
+}
+/**
+* Collect font usages from the POST-localize document's STRING tracks (FIX 3,
+* 0.14 canary). For every `'string'` track whose target node is a Text node,
+* emit one usage per distinct localized KEY VALUE under that node's fontFamily —
+* so a localized CJK message bound to a Latin-only font surfaces as an uncovered
+* glyph. `collectTextUsages` only sees the authored BASE `node.text()`, which is
+* resolved BEFORE the localized string tracks bind, so it misses this.
+*/
+function collectLocalizedTextUsages(scene, doc) {
+	const out = [];
+	for (const tr of doc.tracks) {
+		if (tr.type !== "string") continue;
+		const node = scene.nodes.get(nodeIdOf(tr.target));
+		if (!(node instanceof Text)) continue;
+		for (const k of tr.keys) {
+			const value = k.value;
+			if (typeof value === "string" && value) out.push({
+				family: node.fontFamily,
+				text: value
+			});
+		}
+	}
+	return out;
+}
 /**
 * Run §3.6 font validation for a scene + its timeline document. Builds the
 * registry from `doc.assets`, loads each registered face's cmap via `loadBytes`
@@ -1074,7 +1111,7 @@ function collectTextUsages(scene) {
 async function validateSceneFonts(scene, doc, loadBytes, options = {}) {
 	const mode = options.mode ?? "dev";
 	const registry = buildFontRegistry(doc.assets);
-	const usages = collectTextUsages(scene);
+	const usages = [...collectTextUsages(scene), ...options.extraUsages ?? []];
 	const wanted = /* @__PURE__ */ new Set();
 	for (const u of usages) if (registry.has(u.family)) for (const f of registry.fallbackChain(u.family)) wanted.add(f);
 	const cmaps = /* @__PURE__ */ new Map();
@@ -1121,7 +1158,7 @@ var ShaderEffect = class extends Group {
 		for (const [name, value] of Object.entries(props.uniforms ?? {})) {
 			const sig = signal(value);
 			map.set(name, sig);
-			this.registerTarget(`u.${name}`, sig);
+			this.registerTarget(`u.${name}`, sig, "number");
 		}
 		this.uniformSignals = map;
 	}
@@ -1813,4 +1850,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, collapseReplacer, 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, applyToPoint, arcLength, auditCacheCold, bindScene, breakLines, 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 };

package/dist/layout.js

@@ -53,10 +53,10 @@ var Layout = class extends Group {
 		this.direction = props.direction ?? "row";
 		this.justify = props.justify ?? "start";
 		this.align = props.align ?? "center";
-		this.registerTarget("width", this.width);
-		this.registerTarget("height", this.height);
-		this.registerTarget("gap", this.gap);
-		this.registerTarget("padding", this.padding);
+		this.registerTarget("width", this.width, "number");
+		this.registerTarget("height", this.height, "number");
+		this.registerTarget("gap", this.gap, "number");
+		this.registerTarget("padding", this.padding, "number");
 	}
 	intrinsicSize(measurer) {
 		if (!this.autoWidth && !this.autoHeight) return {

package/dist/layoutEngine.d.ts

@@ -1,4 +1,4 @@
-import { BindableSignal, MeshInterpolation, MeshPaint as MeshPaint$1, MeshPoint, Paint, PathValue, ReadonlySignal, Rng, Track, Vec2, Vec2Signal } from "@glissade/core";
+import { BindableSignal, MeshInterpolation, MeshPaint as MeshPaint$1, MeshPoint, Paint, PathValue, ReadonlySignal, Rng, Track, ValueTypeId, Vec2, Vec2Signal } from "@glissade/core";
 
 //#region src/matrix.d.ts
 
@@ -297,6 +297,13 @@ interface NodeProps {
 interface BindablePropTarget {
   bindSource(fn: () => unknown): void;
   unbindSource(): void;
+  /**
+   * The value type(s) this prop accepts — bindTimeline hard-throws a mismatched
+   * track (§2.2). An array for a polymorphic prop (a Shape `fill` is color|paint,
+   * a vec2 prop is vec2|vec2-arc). UNDEFINED for an untagged target (the 2-arg
+   * registerTarget form): bindTimeline skips the guard (0.13 back-compat seam).
+   */
+  readonly expects: ValueTypeId | readonly ValueTypeId[] | undefined;
 }
 /** Node-local hit-shape override (v2 §C.3) — fat targets for thin strokes. */
 type HitArea = {
@@ -345,7 +352,22 @@ declare abstract class Node {
   /** Track-target paths → bindable signals; subclasses register their own props. */
   protected readonly targets: Map<string, BindablePropTarget>;
   constructor(props?: NodeProps);
-  protected registerTarget(path: string, sig: BindablePropTarget): void;
+  /**
+   * Register a track-target path → bindable signal, stamping the value type the
+   * signal accepts (§2.2). The stamp is what bindTimeline's bind-time guard
+   * reads to reject a mismatched track (a scalar on a vec2, a number on a paint
+   * prop, …) instead of silently sampling to NaN/undefined.
+   *
+   * `expects` is OPTIONAL: omitting it (the 2-arg form) leaves the target
+   * UNtagged — bindTimeline then skips the type guard for it, which is the
+   * back-compat seam for external `Custom`/`Node` subclasses (DESIGN.md §329)
+   * and prebuilt 0.13 nodes that called the 2-arg form (0.13 had no guard). A
+   * built-in node opts INTO the guard by tagging.
+   */
+  protected registerTarget(path: string, sig: {
+    bindSource(fn: () => unknown): void;
+    unbindSource(): void;
+  }, expects?: ValueTypeId | readonly ValueTypeId[]): void;
   resolveTarget(path: string): BindablePropTarget | undefined;
   /** Subclass drawing: emit own commands (and children for containers). */
   protected abstract draw(out: DisplayListBuilder, ctx: EvalContext): void;
@@ -609,6 +631,8 @@ interface ImageProps extends NodeProps {
   height?: PropInit<number>;
 }
 declare class ImageNode extends Node {
+  /** Marks this node as referencing a kind 'image' timeline asset (§2.3). */
+  static readonly assetKind: "image";
   readonly assetId: string;
   readonly width: BindableSignal<number>;
   readonly height: BindableSignal<number>;
@@ -644,6 +668,8 @@ interface VideoProps extends NodeProps {
  * and references the exact source-grid frame; backends resolve it.
  */
 declare class Video extends Node {
+  /** Marks this node as referencing a kind 'video' timeline asset (§3.8). */
+  static readonly assetKind: "video";
   readonly assetId: string;
   readonly at: number;
   readonly trimStart: number;

package/dist/layoutEngine.js

@@ -560,17 +560,30 @@ var Node = class {
 			]);
 		}, { equals: matEquals });
 		this.worldMatrix = computed(() => this.parent ? multiply(this.parent.worldMatrix(), this.localMatrix()) : this.localMatrix(), { equals: matEquals });
-		this.registerTarget("position", this.position);
-		this.registerTarget("position.x", this.position.x);
-		this.registerTarget("position.y", this.position.y);
-		this.registerTarget("rotation", this.rotation);
-		this.registerTarget("scale", this.scale);
-		this.registerTarget("scale.x", this.scale.x);
-		this.registerTarget("scale.y", this.scale.y);
-		this.registerTarget("opacity", this.opacity);
-		this.registerTarget("zIndex", this.zIndex);
-	}
-	registerTarget(path, sig) {
+		this.registerTarget("position", this.position, ["vec2", "vec2-arc"]);
+		this.registerTarget("position.x", this.position.x, "number");
+		this.registerTarget("position.y", this.position.y, "number");
+		this.registerTarget("rotation", this.rotation, "number");
+		this.registerTarget("scale", this.scale, ["vec2", "vec2-arc"]);
+		this.registerTarget("scale.x", this.scale.x, "number");
+		this.registerTarget("scale.y", this.scale.y, "number");
+		this.registerTarget("opacity", this.opacity, "number");
+		this.registerTarget("zIndex", this.zIndex, "number");
+	}
+	/**
+	* Register a track-target path → bindable signal, stamping the value type the
+	* signal accepts (§2.2). The stamp is what bindTimeline's bind-time guard
+	* reads to reject a mismatched track (a scalar on a vec2, a number on a paint
+	* prop, …) instead of silently sampling to NaN/undefined.
+	*
+	* `expects` is OPTIONAL: omitting it (the 2-arg form) leaves the target
+	* UNtagged — bindTimeline then skips the type guard for it, which is the
+	* back-compat seam for external `Custom`/`Node` subclasses (DESIGN.md §329)
+	* and prebuilt 0.13 nodes that called the 2-arg form (0.13 had no guard). A
+	* built-in node opts INTO the guard by tagging.
+	*/
+	registerTarget(path, sig, expects) {
+		sig.expects = expects;
 		this.targets.set(path, sig);
 		if (this.id !== void 0) sig[TARGET_PATH] = `${this.id}/${path}`;
 	}
@@ -1141,10 +1154,10 @@ var Shape = class extends Node {
 		this.stroke = initProp(signal(""), props.stroke);
 		this.strokeWidth = initProp(signal(0), props.strokeWidth);
 		this.reveal = initProp(signal(1), props.reveal);
-		this.registerTarget("fill", this.fill);
-		this.registerTarget("stroke", this.stroke);
-		this.registerTarget("strokeWidth", this.strokeWidth);
-		this.registerTarget("reveal", this.reveal);
+		this.registerTarget("fill", this.fill, ["color", "paint"]);
+		this.registerTarget("stroke", this.stroke, "color");
+		this.registerTarget("strokeWidth", this.strokeWidth, "number");
+		this.registerTarget("reveal", this.reveal, "number");
 		if (props.sketch) validateSketch(props.sketch);
 		if (props.sketchFill) validateHachure(props.sketchFill);
 		if (props.sketchFill && !props.sketch) emitDevWarning(`${this.id !== void 0 ? `'${this.id}': ` : ""}sketchFill is ignored without sketch — hachure fill is drawn only by the sketch renderer. Set a sketch style (e.g. { kind: 'pencil' }) to see it.`);
@@ -1396,9 +1409,9 @@ var Rect = class extends Shape {
 		this.width = initProp(signal(0), props.width);
 		this.height = initProp(signal(0), props.height);
 		this.cornerRadius = initProp(signal(0), props.cornerRadius);
-		this.registerTarget("width", this.width);
-		this.registerTarget("height", this.height);
-		this.registerTarget("cornerRadius", this.cornerRadius);
+		this.registerTarget("width", this.width, "number");
+		this.registerTarget("height", this.height, "number");
+		this.registerTarget("cornerRadius", this.cornerRadius, "number");
 	}
 	intrinsicSize() {
 		return {
@@ -1418,7 +1431,7 @@ var Circle = class extends Shape {
 	constructor(props = {}) {
 		super(props);
 		this.radius = initProp(signal(0), props.radius);
-		this.registerTarget("radius", this.radius);
+		this.registerTarget("radius", this.radius, "number");
 	}
 	intrinsicSize() {
 		const d = this.radius() * 2;
@@ -1451,7 +1464,7 @@ var Path = class extends Shape {
 	constructor(props = {}) {
 		super(props);
 		this.data = initProp(signal([]), props.data);
-		this.registerTarget("d", this.data);
+		this.registerTarget("d", this.data, "path");
 	}
 	/** Control-point bounding box (conservative: contains the true curve). */
 	bounds() {
@@ -1538,6 +1551,8 @@ var Path = class extends Shape {
 	}
 };
 var ImageNode = class extends Node {
+	/** Marks this node as referencing a kind 'image' timeline asset (§2.3). */
+	static assetKind = "image";
 	assetId;
 	width;
 	height;
@@ -1546,8 +1561,8 @@ var ImageNode = class extends Node {
 		this.assetId = props.assetId;
 		this.width = initProp(signal(0), props.width);
 		this.height = initProp(signal(0), props.height);
-		this.registerTarget("width", this.width);
-		this.registerTarget("height", this.height);
+		this.registerTarget("width", this.width, "number");
+		this.registerTarget("height", this.height, "number");
 	}
 	intrinsicSize() {
 		return {
@@ -1581,6 +1596,8 @@ var ImageNode = class extends Node {
 * and references the exact source-grid frame; backends resolve it.
 */
 var Video = class extends Node {
+	/** Marks this node as referencing a kind 'video' timeline asset (§3.8). */
+	static assetKind = "video";
 	assetId;
 	at;
 	trimStart;
@@ -1599,8 +1616,8 @@ var Video = class extends Node {
 		this.sourceFps = props.sourceFps;
 		this.width = initProp(signal(0), props.width);
 		this.height = initProp(signal(0), props.height);
-		this.registerTarget("width", this.width);
-		this.registerTarget("height", this.height);
+		this.registerTarget("width", this.width, "number");
+		this.registerTarget("height", this.height, "number");
 	}
 	/** Frame-indexed media time for timeline time t; null when outside the clip. */
 	mediaTime(t) {
@@ -1657,11 +1674,11 @@ var Text = class extends Node {
 		this.width = initProp(signal(0), props.width);
 		this.lineHeight = props.lineHeight ?? 1.25;
 		this.reveal = initProp(signal(Number.POSITIVE_INFINITY), props.reveal);
-		this.registerTarget("width", this.width);
-		this.registerTarget("text", this.text);
-		this.registerTarget("fill", this.fill);
-		this.registerTarget("fontSize", this.fontSize);
-		this.registerTarget("reveal", this.reveal);
+		this.registerTarget("width", this.width, "number");
+		this.registerTarget("text", this.text, "string");
+		this.registerTarget("fill", this.fill, "color");
+		this.registerTarget("fontSize", this.fontSize, "number");
+		this.registerTarget("reveal", this.reveal, "number");
 	}
 	intrinsicSize(measurer) {
 		const text = this.text();

package/package.json

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