Write HTML. Render video. Built for agents.
JavaScript aiai-agentsanimationclaude-codeffmpegframeworkgsaphtmlhtml-to-videomcpmotion-graphicspuppeteerrenderingtypescriptvideo-editor
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import { runCommand } from "citty";
import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { assertKnownFlags } from "../utils/reject-unknown-flags.js";
import { CliUsageError } from "../utils/commandResult.js";
const synthesizeMock = vi.fn().mockResolvedValue({
durationSeconds: 1,
langApplied: true,
outputPath: "/tmp/speech.wav",
});
vi.mock("../tts/synthesize.js", () => ({ synthesize: synthesizeMock }));
import ttsCommand from "./tts.js";
describe("tts command", () => {
let dir: string;
beforeEach(() => {
dir = mkdtempSync(join(tmpdir(), "hf-tts-command-test-"));
synthesizeMock.mockClear();
vi.spyOn(console, "log").mockImplementation(() => {});
});
afterEach(() => {
rmSync(dir, { recursive: true, force: true });
vi.restoreAllMocks();
});
it("accepts --text-file as a compatibility alias for file input", async () => {
const input = join(dir, "script.txt");
writeFileSync(input, "Legacy file input\n");
expect(() =>
assertKnownFlags(ttsCommand as never, ["--text-file", input, "--json"]),
).not.toThrow();
await ttsCommand.run!({ args: { "text-file": input, json: true } } as never);
expect(synthesizeMock).toHaveBeenCalledWith(
"Legacy file input",
expect.stringMatching(/speech\.wav$/),
expect.objectContaining({ lang: "en-us" }),
);
});
it.each(["0.05", "1x", "1.5junk", "1 2", "", " ", "NaN", "Infinity", "0", "-1", "3.01"])(
"rejects invalid speed %j before synthesis",
async (speed) => {
const errors = vi.spyOn(console, "error").mockImplementation(() => {});
await expect(
runCommand(ttsCommand, { rawArgs: ["Hello", "--speed", speed, "--json"] }),
).rejects.toThrow();
expect(synthesizeMock).not.toHaveBeenCalled();
expect(errors.mock.calls.flat().join(" ")).toContain("between 0.1 and 3.0");
},
);
it.each([
["0.1", 0.1],
["3", 3],
["1e-1", 0.1],
[" 1.25 ", 1.25],
])("uses the complete valid speed %j", async (speed, expected) => {
await runCommand(ttsCommand, { rawArgs: ["Hello", "--speed", speed, "--json"] });
expect(synthesizeMock).toHaveBeenCalledWith(
"Hello",
expect.any(String),
expect.objectContaining({ speed: expected }),
);
});
it("defaults the speed only when the argument is omitted", async () => {
await runCommand(ttsCommand, { rawArgs: ["Hello", "--json"] });
expect(synthesizeMock).toHaveBeenCalledWith(
"Hello",
expect.any(String),
expect.objectContaining({ speed: 1 }),
);
});
it("rejects text words with --text-file even under --list", async () => {
const input = join(dir, "script.txt");
writeFileSync(input, "From the file\n");
vi.spyOn(console, "error").mockImplementation(() => {});
await expect(
ttsCommand.run!({ args: { "text-file": input, input: "hello", list: true } } as never),
).rejects.toThrow(CliUsageError);
});
it("rejects text words together with --text-file instead of dropping the words", async () => {
const input = join(dir, "script.txt");
writeFileSync(input, "From the file\n");
const errorSpy = vi.spyOn(console, "error").mockImplementation(() => {});
await expect(
ttsCommand.run!({ args: { "text-file": input, input: "hello world" } } as never),
).rejects.toThrow(CliUsageError);
expect(synthesizeMock).not.toHaveBeenCalled();
expect(errorSpy.mock.calls.flat().join(" ")).toContain("not both");
});
});