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/skills/audio-funk/example.html ADDED Viewed

@@ -0,0 +1,144 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>TuneFrames — Funk</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":104,"duration":"12s"}</div>
+  <script>
+    async function main() {
+      await Tone.start();
+      Tone.Transport.bpm.value = 104;
+      const s16 = Tone.Time('16n').toSeconds(); // ~0.144s
+      const q   = Tone.Time('4n').toSeconds();  // ~0.577s
+      const bar = Tone.Time('1n').toSeconds();  // ~2.308s
+      // ── Bus compressor (the funk glue) ──────────────────────────────────
+      const comp = new Tone.Compressor({ threshold: -16, ratio: 4, attack: 0.003, release: 0.12 }).toDestination();
+      const room = new Tone.Reverb({ decay: 0.6, wet: 0.12 }).connect(comp);
+      // ── Slap bass ───────────────────────────────────────────────────────
+      const bassFilter = new Tone.Filter(800, 'lowpass').connect(comp);
+      const bass = new Tone.Synth({
+        oscillator: { type: 'square' },
+        envelope: { attack: 0.001, decay: 0.09, sustain: 0.0, release: 0.04 }
+      }).connect(bassFilter);
+      bass.volume.value = -4;
+      // One-bar groove in E — repeated 5 times
+      const bassPattern = [
+        { note: 'E2',  t: 0      },
+        { note: 'E2',  t: s16*2  },
+        { note: 'G2',  t: s16*3  },
+        { note: 'E2',  t: s16*4  },
+        { note: 'A2',  t: s16*6  },
+        { note: 'E2',  t: s16*8  },
+        { note: 'D2',  t: s16*10 },
+        { note: 'E2',  t: s16*12 },
+        { note: 'Gb2', t: s16*14 },
+      ];
+      for (let rep = 0; rep < 5; rep++) {
+        bassPattern.forEach(({ note, t }) => bass.triggerAttackRelease(note, '16n', rep * bar + t));
+      }
+      // ── Rhythm guitar chank (bandpass, hits on upbeats) ─────────────────
+      const guitFilter = new Tone.Filter(2200, 'bandpass').connect(room);
+      const guitar = new Tone.PolySynth(Tone.Synth, {
+        oscillator: { type: 'triangle' },
+        envelope: { attack: 0.003, decay: 0.1, sustain: 0.0, release: 0.06 }
+      }).connect(guitFilter);
+      guitar.volume.value = -14;
+      // Chank on "and" of 2 (s16*9) and "and" of 4 (s16*13) — classic funk chop
+      const chankTimes = [s16 * 9, s16 * 13];
+      for (let rep = 0; rep < 5; rep++) {
+        chankTimes.forEach(t => {
+          guitar.triggerAttackRelease(['E4','G4','B4'], '16n', rep * bar + t);
+        });
+      }
+      // ── Brass stabs (upbeat, punchy) ────────────────────────────────────
+      const brassFilter = new Tone.Filter(4000, 'lowpass').connect(room);
+      const brass = new Tone.PolySynth(Tone.Synth, {
+        oscillator: { type: 'sawtooth' },
+        envelope: { attack: 0.006, decay: 0.13, sustain: 0.0, release: 0.07 }
+      }).connect(brassFilter);
+      brass.volume.value = -10;
+      // Stabs enter on bar 2 — same upbeat timing as guitar chank
+      for (let rep = 1; rep < 5; rep++) {
+        [s16 * 9, s16 * 13].forEach(t => {
+          brass.triggerAttackRelease(['E4','G4','B4'], '16n', rep * bar + t);
+          // Second stab chord a beat later for call-and-response
+          brass.triggerAttackRelease(['D4','F4','A4'], '16n', rep * bar + t + s16 * 2);
+        });
+      }
+      // ── Kick drum ───────────────────────────────────────────────────────
+      const kick = new Tone.MembraneSynth({
+        pitchDecay: 0.04, octaves: 6,
+        envelope: { attack: 0.001, decay: 0.22, sustain: 0, release: 0.08 }
+      }).connect(comp);
+      kick.volume.value = -8;
+      // Kick pattern: beat 1, then syncopated 16th before beat 3 and on the "a" of 3
+      for (let rep = 0; rep < 5; rep++) {
+        kick.triggerAttackRelease('C1', '8n', rep * bar);           // beat 1
+        kick.triggerAttackRelease('C1', '8n', rep * bar + s16 * 7); // "and-a" of 2
+        kick.triggerAttackRelease('C1', '8n', rep * bar + s16 * 10); // "and" of 3
+      }
+      // ── Snare on 2 and 4 (with ghost notes) ────────────────────────────
+      const snareBp  = new Tone.Filter(3200, 'bandpass').connect(room);
+      const snare    = new Tone.NoiseSynth({
+        noise: { type: 'white' },
+        envelope: { attack: 0.001, decay: 0.11, sustain: 0, release: 0.04 }
+      }).connect(snareBp);
+      snare.volume.value = -12;
+      const ghostSnare = new Tone.NoiseSynth({
+        noise: { type: 'white' },
+        envelope: { attack: 0.001, decay: 0.05, sustain: 0, release: 0.02 }
+      }).connect(snareBp);
+      ghostSnare.volume.value = -26; // quiet ghosts
+      for (let rep = 0; rep < 5; rep++) {
+        snare.triggerAttackRelease('8n', rep * bar + q);         // beat 2
+        snare.triggerAttackRelease('8n', rep * bar + q * 3);     // beat 4
+        // Ghost notes around beat 3
+        ghostSnare.triggerAttackRelease('16n', rep * bar + s16 * 9);
+        ghostSnare.triggerAttackRelease('16n', rep * bar + s16 * 11);
+      }
+      // ── 16th hi-hats ───────────────────────────────────────────────────
+      const hat = new Tone.MetalSynth({
+        frequency: 600, harmonicity: 5.1, modulationIndex: 32,
+        resonance: 4000, octaves: 1.5,
+        envelope: { attack: 0.001, decay: 0.028, release: 0.008 }
+      }).connect(comp);
+      hat.volume.value = -19;
+      // Full 16th grid, slight accent on quarter notes
+      for (let rep = 0; rep < 5; rep++) {
+        for (let i = 0; i < 16; i++) {
+          hat.triggerAttackRelease('32n', rep * bar + i * s16);
+        }
+      }
+      // ── Open hi-hat accent on beat 4 of every other bar ────────────────
+      const openHat = new Tone.MetalSynth({
+        frequency: 400, harmonicity: 3.1, modulationIndex: 12,
+        resonance: 2000, octaves: 1.0,
+        envelope: { attack: 0.001, decay: 0.22, release: 0.08 }
+      }).connect(room);
+      openHat.volume.value = -18;
+      for (let rep = 1; rep < 5; rep += 2) {
+        openHat.triggerAttackRelease('8n', rep * bar + q * 3);
+      }
+    }
+  </script>
+</body>
+</html>

