@kieransimkin/dancemoves 3.1.23 → 3.3.0

package/lib/index.mjs

@@ -102,6 +102,38 @@ function install(__dmScope) {
       return ticks;
     }
     var bpm = effectiveBpm(rawConfig.bpm);
+    var bpmSource = ["explicit", "analysis"].indexOf(rawConfig.bpmSource) >= 0 ? rawConfig.bpmSource : "fallback";
+    function beatAlignmentState(audio) {
+      var reading = rawConfig.beatAlignment;
+      if (!reading)
+        return { status: rawConfig.beatAlignmentStatus === "invalid" ? "invalid" : "unconfigured", applied: false };
+      var source = playbackAudio(audio);
+      var identity2 = source && (source.masterSourceUrl || source.masterId || source.currentSrc || source.src);
+      try {
+        if (!identity2 || new URL(String(identity2), document2.baseURI).href !== new URL(reading.source_url).href) {
+          return { status: "source-mismatch", applied: false };
+        }
+      } catch (error) {
+        return { status: "source-mismatch", applied: false };
+      }
+      return {
+        status: reading.phase_status,
+        applied: true,
+        firstBeatSeconds: reading.first_beat_seconds,
+        offsetPips: reading.offset_pips,
+        sourceSha256: reading.source_sha256,
+        bpmStatus: reading.bpm_status
+      };
+    }
+    function rhythmicTime(audio) {
+      var source = playbackAudio(audio);
+      var seconds = source && Number.isFinite(Number(source.currentTime)) ? Number(source.currentTime) : 0;
+      var state = beatAlignmentState(source);
+      return seconds - (state.applied ? state.firstBeatSeconds : 0);
+    }
+    function sourceTick(audio, bpmOverride) {
+      return rhythmicTime(audio) * effectiveBpm(bpmOverride || bpm) * TICKS_PER_BEAT / 60;
+    }
     function durationMilliseconds(ticks, bpmOverride) {
       return 3750 / effectiveBpm(bpmOverride || bpm) * quantizeTicks(ticks);
     }
