@kieransimkin/dancemoves 3.0.4 → 3.0.5

package/README.md

@@ -3,9 +3,11 @@
 **DanceFlow musical motion by Kieran Simkin.** One JavaScript runtime for plain
 websites, React, Next.js and the separately packaged WordPress adapter.
 
-**3.0.4 release candidate** based on the published 3.0.3 shared-library release.
-It adds the shared three-slot lyric stage used by existing WordPress EPKs without
-restoring the duplicate raw-script layout removed in 3.0.
+**3.0.5 release candidate** based on the published 3.0.4 shared-library release.
+It preserves the shared three-slot lyric stage used by existing WordPress EPKs
+without restoring the duplicate raw-script layout removed in 3.0. Public ready
+events now bubble, and WordPress compatibility mode can find the body-level
+lyric popover while ordinary module and React mounts stay scoped.
 
 ## Shared JavaScript library and WordPress
 
@@ -881,6 +883,7 @@ shell errors or resolved development incidents.
 | Cues or lyrics do not appear | Verify the selected UTF-8 timing attachment, bracketed timestamps, successful fetch and master-duration match. Call `discoverAudio()` for deliberately inserted players. A final status of `none` can mask a fetch failure: inspect the request and entry counts. | [Audio discovery](docs/api/javascript.md#audio-discovery-and-playback) |
 | A chapter landing or resumed section has the wrong visual state | Core LRC subscriptions arm one cue within 50 ms. Shared timelines instead reconstruct active intervals and default to no landing callbacks; use their render state for persistent section styling. Do not replay skipped transient cues to restore a section. | [Cue timelines](docs/api/effects.md#cuetimelineoptions) |
 | Custom lyric styling fails, or remains visible on pause | The generated layer is a direct child of `body`, not `.ks-epk`. Use `nextVisible*` only for a nonblank preview; preserve blank clear cues. Custom renderers must handle pause/end separately. | [Lyric styling](docs/api/styling.md), [lyric events](docs/api/javascript.md) |
+| A document-level adapter never mounts, or `lyricStage()` stays `waiting-for-popover` while the popover exists | Versions before 3.0.5 could keep scoped readiness events from document listeners and could confine WordPress compatibility lookups to the EPK root even though the lyric popover is under `body`. Use 3.0.5 or later; verify a bubbling `dance-moves-*-ready` event, native document lookup in WordPress mode, three generated lyric lines and the adapter-specific ready marker. | [Shared effects loading](docs/api/effects.md#loading-and-ready-event) |
 | Phone motion is absent | Check the adapter's root, mobile/sensor/secure-context gates, user permission and reduced-motion state. Verify real sensor events on the intended device; a synthetic event is not physical-device evidence. | [Orientation runtime](docs/api/adapters.md) |
 | Paper planes are absent or obscure the hero | Save Ambient effect = Paper planes, provide `.ks-epk .epk-hero`, verify the atlas request and hero containment/stacking. Reduced-motion and forced-colour CSS intentionally hide decoration; offscreen/hidden state pauses flight. | [Paper-plane requirements](docs/api/paper-planes.md) |
 | Animation slows down or quality appears stuck | Measure the full visible page after load, inspect the active controller's snapshot and remove duplicate effect owners. Shared `quality()` and Clay/Stars use different thresholds and recovery rules; neither is a physical refresh-rate detector. | [Shared quality](docs/api/effects.md#qualityoptions), [Clay/Stars](docs/api/adapters.md) |

package/docs/api/effects.md

@@ -4,7 +4,7 @@
 [Release adapters](adapters.md) · [CSS/HTML](styling.md)
 
 Source: [assets/dance-moves-effects.js](../../assets/dance-moves-effects.js).
-Current shared-library baseline: **3.0.4**. Historical 2.7/2.8 notes below
+Current shared-library baseline: **3.0.5**. Historical 2.7/2.8 notes below
 identify when the earlier primitives were introduced.
 
 This is the reusable, page-independent layer introduced in 2.7 and extended with
@@ -21,9 +21,11 @@ catalogue adopter. The module installs only if `window.DanceMoves` already exist
 and `window.DanceMovesEffects` does not. It does not retry a missing dependency.
 Its `version` property copies `DanceMoves.version`.
 
-After installation it dispatches **`dance-moves-effects-ready`** on **`document`**
-with `detail: { api: window.DanceMovesEffects, version: string }`. It is a native
-`CustomEvent` with default `bubbles: false` and `cancelable: false`. It fires once
+After installation it dispatches **`dance-moves-effects-ready`** from the scoped
+EPK root, or from `document` in WordPress compatibility mode, with
+`detail: { api: window.DanceMovesEffects, version: string }`. It is a native
+`CustomEvent` with `bubbles: true` and `cancelable: false`, so established
+document-level adapters receive it in either mode. It fires once
 per successful installation; a late listener does not receive a replay.
 
 ```js

package/docs/api/styling.md

@@ -3,7 +3,7 @@
 [Documentation index](../README.md) · [JavaScript](javascript.md) ·
 [Adapters](adapters.md)
 
-Current shared-library baseline: DanceMoves 3.0.4.
+Current shared-library baseline: DanceMoves 3.0.5.
 Sources: [core JavaScript](../../assets/dance-moves-core.js),
 [core stylesheet](../../assets/dance-moves-core.css),
 [catalogue adopter](../../assets/dance-moves-catalogue-timing.js),

package/docs/javascript-api.md

@@ -1,6 +1,6 @@
 # Shared JavaScript API
 
-Package: `@kieransimkin/dancemoves`, release candidate 3.0.4.
+Package: `@kieransimkin/dancemoves`, release candidate 3.0.5.
 This guide describes the public shared module; [WordPress](wordpress-shared-runtime.md)
 loads the same runtime through its adapter.
 

package/docs/wordpress-shared-runtime.md

@@ -24,7 +24,7 @@ if ($LASTEXITCODE -ne 0) { throw "WordPress build failed" }
 ```
 
 The build machine needs Node, npm and Python. The WordPress server needs neither
-Node, npm, a C++ compiler nor an external CDN. Install `dist/DanceMoves-wordpress-3.0.4.zip`
+Node, npm, a C++ compiler nor an external CDN. Install `dist/DanceMoves-wordpress-3.0.5.zip`
 through Plugins → Add New → Upload Plugin, preserving a backup and the prior
 working archive. Do not upload the npm tarball, web ZIP, repository source ZIP
 or a downloaded patch bundle.
@@ -71,6 +71,11 @@ the compatibility path for existing three-line lyric treatments: the plugin owns
 the LRC/audio clock and all lifecycle listeners while page code owns only the
 release-scoped render callbacks and CSS.
 
+From 3.0.5, public `dance-moves-*-ready` events bubble for compatibility with
+document-level page adapters. WordPress compatibility mode also keeps native
+document-wide selectors, allowing the body-level lyric popover to be found from
+the scoped runtime. Root-scoped module and React mounts remain isolated.
+
 ```php
 add_action('wp_enqueue_scripts', function () {
     if (!is_page(260)) { return; } // Your actual Arcadians Page ID.

package/lib/build-manifest.json

@@ -1,7 +1,7 @@
 {
   "schema": "dancemoves-library-build/v1",
   "name": "@kieransimkin/dancemoves",
-  "version": "3.0.4",
+  "version": "3.0.5",
   "homepage": "https://kieransimkin.co.uk/my-songs/",
   "files": [
     {
@@ -31,13 +31,13 @@
     },
     {
       "path": "dancemoves.min.js",
-      "bytes": 168118,
-      "sha256": "211a06f8b21fbc12340dd060ac6d36bbbb5cbda6dfc3f45e3cecacda4cc9e8be"
+      "bytes": 168228,
+      "sha256": "2ea4074d6f31f8d9527c13a4379bb6832a760641b900493449840935e0b65cb1"
     },
     {
       "path": "index.cjs",
-      "bytes": 276097,
-      "sha256": "bad26ca5d24335e344695dac673559ed2ff7693af0068ad0f21d5996fc5979da"
+      "bytes": 276314,
+      "sha256": "4e7a6049c0dd68dd9d78836ceb4fe14216c27132ac3264b4d53b27c633e8c597"
     },
     {
       "path": "index.d.ts",
@@ -46,8 +46,8 @@
     },
     {
       "path": "index.mjs",
-      "bytes": 275012,
-      "sha256": "1dcd67e089e11e5e0358e8981df1e16c5a02aea7897f7cce7a53c258e7249a93"
+      "bytes": 275229,
+      "sha256": "ad1b4c0a98f3461d6e3d98db3dc8eff7fac2ea6d437ee1650f26341e9bd9eb9c"
     },
     {
       "path": "react.cjs",
@@ -111,8 +111,8 @@
     },
     {
       "path": "wordpress.js",
-      "bytes": 166906,
-      "sha256": "074fc65dfa819c11ac7fd3f4e713d7b00639e9f59768f2778c43733f1e396e24"
+      "bytes": 167016,
+      "sha256": "c6ee5db0eddcc4ea605ed5e091384c857ff888ee062e9f81dd73feaa21ee8bd4"
     }
   ]
 }