route-graphics 1.42.2 → 1.43.0

package/dist/cli/routeGraphicsCli.js

@@ -3618,6 +3618,7 @@ var AUDIO_TRANSITION_PROPERTY_RANGES = {
 };
 var AUDIO_EASINGS = new Set(SUPPORTED_EASING_NAMES);
 var AUDIO_TRANSITION_PHASE_KEYS = /* @__PURE__ */ new Set(["initialValue", "keyframes"]);
+var AUDIO_BOUNDARY_EFFECT_KEYS = /* @__PURE__ */ new Set(["keyframes"]);
 var AUDIO_TRANSITION_KEYFRAME_KEYS = /* @__PURE__ */ new Set([
   "value",
   "startValue",
@@ -3754,11 +3755,23 @@ var validateSound = (node, path5, ids, flattenedSounds, channelId = null) => {
     );
   }
   const playback = node.playback === void 0 ? void 0 : normalizePlaybackCommand(node.playback, `${path5}.playback`);
+  if (playback && (node.beginEffect || node.endEffect)) {
+    throw new Error(
+      `Input error: ${path5}.beginEffect and ${path5}.endEffect are not supported with transport-controlled playback.`
+    );
+  }
   if (node.transition !== void 0) {
     throw new Error(
       `Input error: ${path5}.transition is not supported. Use top-level audioEffects instead.`
     );
   }
+  for (const field of ["beginEffect", "endEffect"]) {
+    if (node[field] !== void 0) {
+      validateSoundBoundaryEffect(node[field], `${path5}.${field}`, {
+        endEffect: field === "endEffect"
+      });
+    }
+  }
   flattenedSounds.push({
     id: node.id,
     type: "sound",
@@ -3772,7 +3785,9 @@ var validateSound = (node, path5, ids, flattenedSounds, channelId = null) => {
     startAt: node.startAt ?? 0,
     endAt: node.endAt ?? null,
     channelId,
-    ...playback ? { playback } : {}
+    ...playback ? { playback } : {},
+    ...node.beginEffect ? { beginEffect: structuredClone(node.beginEffect) } : {},
+    ...node.endEffect ? { endEffect: structuredClone(node.endEffect) } : {}
   });
 };
 var validateChannel = (node, path5, ids, flattenedChannels, flattenedSounds) => {
@@ -3943,6 +3958,47 @@ var validateTransitionPhase = (phase, path5, propertyName) => {
     assertOptionalBoolean(keyframe.relative, `${keyframePath}.relative`);
   }
 };
+var getBoundaryTrackDurationMs = (track) => track.keyframes.reduce(
+  (duration, keyframe) => duration + (keyframe.delay ?? 0) + keyframe.duration,
+  0
+);
+function validateSoundBoundaryEffect(effect, path5, { endEffect = false } = {}) {
+  assertNonEmptyRecord(effect, path5);
+  for (const [propertyName, track] of Object.entries(effect)) {
+    if (!AUDIO_TRANSITION_PROPERTIES.has(propertyName)) {
+      throw new Error(
+        `Input error: unsupported sound boundary property "${propertyName}" at ${path5}.`
+      );
+    }
+    assertRecord(track, `${path5}.${propertyName}`);
+    for (const key of Object.keys(track)) {
+      if (!AUDIO_BOUNDARY_EFFECT_KEYS.has(key)) {
+        throw new Error(
+          `Input error: unsupported sound boundary field "${key}" at ${path5}.${propertyName}.`
+        );
+      }
+    }
+    validateTransitionPhase(track, `${path5}.${propertyName}`, propertyName);
+    if (track.keyframes.at(-1).relative === true) {
+      throw new Error(
+        `Input error: ${path5}.${propertyName}.keyframes must end with an absolute value.`
+      );
+    }
+  }
+  const playbackRateTrack = effect.playbackRate;
+  if (!endEffect || playbackRateTrack?.keyframes.at(-1).value !== 0) {
+    return;
+  }
+  const playbackRateDurationMs = getBoundaryTrackDurationMs(playbackRateTrack);
+  const effectDurationMs = Math.max(
+    ...Object.values(effect).map(getBoundaryTrackDurationMs)
+  );
+  if (playbackRateDurationMs < effectDurationMs) {
+    throw new Error(
+      `Input error: ${path5}.playbackRate cannot end at 0 before the other boundary tracks finish.`
+    );
+  }
+}
 var validateAudioTransition = (effect, path5) => {
   assertNonEmptyString3(effect.targetId, `${path5}.targetId`);
   assertNonEmptyRecord(effect.properties, `${path5}.properties`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "route-graphics",
-  "version": "1.42.2",
+  "version": "1.43.0",
   "description": "A 2D graphics rendering interface that takes JSON input and renders pixels using PixiJS",
   "main": "dist/RouteGraphics.js",
   "type": "module",