@arraypress/waveform-player 1.9.0 → 1.11.0

package/index.d.ts

@@ -127,6 +127,18 @@ export interface WaveformPlayerOptions {
 	// ── Layout / UI toggles ───────────────────────────────────────
 	/** Play-button alignment. @default 'auto' */
 	buttonAlign?: ButtonAlign;
+	/**
+	 * Player layout. `'preview'` centers the title under the waveform and trims
+	 * the meta row (time/speed/BPM) — ideal for sample-pack previews.
+	 * @default 'default'
+	 */
+	layout?: 'default' | 'preview';
+	/**
+	 * Play/pause button style. `'minimal'` renders a bare glyph with no circle —
+	 * the look sample-pack and beat stores use in preview grids.
+	 * @default 'circle'
+	 */
+	buttonStyle?: 'circle' | 'minimal';
 	/** Show transport controls. @default true */
 	showControls?: boolean;
 	/** Show the info (title/subtitle) block. @default true */

package/package.json

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

package/src/css/waveform-player.css

@@ -3,6 +3,9 @@
     font-family: inherit;
     color: inherit;
     line-height: var(--waveform-line-height, 1.4);
+    /* Neutral accent for the keyboard-focus ring + active states. Monochrome
+       by default (shadcn-style); override this variable to re-tint it. */
+    --wfp-accent: #71717a;
 }
 
 .waveform-player * {
@@ -48,6 +51,28 @@
     transform: scale(1.05);
 }
 
+/* Minimal button style — a bare play/pause glyph with no circle. Set via
+   `buttonStyle: 'minimal'` / data-button-style="minimal". Ideal for sample-pack
+   and beat-store preview grids. */
+.waveform-btn-minimal {
+    width: auto;
+    height: auto;
+    min-width: 0;
+    border: none;
+    border-radius: 0;
+    opacity: 0.7;
+}
+
+.waveform-btn-minimal:hover:not(:disabled) {
+    opacity: 1;
+    transform: none;
+}
+
+.waveform-btn-minimal svg {
+    width: 22px;
+    height: 22px;
+}
+
 .waveform-btn:disabled {
     cursor: not-allowed;
     opacity: 0.3;
@@ -302,13 +327,13 @@
 }
 
 .speed-option.active {
-    background: rgba(168, 85, 247, 0.2);
-    color: #a855f7;
+    background: rgba(255, 255, 255, 0.16);
+    color: #fff;
     font-weight: 600;
 }
 
 .waveform-player.waveform-focused {
-    outline: 2px solid rgba(168, 85, 247, 0.5);
+    outline: 2px solid var(--wfp-accent);
     outline-offset: 2px;
     border-radius: 4px;
 }
@@ -320,10 +345,28 @@
 
 /* Only show focus indicator when keyboard navigating (not clicking) */
 .waveform-player:focus-visible {
-    outline: 1px solid rgba(168, 85, 247, 0.3);
+    outline: 1px solid var(--wfp-accent);
     outline-offset: 1px;
 }
 
+/* ==========================================================================
+   'preview' layout — compact, centered title under the waveform, trimmed
+   meta row. Ideal for sample-pack previews and dense grids.
+   ========================================================================== */
+.waveform-layout-preview .waveform-meta {
+    display: none !important;
+}
+
+.waveform-layout-preview .waveform-info {
+    justify-content: center;
+}
+
+.waveform-layout-preview .waveform-text {
+    flex: 0 1 auto;
+    align-items: center;
+    text-align: center;
+}
+
 /* Remove the class-based focus indicator since we're using :focus-visible */
 .waveform-player.waveform-focused {
     outline: none;

package/src/js/core.js

@@ -224,9 +224,16 @@ export class WaveformPlayer {
             }
         }
 
