release: 0.6.0 (buttonRadius + artworkPosition props)

Exposes the two options added in @arraypress/waveform-player 1.22.0.

The prop TYPES already derived from the core's WaveformPlayerOptions and
flowed through on their own — but the option mapping is hand-written, so
both props would have type-checked and then silently done nothing. Tests
now pin the mapping; verified they fail when it's removed.

Peer range stays ^1.20.0: the props only exist once the consumer's own
core reaches 1.22.0, so an older core is unaffected.

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

Author: arraypress

CHANGELOG.md

@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] — 2026-07-17
+
+### Added
+
+- **`buttonRadius` and `artworkPosition` props.** Exposes the two options added
+  in `@arraypress/waveform-player` 1.22.0: `buttonRadius` sets the play button's
+  corner radius (`0` for square, or any CSS length), and `artworkPosition`
+  (`'info'` | `'button'`) chooses whether the cover renders in the info row or
+  becomes the play button itself.
+
+  Both prop *types* already flowed through automatically, since the props derive
+  from the core's `WaveformPlayerOptions` — but the options bag is written by hand, so
+  until now they would have type-checked and then silently done nothing. Tests
+  now cover the mapping for exactly that reason.
+
+  The peer range stays `^1.20.0`: the props only appear once the consumer's own
+  core is on 1.22.0, so nothing breaks on an older one.
+
 ## [0.5.0] — 2026-07-05
 
 ### Added

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@arraypress/waveform-player-react",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "React component wrapper for @arraypress/waveform-player — forwardRef-friendly, useEffect lifecycle, typed props for every library option.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -71,7 +71,7 @@
     "prepublishOnly": "npm run build"
   },
   "devDependencies": {
-    "@arraypress/waveform-player": "^1.20.0",
+    "@arraypress/waveform-player": "^1.22.0",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
     "@types/react": "^19.2.17",

package.json

@@ -112,6 +112,7 @@ function buildLibraryOptions(props: WaveformPlayerProps): Record<string, unknown
 	if (props.layout !== undefined) opts.layout = props.layout;
 	if (props.buttonStyle !== undefined) opts.buttonStyle = props.buttonStyle;
 	if (props.buttonSize !== undefined) opts.buttonSize = props.buttonSize;
+	if (props.buttonRadius !== undefined) opts.buttonRadius = props.buttonRadius;
 
 	/* Accessibility */
 	if (props.accessibleSeek !== undefined) opts.accessibleSeek = props.accessibleSeek;
@@ -132,6 +133,7 @@ function buildLibraryOptions(props: WaveformPlayerProps): Record<string, unknown
 	if (props.artist !== undefined) opts.artist = props.artist;
 	if (props.artwork !== undefined) opts.artwork = props.artwork;
 	if (props.artworkAlt !== undefined) opts.artworkAlt = props.artworkAlt;
+	if (props.artworkPosition !== undefined) opts.artworkPosition = props.artworkPosition;
 	if (props.album !== undefined) opts.album = props.album;
 	if (props.unknownTrackText !== undefined) opts.unknownTrackText = props.unknownTrackText;
 
@@ -317,6 +319,7 @@ export const WaveformPlayer = forwardRef<WaveformPlayerHandle, WaveformPlayerPro
 			props.showBPM,
 			props.buttonAlign,
 			props.buttonSize,
+			props.buttonRadius,
 			props.accessibleSeek,
 			props.seekLabel,
 			props.seekValueText,
@@ -329,6 +332,7 @@ export const WaveformPlayer = forwardRef<WaveformPlayerHandle, WaveformPlayerPro
 			props.artist,
 			props.artwork,
 			props.artworkAlt,
+			props.artworkPosition,
 			props.album,
 			props.unknownTrackText,
 			props.autoplay,

src/WaveformPlayer.tsx

@@ -139,6 +139,38 @@ describe('<WaveformPlayer> — mount', () => {
 
 // ─── Option pass-through ─────────────────────────────────────────────────
 
+describe('<WaveformPlayer> — button radius + artwork placement', () => {
+	// These props type-check for free (WaveformPlayerProps derives from the
+	// core's WaveformPlayerOptions), but the options bag is hand-built — so a
+	// prop that isn't enumerated in buildLibraryOptions type-checks and then
+	// silently does nothing. That failure is invisible without these.
+	it('forwards buttonRadius, including 0', async () => {
+		render(<WaveformPlayer url="/audio/a.mp3" buttonRadius={0} />);
+		await waitForMount();
+		expect(ctorCalls[0].opts.buttonRadius).toBe(0);
+	});
+
+	it('forwards a buttonRadius unit string', async () => {
+		render(<WaveformPlayer url="/audio/a.mp3" buttonRadius="0.5rem" />);
+		await waitForMount();
+		expect(ctorCalls[0].opts.buttonRadius).toBe('0.5rem');
+	});
+
+	it('forwards artworkPosition', async () => {
+		render(<WaveformPlayer url="/audio/a.mp3" artwork="/c.jpg" artworkPosition="button" />);
+		await waitForMount();
+		expect(ctorCalls[0].opts.artworkPosition).toBe('button');
+	});
+
+	it('omits both when unset, so the core defaults apply', async () => {
+		render(<WaveformPlayer url="/audio/a.mp3" />);
+		await waitForMount();
+		const { opts } = ctorCalls[0];
+		expect('buttonRadius' in opts).toBe(false);
+		expect('artworkPosition' in opts).toBe(false);
+	});
+});
+
 describe('<WaveformPlayer> — option pass-through', () => {
 	it('forwards every primitive prop into the library options bag', async () => {
 		render(