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

tuneframes 0.1.0 → 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 (78) hide show

package/LICENSE +167 -199
package/README.md +150 -97
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 +48 -0
package/examples/example-lofi.html +45 -45
package/examples/example-lofi.mp3 +0 -0
package/examples/example-minimal.html +21 -19
package/examples/example-minimal.mp3 +0 -0
package/examples/example-orchestral.html +67 -67
package/examples/example-orchestral.mp3 +0 -0
package/examples/example-piano.html +53 -0
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 -24
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 +261 -89
package/src/render.js +134 -7

package/registry/presets/drums-808.html ADDED Viewed

@@ -0,0 +1,85 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <script src="https://cdnjs.cloudflare.com/ajax/libs/tone/14.8.49/Tone.js"></script>
+</head>
+<body>
+  <!-- Classic trap 808 pattern — synthesis only, no CDN required -->
+  <!-- 2 bars at 140 BPM: 1 bar = 4 beats × (60/140)s ≈ 1.714s → 2 bars ≈ 3.43s -->
+  <div id="tuneframes" style="display:none">{"bpm":140,"duration":"7s"}</div>
+  <script>
+    async function main() {
+      await Tone.start();
+      // --- 808 Kick: pitched MembraneSynth with long pitch fall ---
+      const kick808 = new Tone.MembraneSynth({
+        pitchDecay:  0.5,
+        octaves:     8,
+        envelope: { attack: 0.001, decay: 0.8, sustain: 0, release: 0.4 }
+      }).toDestination();
+      kick808.volume.value = 2;
+      // --- Snare: layered noise (body) + click (transient) ---
+      const snareNoise = new Tone.NoiseSynth({
+        noise: { type: 'white' },
+        envelope: { attack: 0.001, decay: 0.18, sustain: 0, release: 0.05 }
+      });
+      const snareFilter = new Tone.Filter({ frequency: 3500, type: 'highpass' }).toDestination();
+      snareNoise.connect(snareFilter);
+      snareNoise.volume.value = -4;
+      // --- Hi-hat: MetalSynth for crisp metallic transient ---
+      const hihat = new Tone.MetalSynth({
+        frequency:   400,
+        envelope:    { attack: 0.001, decay: 0.04, release: 0.01 },
+        harmonicity: 5.1,
+        modulationIndex: 32,
+        resonance:   4000,
+        octaves:     1.5
+      }).toDestination();
+      hihat.volume.value = -10;
+      // Open hi-hat: longer decay
+      const openHat = new Tone.MetalSynth({
+        frequency:   500,
+        envelope:    { attack: 0.001, decay: 0.3, release: 0.1 },
+        harmonicity: 5.1,
+        modulationIndex: 32,
+        resonance:   4000,
+        octaves:     1.5
+      }).toDestination();
+      openHat.volume.value = -14;
+      const beat = Tone.Time('4n').toSeconds(); // one beat in seconds at 140 BPM
+      const bar  = beat * 4;
+      // Render 2 bars of trap pattern
+      for (let b = 0; b < 2; b++) {
+        const o = b * bar;
+        // --- 808 kick: beats 1, 2.5, 3 (classic trap syncopation) ---
+        kick808.triggerAttackRelease('C1', '8n', o);
+        kick808.triggerAttackRelease('C1', '8n', o + beat * 1.5);
+        kick808.triggerAttackRelease('C1', '8n', o + beat * 2);
+        // --- Snare: beat 3 (half-time feel) ---
+        snareNoise.triggerAttackRelease('8n', o + beat * 2);
+        // --- Hi-hats: 16th notes throughout, open hat on beat 3-and ---
+        const sixteenth = beat / 4;
+        for (let s = 0; s < 16; s++) {
+          // Skip the snare slot (beat 3) on closed hats so open hat rings
+          if (s === 8) {
+            openHat.triggerAttackRelease('C5', '8n', o + s * sixteenth);
+          } else {
+            // Accent downbeats slightly
+            const vel = (s % 4 === 0) ? 1.0 : (s % 2 === 0 ? 0.6 : 0.35);
+            hihat.volume.value = -10 + (vel - 1) * 4;
+            hihat.triggerAttackRelease('C5', '32n', o + s * sixteenth);
+          }
+        }
+      }
+    }
+  </script>
+</body>
+</html>

package/registry/presets/drums-lofi.html ADDED Viewed

