Adopt core's shipped types; drop drifting local duplicates

The core `@arraypress/waveform-player` v1.8.0 now ships a hand-authored
`index.d.ts`, so this wrapper no longer needs to re-declare the shared
option surface.

- Delete `src/core-module-shim.d.ts` (the loose ambient module shim that
  existed only while the core had no types).
- `src/types.ts`: re-export `WaveformStyle`, `ColorPreset`, `AudioMode`,
  `AudioPreload`, `ButtonAlign`, `WaveformMarker`, `WaveformPeaks` from
  the core, and make `WaveformPlayerProps extend
  Omit<WaveformPlayerOptions, url | callbacks>` instead of re-declaring
  every field. Callbacks and `WaveformPlayerHandle.instance` are now
  typed with the core's `WaveformPlayer` class. `accessibleSeek`,
  `seekLabel`, `barRadius`, and gradient-array colours are exposed for
  free.
- `src/WaveformPlayer.tsx`: type the callback wrappers and `instance`
  getter with the (aliased) core class, and forward `accessibleSeek` /
  `seekLabel` through to the player.
- Bump `@arraypress/waveform-player` peer + dev dependency to `^1.8.0`.
- CHANGELOG: add Unreleased entry.

typecheck, build (tsup), and the 19-test suite all pass.

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

Author: arraypress

CHANGELOG.md

@@ -5,6 +5,38 @@ All notable changes to `@arraypress/waveform-player-react` are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+### Changed
+
+- Public types are now adopted from the core
+  `@arraypress/waveform-player` (v1.8.0+), which ships a hand-authored
+  `index.d.ts`. The shared option surface (`WaveformStyle`,
+  `ColorPreset`, `AudioMode`, `AudioPreload`, `ButtonAlign`,
+  `WaveformMarker`, `WaveformPeaks`) is re-exported from the core, and
+  `WaveformPlayerProps` now `extends` the core's `WaveformPlayerOptions`
+  instead of re-declaring every field. The core is the single source of
+  truth, so the wrapper's types can no longer drift out of sync. Bumped
+  the `@arraypress/waveform-player` peer (and dev) dependency to
+  `^1.8.0`.
+- Callback props (`onLoad`, `onPlay`, `onPause`, `onEnd`,
+  `onTimeUpdate`, `onError`) and the `WaveformPlayerHandle.instance`
+  accessor are now typed with the core's `WaveformPlayer` class instead
+  of `unknown`.
+
+### Added
+
+- `accessibleSeek`, `seekLabel`, `barRadius`, and gradient-array
+  waveform / progress colours (`string[]`) are now exposed as typed
+  props — picked up for free by extending the core options and wired
+  through to the underlying player.
+
+### Removed
+
+- Deleted `src/core-module-shim.d.ts`, the loose ambient
+  `declare module '@arraypress/waveform-player'` shim that only existed
+  while the core had no shipped types.
+
 ## [0.1.1] — 2026-06-27
 
 ### Changed

package.json

@@ -59,7 +59,7 @@
   },
   "sideEffects": false,
   "peerDependencies": {
-    "@arraypress/waveform-player": "^1.7.2",
+    "@arraypress/waveform-player": "^1.8.0",
     "react": "^18.0.0 || ^19.0.0"
   },
   "scripts": {
@@ -71,7 +71,7 @@
     "prepublishOnly": "npm run build"
   },
   "devDependencies": {
-    "@arraypress/waveform-player": "^1.7.2",
+    "@arraypress/waveform-player": "^1.8.0",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
     "@types/react": "^19.2.15",

src/WaveformPlayer.tsx

@@ -57,6 +57,9 @@ import {
 	useRef,
 	type ForwardedRef,
 } from 'react';
+// Aliased to avoid colliding with this file's own `WaveformPlayer`
+// component export. This is the core library's player class type.
+import type { WaveformPlayer as WaveformPlayerInstance } from '@arraypress/waveform-player';
 import type { WaveformPlayerHandle, WaveformPlayerProps } from './types';
 
 /**
@@ -111,6 +114,10 @@ function buildLibraryOptions(props: WaveformPlayerProps): Record<string, unknown
 	if (props.showBPM !== undefined) opts.showBPM = props.showBPM;
 	if (props.buttonAlign !== undefined) opts.buttonAlign = props.buttonAlign;
 
+	/* Accessibility */
+	if (props.accessibleSeek !== undefined) opts.accessibleSeek = props.accessibleSeek;
+	if (props.seekLabel !== undefined) opts.seekLabel = props.seekLabel;
+
 	/* Markers */
 	if (props.markers !== undefined) opts.markers = props.markers;
 	if (props.showMarkers !== undefined) opts.showMarkers = props.showMarkers;
@@ -244,13 +251,13 @@ export const WaveformPlayer = forwardRef<WaveformPlayerHandle, WaveformPlayerPro
 					 * handler from `callbacksRef` — fixing the stale-closure
 					 * bug without re-mounting on callback changes. Signatures
 					 * mirror the core's option callbacks exactly. */
-					opts.onLoad = (instance: unknown) => callbacksRef.current.onLoad?.(instance);
-					opts.onPlay = (instance: unknown) => callbacksRef.current.onPlay?.(instance);
-					opts.onPause = (instance: unknown) => callbacksRef.current.onPause?.(instance);
-					opts.onEnd = (instance: unknown) => callbacksRef.current.onEnd?.(instance);
-					opts.onTimeUpdate = (currentTime: number, duration: number, instance: unknown) =>
+					opts.onLoad = (instance: WaveformPlayerInstance) => callbacksRef.current.onLoad?.(instance);
+					opts.onPlay = (instance: WaveformPlayerInstance) => callbacksRef.current.onPlay?.(instance);
+					opts.onPause = (instance: WaveformPlayerInstance) => callbacksRef.current.onPause?.(instance);
+					opts.onEnd = (instance: WaveformPlayerInstance) => callbacksRef.current.onEnd?.(instance);
+					opts.onTimeUpdate = (currentTime: number, duration: number, instance: WaveformPlayerInstance) =>
 						callbacksRef.current.onTimeUpdate?.(currentTime, duration, instance);
-					opts.onError = (error: Error, instance: unknown) =>
+					opts.onError = (error: Error, instance: WaveformPlayerInstance) =>
 						callbacksRef.current.onError?.(error, instance);
 
 					localInstance = new WaveformPlayerClass(container, opts);
@@ -307,6 +314,8 @@ export const WaveformPlayer = forwardRef<WaveformPlayerHandle, WaveformPlayerPro
 			props.showHoverTime,
 			props.showBPM,
 			props.buttonAlign,
+			props.accessibleSeek,
+			props.seekLabel,
 			props.markers,
 			props.showMarkers,
 			props.title,
@@ -381,7 +390,7 @@ export const WaveformPlayer = forwardRef<WaveformPlayerHandle, WaveformPlayerPro
 					await inst.loadTrack(url, title, subtitle, options);
 				},
 				get instance() {
-					return instanceRef.current;
+					return instanceRef.current as WaveformPlayerInstance;
 				},
 			}),
 			[]