Skip to content

Explainer videos and product demos made by your AI agent. Free and open source: a local voice (Kokoro), word timing (Whisper) and a canvas renderer turn a script into a narrated MP4.

3.0 KB
Raw Blame
import test from 'node:test';
import assert from 'node:assert/strict';
import path from 'node:path';
import { renderFormat, renderOutput } from '../src/render.js';
import { normalizeConfig } from '../src/project.js';
import { resolveTimes, verify } from '../src/qa.js';

test('render accepts mp4, gif, webm and mov with matching output extensions', () => {
  assert.equal(renderFormat(), 'mp4');
  assert.equal(renderFormat({ out: 'x/y.mp4' }), 'mp4');
  assert.equal(renderFormat({ format: 'gif', out: 'x/y.gif' }), 'gif');
  assert.equal(renderFormat({ format: 'mp4', out: 'x/y.MP4' }), 'mp4');
  for (const format of ['webm', 'mov']) {
    assert.equal(renderFormat({ format, out: `x/y.${format}` }), format);
    assert.equal(renderFormat({ format, transparent: true }), format);
    assert.throws(() => renderFormat({ format, out: 'x/y.mp4' }), new RegExp(`\\.${format}`));
  }
  assert.throws(() => renderFormat({ format: 'avi' }), /mp4, gif, webm or mov/);
  assert.throws(() => renderFormat({ out: 'x/y.gif' }), /\.mp4/);
  assert.throws(() => renderFormat({ format: 'gif', out: 'x/y.mp4' }), /\.gif/);
  assert.throws(() => renderFormat({ out: 'x/y' }), /\.mp4/);
});

test('transparent export needs an alpha format', () => {
  for (const format of [undefined, 'mp4', 'gif']) {
    assert.throws(() => renderFormat({ format, transparent: true }), /--format webm or --format mov/);
  }
});

test('render output names follow format, draft and --out', () => {
  for (const format of ['mp4', 'gif', 'webm', 'mov']) {
    assert.equal(renderOutput({ paths: { out: '/tmp/out' } }, { format }), path.resolve(`/tmp/out/video.${format}`));
    assert.equal(renderOutput({ paths: { out: '/tmp/out' } }, { format, draft: true }), path.resolve(`/tmp/out/draft.${format}`));
    assert.equal(renderOutput({ paths: { out: '/tmp/out' } }, { format, draft: true, out: `/tmp/custom.${format}` }), path.resolve(`/tmp/custom.${format}`));
  }
  assert.equal(renderOutput({ paths: { out: '/tmp/out' } }), path.resolve('/tmp/out/video.mp4'));
});

test('cover validates its type and syntax while allowing still specs', () => {
  assert.equal(normalizeConfig({}).cover, 'auto');
  for (const cover of [0, 12.5, '12.5', 'intro', '[email protected]', 'intro@end', 'intro@start']) assert.equal(normalizeConfig({ cover }).cover, cover);
  for (const cover of [false, null, -1, Infinity, {}, '', 'intro@bad', 'intro@2@3']) assert.throws(() => normalizeConfig({ cover }), /cover must be/);
  const timeline = { duration: 8, fps: 30, scenes: [{ id: 'intro', start: 0, dur: 3 }, { id: 'next', start: 3, dur: 5 }] };
  assert.equal(resolveTimes(timeline, ['intro@end'])[0].T, 2.7);
  assert.equal(resolveTimes(timeline, ['[email protected]'])[0].T, 5.4);
  assert.equal(resolveTimes(timeline, [1e21])[0].T, 8 - 1 / 30);
  assert.throws(() => resolveTimes(timeline, ['missing']), /no scene "missing".*intro, next/);
});

test('verify explains that GIF is unsupported', async () => {
  await assert.rejects(verify({ paths: { out: '/tmp' } }, { file: '/tmp/video.gif' }), /verify checks MP4, WebM and MOV files/);
});