@glissade/scene 0.13.0 → 0.14.0-pre.0

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");
+			this.registerTarget(`${id}/offset.x`, r.offset.x, "number");
+			this.registerTarget(`${id}/offset.y`, r.offset.y, "number");
 			return r;
 		});
 	}
@@ -1121,7 +1129,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;
 	}

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,11 @@ 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).
+   */
+  readonly expects: ValueTypeId | readonly ValueTypeId[];
 }
 /** Node-local hit-shape override (v2 §C.3) — fat targets for thin strokes. */
 type HitArea = {
@@ -345,7 +350,16 @@ 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.
+   */
+  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 +623,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 +660,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,24 @@ 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");
+		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");
+		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.
+	*/
+	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 +1148,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 +1403,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 +1425,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 +1458,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 +1545,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 +1555,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 +1590,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 +1610,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 +1668,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.0",
   "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.0"
   },
   "repository": {
     "type": "git",