hyperframes 0.8.45 → 0.8.46

package/dist/cli.js

@@ -50,7 +50,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.8.45" : "0.0.0-dev";
+    VERSION = true ? "0.8.46" : "0.0.0-dev";
   }
 });
 
@@ -66022,37 +66022,80 @@ function finiteOr(value, fallback) {
 }
 function resolveMotionBlurPlan(options) {
   if (!options) return null;
-  const samplesPerFrame = Math.min(
+  const fixedSamplesPerFrame = options.samplesPerFrame === void 0 ? 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";
-  const windowStartFrames = shutterPhase / 360;
-  const shutterFrames = shutterAngle / 360;
-  const sampleTickOffsets = [];
+  return {
+    blend,
+    subFrameDivisions: SUB_FRAME_DIVISIONS,
+    windowStartFrames: shutterPhase / 360,
+    shutterFrames: shutterAngle / 360,
+    fixedSamplesPerFrame
+  };
+}
+function sampleTickOffsets(plan2, samplesPerFrame) {
+  const offsets = [];
   for (let k2 = 0; k2 < samplesPerFrame; k2++) {
-    const offsetFrames = windowStartFrames + (k2 + 0.5) / samplesPerFrame * shutterFrames;
-    sampleTickOffsets.push(Math.round(offsetFrames * SUB_FRAME_DIVISIONS));
+    const offsetFrames = plan2.windowStartFrames + (k2 + 0.5) / samplesPerFrame * plan2.shutterFrames;
+    offsets.push(Math.round(offsetFrames * plan2.subFrameDivisions));
   }
-  return { blend, subFrameDivisions: SUB_FRAME_DIVISIONS, sampleTickOffsets };
+  return offsets;
 }
-function motionBlurSampleTimes(plan2, frameIndex, fps) {
+function motionBlurSampleTimes(plan2, frameIndex, fps, samplesPerFrame) {
   const grid = fps * plan2.subFrameDivisions;
   const frameTicks = frameIndex * plan2.subFrameDivisions;
-  return plan2.sampleTickOffsets.map((offset2) => Math.max(0, frameTicks + offset2) / grid);
+  return sampleTickOffsets(plan2, samplesPerFrame).map(
+    (offset2) => Math.max(0, frameTicks + offset2) / grid
+  );
 }
-function motionBlurWindowIsStatic(plan2, frameIndex, staticFrames) {
-  const first = Math.floor(
-    frameIndex - 1 + Math.min(...plan2.sampleTickOffsets) / plan2.subFrameDivisions
+function motionBlurProbeTimes(plan2, frameIndex, fps) {
+  const grid = fps * plan2.subFrameDivisions;
+  const frameTicks = frameIndex * plan2.subFrameDivisions;
+  const startTick = Math.round(plan2.windowStartFrames * plan2.subFrameDivisions);
+  const endTick = Math.round(
+    (plan2.windowStartFrames + plan2.shutterFrames) * plan2.subFrameDivisions
   );
-  const last = Math.floor(frameIndex + Math.max(...plan2.sampleTickOffsets) / plan2.subFrameDivisions) + 1;
+  return {
+    windowStart: Math.max(0, frameTicks + startTick) / grid,
+    windowEnd: Math.max(0, frameTicks + endTick) / grid
+  };
+}
+function motionBlurWindowIsStatic(plan2, frameIndex, staticFrames) {
+  const worstCaseSamples = plan2.fixedSamplesPerFrame ?? MAX_SAMPLES_PER_FRAME;
+  const inset = plan2.shutterFrames / (2 * worstCaseSamples);
+  const minOffsetFrames = plan2.windowStartFrames + inset;
+  const maxOffsetFrames = plan2.windowStartFrames + plan2.shutterFrames - inset;
+  const first = Math.floor(frameIndex - 1 + Math.min(0, minOffsetFrames));
+  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;
 }
+function adaptiveSampleCount(diff) {
+  for (const step of ADAPTIVE_SAMPLE_STEPS) {
+    if (diff <= step.maxDiff) return step.samples;
+  }
+  return MAX_SAMPLES_PER_FRAME;
+}
+function probeDiffMagnitude(a, b2) {
+  const decodedA = decodePng(a);
+  const decodedB = decodePng(b2);
+  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 i2 = 0; i2 < decodedA.data.length; i2++) {
+    sum += Math.abs(decodedA.data[i2] - decodedB.data[i2]);
+  }
+  return sum / decodedA.data.length;
+}
 function linearToByte(value) {
   const c3 = value <= 31308e-7 ? value * 12.92 : 1.055 * Math.pow(value, 1 / 2.4) - 0.055;
   return clampByte(c3 * 255);
@@ -66060,7 +66103,7 @@ function linearToByte(value) {
 function clampByte(value) {
   return Math.min(255, Math.max(0, Math.round(value)));
 }
-var MAX_SAMPLES_PER_FRAME, DEFAULT_SAMPLES_PER_FRAME, DEFAULT_SHUTTER_ANGLE, DEFAULT_SHUTTER_PHASE, SUB_FRAME_DIVISIONS, SRGB_TO_LINEAR, SRGB_PASSTHROUGH, MotionBlurAccumulator;
+var MAX_SAMPLES_PER_FRAME, DEFAULT_SAMPLES_PER_FRAME, DEFAULT_SHUTTER_ANGLE, DEFAULT_SHUTTER_PHASE, SUB_FRAME_DIVISIONS, ADAPTIVE_SAMPLE_STEPS, SPATIAL_TWEEN_PROPERTIES, SRGB_TO_LINEAR, SRGB_PASSTHROUGH, MotionBlurAccumulator;
 var init_motionBlur = __esm({
   "../engine/src/services/motionBlur.ts"() {
     "use strict";
@@ -66070,6 +66113,42 @@ var init_motionBlur = __esm({
     DEFAULT_SHUTTER_ANGLE = 180;
     DEFAULT_SHUTTER_PHASE = -90;
     SUB_FRAME_DIVISIONS = 4096;
+    ADAPTIVE_SAMPLE_STEPS = [
+      { maxDiff: 3, samples: DEFAULT_SAMPLES_PER_FRAME },
+      { maxDiff: 6, samples: 32 },
+      { maxDiff: Infinity, samples: MAX_SAMPLES_PER_FRAME }
+    ];
+    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"
+    ];
     SRGB_TO_LINEAR = (() => {
       const lut = new Float64Array(256);
       for (let i2 = 0; i2 < 256; i2++) lut[i2] = srgbByteToLinear(i2);
@@ -69691,7 +69770,13 @@ function isStaticDedupFrameAnalysisSafe(totalFrames) {
   return Number.isFinite(totalFrames) && Number.isSafeInteger(totalFrames) && totalFrames > 0 && totalFrames <= MAX_STATIC_DEDUP_ANALYSIS_FRAMES;
 }
 async function computeStaticFrameSet(page, fps) {
-  const result = await page.evaluate(() => {
+  const result = await page.evaluate((spatialProps) => {
+    const SPATIAL_PROPS = new Set(spatialProps);
+    function isSpatial(vars) {
+      if (!vars) return false;
+      for (const key2 of Object.keys(vars)) if (SPATIAL_PROPS.has(key2)) return true;
+      return false;
+    }
     const intervals2 = [];
     let tweenCount2 = 0;
     let hasTimelineCall2 = false;
@@ -69699,7 +69784,7 @@ async function computeStaticFrameSet(page, fps) {
       if (typeof tl.getChildren !== "function") return;
       if (typeof tl.vars?.onUpdate === "function") {
         const total = typeof tl.totalDuration === "function" ? tl.totalDuration() : 0;
-        if (total > 0) intervals2.push({ start: offset2, end: offset2 + total });
+        if (total > 0) intervals2.push({ start: offset2, end: offset2 + total, spatial: true });
       }
       for (const child of tl.getChildren(false, true, true)) {
         const start = offset2 + (typeof child.startTime === "function" ? child.startTime() : 0);
@@ -69707,14 +69792,14 @@ async function computeStaticFrameSet(page, fps) {
         const total = typeof child.totalDuration === "function" ? child.totalDuration() : single;
         if (typeof child.getChildren === "function") {
           if (total > single + 1e-6) {
-            intervals2.push({ start, end: start + total });
+            intervals2.push({ start, end: start + total, spatial: true });
             walk2(child, start);
           } else {
             walk2(child, start);
           }
         } else {
           tweenCount2++;
-          intervals2.push({ start, end: start + total });
+          intervals2.push({ start, end: start + total, spatial: isSpatial(child.vars) });
           if (total <= 1e-6 && (typeof child.vars?.onComplete === "function" || typeof child.vars?.onReverseComplete === "function")) {
             hasTimelineCall2 = true;
           }
@@ -69755,7 +69840,7 @@ async function computeStaticFrameSet(page, fps) {
       hasUnresolvableClipStart: hasUnresolvableClipStart2,
       hasTimelineCall: hasTimelineCall2
     };
-  });
+  }, SPATIAL_TWEEN_PROPERTIES);
   const {
     intervals,
     tweenCount,
@@ -69771,6 +69856,7 @@ async function computeStaticFrameSet(page, fps) {
     return {
       totalFrames,
       staticFrameSet: /* @__PURE__ */ new Set(),
+      nonSpatialOnlyFrameSet: /* @__PURE__ */ new Set(),
       hasVideo,
       hasCanvas,
       hasNonGsapAnim,
@@ -69780,10 +69866,14 @@ async function computeStaticFrameSet(page, fps) {
     };
   }
   const animated = /* @__PURE__ */ new Set();
-  for (const { start, end } of intervals) {
+  const spatialFrameSet = /* @__PURE__ */ new Set();
+  for (const { start, end, spatial } of intervals) {
     const lo = Math.max(0, Math.floor(start * fps));
     const hi = Math.min(totalFrames - 1, Math.ceil(end * fps));
-    for (let f3 = lo; f3 <= hi; f3++) animated.add(f3);
+    for (let f3 = lo; f3 <= hi; f3++) {
+      animated.add(f3);
+      if (spatial) spatialFrameSet.add(f3);
+    }
   }
   for (const f3 of await computeClipBoundaryFrames(page, fps)) animated.add(f3);
   const reasons = [];
@@ -69801,9 +69891,14 @@ async function computeStaticFrameSet(page, fps) {
       if (!animated.has(f3) && !animated.has(f3 - 1)) staticFrameSet.add(f3);
     }
   }
+  const nonSpatialOnlyFrameSet = /* @__PURE__ */ new Set();
+  if (eligible) {
+    for (const f3 of animated) if (!spatialFrameSet.has(f3)) nonSpatialOnlyFrameSet.add(f3);
+  }
   return {
     totalFrames,
     staticFrameSet,
+    nonSpatialOnlyFrameSet,
     hasVideo,
     hasCanvas,
     hasNonGsapAnim,
@@ -70013,6 +70108,11 @@ async function verifyStaticFramesSafe(session, page, staticFrames, fps, sampleCo
   }
 }
 async function armStaticDedup(session, page, logInitPhase) {
+  let sharedStaticFrameStats;
+  if (session.options.motionBlur && session.options.motionBlur.samplesPerFrame === void 0 && !session.motionBlurNonSpatialFrames) {
+    sharedStaticFrameStats = await computeStaticFrameSet(page, fpsToNumber(session.options.fps));
+    session.motionBlurNonSpatialFrames = sharedStaticFrameStats.nonSpatialOnlyFrameSet;
+  }
   if (session.staticFrames || session.staticDedupSkipReason) return;
   session.staticDedupEnabled = session.config?.staticFrameDedup !== false;
   if (!session.staticDedupEnabled) return;
@@ -70037,7 +70137,7 @@ async function armStaticDedup(session, page, logInitPhase) {
     return;
   }
   const fps = fpsToNumber(session.options.fps);
-  const stats = await computeStaticFrameSet(page, fps);
+  const stats = sharedStaticFrameStats ?? await computeStaticFrameSet(page, fps);
   if (!stats.eligible || stats.staticFrameSet.size === 0) {
     session.staticDedupSkipReason = "ineligible";
     logInitPhase(`static-frame dedup: disabled (${stats.reason})`);
@@ -70283,6 +70383,25 @@ function finalizeSessionInit(session) {
   session.motionBlur = resolveSessionMotionBlur(session);
   session.isInitialized = true;
 }
+async function resolveAdaptiveSampleCount(session, frameIndex, absFrameIndex, plan2, fps, sampleSeek) {
+  if (session.motionBlurNonSpatialFrames?.has(absFrameIndex)) {
+    return {
+      samplesPerFrame: DEFAULT_SAMPLES_PER_FRAME,
+      seekMs: 0,
+      beforeCaptureMs: 0,
+      screenshotMs: 0
+    };
+  }
+  const { windowStart, windowEnd } = motionBlurProbeTimes(plan2, absFrameIndex, fps);
+  const probeA = await captureFrameSurface(session, frameIndex, windowStart, sampleSeek);
+  const probeB = await captureFrameSurface(session, frameIndex, windowEnd, sampleSeek);
+  return {
+    samplesPerFrame: adaptiveSampleCount(probeDiffMagnitude(probeA.buffer, probeB.buffer)),
+    seekMs: probeA.seekMs + probeB.seekMs,
+    beforeCaptureMs: probeA.beforeCaptureMs + probeB.beforeCaptureMs,
+    screenshotMs: probeA.screenshotMs + probeB.screenshotMs
+  };
+}
 async function captureAccumulatedFrame(session, frameIndex, absFrameIndex, plan2) {
   const fps = fpsToNumber(session.options.fps);
   const frameTime = quantizeSeekTime(absFrameIndex / fps, fps);
@@ -70293,8 +70412,23 @@ async function captureAccumulatedFrame(session, frameIndex, absFrameIndex, plan2
     suppressEvents: true,
     subFrameDivisions: plan2.subFrameDivisions
   };
+  let samplesPerFrame = plan2.fixedSamplesPerFrame;
+  if (samplesPerFrame === null) {
+    const chosen = await resolveAdaptiveSampleCount(
+      session,
+      frameIndex,
+      absFrameIndex,
+      plan2,
+      fps,
+      sampleSeek
+    );
+    samplesPerFrame = chosen.samplesPerFrame;
+    totals.seekMs += chosen.seekMs;
+    totals.beforeCaptureMs += chosen.beforeCaptureMs;
+    totals.screenshotMs += chosen.screenshotMs;
+  }
   const accumulator = new MotionBlurAccumulator(plan2.blend);
-  for (const sampleTime of motionBlurSampleTimes(plan2, absFrameIndex, fps)) {
+  for (const sampleTime of motionBlurSampleTimes(plan2, absFrameIndex, fps, samplesPerFrame)) {
     const sample = await captureFrameSurface(session, frameIndex, sampleTime, sampleSeek);
     totals.seekMs += sample.seekMs;
     totals.beforeCaptureMs += sample.beforeCaptureMs;

package/dist/fontLocalizeCli.js

@@ -56326,37 +56326,80 @@ function finiteOr(value, fallback) {
 }
 function resolveMotionBlurPlan(options) {
   if (!options) return null;
-  const samplesPerFrame = Math.min(
+  const fixedSamplesPerFrame = options.samplesPerFrame === void 0 ? 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";
-  const windowStartFrames = shutterPhase / 360;
-  const shutterFrames = shutterAngle / 360;
-  const sampleTickOffsets = [];
+  return {
+    blend,
+    subFrameDivisions: SUB_FRAME_DIVISIONS,
+    windowStartFrames: shutterPhase / 360,
+    shutterFrames: shutterAngle / 360,
+    fixedSamplesPerFrame
+  };
+}
+function sampleTickOffsets(plan2, samplesPerFrame) {
+  const offsets = [];
   for (let k = 0; k < samplesPerFrame; k++) {
-    const offsetFrames = windowStartFrames + (k + 0.5) / samplesPerFrame * shutterFrames;
-    sampleTickOffsets.push(Math.round(offsetFrames * SUB_FRAME_DIVISIONS));
+    const offsetFrames = plan2.windowStartFrames + (k + 0.5) / samplesPerFrame * plan2.shutterFrames;
+    offsets.push(Math.round(offsetFrames * plan2.subFrameDivisions));
   }
-  return { blend, subFrameDivisions: SUB_FRAME_DIVISIONS, sampleTickOffsets };
+  return offsets;
 }
-function motionBlurSampleTimes(plan2, frameIndex, fps) {
+function motionBlurSampleTimes(plan2, frameIndex, fps, samplesPerFrame) {
   const grid = fps * plan2.subFrameDivisions;
   const frameTicks = frameIndex * plan2.subFrameDivisions;
-  return plan2.sampleTickOffsets.map((offset2) => Math.max(0, frameTicks + offset2) / grid);
+  return sampleTickOffsets(plan2, samplesPerFrame).map(
+    (offset2) => Math.max(0, frameTicks + offset2) / grid
+  );
 }
-function motionBlurWindowIsStatic(plan2, frameIndex, staticFrames) {
-  const first = Math.floor(
-    frameIndex - 1 + Math.min(...plan2.sampleTickOffsets) / plan2.subFrameDivisions
+function motionBlurProbeTimes(plan2, frameIndex, fps) {
+  const grid = fps * plan2.subFrameDivisions;
+  const frameTicks = frameIndex * plan2.subFrameDivisions;
+  const startTick = Math.round(plan2.windowStartFrames * plan2.subFrameDivisions);
+  const endTick = Math.round(
+    (plan2.windowStartFrames + plan2.shutterFrames) * plan2.subFrameDivisions
   );
-  const last = Math.floor(frameIndex + Math.max(...plan2.sampleTickOffsets) / plan2.subFrameDivisions) + 1;
+  return {
+    windowStart: Math.max(0, frameTicks + startTick) / grid,
+    windowEnd: Math.max(0, frameTicks + endTick) / grid
+  };
+}
+function motionBlurWindowIsStatic(plan2, frameIndex, staticFrames) {
+  const worstCaseSamples = plan2.fixedSamplesPerFrame ?? MAX_SAMPLES_PER_FRAME;
+  const inset = plan2.shutterFrames / (2 * worstCaseSamples);
+  const minOffsetFrames = plan2.windowStartFrames + inset;
+  const maxOffsetFrames = plan2.windowStartFrames + plan2.shutterFrames - inset;
+  const first = Math.floor(frameIndex - 1 + Math.min(0, minOffsetFrames));
+  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;
 }
+function adaptiveSampleCount(diff) {
+  for (const step of ADAPTIVE_SAMPLE_STEPS) {
+    if (diff <= step.maxDiff) return step.samples;
+  }
+  return MAX_SAMPLES_PER_FRAME;
+}
+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;
+}
 function linearToByte(value) {
   const c = value <= 31308e-7 ? value * 12.92 : 1.055 * Math.pow(value, 1 / 2.4) - 0.055;
   return clampByte(c * 255);
@@ -56364,7 +56407,7 @@ function linearToByte(value) {
 function clampByte(value) {
   return Math.min(255, Math.max(0, Math.round(value)));
 }
-var MAX_SAMPLES_PER_FRAME, DEFAULT_SAMPLES_PER_FRAME, DEFAULT_SHUTTER_ANGLE, DEFAULT_SHUTTER_PHASE, SUB_FRAME_DIVISIONS, SRGB_TO_LINEAR, SRGB_PASSTHROUGH, MotionBlurAccumulator;
+var MAX_SAMPLES_PER_FRAME, DEFAULT_SAMPLES_PER_FRAME, DEFAULT_SHUTTER_ANGLE, DEFAULT_SHUTTER_PHASE, SUB_FRAME_DIVISIONS, ADAPTIVE_SAMPLE_STEPS, SPATIAL_TWEEN_PROPERTIES, SRGB_TO_LINEAR, SRGB_PASSTHROUGH, MotionBlurAccumulator;
 var init_motionBlur = __esm({
   "../engine/src/services/motionBlur.ts"() {
     "use strict";
@@ -56374,6 +56417,42 @@ var init_motionBlur = __esm({
     DEFAULT_SHUTTER_ANGLE = 180;
     DEFAULT_SHUTTER_PHASE = -90;
     SUB_FRAME_DIVISIONS = 4096;
+    ADAPTIVE_SAMPLE_STEPS = [
+      { maxDiff: 3, samples: DEFAULT_SAMPLES_PER_FRAME },
+      { maxDiff: 6, samples: 32 },
+      { maxDiff: Infinity, samples: MAX_SAMPLES_PER_FRAME }
+    ];
+    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"
+    ];
     SRGB_TO_LINEAR = (() => {
       const lut = new Float64Array(256);
       for (let i = 0; i < 256; i++) lut[i] = srgbByteToLinear(i);
@@ -59995,7 +60074,13 @@ function isStaticDedupFrameAnalysisSafe(totalFrames) {
   return Number.isFinite(totalFrames) && Number.isSafeInteger(totalFrames) && totalFrames > 0 && totalFrames <= MAX_STATIC_DEDUP_ANALYSIS_FRAMES;
 }
 async function computeStaticFrameSet(page, fps) {
-  const result = await page.evaluate(() => {
+  const result = await page.evaluate((spatialProps) => {
+    const SPATIAL_PROPS = new Set(spatialProps);
+    function isSpatial(vars) {
+      if (!vars) return false;
+      for (const key2 of Object.keys(vars)) if (SPATIAL_PROPS.has(key2)) return true;
+      return false;
+    }
     const intervals2 = [];
     let tweenCount2 = 0;
     let hasTimelineCall2 = false;
@@ -60003,7 +60088,7 @@ async function computeStaticFrameSet(page, fps) {
       if (typeof tl.getChildren !== "function") return;
       if (typeof tl.vars?.onUpdate === "function") {
         const total = typeof tl.totalDuration === "function" ? tl.totalDuration() : 0;
-        if (total > 0) intervals2.push({ start: offset2, end: offset2 + total });
+        if (total > 0) intervals2.push({ start: offset2, end: offset2 + total, spatial: true });
       }
       for (const child of tl.getChildren(false, true, true)) {
         const start = offset2 + (typeof child.startTime === "function" ? child.startTime() : 0);
@@ -60011,14 +60096,14 @@ async function computeStaticFrameSet(page, fps) {
         const total = typeof child.totalDuration === "function" ? child.totalDuration() : single;
         if (typeof child.getChildren === "function") {
           if (total > single + 1e-6) {
-            intervals2.push({ start, end: start + total });
+            intervals2.push({ start, end: start + total, spatial: true });
             walk(child, start);
           } else {
             walk(child, start);
           }
         } else {
           tweenCount2++;
-          intervals2.push({ start, end: start + total });
+          intervals2.push({ start, end: start + total, spatial: isSpatial(child.vars) });
           if (total <= 1e-6 && (typeof child.vars?.onComplete === "function" || typeof child.vars?.onReverseComplete === "function")) {
             hasTimelineCall2 = true;
           }
@@ -60059,7 +60144,7 @@ async function computeStaticFrameSet(page, fps) {
       hasUnresolvableClipStart: hasUnresolvableClipStart2,
       hasTimelineCall: hasTimelineCall2
     };
-  });
+  }, SPATIAL_TWEEN_PROPERTIES);
   const {
     intervals,
     tweenCount,
@@ -60075,6 +60160,7 @@ async function computeStaticFrameSet(page, fps) {
     return {
       totalFrames,
       staticFrameSet: /* @__PURE__ */ new Set(),
+      nonSpatialOnlyFrameSet: /* @__PURE__ */ new Set(),
       hasVideo,
       hasCanvas,
       hasNonGsapAnim,
@@ -60084,10 +60170,14 @@ async function computeStaticFrameSet(page, fps) {
     };
   }
   const animated = /* @__PURE__ */ new Set();
-  for (const { start, end } of intervals) {
+  const spatialFrameSet = /* @__PURE__ */ new Set();
+  for (const { start, end, spatial } 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 (let f = lo; f <= hi; f++) {
+      animated.add(f);
+      if (spatial) spatialFrameSet.add(f);
+    }
   }
   for (const f of await computeClipBoundaryFrames(page, fps)) animated.add(f);
   const reasons = [];
@@ -60105,9 +60195,14 @@ async function computeStaticFrameSet(page, fps) {
       if (!animated.has(f) && !animated.has(f - 1)) staticFrameSet.add(f);
     }
   }
+  const nonSpatialOnlyFrameSet = /* @__PURE__ */ new Set();
+  if (eligible) {
+    for (const f of animated) if (!spatialFrameSet.has(f)) nonSpatialOnlyFrameSet.add(f);
+  }
   return {
     totalFrames,
     staticFrameSet,
+    nonSpatialOnlyFrameSet,
     hasVideo,
     hasCanvas,
     hasNonGsapAnim,
@@ -60317,6 +60412,11 @@ async function verifyStaticFramesSafe(session, page, staticFrames, fps, sampleCo
   }
 }
 async function armStaticDedup(session, page, logInitPhase) {
+  let sharedStaticFrameStats;
+  if (session.options.motionBlur && session.options.motionBlur.samplesPerFrame === void 0 && !session.motionBlurNonSpatialFrames) {
+    sharedStaticFrameStats = await computeStaticFrameSet(page, fpsToNumber(session.options.fps));
+    session.motionBlurNonSpatialFrames = sharedStaticFrameStats.nonSpatialOnlyFrameSet;
+  }
   if (session.staticFrames || session.staticDedupSkipReason) return;
   session.staticDedupEnabled = session.config?.staticFrameDedup !== false;
   if (!session.staticDedupEnabled) return;
@@ -60341,7 +60441,7 @@ async function armStaticDedup(session, page, logInitPhase) {
     return;
   }
   const fps = fpsToNumber(session.options.fps);
-  const stats = await computeStaticFrameSet(page, fps);
+  const stats = sharedStaticFrameStats ?? await computeStaticFrameSet(page, fps);
   if (!stats.eligible || stats.staticFrameSet.size === 0) {
     session.staticDedupSkipReason = "ineligible";
     logInitPhase(`static-frame dedup: disabled (${stats.reason})`);
@@ -60587,6 +60687,25 @@ function finalizeSessionInit(session) {
   session.motionBlur = resolveSessionMotionBlur(session);
   session.isInitialized = true;
 }
+async function resolveAdaptiveSampleCount(session, frameIndex, absFrameIndex, plan2, fps, sampleSeek) {
+  if (session.motionBlurNonSpatialFrames?.has(absFrameIndex)) {
+    return {
+      samplesPerFrame: DEFAULT_SAMPLES_PER_FRAME,
+      seekMs: 0,
+      beforeCaptureMs: 0,
+      screenshotMs: 0
+    };
+  }
+  const { windowStart, windowEnd } = motionBlurProbeTimes(plan2, absFrameIndex, fps);
+  const probeA = await captureFrameSurface(session, frameIndex, windowStart, sampleSeek);
+  const probeB = await captureFrameSurface(session, frameIndex, windowEnd, sampleSeek);
+  return {
+    samplesPerFrame: adaptiveSampleCount(probeDiffMagnitude(probeA.buffer, probeB.buffer)),
+    seekMs: probeA.seekMs + probeB.seekMs,
+    beforeCaptureMs: probeA.beforeCaptureMs + probeB.beforeCaptureMs,
+    screenshotMs: probeA.screenshotMs + probeB.screenshotMs
+  };
+}
 async function captureAccumulatedFrame(session, frameIndex, absFrameIndex, plan2) {
   const fps = fpsToNumber(session.options.fps);
   const frameTime = quantizeSeekTime(absFrameIndex / fps, fps);
@@ -60597,8 +60716,23 @@ async function captureAccumulatedFrame(session, frameIndex, absFrameIndex, plan2
     suppressEvents: true,
     subFrameDivisions: plan2.subFrameDivisions
   };
+  let samplesPerFrame = plan2.fixedSamplesPerFrame;
+  if (samplesPerFrame === null) {
+    const chosen = await resolveAdaptiveSampleCount(
+      session,
+      frameIndex,
+      absFrameIndex,
+      plan2,
+      fps,
+      sampleSeek
+    );
+    samplesPerFrame = chosen.samplesPerFrame;
+    totals.seekMs += chosen.seekMs;
+    totals.beforeCaptureMs += chosen.beforeCaptureMs;
+    totals.screenshotMs += chosen.screenshotMs;
+  }
   const accumulator = new MotionBlurAccumulator(plan2.blend);
-  for (const sampleTime of motionBlurSampleTimes(plan2, absFrameIndex, fps)) {
+  for (const sampleTime of motionBlurSampleTimes(plan2, absFrameIndex, fps, samplesPerFrame)) {
     const sample = await captureFrameSurface(session, frameIndex, sampleTime, sampleSeek);
     totals.seekMs += sample.seekMs;
     totals.beforeCaptureMs += sample.beforeCaptureMs;
@@ -100520,8 +100654,8 @@ async function runFontLocalize(io, localize) {
 }
 
 // src/version.ts
-var VERSION = true ? "0.8.45" : "0.0.0-dev";
-var PRODUCER_VERSION = true ? "0.8.45" : "0.0.0-dev";
+var VERSION = true ? "0.8.46" : "0.0.0-dev";
+var PRODUCER_VERSION = true ? "0.8.46" : "0.0.0-dev";
 
 // src/fontLocalizeCli.ts
 async function readStdin() {

package/dist/hyperframes-player.global.js

@@ -1,4 +1,4 @@
-"use strict";var HyperframesPlayer=(()=>{var ee=Object.defineProperty;var et=Object.getOwnPropertyDescriptor;var tt=Object.getOwnPropertyNames;var it=Object.prototype.hasOwnProperty;var rt=(r,e)=>{for(var t in e)ee(r,t,{get:e[t],enumerable:!0})},nt=(r,e,t,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of tt(e))!it.call(r,n)&&n!==t&&ee(r,n,{get:()=>e[n],enumerable:!(i=et(e,n))||i.enumerable});return r};var ot=r=>nt(ee({},"__esModule",{value:!0}),r);var Ht={};rt(Ht,{HyperframesPlayer:()=>K,SPEED_PRESETS:()=>re,formatSpeed:()=>O,formatTime:()=>q});function we(r){return r.hasRuntime||r.runtimeInjected?!1:!!(r.hasNestedCompositions||r.hasTimelines&&r.attempts>=5)}function P(r){return typeof r=="object"&&r!==null}function Ae(r){return P(r)&&typeof r.getDuration=="function"}function Ce(r){return P(r)&&typeof r.duration=="function"&&typeof r.time=="function"&&typeof r.seek=="function"&&typeof r.play=="function"&&typeof r.pause=="function"}var k="https://cdn.jsdelivr.net/npm/@hyperframes/core@0.8.45/dist/hyperframe.runtime.iife.js";function N(r){if(r===null)return null;let e=Number.parseInt(r,10);return Number.isFinite(e)&&e>0?e:null}function at(r){let e=r?.querySelector("[data-composition-id][data-width][data-height]")??r?.querySelector("[data-width][data-height]");if(!e)return null;let t=N(e.getAttribute("data-width")),i=N(e.getAttribute("data-height"));return t!==null&&i!==null?{width:t,height:i}:null}var W=class{constructor(e,t){this._iframe=e;this._callbacks=t}_iframe;_callbacks;_interval=null;_runtimeInjected=!1;get runtimeInjected(){return this._runtimeInjected}start(){this.stop(),this._runtimeInjected=!1;let e=0;this._interval=setInterval(()=>{e++;try{let t=this._iframe.contentWindow;if(!t)return;let i=!!(t.__hf||t.__player),n=!!(t.__timelines&&Object.keys(t.__timelines).length>0),o=!!this._iframe.contentDocument?.querySelector("[data-composition-src]");if(we({hasRuntime:i,hasTimelines:n,hasNestedCompositions:o,runtimeInjected:this._runtimeInjected,attempts:e})){this._injectRuntime();return}if(this._runtimeInjected&&!i)return;let d=this._resolvePlaybackDurationAdapter(t);if(d&&d.getDuration()>0){this.stop();let s=at(this._iframe.contentDocument);this._callbacks.onReady({duration:d.getDuration(),adapter:d,compositionSize:s});return}}catch{}e>=40&&(this.stop(),this._callbacks.onError("Composition timeline not found after 8s"))},200)}stop(){this._interval!==null&&(clearInterval(this._interval),this._interval=null)}resolveDirectTimelineAdapter(){try{let e=this._iframe.contentWindow;return e?this._resolveDirectTimelineAdapterFromWindow(e):null}catch{return null}}resolveDirectTimelineAdapterFromWindow(e){return this._resolveDirectTimelineAdapterFromWindow(e)}hasRuntimeBridge(e){return Reflect.get(e,"__hf")!==void 0||P(Reflect.get(e,"__player"))}_injectRuntime(){this._runtimeInjected=!0;try{let e=this._iframe.contentDocument;if(!e)return;let t=e.createElement("script");t.src=k,(e.head||e.documentElement).appendChild(t),this._callbacks.onRuntimeInjected?.()}catch{}}_resolveDirectTimelineAdapterFromWindow(e){if(this.hasRuntimeBridge(e))return null;let t=Reflect.get(e,"__timelines");if(!P(t))return null;let i=Object.keys(t);if(i.length===0)return null;let n=this._iframe.contentDocument?.querySelector("[data-composition-id]")?.getAttribute("data-composition-id"),o=n&&n in t?n:i[i.length-1],d=t[o];return Ce(d)?d:null}_resolvePlaybackDurationAdapter(e){let t=Reflect.get(e,"__player");if(Ae(t))return{kind:"runtime",getDuration:()=>t.getDuration()};let i=this._resolveDirectTimelineAdapterFromWindow(e);return i?{kind:"direct-timeline",timeline:i,getDuration:()=>i.duration()}:null}};var Re=`
+"use strict";var HyperframesPlayer=(()=>{var ee=Object.defineProperty;var et=Object.getOwnPropertyDescriptor;var tt=Object.getOwnPropertyNames;var it=Object.prototype.hasOwnProperty;var rt=(r,e)=>{for(var t in e)ee(r,t,{get:e[t],enumerable:!0})},nt=(r,e,t,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of tt(e))!it.call(r,n)&&n!==t&&ee(r,n,{get:()=>e[n],enumerable:!(i=et(e,n))||i.enumerable});return r};var ot=r=>nt(ee({},"__esModule",{value:!0}),r);var Ht={};rt(Ht,{HyperframesPlayer:()=>K,SPEED_PRESETS:()=>re,formatSpeed:()=>O,formatTime:()=>q});function we(r){return r.hasRuntime||r.runtimeInjected?!1:!!(r.hasNestedCompositions||r.hasTimelines&&r.attempts>=5)}function P(r){return typeof r=="object"&&r!==null}function Ae(r){return P(r)&&typeof r.getDuration=="function"}function Ce(r){return P(r)&&typeof r.duration=="function"&&typeof r.time=="function"&&typeof r.seek=="function"&&typeof r.play=="function"&&typeof r.pause=="function"}var k="https://cdn.jsdelivr.net/npm/@hyperframes/core@0.8.46/dist/hyperframe.runtime.iife.js";function N(r){if(r===null)return null;let e=Number.parseInt(r,10);return Number.isFinite(e)&&e>0?e:null}function at(r){let e=r?.querySelector("[data-composition-id][data-width][data-height]")??r?.querySelector("[data-width][data-height]");if(!e)return null;let t=N(e.getAttribute("data-width")),i=N(e.getAttribute("data-height"));return t!==null&&i!==null?{width:t,height:i}:null}var W=class{constructor(e,t){this._iframe=e;this._callbacks=t}_iframe;_callbacks;_interval=null;_runtimeInjected=!1;get runtimeInjected(){return this._runtimeInjected}start(){this.stop(),this._runtimeInjected=!1;let e=0;this._interval=setInterval(()=>{e++;try{let t=this._iframe.contentWindow;if(!t)return;let i=!!(t.__hf||t.__player),n=!!(t.__timelines&&Object.keys(t.__timelines).length>0),o=!!this._iframe.contentDocument?.querySelector("[data-composition-src]");if(we({hasRuntime:i,hasTimelines:n,hasNestedCompositions:o,runtimeInjected:this._runtimeInjected,attempts:e})){this._injectRuntime();return}if(this._runtimeInjected&&!i)return;let d=this._resolvePlaybackDurationAdapter(t);if(d&&d.getDuration()>0){this.stop();let s=at(this._iframe.contentDocument);this._callbacks.onReady({duration:d.getDuration(),adapter:d,compositionSize:s});return}}catch{}e>=40&&(this.stop(),this._callbacks.onError("Composition timeline not found after 8s"))},200)}stop(){this._interval!==null&&(clearInterval(this._interval),this._interval=null)}resolveDirectTimelineAdapter(){try{let e=this._iframe.contentWindow;return e?this._resolveDirectTimelineAdapterFromWindow(e):null}catch{return null}}resolveDirectTimelineAdapterFromWindow(e){return this._resolveDirectTimelineAdapterFromWindow(e)}hasRuntimeBridge(e){return Reflect.get(e,"__hf")!==void 0||P(Reflect.get(e,"__player"))}_injectRuntime(){this._runtimeInjected=!0;try{let e=this._iframe.contentDocument;if(!e)return;let t=e.createElement("script");t.src=k,(e.head||e.documentElement).appendChild(t),this._callbacks.onRuntimeInjected?.()}catch{}}_resolveDirectTimelineAdapterFromWindow(e){if(this.hasRuntimeBridge(e))return null;let t=Reflect.get(e,"__timelines");if(!P(t))return null;let i=Object.keys(t);if(i.length===0)return null;let n=this._iframe.contentDocument?.querySelector("[data-composition-id]")?.getAttribute("data-composition-id"),o=n&&n in t?n:i[i.length-1],d=t[o];return Ce(d)?d:null}_resolvePlaybackDurationAdapter(e){let t=Reflect.get(e,"__player");if(Ae(t))return{kind:"runtime",getDuration:()=>t.getDuration()};let i=this._resolveDirectTimelineAdapterFromWindow(e);return i?{kind:"direct-timeline",timeline:i,getDuration:()=>i.duration()}:null}};var Re=`
   :host {
     display: block;
     position: relative;