@flow-player/test-streams 0.14.2 → 0.15.0

package/dist/fixtures/catalog.d.ts

@@ -1,4 +1,5 @@
 import { type CodecId, type FormatId } from "../config.js";
+import type { WindowEncodeParams } from "./window.js";
 /** manifest 内单条文件记录：相对 fixtureDir 的路径 + 字节数 + sha256。 */
 export type ManifestEntry = {
     path: string;
@@ -11,12 +12,29 @@ export type ManifestItem = {
     format: FormatId;
     entries: ReadonlyArray<ManifestEntry>;
 };
+/**
+ * P3-H 烧录窗 fixture 的 manifest 条目：单 MP4 文件 + 编码参数。
+ * entries 复用 ManifestEntry 契约（size/sha256），encode 记录 GOP/B 帧/
+ * 首 PTS/稀疏等窗口测试关心的编码参数。
+ */
+export type WindowManifestItem = {
+    /** 烧录窗 id（window/<id>.mp4 的文件名主体）。 */
+    id: string;
+    /** 视频编码。 */
+    codec: CodecId;
+    /** 单文件条目（仅主文件）。 */
+    entries: ReadonlyArray<ManifestEntry>;
+    /** 编码参数：GOP/B 帧/首 PTS/稀疏标记等。 */
+    encode: WindowEncodeParams;
+};
 /** manifest.json 顶层结构：generate.ts 负责写，catalog 负责读 + 过滤。 */
 export type Manifest = {
     version: 1;
     generatedAt: string;
     durationSeconds: number;
     fixtures: ReadonlyArray<ManifestItem>;
+    /** P3-H 烧录窗序列（可选，老 manifest 缺省为空）；只追加不改存量 fixtures。 */
+    windowFixtures?: ReadonlyArray<WindowManifestItem>;
 };
 /** lookupFixture 的查询结果：该组合的文件清单与主文件。 */
 export type FixtureLookup = {

package/dist/fixtures/catalog.js

@@ -37,6 +37,7 @@ function summarizeCatalog(fixtureDir) {
   }
   let total = 0;
   for (const item of manifest.fixtures) total += item.entries.length;
+  for (const item of manifest.windowFixtures ?? []) total += item.entries.length;
   return {
     codecs: ALL_CODECS,
     formats: ALL_FORMATS,

package/dist/fixtures/generate.d.ts

@@ -4,11 +4,11 @@ import { type Manifest } from "./catalog.js";
 export type GenerateResult = {
     /** fixture 根目录（绝对路径），manifest.json 写在其下。 */
     fixtureDir: string;
-    /** 本次写盘的 manifest：每个 codec × format 组合一条，entries 带 size/sha256。 */
+    /** 本次写盘的 manifest：每个 codec × format 组合一条，entries 带 size/sha256；另附 windowFixtures 烧录窗序列。 */
     manifest: Manifest;
-    /** 本次实际跑 ffmpeg 生成（或收集已有输出元信息）的组合数。 */
+    /** 本次实际跑 ffmpeg 生成（或收集已有输出元信息）的组合数（含烧录窗）。 */
     generated: number;
-    /** 输出已存在且未开 overwrite 而跳过的组合数。 */
+    /** 输出已存在且未开 overwrite 而跳过的组合数（含烧录窗）。 */
     skipped: number;
     /** 实际使用的 ffmpeg 可执行路径。 */
     ffmpegPath: string;
@@ -21,6 +21,9 @@ export type GenerateResult = {
  * 写到 `fixtureDir/manifest.json`。输出已存在且未开 overwrite 的组合跳过生成，
  * 但仍从磁盘收集条目进 manifest；hls/fmp4 容器目录内 ffmpeg 实际产出的段文件
  * 一并收编。开头还会从 mp4/h264.mp4 复制出 vod/sample-*.mp4 样例。
+ * 矩阵之后按 WINDOW_SPECS 顺序生成 P3-H 烧录窗 MP4 序列（window/<id>.mp4，
+ * 帧号与媒体时间经 drawtext 烧录），条目进 manifest.windowFixtures；
+ * includeWindow=false 可跳过烧录窗（快速反馈用）。
  * 找不到 ffmpeg 时不创建目录、不写盘，返回 ffmpegMissing=true 的空结果。
  */
 export declare function generateFixtures(opts?: GenerateOptions): Promise<GenerateResult>;

package/dist/fixtures/generate.js

@@ -10,7 +10,7 @@ import {
   writeFileSync
 } from "node:fs";
 import { spawn } from "node:child_process";
-import { join as join3, resolve } from "node:path";
+import { join as join4, resolve } from "node:path";
 
 // src/config.ts
 var DEFAULT_FIXTURE_DIR = "fixtures";
@@ -202,6 +202,372 @@ function expandMatrix(opts) {
 }
 var VOD_SAMPLE_RELATIVE = "mp4/h264.mp4";
 
+// src/fixtures/window.ts
+import { join as join3 } from "node:path";
+var DEFAULT_DRAWTEXT_FONT = "/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf";
+var DRAWTEXT_FONT_CANDIDATES = [
+  "/System/Library/Fonts/Supplemental/Verdana.ttf",
+  "/System/Library/Fonts/Hiragino Sans GB.ttc",
+  "/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf",
+  "/usr/share/fonts/truetype/liberation/LiberationSans-Regular.ttf"
+];
+var WINDOW_CONTAINER_DIR = "window";
+var WINDOW_SPECS = [
+  {
+    id: "h264-shortgop-bframes",
+    codec: "h264",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 6,
+    gopFrames: 25,
+    gopMode: "short",
+    bframes: 3,
+    startPtsSeconds: 5,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: true,
+    usageP3: "\u77ED GOP \u6709 B \u5E27\u57FA\u7EBF\uFF1A\u7A97\u53E3\u9010 GOP \u524D\u8FDB\u65F6\u7684\u89E3\u7801\u8D77\u70B9\u5BF9\u9F50",
+    usageP5: "\u591A\u8DEF\u5E76\u53D1\u4E0B\u7684\u5E38\u89C4\u89E3\u7801\u8D1F\u8F7D\u57FA\u7EBF"
+  },
+  {
+    id: "h264-shortgop-nobframes",
+    codec: "h264",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 6,
+    gopFrames: 25,
+    gopMode: "short",
+    bframes: 0,
+    startPtsSeconds: 5,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: false,
+    usageP3: "\u65E0 B \u5E27\u5BF9\u7167\uFF1A\u5E27\u8F93\u51FA\u65E0\u91CD\u6392\u5EF6\u8FDF\uFF0C\u6821\u9A8C PTS \u5355\u8C03\u6027",
+    usageP5: "\u4F4E\u5EF6\u8FDF\u94FE\u8DEF\u7684\u5BB9\u91CF\u5BF9\u7167\u7EC4"
+  },
+  {
+    id: "hevc-shortgop-bframes",
+    codec: "hevc",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 6,
+    gopFrames: 25,
+    gopMode: "short",
+    bframes: 3,
+    startPtsSeconds: 5,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: true,
+    usageP3: "HEVC \u77ED GOP \u6709 B \u5E27\u57FA\u7EBF\uFF1Ahvc1 \u5C01\u88C5\u4E0B\u7A97\u53E3\u63A8\u8FDB",
+    usageP5: "HEVC \u8F6F\u89E3 / \u786C\u89E3\u5BB9\u91CF\u57FA\u7EBF"
+  },
+  {
+    id: "hevc-shortgop-nobframes",
+    codec: "hevc",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 6,
+    gopFrames: 25,
+    gopMode: "short",
+    bframes: 0,
+    startPtsSeconds: 5,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: false,
+    usageP3: "HEVC \u65E0 B \u5E27\u5BF9\u7167\uFF1A\u91CD\u6392\u5173\u95ED\u65F6\u7684\u7A97\u53E3\u884C\u4E3A",
+    usageP5: "HEVC \u4F4E\u5EF6\u8FDF\u5BB9\u91CF\u5BF9\u7167\u7EC4"
+  },
+  {
+    id: "h264-longgop-bframes",
+    codec: "h264",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 10,
+    gopFrames: 125,
+    gopMode: "long",
+    bframes: 3,
+    startPtsSeconds: 10,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: true,
+    usageP3: "\u957F GOP\uFF085s\uFF09\u8DE8\u7A97 seek\uFF1A\u7A97\u53E3\u843D\u5728 GOP \u4E2D\u90E8\u65F6\u7684\u56DE\u8DF3\u8DDD\u79BB",
+    usageP5: "\u957F GOP \u4F4E\u7801\u7387\u6863\u7684\u89E3\u7801\u5BB9\u91CF"
+  },
+  {
+    id: "hevc-longgop-bframes",
+    codec: "hevc",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 10,
+    gopFrames: 125,
+    gopMode: "long",
+    bframes: 3,
+    startPtsSeconds: 10,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: true,
+    usageP3: "HEVC \u957F GOP \u8DE8\u7A97 seek \u5BF9\u7167",
+    usageP5: "HEVC \u957F GOP \u5BB9\u91CF\u6863"
+  },
+  {
+    id: "h264-singlegop",
+    codec: "h264",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 8,
+    gopFrames: 200,
+    gopMode: "single",
+    bframes: 3,
+    startPtsSeconds: 20,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: true,
+    usageP3: "\u5355 GOP \u6781\u9650\uFF1A\u7A97\u53E3\u4EFB\u610F\u70B9 seek \u5FC5\u987B\u56DE\u8DF3\u5230\u6BB5\u9996 IDR",
+    usageP5: "\u5355 GOP \u6781\u4F4E\u7801\u7387\u6863\u5BB9\u91CF"
+  },
+  {
+    id: "hevc-singlegop",
+    codec: "hevc",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 8,
+    gopFrames: 200,
+    gopMode: "single",
+    bframes: 3,
+    startPtsSeconds: 20,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: true,
+    usageP3: "HEVC \u5355 GOP \u6781\u9650\u5BF9\u7167",
+    usageP5: "HEVC \u5355 GOP \u5BB9\u91CF\u6863"
+  },
+  {
+    id: "h264-sparse-1fps",
+    codec: "h264",
+    width: 1280,
+    height: 720,
+    fps: 1,
+    durationSeconds: 8,
+    gopFrames: 4,
+    gopMode: "short",
+    bframes: 0,
+    startPtsSeconds: 30,
+    sparse: true,
+    moovTrailing: true,
+    delayedTail: false,
+    usageP3: "1fps \u7A00\u758F\u6D41\uFF1A\u7A97\u53E3\u6309\u79D2\u6B65\u8FDB\u65F6\u7684\u5E27\u53F7 / \u5A92\u4F53\u65F6\u95F4\u5BF9\u5E94",
+    usageP5: "\u7A00\u758F\u6D41\u6781\u4F4E\u5E27\u7387\u5BB9\u91CF\uFF08\u7F29\u7565\u56FE\u5F0F\u62C9\u6D41\uFF09"
+  },
+  {
+    id: "hevc-sparse-1fps",
+    codec: "hevc",
+    width: 1280,
+    height: 720,
+    fps: 1,
+    durationSeconds: 8,
+    gopFrames: 4,
+    gopMode: "short",
+    bframes: 0,
+    startPtsSeconds: 30,
+    sparse: true,
+    moovTrailing: true,
+    delayedTail: false,
+    usageP3: "HEVC 1fps \u7A00\u758F\u5BF9\u7167",
+    usageP5: "HEVC \u7A00\u758F\u6D41\u5BB9\u91CF\u6863"
+  },
+  {
+    id: "h264-gap-a",
+    codec: "h264",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 6,
+    gopFrames: 25,
+    gopMode: "short",
+    bframes: 0,
+    startPtsSeconds: 100,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: false,
+    pairKind: "gap",
+    pairRole: "a",
+    usageP3: "gap \u53CC\u6BB5\u9996\u6BB5\uFF1A\u4E0E gap-b \u4E4B\u95F4\u7559 2s \u7A7A\u6D1E\uFF0C\u6D4B\u7A97\u53E3\u7A7A\u6D1E\u5C55\u793A",
+    usageP5: "\u65AD\u6D41\u7A7A\u6D1E\u573A\u666F\u7684\u5BB9\u91CF\u5360\u6BD4\u6A21\u578B\u8F93\u5165"
+  },
+  {
+    id: "h264-gap-b",
+    codec: "h264",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 6,
+    gopFrames: 25,
+    gopMode: "short",
+    bframes: 0,
+    startPtsSeconds: 108,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: false,
+    pairKind: "gap",
+    pairRole: "b",
+    usageP3: "gap \u53CC\u6BB5\u6B21\u6BB5\uFF1A\u9996 PTS \u665A\u4E8E\u9996\u6BB5\u5C3E 2s\uFF0C\u7A97\u53E3\u5E94\u5448\u73B0\u7A7A\u6D1E",
+    usageP5: "\u540C gap-a \u914D\u5BF9\u4F7F\u7528"
+  },
+  {
+    id: "h264-overlap-a",
+    codec: "h264",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 6,
+    gopFrames: 25,
+    gopMode: "short",
+    bframes: 0,
+    startPtsSeconds: 200,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: false,
+    pairKind: "overlap",
+    pairRole: "a",
+    usageP3: "overlap \u53CC\u6BB5\u9996\u6BB5\uFF1A\u4E0E overlap-b \u91CD\u53E0 2s\uFF0C\u6D4B\u7A97\u53E3\u53BB\u91CD",
+    usageP5: "\u91CD\u53E0\u5F55\u50CF\u573A\u666F\u7684\u5BB9\u91CF\u5360\u6BD4\u6A21\u578B\u8F93\u5165"
+  },
+  {
+    id: "h264-overlap-b",
+    codec: "h264",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 6,
+    gopFrames: 25,
+    gopMode: "short",
+    bframes: 0,
+    startPtsSeconds: 204,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: false,
+    pairKind: "overlap",
+    pairRole: "b",
+    usageP3: "overlap \u53CC\u6BB5\u6B21\u6BB5\uFF1A\u9996 PTS \u65E9\u4E8E\u9996\u6BB5\u5C3E 2s\uFF0C\u7A97\u53E3\u5E94\u53BB\u91CD\u5408\u5E76",
+    usageP5: "\u540C overlap-a \u914D\u5BF9\u4F7F\u7528"
+  },
+  {
+    id: "h264-size-720p",
+    codec: "h264",
+    width: 1280,
+    height: 720,
+    fps: 25,
+    durationSeconds: 6,
+    gopFrames: 25,
+    gopMode: "short",
+    bframes: 0,
+    startPtsSeconds: 300,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: false,
+    pairKind: "sizeSwitch",
+    pairRole: "a",
+    usageP3: "\u5C3A\u5BF8\u5207\u6362\u9996\u6BB5\uFF08720p high\uFF09\uFF1A\u4E0E 360p \u6BB5\u540C\u8D77\u70B9\uFF0C\u6D4B\u7A97\u53E3\u5185\u5206\u8FA8\u7387\u5207\u6362",
+    usageP5: "\u6E05\u6670\u5EA6\u5207\u6362\u65F6\u7684\u77AC\u65F6\u89E3\u7801\u5CF0\u503C"
+  },
+  {
+    id: "h264-size-360p",
+    codec: "h264",
+    width: 640,
+    height: 360,
+    fps: 25,
+    durationSeconds: 6,
+    gopFrames: 25,
+    gopMode: "short",
+    bframes: 0,
+    startPtsSeconds: 300,
+    sparse: false,
+    moovTrailing: true,
+    delayedTail: false,
+    pairKind: "sizeSwitch",
+    pairRole: "b",
+    usageP3: "\u5C3A\u5BF8\u5207\u6362\u6B21\u6BB5\uFF08360p baseline\uFF09\uFF1A\u7F16\u7801\u914D\u7F6E\u4E0E\u5206\u8FA8\u7387\u540C\u65F6\u53D8\u5316",
+    usageP5: "\u540C size-720p \u914D\u5BF9\u4F7F\u7528"
+  }
+];
+function drawtextFilter(fontfile) {
+  return `drawtext=fontfile=${fontfile}:text='n=%{frame_num} t=%{pts\\:hms}':fontsize=28:fontcolor=white:box=1:boxcolor=black@0.6:x=16:y=16`;
+}
+function buildWindowPlan(spec, opts) {
+  const useDrawtext = opts?.useDrawtext ?? true;
+  const fontfile = opts?.fontfile ?? DEFAULT_DRAWTEXT_FONT;
+  const specCodec = CODEC_SPEC[spec.codec];
+  const videoInput = `testsrc2=size=${spec.width}x${spec.height}:rate=${spec.fps}`;
+  const audioInput = `sine=frequency=1000:sample_rate=44100`;
+  const videoFilter = useDrawtext ? `format=yuv420p,${drawtextFilter(fontfile)}` : "format=yuv420p";
+  const outputFps = spec.sparse ? 1 : spec.fps;
+  const sizeSwitchBaseline = spec.pairKind === "sizeSwitch" && spec.pairRole === "b" ? ["-profile:v", "baseline"] : specCodec.videoArgs;
+  const ffmpegOutputArgs = [
+    "-y",
+    "-f",
+    "lavfi",
+    "-i",
+    videoInput,
+    "-f",
+    "lavfi",
+    "-i",
+    audioInput,
+    "-t",
+    String(spec.durationSeconds),
+    "-vf",
+    videoFilter,
+    "-r",
+    String(outputFps),
+    "-c:v",
+    specCodec.encoder,
+    ...sizeSwitchBaseline,
+    "-pix_fmt",
+    specCodec.pixelFormat,
+    "-bf",
+    String(spec.bframes),
+    "-g",
+    String(spec.gopFrames),
+    "-keyint_min",
+    String(spec.gopFrames),
+    "-sc_threshold",
+    "0",
+    ...containerExtraArgs("mp4", spec.codec),
+    "-c:a",
+    "aac",
+    "-b:a",
+    "128k",
+    "-output_ts_offset",
+    String(spec.startPtsSeconds),
+    "-f",
+    "mp4",
+    "-movflags",
+    "-faststart"
+  ];
+  const mainFile = join3(WINDOW_CONTAINER_DIR, `${spec.id}.mp4`);
+  const encode = {
+    codec: spec.codec,
+    gopFrames: spec.gopFrames,
+    gopMode: spec.gopMode,
+    bframes: spec.bframes,
+    startPtsSeconds: spec.startPtsSeconds,
+    sparse: spec.sparse,
+    moov: "trailing",
+    delayedTail: spec.delayedTail,
+    width: spec.width,
+    height: spec.height,
+    fps: outputFps
+  };
+  return { id: spec.id, spec, mainFile, files: [mainFile], ffmpegOutputArgs, encode };
+}
+
 // src/fixtures/generate.ts
 var FFMPEG_PROBE_ARGS = ["-version"];
 async function generateFixtures(opts = {}) {
@@ -243,26 +609,39 @@ async function generateFixtures(opts = {}) {
     }
   }
   copyVodSamples(fixtureDir);
+  let windowFixtures = [];
+  if (opts.includeWindow !== false) {
+    const windowResult = await generateWindowSet(
+      fixtureDir,
+      ffmpegPath,
+      opts.quiet ?? false,
+      opts.overwrite ?? false
+    );
+    windowFixtures = windowResult.items;
+    generated += windowResult.generated;
+    skipped += windowResult.skipped;
+  }
   const manifest = {
     version: 1,
     generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
     durationSeconds: duration,
-    fixtures: manifestItems
+    fixtures: manifestItems,
+    windowFixtures
   };
-  writeFileSync(join3(fixtureDir, "manifest.json"), JSON.stringify(manifest, null, 2));
+  writeFileSync(join4(fixtureDir, "manifest.json"), JSON.stringify(manifest, null, 2));
   return { fixtureDir, manifest, generated, skipped, ffmpegPath, ffmpegMissing: false };
 }
 async function generateOne(plan, fixtureDir, ffmpegPath, quiet, overwrite) {
-  const outDir = join3(fixtureDir, plan.containerDir);
+  const outDir = join4(fixtureDir, plan.containerDir);
   mkdirSync(outDir, { recursive: true });
-  const outFile = join3(fixtureDir, plan.mainFile);
+  const outFile = join4(fixtureDir, plan.mainFile);
   if (!overwrite && existsSync(outFile)) {
     return collectExisting(plan, fixtureDir);
   }
   if (plan.layout.isContainerDirectory) {
     for (const f of readdirSync(outDir)) {
       if (f === plan.layout.mainFileName) continue;
-      rmIfExists(join3(outDir, f));
+      rmIfExists(join4(outDir, f));
     }
   }
   const args = plan.ffmpegOutputArgs.concat([outFile]);
@@ -276,21 +655,89 @@ async function generateOne(plan, fixtureDir, ffmpegPath, quiet, overwrite) {
   }
   return collectExisting(plan, fixtureDir);
 }
+async function generateWindowSet(fixtureDir, ffmpegPath, quiet, overwrite) {
+  const outDir = join4(fixtureDir, WINDOW_CONTAINER_DIR);
+  mkdirSync(outDir, { recursive: true });
+  const useDrawtext = await supportsDrawtext(ffmpegPath);
+  const fontfile = useDrawtext ? pickFontfile() : void 0;
+  if (!useDrawtext && !quiet) {
+    process.stdout.write(
+      "[generate] drawtext \u6EE4\u955C\u7F3A\u5931\uFF0C\u70E7\u5F55\u7A97\u964D\u7EA7\u4E3A\u88F8 testsrc2\uFF08\u65E0\u70E7\u5F55\u6587\u5B57\uFF0C\u7F16\u7801\u53C2\u6570\u4E0D\u53D8\uFF1B\u5B8C\u6574\u547D\u4EE4\u89C1 README P3-H \u4E00\u8282\uFF09\n"
+    );
+  }
+  const items = [];
+  let generated = 0;
+  let skipped = 0;
+  for (const spec of WINDOW_SPECS) {
+    const plan = buildWindowPlan(spec, { useDrawtext, fontfile });
+    const outFile = join4(fixtureDir, plan.mainFile);
+    if (!overwrite && existsSync(outFile)) {
+      items.push(collectWindowExisting(plan, fixtureDir));
+      skipped += 1;
+      continue;
+    }
+    if (!quiet) {
+      process.stdout.write(`[generate] window/${plan.id} -> ${plan.mainFile}
+`);
+    }
+    const code = await runFfmpeg(ffmpegPath, plan.ffmpegOutputArgs.concat([outFile]), quiet);
+    if (code !== 0) {
+      throw new Error(`ffmpeg exited with code ${code} for window/${plan.id}`);
+    }
+    items.push(collectWindowExisting(plan, fixtureDir));
+    generated += 1;
+  }
+  return { items, generated, skipped };
+}
+function collectWindowExisting(plan, fixtureDir) {
+  const entries = [];
+  for (const rel of plan.files) {
+    const abs = join4(fixtureDir, rel);
+    if (!existsSync(abs)) continue;
+    entries.push({ path: rel, size: statSync(abs).size, sha256: hashFile(abs) });
+  }
+  return { id: plan.id, codec: plan.spec.codec, entries, encode: plan.encode };
+}
+async function supportsDrawtext(ffmpegPath) {
+  const { promise, resolve: resolve2 } = Promise.withResolvers();
+  const proc = spawn(ffmpegPath, ["-hide_banner", "-filters"], {
+    stdio: ["ignore", "pipe", "ignore"]
+  });
+  let out = "";
+  proc.stdout?.on("data", (chunk) => {
+    out += chunk.toString("utf8");
+  });
+  proc.once("error", () => resolve2(false));
+  proc.once("exit", (code) => {
+    if (code !== 0) {
+      resolve2(false);
+      return;
+    }
+    resolve2(/^\s*\S{2,3}\s+drawtext\s/m.test(out));
+  });
+  return promise;
+}
+function pickFontfile() {
+  for (const candidate of DRAWTEXT_FONT_CANDIDATES) {
+    if (existsSync(candidate)) return candidate;
+  }
+  return DRAWTEXT_FONT_CANDIDATES[0] ?? "/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf";
+}
 function collectExisting(plan, fixtureDir) {
   const entries = [];
   for (const rel of plan.files) {
-    const abs = join3(fixtureDir, rel);
+    const abs = join4(fixtureDir, rel);
     if (!existsSync(abs)) continue;
     entries.push({ path: rel, size: statSync(abs).size, sha256: hashFile(abs) });
   }
   if (plan.layout.isContainerDirectory) {
-    const absDir = join3(fixtureDir, plan.containerDir);
+    const absDir = join4(fixtureDir, plan.containerDir);
     if (existsSync(absDir)) {
       for (const name of readdirSync(absDir).sort()) {
         if (name === plan.layout.mainFileName) continue;
-        const rel = join3(plan.containerDir, name);
+        const rel = join4(plan.containerDir, name);
         if (entries.find((e) => e.path === rel)) continue;
-        const abs = join3(absDir, name);
+        const abs = join4(absDir, name);
         if (!statSync(abs).isFile()) continue;
         entries.push({ path: rel, size: statSync(abs).size, sha256: hashFile(abs) });
       }
@@ -299,12 +746,12 @@ function collectExisting(plan, fixtureDir) {
   return { codec: plan.codec, format: plan.format, entries };
 }
 function copyVodSamples(fixtureDir) {
-  const src = join3(fixtureDir, VOD_SAMPLE_RELATIVE);
+  const src = join4(fixtureDir, VOD_SAMPLE_RELATIVE);
   if (!existsSync(src)) return;
-  const vodDir = join3(fixtureDir, "vod");
+  const vodDir = join4(fixtureDir, "vod");
   mkdirSync(vodDir, { recursive: true });
   for (const name of ["sample-1.mp4", "sample-2.mp4"]) {
-    const dst = join3(vodDir, name);
+    const dst = join4(vodDir, name);
     writeFileSync(dst, readFileSync(src));
   }
 }
@@ -353,7 +800,8 @@ function emptyManifest(duration) {
     version: 1,
     generatedAt: (/* @__PURE__ */ new Date(0)).toISOString(),
     durationSeconds: duration,
-    fixtures: []
+    fixtures: [],
+    windowFixtures: []
   };
 }
 export {