package/skills/audio-future-bass/SKILL.md ADDED Viewed

@@ -0,0 +1,163 @@
+---
+name: audio-future-bass
+description: Future Bass — wide supersaw chords (fatsawtooth PolySynth), emotional melodic lead, pitched 808 sub, trap-influenced drums, massive chorus/reverb. Flume / San Holo energy. Big, emotional, wide stereo field.
+---
+# TuneFrames — Future Bass
+## Genre Profile
+- BPM range: 140–160 (half-time groove feel, effective "heard" tempo closer to 70–80)
+- Key characteristics: Supersaw chords (fatsawtooth oscillator, 5–7 unison voices, 30–50 spread), emotional minor-key melody, 808 sub bass (MembraneSynth with long pitchDecay), trap-influenced sparse kick, massive clap with reverb, hi-hat rolls with velocity variation, heavy chorus and reverb on chords
+- Typical instruments: PolySynth/Synth fatsawtooth (supersaw chords), Synth/AMSynth (lead), MembraneSynth (808 + kick), NoiseSynth (clap), MetalSynth (hi-hats)
+- Mood: Euphoric, emotional, uplifting, wide, festival-ready
+## Core Pattern
+```js
+// Future Bass — 150 BPM, A minor
+// Structure: intro (bars 1–2) → drop (bar 3 onward)
+// Chords: Am – F – C – G (1 bar each, looping)
+// 808 sub follows chord roots with pitch glide
+// Half-time drums: sparse kick, big clap on beat 3
+Tone.Transport.bpm.value = 150;
+// Supersaw chord synth — fatsawtooth is the key ingredient
+const chordVerb = new Tone.Reverb({ decay: 4, wet: 0.55 }).toDestination();
+const chordChorus = new Tone.Chorus({ frequency: 0.8, delayTime: 3.5, depth: 0.8, wet: 0.7 }).connect(chordVerb);
+chordChorus.start();
+const chords = new Tone.PolySynth(Tone.Synth, {
+  oscillator: { type: "fatsawtooth", count: 5, spread: 40 },
+  envelope: { attack: 0.08, decay: 0.2, sustain: 0.75, release: 2.0 },
+  volume: -10
+}).connect(chordChorus);
+// 808 sub — MembraneSynth with long pitch glide
+const sub808Dist = new Tone.Distortion({ distortion: 0.1, wet: 0.25 }).toDestination();
+const sub808 = new Tone.MembraneSynth({
+  pitchDecay: 0.45,   // the "808 fall" — pitch glides from note down
+  octaves: 3,
+  envelope: { attack: 0.001, decay: 0.85, sustain: 0, release: 0.4 }
+}).connect(sub808Dist);
+// Schedule supersaw chords at the drop (bar 3+)
+// One-bar chord stabs with full sustain
+const dropChords = [
+  { time: "2m", notes: ["A2","E3","A3","C4","E4"] },   // Am
+  { time: "3m", notes: ["F2","C3","F3","A3","C4"] },   // F
+  { time: "4m", notes: ["C3","G3","C4","E4","G4"] },   // C
+  { time: "5m", notes: ["G2","D3","G3","B3","D4"] },   // G
+];
+dropChords.forEach(({ time, notes }) => {
+  chords.triggerAttackRelease(notes, "1m", time);
+});
+// 808 bass hits on chord roots — enters with drop
+const subHits = [
+  { time: "2m", note: "A2" }, { time: "3m", note: "F2" },
+  { time: "4m", note: "C2" }, { time: "5m", note: "G2" },
+];
+subHits.forEach(({ time, note }) => {
+  sub808.triggerAttackRelease(note, "2n", time);
+});
+Tone.Transport.start();
+```
+## Instrument Configuration
+```js
+// Supersaw chords — fatsawtooth + wide chorus is the defining sound
+const chordVerb = new Tone.Reverb({ decay: 4.0, wet: 0.55 }).toDestination();
+const chordChorus = new Tone.Chorus({ frequency: 0.8, delayTime: 3.5, depth: 0.8, wet: 0.7 });
+chordChorus.connect(chordVerb);
+chordChorus.start();
+const chords = new Tone.PolySynth(Tone.Synth, {
+  oscillator: { type: "fatsawtooth", count: 5, spread: 40 },
+  envelope: { attack: 0.08, decay: 0.2, sustain: 0.75, release: 2.0 },
+  volume: -10
+}).connect(chordChorus);
+// Lead melody — bright, emotional
+const leadVerb = new Tone.Reverb({ decay: 2.5, wet: 0.4 }).toDestination();
+const leadDelay = new Tone.FeedbackDelay({ delayTime: "8n", feedback: 0.3, wet: 0.25 }).connect(leadVerb);
+const lead = new Tone.Synth({
+  oscillator: { type: "triangle" },
+  envelope: { attack: 0.02, decay: 0.3, sustain: 0.6, release: 1.0 },
+  volume: -6
+}).connect(leadDelay);
+// 808 sub — long pitch decay = the glide
+const sub808Dist = new Tone.Distortion({ distortion: 0.1, wet: 0.25 }).toDestination();
+const sub808 = new Tone.MembraneSynth({
+  pitchDecay: 0.45,
+  octaves: 3,
+  envelope: { attack: 0.001, decay: 0.85, sustain: 0, release: 0.4 },
+  volume: 2
+}).connect(sub808Dist);
+// Trap kick — on beat 1 (half-time feel)
+const kick = new Tone.MembraneSynth({
+  pitchDecay: 0.08, octaves: 8,
+  envelope: { attack: 0.001, decay: 0.35, sustain: 0, release: 0.1 },
+  volume: 0
+}).toDestination();
+// Clap — big noise transient with long reverb
+const clapVerb = new Tone.Reverb({ decay: 2.8, wet: 0.55 }).toDestination();
+const clap = new Tone.NoiseSynth({
+  noise: { type: "white" },
+  envelope: { attack: 0.001, decay: 0.18, sustain: 0, release: 0.08 },
+  volume: -4
+}).connect(clapVerb);
+// Hi-hat — trap roll with velocity variation
+const hat = new Tone.MetalSynth({
+  frequency: 600, harmonicity: 5.1, modulationIndex: 32,
+  resonance: 4500, octaves: 1.5,
+  envelope: { attack: 0.001, decay: 0.03, release: 0.01 },
+  volume: -12
+}).toDestination();
+```
+## Composition Structure
+- **Intro (bars 1–2):** Lead melody only with light hi-hats — emotional hook, no chords yet
+- **Build (end of bar 2):** Riser noise (NoiseSynth with rising filter) creates anticipation
+- **Drop (bar 3):** Supersaw chords crash in simultaneously with kick, clap, and 808 sub
+- **Drop loop:** Am–F–C–G chord cycle (1 bar each), 808 follows roots, hats roll
+- **Variation:** Add pitch bend on lead (modulate `lead.detune.value` ±50 cents over 1 bar)
+- **Breakdown:** Mute drums, let chords ring with reverb tail — rebuild tension
+- **Second drop:** Higher register chord voicing, lead octave up
+Emotional tension technique: during the bar before the drop, cut all sound (or just leave a white noise riser), then everything hits at once — maximum impact.
+## Example Variations
+### 1 — Wider supersaw (more voices)
+```js
+// More unison voices = fatter, more expensive but more enormous
+const chords = new Tone.PolySynth(Tone.Synth, {
+  oscillator: { type: "fatsawtooth", count: 7, spread: 55 },
+  // ...
+});
+```
+### 2 — Filter sweep on drop entry
+```js
+// Chords start filtered and open up over the first bar of the drop
+const chordFilter = new Tone.Filter({ frequency: 300, type: "lowpass", Q: 2 });
+// chain: chords → chordFilter → chordChorus → chordVerb
+const sweepStart = Tone.Time("2m").toSeconds();
+chordFilter.frequency.setValueAtTime(300, sweepStart);
+chordFilter.frequency.exponentialRampToValueAtTime(12000, sweepStart + Tone.Time("1m").toSeconds());
+```
+### 3 — Pitched chord stab (one-hit per bar)
+```js
+// Instead of sustained chords, use a sharp pluck attack then let the reverb carry
+const chords = new Tone.PolySynth(Tone.Synth, {
+  oscillator: { type: "fatsawtooth", count: 5, spread: 40 },
+  envelope: { attack: 0.005, decay: 0.15, sustain: 0, release: 2.5 }, // no sustain = pluck
+});
+```

