spessasynth_core 4.4.7 → 4.4.8

package/dist/index.js

@@ -411,7 +411,7 @@ var RIFFChunk = class RIFFChunk {
 		}
 		const parts = [getStringBytes(headerWritten), sizeBytes];
 		if (isList) parts.push(getStringBytes(header));
-		parts.push(...chunks);
+		for (const chunk of chunks) parts.push(chunk);
 		if (totalSize % 2 !== 0) parts.push(/* @__PURE__ */ new Uint8Array(1));
 		return parts;
 	}
@@ -511,8 +511,8 @@ function audioToWav(audioData, sampleRate, options = DEFAULT_WAV_WRITE_OPTIONS)
 	let cueChunk = new IndexedByteArray(0);
 	const cueOn = loop?.end !== void 0 && loop?.start !== void 0;
 	if (cueOn) {
-		const loopStartSamples = Math.floor(loop.start * sampleRate);
-		const loopEndSamples = Math.floor(loop.end * sampleRate);
+		const loopStartSamples = Math.round(loop.start * sampleRate);
+		const loopEndSamples = Math.round(loop.end * sampleRate);
 		const cueStart = new IndexedByteArray(24);
 		writeLittleEndianIndexed(cueStart, 0, 4);
 		writeLittleEndianIndexed(cueStart, 0, 4);
@@ -629,6 +629,105 @@ function audioToWav(audioData, sampleRate, options = DEFAULT_WAV_WRITE_OPTIONS)
 	if (cueOn) wavData.set(cueChunk, offset);
 	return wavData.buffer;
 }
