tuneframes 0.1.1 → 0.2.0

package/registry/presets/reverb-warm.html

@@ -0,0 +1,11 @@
+<!-- TuneFrames preset: reverb-warm
+     Long reverb chain. Paste before your instruments. -->
+<script>
+  // Reverb: long decay, high wet — lush, ambient
+  const verb = new Tone.Reverb({
+    decay: 4,
+    wet: 0.75
+  }).toDestination();
+  // Call .generate() to build the impulse response (runs at composition start)
+  verb.generate();
+</script>

package/registry/samples.json

@@ -0,0 +1,226 @@
+{
+  "version": "1.0.0",
+  "cdn": {
+    "gleitz_fluidr3_gm": {
+      "name": "gleitz FluidR3_GM",
+      "baseUrlTemplate": "https://gleitz.github.io/midi-js-soundfonts/FluidR3_GM/{instrument}-mp3/",
+      "format": "mp3",
+      "noteNameFormat": "Sharps written with 's' suffix (e.g. F#4 = Fs4, C#3 = Cs3)",
+      "license": "Public domain (FluidR3_GM SoundFont)",
+      "repo": "https://github.com/gleitz/midi-js-soundfonts"
+    }
+  },
+  "instruments": {
+    "acoustic_grand_piano": {
+      "cdn": "gleitz_fluidr3_gm",
+      "baseUrl": "https://gleitz.github.io/midi-js-soundfonts/FluidR3_GM/acoustic_grand_piano-mp3/",
+      "category": "piano",
+      "range": { "low": "A0", "high": "C8" },
+      "urls": {
+        "A0": "A0.mp3",
+        "C1": "C1.mp3",
+        "Ds1": "Ds1.mp3",
+        "Fs1": "Fs1.mp3",
+        "A1": "A1.mp3",
+        "C2": "C2.mp3",
+        "Ds2": "Ds2.mp3",
+        "Fs2": "Fs2.mp3",
+        "A2": "A2.mp3",
+        "C3": "C3.mp3",
+        "Ds3": "Ds3.mp3",
+        "Fs3": "Fs3.mp3",
+        "A3": "A3.mp3",
+        "C4": "C4.mp3",
+        "Ds4": "Ds4.mp3",
+        "Fs4": "Fs4.mp3",
+        "A4": "A4.mp3",
+        "C5": "C5.mp3",
+        "Ds5": "Ds5.mp3",
+        "Fs5": "Fs5.mp3",
+        "A5": "A5.mp3",
+        "C6": "C6.mp3",
+        "Ds6": "Ds6.mp3",
+        "Fs6": "Fs6.mp3",
+        "A6": "A6.mp3",
+        "C7": "C7.mp3",
+        "Ds7": "Ds7.mp3",
+        "Fs7": "Fs7.mp3",
+        "A7": "A7.mp3",
+        "C8": "C8.mp3"
+      },
+      "notes": "Full 88-key range. Tone.Sampler pitch-shifts from nearest sample automatically."
+    },
+    "acoustic_bass": {
+      "cdn": "gleitz_fluidr3_gm",
+      "baseUrl": "https://gleitz.github.io/midi-js-soundfonts/FluidR3_GM/acoustic_bass-mp3/",
+      "category": "bass",
+      "range": { "low": "C1", "high": "G4" },
+      "urls": {
+        "C1": "C1.mp3",
+        "Ds1": "Ds1.mp3",
+        "Fs1": "Fs1.mp3",
+        "A1": "A1.mp3",
+        "C2": "C2.mp3",
+        "Ds2": "Ds2.mp3",
+        "Fs2": "Fs2.mp3",
+        "A2": "A2.mp3",
+        "C3": "C3.mp3",
+        "Ds3": "Ds3.mp3",
+        "Fs3": "Fs3.mp3",
+        "A3": "A3.mp3",
+        "C4": "C4.mp3",
+        "Fs4": "Fs4.mp3"
+      },
+      "notes": "Upright/double bass. Best in C1–C3 range for natural timbre."
+    },
+    "string_ensemble_1": {
+      "cdn": "gleitz_fluidr3_gm",
+      "baseUrl": "https://gleitz.github.io/midi-js-soundfonts/FluidR3_GM/string_ensemble_1-mp3/",
+      "category": "strings",
+      "range": { "low": "C2", "high": "C7" },
+      "urls": {
+        "C2": "C2.mp3",
+        "Ds2": "Ds2.mp3",
+        "Fs2": "Fs2.mp3",
+        "A2": "A2.mp3",
+        "C3": "C3.mp3",
+        "Ds3": "Ds3.mp3",
+        "Fs3": "Fs3.mp3",
+        "A3": "A3.mp3",
+        "C4": "C4.mp3",
+        "Ds4": "Ds4.mp3",
+        "Fs4": "Fs4.mp3",
+        "A4": "A4.mp3",
+        "C5": "C5.mp3",
+        "Ds5": "Ds5.mp3",
+        "Fs5": "Fs5.mp3",
+        "A5": "A5.mp3",
+        "C6": "C6.mp3",
+        "Ds6": "Ds6.mp3",
+        "Fs6": "Fs6.mp3",
+        "A6": "A6.mp3",
+        "C7": "C7.mp3"
+      },
+      "notes": "Lush string section. Long note durations ('1n', '2n') sound most natural."
+    },
+    "brass_section": {
+      "cdn": "gleitz_fluidr3_gm",
+      "baseUrl": "https://gleitz.github.io/midi-js-soundfonts/FluidR3_GM/brass_section-mp3/",
+      "category": "brass",
+      "range": { "low": "C2", "high": "C6" },
+      "urls": {
+        "C2": "C2.mp3",
+        "Ds2": "Ds2.mp3",
+        "Fs2": "Fs2.mp3",
+        "A2": "A2.mp3",
+        "C3": "C3.mp3",
+        "Ds3": "Ds3.mp3",
+        "Fs3": "Fs3.mp3",
+        "A3": "A3.mp3",
+        "C4": "C4.mp3",
+        "Ds4": "Ds4.mp3",
+        "Fs4": "Fs4.mp3",
+        "A4": "A4.mp3",
+        "C5": "C5.mp3",
+        "Ds5": "Ds5.mp3",
+        "Fs5": "Fs5.mp3",
+        "A5": "A5.mp3",
+        "C6": "C6.mp3"
+      },
+      "notes": "Big brass stabs and fanfares. Works best for short, punchy note durations ('8n', '4n')."
+    },
+    "acoustic_guitar_nylon": {
+      "cdn": "gleitz_fluidr3_gm",
+      "baseUrl": "https://gleitz.github.io/midi-js-soundfonts/FluidR3_GM/acoustic_guitar_nylon-mp3/",
+      "category": "guitar",
+      "range": { "low": "E2", "high": "D6" },
+      "urls": {
+        "Fs2": "Fs2.mp3",
+        "A2": "A2.mp3",
+        "C3": "C3.mp3",
+        "Ds3": "Ds3.mp3",
+        "Fs3": "Fs3.mp3",
+        "A3": "A3.mp3",
+        "C4": "C4.mp3",
+        "Ds4": "Ds4.mp3",
+        "Fs4": "Fs4.mp3",
+        "A4": "A4.mp3",
+        "C5": "C5.mp3",
+        "Ds5": "Ds5.mp3",
+        "Fs5": "Fs5.mp3",
+        "A5": "A5.mp3",
+        "C6": "C6.mp3"
+      },
+      "notes": "Classical nylon-string guitar. Natural decay — use release or short durations."
+    },
+    "vibraphone": {
+      "cdn": "gleitz_fluidr3_gm",
+      "baseUrl": "https://gleitz.github.io/midi-js-soundfonts/FluidR3_GM/vibraphone-mp3/",
+      "category": "mallet",
+      "range": { "low": "C3", "high": "C7" },
+      "urls": {
+        "C3": "C3.mp3",
+        "Ds3": "Ds3.mp3",
+        "Fs3": "Fs3.mp3",
+        "A3": "A3.mp3",
+        "C4": "C4.mp3",
+        "Ds4": "Ds4.mp3",
+        "Fs4": "Fs4.mp3",
+        "A4": "A4.mp3",
+        "C5": "C5.mp3",
+        "Ds5": "Ds5.mp3",
+        "Fs5": "Fs5.mp3",
+        "A5": "A5.mp3",
+        "C6": "C6.mp3",
+        "Ds6": "Ds6.mp3",
+        "Fs6": "Fs6.mp3",
+        "A6": "A6.mp3",
+        "C7": "C7.mp3"
+      },
+      "notes": "Warm bell-like timbre. Pairs well with reverb for jazz/ambient contexts."
+    },
+    "flute": {
+      "cdn": "gleitz_fluidr3_gm",
+      "baseUrl": "https://gleitz.github.io/midi-js-soundfonts/FluidR3_GM/flute-mp3/",
+      "category": "woodwind",
+      "range": { "low": "C4", "high": "A7" },
+      "urls": {
+        "C4": "C4.mp3",
+        "Ds4": "Ds4.mp3",
+        "Fs4": "Fs4.mp3",
+        "A4": "A4.mp3",
+        "C5": "C5.mp3",
+        "Ds5": "Ds5.mp3",
+        "Fs5": "Fs5.mp3",
+        "A5": "A5.mp3",
+        "C6": "C6.mp3",
+        "Ds6": "Ds6.mp3",
+        "Fs6": "Fs6.mp3",
+        "A6": "A6.mp3",
+        "C7": "C7.mp3"
+      },
+      "notes": "Breathy and lyrical. Best for melodic lines, not chords."
+    },
+    "choir_aahs": {
+      "cdn": "gleitz_fluidr3_gm",
+      "baseUrl": "https://gleitz.github.io/midi-js-soundfonts/FluidR3_GM/choir_aahs-mp3/",
+      "category": "choir",
+      "range": { "low": "C3", "high": "G5" },
+      "urls": {
+        "C3": "C3.mp3",
+        "Ds3": "Ds3.mp3",
+        "Fs3": "Fs3.mp3",
+        "A3": "A3.mp3",
+        "C4": "C4.mp3",
+        "Ds4": "Ds4.mp3",
+        "Fs4": "Fs4.mp3",
+        "A4": "A4.mp3",
+        "C5": "C5.mp3",
+        "Ds5": "Ds5.mp3",
+        "Fs5": "Fs5.mp3",
+        "A5": "A5.mp3"
+      },
+      "notes": "Sustained 'aah' choir vowel. Long durations ('1n', '2n') and reverb are essential for realism."
+    }
+  }
+}

