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-indie-pop/example.html ADDED Viewed

@@ -0,0 +1,121 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <title>TuneFrames — Indie Pop</title>
+  <script src="https://cdnjs.cloudflare.com/ajax/libs/tone/14.8.49/Tone.js"></script>
+</head>
+<body>
+  <!-- TuneFrames Metadata -->
+  <div id="tuneframes" style="display:none">{"bpm":128,"duration":"12s"}</div>
+  <script>
+    async function main() {
+      await Tone.start();
+      Tone.Transport.bpm.value = 128;
+      // --- MASTER BUS ---
+      const masterLimiter = new Tone.Limiter(-1).toDestination();
+      const masterGain = new Tone.Gain(0.85).connect(masterLimiter);
+      // --- GUITAR — jangly pluck through chorus + reverb ---
+      const guitarVerb = new Tone.Reverb({ decay: 2.5, wet: 0.35 }).connect(masterGain);
+      const guitarChorus = new Tone.Chorus({ frequency: 3.5, delayTime: 2, depth: 0.6, wet: 0.5 }).connect(guitarVerb);
+      guitarChorus.start();
+      const guitarGain = new Tone.Gain(0.55).connect(guitarChorus);
+      const guitar = new Tone.PolySynth(Tone.Synth, {
+        oscillator: { type: "triangle" },
+        envelope: { attack: 0.005, decay: 0.28, sustain: 0.06, release: 0.7 },
+        volume: 0
+      }).connect(guitarGain);
+      // --- BASS — warm sine, root movement ---
+      const bassVerb = new Tone.Reverb({ decay: 0.6, wet: 0.1 }).connect(masterGain);
+      const bassGain = new Tone.Gain(0.65).connect(bassVerb);
+      const bass = new Tone.Synth({
+        oscillator: { type: "sine" },
+        envelope: { attack: 0.05, decay: 0.2, sustain: 0.7, release: 0.4 },
+        volume: 0
+      }).connect(bassGain);
+      // --- KICK — punchy but not hard ---
+      const kickDist = new Tone.Distortion({ distortion: 0.1, wet: 0.3 }).connect(masterGain);
+      const kickGain = new Tone.Gain(0.75).connect(kickDist);
+      const kick = new Tone.MembraneSynth({
+        pitchDecay: 0.06,
+        octaves: 5,
+        envelope: { attack: 0.001, decay: 0.3, sustain: 0, release: 0.1 }
+      }).connect(kickGain);
+      // --- SNARE — white noise with moderate reverb ---
+      const snareVerb = new Tone.Reverb({ decay: 0.9, wet: 0.38 }).connect(masterGain);
+      const snareGain = new Tone.Gain(0.45).connect(snareVerb);
+      const snare = new Tone.NoiseSynth({
+        noise: { type: "white" },
+        envelope: { attack: 0.001, decay: 0.15, sustain: 0, release: 0.05 }
+      }).connect(snareGain);
+      // --- HI-HAT — highpass filtered, airy ---
+      const hatFilter = new Tone.Filter(7000, "highpass").connect(masterGain);
+      const hatGain = new Tone.Gain(0.22).connect(hatFilter);
+      const hat = new Tone.NoiseSynth({
+        noise: { type: "white" },
+        envelope: { attack: 0.001, decay: 0.05, sustain: 0, release: 0.01 }
+      }).connect(hatGain);
+      // --- ARPEGGIO — 4-bar G–C–Em–D chord cycle, 8th note grid ---
+      // 8 notes per bar × 4 bars = 32-note grid, loops seamlessly
+      const arpGrid = [
+        // Bar 0: G major
+        "G3","B3","D4","G4","D4","B3","G3","B3",
+        // Bar 1: C major
+        "C4","E4","G4","C5","G4","E4","C4","E4",
+        // Bar 2: E minor
+        "E3","G3","B3","E4","B3","G3","E3","G3",
+        // Bar 3: D major
+        "D3","F#3","A3","D4","A3","F#3","D3","F#3",
+      ];
+      let arpStep = 0;
+      const arpSeq = new Tone.Sequence((time) => {
+        guitar.triggerAttackRelease(arpGrid[arpStep % arpGrid.length], "8n", time);
+        arpStep++;
+      }, new Array(8).fill(1), "8n");
+      arpSeq.start(0);
+      // --- BASS — root + 5th pattern per chord, enters bar 3 ---
+      const bassPart = new Tone.Part((time, note) => {
+        bass.triggerAttackRelease(note, "4n", time);
+      }, [
+        ["0:0:0","G2"], ["0:2:0","D2"],
+        ["1:0:0","C2"], ["1:2:0","G2"],
+        ["2:0:0","E2"], ["2:2:0","B2"],
+        ["3:0:0","D2"], ["3:2:0","A2"],
+      ]);
+      bassPart.loopEnd = "4m";
+      bassPart.loop = true;
+      bassPart.start("2m");
+      // --- KICK — beats 1 and 3, enters bar 3 ---
+      const kickSeq = new Tone.Sequence((time, val) => {
+        if (val) kick.triggerAttackRelease("C1", "8n", time);
+      }, ["C1",null,null,null,null,null,null,null,"C1",null,null,null,null,null,null,null], "16n");
+      kickSeq.start("2m");
+      // --- SNARE — beats 2 and 4, enters bar 3 ---
+      const snareSeq = new Tone.Sequence((time, val) => {
+        if (val) snare.triggerAttackRelease("8n", time);
+      }, [null,null,null,null,1,null,null,null,null,null,null,null,1,null,null,null], "16n");
+      snareSeq.start("2m");
+      // --- HI-HAT — 8th notes throughout ---
+      const hatSeq = new Tone.Sequence((time, val) => {
+        if (val) hat.triggerAttackRelease("16n", time, 0.5);
+      }, [1,null,1,null,1,null,1,null,1,null,1,null,1,null,1,null], "16n");
+      hatSeq.start(0);
+    }
+    main();
+  </script>
+</body>
+</html>

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

