Update version to 1.5.1 and enhance silence detection functionality

- Bump package version from 1.5.0 to 1.5.1 in package.json.
- Ensure `removeSilences` method in `MediaClip` initializes correctly based on state.
- Clarify documentation for `SilenceDetectionOptions`, specifying minimum duration in milliseconds.
- Update silence detection utility to convert minimum duration from milliseconds to samples for accurate processing.

These changes improve the robustness and clarity of silence handling in audio processing.

Author: k9p5

package.json

@@ -1,7 +1,7 @@
 {
   "name": "@diffusionstudio/core",
   "private": false,
-  "version": "1.5.0",
+  "version": "1.5.1",
   "type": "module",
   "description": "Build bleeding edge video processing applications",
   "files": [

src/clips/media/media.ts

@@ -321,6 +321,10 @@ export class MediaClip<Props extends MediaClipProps = MediaClipProps> extends Cl
 	 * @param options - Options for silence detection
 	 */
 	public async removeSilences(options: SilenceRemoveOptions = {}): Promise<MediaClip<Props>[]> {
+		if (!['READY', 'ATTACHED'].includes(this.state)) {
+			await this.init();
+		}
+
 		const silences = (await this.source.silences(options))
 			.filter((silence) => inRange(silence, this.range))
 			.sort((a, b) => a.start.millis - b.start.millis);

src/sources/audio.types.ts

@@ -29,13 +29,13 @@ export type SilenceDetectionOptions = {
 	 */
 	threshold?: number;
 	/**
-	 * This parameter affect how accurately the algorithm captures short silences. 
+	 * This parameter affects how accurately the algorithm captures short silences. 
 	 * @default 1024
 	 */
 	hopSize?: number;
 	/**
-	 * Setting a minimum duration for a silence period helps avoid detecting brief gaps between sounds as silences. 
-	 * @default 0.5
+	 * Setting a minimum duration in **milliseconds** for a silence period helps avoid detecting brief gaps between sounds as silences. 
+	 * @default 500
 	 */
 	minDuration?: number;
 };

src/sources/audio.utils.ts

@@ -6,23 +6,20 @@ import type { AudioSlice, SilenceDetectionOptions } from './audio.types';
 /**
  * Detect silences in an audio buffer
  * @param audioBuffer - The web audio buffer.
- * @param threshold - The threshold for silence detection.
- * @param hopSize - The hop size between frames in samples.
- * @param minDuration - Minimum duration for a silence in seconds.
- * @returns An array of the silences in the clip.
+ * @param options - Options for silence detection
  */
 export function detectSilences(
 	audioBuffer: AudioBuffer,
 	options: SilenceDetectionOptions = {}
 ): AudioSlice[] {
-	const { threshold = 0.02, hopSize = 1024, minDuration = 0.5 } = options;
+	const { threshold = 0.02, hopSize = 1024, minDuration = 500 } = options;
 
 	const slices: AudioSlice[] = [];
 	const channel = audioBuffer.getChannelData(0);
 	const sampleRate = audioBuffer.sampleRate;
 
-	// Convert minDuration from seconds to samples
-	const minSamples = Math.floor(minDuration * sampleRate);
+	// Convert minDuration from milliseconds to samples
+	const minSamples = Math.floor((minDuration / 1000) * sampleRate);
 
 	let silenceStart: number | null = null;
 	let consecutiveSilentSamples = 0;