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/examples/example-lofi.html CHANGED Viewed

@@ -1,45 +1,45 @@
-<!DOCTYPE html>
-<html>
-<head>
-  <title>TuneFrames — Lofi Example</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":"1m"}</div>
-  <script>
-    async function main() {
-      await Tone.start();
-      const reverb = new Tone.Reverb({ decay: 4, wet: 0.6 }).toDestination();
-      const pad = new Tone.PolySynth(Tone.Synth, {
-        oscillator: { type: 'triangle' },
-        envelope: { attack: 0.5, decay: 0.3, sustain: 0.8, release: 2 }
-      }).connect(reverb);
-      // Am - F - C - G chord progression
-      const chords = [
-        ['A3', 'C4', 'E4'],
-        ['F3', 'A3', 'C4'],
-        ['C3', 'E3', 'G3'],
-        ['G3', 'B3', 'D4'],
-      ];
-      // Play each chord for 2 beats at 80 BPM
-      for (let i = 0; i < chords.length; i++) {
-        pad.triggerAttackRelease(chords[i], '2n', i * Tone.Time('2n').toSeconds());
-      }
-      // Simple melody
-      const melody = new Tone.Synth({
-        oscillator: { type: 'sine' },
-        envelope: { attack: 0.01, decay: 0.1, sustain: 0.3, release: 0.5 }
-      }).toDestination();
-      melody.triggerAttackRelease('C5', '8n', Tone.Time('2n').toSeconds() * 0.5);
-      melody.triggerAttackRelease('E5', '8n', Tone.Time('2n').toSeconds() * 1.5);
-      melody.triggerAttackRelease('G5', '8n', Tone.Time('2n').toSeconds() * 2.5);
-      melody.triggerAttackRelease('C5', '4n', Tone.Time('2n').toSeconds() * 3.5);
-    }
-  </script>
-</body>
-</html>
+<!DOCTYPE html>
+<html>
+<head>
+  <title>TuneFrames — Lofi Example</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":"10s"}</div>
+  <script>
+    async function main() {
+      await Tone.start();
+      const reverb = new Tone.Reverb({ decay: 4, wet: 0.6 }).toDestination();
+      const pad = new Tone.PolySynth(Tone.Synth, {
+        oscillator: { type: 'triangle' },
+        envelope: { attack: 0.5, decay: 0.3, sustain: 0.8, release: 2 }
+      }).connect(reverb);
+      // Am - F - C - G chord progression
+      const chords = [
+        ['A3', 'C4', 'E4'],
+        ['F3', 'A3', 'C4'],
+        ['C3', 'E3', 'G3'],
+        ['G3', 'B3', 'D4'],
+      ];
+      // Play each chord for 2 beats at 80 BPM
+      for (let i = 0; i < chords.length; i++) {
+        pad.triggerAttackRelease(chords[i], '2n', i * Tone.Time('2n').toSeconds());
+      }
+      // Simple melody
+      const melody = new Tone.Synth({
+        oscillator: { type: 'sine' },
+        envelope: { attack: 0.01, decay: 0.1, sustain: 0.3, release: 0.5 }
+      }).toDestination();
+      melody.triggerAttackRelease('C5', '8n', Tone.Time('2n').toSeconds() * 0.5);
+      melody.triggerAttackRelease('E5', '8n', Tone.Time('2n').toSeconds() * 1.5);
+      melody.triggerAttackRelease('G5', '8n', Tone.Time('2n').toSeconds() * 2.5);
+      melody.triggerAttackRelease('C5', '4n', Tone.Time('2n').toSeconds() * 3.5);
+    }
+  </script>
+</body>
+</html>

package/examples/example-lofi.mp3 ADDED Viewed

Binary file

package/examples/example-minimal.html CHANGED Viewed

