@jpdutoit/squelchy 0.0.1 → 0.0.3

package/index.d.ts

@@ -244,16 +244,21 @@ export declare const Hat: {
 };
 /**
  * Gate + pitch CV for driving patchable modules (Envelope trig, V/Oct inputs).
- * `gate` goes 1 at `time`, back to 0 after `duration`; `pitch` holds the midi
- * value (semitones = the project's V/Oct unit). Both are ConstantSourceNodes.
+ * `gate` goes to the hit's velocity at `time`, back to 0 after `duration`;
+ * `pitch` holds the note (absolute key position, 69 = A4), typed as the
+ * library's pitch signal like every other V/OCT output. Both are
+ * ConstantSourceNodes.
  */
+export interface NoteCvInstance {
+	/** Gate CV: the hit's velocity while a note is held, 0 otherwise. */
+	gate: ConstantSourceNode;
+	/** Pitch CV: the current note (69 = A4), held between notes. */
+	pitch: ConstantSourceNode & Signal<Note>;
+	trigger(time: Seconds, hit?: Partial<Hit<Note>>): void;
+	dispose(): void;
+}
 export declare const NoteCv: {
-	create(ctx: BaseAudioContext): {
-		gate: ConstantSourceNode;
-		pitch: ConstantSourceNode;
-		trigger(time: Seconds, h?: Partial<Hit<Note>>): void;
-		dispose(): void;
-	};
+	create(ctx: BaseAudioContext): NoteCvInstance;
 };
 export declare function pulse(target: AudioNode, when?: number): void;
 /** Canonical percussion voice keys shared by every sample set and by any
@@ -276,8 +281,6 @@ export declare const VOICE_KEYS: readonly [
 	"perc"
 ];
 export type VoiceKey = (typeof VOICE_KEYS)[number];
-/** Where the kit audio is hosted. Override with `loadSampleSet(..., { baseUrl })`. */
-export declare const DEFAULT_SAMPLE_BASE_URL = "https://squelchy.studio";
 export interface SampleSetInfo {
 	name: string;
 	blurb: string;
@@ -285,7 +288,7 @@ export interface SampleSetInfo {
 	credit: string;
 	license: string;
 	licenseUrl: string;
-	/** Root-relative sample path per voice; resolved against baseUrl on load. */
+	/** Audio URL per voice, fetched as-is by `loadSampleSet`. */
 	voices: Partial<Record<VoiceKey, string>>;
 }
 export interface LoadedSampleSet {
@@ -296,244 +299,14 @@ export interface LoadedSampleSet {
 }
 /** Fetch + decode every voice of a kit in parallel. */
 export declare function loadSampleSet(ctx: BaseAudioContext, set: SampleSetInfo, opts?: {
-	baseUrl?: string;
 	fetch?: typeof fetch;
 }): Promise<LoadedSampleSet>;
-/** A one-sample voice. velocity 0..1 scales level; `value` (semitones) repitches. */
+/** A one-sample voice. velocity 0..1 scales level; a number `value`
+ *  repitches in semitones, anything else (e.g. `true` from steps()) plays it
+ *  unshifted. */
 export declare const SampleVoice: {
-	create(ctx: BaseAudioContext, kit: LoadedSampleSet, key: VoiceKey): VoiceInstance<number>;
-};
-export declare const SampleSets: {
-	readonly "roland-808": {
-		readonly name: "Roland TR-808";
-		readonly blurb: "The original machine, sampled from hardware. Deep sub kick, ticking hats.";
-		readonly family: "Machines";
-		readonly credit: "Michael Fischer / Technopolis TR-808 sample set, released to the public domain";
-		readonly license: "CC0 1.0 / public domain \u2014 free to use, no attribution required";
-		readonly licenseUrl: "https://creativecommons.org/publicdomain/zero/1.0/";
-		readonly voices: {
-			readonly bd: "/__l5e/assets-v1/c4b2fc55-dcf1-4248-a7fb-2cd3653a659b/roland-808-bd.flac";
-			readonly ch: "/__l5e/assets-v1/c1ec3b3d-571f-46a6-9d05-12b2fe5f6fc5/roland-808-ch.flac";
-			readonly clap: "/__l5e/assets-v1/8bd15e4b-96b7-46b6-b26a-35283c816f1e/roland-808-clap.flac";
-			readonly cym: "/__l5e/assets-v1/033f0719-913a-4a7a-998e-92a7319d806f/roland-808-cym.flac";
-			readonly ht: "/__l5e/assets-v1/ca555782-7544-446a-a461-9b56b4d30072/roland-808-ht.flac";
-			readonly lt: "/__l5e/assets-v1/8e100e1c-3844-42aa-bbe7-9eb52b9d704e/roland-808-lt.flac";
-			readonly mt: "/__l5e/assets-v1/93dd309f-9347-4ea1-909f-56196b08dc88/roland-808-mt.flac";
-			readonly oh: "/__l5e/assets-v1/4881941c-b558-4159-babd-fe224b0f1543/roland-808-oh.flac";
-			readonly perc: "/__l5e/assets-v1/d13076b5-50ca-4675-9d4e-70afd6e6203d/roland-808-perc.flac";
-			readonly rim: "/__l5e/assets-v1/ce82e0e9-402d-4a5e-bf01-59dfb922d1ba/roland-808-rim.flac";
-			readonly sd: "/__l5e/assets-v1/67a799c9-e019-442b-8025-99d69bc493b9/roland-808-sd.flac";
-		};
-	};
-	readonly "tr-909": {
-		readonly name: "Roland TR-909";
-		readonly blurb: "Punchy transistor kick, snappy sampled snare, sizzling metal hats. House and techno.";
-		readonly family: "Machines";
-		readonly credit: "MckAudio TR8 sample pack, dedicated to the public domain (CC0)";
-		readonly license: "CC0 1.0 / public domain \u2014 free to use, no attribution required";
-		readonly licenseUrl: "https://creativecommons.org/publicdomain/zero/1.0/";
-		readonly voices: {
-			readonly bd: "/__l5e/assets-v1/fd3911bb-6783-4db6-bee2-bb8c5a589f26/tr-909-bd.flac";
-			readonly ch: "/__l5e/assets-v1/6f795c20-fb89-4cd5-b696-3a505d487baa/tr-909-ch.flac";
-			readonly clap: "/__l5e/assets-v1/7b1ccf8e-0dd6-4189-82d7-03a910e895f2/tr-909-clap.flac";
-			readonly cym: "/__l5e/assets-v1/f0d5ce25-3238-4e89-bb09-f5b7118fa0a7/tr-909-cym.flac";
-			readonly ht: "/__l5e/assets-v1/5f9b4c37-25a7-492c-aaed-f7fe24fbfe2c/tr-909-ht.flac";
-			readonly lt: "/__l5e/assets-v1/8477dddd-b9ed-4957-9a48-b5501bc77056/tr-909-lt.flac";
-			readonly mt: "/__l5e/assets-v1/92d461e5-d74a-4ba2-a899-4dea1ad06d13/tr-909-mt.flac";
-			readonly oh: "/__l5e/assets-v1/20c51259-d8d1-4ee3-a1d6-e850c3227b1a/tr-909-oh.flac";
-			readonly perc: "/__l5e/assets-v1/147d346e-9ae7-4413-a50a-de4f03ef7342/tr-909-perc.flac";
-			readonly rim: "/__l5e/assets-v1/0c9f157d-1329-4804-aa12-6819651d69fb/tr-909-rim.flac";
-			readonly sd: "/__l5e/assets-v1/bd8069c2-e07c-4d5c-b05a-fb5b9a31eadb/tr-909-sd.flac";
-		};
-	};
-	readonly "tr-707": {
-		readonly name: "Roland TR-707";
-		readonly blurb: "Twelve-bit sampled kit with early-digital crunch. Big eighties snare and claps.";
-		readonly family: "Machines";
-		readonly credit: "MckAudio TR8 sample pack, dedicated to the public domain (CC0)";
-		readonly license: "CC0 1.0 / public domain \u2014 free to use, no attribution required";
-		readonly licenseUrl: "https://creativecommons.org/publicdomain/zero/1.0/";
-		readonly voices: {
-			readonly bd: "/__l5e/assets-v1/825b2c7c-5c5f-411c-8191-306549ee26f2/tr-707-bd.flac";
-			readonly ch: "/__l5e/assets-v1/6b35b393-7e9c-462d-8d2f-dc834417062b/tr-707-ch.flac";
-			readonly clap: "/__l5e/assets-v1/efbe819a-b13e-4bf2-a6bd-9bc15a09ff3f/tr-707-clap.flac";
-			readonly cym: "/__l5e/assets-v1/4a34902b-8592-46d8-b339-05a0648cac4f/tr-707-cym.flac";
-			readonly ht: "/__l5e/assets-v1/e58beee9-45e5-4b65-af99-a05fcb96f55b/tr-707-ht.flac";
-			readonly lt: "/__l5e/assets-v1/a0d6f499-4af6-4d34-96de-5ad7c2397229/tr-707-lt.flac";
-			readonly mt: "/__l5e/assets-v1/6c4bd12b-78ff-4f70-863b-cd482f684eb6/tr-707-mt.flac";
-			readonly oh: "/__l5e/assets-v1/c07159f3-d763-4698-a786-aeae60d38ac9/tr-707-oh.flac";
-			readonly perc: "/__l5e/assets-v1/2f8cffcb-8e86-4f65-99db-a705727ed3ab/tr-707-perc.flac";
-			readonly rim: "/__l5e/assets-v1/3d6445b1-38bd-4e9f-b048-db8c079b3c03/tr-707-rim.flac";
-			readonly sd: "/__l5e/assets-v1/aaf70dd8-c740-4b05-9369-feb80f3e26be/tr-707-sd.flac";
-		};
-	};
-	readonly "tr-606": {
-		readonly name: "Roland TR-606";
-		readonly blurb: "Tiny Drumatix voices \u2014 thin kick, spitty snare, ticking hats. Perfect with a 303.";
-		readonly family: "Machines";
-		readonly credit: "MckAudio TR8 sample pack, dedicated to the public domain (CC0)";
-		readonly license: "CC0 1.0 / public domain \u2014 free to use, no attribution required";
-		readonly licenseUrl: "https://creativecommons.org/publicdomain/zero/1.0/";
-		readonly voices: {
-			readonly bd: "/__l5e/assets-v1/f46ec897-9319-4c25-b63b-74df979de508/tr-606-bd.flac";
-			readonly ch: "/__l5e/assets-v1/f4c57254-c711-43b0-82c6-52b011e205ba/tr-606-ch.flac";
-			readonly cym: "/__l5e/assets-v1/db524ec1-36d3-43db-bfc4-fd84a1ddd2ac/tr-606-cym.flac";
-			readonly ht: "/__l5e/assets-v1/74b486cf-c1f1-45c7-bd2a-4fd0c3794e1a/tr-606-ht.flac";
-			readonly lt: "/__l5e/assets-v1/6b1a564f-6388-40c1-8028-3ea9b6824256/tr-606-lt.flac";
-			readonly mt: "/__l5e/assets-v1/d871a86a-fcc8-45a6-b5a4-83977a689593/tr-606-mt.flac";
-			readonly oh: "/__l5e/assets-v1/a4c607d2-d62c-49b5-ac99-549fd6262468/tr-606-oh.flac";
-			readonly sd: "/__l5e/assets-v1/2062f1d4-e34f-406f-911b-2eb2ec523a89/tr-606-sd.flac";
-		};
-	};
-	readonly "compu-78": {
-		readonly name: "Compu-78";
-		readonly blurb: "Tiny, dry preset-box percussion. Bossa nova organ rhythm energy.";
-		readonly family: "Machines";
-		readonly credit: "Synthesised for Squelchy";
-		readonly license: "CC0 1.0 / public domain \u2014 free to use, no attribution required";
-		readonly licenseUrl: "https://creativecommons.org/publicdomain/zero/1.0/";
-		readonly voices: {
-			readonly bd: "/__l5e/assets-v1/150a91e2-8b92-40f2-80e0-10b30f10976b/compu-78-bd.flac";
-			readonly ch: "/__l5e/assets-v1/da9dcfc4-5f29-43b9-979f-9679edeb09ed/compu-78-ch.flac";
-			readonly clap: "/__l5e/assets-v1/f3b5d485-44bc-4b34-b2bc-d37f436dffc2/compu-78-clap.flac";
-			readonly cym: "/__l5e/assets-v1/627db2bf-08d5-4054-8de9-b8ec0ca4436a/compu-78-cym.flac";
-			readonly ht: "/__l5e/assets-v1/1323f20c-3c98-45fb-abd1-e4b1e4be158f/compu-78-ht.flac";
-			readonly lt: "/__l5e/assets-v1/ba67ce5c-3f01-4e1b-9fd8-a96bb5428cf4/compu-78-lt.flac";
-			readonly mt: "/__l5e/assets-v1/f8cd42d6-2f98-4e9d-9428-ba091ec125cf/compu-78-mt.flac";
-			readonly oh: "/__l5e/assets-v1/b4a1d5b2-0022-4f1b-ac52-1618ba03ea67/compu-78-oh.flac";
-			readonly perc: "/__l5e/assets-v1/55e15a92-ba17-48cb-aec0-47e5198f073f/compu-78-perc.flac";
-			readonly rim: "/__l5e/assets-v1/698aaf24-8e84-4b3b-8f13-dc95f2b3f157/compu-78-rim.flac";
-			readonly sd: "/__l5e/assets-v1/41357245-d767-410e-8415-08dbb9e7503e/compu-78-sd.flac";
-		};
-	};
-	readonly "dr5-studio": {
-		readonly name: "Studio Kit";
-		readonly blurb: "Acoustic drums in a small dry room. Skin, air and a little ambience.";
-		readonly family: "Acoustic";
-		readonly credit: "MckAudio DR5 sample pack, dedicated to the public domain (CC0)";
-		readonly license: "CC0 1.0 / public domain \u2014 free to use, no attribution required";
-		readonly licenseUrl: "https://creativecommons.org/publicdomain/zero/1.0/";
-		readonly voices: {
-			readonly bd: "/__l5e/assets-v1/9bc4c40f-432c-4fd1-98f8-dc3343b5dd31/dr5-studio-bd.flac";
-			readonly ch: "/__l5e/assets-v1/862411a4-6d87-45e7-a3a2-2c4062f8e79b/dr5-studio-ch.flac";
-			readonly clap: "/__l5e/assets-v1/2feebc4f-49d2-4ea0-9b5a-890059c24a9c/dr5-studio-clap.flac";
-			readonly cym: "/__l5e/assets-v1/5abff1b5-b403-403b-b681-9ac37a394442/dr5-studio-cym.flac";
-			readonly ht: "/__l5e/assets-v1/4e6883a5-e310-4035-a6ae-ee4033c7a0a1/dr5-studio-ht.flac";
-			readonly lt: "/__l5e/assets-v1/faf35ae9-f89f-4ceb-ad5e-c562dd5d261a/dr5-studio-lt.flac";
-			readonly mt: "/__l5e/assets-v1/4b923b44-9e79-4aa0-a9ef-4178a9f0279b/dr5-studio-mt.flac";
-			readonly oh: "/__l5e/assets-v1/5a5e6d0c-4c8f-4dc5-9dea-55f90083a55a/dr5-studio-oh.flac";
-			readonly perc: "/__l5e/assets-v1/8d286dd0-4201-49f6-9738-0a39e3a3d860/dr5-studio-perc.flac";
-			readonly rim: "/__l5e/assets-v1/1d139e86-288e-48bd-baba-f7d2502271a5/dr5-studio-rim.flac";
-			readonly sd: "/__l5e/assets-v1/eb7b02d6-7063-4350-9515-40010dd583cb/dr5-studio-sd.flac";
-		};
-	};
-	readonly "tape-dust": {
-		readonly name: "Tape Dust";
-		readonly blurb: "Wobbly, hissy and rolled-off. Everything through a tired cassette.";
-		readonly family: "Character";
-		readonly credit: "Synthesised for Squelchy";
-		readonly license: "CC0 1.0 / public domain \u2014 free to use, no attribution required";
-		readonly licenseUrl: "https://creativecommons.org/publicdomain/zero/1.0/";
-		readonly voices: {
-			readonly bd: "/__l5e/assets-v1/7e90ada0-1da8-4930-9c05-48c395e8a863/tape-dust-bd.flac";
-			readonly ch: "/__l5e/assets-v1/538fd73f-f7ee-408e-ab69-f8865506f4f5/tape-dust-ch.flac";
-			readonly clap: "/__l5e/assets-v1/21b5b5ea-6dce-495d-b740-e7162941c972/tape-dust-clap.flac";
-			readonly cym: "/__l5e/assets-v1/ac1a7f2d-9a96-4f61-b2ec-743854f15bbe/tape-dust-cym.flac";
-			readonly ht: "/__l5e/assets-v1/93dd3f9c-8267-4f4e-b292-807cf0022c9e/tape-dust-ht.flac";
-			readonly lt: "/__l5e/assets-v1/7a51ff67-62ec-408b-b6c3-4a0cae248eaf/tape-dust-lt.flac";
-			readonly mt: "/__l5e/assets-v1/ba3340c5-6ead-419a-836a-a041448f06da/tape-dust-mt.flac";
-			readonly oh: "/__l5e/assets-v1/e924553d-ac9a-427e-a69a-2939032ee618/tape-dust-oh.flac";
-			readonly perc: "/__l5e/assets-v1/abfad1e6-998b-47a8-8c98-6f511c151143/tape-dust-perc.flac";
-			readonly rim: "/__l5e/assets-v1/c86262d8-9711-41d4-b866-19a1ffcaf443/tape-dust-rim.flac";
-			readonly sd: "/__l5e/assets-v1/2d1090cf-0284-4c33-9ba2-430c5c7b4730/tape-dust-sd.flac";
-		};
-	};
-	readonly "hard-cell": {
-		readonly name: "Hard Cell";
-		readonly blurb: "Overdriven and bit-crushed. Industrial techno with no headroom left.";
-		readonly family: "Character";
-		readonly credit: "Synthesised for Squelchy";
-		readonly license: "CC0 1.0 / public domain \u2014 free to use, no attribution required";
-		readonly licenseUrl: "https://creativecommons.org/publicdomain/zero/1.0/";
-		readonly voices: {
-			readonly bd: "/__l5e/assets-v1/d8f1c5cf-8e07-4a1e-a519-d7f69781329b/hard-cell-bd.flac";
-			readonly ch: "/__l5e/assets-v1/c3275e9a-dd79-4ac8-b4b9-84ebe25b5529/hard-cell-ch.flac";
-			readonly clap: "/__l5e/assets-v1/160a5d2c-01e0-49da-a998-149a0cf08317/hard-cell-clap.flac";
-			readonly cym: "/__l5e/assets-v1/910f3623-0209-439f-9e34-0c0f842bc78f/hard-cell-cym.flac";
-			readonly ht: "/__l5e/assets-v1/36f5b37b-9d44-49b8-a57b-bf5d2a1aa523/hard-cell-ht.flac";
-			readonly lt: "/__l5e/assets-v1/6065e512-578b-477f-88d9-49b3ccccacea/hard-cell-lt.flac";
-			readonly mt: "/__l5e/assets-v1/4e33c147-b8da-4b03-abca-4fd254d5006d/hard-cell-mt.flac";
-			readonly oh: "/__l5e/assets-v1/3e5b3bce-f21b-4ecb-8f28-375ce871427f/hard-cell-oh.flac";
-			readonly perc: "/__l5e/assets-v1/ab27e781-3d41-4e04-8f44-f7a568543586/hard-cell-perc.flac";
-			readonly rim: "/__l5e/assets-v1/ea2989c5-2354-4574-ae38-4786deeee151/hard-cell-rim.flac";
-			readonly sd: "/__l5e/assets-v1/5bd3dca9-bdb7-4618-8e0b-9ed1c0b062c7/hard-cell-sd.flac";
-		};
-	};
-	readonly "rx5-fm": {
-		readonly name: "Yamaha RX5";
-		readonly blurb: "FM percussion \u2014 glassy, bell-like, unmistakably late-eighties digital.";
-		readonly family: "Digital";
-		readonly credit: "MckAudio RX5 sample pack, dedicated to the public domain (CC0)";
-		readonly license: "CC0 1.0 / public domain \u2014 free to use, no attribution required";
-		readonly licenseUrl: "https://creativecommons.org/publicdomain/zero/1.0/";
-		readonly voices: {
-			readonly bd: "/__l5e/assets-v1/22b27f9f-d301-48e2-a0e4-e6b6e538ec31/rx5-fm-bd.flac";
-			readonly ch: "/__l5e/assets-v1/236fb4f5-7d2a-48c0-be18-bc3777a6be91/rx5-fm-ch.flac";
-			readonly clap: "/__l5e/assets-v1/58402fc0-996c-4577-9074-bb40b585c26e/rx5-fm-clap.flac";
-			readonly cym: "/__l5e/assets-v1/d3e6ba9b-a2b8-4467-8923-97594723720e/rx5-fm-cym.flac";
-			readonly ht: "/__l5e/assets-v1/a5edef5d-7861-4b3a-99bc-10ece111ca64/rx5-fm-ht.flac";
-			readonly lt: "/__l5e/assets-v1/7151d30d-fe90-4ac5-9c9f-e91a808a1efa/rx5-fm-lt.flac";
-			readonly mt: "/__l5e/assets-v1/46119925-9ecd-431a-94ee-2135c8ce4382/rx5-fm-mt.flac";
-			readonly oh: "/__l5e/assets-v1/9fe4938f-fda7-43f8-84c6-c53325fd674c/rx5-fm-oh.flac";
-			readonly perc: "/__l5e/assets-v1/1aa471d4-4737-45e6-9070-6301892dcdfa/rx5-fm-perc.flac";
-			readonly rim: "/__l5e/assets-v1/2b0409a0-1aa6-41a4-9593-553247a2e624/rx5-fm-rim.flac";
-			readonly sd: "/__l5e/assets-v1/3d9c426c-7783-4106-940f-1e6b6405bdd5/rx5-fm-sd.flac";
-		};
-	};
-	readonly "micro-click": {
-		readonly name: "Micro Click";
-		readonly blurb: "Clicks, ticks and pops. Minimal and micro-house, nothing sustains.";
-		readonly family: "Digital";
-		readonly credit: "Synthesised for Squelchy";
-		readonly license: "CC0 1.0 / public domain \u2014 free to use, no attribution required";
-		readonly licenseUrl: "https://creativecommons.org/publicdomain/zero/1.0/";
-		readonly voices: {
-			readonly bd: "/__l5e/assets-v1/58e3ce80-d300-47c6-8d79-52b00376550f/micro-click-bd.flac";
-			readonly ch: "/__l5e/assets-v1/1c12e400-5c5f-4aae-b006-5a3fe3c6ef2c/micro-click-ch.flac";
-			readonly clap: "/__l5e/assets-v1/b1f402f6-a85d-421b-9684-4b78719726d5/micro-click-clap.flac";
-			readonly cym: "/__l5e/assets-v1/fe501055-43d7-427f-9ab4-5efd0423292e/micro-click-cym.flac";
-			readonly ht: "/__l5e/assets-v1/3aab93cb-cd84-4600-a3e5-458fa74a2a86/micro-click-ht.flac";
-			readonly lt: "/__l5e/assets-v1/b09a0d61-c9a2-4b31-b0f2-10d3c10ef83c/micro-click-lt.flac";
-			readonly mt: "/__l5e/assets-v1/988e7a56-e914-43ad-aff1-71ec3a04b8e4/micro-click-mt.flac";
-			readonly oh: "/__l5e/assets-v1/122a3f93-4542-471b-b390-996665248653/micro-click-oh.flac";
-			readonly perc: "/__l5e/assets-v1/cae413d7-a68c-411a-a4b4-b7c20a83946d/micro-click-perc.flac";
-			readonly rim: "/__l5e/assets-v1/41922292-1c6e-4bef-ac8e-fa1ce09eefca/micro-click-rim.flac";
-			readonly sd: "/__l5e/assets-v1/6218ccdd-cba1-466e-af8b-665d7a2d4640/micro-click-sd.flac";
-		};
-	};
-	readonly "deep-analogue": {
-		readonly name: "Deep Analogue";
-		readonly blurb: "Long sub kick, soft snare, warm hats. Deep house at three in the morning.";
-		readonly family: "Acoustic";
-		readonly credit: "Synthesised for Squelchy";
-		readonly license: "CC0 1.0 / public domain \u2014 free to use, no attribution required";
-		readonly licenseUrl: "https://creativecommons.org/publicdomain/zero/1.0/";
-		readonly voices: {
-			readonly bd: "/__l5e/assets-v1/93c55e12-44f1-4cf9-8b19-82833257a68f/deep-analogue-bd.flac";
-			readonly ch: "/__l5e/assets-v1/7c881111-83d8-4c1a-b4af-4f09d2a09f4b/deep-analogue-ch.flac";
-			readonly clap: "/__l5e/assets-v1/e8b67bb8-8f7f-4b87-9ee4-d9cb7bc43efe/deep-analogue-clap.flac";
-			readonly cym: "/__l5e/assets-v1/b329f9e1-3eb0-471c-b7c7-8ad7f639323f/deep-analogue-cym.flac";
-			readonly ht: "/__l5e/assets-v1/a381a6b5-fd09-4fa6-b88e-86a29b8f25d9/deep-analogue-ht.flac";
-			readonly lt: "/__l5e/assets-v1/c9ebc90a-20aa-4f76-9e79-f440258d4bac/deep-analogue-lt.flac";
-			readonly mt: "/__l5e/assets-v1/5e1b803c-748e-4f09-bed7-c7b4511dc8b0/deep-analogue-mt.flac";
-			readonly oh: "/__l5e/assets-v1/289d67f2-6d55-4a04-8607-302442465e81/deep-analogue-oh.flac";
-			readonly perc: "/__l5e/assets-v1/8ef1f592-a3a4-45a5-9ea4-80362953aee4/deep-analogue-perc.flac";
-			readonly rim: "/__l5e/assets-v1/102a1c23-6e5f-468e-95c8-e414ce849884/deep-analogue-rim.flac";
-			readonly sd: "/__l5e/assets-v1/9be98c57-13c4-4337-bb2f-53c0b2ff7150/deep-analogue-sd.flac";
-		};
-	};
+	create(ctx: BaseAudioContext, kit: LoadedSampleSet, key: VoiceKey): VoiceInstance<number | boolean>;
 };
-export type SampleSetId = keyof typeof SampleSets;
 export interface AcidFilterParams {
 	/** Cutoff Note. Base cutoff as a note (67 ≈ 400 Hz, 69 = 440 Hz) for the iconic squelchy acid sound. Drives the V/OCT worklet 1:1 — the panel knob shows the equivalent Hz. Range 15–135 notes. Default 67. */
 	note?: Note;
@@ -893,13 +666,13 @@ export type EnvelopeFollowerProps = {
 };
 export declare const EnvelopeFollower: LibModule<EnvelopeFollowerParams, EnvelopeFollowerInputs, EnvelopeFollowerOutputs, EnvelopeFollowerProps>;
 export interface EnvelopeParams {
-	/** Attack. Time for signal to rise from zero to full level when triggered. Range 0.001–2 s (log). Default 0.01. */
+	/** Attack. Time for the level to rise from zero to full, in a straight line. Range 0.001–2 s (log). Default 0.01. */
 	attack?: Seconds;
-	/** Decay. Time to fall from peak to sustain level after attack completes. Range 0.001–2 s (log). Default 0.1. */
+	/** Decay. Time to fall from the peak to the sustain level, on an exponential curve like an analog envelope. The time for the gap to sustain to shrink by 60 dB. Range 0.001–10 s (log). Default 0.46. */
 	decay?: Seconds;
-	/** Sustain. Level held while the note is held. 0 = plucky, 1 = organ-like. Range 0–1. Default 0.7. */
+	/** Sustain. Level held while the note is held. 0 = plucky, 1 = organ-like. Moving it while a note is held glides at the decay speed. Range 0–1. Default 0.7. */
 	sustain?: number;
-	/** Release. Time to fade to silence after note is released. Range 0.001–3 s (log). Default 0.3. */
+	/** Release. Time to fade to silence (60 dB down) after the note is released, on an exponential curve like an analog envelope. Range 0.001–20 s (log). Default 2.1. */
 	release?: Seconds;
 	/** ENV Depth. Scales the ENV output in semitones (12 = one octave), the unit every pitch and cutoff modulation input on this rack reads. Higher values produce a wider sweep on the modulation target. Range 0–96 semitones (sqrt). Default 48. */
 	depth?: Semitones;
@@ -1556,13 +1329,13 @@ export type SaturatorProps = {
 };
 export declare const Saturator: LibModule<SaturatorParams, SaturatorInputs, SaturatorOutputs, SaturatorProps>;
 export interface ShimmerParams {
-	/** Reverb Decay. RT60 of the reverb tank in seconds. Range 0.5–10 s (log). Default 3. */
+	/** Reverb Decay. RT60 of the reverb tank in seconds — the time to fall 60 dB, measured at 500 Hz. Treble dies faster, like a real hall. Range 0.5–10 s (log). Default 3. */
 	decay?: Seconds;
 	/** Pitch Shift. Transposition applied by the granular pitch shifter on every trip round the feedback loop (12 = one octave). +12 = octave up, +7 = fifth up, -12 = octave down. Range -12–24 semitones. Default 12. */
 	pitch?: Semitones;
 	/** Dry/Wet Mix. Equal-power balance between dry signal and shimmer output — independent of the regen amount. Range 0–1. Default 0.5. */
 	mix?: number;
-	/** Shimmer Regen. How much pitch-shifted signal is fed back into the tank. High = endless rising choir. Range 0–0.95. Default 0.5. */
+	/** Shimmer Regen. Gain once round the pitch-shifted feedback loop, measured at 500 Hz: 0.5 = each new octave 6 dB quieter than the last, 0.95 = an almost endless rising choir. Means the same at every DECAY setting. Range 0–0.95. Default 0.5. */
 	shimmer?: number;
 }
 export type ShimmerInputs = {