scribbletune 5.5.1 → 5.5.2

package/README.md

@@ -5,7 +5,7 @@
 <h1 align="center">Scribbletune</h1>
 
 <p align="center">
-  Create music with JavaScript. Use simple strings and arrays to craft rhythms, melodies, and chord progressions — then export MIDI files or play them live in the browser with <a href="https://tonejs.github.io/">Tone.js</a>.
+  Create music with JavaScript. Use simple strings and arrays to craft rhythms, melodies, and chord progressions — then export MIDI files or play them live in the browser with <a href="https://tonejs.github.io/">Tone.js</a> or use the CLI to directly emit MIDI file from your terminal.
 </p>
 
 <p align="center">
@@ -23,9 +23,9 @@ npm install scribbletune
 
 ## Quick start
 
-### CLI
+### Option 1: CLI
 
-The package now ships a CLI binary: `scribbletune`.
+If you installed Scribbletune globally via `npm i -g scribbletune` then you can directly use `scribbletune` as the command. If you installed it locally via `npm i scribbletune` then please use `npx scribbletune` as the command.
 
 Run modes:
 
@@ -41,21 +41,10 @@ npx scribbletune --help
 
 Quick command examples:
 
-```bash
-# Use built file directly from repo (before publish)
-node dist/cli.cjs --help
-
-# Use local package binary
-npx scribbletune --help
-
-# If installed globally
-scribbletune --help
-```
-
 #### Command format
 
 ```bash
-scribbletune --riff <root> <mode> <pattern> [octaveShift] [motif] [options]
+scribbletune --riff <root> <mode> <pattern> [subdiv] [options]
 scribbletune --chord <root> <mode> <progression|random> <pattern> [subdiv] [options]
 scribbletune --arp <root> <mode> <progression|random> <pattern> [subdiv] [options]
 ```
@@ -67,26 +56,23 @@ Progression input rules for `--chord` and `--arp`:
 "I IV vi V"     # roman numerals (space separated)
 I,IV,vi,V       # roman numerals (comma separated)
 random          # generated progression
-CM-FM-Am-GM     # explicit chord names
+CM-FM-Am-GM     # explicit chord names (`root` and `mode` are ignored)
 ```
 
-Notes:
-- Hyphenated romans like `I-IV-vi-V` are not supported currently.
-- For explicit chords (`CM-FM-Am-GM`), `root` and `mode` are currently ignored.
-
 Common options:
 
 ```bash
---outfile <file.mid>    # default: music.mid
---bpm <number>
+--outfile <file.mid>  # default: music.mid
 --subdiv <4n|8n|1m...>
 --sizzle [sin|cos|rampUp|rampDown] [reps]
 --sizzle-reps <number>
 --amp <0-127>
 --accent <x--x...>
 --accent-low <0-127>
+--style <letters>     # riff motif/style, e.g. AABC
 --fit-pattern         # explicit enable (already enabled by default)
 --no-fit-pattern      # disable automatic pattern fitting
+--bpm <number>        # your DAW may or may not support it
 ```
 
 Note: if your pattern uses `[` and `]` (for subdivisions), quote it in shell:
@@ -110,13 +96,21 @@ x.repeat(4)       # -> xxxx
 # Basic riff from scale
 scribbletune --riff C3 phrygian x-xRx_RR --outfile riff.mid
 
-# With octave shift and motif
-scribbletune --riff C3 phrygian x-xRx_RR 0 AABC --sizzle sin 2 --outfile riff-aabc.mid
+# With motif/style and positional subdiv
+scribbletune --riff C3 phrygian x-xRx_RR 8n --style AABC --sizzle sin 2 --outfile riff-aabc.mid
+
+# Set riff subdivision via positional arg
+scribbletune --riff C3 phrygian x-xRx_RR 8n --style AABC --outfile riff-8n.mid
 
 # Pattern with subdivisions (quote [] in shell)
-scribbletune --riff C3 phrygian 'x-x[xx]-x-[xx]' 0 AABC --outfile riff-subdiv.mid
+scribbletune --riff C3 phrygian 'x-x[xx]-x-[xx]' 8n --style AABC --outfile riff-subdiv.mid
 ```
 
+Riff + motif note:
+- `--style` creates riff sections by repeating the full pattern per letter.
+- Example: `--style AABC` with pattern `x-x[xx]` creates 4 sections: `A`, `A`, `B`, `C`.
+- Repeated letters reuse the exact same generated section (same rhythm and same notes, including random `R` choices).
+
 #### `--chord` examples
 
 ```bash
@@ -167,7 +161,7 @@ scribbletune --arp C3 major 1736 x 4n --no-fit-pattern --outfile arp-no-fit.mid
 
 Run `scribbletune --help` to see the latest CLI usage text.
 
-### Generate a MIDI file (Node.js)
+### Option 2: Node.js
 
 ```js
 import { scale, clip, midi } from 'scribbletune';
@@ -180,7 +174,7 @@ midi(c, 'c-major.mid');
 
 Run it with `node` and open the `.mid` file in Ableton Live, GarageBand, Logic, or any DAW.
 
-### Play in the browser (with Tone.js)
+### Option 3: Browser (with Tone.js)
 
 Scribbletune's browser entry point adds `Session`, `Channel`, and live `clip()` support on top of [Tone.js](https://tonejs.github.io/).
 