+        // Compact 'preview' layout: centered title under the waveform with the
+        // meta row trimmed. Set via the `layout` option / data-layout="preview".
+        const isPreview = this.options.layout === 'preview';
+        if (isPreview) {
+            this.container.classList.add('waveform-layout-preview');
+        }
+
         // Build play button HTML (conditional)
         const buttonHTML = this.options.showControls ? `
-        <button class="waveform-btn" aria-label="Play/Pause" style="
+        <button class="waveform-btn${this.options.buttonStyle === 'minimal' ? ' waveform-btn-minimal' : ''}" aria-label="Play/Pause" style="
             border-color: ${this.options.buttonColor};
             color: ${this.options.buttonColor};
         ">
@@ -251,7 +258,7 @@ export class WaveformPlayer {
           <span class="waveform-title" style="color: ${this.options.textColor};"></span>
           ${this.options.subtitle ? `<span class="waveform-subtitle" style="color: ${this.options.textSecondaryColor};">${this.options.subtitle}</span>` : ''}
         </div>
-        <div style="display: flex; align-items: center; gap: 1rem;">
+        <div class="waveform-meta" style="display: flex; align-items: center; gap: 1rem;">
           ${this.options.showBPM ? `
             <span class="waveform-bpm" style="color: ${this.options.textSecondaryColor}; display: none;">
               <span class="bpm-value">--</span> BPM

package/src/js/themes.js

@@ -151,8 +151,11 @@ export function getColorPreset(presetName) {
 export const DEFAULT_OPTIONS = {
     // Core settings
     url: '',
-    height: 60,
-    samples: 200,
+    height: 64,
+    // Source peak resolution. The drawer resamples these to fit
+    // canvasWidth / (barWidth + barSpacing) bars, so this is fidelity headroom,
+    // not the visible bar count.
+    samples: 256,
     preload: 'metadata',
 
     // Audio mode — 'self' = player owns the <audio> element (default, current
@@ -169,13 +172,22 @@ export const DEFAULT_OPTIONS = {
 
     // Layout Options
     buttonAlign: 'auto',
+    // Player layout. 'default' = play button + waveform with a left-aligned
+    // info row below. 'preview' = compact: the title is centered under the
+    // waveform and the meta row (time / speed / BPM) is trimmed — ideal for
+    // sample-pack sample previews and dense grids.
+    layout: 'default',
+    // Play/pause button style. 'circle' = bordered circle (default).
+    // 'minimal' = a bare play/pause glyph with no circle — the look sample-pack
+    // and beat stores use in their preview grids.
+    buttonStyle: 'circle',
 
     // Default waveform style
     waveformStyle: 'mirror',
     barWidth: 2,
     barSpacing: 0,
-    // Rounded bar caps (px). 0 = square (default). Applies to bars/mirror.
-    barRadius: 0,
+    // Rounded bar caps (px). 0 = square; 1 = soft caps (default). Applies to bars/mirror.
+    barRadius: 1,
 
     // Color preset: null = auto-detect, 'dark' = force dark, 'light' = force light
     colorPreset: null,
@@ -245,7 +257,7 @@ export const DEFAULT_OPTIONS = {
  */
 export const STYLE_DEFAULTS = {
     bars: {barWidth: 3, barSpacing: 1},
-    mirror: {barWidth: 2, barSpacing: 0},
+    mirror: {barWidth: 2, barSpacing: 2},
     line: {barWidth: 2, barSpacing: 0},
     blocks: {barWidth: 4, barSpacing: 2},
     dots: {barWidth: 3, barSpacing: 3},

package/src/js/utils.js

@@ -137,6 +137,8 @@ export function parseDataAttributes(element) {
     setNum('barSpacing');
     setNum('barRadius');
     if (element.dataset.buttonAlign) options.buttonAlign = element.dataset.buttonAlign;
+    if (element.dataset.layout) options.layout = element.dataset.layout;
+    if (element.dataset.buttonStyle) options.buttonStyle = element.dataset.buttonStyle;
 
     // Color preset
     if (element.dataset.colorPreset) options.colorPreset = element.dataset.colorPreset;