@@ -109,7 +141,7 @@ function install(__dmScope) {
       var settings = options || {};
       var audio = playbackAudio(settings.audio) || (settings.clock === "audio" ? activeAudio : null);
       if (audio && !audio.paused && !audio.ended && Number.isFinite(Number(audio.currentTime))) {
-        return Number(audio.currentTime) * effectiveBpm(settings.bpm || bpm) * TICKS_PER_BEAT / 60;
+        return sourceTick(audio, settings.bpm);
       }
       var now = window2.performance && typeof window2.performance.now === "function" ? window2.performance.now() : Date.now();
       return Math.max(0, now - pageClockStarted) * effectiveBpm(settings.bpm || bpm) * TICKS_PER_BEAT / 6e4;
@@ -408,7 +440,7 @@ function install(__dmScope) {
         __dmScope.dataset(document2.documentElement, "danceMovesSharedControls", null);
       }
       __dmScope.dataset(document2.documentElement, "danceMovesBpm", String(bpm));
-      __dmScope.dataset(document2.documentElement, "danceMovesBpmSource", rawConfig.bpmSource === "explicit" ? "explicit" : "fallback");
+      __dmScope.dataset(document2.documentElement, "danceMovesBpmSource", bpmSource);
       __dmScope.dataset(document2.documentElement, "danceMovesVersion", String(rawConfig.version || ""));
     }
     function registerAnimationScope(root, selectors) {
@@ -944,7 +976,7 @@ function install(__dmScope) {
       var root = document2.querySelector(".ks-epk");
       if (root) {
         __dmScope.dataset(root, "danceMovesBpm", String(bpm));
-        __dmScope.dataset(root, "danceMovesBpmSource", rawConfig.bpmSource === "explicit" ? "explicit" : "fallback");
+        __dmScope.dataset(root, "danceMovesBpmSource", bpmSource);
         if (rawConfig.lyricTimingUrl)
           __dmScope.dataset(root, "danceMovesLyricTiming", String(rawConfig.lyricTimingUrl));
         if (rawConfig.cueTimingUrl)
@@ -973,11 +1005,14 @@ function install(__dmScope) {
     var api = {
       version: String(rawConfig.version || ""),
       bpm,
-      bpmSource: rawConfig.bpmSource === "explicit" ? "explicit" : "fallback",
+      bpmSource,
       ticksPerBeat: TICKS_PER_BEAT,
       quantizeTicks,
       durationMilliseconds,
       currentTick,
+      sourceTick,
+      rhythmicTime,
+      beatAlignmentState,
       nextIntervalTick,
       scheduleAtInterval,
       deferStart,
@@ -1032,7 +1067,7 @@ function install2(__dmScope) {
       return;
     var instances = /* @__PURE__ */ new Map();
     var serial2 = 0;
-    function finite2(value, fallback) {
+    function finite3(value, fallback) {
       value = Number(value);
       return Number.isFinite(value) ? value : fallback;
     }
@@ -1086,8 +1121,8 @@ function install2(__dmScope) {
         rect = bounds.getBoundingClientRect();
       }
       function apply(x, y, reason) {
-        latestX = clamp(finite2(x, 0), -1, 1);
-        latestY = clamp(finite2(y, 0), -1, 1);
+        latestX = clamp(finite3(x, 0), -1, 1);
+        latestY = clamp(finite3(y, 0), -1, 1);
         __dmScope.setStyle(state.root.style, "--dance-moves-x", latestX.toFixed(4));
         __dmScope.setStyle(state.root.style, "--dance-moves-y", latestY.toFixed(4));
         __dmScope.dataset(state.root, "danceMovesPointer", reason || "active");
@@ -1178,13 +1213,14 @@ function install2(__dmScope) {
       var audio = playbackElement(options.audio, state.root.querySelector("audio"));
       if (!audio)
         throw new Error("DanceMovesEffects pulse requires an audio element");
-      var ticks = Math.max(1, Math.round(finite2(options.ticks, 16)));
+      var ticks = Math.max(1, Math.round(finite3(options.ticks, 16)));
       var className = String(options.className || "dance-moves-playing");
       var prefix = String(options.propertyPrefix || "--dance-moves-pulse").replace(/-+$/, "");
       function sync() {
-        var rate = Math.max(0.01, finite2(audio.playbackRate, 1));
+        var rate = Math.max(0.01, finite3(audio.playbackRate, 1));
         var duration = motion.durationMilliseconds(ticks) / 1e3 / rate;
-        var phase = -(finite2(audio.currentTime, 0) / rate % duration);
+        var rhythmicSeconds = motion.rhythmicTime ? motion.rhythmicTime(audio) : finite3(audio.currentTime, 0);
+        var phase = -((rhythmicSeconds / rate % duration + duration) % duration);
         __dmScope.setStyle(state.root.style, prefix + "-duration", duration.toFixed(6) + "s");
         __dmScope.setStyle(state.root.style, prefix + "-delay", phase.toFixed(6) + "s");
         __dmScope.dataset(state.root, "danceMovesPulse", state.reduced.matches || state.forced.matches ? "inactive" : audio.paused ? "paused" : "playing");
@@ -1223,7 +1259,7 @@ function install2(__dmScope) {
       var state = commonState(options, "cue-class");
       var cue = String(options.cue || "*");
       var className = String(options.className || "dance-moves-cue-active");
-      var durationTicks = Math.max(1, Math.round(finite2(options.durationTicks, 16)));
+      var durationTicks = Math.max(1, Math.round(finite3(options.durationTicks, 16)));
       var timer = 0, count = 0;
       function clear(reason) {
         if (timer)
@@ -1279,16 +1315,16 @@ function install2(__dmScope) {
       if (!audio)
         throw new Error("DanceMovesEffects cueTimeline requires an audio element");
       var cues = (Array.isArray(options.cues) ? options.cues : []).map(function(cue, index) {
-        var time = finite2(cue && cue.time, NaN);
+        var time = finite3(cue && cue.time, NaN);
         if (!Number.isFinite(time) || time < 0)
           throw new TypeError("DanceMovesEffects cueTimeline cue time must be a non-negative number");
         return Object.freeze({ id: String(cue.id || "cue-" + index), time, end: Number.isFinite(Number(cue.end)) ? Number(cue.end) : null, data: cue.data });
       }).sort(function(a, b) {
         return a.time - b.time;
       });
-      var tolerance = Math.max(0, finite2(options.seekLandingTolerance, 0.05));
-      var maxCrossingGap = Math.max(0.05, finite2(options.maxCrossingGap, 1.25));
-      var fired = /* @__PURE__ */ new Set(), frame = 0, previous = finite2(audio.currentTime, 0), status = "idle", generation = 0, previousWall = 0;
+      var tolerance = Math.max(0, finite3(options.seekLandingTolerance, 0.05));
+      var maxCrossingGap = Math.max(0.05, finite3(options.maxCrossingGap, 1.25));
+      var fired = /* @__PURE__ */ new Set(), frame = 0, previous = finite3(audio.currentTime, 0), status = "idle", generation = 0, previousWall = 0;
       function blocked() {
         return document2.hidden || state.reduced.matches || state.forced.matches;
       }
@@ -1298,7 +1334,7 @@ function install2(__dmScope) {
         });
       }
       function publish(reason, extra) {
-        var time = finite2(audio.currentTime, 0);
+        var time = finite3(audio.currentTime, 0);
         __dmScope.dataset(state.root, "danceMovesCueTimeline", reason);
         if (typeof options.render === "function")
           options.render({ root: state.root, audio, time, previousTime: previous, reason, playing: !audio.paused && !audio.ended && !blocked(), active: activeAt(time), generation, detail: extra || null });
@@ -1308,10 +1344,10 @@ function install2(__dmScope) {
           return;
         fired.add(cue.id);
         if (typeof options.onCue === "function")
-          options.onCue({ root: state.root, audio, cue, time: finite2(audio.currentTime, cue.time), reason, generation });
+          options.onCue({ root: state.root, audio, cue, time: finite3(audio.currentTime, cue.time), reason, generation });
       }
       function rebuild(time, reason, allowLanding) {
-        time = Math.max(0, finite2(time, 0));
+        time = Math.max(0, finite3(time, 0));
         generation += 1;
         fired.clear();
         cues.forEach(function(cue) {
@@ -1337,7 +1373,7 @@ function install2(__dmScope) {
         frame = 0;
         if (audio.paused || audio.ended || blocked())
           return stop(audio.ended ? "ended" : blocked() ? "inactive" : "paused");
-        var now = Math.max(0, finite2(audio.currentTime, previous));
+        var now = Math.max(0, finite3(audio.currentTime, previous));
         var delta = now - previous;
         if (delta < -1e-3 || delta > maxCrossingGap)
           rebuild(now, "discontinuity", false);
@@ -1346,8 +1382,8 @@ function install2(__dmScope) {
             if (previous < cue.time && now >= cue.time)
               fire(cue, "crossing");
           });
-        var wallDelta = previousWall ? Math.min(0.25, Math.max(0, (finite2(wallNow, previousWall) - previousWall) / 1e3)) : 0;
-        previousWall = finite2(wallNow, previousWall);
+        var wallDelta = previousWall ? Math.min(0.25, Math.max(0, (finite3(wallNow, previousWall) - previousWall) / 1e3)) : 0;
+        previousWall = finite3(wallNow, previousWall);
         previous = now;
         status = "playing";
         publish("frame", { deltaSeconds: wallDelta });
@@ -1356,7 +1392,7 @@ function install2(__dmScope) {
       function start(reason) {
         if (frame || audio.paused || audio.ended || blocked())
           return publish(blocked() ? "inactive" : audio.ended ? "ended" : "paused");
-        previous = Math.max(0, finite2(audio.currentTime, 0));
+        previous = Math.max(0, finite3(audio.currentTime, 0));
         previousWall = 0;
         status = reason || "playing";
         publish(status);
@@ -1420,7 +1456,7 @@ function install2(__dmScope) {
         start,
         stop,
         snapshot: function() {
-          return { id: state.id, type: "cue-timeline", status, time: finite2(audio.currentTime, 0), previousTime: previous, generation, fired: Array.from(fired), active: activeAt(finite2(audio.currentTime, 0)).map(function(cue) {
+          return { id: state.id, type: "cue-timeline", status, time: finite3(audio.currentTime, 0), previousTime: previous, generation, fired: Array.from(fired), active: activeAt(finite3(audio.currentTime, 0)).map(function(cue) {
             return cue.id;
           }) };
         },
@@ -1443,28 +1479,28 @@ function install2(__dmScope) {
       if (!target)
         throw new Error("DanceMovesEffects spritePlayback requires a target element");
       var frameMap = Array.isArray(options.frameMap) && options.frameMap.length ? options.frameMap.map(function(value) {
-        value = Math.floor(finite2(value, -1));
+        value = Math.floor(finite3(value, -1));
         if (value < 0)
           throw new TypeError("DanceMovesEffects spritePlayback frameMap values must be non-negative integers");
         return value;
       }) : null;
-      var frameCount = frameMap ? frameMap.length : Math.max(1, Math.round(finite2(options.frameCount, 1)));
-      var columns = Math.max(1, Math.round(finite2(options.columns, frameCount)));
-      var framesPerRow = clamp(Math.round(finite2(options.framesPerRow, columns)), 1, columns);
-      var columnOffset = clamp(Math.round(finite2(options.columnOffset, 0)), 0, columns - framesPerRow);
-      var rowOffset = Math.max(0, Math.round(finite2(options.rowOffset, 0)));
-      var cycleTicks = Math.max(1, Math.round(finite2(options.cycleTicks, 32)));
-      var phaseOffsetSeconds = finite2(options.phaseOffsetSeconds, 0);
-      var staticFrame = clamp(Math.round(finite2(options.staticFrame, 0)), 0, frameCount - 1);
+      var frameCount = frameMap ? frameMap.length : Math.max(1, Math.round(finite3(options.frameCount, 1)));
+      var columns = Math.max(1, Math.round(finite3(options.columns, frameCount)));
+      var framesPerRow = clamp(Math.round(finite3(options.framesPerRow, columns)), 1, columns);
+      var columnOffset = clamp(Math.round(finite3(options.columnOffset, 0)), 0, columns - framesPerRow);
+      var rowOffset = Math.max(0, Math.round(finite3(options.rowOffset, 0)));
+      var cycleTicks = Math.max(1, Math.round(finite3(options.cycleTicks, 32)));
+      var phaseOffsetSeconds = finite3(options.phaseOffsetSeconds, 0);
+      var staticFrame = clamp(Math.round(finite3(options.staticFrame, 0)), 0, frameCount - 1);
       var prefix = String(options.propertyPrefix || "--dance-moves-sprite").replace(/-+$/, "");
       if (prefix.slice(0, 2) !== "--")
         prefix = "--" + prefix.replace(/^-+/, "");
       var tiers = Array.isArray(options.qualityTiers) && options.qualityTiers.length ? options.qualityTiers.map(String) : ["full", "constrained", "minimal"];
       var suppliedFps = Array.isArray(options.qualityFramesPerSecond) ? options.qualityFramesPerSecond : [60, 30, 15];
       var qualityFps = tiers.map(function(_, index) {
-        return Math.max(1, finite2(suppliedFps[index], suppliedFps[suppliedFps.length - 1] || 15));
+        return Math.max(1, finite3(suppliedFps[index], suppliedFps[suppliedFps.length - 1] || 15));
       });
-      var qualityIndex = clamp(Math.round(finite2(options.initialQuality, 0)), 0, tiers.length - 1);
+      var qualityIndex = clamp(Math.round(finite3(options.initialQuality, 0)), 0, tiers.length - 1);
       var frame = 0, status = "idle", lastWall = -Infinity, renders = 0, latest = null;
       function blocked() {
         return document2.hidden || state.reduced.matches || state.forced.matches;
@@ -1474,9 +1510,10 @@ function install2(__dmScope) {
         return { sourceFrame, column: sourceFrame % columns, row: Math.floor(sourceFrame / columns) };
       }
       function calculate(reason, staticFallback) {
-        var cycleSeconds = Math.max(1e-3, finite2(motion.durationMilliseconds(cycleTicks), 1) / 1e3);
-        var time = Math.max(0, finite2(audio.currentTime, 0));
-        var phase = ((time - phaseOffsetSeconds) % cycleSeconds + cycleSeconds) % cycleSeconds / cycleSeconds;
+        var cycleSeconds = Math.max(1e-3, finite3(motion.durationMilliseconds(cycleTicks), 1) / 1e3);
+        var time = Math.max(0, finite3(audio.currentTime, 0));
+        var rhythmicSeconds = motion.rhythmicTime ? motion.rhythmicTime(audio) : time;
+        var phase = ((rhythmicSeconds - phaseOffsetSeconds) % cycleSeconds + cycleSeconds) % cycleSeconds / cycleSeconds;
         var localFrame = staticFallback ? staticFrame : Math.min(frameCount - 1, Math.floor(phase * frameCount + 1e-9));
         var mapped = mappedFrame(localFrame);
         return {
@@ -1530,8 +1567,8 @@ function install2(__dmScope) {
         if (audio.paused || audio.ended || blocked())
           return stop(audio.ended ? "ended" : blocked() ? "inactive" : "paused", audio.ended || blocked());
         var minimumInterval = 1e3 / qualityFps[qualityIndex];
-        if (!Number.isFinite(lastWall) || finite2(wallNow, lastWall) - lastWall >= minimumInterval - 0.01) {
-          lastWall = finite2(wallNow, lastWall);
+        if (!Number.isFinite(lastWall) || finite3(wallNow, lastWall) - lastWall >= minimumInterval - 0.01) {
+          lastWall = finite3(wallNow, lastWall);
           status = "playing";
           publish("frame", false);
         }
@@ -1562,7 +1599,7 @@ function install2(__dmScope) {
       }
       function setQuality(value, reason) {
         var named = typeof value === "string" ? tiers.indexOf(value) : -1;
-        qualityIndex = named >= 0 ? named : clamp(Math.round(finite2(value, qualityIndex)), 0, tiers.length - 1);
+        qualityIndex = named >= 0 ? named : clamp(Math.round(finite3(value, qualityIndex)), 0, tiers.length - 1);
         lastWall = -Infinity;
         publish(reason || "quality-change", audio.ended || blocked());
       }
@@ -1616,7 +1653,7 @@ function install2(__dmScope) {
         },
         setQuality,
         snapshot: function() {
-          return { id: state.id, type: "sprite-playback", status, time: finite2(audio.currentTime, 0), frame: latest ? latest.frame : null, localFrame: latest ? latest.localFrame : null, column: latest ? latest.column : null, row: latest ? latest.row : null, phase: latest ? latest.phase : null, cycleTicks, cycleSeconds: latest ? latest.cycleSeconds : null, qualityTier: tiers[qualityIndex], qualityIndex, renders, running: Boolean(frame) };
+          return { id: state.id, type: "sprite-playback", status, time: finite3(audio.currentTime, 0), frame: latest ? latest.frame : null, localFrame: latest ? latest.localFrame : null, column: latest ? latest.column : null, row: latest ? latest.row : null, phase: latest ? latest.phase : null, cycleTicks, cycleSeconds: latest ? latest.cycleSeconds : null, qualityTier: tiers[qualityIndex], qualityIndex, renders, running: Boolean(frame) };
         },
         teardown: function() {
           stop("teardown", true);
@@ -1683,8 +1720,8 @@ function install2(__dmScope) {
       popover.appendChild(viewport);
       __dmScope.dataset(popover, "danceMovesLyricStage", "ready");
       __dmScope.setStyle(popover.style, "--dance-moves-lyric-progress", "0");
-      var travelTicks = Math.max(1, Math.round(finite2(options.travelTicks, 32)));
-      var defaultCueTicks = Math.max(1, Math.round(finite2(options.cueDurationTicks, 32)));
+      var travelTicks = Math.max(1, Math.round(finite3(options.travelTicks, 32)));
+      var defaultCueTicks = Math.max(1, Math.round(finite3(options.cueDurationTicks, 32)));
       var latest = null, phase = "idle", progress = 0, frame = 0, wakeTimer = 0, cueTimer = 0, cueCleanup = null, cueCount = 0;
       var lyricEffects = [];
       var slots = Object.freeze({ previous, current, next, viewport, track });
@@ -1733,7 +1770,7 @@ function install2(__dmScope) {
         publish(reason || value);
       }
       function setProgress(value) {
-        progress = clamp(finite2(value, 0), 0, 1);
+        progress = clamp(finite3(value, 0), 0, 1);
         __dmScope.setStyle(popover.style, "--dance-moves-lyric-progress", progress.toFixed(5));
       }
       function copyLyrics(detail) {
@@ -1750,7 +1787,7 @@ function install2(__dmScope) {
         var cleanup = typeof result === "function" ? result : typeof result.cleanup === "function" ? result.cleanup : null;
         if (!cleanup)
           return;
-        var durationTicks = result && typeof result === "object" ? Math.max(1, Math.round(finite2(result.durationTicks, 64))) : 64;
+        var durationTicks = result && typeof result === "object" ? Math.max(1, Math.round(finite3(result.durationTicks, 64))) : 64;
         var record = { cleanup, timer: 0 };
         record.timer = window2.setTimeout(function() {
           lyricEffects = lyricEffects.filter(function(item) {
@@ -1776,7 +1813,7 @@ function install2(__dmScope) {
           setProgress(0);
           return setPhase("waiting", "no-next-line");
         }
-        var now = Math.max(0, finite2(audio.currentTime, 0));
+        var now = Math.max(0, finite3(audio.currentTime, 0));
         if (now < windowRange.start)
           return reconcile("frame-before-window");
         if (now >= windowRange.end) {
@@ -1806,7 +1843,7 @@ function install2(__dmScope) {
           setProgress(0);
           return setPhase("waiting", reason || "no-next-line");
         }
-        var now = Math.max(0, finite2(audio.currentTime, 0));
+        var now = Math.max(0, finite3(audio.currentTime, 0));
         if (now >= windowRange.end) {
           setProgress(1);
           return setPhase("arrived", reason || "arrived");
@@ -1821,7 +1858,7 @@ function install2(__dmScope) {
         wakeTimer = window2.setTimeout(function() {
           wakeTimer = 0;
           tick();
-        }, Math.max(0, (windowRange.start - now) * 1e3 / Math.max(0.01, finite2(audio.playbackRate, 1))));
+        }, Math.max(0, (windowRange.start - now) * 1e3 / Math.max(0.01, finite3(audio.playbackRate, 1))));
       }
       function onLyric(detail) {
         var previousDetail = latest;
@@ -1876,7 +1913,7 @@ function install2(__dmScope) {
         else if (result && typeof result === "object") {
           if (typeof result.cleanup === "function")
             cueCleanup = result.cleanup;
-          durationTicks = Math.max(1, Math.round(finite2(result.durationTicks, defaultCueTicks)));
+          durationTicks = Math.max(1, Math.round(finite3(result.durationTicks, defaultCueTicks)));
         }
         cueTimer = window2.setTimeout(function() {
           clearCue("complete");
@@ -1948,16 +1985,16 @@ function install2(__dmScope) {
       var hazardSources = Array.isArray(options.hazardSources) ? options.hazardSources.filter(Boolean).map(String) : [];
       if (!shipSources.length || !hazardSources.length)
         throw new Error("DanceMovesEffects cooperativeArena requires ship and hazard sources");
-      var shipCount = clamp(Math.round(finite2(options.shipCount, 3)), 2, 12);
-      var hazardCount = clamp(Math.round(finite2(options.hazardCount, 8)), 3, 48);
-      var speed = clamp(finite2(options.speed, 1), 0.35, 2.4);
+      var shipCount = clamp(Math.round(finite3(options.shipCount, 3)), 2, 12);
+      var hazardCount = clamp(Math.round(finite3(options.hazardCount, 8)), 3, 48);
+      var speed = clamp(finite3(options.speed, 1), 0.35, 2.4);
       var inlineTransform = options.inlineTransform === true;
-      var bpm = Math.max(1, finite2(options.bpm, motion.bpm || 120));
-      var shotIntervalTicks = clamp(Math.round(finite2(options.shotIntervalTicks, 32)), 4, 256);
+      var bpm = Math.max(1, finite3(options.bpm, motion.bpm || 120));
+      var shotIntervalTicks = clamp(Math.round(finite3(options.shotIntervalTicks, 32)), 4, 256);
       var shotIntervalSeconds = motion.durationMilliseconds ? motion.durationMilliseconds(shotIntervalTicks, bpm) / 1e3 : shotIntervalTicks * 60 / (bpm * 16);
-      var burstDurationSeconds = clamp(finite2(options.burstDurationBeats, 1.5), 0.1, 8) * 60 / bpm;
-      var shipHitboxScale = clamp(finite2(options.shipHitboxScale, 1), 0.4, 1);
-      var hazardHitboxScale = clamp(finite2(options.hazardHitboxScale, 1), 0.4, 1);
+      var burstDurationSeconds = clamp(finite3(options.burstDurationBeats, 1.5), 0.1, 8) * 60 / bpm;
+      var shipHitboxScale = clamp(finite3(options.shipHitboxScale, 1), 0.4, 1);
+      var hazardHitboxScale = clamp(finite3(options.hazardHitboxScale, 1), 0.4, 1);
       var removers = state.removers, ships = [], hazards = [], shots = [], bursts = [], burstTimers = [];
       var activeShips = shipCount, activeHazards = hazardCount;
       var width = 1, height = 1, frame = 0, last = 0, elapsed = 0, nextShot = 0, hits = 0;
@@ -2289,7 +2326,7 @@ function install2(__dmScope) {
           reconcile(reason || "manual");
         },
         setDensity: function(nextShips, nextHazards) {
-          var shipsNext = clamp(Math.round(finite2(nextShips, activeShips)), 2, shipCount), hazardsNext = clamp(Math.round(finite2(nextHazards, activeHazards)), 3, hazardCount);
+          var shipsNext = clamp(Math.round(finite3(nextShips, activeShips)), 2, shipCount), hazardsNext = clamp(Math.round(finite3(nextHazards, activeHazards)), 3, hazardCount);
           if (shipsNext === activeShips && hazardsNext === activeHazards)
             return;
           activeShips = shipsNext;
@@ -2332,12 +2369,12 @@ function install2(__dmScope) {
       options = options || {};
       var state = commonState(options, "quality");
       var tiers = Array.isArray(options.tiers) && options.tiers.length ? options.tiers.map(String) : ["full", "constrained", "minimal"];
-      var index = clamp(Math.round(finite2(options.initial, 0)), 0, tiers.length - 1);
-      var sampleMs = Math.max(800, finite2(options.sampleMilliseconds, 1600));
-      var poorWindows = Math.max(2, Math.round(finite2(options.poorWindows, 2)));
-      var healthyWindows = Math.max(3, Math.round(finite2(options.healthyWindows, 5)));
-      var downgradeRatio = clamp(finite2(options.downgradeRatio, 0.72), 0.2, 0.95);
-      var recoveryRatio = clamp(finite2(options.recoveryRatio, 0.9), downgradeRatio, 1);
+      var index = clamp(Math.round(finite3(options.initial, 0)), 0, tiers.length - 1);
+      var sampleMs = Math.max(800, finite3(options.sampleMilliseconds, 1600));
+      var poorWindows = Math.max(2, Math.round(finite3(options.poorWindows, 2)));
+      var healthyWindows = Math.max(3, Math.round(finite3(options.healthyWindows, 5)));
+      var downgradeRatio = clamp(finite3(options.downgradeRatio, 0.72), 0.2, 0.95);
+      var recoveryRatio = clamp(finite3(options.recoveryRatio, 0.9), downgradeRatio, 1);
       var frame = 0, frames = 0, start = 0, reference = 0, poor = 0, healthy = 0, lastShift = 0, running = true;
       var preferenceLimited = false, tierBeforePreference = index;
       function publish(reason, sample) {
@@ -2381,12 +2418,12 @@ function install2(__dmScope) {
             poor = 0;
             healthy = 0;
           }
-          if (poor >= poorWindows && index < tiers.length - 1 && now - lastShift >= finite2(options.downgradeCooldownMilliseconds, 5e3)) {
+          if (poor >= poorWindows && index < tiers.length - 1 && now - lastShift >= finite3(options.downgradeCooldownMilliseconds, 5e3)) {
             index += 1;
             poor = 0;
             lastShift = now;
             publish("sustained-low-fps", { fps });
-          } else if (healthy >= healthyWindows && index > 0 && now - lastShift >= finite2(options.recoveryCooldownMilliseconds, 12e3)) {
+          } else if (healthy >= healthyWindows && index > 0 && now - lastShift >= finite3(options.recoveryCooldownMilliseconds, 12e3)) {
             index -= 1;
             healthy = 0;
             lastShift = now;
@@ -2425,7 +2462,7 @@ function install2(__dmScope) {
         id: state.id,
         type: "quality",
         setTier: function(value, reason) {
-          index = clamp(Math.round(finite2(value, index)), 0, tiers.length - 1);
+          index = clamp(Math.round(finite3(value, index)), 0, tiers.length - 1);
           publish(reason || "manual");
         },
         snapshot: function() {
@@ -4895,8 +4932,9 @@ function install9(__dmScope) {
           anchor = 0;
         lastClock = mode;
         const tempo = bpm();
-        const beats = useAudio ? Math.max(0, Number.isFinite(audio.currentTime) ? audio.currentTime : 0) * tempo / 60 : motion.currentTick({ clock: "page" }) / 16;
-        return { beats, mode, tempo };
+        const sourceBeats = useAudio ? Math.max(0, Number.isFinite(audio.currentTime) ? audio.currentTime : 0) * tempo / 60 : motion.currentTick({ clock: "page" }) / 16;
+        const beats = useAudio && motion.sourceTick ? motion.sourceTick(audio) / 16 : sourceBeats;
+        return { beats, sourceBeats, mode, tempo };
       }
       function blocked() {
         if (!enabled)
@@ -4934,7 +4972,8 @@ function install9(__dmScope) {
           audio: s.mode === "audio" ? audio : null,
           rudiment: row.name,
           clock: s.mode,
-          sourceBeats: s.beats,
+          sourceBeats: s.sourceBeats,
+          rhythmicBeats: s.beats,
           bpm: s.tempo,
           rate,
           pip: neutral ? null : pip,
@@ -5480,6 +5519,35 @@ function createScope(root, config, { legacyGlobals = false, nonce, orientation =
   return api;
 }
 
+// .build/modules/beat-alignment.mjs
+var hash = (value) => typeof value === "string" && /^[a-f0-9]{64}$/.test(value);
+function rational(value, label) {
+  if (typeof value !== "string" || !/^-?\d{1,80}(?:\/[1-9]\d{0,79})?$/.test(value)) throw new TypeError(`Invalid exact ${label}`);
+  const [n, d = "1"] = value.split("/");
+  return [BigInt(n), BigInt(d)];
+}
+function numeric(value, label, min, max) {
+  if (typeof value !== "number" || !Number.isFinite(value) || value < min || value > max) throw new RangeError(`Invalid ${label}`);
+  return value;
+}
+function validateBeatAlignment(input) {
+  if (input === void 0 || input === null || input === "") return null;
+  if (!input || typeof input !== "object" || Array.isArray(input) || input.schema !== "stemlab.beat-alignment.v1" || input.pips_per_beat !== 64 || input.canonical_first_beat_pip !== 0 || !hash(input.source_sha256) || !hash(input.evidence_sha256) || !hash(input.report_sha256)) throw new TypeError("Invalid source-bound StemLab beat alignment");
+  const bpm = numeric(input.bpm, "alignment BPM", 20, 400);
+  const first = numeric(input.first_beat_seconds, "first beat", 0, 86400);
+  const offset = numeric(input.offset_pips, "pip offset", -36864e3, 0);
+  const [bn, bd] = rational(input.exact_bpm, "BPM"), [fn, fd] = rational(input.first_beat_exact_seconds, "first beat"), [pn, pd] = rational(input.exact_offset_pips, "pip offset");
+  if (fn * bn * 64n * pd + pn * fd * bd * 60n !== 0n || bn <= 0n || fn < 0n || Math.abs(Number(bn) / Number(bd) - bpm) > 1e-9 || Math.abs(Number(fn) / Number(fd) - first) > 1e-9 || Math.abs(Number(pn) / Number(pd) - offset) > 1e-7) throw new RangeError("Exact beat alignment and numeric clock disagree");
+  if (!["canonical", "estimated"].includes(input.bpm_status) || !["estimated", "confirmed", "synthetic"].includes(input.phase_status)) throw new TypeError("Alignment authority is required");
+  for (const key of ["analysis_id", "bpm_basis"]) if (typeof input[key] !== "string" || !/^[a-zA-Z0-9_.-]{1,128}$/.test(input[key])) throw new TypeError(`Invalid ${key}`);
+  if (input.source_audio_verified !== true || !input.source_audio || !Number.isSafeInteger(input.source_audio.num_frames) || input.source_audio.num_frames < 1 || !Number.isSafeInteger(input.source_audio.sample_rate) || input.source_audio.sample_rate < 1 || first >= input.source_audio.num_frames / input.source_audio.sample_rate) throw new TypeError("Verified source audio frame bounds are required");
+  const sourceUrl = input.source_url;
+  if (typeof sourceUrl !== "string" || sourceUrl.length > 4096 || /[\u0000-\u001f]/.test(sourceUrl)) throw new TypeError("An exact verified master URL is required");
+  const parsed = new URL(sourceUrl);
+  if (!["http:", "https:"].includes(parsed.protocol) || parsed.username || parsed.password || parsed.hash) throw new TypeError("Invalid verified master URL");
+  return Object.freeze({ ...input, bpm, first_beat_seconds: first, offset_pips: offset, source_audio: Object.freeze({ ...input.source_audio }) });
+}
+
 // .build/modules/config.mjs
 var PAGE_META_KEYS = Object.freeze({
   bpm: "_dance_moves_bpm",
@@ -5487,7 +5555,9 @@ var PAGE_META_KEYS = Object.freeze({
   cue: "_dance_moves_cue_timing_id",
   popups: "_dance_moves_lyric_popups_enabled",
   duration: "_dance_moves_master_duration_ms",
-  effect: "_dance_moves_effect"
+  effect: "_dance_moves_effect",
+  alignment: "_dance_moves_beat_alignment",
+  alignmentAudio: "_dance_moves_beat_alignment_audio_id"
 });
 var object = (value) => value && typeof value === "object" && !Array.isArray(value);
 function finite(value, name, min, max) {
@@ -5506,7 +5576,11 @@ function url(value, name) {
 function validatePageConfig(input = {}) {
   if (!object(input)) throw new TypeError("Page configuration must be an object");
   const explicit = input.bpm !== void 0 && input.bpm !== null && input.bpm !== "";
-  const bpm = explicit ? Math.round(finite(input.bpm, "bpm", 20, 400) * 1e3) / 1e3 : 120;
+  const beatAlignment = validateBeatAlignment(input.beatAlignment);
+  const canonicalExplicit = explicit && !["fallback", "analysis"].includes(input.bpmSource);
+  if (canonicalExplicit && beatAlignment && Math.abs(input.bpm - beatAlignment.bpm) > 500001e-9) throw new RangeError("Stored BPM and selected beat alignment disagree; select a matching BPM basis");
+  const bpm = beatAlignment ? beatAlignment.bpm : explicit ? Math.round(finite(input.bpm, "bpm", 20, 400) * 1e3) / 1e3 : 120;
+  if (explicit) finite(input.bpm, "bpm", 20, 400);
   const effect = input.effect ?? "";
   if (!["", "paper-planes"].includes(effect)) throw new RangeError("effect must be empty or paper-planes");
   if (input.lyricPopupsEnabled !== void 0 && typeof input.lyricPopupsEnabled !== "boolean") throw new TypeError("lyricPopupsEnabled must be boolean");
@@ -5518,8 +5592,9 @@ function validatePageConfig(input = {}) {
   return Object.freeze({
     pageId,
     bpm,
-    bpmSource: explicit && input.bpmSource !== "fallback" ? "explicit" : "fallback",
+    bpmSource: canonicalExplicit ? "explicit" : beatAlignment ? "analysis" : "fallback",
     fallbackBpm: 120,
+    beatAlignment,
     ticksPerBeat: 16,
     tickDefinition: "sixteenth-of-beat",
     longDurationQuantumTicks: 16,
@@ -5535,9 +5610,9 @@ function validatePageConfig(input = {}) {
 }
 async function fromWordPressMeta(meta, resolveAttachment) {
   if (!object(meta)) throw new TypeError("meta must be an object");
-  const numeric = (value) => value !== "" && value !== null && value !== void 0 && Number.isFinite(Number(value));
+  const numeric2 = (value) => value !== "" && value !== null && value !== void 0 && Number.isFinite(Number(value));
   const b = meta[PAGE_META_KEYS.bpm];
-  const bpm = numeric(b) && Number(b) >= 20 && Number(b) <= 400 ? Number(b) : void 0;
+  const bpm = numeric2(b) && Number(b) >= 20 && Number(b) <= 400 ? Number(b) : void 0;
   const resolve = async (key) => {
     const value = Number(meta[key] || 0);
     if (!Number.isSafeInteger(value)) throw new RangeError("Attachment ID must be a safe integer");
@@ -5547,8 +5622,15 @@ async function fromWordPressMeta(meta, resolveAttachment) {
     return await resolveAttachment(id) || "";
   };
   const duration = Number(meta[PAGE_META_KEYS.duration]);
+  let beatAlignment = meta[PAGE_META_KEYS.alignment] || null;
+  if (typeof beatAlignment === "string") {
+    if (beatAlignment.length > 16384) throw new RangeError("Beat alignment exceeds 16 KiB");
+    beatAlignment = JSON.parse(beatAlignment);
+  }
+  if (beatAlignment) beatAlignment = { ...beatAlignment, source_url: await resolve(PAGE_META_KEYS.alignmentAudio) };
   return validatePageConfig({
     bpm,
+    beatAlignment,
     lyricTimingUrl: await resolve(PAGE_META_KEYS.lyric),
     cueTimingUrl: await resolve(PAGE_META_KEYS.cue),
     lyricPopupsEnabled: meta[PAGE_META_KEYS.popups] === true || String(meta[PAGE_META_KEYS.popups]) === "1",
@@ -6089,7 +6171,8 @@ function installPlayback(scope, api, host = scope.document.defaultView) {
       error: { get: () => read().error || null },
       element: { value: isNative ? master : null },
       activePlayer: { get: () => delegate ? delegate.activePlayer : active.element },
-      masterId: { get: () => delegate ? delegate.masterId : master.currentSrc || master.src || master.id }
+      masterId: { get: () => delegate ? delegate.masterId : master.currentSrc || master.src || master.id },
+      masterSourceUrl: { get: () => delegate ? delegate.masterSourceUrl : reference?.sourceUrl || master.currentSrc || master.src || "" }
     });
     transport.matches = (selector) => target.matches(selector);
     transport.getAttribute = (name) => target.getAttribute(name);
@@ -6403,6 +6486,184 @@ function installPlayback(scope, api, host = scope.document.defaultView) {
   });
 }
 
+// .build/modules/recordings.mjs
+var WASM = "AGFzbQEAAAABDwJgAAF/YAZ/f39/f38BfAMDAgABBQUBAQKAQAYIAX8BQYCIBAsHKgMGbWVtb3J5AgAKdGFibGVfYmFzZQAAEHNhbXBsZV9yZWNvcmRpbmcAAQpvAggAQYCIhIAAC2QCAXwBfkQAAAAAAAD4fyEGAkAgAEUNACABQQFIDQAgAkEBSA0AIAVBAEgNACAFIAJPDQAgBKwgA6x9IgdCAFMNACAHIAGtWg0AIAAgB6cgAmxBA3RqIAVBA3RqKwMAIQYLIAYL";
+var MAX_VALUES = 8388608;
+var MAX_BYTES = 64 * 1024 * 1024;
+var modulePromise;
+var finite2 = (n, label) => {
+  if (typeof n !== "number" || !Number.isFinite(n)) throw new TypeError(label + " must be finite");
+  return n;
+};
+function validateRecording(input) {
+  if (!input || input.format !== "dancerudiments.recording" || input.schema_version !== 1 || input.pips_per_beat !== 64 || input.sample_dtype !== "float64") throw new TypeError("Expected dancerudiments.recording v1, float64, 64 pips per beat");
+  if (typeof input.name !== "string" || !input.name.length || input.name.length > 128) throw new TypeError("Recording name is required");
+  const dimensions = input.dimensions;
+  if (!Array.isArray(dimensions) || !dimensions.length || dimensions.length > 64 || new Set(dimensions).size !== dimensions.length || dimensions.some((d) => typeof d !== "string" || !/^[a-z][a-z0-9_]{0,127}$/.test(d))) throw new TypeError("Recording requires 1..64 unique named dimensions");
+  const c = input.clock;
+  if (!c || finite2(c.bpm, "Recording BPM") <= 0 || !["confirmed", "estimated"].includes(c.bpm_status) || !["unverified", "estimated", "supplied"].includes(c.phase_status) || typeof c.bpm_source !== "string" || !c.bpm_source.trim()) throw new TypeError("Recording clock requires BPM and provenance");
+  finite2(c.beat_zero_seconds, "Beat zero");
+  if (!Number.isInteger(c.start_pip) || c.start_pip < -2147483648) throw new RangeError("Invalid recording start pip");
+  const rows = input.samples;
+  if (!Array.isArray(rows) || !rows.length || rows.length * dimensions.length > MAX_VALUES || c.start_pip + rows.length > 2147483647) throw new RangeError("Recording exceeds bounded sample limits");
+  const values = new Float64Array(rows.length * dimensions.length);
+  rows.forEach((row, i) => {
+    if (!Array.isArray(row) || row.length !== dimensions.length) throw new TypeError("Recording sample dimensions differ");
+    row.forEach((v, j) => {
+      finite2(v, "Sample");
+      if (Math.abs(v) > 1) throw new RangeError("Recording samples must be in [-1,1]");
+      values[i * dimensions.length + j] = v;
+    });
+  });
+  return Object.freeze({ name: input.name, dimensions: Object.freeze([...dimensions]), count: rows.length, clock: Object.freeze({ ...c }), values });
+}
+async function samplerFromData(data) {
+  if (!modulePromise) modulePromise = WebAssembly.compile(Uint8Array.from(atob(WASM), (c) => c.charCodeAt(0))).catch((error) => {
+    modulePromise = null;
+    throw error;
+  });
+  const api = (await WebAssembly.instantiate(await modulePromise, {})).exports;
+  const base = api.table_base(), pages = Math.ceil((base + data.values.byteLength - api.memory.buffer.byteLength) / 65536);
+  if (pages > 0) api.memory.grow(pages);
+  new Float64Array(api.memory.buffer, base, data.values.length).set(data.values);
+  return Object.freeze({ ...data, sample(pip) {
+    if (!Number.isInteger(pip) || pip < data.clock.start_pip || pip >= data.clock.start_pip + data.count) throw new RangeError("Position is outside the non-looping recording");
+    return data.dimensions.map((_, axis) => api.sample_recording(base, data.count, data.dimensions.length, data.clock.start_pip, pip, axis));
+  } });
+}
+function createRecordingService(scope, rudiments, config) {
+  const handles = /* @__PURE__ */ new Map();
+  async function load(url2) {
+    if (scope.disposed) throw new Error("DanceMoves mount is destroyed");
+    const response = await scope.window.fetch(url2);
+    if (!response.ok) throw new Error("Recording request failed: " + response.status);
+    if (Number(response.headers?.get("content-length")) > MAX_BYTES) throw new RangeError("Recording exceeds 64 MiB");
+    let text;
+    if (response.body?.getReader) {
+      const reader = response.body.getReader(), chunks = [];
+      let size = 0;
+      for (; ; ) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        size += value.byteLength;
+        if (size > MAX_BYTES) {
+          await reader.cancel();
+          throw new RangeError("Recording exceeds 64 MiB");
+        }
+        chunks.push(value);
+      }
+      const bytes = new Uint8Array(size);
+      let offset = 0;
+      for (const chunk of chunks) {
+        bytes.set(chunk, offset);
+        offset += chunk.length;
+      }
+      text = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+    } else {
+      text = await response.text();
+      if (new TextEncoder().encode(text).length > MAX_BYTES) throw new RangeError("Recording exceeds 64 MiB");
+    }
+    const input = JSON.parse(text);
+    validateRecording(input);
+    return input;
+  }
+  function animate(options = {}) {
+    if (scope.disposed) throw new Error("DanceMoves mount is destroyed");
+    if (typeof options.id !== "string" || !options.id.trim() || handles.has(options.id)) throw new TypeError("Recording controller requires a unique id");
+    if (typeof options.render !== "function") throw new TypeError("Recording render callback is required");
+    if (!options.audio) throw new TypeError("Recording playback requires an audio/player source");
+    if (["rate", "phasePips", "clock", "bpm"].some((k) => Object.hasOwn(options, k))) throw new TypeError("Recording clock, rate and origin come from its capture");
+    const data = validateRecording(options.recording);
+    if (Math.abs(data.clock.bpm - config.bpm) > 1e-9) throw new RangeError("Recording BPM does not match the authoritative page BPM");
+    let inner = null, sampler = null, destroyed = false, enabled = options.enabled !== false, paused = false, status = "loading", error = null, last = null;
+    const output = (frame, values, pip, reason) => {
+      if (destroyed) return;
+      last = { ...frame, rudiment: null, recording: data.name, dimensions: data.dimensions, values, position: { x: values[0] || 0, y: values[1] || 0, z: values[2] || 0 }, pip, positionPips: pip, loopProgress: null, reason };
+      options.render(last);
+    };
+    const handle = {
+      id: options.id,
+      ready: null,
+      setEnabled(value) {
+        if (typeof value !== "boolean") throw new TypeError("enabled must be boolean");
+        enabled = value;
+        inner?.setEnabled(value);
+      },
+      pause() {
+        paused = true;
+        inner?.pause();
+      },
+      resume() {
+        paused = false;
+        inner?.resume();
+      },
+      refresh() {
+        inner?.refresh();
+      },
+      destroy() {
+        if (destroyed) return;
+        inner?.destroy();
+        inner = null;
+        sampler = null;
+        destroyed = true;
+        status = "destroyed";
+        handles.delete(options.id);
+      },
+      snapshot() {
+        const state = inner?.snapshot() ?? null;
+        return { id: options.id, type: "recording", recording: data.name, status: !destroyed && ["hidden", "offscreen", "paused", "seeking"].includes(state?.status) ? state.status : status, error, destroyed, enabled, paused, pip: last?.pip ?? null, dimensions: data.dimensions, count: data.count, clock: data.clock, inner: state };
+      }
+    };
+    handle.teardown = handle.destroy;
+    handles.set(options.id, handle);
+    handle.ready = samplerFromData(data).then(async (native) => {
+      if (destroyed || scope.disposed) return handle;
+      sampler = native;
+      inner = rudiments.animate({
+        id: options.id,
+        root: options.root,
+        target: options.target,
+        audio: options.audio,
+        clock: "audio",
+        rudiment: "circle",
+        rate: 1,
+        phasePips: 0,
+        amplitude: 0,
+        css: false,
+        renderEveryFrame: true,
+        offscreen: options.offscreen !== false,
+        enabled,
+        render(frame) {
+          if (destroyed) return;
+          const neutral = ["disabled", "reduced-motion", "forced-colors"].includes(frame.reason), precise = (frame.sourceBeats - data.clock.beat_zero_seconds * data.clock.bpm / 60) * 64;
+          const pip = Math.floor(precise + 1e-8), outside = pip < data.clock.start_pip || pip >= data.clock.start_pip + data.count;
+          status = neutral ? frame.reason : outside ? "outside-recording" : frame.reason;
+          const values = neutral || outside ? data.dimensions.map(() => 0) : sampler.sample(pip);
+          output(frame, values, pip, status);
+        }
+      });
+      if (paused) inner.pause();
+      await inner.ready;
+      return handle;
+    }).catch((failure) => {
+      error = String(failure.message || failure);
+      status = "error";
+      inner?.destroy();
+      inner = null;
+      sampler = null;
+      if (handles.get(options.id) === handle) handles.delete(options.id);
+      throw failure;
+    });
+    return handle;
+  }
+  scope.onDispose(() => {
+    for (const handle of [...handles.values()]) handle.destroy();
+  });
+  return Object.freeze({ load, animate, get: (id) => handles.get(id) || null, destroyAll: () => {
+    for (const h of [...handles.values()]) h.destroy();
+  }, snapshot: () => ({ native: "DanceRudiments 0.3.0 recording C++/WASM", instances: [...handles.values()].map((h) => h.snapshot()) }) });
+}
+
 // .build/modules/child-playback.mjs
 var PROTOCOL = "dancemoves.child-playback.v1";
 var EVENTS = /* @__PURE__ */ new Set(["snapshot", "loadedmetadata", "durationchange", "play", "playing", "pause", "ended", "seeking", "seeked", "ratechange", "timeupdate", "waiting", "error"]);
@@ -6827,7 +7088,7 @@ function installChildPlayback(scope, api, host) {
 }
 
 // .build/modules/version.mjs
-var VERSION = "3.1.23";
+var VERSION = "3.3.0";
 
 // .build/modules/index.mjs
 var mounted = /* @__PURE__ */ new WeakMap();
@@ -6880,6 +7141,7 @@ function createDanceMoves(options = {}) {
       config,
       effects: w.DanceMovesEffects,
       rudiments: w.DanceMovesRudiments,
+      recordings: createRecordingService(scope, w.DanceMovesRudiments, config),
       orientationCore: w.KSEpkOrientationCore,
       getOrientation: () => w.__ksEpkOrientationRuntime || null,
       getClay: () => w.DanceMovesClayStars || null,
@@ -6921,5 +7183,6 @@ export {
   createPlaybackPublisher,
   createPlaybackReceiver,
   fromWordPressMeta,
+  validateBeatAlignment,
   validatePageConfig
 };