echogarden 1.8.7 → 2.0.0

package/src/audio/SoxPath.ts

@@ -1,7 +1,7 @@
-import path from 'path'
 import { loadPackage } from '../utilities/PackageManager.js'
 import { commandExists } from '../utilities/Utilities.js'
 import { getGlobalOption } from '../api/GlobalOptions.js'
+import { joinPath } from '../utilities/PathUtilities.js'
 
 export async function tryResolvingSoxPath() {
 	if (getGlobalOption('soxPath')) {
@@ -14,7 +14,7 @@ export async function tryResolvingSoxPath() {
 	if (platform === 'win32') {
 		const soxPackagePath = await loadPackage('sox-14.4.1a-win32')
 
-		return path.join(soxPackagePath, 'sox.exe')
+		return joinPath(soxPackagePath, 'sox.exe')
 	}
 
 	if (await commandExists('sox')) {
@@ -24,7 +24,7 @@ export async function tryResolvingSoxPath() {
 	if (platform === 'linux' && arch === 'x64') {
 		const soxPackagePath = await loadPackage('sox-14.4.2-linux-minimal')
 
-		return path.join(soxPackagePath, 'sox')
+		return joinPath(soxPackagePath, 'sox')
 	}
 
 	return undefined

package/src/build-tools/MakeTarballsForInstalledPackages.ts

@@ -1,6 +1,6 @@
-import path from 'path'
 import { existsSync, readdir } from '../utilities/FileSystem.js'
 import { ensureAndGetPackagesDir } from '../utilities/PackageManager.js'
+import { joinPath } from '../utilities/PathUtilities.js'
 import { createNamedTarball } from '../utilities/TarballMaker.js'
 import { setupProgramTerminationListeners } from '../utilities/Utilities.js'
 
@@ -9,11 +9,11 @@ async function makeTarballsForInstalledPackages(tarballDir: string, skipIfExists
 	const packageList = await readdir(packagesDir)
 
 	for (const packageName of packageList) {
-		if (skipIfExists && existsSync(path.join(tarballDir, `${packageName}.tar.gz`))) {
+		if (skipIfExists && existsSync(joinPath(tarballDir, `${packageName}.tar.gz`))) {
 			continue
 		}
 
-		const packagePath = path.join(packagesDir, packageName)
+		const packagePath = joinPath(packagesDir, packageName)
 		await createNamedTarball(packagePath, packageName, tarballDir)
 	}
 }

package/src/cli/CLI.ts

@@ -1,6 +1,6 @@
 import * as API from '../api/API.js'
 import { parseCLIArguments } from './CLIParser.js'
-import { getWithDefault, logToStderr, setupUnhandledExceptionListeners, splitFilenameOnExtendedExtension, stringifyAndFormatJson } from '../utilities/Utilities.js'
+import { parseJSONAndGetType, getWithDefault, logToStderr, parseJson, setupUnhandledExceptionListeners, splitFilenameOnExtendedExtension, stringifyAndFormatJson } from '../utilities/Utilities.js'
 import { getOptionTypeFromSchema, SchemaTypeDefinition } from './CLIOptionsSchema.js'
 import { ParsedConfigFile, parseConfigFile, parseJSONConfigFile } from './CLIConfigFile.js'
 
@@ -10,12 +10,11 @@ import { SubtitlesConfig, subtitlesToText, timelineToSubtitles } from '../subtit
 import { Logger, resetActiveLogger } from '../utilities/Logger.js'
 import { isMainThread, parentPort } from 'node:worker_threads'
 import { encodeFromChannels, getDefaultFFMpegOptionsForSpeech } from '../codecs/FFMpegTranscoder.js'
-import path, { parse as parsePath } from 'node:path'
 import { splitToParagraphs, splitToWords, wordCharacterPattern } from '../nlp/Segmentation.js'
-import { playAudioSamples, playAudioWithWordTimeline } from '../audio/AudioPlayer.js'
+import { playAudioSamplesWithKeyboardControls, playAudioWithWordTimeline } from '../audio/AudioPlayer.js'
 import { extendDeep } from '../utilities/ObjectUtilities.js'
 import { Timeline, TimelineEntry, addTimeOffsetToTimeline, addWordTextOffsetsToTimeline, roundTimelineProperties } from '../utilities/Timeline.js'
-import { ensureDir, existsSync, readAndParseJsonFile, readFile, readdir, writeFileSafe } from '../utilities/FileSystem.js'
+import { ensureDir, existsSync, readAndParseJsonFile, readdir, readFileAsUtf8, writeFileSafe } from '../utilities/FileSystem.js'
 import { formatLanguageCodeWithName, getShortLanguageCode } from '../utilities/Locale.js'
 import { APIOptions } from '../api/APIOptions.js'
 import { ensureAndGetPackagesDir, getVersionTagFromPackageName, loadPackage, resolveVersionTagForUnversionedPackageName } from '../utilities/PackageManager.js'
@@ -23,8 +22,7 @@ import { removePackage } from '../utilities/PackageManager.js'
 import { appName } from '../api/Common.js'
 import { ServerOptions, startServer } from '../server/Server.js'
 import { OpenPromise } from '../utilities/OpenPromise.js'
-import JSON5 from 'json5'
-import { getLowercaseFileExtension, resolveToModuleRootDir } from '../utilities/PathUtilities.js'
+import { getLowercaseFileExtension, joinPath, parsePath, resolveToModuleRootDir } from '../utilities/PathUtilities.js'
 import { CLIOptions, CLIOptionsKeys } from './CLIOptions.js'
 import { convertHtmlToText, formatIntegerWithLeadingZeros, formatListWithQuotedElements } from '../utilities/StringUtilities.js'
 
@@ -431,7 +429,7 @@ export async function speak(operationData: CLIOperationData) {
 		}
 
 		const sourceFileExtension = getLowercaseFileExtension(sourceFile)
-		const fileContent = await readFile(sourceFile, { encoding: 'utf-8' })
+		const fileContent = await readFileAsUtf8(sourceFile)
 
 		if (options.ssml && sourceFileExtension != 'xml' && sourceFileExtension != 'ssml') {
 			throw new Error(`SSML option is set, but source file doesn't have an 'xml' or 'ssml' extension.`)
@@ -445,7 +443,7 @@ export async function speak(operationData: CLIOperationData) {
 			const textContent = await convertHtmlToText(fileContent)
 			textSegments = splitToParagraphs(textContent, 'single', 'preserve')
 		} else if (sourceFileExtension == 'srt' || sourceFileExtension == 'vtt') {
-			const fileContent = await readFile(sourceFile, { encoding: 'utf-8' })
+			const fileContent = await readFileAsUtf8(sourceFile)
 			//textSegments = subtitlesToTimeline(fileContent).map(entry => entry.text)
 			textSegments = [subtitlesToText(fileContent)]
 		} else if (sourceFileExtension == 'xml' || sourceFileExtension == 'ssml') {
@@ -500,7 +498,7 @@ export async function speak(operationData: CLIOperationData) {
 			const audioWithAddedGain = applyGainDecibels(segmentData.audio as RawAudio, gainAmount)
 			const segmentWordTimeline = segmentData.timeline.flatMap(sentenceTimeline => sentenceTimeline.timeline!)
 
-			await playAudioWithWordTimeline(audioWithAddedGain, segmentWordTimeline, segmentData.transcript)
+			await playAudioWithWordTimeline(audioWithAddedGain, segmentWordTimeline, segmentData.transcript, cliOptions.player)
 		}
 	}
 
@@ -590,7 +588,7 @@ export async function transcribe(operationData: CLIOperationData) {
 
 		const normalizedAudioToPlay = normalizeAudioLevel(audioToPlay)
 
-		await playAudioWithWordTimeline(normalizedAudioToPlay, wordTimeline, transcript)
+		await playAudioWithWordTimeline(normalizedAudioToPlay, wordTimeline, transcript, cliOptions.player)
 	}
 }
 
@@ -621,7 +619,7 @@ export async function align(operationData: CLIOperationData) {
 	}
 
 	const referenceFileExtension = getLowercaseFileExtension(alignmentReferenceFile)
-	const fileContent = await readFile(alignmentReferenceFile, { encoding: 'utf-8' })
+	const fileContent = await readFileAsUtf8(alignmentReferenceFile)
 
 	let text: string
 
@@ -686,7 +684,7 @@ export async function align(operationData: CLIOperationData) {
 
 		const normalizedAudioToPlay = normalizeAudioLevel(audioToPlay)
 
-		await playAudioWithWordTimeline(normalizedAudioToPlay, wordTimeline, transcript)
+		await playAudioWithWordTimeline(normalizedAudioToPlay, wordTimeline, transcript, cliOptions.player)
 	}
 }
 
@@ -717,7 +715,7 @@ export async function alignTranslation(operationData: CLIOperationData) {
 	}
 
 	const referenceFileExtension = getLowercaseFileExtension(alignmentReferenceFile)
-	const fileContent = await readFile(alignmentReferenceFile, { encoding: 'utf-8' })
+	const fileContent = await readFileAsUtf8(alignmentReferenceFile)
 
 	let text: string
 
@@ -791,7 +789,7 @@ export async function alignTranslation(operationData: CLIOperationData) {
 
 		const normalizedAudioToPlay = normalizeAudioLevel(audioToPlay)
 
-		await playAudioWithWordTimeline(normalizedAudioToPlay, wordTimeline, translatedTranscript)
+		await playAudioWithWordTimeline(normalizedAudioToPlay, wordTimeline, translatedTranscript, cliOptions.player)
 	}
 }
 
@@ -835,7 +833,7 @@ export async function alignTranscriptAndTranslation(operationData: CLIOperationD
 
 	{
 		const nativeTranscriptFileExtension = getLowercaseFileExtension(nativeTranscriptFilePath)
-		const fileContent = await readFile(nativeTranscriptFilePath, { encoding: 'utf-8' })
+		const fileContent = await readFileAsUtf8(nativeTranscriptFilePath)
 
 
 		if (nativeTranscriptFileExtension == 'txt') {
@@ -853,7 +851,7 @@ export async function alignTranscriptAndTranslation(operationData: CLIOperationD
 
 	{
 		const translatedTranscriptFileExtension = getLowercaseFileExtension(translatedTranscriptFilePath)
-		const fileContent = await readFile(translatedTranscriptFilePath, { encoding: 'utf-8' })
+		const fileContent = await readFileAsUtf8(translatedTranscriptFilePath)
 
 		if (translatedTranscriptFileExtension == 'txt') {
 			translatedTranscript = fileContent
@@ -930,7 +928,7 @@ export async function alignTranscriptAndTranslation(operationData: CLIOperationD
 
 		const normalizedAudioToPlay = normalizeAudioLevel(audioToPlay)
 
-		await playAudioWithWordTimeline(normalizedAudioToPlay, translatedWordTimeline, translatedTranscript)
+		await playAudioWithWordTimeline(normalizedAudioToPlay, translatedWordTimeline, translatedTranscript, cliOptions.player)
 	}
 }
 
@@ -967,7 +965,7 @@ export async function alignTimelineTranslation(operationData: CLIOperationData)
 	}
 
 	const translationFileExtension = getLowercaseFileExtension(translationFilePath)
-	const translationFileContent = await readFile(translationFilePath, { encoding: 'utf-8' })
+	const translationFileContent = await readFileAsUtf8(translationFilePath)
 
 	let translationText: string
 
@@ -1018,7 +1016,7 @@ export async function alignTimelineTranslation(operationData: CLIOperationData)
 		transcriptToPlay = translationText
 		timelineToPlay = translationWordTimeline
 
-		await playAudioWithWordTimeline(normalizedAudioToPlay, timelineToPlay, transcriptToPlay)
+		await playAudioWithWordTimeline(normalizedAudioToPlay, timelineToPlay, transcriptToPlay, cliOptions.player)
 	}
 }
 
@@ -1039,7 +1037,7 @@ export async function translateText(operationData: CLIOperationData) {
 	}
 
 	const inputFileExtension = getLowercaseFileExtension(inputFilename)
-	const inputFileContent = await readFile(inputFilename, { encoding: 'utf-8' })
+	const inputFileContent = await readFileAsUtf8(inputFilename)
 
 	let inputText: string
 
@@ -1186,7 +1184,7 @@ export async function translateSpeech(operationData: CLIOperationData) {
 			transcriptToPlay = transcriptToPlay.trim()
 		}
 
-		await playAudioWithWordTimeline(normalizedAudioToPlay, timelineToPlay, transcriptToPlay)
+		await playAudioWithWordTimeline(normalizedAudioToPlay, timelineToPlay, transcriptToPlay, cliOptions.player)
 	}
 }
 
@@ -1223,7 +1221,7 @@ export async function detectLanguage(operationData: CLIOperationData, mode: 'spe
 
 		await checkOutputFilenames(outputFilenames, false, true, false)
 
-		let text = await readFile(inputFilePath, { encoding: 'utf-8' })
+		let text = await readFileAsUtf8(inputFilePath)
 
 		if (inputFileExtension == 'srt' || inputFileExtension == 'vtt') {
 			text = subtitlesToText(text)
@@ -1332,7 +1330,7 @@ export async function detectVoiceActivity(operationData: CLIOperationData) {
 			return { ...entry, type: 'word' } as TimelineEntry
 		})
 
-		await playAudioWithWordTimeline(normalizedAudio, timelineToPlay)
+		await playAudioWithWordTimeline(normalizedAudio, timelineToPlay, cliOptions.player)
 	}
 }
 
@@ -1377,7 +1375,7 @@ export async function denoise(operationData: CLIOperationData) {
 	logger.end()
 
 	if (cliOptions.play) {
-		await playAudioSamples(denoisedAudio)
+		await playAudioSamplesWithKeyboardControls(denoisedAudio, cliOptions.player)
 	}
 }
 
@@ -1420,7 +1418,7 @@ export async function isolate(operationData: CLIOperationData) {
 	logger.end()
 
 	if (cliOptions.play) {
-		await playAudioSamples(isolatedRawAudio)
+		await playAudioSamplesWithKeyboardControls(isolatedRawAudio, cliOptions.player)
 	}
 }
 
@@ -1806,19 +1804,15 @@ async function optionsLookupToTypedObject<K extends keyof APIOptions>(cliOptions
 			throw new Error(`The property '${key}' is not a Boolean, and cannot be negated using the 'not-' prefix.`)
 		} else if (optionType == 'array' || optionType == 'object') {
 			try {
-				const { default: JSON5 } = await import('json5')
-				parsedValue = JSON5.parse(value)
+				parsedValue = await parseJson(value, true)
 			} catch (e) {
 				parsedValue = value
 			}
 		} else if (optionIsUnion) {
-			const isArrayJSON = value.startsWith('[') && value.endsWith(']')
-			const isObjectJSON = value.startsWith('{') && value.endsWith('}')
-			const isNumberJSON = !isNaN(Number.parseFloat(value))
-			const isBooleanJSON = value == 'true' || value == 'false'
+			const { parsedValue: json5ParsedValue, jsonType } = await parseJSONAndGetType(value, true)
 
-			if (isArrayJSON || isObjectJSON || isNumberJSON || isBooleanJSON) {
-				parsedValue = JSON5.parse(value)
+			if (jsonType === 'number' || jsonType === 'boolean' || jsonType === 'array' || jsonType === 'object') {
+				parsedValue = json5ParsedValue
 			} else {
 				parsedValue = value
 			}
@@ -1941,7 +1935,7 @@ function getFileSaver(outputFilePath: string, allowOverwrite: boolean): FileSave
 		const filenameParts = splitFilenameOnExtendedExtension(parsedPath.base)
 
 		for (let i = 1; existsSync(outputFilePath); i++) {
-			outputFilePath = path.join(parsedPath.dir, `${filenameParts[0]}_${formatIntegerWithLeadingZeros(i, 3)}`)
+			outputFilePath = joinPath(parsedPath.dir, `${filenameParts[0]}_${formatIntegerWithLeadingZeros(i, 3)}`)
 
 			if (filenameParts[1]) {
 				outputFilePath += `.${filenameParts[1]}`
@@ -1956,14 +1950,14 @@ function getFileSaver(outputFilePath: string, allowOverwrite: boolean): FileSave
 	if (fileExtension == 'txt') {
 		fileSaver = async (audio, timeline, text) => {
 			await ensureDir(fileDir)
-			return writeFileSafe(outputFilePath, text, { encoding: 'utf-8' })
+			return writeFileSafe(outputFilePath, text)
 		}
 	} else if (fileExtension == 'json') {
 		fileSaver = async (audio, timeline, text) => {
 			await ensureDir(fileDir)
 
 			const roundedTimeline = roundTimelineProperties(timeline)
-			return writeFileSafe(outputFilePath, stringifyAndFormatJson(roundedTimeline))
+			return writeFileSafe(outputFilePath, await stringifyAndFormatJson(roundedTimeline))
 		}
 	} else if (fileExtension == 'srt') {
 		fileSaver = async (audio, timeline, text, subtitlesConfig) => {

package/src/cli/CLIConfigFile.ts

@@ -1,7 +1,7 @@
-import { readAndParseJsonFile, readFile } from '../utilities/FileSystem.js'
+import { readAndParseJsonFile, readFileAsUtf8 } from '../utilities/FileSystem.js'
 
 export async function parseConfigFile(path: string): Promise<ParsedConfigFile> {
-	const fileContent = await readFile(path, { encoding: 'utf-8' })
+	const fileContent = await readFileAsUtf8(path)
 
 	const lines = fileContent
 		.split(/\r?\n/g)

package/src/cli/CLIOptions.ts

@@ -1,8 +1,11 @@
+import { type AudioPlayerID } from "../audio/AudioPlayer.js"
+
 export interface CLIOptions {
 	play?: boolean
+	player?: AudioPlayerID
 	overwrite?: boolean
 	debug?: boolean
 	config?: string
 }
 
-export const CLIOptionsKeys: (keyof CLIOptions)[] = ['play', 'overwrite', 'debug', 'config']
+export const CLIOptionsKeys: (keyof CLIOptions)[] = ['play', 'player', 'overwrite', 'debug', 'config']

package/src/codecs/FFMpegTranscoder.ts

@@ -3,11 +3,11 @@ import { spawn } from 'child_process'
 import { encodeRawAudioToWave, decodeWaveToRawAudio, RawAudio } from '../audio/AudioUtilities.js'
 
 import { Logger } from '../utilities/Logger.js'
-import { commandExists, concatBuffers, logToStderr } from '../utilities/Utilities.js'
-import path from 'node:path'
+import { commandExists, concatUint8Arrays, isUint8Array, logToStderr } from '../utilities/Utilities.js'
 import { loadPackage } from '../utilities/PackageManager.js'
 import { getGlobalOption } from '../api/GlobalOptions.js'
 import { existsSync } from '../utilities/FileSystem.js'
+import { joinPath } from '../utilities/PathUtilities.js'
 
 const log = logToStderr
 
@@ -27,7 +27,7 @@ export async function encodeFromChannels(rawAudio: RawAudio, outputOptions: FFMp
 	return transcode(encodeRawAudioToWave(rawAudio), outputOptions)
 }
 
-export async function decodeToChannels(input: string | Buffer, outSampleRate?: number, outChannelCount?: number) {
+export async function decodeToChannels(input: string | Uint8Array, outSampleRate?: number, outChannelCount?: number) {
 	const outputOptions: FFMpegOutputOptions = {
 		codec: 'pcm_f32le',
 		format: 'wav',
@@ -47,7 +47,7 @@ export async function decodeToChannels(input: string | Buffer, outSampleRate?: n
 	return rawAudio
 }
 
-export async function transcode(input: string | Buffer, outputOptions: FFMpegOutputOptions) {
+export async function transcode(input: string | Uint8Array, outputOptions: FFMpegOutputOptions) {
 	const executablePath = await getFFMpegExecutablePath()
 
 	if (!executablePath) {
@@ -57,16 +57,16 @@ export async function transcode(input: string | Buffer, outputOptions: FFMpegOut
 	return transcode_CLI(executablePath, input, outputOptions)
 }
 
-async function transcode_CLI(ffmpegCommand: string, input: string | Buffer, outputOptions: FFMpegOutputOptions) {
-	return new Promise<Buffer>((resolve, reject) => {
+async function transcode_CLI(ffmpegCommand: string, input: string | Uint8Array, outputOptions: FFMpegOutputOptions) {
+	return new Promise<Uint8Array>((resolve, reject) => {
 		const logger = new Logger()
 		logger.start('Transcode with command-line ffmpeg')
 
-		const args = buildCommandLineArguments(Buffer.isBuffer(input) ? '-' : input, outputOptions)
+		const args = buildCommandLineArguments(isUint8Array(input) ? '-' : input, outputOptions)
 
 		const process = spawn(ffmpegCommand, args)
 
-		if (Buffer.isBuffer(input)) {
+		if (isUint8Array(input)) {
 			process.stdin.end(input)
 		} else if (typeof input === 'string') {
 			if (!existsSync(input)) {
@@ -75,7 +75,7 @@ async function transcode_CLI(ffmpegCommand: string, input: string | Buffer, outp
 			}
 		}
 
-		const stdoutChunks: Buffer[] = []
+		const stdoutChunks: Uint8Array[] = []
 		let stderrOutput = ''
 
 		process.stdout.on('data', (data) => {
@@ -94,7 +94,7 @@ async function transcode_CLI(ffmpegCommand: string, input: string | Buffer, outp
 
 		process.on('close', (exitCode) => {
 			if (exitCode == 0) {
-				const concatenatedChunks = concatBuffers(stdoutChunks)
+				const concatenatedChunks = concatUint8Arrays(stdoutChunks)
 
 				resolve(concatenatedChunks)
 			} else {
@@ -206,7 +206,7 @@ async function getFFMpegExecutablePath() {
 		filename += '.exe'
 	}
 
-	return path.join(ffmpegPackagePath, filename)
+	return joinPath(ffmpegPackagePath, filename)
 }
 
 export function getDefaultFFMpegOptionsForSpeech(fileExtension: string, customBitrate?: number) {

package/src/codecs/TIMITCodec.ts

@@ -1,13 +1,14 @@
 import { decodeToChannels } from '../audio/AudioBufferConversion.js'
-import { readFile } from '../utilities/FileSystem.js'
+import { decodeAscii } from '../encodings/Ascii.js'
+import { readFileAsBinary } from '../utilities/FileSystem.js'
 import { SampleFormat } from './WaveCodec.js'
 
 export async function decodeTimitAudioFile(filename: string) {
-	return decodeTimitAudio(await readFile(filename))
+	return decodeTimitAudio(await readFileAsBinary(filename))
 }
 
-export function decodeTimitAudio(data: Buffer) {
-	if (data.subarray(0, 16).toString('ascii') != 'NIST_1A\n   1024\n') {
+export function decodeTimitAudio(data: Uint8Array) {
+	if (decodeAscii(data.subarray(0, 16)) != 'NIST_1A\n   1024\n') {
 		throw new Error('Data is not a valid TIMIT audio file')
 	}
 

package/src/codecs/WaveCodec.ts

@@ -1,6 +1,9 @@
 import * as AudioBufferConversion from '../audio/AudioBufferConversion.js'
 import { RawAudio } from '../audio/AudioUtilities.js'
-import { concatBuffers, logToStderr } from '../utilities/Utilities.js'
+import { readUint16LE, readUint32LE, writeAscii, writeUint16LE, writeUint32LE } from '../utilities/BinaryUtilities.js'
+import { encodeHex, decodeHex } from '../encodings/Hex.js'
+import { concatUint8Arrays, logToStderr } from '../utilities/Utilities.js'
+import { decodeAscii } from '../encodings/Ascii.js'
 
 const log = logToStderr
 
@@ -16,25 +19,25 @@ export function encodeWave(rawAudio: RawAudio, bitDepth: BitDepth = 16, sampleFo
 	const formatSubChunk = new WaveFormat(audioChannels.length, sampleRate, bitDepth, sampleFormat, speakerPositionMask)
 	const formatSubChunkBuffer = formatSubChunk.serialize(shouldUseExtensibleFormat)
 
-	const dataSubChunkBuffer = Buffer.alloc(4 + 4 + audioDataLength)
-	dataSubChunkBuffer.write('data', 0, 'ascii')
+	const dataSubChunkBuffer = new Uint8Array(4 + 4 + audioDataLength)
+	writeAscii(dataSubChunkBuffer, 'data', 0)
 	const dataChunkLength = Math.min(audioDataLength, 4294967295) // Ensure large data chunk length is clipped to max
-	dataSubChunkBuffer.writeUint32LE(dataChunkLength, 4)
+	writeUint32LE(dataSubChunkBuffer, dataChunkLength, 4)
 	dataSubChunkBuffer.set(audioBuffer, 8)
 
-	const riffChunkHeaderBuffer = Buffer.alloc(12)
-	riffChunkHeaderBuffer.write('RIFF', 0, 'ascii')
+	const riffChunkHeaderBuffer = new Uint8Array(12)
+	writeAscii(riffChunkHeaderBuffer, 'RIFF', 0)
 	const riffChunkLength = Math.min(4 + formatSubChunkBuffer.length + dataSubChunkBuffer.length, 4294967295) // Ensure large RIFF chunk length is clipped to max
-	riffChunkHeaderBuffer.writeUint32LE(riffChunkLength, 4)
-	riffChunkHeaderBuffer.write('WAVE', 8, 'ascii')
+	writeUint32LE(riffChunkHeaderBuffer, riffChunkLength, 4)
+	writeAscii(riffChunkHeaderBuffer, 'WAVE', 8)
 
-	return concatBuffers([riffChunkHeaderBuffer, formatSubChunkBuffer, dataSubChunkBuffer])
+	return concatUint8Arrays([riffChunkHeaderBuffer, formatSubChunkBuffer, dataSubChunkBuffer])
 }
 
-export function decodeWave(waveData: Buffer, ignoreTruncatedChunks = true, ignoreOverflowingDataChunks = true) {
+export function decodeWave(waveData: Uint8Array, ignoreTruncatedChunks = true, ignoreOverflowingDataChunks = true) {
 	let readOffset = 0
 
-	const riffId = waveData.subarray(readOffset, readOffset + 4).toString('ascii')
+	const riffId = decodeAscii(waveData.subarray(readOffset, readOffset + 4))
 
 	if (riffId != 'RIFF') {
 		throw new Error('Not a valid wave file. No RIFF id found at offset 0.')
@@ -42,11 +45,11 @@ export function decodeWave(waveData: Buffer, ignoreTruncatedChunks = true, ignor
 
 	readOffset += 4
 
-	let riffChunkSize = waveData.readUInt32LE(readOffset)
+	let riffChunkSize = readUint32LE(waveData, readOffset)
 
 	readOffset += 4
 
-	const waveId = waveData.subarray(readOffset, readOffset + 4).toString('ascii')
+	const waveId = decodeAscii(waveData.subarray(readOffset, readOffset + 4))
 
 	if (waveId != 'WAVE') {
 		throw new Error('Not a valid wave file. No WAVE id found at offset 8.')
@@ -66,14 +69,14 @@ export function decodeWave(waveData: Buffer, ignoreTruncatedChunks = true, ignor
 
 	readOffset += 4
 
-	let formatSubChunkBodyBuffer: Buffer | undefined
-	const dataBuffers: Buffer[] = []
+	let formatSubChunkBodyBuffer: Uint8Array | undefined
+	const dataBuffers: Uint8Array[] = []
 
 	while (true) {
-		const subChunkIdentifier = waveData.subarray(readOffset, readOffset + 4).toString('ascii')
+		const subChunkIdentifier = decodeAscii(waveData.subarray(readOffset, readOffset + 4))
 		readOffset += 4
 
-		let subChunkSize = waveData.readUInt32LE(readOffset)
+		let subChunkSize = readUint32LE(waveData, readOffset)
 		readOffset += 4
 
 		if (!ignoreTruncatedChunks && subChunkSize > waveData.length - readOffset) {
@@ -125,7 +128,7 @@ export function decodeWave(waveData: Buffer, ignoreTruncatedChunks = true, ignor
 	const bitDepth = waveFormat.bitDepth
 	const speakerPositionMask = waveFormat.speakerPositionMask
 
-	const concatenatedDataBuffers = concatBuffers(dataBuffers)
+	const concatenatedDataBuffers = concatUint8Arrays(dataBuffers)
 	dataBuffers.length = 0 // Allow the garbage collector to free up memory held by the data buffers
 
 	const audioChannels = AudioBufferConversion.decodeToChannels(concatenatedDataBuffers, channelCount, bitDepth, sampleFormat)
@@ -139,7 +142,7 @@ export function decodeWave(waveData: Buffer, ignoreTruncatedChunks = true, ignor
 	}
 }
 
-export function repairWave(waveData: Buffer) {
+export function repairWave(waveData: Uint8Array) {
 	const { rawAudio, sourceSampleFormat, sourceBitDepth } = decodeWave(waveData)
 
 	return encodeWave(rawAudio, sourceBitDepth, sourceSampleFormat)
@@ -177,25 +180,25 @@ class WaveFormat { // 24 bytes total for PCM, 26 for float
 
 		const serializedSize = sampleFormatToSerializedSize[sampleFormatId]
 
-		const result = Buffer.alloc(serializedSize)
+		const result = new Uint8Array(serializedSize)
 
-		result.write('fmt ', 0, 'ascii') // + 4
-		result.writeUint32LE(serializedSize - 8, 4) // + 4
+		writeAscii(result, 'fmt ', 0) // + 4
+		writeUint32LE(result, serializedSize - 8, 4) // + 4
 
-		result.writeUint16LE(sampleFormatId, 8) // + 2
-		result.writeUint16LE(this.channelCount, 10) // + 2
-		result.writeUint32LE(this.sampleRate, 12) // + 4
-		result.writeUint32LE(this.byteRate, 16) // + 4
-		result.writeUint16LE(this.blockAlign, 20) // + 2
-		result.writeUint16LE(this.bitDepth, 22) // + 2
+		writeUint16LE(result, sampleFormatId, 8) // + 2
+		writeUint16LE(result, this.channelCount, 10) // + 2
+		writeUint32LE(result, this.sampleRate, 12) // + 4
+		writeUint32LE(result, this.byteRate, 16) // + 4
+		writeUint16LE(result, this.blockAlign, 20) // + 2
+		writeUint16LE(result, this.bitDepth, 22) // + 2
 
 		if (useExtensibleFormat) {
-			result.writeUint16LE(serializedSize - 26, 24) // + 2 (extension size)
-			result.writeUint16LE(this.bitDepth, 26) // + 2 (valid bits per sample)
-			result.writeUint32LE(this.speakerPositionMask, 28) // + 2 (speaker position mask)
+			writeUint16LE(result, serializedSize - 26, 24) // + 2 (extension size)
+			writeUint16LE(result, this.bitDepth, 26) // + 2 (valid bits per sample)
+			writeUint32LE(result, this.speakerPositionMask, 28) // + 2 (speaker position mask)
 
 			if (this.sampleFormat == SampleFormat.PCM || this.sampleFormat == SampleFormat.Float) {
-				result.set(Buffer.from(this.guid, 'hex'), 32)
+				result.set(decodeHex(this.guid), 32)
 			} else {
 				throw new Error(`Extensible format is not supported for sample format ${this.sampleFormat}`)
 			}
@@ -204,11 +207,11 @@ class WaveFormat { // 24 bytes total for PCM, 26 for float
 		return result
 	}
 
-	static deserializeFrom(formatChunkBody: Buffer) { // chunkBody should not include the first 8 bytes
-		let sampleFormat = formatChunkBody.readUint16LE(0) // + 2
-		const channelCount = formatChunkBody.readUint16LE(2) // + 2
-		const sampleRate = formatChunkBody.readUint32LE(4) // + 4
-		const bitDepth = formatChunkBody.readUint16LE(14)
+	static deserializeFrom(formatChunkBody: Uint8Array) { // chunkBody should not include the first 8 bytes
+		let sampleFormat = readUint16LE(formatChunkBody, 0) // + 2
+		const channelCount = readUint16LE(formatChunkBody, 2) // + 2
+		const sampleRate = readUint32LE(formatChunkBody, 4) // + 4
+		const bitDepth = readUint16LE(formatChunkBody, 14)
 		let speakerPositionMask = 0
 
 		if (sampleFormat == 65534) {
@@ -216,9 +219,9 @@ class WaveFormat { // 24 bytes total for PCM, 26 for float
 				throw new Error(`Format subchunk specifies a format id of 65534 (extensible) but its body size is ${formatChunkBody.length} bytes, which is smaller than the minimum expected of 40 bytes`)
 			}
 
-			speakerPositionMask = formatChunkBody.readUint16LE(20)
+			speakerPositionMask = readUint16LE(formatChunkBody, 20)
 
-			const guid = formatChunkBody.subarray(24, 40).toString('hex')
+			const guid = encodeHex(formatChunkBody.subarray(24, 40))
 
 			if (guid == sampleFormatToGuid[SampleFormat.PCM]) {
 				sampleFormat = SampleFormat.PCM

package/src/data-structures/DynamicTypedArray.ts

@@ -0,0 +1,64 @@
+import { TypedArray, TypedArrayConstructor } from "../typings/TypedArray.js"
+
+export class DynamicTypedArray<T extends TypedArray> {
+	elements: TypedArray
+	length = 0
+
+	constructor(private TypedArrayConstructor: TypedArrayConstructor<T>, initialCapacity = 4) {
+		this.elements = new TypedArrayConstructor(initialCapacity)
+	}
+
+	add(newElement: number) {
+		const length = this.length
+
+		if (length === this.elements.length) {
+			this.ensureCapacity(length + 1)
+		}
+
+		this.elements[length] = newElement
+		this.length += 1
+	}
+
+	addMany(...newElements: number[]) {
+		this.addArray(newElements)
+	}
+
+	addArray(newElements: ArrayLike<number>) {
+		const addedCount = newElements.length
+
+		this.ensureCapacity(this.length + addedCount)
+
+		this.elements.set(newElements, this.length)
+		this.length += addedCount
+	}
+
+	ensureCapacity(requiredCapacity: number) {
+		if (requiredCapacity > this.elements.length) {
+			const newCapacity = requiredCapacity * 2
+
+			const newElements = new this.TypedArrayConstructor(newCapacity)
+			newElements.set(this.toTypedArray())
+
+			this.elements = newElements
+		}
+	}
+
+	toTypedArray() {
+		return this.elements.subarray(0, this.length) as T
+	}
+
+	clear() {
+		this.length = 0
+	}
+}
+
+export function createDynamicUint8Array(initialCapacity?: number): DynamicUint8Array {
+	return new DynamicTypedArray<Uint8Array>(Uint8Array, initialCapacity)
+}
+
+export function createDynamicUint16Array(initialCapacity?: number): DynamicUint16Array {
+	return new DynamicTypedArray<Uint16Array>(Uint16Array, initialCapacity)
+}
+
+export type DynamicUint8Array = DynamicTypedArray<Uint8Array>
+export type DynamicUint16Array = DynamicTypedArray<Uint16Array>