@kieransimkin/dancemoves 3.1.23 → 3.2.0

package/README.md

@@ -1,5 +1,8 @@
 # DanceMoves
 
+**3.2.0** adds native, non-looping playback of StemLab/DanceRudiments audio-derived movement recordings.  `runtime.recordings` composes the existing audio clock, shared player mapping, accessibility preferences and lifecycle. Captured BPM must match page metadata; samples retain their original integer-pip clock and never wrap. See [recording playback](docs/audio-recording-playback.md).
+
+
 **3.1.23** secures WordPress motion-capture writes with authenticated
 `manage_options` authorization. The private capture administration UI uses the
 same capability. Published tokens no longer authorize uploads; cookie clients

package/docs/audio-recording-playback.md

@@ -0,0 +1,56 @@
+# Audio-derived recording playback
+
+DanceMoves 3.2.0 adds `runtime.recordings` for the bounded `dancerudiments.recording`
+v1 JSON format exported by StemLab and DanceRudiments 0.3.0. Named native patterns
+continue to loop at their own periods. Recordings retain their captured origin,
+64-pip resolution, named dimensions and exact extent; they never wrap or interpolate.
+
+```js
+const recording = await runtime.recordings.load('/approved-motion.json');
+const motion = runtime.recordings.animate({
+  id: 'subject:recording', root, target, audio,
+  recording,
+  render({values, reason}) {
+    // Map bounded native samples to the existing subject's appearance.
+    // A CSSOM rule avoids high-frequency inline-style mutation observers.
+    rule.style.setProperty('--subject-angle', `${values[0] * 6}deg`);
+  }
+});
+await motion.ready;
+motion.setEnabled(false); // neutral values, preserving the captured clock
+motion.setEnabled(true);
+motion.destroy();
+```
+
+The controller composes the existing native DanceMoves audio scheduler and its
+shared-player mapping. Pause holds the source pose; seeking reconstructs it.
+Reduced motion, forced colours and explicit disable output zeroes. Hidden and
+offscreen subjects suspend through the existing lifecycle. Positions outside the
+recording emit zeroes with `reason: 'outside-recording'`; seeking back into the
+capture resumes its exact native sample. Runtime disposal destroys all recording
+controllers, including pending native loads. Use `pause()`, `resume()`, `refresh()`,
+`snapshot()`, `recordings.get(id)` and `recordings.snapshot()` for ownership and QA.
+
+The recording BPM must match the authoritative runtime/page BPM. A controller
+cannot override tempo, rate, phase or clock. BPM provenance and phase provenance
+remain separate. The page's WordPress EPK Timing metadata remains the only source
+for lyric/cue attachments; a movement recording never replaces those fields.
+Use the exact track/master, same-clock stem provenance and original capture origin.
+StemLab owns separation, filtering and smoothing; this player performs no DSP.
+All smoothing variants should use a fixed reference scale for a fair comparison.
+
+The sampler is the official native C++/WebAssembly accessor from DanceRudiments
+0.3.0. There is no JavaScript movement fallback. Its embedded binary SHA-256 is
+`d4cd976156860aa7a5c9665b27d2fda3cf6a0fa0da3dc0b9df365e425f1c6e29`, built from
+upstream `include/dancerudiments/recording_view.hpp` SHA-256
+`19dd73a150a82c4d9074fe4b9ba4c2f09d41e206028a6a6dc922d94e00dc4b8d` and
+`tools/recording_wasm.cpp` SHA-256
+`f4713cc7c773fa065715383fc68dccd91398fff08cd89167c5f24e64c0cecea9`.
+See the [upstream recording contract](https://github.com/kieransimkin/DanceRudiments/blob/v0.3.0/docs/recordings.md).
+The existing bundled named catalogue and its separate version are unchanged.
+
+Inputs are limited to 64 MiB JSON, 8,388,608 finite values in [-1,1], 1..64 unique
+named dimensions and signed 32-bit integer pip bounds. Loading fails closed for
+bad UTF-8, schema, samples, HTTP responses, mismatched BPM or unavailable WASM.
+Treat `ready` rejection as an unavailable motion state and retain static content.
+These source/build changes do not deploy a WordPress plugin or page.

package/lib/build-manifest.json

@@ -1,7 +1,7 @@
 {
   "schema": "dancemoves-library-build/v1",
   "name": "@kieransimkin/dancemoves",
-  "version": "3.1.23",
+  "version": "3.2.0",
   "homepage": "https://kieransimkin.co.uk/my-songs/",
   "files": [
     {
@@ -31,23 +31,23 @@
     },
     {
       "path": "dancemoves.min.js",
-      "bytes": 212321,
-      "sha256": "2d7a7ec476e32d695fd88277967009b3e10a2ef889e0ecafa59ac4eaf6e15f2a"
+      "bytes": 218383,
+      "sha256": "9a9afad98cbf15d3c8394a54809596d1ffe784f5ac7ca13484186ace3eb93661"
     },
     {
       "path": "index.cjs",
-      "bytes": 361185,
-      "sha256": "cf41f6c466acbb9f170ca37258fdf15ef7695457543e3bc29dc8b38ff38fed54"
+      "bytes": 370576,
+      "sha256": "ca7ed8da52270ee4a17f94672121f4182fa5cc8c5964c8d095a682978d1b4981"
     },
     {
       "path": "index.d.ts",
-      "bytes": 13718,
-      "sha256": "82ec16610754f0237cd91e2a7a7ce4f6fe17617d8a61b78d089143e9fdb142e4"
+      "bytes": 14929,
+      "sha256": "477a8d665f245dbcff92cdc17372f39b54dbe3f9392695a00773f43b92288914"
     },
     {
       "path": "index.mjs",
-      "bytes": 360040,
-      "sha256": "abd302d298b2c808d83507eed49235602a4c7530dd3771083e4dfe16d84997ba"
+      "bytes": 369431,
+      "sha256": "6edacb0ded30311fc26bb80e86c772ba362c1b60c54a68b5ebaa2d3eb484ac16"
     },
     {
       "path": "react.cjs",
@@ -106,8 +106,8 @@
     },
     {
       "path": "wordpress.js",
-      "bytes": 211126,
-      "sha256": "dfb55567a063115518847ab70485924fed0bd4d64e790f9d659be97e1f0f08f5"
+      "bytes": 217191,
+      "sha256": "1b02054111edf66b3a5766c7da74291fe597d2ed3ac7a89f0f282cfb99c415df"
     }
   ]
 }