npm - tuneframes - Versions diffs - 0.1.1 → 0.2.0 - Mend

tuneframes 0.1.1 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (80) hide show

package/LICENSE +166 -166
package/README.md +158 -55
package/examples/example-ai-dj-chill.html +167 -0
package/examples/example-ai-dj-dark.html +167 -0
package/examples/example-ai-dj-energetic.html +167 -0
package/examples/example-ai-dj-happy.html +167 -0
package/examples/example-ai-dj.html +167 -0
package/examples/example-ambient.html +63 -63
package/examples/example-ambient.mp3 +0 -0
package/examples/example-bass.html +47 -47
package/examples/example-lofi.html +45 -45
package/examples/example-lofi.mp3 +0 -0
package/examples/example-minimal.html +20 -20
package/examples/example-orchestral.html +67 -67
package/examples/example-orchestral.mp3 +0 -0
package/examples/example-piano.html +52 -52
package/examples/example-piano.mp3 +0 -0
package/examples/example-techno.html +69 -69
package/examples/example-techno.mp3 +0 -0
package/package.json +42 -37
package/registry/presets/bass-electric.html +67 -0
package/registry/presets/bass-saw.html +22 -0
package/registry/presets/chord-progression.html +22 -0
package/registry/presets/drums-808.html +85 -0
package/registry/presets/drums-lofi.html +35 -0
package/registry/presets/lead-piano.html +26 -0
package/registry/presets/piano-salamander.html +69 -0
package/registry/presets/reverb-warm.html +11 -0
package/registry/samples.json +226 -0
package/skills/audio-ambient/SKILL.md +141 -0
package/skills/audio-ambient/example.html +113 -0
package/skills/audio-boss-battle/SKILL.md +157 -0
package/skills/audio-boss-battle/example.html +185 -0
package/skills/audio-boss-battle/example.mp3 +0 -0
package/skills/audio-chillwave/SKILL.md +142 -0
package/skills/audio-chillwave/example.html +144 -0
package/skills/audio-cinematic/SKILL.md +147 -0
package/skills/audio-cinematic/example.html +123 -0
package/skills/audio-classical/SKILL.md +138 -0
package/skills/audio-classical/example.html +145 -0
package/skills/audio-dnb/SKILL.md +142 -0
package/skills/audio-dnb/example.html +124 -0
package/skills/audio-downtempo/SKILL.md +152 -0
package/skills/audio-downtempo/example.html +164 -0
package/skills/audio-folk/SKILL.md +139 -0
package/skills/audio-folk/example.html +132 -0
package/skills/audio-funk/SKILL.md +149 -0
package/skills/audio-funk/example.html +144 -0
package/skills/audio-future-bass/SKILL.md +163 -0
package/skills/audio-future-bass/example.html +164 -0
package/skills/audio-hip-hop/SKILL.md +133 -0
package/skills/audio-hip-hop/example.html +129 -0
package/skills/audio-house/SKILL.md +147 -0
package/skills/audio-house/example.html +128 -0
package/skills/audio-indie-pop/SKILL.md +150 -0
package/skills/audio-indie-pop/example.html +121 -0
package/skills/audio-jazz/SKILL.md +141 -0
package/skills/audio-jazz/example.html +146 -0
package/skills/audio-lofi/SKILL.md +140 -0
package/skills/audio-lofi/example.html +135 -0
package/skills/audio-minimal/SKILL.md +155 -0
package/skills/audio-minimal/example.html +118 -0
package/skills/audio-orchestral/SKILL.md +156 -0
package/skills/audio-orchestral/example.html +140 -0
package/skills/audio-r-and-b/SKILL.md +134 -0
package/skills/audio-r-and-b/example.html +154 -0
package/skills/audio-r-and-b/example.mp3 +0 -0
package/skills/audio-techno/SKILL.md +140 -0
package/skills/audio-techno/example.html +125 -0
package/skills/audio-trap/SKILL.md +123 -0
package/skills/audio-trap/example.html +119 -0
package/skills/render-retest/example.html +115 -0
package/skills/tuneframes/SKILL.md +221 -0
package/skills/tuneframes-cli/SKILL.md +46 -0
package/skills/verify/example.html +104 -0
package/src/cli.js +260 -151
package/src/render.js +134 -7
package/examples/example-bass.mp3 +0 -0
package/examples/example-demo-beat.wav +0 -0
package/examples/example-orchestral.wav +0 -0

