framefields 2.4.1 → 2.4.3

package/dist/{dist-ClyC_d66.mjs → dist-TrtLGPvc.mjs}

@@ -50,17 +50,17 @@ var ProgrammaticSignal = class ProgrammaticSignal$1 {
 		frameSignal.get();
 		const currentFrame = ctx?.frame ?? (this._seekedFrame >= 0 ? this._seekedFrame : frameSignal.value);
 		if (this._cachedFrame === currentFrame) return this._cachedValue;
-		const fps = ctx?.fps ?? this._fps;
-		const time = ctx?.time ?? (fps > 0 ? currentFrame / fps : 0);
+		const fps$1 = ctx?.fps ?? this._fps;
+		const time = ctx?.time ?? (fps$1 > 0 ? currentFrame / fps$1 : 0);
 		const duration = ctx?.duration ?? this._durationFrames ?? 100;
 		const resolvedCtx = {
 			frame: currentFrame,
-			fps,
+			fps: fps$1,
 			time,
 			duration,
-			durationMs: ctx?.durationMs ?? duration / fps * 1e3,
+			durationMs: ctx?.durationMs ?? duration / fps$1 * 1e3,
 			progress: duration > 0 ? currentFrame / duration : 0,
-			deltaTime: ctx?.deltaTime ?? (fps > 0 ? 1 / fps : .0416)
+			deltaTime: ctx?.deltaTime ?? (fps$1 > 0 ? 1 / fps$1 : .0416)
 		};
 		this._cachedFrame = currentFrame;
 		this._cachedValue = this._evaluator(resolvedCtx);
@@ -82,11 +82,11 @@ var ProgrammaticSignal = class ProgrammaticSignal$1 {
 		if (other instanceof ProgrammaticSignal$1) other.registerChild(child);
 		return child;
 	}
-	seekFrame(frame) {
-		this._seekedFrame = frame;
+	seekFrame(frame$1) {
+		this._seekedFrame = frame$1;
 		this._cachedFrame = -1;
 		for (const sub of this._subscribers) sub.markDirty();
-		for (const child of this._children) child.seekFrame(frame);
+		for (const child of this._children) child.seekFrame(frame$1);
 	}
 	invalidate() {
 		this._cachedFrame = -1;
@@ -259,9 +259,9 @@ var ProgrammaticSignal = class ProgrammaticSignal$1 {
 	map(fn) {
 		return this._derive((ctx) => fn(this.get(ctx), ctx));
 	}
-	toFrameArray(totalFrames, fps) {
+	toFrameArray(totalFrames, fps$1) {
 		const count = Math.max(1, totalFrames);
-		const f = fps ?? this._fps;
+		const f = fps$1 ?? this._fps;
 		const out = new Float32Array(count);
 		for (let i = 0; i < count; i++) out[i] = this.get({
 			frame: i,
@@ -440,9 +440,9 @@ var FrameArraySignalImpl = class {
 	_cachedValue = 0;
 	_seekedFrame = -1;
 	_subscribers = /* @__PURE__ */ new Set();
-	constructor(samples, fps = 24, gpuBinding) {
+	constructor(samples, fps$1 = 24, gpuBinding) {
 		this._samples = samples;
-		this.fps = fps;
+		this.fps = fps$1;
 		this.gpuBinding = gpuBinding;
 		if (samples.length > 0) this._cachedValue = samples[0];
 	}
@@ -471,12 +471,12 @@ var FrameArraySignalImpl = class {
 	peek() {
 		return this._cachedValue;
 	}
-	seekFrame(frame) {
-		this._seekedFrame = frame;
-		this._cachedFrame = frame;
+	seekFrame(frame$1) {
+		this._seekedFrame = frame$1;
+		this._cachedFrame = frame$1;
 		if (!this._samples || this._samples.length === 0) this._cachedValue = 0;
 		else {
-			const idx = Math.max(0, Math.min(this._samples.length - 1, Math.round(frame)));
+			const idx = Math.max(0, Math.min(this._samples.length - 1, Math.round(frame$1)));
 			this._cachedValue = Number(this._samples[idx]) || 0;
 		}
 		for (const sub of this._subscribers) sub.markDirty();
@@ -503,15 +503,15 @@ function isValueSignal(val) {
 function computed(fn) {
 	return new ComputedImpl(fn);
 }
-function frameArraySignal(samples, fps = 24, gpuBinding) {
-	return new FrameArraySignalImpl(samples, fps, gpuBinding);
+function frameArraySignal(samples, fps$1 = 24, gpuBinding) {
+	return new FrameArraySignalImpl(samples, fps$1, gpuBinding);
 }
 const frameSignal = signal(0);
 const timeSignal = signal(0);
 const progressSignal = signal(0);
-function updateClockSignals(frame, fps = 24, durationMs) {
-	frameSignal.set(frame);
-	const timeSec = fps > 0 ? frame / fps : 0;
+function updateClockSignals(frame$1, fps$1 = 24, durationMs) {
+	frameSignal.set(frame$1);
+	const timeSec = fps$1 > 0 ? frame$1 / fps$1 : 0;
 	timeSignal.set(timeSec);
 	if (durationMs && durationMs > 0) {
 		const durSec = durationMs / 1e3;
@@ -537,17 +537,17 @@ var ProceduralSignalImpl = class {
 	}
 	get(ctx) {
 		frameSignal.get();
-		const frame = ctx?.frame ?? frameSignal.value;
-		const fps = ctx?.fps ?? 24;
-		const time = ctx?.time ?? (fps > 0 ? frame / fps : 0);
+		const frame$1 = ctx?.frame ?? frameSignal.value;
+		const fps$1 = ctx?.fps ?? 24;
+		const time = ctx?.time ?? (fps$1 > 0 ? frame$1 / fps$1 : 0);
 		if (this._config.fn) return this._config.fn(ctx ?? {
-			frame,
-			fps,
+			frame: frame$1,
+			fps: fps$1,
 			time,
 			duration: 0,
 			durationMs: 0,
 			progress: 0,
-			deltaTime: fps > 0 ? 1 / fps : 0
+			deltaTime: fps$1 > 0 ? 1 / fps$1 : 0
 		});
 		const freq = this._config.frequency ?? 1;
 		const amp = this._config.amplitude ?? 1;
@@ -625,6 +625,7 @@ const Signal = {
 	cosine: cosineSignal
 };
 var Effect = class {
+	domain = "visual";
 	signals;
 	config;
 	_frameHooks = [];
@@ -885,6 +886,69 @@ const NodeVisualConfigSchema = z$1.object({
 	locked: z$1.boolean().optional().default(false),
 	collapsed: z$1.boolean().optional().default(false)
 }).passthrough();
+/** Asserts and casts a number to an integer FrameIndex. */
+function frame(n) {
+	if (!Number.isFinite(n) || !Number.isInteger(n) || n < 0) throw new RangeError(`FrameIndex must be a non-negative finite integer, got ${n}`);
+	return n;
+}
+/** Asserts and casts a number to Seconds. */
+function seconds(s) {
+	if (!Number.isFinite(s)) throw new TypeError(`Seconds must be a finite number, got ${s}`);
+	return s;
+}
+/** Asserts and casts a number to Milliseconds. */
+function ms(m) {
+	if (!Number.isFinite(m)) throw new TypeError(`Milliseconds must be a finite number, got ${m}`);
+	return m;
+}
+/** Asserts and casts a number to Fps. */
+function fps(f) {
+	if (!Number.isFinite(f) || f <= 0) throw new RangeError(`Fps must be a positive finite number, got ${f}`);
+	return f;
+}
+/** Clamps and casts a number to Normalized [0.0, 1.0]. */
+function normalized(n) {
+	if (!Number.isFinite(n)) throw new TypeError(`Normalized must be a finite number, got ${n}`);
+	return Math.max(0, Math.min(1, n));
+}
+/** Asserts and casts a number to Degrees. */
+function degrees(deg) {
+	if (!Number.isFinite(deg)) throw new TypeError(`Degrees must be a finite number, got ${deg}`);
+	return deg;
+}
+/** Asserts and casts a number to Radians. */
+function radians(rad) {
+	if (!Number.isFinite(rad)) throw new TypeError(`Radians must be a finite number, got ${rad}`);
+	return rad;
+}
+/** Asserts and casts a number to Pixels. */
+function pixels(px) {
+	if (!Number.isFinite(px)) throw new TypeError(`Pixels must be a finite number, got ${px}`);
+	return px;
+}
+/** Casts a string to HandleId. */
+function handleId(id) {
+	if (!id) throw new TypeError("HandleId cannot be empty");
+	return id;
+}
+/** Casts a string to HandleLabel. */
+function handleLabel(label) {
+	if (!label) throw new TypeError("HandleLabel cannot be empty");
+	return label;
+}
+/** Casts a string to NodeId. */
+function nodeId(id) {
+	if (!id) throw new TypeError("NodeId cannot be empty");
+	return id;
+}
+/** Type guard checking if a number is a valid FrameIndex. */
+function isFrameIndex(val) {
+	return typeof val === "number" && Number.isInteger(val) && val >= 0;
+}
+/** Type guard checking if a number is in the Normalized [0, 1] range. */
+function isNormalized(val) {
+	return typeof val === "number" && Number.isFinite(val) && val >= 0 && val <= 1;
+}
 const dataTypeColors = {
 	Text: {
 		bg: "bg-blue-500",
@@ -1368,6 +1432,7 @@ const BaseMediaOperationPropsSchema = z.object({
 	volume: z.number().optional(),
 	opacity: z.number().optional(),
 	startFrame: z.number().optional(),
+	durationFrames: z.number().optional(),
 	timeline: TimelineTransformSchema.optional()
 });
 /** Original source file (leaf node) */
@@ -1578,12 +1643,12 @@ function appendOperation(vv, operation) {
 * Helper to compute the metadata of the NEXT node in the operator tree.
 */
 function computeNextMetadata(baseMeta, op) {
-	let { width, height, durationMs, fps, sampleRate, channels, bitDepth, audioCodec, audioBitrate } = baseMeta;
+	let { width, height, durationMs, fps: fps$1, sampleRate, channels, bitDepth, audioCodec, audioBitrate } = baseMeta;
 	if ("metadata" in op && op.metadata) {
 		width = op.metadata.width ?? width;
 		height = op.metadata.height ?? height;
 		durationMs = op.metadata.durationMs ?? durationMs;
-		fps = op.metadata.fps ?? fps;
+		fps$1 = op.metadata.fps ?? fps$1;
 		sampleRate = op.metadata.sampleRate ?? sampleRate;
 		channels = op.metadata.channels ?? channels;
 		bitDepth = op.metadata.bitDepth ?? bitDepth;
@@ -1593,13 +1658,13 @@ function computeNextMetadata(baseMeta, op) {
 	if (op.dataType === "Audio" || op.dataType === "Text" || op.dataType === "Caption") {
 		width = void 0;
 		height = void 0;
-		fps = void 0;
+		fps$1 = void 0;
 	}
 	return {
 		width,
 		height,
 		durationMs,
-		fps,
+		fps: fps$1,
 		sampleRate,
 		channels,
 		bitDepth,
@@ -1613,7 +1678,7 @@ function getFileDataMetadata(filedata) {
 	const width = entity?.width;
 	const height = entity?.height;
 	let durationMs = entity?.duration;
-	const fps = entity?.fps;
+	const fps$1 = entity?.fps;
 	const sampleRate = entity?.sampleRate;
 	const channels = entity?.channels;
 	const bitDepth = entity?.bitDepth;
@@ -1628,7 +1693,7 @@ function getFileDataMetadata(filedata) {
 		width,
 		height,
 		durationMs: durationMs === 0 ? void 0 : durationMs,
-		fps,
+		fps: fps$1,
 		sampleRate,
 		channels,
 		bitDepth,
@@ -1646,7 +1711,7 @@ function getActiveMediaMetadata(vv) {
 	let width = vv.metadata?.width;
 	let height = vv.metadata?.height;
 	let durationMs = vv.metadata?.durationMs;
-	let fps = vv.metadata?.fps;
+	let fps$1 = vv.metadata?.fps;
 	let sampleRate = vv.metadata?.sampleRate;
 	let channels = vv.metadata?.channels;
 	let bitDepth = vv.metadata?.bitDepth;
@@ -1659,7 +1724,7 @@ function getActiveMediaMetadata(vv) {
 		width = width ?? sm.width ?? fdm?.width;
 		height = height ?? sm.height ?? fdm?.height;
 		durationMs = durationMs ?? sm.durationMs ?? fdm?.durationMs;
-		fps = fps ?? sm.fps ?? fdm?.fps;
+		fps$1 = fps$1 ?? sm.fps ?? fdm?.fps;
 		sampleRate = sampleRate ?? sm.sampleRate ?? fdm?.sampleRate;
 		channels = channels ?? sm.channels ?? fdm?.channels;
 		bitDepth = bitDepth ?? sm.bitDepth ?? fdm?.bitDepth;
@@ -1671,7 +1736,7 @@ function getActiveMediaMetadata(vv) {
 		width,
 		height,
 		durationMs: durationMs === 0 ? void 0 : durationMs,
-		fps,
+		fps: fps$1,
 		sampleRate,
 		channels,
 		bitDepth,
@@ -1717,6 +1782,18 @@ function computeVideoCropRenderProps(virtualMedia) {
 		cropTranslatePercentageY: -(totalOffsetY / sourceH) * 100
 	};
 }
+/**
+* Compile-time exhaustiveness check helper for discriminated unions and enums.
+*
+* In switch statements or if-else ladders, passing the unhandled variable to
+* `assertNever(x)` will fail TypeScript compilation if any variant was missed.
+* At runtime, if an unexpected value arrives (e.g. from unvalidated JSON), it throws
+* a descriptive Error.
+*/
+function assertNever(value, message) {
+	const detail = typeof value === "object" && value !== null ? JSON.stringify(value) : String(value);
+	throw new Error(message ?? `Unhandled union variant: ${detail}`);
+}
 const NAMED = {
 	transparent: "#00000000",
 	black: "#000000",
@@ -2059,9 +2136,9 @@ const Color = {
 		const [L, C, H, a] = oklchOf(c);
 		return fromOklch(L, C * factor, H, a);
 	},
-	rotate(c, degrees) {
+	rotate(c, degrees$1) {
 		const [L, C, H, a] = oklchOf(c);
-		return fromOklch(L, C, H + degrees, a);
+		return fromOklch(L, C, H + degrees$1, a);
 	},
 	alpha(c, a) {
 		const [r, g, b] = parseOr(c);
@@ -2541,5 +2618,5 @@ function extractSvgDimensions(buffer) {
 }
 
 //#endregion
-export { TimelineTransformSchema as $, sampleColorStops as $t, MIME_TYPES as A, gradientStopsToOklab as At, OutputItemSchema as B, oklabToRgb as Bt, FileDataSchema as C, generateId as Ct, HandleTypeVal as D, getLeafMediaType as Dt, Gradient as E, getFingerprint as Et, ModerationUnrefundableError as F, isValueSignal as Ft, SignalGateDataSchema as G, registerSignalDependency as Gt, Signal as H, parseCssGradient as Ht, MultiOutputGenericSchema as I, isVirtualMediaData as It, SingleOutputGenericSchema as J, resolveMediaMimeType as Jt, SignalMathDataSchema as K, reportRenderDiagnostic as Kt, NodeMetadataSchema as L, limitGradientStops as Lt, MediaOperationSchema as M, isCssGradient as Mt, MediaSourceSchema as N, isEqual as Nt, JsonValueSchema as O, getMediaType as Ot, ModerationError as P, isSignal as Pt, TimelineSegmentSchema as Q, rgbToOklab as Qt, NodeResultSchema as R, mixColors as Rt, FileAssetSchema as S, frameSignal as St, GlobalCompositeOperation as T, getFileDataMetadata as Tt, SignalChannelMetaSchema as U, programmaticSignal as Ut, ProgrammaticSignal as V, parseCssColor as Vt, SignalDataSchema as W, progressSignal as Wt, TEXT_LAYER_DEFAULTS as X, resolveParam as Xt, SourceOperationSchema as Y, resolveNumber as Yt, TextOperationSchema as Z, resolveString as Zt, DataTypeVal as _, deserializeSignalData as _t, BaseVideoLayerPropsSchema as a, takeRenderDiagnostics as an, VideoStylePropsSchema as at, ExportResultSchema as b, formatHex as bt, COMPOSITOR_DEFAULTS as c, VirtualMediaDataSchema as ct, ConfigSchemaRegistry as d, computeVideoCropRenderProps as dt, serializeSignalData as en, TransitionSchema as et, DATA_TYPE_EXTENSIONS as f, computed as ft, DataType as g, dataTypeColors as gt, DEFAULT_MEDIA_DIMENSION as h, createVirtualMedia as ht, BaseMediaOperationPropsSchema as i, stampResult as in, VideoSpatialPropsSchema as it, MediaMetadataSchema as j, hasOnlySingleSource as jt, MAX_GRADIENT_STOPS as k, getRenderFingerprint as kt, Color as l, appendOperation as lt, DEFAULT_FPS as m, createOutputItemSchema as mt, AnyOutputUnionSchema as n, signalBuilder as nn, VideoAnimationSchema as nt, CAPTION_LAYER_DEFAULTS as o, timeSignal as on, VideoTextPropsSchema as ot, DEFAULT_DURATION_MS as p, cosineSignal as pt, SignalStatsSchema as q, resolveBoolean as qt, AudioExtractorSignalDataSchema as r, sineSignal as rn, VideoLayerTypeSchema as rt, COMPOSITE_OPERATIONS as s, updateClockSignals as sn, VideoTimingPropsSchema as st, AnimationTypeSchema as t, signal as tn, TransitionTypeSchema as tt, ConfigHandleSchema as u, checkNodeResultCache as ut, DataTypes as v, extractSvgDimensions as vt, GeneratorSignalDataSchema as w, getActiveMediaMetadata as wt, ExtendedLayerSchema as x, frameArraySignal as xt, Effect as y, findSourceAsset as yt, NodeVisualConfigSchema as z, normalizeColorStops as zt };
-//# sourceMappingURL=dist-ClyC_d66.mjs.map
+export { TimelineTransformSchema as $, parseCssGradient as $t, MIME_TYPES as A, getFingerprint as At, OutputItemSchema as B, isFrameIndex as Bt, FileDataSchema as C, fps as Ct, HandleTypeVal as D, generateId as Dt, Gradient as E, frameSignal as Et, ModerationUnrefundableError as F, handleId as Ft, SignalGateDataSchema as G, limitGradientStops as Gt, Signal as H, isSignal as Ht, MultiOutputGenericSchema as I, handleLabel as It, SingleOutputGenericSchema as J, nodeId as Jt, SignalMathDataSchema as K, mixColors as Kt, NodeMetadataSchema as L, hasOnlySingleSource as Lt, MediaOperationSchema as M, getMediaType as Mt, MediaSourceSchema as N, getRenderFingerprint as Nt, JsonValueSchema as O, getActiveMediaMetadata as Ot, ModerationError as P, gradientStopsToOklab as Pt, TimelineSegmentSchema as Q, parseCssColor as Qt, NodeResultSchema as R, isCssGradient as Rt, FileAssetSchema as S, formatHex as St, GlobalCompositeOperation as T, frameArraySignal as Tt, SignalChannelMetaSchema as U, isValueSignal as Ut, ProgrammaticSignal as V, isNormalized as Vt, SignalDataSchema as W, isVirtualMediaData as Wt, TEXT_LAYER_DEFAULTS as X, normalized as Xt, SourceOperationSchema as Y, normalizeColorStops as Yt, TextOperationSchema as Z, oklabToRgb as Zt, DataTypeVal as _, sineSignal as _n, dataTypeColors as _t, BaseVideoLayerPropsSchema as a, reportRenderDiagnostic as an, VideoStylePropsSchema as at, ExportResultSchema as b, timeSignal as bn, extractSvgDimensions as bt, COMPOSITOR_DEFAULTS as c, resolveNumber as cn, VirtualMediaDataSchema as ct, ConfigSchemaRegistry as d, rgbToOklab as dn, checkNodeResultCache as dt, pixels as en, TransitionSchema as et, DATA_TYPE_EXTENSIONS as f, sampleColorStops as fn, computeVideoCropRenderProps as ft, DataType as g, signalBuilder as gn, createVirtualMedia as gt, DEFAULT_MEDIA_DIMENSION as h, signal as hn, createOutputItemSchema as ht, BaseMediaOperationPropsSchema as i, registerSignalDependency as in, VideoSpatialPropsSchema as it, MediaMetadataSchema as j, getLeafMediaType as jt, MAX_GRADIENT_STOPS as k, getFileDataMetadata as kt, Color as l, resolveParam as ln, appendOperation as lt, DEFAULT_FPS as m, serializeSignalData as mn, cosineSignal as mt, AnyOutputUnionSchema as n, progressSignal as nn, VideoAnimationSchema as nt, CAPTION_LAYER_DEFAULTS as o, resolveBoolean as on, VideoTextPropsSchema as ot, DEFAULT_DURATION_MS as p, seconds as pn, computed as pt, SignalStatsSchema as q, ms as qt, AudioExtractorSignalDataSchema as r, radians as rn, VideoLayerTypeSchema as rt, COMPOSITE_OPERATIONS as s, resolveMediaMimeType as sn, VideoTimingPropsSchema as st, AnimationTypeSchema as t, programmaticSignal as tn, TransitionTypeSchema as tt, ConfigHandleSchema as u, resolveString as un, assertNever as ut, DataTypes as v, stampResult as vn, degrees as vt, GeneratorSignalDataSchema as w, frame as wt, ExtendedLayerSchema as x, updateClockSignals as xn, findSourceAsset as xt, Effect as y, takeRenderDiagnostics as yn, deserializeSignalData as yt, NodeVisualConfigSchema as z, isEqual as zt };
+//# sourceMappingURL=dist-TrtLGPvc.mjs.map