@@ -0,0 +1,141 @@
+---
+name: audio-jazz
+description: Jazz — ii-V-I changes, extended chords, walking bass, swing feel, bebop melody
+---
+# TuneFrames — Jazz
+## Genre Profile
+- BPM range: 100–180 (ballad 60–90, bebop 180–240)
+- Key characteristics: ii-V-I progressions, extended/altered chords (maj7, min7, dom7, dim7), swing 8th notes, call-and-response phrasing
+- Typical instruments: Piano (PolySynth), walking upright bass (Synth sine), ride cymbal (MetalSynth), brush snare (NoiseSynth), optional vibraphone
+- Mood: Sophisticated, improvisatory, warm, intellectually alive
+## Core Pattern
+```js
+// Jazz core: 120 BPM swing, Dm7–G7–Cmaj7 (ii-V-I in C major)
+async function main() {
+  await Tone.start();
+  Tone.Transport.bpm.value = 120;
+  const reverb = new Tone.Reverb({ decay: 1.8, wet: 0.3 }).toDestination();
+  // ── Piano voicings (shell voicings: root + 3rd + 7th) ─────────────────
+  const piano = new Tone.PolySynth(Tone.Synth, {
+    oscillator: { type: 'triangle' },
+    envelope: { attack: 0.01, decay: 0.4, sustain: 0.5, release: 1.2 }
+  }).connect(reverb);
+  piano.volume.value = -10;
+  const bar = Tone.Time('1n').toSeconds(); // 1 bar in seconds
+  // ii–V–I–I in C (shell voicings)
+  const changes = [
+    ['D3','F3','C4'],      // Dm7 (ii)
+    ['G3','B3','F4'],      // G7  (V)
+    ['C3','E3','B3'],      // Cmaj7 (I)
+    ['C3','E3','G3','B3'], // Cmaj7 full (I hold)
+  ];
+  changes.forEach((ch, i) => piano.triggerAttackRelease(ch, '1n', i * bar));
+  // ── Walking bass (quarter notes, chromatic approach notes) ────────────
+  const bass = new Tone.Synth({
+    oscillator: { type: 'sine' },
+    envelope: { attack: 0.01, decay: 0.1, sustain: 0.6, release: 0.2 }
+  }).connect(reverb);
+  bass.volume.value = -8;
+  // Classic walking line: D–F–A–C / G–B–D–F / C–E–G–B / C–E–G–C
+  const walk = ['D2','F2','A2','C3','G2','B2','D3','F3','C2','E2','G2','B2','C2','E2','G2','C3'];
+  const q = Tone.Time('4n').toSeconds();
+  walk.forEach((n, i) => bass.triggerAttackRelease(n, '4n', i * q));
+  // ── Ride cymbal (swing pattern: 1–2–ah–3–4–ah) ────────────────────────
+  const ride = new Tone.MetalSynth({
+    frequency: 250, harmonicity: 5.1, modulationIndex: 16,
+    resonance: 4000, octaves: 1.5,
+    envelope: { attack: 0.001, decay: 0.3, release: 0.1 }
+  }).connect(reverb);
+  ride.volume.value = -22;
+  // Swing ride: beats 1, 2 triplet-late, 3, 4 triplet-late
+  const swingOffset = q * 0.67; // triplet-swing "ah"
+  for (let i = 0; i < 4; i++) {
+    ride.triggerAttackRelease('8n', i * bar);
+    ride.triggerAttackRelease('8n', i * bar + swingOffset);
+    ride.triggerAttackRelease('8n', i * bar + q * 2);
+    ride.triggerAttackRelease('8n', i * bar + q * 2 + swingOffset);
+  }
+}
+```
+## Instrument Configuration
+```js
+// Jazz piano — triangle wave (mellow, not harsh), moderate decay
+const piano = new Tone.PolySynth(Tone.Synth, {
+  oscillator: { type: 'triangle' },
+  envelope: { attack: 0.01, decay: 0.4, sustain: 0.5, release: 1.2 }
+});
+// Upright bass feel — pure sine, tight decay, no sustain tail
+const bass = new Tone.Synth({
+  oscillator: { type: 'sine' },
+  envelope: { attack: 0.01, decay: 0.08, sustain: 0.55, release: 0.15 }
+});
+// Ride cymbal — low frequency MetalSynth, long decay
+const ride = new Tone.MetalSynth({
+  frequency: 250, harmonicity: 5.1, modulationIndex: 16,
+  resonance: 4000, octaves: 1.5,
+  envelope: { attack: 0.001, decay: 0.3, release: 0.1 }
+});
+// Brush snare — bandpass-filtered white noise
+const snare = new Tone.NoiseSynth({
+  noise: { type: 'white' },
+  envelope: { attack: 0.005, decay: 0.1, sustain: 0, release: 0.05 }
+});
+const snareFilter = new Tone.Filter(2500, 'bandpass');
+snare.connect(snareFilter);
+// Room reverb — short, warm
+const reverb = new Tone.Reverb({ decay: 1.8, wet: 0.3 }).toDestination();
+```
+## Composition Structure
+1. **Head in (0–4s):** Piano states the changes, bass walks, ride establishes swing
+2. **Melody chorus (4–8s):** Bebop-style single-note melody over the changes (arpeggiated +chromatic passing tones)
+3. **Reharmonization (8–12s):** Tritone sub on the V chord (Db7 instead of G7), piano plays richer voicings
+4. **Tag / turnaround:** Quick ii-V back to the top, ritardando on the final bar
+## Example Variations
+### 1 — Tritone substitution on V (G7 → Db7)
+```js
+// Replace G7 shell with Db7 shell (tritone sub)
+const changes = [
+  ['D3','F3','C4'],    // Dm7
+  ['Db3','F3','B3'],   // Db7 (tritone sub for G7)
+  ['C3','E3','B3'],    // Cmaj7
+];
+```
+### 2 — Ballad tempo (70 BPM) with rubato melody
+```js
+Tone.Transport.bpm.value = 70;
+// Hold each chord for 2 bars, melody uses longer note values ('2n', '1n')
+```
+### 3 — Vibraphone color (add shimmer on the I chord)
+```js
+const vibe = new Tone.PolySynth(Tone.Synth, {
+  oscillator: { type: 'sine' },
+  envelope: { attack: 0.005, decay: 1.5, sustain: 0.2, release: 2.0 }
+});
+const vibeVib = new Tone.Vibrato({ frequency: 5, depth: 0.05 }).connect(reverb);
+vibe.connect(vibeVib);
+vibe.triggerAttackRelease(['C4','E4','G4','B4'], '2n', barStart);
+```

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

