Write HTML. Render video. Built for agents.
JavaScript aiai-agentsanimationclaude-codeffmpegframeworkgsaphtmlhtml-to-videomcpmotion-graphicspuppeteerrenderingtypescriptvideo-editor
// @vitest-environment node
import { describe, expect, it } from "vitest";
import {
formatMeasuredNote,
parseMediaTreatmentSignalStats,
statsToAdjust,
summarizeMediaTreatmentAnalysis,
type GradeMediaProbe,
} from "./mediaGradeAnalyzer";
const SIGNALSTATS = `frame:0 pts:0 pts_time:0
lavfi.signalstats.YMIN=4
lavfi.signalstats.YLOW=8
lavfi.signalstats.YAVG=100
lavfi.signalstats.YHIGH=240
lavfi.signalstats.YMAX=250
lavfi.signalstats.UAVG=120
lavfi.signalstats.VAVG=140
lavfi.signalstats.SATAVG=40
frame:1 pts:1 pts_time:1
lavfi.signalstats.YMIN=20
lavfi.signalstats.YLOW=20
lavfi.signalstats.YAVG=120
lavfi.signalstats.YHIGH=220
lavfi.signalstats.YMAX=230
lavfi.signalstats.UAVG=125
lavfi.signalstats.VAVG=135
lavfi.signalstats.SATAVG=60`;
const UNDEREXPOSED_SIGNALSTATS = `frame:0 pts:0 pts_time:0
lavfi.signalstats.YMIN=2
lavfi.signalstats.YLOW=8
lavfi.signalstats.YAVG=50
lavfi.signalstats.YHIGH=120
lavfi.signalstats.YMAX=135
lavfi.signalstats.UAVG=128
lavfi.signalstats.VAVG=128
lavfi.signalstats.SATAVG=30`;
const BLOWN_HIGHLIGHT_SIGNALSTATS = `frame:0 pts:0 pts_time:0
lavfi.signalstats.YMIN=70
lavfi.signalstats.YLOW=90
lavfi.signalstats.YAVG=200
lavfi.signalstats.YHIGH=248
lavfi.signalstats.YMAX=255
lavfi.signalstats.UAVG=128
lavfi.signalstats.VAVG=128
lavfi.signalstats.SATAVG=30`;
const PROBE: GradeMediaProbe = {
duration: 4,
colorSpace: "bt2020nc",
transfer: "smpte2084",
primaries: "bt2020",
pixelFormat: "yuv420p10le",
};
function productResult(signalStats = SIGNALSTATS) {
const frames = parseMediaTreatmentSignalStats(signalStats);
const summary = summarizeMediaTreatmentAnalysis(PROBE, frames);
return {
frames,
summary,
adjust: statsToAdjust(summary.measured),
note: formatMeasuredNote("/tmp/frame.png", summary.measured),
};
}
async function vendoredResult(signalStats = SIGNALSTATS) {
const moduleUrl = new URL(
"../../../packages/cli/src/media-use/lib/grade-analyzer.mjs",
import.meta.url,
);
const analyzer = await import(moduleUrl.href);
const frames = analyzer.parseMediaTreatmentSignalStats(signalStats);
const summary = analyzer.summarizeMediaTreatmentAnalysis(PROBE, frames);
return {
frames,
summary,
adjust: analyzer.statsToAdjust(summary.measured),
note: analyzer.formatMeasuredNote("/tmp/frame.png", summary.measured),
};
}
describe("vendored media grade analyzer parity", () => {
it("keeps the standalone skill copy aligned with the typed product module", async () => {
expect(await vendoredResult()).toEqual(productResult());
});
it.each([
["underexposed", UNDEREXPOSED_SIGNALSTATS, 1],
["blown-highlight", BLOWN_HIGHLIGHT_SIGNALSTATS, -1],
])("covers the %s exposure branch", async (_, signalStats, expectedSign) => {
const product = productResult(signalStats);
expect(Math.sign(product.adjust.adjust.exposure)).toBe(expectedSign);
expect(await vendoredResult(signalStats)).toEqual(product);
});
});
describe("signal-stats frame headers", () => {
it.each([
["frame:123 pts:42 pts_time:-12.5", -12.5],
["frame:000pts_time:+.25", 0.25],
["frame:1 pts_time:1 pts_time:2.5", 2.5],
["frame:1 pts_time:1 pts_time:invalid", 1],
["frame:1 pts_time:12.", 12],
["frame:1 pts_time:2e3", 2],
["frame: pts_time:1", undefined],
["frame:-1 pts_time:1", undefined],
["prefix frame:1 pts_time:1", undefined],
["frame:1\u2028pts_time:1", undefined],
["frame:" + "0".repeat(100_000) + "!", undefined],
["frame:" + "0".repeat(100_000) + " pts_time:-.5", -0.5],
])("preserves header parsing (case %#)", async (header, ptsTime) => {
const raw = SIGNALSTATS.replace("frame:0 pts:0 pts_time:0", String(header));
const product = productResult(raw);
expect(product.frames).toHaveLength(2);
expect(product.frames[0]?.ptsTime).toBe(ptsTime);
expect(product.frames[1]?.ptsTime).toBe(1);
expect(await vendoredResult(raw)).toEqual(product);
});
});