framefields 2.4.2 → 2.5.0

package/dist/preview-engine/{renderers-FADYGSLK.mjs → renderers-VYK2BJID.mjs}

@@ -1 +1 @@
-import{a}from"./chunk-ZKPQGQE3.mjs";import"./chunk-XDMZP3E2.mjs";import"./chunk-IQC2I5A5.mjs";import"./chunk-IQKIHFNZ.mjs";import"./chunk-BVF64D6H.mjs";export{a as default};
+import{a}from"./chunk-NXKXOSE6.mjs";import"./chunk-RNFYEZLL.mjs";import"./chunk-IQC2I5A5.mjs";import"./chunk-IQKIHFNZ.mjs";import"./chunk-BVF64D6H.mjs";export{a as default};

package/dist/preview-engine/renderers-W6762MNW.mjs

@@ -0,0 +1 @@
+import{a}from"./chunk-MLW6Y4RN.mjs";import"./chunk-KRVXRP5F.mjs";import"./chunk-37EFVZWT.mjs";import"./chunk-RNFYEZLL.mjs";import"./chunk-6YJP57MZ.mjs";import"./chunk-BVF64D6H.mjs";export{a as default};

package/dist/preview-engine/renderers-W6ZTVA2I.mjs

@@ -0,0 +1 @@
+import{ea as a}from"./chunk-2AV7HRRL.mjs";import"./chunk-YQRKT47I.mjs";import"./chunk-VXUJWPIK.mjs";import"./chunk-OLLY3Q7M.mjs";import"./chunk-XKO4RYKN.mjs";import"./chunk-X6HUH6K4.mjs";import"./chunk-V6DAD4S4.mjs";import"./chunk-24P6DAB3.mjs";import"./chunk-RNFYEZLL.mjs";import"./chunk-4GEWSUX5.mjs";import"./chunk-MTJHQATU.mjs";import"./chunk-IQKIHFNZ.mjs";import"./chunk-YAQFFQPG.mjs";import"./chunk-BVF64D6H.mjs";export{a as default};

package/dist/preview-engine/renderers-WDV7ENJA.mjs

@@ -0,0 +1 @@
+import{a,b}from"./chunk-25T3M6MI.mjs";import"./chunk-ENKKLU7B.mjs";import"./chunk-RNFYEZLL.mjs";import"./chunk-6YJP57MZ.mjs";import"./chunk-BVF64D6H.mjs";export{a as LiquifyWebGPURenderer,b as default};

package/dist/preview-engine/{renderers-MBSOKWKB.mjs → renderers-WPBTAU2E.mjs}

