hyperframes 0.8.113 → 0.8.114

package/dist/{skills-O25ZTFTO.js → skills-M6ETUUH5.js}

@@ -9,8 +9,8 @@ import {
 } from "./chunk-WMQNIQDJ.js";
 import {
   trackSkillsInstallSkipped
-} from "./chunk-7CGIICLA.js";
-import "./chunk-DDK22K3I.js";
+} from "./chunk-JH7ZJRDL.js";
+import "./chunk-IPXPSCWV.js";
 import {
   diag
 } from "./chunk-VWG7OQKU.js";
@@ -51,15 +51,15 @@ import {
   isCoreSkill,
   presentSkills,
   pruneOrphanedLockEntries
-} from "./chunk-FXHVADV6.js";
+} from "./chunk-6U3K3U62.js";
 import {
   withMeta
-} from "./chunk-U4VSY56O.js";
+} from "./chunk-SYQOD3W7.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-3XPZJUKM.js";
+import "./chunk-MLLBZR2U.js";
 import "./chunk-KNU5COPB.js";
 import {
   buildNpxCommand

package/dist/{skillsUpdateCheck-Y2V4OMMT.js → skillsUpdateCheck-UTX5LT5C.js}

@@ -9,13 +9,13 @@ import {
   printSkillsUpdateNotice,
   refreshSkillsCache,
   skillsCheckDue
-} from "./chunk-FXHVADV6.js";
-import "./chunk-U4VSY56O.js";
+} from "./chunk-6U3K3U62.js";
+import "./chunk-SYQOD3W7.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-3XPZJUKM.js";
+import "./chunk-MLLBZR2U.js";
 import "./chunk-KNU5COPB.js";
 import "./chunk-M2WBOQ2Q.js";
 export {

package/dist/{snapshot-KGM2HZIC.js → snapshot-HMDAENTY.js}

@@ -9,9 +9,9 @@ import {
 } from "./chunk-KZI44OPA.js";
 import {
   serveStaticProjectHtml
-} from "./chunk-OEA2J2TF.js";
+} from "./chunk-LDSWUYZB.js";
 import "./chunk-XUHOIDKG.js";
-import "./chunk-L5SYYW2P.js";
+import "./chunk-752X6G7T.js";
 import "./chunk-X7MTZ4T2.js";
 import {
   DEFAULT_ZOOM_SCALE,
@@ -26,14 +26,14 @@ import "./chunk-5Z63TBTX.js";
 import "./chunk-262C25DQ.js";
 import "./chunk-3IUSKIZW.js";
 import "./chunk-YEIFI443.js";
-import "./chunk-VTP4VSRP.js";
+import "./chunk-LYNBNESS.js";
 import "./chunk-XFJXFNJF.js";
 import "./chunk-WEATBQTR.js";
 import "./chunk-GDJ74GHW.js";
 import "./chunk-LMC46FK5.js";
 import {
   resolveProject
-} from "./chunk-IRJBTYJF.js";
+} from "./chunk-WAS5VEA4.js";
 import {
   formatLintFindings
 } from "./chunk-6CSYCFQV.js";
@@ -53,11 +53,12 @@ import "./chunk-AWDFDFI3.js";
 import "./chunk-GMECXFAN.js";
 import {
   findFFmpeg,
+  findFFprobe,
   getFFmpegInstallHint
 } from "./chunk-TVCRUG2S.js";
 import "./chunk-RDMAU7AJ.js";