@@ -1,19 +1,21 @@
-<!DOCTYPE html>
-<html>
-<head>
-  <title>TuneFrames — Minimal Test</title>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/tone/14.8.49/Tone.js"></script>
-</head>
-<body>
-  <script>
-    // This must be a named async function for the renderer to call
-    async function main() {
-      // BPM set in #tuneframes metadata
-      await Tone.start();
-      const synth = new Tone.Synth().toDestination();
-      // Explicitly schedule at transport time 0
-      synth.triggerAttackRelease('C4', '4n', 0);
-    }
-  </script>
-</body>
-</html>
+<!DOCTYPE html>
+<html>
+<head>
+  <title>TuneFrames — Minimal</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":120,"duration":"2s"}</div>
+  <script>
+    async function main() {
+      await Tone.start();
+      const synth = new Tone.Synth().toDestination();
+      const beat = Tone.Time('4n').toSeconds();
+      // C major arpeggio — three notes, clean and simple
+      synth.triggerAttackRelease('C4', '4n', 0);
+      synth.triggerAttackRelease('E4', '4n', beat);
+      synth.triggerAttackRelease('G4', '4n', beat * 2);
+    }
+  </script>
+</body>
+</html>

package/examples/example-minimal.mp3 ADDED Viewed

Binary file

package/examples/example-orchestral.html CHANGED Viewed

@@ -1,67 +1,67 @@
-<!DOCTYPE html>
-<html>
-<head>
-  <title>TuneFrames — Orchestral</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":72,"duration":"1m"}</div>
-  <script>
-    async function main() {
-      await Tone.start();
-      const verb = new Tone.Reverb({ decay: 6, wet: 0.5 }).toDestination();
-      // Strings section
-      const strings = new Tone.PolySynth(Tone.Synth, {
-        oscillator: { type: 'sawtooth' },
-        envelope: { attack: 1.5, decay: 0.3, sustain: 0.9, release: 3 }
-      }).connect(verb);
-      strings.volume.value = -12;
-      // Brass
-      const brass = new Tone.PolySynth(Tone.Synth, {
-        oscillator: { type: 'sawtooth' },
-        envelope: { attack: 0.3, decay: 0.2, sustain: 0.7, release: 1.5 }
-      }).connect(verb);
-      brass.volume.value = -10;
-      // Timpani
-      const timpani = new Tone.MembraneSynth({
-        pitchDecay: 0.05,
-        octaves: 4,
-        oscillator: { type: 'sine' },
-        envelope: { attack: 0.001, decay: 1, sustain: 0, release: 2 }
-      }).toDestination();
-      timpani.volume.value = -8;
-      const beat = Tone.Time('1n').toSeconds();
-      // Strings: swell on every bar
-      const stringChords = [
-        ['D3', 'F3', 'A3', 'C4'],  // Dm7
-        ['C3', 'E3', 'G3', 'B3'],  // Cmaj7
-        ['Bb2', 'D3', 'F3', 'A3'], // Bbmaj7
-        ['A2', 'C3', 'E3', 'G3'],  // Am7
-      ];
-      stringChords.forEach((chord, i) => {
-        strings.triggerAttackRelease(chord, '1n', i * beat);
-      });
-      // Brass: enters on bar 3 with fanfare
-      const fanfares = [
-        ['D4', 'F4', 'A4'],
-        ['C4', 'E4', 'G4'],
-      ];
-      fanfares.forEach((chord, i) => {
-        brass.triggerAttackRelease(chord, '2n', (i + 2) * beat);
-      });
-      // Timpani: tonic hits on bars 1 and 3
-      timpani.triggerAttackRelease('D2', '1n', 0);
-      timpani.triggerAttackRelease('D2', '1n', beat * 2);
-      timpani.triggerAttackRelease('A1', '2n', beat * 3.5);
-    }
-  </script>
-</body>
-</html>
+<!DOCTYPE html>
+<html>
+<head>
+  <title>TuneFrames — Orchestral</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":72,"duration":"14s"}</div>
+  <script>
+    async function main() {
+      await Tone.start();
+      const verb = new Tone.Reverb({ decay: 6, wet: 0.5 }).toDestination();
+      // Strings section
+      const strings = new Tone.PolySynth(Tone.Synth, {
+        oscillator: { type: 'sawtooth' },
+        envelope: { attack: 1.5, decay: 0.3, sustain: 0.9, release: 3 }
+      }).connect(verb);
+      strings.volume.value = -12;
+      // Brass
+      const brass = new Tone.PolySynth(Tone.Synth, {
+        oscillator: { type: 'sawtooth' },
+        envelope: { attack: 0.3, decay: 0.2, sustain: 0.7, release: 1.5 }
+      }).connect(verb);
+      brass.volume.value = -10;
+      // Timpani
+      const timpani = new Tone.MembraneSynth({
+        pitchDecay: 0.05,
+        octaves: 4,
+        oscillator: { type: 'sine' },
+        envelope: { attack: 0.001, decay: 1, sustain: 0, release: 2 }
+      }).toDestination();
+      timpani.volume.value = -8;
+      const beat = Tone.Time('1n').toSeconds();
+      // Strings: swell on every bar
+      const stringChords = [
+        ['D3', 'F3', 'A3', 'C4'],  // Dm7
+        ['C3', 'E3', 'G3', 'B3'],  // Cmaj7
+        ['Bb2', 'D3', 'F3', 'A3'], // Bbmaj7
+        ['A2', 'C3', 'E3', 'G3'],  // Am7
+      ];
+      stringChords.forEach((chord, i) => {
+        strings.triggerAttackRelease(chord, '1n', i * beat);
+      });
+      // Brass: enters on bar 3 with fanfare
+      const fanfares = [
+        ['D4', 'F4', 'A4'],
+        ['C4', 'E4', 'G4'],
+      ];
+      fanfares.forEach((chord, i) => {
+        brass.triggerAttackRelease(chord, '2n', (i + 2) * beat);
+      });
+      // Timpani: tonic hits on bars 1 and 3
+      timpani.triggerAttackRelease('D2', '1n', 0);
+      timpani.triggerAttackRelease('D2', '1n', beat * 2);
+      timpani.triggerAttackRelease('A1', '2n', beat * 3.5);
+    }
+  </script>
+</body>
+</html>

