@hyperframes/engine 0.6.111 → 0.6.113

package/dist/config.d.ts

@@ -42,6 +42,12 @@ export interface EngineConfig {
     expectedChromiumMajor?: number;
     /** Force screenshot capture mode (skip BeginFrame even on Linux). */
     forceScreenshot: boolean;
+    /**
+     * Static-frame dedup: reuse byte-identical frames instead of re-seeking +
+     * re-screenshotting (anchor-verified at init). Default ON; disable via
+     * `HF_STATIC_DEDUP` in {false,0,off}. Only arms in screenshot capture mode.
+     */
+    staticFrameDedup: boolean;
     /**
      * Low-memory render profile. When `true`, the orchestrator collapses the
      * pipeline to its cheapest shape on memory-constrained hosts: it skips the

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAE3B,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IAClB,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IACvC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IAGpB,yDAAyD;IACzD,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,oBAAoB,EAAE,MAAM,CAAC;IAG7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB;;;;;;;;OAQG;IACH,cAAc,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;IACjD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,qEAAqE;IACrE,eAAe,EAAE,OAAO,CAAC;IACzB;;;;;;;;OAQG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,yBAAyB,EAAE,OAAO,CAAC;IAGnC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,OAAO,CAAC;IAC/B;;;;OAIG;IACH,iCAAiC,EAAE,MAAM,CAAC;IAG1C,+DAA+D;IAC/D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wEAAwE;IACxE,oBAAoB,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,sBAAsB,EAAE,MAAM,CAAC;IAG/B,kEAAkE;IAClE,GAAG,EAAE;QAAE,QAAQ,EAAE,KAAK,GAAG,IAAI,CAAA;KAAE,GAAG,KAAK,CAAC;IACxC,yEAAyE;IACzE,aAAa,EAAE,OAAO,CAAC;IAGvB,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,sBAAsB,EAAE,MAAM,CAAC;IAC/B;;;;;OAKG;IACH,6BAA6B,EAAE,MAAM,CAAC;IAGtC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;;;;;;OAQG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAG9B,kDAAkD;IAClD,aAAa,EAAE,OAAO,CAAC;IACvB,mDAAmD;IACnD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAG7B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAGzB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,qEAAqE;AACrE,eAAO,MAAM,cAAc,EAAE,YA6C5B,CAAC;AAgBF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CA+H7E"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAE3B,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IAClB,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IACvC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IAGpB,yDAAyD;IACzD,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,oBAAoB,EAAE,MAAM,CAAC;IAG7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB;;;;;;;;OAQG;IACH,cAAc,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;IACjD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,qEAAqE;IACrE,eAAe,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAC1B;;;;;;;;OAQG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,yBAAyB,EAAE,OAAO,CAAC;IAGnC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,OAAO,CAAC;IAC/B;;;;OAIG;IACH,iCAAiC,EAAE,MAAM,CAAC;IAG1C,+DAA+D;IAC/D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wEAAwE;IACxE,oBAAoB,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,sBAAsB,EAAE,MAAM,CAAC;IAG/B,kEAAkE;IAClE,GAAG,EAAE;QAAE,QAAQ,EAAE,KAAK,GAAG,IAAI,CAAA;KAAE,GAAG,KAAK,CAAC;IACxC,yEAAyE;IACzE,aAAa,EAAE,OAAO,CAAC;IAGvB,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,sBAAsB,EAAE,MAAM,CAAC;IAC/B;;;;;OAKG;IACH,6BAA6B,EAAE,MAAM,CAAC;IAGtC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;;;;;;OAQG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAG9B,kDAAkD;IAClD,aAAa,EAAE,OAAO,CAAC;IACvB,mDAAmD;IACnD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAG7B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAGzB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,qEAAqE;AACrE,eAAO,MAAM,cAAc,EAAE,YA8C5B,CAAC;AAgBF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAqI7E"}

package/dist/config.js

@@ -22,6 +22,7 @@ export const DEFAULT_CONFIG = {
     browserTimeout: 120_000,
     protocolTimeout: 300_000,
     forceScreenshot: false,
+    staticFrameDedup: true,
     // Auto-detected per host in `resolveConfig`; defaults off for the raw
     // DEFAULT_CONFIG (used directly by tests and worker-sizing fallbacks).
     lowMemoryMode: false,
@@ -95,6 +96,11 @@ export function resolveConfig(overrides) {
             return false;
         return isLowMemorySystem();
     };
+    // Opt-OUT: default ON, disabled only by an explicit falsey value.
+    const resolveStaticFrameDedup = () => {
+        const raw = env("HF_STATIC_DEDUP")?.trim().toLowerCase();
+        return !(raw === "false" || raw === "off" || raw === "0");
+    };
     // Env-var layer (backward compat)
     const fromEnv = {
         concurrency: env("PRODUCER_MAX_WORKERS") ? Number(env("PRODUCER_MAX_WORKERS")) : undefined,
@@ -111,6 +117,7 @@ export function resolveConfig(overrides) {
             ? Number(env("PRODUCER_EXPECTED_CHROMIUM_MAJOR"))
             : undefined,
         forceScreenshot: envBool("PRODUCER_FORCE_SCREENSHOT", DEFAULT_CONFIG.forceScreenshot),
+        staticFrameDedup: resolveStaticFrameDedup(),
         lowMemoryMode: resolveLowMemoryMode(),
         enablePageSideCompositing: envBool("HF_PAGE_SIDE_COMPOSITING", DEFAULT_CONFIG.enablePageSideCompositing),
         enableChunkedEncode: envBool("PRODUCER_ENABLE_CHUNKED_ENCODE", DEFAULT_CONFIG.enableChunkedEncode),

package/dist/config.js.map

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

package/dist/services/frameCapture.d.ts

@@ -21,6 +21,25 @@ export interface CaptureSession {
     outputDir: string;
     onBeforeCapture: BeforeCaptureHook | null;
     isInitialized: boolean;
+    /**
+     * Static-frame dedup (default-on; opt out with `HF_STATIC_DEDUP=false`): indices of frames byte-identical
+     * to their predecessor (no GSAP tween / clip cut active in either), predicted from
+     * window.__timelines and empirically anchor-verified. These reuse `lastFrameBuffer`
+     * instead of re-seeking + re-screenshotting. Undefined when disabled or ineligible.
+     */
+    staticFrames?: Set<number>;
+    /** Last non-deduped frame buffer, reused for every `staticFrames` index in its run. */
+    lastFrameBuffer?: Buffer;
+    /** Count of frames served from a reused buffer (dedup telemetry). */
+    staticDedupCount?: number;
+    /** Dedup was enabled for this render (default-on; opt out with `HF_STATIC_DEDUP=false`). */
+    staticDedupEnabled?: boolean;
+    /**
+     * Short machine code for WHY dedup did not arm, for a low-cardinality breakdown.
+     * One of: `capture_mode` | `video_injection` | `page_composite` |
+     * `ineligible` | `verification_failed` | `verification_budget`. Undefined when armed or disabled.
+     */
+    staticDedupSkipReason?: string;
     pageReleased?: boolean;
     browserReleased?: boolean;
     browserConsoleBuffer: string[];

package/dist/services/frameCapture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frameCapture.d.ts","sourceRoot":"","sources":["../../src/services/frameCapture.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"frameCapture.d.ts","sourceRoot":"","sources":["../../src/services/frameCapture.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,IAAI,EAAsC,MAAM,gBAAgB,CAAC;AAM7F,OAAO,EAOL,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAO7B,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,KAAK,EACV,cAAc,EAEd,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;AAEvF,wGAAwG;AACxG,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5E,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC1C,aAAa,EAAE,OAAO,CAAC;IACvB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,uFAAuF;IACvF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAM1B,4FAA4F;IAC5F,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAI/B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,aAAa,CAAC,EAAE;QACd,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,WAAW,EAAE;QACX,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,WAAW,EAAE,WAAW,CAAC;IAEzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,wBAAwB,EAAE,MAAM,CAAC;IACjC,uBAAuB,EAAE,MAAM,CAAC;IAChC,qFAAqF;IACrF,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CAChC;AAyDD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAuB3D;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE;IACvD,WAAW,EAAE,WAAW,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,MAAM,CAOT;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE;IACrD,WAAW,EAAE,WAAW,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAMT;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CAKT;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAMT;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,IAAI,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,sEAAsE;IACtE,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAID;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvF;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,IAAI,CAAC,CAoBf;AAsBD,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,EACvB,eAAe,GAAE,iBAAiB,GAAG,IAAW,EAChD,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC7B,OAAO,CAAC,cAAc,CAAC,CAqIzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAM5F;AAkOD,+CAA+C;AAC/C,wBAAsB,eAAe,CACnC,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,MAAY,GACvB,OAAO,CAAC,OAAO,CAAC,CA8BlB;AAkGD,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA4V9E;AA+gBD,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,aAAa,CAAC,CAcxB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,mBAAmB,CAAC,CAI9B;AAED;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GAAG,CACtC,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,KACT,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,cAAc,EACvB,UAAU,GAAE,MAAU,EACtB,IAAI,GAAE,MAAU,EAChB,YAAY,GAAE,yBAA4C,GACzD,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAqDhF;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,iBAAiB,GAAG,IAAI,GACxC,IAAI,CAqBN;AAED,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAMrF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,kBAAkB,CAejF"}

package/dist/services/frameCapture.js

@@ -739,6 +739,7 @@ export async function initializeSession(session) {
         if (session.options.format === "png") {
             await initTransparentBackground(session.page);
         }
+        await armStaticDedup(session, session.page, logInitPhase);
         session.isInitialized = true;
         return;
     }
@@ -866,6 +867,7 @@ export async function initializeSession(session) {
     if (session.options.format === "png") {
         await initTransparentBackground(session.page);
     }
+    await armStaticDedup(session, session.page, logInitPhase);
     session.isInitialized = true;
 }
 async function captureFrameErrorDiagnostics(session, frameIndex, time, error) {
@@ -947,6 +949,295 @@ async function prepareFrameForCapture(session, frameIndex, time) {
     }
     return { quantizedTime, seekMs, beforeCaptureMs };
 }
+// ── Static-frame dedup (default-on, opt-out HF_STATIC_DEDUP=false) ─────────────
+// Skip re-seeking + re-screenshotting frames that are byte-identical to their
+// predecessor. A frame is dedupable iff no GSAP tween or clip cut is active in it or
+// its predecessor (predicted from window.__timelines), AND an empirical anchor-compare
+// confirms it. Capture-mode-independent (works on screenshot + beginframe), lossless
+// (verification disables the whole comp on any drift), default off. Pays on
+// static-hold content (title cards, slideshows, data-viz pauses); a no-op on
+// continuously-animated comps and disqualified by video/canvas/non-GSAP animation.
+/**
+ * Clip-cut boundary frames (±1) from the [data-start] schedule. A hard scene swap at a
+ * cut changes content with no tween; treat those frames as animated so the post-cut
+ * frame is captured fresh and later static frames reuse the correct scene.
+ */
+async function computeClipBoundaryFrames(page, fps) {
+    const schedule = await page.evaluate(() => Array.from(document.querySelectorAll("[data-start]")).map((el) => ({
+        start: parseFloat(el.dataset.start || ""),
+        dur: parseFloat(el.dataset.duration || ""),
+    })));
+    const frames = new Set();
+    for (const { start, dur } of schedule) {
+        if (Number.isNaN(start))
+            continue;
+        const edges = [Math.round(start * fps)];
+        if (!Number.isNaN(dur))
+            edges.push(Math.round((start + dur) * fps));
+        for (const e of edges) {
+            for (const f of [e - 1, e, e + 1]) {
+                if (f >= 0)
+                    frames.add(f);
+            }
+        }
+    }
+    return frames;
+}
+/**
+ * Predict the dedupable (static) frame set from window.__timelines. A frame f (f>0) is
+ * static iff NEITHER f NOR f-1 falls inside any GSAP tween interval — content didn't
+ * change f-1→f, so f can reuse f-1's buffer. Requiring BOTH neighbours static under-
+ * claims by one frame at each tween edge (the SAFE direction). Disqualifies the whole
+ * comp on any signal the tween-walker can't see: video / canvas / webgl (redraw without
+ * a tween), zero tweens (non-GSAP animation), or a running CSS/WAAPI animation.
+ */
+async function computeStaticFrameSet(page, fps) {
+    const result = await page.evaluate(() => {
+        const intervals = [];
+        let tweenCount = 0;
+        // totalDuration() (NOT duration()): a repeat/yoyo tween animates past one iteration;
+        // a repeating timeline is marked opaque over its whole span (conservative).
+        function walk(tl, offset) {
+            if (typeof tl.getChildren !== "function")
+                return;
+            for (const child of tl.getChildren(false, true, true)) {
+                const start = offset + (typeof child.startTime === "function" ? child.startTime() : 0);
+                const single = typeof child.duration === "function" ? child.duration() : 0;
+                const total = typeof child.totalDuration === "function" ? child.totalDuration() : single;
+                if (typeof child.getChildren === "function") {
+                    if (total > single + 1e-6)
+                        intervals.push({ start, end: start + total });
+                    else
+                        walk(child, start);
+                }
+                else {
+                    tweenCount++;
+                    intervals.push({ start, end: start + total });
+                }
+            }
+        }
+        const w = window;
+        for (const tl of Object.values(w.__timelines || {})) {
+            if (tl && typeof tl.getChildren === "function")
+                walk(tl, 0);
+        }
+        const hasVideo = !!document.querySelector("video");
+        const hasCanvas = !!document.querySelector("canvas");
+        // A non-numeric data-start (reference expression like "intro+0.5") can't be turned
+        // into a clip-cut boundary by computeClipBoundaryFrames' parseFloat, so the cut goes
+        // unprotected and could be deduped into the previous scene. Disqualify the comp.
+        const hasUnresolvableClipStart = Array.from(document.querySelectorAll("[data-start]")).some((el) => {
+            const v = el.dataset.start;
+            return v != null && v.trim() !== "" && !Number.isFinite(parseFloat(v));
+        });
+        // Non-GSAP animation (CSS @keyframes / transitions / WAAPI) surfaces via
+        // getAnimations(); any running/paused one can change content without a tween.
+        let hasNonGsapAnim = false;
+        try {
+            const docAnims = document.getAnimations;
+            if (typeof docAnims === "function") {
+                hasNonGsapAnim = docAnims.call(document).some((a) => {
+                    const t = a;
+                    return t.playState === "running" || t.playState === "paused";
+                });
+            }
+        }
+        catch {
+            hasNonGsapAnim = true;
+        }
+        return {
+            intervals,
+            tweenCount,
+            duration: w.__hf?.duration ?? 0,
+            hasVideo,
+            hasCanvas,
+            hasNonGsapAnim,
+            hasUnresolvableClipStart,
+        };
+    });
+    const { intervals, tweenCount, duration, hasVideo, hasCanvas, hasNonGsapAnim, hasUnresolvableClipStart, } = result;
+    const totalFrames = Math.max(1, Math.ceil(duration * fps));
+    const animated = new Set();
+    for (const { start, end } of intervals) {
+        const lo = Math.max(0, Math.floor(start * fps));
+        const hi = Math.min(totalFrames - 1, Math.ceil(end * fps));
+        for (let f = lo; f <= hi; f++)
+            animated.add(f);
+    }
+    for (const f of await computeClipBoundaryFrames(page, fps))
+        animated.add(f);
+    const reasons = [];
+    if (!(duration > 0))
+        reasons.push("unknown/zero duration");
+    if (hasVideo)
+        reasons.push("video");
+    if (hasCanvas)
+        reasons.push("canvas/webgl");
+    if (tweenCount === 0)
+        reasons.push("no GSAP tweens (non-GSAP animation)");
+    if (hasNonGsapAnim)
+        reasons.push("running CSS/WAAPI animation");
+    if (hasUnresolvableClipStart)
+        reasons.push("unresolvable clip start (reference expression)");
+    const eligible = reasons.length === 0;
+    const staticFrameSet = new Set();
+    if (eligible) {
+        for (let f = 1; f < totalFrames; f++) {
+            if (!animated.has(f) && !animated.has(f - 1))
+                staticFrameSet.add(f);
+        }
+    }
+    return {
+        totalFrames,
+        staticFrameSet,
+        hasVideo,
+        hasCanvas,
+        hasNonGsapAnim,
+        tweenCount,
+        eligible,
+        reason: eligible ? "eligible" : reasons.join("+"),
+    };
+}
+/**
+ * Empirically verify the predicted-static set before trusting it. Group static frames
+ * into runs; each run [a..b] reuses anchor a-1. CRITICAL: compare against the ANCHOR,
+ * not the predecessor — a slow drift with sub-quantization per-frame deltas is byte-
+ * identical frame-to-frame yet drifts far from the anchor by the run's end (the real
+ * frozen error). Capture each run's anchor once, compare END + a midpoint to it; any
+ * mismatch ⇒ the run isn't truly static ⇒ disable dedup whole-comp. Capture-mode-
+ * independent (seeks + screenshots in normal DOM). Returns the first bad frame, or null.
+ */
+async function verifyStaticFramesSafe(session, page, staticFrames, fps, sampleCount) {
+    const frames = [...staticFrames].sort((a, b) => a - b);
+    if (frames.length === 0)
+        return null;
+    // Runs are maximal-contiguous (adjacent frames merge), so a run's anchor a-1 is
+    // guaranteed NOT static — always a freshly-captured frame.
+    const runs = [];
+    for (const f of frames) {
+        const last = runs[runs.length - 1];
+        if (last && f === last.b + 1)
+            last.b = f;
+        else
+            runs.push({ a: f, b: f });
+    }
+    const seekCapture = async (frameIdx) => {
+        const t = quantizeTimeToFrame(frameIdx / fps, fps);
+        await page.evaluate((tt) => {
+            const hf = window.__hf;
+            if (hf && typeof hf.seek === "function")
+                hf.seek(tt);
+        }, t);
+        return pageScreenshotCapture(page, session.options);
+    };
+    // Verify EVERY run in order (no longest-first truncation that would leave runs armed
+    // but unverified). Per run, compare the FIRST reused frame `a`, the END `b` (max
+    // accumulated drift), and interior points at a stride — against the anchor the run
+    // actually reuses. `sampleCount` sets the interior density (points per run ~ that many
+    // for a long run); a hard cap bounds pathological run counts, and hitting it DISABLES
+    // dedup (conservative: never trust an unverified set).
+    const perRun = Math.max(3, Math.min(sampleCount, 8));
+    const hardCap = Math.max(sampleCount * 8, 400);
+    let spent = 0;
+    for (const { a, b } of runs) {
+        const anchor = a - 1;
+        if (anchor < 0)
+            continue;
+        const anchorBuf = await seekCapture(anchor);
+        spent++;
+        const span = b - a;
+        const stride = span > 0 ? Math.max(1, Math.floor(span / (perRun - 1))) : 1;
+        const pts = new Set();
+        for (let f = a; f <= b; f += stride)
+            pts.add(f);
+        pts.add(b); // always include the end (max drift)
+        for (const f of [...pts].sort((x, y) => x - y)) {
+            const cur = await seekCapture(f);
+            spent++;
+            if (!anchorBuf.equals(cur))
+                return { badFrame: f, budgetExhausted: false };
+        }
+        // Budget exhausted → can't fully verify → disarm. Reported distinctly from real
+        // drift so a `verification_budget` spike in telemetry signals "tune HF_STATIC_DEDUP_SAMPLES",
+        // not "compositions are non-static".
+        if (spent > hardCap)
+            return { badFrame: a, budgetExhausted: true };
+    }
+    return null;
+}
+/**
+ * Arm static-frame dedup for this render (default-on; opt out with HF_STATIC_DEDUP=false).
+ * Runs at init in normal DOM state so the verification screenshots are valid. Predicts
+ * the static set, anchor-verifies it (skip with HF_STATIC_DEDUP_VERIFY=false — unsafe),
+ * and on success stores it on the session for captureFrameCore to reuse. Sample budget
+ * via HF_STATIC_DEDUP_SAMPLES (default 24).
+ */
+async function armStaticDedup(session, page, logInitPhase) {
+    // Default ON for everyone; opt out via HF_STATIC_DEDUP in {false,0,off} (resolved into
+    // EngineConfig.staticFrameDedup by resolveConfig). Verification is the safety net at scale.
+    // Default-on: only an explicit `staticFrameDedup === false` (resolved from
+    // HF_STATIC_DEDUP) disables; a missing config leaves dedup enabled.
+    session.staticDedupEnabled = session.config?.staticFrameDedup !== false;
+    if (!session.staticDedupEnabled)
+        return;
+    // Conservative gates: dedup is verified against the plain screenshot path, so only arm
+    // where the production capture matches what verification measures, and where reuse is
+    // sound. Skip when:
+    //  - capture mode is not screenshot (BeginFrame advances the compositor clock per
+    //    frame; skipping beginFrame for static frames gaps the tick sequence, and the
+    //    verifier uses pageScreenshotCapture not beginFrameCapture — its proof wouldn't
+    //    transfer);
+    //  - a before-capture hook is set (per-frame video-frame injection — those frames are
+    //    NOT static even if the GSAP timeline is idle, and the injector is skipped on reuse);
+    //  - page-side compositing is active (shader transitions / drawElement composite paint
+    //    a frame the plain verification screenshot doesn't reproduce).
+    if (session.captureMode !== "screenshot") {
+        session.staticDedupSkipReason = "capture_mode";
+        logInitPhase(`static-frame dedup: disabled (capture mode ${session.captureMode}, not screenshot)`);
+        return;
+    }
+    if (session.onBeforeCapture) {
+        session.staticDedupSkipReason = "video_injection";
+        logInitPhase("static-frame dedup: disabled (before-capture hook / video injection active)");
+        return;
+    }
+    const pageComposite = await page
+        .evaluate(() => typeof window
+        .__hf_page_composite_prepare === "function")
+        .catch(() => true); // fail CLOSED: if we can't determine, assume compositing → skip dedup
+    if (pageComposite) {
+        session.staticDedupSkipReason = "page_composite";
+        logInitPhase("static-frame dedup: disabled (page-side compositing active)");
+        return;
+    }
+    const fps = fpsToNumber(session.options.fps);
+    const stats = await computeStaticFrameSet(page, fps);
+    if (!stats.eligible || stats.staticFrameSet.size === 0) {
+        session.staticDedupSkipReason = "ineligible";
+        logInitPhase(`static-frame dedup: disabled (${stats.reason})`);
+        return;
+    }
+    const rawSamples = Number(process.env.HF_STATIC_DEDUP_SAMPLES ?? "24");
+    const samples = Number.isFinite(rawSamples) && rawSamples >= 1 ? rawSamples : 24;
+    const verdict = process.env.HF_STATIC_DEDUP_VERIFY === "false"
+        ? null
+        : await verifyStaticFramesSafe(session, page, stats.staticFrameSet, fps, samples);
+    if (verdict !== null) {
+        session.staticDedupSkipReason = verdict.budgetExhausted
+            ? "verification_budget"
+            : "verification_failed";
+        logInitPhase(verdict.budgetExhausted
+            ? `static-frame dedup: disabled (verification budget exhausted before frame ${verdict.badFrame}; ` +
+                `raise HF_STATIC_DEDUP_SAMPLES to verify more)`
+            : `static-frame dedup: disabled (verification failed — content drifts from anchor at ` +
+                `predicted-static frame ${verdict.badFrame})`);
+        return;
+    }
+    // armed + predicted are derived from staticFrames in getCapturePerfSummary.
+    session.staticFrames = stats.staticFrameSet;
+    logInitPhase(`static-frame dedup: ${stats.staticFrameSet.size}/${stats.totalFrames} frame(s) reusable ` +
+        `(${Math.round((stats.staticFrameSet.size / stats.totalFrames) * 100)}%, verified)`);
+}
 /**
  * Internal core: prepare, screenshot, and track perf.
  * Shared by captureFrame (disk) and captureFrameToBuffer (buffer).
@@ -955,6 +1246,29 @@ async function prepareFrameForCapture(session, frameIndex, time) {
 async function captureFrameCore(session, frameIndex, time) {
     const { page, options } = session;
     const startTime = Date.now();
+    // Static-frame dedup: this frame is byte-identical to its predecessor (predicted +
+    // anchor-verified at init) → reuse the prior buffer, skip the seek + screenshot.
+    // KEY: index by the ABSOLUTE composition frame (derived from `time`), NOT the
+    // `frameIndex` arg — chunked/parallel/distributed callers pass a chunk-RELATIVE
+    // frameIndex (captureStage passes the loop `i`, parallelCoordinator passes
+    // `i-outputFrameOffset`) while staticFrames is keyed in absolute frames. Using `time`
+    // is correct on every path (sequential, per-worker range, distributed chunk) because
+    // `time` is always the absolute composition time for the frame. Each session captures
+    // its range in ascending order, so lastFrameBuffer is the correct in-range anchor (and
+    // since a static run is verified identical, reusing the run's first in-range capture
+    // equals reusing the global anchor). Telemetry: count reuses separately; do NOT bump
+    // capturePerf.frames (that would dilute the per-frame timing averages).
+    // Use the SAME floor+epsilon idiom as quantizeTimeToFrame so the dedup lookup agrees
+    // with the frame the seek actually lands on, even if `time` ever isn't exactly i/fps.
+    const absFrameIndex = Math.floor(time * fpsToNumber(options.fps) + 1e-9);
+    if (session.staticFrames?.has(absFrameIndex) && session.lastFrameBuffer) {
+        session.staticDedupCount = (session.staticDedupCount ?? 0) + 1;
+        return {
+            buffer: session.lastFrameBuffer,
+            quantizedTime: quantizeTimeToFrame(time, fpsToNumber(options.fps)),
+            captureTimeMs: Date.now() - startTime,
+        };
+    }
     try {
         const { quantizedTime, seekMs, beforeCaptureMs } = await prepareFrameForCapture(session, frameIndex, time);
         const screenshotStart = Date.now();
@@ -978,6 +1292,9 @@ async function captureFrameCore(session, frameIndex, time) {
         session.capturePerf.beforeCaptureMs += beforeCaptureMs;
         session.capturePerf.screenshotMs += screenshotMs;
         session.capturePerf.totalMs += captureTimeMs;
+        // Retain this freshly-captured buffer so the following static frames can reuse it.
+        if (session.staticFrames)
+            session.lastFrameBuffer = screenshotBuffer;
         return { buffer: screenshotBuffer, quantizedTime, captureTimeMs };
     }
     catch (captureError) {
@@ -1038,18 +1355,38 @@ export async function discardWarmupCapture(session, frameIndex = 0, time = 0, in
     const perfBefore = { ...session.capturePerf };
     const hasDamageBefore = session.beginFrameHasDamageCount;
     const noDamageBefore = session.beginFrameNoDamageCount;
+    const dedupCountBefore = session.staticDedupCount;
+    const lastFrameBufferBefore = session.lastFrameBuffer;
     try {
         await innerCapture(session, frameIndex, time);
     }
     finally {
         // Always restore — even on error. A failed warmup capture should not
-        // leak inflated perf counters into the real capture summary.
+        // leak inflated perf counters, a phantom dedup reuse, or a warmup-era
+        // lastFrameBuffer anchor into the real capture summary/state.
         session.capturePerf = perfBefore;
         session.beginFrameHasDamageCount = hasDamageBefore;
         session.beginFrameNoDamageCount = noDamageBefore;
+        session.staticDedupCount = dedupCountBefore;
+        session.lastFrameBuffer = lastFrameBufferBefore;
     }
 }
 export async function closeCaptureSession(session) {
+    // Realized static-dedup telemetry: how much the cache actually helped this
+    // render (vs the prediction logged at arm time). Both capture paths
+    // (sequential orchestrator + parallel workers) close their session here, so
+    // this is the one uniform emit point. Zero the count afterward so the
+    // idempotent re-close (HDR cleanup) doesn't double-log.
+    const reused = session.staticDedupCount ?? 0;
+    if (session.staticFrames && reused > 0) {
+        const captured = session.capturePerf.frames; // excludes reuses by design
+        const total = captured + reused;
+        const pct = total > 0 ? Math.round((reused / total) * 100) : 0;
+        const avgTotalMs = captured > 0 ? Math.round(session.capturePerf.totalMs / captured) : 0;
+        console.log(`[static-dedup] reused ${reused}/${total} frame(s) (${pct}%), ` +
+            `est. ~${reused * avgTotalMs}ms saved (avg ${avgTotalMs}ms/frame)`);
+        session.staticDedupCount = 0;
+    }
     // INVARIANT: closeCaptureSession is idempotent. The renderOrchestrator HDR
     // cleanup path tracks a `domSessionClosed` flag and may still re-call this
     // in the outer finally if the inner cleanup raised before the flag flipped.
@@ -1099,6 +1436,12 @@ export function prepareCaptureSessionForReuse(session, outputDir, onBeforeCaptur
     };
     session.beginFrameHasDamageCount = 0;
     session.beginFrameNoDamageCount = 0;
+    // Reset per-render dedup state so a buffer captured by the prior render/probe can't
+    // bleed into this render's first static frame. staticFrames (the armed set) is left
+    // intact: it's keyed in absolute frames and stays valid for a same-composition reuse;
+    // lastFrameBuffer must be re-seeded by this render's first fresh capture.
+    session.lastFrameBuffer = undefined;
+    session.staticDedupCount = 0;
 }
 export async function getCompositionDuration(session) {
     if (!session.isInitialized)
@@ -1115,6 +1458,12 @@ export function getCapturePerfSummary(session) {
         avgSeekMs: Math.round(session.capturePerf.seekMs / frames),
         avgBeforeCaptureMs: Math.round(session.capturePerf.beforeCaptureMs / frames),
         avgScreenshotMs: Math.round(session.capturePerf.screenshotMs / frames),
+        staticDedupReused: session.staticDedupCount ?? 0,
+        staticDedupEnabled: session.staticDedupEnabled ?? false,
+        // armed ⟺ a non-empty static set survived verification; predicted === its size.
+        staticDedupArmed: (session.staticFrames?.size ?? 0) > 0,
+        staticDedupPredicted: session.staticFrames?.size ?? 0,
+        staticDedupSkipReason: session.staticDedupSkipReason,
     };
 }
 //# sourceMappingURL=frameCapture.js.map