@hyperframes/studio-server 0.9.15 → 0.9.17

package/dist/{chunk-NOIHVBIQ.js → chunk-66YZA32N.js}

@@ -1,6 +1,6 @@
 import {
   probeMediaMetadata
-} from "./chunk-X73QTST2.js";
+} from "./chunk-Y6EZUBYR.js";
 import {
   realpath
 } from "./chunk-QF7MFJJU.js";

package/dist/{chunk-B356RYG5.js → chunk-F4AQECCT.js}

@@ -2,11 +2,11 @@ import {
   PROXY_STILL_EXTENSION,
   PROXY_VARIANT_CONFIG,
   ffmpegHasHdrFilters
-} from "./chunk-NOIHVBIQ.js";
+} from "./chunk-66YZA32N.js";
 import {
   probeFirstFrameColour,
   probeMediaMetadata
-} from "./chunk-X73QTST2.js";
+} from "./chunk-Y6EZUBYR.js";
 import {
   mkdirWithinProject,
   realProjectRoot,
@@ -768,7 +768,7 @@ async function buildVideoFilter(ffmpegPath, sourcePath, metadata, keepsAlpha, bo
   const { hdrTransfer } = metadata.color;
   const toneMap = (hdrTransfer === "pq" || hdrTransfer === "hlg") && !keepsAlpha;
   if (toneMap) await ensureHdrFilters(ffmpegPath);
-  const firstFrame = toneMap ? await probeFirstFrameColour(sourcePath) : {};
+  const firstFrame = toneMap ? await probeFirstFrameColour(sourcePath, metadata.color.codecName) : {};
   const evenScale = proxyScaleFilter(box);
   const pixelFormat = keepsAlpha ? "yuva420p" : "yuv420p";
   return toneMap ? [

package/dist/{chunk-GTQ6S4O5.js → chunk-IJMPYPJG.js}

@@ -1,14 +1,14 @@
 import {
   PROXY_PARAMS_VERSION,
   resolveProxy
-} from "./chunk-B356RYG5.js";
+} from "./chunk-F4AQECCT.js";
 import {
   createMediaCodecProbeCache,
   proxyVariantFor,
   recordProxyPrewarm,
   scanProjectMedia,
   shouldPrewarmProxy
-} from "./chunk-NOIHVBIQ.js";
+} from "./chunk-66YZA32N.js";
 
 // src/helpers/mediaProxyPreview.ts
 import { resolve } from "path";

package/dist/{chunk-H4NVSSDJ.js → chunk-NEGQQZNI.js}

@@ -1,6 +1,6 @@
 import {
   probeAudioTrack
-} from "./chunk-X73QTST2.js";
+} from "./chunk-Y6EZUBYR.js";
 import {
   resolveWithinProject
 } from "./chunk-QF7MFJJU.js";
@@ -277,30 +277,24 @@ function audioNormalizationPlan(referenceTrack, targetTrack) {
   }
   const referenceLufs = referenceTrack.integratedLufs + gainDb(referenceTrack.volume);
   const targetLufs = targetTrack.integratedLufs + gainDb(targetTrack.volume);
