@jpdutoit/squelchy 0.0.2 → 0.0.4

package/index.d.ts

@@ -50,7 +50,7 @@ export declare function preload(ctx: BaseAudioContext, opts?: {
 export type ParamValue = number | string | boolean | number[] | boolean[][];
 /** Runtime metadata — only what code needs. Human-facing text (names,
  *  descriptions, labels) is stripped from the bundle; it lives in the
- *  generated docs/MODULES.md, meta.json and the .d.ts JSDoc instead. */
+ *  generated docs/MODULES.md, docs/modules.json and the .d.ts JSDoc instead. */
 export interface ModuleMeta {
 	type: string;
 	ports: Record<string, Pick<PortDefinition, "type" | "signal">>;
@@ -139,7 +139,7 @@ export interface StepObject<V> {
 	/** Gate length in steps, default = the playback's `gate`. */
 	length?: number;
 }
-/** A pattern step: a value, a rest (null/undefined/false/0/'.'/'-'), or a StepObject. */
+/** A pattern step: a value (0 included), a rest (null/undefined/false), or a StepObject. */
 export type Step<V> = V | StepObject<V> | null | undefined | false;
 /** What a voice receives per hit. */
 export interface Hit<V = unknown> {
@@ -151,7 +151,7 @@ export interface Hit<V = unknown> {
 	step: number;
 	/** Loop iteration, 0-based. */
 	cycle: number;
-	/** The step's value (true for `steps('x..x')`, a midi number for melodies, …). */
+	/** The step's value (true for `steps('x..x')`, a Note for melodies, …). */
 	value: V;
 	velocity: number;
 	/** Gate length in seconds. */
@@ -219,10 +219,27 @@ export interface Transport {
 	tick(): void;
 	dispose(): void;
 }
-export declare function isRest(v: unknown): boolean;
+/** Rests are exactly the "nothing" values in `Step`: null, undefined (array
+ *  holes) and false. `0` is a real value (root note, 0 semitones, CV 0);
+ *  `'.'`/`'-'` are only rest syntax inside steps()/notes() strings. */
+export declare function isRest(v: unknown): v is null | undefined | false;
 export declare function createTransport(ctx: BaseAudioContext, opts?: TransportOptions): Transport;
-/** `steps('x... x... x..x x...')` → boolean[]. x/X = hit, anything else = rest; spaces/| ignored. */
-export declare function steps(s: string): boolean[];
+/** Velocities for the hit letters in `steps()`. */
+export interface StepsLevels {
+	/** `X`. Default 1. */
+	accent?: number;
+	/** `x`. Default 0.75. */
+	normal?: number;
+	/** `o`. Default 0.4. */
+	ghost?: number;
+}
+/**
+ * `steps('X..x o.x. x... x..x')` → one step per character, value `true`:
+ * `X` = accent, `x` = normal hit, `o` = ghost note (as velocity, see
+ * StepsLevels), `.`/`-` = rest. Spaces and `|` are ignored; any other
+ * character throws, so a typo can't silently become a rest.
+ */
+export declare function steps(s: string, levels?: StepsLevels): (StepObject<true> | null)[];
 /** 'A4' → 69, 'C4' → 60, 'F#2' → 42; a number passes through typed. Midi numbers are the pitch unit everywhere (V/Oct = semitones). */
 export declare function note(name: string | number): Note;
 /** `notes('C3 . E3 G3 - C4')` → (Note | null)[]. '.'/'-' = rest. */
@@ -281,8 +298,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;
@@ -290,7 +305,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 {
@@ -301,246 +316,20 @@ 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; a number `value`
- *  repitches in semitones, anything else (e.g. `true` from steps()) plays it
- *  unshifted. */
+export interface SampleVoiceOptions {
+	/** The note that plays the sample unshifted. Default 60 (C4). */
+	root?: Note;
+}
+/** A one-shot sample voice, like a drum machine: every hit plays the whole
+ *  sample, whatever the step's gate length. velocity 0..1 scales level. A
+ *  `Note` value plays the sample at that note (`root` = unshifted), the same
+ *  numbers `NoteCv` plays, so `notes()` melodies work on both; anything else
+ *  (e.g. `true` from steps()) plays it unshifted. */
 export declare const SampleVoice: {
-	create(ctx: BaseAudioContext, kit: LoadedSampleSet, key: VoiceKey): VoiceInstance<number | boolean>;
-};
-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, opts?: SampleVoiceOptions): VoiceInstance<Note | 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;
@@ -550,7 +339,7 @@ export interface AcidFilterParams {
 	envMod?: number;
 	/** Accent. Intensifies the envelope sweep for more aggressive acid sounds. Range 0–1. Default 0.5. */
 	accent?: number;
-	/** Decay Time. How quickly the filter envelope falls. Short = plucky, long = sustained. Range 0.05–1 s (log). Default 0.2. */
+	/** Decay Time. Time for the exponential filter sweep to fall 60 dB after each trigger. Short = plucky squelch, long = slow, singing sweeps. Range 0.2–5 s (log). Default 0.92. */
 	decay?: Seconds;
 }
 export type AcidFilterInputs = {
@@ -900,13 +689,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;
@@ -1563,13 +1352,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. At PITCH 0 the loop is plain reverb feedback and the regen is held under its self-oscillation edge, so 0.95 is a near-frozen, slowly breathing tail that always dies away. Range 0–0.95. Default 0.5. */
 	shimmer?: number;
 }
 export type ShimmerInputs = {