qa-video 1.0.0

package/README.md

@@ -0,0 +1,112 @@
+# QA Video Generator
+
+Generate flashcard-style videos from YAML Q&A files with offline neural TTS narration. Designed for interview preparation — provide your questions and answers, get a YouTube-ready MP4.
+
+## How it works
+
+1. **Parse** YAML file with questions and answers
+2. **Synthesize** speech for each Q&A using [Kokoro TTS](https://github.com/hexgrad/kokoro) (offline, neural, 82M params)
+3. **Render** styled slides as 1920x1080 PNGs using Skia canvas
+4. **Assemble** video with FFmpeg — H.264 High Profile, AAC audio, YouTube-optimized
+
+Each card shows the question (with voiceover), pauses, then shows the answer (with voiceover), then moves to the next card.
+
+## Prerequisites
+
+- **Node.js** 18+
+- **pnpm** (or npm/yarn)
+- **FFmpeg** — `brew install ffmpeg`
+- **espeak-ng** — `brew install espeak-ng` (required by Kokoro TTS phonemizer)
+
+## Install
+
+```bash
+pnpm install
+pnpm build
+```
+
+## Usage
+
+### Single file
+
+```bash
+node dist/index.js generate -i qa/core-concepts.yaml
+```
+
+### All files in a directory
+
+```bash
+node dist/index.js batch -d qa/
+```
+
+### Clear cached artifacts
+
+```bash
+node dist/index.js clear              # clear all caches
+node dist/index.js clear -i qa/test.yaml  # clear cache for one file
+node dist/index.js clear -d qa/          # clear caches for all files in dir
+```
+
+### Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--voice <name>` | `af_heart` | Kokoro TTS voice |
+| `--question-delay <sec>` | `2` | Silence after question speech |
+| `--answer-delay <sec>` | `3` | Silence after answer speech |
+| `--card-gap <sec>` | `1` | Gap between cards |
+| `--font-size <px>` | `52` | Slide text font size |
+| `--force` | `false` | Regenerate all artifacts, ignore cache |
+
+## YAML Format
+
+```yaml
+config:
+  questionDelay: 2
+  answerDelay: 3
+questions:
+- question: What is DevOps?
+  answer: DevOps is a set of practices that combine software development and IT operations.
+- question: What is Docker?
+  answer: Docker is a platform for containerizing applications.
+```
+
+Config values in the YAML override defaults but CLI flags take priority.
+
+## Caching
+
+Artifacts (WAV audio, PNG slides, MP4 clips) are cached in `output/.tmp/` with SHA-based filenames. If the pipeline is interrupted, re-running reuses all previously generated artifacts. Only changed questions get regenerated. Use `--force` to bypass the cache or `clear` command to remove it.
+
+## Output
+
+- **Format:** MP4 (H.264 High Profile + AAC)
+- **Resolution:** 1920x1080 @ 30fps
+- **Audio:** 384kbps stereo, 48kHz
+- **Optimized:** `-movflags +faststart`, `-tune stillimage`
+
+Videos are saved to `output/<filename>.mp4`.
+
+## Architecture
+
+```
+src/
+├── index.ts      # CLI entry point (commander)
+├── types.ts      # Shared types & defaults
+├── parser.ts     # YAML parser
+├── tts.ts        # Kokoro TTS synthesis
+├── renderer.ts   # Slide rendering (@napi-rs/canvas)
+├── assembler.ts  # FFmpeg video assembly
+├── pipeline.ts   # 4-stage orchestration
+└── cache.ts      # SHA-based artifact caching
+```
+
+## Tech Stack
+
+- **TTS:** [kokoro-js](https://www.npmjs.com/package/kokoro-js) — offline neural TTS, Apache 2.0
+- **Canvas:** [@napi-rs/canvas](https://www.npmjs.com/package/@napi-rs/canvas) — Skia-based, zero system deps
+- **Video:** [fluent-ffmpeg](https://www.npmjs.com/package/fluent-ffmpeg) + system FFmpeg
+- **CLI:** [commander](https://www.npmjs.com/package/commander)
+
+## License
+
+MIT

package/dist/assembler.d.ts

@@ -0,0 +1,4 @@
+import { Segment } from './types.js';
+export declare function createSegmentClip(segment: Segment, outputPath: string): Promise<void>;
+export declare function createSilentClip(imagePath: string, durationSec: number, outputPath: string): Promise<void>;
+export declare function concatenateClips(clipPaths: string[], outputPath: string, tempDir: string): Promise<void>;

package/dist/assembler.js

@@ -0,0 +1,80 @@
+import { join } from 'path';
+import { writeFile } from 'fs/promises';
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+import { getFfmpegPath } from './ffmpeg-paths.js';
+const execFileAsync = promisify(execFile);
+async function getFfmpeg() {
+    const ffmpeg = await import('fluent-ffmpeg');
+    return ffmpeg.default;
+}
+export async function createSegmentClip(segment, outputPath) {
+    const FfmpegCommand = await getFfmpeg();
+    return new Promise((resolve, reject) => {
+        FfmpegCommand()
+            .input(segment.imagePath)
+            .inputOptions(['-loop', '1'])
+            .input(segment.audioPath)
+            .outputOptions([
+            '-c:v', 'libx264',
+            '-tune', 'stillimage',
+            '-c:a', 'aac',
+            '-b:a', '384k',
+            '-ar', '48000',
+            '-ac', '2',
+            '-pix_fmt', 'yuv420p',
+            '-shortest',
+            '-t', String(segment.totalDuration),
+            '-r', '30',
+        ])
+            .output(outputPath)
+            .on('end', () => resolve())
+            .on('error', (err) => reject(err))
+            .run();
+    });
+}
+export async function createSilentClip(imagePath, durationSec, outputPath) {
+    await execFileAsync(getFfmpegPath(), [
+        '-y',
+        '-loop', '1', '-i', imagePath,
+        '-f', 'lavfi', '-i', 'anullsrc=r=48000:cl=stereo',
+        '-c:v', 'libx264', '-tune', 'stillimage',
+        '-c:a', 'aac', '-b:a', '384k', '-ar', '48000', '-ac', '2',
+        '-pix_fmt', 'yuv420p',
+        '-t', String(durationSec),
+        '-r', '30',
+        outputPath,
+    ]);
+}
+export async function concatenateClips(clipPaths, outputPath, tempDir) {
+    const FfmpegCommand = await getFfmpeg();
+    // Write concat list file
+    const concatListPath = join(tempDir, 'concat_list.txt');
+    const concatContent = clipPaths.map(p => `file '${p}'`).join('\n');
+    await writeFile(concatListPath, concatContent, 'utf-8');
+    return new Promise((resolve, reject) => {
+        FfmpegCommand()
+            .input(concatListPath)
+            .inputOptions(['-f', 'concat', '-safe', '0'])
+            .outputOptions([
+            '-c:v', 'libx264',
+            '-crf', '18',
+            '-preset', 'medium',
+            '-profile:v', 'high',
+            '-level', '4.0',
+            '-tune', 'stillimage',
+            '-c:a', 'aac',
+            '-b:a', '384k',
+            '-ar', '48000',
+            '-ac', '2',
+            '-pix_fmt', 'yuv420p',
+            '-movflags', '+faststart',
+            '-r', '30',
+        ])
+            .output(outputPath)
+            .on('end', () => resolve())
+            .on('error', (err) => reject(err))
+            .run();
+    });
+}
+//# sourceMappingURL=assembler.js.map

package/dist/assembler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembler.js","sourceRoot":"","sources":["../src/assembler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,KAAK,UAAU,SAAS;IACtB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;IAC7C,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAgB,EAChB,UAAkB;IAElB,MAAM,aAAa,GAAG,MAAM,SAAS,EAAE,CAAC;IAExC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,aAAa,EAAE;aACZ,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;aACxB,YAAY,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;aAC5B,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;aACxB,aAAa,CAAC;YACb,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,YAAY;YACrB,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,MAAM;YACd,KAAK,EAAE,OAAO;YACd,KAAK,EAAE,GAAG;YACV,UAAU,EAAE,SAAS;YACrB,WAAW;YACX,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC;YACnC,IAAI,EAAE,IAAI;SACX,CAAC;aACD,MAAM,CAAC,UAAU,CAAC;aAClB,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;aAC1B,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;aACxC,GAAG,EAAE,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,SAAiB,EACjB,WAAmB,EACnB,UAAkB;IAElB,MAAM,aAAa,CAAC,aAAa,EAAE,EAAE;QACnC,IAAI;QACJ,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS;QAC7B,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,4BAA4B;QACjD,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY;QACxC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG;QACzD,UAAU,EAAE,SAAS;QACrB,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC;QACzB,IAAI,EAAE,IAAI;QACV,UAAU;KACX,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,SAAmB,EACnB,UAAkB,EAClB,OAAe;IAEf,MAAM,aAAa,GAAG,MAAM,SAAS,EAAE,CAAC;IAExC,yBAAyB;IACzB,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;IACxD,MAAM,aAAa,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnE,MAAM,SAAS,CAAC,cAAc,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;IAExD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,aAAa,EAAE;aACZ,KAAK,CAAC,cAAc,CAAC;aACrB,YAAY,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;aAC5C,aAAa,CAAC;YACb,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,QAAQ;YACnB,YAAY,EAAE,MAAM;YACpB,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,YAAY;YACrB,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,MAAM;YACd,KAAK,EAAE,OAAO;YACd,KAAK,EAAE,GAAG;YACV,UAAU,EAAE,SAAS;YACrB,WAAW,EAAE,YAAY;YACzB,IAAI,EAAE,IAAI;SACX,CAAC;aACD,MAAM,CAAC,UAAU,CAAC;aAClB,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;aAC1B,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;aACxC,GAAG,EAAE,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cache.d.ts

@@ -0,0 +1,6 @@
+/** Short SHA-8 hash of content for cache keys */
+export declare function sha(content: string): string;
+/** Build a cache-keyed filename: <prefix>_<sha>.<ext> */
+export declare function cachedPath(tempDir: string, prefix: string, hashContent: string, ext: string): string;
+/** Returns true if the file exists and force=false (i.e., cached and valid) */
+export declare function isCached(filePath: string, force: boolean): boolean;

package/dist/cache.js

@@ -0,0 +1,16 @@
+import { createHash } from 'crypto';
+import { existsSync } from 'fs';
+import { join } from 'path';
+/** Short SHA-8 hash of content for cache keys */
+export function sha(content) {
+    return createHash('sha256').update(content).digest('hex').substring(0, 8);
+}
+/** Build a cache-keyed filename: <prefix>_<sha>.<ext> */
+export function cachedPath(tempDir, prefix, hashContent, ext) {
+    return join(tempDir, `${prefix}_${sha(hashContent)}.${ext}`);
+}
+/** Returns true if the file exists and force=false (i.e., cached and valid) */
+export function isCached(filePath, force) {
+    return !force && existsSync(filePath);
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,iDAAiD;AACjD,MAAM,UAAU,GAAG,CAAC,OAAe;IACjC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,MAAc,EAAE,WAAmB,EAAE,GAAW;IAC1F,OAAO,IAAI,CAAC,OAAO,EAAE,GAAG,MAAM,IAAI,GAAG,CAAC,WAAW,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,QAAQ,CAAC,QAAgB,EAAE,KAAc;IACvD,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC;AACxC,CAAC"}

package/dist/ffmpeg-paths.d.ts

@@ -0,0 +1,3 @@
+export declare function ensureDeps(): Promise<void>;
+export declare function getFfmpegPath(): string;
+export declare function getFfprobePath(): string;

package/dist/ffmpeg-paths.js

@@ -0,0 +1,59 @@
+import { execFileSync } from 'child_process';
+function which(bin) {
+    try {
+        return execFileSync('which', [bin], { encoding: 'utf-8' }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+async function resolveFfmpegPath() {
+    try {
+        const mod = await import('ffmpeg-static');
+        if (mod.default)
+            return mod.default;
+    }
+    catch { }
+    return process.env.FFMPEG_PATH || which('ffmpeg');
+}
+async function resolveFfprobePath() {
+    try {
+        const mod = await import('@ffprobe-installer/ffprobe');
+        if (mod.path)
+            return mod.path;
+    }
+    catch { }
+    return process.env.FFPROBE_PATH || which('ffprobe');
+}
+let _ffmpegPath = null;
+let _ffprobePath = null;
+export async function ensureDeps() {
+    _ffmpegPath = await resolveFfmpegPath();
+    _ffprobePath = await resolveFfprobePath();
+    if (!_ffmpegPath) {
+        console.error('Error: ffmpeg not found.\n' +
+            '  Install: brew install ffmpeg (macOS) / sudo apt install ffmpeg (Linux)\n' +
+            '  Or set FFMPEG_PATH environment variable.');
+        process.exit(1);
+    }
+    if (!_ffprobePath) {
+        console.error('Error: ffprobe not found.\n' +
+            '  Install ffmpeg (includes ffprobe):\n' +
+            '    brew install ffmpeg (macOS) / sudo apt install ffmpeg (Linux)\n' +
+            '  Or set FFPROBE_PATH environment variable.');
+        process.exit(1);
+    }
+    process.env.FFMPEG_PATH = _ffmpegPath;
+    process.env.FFPROBE_PATH = _ffprobePath;
+}
+export function getFfmpegPath() {
+    if (!_ffmpegPath)
+        throw new Error('Call ensureDeps() first');
+    return _ffmpegPath;
+}
+export function getFfprobePath() {
+    if (!_ffprobePath)
+        throw new Error('Call ensureDeps() first');
+    return _ffprobePath;
+}
+//# sourceMappingURL=ffmpeg-paths.js.map

package/dist/ffmpeg-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffmpeg-paths.js","sourceRoot":"","sources":["../src/ffmpeg-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,SAAS,KAAK,CAAC,GAAW;IACxB,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB;IAC9B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QAC1C,IAAI,GAAG,CAAC,OAAO;YAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IACV,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;AACpD,CAAC;AAED,KAAK,UAAU,kBAAkB;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;QACvD,IAAI,GAAG,CAAC,IAAI;YAAE,OAAO,GAAG,CAAC,IAAI,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IACV,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;AACtD,CAAC;AAED,IAAI,WAAW,GAAkB,IAAI,CAAC;AACtC,IAAI,YAAY,GAAkB,IAAI,CAAC;AAEvC,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,WAAW,GAAG,MAAM,iBAAiB,EAAE,CAAC;IACxC,YAAY,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAE1C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,CAAC,KAAK,CACX,4BAA4B;YAC5B,4EAA4E;YAC5E,4CAA4C,CAC7C,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CACX,6BAA6B;YAC7B,wCAAwC;YACxC,qEAAqE;YACrE,6CAA6C,CAC9C,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,WAAW,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,YAAY,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,WAAW;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7D,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC9D,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,212 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { resolve, basename, dirname, join } from 'path';
+import { existsSync, mkdirSync, readdirSync } from 'fs';
+import { rm } from 'fs/promises';
+import { createRequire } from 'module';
+import { runPipeline } from './pipeline.js';
+import { DEFAULT_CONFIG } from './types.js';
+import { ensureDeps } from './ffmpeg-paths.js';
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
+const program = new Command();
+program
+    .name('qa-video')
+    .description('Generate flashcard videos from YAML Q&A files with TTS narration')
+    .version(pkg.version);
+function buildConfig(inputPath, opts) {
+    const inputName = basename(inputPath, '.yaml').replace(/\.yml$/, '');
+    const outputPath = opts.output
+        ? resolve(opts.output)
+        : join(dirname(inputPath), '..', 'output', `${inputName}.mp4`);
+    const outputDir = dirname(outputPath);
+    mkdirSync(outputDir, { recursive: true });
+    const tempDir = opts.tempDir
+        ? resolve(opts.tempDir)
+        : join(dirname(outputPath), '.tmp', inputName);
+    mkdirSync(tempDir, { recursive: true });
+    return {
+        inputPath,
+        outputPath,
+        tempDir,
+        voice: opts.voice,
+        questionDelay: parseFloat(opts.questionDelay),
+        answerDelay: parseFloat(opts.answerDelay),
+        cardGap: parseFloat(opts.cardGap),
+        fontSize: parseInt(opts.fontSize),
+        backgroundColor: DEFAULT_CONFIG.backgroundColor,
+        questionColor: DEFAULT_CONFIG.questionColor,
+        answerColor: DEFAULT_CONFIG.answerColor,
+        textColor: DEFAULT_CONFIG.textColor,
+        width: DEFAULT_CONFIG.width,
+        height: DEFAULT_CONFIG.height,
+        force: opts.force ?? false,
+    };
+}
+const sharedOptions = (cmd) => cmd
+    .option('--voice <name>', `TTS voice name`, DEFAULT_CONFIG.voice)
+    .option('--question-delay <seconds>', 'Pause after question speech', String(DEFAULT_CONFIG.questionDelay))
+    .option('--answer-delay <seconds>', 'Pause after answer speech', String(DEFAULT_CONFIG.answerDelay))
+    .option('--card-gap <seconds>', 'Gap between cards', String(DEFAULT_CONFIG.cardGap))
+    .option('--font-size <px>', 'Font size for slide text', String(DEFAULT_CONFIG.fontSize))
+    .option('--temp-dir <path>', 'Temporary directory for intermediate files', '')
+    .option('--force', 'Regenerate all artifacts, ignoring cache', false);
+// Single file
+sharedOptions(program
+    .command('generate')
+    .description('Generate a video from a single YAML Q&A file')
+    .requiredOption('-i, --input <path>', 'Path to YAML file')
+    .option('-o, --output <path>', 'Output video file path')).action(async (opts) => {
+    try {
+        const inputPath = resolve(opts.input);
+        if (!existsSync(inputPath)) {
+            console.error(`Error: Input file not found: ${inputPath}`);
+            process.exit(1);
+        }
+        const config = buildConfig(inputPath, opts);
+        console.log(`\n╔══════════════════════════════════╗`);
+        console.log(`║      QA Video Generator          ║`);
+        console.log(`╚══════════════════════════════════╝`);
+        console.log(`Input:  ${config.inputPath}`);
+        console.log(`Output: ${config.outputPath}`);
+        await runPipeline(config);
+    }
+    catch (err) {
+        console.error(`\nError: ${err.message}`);
+        if (process.env.DEBUG)
+            console.error(err.stack);
+        process.exit(1);
+    }
+});
+// Batch: all files in a directory
+sharedOptions(program
+    .command('batch')
+    .description('Generate videos for all YAML files in a directory')
+    .requiredOption('-d, --dir <path>', 'Directory containing YAML files')
+    .option('-o, --output-dir <path>', 'Output directory for videos')).action(async (opts) => {
+    try {
+        const dirPath = resolve(opts.dir);
+        if (!existsSync(dirPath)) {
+            console.error(`Error: Directory not found: ${dirPath}`);
+            process.exit(1);
+        }
+        const yamlFiles = readdirSync(dirPath)
+            .filter(f => f.endsWith('.yaml') || f.endsWith('.yml'))
+            .sort();
+        if (yamlFiles.length === 0) {
+            console.error(`Error: No YAML files found in: ${dirPath}`);
+            process.exit(1);
+        }
+        console.log(`\n╔══════════════════════════════════╗`);
+        console.log(`║   QA Video Generator — Batch     ║`);
+        console.log(`╚══════════════════════════════════╝`);
+        console.log(`Directory: ${dirPath}`);
+        console.log(`Files:     ${yamlFiles.length}`);
+        console.log(`Files:     ${yamlFiles.join(', ')}`);
+        const batchStart = Date.now();
+        const results = [];
+        for (let fi = 0; fi < yamlFiles.length; fi++) {
+            const file = yamlFiles[fi];
+            const inputPath = join(dirPath, file);
+            console.log(`\n${'═'.repeat(60)}`);
+            console.log(`  FILE ${fi + 1}/${yamlFiles.length}: ${file}`);
+            console.log(`${'═'.repeat(60)}`);
+            const fileStart = Date.now();
+            try {
+                const fileOpts = {
+                    ...opts,
+                    output: opts.outputDir
+                        ? join(resolve(opts.outputDir), basename(file, '.yaml').replace(/\.yml$/, '') + '.mp4')
+                        : undefined,
+                };
+                const config = buildConfig(inputPath, fileOpts);
+                console.log(`Output: ${config.outputPath}`);
+                await runPipeline(config);
+                const timeStr = ((Date.now() - fileStart) / 1000).toFixed(1) + 's';
+                results.push({ file, status: 'OK', time: timeStr });
+            }
+            catch (err) {
+                const timeStr = ((Date.now() - fileStart) / 1000).toFixed(1) + 's';
+                results.push({ file, status: `FAILED: ${err.message}`, time: timeStr });
+                console.error(`  Error processing ${file}: ${err.message}`);
+            }
+        }
+        // Batch summary
+        const totalTime = ((Date.now() - batchStart) / 1000).toFixed(1);
+        const ok = results.filter(r => r.status === 'OK').length;
+        const failed = results.length - ok;
+        console.log(`\n${'═'.repeat(60)}`);
+        console.log(`  BATCH SUMMARY`);
+        console.log(`${'═'.repeat(60)}`);
+        for (const r of results) {
+            const icon = r.status === 'OK' ? 'OK' : 'FAIL';
+            console.log(`  [${icon}] ${r.file} (${r.time})`);
+        }
+        console.log(`\n  Total: ${ok} succeeded, ${failed} failed, ${totalTime}s elapsed`);
+        if (failed > 0)
+            process.exit(1);
+    }
+    catch (err) {
+        console.error(`\nError: ${err.message}`);
+        if (process.env.DEBUG)
+            console.error(err.stack);
+        process.exit(1);
+    }
+});
+// Clear cached artifacts
+program
+    .command('clear')
+    .description('Remove cached artifacts (temp files)')
+    .option('-d, --dir <path>', 'YAML directory (clears all caches for that dir)')
+    .option('-i, --input <path>', 'Single YAML file (clears cache for that file)')
+    .option('--output-dir <path>', 'Output directory containing .tmp folder')
+    .action(async (opts) => {
+    try {
+        const targets = [];
+        if (opts.input) {
+            const inputPath = resolve(opts.input);
+            const inputName = basename(inputPath, '.yaml').replace(/\.yml$/, '');
+            const tmpDir = opts.outputDir
+                ? join(resolve(opts.outputDir), '.tmp', inputName)
+                : join(dirname(inputPath), '..', 'output', '.tmp', inputName);
+            targets.push(tmpDir);
+        }
+        else if (opts.dir) {
+            const dirPath = resolve(opts.dir);
+            const yamlFiles = readdirSync(dirPath).filter(f => f.endsWith('.yaml') || f.endsWith('.yml'));
+            for (const file of yamlFiles) {
+                const inputName = basename(file, '.yaml').replace(/\.yml$/, '');
+                const tmpDir = opts.outputDir
+                    ? join(resolve(opts.outputDir), '.tmp', inputName)
+                    : join(dirname(join(dirPath, file)), '..', 'output', '.tmp', inputName);
+                targets.push(tmpDir);
+            }
+        }
+        else {
+            // Default: clear all .tmp under output/
+            const defaultTmp = join(process.cwd(), 'output', '.tmp');
+            targets.push(defaultTmp);
+        }
+        let cleared = 0;
+        for (const dir of targets) {
+            if (existsSync(dir)) {
+                await rm(dir, { recursive: true, force: true });
+                console.log(`  Removed: ${dir}`);
+                cleared++;
+            }
+        }
+        if (cleared === 0) {
+            console.log('  No cached artifacts found.');
+        }
+        else {
+            console.log(`\n  Cleared ${cleared} cache(s).`);
+        }
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+});
+await ensureDeps();
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/parser.d.ts

@@ -0,0 +1,2 @@
+import { YamlInput } from './types.js';
+export declare function parseYamlFile(filePath: string): Promise<YamlInput>;

package/dist/parser.js

@@ -0,0 +1,32 @@
+import { readFile } from 'fs/promises';
+import { parse } from 'yaml';
+export async function parseYamlFile(filePath) {
+    const content = await readFile(filePath, 'utf-8');
+    const data = parse(content);
+    if (!data || typeof data !== 'object') {
+        throw new Error(`Invalid YAML file: ${filePath}`);
+    }
+    // Support both "questions" and "cards" array keys
+    const questions = data.questions || data.cards || [];
+    if (!Array.isArray(questions) || questions.length === 0) {
+        throw new Error(`No questions found in: ${filePath}`);
+    }
+    // Normalize card fields: support both q/a and question/answer
+    const normalizedQuestions = questions.map((card, i) => {
+        const question = card.question || card.q;
+        const answer = card.answer || card.a;
+        if (!question || !answer) {
+            throw new Error(`Card ${i + 1} is missing question or answer`);
+        }
+        return {
+            question: String(question).trim(),
+            answer: String(answer).trim(),
+        };
+    });
+    const config = data.config || {};
+    return {
+        config,
+        questions: normalizedQuestions,
+    };
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAG7B,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB;IAClD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAE5B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,sBAAsB,QAAQ,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,kDAAkD;IAClD,MAAM,SAAS,GAAe,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAEjE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,8DAA8D;IAC9D,MAAM,mBAAmB,GAAe,SAAS,CAAC,GAAG,CAAC,CAAC,IAAS,EAAE,CAAS,EAAE,EAAE;QAC7E,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC;QAErC,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;QACjE,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE;YACjC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE;SAC9B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAe,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;IAE7C,OAAO;QACL,MAAM;QACN,SAAS,EAAE,mBAAmB;KAC/B,CAAC;AACJ,CAAC"}

package/dist/pipeline.d.ts

@@ -0,0 +1,2 @@
+import { PipelineConfig } from './types.js';
+export declare function runPipeline(config: PipelineConfig): Promise<void>;

package/dist/pipeline.js

@@ -0,0 +1,205 @@
+import { mkdirSync, existsSync } from 'fs';
+import { parseYamlFile } from './parser.js';
+import { initTTS, synthesize, getAudioDuration } from './tts.js';
+import { renderSlide } from './renderer.js';
+import { createSegmentClip, createSilentClip, concatenateClips } from './assembler.js';
+import { DEFAULT_CONFIG } from './types.js';
+import { sha, cachedPath, isCached } from './cache.js';
+function elapsed(start) {
+    return ((Date.now() - start) / 1000).toFixed(1);
+}
+function formatDuration(seconds) {
+    const m = Math.floor(seconds / 60);
+    const s = Math.floor(seconds % 60);
+    return m > 0 ? `${m}m ${s}s` : `${s}s`;
+}
+export async function runPipeline(config) {
+    const pipelineStart = Date.now();
+    const { force } = config;
+    if (!existsSync(config.tempDir)) {
+        mkdirSync(config.tempDir, { recursive: true });
+    }
+    // ── Stage 1: Parse YAML ──
+    const stage1Start = Date.now();
+    console.log('\n── Stage 1/4: Parsing YAML ──');
+    const yamlData = await parseYamlFile(config.inputPath);
+    const cards = yamlData.questions;
+    const yamlConfig = yamlData.config;
+    if (yamlConfig.questionDelay !== undefined && config.questionDelay === DEFAULT_CONFIG.questionDelay) {
+        config.questionDelay = yamlConfig.questionDelay;
+    }
+    if (yamlConfig.answerDelay !== undefined && config.answerDelay === DEFAULT_CONFIG.answerDelay) {
+        config.answerDelay = yamlConfig.answerDelay;
+    }
+    if (yamlConfig.voice && config.voice === DEFAULT_CONFIG.voice) {
+        config.voice = yamlConfig.voice;
+    }
+    console.log(`  Cards: ${cards.length}`);
+    console.log(`  Voice: ${config.voice}`);
+    console.log(`  Delays: question=${config.questionDelay}s, answer=${config.answerDelay}s, gap=${config.cardGap}s`);
+    if (force)
+        console.log(`  Force: regenerating all artifacts`);
+    console.log(`  Stage 1 done (${elapsed(stage1Start)}s)`);
+    // ── Stage 2: Synthesize speech ──
+    const stage2Start = Date.now();
+    console.log('\n── Stage 2/4: Synthesizing speech ──');
+    let ttsInitialized = false;
+    const segments = [];
+    let totalAudioDuration = 0;
+    let cachedAudioCount = 0;
+    for (let i = 0; i < cards.length; i++) {
+        const card = cards[i];
+        const progress = `[${i + 1}/${cards.length}]`;
+        // Question audio — SHA keyed on text + voice
+        const qAudioHash = `audio:${card.question}:${config.voice}`;
+        const qAudioPath = cachedPath(config.tempDir, `q_${i}`, qAudioHash, 'wav');
+        if (isCached(qAudioPath, force)) {
+            const qDuration = await getAudioDuration(qAudioPath);
+            totalAudioDuration += qDuration;
+            console.log(`  ${progress} Q: "${card.question.substring(0, 50)}..." (cached, ${qDuration.toFixed(1)}s)`);
+            cachedAudioCount++;
+            segments.push({
+                type: 'question', text: card.question, cardIndex: i, totalCards: cards.length,
+                audioPath: qAudioPath, imagePath: '', audioDuration: qDuration,
+                totalDuration: qDuration + config.questionDelay,
+            });
+        }
+        else {
+            if (!ttsInitialized) {
+                await initTTS(config.voice);
+                ttsInitialized = true;
+            }
+            const qStart = Date.now();
+            process.stdout.write(`  ${progress} Q: "${card.question.substring(0, 50)}..." `);
+            await synthesize(card.question, qAudioPath, config.voice);
+            const qDuration = await getAudioDuration(qAudioPath);
+            totalAudioDuration += qDuration;
+            console.log(`(${qDuration.toFixed(1)}s audio, ${elapsed(qStart)}s)`);
+            segments.push({
+                type: 'question', text: card.question, cardIndex: i, totalCards: cards.length,
+                audioPath: qAudioPath, imagePath: '', audioDuration: qDuration,
+                totalDuration: qDuration + config.questionDelay,
+            });
+        }
+        // Answer audio
+        const aAudioHash = `audio:${card.answer}:${config.voice}`;
+        const aAudioPath = cachedPath(config.tempDir, `a_${i}`, aAudioHash, 'wav');
+        if (isCached(aAudioPath, force)) {
+            const aDuration = await getAudioDuration(aAudioPath);
+            totalAudioDuration += aDuration;
+            console.log(`  ${progress} A: "${card.answer.substring(0, 50)}..." (cached, ${aDuration.toFixed(1)}s)`);
+            cachedAudioCount++;
+            segments.push({
+                type: 'answer', text: card.answer, cardIndex: i, totalCards: cards.length,
+                audioPath: aAudioPath, imagePath: '', audioDuration: aDuration,
+                totalDuration: aDuration + config.answerDelay,
+            });
+        }
+        else {
+            if (!ttsInitialized) {
+                await initTTS(config.voice);
+                ttsInitialized = true;
+            }
+            const aStart = Date.now();
+            process.stdout.write(`  ${progress} A: "${card.answer.substring(0, 50)}..." `);
+            await synthesize(card.answer, aAudioPath, config.voice);
+            const aDuration = await getAudioDuration(aAudioPath);
+            totalAudioDuration += aDuration;
+            console.log(`(${aDuration.toFixed(1)}s audio, ${elapsed(aStart)}s)`);
+            segments.push({
+                type: 'answer', text: card.answer, cardIndex: i, totalCards: cards.length,
+                audioPath: aAudioPath, imagePath: '', audioDuration: aDuration,
+                totalDuration: aDuration + config.answerDelay,
+            });
+        }
+    }
+    console.log(`  Total audio: ${formatDuration(totalAudioDuration)} (${cachedAudioCount}/${segments.length} cached)`);
+    console.log(`  Stage 2 done (${elapsed(stage2Start)}s)`);
+    // ── Stage 3: Render slides ──
+    const stage3Start = Date.now();
+    console.log('\n── Stage 3/4: Rendering slides ──');
+    let cachedSlideCount = 0;
+    for (let i = 0; i < segments.length; i++) {
+        const seg = segments[i];
+        const slideHash = `slide:${seg.text}:${seg.type}:${seg.cardIndex}:${seg.totalCards}:${config.fontSize}:${config.questionColor}:${config.answerColor}:${config.textColor}`;
+        const imagePath = cachedPath(config.tempDir, `slide_${i}`, slideHash, 'png');
+        seg.imagePath = imagePath;
+        if (isCached(imagePath, force)) {
+            cachedSlideCount++;
+        }
+        else {
+            await renderSlide(imagePath, {
+                text: seg.text, type: seg.type, cardIndex: seg.cardIndex,
+                totalCards: seg.totalCards, config,
+            });
+        }
+    }
+    // Gap slide
+    const gapSlideHash = `slide:gap:${config.backgroundColor}:${config.fontSize}:${cards.length}`;
+    const gapSlidePath = cachedPath(config.tempDir, 'slide_gap', gapSlideHash, 'png');
+    if (!isCached(gapSlidePath, force)) {
+        await renderSlide(gapSlidePath, {
+            text: '', type: 'question', cardIndex: 0, totalCards: cards.length,
+            config: { ...config, questionColor: config.backgroundColor },
+        });
+    }
+    else {
+        cachedSlideCount++;
+    }
+    console.log(`  Rendered ${segments.length + 1} slides (${cachedSlideCount} cached)`);
+    console.log(`  Stage 3 done (${elapsed(stage3Start)}s)`);
+    // ── Stage 4: Assemble video ──
+    const stage4Start = Date.now();
+    console.log('\n── Stage 4/4: Assembling video ──');
+    const clipPaths = [];
+    const totalClips = segments.length + (cards.length - 1);
+    let cachedClipCount = 0;
+    for (let i = 0; i < segments.length; i++) {
+        const seg = segments[i];
+        // Clip hash: based on audio hash + slide hash + timing
+        const clipHash = `clip:${sha(`audio:${seg.text}:${config.voice}`)}:${sha(`slide:${seg.text}:${seg.type}:${seg.cardIndex}:${seg.totalCards}:${config.fontSize}:${config.questionColor}:${config.answerColor}:${config.textColor}`)}:${seg.totalDuration}`;
+        const clipPath = cachedPath(config.tempDir, `clip_${i}`, clipHash, 'mp4');
+        const clipNum = clipPaths.length + 1;
+        if (isCached(clipPath, force)) {
+            console.log(`  [${clipNum}/${totalClips}] ${seg.type} card ${seg.cardIndex + 1} (${seg.totalDuration.toFixed(1)}s) (cached)`);
+            cachedClipCount++;
+        }
+        else {
+            process.stdout.write(`  [${clipNum}/${totalClips}] ${seg.type} card ${seg.cardIndex + 1} (${seg.totalDuration.toFixed(1)}s)... `);
+            const clipStart = Date.now();
+            await createSegmentClip(seg, clipPath);
+            console.log(`done (${elapsed(clipStart)}s)`);
+        }
+        clipPaths.push(clipPath);
+        if (seg.type === 'answer' && seg.cardIndex < seg.totalCards - 1 && config.cardGap > 0) {
+            const gapHash = `gap:${sha(gapSlideHash)}:${config.cardGap}`;
+            const gapClipPath = cachedPath(config.tempDir, `gap_${i}`, gapHash, 'mp4');
+            const gapNum = clipPaths.length + 1;
+            if (isCached(gapClipPath, force)) {
+                console.log(`  [${gapNum}/${totalClips}] gap (${config.cardGap}s) (cached)`);
+                cachedClipCount++;
+            }
+            else {
+                process.stdout.write(`  [${gapNum}/${totalClips}] gap (${config.cardGap}s)... `);
+                const gapStart = Date.now();
+                await createSilentClip(gapSlidePath, config.cardGap, gapClipPath);
+                console.log(`done (${elapsed(gapStart)}s)`);
+            }
+            clipPaths.push(gapClipPath);
+        }
+    }
+    process.stdout.write(`  Concatenating ${clipPaths.length} clips... `);
+    const concatStart = Date.now();
+    await concatenateClips(clipPaths, config.outputPath, config.tempDir);
+    console.log(`done (${elapsed(concatStart)}s)`);
+    console.log(`  Clips: ${cachedClipCount}/${totalClips} cached`);
+    console.log(`  Stage 4 done (${elapsed(stage4Start)}s)`);
+    // ── Summary ──
+    const estimatedVideoDuration = segments.reduce((sum, s) => sum + s.totalDuration, 0) + (cards.length - 1) * config.cardGap;
+    console.log(`\n══ Complete ══`);
+    console.log(`  Output:   ${config.outputPath}`);
+    console.log(`  Duration: ~${formatDuration(estimatedVideoDuration)}`);
+    console.log(`  Cards:    ${cards.length}`);
+    console.log(`  Time:     ${elapsed(pipelineStart)}s`);
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"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"}

package/dist/renderer.d.ts

@@ -0,0 +1,10 @@
+import { PipelineConfig } from './types.js';
+interface SlideOptions {
+    text: string;
+    type: 'question' | 'answer';
+    cardIndex: number;
+    totalCards: number;
+    config: PipelineConfig;
+}
+export declare function renderSlide(outputPath: string, options: SlideOptions): Promise<void>;
+export {};

package/dist/renderer.js

@@ -0,0 +1,89 @@
+import { createCanvas } from '@napi-rs/canvas';
+import { writeFile } from 'fs/promises';
+function wrapText(ctx, text, maxWidth) {
+    const lines = [];
+    const paragraphs = text.split('\n');
+    for (const paragraph of paragraphs) {
+        if (paragraph.trim() === '') {
+            lines.push('');
+            continue;
+        }
+        const words = paragraph.split(/\s+/);
+        let currentLine = '';
+        for (const word of words) {
+            const testLine = currentLine ? `${currentLine} ${word}` : word;
+            const metrics = ctx.measureText(testLine);
+            if (metrics.width > maxWidth && currentLine) {
+                lines.push(currentLine);
+                currentLine = word;
+            }
+            else {
+                currentLine = testLine;
+            }
+        }
+        if (currentLine) {
+            lines.push(currentLine);
+        }
+    }
+    return lines;
+}
+export async function renderSlide(outputPath, options) {
+    const { text, type, cardIndex, totalCards, config } = options;
+    const { width, height, fontSize, textColor } = config;
+    const bgColor = type === 'question' ? config.questionColor : config.answerColor;
+    const canvas = createCanvas(width, height);
+    const ctx = canvas.getContext('2d');
+    // Background
+    ctx.fillStyle = bgColor;
+    ctx.fillRect(0, 0, width, height);
+    // Header bar
+    const headerHeight = 80;
+    ctx.fillStyle = 'rgba(0, 0, 0, 0.3)';
+    ctx.fillRect(0, 0, width, headerHeight);
+    // Header text
+    ctx.fillStyle = textColor;
+    ctx.font = `bold 28px "Arial", "Helvetica", sans-serif`;
+    ctx.textAlign = 'left';
+    ctx.fillText(`${type === 'question' ? 'QUESTION' : 'ANSWER'} ${cardIndex + 1} of ${totalCards}`, 40, 50);
+    // Type badge
+    const badgeText = type === 'question' ? 'Q' : 'A';
+    const badgeColor = type === 'question' ? '#e94560' : '#0cca4a';
+    const badgeSize = 60;
+    const badgeX = width - 100;
+    const badgeY = 10;
+    ctx.fillStyle = badgeColor;
+    ctx.beginPath();
+    ctx.roundRect(badgeX, badgeY, badgeSize, badgeSize, 12);
+    ctx.fill();
+    ctx.fillStyle = '#ffffff';
+    ctx.font = `bold 36px "Arial", "Helvetica", sans-serif`;
+    ctx.textAlign = 'center';
+    ctx.fillText(badgeText, badgeX + badgeSize / 2, badgeY + 43);
+    // Main text
+    ctx.font = `${fontSize}px "Arial", "Helvetica", sans-serif`;
+    ctx.textAlign = 'center';
+    ctx.fillStyle = textColor;
+    const maxTextWidth = width - 200;
+    const lines = wrapText(ctx, text, maxTextWidth);
+    const lineHeight = fontSize * 1.4;
+    const totalTextHeight = lines.length * lineHeight;
+    // Center vertically (below header)
+    const contentAreaTop = headerHeight;
+    const contentAreaHeight = height - contentAreaTop;
+    let startY = contentAreaTop + (contentAreaHeight - totalTextHeight) / 2 + fontSize;
+    // Clamp so text doesn't go above header
+    if (startY < contentAreaTop + fontSize + 20) {
+        startY = contentAreaTop + fontSize + 20;
+    }
+    for (const line of lines) {
+        ctx.fillText(line, width / 2, startY);
+        startY += lineHeight;
+    }
+    // Footer
+    ctx.fillStyle = 'rgba(255, 255, 255, 0.15)';
+    ctx.fillRect(0, height - 4, width, 4);
+    // Save PNG
+    const buffer = canvas.toBuffer('image/png');
+    await writeFile(outputPath, buffer);
+}
+//# sourceMappingURL=renderer.js.map

package/dist/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"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"}

package/dist/tts.d.ts

@@ -0,0 +1,3 @@
+export declare function initTTS(voice?: string): Promise<void>;
+export declare function synthesize(text: string, outputPath: string, voice: string): Promise<void>;
+export declare function getAudioDuration(filePath: string): Promise<number>;

package/dist/tts.js

@@ -0,0 +1,33 @@
+let ttsInstance = null;
+export async function initTTS(voice) {
+    const { KokoroTTS } = await import('kokoro-js');
+    console.log('Loading Kokoro TTS model (first run downloads ~80MB model)...');
+    ttsInstance = await KokoroTTS.from_pretrained('onnx-community/Kokoro-82M-v1.0-ONNX', { dtype: 'q8' });
+    console.log('TTS model loaded successfully.');
+}
+export async function synthesize(text, outputPath, voice) {
+    if (!ttsInstance) {
+        throw new Error('TTS not initialized. Call initTTS() first.');
+    }
+    const audio = await ttsInstance.generate(text, { voice });
+    audio.save(outputPath);
+}
+export async function getAudioDuration(filePath) {
+    const ffmpeg = await import('fluent-ffmpeg');
+    const FfmpegCommand = ffmpeg.default;
+    return new Promise((resolve, reject) => {
+        FfmpegCommand.ffprobe(filePath, (err, metadata) => {
+            if (err) {
+                reject(new Error(`Failed to probe audio file: ${err.message}`));
+                return;
+            }
+            const duration = metadata?.format?.duration;
+            if (typeof duration !== 'number' || isNaN(duration)) {
+                reject(new Error(`Could not determine duration for: ${filePath}`));
+                return;
+            }
+            resolve(duration);
+        });
+    });
+}
+//# sourceMappingURL=tts.js.map

package/dist/tts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tts.js","sourceRoot":"","sources":["../src/tts.ts"],"names":[],"mappings":"AAAA,IAAI,WAAW,GAAQ,IAAI,CAAC;AAE5B,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAAc;IAC1C,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC;IAC7E,WAAW,GAAG,MAAM,SAAS,CAAC,eAAe,CAC3C,qCAAqC,EACrC,EAAE,KAAK,EAAE,IAAI,EAAE,CAChB,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAY,EACZ,UAAkB,EAClB,KAAa;IAEb,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1D,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IACrD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;IAC7C,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC;IAErC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAiB,EAAE,QAAa,EAAE,EAAE;YACnE,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,CAAC,IAAI,KAAK,CAAC,+BAA+B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAChE,OAAO;YACT,CAAC;YACD,MAAM,QAAQ,GAAG,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;YAC5C,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACpD,MAAM,CAAC,IAAI,KAAK,CAAC,qCAAqC,QAAQ,EAAE,CAAC,CAAC,CAAC;gBACnE,OAAO;YACT,CAAC;YACD,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,47 @@
+export interface YamlConfig {
+    questionDelay?: number;
+    answerDelay?: number;
+    cardGap?: number;
+    voice?: string;
+    fontSize?: number;
+    backgroundColor?: string;
+    questionColor?: string;
+    answerColor?: string;
+    textColor?: string;
+}
+export interface YamlCard {
+    question: string;
+    answer: string;
+}
+export interface YamlInput {
+    config: YamlConfig;
+    questions: YamlCard[];
+}
+export interface Segment {
+    type: 'question' | 'answer';
+    text: string;
+    cardIndex: number;
+    totalCards: number;
+    audioPath: string;
+    imagePath: string;
+    audioDuration: number;
+    totalDuration: number;
+}
+export interface PipelineConfig {
+    inputPath: string;
+    outputPath: string;
+    voice: string;
+    tempDir: string;
+    questionDelay: number;
+    answerDelay: number;
+    cardGap: number;
+    fontSize: number;
+    backgroundColor: string;
+    questionColor: string;
+    answerColor: string;
+    textColor: string;
+    width: number;
+    height: number;
+    force: boolean;
+}
+export declare const DEFAULT_CONFIG: Omit<PipelineConfig, 'inputPath' | 'outputPath' | 'tempDir'>;

package/dist/types.js

@@ -0,0 +1,15 @@
+export const DEFAULT_CONFIG = {
+    voice: 'af_heart',
+    questionDelay: 2,
+    answerDelay: 3,
+    cardGap: 1,
+    fontSize: 52,
+    backgroundColor: '#1a1a2e',
+    questionColor: '#16213e',
+    answerColor: '#0f3460',
+    textColor: '#ffffff',
+    width: 1920,
+    height: 1080,
+    force: false,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAmDA,MAAM,CAAC,MAAM,cAAc,GAAiE;IAC1F,KAAK,EAAE,UAAU;IACjB,aAAa,EAAE,CAAC;IAChB,WAAW,EAAE,CAAC;IACd,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,EAAE;IACZ,eAAe,EAAE,SAAS;IAC1B,aAAa,EAAE,SAAS;IACxB,WAAW,EAAE,SAAS;IACtB,SAAS,EAAE,SAAS;IACpB,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,KAAK,EAAE,KAAK;CACb,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "qa-video",
+  "version": "1.0.0",
+  "description": "Generate flashcard videos from YAML Q&A files with TTS narration",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "qa-video": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@ffprobe-installer/ffprobe": "^2.1.2",
+    "@napi-rs/canvas": "^0.1.92",
+    "commander": "^14.0.3",
+    "ffmpeg-static": "^5.3.0",
+    "fluent-ffmpeg": "^2.1.3",
+    "fs-extra": "^11.3.3",
+    "kokoro-js": "^1.2.1",
+    "yaml": "^2.8.2"
+  },
+  "devDependencies": {
+    "@types/fluent-ffmpeg": "^2.1.28",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^25.2.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}