-  const wantedGainDb = referenceLufs - targetTrack.integratedLufs;
-  if (wantedGainDb > MAX_AUDIO_GAIN_DB + 1e-9) {
-    throw new Error(
-      `Matching #${targetTrack.id} needs ${wantedGainDb.toFixed(1)} dB, beyond the +${MAX_AUDIO_GAIN_DB} dB authoring ceiling. A gap this large belongs in the source file, not the mixer: mixer gain raises the noise floor with the signal. Normalize ${targetTrack.id}'s asset offline (e.g. ffmpeg loudnorm), or lower #${referenceTrack.id} instead.`
-    );
-  }
-  const volume = 10 ** (wantedGainDb / 20);
-  const projectedTruePeakDbfs = targetTrack.truePeakDbfs + wantedGainDb;
-  if (projectedTruePeakDbfs > 0) {
-    throw new Error(
-      `Matching #${targetTrack.id} would clip at +${projectedTruePeakDbfs.toFixed(1)} dBFS; limit or preprocess the source first`
-    );
-  }
+  const previousGainDb = gainDb(targetTrack.volume);
+  const { appliedGainDb, limitedBy } = fittedGain(
+    referenceLufs - targetTrack.integratedLufs,
+    targetTrack.truePeakDbfs,
+    previousGainDb
+  );
   return {
     referenceId: referenceTrack.id,
     targetId: targetTrack.id,
     referenceLufs,
     targetLufs,
     previousVolume: targetTrack.volume,
-    volume,
-    gainDb: wantedGainDb,
-    changeDb: wantedGainDb - gainDb(targetTrack.volume),
-    projectedLufs: targetTrack.integratedLufs + wantedGainDb,
-    projectedTruePeakDbfs
+    volume: 10 ** (appliedGainDb / 20),
+    gainDb: appliedGainDb,
+    changeDb: appliedGainDb - previousGainDb,
+    projectedLufs: targetTrack.integratedLufs + appliedGainDb,
+    projectedTruePeakDbfs: targetTrack.truePeakDbfs + appliedGainDb,
+    limitedBy
   };
 }
 function updateAudioVolume(html, id, volume) {
@@ -363,19 +357,12 @@ function absoluteLoudnessPlan(track, targetLufs = DEFAULT_TARGET_LUFS) {
   if (track.integratedLufs <= SILENCE_LUFS) {
     throw new Error(`#${track.id} is silent in the played window; there is nothing to normalize`);
   }
-  const wantedGainDb = targetLufs - track.integratedLufs;
-  const peakRoomDb = NORMALIZE_TRUE_PEAK_CEILING_DBFS - track.truePeakDbfs;
-  const limits = [
-    [null, wantedGainDb],
-    ["gain-ceiling", MAX_AUDIO_GAIN_DB],
-    ["true-peak", peakRoomDb]
-  ];
-  const [limitedBy, limitedGainDb] = limits.reduce(
-    (lowest, candidate) => candidate[1] < lowest[1] - 1e-9 ? candidate : lowest
-  );
   const previousGainDb = track.volume > 0 ? gainDb(track.volume) : 0;
-  const limitCannotCutAWantedBoost = wantedGainDb > previousGainDb;
-  const appliedGainDb = limitCannotCutAWantedBoost ? Math.max(limitedGainDb, previousGainDb) : limitedGainDb;
+  const { appliedGainDb, limitedBy } = fittedGain(
+    targetLufs - track.integratedLufs,
+    track.truePeakDbfs,
+    previousGainDb
+  );
   return {
     targetId: track.id,
     targetLufs,
@@ -389,6 +376,18 @@ function absoluteLoudnessPlan(track, targetLufs = DEFAULT_TARGET_LUFS) {
     limitedBy
   };
 }
+function fittedGain(wantedGainDb, truePeakDbfs, previousGainDb) {
+  const limits = [
+    [null, wantedGainDb],
+    ["gain-ceiling", MAX_AUDIO_GAIN_DB],
+    ["true-peak", NORMALIZE_TRUE_PEAK_CEILING_DBFS - truePeakDbfs]
+  ];
+  const [limitedBy, limitedGainDb] = limits.reduce(
+    (lowest, candidate) => candidate[1] < lowest[1] - 1e-9 ? candidate : lowest
+  );
+  const appliedGainDb = wantedGainDb > previousGainDb ? Math.max(limitedGainDb, previousGainDb) : limitedGainDb;
+  return { appliedGainDb, limitedBy };
+}
 function absoluteOutcome(plan, tolerance) {
   if (Math.abs(plan.changeDb) > tolerance) return "change";
   return Math.abs(plan.projectedLufs - plan.targetLufs) <= tolerance ? "matched" : "held";

package/dist/{chunk-LK3ZTZGN.js → chunk-REQUL5L4.js}

@@ -343,6 +343,12 @@ function probeElementsInSource(source, targets) {
 function probeElementInSource(source, target) {
   return probeElementsInSource(source, [target])[0] ?? false;
 }
+var refused = (html, refusal) => ({
+  html,
+  matched: false,
+  newId: null,
+  refusal
+});
 function resolveElementTiming(el) {
   const timing = readClipTiming(el);
   return { start: timing.start ?? 0, duration: timing.duration ?? 0 };
@@ -363,7 +369,7 @@ function isWindowOf(media, row) {
 function splitElementInHtml(source, target, splitTime, newId, fallbackTiming) {
   const { document, wrappedFragment } = parseSourceDocument(source);
   const el = findTargetElement(document, target);
-  if (!el || !isHTMLElement(el)) return { html: source, matched: false, newId: null };
+  if (!el || !isHTMLElement(el)) return refused(source, "target-not-found");
   const timedMediaSelector = "video[data-start], audio[data-start]";
   const innerMedia = el.hasAttribute("data-start") || resolveElementTiming(el).duration > 0 || el.matches("[data-composition-src], [data-composition-id]") ? null : el.querySelector(timedMediaSelector);
   const timedMedia = innerMedia && isWindowOf(resolveElementTiming(innerMedia), fallbackTiming) ? innerMedia : null;
@@ -373,21 +379,22 @@ function splitElementInHtml(source, target, splitTime, newId, fallbackTiming) {
   const reference = readClipTiming(timed).startExpression;
   const startsAfter = reference?.kind === "reference" ? reference : null;
   if (startsAfter) {
-    if (!fallbackTiming) return { html: source, matched: false, newId: null };
+    if (!fallbackTiming) return refused(source, "reference-without-range");
     start = fallbackTiming.start;
   }
   if (duration <= 0 && fallbackTiming && fallbackTiming.duration > 0) {
     start = fallbackTiming.start;
     duration = fallbackTiming.duration;
   }
-  if (duration <= 0 || splitTime < start + SPLIT_BOUNDARY_EPSILON_S || splitTime > start + duration - SPLIT_BOUNDARY_EPSILON_S) {
-    return { html: source, matched: false, newId: null };
+  if (duration <= 0) return refused(source, "no-duration");
+  if (splitTime < start + SPLIT_BOUNDARY_EPSILON_S || splitTime > start + duration - SPLIT_BOUNDARY_EPSILON_S) {
+    return refused(source, "outside-clip");
   }
   newId = nextUniqueId(document, newId);
   const firstDuration = splitTime - start;
   const secondDuration = duration - firstDuration;
   const clone = el.cloneNode(true);
-  if (!isHTMLElement(clone)) return { html: source, matched: false, newId: null };
+  if (!isHTMLElement(clone)) return refused(source, "target-not-found");
   clone.setAttribute("id", newId);
   dedupeClonedCompositionId(document, clone);
   clone.removeAttribute("data-hf-id");

package/dist/{chunk-X73QTST2.js → chunk-Y6EZUBYR.js}

@@ -3,7 +3,10 @@ import { execFile } from "child_process";
 import { extname } from "path";
 import {
   firstFrameColourArgs,
-  parseFirstFrameColour
+  keyframeTransferArgs,
+  parseFirstFrameColour,
+  readsKeyframeTransfers,
+  parseKeyframeTransfers
 } from "@hyperframes/core";
 import { findFfBinary } from "@hyperframes/parsers/ff-binaries";
 import { videoStreamHasAlpha } from "@hyperframes/parsers/media-alpha";
@@ -82,14 +85,21 @@ function classifyMediaColor(stream) {
     bitsPerRawSample: stream?.bits_per_raw_sample
   };
 }
-async function probeFirstFrameColour(filePath, runner = execFileRunner) {
+async function probeFirstFrameColour(filePath, codec, runner = execFileRunner) {
   const ffmpegPath = findFfBinary("ffmpeg", { configuredMustExist: true }) ?? (runner === execFileRunner ? void 0 : "ffmpeg");
   if (!ffmpegPath) return {};
   const result = await runner(ffmpegPath, firstFrameColourArgs(filePath), {
     timeout: 15e3,
     maxBuffer: 1024 * 1024
   });
-  return result.status === 0 ? parseFirstFrameColour(String(result.stderr)) : {};
+  const first = result.status === 0 ? parseFirstFrameColour(String(result.stderr)) : {};
+  if (result.status !== 0 || !readsKeyframeTransfers(first)) return first;
+  const keyframes = await runner(ffmpegPath, keyframeTransferArgs(filePath, codec), {
+    timeout: 3e4,
+    maxBuffer: 8 * 1024 * 1024
+  });
+  const keyframeTransfers = keyframes.status === 0 ? parseKeyframeTransfers(String(keyframes.stderr)) : [];
+  return { ...first, keyframeTransfers };
 }
 function bitDepthOf(stream) {
   const raw = Number(stream.bits_per_raw_sample);

package/dist/helpers/loudness.d.ts

@@ -35,6 +35,7 @@ interface AudioNormalizationPlan {
     changeDb: number;
     projectedLufs: number;
     projectedTruePeakDbfs: number;
+    limitedBy: LoudnessLimit | null;
 }
 /** Read the authored clips with sound — `<audio>` and audible `<video>` — without reserializing. */
 declare function audioTags(html: string): AudioTag[];
@@ -43,7 +44,7 @@ declare function resolveLocalAudioPath(projectDir: string, src: string): string;
 /** Parse FFmpeg's final EBU R128 summary, not its per-window log lines. */
 declare function parseEbur128Summary(stderr: string): LoudnessMeasurement;
 declare function gainDb(volume: number): number;
-/** Calculate the target's absolute authored gain while keeping the reference unchanged. */
+/** The target's gain that matches the reference's played loudness; past a ceiling it stops as fittedGain does. */
 declare function audioNormalizationPlan(referenceTrack: NormalizationTrack, targetTrack: NormalizationTrack): AudioNormalizationPlan;
 /** Patch one authored attribute in place so scripts/styles/comments remain byte-stable. */
 declare function updateAudioVolume(html: string, id: string, volume: number): string;
@@ -78,9 +79,8 @@ interface AbsoluteLoudnessPlan {
 }
 /**
  * The authored gain that brings one clip's played window to an absolute
- * loudness. Unlike reference matching it never refuses: past the +12 dB
- * authoring ceiling or the true-peak ceiling it applies the most that fits and
- * names which limit stopped it.
+ * loudness; past the +12 dB authoring ceiling or the true-peak ceiling it
+ * applies the most that fits and names which limit stopped it (fittedGain).
  */
 declare function absoluteLoudnessPlan(track: NormalizationTrack, targetLufs?: number): AbsoluteLoudnessPlan;
 type AbsoluteOutcome = "matched" | "held" | "change";

package/dist/helpers/loudness.js

@@ -12,8 +12,8 @@ import {
   requiredFfmpeg,
   resolveLocalAudioPath,
   updateAudioVolume
-} from "../chunk-H4NVSSDJ.js";
-import "../chunk-X73QTST2.js";
+} from "../chunk-NEGQQZNI.js";
+import "../chunk-Y6EZUBYR.js";
 import "../chunk-QF7MFJJU.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";

package/dist/helpers/mediaCodecMap.js

@@ -15,8 +15,8 @@ import {
   scanProjectMedia,
   scanProjectMediaCodecMap,
   shouldPrewarmProxy
-} from "../chunk-NOIHVBIQ.js";
-import "../chunk-X73QTST2.js";
+} from "../chunk-66YZA32N.js";
+import "../chunk-Y6EZUBYR.js";
 import "../chunk-QF7MFJJU.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";

package/dist/helpers/mediaProxyPreview.d.ts

@@ -1,5 +1,5 @@
 import '@hyperframes/core';
-export { a as PreviewApiAdapter, P as PreviewDocumentStore, i as injectMediaCodecMap, f as injectMediaCodecMapIntoHtml, g as isAutoProxyEnabled, p as proxyEtagSalt, r as resolvePreviewMediaCodecProbeCache } from '../mediaProxyPreview-Ds5TElPq.js';
+export { a as PreviewApiAdapter, P as PreviewDocumentStore, i as injectMediaCodecMap, f as injectMediaCodecMapIntoHtml, g as isAutoProxyEnabled, p as proxyEtagSalt, r as resolvePreviewMediaCodecProbeCache } from '../mediaProxyPreview-pNW7nfS0.js';
 import './mediaCodecMap.js';
 import 'sharp';
 import '@hyperframes/parsers';

package/dist/helpers/mediaProxyPreview.js

@@ -4,10 +4,10 @@ import {
   isAutoProxyEnabled,
   proxyEtagSalt,
   resolvePreviewMediaCodecProbeCache
-} from "../chunk-GTQ6S4O5.js";
-import "../chunk-B356RYG5.js";
-import "../chunk-NOIHVBIQ.js";
-import "../chunk-X73QTST2.js";
+} from "../chunk-IJMPYPJG.js";
+import "../chunk-F4AQECCT.js";
+import "../chunk-66YZA32N.js";
+import "../chunk-Y6EZUBYR.js";
 import "../chunk-QF7MFJJU.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";

package/dist/helpers/proxyTranscoder.js

@@ -22,9 +22,9 @@ import {
   retryProxyCopy,
   sourceFolderKind,
   waitForProxy
-} from "../chunk-B356RYG5.js";
-import "../chunk-NOIHVBIQ.js";
-import "../chunk-X73QTST2.js";
+} from "../chunk-F4AQECCT.js";
+import "../chunk-66YZA32N.js";
+import "../chunk-Y6EZUBYR.js";
 import "../chunk-QF7MFJJU.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";

package/dist/helpers/sourceMutation.d.ts

@@ -34,10 +34,13 @@ declare function nextUniqueId(document: Document, base: string, takenIds?: Reado
 /** Whether each target exists in `source`; the document is parsed once however many targets ask. */
 declare function probeElementsInSource(source: string, targets: readonly SourceMutationTarget[]): boolean[];
 declare function probeElementInSource(source: string, target: SourceMutationTarget): boolean;
+/** Why a split changed nothing: the cut route says it, so a report names the cause and not just "rejected". */
+type SplitRefusal = "target-not-found" | "reference-without-range" | "no-duration" | "outside-clip";
 interface SplitElementResult {
     html: string;
     matched: boolean;
     newId: string | null;
+    refusal?: SplitRefusal;
 }
 declare function splitElementInHtml(source: string, target: SourceMutationTarget, splitTime: number, newId: string, fallbackTiming?: {
     start: number;
@@ -96,4 +99,4 @@ declare function unwrapElementsFromHtml(source: string, groupTarget: SourceMutat
 /** After a cut, give each linked group's right halves their own `data-link` and `data-sync-origin`. */
 declare function relinkSplitHalvesInHtml(source: string, rightHalfIds: readonly string[]): string;
 
-export { type ElementRebase, type PatchOperation, type SourceMutationTarget, type SplitElementResult, type UnwrapChildTrack, type UnwrapElementsResult, type WrapElementsResult, dedupeClonedCompositionId, findTargetElement, isHTMLElement, nextUniqueId, parseSourceDocument, patchElementInHtml, probeElementInSource, probeElementsInSource, relinkSplitHalvesInHtml, removeElementFromHtml, removeElementsFromHtml, splitElementInHtml, unwrapElementsFromHtml, wrapElementsInHtml };
+export { type ElementRebase, type PatchOperation, type SourceMutationTarget, type SplitElementResult, type SplitRefusal, type UnwrapChildTrack, type UnwrapElementsResult, type WrapElementsResult, dedupeClonedCompositionId, findTargetElement, isHTMLElement, nextUniqueId, parseSourceDocument, patchElementInHtml, probeElementInSource, probeElementsInSource, relinkSplitHalvesInHtml, removeElementFromHtml, removeElementsFromHtml, splitElementInHtml, unwrapElementsFromHtml, wrapElementsInHtml };

package/dist/helpers/sourceMutation.js

@@ -13,7 +13,7 @@ import {
   splitElementInHtml,
   unwrapElementsFromHtml,
   wrapElementsInHtml
-} from "../chunk-LK3ZTZGN.js";
+} from "../chunk-REQUL5L4.js";
 export {
   dedupeClonedCompositionId,
   findTargetElement,

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Hono } from 'hono';
-import { S as StudioApiAdapter, P as PreviewDocumentStore, M as MediaProcessingJobState } from './mediaProxyPreview-Ds5TElPq.js';
-export { L as LintResult, a as PreviewApiAdapter, R as RenderJobState, b as ResolvedProject, c as StudioSelectionResponse, d as StudioSelectionSnapshot, e as StudioSelectionTextField } from './mediaProxyPreview-Ds5TElPq.js';
+import { S as StudioApiAdapter, P as PreviewDocumentStore, M as MediaProcessingJobState } from './mediaProxyPreview-pNW7nfS0.js';
+export { L as LintResult, a as PreviewApiAdapter, R as RenderJobState, b as ResolvedProject, c as StudioSelectionResponse, d as StudioSelectionSnapshot, e as StudioSelectionTextField } from './mediaProxyPreview-pNW7nfS0.js';
 export { C as ClosedWindow, D as DEFAULT_HISTORY_ROOT, S as HISTORY_START, H as HistoryClosedError, a as HistoryEntry, b as HistoryEntrySide, c as HistoryFileChange, d as HistoryListItem, e as HistoryRefusedError, f as HistoryResult, g as HistoryTarget, h as HistoryWho, i as HistoryWindow, M as MAX_WINDOW_IDLE_MS, P as ProjectHistory, j as ProjectHistoryOptions, k as ProjectHistoryView, U as UNDO_MODES, l as UndoMode, o as openProjectHistory, r as readProjectHistory } from './projectHistory-C18HDvac.js';
 export { ArtifactCapture, ArtifactInput, ArtifactRecord, HistoryBusyError, HistoryIdError, InPlaceOutcome, ProjectHistoryRecord, PrunedHistory, ReclaimedHistory, RenderRecord, VideoState, artifactDirectory, beginArtifactCapture, finishSnapshotRun, forgetRecordedArtifacts, historyCache, isUncopiedMedia, listProjectHistories, onRestoredInPlace, pruneGoneProjectHistories, reclaimUncopiedBlobs, recordArtifact, recordArtifacts, recordRenderSuccess, registerRenderOutput, retainSnapshotOutput } from './history/index.js';
 export { CACHE_DIR_NAME as PROXY_CACHE_DIR_NAME } from './helpers/proxyTranscoder.js';

package/dist/index.js

@@ -17,7 +17,7 @@ import {
   splitElementInHtml,
   unwrapElementsFromHtml,
   wrapElementsInHtml
-} from "./chunk-LK3ZTZGN.js";
+} from "./chunk-REQUL5L4.js";
 import {
   isCompositionSource,
   stampProjectHfIds,
@@ -85,13 +85,13 @@ import {
   requestedProjectPath,
   requiredFfmpeg,
   resolveLocalAudioPath
-} from "./chunk-H4NVSSDJ.js";
+} from "./chunk-NEGQQZNI.js";
 import {
   injectMediaCodecMap,
   isAutoProxyEnabled,
   proxyEtagSalt,
   resolvePreviewMediaCodecProbeCache
-} from "./chunk-GTQ6S4O5.js";
+} from "./chunk-IJMPYPJG.js";
 import {
   CACHE_DIR_NAME,
   PROXY_PENDING_RETRY_AFTER_SECONDS,
@@ -105,7 +105,7 @@ import {
   resolveStill,
   retryProxyCopy,
   waitForProxy
-} from "./chunk-B356RYG5.js";
+} from "./chunk-F4AQECCT.js";
 import {
   PROXY_VARIANT_CONFIG,
   decideMediaProxyEligibility,
@@ -113,11 +113,11 @@ import {
   probeAssetCodec,
   recordProxyRequest,
   resolveProxyVariantRequest
-} from "./chunk-NOIHVBIQ.js";
+} from "./chunk-66YZA32N.js";
 import {
   probeAudioTrack,
   probeMediaMetadata
-} from "./chunk-X73QTST2.js";
+} from "./chunk-Y6EZUBYR.js";
 import {
   folderGone,
   isInHiddenOrVendorDir,
@@ -2930,6 +2930,12 @@ async function executeGsapMutationRecast(body, block, respond) {
       return respond({ error: `unknown mutation type: ${body.type}` }, 400);
   }
 }
+var CUT_REFUSALS = {
+  "target-not-found": "Cut target was not found",
+  "reference-without-range": "Cut target starts after another clip and the cut sent no range for it",
+  "no-duration": "Cut target has no duration",
+  "outside-clip": "Cut point was outside the clip's start and end"
+};
 async function foldAtomicCutFile(c, file, absPath, before, writer) {
   let after = before;
   let splitCount = 0;
@@ -2958,7 +2964,7 @@ async function foldAtomicCutFile(c, file, absPath, before, writer) {
     });
     if (!split.matched || !split.newId) {
       return c.json(
-        { error: `Cut target was not found or was outside its authored bounds in ${file.path}` },
+        { error: `${CUT_REFUSALS[split.refusal ?? "target-not-found"]} in ${file.path}` },
         400
       );
     }
@@ -4848,6 +4854,7 @@ function contentDispositionHeader(disposition, filename) {
 }
 function registerRenderRoutes(api, adapter) {
   const renderJobs = /* @__PURE__ */ new Map();
+  const CANCEL_SETTLE_MS = 45e3;
   const nextFreeRenderJobId = (baseId, ext, rendersDir) => {
     let jobId = baseId;
     for (let n = 2; renderJobs.has(jobId) || existsSync6(join10(rendersDir, `${jobId}${ext}`)); n++) {
@@ -4965,13 +4972,19 @@ function registerRenderRoutes(api, adapter) {
       }
     });
   });
-  api.post("/render/:jobId/cancel", (c) => {
+  api.post("/render/:jobId/cancel", async (c) => {
     const { jobId } = c.req.param();
     const job = renderJobs.get(jobId);
     if (!job) return c.json({ error: "not found" }, 404);
     if (job.status === "rendering") {
       job.status = "cancelled";
-      job.cancel?.();
+      let giveUp;
+      const late = new Promise((done) => giveUp = setTimeout(done, CANCEL_SETTLE_MS));
+      try {
+        await Promise.race([job.cancel?.(), late]);
+      } finally {
+        clearTimeout(giveUp);
+      }
     }
     return c.json({ status: job.status });
   });

package/dist/{mediaProxyPreview-Ds5TElPq.d.ts → mediaProxyPreview-pNW7nfS0.d.ts}

@@ -27,7 +27,7 @@ interface RenderJobState {
      * stop an in-flight render; adapters that can't abort may omit it (the
      * route still marks the job cancelled so the SSE stream terminates).
      */
-    cancel?: () => void;
+    cancel?: () => void | Promise<void>;
 }
 interface MediaProcessingJobState {
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio-server",
-  "version": "0.9.15",
+  "version": "0.9.17",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
@@ -88,8 +88,8 @@
     "linkedom": "^0.18.12",
     "postcss": "^8.5.8",
     "postcss-selector-parser": "^7.1.2",
-    "@hyperframes/core": "0.9.15",
-    "@hyperframes/parsers": "0.9.15"
+    "@hyperframes/parsers": "0.9.17",
+    "@hyperframes/core": "0.9.17"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",