package/skills/audio-lofi/example.html ADDED Viewed

@@ -0,0 +1,135 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>TuneFrames — Lo-fi Hip Hop</title>
+  <script src="https://cdnjs.cloudflare.com/ajax/libs/tone/14.8.49/Tone.js"></script>
+</head>
+<body>
+  <div id="tuneframes" style="display:none">{"bpm":80,"duration":"12s"}</div>
+  <script>
+    async function main() {
+      await Tone.start();
+      Tone.Transport.bpm.value = 80;
+      // ── Effects chain ───────────────────────────────────────────────────
+      const reverb   = new Tone.Reverb({ decay: 3.5, preDelay: 0.01, wet: 0.55 }).toDestination();
+      await reverb.ready;
+      const lpFilter = new Tone.Filter(1800, 'lowpass').connect(reverb);
+      const tape     = new Tone.Distortion(0.04).connect(lpFilter);
+      // ── Soft pink noise (vinyl warmth) ──────────────────────────────────
+      const noiseLp   = new Tone.Filter(600, 'lowpass').connect(reverb);
+      const vinylNoise = new Tone.Noise('pink').connect(noiseLp);
+      vinylNoise.volume.value = -42;
+      vinylNoise.start(0).stop('+12');
+      // ── Rhodes-style keys ───────────────────────────────────────────────
+      const keys = new Tone.PolySynth(Tone.Synth, {
+        oscillator: { type: 'triangle' },
+        envelope: { attack: 0.05, decay: 0.3, sustain: 0.7, release: 2.0 }
+      }).connect(tape);
+      keys.volume.value = -10;
+      // Am7 – Fmaj7 – Cmaj7 – G7
+      const chords = [
+        ['A3','C4','E4','G4'],
+        ['F3','A3','C4','E4'],
+        ['C3','E3','G3','B3'],
+        ['G3','B3','D4','F4'],
+      ];
+      // 2 beats per chord at 80 BPM = 1.5s per chord
+      const step = Tone.Time('2n').toSeconds();
+      chords.forEach((ch, i) => keys.triggerAttackRelease(ch, '2n', i * step));
+      // Second pass — loop the chords again from 6s
+      chords.forEach((ch, i) => keys.triggerAttackRelease(ch, '2n', 6 + i * step));
+      // ── Walking bass ────────────────────────────────────────────────────
+      const bassFilter = new Tone.Filter(600, 'lowpass').connect(reverb);
+      const bass = new Tone.Synth({
+        oscillator: { type: 'sine' },
+        envelope: { attack: 0.02, decay: 0.12, sustain: 0.5, release: 0.5 }
+      }).connect(bassFilter);
+      bass.volume.value = -6;
+      // Root + passing tone on each chord (quarter notes)
+      const bassLines = [
+        ['A2','C3'],
+        ['F2','G2'],
+        ['C2','E2'],
+        ['G2','A2'],
+      ];
+      bassLines.forEach(([root, pass], i) => {
+        bass.triggerAttackRelease(root, '4n', i * step);
+        bass.triggerAttackRelease(pass, '4n', i * step + step * 0.5);
+      });
+      bassLines.forEach(([root, pass], i) => {
+        bass.triggerAttackRelease(root, '4n', 6 + i * step);
+        bass.triggerAttackRelease(pass, '4n', 6 + i * step + step * 0.5);
+      });
+      // ── Muffled kick ────────────────────────────────────────────────────
+      const kickLp = new Tone.Filter(200, 'lowpass').connect(reverb);
+      const kick   = new Tone.MembraneSynth({
+        pitchDecay: 0.05, octaves: 5,
+        envelope: { attack: 0.001, decay: 0.4, sustain: 0, release: 0.4 }
+      }).connect(kickLp);
+      kick.volume.value = -14;
+      const beat = 60 / 80; // 0.75s
+      // Kick on beats 1 and 3 of each bar (2 bars = 12 beats total)
+      for (let bar = 0; bar < 4; bar++) {
+        kick.triggerAttackRelease('C1', '8n', bar * beat * 4);
+        kick.triggerAttackRelease('C1', '8n', bar * beat * 4 + beat * 2);
+      }
+      // ── Snare (soft) ────────────────────────────────────────────────────
+      const snare = new Tone.NoiseSynth({
+        noise: { type: 'white' },
+        envelope: { attack: 0.001, decay: 0.12, sustain: 0, release: 0.05 }
+      }).connect(new Tone.Filter(3000, 'bandpass').connect(reverb));
+      snare.volume.value = -22;
+      // Snare on beats 2 and 4
+      for (let bar = 0; bar < 4; bar++) {
+        snare.triggerAttackRelease('8n', bar * beat * 4 + beat);
+        snare.triggerAttackRelease('8n', bar * beat * 4 + beat * 3);
+      }
+      // ── Soft hi-hat (swung 8ths) ────────────────────────────────────────
+      const hat = new Tone.MetalSynth({
+        frequency: 400,
+        envelope: { attack: 0.001, decay: 0.06, release: 0.01 },
+        harmonicity: 5.1, modulationIndex: 32, resonance: 4000, octaves: 1.5
+      }).connect(reverb);
+      hat.volume.value = -28;
+      // Swung 8th notes: on beat, then slightly late (lazy swing)
+      for (let i = 0; i < 16; i++) {
+        const swing = (i % 2 === 1) ? 0.05 : 0; // slight swing delay on offbeats
+        hat.triggerAttackRelease('16n', i * beat * 0.5 + swing);
+      }
+      // ── Melody fragment (enters bar 3, ~4.5s) ───────────────────────────
+      const melodyDelay = new Tone.FeedbackDelay({ delayTime: '8n', feedback: 0.25, wet: 0.3 }).connect(reverb);
+      const melody = new Tone.Synth({
+        oscillator: { type: 'sine' },
+        envelope: { attack: 0.02, decay: 0.2, sustain: 0.3, release: 0.8 }
+      }).connect(melodyDelay);
+      melody.volume.value = -16;
+      // Simple pentatonic phrase over bars 3–4 (starting at 4.5s)
+      const phrase = [
+        { note: 'E5', time: 4.5, dur: '8n' },
+        { note: 'C5', time: 5.0, dur: '8n' },
+        { note: 'A4', time: 5.5, dur: '4n' },
+        { note: 'G4', time: 6.5, dur: '8n' },
+        { note: 'A4', time: 7.0, dur: '4n' },
+        { note: 'E5', time: 7.75, dur: '8n' },
+        { note: 'C5', time: 8.25, dur: '2n' },
+      ];
+      phrase.forEach(({ note, time, dur }) => melody.triggerAttackRelease(note, dur, time));
+    }
+  </script>
+</body>
+</html>