package/skills/audio-future-bass/example.html ADDED Viewed

@@ -0,0 +1,164 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <title>TuneFrames — Future Bass</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":150,"duration":"12s"}</div>
+  <script>
+    async function main() {
+      await Tone.start();
+      Tone.Transport.bpm.value = 150;
+      // --- MASTER BUS ---
+      const masterLimiter = new Tone.Limiter(-1).toDestination();
+      const masterGain = new Tone.Gain(0.82).connect(masterLimiter);
+      // --- SUPERSAW CHORDS — fatsawtooth + wide chorus + huge reverb ---
+      const chordVerb = new Tone.Reverb({ decay: 4.0, wet: 0.55 }).connect(masterGain);
+      const chordChorus = new Tone.Chorus({ frequency: 0.8, delayTime: 3.5, depth: 0.8, wet: 0.7 }).connect(chordVerb);
+      chordChorus.start();
+      const chordGain = new Tone.Gain(0.45).connect(chordChorus);
+      const chords = new Tone.PolySynth(Tone.Synth, {
+        oscillator: { type: "fatsawtooth", count: 5, spread: 40 },
+        envelope: { attack: 0.08, decay: 0.2, sustain: 0.75, release: 2.0 },
+        volume: 0
+      }).connect(chordGain);
+      // --- LEAD — emotional melodic line, triangle + delay ---
+      const leadVerb = new Tone.Reverb({ decay: 2.5, wet: 0.4 }).connect(masterGain);
+      const leadDelay = new Tone.FeedbackDelay({ delayTime: "8n", feedback: 0.28, wet: 0.25 }).connect(leadVerb);
+      const leadGain = new Tone.Gain(0.6).connect(leadDelay);
+      const lead = new Tone.Synth({
+        oscillator: { type: "triangle" },
+        envelope: { attack: 0.02, decay: 0.3, sustain: 0.6, release: 1.0 },
+        volume: 0
+      }).connect(leadGain);
+      // --- 808 SUB — long pitch glide, saturated ---
+      const sub808Dist = new Tone.Distortion({ distortion: 0.12, wet: 0.3 }).connect(masterGain);
+      const sub808Gain = new Tone.Gain(0.85).connect(sub808Dist);
+      const sub808 = new Tone.MembraneSynth({
+        pitchDecay: 0.45,
+        octaves: 3,
+        envelope: { attack: 0.001, decay: 0.9, sustain: 0, release: 0.4 }
+      }).connect(sub808Gain);
+      // --- KICK — trap: sparse, heavy ---
+      const kickGain = new Tone.Gain(0.9).connect(masterGain);
+      const kick = new Tone.MembraneSynth({
+        pitchDecay: 0.08,
+        octaves: 8,
+        envelope: { attack: 0.001, decay: 0.38, sustain: 0, release: 0.1 }
+      }).connect(kickGain);
+      // --- CLAP — big noise with long reverb ---
+      const clapVerb = new Tone.Reverb({ decay: 2.8, wet: 0.55 }).connect(masterGain);
+      const clapGain = new Tone.Gain(0.55).connect(clapVerb);
+      const clap = new Tone.NoiseSynth({
+        noise: { type: "white" },
+        envelope: { attack: 0.001, decay: 0.18, sustain: 0, release: 0.08 }
+      }).connect(clapGain);
+      // --- HI-HAT — trap roll, heavy velocity variation ---
+      const hatGain = new Tone.Gain(0.35).connect(masterGain);
+      const hat = new Tone.MetalSynth({
+        frequency: 600,
+        envelope: { attack: 0.001, decay: 0.03, release: 0.01 },
+        harmonicity: 5.1,
+        modulationIndex: 32,
+        resonance: 4500,
+        octaves: 1.5
+      }).connect(hatGain);
+      // --- PATTERNS ---
+      // Intro lead melody (bars 1–2): emotional minor pentatonic line
+      const introLead = [
+        { time: "0:0:0", note: "A4", dur: "4n" },
+        { time: "0:1:0", note: "G4", dur: "8n" },
+        { time: "0:1:2", note: "E4", dur: "8n" },
+        { time: "0:2:0", note: "C5", dur: "4n" },
+        { time: "0:3:0", note: "A4", dur: "4n" },
+        { time: "1:0:0", note: "E4", dur: "2n" },
+        { time: "1:2:0", note: "G4", dur: "4n" },
+        { time: "1:3:0", note: "A4", dur: "4n" },
+      ];
+      introLead.forEach(({ time, note, dur }) => {
+        lead.triggerAttackRelease(note, dur, time);
+      });
+      // Drop lead melody (bars 3–6): brighter, higher register
+      const dropLead = [
+        { time: "2:0:0", note: "A5", dur: "4n" },
+        { time: "2:1:0", note: "G5", dur: "8n" },
+        { time: "2:1:2", note: "E5", dur: "8n" },
+        { time: "2:2:0", note: "C5", dur: "4n" },
+        { time: "2:3:0", note: "A4", dur: "4n" },
+        { time: "3:0:0", note: "F5", dur: "2n" },
+        { time: "3:2:0", note: "E5", dur: "4n" },
+        { time: "3:3:0", note: "D5", dur: "4n" },
+        { time: "4:0:0", note: "C5", dur: "2n" },
+        { time: "4:2:0", note: "E5", dur: "4n" },
+        { time: "4:3:0", note: "G5", dur: "4n" },
+        { time: "5:0:0", note: "G5", dur: "2n" },
+        { time: "5:2:0", note: "A5", dur: "4n" },
+        { time: "5:3:0", note: "G5", dur: "4n" },
+      ];
+      dropLead.forEach(({ time, note, dur }) => {
+        lead.triggerAttackRelease(note, dur, time);
+      });
+      // Drop supersaw chords — Am, F, C, G (1 bar each, wide voicings)
+      const dropChords = [
+        { time: "2m", notes: ["A2","E3","A3","C4","E4"] },
+        { time: "3m", notes: ["F2","C3","F3","A3","C4"] },
+        { time: "4m", notes: ["C3","G3","C4","E4","G4"] },
+        { time: "5m", notes: ["G2","D3","G3","B3","D4"] },
+      ];
+      dropChords.forEach(({ time, notes }) => {
+        chords.triggerAttackRelease(notes, "1m", time);
+      });
+      // 808 sub bass — follows chord roots, enters with the drop
+      const subHits = [
+        { time: "2m", note: "A2" },
+        { time: "3m", note: "F2" },
+        { time: "4m", note: "C2" },
+        { time: "5m", note: "G2" },
+      ];
+      subHits.forEach(({ time, note }) => {
+        sub808.triggerAttackRelease(note, "2n", time);
+      });
+      // Kick: half-time feel — beat 1 every bar, plus extra on bar 2 beat 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,"C1",null], "16n");
+      kickSeq.start("2m");
+      // Clap: half-time snare on beat 3 (step 8 in 16-step)
+      const clapSeq = new Tone.Sequence((time, val) => {
+        if (val) clap.triggerAttackRelease("8n", time);
+      }, [null,null,null,null,null,null,null,null,1,null,null,null,null,null,null,null], "16n");
+      clapSeq.start("2m");
+      // Hi-hat: trap roll with velocity variation throughout
+      const hatVels = [0.8,0.3,0.7,0.2,0.6,0.3,0.8,0.2,0.7,0.3,0.6,0.2,0.9,0.3,1.0,0.2];
+      let hatStep = 0;
+      const hatSeq = new Tone.Sequence((time) => {
+        hat.triggerAttackRelease("32n", time, hatVels[hatStep % 16]);
+        hatStep++;
+      }, new Array(16).fill(1), "16n");
+      hatSeq.start(0);
+    }
+    main();
+  </script>
+</body>
+</html>