+// src/utils/read_wav.ts
+/**
+* Reads a WAVE file into PCM audio data, the counterpart of {@link audioToWav}.
+*
+* It reads 8, 16, 24 and 32-bit integer PCM and 32 and 64-bit float files (including `WAVE_FORMAT_EXTENSIBLE`).
+* The loop is read from the first loop of the `smpl` chunk. Without one, the first two points of the `cue ` chunk
+* are taken as the loop start and end, which is how {@link audioToWav} writes it.
+* Other files may use cue points as plain markers, so such a loop is only reliable for files written by core.
+*
+* > **Note**
+* >
+* > The returned loop end is exclusive, like the SoundFont loop end.
+*
+* @param buffer The binary WAVE file.
+* @returns The audio data (one array per channel), the sample rate and the loop, if the file has one.
+* @throws Error if the file is not a valid or supported WAVE file.
+*
+* @group Utilities
+*/
+function wavToAudio(buffer) {
+	const view = new DataView(buffer);
+	const bytes = new Uint8Array(buffer);
+	const fourCC = (at) => String.fromCodePoint(bytes[at], bytes[at + 1], bytes[at + 2], bytes[at + 3]);
+	if (buffer.byteLength < 12 || fourCC(0) !== "RIFF" || fourCC(8) !== "WAVE") throw new Error("Not a WAVE file.");
+	let format = 0;
+	let channels = 0;
+	let sampleRate = 0;
+	let bitsPerSample = 0;
+	let dataStart = -1;
+	let dataSize = 0;
+	let smplLoop;
+	const cuePoints = new Array();
+	let pos = 12;
+	while (pos + 8 <= buffer.byteLength) {
+		const id = fourCC(pos);
+		const size = view.getUint32(pos + 4, true);
+		const body = pos + 8;
+		const available = Math.min(size, buffer.byteLength - body);
+		switch (id) {
+			case "fmt ":
+				format = view.getUint16(body, true);
+				channels = view.getUint16(body + 2, true);
+				sampleRate = view.getUint32(body + 4, true);
+				bitsPerSample = view.getUint16(body + 14, true);
+				if (format === 65534 && size >= 26) format = view.getUint16(body + 24, true);
+				break;
+			case "data":
+				dataStart = body;
+				dataSize = available;
+				break;
+			case "smpl":
+				if ((size >= 36 ? view.getUint32(body + 28, true) : 0) > 0 && size >= 60) smplLoop = {
+					start: view.getUint32(body + 36 + 8, true),
+					end: view.getUint32(body + 36 + 12, true) + 1
+				};
+				break;
+			case "cue ": {
+				const count = view.getUint32(body, true);
+				for (let i = 0; i < count && 4 + (i + 1) * 24 <= size; i++) cuePoints.push(view.getUint32(body + 4 + i * 24 + 20, true));
+				break;
+			}
+		}
+		pos = body + size + size % 2;
+	}
+	if (channels === 0 || dataStart === -1) throw new Error("The WAVE file has no fmt or data chunk!");
+	const bytesPerSample = bitsPerSample >> 3;
+	const isFloat = format === 3;
+	if (format !== 1 && format !== 3 || (isFloat ? ![4, 8].includes(bytesPerSample) : bytesPerSample < 1 || bytesPerSample > 4)) throw new Error(`Unsupported WAVE format ${format} with ${bitsPerSample} bits per sample.`);
+	const frames = Math.floor(dataSize / (bytesPerSample * channels));
+	const audioData = Array.from({ length: channels }, () => new Float32Array(frames));
+	for (let i = 0; i < frames; i++) for (let c = 0; c < channels; c++) {
+		const at = dataStart + (i * channels + c) * bytesPerSample;
+		let value;
+		if (isFloat) value = bytesPerSample === 4 ? view.getFloat32(at, true) : view.getFloat64(at, true);
+		else switch (bytesPerSample) {
+			case 1:
+				value = (view.getUint8(at) - 128) / 128;
+				break;
+			case 2:
+				value = view.getInt16(at, true) / 32768;
+				break;
+			case 3:
+				value = ((bytes[at + 2] << 24 | bytes[at + 1] << 16 | bytes[at] << 8) >> 8) / 8388608;
+				break;
+			default: value = view.getInt32(at, true) / 2147483648;
+		}
+		audioData[c][i] = value;
+	}
+	let loop = smplLoop;
+	if (!loop && cuePoints.length >= 2) loop = {
+		start: cuePoints[0],
+		end: cuePoints[1]
+	};
+	return {
+		audioData,
+		sampleRate,
+		loop
+	};
+}
 // src/utils/loggin.ts
 /**
 * SpessaSynth can print out additional info to the console or print nothing at all.
@@ -1603,56 +1702,43 @@ const GeneratorLimits = Object.freeze({
 		min: -12e3,
 		max: 12e3,
 		def: 0,
-		nrpn: 2,
-		presetMin: -24e3,
-		presetMax: 24e3
+		nrpn: 2
 	},
 	[GeneratorTypes.vibLfoToPitch]: {
 		min: -12e3,
 		max: 12e3,
 		def: 0,
-		nrpn: 2,
-		presetMin: -24e3,
-		presetMax: 24e3
+		nrpn: 2
 	},
 	[GeneratorTypes.modEnvToPitch]: {
 		min: -12e3,
 		max: 12e3,
 		def: 0,
-		nrpn: 2,
-		presetMin: -24e3,
-		presetMax: 24e3
+		nrpn: 2
 	},
 	[GeneratorTypes.initialFilterFc]: {
 		min: 1500,
 		max: 13500,
 		def: 13500,
-		nrpn: 2,
-		presetMin: -21e3,
-		presetMax: 21e3
+		nrpn: 2
 	},
 	[GeneratorTypes.initialFilterQ]: {
 		min: 0,
 		max: 960,
 		def: 0,
-		nrpn: 1,
-		presetMin: -960
+		nrpn: 1
 	},
 	[GeneratorTypes.modLfoToFilterFc]: {
 		min: -12e3,
 		max: 12e3,
 		def: 0,
-		nrpn: 2,
-		presetMin: -24e3,
-		presetMax: 24e3
+		nrpn: 2
 	},
 	[GeneratorTypes.modEnvToFilterFc]: {
 		min: -12e3,
 		max: 12e3,
 		def: 0,
-		nrpn: 2,
-		presetMin: -24e3,
-		presetMax: 24e3
+		nrpn: 2
 	},
 	[GeneratorTypes.endAddrsCoarseOffset]: {
 		min: -32768,
@@ -1664,189 +1750,145 @@ const GeneratorLimits = Object.freeze({
 		min: -960,
 		max: 960,
 		def: 0,
-		nrpn: 1,
-		presetMin: -1920,
-		presetMax: 1920
+		nrpn: 1
 	},
 	[GeneratorTypes.chorusEffectsSend]: {
 		min: 0,
 		max: 1e3,
 		def: 0,
-		nrpn: 1,
-		presetMin: -1e3
+		nrpn: 1
 	},
 	[GeneratorTypes.reverbEffectsSend]: {
 		min: 0,
 		max: 1e3,
 		def: 0,
-		nrpn: 1,
-		presetMin: -1e3
+		nrpn: 1
 	},
 	[GeneratorTypes.pan]: {
 		min: -500,
 		max: 500,
 		def: 0,
-		nrpn: 1,
-		presetMin: -1e3,
-		presetMax: 1e3
+		nrpn: 1
 	},
 	[GeneratorTypes.delayModLFO]: {
 		min: -12e3,
 		max: 5e3,
 		def: -12e3,
-		nrpn: 2,
-		presetMin: -21e3,
-		presetMax: 21e3
+		nrpn: 2
 	},
 	[GeneratorTypes.freqModLFO]: {
 		min: -16e3,
 		max: 4500,
 		def: 0,
-		nrpn: 4,
-		presetMin: -21e3,
-		presetMax: 21e3
+		nrpn: 4
 	},
 	[GeneratorTypes.delayVibLFO]: {
 		min: -12e3,
 		max: 5e3,
 		def: -12e3,
-		nrpn: 2,
-		presetMin: -21e3,
-		presetMax: 21e3
+		nrpn: 2
 	},
 	[GeneratorTypes.freqVibLFO]: {
 		min: -16e3,
 		max: 4500,
 		def: 0,
-		nrpn: 4,
-		presetMin: -21e3,
-		presetMax: 21e3
+		nrpn: 4
 	},
 	[GeneratorTypes.delayModEnv]: {
 		min: -32768,
 		max: 5e3,
 		def: -32768,
-		nrpn: 2,
-		presetMin: -21e3,
-		presetMax: 21e3
+		nrpn: 2
 	},
 	[GeneratorTypes.attackModEnv]: {
 		min: -32768,
 		max: 8e3,
 		def: -32768,
-		nrpn: 2,
-		presetMin: -21e3,
-		presetMax: 21e3
+		nrpn: 2
 	},
 	[GeneratorTypes.holdModEnv]: {
 		min: -12e3,
 		max: 5e3,
 		def: -12e3,
-		nrpn: 2,
-		presetMin: -21e3,
-		presetMax: 21e3
+		nrpn: 2
 	},
 	[GeneratorTypes.decayModEnv]: {
 		min: -12e3,
 		max: 8e3,
 		def: -12e3,
-		nrpn: 2,
-		presetMin: -21e3,
-		presetMax: 21e3
+		nrpn: 2
 	},
 	[GeneratorTypes.sustainModEnv]: {
 		min: 0,
 		max: 1e3,
 		def: 0,
-		nrpn: 1,
-		presetMin: -1e3
+		nrpn: 1
 	},
 	[GeneratorTypes.releaseModEnv]: {
 		min: -12e3,
 		max: 8e3,
 		def: -12e3,
-		nrpn: 2,
-		presetMin: -21e3,
-		presetMax: 21e3
+		nrpn: 2
 	},
 	[GeneratorTypes.keyNumToModEnvHold]: {
 		min: -1200,
 		max: 1200,
 		def: 0,
-		nrpn: 1,
-		presetMin: -2400,
-		presetMax: 2400
+		nrpn: 1
 	},
 	[GeneratorTypes.keyNumToModEnvDecay]: {
 		min: -1200,
 		max: 1200,
 		def: 0,
-		nrpn: 1,
-		presetMin: -2400,
-		presetMax: 2400
+		nrpn: 1
 	},
 	[GeneratorTypes.delayVolEnv]: {
 		min: -12e3,
 		max: 5e3,
 		def: -12e3,
-		nrpn: 2,
-		presetMin: -21e3,
-		presetMax: 21e3
+		nrpn: 2
 	},
 	[GeneratorTypes.attackVolEnv]: {
 		min: -12e3,
 		max: 8e3,
 		def: -12e3,
-		nrpn: 2,
-		presetMin: -21e3,
-		presetMax: 21e3
+		nrpn: 2
 	},
 	[GeneratorTypes.holdVolEnv]: {
 		min: -12e3,
 		max: 5e3,
 		def: -12e3,
-		nrpn: 2,
-		presetMin: -21e3,
-		presetMax: 21e3
+		nrpn: 2
 	},
 	[GeneratorTypes.decayVolEnv]: {
 		min: -12e3,
 		max: 8e3,
 		def: -12e3,
-		nrpn: 2,
-		presetMin: -21e3,
-		presetMax: 21e3
+		nrpn: 2
 	},
 	[GeneratorTypes.sustainVolEnv]: {
 		min: 0,
 		max: 1440,
 		def: 0,
-		nrpn: 1,
-		presetMin: -1440
+		nrpn: 1
 	},
 	[GeneratorTypes.releaseVolEnv]: {
 		min: -12e3,
 		max: 8e3,
 		def: -12e3,
-		nrpn: 2,
-		presetMin: -21e3,
-		presetMax: 21e3
+		nrpn: 2
 	},
 	[GeneratorTypes.keyNumToVolEnvHold]: {
 		min: -1200,
 		max: 1200,
 		def: 0,
-		nrpn: 1,
-		presetMin: -2400,
-		presetMax: 2400
+		nrpn: 1
 	},
 	[GeneratorTypes.keyNumToVolEnvDecay]: {
 		min: -1200,
 		max: 1200,
 		def: 0,
-		nrpn: 1,
-		presetMin: -2400,
-		presetMax: 2400
+		nrpn: 1
 	},
 	[GeneratorTypes.startloopAddrsCoarseOffset]: {
 		min: -32768,
@@ -1870,8 +1912,7 @@ const GeneratorLimits = Object.freeze({
 		min: 0,
 		max: 1440,
 		def: 0,
-		nrpn: 1,
-		presetMin: -1440
+		nrpn: 1
 	},
 	[GeneratorTypes.endloopAddrsCoarseOffset]: {
 		min: -32768,
@@ -1883,28 +1924,23 @@ const GeneratorLimits = Object.freeze({
 		min: -120,
 		max: 120,
 		def: 0,
-		nrpn: 1,
-		presetMin: -240,
-		presetMax: 240
+		nrpn: 1
 	},
 	[GeneratorTypes.fineTune]: {
 		min: -12700,
 		max: 12700,
 		def: 0,
-		nrpn: 1,
-		presetMin: -198,
-		presetMax: 198
+		nrpn: 1
 	},
 	[GeneratorTypes.scaleTuning]: {
 		min: 0,
 		max: 1200,
 		def: 100,
-		nrpn: 1,
-		presetMin: -1200
+		nrpn: 1
 	},
 	[GeneratorTypes.exclusiveClass]: {
 		min: 0,
-		max: 99999,
+		max: 32767,
 		def: 0,
 		nrpn: 0
 	},
@@ -3997,6 +4033,12 @@ var MIDIUtils = class MIDIUtils {
 					controller: MIDIControllers.reverbDepth,
 					value
 				}];
+				case 20: return [{
+					type: "Controller Change",
+					channel,
+					controller: MIDIControllers.variationDepth,
+					value
+				}];
 				case 21: return [{
 					type: "Controller Change",
 					channel,
@@ -7337,6 +7379,22 @@ var BasicSample = class {
 		return this.linkedTo.length;
 	}
 	/**
+	* If the decoded float data is currently held in memory.
+	* Check it before {@link getAudioData} to know if the call has to decode,
+	* then use {@link releaseDecoded} to drop the copy again.
+	*/
+	get isDecoded() {
+		return this.audioData !== void 0;
+	}
+	/**
+	* If the decoded float data can be made again from the stored data.
+	* False for replaced data (set with {@link BasicSample.setAudioData}), which has nothing to decode from.
+	* @internal
+	*/
+	get canRedecode() {
+		return !this.dataOverridden && (this.compressedData !== void 0 || this.s16leData !== void 0);
+	}
+	/**
 	* Get raw data for writing the file, either a compressed bit stream or signed 16-bit little endian PCM data.
 	* @param allowVorbis if vorbis file data is allowed.
 	* @return either s16le or vorbis data.
@@ -7412,7 +7470,7 @@ var BasicSample = class {
 	* @returns True if the decoded data was dropped.
 	*/
 	releaseDecoded() {
-		if (this.audioData && !this.dataOverridden && (this.compressedData || this.s16leData)) {
+		if (this.audioData && this.canRedecode) {
 			this.audioData = void 0;
 			return true;
 		}
@@ -7444,12 +7502,13 @@ var BasicSample = class {
 		this.setAudioData(resampled, newSampleRate);
 	}
 	/**
-	* Compresses the audio data
+	* Compresses the audio data.
 	* @param encodeVorbis the compression function to use when compressing.
+	* @returns True if the sample is compressed afterward, false if the encoder failed and it stays uncompressed.
 	* @internal
 	*/
 	async compressSample(encodeVorbis) {
-		if (this.isCompressed) return;
+		if (this.isCompressed) return true;
 		try {
 			let audioData = this.getAudioData();
 			if (this.sampleRate < 8e3 || this.sampleRate > 96e3) {
@@ -7458,9 +7517,11 @@ var BasicSample = class {
 			}
 			const compressed = await encodeVorbis(audioData, this.sampleRate);
 			this.setCompressedData(compressed);
+			return true;
 		} catch (error) {
 			SpessaLog.warn(`Failed to compress ${this.name}. Leaving as uncompressed!`, error);
 			this.compressedData = void 0;
+			return false;
 		}
 	}
 	/**
@@ -7510,16 +7571,17 @@ var BasicSample = class {
 		}
 	}
 	/**
-	* Links the sample to a given instrument
-	* @param instrument the instrument to link to
+	* Links the sample to a given instrument.
+	* @param instrument the instrument to link to.
 	* @internal
 	*/
 	linkTo(instrument) {
 		this.linkedTo.push(instrument);
 	}
 	/**
-	* Unlinks the sample from a given instrument
-	* @param instrument the instrument to unlink from
+	* Unlinks the sample from a given instrument.
+	* @param instrument the instrument to unlink from.
+	* @internal
 	*/
 	unlinkFrom(instrument) {
 		const index = this.linkedTo.indexOf(instrument);
@@ -7886,12 +7948,12 @@ var ModulatorSource = class ModulatorSource {
 	*/
 	curveType;
 	/**
-	* @internal
-	* @param index
-	* @param curveType
-	* @param isCC
-	* @param isBipolar
-	* @param isNegative
+	* Creates a new modulator source.
+	* @param index The controller or MIDI CC number, see `isCC`.
+	* @param curveType How the minimum value approaches the maximum value.
+	* @param isCC If the index is a MIDI CC instead of a general controller.
+	* @param isBipolar If the source is bipolar (-1 to 1) instead of unipolar (0 to 1).
+	* @param isNegative If the direction of the source is flipped.
 	*/
 	constructor(index = ModulatorControllerSources.noController, curveType = ModulatorCurveTypes.linear, isCC = false, isBipolar = false, isNegative = false) {
 		this.isBipolar = isBipolar;
@@ -8359,14 +8421,13 @@ var BasicLinkedZone = class extends BasicZone {
 	}
 	/**
 	* Links the child to the parent, unless this zone was created without linking.
-	* @internal
+	* Use it to put a zone back after {@link unlinkChild}, for example when undoing a zone deletion.
 	*/
 	linkChild() {
 		if (this.linked) this.child.linkTo(this.parent);
 	}
 	/**
 	* Unlinks the child from the parent, unless this zone was created without linking.
-	* @internal
 	*/
 	unlinkChild() {
 		if (this.linked) this.child.unlinkFrom(this.parent);
@@ -8754,7 +8815,7 @@ var BasicPreset = class BasicPreset {
 					}
 				}
 				finalGenList = finalGenList.filter((g) => g.type !== GeneratorTypes.sampleID && g.type !== GeneratorTypes.keyRange && g.type !== GeneratorTypes.velRange && g.type !== GeneratorTypes.endOper && g.type !== GeneratorTypes.instrument && (!(g.type in GeneratorLimits) || g.value !== GeneratorLimits[g.type].def));
-				const zone = outputInstrument.createZone(instZone.sample);
+				const zone = outputInstrument.createZone(instZone.sample, false);
 				zone.keyRange = instZoneKeyRange;
 				zone.velRange = instZoneVelRange;
 				if (zone.keyRange.min === 0 && zone.keyRange.max === 127) zone.keyRange.min = -1;
@@ -8884,6 +8945,7 @@ var BasicInstrument = class {
 	/**
 	* Unlinks the instrument from a given preset.
 	* @param preset The preset to unlink from.
+	* @internal
 	*/
 	unlinkFrom(preset) {
 		const index = this.linkedTo.indexOf(preset);
@@ -9168,7 +9230,7 @@ function writeSF(bank, software, writeDefaultModulators, writeExtendedLimits, wr
 	*/
 	const infoArrays = [];
 	const writeSF2Info = (type, data) => {
-		if (!data) return;
+		if (data === void 0) return;
 		infoArrays.push(...RIFFChunk.getParts(type, [getStringBytes(data, true, true)], rf64));
 	};
 	const info = bank.soundBankInfo;
@@ -9179,7 +9241,7 @@ function writeSF(bank, software, writeDefaultModulators, writeExtendedLimits, wr
 		infoArrays.push(RIFFChunk.write("ifil", ifilData, rf64));
 	}
 	writeSF2Info("isng", info.soundEngine);
-	writeSF2Info("INAM", info.name);
+	writeSF2Info("INAM", info.name ?? "");
 	writeSF2Info("irom", info.romInfo);
 	if (info.romVersion) {
 		const ifilData = new IndexedByteArray(4);
@@ -9566,6 +9628,9 @@ var DLSSample = class extends BasicSample {
 		if (this.rawData && !this.audioData) return "float32";
 		return super.storedForm;
 	}
+	get canRedecode() {
+		return this.rawData !== void 0 && !this.dataOverridden || super.canRedecode;
+	}
 	getStoredData() {
 		if (this.rawData && !this.audioData) this.getAudioData();
 		return super.getStoredData();
@@ -9574,13 +9639,6 @@ var DLSSample = class extends BasicSample {
 		this.rawData = void 0;
 		super.setStoredData(stored);
 	}
-	releaseDecoded() {
-		if (this.rawData && this.audioData && !this.dataOverridden) {
-			this.audioData = void 0;
-			return true;
-		}
-		return super.releaseDecoded();
-	}
 	releaseData() {
 		if (this.hasData) this.releasedForm = this.storedForm;
 		this.cachedLength = this.sampleLength;
@@ -9658,7 +9716,7 @@ var DownloadableSoundsSample = class DownloadableSoundsSample extends DLSVerifie
 	}
 	static fromSFSample(sample) {
 		const raw = sample.getRawData(false);
-		const dlsSample = new DownloadableSoundsSample(1, 2, sample.sampleRate, new RIFFChunk("data", raw.length, new IndexedByteArray(raw.buffer)));
+		const dlsSample = new DownloadableSoundsSample(1, 2, sample.sampleRate, new RIFFChunk("data", raw.length, new IndexedByteArray(raw.buffer, raw.byteOffset, raw.byteLength)));
 		dlsSample.name = sample.name;
 		dlsSample.waveSample = WaveSample.fromSFSample(sample);
 		return dlsSample;
@@ -10746,8 +10804,8 @@ var DownloadableSoundsInstrument = class DownloadableSoundsInstrument extends DL
 		SpessaLog.groupCollapsed(`%cWriting %c${this.name}%c...`, ConsoleColors.info, ConsoleColors.recognized, ConsoleColors.info);
 		const chunks = [this.writeHeader()];
 		const regionChunks = this.regions.flatMap((r) => r.write());
-		chunks.push(...RIFFChunk.getParts("lrgn", regionChunks, false, true));
-		if (this.articulation.length > 0) chunks.push(...this.articulation.write());
+		for (const part of RIFFChunk.getParts("lrgn", regionChunks, false, true)) chunks.push(part);
+		if (this.articulation.length > 0) for (const part of this.articulation.write()) chunks.push(part);
 		const inam = RIFFChunk.write("INAM", getStringBytes(this.name, true));
 		chunks.push(RIFFChunk.write("INFO", inam, false, true));
 		SpessaLog.groupEnd();
@@ -11032,7 +11090,7 @@ var DownloadableSounds = class DownloadableSounds extends DLSVerifier {
 */
 const DEFAULT_SOUND_BANK_CLONE_OPTIONS = {
 	reuseByName: true,
-	reuseChildrenByName: true,
+	reuseChildren: "name",
 	addToBank: true
 };
 const MAX_BASE_NAME_LENGTH = 37;
@@ -11079,6 +11137,17 @@ var SoundBankCloner = class {
 		this.bank = bank;
 		this.options = fillWithDefaults(options, DEFAULT_SOUND_BANK_CLONE_OPTIONS);
 	}
+	get ownReuse() {
+		return this.options.reuseByName ? "name" : "none";
+	}
+	/**
+	* Gets the clone this session made of an element.
+	* @param source The sample or instrument that was cloned.
+	* @returns The clone, or undefined if the session has not cloned the element.
+	*/
+	getClone(source) {
+		return source instanceof BasicSample ? this.sampleClones.get(source) : this.instrumentClones.get(source);
+	}
 	/**
 	* Clones a sample and its stereo partner.
 	* The data is shared with the original, not copied.
@@ -11086,7 +11155,7 @@ var SoundBankCloner = class {
 	* @returns The clone, or the existing sample with the same name if it is reused.
 	*/
 	cloneSample(sample) {
-		return this.copySample(sample, this.options.reuseByName);
+		return this.copySample(sample, this.ownReuse);
 	}
 	/**
 	* Clones an instrument and the samples it uses.
@@ -11094,7 +11163,7 @@ var SoundBankCloner = class {
 	* @returns The clone, or the existing instrument with the same name if it is reused.
 	*/
 	cloneInstrument(instrument) {
-		return this.copyInstrument(instrument, this.options.reuseByName);
+		return this.copyInstrument(instrument, this.ownReuse);
 	}
 	/**
 	* Clones a preset and the instruments and samples it uses.
@@ -11103,10 +11172,8 @@ var SoundBankCloner = class {
 	*/
 	clonePreset(preset) {
 		const all = [...this.bank.presets, ...this.created.presets];
-		if (this.options.reuseByName) {
-			const existing = all.find((p) => p.name === preset.name);
-			if (existing) return existing;
-		}
+		const existing = this.findReused(preset, all, this.ownReuse);
+		if (existing) return existing;
 		const newPreset = new BasicPreset(this.bank);
 		newPreset.name = this.getFreeName(preset.name, all);
 		newPreset.bankMSB = preset.bankMSB;
@@ -11117,7 +11184,7 @@ var SoundBankCloner = class {
 		newPreset.genre = preset.genre;
 		newPreset.morphology = preset.morphology;
 		newPreset.globalZone.copyFrom(preset.globalZone);
-		for (const zone of preset.zones) newPreset.createZone(this.copyInstrument(zone.instrument, this.options.reuseChildrenByName)).copyFrom(zone);
+		for (const zone of preset.zones) newPreset.createZone(this.copyInstrument(zone.instrument, this.options.reuseChildren)).copyFrom(zone);
 		this.created.presets.push(newPreset);
 		if (this.options.addToBank) this.bank.addPresets(newPreset);
 		return newPreset;
@@ -11126,14 +11193,12 @@ var SoundBankCloner = class {
 		const cloned = this.instrumentClones.get(instrument);
 		if (cloned) return cloned;
 		const all = [...this.bank.instruments, ...this.created.instruments];
-		if (reuse) {
-			const existing = all.find((i) => i.name === instrument.name);
-			if (existing) return existing;
-		}
+		const existing = this.findReused(instrument, all, reuse);
+		if (existing) return existing;
 		const newInstrument = new BasicInstrument();
 		newInstrument.name = this.getFreeName(instrument.name, all);
 		newInstrument.globalZone.copyFrom(instrument.globalZone);
-		for (const zone of instrument.zones) newInstrument.createZone(this.copySample(zone.sample, this.options.reuseChildrenByName)).copyFrom(zone);
+		for (const zone of instrument.zones) newInstrument.createZone(this.copySample(zone.sample, this.options.reuseChildren)).copyFrom(zone);
 		this.instrumentClones.set(instrument, newInstrument);
 		this.created.instruments.push(newInstrument);
 		if (this.options.addToBank) this.bank.addInstruments(newInstrument);
@@ -11143,10 +11208,8 @@ var SoundBankCloner = class {
 		const cloned = this.sampleClones.get(sample);
 		if (cloned) return cloned;
 		const all = [...this.bank.samples, ...this.created.samples];
-		if (reuse) {
-			const existing = all.find((s) => s.name === sample.name);
-			if (existing) return existing;
-		}
+		const existing = this.findReused(sample, all, reuse);
+		if (existing) return existing;
 		const newSample = new BasicSample(this.getFreeName(sample.name, all), sample.sampleRate, sample.originalKey, sample.pitchCorrection, sample.sampleType, sample.loopStart, sample.loopEnd);
 		if (sample.hasData) newSample.setStoredData(sample.getStoredData());
 		else {
@@ -11160,10 +11223,20 @@ var SoundBankCloner = class {
 		if (linked) {
 			const newLinked = this.sampleClones.get(linked);
 			if (newLinked) newSample.setLinkedSample(newLinked, sample.sampleType);
-			else this.copySample(linked, false);
+			else this.copySample(linked, "none");
 		}
 		return newSample;
 	}
+	/**
+	* Finds the element to use instead of a copy, if the options allow one.
+	*/
+	findReused(element, elements, reuse) {
+		switch (reuse) {
+			case "none": return;
+			case "identity": return elements.includes(element) ? element : void 0;
+			case "name": return elements.find((e) => e.name === element.name);
+		}
+	}
 	getFreeName(name, elements) {
 		const taken = new Set(elements.map((e) => e.name));
 		if (!taken.has(name)) return name;
@@ -11329,7 +11402,7 @@ var BasicSoundBank = class BasicSoundBank {
 		const copied = new BasicSoundBank(bank.type);
 		const cloner = new SoundBankCloner(copied, {
 			reuseByName: false,
-			reuseChildrenByName: false
+			reuseChildren: "none"
 		});
 		for (const p of bank.presets) cloner.clonePreset(p);
 		copied.soundBankInfo = { ...bank.soundBankInfo };
@@ -11343,13 +11416,13 @@ var BasicSoundBank = class BasicSoundBank {
 	* @param presets The presets to add.
 	*/
 	addCompletePresets(presets) {
-		this.addPresets(...presets);
+		this.addElements(this.presets, presets);
 		const instrumentList = [];
 		for (const preset of presets) for (const zone of preset.zones) if (zone.instrument && !instrumentList.includes(zone.instrument)) instrumentList.push(zone.instrument);
-		this.addInstruments(...instrumentList);
+		this.addElements(this.instruments, instrumentList);
 		const sampleList = [];
 		for (const instrument of instrumentList) for (const zone of instrument.zones) if (zone.sample && !sampleList.includes(zone.sample)) sampleList.push(zone.sample);
-		this.addSamples(...sampleList);
+		this.addElements(this.samples, sampleList);
 	}
 	/**
 	* Sets the sound bank's sample format _in place_.
@@ -11363,9 +11436,11 @@ var BasicSoundBank = class BasicSoundBank {
 	* @param options Options associated with setting the sample format.
 	* @returns The samples whose sample rate or loop points changed.
 	* Compressing resamples samples outside 8000 to 96000 Hz.
+	* @throws Error if `rejectOnFailure` is set and one of the samples has failed to compress.
 	*/
 	async setSampleFormat(options) {
 		const changed = new Array();
+		const failed = new Array();
 		let writtenCount = 0;
 		const format = options.format;
 		const progressFunc = options.progressFunction;
@@ -11379,7 +11454,7 @@ var BasicSoundBank = class BasicSoundBank {
 					const f = options.compressionFunction;
 					if (!f) throw new Error(`No compression function supplied but '${format}' was requested.`);
 					const { sampleRate, loopStart, loopEnd } = s;
-					await s.compressSample(f);
+					if (!await s.compressSample(f)) failed.push(s);
 					if (s.sampleRate !== sampleRate || s.loopStart !== loopStart || s.loopEnd !== loopEnd) changed.push(s);
 				}
 			}
@@ -11387,6 +11462,7 @@ var BasicSoundBank = class BasicSoundBank {
 			progressFunc?.(writtenCount / this.samples.length);
 			SpessaLog.info(`%cEncoded sample %c${writtenCount}. ${s.name}%c of %c${this.samples.length}%c. Compressed: %c${s.isCompressed}%c.`, ConsoleColors.info, ConsoleColors.recognized, ConsoleColors.info, ConsoleColors.recognized, ConsoleColors.info, s.isCompressed ? ConsoleColors.recognized : ConsoleColors.unrecognized, ConsoleColors.info);
 		}
+		if (failed.length > 0 && options.format === "compressed" && options.rejectOnFailure) throw new Error(`Failed to compress ${failed.length} samples: ${failed.map((s) => s.name).join(", ")}`);
 		switch (format) {
 			default:
 			case "pcm":
@@ -11450,21 +11526,21 @@ var BasicSoundBank = class BasicSoundBank {
 	* @param presets The presets to add.
 	*/
 	addPresets(...presets) {
-		this.presets.push(...presets);
+		this.addElements(this.presets, presets);
 	}
 	/**
 	* Adds {@link BasicInstrument}s to this sound bank.
 	* @param instruments The instruments to add.
 	*/
 	addInstruments(...instruments) {
-		this.instruments.push(...instruments);
+		this.addElements(this.instruments, instruments);
 	}
 	/**
 	* Adds {@link BasicSample}s to this sound bank.
 	* @param samples The samples to add.
 	*/
 	addSamples(...samples) {
-		this.samples.push(...samples);
+		this.addElements(this.samples, samples);
 	}
 	/**
 	* Clones a sample into this bank, together with its stereo partner.
@@ -11516,9 +11592,11 @@ var BasicSoundBank = class BasicSoundBank {
 	}
 	/**
 	* Updates internal values. Call after updating the preset list.
+	* @param sort If the presets should be sorted. Set it to `false` to keep a custom order,
+	* only the internal values (like {@link isXGBank}) are then recomputed.
 	*/
-	flush() {
-		this.presets.sort(MIDIPatchTools.compare.bind(MIDIPatchTools));
+	flush(sort = true) {
+		if (sort) this.presets.sort(MIDIPatchTools.compare.bind(MIDIPatchTools));
 		this.parseInternal();
 	}
 	/**
@@ -11663,6 +11741,9 @@ var BasicSoundBank = class BasicSoundBank {
 		this.instruments.length = 0;
 		this.samples.length = 0;
 	}
+	addElements(list, elements) {
+		for (const element of elements) list.push(element);
+	}
 	parsingError(error) {
 		throw new Error(`SF parsing error: ${error} The file may be corrupted.`);
 	}
@@ -15464,7 +15545,6 @@ function setTimeToInternal(time, ticks = void 0) {
 						const channel = analyzed.channel + portOffset;
 						if (channel >= this.synth.midiChannels.length) break;
 						channels[channel] ??= createChannelStatus(channel);
-						if (this._midiData.isMultiPort && track.channels.size === 0) break;
 						if (controller === MIDIControllers.resetAllControllers) {
 							resetAllControllers(channel);
 							break;
@@ -52867,15 +52947,19 @@ var SoundBankManager = class {
 	*/
 	userDrumSets;
 	presetListChangeCallback;
+	bankRemovedCallback;
 	selectablePresetList = [];
 	/**
 	* @internal
 	* @param presetListChangeCallback Supplied by the parent synthesizer class,
 	* this is called whenever the preset list changes.
 	* The argument tells if the synthesizer should reset after updating its channels.
+	* @param bankRemovedCallback Called when a sound bank leaves the manager (deleted, replaced or destroyed),
+	* so the synthesizer can drop what it holds of it.
 	*/
-	constructor(presetListChangeCallback) {
+	constructor(presetListChangeCallback, bankRemovedCallback) {
 		this.presetListChangeCallback = presetListChangeCallback;
+		this.bankRemovedCallback = bankRemovedCallback;
 		const resolvePatch = (patch) => this.getPreset(patch, this.systemGetter());
 		this.userDrumSets = [new UserDrumSet(64, "User Drum Set 1", resolvePatch), new UserDrumSet(65, "User Drum Set 2", resolvePatch)];
 	}
@@ -52924,13 +53008,16 @@ var SoundBankManager = class {
 	/**
 	* This method removes a sound bank with a given ID from the sound bank list.
 	* @param id The ID of the sound bank to delete.
+	* @param reset If the synthesizer should reset (put every channel's controllers back to defaults) after the change.
+	* Set it to `false` to keep a song playing, the channels then only update to the new presets.
 	* @throws Error An error if there's no sound bank with the given ID.
 	*/
-	deleteSoundBank(id) {
+	deleteSoundBank(id, reset = true) {
 		const index = this.soundBankList.findIndex((s) => s.id === id);
 		if (index === -1) throw new Error(`No sound bank with id "${id}"`);
-		this.soundBankList.splice(index, 1);
-		this.generatePresetList();
+		const [removed] = this.soundBankList.splice(index, 1);
+		this.bankRemoved(removed.soundBank);
+		this.generatePresetList(reset);
 	}
 	/**
 	* Adds a new sound bank with a given ID, or replaces an existing one.
@@ -52938,8 +53025,10 @@ var SoundBankManager = class {
 	* @param id The unique ID to assign to the sound bank.
 	* If a sound bank with this ID already exists, it will be replaced.
 	* @param bankOffset The bank offset of the sound bank. Offsets the bank MSB value of all presets in this sound bank.
+	* @param reset If the synthesizer should reset (put every channel's controllers back to defaults) after the change.
+	* Set it to `false` to keep a song playing, the channels then only update to the new presets.
 	*/
-	addSoundBank(bank, id, bankOffset = 0) {
+	addSoundBank(bank, id, bankOffset = 0, reset = true) {
 		const foundBank = this.soundBankList.find((s) => s.id === id);
 		if (foundBank === void 0) this.soundBankList.push({
 			id,
@@ -52947,10 +53036,12 @@ var SoundBankManager = class {
 			bankOffset
 		});
 		else {
+			const old = foundBank.soundBank;
 			foundBank.soundBank = bank;
 			foundBank.bankOffset = bankOffset;
+			this.bankRemoved(old);
 		}
-		this.generatePresetList();
+		this.generatePresetList(reset);
 	}
 	/**
 	* Rebuilds the preset list from the current sound banks.
@@ -52980,11 +53071,17 @@ var SoundBankManager = class {
 	* @internal
 	*/
 	destroy() {
-		for (const s of this.soundBankList) s.soundBank.destroySoundBank();
+		for (const s of this.soundBankList) {
+			this.bankRemovedCallback?.(s.soundBank);
+			s.soundBank.destroySoundBank();
+		}
 		this.soundBankList = [];
 		this.selectablePresetList = [];
 		this._presetList = [];
 	}
+	bankRemoved(bank) {
+		if (!this.soundBankList.some((s) => s.soundBank === bank)) this.bankRemovedCallback?.(bank);
+	}
 	generatePresetList(resetSynth = true) {
 		const presetList = new Array();
 		const addedPresets = /* @__PURE__ */ new Set();
@@ -53133,7 +53230,7 @@ function renderVoice(voice, timeNow, sampleCount) {
 	let targetKey = voice.targetKey;
 	let cents = voice.pitchOffset + modulated[GeneratorTypes.fineTune] + this.octaveTuning[targetKey] + this.currentTuning;
 	let semitones = modulated[GeneratorTypes.coarseTune];
-	const tuning = core.tunings[this.preset.program * 128 + voice.midiNote];
+	const tuning = core.tunings[(this.preset?.program ?? this.patch.program) * 128 + voice.midiNote];
 	if (tuning !== -1) {
 		targetKey = Math.trunc(tuning);
 		semitones += tuning - targetKey;
@@ -58986,7 +59083,7 @@ var SoundFont2 = class extends BasicSoundBank {
 			}
 		}
 		for (const s of samples) s.name = s.name.trim();
-		this.samples.push(...samples);
+		this.addElements(this.samples, samples);
 		const instrumentGenerators = readGenerators(igenChunk, isSFE);
 		const instrumentModulators = readModulators(imodChunk, isSFE);
 		const extendInstruments = xdtaChunk !== void 0 && !!xChunks.inst;
@@ -59003,7 +59100,7 @@ var SoundFont2 = class extends BasicSoundBank {
 			instruments.pop();
 		}
 		for (const i of instruments) i.name = i.name.trim();
-		this.instruments.push(...instruments);
+		this.addElements(this.instruments, instruments);
 		const ibagIndexes = readZoneIndexes(ibagChunk);
 		if (xdtaChunk && xChunks.ibag) {
 			const extraIndexes = readZoneIndexes(xChunks.ibag);
@@ -59030,7 +59127,7 @@ var SoundFont2 = class extends BasicSoundBank {
 			presets.pop();
 		}
 		for (const p of presets) p.name = p.name.trim();
-		this.addPresets(...presets);
+		this.addElements(this.presets, presets);
 		const pbagIndexes = readZoneIndexes(pbagChunk);
 		if (xdtaChunk && xChunks.pbag) {
 			const extraIndexes = readZoneIndexes(xChunks.pbag);
@@ -59161,7 +59258,6 @@ var DecodedSampleCache = class {
 	*/
 	totalBytes = 0;
 	entries = /* @__PURE__ */ new Map();
-	unreleasable = /* @__PURE__ */ new WeakSet();
 	voiceCache;
 	/**
 	* @param budget The budget in bytes.
@@ -59182,7 +59278,7 @@ var DecodedSampleCache = class {
 	touch(sample, cacheKey) {
 		let entry = this.entries.get(sample);
 		if (entry) this.entries.delete(sample);
-		if (this.unreleasable.has(sample) || sample.storedForm === "float32" && !(sample instanceof DLSSample)) {
+		if (!sample.canRedecode) {
 			if (entry) this.totalBytes -= entry.bytes;
 			return;
 		}
@@ -59197,16 +59293,29 @@ var DecodedSampleCache = class {
 		this.entries.set(sample, entry);
 		if (this.totalBytes > this.budget) this.evict(sample);
 	}
+	/**
+	* Stops tracking samples, for example when their sound bank is removed.
+	* The samples are not released, the cache just stops holding them.
+	* Voices cached from them are dropped too.
+	* @param samples The samples to forget.
+	*/
+	forget(samples) {
+		for (const sample of samples) {
+			const entry = this.entries.get(sample);
+			if (!entry) continue;
+			this.entries.delete(sample);
+			this.totalBytes -= entry.bytes;
+			for (const key of entry.cacheKeys) this.voiceCache.delete(key);
+		}
+	}
 	evict(keep) {
 		for (const [sample, entry] of this.entries) {
 			if (this.totalBytes <= this.budget) return;
 			if (sample === keep) continue;
 			this.entries.delete(sample);
 			this.totalBytes -= entry.bytes;
-			if (!sample.releaseDecoded()) {
-				this.unreleasable.add(sample);
-				continue;
-			}
+			if (!sample.canRedecode) continue;
+			sample.releaseDecoded();
 			for (const key of entry.cacheKeys) this.voiceCache.delete(key);
 		}
 	}
@@ -59494,10 +59603,6 @@ var SpessaSynthProcessor = class {
 	*/
 	gsDelayActive = false;
 	/**
-	* The sound bank manager, which manages all sound banks and presets.
-	*/
-	soundBankManager = new SoundBankManager(this.updatePresetList.bind(this));
-	/**
 	* The sample rate, in Hertz.
 	*/
 	sampleRate;
@@ -59593,6 +59698,12 @@ var SpessaSynthProcessor = class {
 	*/
 	decodedSamples;
 	/**
+	* The sound bank manager, which manages all sound banks and presets.
+	*/
+	soundBankManager = new SoundBankManager(this.updatePresetList.bind(this), (bank) => {
+		this.decodedSamples.forget(bank.samples);
+	});
+	/**
 	* The synthesizer's GS reverb processor.
 	*
 	* Used when {@link GlobalMIDIParameter.system} is `gm` `gm2` or `gs`.
@@ -61023,6 +61134,6 @@ var SpessaSynthProcessor = class {
 		return (isGMGSDrum ? 128 + patch.bankMSB : patch.bankMSB) + bankLSB * 256 + program * 32768 + 4194304 * midiNote + 536870912 * velocity;
 	}
 };
-export { BasicInstrument, BasicInstrumentZone, BasicLinkedZone, BasicMIDI, BasicPreset, BasicPresetZone, BasicSample, BasicSoundBank, BasicZone, DEFAULT_CHANNEL_MIDI_PARAMETERS, DEFAULT_CHANNEL_SYSTEM_PARAMETERS, DEFAULT_DRUM_REVERB, DEFAULT_GLOBAL_MIDI_PARAMETERS, DEFAULT_GLOBAL_SYSTEM_PARAMETERS, DEFAULT_MIDI_CONTROLLERS, DEFAULT_SOUND_BANK_CLONE_OPTIONS, DEFAULT_SOUND_BANK_LOAD_OPTIONS, DEFAULT_SYNTH_MODE, DefaultGSChorus, DefaultGSDelay, DefaultGSEqualizer, DefaultGSInsertion, DefaultGSReverb, DefaultXGChorus, DefaultXGEffect, DefaultXGInsertion, DefaultXGReverb, DefaultXGSystemEffect, DefaultXGVariation, DrumParameterUtils, EmptySample, GENERATORS_AMOUNT, GSInsertionControlSources, Generator, GeneratorLimits, GeneratorTypes, INSTRUMENT_ONLY_GENERATORS, IndexedByteArray, InterpolationTypes, MAX_GENERATOR, MIDIBuilder, MIDIChannel, MIDIControllers, MIDIMessage, MIDIMessageTypes, MIDIPatchTools, MIDITrack, MIDIUtils, MIDI_DRUM_CHANNEL, Modulator, ModulatorControllerSources, ModulatorCurveTypes, ModulatorSource, ModulatorTransformTypes, NonRegisteredParameterTypesLSB, NonRegisteredParameterTypesMSB, RegisteredParameterTypes, SPESSASYNTH_GAIN_FACTOR, SPESSA_BUFSIZE, SampleTypes, SoundBankCloner, SoundBankLoader, SoundBankManager, SpessaLog, SpessaSynthCoreUtils, SpessaSynthProcessor, SpessaSynthSequencer, VOICE_CAP, audioToWav };
+export { BasicInstrument, BasicInstrumentZone, BasicLinkedZone, BasicMIDI, BasicPreset, BasicPresetZone, BasicSample, BasicSoundBank, BasicZone, DEFAULT_CHANNEL_MIDI_PARAMETERS, DEFAULT_CHANNEL_SYSTEM_PARAMETERS, DEFAULT_DRUM_REVERB, DEFAULT_GLOBAL_MIDI_PARAMETERS, DEFAULT_GLOBAL_SYSTEM_PARAMETERS, DEFAULT_MIDI_CONTROLLERS, DEFAULT_SOUND_BANK_CLONE_OPTIONS, DEFAULT_SOUND_BANK_LOAD_OPTIONS, DEFAULT_SYNTH_MODE, DefaultGSChorus, DefaultGSDelay, DefaultGSEqualizer, DefaultGSInsertion, DefaultGSReverb, DefaultXGChorus, DefaultXGEffect, DefaultXGInsertion, DefaultXGReverb, DefaultXGSystemEffect, DefaultXGVariation, DrumParameterUtils, EmptySample, GENERATORS_AMOUNT, GSInsertionControlSources, Generator, GeneratorLimits, GeneratorTypes, INSTRUMENT_ONLY_GENERATORS, IndexedByteArray, InterpolationTypes, MAX_GENERATOR, MIDIBuilder, MIDIChannel, MIDIControllers, MIDIMessage, MIDIMessageTypes, MIDIPatchTools, MIDITrack, MIDIUtils, MIDI_DRUM_CHANNEL, Modulator, ModulatorControllerSources, ModulatorCurveTypes, ModulatorSource, ModulatorTransformTypes, NonRegisteredParameterTypesLSB, NonRegisteredParameterTypesMSB, RegisteredParameterTypes, SPESSASYNTH_GAIN_FACTOR, SPESSA_BUFSIZE, SampleTypes, SoundBankCloner, SoundBankLoader, SoundBankManager, SpessaLog, SpessaSynthCoreUtils, SpessaSynthProcessor, SpessaSynthSequencer, VOICE_CAP, audioToWav, wavToAudio };
 
 //# sourceMappingURL=index.js.map