package/skills/audio-ambient/SKILL.md

@@ -0,0 +1,141 @@
+---
+name: audio-ambient
+description: Brian Eno-style ambient — long evolving drone pads, massive reverb (8-12s decay), no percussion, slow pitch movement
+---
+
+# TuneFrames — Ambient
+
+## Genre Profile
+- BPM range: 50-70 (or unmeasured — BPM matters only for note scheduling)
+- Key characteristics: slow fade-ins/outs (attack 3-6s, release 5-8s), pitch movement by semitones over 4-8 seconds, overlapping sustain layers, no rhythm
+- Typical instruments: PolySynth (sine/triangle), soft AM pads, FMSynth with gentle modulation
+- Mood: deep, meditative, timeless, oceanic
+
+## Core Pattern
+
+```js
+// Ambient: overlapping long pads that evolve slowly
+// Key = D minor — dark and peaceful
+// Chord tones: D2, F2, A2, C3, E3, G3
+
+const reverb = new Tone.Reverb({ decay: 10, wet: 0.9 });
+await reverb.generate(); // must await before using
+reverb.toDestination();
+
+const delay = new Tone.FeedbackDelay({ delayTime: '4n', feedback: 0.4, wet: 0.3 });
+delay.connect(reverb);
+
+// Primary drone pad — slow attack, very long sustain
+const drone = new Tone.PolySynth(Tone.Synth, {
+  oscillator: { type: 'sine' },
+  envelope: { attack: 4.0, decay: 2.0, sustain: 0.9, release: 6.0 },
+  volume: -10,
+});
+drone.connect(delay);
+
+// Shimmer layer — high harmonics, triangle wave
+const shimmer = new Tone.PolySynth(Tone.Synth, {
+  oscillator: { type: 'triangle' },
+  envelope: { attack: 5.0, decay: 1.5, sustain: 0.7, release: 7.0 },
+  volume: -18,
+});
+shimmer.connect(reverb);
+
+// Schedule evolving chord tones — no rhythm, just slow fades in/out
+const notes = ['D2', 'A2', 'F3', 'C3', 'E3', 'D3', 'G2'];
+notes.forEach((note, i) => {
+  const offset = i * 2.5; // stagger each note by 2.5 seconds
+  Tone.Transport.scheduleOnce((time) => {
+    drone.triggerAttackRelease(note, '8n', time); // long hold
+  }, offset);
+});
+
+// Shimmer tones — offset so they breathe between drone attacks
+['F4', 'A4', 'C5', 'E5'].forEach((note, i) => {
+  Tone.Transport.scheduleOnce((time) => {
+    shimmer.triggerAttackRelease(note, '8n', time);
+  }, i * 3.2 + 1.5);
+});
+
+Tone.Transport.bpm.value = 60;
+Tone.Transport.start();
+```
+
+## Instrument Configuration
+
+```js
+// Massive reverb — the defining character of ambient
+const reverb = new Tone.Reverb({ decay: 10, preDelay: 0.05, wet: 0.88 });
+await reverb.generate(); // always await!
+
+// Sidechain delay for shimmer depth
+const delay = new Tone.FeedbackDelay({ delayTime: 0.375, feedback: 0.45, wet: 0.35 });
+
+// Primary drone — sine waves, extremely slow envelope
+const drone = new Tone.PolySynth(Tone.Synth, {
+  oscillator: { type: 'sine' },
+  envelope: { attack: 4.5, decay: 2.0, sustain: 0.85, release: 7.0 },
+  volume: -8,
+});
+
+// Overtone layer — triangle adds warmth without brightness
+const overtone = new Tone.PolySynth(Tone.Synth, {
+  oscillator: { type: 'triangle' },
+  envelope: { attack: 3.0, decay: 1.5, sustain: 0.7, release: 5.0 },
+  volume: -16,
+});
+
+// Sub drone — sine one octave below, anchors the space
+const sub = new Tone.Synth({
+  oscillator: { type: 'sine' },
+  envelope: { attack: 6.0, decay: 3.0, sustain: 0.9, release: 8.0 },
+  volume: -14,
+});
+
+// Signal chain: instruments → delay → reverb → destination
+drone.connect(delay);
+overtone.connect(reverb);
+sub.connect(reverb);
+delay.connect(reverb);
+```
+
+## Composition Structure
+
+**Ambient has no traditional structure — it breathes.**
+
+1. **Entry (0-4s):** First note fades in almost imperceptibly — attack is 4+ seconds
+2. **Accumulation (4-10s):** Second and third pitches enter, staggered 2-4s apart, building a slow chord cloud
+3. **Shimmer (8-14s):** Upper register tones enter — overtones of the root
+4. **Sustained body (10-20s+):** All layers overlap. Nothing resolves — everything just exists together
+5. **No outro needed** — ambient fades naturally because of long release envelopes
+
+**Pitch movement rules:**
+- Move by semitones or whole steps only — no jumps larger than a 4th
+- Let dissonance exist — it resolves by itself over time
+- Never use more than 4-5 notes simultaneously
+
+## Example Variations
+
+### Variation 1: Major / peaceful
+```js
+// C major drone — open and spacious
+const chordNotes = ['C3', 'G3', 'E4', 'B3', 'D4'];
+// Brighter attack on shimmer: attack: 2.5
+// Higher reverb wet: 0.92
+```
+
+### Variation 2: Cluster / tension
+```js
+// Half-step cluster — creates gentle tension that never resolves
+const tones = ['E3', 'F3', 'G3', 'Ab3']; // chromatic compression
+// Slower attack: 6.0 — the dissonance appears gradually so it never feels harsh
+// Delay feedback higher: 0.55 — creates wash of overtones
+```
+
+### Variation 3: Single-note breath
+```js
+// Pure minimalism — one pitch at a time, long silences between
+const seq = ['D3', null, null, null, 'F3', null, null, null, 'A3'];
+// This is the most meditative form — inspired by Feldman/Satie
+// Set reverb decay to 12s so notes bleed into silence
+```