package/skills/audio-hip-hop/SKILL.md ADDED Viewed

@@ -0,0 +1,133 @@
+---
+name: audio-hip-hop
+description: Boom Bap Hip Hop — punchy kick, snare on 2 and 4 with reverb tail, shuffled 16th hi-hats with swing, smooth bass line, warm soul-pad. Pete Rock / J Dilla / Madlib head-nod groove.
+---
+# TuneFrames — Boom Bap Hip Hop
+## Genre Profile
+- BPM range: 80–95 (slow enough to feel heavy)
+- Key characteristics: Heavy kick with short distortion (MembraneSynth), snare strictly on beats 2 and 4 with long reverb tail, 16th-note hi-hats with Tone.Transport swing (0.4–0.6) for the shuffle, smooth chromatic bass line, warm pad chord with slow attack for "sampled soul" texture
+- Typical instruments: MembraneSynth (kick), NoiseSynth (snare), MetalSynth or NoiseSynth (hat), MonoSynth or Synth (bass), PolySynth (pad)
+- Mood: Head-nodding, soulful, heavy, hypnotic, dusty
+## Core Pattern
+```js
+// Boom Bap — 88 BPM, F minor, 2-bar loop
+// Swing makes this: 16th hat offbeats push back into shuffle territory
+// Kick: beat 1 + syncopated ghost hit | Snare: beats 2 and 4 | Hat: 16ths shuffled
+Tone.Transport.bpm.value = 88;
+Tone.Transport.swing = 0.5;           // full swing — offbeat 16ths pushed back
+Tone.Transport.swingSubdivision = "16n";
+// Kick: beat 1, "and" of beat 2, beat 3 (classic boom bap syncopation)
+new Tone.Sequence((time, val) => {
+  if (val) kick.triggerAttackRelease("C1", "8n", time);
+}, ["C1",null,null,null,null,null,"C1",null,"C1",null,null,null,null,null,null,null], "16n").start(0);
+//   beat1              and-of-2             beat3
+// Snare: strictly 2 and 4
+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").start(0);
+// Hi-hat: all 16ths with alternating velocity — swing does the shuffle work
+const hatVels = [0.9,0.45,0.85,0.4,0.9,0.45,0.85,0.4,0.9,0.45,0.9,0.4,0.85,0.45,0.9,0.45];
+let hatStep = 0;
+new Tone.Sequence((time) => {
+  hat.triggerAttackRelease("16n", time, hatVels[hatStep++ % 16]);
+}, new Array(16).fill(1), "16n").start(0);
+Tone.Transport.start();
+```
+## Instrument Configuration
+```js
+// Kick — MembraneSynth with slight saturation (the "punchy" sound)
+const kickDist = new Tone.Distortion({ distortion: 0.2, wet: 0.4 }).toDestination();
+const kick = new Tone.MembraneSynth({
+  pitchDecay: 0.07,
+  octaves: 6,
+  envelope: { attack: 0.001, decay: 0.32, sustain: 0, release: 0.1 },
+  volume: 0
+}).connect(kickDist);
+// Snare — white noise with a long reverb tail (the "room" sound)
+const snareVerb = new Tone.Reverb({ decay: 1.8, wet: 0.5 }).toDestination();
+const snare = new Tone.NoiseSynth({
+  noise: { type: "white" },
+  envelope: { attack: 0.001, decay: 0.2, sustain: 0, release: 0.06 },
+  volume: -4
+}).connect(snareVerb);
+// Hi-hat — crisp, short, metallic
+const hat = new Tone.MetalSynth({
+  frequency: 500,
+  envelope: { attack: 0.001, decay: 0.04, release: 0.01 },
+  harmonicity: 5.1,
+  modulationIndex: 24,
+  resonance: 4000,
+  octaves: 1.2,
+  volume: -12
+}).toDestination();
+// Bass — MonoSynth, smooth but defined
+const bass = new Tone.MonoSynth({
+  oscillator: { type: "sawtooth" },
+  filter: { Q: 2, type: "lowpass", rolloff: -12 },
+  filterEnvelope: { attack: 0.01, decay: 0.2, sustain: 0.4, release: 0.3,
+                    baseFrequency: 120, octaves: 1.5 },
+  envelope: { attack: 0.01, decay: 0.15, sustain: 0.7, release: 0.3 },
+  volume: -4
+}).toDestination();
+// Soul pad — warm PolySynth, slow attack = "reverse sample" texture
+const padVerb = new Tone.Reverb({ decay: 3.5, wet: 0.5 }).toDestination();
+const pad = new Tone.PolySynth(Tone.Synth, {
+  oscillator: { type: "triangle" },
+  envelope: { attack: 0.6, decay: 0.5, sustain: 0.7, release: 2.0 },
+  volume: -14
+}).connect(padVerb);
+```
+## Composition Structure
+- **Bar 1:** Kick + snare + hat only — establish the swung groove, feel the shuffle
+- **Bars 2–4:** Add bass — smooth line following Fm → Cm → Bb → Eb
+- **Bars 5–8:** Add soul pad — Fm7 chord with slow attack, warm
+- **Bars 9–16:** Full groove — all elements, occasionally double the kick for variation
+- **Half-time bar:** Every 4–8 bars, simplify to kick on beat 1 only — creates space then snaps back
+Dilla technique: vary the kick pattern slightly each 2 bars instead of looping the exact same hit positions. Use a step counter to swap between two kick pattern arrays.
+## Example Variations
+### 1 — "Dilla" floating kick (pattern alternates every 2 bars)
+```js
+const kickPatterns = [
+  ["C1",null,null,null,null,null,"C1",null,"C1",null,null,null,null,null,null,null],
+  ["C1",null,null,null,null,null,null,null,"C1",null,"C1",null,null,null,null,null],
+];
+let bar = 0;
+new Tone.Sequence((time, val) => {
+  if (val) kick.triggerAttackRelease("C1", "8n", time);
+}, kickPatterns[Math.floor(bar++ / 16) % 2], "16n").start(0);
+```
+### 2 — Swing amount variation (lighter shuffle)
+```js
+// 0.3 = light shuffle (more "straight"), 0.5 = full triplet swing, 0.15 = barely swung
+Tone.Transport.swing = 0.35; // Pete Rock feel — noticeable but not extreme
+```
+### 3 — Open hi-hat accent on beat 4
+```js
+// Add an open hi-hat (longer decay) on step 12 for groove
+const openHat = new Tone.MetalSynth({ ...hat options..., envelope: { decay: 0.18 } }).toDestination();
+const openHatSeq = new Tone.Sequence((time, val) => {
+  if (val) openHat.triggerAttackRelease("8n", time, 0.7);
+}, [null,null,null,null,null,null,null,null,null,null,null,null,1,null,null,null], "16n").start(0);
+```