@arraypress/waveform-player 1.8.0 → 1.9.0

package/index.d.ts

@@ -329,6 +329,12 @@ export declare class WaveformPlayer {
 		escapeHtml(str: unknown): string;
 		/** Whether a URL uses a safe (`http`/`https`/relative) scheme. */
 		isSafeHref(url: string): boolean;
+		/**
+		 * Parse every recognised `data-*` attribute off an element into a
+		 * sparse options object (the player's full declarative contract).
+		 * Lets wrappers inherit the complete option surface without drifting.
+		 */
+		parseDataAttributes(element: HTMLElement): Partial<WaveformPlayerOptions>;
 	};
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arraypress/waveform-player",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "Lightweight, customizable audio player with waveform visualization",
   "type": "module",
   "types": "./index.d.ts",

package/src/js/core.js

@@ -890,6 +890,14 @@ export class WaveformPlayer {
         // Clear or update markers
         this.options.markers = options.markers || [];
 
+        // Reset the waveform to the NEW track's peaks, or null to regenerate
+        // from the URL. mergeOptions() above keeps the previous track's
+        // this.options.waveform when the caller passes none, and load() does
+        // `if (this.options.waveform) setWaveformData(...)` — so without this
+        // reset a track loaded without peaks would redraw the PREVIOUS track's
+        // waveform (audio changes, visualization doesn't).
+        this.options.waveform = options.waveform || null;
+
         // Load the new track
         await this.load(url);
 

package/src/js/index.js

@@ -12,12 +12,15 @@
 
 // Import the main class
 import {WaveformPlayer} from './core.js';
-import {formatTime, extractTitleFromUrl, escapeHtml, isSafeHref} from './utils.js';
+import {formatTime, extractTitleFromUrl, escapeHtml, isSafeHref, parseDataAttributes} from './utils.js';
 
 // Expose a small set of pure helpers as a single source of truth so consumers
-// (e.g. @arraypress/waveform-bar) can reuse them instead of shipping divergent
-// copies. Attached to the class so it's reachable from the IIFE global too.
-WaveformPlayer.utils = {formatTime, extractTitleFromUrl, escapeHtml, isSafeHref};
+// (e.g. @arraypress/waveform-bar, @arraypress/waveform-playlist) can reuse them
+// instead of shipping divergent copies. `parseDataAttributes` lets wrappers read
+// the player's full `data-*` option surface off a host element without
+// re-implementing (and drifting from) the contract. Attached to the class so
+// it's reachable from the IIFE global too.
+WaveformPlayer.utils = {formatTime, extractTitleFromUrl, escapeHtml, isSafeHref, parseDataAttributes};
 
 /**
  * Whether we're running in a browser (vs. SSR / Node), where `window` and