@arraypress/waveform-player 1.8.1 → 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.1",
+  "version": "1.9.0",
   "description": "Lightweight, customizable audio player with waveform visualization",
   "type": "module",
   "types": "./index.d.ts",

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