@kieransimkin/dancemoves 3.1.23 → 3.2.0

package/lib/index.cjs

@@ -1065,7 +1065,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;
     }
@@ -1119,8 +1119,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");
@@ -1211,13 +1211,13 @@ 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 phase = -(finite3(audio.currentTime, 0) / rate % 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");
@@ -1256,7 +1256,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)
@@ -1312,16 +1312,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;
       }
@@ -1331,7 +1331,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 });
@@ -1341,10 +1341,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) {
@@ -1370,7 +1370,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);
@@ -1379,8 +1379,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 });
@@ -1389,7 +1389,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);
@@ -1453,7 +1453,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;
           }) };
         },
@@ -1476,28 +1476,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;
@@ -1507,8 +1507,8 @@ 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 cycleSeconds = Math.max(1e-3, finite3(motion.durationMilliseconds(cycleTicks), 1) / 1e3);
+        var time = Math.max(0, finite3(audio.currentTime, 0));
         var phase = ((time - phaseOffsetSeconds) % cycleSeconds + cycleSeconds) % cycleSeconds / cycleSeconds;
         var localFrame = staticFallback ? staticFrame : Math.min(frameCount - 1, Math.floor(phase * frameCount + 1e-9));
         var mapped = mappedFrame(localFrame);
@@ -1563,8 +1563,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);
         }
@@ -1595,7 +1595,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());
       }
@@ -1649,7 +1649,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);
@@ -1716,8 +1716,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 });
@@ -1766,7 +1766,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) {
@@ -1783,7 +1783,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) {
@@ -1809,7 +1809,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) {
@@ -1839,7 +1839,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");
@@ -1854,7 +1854,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;
@@ -1909,7 +1909,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");
@@ -1981,16 +1981,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;
@@ -2322,7 +2322,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;
@@ -2365,12 +2365,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) {
@@ -2414,12 +2414,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;
@@ -2458,7 +2458,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() {
@@ -6436,6 +6436,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"]);
@@ -6860,7 +7038,7 @@ function installChildPlayback(scope, api, host) {
 }
 
 // .build/modules/version.mjs
-var VERSION = "3.1.23";
+var VERSION = "3.2.0";
 
 // .build/modules/index.mjs
 var mounted = /* @__PURE__ */ new WeakMap();
@@ -6913,6 +7091,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,

package/lib/index.d.ts

@@ -92,7 +92,7 @@ export interface DanceMoves {
  resetRunningAnimations(audio?:PlaybackMedia):number;discoverAudio():void;registerPlaybackSource(source:PlaybackSource):void;unregisterPlaybackSource(source:PlaybackSource):void;
  setDiagnosticsSink(callback:((record:Record<string,unknown>)=>void)|null):boolean;diagnosticsEnabled():boolean;
  applyCatalogueTiming?():Record<string,unknown>;catalogueTimingSnapshot?():Record<string,unknown>;removeCatalogueAnimationScope?():void;
- effects:Effects;rudiments:import('./rudiments').RudimentApi;
+ effects:Effects;rudiments:import('./rudiments').RudimentApi;recordings:RecordingService;
  orientationCore:Record<string,(...args:any[])=>any>;
  getOrientation():(Controller & {reset():void})|null;getClay():(Controller & Record<string,any>)|null;getPaperPlanes():Controller|null;
  createOrientation(options:{render:(point:Offset & Record<string,unknown>)=>void;windowMilliseconds?:number;minimumSpanDegrees?:number;smoothingTimeConstantMilliseconds?:number}):OrientationController;
@@ -111,3 +111,7 @@ export function fromWordPressMeta(meta:Record<string,unknown>,resolveAttachment?
 export interface Revision {revision:number;config:PageConfig;savedAt:string}
 export interface PageStore {read(id:string):Revision|null;revisions(id:string):Revision[];save(id:string,input:PageConfig,options?:{expectedRevision?:number}):Revision;restore(id:string,revision:number,options?:{expectedRevision?:number}):Revision;delete(id:string):boolean}
 export function createMemoryPageStore(options?:{maxPages?:number;maxRevisions?:number}):PageStore;
+export interface AudioRecording {format:'dancerudiments.recording';schema_version:1;pips_per_beat:64;sample_dtype:'float64';name:string;dimensions:string[];samples:number[][];clock:{bpm:number;bpm_source:string;bpm_status:'confirmed'|'estimated';beat_zero_seconds:number;phase_status:'unverified'|'estimated'|'supplied';start_pip:number};provenance?:Record<string,unknown>}
+export interface RecordingFrame {recording:string;dimensions:readonly string[];values:number[];position:{x:number;y:number;z:number};pip:number;positionPips:number;sourceBeats:number;loopProgress:null;reason:string}
+export interface RecordingController {id:string;ready:Promise<RecordingController>;setEnabled(value:boolean):void;pause():void;resume():void;refresh():void;destroy():void;teardown():void;snapshot():Record<string,unknown>}
+export interface RecordingService {load(url:string):Promise<AudioRecording>;animate(options:{id:string;root:HTMLElement;target:HTMLElement;audio:PlaybackMedia;recording:AudioRecording;offscreen?:boolean;enabled?:boolean;render:(frame:RecordingFrame)=>void}):RecordingController;get(id:string):RecordingController|null;destroyAll():void;snapshot():Record<string,unknown>}