package/examples/example-orchestral.mp3 ADDED Viewed

Binary file

package/examples/example-piano.html ADDED Viewed

@@ -0,0 +1,53 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>TuneFrames — Piano</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":100,"duration":"5s"}</div>
+  <script>
+    async function main() {
+      await Tone.start();
+      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.3, release: 1.2 }
+      }).toDestination();
+      piano.volume.value = -8;
+      // Dm - Am - Bb - F chord progression, 2 bars each
+      const chords = [
+        ['D3', 'F3', 'A3'],   // Dm
+        ['A2', 'C3', 'E3'],   // Am
+        ['Bb2', 'D3', 'F3'],  // Bb
+        ['F2', 'A2', 'C3']    // F
+      ];
+      chords.forEach((chord, i) => {
+        piano.triggerAttackRelease(chord, '2n', i * 2 * beat);
+      });
+      // Melodic line: simple pentatonic over the changes
+      const melody = [
+        { note: 'D4', time: 0 },
+        { note: 'F4', time: beat },
+        { note: 'A4', time: beat * 2 },
+        { note: 'C4', time: 2 * beat },
+        { note: 'E4', time: 2.5 * beat },
+        { note: 'D4', time: 3 * beat },
+        { note: 'F4', time: 4 * beat },
+        { note: 'G4', time: 4.5 * beat },
+        { note: 'A4', time: 5 * beat },
+        { note: 'Bb4', time: 6 * beat },
+        { note: 'F4', time: 7 * beat }
+      ];
+      melody.forEach(({ note, time }) => {
+        if (time < 5) piano.triggerAttackRelease(note, '8n', time);
+      });
+    }
+  </script>
+</body>
+</html>

package/examples/example-piano.mp3 ADDED Viewed

Binary file

package/examples/example-techno.html CHANGED Viewed