@@ -0,0 +1,146 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>TuneFrames — Jazz</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":132,"duration":"12s"}</div>
+  <script>
+    async function main() {
+      await Tone.start();
+      Tone.Transport.bpm.value = 132;
+      // ── Effects ─────────────────────────────────────────────────────────
+      const reverb = new Tone.Reverb({ decay: 1.6, preDelay: 0.01, wet: 0.28 }).toDestination();
+      await reverb.ready;
+      // ── Piano — shell voicings (3rd + 7th on top) ───────────────────────
+      const piano = new Tone.PolySynth(Tone.Synth, {
+        oscillator: { type: 'triangle' },
+        envelope: { attack: 0.008, decay: 0.35, sustain: 0.5, release: 1.4 }
+      }).connect(reverb);
+      piano.volume.value = -10;
+      const bar = Tone.Time('1n').toSeconds();
+      const q   = Tone.Time('4n').toSeconds();
+      // ii–V–I–vi turnaround in C major (2 full passes = 8 bars)
+      // Bar layout: Dm7 | G7 | Cmaj7 | Am7 | repeat
+      const changes = [
+        { chord: ['D3','F3','C4'],       dur: '1n' }, // Dm7
+        { chord: ['G2','B2','F3'],       dur: '1n' }, // G7
+        { chord: ['C3','E3','B3'],       dur: '1n' }, // Cmaj7
+        { chord: ['A2','C3','G3','E4'],  dur: '1n' }, // Am7
+        { chord: ['D3','F3','C4'],       dur: '1n' }, // Dm7 (repeat)
+        { chord: ['Db3','F3','B3'],      dur: '1n' }, // Db7 (tritone sub)
+        { chord: ['C3','E3','B3','G4'],  dur: '2n' }, // Cmaj7
+        { chord: ['G2','B2','F3'],       dur: '2n' }, // G7 (turnaround)
+      ];
+      let t = 0;
+      changes.forEach(({ chord, dur }) => {
+        piano.triggerAttackRelease(chord, dur, t);
+        t += Tone.Time(dur).toSeconds();
+      });
+      // ── Walking bass ────────────────────────────────────────────────────
+      const bass = new Tone.Synth({
+        oscillator: { type: 'sine' },
+        envelope: { attack: 0.008, decay: 0.09, sustain: 0.55, release: 0.15 }
+      }).connect(reverb);
+      bass.volume.value = -6;
+      // 8-bar walking line (one note per beat = 32 quarter notes)
+      const walkLine = [
+        // Bar 1 Dm7
+        'D2','F2','A2','C3',
+        // Bar 2 G7
+        'G2','B2','D3','F3',
+        // Bar 3 Cmaj7
+        'C3','E2','G2','B2',
+        // Bar 4 Am7
+        'A2','C3','E3','G2',
+        // Bar 5 Dm7 (chromatic approach)
+        'D2','Eb2','E2','F2',
+        // Bar 6 Db7 (tritone)
+        'Db3','Ab2','F2','Eb2',
+        // Bar 7 Cmaj7
+        'C2','G2','E2','B2',
+        // Bar 8 G7
+        'G2','Ab2','A2','B2',
+      ];
+      walkLine.forEach((n, i) => bass.triggerAttackRelease(n, '4n', i * q));
+      // ── Ride cymbal (jazz swing pattern) ────────────────────────────────
+      const ride = new Tone.MetalSynth({
+        frequency: 240, harmonicity: 5.1, modulationIndex: 16,
+        resonance: 4000, octaves: 1.5,
+        envelope: { attack: 0.001, decay: 0.28, release: 0.08 }
+      }).connect(reverb);
+      ride.volume.value = -22;
+      // Swing triplet feel: beat 1, beat 2-and (triplet late), beat 3, beat 4-and
+      const swingLate = q * 0.67;
+      for (let b = 0; b < 8; b++) {
+        const base = b * bar;
+        ride.triggerAttackRelease('8n', base);
+        ride.triggerAttackRelease('8n', base + swingLate);
+        ride.triggerAttackRelease('8n', base + q * 2);
+        ride.triggerAttackRelease('8n', base + q * 2 + swingLate);
+      }
+      // ── Brush snare on 2 and 4 ──────────────────────────────────────────
+      const snareBp = new Tone.Filter(2800, 'bandpass').connect(reverb);
+      const snare   = new Tone.NoiseSynth({
+        noise: { type: 'white' },
+        envelope: { attack: 0.004, decay: 0.09, sustain: 0, release: 0.04 }
+      }).connect(snareBp);
+      snare.volume.value = -26;
+      for (let b = 0; b < 8; b++) {
+        snare.triggerAttackRelease('8n', b * bar + q);       // beat 2
+        snare.triggerAttackRelease('8n', b * bar + q * 3);   // beat 4
+      }
+      // ── Bebop melody (enters bar 3) ─────────────────────────────────────
+      const melody = new Tone.Synth({
+        oscillator: { type: 'triangle' },
+        envelope: { attack: 0.005, decay: 0.15, sustain: 0.4, release: 0.5 }
+      }).connect(reverb);
+      melody.volume.value = -12;
+      // Classic bebop phrase: arpeggiated chords + chromatic passing tones
+      const phrase = [
+        // Over Cmaj7 (bar 3)
+        { note: 'G4',  time: bar * 2,             dur: '8n' },
+        { note: 'E4',  time: bar * 2 + q * 0.5,  dur: '8n' },
+        { note: 'C5',  time: bar * 2 + q,         dur: '8n' },
+        { note: 'B4',  time: bar * 2 + q * 1.5,  dur: '8n' },
+        { note: 'A4',  time: bar * 2 + q * 2,     dur: '8n' },
+        { note: 'G4',  time: bar * 2 + q * 2.5,  dur: '8n' },
+        { note: 'F4',  time: bar * 2 + q * 3,     dur: '4n' },
+        // Over Am7 (bar 4)
+        { note: 'E4',  time: bar * 3 + q * 0.5,  dur: '8n' },
+        { note: 'C5',  time: bar * 3 + q,         dur: '8n' },
+        { note: 'B4',  time: bar * 3 + q * 1.5,  dur: '8n' },
+        { note: 'A4',  time: bar * 3 + q * 2,     dur: '4n' },
+        { note: 'G4',  time: bar * 3 + q * 3,     dur: '4n' },
+        // Over Dm7 again (bar 5)
+        { note: 'D5',  time: bar * 4,             dur: '8n' },
+        { note: 'C5',  time: bar * 4 + q * 0.5,  dur: '8n' },
+        { note: 'A4',  time: bar * 4 + q,         dur: '8n' },
+        { note: 'F4',  time: bar * 4 + q * 1.5,  dur: '8n' },
+        { note: 'E4',  time: bar * 4 + q * 2,     dur: '4n' },
+        { note: 'Eb4', time: bar * 4 + q * 3,     dur: '8n' }, // chromatic
+        { note: 'D4',  time: bar * 4 + q * 3.5,  dur: '8n' },
+        // Over Db7 (bar 6) — altered sound
+        { note: 'Ab4', time: bar * 5,             dur: '8n' },
+        { note: 'F4',  time: bar * 5 + q * 0.5,  dur: '8n' },
+        { note: 'Db4', time: bar * 5 + q,         dur: '4n' },
+        { note: 'C4',  time: bar * 5 + q * 2,     dur: '2n' }, // resolve to C
+      ];
+      phrase.forEach(({ note, time, dur }) => melody.triggerAttackRelease(note, dur, time));
+    }
+  </script>
+</body>
+</html>

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