package/skills/audio-minimal/SKILL.md ADDED Viewed

@@ -0,0 +1,155 @@
+---
+name: audio-minimal
+description: Minimal techno — Robert Hood / Villalobos style. A click, a sub, a single hi-hat, one repeating note. Every sound has massive space. Groove lives in subtle velocity variation and silence.
+---
+# TuneFrames — Minimal Techno
+## Genre Profile
+- BPM range: 128–135
+- Key characteristics: Extreme sparsity — 3 to 5 sounds maximum, massive amounts of silence, subtle velocity and timing micro-variations create the groove, no melodic content or filtered sweeps, hypnotic through repetition and restraint
+- Typical instruments: MembraneSynth (kick/click), one MetalSynth or NoiseSynth (hi-hat), one MonoSynth (single repeating note or sub), maybe one sparse PolySynth texture
+- Mood: Hypnotic, austere, cerebral, meditative, relentless
+## Core Pattern
+```js
+// Minimal Techno — 132 BPM
+// Rule: if you're adding a sound, ask whether removing it makes it better.
+// The answer is usually yes.
+// Click kick — not a deep sub, more of a transient "click"
+const kick = new Tone.MembraneSynth({
+  pitchDecay: 0.02,   // very short pitch decay = more click, less boom
+  octaves: 4,
+  envelope: { attack: 0.001, decay: 0.18, sustain: 0, release: 0.05 }
+}).toDestination();
+// Sub — single note, all session, barely moving
+const sub = new Tone.MonoSynth({
+  oscillator: { type: "sine" },
+  envelope: { attack: 0.01, decay: 0.3, sustain: 0.6, release: 0.2 },
+  filter: { type: "lowpass", frequency: 120 },
+  volume: -6
+}).toDestination();
+// Hi-hat — one hit, lots of space, slight velocity drift
+const hat = new Tone.MetalSynth({
+  frequency: 400,
+  envelope: { attack: 0.001, decay: 0.06, release: 0.015 },
+  harmonicity: 3.1, modulationIndex: 16, resonance: 3000, octaves: 1.2,
+  volume: -12
+}).toDestination();
+// The groove is here: velocity micro-variation on the kick
+let step = 0;
+const vels = [0.9, 0.75, 0.85, 0.7, 0.9, 0.8, 0.78, 0.85]; // never quite the same
+new Tone.Sequence((time) => {
+  kick.triggerAttackRelease("C1", "8n", time, vels[step % vels.length]);
+  step++;
+}, [1, null, null, null, 1, null, null, null,
+    1, null, null, null, 1, null, null, null], "16n").start(0);
+// Hat: only on the "and" of beat 4 — one hit per bar
+new Tone.Sequence((time, val) => {
+  if (val) hat.triggerAttackRelease("16n", time, 0.55 + Math.random() * 0.12);
+}, [null, null, null, null, null, null, null, null,
+    null, null, null, null, null, null, 1, null], "16n").start(0);
+```
+## Instrument Configuration
+```js
+// Kick — transient-heavy click, minimal sub content
+const kick = new Tone.MembraneSynth({
+  pitchDecay: 0.018,  // ultra-short = it's mostly a click/transient
+  octaves: 4,
+  volume: -2,
+  envelope: { attack: 0.001, decay: 0.16, sustain: 0, release: 0.04 }
+}).toDestination();
+// Sub tone — sine wave, barely audible, felt not heard
+// This is the floor the kick sits on
+const sub = new Tone.MonoSynth({
+  oscillator: { type: "sine" },
+  filter: { type: "lowpass", frequency: 100 },
+  envelope: { attack: 0.008, decay: 0.25, sustain: 0.7, release: 0.3 },
+  volume: -10
+}).toDestination();
+// Hi-hat — single sparse hit, slightly random velocity = humanization
+const hat = new Tone.MetalSynth({
+  frequency: 380, harmonicity: 3.1, modulationIndex: 16,
+  resonance: 3200, octaves: 1.2,
+  envelope: { attack: 0.001, decay: 0.065, release: 0.018 },
+  volume: -14
+}).toDestination();
+// Optional: one sparse texture note
+// A single note (Tone.Synth) with long release and deep reverb
+// Triggered once every 4-8 bars — the only "melodic" element
+const textureVerb = new Tone.Reverb({ decay: 8.0, wet: 0.85 }).toDestination();
+const texture = new Tone.Synth({
+  oscillator: { type: "sine" },
+  envelope: { attack: 0.2, decay: 2.0, sustain: 0, release: 3.0 },
+  volume: -18
+}).connect(textureVerb);
+```
+## Composition Structure
+Minimal techno is NOT about adding — it's about what you don't play.
+- **Bar 1-4:** Kick only. Establish the pulse. Let silence speak.
+- **Bar 5-8:** Add sub note on beat 1 only. Four bars of kick + one sub note per bar.
+- **Bar 9-16:** Add hat — ONE hit per bar, on beat 4.5 (last 16th). That's it.
+- **Bar 17-32:** No changes. Let the loop breathe. Micro-velocity variation IS the movement.
+- **Bar 33:** Remove the hat. Just kick + sub. Feel the absence.
+- **Bar 37:** Bring hat back at different position in the bar.
+- **Bar 41:** Single texture note — sine wave through 8s reverb. Play it once. Don't repeat it for 8 bars.
+- **Outro:** Remove sub. Just kick. Then silence mid-beat.
+The key insight: in minimal, a sound you've heard 32 times and then REMOVED is louder in its absence than it ever was playing. Use this. Remove things. Let the memory of the sound carry the groove.
+Micro-variation toolkit:
+- Velocity: never the same value twice in a row — vary ±10% randomly
+- Timing: slight humanization (`time + (Math.random() - 0.5) * 0.005`) on the hat only
+- Filter: one slow, almost-imperceptible filter movement over 32 bars on the sub
+- Volume: a 2dB swell over 8 bars, back down — the listener should feel it not notice it
+## Example Variations
+### 1 — Hat timing humanization (the Villalobos move)
+```js
+// Subtle timing displacement on hat = the groove isn't in the kick, it's here
+hat.triggerAttackRelease(
+  "16n",
+  time + (Math.random() - 0.5) * 0.006, // ±6ms drift
+  0.5 + Math.random() * 0.15
+);
+```
+### 2 — Sub filter drift (imperceptible movement)
+```js
+// Extremely slow filter sweep — listener feels unease without knowing why
+const now = Tone.now();
+subFilter.frequency.setValueAtTime(90, now);
+subFilter.frequency.linearRampToValueAtTime(140, now + 30); // over 30 seconds
+subFilter.frequency.linearRampToValueAtTime(90, now + 60);
+```
+### 3 — Silence as event (drop the kick for 1 bar)
+```js
+// Most powerful move in minimal: remove kick for exactly one bar
+// Use a Tone.Part to exclude one specific bar from the sequence
+// The groove snaps back harder when the kick returns
+let kickEnabled = true;
+const kickSeq = new Tone.Sequence((time) => {
+  if (kickEnabled) kick.triggerAttackRelease("C1", "8n", time);
+}, [1, null, null, null, 1, null, null, null,
+    1, null, null, null, 1, null, null, null], "16n");
+// Disable for bar 9 only
+Tone.Transport.scheduleOnce(() => { kickEnabled = false; }, "8m");
+Tone.Transport.scheduleOnce(() => { kickEnabled = true; },  "9m");
+```

