@hyperframes/engine 0.8.44 → 0.8.46

package/dist/services/motionBlur.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Sub-frame multi-sample motion blur (issue #4010).
+ *
+ * For each output frame the capture path seeks the timeline to K sub-frame times spread
+ * across the shutter window, captures each, and averages them. Unlike the catalog
+ * component, which stacks offset copies of an element and can only integrate
+ * translation, re-rendering at each sample integrates whatever the composition actually
+ * does inside the window: rotation, scale, opacity, filters, child animation.
+ *
+ * Shutter window, the After Effects model, in frames rather than seconds so the sample
+ * offsets are frame-rate independent:
+ *
+ *   shutterTime = shutterAngle / 360 / fps
+ *   windowStart = t + shutterPhase / 360 / fps
+ *   sample k at  windowStart + (k + 0.5) / N * shutterTime
+ */
+/** Caller-facing options. Presence of the object is the opt-in; there is no enabled flag. */
+export interface MotionBlurOptions {
+    /** Sub-frame captures averaged into one output frame. Default 16, clamped to 1..64. */
+    samplesPerFrame?: number;
+    /** Shutter window width in degrees of one frame. Default 180, AE's default. */
+    shutterAngle?: number;
+    /** Window offset in degrees. Default -90, which centres the window on the frame time. */
+    shutterPhase?: number;
+    /**
+     * Working space for the average. Default "srgb", matching After Effects' non-linearised
+     * 8-bpc working space and the catalog component. "linear" is physically correct light
+     * integration and diverges from both on high-contrast edges.
+     */
+    blend?: MotionBlurBlendSpace;
+}
+export type MotionBlurBlendSpace = "srgb" | "linear";
+/** A resolved plan. The window is fixed by shutter angle/phase alone, independent of
+ * how many samples fill it, which is what lets the count vary per frame. */
+export interface MotionBlurPlan {
+    readonly blend: MotionBlurBlendSpace;
+    /**
+     * Sub-frame ticks per output frame. The seek grid is `fps * subFrameDivisions`, which
+     * contains the output frame grid, so the frame-time instant never moves.
+     */
+    readonly subFrameDivisions: number;
+    /** Window start, in frames relative to the frame instant (`shutterPhase / 360`). */
+    readonly windowStartFrames: number;
+    /** Window width, in frames (`shutterAngle / 360`). */
+    readonly shutterFrames: number;
+    /** Explicit count from the caller (clamped to 1..64), or null for adaptive per-frame. */
+    readonly fixedSamplesPerFrame: number | null;
+}
+export declare const MAX_SAMPLES_PER_FRAME = 64;
+/** Sample count for a frame confirmed to need no measurement (the adaptive floor, and
+ * the count an explicit `samplesPerFrame` defaults to). */
+export declare const DEFAULT_SAMPLES_PER_FRAME = 16;
+/** Resolve caller options into a plan, or null when motion blur is off. */
+export declare function resolveMotionBlurPlan(options: MotionBlurOptions | undefined): MotionBlurPlan | null;
+/**
+ * Absolute seek times for one output frame, in ascending order, for `samplesPerFrame`
+ * samples spread across the plan's window (independent of `plan.fixedSamplesPerFrame` —
+ * the caller decides how many samples this particular frame gets).
+ *
+ * Built from integer ticks rather than by adding floats to `frameIndex / fps`, so the
+ * page-side quantizer recovers the intended tick exactly on every host. Times before the
+ * composition start clamp to 0, which is what After Effects does at the first frame.
+ */
+export declare function motionBlurSampleTimes(plan: MotionBlurPlan, frameIndex: number, fps: number, samplesPerFrame: number): number[];
+/** The two true shutter-window edges (not samples — see `motionBlurProbeTimes`'s
+ * caller), for measuring motion magnitude before a sample count is chosen. */
+export declare function motionBlurProbeTimes(plan: MotionBlurPlan, frameIndex: number, fps: number): {
+    windowStart: number;
+    windowEnd: number;
+};
+/**
+ * Is every frame the shutter window reads from known static, so this frame can reuse its
+ * predecessor's buffer instead of paying K captures?
+ *
+ * The static-frame dedup asks whether a frame is byte-identical to the one before it. With
+ * blur on that is not enough: the window reads content from either side of the frame
+ * instant, so a still frame next to a moving one still has to be captured. At a shutter
+ * angle above 360 the window spans whole neighbouring frames and the reuse would drop a
+ * frame of motion outright.
+ *
+ * The range covers the previous frame's window too, because reuse claims this frame's
+ * blurred output equals that one's. Contract taken from #4013 by Dante-dan, which carried
+ * this guard before we did.
+ */
+export declare function motionBlurWindowIsStatic(plan: MotionBlurPlan, frameIndex: number, staticFrames: ReadonlySet<number>): boolean;
+/** Diff magnitude → sample count, ascending and exhaustive. Calibration provenance and
+ * measured numbers are in the PR description for #4029; the 32-sample step is
+ * interpolated, not independently measured. */
+export declare const ADAPTIVE_SAMPLE_STEPS: ReadonlyArray<{
+    readonly maxDiff: number;
+    readonly samples: number;
+}>;
+/** Sample count for a frame whose probe diff magnitude is `diff` (see `ADAPTIVE_SAMPLE_STEPS`). */
+export declare function adaptiveSampleCount(diff: number): number;
+/** GSAP property names that move an element in screen space. Matches the Transform
+ * categories of SUPPORTED_PROPS in packages/parsers/src/gsapConstants.ts, minus
+ * transformOrigin (that file's own classifyTweenPropertyGroup excludes it: a pivot-point
+ * modifier, not independent motion). Passed into computeStaticFrameSet's page.evaluate as data. */
+export declare const SPATIAL_TWEEN_PROPERTIES: readonly string[];
+/** Mean absolute byte difference between two probe captures (never a sample that
+ * enters the average) — the motion signal `adaptiveSampleCount` maps to a count. */
+export declare function probeDiffMagnitude(a: Buffer, b: Buffer): number;
+/**
+ * Running average of the sub-frame captures for one output frame.
+ *
+ * Samples are folded in as they arrive rather than held until the end, so peak memory is
+ * one accumulator plus one decoded sample regardless of K. Holding all K decoded frames
+ * would be (K + 1) * 8.3 MB at 1080p, which is 141 MB at the default 16 samples and
+ * 540 MB at the 64 maximum, thrown away and rebuilt on every frame of the render.
+ *
+ * Colour is summed premultiplied by alpha and un-premultiplied at the end, so a sample
+ * that is transparent at a pixel contributes no colour there. On opaque frames, the
+ * common case, that reduces to a plain mean.
+ */
+export declare class MotionBlurAccumulator {
+    private readonly toWorking;
+    private readonly fromWorking;
+    /** Premultiplied r, g, b and alpha sums per pixel. Null until the first sample sets the size. */
+    private sums;
+    private width;
+    private height;
+    private count;
+    constructor(blend: MotionBlurBlendSpace);
+    /** Fold one captured sample PNG into the running average. */
+    add(png: Buffer): void;
+    /** Un-premultiply and encode the average. Throws if no sample was ever added. */
+    finish(): {
+        width: number;
+        height: number;
+        data: Uint8Array;
+    };
+}
+//# sourceMappingURL=motionBlur.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"motionBlur.d.ts","sourceRoot":"","sources":["../../src/services/motionBlur.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,6FAA6F;AAC7F,MAAM,WAAW,iBAAiB;IAChC,uFAAuF;IACvF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,KAAK,CAAC,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAErD;4EAC4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,oFAAoF;IACpF,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,sDAAsD;IACtD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,yFAAyF;IACzF,QAAQ,CAAC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9C;AAED,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;2DAC2D;AAC3D,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAc5C,2EAA2E;AAC3E,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,iBAAiB,GAAG,SAAS,GACrC,cAAc,GAAG,IAAI,CAqBvB;AAcD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,eAAe,EAAE,MAAM,GACtB,MAAM,EAAE,CAMV;AAED;8EAC8E;AAC9E,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,GACV;IACD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,CAWA;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,GAChC,OAAO,CAgBT;AAED;;+CAE+C;AAC/C,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAIA,CAAC;AAEF,mGAAmG;AACnG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED;;;mGAGmG;AACnG,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EA8BrD,CAAC;AAEF;oFACoF;AACpF,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAa/D;AA6BD;;;;;;;;;;;GAWG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4B;IACxD,iGAAiG;IACjG,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,KAAK,CAAK;gBAEN,KAAK,EAAE,oBAAoB;IAKvC,6DAA6D;IAC7D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IA0BtB,iFAAiF;IACjF,MAAM,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE;CAgB9D"}

package/dist/services/motionBlur.js

@@ -0,0 +1,275 @@
+/**
+ * Sub-frame multi-sample motion blur (issue #4010).
+ *
+ * For each output frame the capture path seeks the timeline to K sub-frame times spread
+ * across the shutter window, captures each, and averages them. Unlike the catalog
+ * component, which stacks offset copies of an element and can only integrate
+ * translation, re-rendering at each sample integrates whatever the composition actually
+ * does inside the window: rotation, scale, opacity, filters, child animation.
+ *
+ * Shutter window, the After Effects model, in frames rather than seconds so the sample
+ * offsets are frame-rate independent:
+ *
+ *   shutterTime = shutterAngle / 360 / fps
+ *   windowStart = t + shutterPhase / 360 / fps
+ *   sample k at  windowStart + (k + 0.5) / N * shutterTime
+ */
+import { decodePng, srgbByteToLinear } from "../utils/alphaBlit.js";
+export const MAX_SAMPLES_PER_FRAME = 64;
+/** Sample count for a frame confirmed to need no measurement (the adaptive floor, and
+ * the count an explicit `samplesPerFrame` defaults to). */
+export const DEFAULT_SAMPLES_PER_FRAME = 16;
+const DEFAULT_SHUTTER_ANGLE = 180;
+const DEFAULT_SHUTTER_PHASE = -90;
+/**
+ * Ticks per output frame on the seek grid. Fine enough that the rounding error on a
+ * sample time is under 1/8192 of a frame, coarse enough to stay exactly representable.
+ */
+const SUB_FRAME_DIVISIONS = 4096;
+function finiteOr(value, fallback) {
+    return Number.isFinite(value) ? value : fallback;
+}
+/** Resolve caller options into a plan, or null when motion blur is off. */
+export function resolveMotionBlurPlan(options) {
+    if (!options)
+        return null;
+    const fixedSamplesPerFrame = options.samplesPerFrame === undefined
+        ? null
+        : Math.min(MAX_SAMPLES_PER_FRAME, Math.max(1, Math.round(finiteOr(options.samplesPerFrame, DEFAULT_SAMPLES_PER_FRAME))));
+    const shutterAngle = finiteOr(options.shutterAngle, DEFAULT_SHUTTER_ANGLE);
+    const shutterPhase = finiteOr(options.shutterPhase, DEFAULT_SHUTTER_PHASE);
+    const blend = options.blend === "linear" ? "linear" : "srgb";
+    return {
+        blend,
+        subFrameDivisions: SUB_FRAME_DIVISIONS,
+        windowStartFrames: shutterPhase / 360,
+        shutterFrames: shutterAngle / 360,
+        fixedSamplesPerFrame,
+    };
+}
+/** Tick offsets from the frame instant for `samplesPerFrame` samples spread evenly
+ * across the plan's window, ascending. Integers, so every host agrees. */
+function sampleTickOffsets(plan, samplesPerFrame) {
+    const offsets = [];
+    for (let k = 0; k < samplesPerFrame; k++) {
+        const offsetFrames = plan.windowStartFrames + ((k + 0.5) / samplesPerFrame) * plan.shutterFrames;
+        offsets.push(Math.round(offsetFrames * plan.subFrameDivisions));
+    }
+    return offsets;
+}
+/**
+ * Absolute seek times for one output frame, in ascending order, for `samplesPerFrame`
+ * samples spread across the plan's window (independent of `plan.fixedSamplesPerFrame` —
+ * the caller decides how many samples this particular frame gets).
+ *
+ * Built from integer ticks rather than by adding floats to `frameIndex / fps`, so the
+ * page-side quantizer recovers the intended tick exactly on every host. Times before the
+ * composition start clamp to 0, which is what After Effects does at the first frame.
+ */
+export function motionBlurSampleTimes(plan, frameIndex, fps, samplesPerFrame) {
+    const grid = fps * plan.subFrameDivisions;
+    const frameTicks = frameIndex * plan.subFrameDivisions;
+    return sampleTickOffsets(plan, samplesPerFrame).map((offset) => Math.max(0, frameTicks + offset) / grid);
+}
+/** The two true shutter-window edges (not samples — see `motionBlurProbeTimes`'s
+ * caller), for measuring motion magnitude before a sample count is chosen. */
+export function motionBlurProbeTimes(plan, frameIndex, fps) {
+    const grid = fps * plan.subFrameDivisions;
+    const frameTicks = frameIndex * plan.subFrameDivisions;
+    const startTick = Math.round(plan.windowStartFrames * plan.subFrameDivisions);
+    const endTick = Math.round((plan.windowStartFrames + plan.shutterFrames) * plan.subFrameDivisions);
+    return {
+        windowStart: Math.max(0, frameTicks + startTick) / grid,
+        windowEnd: Math.max(0, frameTicks + endTick) / grid,
+    };
+}
+/**
+ * Is every frame the shutter window reads from known static, so this frame can reuse its
+ * predecessor's buffer instead of paying K captures?
+ *
+ * The static-frame dedup asks whether a frame is byte-identical to the one before it. With
+ * blur on that is not enough: the window reads content from either side of the frame
+ * instant, so a still frame next to a moving one still has to be captured. At a shutter
+ * angle above 360 the window spans whole neighbouring frames and the reuse would drop a
+ * frame of motion outright.
+ *
+ * The range covers the previous frame's window too, because reuse claims this frame's
+ * blurred output equals that one's. Contract taken from #4013 by Dante-dan, which carried
+ * this guard before we did.
+ */
+export function motionBlurWindowIsStatic(plan, frameIndex, staticFrames) {
+    // Bound by the outermost sample this frame could take (its half-step inset from the
+    // true edge), not the edge itself. An adaptive plan's K is unknown here, so use the
+    // widest possible inset (K=64) rather than the true edge, which any chosen K stays inside.
+    const worstCaseSamples = plan.fixedSamplesPerFrame ?? MAX_SAMPLES_PER_FRAME;
+    const inset = plan.shutterFrames / (2 * worstCaseSamples);
+    const minOffsetFrames = plan.windowStartFrames + inset;
+    const maxOffsetFrames = plan.windowStartFrames + plan.shutterFrames - inset;
+    const first = Math.floor(frameIndex - 1 + Math.min(0, minOffsetFrames));
+    // A sample landing inside [F, F+1) reads content the frame set only pins down at both
+    // ends, so the frame after the last one touched has to be static as well.
+    const last = Math.floor(frameIndex + Math.max(0, maxOffsetFrames)) + 1;
+    for (let frame = first; frame <= last; frame++) {
+        if (!staticFrames.has(frame))
+            return false;
+    }
+    return true;
+}
+/** Diff magnitude → sample count, ascending and exhaustive. Calibration provenance and
+ * measured numbers are in the PR description for #4029; the 32-sample step is
+ * interpolated, not independently measured. */
+export const ADAPTIVE_SAMPLE_STEPS = [
+    { maxDiff: 3, samples: DEFAULT_SAMPLES_PER_FRAME },
+    { maxDiff: 6, samples: 32 },
+    { maxDiff: Infinity, samples: MAX_SAMPLES_PER_FRAME },
+];
+/** Sample count for a frame whose probe diff magnitude is `diff` (see `ADAPTIVE_SAMPLE_STEPS`). */
+export function adaptiveSampleCount(diff) {
+    for (const step of ADAPTIVE_SAMPLE_STEPS) {
+        if (diff <= step.maxDiff)
+            return step.samples;
+    }
+    return MAX_SAMPLES_PER_FRAME;
+}
+/** GSAP property names that move an element in screen space. Matches the Transform
+ * categories of SUPPORTED_PROPS in packages/parsers/src/gsapConstants.ts, minus
+ * transformOrigin (that file's own classifyTweenPropertyGroup excludes it: a pivot-point
+ * modifier, not independent motion). Passed into computeStaticFrameSet's page.evaluate as data. */
+export const SPATIAL_TWEEN_PROPERTIES = [
+    "x",
+    "y",
+    "z",
+    "xPercent",
+    "yPercent",
+    "rotation",
+    "rotate",
+    "rotationX",
+    "rotationY",
+    "rotationZ",
+    "scale",
+    "scaleX",
+    "scaleY",
+    "scaleZ",
+    "skewX",
+    "skewY",
+    "perspective",
+    "transformPerspective",
+    "top",
+    "left",
+    "right",
+    "bottom",
+    "width",
+    "height",
+    "translate",
+    "translateX",
+    "translateY",
+    "translateZ",
+    "transform",
+];
+/** Mean absolute byte difference between two probe captures (never a sample that
+ * enters the average) — the motion signal `adaptiveSampleCount` maps to a count. */
+export function probeDiffMagnitude(a, b) {
+    const decodedA = decodePng(a);
+    const decodedB = decodePng(b);
+    if (decodedA.width !== decodedB.width || decodedA.height !== decodedB.height) {
+        throw new Error(`probeDiffMagnitude: sample geometry mismatch (${decodedA.width}x${decodedA.height} vs ${decodedB.width}x${decodedB.height})`);
+    }
+    let sum = 0;
+    for (let i = 0; i < decodedA.data.length; i++) {
+        sum += Math.abs(decodedA.data[i] - decodedB.data[i]);
+    }
+    return sum / decodedA.data.length;
+}
+const SRGB_TO_LINEAR = (() => {
+    const lut = new Float64Array(256);
+    for (let i = 0; i < 256; i++)
+        lut[i] = srgbByteToLinear(i);
+    return lut;
+})();
+/**
+ * Identity table for the sRGB working space, so the accumulate loop is one shape for both
+ * spaces instead of two near-copies. Measured on a 1920x1080 frame at 16 samples, reading
+ * this table costs nothing against using the byte directly: the two variants time within
+ * each other's run-to-run noise.
+ */
+const SRGB_PASSTHROUGH = (() => {
+    const lut = new Float64Array(256);
+    for (let i = 0; i < 256; i++)
+        lut[i] = i;
+    return lut;
+})();
+function linearToByte(value) {
+    const c = value <= 0.0031308 ? value * 12.92 : 1.055 * Math.pow(value, 1 / 2.4) - 0.055;
+    return clampByte(c * 255);
+}
+function clampByte(value) {
+    return Math.min(255, Math.max(0, Math.round(value)));
+}
+/**
+ * Running average of the sub-frame captures for one output frame.
+ *
+ * Samples are folded in as they arrive rather than held until the end, so peak memory is
+ * one accumulator plus one decoded sample regardless of K. Holding all K decoded frames
+ * would be (K + 1) * 8.3 MB at 1080p, which is 141 MB at the default 16 samples and
+ * 540 MB at the 64 maximum, thrown away and rebuilt on every frame of the render.
+ *
+ * Colour is summed premultiplied by alpha and un-premultiplied at the end, so a sample
+ * that is transparent at a pixel contributes no colour there. On opaque frames, the
+ * common case, that reduces to a plain mean.
+ */
+export class MotionBlurAccumulator {
+    toWorking;
+    fromWorking;
+    /** Premultiplied r, g, b and alpha sums per pixel. Null until the first sample sets the size. */
+    sums = null;
+    width = 0;
+    height = 0;
+    count = 0;
+    constructor(blend) {
+        this.toWorking = blend === "linear" ? SRGB_TO_LINEAR : SRGB_PASSTHROUGH;
+        this.fromWorking = blend === "linear" ? linearToByte : clampByte;
+    }
+    /** Fold one captured sample PNG into the running average. */
+    add(png) {
+        const { width, height, data } = decodePng(png);
+        if (!this.sums) {
+            this.width = width;
+            this.height = height;
+            // float32 holds a 64-sample premultiplied sum (max 16320) far more precisely than
+            // the 1/255 quantum the result is rounded to.
+            this.sums = new Float32Array(width * height * 4);
+        }
+        else if (width !== this.width || height !== this.height) {
+            throw new Error(`MotionBlurAccumulator: sample geometry mismatch (${width}x${height} vs ${this.width}x${this.height})`);
+        }
+        const sums = this.sums;
+        const toWorking = this.toWorking;
+        for (let i = 0; i < sums.length; i += 4) {
+            const alpha = data[i + 3] / 255;
+            sums[i] = sums[i] + toWorking[data[i]] * alpha;
+            sums[i + 1] = sums[i + 1] + toWorking[data[i + 1]] * alpha;
+            sums[i + 2] = sums[i + 2] + toWorking[data[i + 2]] * alpha;
+            sums[i + 3] = sums[i + 3] + alpha;
+        }
+        this.count += 1;
+    }
+    /** Un-premultiply and encode the average. Throws if no sample was ever added. */
+    finish() {
+        const sums = this.sums;
+        if (!sums)
+            throw new Error("MotionBlurAccumulator: no samples");
+        const out = new Uint8Array(sums.length);
+        for (let i = 0; i < sums.length; i += 4) {
+            const alphaSum = sums[i + 3];
+            out[i + 3] = clampByte((alphaSum / this.count) * 255);
+            if (alphaSum === 0)
+                continue;
+            const scale = 1 / alphaSum;
+            out[i] = this.fromWorking(sums[i] * scale);
+            out[i + 1] = this.fromWorking(sums[i + 1] * scale);
+            out[i + 2] = this.fromWorking(sums[i + 2] * scale);
+        }
+        return { width: this.width, height: this.height, data: out };
+    }
+}
+//# sourceMappingURL=motionBlur.js.map

package/dist/services/motionBlur.js.map

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

package/dist/types.d.ts

@@ -5,6 +5,7 @@
  * as video must expose `window.__hf` implementing the HfProtocol interface.
  */
 import type { Fps } from "@hyperframes/core";
+import type { MotionBlurOptions } from "./services/motionBlur.js";
 /**
  * Outcome of waiting for a sub-composition's GSAP timelines to register.
  * Threaded string-typed through `CapturePerfSummary` / `RenderPerfSummary` /
@@ -82,11 +83,22 @@ export interface HfTransitionMeta {
  * GSAP, Framer Motion, CSS animations, Three.js — anything works as long
  * as `seek()` produces deterministic visual output for a given time.
  */
+/**
+ * Per-seek controls the page honours. Both default off, which is an ordinary frame seek.
+ *
+ * `suppressEvents` stops a composition's own timeline callbacks from firing, and
+ * `subFrameDivisions` refines the grid the page quantizes onto so a fractional time is
+ * not floored back onto the output frame. Motion-blur sampling sets both.
+ */
+export interface HfSeekOptions {
+    suppressEvents?: boolean;
+    subFrameDivisions?: number;
+}
 export interface HfProtocol {
     /** Total duration of the composition in seconds */
     duration: number;
     /** Seek to a specific time. Must produce deterministic visual output. */
-    seek(time: number): void;
+    seek(time: number, options?: HfSeekOptions): void;
     /** Optional: media elements the engine should handle */
     media?: HfMediaElement[];
     /** Optional: shader transition metadata, populated by @hyperframes/shader-transitions */
@@ -113,6 +125,12 @@ export interface CaptureOptions {
     fps: Fps;
     format?: "jpeg" | "png";
     quality?: number;
+    /**
+     * Opt into sub-frame multi-sample motion blur (issue #4010). Absent means off and the
+     * capture path is byte-identical to a render without it. Requires `format: "png"` and
+     * screenshot capture mode; see `services/motionBlur.ts`.
+     */
+    motionBlur?: MotionBlurOptions;
     deviceScaleFactor?: number;
     /**
      * Opt into Chrome's capture-beyond-viewport screenshot path. Leave undefined

package/dist/types.d.ts.map

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

package/dist/utils/alphaBlit.d.ts

@@ -17,6 +17,13 @@ export declare function decodePng(buf: Buffer): {
     height: number;
     data: Uint8Array;
 };
+/**
+ * Encode 8-bit RGBA pixels as a PNG, the inverse of `decodePng`.
+ *
+ * Byte-identical for identical pixels: every scanline takes filter 0 and zlib runs at a
+ * fixed level, so a render that samples the same instant twice produces the same file.
+ */
+export declare function encodePng(width: number, height: number, rgba: Uint8Array): Buffer;
 /**
  * Decode a 16-bit RGB PNG (from FFmpeg) to an rgb48le Buffer.
  *
@@ -31,6 +38,32 @@ export declare function decodePngToRgb48le(buf: Buffer): {
     height: number;
     data: Buffer;
 };
+/**
+ * Build a 256-entry LUT: sRGB 8-bit value → HDR 16-bit signal value.
+ *
+ * Pipeline per channel: sRGB EOTF (decode gamma) → linear → HDR OETF → 16-bit.
+ *
+ * ## Convention
+ *
+ * "Linear" here means **scene light in [0, 1] relative to SDR reference white**
+ * (not absolute nits). The HLG branch applies the OETF directly — no OOTF (no
+ * gamma 1.2 scene→display conversion). This is the right choice for DOM
+ * overlays that will be composited ON TOP of HLG video pixels (which are
+ * already in HLG signal space); we need the overlay to sit in the same space
+ * as what it’s blending onto. Applying the OOTF here would double-apply it
+ * when the HDR video already carries scene-light semantics.
+ *
+ * For PQ, SDR white is placed at 203 nits per ITU-R BT.2408 ("SDR white"
+ * reference level) and normalized against 10,000-nit peak. This lets SDR
+ * content (text, UI) sit at the conventional SDR-white brightness within a
+ * PQ frame rather than at peak brightness.
+ *
+ * Note: converts the transfer function but not the color primaries (bt709 →
+ * bt2020). For neutral/near-neutral content (text, UI) the gamut difference
+ * is negligible.
+ */
+/** sRGB EOTF: an 8-bit signal value to linear light, 0 to 1 relative to SDR white. */
+export declare function srgbByteToLinear(value: number): number;
 /**
  * Alpha-composite a DOM RGBA overlay (8-bit sRGB) onto an HDR canvas
  * (rgb48le) in-place.

package/dist/utils/alphaBlit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"alphaBlit.d.ts","sourceRoot":"","sources":["../../src/utils/alphaBlit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiJH;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAuB1F;AAID;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA6B/F;AAqFD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,KAAK,GAAG,IAAI,GAAG,MAAc,GACtC,IAAI,CAiCN;AAcD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GACtC,MAAM,CAOR;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC9C,IAAI,CAiFN;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EAAE,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC9C,IAAI,CA0HN;AAED;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,YAAY,CAAC;AA4F7E;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,SAAkB,EACvB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CA+ER;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAavE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAwCjE"}
+{"version":3,"file":"alphaBlit.d.ts","sourceRoot":"","sources":["../../src/utils/alphaBlit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkJH;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAuB1F;AAoBD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAwBjF;AAID;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA6B/F;AAID;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGtD;AAyDD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,KAAK,GAAG,IAAI,GAAG,MAAc,GACtC,IAAI,CAiCN;AAcD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GACtC,MAAM,CAOR;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC9C,IAAI,CAiFN;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EAAE,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC9C,IAAI,CA0HN;AAED;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,YAAY,CAAC;AA4F7E;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,SAAkB,EACvB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CA+ER;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAavE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAwCjE"}

package/dist/utils/alphaBlit.js

@@ -4,7 +4,8 @@
  * Replaces per-frame FFmpeg spawns for the two-pass HDR compositing path.
  * Uses only Node.js built-ins (zlib) — no additional dependencies.
  */
-import { inflateSync } from "zlib";
+import { deflateSync, inflateSync } from "zlib";
+import { chunkCrc32 } from "./crc32.js";
 // ── PNG decoder ───────────────────────────────────────────────────────────────
 function paeth(a, b, c) {
     const p = a + b - c;
@@ -156,6 +157,50 @@ export function decodePng(buf) {
     }
     return { width, height, data: output };
 }
+// ── PNG encoder ──────────────────────────────────────────────────
+/**
+ * Intermediate frames are read once by the encoder and deleted, so encode speed matters
+ * and compression ratio does not. Measured on a 1920x1080 frame: level 1 takes 214 ms for
+ * 4.14 MiB against level 6's 293 ms for 3.98 MiB.
+ */
+const PNG_DEFLATE_LEVEL = 1;
+function pngChunk(type, body) {
+    const header = Buffer.alloc(8);
+    header.writeUInt32BE(body.length, 0);
+    header.write(type, 4, "ascii");
+    const trailer = Buffer.alloc(4);
+    trailer.writeUInt32BE(chunkCrc32(type, body), 0);
+    return Buffer.concat([header, body, trailer]);
+}
+/**
+ * Encode 8-bit RGBA pixels as a PNG, the inverse of `decodePng`.
+ *
+ * Byte-identical for identical pixels: every scanline takes filter 0 and zlib runs at a
+ * fixed level, so a render that samples the same instant twice produces the same file.
+ */
+export function encodePng(width, height, rgba) {
+    const expected = width * height * 4;
+    if (rgba.length !== expected) {
+        throw new Error(`encodePng: expected ${expected} bytes for ${width}x${height}, got ${rgba.length}`);
+    }
+    const stride = width * 4;
+    const filtered = Buffer.alloc((stride + 1) * height);
+    for (let y = 0; y < height; y++) {
+        filtered[y * (stride + 1)] = 0;
+        filtered.set(rgba.subarray(y * stride, (y + 1) * stride), y * (stride + 1) + 1);
+    }
+    const ihdr = Buffer.alloc(13);
+    ihdr.writeUInt32BE(width, 0);
+    ihdr.writeUInt32BE(height, 4);
+    ihdr[8] = 8; // bit depth
+    ihdr[9] = 6; // colour type RGBA
+    return Buffer.concat([
+        Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]),
+        pngChunk("IHDR", ihdr),
+        pngChunk("IDAT", deflateSync(filtered, { level: PNG_DEFLATE_LEVEL })),
+        pngChunk("IEND", Buffer.alloc(0)),
+    ]);
+}
 // ── 16-bit PNG decoder ────────────────────────────────────────────────────────
 /**
  * Decode a 16-bit RGB PNG (from FFmpeg) to an rgb48le Buffer.
@@ -216,6 +261,11 @@ export function decodePngToRgb48le(buf) {
  * bt2020). For neutral/near-neutral content (text, UI) the gamut difference
  * is negligible.
  */
+/** sRGB EOTF: an 8-bit signal value to linear light, 0 to 1 relative to SDR white. */
+export function srgbByteToLinear(value) {
+    const v = value / 255;
+    return v <= 0.04045 ? v / 12.92 : Math.pow((v + 0.055) / 1.055, 2.4);
+}
 function buildSrgbToSignalLut(transfer) {
     const lut = new Uint16Array(256);
     // HLG OETF constants (Rec. 2100)
@@ -235,9 +285,7 @@ function buildSrgbToSignalLut(transfer) {
             lut[i] = i * 257;
             continue;
         }
-        // sRGB EOTF: signal → linear (range 0–1, relative to SDR white)
-        const v = i / 255;
-        const linear = v <= 0.04045 ? v / 12.92 : Math.pow((v + 0.055) / 1.055, 2.4);
+        const linear = srgbByteToLinear(i);
         let signal;
         if (transfer === "hlg") {
             signal =