@@ -0,0 +1,140 @@
+---
+name: audio-lofi
+description: Lo-fi Hip Hop — dusty jazzy chords, soft keys, muffled drums, chill study vibe
+---
+# TuneFrames — Lo-fi Hip Hop
+## Genre Profile
+- BPM range: 70–90
+- Key characteristics: Jazz-adjacent chord progressions (Am–F–C–G or ii–V–I extensions), swung/lazy 8th-note feel, heavy reverb + slight LP filter on everything, vinyl warmth
+- Typical instruments: Rhodes/electric piano (PolySynth triangle/sine), soft bass (Synth), MembraneSynth kick filtered low, closed hi-hat (MetalSynth), pad layer
+- Mood: Nostalgic, cozy, introspective, study-focus
+## Core Pattern
+```js
+// Lo-fi core: 80 BPM, Am–F–C–G, 4 chords × 2 beats each
+async function main() {
+  await Tone.start();
+  Tone.Transport.bpm.value = 80;
+  // ── Effects chain (everything runs warm and muffled) ──────────────────
+  const reverb  = new Tone.Reverb({ decay: 3.5, wet: 0.55 }).toDestination();
+  const lpFilter = new Tone.Filter(1800, 'lowpass').connect(reverb);
+  // Optional: slight tape distortion
+  const warm    = new Tone.Distortion(0.04).connect(lpFilter);
+  // ── Rhodes-style chords ───────────────────────────────────────────────
+  const keys = new Tone.PolySynth(Tone.Synth, {
+    oscillator: { type: 'triangle' },
+    envelope: { attack: 0.04, decay: 0.3, sustain: 0.7, release: 1.8 }
+  }).connect(warm);
+  keys.volume.value = -10;
+  // ii–V–I–VI in A minor
+  const chords = [
+    ['A3','C4','E4'],   // Am
+    ['F3','A3','C4'],   // F maj
+    ['C3','E3','G3'],   // C maj
+    ['G3','B3','D4'],   // G maj
+  ];
+  const step = Tone.Time('2n').toSeconds(); // 2 beats each chord
+  chords.forEach((ch, i) => keys.triggerAttackRelease(ch, '2n', i * step));
+  // ── Walking bass ──────────────────────────────────────────────────────
+  const bass = new Tone.Synth({
+    oscillator: { type: 'sine' },
+    envelope: { attack: 0.02, decay: 0.1, sustain: 0.5, release: 0.4 }
+  }).connect(lpFilter);
+  bass.volume.value = -8;
+  const bassNotes = ['A2', 'F2', 'C2', 'G2'];
+  bassNotes.forEach((n, i) => bass.triggerAttackRelease(n, '4n', i * step));
+  // ── Muffled kick (MembraneSynth + deep LP) ────────────────────────────
+  const kickFilter = 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(kickFilter);
+  kick.volume.value = -14;
+  // Kick on beats 1 and 3 (seconds at 80 BPM: beat = 0.75s)
+  const beat = 60 / 80;
+  [0, beat * 2, beat * 4, beat * 6].forEach(t => kick.triggerAttackRelease('C1', '8n', t));
+  // ── Soft hi-hat ───────────────────────────────────────────────────────
+  const hat = new Tone.MetalSynth({
+    frequency: 400, envelope: { attack: 0.001, decay: 0.08, release: 0.01 },
+    harmonicity: 5.1, modulationIndex: 32, resonance: 4000, octaves: 1.5
+  }).connect(reverb);
+  hat.volume.value = -24;
+  for (let i = 0; i < 8; i++) {
+    hat.triggerAttackRelease('8n', i * beat * 0.5);
+  }
+}
+```
+## Instrument Configuration
+```js
+// Rhodes feel — triangle oscillator, slow attack, long release
+const keys = new Tone.PolySynth(Tone.Synth, {
+  oscillator: { type: 'triangle' },
+  envelope: { attack: 0.04, decay: 0.3, sustain: 0.7, release: 1.8 }
+});
+// Tape warmth — very light distortion before the LP filter
+const tape = new Tone.Distortion(0.04);
+const lp   = new Tone.Filter(1800, 'lowpass');  // cuts harsh highs
+// Lush room reverb
+const reverb = new Tone.Reverb({ decay: 3.5, preDelay: 0.01, wet: 0.55 });
+// Chain: keys → tape → lp → reverb → destination
+keys.connect(tape); tape.connect(lp); lp.connect(reverb); reverb.toDestination();
+// Muffled kick — very tight low-pass (200 Hz)
+const kickLp = new Tone.Filter(200, 'lowpass').toDestination();
+const kick   = new Tone.MembraneSynth({ pitchDecay: 0.05, octaves: 5 }).connect(kickLp);
+// Airy hat — kept very quiet, short decay
+const hat = new Tone.MetalSynth({ frequency: 400, envelope: { decay: 0.08 } });
+hat.volume.value = -24;
+hat.connect(reverb);
+```
+## Composition Structure
+1. **Intro (0–2s):** Keys enter alone with chord 1, bass follows on beat 2
+2. **Main loop (2–8s):** Full Am–F–C–G cycle, kick on 1+3, hat 8ths, bass walks roots
+3. **Variation (8–10s):** Add a simple melody fragment (C5–E5–G5–A5) over the progression
+4. **Outro:** Let chords ring out with long release, hat fades (volume ramp)
+## Example Variations
+### 1 — Jazzier chord voicings (7ths)
+```js
+const chords = [
+  ['A3','C4','E4','G4'],  // Am7
+  ['F3','A3','C4','E4'],  // Fmaj7
+  ['C3','E3','G3','B3'],  // Cmaj7
+  ['G3','B3','D4','F4'],  // G7
+];
+```
+### 2 — Slower, dreamier (70 BPM + delay)
+```js
+Tone.Transport.bpm.value = 70;
+const delay = new Tone.FeedbackDelay('8n.', 0.3).connect(reverb);
+keys.connect(delay); // dotted-8th echo
+```
+### 3 — Add a simple vinyl-crackle effect (noise burst)
+```js
+const noise = new Tone.Noise('pink').connect(new Tone.Filter(600, 'lowpass').toDestination());
+noise.volume.value = -40;
+noise.start(0).stop('+10');
+```