package/skills/audio-minimal/example.html ADDED Viewed

@@ -0,0 +1,118 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <title>TuneFrames — Minimal Techno</title>
+  <script src="https://cdnjs.cloudflare.com/ajax/libs/tone/14.8.49/Tone.js"></script>
+</head>
+<body>
+  <!-- TuneFrames Metadata -->
+  <div id="tuneframes"
+    data-bpm="132"
+    data-duration="12s"
+    data-genre="minimal"
+    data-key="none"
+    style="display:none">
+  </div>
+  <script>
+    async function main() {
+      await Tone.start();
+      Tone.Transport.bpm.value = 132;
+      // --- MASTER BUS ---
+      const masterLimiter = new Tone.Limiter(-2).toDestination();
+      const masterGain = new Tone.Gain(0.9).connect(masterLimiter);
+      // --- KICK CLICK — transient-forward, minimal sub ---
+      const kickGain = new Tone.Gain(0.8).connect(masterGain);
+      const kick = new Tone.MembraneSynth({
+        pitchDecay: 0.019,
+        octaves: 4,
+        envelope: { attack: 0.001, decay: 0.16, sustain: 0, release: 0.04 }
+      }).connect(kickGain);
+      // --- SUB TONE — sine, low-passed, felt not heard ---
+      const subGain = new Tone.Gain(0.55).connect(masterGain);
+      const subFilter = new Tone.Filter({ frequency: 110, type: "lowpass", Q: 1 }).connect(subGain);
+      const sub = new Tone.MonoSynth({
+        oscillator: { type: "sine" },
+        filter: { type: "lowpass", frequency: 200 },
+        filterEnvelope: { attack: 0.01, decay: 0.3, sustain: 0.6, release: 0.3,
+                          baseFrequency: 80, octaves: 1 },
+        envelope: { attack: 0.008, decay: 0.22, sustain: 0.65, release: 0.25 },
+        volume: -4
+      }).connect(subFilter);
+      // --- HI-HAT — sparse, single hit per bar, humanized ---
+      const hatGain = new Tone.Gain(0.35).connect(masterGain);
+      const hat = new Tone.MetalSynth({
+        frequency: 385,
+        envelope: { attack: 0.001, decay: 0.062, release: 0.018 },
+        harmonicity: 3.1,
+        modulationIndex: 16,
+        resonance: 3100,
+        octaves: 1.2
+      }).connect(hatGain);
+      // --- TEXTURE — single sine note, massive reverb, triggered once ---
+      const textureVerb = new Tone.Reverb({ decay: 7.5, wet: 0.88 }).connect(masterGain);
+      const textureGain = new Tone.Gain(0.3).connect(textureVerb);
+      const texture = new Tone.Synth({
+        oscillator: { type: "sine" },
+        envelope: { attack: 0.25, decay: 2.5, sustain: 0, release: 4.0 },
+        volume: -2
+      }).connect(textureGain);
+      // --- KICK SEQUENCE — 4-on-the-floor with subtle velocity drift ---
+      // The groove IS the velocity variation — never fully uniform
+      const kickVels = [0.88, 0.74, 0.84, 0.71, 0.90, 0.76, 0.82, 0.70,
+                        0.91, 0.73, 0.85, 0.72, 0.88, 0.75, 0.83, 0.74];
+      let kickStep = 0;
+      const kickSeq = new Tone.Sequence((time) => {
+        kick.triggerAttackRelease("C1", "8n", time, kickVels[kickStep % kickVels.length]);
+        kickStep++;
+      }, [1, null, null, null, 1, null, null, null,
+          1, null, null, null, 1, null, null, null], "16n");
+      kickSeq.start(0);
+      // --- SUB SEQUENCE — one hit per bar, beat 1 only ---
+      // Enters at bar 3 — two bars of kick-only silence first
+      const subSeq = new Tone.Sequence((time) => {
+        sub.triggerAttackRelease("C1", "4n", time);
+      }, [1, null, null, null, null, null, null, null,
+          null, null, null, null, null, null, null, null], "16n");
+      subSeq.start("2m");
+      // Very slow filter drift on sub — imperceptible but felt
+      const subDriftStart = Tone.Time("2m").toSeconds();
+      subFilter.frequency.setValueAtTime(100, subDriftStart);
+      subFilter.frequency.linearRampToValueAtTime(145, subDriftStart + 8);
+      subFilter.frequency.linearRampToValueAtTime(95, subDriftStart + 12);
+      // --- HI-HAT SEQUENCE — ONE hit per bar, on last 16th (step 15) ---
+      // Slight timing humanization = the Villalobos groove
+      // Enters at bar 5
+      const hatSeq = new Tone.Sequence((time) => {
+        const jitter = (Math.random() - 0.5) * 0.005; // ±5ms humanization
+        const vel = 0.48 + Math.random() * 0.16;      // velocity drift
+        hat.triggerAttackRelease("16n", time + jitter, vel);
+      }, [null, null, null, null, null, null, null, null,
+          null, null, null, null, null, null, 1, null], "16n");
+      hatSeq.start("4m");
+      // --- TEXTURE NOTE — single event, bar 7, D above middle ---
+      // Plays once. Never repeats. The reverb tail carries it.
+      texture.triggerAttackRelease("D4", "8n", "6m");
+      // --- STRUCTURAL EVENT: remove hat for exactly one bar (bar 9), then return ---
+      // Absence as rhythm — the most minimal move there is
+      Tone.Transport.scheduleOnce(() => { hatSeq.mute = true; }, "8m");
+      Tone.Transport.scheduleOnce(() => { hatSeq.mute = false; }, "9m");
+    }
+    main();
+  </script>
+</body>
+</html>