@@ -355,6 +349,12 @@ npm run lint      # check with biome
 npm run dev       # build in watch mode
 ```
 
+If developing new features for the CLI, use the following command after running `npm run build` to test before publishing,
+
+```bash
+node dist/cli.cjs --help
+```
+
 ## License
 
 MIT

package/dist/cli.cjs

@@ -546,12 +546,12 @@ var progression = (scaleType, count = 4) => {
 
 // src/cli.ts
 var HELP_TEXT = `Usage:
-  scribbletune --riff <root> <mode> <pattern> [octaveShift] [motif]
+  scribbletune --riff <root> <mode> <pattern> [subdiv]
   scribbletune --chord <root> <mode> <progression|random> <pattern> [subdiv]
   scribbletune --arp <root> <mode> <progression|random> <pattern> [subdiv]
 
 Examples:
-  scribbletune --riff C3 phrygian x-xRx_RR 0 AABC --sizzle sin 2 --outfile riff.mid
+  scribbletune --riff C3 phrygian x-xRx_RR 8n --style AABC --sizzle sin 2 --outfile riff.mid
   scribbletune --chord C3 major 1645 xxxx 1m --sizzle cos 1 --outfile chord.mid
   scribbletune --chord C3 major CM-FM-Am-GM xxxx 1m
   scribbletune --chord C3 major random xxxx 1m
@@ -568,6 +568,7 @@ Options:
   --accent-low <0-127>  Accent low level
   --count <2-8>         Arp note count (arp command only)
   --order <digits>      Arp order string (arp command only)
+  --style <letters>     Riff motif/style pattern (e.g. AABC)
   --fit-pattern         Repeat pattern until it can consume all generated notes (default)
   --no-fit-pattern      Disable automatic pattern fitting
   -h, --help            Show this help
@@ -587,11 +588,6 @@ var romanByDigit = (progDigits, mode) => {
   });
   return { chordDegrees: romans.join(" "), raw: progDigits };
 };
-var setOctave = (note, octaveShift = 0) => {
-  const base = note.replace(/\d+/g, "");
-  const oct = Number(note.match(/\d+/)?.[0] || "4");
-  return `${base}${oct + octaveShift}`;
-};
 var parseProgression = (root, mode, progressionInput) => {
   if (progressionInput === "random") {
     const modeType = mode === "minor" || mode === "m" ? "minor" : "major";
@@ -751,6 +747,11 @@ var parseCliArgs = (argv) => {
       i += 2;
       continue;
     }
+    if (token === "--style") {
+      options.style = argv[i + 1];
+      i += 2;
+      continue;
+    }
     if (token === "--fit-pattern") {
       options.fitPattern = true;
       i += 1;
@@ -775,31 +776,53 @@ var baseClipParams = (parsed) => {
   };
 };
 var makeRiff = (parsed) => {
-  const [root, mode, pattern, octaveShiftArg, motif] = parsed.positionals;
+  const [root, mode, pattern, subdiv] = parsed.positionals;
+  const style = parsed.style;
   if (!root || !mode || !pattern) {
-    throw new TypeError(
-      "riff requires: <root> <mode> <pattern> [octaveShift] [motif]"
-    );
+    throw new TypeError("riff requires: <root> <mode> <pattern> [subdiv]");
   }
-  const octaveShift = Number(octaveShiftArg || "0");
-  const riffScale = (0, import_harmonics4.scale)(`${setOctave(root, octaveShift)} ${mode}`);
-  const riffNotes = motif && motif.length ? motif.toUpperCase().split("").map((letter) => {
-    const idx = letter.charCodeAt(0) - 65;
-    if (idx < 0) {
-      return riffScale[0];
-    }
-    return riffScale[idx % riffScale.length];
-  }) : riffScale;
-  const resolvedPattern = resolvePattern(
+  const riffScale = (0, import_harmonics4.scale)(`${root} ${mode}`);
+  let riffNotes = riffScale;
+  let resolvedPattern = resolvePattern(
     pattern,
     riffNotes.length,
     parsed.fitPattern
   );
+  if (style && style.length) {
+    const sectionPattern = expandPatternSyntax(pattern);
+    const letters = style.toUpperCase().split("");
+    const sectionCache = {};
+    const combined = [];
+    const clipParams = {
+      ...baseClipParams(parsed),
+      subdiv: parsed.subdiv || subdiv
+    };
+    for (const letter of letters) {
+      if (!sectionCache[letter]) {
+        const idx = letter.charCodeAt(0) - 65;
+        const note = riffScale[idx >= 0 ? idx % riffScale.length : 0];
+        sectionCache[letter] = clip({
+          notes: [note],
+          randomNotes: riffScale,
+          pattern: sectionPattern,
+          ...clipParams
+        });
+      }
+      combined.push(
+        ...sectionCache[letter].map((event) => ({
+          ...event,
+          note: event.note ? [...event.note] : null
+        }))
+      );
+    }
+    return combined;
+  }
   return clip({
     notes: riffNotes,
     randomNotes: riffScale,
     pattern: resolvedPattern,
-    ...baseClipParams(parsed)
+    ...baseClipParams(parsed),
+    subdiv: parsed.subdiv || subdiv
   });
 };
 var makeChord = (parsed) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scribbletune",
-  "version": "5.5.1",
+  "version": "5.5.2",
   "description": "Create music with JavaScript and Node.js!",
   "type": "module",
   "main": "./dist/index.cjs",