@@ -1,4 +1,4 @@
-import{A as B}from"./chunk-XDMZP3E2.mjs";import{e as h}from"./chunk-BVF64D6H.mjs";h();h();h();function M(r){return typeof r=="object"&&r!==null&&"particleStatic"in r&&typeof r.particleFrame=="function"}var w=32,S=32,R=8,L=8,T=24,E=64,_=64,F=`
+import{A as B}from"./chunk-RNFYEZLL.mjs";import{e as h}from"./chunk-BVF64D6H.mjs";h();h();h();function M(r){return typeof r=="object"&&r!==null&&"particleStatic"in r&&typeof r.particleFrame=="function"}var w=32,S=32,R=8,L=8,T=24,E=64,_=64,F=`
 struct Particle {
 	pos : vec2<f32>,
 	vel : vec2<f32>,

package/dist/preview-engine/renderers-XP7YFWBV.mjs

@@ -0,0 +1 @@
+import{a}from"./chunk-7EHUT5A3.mjs";import"./chunk-NVTPJUNG.mjs";import"./chunk-MJN3LOZ7.mjs";import"./chunk-V6DAD4S4.mjs";import"./chunk-ENKKLU7B.mjs";import"./chunk-RNFYEZLL.mjs";import"./chunk-6YJP57MZ.mjs";import"./chunk-BVF64D6H.mjs";export{a as default};

package/dist/preview-engine/renderers-XVUOO7B6.mjs

@@ -0,0 +1 @@
+import{a}from"./chunk-XJ4CQIZZ.mjs";import"./chunk-ENKKLU7B.mjs";import"./chunk-RNFYEZLL.mjs";import"./chunk-6YJP57MZ.mjs";import"./chunk-BVF64D6H.mjs";export{a as default};

package/dist/preview-engine/renderers-YPFM5UJO.mjs

@@ -0,0 +1 @@
+import{a}from"./chunk-ENS4KUJV.mjs";import"./chunk-ENKKLU7B.mjs";import"./chunk-RNFYEZLL.mjs";import"./chunk-6YJP57MZ.mjs";import"./chunk-BVF64D6H.mjs";export{a as default};

package/dist/preview-engine/renderers-YW3LBALW.mjs

@@ -0,0 +1 @@
+import{a,b}from"./chunk-24H3QVYB.mjs";import"./chunk-ENKKLU7B.mjs";import"./chunk-RNFYEZLL.mjs";import"./chunk-6YJP57MZ.mjs";import"./chunk-BVF64D6H.mjs";export{a as ColorBalanceWebGPURenderer,b as default};

package/dist/preview-engine/{renderers-4AJWVIJG.mjs → renderers-ZAPIBQZC.mjs}

@@ -1,4 +1,4 @@
-import{a as k,d as F,e as V,f as T,g as D,k as L}from"./chunk-ENKKLU7B.mjs";import{A,y as o}from"./chunk-XDMZP3E2.mjs";import{d as b}from"./chunk-6YJP57MZ.mjs";import{e as u}from"./chunk-BVF64D6H.mjs";u();u();var z=`
+import{a as k,d as F,e as V,f as T,g as D,k as L}from"./chunk-ENKKLU7B.mjs";import{A,y as o}from"./chunk-RNFYEZLL.mjs";import{d as b}from"./chunk-6YJP57MZ.mjs";import{e as u}from"./chunk-BVF64D6H.mjs";u();u();var z=`
 struct VFXUniforms {
     effectType             : f32,
     outputType             : f32,

package/dist/preview-engine/renderers-ZRR4TUVQ.mjs

@@ -0,0 +1 @@
+import{a}from"./chunk-QQJPPGH5.mjs";import"./chunk-MJN3LOZ7.mjs";import"./chunk-V6DAD4S4.mjs";import"./chunk-ENKKLU7B.mjs";import"./chunk-RNFYEZLL.mjs";import"./chunk-6YJP57MZ.mjs";import"./chunk-BVF64D6H.mjs";export{a as default};

package/dist/preview-engine/{renderers-TY7DVI7E.mjs → renderers-ZVKXIQ3E.mjs}

@@ -1,4 +1,4 @@
-import{a as x,d as g,f as T,h as v,j as U,m as P}from"./chunk-ENKKLU7B.mjs";import{A as h}from"./chunk-XDMZP3E2.mjs";import"./chunk-6YJP57MZ.mjs";import{e as p}from"./chunk-BVF64D6H.mjs";p();p();var w="rgba16float",k=`
+import{a as x,d as g,f as T,h as v,j as U,m as P}from"./chunk-ENKKLU7B.mjs";import{A as h}from"./chunk-RNFYEZLL.mjs";import"./chunk-6YJP57MZ.mjs";import{e as p}from"./chunk-BVF64D6H.mjs";p();p();var w="rgba16float",k=`
 struct U { a : vec4<f32>, b : vec4<f32> };
 @group(0) @binding(0) var<uniform> u : U;
 @group(0) @binding(1) var historyTex : texture_2d<f32>;

package/dist/preview-engine/signals.mjs

@@ -1 +1 @@
-import{a as l,b as m,c as n,d as o}from"./chunk-GMGGDADT.mjs";import"./chunk-CPFPY35C.mjs";import{a as p}from"./chunk-RHRMEBNK.mjs";import{a as k}from"./chunk-KT35IPCF.mjs";import"./chunk-FLPSWDX4.mjs";import"./chunk-NQZKBFC6.mjs";import"./chunk-ENKKLU7B.mjs";import"./chunk-VUFDQJ2B.mjs";import"./chunk-Z6UKUHPU.mjs";import"./chunk-VONDRBA2.mjs";import"./chunk-37EFVZWT.mjs";import"./chunk-2SJ4BBMT.mjs";import"./chunk-NIRW77QA.mjs";import"./chunk-24P6DAB3.mjs";import"./chunk-Q4Z54DQ7.mjs";import{i as a,k as b,q as c,r as d,s as e,t as f}from"./chunk-XDMZP3E2.mjs";import{a as g,b as h,c as i,d as j}from"./chunk-6YJP57MZ.mjs";import"./chunk-BVF64D6H.mjs";export{p as AudioSignal,g as AudioSignalComputePipeline,l as AudioSignalExtractorNode,f as Signal,n as SignalGateNode,o as SignalMathNode,m as SignalNode,i as SignalRegistry,h as buildWGSLSignalFn,b as computed,e as cosineSignal,k as modulateRenderer,a as signal,c as signalBuilder,j as signalRegistry,d as sineSignal};
+import{a as l,b as m,c as n,d as o}from"./chunk-CEIOI4HO.mjs";import"./chunk-I6E3AKLS.mjs";import{a as p}from"./chunk-DKXKOUQR.mjs";import{a as k}from"./chunk-MRDJNDYV.mjs";import"./chunk-MJN3LOZ7.mjs";import"./chunk-V6DAD4S4.mjs";import"./chunk-ENKKLU7B.mjs";import"./chunk-VUFDQJ2B.mjs";import"./chunk-HXHP3UHZ.mjs";import"./chunk-AJLPRIXB.mjs";import"./chunk-37EFVZWT.mjs";import"./chunk-2SJ4BBMT.mjs";import"./chunk-NIRW77QA.mjs";import"./chunk-24P6DAB3.mjs";import"./chunk-Q4Z54DQ7.mjs";import{i as a,k as b,q as c,r as d,s as e,t as f}from"./chunk-RNFYEZLL.mjs";import{a as g,b as h,c as i,d as j}from"./chunk-6YJP57MZ.mjs";import"./chunk-BVF64D6H.mjs";export{p as AudioSignal,g as AudioSignalComputePipeline,l as AudioSignalExtractorNode,f as Signal,n as SignalGateNode,o as SignalMathNode,m as SignalNode,i as SignalRegistry,h as buildWGSLSignalFn,b as computed,e as cosineSignal,k as modulateRenderer,a as signal,c as signalBuilder,j as signalRegistry,d as sineSignal};

package/dist/{program-C2cJayA1.mjs → program-CEHCeDpG.mjs}

@@ -1,6 +1,6 @@
-import { Ht as parseCssGradient, Rt as mixColors, Vt as parseCssColor, ht as createVirtualMedia, l as Color, wt as getActiveMediaMetadata } from "./dist-ClyC_d66.mjs";
-import { t as ColorSchema } from "./dist-SB9qfAko.mjs";
-import { Mt as KineticMarqueeConfigSchema, Nn as signalRegistry, Yt as TextPathOptionsSchema, gt as AETextAnimatorSchema, nn as TypewriterAnimatorSchema, vt as AdvancedTextAnimatorSchema } from "./dist-CspOG4V1.mjs";
+import { $t as parseCssGradient, Kt as mixColors, Ot as getActiveMediaMetadata, Qt as parseCssColor, gt as createVirtualMedia, l as Color, ut as assertNever, y as Effect } from "./dist-DFeF-ygz.mjs";
+import { t as ColorSchema } from "./dist-CQZ5_60A.mjs";
+import { Mt as KineticMarqueeConfigSchema, Nn as signalRegistry, Yt as TextPathOptionsSchema, gt as AETextAnimatorSchema, nn as TypewriterAnimatorSchema, vt as AdvancedTextAnimatorSchema } from "./dist-BBUrGwqd.mjs";
 import { z } from "zod";
 import { loadYoga } from "yoga-layout/load";
 
@@ -57,6 +57,12 @@ function dirOf(node) {
 		case "flex": return node.dir ?? "row";
 		case "block": return "column";
 		case "box": return node.children && node.children.length > 0 ? "column" : null;
+		case "text":
+		case "media":
+		case "shape":
+		case "camera":
+		case "light":
+		case "model3d":
 		default: return null;
 	}
 }
@@ -164,7 +170,7 @@ function buildYogaNode(yoga, layoutNode, parentExtent, measure, parentDir) {
 		const measured = measure?.(node) ?? null;
 		if (measured) {
 			const hasRatio = node.aspectRatio !== void 0;
-			const isCaption = node.dataType === "Caption";
+			const isCaption = node.kind === "media" && node.dataType === "Caption";
 			const intrinsicRatio = measured.height > 0 ? measured.width / measured.height : 1;
 			if (node.kind === "media" && !isCaption && !hasRatio) yn.setAspectRatio(intrinsicRatio);
 			const isWAuto = wSpec === void 0 || wSpec === "auto" || wSpec === "fit";
@@ -512,18 +518,14 @@ var LayerAnimation = class LayerAnimation$1 {
 	tracks = [];
 	/** Hold each value for this many frames (see {@link LayerAnimation.stepped}). */
 	frameStep;
+	defaultRepeat;
+	defaultYoyo;
 	constructor(tracks = []) {
 		this.tracks = [...tracks];
 	}
 	static create() {
 		return new LayerAnimation$1();
 	}
-	/**
-	* Stepped timing for the whole layer: every animated value is held for
-	* `frames` frames ("on twos" = 2, "on threes" = 3), the choppy, hand-made
-	* look of stop motion and cel animation. Applies to all of the layer's
-	* tracks, including ones added by other `.animate()` calls.
-	*/
 	static stepped(frames = 2) {
 		return new LayerAnimation$1().stepped(frames);
 	}
@@ -536,8 +538,8 @@ var LayerAnimation = class LayerAnimation$1 {
 		return new LayerAnimation$1().fromTo(prop, fromValue, toValue, options);
 	}
 	/** A track from a list of `[frame, value, ease?]` keyframes; see {@link LayerAnimation.keys}. */
-	static keys(prop, keyframes) {
-		return new LayerAnimation$1().keys(prop, keyframes);
+	static keys(prop, keyframes, options) {
+		return new LayerAnimation$1().keys(prop, keyframes, options);
 	}
 	static signal(prop, signalOrHandleId, options = {}) {
 		return new LayerAnimation$1().signal(prop, signalOrHandleId, options);
@@ -578,11 +580,47 @@ var LayerAnimation = class LayerAnimation$1 {
 	static rotation(fromAngle, toAngle, options = {}) {
 		return new LayerAnimation$1().fromTo("rotation", fromAngle, toAngle, options);
 	}
+	static scale(fromScale, toScale, options = {}) {
+		return new LayerAnimation$1().fromTo("scale", fromScale, toScale, options);
+	}
+	static scaleX(fromScale, toScale, options = {}) {
+		return new LayerAnimation$1().fromTo("scaleX", fromScale, toScale, options);
+	}
+	static scaleY(fromScale, toScale, options = {}) {
+		return new LayerAnimation$1().fromTo("scaleY", fromScale, toScale, options);
+	}
 	addTrack(track) {
 		this.tracks.push(track);
 		return this;
 	}
 	/**
+	* Configures repeat count on all tracks, or on a specific prop's track:
+	* - `-1`: loops indefinitely.
+	* - `N`: repeats N times after the initial iteration (total N + 1 iterations).
+	*/
+	repeat(count = -1, prop) {
+		this.defaultRepeat = count;
+		for (const track of this.tracks) if (!prop || track.prop === prop) track.repeat = count;
+		return this;
+	}
+	/**
+	* Enables or disables yoyo (alternate playback direction on each repeat iteration).
+	*/
+	yoyo(enable = true, prop) {
+		this.defaultYoyo = enable;
+		for (const track of this.tracks) if (!prop || track.prop === prop) track.yoyo = enable;
+		return this;
+	}
+	/**
+	* Shorthand to loop keyframed animation continuously (infinite repeat).
+	* If `options.yoyo` is true, oscillates back and forth.
+	*/
+	loop(options = {}, prop) {
+		this.repeat(-1, prop);
+		if (options.yoyo) this.yoyo(true, prop);
+		return this;
+	}
+	/**
 	* Creates a keyframed track animating from fromValue to toValue.
 	*/
 	fromTo(prop, fromValue, toValue, options = {}) {
@@ -591,13 +629,19 @@ var LayerAnimation = class LayerAnimation$1 {
 		const ease = parseEase(options.ease);
 		let track = this.tracks.find((t) => t.prop === prop && (!t.source || t.source.type === "keyframe"));
 		if (!track) {
-			track = {
+			const newTrack = {
 				id: `${prop}_fromTo_${this.tracks.length}`,
 				prop,
-				keyframes: []
+				keyframes: [],
+				...this.defaultRepeat !== void 0 && { repeat: this.defaultRepeat },
+				...this.defaultYoyo !== void 0 && { yoyo: this.defaultYoyo }
 			};
-			this.tracks.push(track);
+			this.tracks.push(newTrack);
+			track = newTrack;
 		}
+		if (options.repeat !== void 0) track.repeat = options.repeat;
+		if (options.yoyo !== void 0) track.yoyo = options.yoyo;
+		if (options.durationFrames !== void 0) track.durationFrames = options.durationFrames;
 		const id = track.id;
 		if (track.keyframes.length === 0 && start > 0) track.keyframes.push({
 			id: `${id}_k0`,
@@ -624,12 +668,15 @@ var LayerAnimation = class LayerAnimation$1 {
 	keyframe(prop, frame, value, ease) {
 		let track = this.tracks.find((t) => t.prop === prop && (!t.source || t.source.type === "keyframe"));
 		if (!track) {
-			track = {
+			const newTrack = {
 				id: `${prop}_track_${this.tracks.length}`,
 				prop,
-				keyframes: []
+				keyframes: [],
+				...this.defaultRepeat !== void 0 && { repeat: this.defaultRepeat },
+				...this.defaultYoyo !== void 0 && { yoyo: this.defaultYoyo }
 			};
-			this.tracks.push(track);
+			this.tracks.push(newTrack);
+			track = newTrack;
 		}
 		const parsedEase = parseEase(ease);
 		const kf = {
@@ -649,8 +696,16 @@ var LayerAnimation = class LayerAnimation$1 {
 	* `.keys("scale", [[0, 0], [12, 1.1, "back.out"], [20, 1]])`.
 	* Frames are rounded to whole frames, so beat math can be passed straight in.
 	*/
-	keys(prop, keyframes) {
+	keys(prop, keyframes, options) {
 		for (const [frame, value, ease] of keyframes) this.keyframe(prop, Math.round(frame), value, ease);
+		if (options) {
+			const track = this.tracks.find((t) => t.prop === prop && (!t.source || t.source.type === "keyframe"));
+			if (track) {
+				if (options.repeat !== void 0) track.repeat = options.repeat;
+				if (options.yoyo !== void 0) track.yoyo = options.yoyo;
+				if (options.durationFrames !== void 0) track.durationFrames = options.durationFrames;
+			}
+		}
 		return this;
 	}
 	/**
@@ -761,6 +816,24 @@ var LayerAnimation = class LayerAnimation$1 {
 		return this.fromTo("rotateZ", fromAngle, toAngle, options);
 	}
 	/**
+	* Animate scale along the X axis.
+	*/
+	scaleX(fromScale, toScale, options = {}) {
+		return this.fromTo("scaleX", fromScale, toScale, options);
+	}
+	/**
+	* Animate scale along the Y axis.
+	*/
+	scaleY(fromScale, toScale, options = {}) {
+		return this.fromTo("scaleY", fromScale, toScale, options);
+	}
+	/**
+	* Animate uniform scale.
+	*/
+	scale(fromScale, toScale, options = {}) {
+		return this.fromTo("scale", fromScale, toScale, options);
+	}
+	/**
 	* Animate perspective camera distance in pixels.
 	*/
 	perspective(fromDist, toDist, options = {}) {
@@ -1027,13 +1100,18 @@ var LayerAnimation = class LayerAnimation$1 {
 		return this;
 	}
 	static merge(...anims) {
-		return new LayerAnimation$1().merge(...anims);
+		const result = new LayerAnimation$1();
+		result.tracks = mergeAnimationTracks(anims.flatMap((o) => o.tracks));
+		return result;
 	}
 	/**
 	* Returns the validated LayerAnimation specification object.
 	*/
 	toSpec() {
-		return { tracks: this.tracks };
+		return {
+			tracks: this.tracks,
+			...this.frameStep !== void 0 && { frameStep: this.frameStep }
+		};
 	}
 	toJSON() {
 		return this.toSpec();
@@ -1899,21 +1977,47 @@ const COLOR_PROPS$1 = new Set([
 	"textBackgroundColor",
 	"color"
 ]);
+function computeRepeatFrame(track, localFrame, startFrame, lastFrame) {
+	const repeat = track.repeat ?? 0;
+	const cycleSpan = lastFrame - startFrame;
+	const cycleDuration = track.durationFrames !== void 0 && track.durationFrames > 0 ? track.durationFrames : cycleSpan;
+	if (repeat === 0 || cycleDuration <= 0) {
+		if (localFrame >= lastFrame) {
+			const kfs = track.keyframes ?? [];
+			return { completedValue: kfs[kfs.length - 1].value };
+		}
+		return { frame: localFrame };
+	}
+	const delta = localFrame - startFrame;
+	const cycleIndex = Math.floor(delta / cycleDuration);
+	if (repeat > 0 && cycleIndex >= 1 + repeat) {
+		const isFinalReverse = Boolean(track.yoyo) && repeat % 2 === 1;
+		const kfs = track.keyframes ?? [];
+		return { completedValue: isFinalReverse ? kfs[0].value : kfs[kfs.length - 1].value };
+	}
+	const cycleOffset = delta - cycleIndex * cycleDuration;
+	if (Boolean(track.yoyo) && cycleIndex % 2 === 1) return { frame: cycleOffset >= cycleSpan ? startFrame : lastFrame - cycleOffset };
+	return { frame: cycleOffset >= cycleSpan ? lastFrame : startFrame + cycleOffset };
+}
 /**
-* Standard keyframe track evaluation.
+* Standard keyframe track evaluation with loop (repeat/yoyo) support.
 */
 function evaluateKeyframes(track, localFrame, ease) {
 	const keyframes = track.keyframes ?? [];
 	if (keyframes.length === 0) return 0;
 	if (keyframes.length === 1) return keyframes[0].value;
-	if (localFrame <= keyframes[0].frame) return keyframes[0].value;
-	if (localFrame >= keyframes[keyframes.length - 1].frame) return keyframes[keyframes.length - 1].value;
+	const startFrame = keyframes[0].frame;
+	if (localFrame <= startFrame) return keyframes[0].value;
+	const lastFrame = keyframes[keyframes.length - 1].frame;
+	const repeatResolution = computeRepeatFrame(track, localFrame, startFrame, lastFrame);
+	if ("completedValue" in repeatResolution) return repeatResolution.completedValue;
+	const evalFrame = repeatResolution.frame;
 	for (let i = 0; i < keyframes.length - 1; i++) {
 		const kf0 = keyframes[i];
 		const kf1 = keyframes[i + 1];
-		if (localFrame >= kf0.frame && localFrame <= kf1.frame) {
+		if (evalFrame >= kf0.frame && evalFrame <= kf1.frame) {
 			const delta = kf1.frame - kf0.frame;
-			const linear = delta > 0 ? (localFrame - kf0.frame) / delta : 0;
+			const linear = delta > 0 ? (evalFrame - kf0.frame) / delta : 0;
 			const t = ease ? ease(kf1.ease ?? kf0.ease, delta, linear) : linear;
 			if (typeof kf0.value === "boolean") return linear >= 1 ? kf1.value : kf0.value;
 			if (typeof kf0.value === "string" && typeof kf1.value === "string") {
@@ -1995,6 +2099,12 @@ const COLOR_PROPS = [
 	"emissive",
 	"color"
 ];
+/**
+* Keyframes on one layer past which an animation is probably keyed every
+* frame by mistake. There is no hard limit: evaluation and playback handle
+* any count, but programs this size are slow to send, read and edit.
+*/
+const LARGE_ANIMATION_KEYFRAMES = 2e3;
 /** Contrast below this makes text hard to read (WCAG large-text minimum). */
 const MIN_TEXT_CONTRAST = 3;
 function tracksOf(node) {
@@ -2081,11 +2191,15 @@ function lintComposition(config) {
 			"translateX",
 			"translateY",
 			"scale",
+			"scaleX",
+			"scaleY",
 			"rotation"
 		])) {
 			const { x, y, width, height } = node;
 			if (x + width <= 0 || y + height <= 0 || x >= W || y >= H) push("warning", "offscreen_layer", `'${id}' sits entirely outside the ${W}×${H} canvas (x ${x}, y ${y}) and never moves in.`, id);
 		}
+		const keyframeCount = tracksOf(node).reduce((n, t) => n + (t.keyframes?.length ?? 0), 0);
+		if (keyframeCount > LARGE_ANIMATION_KEYFRAMES) push("warning", "large_animation", `'${id}' has ${keyframeCount} keyframes across its tracks (over ${LARGE_ANIMATION_KEYFRAMES}). Keying every frame is rarely needed: key the turning points and let eases fill in, or drive the prop from a signal.`, id);
 		for (const t of tracksOf(node)) {
 			const kfs = t.keyframes ?? [];
 			if ((!t.source || t.source.type === "keyframe") && kfs.length >= 2 && kfs.every((k) => JSON.stringify(k.value) === JSON.stringify(kfs[0].value))) push("info", "static_track", `'${id}' animates \`${t.prop}\` but every keyframe holds ${JSON.stringify(kfs[0].value)}.`, id);
@@ -2143,6 +2257,21 @@ function hoistOne(owner) {
 function hoistMattes(nodes) {
 	return nodes.flatMap((n) => hoistOne(n));
 }
+/**
+* Compositor program document v2 — THE single source of truth for a
+* composition (spec: `nodes/node-compositor/SKILL.md`).
+*
+* The config IS a tree of HTML-like layout nodes (`layout`), replacing the
+* v1 flat `layers[]`. No `layers`, no `layerUpdates`, no aliases: the tree
+* is what agents write, what the editor edits, what the renderer renders.
+*
+* Design rules (hard):
+*  - strict zod, `.strict()` everywhere; unknown keys are rejected by the
+*    pre-parse scan in `validate.ts` (zod alone would silently strip them)
+*  - recursive container fields use `z.lazy`; leaf kinds are plain objects
+*  - every field that can animate is in `AnimatablePropSchema`
+*  - no backwards compatibility: v1 shapes fail fast with E-codes
+*/
 /** number px | "auto" (intrinsic) | "fit" (shrink-wrap) | "fill" (parent extent). */
 const SizeSpecSchema = z.union([
 	z.number().min(0),
@@ -2162,6 +2291,11 @@ const ShapeTypeSchema = z.enum([
 	"arrow",
 	"path"
 ]);
+const EffectSpecSchema = z.union([
+	z.instanceof(Effect),
+	z.object({ op: z.string().min(1) }).passthrough(),
+	z.custom((val) => Boolean(val && typeof val === "object" && "op" in val && typeof val.op === "string"))
+]);
 const AnimatablePropSchema = z.enum([
 	"x",
 	"y",
@@ -2398,11 +2532,9 @@ const TrackSourceSchema = z.preprocess((val) => {
 }, RawTrackSourceSchema);
 const animationInvariants = (anim, ctx) => {
 	if (!anim?.tracks) return;
-	let totalKeyframes = 0;
 	for (let tIdx = 0; tIdx < anim.tracks.length; tIdx++) {
 		const track = anim.tracks[tIdx];
 		const keyframes = track.keyframes ?? [];
-		totalKeyframes += keyframes.length;
 		if ((!track.source || track.source.type === "keyframe") && keyframes.length < 1) ctx.addIssue({
 			code: z.ZodIssueCode.custom,
 			message: `Track for property '${track.prop}' must have at least 1 keyframe.`,
@@ -2488,11 +2620,6 @@ const animationInvariants = (anim, ctx) => {
 			});
 		}
 	}
-	if (totalKeyframes > 128) ctx.addIssue({
-		code: z.ZodIssueCode.custom,
-		message: `Total keyframes across all tracks (${totalKeyframes}) exceeds the limit of 128.`,
-		path: ["tracks"]
-	});
 };
 const AnimationTrackSchema = z.object({
 	id: z.string().min(1),
@@ -2531,9 +2658,11 @@ const BaseNodeFields = {
 	hidden: z.boolean().default(false),
 	opacity: z.number().min(0).max(1).default(1),
 	blendMode: z.string().optional(),
-	effects: z.array(z.unknown()).optional(),
+	effects: z.array(EffectSpecSchema).optional(),
 	rotation: z.number().default(0),
 	scale: z.number().min(0).default(1),
+	scaleX: z.number().default(1),
+	scaleY: z.number().default(1),
 	anchorX: z.number().min(0).max(1).default(.5),
 	anchorY: z.number().min(0).max(1).default(.5),
 	startFrame: z.number().int().min(0).default(0),
@@ -2968,6 +3097,7 @@ const MediaNodeSchema = z.object({
 	...BaseNodeFields,
 	kind: z.literal("media"),
 	inputHandleId: z.string().min(1),
+	src: z.string().optional(),
 	dataType: z.string().optional(),
 	fit: z.enum([
 		"cover",
@@ -3107,7 +3237,14 @@ const Model3DNodeSchema = z.object({
 	text3dOptions: z.unknown().optional(),
 	primitive3d: z.unknown().optional()
 }).strict();
-const LayoutNodeSchema = z.lazy(() => z.union([
+/**
+* Dispatch on `kind`, not a plain union: a plain union tries every member,
+* and each member parses `children` before failing, so parse time grows
+* ~3x per nesting level (a depth-14 tree took minutes). The node schemas
+* are typed `ZodType<…>` for their recursive types, but each is a strict
+* object with a `kind` literal, which is all `discriminatedUnion` reads.
+*/
+const LayoutNodeSchema = z.lazy(() => z.discriminatedUnion("kind", [
 	FlexNodeSchema,
 	BlockNodeSchema,
 	BoxNodeSchema,
@@ -3129,7 +3266,7 @@ const CompositorProgramSchema = z.object({
 	layout: z.array(LayoutNodeSchema).default([]),
 	fonts: z.array(z.string()).optional(),
 	signals: z.record(z.string(), z.unknown()).optional(),
-	effects: z.array(z.unknown()).optional(),
+	effects: z.array(EffectSpecSchema).optional(),
 	vision: z.unknown().optional(),
 	onRequestFrame: z.custom().optional()
 }).strict();
@@ -3327,8 +3464,8 @@ function computeStaggerDelay(index, totalCount, staggerFrames, direction = "forw
 			const dist = Math.abs(index - center);
 			return Math.round(dist * staggerFrames);
 		}
-		case "forward":
-		default: return index * staggerFrames;
+		case "forward": return index * staggerFrames;
+		default: return assertNever(direction);
 	}
 }
 /**
@@ -3361,12 +3498,12 @@ function applyStaggerToChildren(children, staggerFrames, direction = "forward",
 */
 function nodeToVirtualMedia(node, resolveMedia, fps, inheritedOffset = 0, compDurationMs, inheritedDurationFrames) {
 	let children = [];
-	const sourceRef = node.src ?? node.inputHandleId;
+	const sourceRef = node.kind === "media" ? node.src ?? node.inputHandleId : "inputHandleId" in node ? node.inputHandleId : void 0;
 	const isDirectMediaSource = (s) => typeof s === "string" && (s.startsWith("http://") || s.startsWith("https://") || s.startsWith("file://") || s.startsWith("/") || s.startsWith("./") || s.startsWith("blob:") || s.startsWith("data:") || /\.(png|jpe?g|webp|gif|svg|mp4|webm|mov|mkv|mp3|wav|ogg|m4a|srt|vtt|json|lottie)$/i.test(s));
 	let media;
 	if (node.kind === "media") {
-		if (resolveMedia) media = resolveMedia(node.inputHandleId);
-		if (!media && sourceRef && (isDirectMediaSource(sourceRef) || node.src)) media = createVirtualMedia(sourceRef, node.dataType ?? "Video");
+		if (resolveMedia && node.inputHandleId) media = resolveMedia(node.inputHandleId);
+		if (!media && sourceRef && (isDirectMediaSource(sourceRef) || Boolean(node.src))) media = createVirtualMedia(sourceRef, node.dataType ?? "Video");
 		if (!media && !resolveMedia && sourceRef && (sourceRef.includes(".") || sourceRef.includes("/"))) console.warn(`[Compositor] Media layer '${node.id ?? "?"}' source '${sourceRef}' could not be resolved.`);
 		if (media && node.crop) {
 			const cropRaw = node.crop;
@@ -3381,18 +3518,23 @@ function nodeToVirtualMedia(node, resolveMedia, fps, inheritedOffset = 0, compDu
 				children: [media]
 			};
 		}
-		if (media && Array.isArray(node.effects)) for (const eff of node.effects) {
-			const effOp = typeof eff.toOperation === "function" ? eff.toOperation() : eff;
-			media = {
-				metadata: { ...media.metadata },
-				operation: {
-					id: node.id ? `${node.id}-${effOp.op ?? "effect"}` : void 0,
-					effect: eff,
-					...effOp,
-					dataType: media.operation.dataType
-				},
-				children: [media]
-			};
+		if (media && Array.isArray(node.effects)) {
+			let currentMedia = media;
+			for (const eff of node.effects) {
+				const effOp = eff && typeof eff.toOperation === "function" ? eff.toOperation() : eff;
+				currentMedia = {
+					metadata: { ...currentMedia.metadata },
+					operation: {
+						op: String(effOp.op ?? "effect"),
+						id: node.id ? `${node.id}-${effOp.op ?? "effect"}` : void 0,
+						effect: eff,
+						...effOp,
+						dataType: currentMedia.operation.dataType
+					},
+					children: [currentMedia]
+				};
+			}
+			media = currentMedia;
 		}
 		if (media && node.vision) {
 			const visionRaw = node.vision;
@@ -3412,12 +3554,13 @@ function nodeToVirtualMedia(node, resolveMedia, fps, inheritedOffset = 0, compDu
 	}
 	if (node.kind === "media") children = media ? [media] : [];
 	else if ("children" in node && node.children) {
-		const staggerFrames = "staggerFrames" in node && typeof node.staggerFrames === "number" ? node.staggerFrames : 0;
-		const staggerDirection = "staggerDirection" in node && typeof node.staggerDirection === "string" ? node.staggerDirection : "forward";
+		const staggerFrames = node.kind === "flex" && typeof node.staggerFrames === "number" ? node.staggerFrames : 0;
+		const staggerDirection = node.kind === "flex" && typeof node.staggerDirection === "string" ? node.staggerDirection : "forward";
 		const nodeStart = typeof node.startFrame === "number" && Number.isFinite(node.startFrame) ? Math.round(node.startFrame) : 0;
 		const nodeDuration = typeof node.durationFrames === "number" && Number.isFinite(node.durationFrames) ? Math.round(node.durationFrames) : inheritedDurationFrames;
-		children = node.children.map((c, idx) => {
-			const delay = computeStaggerDelay(idx, node.children.length, staggerFrames, staggerDirection);
+		const nodeChildren = node.children;
+		children = nodeChildren.map((c, idx) => {
+			const delay = computeStaggerDelay(idx, nodeChildren.length, staggerFrames, staggerDirection);
 			return nodeToVirtualMedia(c, resolveMedia, fps, inheritedOffset + nodeStart + delay, compDurationMs, c.durationFrames === void 0 ? nodeDuration : void 0);
 		});
 	}
@@ -3435,7 +3578,7 @@ function nodeToVirtualMedia(node, resolveMedia, fps, inheritedOffset = 0, compDu
 	const defaultCompDuration = inheritedDurationFrames ?? Math.round((compDurationMs ?? 1e4) / 1e3 * fps);
 	if (isContainer && children.length > 0) {
 		if (dur === void 0) {
-			const childEnds = children.map((c) => (c.operation?.startFrame ?? 0) + (c.operation?.durationFrames ?? defaultCompDuration));
+			const childEnds = children.map((c) => (c.operation.startFrame ?? 0) + (c.operation.durationFrames ?? defaultCompDuration));
 			dur = Math.max(1, Math.max(...childEnds) - startFrame);
 		}
 	} else if (isCaption && limit !== void 0 && limit > 0) dur = limit;
@@ -3490,13 +3633,13 @@ function compositorToProgram(config, options) {
 				...collectInlineSignals(config.layout),
 				...signals ?? config.signals ?? {}
 			},
-			...(config.onRequestFrame || options.onRequestFrame) && { onRequestFrame: config.onRequestFrame ?? options.onRequestFrame }
+			...config.onRequestFrame || options.onRequestFrame ? { onRequestFrame: config.onRequestFrame ?? options.onRequestFrame } : {}
 		},
 		children: hoistMattes(config.layout).map((n) => nodeToVirtualMedia(n, resolveMedia, fps, 0, durationMs))
 	};
 	const effectsList = Array.isArray(options.effects) ? options.effects : Array.isArray(config.effects) ? config.effects : [];
 	for (const eff of effectsList) {
-		const effOp = typeof eff.toOperation === "function" ? eff.toOperation() : eff;
+		const effOp = eff && typeof eff.toOperation === "function" ? eff.toOperation() : eff;
 		rootMedia = {
 			metadata: { ...rootMedia.metadata },
 			operation: {
@@ -3534,4 +3677,4 @@ function collectNodeOps(nodes) {
 
 //#endregion
 export { applyStaggerToChildren as A, evaluateTrackAtFrame as B, ShapeNodeSchema as C, TextSpanMarkSchema as D, TextNodeSchema as E, computeLayout as F, initLayout as H, computeLayoutSync as I, computeStaggerDelay as L, collectNodeOps as M, compositorToProgram as N, TextSpanSchema as O, computeCarrierContinuity as P, evaluateAnimationAtFrame as R, Sequence as S, TextAnimatorSchema as T, lintComposition as U, hoistMattes as V, mergeAnimationTracks as W, MediaNodeSchema as _, CarrierHandoffConfigSchema as a, SceneDefinitionSchema as b, EnvironmentFogSchema as c, LayerAnimation as d, LayoutNodeSchema as f, MatteModeSchema as g, MaterialTypeSchema as h, CameraNodeSchema as i, calculateSequenceTimeline as j, ToneMappingSchema as k, EnvironmentPresetSchema as l, LightTypeSchema as m, BoxNodeSchema as n, ColorStopSchema as o, LightNodeSchema as p, CameraAnimation as r, CompositorProgramSchema as s, BloomConfigSchema as t, FlexNodeSchema as u, Model3DNodeSchema as v, TextAnimator as w, SceneTransitionTypeSchema as x, Scene as y, evaluateKeyframes as z };
-//# sourceMappingURL=program-C2cJayA1.mjs.map
+//# sourceMappingURL=program-CEHCeDpG.mjs.map