hyperframes 0.8.61 → 0.8.63

package/dist/fontLocalizeCli.js

@@ -55119,17 +55119,22 @@ var BrowserLeasePool;
 var init_browserLeasePool = __esm({
   "../engine/src/services/browserLeasePool.ts"() {
     "use strict";
-    BrowserLeasePool = class {
+    BrowserLeasePool = class _BrowserLeasePool {
       constructor(options) {
         this.options = options;
       }
       options;
+      /** Under the CLI's 3s exit watchdog, alongside the render-wait bound it races. */
+      static DRAIN_FORCE_CLOSE_MS = 1e3;
       available = /* @__PURE__ */ new Map();
       entries = /* @__PURE__ */ new Set();
       leasesByBrowser = /* @__PURE__ */ new Map();
       drainPromise = null;
+      closed = false;
       async acquire(fingerprintInput, pooled) {
+        if (this.closed) throw new Error("Browser pool is closed; no new browsers can be acquired");
         if (this.drainPromise) await this.drainPromise;
+        if (this.closed) throw new Error("Browser pool is closed; no new browsers can be acquired");
         const fingerprint = freezeFingerprint(fingerprintInput);
         const entry = this.reserveEntry(fingerprint, pooled);
         return this.issueLease(entry);
@@ -55188,17 +55193,30 @@ var init_browserLeasePool = __esm({
         if (this.drainPromise) return this.drainPromise;
         const entries2 = [...this.entries];
         for (const entry of entries2) this.requestClose(entry, false);
-        this.drainPromise = Promise.all(entries2.map((entry) => entry.closePromise)).then(() => {
+        const settle = Promise.all(entries2.map((entry) => entry.closePromise));
+        const bound = new Promise(
+          (resolve18) => setTimeout(resolve18, _BrowserLeasePool.DRAIN_FORCE_CLOSE_MS).unref()
+        );
+        this.drainPromise = Promise.race([settle, bound]).then(() => {
+          for (const entry of entries2) if (this.entries.has(entry)) this.requestClose(entry, true);
+          return settle;
+        }).then(() => {
           this.drainPromise = null;
         });
         return this.drainPromise;
       }
+      /** Terminal: drains every entry and refuses every `acquire()` after. */
+      close() {
+        this.closed = true;
+        return this.drain();
+      }
       /** Test-only state reset. Call `drain()` first when entries own real browsers. */
       reset() {
         this.available.clear();
         this.entries.clear();
         this.leasesByBrowser.clear();
         this.drainPromise = null;
+        this.closed = false;
       }
       createEntry(key2, fingerprint, pooled) {
         const entry = {
@@ -55732,6 +55750,9 @@ function forceReleaseBrowser(browser) {
 async function drainBrowserPool() {
   await browserLeasePool.drain();
 }
+async function closeBrowserPool() {
+  await browserLeasePool.close();
+}
 function probeNvidiaVramMb() {
   if (_cachedVramMb !== null) return _cachedVramMb;
   try {
@@ -62755,11 +62776,19 @@ async function extractMediaMetadata(filePath) {
   });
   return probePromise;
 }
+function resolveStreamWindow(filePath, metadata) {
+  const videoStreamDurationSeconds = metadata.videoStreamDurationSeconds;
+  const candidateStart = metadata.videoStreamStartSeconds ?? 0;
+  const videoStreamStartSeconds = Number.isFinite(candidateStart) ? candidateStart : 0;
+  const cacheKey = `${filePath}\0${String(videoStreamStartSeconds)}\0${String(videoStreamDurationSeconds)}`;
+  return { videoStreamStartSeconds, videoStreamDurationSeconds, cacheKey };
+}
 async function extractFinalVideoFrameTimestamp(filePath, metadata, signal) {
-  const videoDurationSeconds = metadata.videoStreamDurationSeconds;
-  const candidateStreamStart = metadata.videoStreamStartSeconds ?? 0;
-  const videoStreamStartSeconds = Number.isFinite(candidateStreamStart) ? candidateStreamStart : 0;
-  const cacheKey = `${filePath}\0${String(videoStreamStartSeconds)}\0${String(videoDurationSeconds)}`;
+  const {
+    videoStreamStartSeconds,
+    videoStreamDurationSeconds: videoDurationSeconds,
+    cacheKey
+  } = resolveStreamWindow(filePath, metadata);
   let probeCache = finalVideoFrameTimestampCache;
   if (signal) {
     probeCache = finalVideoFrameTimestampSignalCaches.get(signal) ?? /* @__PURE__ */ new Map();
@@ -62862,19 +62891,27 @@ async function extractAudioMetadata(filePath, options) {
   });
   return probePromise;
 }
-async function analyzeKeyframeIntervals(filePath) {
-  const cached2 = keyframeCache.get(filePath);
+async function analyzeKeyframeIntervals(filePath, metadata) {
+  const { videoStreamStartSeconds, videoStreamDurationSeconds, cacheKey } = resolveStreamWindow(
+    filePath,
+    metadata
+  );
+  const cached2 = keyframeCache.get(cacheKey);
   if (cached2) return cached2;
-  const promise = analyzeKeyframeIntervalsUncached(filePath);
-  keyframeCache.set(filePath, promise);
+  const promise = analyzeKeyframeIntervalsUncached(
+    filePath,
+    videoStreamStartSeconds,
+    videoStreamDurationSeconds
+  );
+  keyframeCache.set(cacheKey, promise);
   promise.catch(() => {
-    if (keyframeCache.get(filePath) === promise) {
-      keyframeCache.delete(filePath);
+    if (keyframeCache.get(cacheKey) === promise) {
+      keyframeCache.delete(cacheKey);
     }
   });
   return promise;
 }
-async function analyzeKeyframeIntervalsUncached(filePath) {
+async function analyzeKeyframeIntervalsUncached(filePath, videoStreamStartSeconds, videoStreamDurationSeconds) {
   const stdout = await runFfprobe(filePath, [
     "-select_streams",
     "v:0",
@@ -62886,14 +62923,26 @@ async function analyzeKeyframeIntervalsUncached(filePath) {
     "csv=p=0"
   ]);
   const timestamps = stdout.split("\n").map((line) => parseFloat(line.trim())).filter((t) => Number.isFinite(t));
-  if (timestamps.length < 2) {
+  if (timestamps.length === 0) {
     return {
       avgIntervalSeconds: 0,
       maxIntervalSeconds: 0,
-      keyframeCount: timestamps.length,
+      keyframeCount: 0,
       isProblematic: false
     };
   }
+  if (timestamps.length === 1) {
+    const streamEnd = videoStreamStartSeconds + videoStreamDurationSeconds;
+    const rawInterval = streamEnd - (timestamps[0] ?? videoStreamStartSeconds);
+    const singleGopInterval = Number.isFinite(rawInterval) ? Math.max(rawInterval, 0) : 0;
+    const roundedInterval = Math.round(singleGopInterval * 100) / 100;
+    return {
+      avgIntervalSeconds: roundedInterval,
+      maxIntervalSeconds: roundedInterval,
+      keyframeCount: 1,
+      isProblematic: singleGopInterval > PROBLEMATIC_KEYFRAME_INTERVAL_SECONDS
+    };
+  }
   let maxInterval = 0;
   let totalInterval = 0;
   for (let i = 1; i < timestamps.length; i++) {
@@ -62906,10 +62955,10 @@ async function analyzeKeyframeIntervalsUncached(filePath) {
     avgIntervalSeconds: Math.round(avgInterval * 100) / 100,
     maxIntervalSeconds: Math.round(maxInterval * 100) / 100,
     keyframeCount: timestamps.length,
-    isProblematic: maxInterval > 2
+    isProblematic: maxInterval > PROBLEMATIC_KEYFRAME_INTERVAL_SECONDS
   };
 }
-var FFPROBE_STDERR_MAX_BYTES, FFPROBE_STDOUT_MAX_CHARS, FFPROBE_ERROR_MAX_CHARS, videoMetadataCache, finalVideoFrameTimestampCache, finalVideoFrameTimestampSignalCaches, audioMetadataCache, mediaProbeOutputCache, mediaProbeOutputSignalCaches, MEDIA_PROBE_OUTPUT_CACHE_MAX_ENTRIES, AAC_LC_SAMPLES_PER_PACKET, STILL_IMAGE_DEMUXERS, StructurallyIncompletePngError, extractVideoMetadata, keyframeCache;
+var FFPROBE_STDERR_MAX_BYTES, FFPROBE_STDOUT_MAX_CHARS, FFPROBE_ERROR_MAX_CHARS, videoMetadataCache, finalVideoFrameTimestampCache, finalVideoFrameTimestampSignalCaches, audioMetadataCache, mediaProbeOutputCache, mediaProbeOutputSignalCaches, MEDIA_PROBE_OUTPUT_CACHE_MAX_ENTRIES, AAC_LC_SAMPLES_PER_PACKET, STILL_IMAGE_DEMUXERS, StructurallyIncompletePngError, extractVideoMetadata, keyframeCache, PROBLEMATIC_KEYFRAME_INTERVAL_SECONDS;
 var init_ffprobe = __esm({
   "../engine/src/utils/ffprobe.ts"() {
     "use strict";
@@ -62952,6 +63001,7 @@ var init_ffprobe = __esm({
     };
     extractVideoMetadata = extractMediaMetadata;
     keyframeCache = /* @__PURE__ */ new Map();
+    PROBLEMATIC_KEYFRAME_INTERVAL_SECONDS = 2;
   }
 });
 
@@ -64117,6 +64167,11 @@ function isUnresolvedAssetPlaceholder(rawSrc) {
 function cleanAssetUrl(url) {
   return url.trim().split(/[?#]/, 1)[0] ?? "";
 }
+function isWithinProjectRoot(projectDir, candidate, pathModule = { resolve: resolve5, relative, isAbsolute }) {
+  const projectRoot = pathModule.resolve(projectDir);
+  const relativePath = pathModule.relative(projectRoot, candidate);
+  return relativePath === "" || !relativePath.startsWith("..") && !pathModule.isAbsolute(relativePath);
+}
 function reanchoredCandidates(variant, baseDir, compiledDir) {
   const baseAbs = resolve5(baseDir);
   const joinedAbs = resolve5(join8(baseDir, variant));
@@ -82481,6 +82536,14 @@ function readRegularFile(filePath) {
     closeSync4(fd);
   }
 }
+function resolveContainedPaths(projectDir, compiledDir, relativePath) {
+  const projectPath = join18(projectDir, relativePath);
+  if (!isWithinProjectRoot(projectDir, projectPath)) return null;
+  if (!compiledDir) return { projectPath, compiledPath: null };
+  const compiledPath = join18(compiledDir, relativePath);
+  if (!isWithinProjectRoot(compiledDir, compiledPath)) return null;
+  return { projectPath, compiledPath };
+}
 function createFileServer(options) {
   const { projectDir, compiledDir, port = 0, stripEmbeddedRuntime = true } = options;
   const headScripts = options.headScripts ?? [];
@@ -82490,8 +82553,9 @@ function createFileServer(options) {
     let requestPath = c.req.path;
     if (requestPath === "/") requestPath = "/index.html";
     const relativePath = requestPath.replace(/^\//, "");
-    const compiledPath = compiledDir ? join18(compiledDir, relativePath) : null;
-    const content = (compiledPath ? readRegularFile(compiledPath) : null) ?? readRegularFile(join18(projectDir, relativePath));
+    const resolved = resolveContainedPaths(projectDir, compiledDir, relativePath);
+    if (!resolved) return c.text("Not found", 404);
+    const content = (resolved.compiledPath ? readRegularFile(resolved.compiledPath) : null) ?? readRegularFile(resolved.projectPath);
     if (content === null) return c.text("Not found", 404);
     const ext = extname3(relativePath).toLowerCase();
     const contentType = MIME_TYPES[ext] || "application/octet-stream";
@@ -82522,6 +82586,7 @@ var init_fileServer = __esm({
   "../engine/src/services/fileServer.ts"() {
     "use strict";
     init_compiler();
+    init_assetResolution();
     MIME_TYPES = {
       ".html": "text/html; charset=utf-8",
       ".css": "text/css; charset=utf-8",
@@ -83675,6 +83740,7 @@ __export(src_exports, {
   classifyVideoExtractionError: () => classifyVideoExtractionError,
   cloneCaptureWarning: () => cloneCaptureWarning,
   cloneCaptureWarnings: () => cloneCaptureWarnings,
+  closeBrowserPool: () => closeBrowserPool,
   closeCaptureSession: () => closeCaptureSession,
   completeDeferredDrawElementInit: () => completeDeferredDrawElementInit,
   compositionRequiresWebGpu: () => compositionRequiresWebGpu,
@@ -91976,12 +92042,14 @@ init_dist2();
 init_mediaTiming();
 init_src();
 var COMPOSITION_HOST_ATTR = "data-composition-file";
-var ROOT_WINDOW = { offset: 0, limit: Infinity, basis: "local" };
-function parseNumeric3(value) {
-  if (value == null || value === "") return null;
-  const parsed = Number.parseFloat(value);
-  return Number.isFinite(parsed) ? parsed : null;
+function resolveHostEnd(host, hostStart) {
+  return resolveAuthoredTimingWindow({
+    start: hostStart,
+    duration: host.getAttribute("data-duration"),
+    end: host.getAttribute("data-end")
+  })?.end ?? null;
 }
+var ROOT_WINDOW = { offset: 0, limit: Infinity, basis: "local" };
 function resolveHostWindow(element, document2, startCache, visiting) {
   const hosts = [];
   for (let ancestor2 = element.parentElement; ancestor2; ancestor2 = ancestor2.parentElement) {
@@ -91992,7 +92060,7 @@ function resolveHostWindow(element, document2, startCache, visiting) {
   let limit = Infinity;
   for (const host of hosts.reverse()) {
     const hostStart = resolveReferencedStart(document2, host, startCache, visiting);
-    const hostEnd = parseNumeric3(host.getAttribute("data-end"));
+    const hostEnd = resolveHostEnd(host, hostStart);
     if (hostEnd != null) limit = Math.min(limit, offset2 + hostEnd);
     offset2 += hostStart;
   }
@@ -95262,10 +95330,11 @@ async function compileForRender(projectDir, htmlPath, downloadDir, options = {})
     if (isHttpUrl(video.src)) continue;
     const videoPath = resolve12(projectDir, video.src);
     const reencode = `ffmpeg -i "${video.src}" -c:v libx264 -r 30 -g 30 -keyint_min 30 -movflags +faststart -c:a copy output.mp4`;
-    Promise.all([
-      withMediaProbeSlot(() => analyzeKeyframeIntervals(videoPath)),
-      withMediaProbeSlot(() => extractMediaMetadata(videoPath))
-    ]).then(([analysis, metadata]) => {
+    (async () => {
+      const metadata = await withMediaProbeSlot(() => extractMediaMetadata(videoPath));
+      const analysis = await withMediaProbeSlot(
+        () => analyzeKeyframeIntervals(videoPath, metadata)
+      );
       if (analysis.isProblematic) {
         defaultLogger.warn(
           `[Compiler] WARNING: Video "${video.id}" has sparse keyframes (max interval: ${analysis.maxIntervalSeconds}s). This causes seek failures and frame freezing. Re-encode with: ${reencode}`
@@ -95276,7 +95345,7 @@ async function compileForRender(projectDir, htmlPath, downloadDir, options = {})
           `[Compiler] Video "${video.id}" is variable frame rate (VFR); the engine will normalize it to CFR before frame extraction. If rendering feels slow on this video, pre-encode once with: ${reencode}`
         );
       }
-    }).catch(() => {
+    })().catch(() => {
     });
   }
   const { document: document2 } = parseHTML(html);
@@ -102748,8 +102817,8 @@ async function runFontLocalize(io, localize) {
 }
 
 // src/version.ts
-var VERSION = true ? "0.8.61" : "0.0.0-dev";
-var PRODUCER_VERSION = true ? "0.8.61" : "0.0.0-dev";
+var VERSION = true ? "0.8.63" : "0.0.0-dev";
+var PRODUCER_VERSION = true ? "0.8.63" : "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 pn=Object.getOwnPropertyDescriptor;var fn=Object.getOwnPropertyNames;var hn=Object.prototype.hasOwnProperty;var bn=(n,e)=>{for(var t in e)Ee(n,t,{get:e[t],enumerable:!0})},gn=(n,e,t,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of fn(e))!hn.call(n,r)&&r!==t&&Ee(n,r,{get:()=>e[r],enumerable:!(i=pn(e,r))||i.enumerable});return n};var _n=n=>gn(Ee({},"__esModule",{value:!0}),n);var Yi={};bn(Yi,{HyperframesPlayer:()=>Ae,SPEED_PRESETS:()=>xe,formatSpeed:()=>G,formatTime:()=>ie});function dt(n){return n.hasRuntime||n.runtimeInjected?!1:!!(n.hasNestedCompositions||n.hasTimelines&&n.attempts>=5)}function H(n){return typeof n=="object"&&n!==null}function ct(n){return H(n)&&typeof n.getDuration=="function"}function mt(n){return H(n)&&typeof n.duration=="function"&&typeof n.time=="function"&&typeof n.seek=="function"&&typeof n.play=="function"&&typeof n.pause=="function"}var L="https://cdn.jsdelivr.net/npm/@hyperframes/core@0.8.61/dist/hyperframe.runtime.iife.js";function V(n){if(n===null)return null;let e=Number.parseInt(n,10);return Number.isFinite(e)&&e>0?e:null}function yn(n){let e=n?.querySelector("[data-composition-id][data-width][data-height]")??n?.querySelector("[data-width][data-height]");if(!e)return null;let t=V(e.getAttribute("data-width")),i=V(e.getAttribute("data-height"));return t!==null&&i!==null?{width:t,height:i}:null}var ne=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),r=!!(t.__timelines&&Object.keys(t.__timelines).length>0),o=!!this._iframe.contentDocument?.querySelector("[data-composition-src]");if(dt({hasRuntime:i,hasTimelines:r,hasNestedCompositions:o,runtimeInjected:this._runtimeInjected,attempts:e})){this._injectRuntime();return}if(this._runtimeInjected&&!i)return;let a=this._resolvePlaybackDurationAdapter(t);if(a&&a.getDuration()>0){this.stop();let s=yn(this._iframe.contentDocument);this._callbacks.onReady({duration:a.getDuration(),adapter:a,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||H(Reflect.get(e,"__player"))}_injectRuntime(){this._runtimeInjected=!0;try{let e=this._iframe.contentDocument;if(!e)return;let t=e.createElement("script");t.src=L,(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(!H(t))return null;let i=Object.keys(t);if(i.length===0)return null;let r=this._iframe.contentDocument?.querySelector("[data-composition-id]")?.getAttribute("data-composition-id"),o=r&&r in t?r:i[i.length-1],a=t[o];return mt(a)?a:null}_resolvePlaybackDurationAdapter(e){let t=Reflect.get(e,"__player");if(ct(t))return{kind:"runtime",getDuration:()=>t.getDuration()};let i=this._resolveDirectTimelineAdapterFromWindow(e);return i?{kind:"direct-timeline",timeline:i,getDuration:()=>i.duration()}:null}};var pt=`
+"use strict";var HyperframesPlayer=(()=>{var Ee=Object.defineProperty;var pn=Object.getOwnPropertyDescriptor;var fn=Object.getOwnPropertyNames;var hn=Object.prototype.hasOwnProperty;var bn=(n,e)=>{for(var t in e)Ee(n,t,{get:e[t],enumerable:!0})},gn=(n,e,t,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of fn(e))!hn.call(n,r)&&r!==t&&Ee(n,r,{get:()=>e[r],enumerable:!(i=pn(e,r))||i.enumerable});return n};var _n=n=>gn(Ee({},"__esModule",{value:!0}),n);var Yi={};bn(Yi,{HyperframesPlayer:()=>Ae,SPEED_PRESETS:()=>xe,formatSpeed:()=>G,formatTime:()=>ie});function dt(n){return n.hasRuntime||n.runtimeInjected?!1:!!(n.hasNestedCompositions||n.hasTimelines&&n.attempts>=5)}function H(n){return typeof n=="object"&&n!==null}function ct(n){return H(n)&&typeof n.getDuration=="function"}function mt(n){return H(n)&&typeof n.duration=="function"&&typeof n.time=="function"&&typeof n.seek=="function"&&typeof n.play=="function"&&typeof n.pause=="function"}var L="https://cdn.jsdelivr.net/npm/@hyperframes/core@0.8.63/dist/hyperframe.runtime.iife.js";function V(n){if(n===null)return null;let e=Number.parseInt(n,10);return Number.isFinite(e)&&e>0?e:null}function yn(n){let e=n?.querySelector("[data-composition-id][data-width][data-height]")??n?.querySelector("[data-width][data-height]");if(!e)return null;let t=V(e.getAttribute("data-width")),i=V(e.getAttribute("data-height"));return t!==null&&i!==null?{width:t,height:i}:null}var ne=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),r=!!(t.__timelines&&Object.keys(t.__timelines).length>0),o=!!this._iframe.contentDocument?.querySelector("[data-composition-src]");if(dt({hasRuntime:i,hasTimelines:r,hasNestedCompositions:o,runtimeInjected:this._runtimeInjected,attempts:e})){this._injectRuntime();return}if(this._runtimeInjected&&!i)return;let a=this._resolvePlaybackDurationAdapter(t);if(a&&a.getDuration()>0){this.stop();let s=yn(this._iframe.contentDocument);this._callbacks.onReady({duration:a.getDuration(),adapter:a,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||H(Reflect.get(e,"__player"))}_injectRuntime(){this._runtimeInjected=!0;try{let e=this._iframe.contentDocument;if(!e)return;let t=e.createElement("script");t.src=L,(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(!H(t))return null;let i=Object.keys(t);if(i.length===0)return null;let r=this._iframe.contentDocument?.querySelector("[data-composition-id]")?.getAttribute("data-composition-id"),o=r&&r in t?r:i[i.length-1],a=t[o];return mt(a)?a:null}_resolvePlaybackDurationAdapter(e){let t=Reflect.get(e,"__player");if(ct(t))return{kind:"runtime",getDuration:()=>t.getDuration()};let i=this._resolveDirectTimelineAdapterFromWindow(e);return i?{kind:"direct-timeline",timeline:i,getDuration:()=>i.duration()}:null}};var pt=`
   :host {
     display: block;
     position: relative;

package/dist/renderSetupWorker.js

@@ -56408,10 +56408,10 @@ function collectSubCompositionSrcs(html) {
 function cleanAssetUrl(url) {
   return url.trim().split(/[?#]/, 1)[0] ?? "";
 }
-function isWithinProjectRoot(projectDir, candidate) {
-  const projectRoot = resolve(projectDir);
-  const relativePath = relative(projectRoot, candidate);
-  return relativePath === "" || !relativePath.startsWith("..") && !isAbsolute(relativePath);
+function isWithinProjectRoot(projectDir, candidate, pathModule = { resolve, relative, isAbsolute }) {
+  const projectRoot = pathModule.resolve(projectDir);
+  const relativePath = pathModule.relative(projectRoot, candidate);
+  return relativePath === "" || !relativePath.startsWith("..") && !pathModule.isAbsolute(relativePath);
 }
 function addCandidate(candidates, candidate) {
   if (!candidates.includes(candidate)) candidates.push(candidate);

package/dist/skills/media-use/scripts/lib/transcriptCutFade.mjs

@@ -0,0 +1,21 @@
+function round3(n) {
+  return Math.round(Number(n) * 1000) / 1000;
+}
+
+// 30ms in/out ramps kill the click at every concat boundary. A segment shorter
+// than 4x the ramp would spend its whole length fading, so scale down there and
+// skip entirely on a degenerate one. fadeIn/fadeOut are false at the export's
+// own true start/end, where there is no splice to smooth.
+export function fadeFilterFor(durationSeconds, { fadeIn, fadeOut }) {
+  if (!fadeIn && !fadeOut) return null;
+  const FADE_SECONDS = 0.03;
+  if (!Number.isFinite(durationSeconds) || durationSeconds <= 0.01) return null;
+  const d = Math.min(FADE_SECONDS, durationSeconds / 4);
+  const parts = [];
+  if (fadeIn) parts.push(`afade=t=in:st=0:d=${round3(d)}`);
+  if (fadeOut) {
+    const out = round3(durationSeconds - d);
+    if (out > 0) parts.push(`afade=t=out:st=${out}:d=${round3(d)}`);
+  }
+  return parts.length ? parts.join(",") : null;
+}

package/dist/skills/media-use/scripts/lib/transcriptCutFade.test.mjs

@@ -0,0 +1,33 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { fadeFilterFor } from "./transcriptCutFade.mjs";
+
+test("fades in only at the first segment's trailing splice", () => {
+  assert.equal(fadeFilterFor(2, { fadeIn: false, fadeOut: true }), "afade=t=out:st=1.97:d=0.03");
+});
+
+test("fades both edges of a middle segment's two splices", () => {
+  assert.equal(
+    fadeFilterFor(2, { fadeIn: true, fadeOut: true }),
+    "afade=t=in:st=0:d=0.03,afade=t=out:st=1.97:d=0.03",
+  );
+});
+
+test("fades out only at the last segment's leading splice", () => {
+  assert.equal(fadeFilterFor(2, { fadeIn: true, fadeOut: false }), "afade=t=in:st=0:d=0.03");
+});
+
+test("a single kept segment borders no splice at all", () => {
+  assert.equal(fadeFilterFor(2, { fadeIn: false, fadeOut: false }), null);
+});
+
+test("still scales the ramp down on a short segment with both edges faded", () => {
+  assert.equal(
+    fadeFilterFor(0.08, { fadeIn: true, fadeOut: true }),
+    "afade=t=in:st=0:d=0.02,afade=t=out:st=0.06:d=0.02",
+  );
+});
+
+test("skips a degenerate segment even when a splice is requested", () => {
+  assert.equal(fadeFilterFor(0.005, { fadeIn: true, fadeOut: true }), null);
+});

package/dist/skills/media-use/scripts/transcript-cut.mjs

@@ -6,6 +6,7 @@ import { tmpdir } from "node:os";
 import { dirname, extname, join, resolve } from "node:path";
 import { parseArgs } from "node:util";
 import { compileCutList } from "./lib/cutlist.mjs";
+import { fadeFilterFor } from "./lib/transcriptCutFade.mjs";
 import { track } from "./lib/telemetry.mjs";
 
 const { values: args } = parseArgs({
@@ -92,11 +93,23 @@ function run() {
 
   try {
     const parts = segments.map((segment, index) => {
-      const out = join(
-        tmpDir,
-        `segment-${String(index).padStart(4, "0")}${extname(outPath) || ".mp4"}`,
-      );
-      cutSegment(inputPath, segment, out, Boolean(args.copy));
+      // Intermediates carry PCM audio, not the final codec. Encoding each
+      // segment to a lossy codec separately makes the encoder pad every segment
+      // with priming silence (~25-35ms for AAC), which concat then bakes in as a
+      // gap at each cut -- a defect distinct from, and surviving, the fades
+      // below. PCM has no priming, so audio is encoded exactly once, at concat.
+      const ext = args.copy ? extname(outPath) || ".mp4" : isAudioOnly(outPath) ? ".wav" : ".mkv";
+      const out = join(tmpDir, `segment-${String(index).padStart(4, "0")}${ext}`);
+      // --copy stays fade-free (stream copy cannot filter). A segment's true
+      // start/end (index 0's start, the last segment's end) borders nothing
+      // kept, so only an interior splice edge gets a ramp.
+      const fade = args.copy
+        ? null
+        : fadeFilterFor(segment.end - segment.start, {
+            fadeIn: index > 0,
+            fadeOut: index < segments.length - 1,
+          });
+      cutSegment(inputPath, segment, out, args.copy, fade);
       return out;
     });
     const listPath = join(tmpDir, "list.txt");
@@ -107,9 +120,16 @@ function run() {
     // Encode to a sibling temp (same extension so ffmpeg picks the right muxer),
     // then atomic-rename so a SIGKILL mid-encode can't leave a truncated outPath.
     const tmpOut = `${outPath}.part${extname(outPath) || ".mp4"}`;
+    // --copy already produced final-codec segments, so concat can stream-copy.
+    // Otherwise the PCM intermediates are encoded here, once, for the whole file.
+    const concatCodecs = args.copy
+      ? ["-c", "copy"]
+      : isAudioOnly(outPath)
+        ? encodeArgsFor(extname(outPath).toLowerCase())
+        : ["-c:v", "copy", "-c:a", "aac", "-b:a", "192k", "-movflags", "+faststart"];
     execFileSync(
       "ffmpeg",
-      ["-y", "-f", "concat", "-safe", "0", "-i", listPath, "-c", "copy", tmpOut],
+      ["-y", "-f", "concat", "-safe", "0", "-i", listPath, ...concatCodecs, tmpOut],
       {
         stdio: "ignore",
       },
@@ -158,7 +178,7 @@ function run() {
   console.log(`next: resolve --from ${outPath} --type <type>`);
 }
 
-function cutSegment(inputPath, segment, outPath, copy) {
+function cutSegment(inputPath, segment, outPath, copy, fade) {
   const argv = [
     "-y",
     "-nostdin",
@@ -171,8 +191,15 @@ function cutSegment(inputPath, segment, outPath, copy) {
   ];
   if (copy) {
     argv.push("-c", "copy", "-avoid_negative_ts", "make_zero");
+  } else if (extname(outPath).toLowerCase() === ".mkv") {
+    // Concat splices raw segment edges together; without a short ramp the
+    // waveform steps discontinuously at every boundary and you hear a click.
+    if (fade) argv.push("-af", fade);
+    // Video intermediate: keep the picture cheap and the audio uncompressed.
+    argv.push("-c:v", "libx264", "-preset", "veryfast", "-crf", "18", "-c:a", "pcm_s16le");
   } else {
-    argv.push(...encodeArgsFor(extname(outPath).toLowerCase()));
+    if (fade) argv.push("-af", fade);
+    argv.push("-c:a", "pcm_s16le");
   }
   argv.push(outPath);
   execFileSync("ffmpeg", argv, { stdio: "ignore" });
@@ -180,6 +207,10 @@ function cutSegment(inputPath, segment, outPath, copy) {
 
 // Codec set per output container. Audio-only outputs must not get the
 // video-centric aac/x264 set (aac inside .wav breaks timing entirely).
+function isAudioOnly(filePath) {
+  return [".wav", ".mp3", ".m4a", ".aac", ".flac"].includes(extname(filePath).toLowerCase());
+}
+
 function encodeArgsFor(ext) {
   if (ext === ".wav") return ["-c:a", "pcm_s16le"];
   if (ext === ".mp3") return ["-c:a", "libmp3lame", "-q:a", "2"];

package/dist/skills/media-use/scripts/transcript-cut.test.mjs

@@ -0,0 +1,117 @@
+import assert from "node:assert/strict";
+import { execFileSync, spawnSync } from "node:child_process";
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import test from "node:test";
+import { fileURLToPath } from "node:url";
+
+const SCRIPT = fileURLToPath(new URL("./transcript-cut.mjs", import.meta.url));
+const HAS_FFMPEG =
+  spawnSync("ffmpeg", ["-version"], { stdio: "ignore" }).status === 0 &&
+  spawnSync("ffprobe", ["-version"], { stdio: "ignore" }).status === 0;
+
+const SAMPLE_RATE = 44100;
+// A continuous tone's own slope between samples never exceeds amplitude * 2*pi*f/rate
+// (~2054 for 440Hz at full scale here); a raw splice between two independently-cut
+// points on the same tone lands at two unrelated phases, so an unfaded join jumps far
+// past that. This threshold sits well above normal tone motion and well below a splice.
+const MAX_CONTINUOUS_STEP = 6000;
+const MIN_SUSPICIOUS_ZERO_RUN = 20;
+
+function fixture() {
+  const dir = mkdtempSync(join(tmpdir(), "media-use-transcript-cut-"));
+  return { dir, cleanup: () => rmSync(dir, { recursive: true, force: true }) };
+}
+
+function run(args) {
+  return spawnSync(process.execPath, [SCRIPT, ...args], { encoding: "utf8" });
+}
+
+function readPcm(filePath) {
+  const raw = execFileSync("ffmpeg", [
+    "-hide_banner",
+    "-loglevel",
+    "error",
+    "-i",
+    filePath,
+    "-f",
+    "s16le",
+    "-ac",
+    "1",
+    "-ar",
+    String(SAMPLE_RATE),
+    "-",
+  ]);
+  const samples = new Int16Array(raw.buffer, raw.byteOffset, raw.length / 2);
+  return samples;
+}
+
+test(
+  "keeps a spliced tone continuous at every cut, with no raw phase jump or silence gap",
+  { skip: !HAS_FFMPEG },
+  (t) => {
+    const { dir, cleanup } = fixture();
+    t.after(cleanup);
+
+    const source = join(dir, "tone.wav");
+    execFileSync("ffmpeg", [
+      "-y",
+      "-hide_banner",
+      "-loglevel",
+      "error",
+      "-f",
+      "lavfi",
+      "-i",
+      `sine=frequency=440:duration=6:sample_rate=${SAMPLE_RATE}`,
+      source,
+    ]);
+
+    const transcriptPath = join(dir, "transcript.json");
+    writeFileSync(transcriptPath, JSON.stringify({ words: [{ text: "tone", start: 0, end: 6 }] }));
+
+    const output = join(dir, "out.wav");
+    // Two "ugly" removal ranges: neither aligned to the 440Hz period, so the kept
+    // segments' cut edges land at unrelated phases of the same continuous tone --
+    // exactly the shape that clicks without a fade, and the shape jrusso1020's
+    // review proved this branch never actually fades.
+    const result = run([
+      "--input",
+      source,
+      "--transcript",
+      transcriptPath,
+      "--remove",
+      "1.37-1.83,3.29-3.71",
+      "--out",
+      output,
+      "--json",
+    ]);
+    assert.equal(result.status, 0, result.stderr || result.stdout);
+
+    const samples = readPcm(output);
+    assert.ok(samples.length > SAMPLE_RATE, "expected several seconds of audio");
+
+    let maxStep = 0;
+    let zeroRun = 0;
+    let maxZeroRun = 0;
+    for (let i = 1; i < samples.length; i++) {
+      const step = Math.abs(samples[i] - samples[i - 1]);
+      if (step > maxStep) maxStep = step;
+      if (samples[i] === 0) {
+        zeroRun++;
+        if (zeroRun > maxZeroRun) maxZeroRun = zeroRun;
+      } else {
+        zeroRun = 0;
+      }
+    }
+
+    assert.ok(
+      maxStep <= MAX_CONTINUOUS_STEP,
+      `largest sample-to-sample step was ${maxStep}, expected <= ${MAX_CONTINUOUS_STEP} (a raw, unfaded splice)`,
+    );
+    assert.ok(
+      maxZeroRun < MIN_SUSPICIOUS_ZERO_RUN,
+      `found a run of ${maxZeroRun} consecutive zero samples, expected < ${MIN_SUSPICIOUS_ZERO_RUN} (a priming-silence gap)`,
+    );
+  },
+);

package/dist/studio/assets/{hyperframes-player-nmVkPQza.js → hyperframes-player-FmXtbvEE.js}

@@ -1,4 +1,4 @@
-var we=Object.defineProperty;var Ae=(s,i,e)=>i in s?we(s,i,{enumerable:!0,configurable:!0,writable:!0,value:e}):s[i]=e;var h=(s,i,e)=>Ae(s,typeof i!="symbol"?i+"":i,e);import{r as he,i as Ee,a as w,b as ue,c as Ce,d as Te,s as Re,e as Se,F as Le}from"./index-BK36b0XY.js";function xe(s){return s.hasRuntime||s.runtimeInjected?!1:!!(s.hasNestedCompositions||s.hasTimelines&&s.attempts>=5)}function $(s){return typeof s=="object"&&s!==null}function Me(s){return $(s)&&typeof s.getDuration=="function"}function De(s){return $(s)&&typeof s.duration=="function"&&typeof s.time=="function"&&typeof s.seek=="function"&&typeof s.play=="function"&&typeof s.pause=="function"}function Pe(s){if(!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(s))throw new Error(`Invalid HyperFrames runtime version: ${s}`);return`https://cdn.jsdelivr.net/npm/@hyperframes/core@${s}/dist/hyperframe.runtime.iife.js`}const H=typeof __HYPERFRAMES_RUNTIME_CDN_URL__=="string"?__HYPERFRAMES_RUNTIME_CDN_URL__:Pe("0.0.0-dev");function V(s){if(s===null)return null;const i=Number.parseInt(s,10);return Number.isFinite(i)&&i>0?i:null}function ke(s){const i=(s==null?void 0:s.querySelector("[data-composition-id][data-width][data-height]"))??(s==null?void 0:s.querySelector("[data-width][data-height]"));if(!i)return null;const e=V(i.getAttribute("data-width")),t=V(i.getAttribute("data-height"));return e!==null&&t!==null?{width:e,height:t}:null}class Ie{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 r=!!(t.__hf||t.__player),n=!!(t.__timelines&&Object.keys(t.__timelines).length>0),a=!!((e=this._iframe.contentDocument)!=null&&e.querySelector("[data-composition-src]"));if(xe({hasRuntime:r,hasTimelines:n,hasNestedCompositions:a,runtimeInjected:this._runtimeInjected,attempts:i})){this._injectRuntime();return}if(this._runtimeInjected&&!r)return;const d=this._resolvePlaybackDurationAdapter(t);if(d&&d.getDuration()>0){this.stop();const c=ke(this._iframe.contentDocument);this._callbacks.onReady({duration:d.getDuration(),adapter:d,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||$(Reflect.get(i,"__player"))}_injectRuntime(){var i,e;this._runtimeInjected=!0;try{const t=this._iframe.contentDocument;if(!t)return;const r=t.createElement("script");r.src=H,(t.head||t.documentElement).appendChild(r),(e=(i=this._callbacks).onRuntimeInjected)==null||e.call(i)}catch{}}_resolveDirectTimelineAdapterFromWindow(i){var d,c;if(this.hasRuntimeBridge(i))return null;const e=Reflect.get(i,"__timelines");if(!$(e))return null;const t=Object.keys(e);if(t.length===0)return null;const r=(c=(d=this._iframe.contentDocument)==null?void 0:d.querySelector("[data-composition-id]"))==null?void 0:c.getAttribute("data-composition-id"),n=r&&r in e?r:t[t.length-1],a=e[n];return De(a)?a:null}_resolvePlaybackDurationAdapter(i){const e=Reflect.get(i,"__player");if(Me(e))return{kind:"runtime",getDuration:()=>e.getDuration()};const t=this._resolveDirectTimelineAdapterFromWindow(i);return t?{kind:"direct-timeline",timeline:t,getDuration:()=>t.duration()}:null}}const Oe=`
+var we=Object.defineProperty;var Ae=(s,i,e)=>i in s?we(s,i,{enumerable:!0,configurable:!0,writable:!0,value:e}):s[i]=e;var h=(s,i,e)=>Ae(s,typeof i!="symbol"?i+"":i,e);import{r as he,i as Ee,a as w,b as ue,c as Ce,d as Te,s as Re,e as Se,F as Le}from"./index-CjueZL58.js";function xe(s){return s.hasRuntime||s.runtimeInjected?!1:!!(s.hasNestedCompositions||s.hasTimelines&&s.attempts>=5)}function $(s){return typeof s=="object"&&s!==null}function Me(s){return $(s)&&typeof s.getDuration=="function"}function De(s){return $(s)&&typeof s.duration=="function"&&typeof s.time=="function"&&typeof s.seek=="function"&&typeof s.play=="function"&&typeof s.pause=="function"}function Pe(s){if(!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(s))throw new Error(`Invalid HyperFrames runtime version: ${s}`);return`https://cdn.jsdelivr.net/npm/@hyperframes/core@${s}/dist/hyperframe.runtime.iife.js`}const H=typeof __HYPERFRAMES_RUNTIME_CDN_URL__=="string"?__HYPERFRAMES_RUNTIME_CDN_URL__:Pe("0.0.0-dev");function V(s){if(s===null)return null;const i=Number.parseInt(s,10);return Number.isFinite(i)&&i>0?i:null}function ke(s){const i=(s==null?void 0:s.querySelector("[data-composition-id][data-width][data-height]"))??(s==null?void 0:s.querySelector("[data-width][data-height]"));if(!i)return null;const e=V(i.getAttribute("data-width")),t=V(i.getAttribute("data-height"));return e!==null&&t!==null?{width:e,height:t}:null}class Ie{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 r=!!(t.__hf||t.__player),n=!!(t.__timelines&&Object.keys(t.__timelines).length>0),a=!!((e=this._iframe.contentDocument)!=null&&e.querySelector("[data-composition-src]"));if(xe({hasRuntime:r,hasTimelines:n,hasNestedCompositions:a,runtimeInjected:this._runtimeInjected,attempts:i})){this._injectRuntime();return}if(this._runtimeInjected&&!r)return;const d=this._resolvePlaybackDurationAdapter(t);if(d&&d.getDuration()>0){this.stop();const c=ke(this._iframe.contentDocument);this._callbacks.onReady({duration:d.getDuration(),adapter:d,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||$(Reflect.get(i,"__player"))}_injectRuntime(){var i,e;this._runtimeInjected=!0;try{const t=this._iframe.contentDocument;if(!t)return;const r=t.createElement("script");r.src=H,(t.head||t.documentElement).appendChild(r),(e=(i=this._callbacks).onRuntimeInjected)==null||e.call(i)}catch{}}_resolveDirectTimelineAdapterFromWindow(i){var d,c;if(this.hasRuntimeBridge(i))return null;const e=Reflect.get(i,"__timelines");if(!$(e))return null;const t=Object.keys(e);if(t.length===0)return null;const r=(c=(d=this._iframe.contentDocument)==null?void 0:d.querySelector("[data-composition-id]"))==null?void 0:c.getAttribute("data-composition-id"),n=r&&r in e?r:t[t.length-1],a=e[n];return De(a)?a:null}_resolvePlaybackDurationAdapter(i){const e=Reflect.get(i,"__player");if(Me(e))return{kind:"runtime",getDuration:()=>e.getDuration()};const t=this._resolveDirectTimelineAdapterFromWindow(i);return t?{kind:"direct-timeline",timeline:t,getDuration:()=>t.duration()}:null}}const Oe=`
   :host {
     display: block;
     position: relative;