@@ -1,69 +1,69 @@
-<!DOCTYPE html>
-<html>
-<head>
-  <title>TuneFrames - Techno</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":130,"duration":"2n"}</div>
-  <script>
-    async function main() {
-      await Tone.start();
-      const beat = Tone.Time('4n').toSeconds();
-      const comp = new Tone.Compressor(-18, 5).toDestination();
-      const verb = new Tone.Reverb({ decay: 1, wet: 0.3 }).toDestination();
-      // Kick - 4-on-the-floor
-      const kick = new Tone.MembraneSynth({
-        pitchDecay: 0.05, octaves: 6,
-        oscillator: { type: 'sine' },
-        envelope: { attack: 0.001, decay: 0.3, sustain: 0, release: 0.1 }
-      }).connect(comp);
-      // Hi-hat: NoiseSynth (white noise + filter envelope)
-      const hihat = new Tone.NoiseSynth({
-        noise: { type: 'white' },
-        envelope: { attack: 0.001, decay: 0.03, sustain: 0, release: 0.01 }
-      }).toDestination();
-      hihat.volume.value = -10;
-      // Bass: detuned saws
-      const bass = new Tone.MonoSynth({
-        oscillator: { type: 'sawtooth' },
-        filter: { Q: 3, type: 'lowpass', rolloff: -24 },
-        envelope: { attack: 0.005, decay: 0.15, sustain: 0.5, release: 0.1 },
-        filterEnvelope: { attack: 0.001, decay: 0.1, sustain: 0.3, release: 0.2, baseFrequency: 80, octaves: 4 }
-      }).connect(comp);
-      // Pad: parallel saw chords
-      const pad = new Tone.PolySynth(Tone.Synth, {
-        oscillator: { type: 'sawtooth' },
-        envelope: { attack: 0.2, decay: 0.4, sustain: 0.7, release: 0.8 }
-      }).connect(verb);
-      pad.volume.value = -14;
-      // Kick: 4-on-the-floor every beat
-      for (let i = 0; i < 8; i++) {
-        kick.triggerAttackRelease('C1', '8n', i * beat);
-      }
-      // Hi-hat: offbeat 16ths (16 events)
-      for (let i = 0; i < 16; i++) {
-        hihat.triggerAttackRelease('16n', (i + 0.5) * beat * 0.5);
-      }
-      // Bass: syncopated
-      const bassPat = ['E1', 'E1', null, 'G1', 'A1', null, 'B1', 'A1', 'G1', null, 'E1', 'E1'];
-      bassPat.forEach((note, i) => {
-        if (note) bass.triggerAttackRelease(note, '8n', i * beat * 0.5);
-      });
-      // Pad: slow chord stabs
-      pad.triggerAttackRelease(['E2', 'G2', 'B2'], '2n', 0);
-      pad.triggerAttackRelease(['C2', 'E2', 'G2'], '2n', beat * 4);
-      pad.triggerAttackRelease(['D2', 'F2', 'A2'], '2n', beat * 6);
-    }
-  </script>
-</body>
-</html>
+<!DOCTYPE html>
+<html>
+<head>
+  <title>TuneFrames - Techno</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":130,"duration":"4s"}</div>
+  <script>
+    async function main() {
+      await Tone.start();
+      const beat = Tone.Time('4n').toSeconds();
+      const comp = new Tone.Compressor(-18, 5).toDestination();
+      const verb = new Tone.Reverb({ decay: 1, wet: 0.3 }).toDestination();
+      // Kick - 4-on-the-floor
+      const kick = new Tone.MembraneSynth({
+        pitchDecay: 0.05, octaves: 6,
+        oscillator: { type: 'sine' },
+        envelope: { attack: 0.001, decay: 0.3, sustain: 0, release: 0.1 }
+      }).connect(comp);
+      // Hi-hat: NoiseSynth (white noise + filter envelope)
+      const hihat = new Tone.NoiseSynth({
+        noise: { type: 'white' },
+        envelope: { attack: 0.001, decay: 0.03, sustain: 0, release: 0.01 }
+      }).toDestination();
+      hihat.volume.value = -10;
+      // Bass: detuned saws
+      const bass = new Tone.MonoSynth({
+        oscillator: { type: 'sawtooth' },
+        filter: { Q: 3, type: 'lowpass', rolloff: -24 },
+        envelope: { attack: 0.005, decay: 0.15, sustain: 0.5, release: 0.1 },
+        filterEnvelope: { attack: 0.001, decay: 0.1, sustain: 0.3, release: 0.2, baseFrequency: 80, octaves: 4 }
+      }).connect(comp);
+      // Pad: parallel saw chords
+      const pad = new Tone.PolySynth(Tone.Synth, {
+        oscillator: { type: 'sawtooth' },
+        envelope: { attack: 0.2, decay: 0.4, sustain: 0.7, release: 0.8 }
+      }).connect(verb);
+      pad.volume.value = -14;
+      // Kick: 4-on-the-floor every beat
+      for (let i = 0; i < 8; i++) {
+        kick.triggerAttackRelease('C1', '8n', i * beat);
+      }
+      // Hi-hat: offbeat 16ths (16 events)
+      for (let i = 0; i < 16; i++) {
+        hihat.triggerAttackRelease('16n', (i + 0.5) * beat * 0.5);
+      }
+      // Bass: syncopated
+      const bassPat = ['E1', 'E1', null, 'G1', 'A1', null, 'B1', 'A1', 'G1', null, 'E1', 'E1'];
+      bassPat.forEach((note, i) => {
+        if (note) bass.triggerAttackRelease(note, '8n', i * beat * 0.5);
+      });
+      // Pad: slow chord stabs
+      pad.triggerAttackRelease(['E2', 'G2', 'B2'], '2n', 0);
+      pad.triggerAttackRelease(['C2', 'E2', 'G2'], '2n', beat * 4);
+      pad.triggerAttackRelease(['D2', 'F2', 'A2'], '2n', beat * 6);
+    }
+  </script>
+</body>
+</html>

