feat: barRadius + gradient color props (mirror core 1.8.0)

Adds the barRadius prop (rounded bar caps) and allows waveformColor/
progressColor to be an array of gradient stops, matching the core
@arraypress/waveform-player 1.8.0 additions. Astro path JSON-encodes
array colors into the data-attribute; React passes them through.

Not yet released — peer bump to ^1.8.0 + version bump will land with the
next wrapper release once core 1.8.0 is published.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: arraypress

src/WaveformPlayer.tsx

@@ -81,6 +81,7 @@ function buildLibraryOptions(props: WaveformPlayerProps): Record<string, unknown
 	if (props.samples !== undefined) opts.samples = props.samples;
 	if (props.barWidth !== undefined) opts.barWidth = props.barWidth;
 	if (props.barSpacing !== undefined) opts.barSpacing = props.barSpacing;
+	if (props.barRadius !== undefined) opts.barRadius = props.barRadius;
 	if (props.waveform !== undefined && props.waveform !== null) {
 		opts.waveform = props.waveform;
 	}
@@ -235,6 +236,7 @@ export const WaveformPlayer = forwardRef<WaveformPlayerHandle, WaveformPlayerPro
 			props.samples,
 			props.barWidth,
 			props.barSpacing,
+			props.barRadius,
 			props.waveform,
 			props.colorPreset,
 			props.waveformColor,

src/types.ts

@@ -183,17 +183,19 @@ export interface WaveformPlayerProps {
 	barWidth?: number;
 	/** Gap between bars in pixels. */
 	barSpacing?: number;
+	/** Rounded bar-cap radius in pixels (bars/mirror). `0` = square. @default 0 */
+	barRadius?: number;
 	/** Pre-computed peaks data. See {@link WaveformPeaks}. */
 	waveform?: WaveformPeaks;
 
 	// ── 3. Colours ─────────────────────────────────────────────────────
 
 	/** Forced colour preset; `null` auto-detects. @default null */
 	colorPreset?: ColorPreset;
-	/** Unplayed peak colour (CSS colour string). */
-	waveformColor?: string;
-	/** Progress/played-through colour. */
-	progressColor?: string;
+	/** Unplayed peak colour. A CSS colour string, or an array of stops for a vertical gradient (e.g. `['#fafafa', '#71717a']`). */
+	waveformColor?: string | string[];
+	/** Progress/played-through colour. Also accepts an array of stops for a gradient. */
+	progressColor?: string | string[];
 	/** Play button border/text colour. */
 	buttonColor?: string;
 	/** Play button hover colour. */