@@ -0,0 +1,35 @@
+<!-- TuneFrames preset: drums-lofi
+     Kick + snare + hi-hat loop. Paste inside <script> in your composition. -->
+<script>
+  const beat = Tone.Time('4n').toSeconds();
+  const kick = new Tone.MembraneSynth({
+    pitchDecay: 0.05, octaves: 6,
+    oscillator: { type: 'sine' },
+    envelope: { attack: 0.001, decay: 0.4, sustain: 0, release: 0.1 }
+  }).toDestination();
+  const snare = new Tone.NoiseSynth({
+    noise: { type: 'white' },
+    envelope: { attack: 0.001, decay: 0.2, sustain: 0, release: 0.1 }
+  }).toDestination();
+  const hihat = new Tone.NoiseSynth({
+    noise: { type: 'white' },
+    envelope: { attack: 0.001, decay: 0.04, sustain: 0, release: 0.01 }
+  }).toDestination();
+  hihat.volume.value = -14;
+  // Kick on 1, 2, 3, 4
+  for (let i = 0; i < 4; i++) {
+    kick.triggerAttackRelease('C1', '4n', i * beat);
+  }
+  // Snare on 2 and 4
+  [1, 3].forEach(i => snare.triggerAttackRelease('C3', '4n', i * beat));
+  // Hi-hat on every 8th note
+  for (let i = 0; i < 8; i++) {
+    hihat.triggerAttackRelease('16n', i * beat * 0.5);
+  }
+</script>

package/registry/presets/lead-piano.html ADDED Viewed

@@ -0,0 +1,26 @@
+<!-- TuneFrames preset: lead-piano
+     Simple 8-bar piano melody. Paste inside <script>. -->
+<script>
+  const beat = Tone.Time('4n').toSeconds();
+  const piano = new Tone.PolySynth(Tone.Synth, {
+    oscillator: { type: 'triangle' },
+    envelope: { attack: 0.005, decay: 0.3, sustain: 0.4, release: 0.8 }
+  }).toDestination();
+  piano.volume.value = -8;
+  const melody = [
+    { note: 'C5', time: 0 },
+    { note: 'E5', time: 1 },
+    { note: 'G5', time: 2 },
+    { note: 'E5', time: 3 },
+    { note: 'D5', time: 4 },
+    { note: 'F5', time: 5 },
+    { note: 'A5', time: 6 },
+    { note: 'F5', time: 7 },
+  ];
+  melody.forEach(({ note, time }) => {
+    piano.triggerAttackRelease(note, '4n', time * beat);
+  });
+</script>

package/registry/presets/piano-salamander.html ADDED Viewed

@@ -0,0 +1,69 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <script src="https://cdnjs.cloudflare.com/ajax/libs/tone/14.8.49/Tone.js"></script>
+</head>
+<body>
+  <!-- Am - F - C - G chord progression, 4 chords × 2s = 8s -->
+  <div id="tuneframes" style="display:none">{"bpm":120,"duration":"9s"}</div>
+  <script>
+    async function main() {
+      await Tone.start();
+      // Load acoustic grand piano samples from gleitz FluidR3_GM CDN
+      const piano = new Tone.Sampler({
+        urls: {
+          A0:  'A0.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',
+          A6:  'A6.mp3',
+          C7:  'C7.mp3',
+          C8:  'C8.mp3'
+        },
+        baseUrl: 'https://gleitz.github.io/midi-js-soundfonts/FluidR3_GM/acoustic_grand_piano-mp3/'
+      });
+      // Light reverb for hall ambience
+      const reverb = new Tone.Reverb({ decay: 2.5, wet: 0.25 }).toDestination();
+      piano.connect(reverb);
+      // CRITICAL: wait for all samples to load before scheduling any notes
+      await Tone.loaded();
+      // Am - F - C - G, 2 seconds each, 8 seconds total
+      // Voicings are close-position triads with a bass note for warmth
+      const chords = [
+        { notes: ['A2', 'E3', 'A3', 'C4', 'E4'], label: 'Am' },
+        { notes: ['F2', 'C3', 'F3', 'A3', 'C4'], label: 'F'  },
+        { notes: ['C3', 'G3', 'C4', 'E4', 'G4'], label: 'C'  },
+        { notes: ['G2', 'D3', 'G3', 'B3', 'D4'], label: 'G'  }
+      ];
+      const chordDuration = 2; // seconds per chord
+      const noteDuration  = '1n'; // sustain each chord for a whole note
+      chords.forEach((chord, i) => {
+        const t = i * chordDuration;
+        // Arpeggiate the bass note very slightly ahead of the chord for a natural feel
+        piano.triggerAttackRelease(chord.notes[0], noteDuration, t);
+        piano.triggerAttackRelease(chord.notes.slice(1), noteDuration, t + 0.04);
+      });
+    }
+  </script>
+</body>
+</html>

package/registry/presets/reverb-warm.html ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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
+```