-import "./chunk-7CGIICLA.js";
-import "./chunk-DDK22K3I.js";
+import "./chunk-JH7ZJRDL.js";
+import "./chunk-IPXPSCWV.js";
 import "./chunk-VWG7OQKU.js";
 import {
   c
@@ -92,7 +93,9 @@ import {
   definitiveEntryMismatchComposition,
   hasDefinitiveEntryMismatch
 } from "./chunk-Q5X2B5WT.js";
-import "./chunk-LCSMOLGX.js";
+import {
+  runCancellableProcess
+} from "./chunk-LCSMOLGX.js";
 import "./chunk-TWWSYAKJ.js";
 import {
   lintProject
@@ -106,7 +109,7 @@ import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-3XPZJUKM.js";
+import "./chunk-MLLBZR2U.js";
 import {
   normalizeErrorMessage
 } from "./chunk-KNU5COPB.js";
@@ -195,35 +198,121 @@ async function recaptureSnapshotComposite(page) {
     });
   }
 }
-async function extractVideoFrameToBuffer(videoPath, timeSeconds, useVp9AlphaDecoder = false, accurateSeek = false, holdLastFrame = false) {
+function containingSourceFrameIndex(timestamps, time) {
+  if (!Number.isFinite(time)) return -1;
+  const tolerance = 16 * Number.EPSILON * Math.max(1, Math.abs(time));
+  let index = -1;
+  for (const [i, timestamp] of timestamps.entries()) {
+    if (timestamp > time + tolerance) break;
+    index = i;
+  }
+  return index;
+}
+async function probeContainingSourceFrameSeek(videoPath, time, holdLastFrame) {
+  const ffprobe = findFFprobe();
+  if (!ffprobe) return { seek: time };
+  const probe = async (readIntervals, entries) => {
+    try {
+      const { stdout } = await runCancellableProcess(
+        ffprobe,
+        [
+          ...["-v", "error", "-select_streams", "v:0", "-read_intervals", readIntervals],
+          ...["-show_entries", entries, "-of", "json", "--", videoPath]
+        ],
+        { timeoutMs: FFMPEG_EXTRACT_TIMEOUT_MS, maxBufferBytes: 32 * 1024 * 1024 }
+      );
+      const parsed = JSON.parse(stdout);
+      return typeof parsed === "object" && parsed !== null ? parsed : null;
+    } catch {
+      return null;
+    }
+  };
+  const data = await probe("%+#1", "stream=time_base,start_pts:format=start_time,duration");
+  if (data === null || !Array.isArray(data.streams)) return null;
+  const stream = data.streams[0];
+  if (typeof stream !== "object" || stream === null || !("time_base" in stream) || typeof stream.time_base !== "string")
+    return null;
+  const [numerator, denominator] = stream.time_base.split("/");
+  const timeBase = Number(numerator) / Number(denominator);
+  if (!Number.isFinite(timeBase) || timeBase <= 0) return null;
+  const format = "format" in data ? data.format : null;
+  const start = typeof format === "object" && format !== null && "start_time" in format ? Number(format.start_time) : 0;
+  const duration = typeof format === "object" && format !== null && "duration" in format ? Number(format.duration) : NaN;
+  if (!holdLastFrame && Number.isFinite(duration) && time >= duration) return null;
+  const formatStart = Number.isFinite(start) ? start : 0;
+  const startPts = "start_pts" in stream && typeof stream.start_pts === "number" ? stream.start_pts : NaN;
+  const startTicks = Math.abs(startPts * timeBase - formatStart) <= 1e-6 ? startPts : formatStart / timeBase;
+  const packetData = await probe(`%${startTicks * timeBase + time + 1}`, "packet=pts,dts,flags");
+  if (packetData === null || !Array.isArray(packetData.packets)) return null;
+  const packets = [];
+  for (const packet of packetData.packets) {
+    if (typeof packet !== "object" || packet === null) return null;
+    const pts = "pts" in packet ? packet.pts : "dts" in packet ? packet.dts : void 0;
+    if (typeof pts !== "number") return null;
+    const dts = "dts" in packet && typeof packet.dts === "number" ? packet.dts : pts;
+    const key = "flags" in packet && typeof packet.flags === "string" && packet.flags.includes("K");
+    packets.push({ pts: (pts - startTicks) * timeBase, dts: (dts - startTicks) * timeBase, key });
+  }
+  const timestamps = packets.map((packet) => packet.pts).sort((a, b) => a - b);
+  const index = Math.max(0, containingSourceFrameIndex(timestamps, time));
+  if (timestamps.length === 0 || !Number.isFinite(time)) return null;
+  const frame = timestamps[index];
+  const previous = timestamps[index - 1] ?? frame - 1e-3;
+  const mid = (previous + frame) / 2;
+  const ffmpeg = findFFmpeg();
+  const landing = async (seek) => {
+    const raw = ffmpeg ? await probeSeekLanding(ffmpeg, videoPath, seek) : null;
+    return raw === null ? null : raw - startTicks * timeBase;
+  };
+  const candidates = packets.filter(
+    (packet) => packet.key && packet.pts > 0 && packet.pts <= frame
+  );
+  for (const candidate of candidates.reverse().slice(0, 3)) {
+    const landed = await landing(candidate.pts);
+    if (landed === null) break;
+    if (landed <= 0 || landed > frame) continue;
+    const again = Math.abs(landed - candidate.pts) < 1e-6 ? landed : await landing(landed);
+    if (again !== null && Math.abs(again - landed) < 1e-6)
+      return { seek: landed, select: mid - landed };
+  }
+  return { select: mid - (timestamps.find((t) => t >= 0) ?? frame) };
+}
+async function probeSeekLanding(ffmpeg, videoPath, seek) {
+  try {
+    const { stdout } = await runCancellableProcess(
+      ffmpeg,
+      [
+        ...["-v", "error", "-copyts", "-noaccurate_seek", "-ss", String(seek), "-i", videoPath],
+        ...["-map", "0:v:0", "-c", "copy", "-frames:v", "1", "-f", "framecrc", "-"]
+      ],
+      { timeoutMs: FFMPEG_EXTRACT_TIMEOUT_MS, maxBufferBytes: 1024 * 1024 }
+    );
+    const base = /^#tb 0: (\d+)\/(\d+)/m.exec(stdout);
+    const row = /^0,\s*-?\d+,\s*(-?\d+),/m.exec(stdout);
+    if (!base || !row) return null;
+    return Number(row[1]) * Number(base[1]) / Number(base[2]);
+  } catch {
+    return null;
+  }
+}
+async function extractVideoFrameToBuffer(videoPath, timeSeconds, useVp9AlphaDecoder = false, holdLastFrame = false) {
   const tmp = mkdtempSync(join(tmpdir(), "hf-snapshot-frame-"));
   const outPath = join(tmp, "frame.png");
   try {
     const ffmpegPath = requireSnapshotFfmpeg(findFFmpeg());
-    const args = ["-hide_banner", "-loglevel", "error"];
-    if (useVp9AlphaDecoder) {
-      args.push("-c:v", "libvpx-vp9");
-    }
-    const decoderArgs = [...args];
-    const seek = ["-ss", String(Math.max(0, timeSeconds))];
-    args.push(
-      ...accurateSeek ? ["-i", videoPath, ...seek] : [...seek, "-i", videoPath],
-      "-frames:v",
-      "1",
-      "-q:v",
-      "2",
-      "-y",
-      outPath
+    const seek = await probeContainingSourceFrameSeek(
+      videoPath,
+      Math.max(0, timeSeconds),
+      holdLastFrame
     );
-    let result = await runFfmpegOnce(ffmpegPath, args, FFMPEG_EXTRACT_TIMEOUT_MS);
-    if (holdLastFrame && result.code === 0 && !result.timedOut && !existsSync(outPath)) {
-      const tail = ["-sseof", "-1", "-i", videoPath, "-update", "1", "-q:v", "2", "-y", outPath];
-      result = await runFfmpegOnce(
-        ffmpegPath,
-        [...decoderArgs, ...tail],
-        FFMPEG_EXTRACT_TIMEOUT_MS
-      );
-    }
+    if (seek === null) return null;
+    const args = ["-hide_banner", "-loglevel", "error"];
+    if (useVp9AlphaDecoder) args.push("-c:v", "libvpx-vp9");
+    if (seek.seek !== void 0) args.push("-ss", String(seek.seek));
+    args.push("-i", videoPath, "-map", "0:v:0");
+    if (seek.select !== void 0) args.push("-vf", `select=gte(t-start_t\\,${seek.select})`);
+    args.push("-frames:v", "1", "-q:v", "2", "-y", outPath);
+    const result = await runFfmpegOnce(ffmpegPath, args, FFMPEG_EXTRACT_TIMEOUT_MS);
     if (result.code !== 0 || result.timedOut || !existsSync(outPath)) return null;
     return readFileSync(outPath);
   } finally {
@@ -443,7 +532,6 @@ async function captureSnapshots(projectDir, opts) {
               ffmpegInput,
               Math.max(0, v.relTime),
               useVp9AlphaDecoder,
-              false,
               v.srcDuration > 0 && v.relTime >= v.srcDuration - 1
             );
             if (!png) continue;
@@ -499,7 +587,7 @@ async function captureSnapshots(projectDir, opts) {
           await page.screenshot({ path: framePath, type: "png", omitBackground: true });
         }
         if (opts.against) {
-          const refPng = await extractVideoFrameToBuffer(opts.against, time, false, true);
+          const refPng = await extractVideoFrameToBuffer(opts.against, time);
           if (!refPng) {
             console.error(
               `   ${c.warn("\u26A0")} --against has no frame at ${timeLabel} \u2014 reference pair skipped`
@@ -771,6 +859,7 @@ ${c.error("\u2717")} Snapshot failed: ${msg}`);
 });
 export {
   computeSnapshotTimes,
+  containingSourceFrameIndex,
   snapshot_default as default,
   examples,
   extractVideoFrameToBuffer,

package/dist/{staticProjectServer-OCE7GU5S.js → staticProjectServer-XDH5SQV6.js}

@@ -6,11 +6,11 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   serveStaticProjectHtml
-} from "./chunk-OEA2J2TF.js";
+} from "./chunk-LDSWUYZB.js";
 import "./chunk-XUHOIDKG.js";
-import "./chunk-L5SYYW2P.js";
+import "./chunk-752X6G7T.js";
 import "./chunk-X7MTZ4T2.js";
-import "./chunk-VTP4VSRP.js";
+import "./chunk-LYNBNESS.js";
 import "./chunk-XFJXFNJF.js";
 import "./chunk-WEATBQTR.js";
 import "./chunk-GDJ74GHW.js";

package/dist/studio/assets/{hyperframes-player-DzJbtQVO.js → hyperframes-player-aXNJKiIg.js}

@@ -1,4 +1,4 @@
-var xe=Object.defineProperty;var ke=(r,i,e)=>i in r?xe(r,i,{enumerable:!0,configurable:!0,writable:!0,value:e}):r[i]=e;var h=(r,i,e)=>ke(r,typeof i!="symbol"?i+"":i,e);import{r as fe,i as Ie,a as w,b as _e,p as Oe,c as Ne,d as Fe,s as Ve,e as ge,F as ye}from"./index-DRhF3v4Z.js";function He(r){return r.hasRuntime||r.runtimeInjected?!1:!!(r.hasNestedCompositions||r.hasTimelines&&r.attempts>=5)}function z(r){return typeof r=="object"&&r!==null}function Ue(r){return z(r)&&typeof r.getDuration=="function"}function We(r){return z(r)&&typeof r.duration=="function"&&typeof r.time=="function"&&typeof r.seek=="function"&&typeof r.play=="function"&&typeof r.pause=="function"}function ze(r){if(!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(r))throw new Error(`Invalid HyperFrames runtime version: ${r}`);return`https://cdn.jsdelivr.net/npm/@hyperframes/core@${r}/dist/hyperframe.runtime.iife.js`}const U=typeof __HYPERFRAMES_RUNTIME_CDN_URL__=="string"?__HYPERFRAMES_RUNTIME_CDN_URL__:ze("0.0.0-dev");function $(r){if(r===null)return null;const i=Number.parseInt(r,10);return Number.isFinite(i)&&i>0?i:null}function $e(r){const i=(r==null?void 0:r.querySelector("[data-composition-id][data-width][data-height]"))??(r==null?void 0:r.querySelector("[data-width][data-height]"));if(!i)return null;const e=$(i.getAttribute("data-width")),t=$(i.getAttribute("data-height"));return e!==null&&t!==null?{width:e,height:t}:null}class je{constructor(i,e){h(this,"_interval",null);h(this,"_runtimeInjected",!1);this._iframe=i,this._callbacks=e}get runtimeInjected(){return this._runtimeInjected}start(){this.stop(),this._runtimeInjected=!1;let i=0;this._interval=setInterval(()=>{var e;i++;try{const t=this._iframe.contentWindow;if(!t)return;const s=!!(t.__hf||t.__player),n=!!(t.__timelines&&Object.keys(t.__timelines).length>0),o=!!((e=this._iframe.contentDocument)!=null&&e.querySelector("[data-composition-src]"));if(He({hasRuntime:s,hasTimelines:n,hasNestedCompositions:o,runtimeInjected:this._runtimeInjected,attempts:i})){this._injectRuntime();return}if(this._runtimeInjected&&!s)return;const a=this._resolvePlaybackDurationAdapter(t);if(a&&a.getDuration()>0){this.stop();const c=$e(this._iframe.contentDocument);this._callbacks.onReady({duration:a.getDuration(),adapter:a,compositionSize:c});return}}catch{}i>=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{const i=this._iframe.contentWindow;return i?this._resolveDirectTimelineAdapterFromWindow(i):null}catch{return null}}resolveDirectTimelineAdapterFromWindow(i){return this._resolveDirectTimelineAdapterFromWindow(i)}hasRuntimeBridge(i){return Reflect.get(i,"__hf")!==void 0||z(Reflect.get(i,"__player"))}_injectRuntime(){var i,e;this._runtimeInjected=!0;try{const t=this._iframe.contentDocument;if(!t)return;const s=t.createElement("script");s.src=U,(t.head||t.documentElement).appendChild(s),(e=(i=this._callbacks).onRuntimeInjected)==null||e.call(i)}catch{}}_resolveDirectTimelineAdapterFromWindow(i){var a,c;if(this.hasRuntimeBridge(i))return null;const e=Reflect.get(i,"__timelines");if(!z(e))return null;const t=Object.keys(e);if(t.length===0)return null;const s=(c=(a=this._iframe.contentDocument)==null?void 0:a.querySelector("[data-composition-id]"))==null?void 0:c.getAttribute("data-composition-id"),n=s&&s in e?s:t[t.length-1],o=e[n];return We(o)?o:null}_resolvePlaybackDurationAdapter(i){const e=Reflect.get(i,"__player");if(Ue(e))return{kind:"runtime",getDuration:()=>e.getDuration()};const t=this._resolveDirectTimelineAdapterFromWindow(i);return t?{kind:"direct-timeline",timeline:t,getDuration:()=>t.duration()}:null}}const Be=`
+var xe=Object.defineProperty;var ke=(r,i,e)=>i in r?xe(r,i,{enumerable:!0,configurable:!0,writable:!0,value:e}):r[i]=e;var h=(r,i,e)=>ke(r,typeof i!="symbol"?i+"":i,e);import{r as fe,i as Ie,a as w,b as _e,p as Oe,c as Ne,d as Fe,s as Ve,e as ge,F as ye}from"./index-Dz7doz9l.js";function He(r){return r.hasRuntime||r.runtimeInjected?!1:!!(r.hasNestedCompositions||r.hasTimelines&&r.attempts>=5)}function z(r){return typeof r=="object"&&r!==null}function Ue(r){return z(r)&&typeof r.getDuration=="function"}function We(r){return z(r)&&typeof r.duration=="function"&&typeof r.time=="function"&&typeof r.seek=="function"&&typeof r.play=="function"&&typeof r.pause=="function"}function ze(r){if(!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(r))throw new Error(`Invalid HyperFrames runtime version: ${r}`);return`https://cdn.jsdelivr.net/npm/@hyperframes/core@${r}/dist/hyperframe.runtime.iife.js`}const U=typeof __HYPERFRAMES_RUNTIME_CDN_URL__=="string"?__HYPERFRAMES_RUNTIME_CDN_URL__:ze("0.0.0-dev");function $(r){if(r===null)return null;const i=Number.parseInt(r,10);return Number.isFinite(i)&&i>0?i:null}function $e(r){const i=(r==null?void 0:r.querySelector("[data-composition-id][data-width][data-height]"))??(r==null?void 0:r.querySelector("[data-width][data-height]"));if(!i)return null;const e=$(i.getAttribute("data-width")),t=$(i.getAttribute("data-height"));return e!==null&&t!==null?{width:e,height:t}:null}class je{constructor(i,e){h(this,"_interval",null);h(this,"_runtimeInjected",!1);this._iframe=i,this._callbacks=e}get runtimeInjected(){return this._runtimeInjected}start(){this.stop(),this._runtimeInjected=!1;let i=0;this._interval=setInterval(()=>{var e;i++;try{const t=this._iframe.contentWindow;if(!t)return;const s=!!(t.__hf||t.__player),n=!!(t.__timelines&&Object.keys(t.__timelines).length>0),o=!!((e=this._iframe.contentDocument)!=null&&e.querySelector("[data-composition-src]"));if(He({hasRuntime:s,hasTimelines:n,hasNestedCompositions:o,runtimeInjected:this._runtimeInjected,attempts:i})){this._injectRuntime();return}if(this._runtimeInjected&&!s)return;const a=this._resolvePlaybackDurationAdapter(t);if(a&&a.getDuration()>0){this.stop();const c=$e(this._iframe.contentDocument);this._callbacks.onReady({duration:a.getDuration(),adapter:a,compositionSize:c});return}}catch{}i>=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{const i=this._iframe.contentWindow;return i?this._resolveDirectTimelineAdapterFromWindow(i):null}catch{return null}}resolveDirectTimelineAdapterFromWindow(i){return this._resolveDirectTimelineAdapterFromWindow(i)}hasRuntimeBridge(i){return Reflect.get(i,"__hf")!==void 0||z(Reflect.get(i,"__player"))}_injectRuntime(){var i,e;this._runtimeInjected=!0;try{const t=this._iframe.contentDocument;if(!t)return;const s=t.createElement("script");s.src=U,(t.head||t.documentElement).appendChild(s),(e=(i=this._callbacks).onRuntimeInjected)==null||e.call(i)}catch{}}_resolveDirectTimelineAdapterFromWindow(i){var a,c;if(this.hasRuntimeBridge(i))return null;const e=Reflect.get(i,"__timelines");if(!z(e))return null;const t=Object.keys(e);if(t.length===0)return null;const s=(c=(a=this._iframe.contentDocument)==null?void 0:a.querySelector("[data-composition-id]"))==null?void 0:c.getAttribute("data-composition-id"),n=s&&s in e?s:t[t.length-1],o=e[n];return We(o)?o:null}_resolvePlaybackDurationAdapter(i){const e=Reflect.get(i,"__player");if(Ue(e))return{kind:"runtime",getDuration:()=>e.getDuration()};const t=this._resolveDirectTimelineAdapterFromWindow(i);return t?{kind:"direct-timeline",timeline:t,getDuration:()=>t.duration()}:null}}const Be=`
   :host {
     display: block;
     position: relative;