package/examples/example-techno.mp3 ADDED Viewed

Binary file

package/package.json CHANGED Viewed

@@ -1,24 +1,42 @@
-{
-  "name": "tuneframes",
-  "version": "0.1.0",
-  "description": "Write HTML with Tone.js. Render music to MP3/WAV with one CLI command. Built for AI agents.",
-  "repository": "github:cusidoc/tuneframes",
-  "homepage": "https://github.com/cusidoc/tuneframes#readme",
-  "author": "Nick Shepherd <nick@moltos.org>",
-  "main": "src/cli.js",
-  "bin": {
-    "tuneframes": "src/cli.js"
-  },
-  "scripts": {
-    "render": "node src/render.js",
-    "test": "node src/cli.js render examples/example-minimal.html"
-  },
-  "keywords": ["music", "tone.js", "agent", "hyperframes", "ai"],
-  "license": "Apache-2.0",
-  "dependencies": {
-    "playwright": "^1.40.0"
-  },
-  "engines": {
-    "node": ">=18"
-  }
-}
+{
+  "name": "tuneframes",
+  "version": "0.2.0",
+  "description": "Agent-native music generation. Write Tone.js, render to audio.",
+  "main": "src/cli.js",
+  "bin": {
+    "tuneframes": "src/cli.js"
+  },
+  "scripts": {
+    "render": "node src/cli.js render",
+    "preview": "node src/cli.js preview"
+  },
+  "files": [
+    "src",
+    "examples",
+    "registry",
+    "skills"
+  ],
+  "keywords": [
+    "tonejs",
+    "music",
+    "audio",
+    "generation",
+    "agents",
+    "web-audio",
+    "soundfont",
+    "sampler",
+    "instruments"
+  ],
+  "author": "Nathan Shepherd",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Shepherd217/TuneFrames.git"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "playwright": "^1.44.0"
+  }
+}

package/registry/presets/bass-electric.html ADDED Viewed