package/skills/audio-ambient/example.html

@@ -0,0 +1,113 @@
+<div id="tuneframes" style="display:none">{"bpm":60,"duration":"14s"}</div>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/tone/14.8.49/Tone.js"></script>
+<script>
+// TuneFrames — Ambient (Brian Eno style)
+// D minor drone pads, massive reverb, slow evolving pitch movement
+// No percussion. Everything breathes.
+
+async function main() {
+  await Tone.start();
+
+  Tone.Transport.bpm.value = 60;
+
+  // ── Effects chain ──────────────────────────────────────────────────────────
+  const reverb = new Tone.Reverb({ decay: 10, preDelay: 0.05, wet: 0.88 });
+  await reverb.generate();
+  reverb.toDestination();
+
+  const delay = new Tone.FeedbackDelay({ delayTime: 0.5, feedback: 0.42, wet: 0.32 });
+  delay.connect(reverb);
+
+  // ── Primary drone — sine wave, very slow attack ────────────────────────────
+  const drone = new Tone.PolySynth(Tone.Synth, {
+    oscillator: { type: 'sine' },
+    envelope: { attack: 4.5, decay: 2.0, sustain: 0.9, release: 7.0 },
+    volume: -8,
+  });
+  drone.connect(delay);
+
+  // ── Shimmer layer — triangle, even slower, upper register ─────────────────
+  const shimmer = new Tone.PolySynth(Tone.Synth, {
+    oscillator: { type: 'triangle' },
+    envelope: { attack: 5.0, decay: 1.5, sustain: 0.75, release: 6.0 },
+    volume: -17,
+  });
+  shimmer.connect(reverb);
+
+  // ── Sub drone — anchors the bass register ─────────────────────────────────
+  const sub = new Tone.Synth({
+    oscillator: { type: 'sine' },
+    envelope: { attack: 6.0, decay: 3.0, sustain: 0.9, release: 8.0 },
+    volume: -13,
+  });
+  sub.connect(reverb);
+
+  // ── Schedule drone tones — D minor: D F A C ───────────────────────────────
+  // Staggered so they don't all attack at once — the overlapping sustains
+  // create the "chord cloud" that defines ambient music.
+  // Note durations use seconds (6, 5, etc.) so the 4.5–6s attacks can fully
+  // develop before release. '8n' (0.5s at 60 BPM) is far too short.
+
+  // Root drone: enters immediately, fades in over 4.5 seconds
+  Tone.Transport.scheduleOnce((t) => {
+    drone.triggerAttackRelease(['D3', 'A3'], 6, t);
+  }, 0);
+
+  // Fifth enters at 1.5s — builds on the drone
+  Tone.Transport.scheduleOnce((t) => {
+    drone.triggerAttackRelease(['F3', 'C4'], 6, t);
+  }, 1.5);
+
+  // Color tone — minor 7th adds bittersweet quality
+  Tone.Transport.scheduleOnce((t) => {
+    drone.triggerAttackRelease(['E3', 'G3'], 5, t);
+  }, 3.5);
+
+  // Second wave — new chord cloud begins overlapping the first
+  Tone.Transport.scheduleOnce((t) => {
+    drone.triggerAttackRelease(['D3', 'F3'], 5, t);
+  }, 6.0);
+
+  Tone.Transport.scheduleOnce((t) => {
+    drone.triggerAttackRelease(['A3', 'C4'], 4, t);
+  }, 8.0);
+
+  // ── Shimmer tones — upper harmonics ───────────────────────────────────────
+  Tone.Transport.scheduleOnce((t) => {
+    shimmer.triggerAttackRelease(['F5', 'A5'], 5, t);
+  }, 2.0);
+
+  Tone.Transport.scheduleOnce((t) => {
+    shimmer.triggerAttackRelease(['D5', 'C5'], 5, t);
+  }, 5.5);
+
+  Tone.Transport.scheduleOnce((t) => {
+    shimmer.triggerAttackRelease(['E5', 'G5'], 4, t);
+  }, 9.0);
+
+  // ── Sub bass — single low D, fades in and holds ───────────────────────────
+  Tone.Transport.scheduleOnce((t) => {
+    sub.triggerAttackRelease('D2', 7, t);
+  }, 0.5);
+
+  // NOTE: do NOT call Tone.Transport.start() here — Tone.Offline manages
+  // transport internally. Calling it manually breaks offline rendering.
+}
+
+window.renderComposition = async function(wavPath) {
+  let attempts = 0;
+  while (typeof Tone === 'undefined' && attempts < 50) {
+    await new Promise(r => setTimeout(r, 100));
+    attempts++;
+  }
+  if (typeof Tone === 'undefined') throw new Error('Tone not loaded');
+
+  const meta = JSON.parse(document.getElementById('tuneframes').textContent);
+  const durationSec = parseFloat(meta.duration) + 1.0;
+
+  const buffer = await Tone.Offline(async () => { await main(); }, durationSec, 1, 44100);
+  const wav = audioBufferToWav(buffer);
+  window.writeFile(wavPath, Array.from(new Uint8Array(wav)));
+  return wav.byteLength;
+};
+</script>

