@reelscript/cli 0.1.0

package/dist/tts.js

@@ -0,0 +1,154 @@
+/**
+ * Narration: text-to-speech engines and a cache of synthesized clips.
+ *
+ * The default engine is Kokoro-82M through the optional `kokoro-js`
+ * dependency: open weights, runs on CPU faster than real time, no account.
+ * Any object implementing TtsEngine can be passed instead (ElevenLabs,
+ * OpenAI, a cloud service).
+ */
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+export const DEFAULT_VOICE = "af_heart";
+export const KOKORO_MODEL = "onnx-community/Kokoro-82M-v1.0-ONNX";
+/** Root of reelscript's on-disk cache (models, synthesized clips). */
+export function cacheDir() {
+    return process.env.REELSCRIPT_CACHE ?? join(homedir(), ".cache", "reelscript");
+}
+/** Split narration into sentences; TTS models prefer short inputs. */
+export function splitSentences(text) {
+    return text
+        .replace(/\s+/g, " ")
+        .trim()
+        .split(/(?<=[.!?])\s+/)
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+/**
+ * Point transformers.js (kokoro-js's model loader) at reelscript's cache dir
+ * instead of its default inside node_modules, so the model survives
+ * reinstalls and can be cached in CI.
+ *
+ * Node keeps separate module instances for the ESM and CJS builds, each with
+ * its own `env`, so this must configure the exact file kokoro-js imports: the
+ * ESM build resolved from kokoro-js's own location (nested or hoisted).
+ */
+async function redirectModelCache() {
+    const { fileURLToPath, pathToFileURL } = await import("node:url");
+    const { dirname, join: pjoin } = await import("node:path");
+    let url = "@huggingface/transformers";
+    try {
+        let dir = dirname(fileURLToPath(import.meta.resolve("kokoro-js")));
+        for (;;) {
+            const candidate = pjoin(dir, "node_modules", "@huggingface", "transformers", "dist", "transformers.node.mjs");
+            if (existsSync(candidate)) {
+                url = pathToFileURL(candidate).href;
+                break;
+            }
+            const parent = dirname(dir);
+            if (parent === dir)
+                break;
+            dir = parent;
+        }
+    }
+    catch {
+        /* fall back to bare specifier */
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const mod = await import(url);
+    if (!mod.env)
+        throw new Error("reelscript: could not configure the transformers.js model cache");
+    mod.env.cacheDir = join(cacheDir(), "models") + "/";
+}
+/** Kokoro-82M via kokoro-js, loaded lazily on first use. */
+export function kokoro(model = KOKORO_MODEL) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let loading = null;
+    const load = () => (loading ??= (async () => {
+        const spec = "kokoro-js";
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let mod;
+        try {
+            mod = await import(spec);
+        }
+        catch {
+            throw new Error("reelscript: narration needs the optional dependency kokoro-js.\n" +
+                "  npm install kokoro-js\n" +
+                "or pass your own engine via createDemo({ tts })");
+        }
+        await redirectModelCache();
+        return mod.KokoroTTS.from_pretrained(model, { dtype: "q8", device: "cpu" });
+    })());
+    return {
+        id: `kokoro:${model}:q8`,
+        async synthesize(text, { voice = DEFAULT_VOICE, speed = 1 } = {}) {
+            const tts = await load();
+            const parts = [];
+            let sampleRate = 24000;
+            for (const sentence of splitSentences(text)) {
+                const out = await tts.generate(sentence, { voice, speed });
+                parts.push(out.audio);
+                sampleRate = out.sampling_rate;
+            }
+            const total = parts.reduce((n, p) => n + p.length, 0);
+            const audio = new Float32Array(total);
+            let offset = 0;
+            for (const p of parts) {
+                audio.set(p, offset);
+                offset += p.length;
+            }
+            return { audio, sampleRate };
+        },
+    };
+}
+/** Encode mono float samples as a 16-bit PCM WAV file. */
+export function toWav({ audio, sampleRate }) {
+    const n = audio.length;
+    const buf = Buffer.alloc(44 + n * 2);
+    buf.write("RIFF", 0);
+    buf.writeUInt32LE(36 + n * 2, 4);
+    buf.write("WAVE", 8);
+    buf.write("fmt ", 12);
+    buf.writeUInt32LE(16, 16); // chunk size
+    buf.writeUInt16LE(1, 20); // PCM
+    buf.writeUInt16LE(1, 22); // mono
+    buf.writeUInt32LE(sampleRate, 24);
+    buf.writeUInt32LE(sampleRate * 2, 28); // byte rate
+    buf.writeUInt16LE(2, 32); // block align
+    buf.writeUInt16LE(16, 34); // bits per sample
+    buf.write("data", 36);
+    buf.writeUInt32LE(n * 2, 40);
+    for (let i = 0; i < n; i++) {
+        const s = Math.max(-1, Math.min(1, audio[i]));
+        buf.writeInt16LE(Math.round(s < 0 ? s * 0x8000 : s * 0x7fff), 44 + i * 2);
+    }
+    return buf;
+}
+/** Synthesize (or fetch from cache) one narration clip. */
+export async function synthesizeClip(engine, text, opts) {
+    const voice = opts.voice ?? DEFAULT_VOICE;
+    const speed = opts.speed ?? 1;
+    const key = createHash("sha1").update([engine.id, voice, String(speed), text].join("\0")).digest("hex");
+    const dir = join(cacheDir(), "tts");
+    mkdirSync(dir, { recursive: true });
+    const file = join(dir, `${key}.wav`);
+    const meta = `${file}.json`;
+    if (existsSync(file) && existsSync(meta)) {
+        return { file, seconds: JSON.parse(readFileSync(meta, "utf8")).seconds };
+    }
+    const audio = await engine.synthesize(text, { voice, speed });
+    const seconds = audio.audio.length / audio.sampleRate;
+    writeFileSync(file, toWav(audio));
+    writeFileSync(meta, JSON.stringify({ seconds, text, voice, speed, engine: engine.id }));
+    return { file, seconds };
+}
+/** Replace words the TTS mispronounces, e.g. { Reelscript: "Reel script" }. */
+export function applyPronunciations(text, map) {
+    if (!map)
+        return text;
+    let out = text;
+    for (const [word, spoken] of Object.entries(map))
+        out = out.split(word).join(spoken);
+    return out;
+}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@reelscript/cli",
+  "version": "0.1.0",
+  "description": "Product demos as code. Write a script, render a demo, re-run it in CI when your UI changes.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Trevin Lee",
+  "keywords": [
+    "demo",
+    "screencast",
+    "screen-recording",
+    "video",
+    "automation",
+    "playwright",
+    "demo-as-code"
+  ],
+  "bin": {
+    "reelscript": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "assets"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "example": "npm run build && tsx examples/basic.ts",
+    "preview": "tsx src/cli.ts preview examples/basic.ts",
+    "test": "node --import tsx --test test/*.test.ts",
+    "prepublishOnly": "npm run build && npm test",
+    "example:terminal": "npm run build && tsx examples/terminal.ts",
+    "example:desktop": "npm run build && tsx examples/desktop.ts"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@xterm/addon-fit": "^0.11.0",
+    "@xterm/xterm": "^6.0.0",
+    "ffmpeg-static": "^5.3.0",
+    "playwright": "^1.63.0",
+    "sharp": "^0.34.5",
+    "tsx": "^4.23.15"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.2",
+    "typescript": "^7.0.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/trevin-lee/reelscript.git"
+  },
+  "homepage": "https://github.com/trevin-lee/reelscript#readme",
+  "bugs": {
+    "url": "https://github.com/trevin-lee/reelscript/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "optionalDependencies": {
+    "kokoro-js": "^1.2.1"
+  }
+}