package/skills/audio-orchestral/SKILL.md ADDED Viewed

@@ -0,0 +1,156 @@
+---
+name: audio-orchestral
+description: Full orchestral writing — strings carry melody, brass punctuate, timpani on downbeats, woodwind color
+---
+# TuneFrames — Orchestral
+## Genre Profile
+- BPM range: 60-120 (varies by mood — slow for drama, faster for action)
+- Key characteristics: proper voice leading between parts, strings as primary melodic voice, brass on structural downbeats, timpani emphasizes phrase endings, woodwinds add color between string phrases
+- Typical instruments: PolySynth triangle (strings), PolySynth sawtooth (brass), MembraneSynth (timpani), AMSynth (woodwinds)
+- Mood: cinematic, epic, emotional, noble
+## Core Pattern
+```js
+// Orchestral texture: strings carry the tune, brass confirm the harmony
+// Key = D minor, BPM = 80
+Tone.Transport.bpm.value = 80;
+// Hall reverb — essential for orchestral realism
+const reverb = new Tone.Reverb({ decay: 3.5, preDelay: 0.04, wet: 0.7 });
+await reverb.generate();
+reverb.toDestination();
+// STRINGS — PolySynth, triangle wave, slow attack (bowing)
+const strings = new Tone.PolySynth(Tone.Synth, {
+  oscillator: { type: 'triangle' },
+  envelope: { attack: 0.8, decay: 0.3, sustain: 0.9, release: 1.5 },
+  volume: -6,
+});
+strings.connect(reverb);
+// BRASS — PolySynth, sawtooth, medium attack (breath to tone)
+const brass = new Tone.PolySynth(Tone.Synth, {
+  oscillator: { type: 'sawtooth' },
+  envelope: { attack: 0.3, decay: 0.4, sustain: 0.7, release: 0.8 },
+  volume: -10,
+});
+brass.connect(reverb);
+// TIMPANI — MembraneSynth with long resonance
+const timpani = new Tone.MembraneSynth({
+  pitchDecay: 0.4, octaves: 4,
+  envelope: { attack: 0.001, decay: 1.2, sustain: 0, release: 0.8 },
+  volume: -8,
+}).connect(reverb);
+// Strings: melody phrase (quarter notes + half notes)
+// D minor: D E F G A Bb A G
+const stringMelody = ['D4','E4','F4','G4','A4','Bb4','A4','G4'];
+const stringTimes  = [0, 0.75, 1.5, 2.25, 3, 3.75, 4.5, 5.25];
+stringMelody.forEach((note, i) => {
+  Tone.Transport.scheduleOnce(time => {
+    strings.triggerAttackRelease(note, '4n', time);
+  }, stringTimes[i]);
+});
+// Brass: hold root + fifth on downbeats, confirm the harmony
+Tone.Transport.scheduleOnce(t => brass.triggerAttackRelease(['D3','A3'], '2n', t), 0);
+Tone.Transport.scheduleOnce(t => brass.triggerAttackRelease(['F3','C4'], '2n', t), 3);
+Tone.Transport.scheduleOnce(t => brass.triggerAttackRelease(['G3','D4'], '2n', t), 6);
+// Timpani: roll on downbeats — D2 as the root
+[0, 3, 6].forEach(t => {
+  Tone.Transport.scheduleOnce(time => timpani.triggerAttackRelease('D2', '8n', time), t);
+});
+```
+## Instrument Configuration
+```js
+// Hall reverb — orchestras play in halls
+const reverb = new Tone.Reverb({ decay: 3.5, preDelay: 0.05, wet: 0.7 });
+await reverb.generate();
+reverb.toDestination();
+// STRINGS (Violin section)
+// Triangle wave approximates the bowed string harmonic spectrum (rough, not sine)
+// Slow attack simulates bow catching the string
+const strings = new Tone.PolySynth(Tone.Synth, {
+  oscillator: { type: 'triangle' },
+  envelope: { attack: 0.8, decay: 0.2, sustain: 0.95, release: 1.5 },
+  volume: -5,
+}).connect(reverb);
+// BRASS (French horns / Trumpets)
+// Sawtooth gives the harmonic richness of a brass instrument
+// Medium attack = breath control into tone
+const brass = new Tone.PolySynth(Tone.Synth, {
+  oscillator: { type: 'sawtooth' },
+  envelope: { attack: 0.35, decay: 0.3, sustain: 0.75, release: 1.0 },
+  volume: -9,
+}).connect(reverb);
+// WOODWINDS (Oboe / Flute color)
+// AMSynth provides the reedy, breathy quality
+const woodwinds = new Tone.AMSynth({
+  harmonicity: 1,
+  oscillator: { type: 'triangle' },
+  envelope: { attack: 0.15, decay: 0.1, sustain: 0.85, release: 0.6 },
+  modulation: { type: 'square' },
+  modulationEnvelope: { attack: 0.5, decay: 0.0, sustain: 0.3, release: 0.5 },
+  volume: -16,
+}).connect(reverb);
+// TIMPANI
+// MembraneSynth: pitchDecay simulates the drum head ringing
+const timpani = new Tone.MembraneSynth({
+  pitchDecay: 0.35, octaves: 5,
+  envelope: { attack: 0.001, decay: 1.5, sustain: 0, release: 1.0 },
+  volume: -7,
+}).connect(reverb);
+```
+## Composition Structure
+**Phrase-based (not loop-based):**
+1. **Statement (0-3s):** Strings introduce the melody. Brass hold the tonic chord quietly. Timpani on beat 1.
+2. **Response (3-6s):** Strings move to a contrasting phrase. Brass shift to IV or V chord. Woodwinds enter between string notes.
+3. **Development (6-9s):** Melody moves to upper strings (higher octave). Brass build in volume. Timpani on phrase downbeats.
+4. **Cadence (9-12s):** All voices converge on a half-cadence (ends on V) or full cadence (ends on I). Timpani rolls.
+**Voice leading rules:**
+- Strings: move by step or small intervals. Avoid leaps larger than a 5th in the melody.
+- Brass: hold common tones between chords when possible. Move the voice that needs to move.
+- Woodwinds: fill in the 3rd or 7th of the chord — the color tones strings and brass don't cover.
+## Example Variations
+### Variation 1: Heroic major (C major, faster)
+```js
+Tone.Transport.bpm.value = 108;
+// Key: C major — C D E F G A B C
+// Brass on I, IV, V, I (C, F, G, C)
+// Timpani on C2, G2 alternating
+// Strings lead in 8th notes — more energetic
+```
+### Variation 2: Tragic minor (A minor, slow)
+```js
+Tone.Transport.bpm.value = 66;
+// Key: A minor — A B C D E F G A
+// Very slow strings: half notes and whole notes only
+// Brass only enter at climax (bar 3), very quiet before that
+// Timpani: soft rolls (8 rapid 32nd notes) instead of single hits
+```
+### Variation 3: Mysterious woodwind feature
+```js
+// Woodwinds take the melody for 4 bars — strings accompany
+// Strings: slow tremolo (fast repeating 32nd notes on a held chord)
+// Woodwinds: stepwise descending line D4→C4→B3→A3→G3
+// No brass, no timpani — intimate chamber feel
+```