package/skills/audio-boss-battle/SKILL.md

@@ -0,0 +1,157 @@
+---
+name: audio-boss-battle
+description: Video Game Boss Battle — driving 16th-note bass ostinato, power chord stabs on offbeats, heroic AMSynth brass melody, tuned timpani hits, fast counter-arpeggio. Final Fantasy / Nobuo Uematsu epic orchestral-hybrid energy.
+---
+
+# TuneFrames — Video Game Boss Battle
+
+## Genre Profile
+- BPM range: 150–185 (intense, relentless forward drive)
+- Key characteristics: Bass ostinato hammering the root in 16th notes (MonoSynth sawtooth), power chord stabs on offbeats (PolySynth square/sawtooth, short decay), heroic lead melody (AMSynth with sawtooth + sine modulation for brass-like tone), tuned timpani accents (MembraneSynth pitched to D1/A1), fast ascending counter-arpeggio for tension, driving kick pattern
+- Typical instruments: MonoSynth (bass ostinato), PolySynth (power chords), AMSynth (brass melody), MembraneSynth × 2 (kick + timpani), PolySynth (counter arpeggio)
+- Mood: Intense, epic, driving, heroic, desperate, high-stakes
+
+## Core Pattern
+
+```js
+// Boss Battle — 165 BPM, D minor
+// Bars 1–2: bass ostinato alone (ominous)
+// Bars 3–4: power chord stabs on offbeats
+// Bars 5–8: full: melody + counter arpeggio + drums
+
+Tone.Transport.bpm.value = 165;
+
+// Bass ostinato — driving 16th note figure around D root
+const bass = new Tone.MonoSynth({
+  oscillator: { type: "sawtooth" },
+  filter: { Q: 3, type: "lowpass", rolloff: -24 },
+  filterEnvelope: { attack: 0.001, decay: 0.1, sustain: 0.5, release: 0.2,
+                    baseFrequency: 80, octaves: 2 },
+  envelope: { attack: 0.001, decay: 0.1, sustain: 0.7, release: 0.1 },
+  volume: -4
+}).toDestination();
+
+// 16th-note ostinato: D root hammered with neighbor-note movement
+const bassLine = [
+  "D2","D2","F2","D2",  "G2","D2","F2","E2",
+  "D2","D2","F2","D2",  "G2","F2","Eb2","D2"
+];
+let bassStep = 0;
+new Tone.Sequence((time) => {
+  bass.triggerAttackRelease(bassLine[bassStep++ % bassLine.length], "16n", time);
+}, new Array(16).fill(1), "16n").start(0);
+
+// Power chord stabs — PolySynth on the "and" of beats 1 and 3
+const stabChords = [["D3","A3"],["F3","C4"],["G3","D4"],["Bb3","F4"]];
+let stabStep = 0;
+new Tone.Sequence((time, val) => {
+  if (val) stabs.triggerAttackRelease(stabChords[stabStep++ % stabChords.length], "16n", time);
+}, [null,null,1,null,null,null,null,null,null,null,1,null,null,null,null,null], "16n").start("2m");
+
+// Heroic AMSynth melody — D minor ascending/descending
+const melody = [
+  { time: "4m", note: "D4", dur: "4n" }, { time: "4m:1", note: "F4", dur: "4n" },
+  { time: "4m:2", note: "A4", dur: "4n" }, { time: "4m:3", note: "C5", dur: "4n" },
+  { time: "5m", note: "Bb4", dur: "4n" }, { time: "5m:1", note: "A4", dur: "4n" },
+  { time: "5m:2", note: "G4", dur: "2n" },
+];
+melody.forEach(({ time, note, dur }) => brass.triggerAttackRelease(note, dur, time));
+
+Tone.Transport.start();
+```
+
+## Instrument Configuration
+
+```js
+// Bass ostinato — sawtooth through lowpass filter for growl
+const bassVerb = new Tone.Reverb({ decay: 0.4, wet: 0.1 }).toDestination();
+const bass = new Tone.MonoSynth({
+  oscillator: { type: "sawtooth" },
+  filter: { Q: 3, type: "lowpass", rolloff: -24 },
+  filterEnvelope: { attack: 0.001, decay: 0.1, sustain: 0.5, release: 0.2,
+                    baseFrequency: 80, octaves: 2 },
+  envelope: { attack: 0.001, decay: 0.1, sustain: 0.7, release: 0.1 },
+  volume: -4
+}).connect(bassVerb);
+
+// Power chord stabs — square wave, very short decay, punchy
+const stabReverb = new Tone.Reverb({ decay: 0.6, wet: 0.2 }).toDestination();
+const stabs = new Tone.PolySynth(Tone.Synth, {
+  oscillator: { type: "square" },
+  envelope: { attack: 0.001, decay: 0.12, sustain: 0.0, release: 0.08 },
+  volume: -8
+}).connect(stabReverb);
+
+// AMSynth brass melody — sawtooth carrier + sine AM creates "blat" of brass
+const brassVerb = new Tone.Reverb({ decay: 1.5, wet: 0.3 }).toDestination();
+const brass = new Tone.AMSynth({
+  oscillator: { type: "sawtooth" },
+  envelope: { attack: 0.04, decay: 0.1, sustain: 0.85, release: 0.4 },
+  modulation: { type: "sine" },
+  modulationEnvelope: { attack: 0.5, decay: 0, sustain: 1, release: 0.5 },
+  harmonicity: 1,
+  volume: -8
+}).connect(brassVerb);
+
+// Timpani — MembraneSynth pitched low, longer decay than kick
+const timpsVerb = new Tone.Reverb({ decay: 1.2, wet: 0.35 }).toDestination();
+const timps = new Tone.MembraneSynth({
+  pitchDecay: 0.2,
+  octaves: 4,
+  envelope: { attack: 0.001, decay: 0.6, sustain: 0, release: 0.3 },
+  volume: -4
+}).connect(timpsVerb);
+
+// Kick — driving, 8th or 16th note pattern
+const kick = new Tone.MembraneSynth({
+  pitchDecay: 0.06, octaves: 8,
+  envelope: { attack: 0.001, decay: 0.28, sustain: 0, release: 0.08 },
+  volume: 0
+}).toDestination();
+
+// Counter arpeggio — fast 16th note ascent, adds tension
+const arpVerb = new Tone.Reverb({ decay: 0.8, wet: 0.25 }).toDestination();
+const arpSynth = new Tone.PolySynth(Tone.Synth, {
+  oscillator: { type: "sawtooth4" },
+  envelope: { attack: 0.001, decay: 0.08, sustain: 0, release: 0.1 },
+  volume: -14
+}).connect(arpVerb);
+```
+
+## Composition Structure
+
+- **Bars 1–2:** Bass ostinato only — ominous, low, relentless (the enemy approaches)
+- **Bars 3–4:** Timpani accents on bar downbeats, power chord stabs on offbeats (tension escalates)
+- **Bars 5–6:** Kick + snare enter, driving rhythm locked in, counter arpeggio begins
+- **Bars 7–10:** Full arrangement — AMSynth brass melody soars over the groove
+- **Bar 11–12:** Climax: all elements together, melody at highest pitch, bass most active
+- **Buildup trick:** Use `Tone.Transport.bpm.linearRampTo(180, "+4m")` to gradually accelerate into the final bars
+
+Harmonic vocabulary: D natural minor (D E F G A Bb C). Tritone sub on beat 3 (Ab) adds danger. Perfect 5th power chords [root, 5th] — no thirds — are the "8-bit" signature.
+
+## Example Variations
+
+### 1 — Faster bass (triplet feel, more chaotic)
+```js
+// 8th note triplets instead of 16ths — more chaotic, less locked-in
+const tripletBass = ["D2","F2","A2","G2","F2","D2"];
+let step = 0;
+new Tone.Sequence((time) => {
+  bass.triggerAttackRelease(tripletBass[step++ % tripletBass.length], "8t", time);
+}, new Array(6).fill(1), "8t").start(0);
+```
+
+### 2 — Tempo acceleration (building to a climax)
+```js
+// Slowly push the BPM from 160 to 185 over 8 bars
+const startTime = Tone.Time("4m").toSeconds();
+Tone.Transport.bpm.setValueAtTime(160, startTime);
+Tone.Transport.bpm.linearRampToValueAtTime(185, startTime + Tone.Time("4m").toSeconds());
+```
+
+### 3 — Minor key shift mid-battle (F minor for boss phase 2)
+```js
+// After 8 bars, shift to F minor: F G Ab Bb C Db Eb
+// Retrigger stab chords and melody with new root
+const phase2Chords = [["F3","C4"],["Ab3","Eb4"],["Bb3","F4"],["Db4","Ab4"]];
+```