@@ -0,0 +1,67 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <script src="https://cdnjs.cloudflare.com/ajax/libs/tone/14.8.49/Tone.js"></script>
+</head>
+<body>
+  <!-- Walking bass line in C minor — acoustic_bass from gleitz CDN -->
+  <!-- 2 bars at 100 BPM: 1 beat = 0.6s, 8 quarter notes = 4.8s -->
+  <div id="tuneframes" style="display:none">{"bpm":100,"duration":"6s"}</div>
+  <script>
+    async function main() {
+      await Tone.start();
+      // Load acoustic bass samples from gleitz FluidR3_GM CDN
+      const bass = new Tone.Sampler({
+        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'
+        },
+        baseUrl: 'https://gleitz.github.io/midi-js-soundfonts/FluidR3_GM/acoustic_bass-mp3/'
+      });
+      // Subtle compression to even out the pluck dynamics
+      const comp = new Tone.Compressor({ threshold: -18, ratio: 3 }).toDestination();
+      bass.connect(comp);
+      // CRITICAL: wait for samples to load before scheduling any notes
+      await Tone.loaded();
+      const beat = Tone.Time('4n').toSeconds(); // 0.6s at 100 BPM
+      const dur  = '4n'; // each walking note lasts one quarter note
+      // Walking bass in C minor — 2 bars, 4 notes per bar
+      // Bar 1: root → approach from below → fifth → seventh (classic walking move)
+      // Bar 2: resolve back down with chromatic approach to the root
+      const line = [
+        // Bar 1 — Cm feel
+        'C2',  // root
+        'Eb2', // minor third
+        'G2',  // fifth
+        'Bb2', // minor seventh
+        // Bar 2 — Fm → G7 turnaround, walking back to root
+        'Ab2', // flat-six (Fm)
+        'G2',  // fifth (G dominant)
+        'F2',  // approach
+        'Eb2'  // land on minor third, implies return to Cm
+      ];
+      line.forEach((note, i) => {
+        bass.triggerAttackRelease(note, dur, i * beat);
+      });
+    }
+  </script>
+</body>
+</html>

package/registry/presets/bass-saw.html ADDED Viewed

@@ -0,0 +1,22 @@
+<!-- TuneFrames preset: bass-saw
+     Detuned saw MonoSynth bass. Paste inside <script>.
+     Set duration to cover the number of beats you've scheduled. -->
+<script>
+  const beat = Tone.Time('4n').toSeconds();
+  const bass = new Tone.MonoSynth({
+    oscillator: { type: 'sawtooth' },
+    filter: { Q: 4, type: 'lowpass', rolloff: -24 },
+    envelope: { attack: 0.005, decay: 0.2, sustain: 0.6, release: 0.15 },
+    filterEnvelope: {
+      attack: 0.001, decay: 0.1, sustain: 0.4, release: 0.2,
+      baseFrequency: 80, octaves: 4
+    }
+  }).toDestination();
+  bass.volume.value = -6;
+  const pattern = ['E1', null, 'E1', 'G1', 'A1', null, 'B1', 'A1', 'G1', null, 'E1', 'E1'];
+  pattern.forEach((note, i) => {
+    if (note) bass.triggerAttackRelease(note, '8n', i * beat * 0.5);
+  });
+</script>

package/registry/presets/chord-progression.html ADDED Viewed

@@ -0,0 +1,22 @@
+<!-- TuneFrames preset: chord-progression
+     Dm → C → Bb → Am, 1 measure each.
+     Paste inside <script>. Set metadata duration to "4s" per chord (16s total for all 4). -->
+<script>
+  const measure = Tone.Time('1n').toSeconds();
+  const pad = new Tone.PolySynth(Tone.Synth, {
+    oscillator: { type: 'sawtooth' },
+    envelope: { attack: 0.5, decay: 0.3, sustain: 0.7, release: 1.5 }
+  }).toDestination();
+  const progression = [
+    { chord: ['D3', 'F3', 'A3'], name: 'Dm' },
+    { chord: ['C3', 'E3', 'G3'], name: 'C' },
+    { chord: ['Bb2', 'D3', 'F3'], name: 'Bb' },
+    { chord: ['A2', 'C3', 'E3'], name: 'Am' },
+  ];
+  progression.forEach(({ chord }, i) => {
+    pad.triggerAttackRelease(chord, '1n', i * measure);
+  });
+</script>