hyperframes 0.8.143 → 0.8.145

package/dist/{chunk-7UYBQ6NF.js → chunk-GXJEGZL2.js}

@@ -21,7 +21,7 @@ import {
   splitElementInHtml,
   unwrapElementsFromHtml,
   wrapElementsInHtml
-} from "./chunk-UM2GRYM3.js";
+} from "./chunk-5WVW7P23.js";
 import {
   MAX_WINDOW_IDLE_MS,
   STUDIO_SIGNATURE_MANIFEST_PATHS,
@@ -43,7 +43,7 @@ import {
   requestedProjectPath,
   requiredFfmpeg,
   resolveLocalAudioPath
-} from "./chunk-BFDJ63J5.js";
+} from "./chunk-DDIVWXN7.js";
 import {
   PROXY_PARAMS_VERSION,
   PROXY_PENDING_RETRY_AFTER_SECONDS,
@@ -65,7 +65,7 @@ import {
   scanProjectMediaCodecMap,
   shouldPrewarmProxy,
   waitForProxy
-} from "./chunk-ZQQ3SEIE.js";
+} from "./chunk-KIFHYXPB.js";
 import {
   STUDIO_MOTION_PATH,
   createStudioMotionRenderBodyScript,
@@ -98,7 +98,7 @@ import {
 } from "./chunk-TJSTGSAW.js";
 import {
   addScenePartsManifest
-} from "./chunk-F26LCYRY.js";
+} from "./chunk-FDT6KQV4.js";
 import {
   ensureHfIds
 } from "./chunk-NE55C6S5.js";
@@ -111,7 +111,7 @@ import {
   parseFps,
   parsePreviewProxyBox,
   sameInstant
-} from "./chunk-4M4EC7JX.js";
+} from "./chunk-VRW6EBHV.js";
 import {
   AFTER_FONTS_SCRIPT_TYPE,
   RUNTIME_BOOTSTRAP_ATTR,
@@ -125,7 +125,7 @@ import {
   resolveRateSpec,
   sourceTimeAt,
   stripEmbeddedRuntimeScripts
-} from "./chunk-6TPZSTCL.js";
+} from "./chunk-AUWHD7RA.js";
 import {
   HTML_ATTRIBUTE_ENTITIES,
   MagicString,
@@ -159,7 +159,7 @@ import {
   rewriteAssetPaths,
   rewriteCssAssetUrls,
   rewriteInlineStyleAssetUrls
-} from "./chunk-ZLW2V65P.js";
+} from "./chunk-BSQ7XANM.js";
 import {
   parseHTML
 } from "./chunk-SDYDNHEE.js";
@@ -300,7 +300,7 @@ function clearElementScreenshotIsolation() {
   page.__hfThumbnailFaded = [];
 }
 
-// ../studio-server/dist/chunk-AYKLBPP2.js
+// ../studio-server/dist/chunk-WE5JQ6V7.js
 import { resolve } from "path";
 function isAutoProxyEnabled(adapter) {
   return adapter.autoProxy !== false;
@@ -4430,16 +4430,7 @@ function applyFileMutations(projectDir, mutations, requestToken, writeFile = (pa
     }
     return results;
   } catch (error) {
-    const rollbackErrors = [];
-    for (const mutation of attempted.reverse()) {
-      try {
-        if (!mutation.written || readFileSync4(mutation.absPath, "utf-8") === mutation.after)
-          writeFile(mutation.absPath, mutation.before, "utf-8");
-        clearFileWriteReceipt(mutation.absPath, mutation.version, mutation.writeToken);
-      } catch (rollbackError) {
-        rollbackErrors.push(rollbackError);
-      }
-    }
+    const rollbackErrors = rollBack(attempted, writeFile);
     if (rollbackErrors.length > 0) {
       throw new AggregateError(
         [error, ...rollbackErrors],
@@ -4449,6 +4440,20 @@ function applyFileMutations(projectDir, mutations, requestToken, writeFile = (pa
     throw error;
   }
 }
+function rollBack(attempted, writeFile) {
+  const errors = [];
+  for (const mutation of attempted.reverse()) {
+    try {
+      const current = readFileSync4(mutation.absPath, "utf-8");
+      if (mutation.written ? current === mutation.after : current !== mutation.before)
+        writeFile(mutation.absPath, mutation.before, "utf-8");
+      clearFileWriteReceipt(mutation.absPath, mutation.version, mutation.writeToken);
+    } catch (rollbackError) {
+      errors.push(rollbackError);
+    }
+  }
+  return errors;
+}
 function applyOneMutation(projectDir, mutation, requestToken, writeFile, attempted) {
   const current = readFileSync4(mutation.absPath, "utf-8");
   assertExpectedVersion(mutation, current);
@@ -5441,7 +5446,7 @@ async function prepareGsapMutationScript(c, res, firstMutation) {
   let block = extractGsapScriptBlock(html);
   if (!block && (firstMutation.type === "add" || firstMutation.type === "add-with-keyframes")) {
     const compId = html.match(/data-composition-id="([^"]+)"/)?.[1] ?? "main";
-    const { GSAP_CDN } = await import("./dist-XN234YFQ.js");
+    const { GSAP_CDN } = await import("./dist-Q4BI5A73.js");
     const bootstrap = [
       `<script src="${GSAP_CDN}"></script>`,
       "<script>",
@@ -7838,7 +7843,11 @@ async function lintUncoveredHtml(adapter, projectDir, htmlFiles, coveredFiles) {
   for (const file of htmlFiles) {
     if (coveredFiles.has(file)) continue;
     const content = readFileSync7(join9(projectDir, file), "utf-8");
-    const result = await adapter.lint(content, { filePath: file, isSubComposition: true });
+    const result = await adapter.lint(content, {
+      filePath: file,
+      isSubComposition: true,
+      compSrcPath: file
+    });
     for (const finding of result?.findings ?? []) {
       findings.push({ ...finding, file });
     }
@@ -7959,6 +7968,7 @@ function registerRenderRoutes(api, adapter) {
       outputResolution,
       composition,
       variables,
+      useGpu: body.gpu === true && format === "mp4",
       distinctId: typeof body.telemetryDistinctId === "string" ? body.telemetryDistinctId : void 0,
       telemetryOptOut: body.telemetryOptOut === true
     });

package/dist/{chunk-KJJLA674.js → chunk-GZVP4TWN.js}

@@ -71,51 +71,6 @@ ${EXTRA_POSITIONAL_HINTS[path]}` : "");
   );
 }
 
-// src/utils/reject-unknown-flags.ts
-var ALWAYS_KNOWN = /* @__PURE__ */ new Set(["help", "h", "version", "v", "json"]);
-function nameVariants(name) {
-  const kebab = name.replace(/[A-Z]/g, (c) => "-" + c.toLowerCase());
-  const camel = name.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
-  return [name, kebab, camel];
-}
-function knownFlags(args) {
-  const known = new Set(ALWAYS_KNOWN);
-  for (const [name, def] of Object.entries(args ?? {})) {
-    for (const v of nameVariants(name)) known.add(v);
-    const alias = def?.alias;
-    if (typeof alias === "string") known.add(alias);
-    else if (Array.isArray(alias)) for (const a of alias) known.add(a);
-  }
-  return known;
-}
-function longFlagName(tok) {
-  const name = tok.slice(2).split("=")[0] ?? "";
-  return name.startsWith("no-") ? name.slice(3) : name;
-}
-function unknownFlagIn(tok, known) {
-  if (tok === "-" || !tok.startsWith("-")) return null;
-  if (tok.startsWith("--")) {
-    const name = longFlagName(tok);
-    return name && !known.has(name) ? `--${name}` : null;
-  }
-  for (const ch of tok.slice(1).split("=")[0] ?? "") {
-    if (!known.has(ch)) return `-${ch}`;
-  }
-  return null;
-}
-function assertKnownFlags(cmd, rawArgs) {
-  if (!Array.isArray(rawArgs)) return;
-  const rawDef = cmd.args;
-  const args = rawDef && typeof rawDef === "object" ? rawDef : void 0;
-  const known = knownFlags(args);
-  for (const tok of rawArgs) {
-    if (tok === "--") break;
-    const bad = unknownFlagIn(tok, known);
-    if (bad) throw new Error(`Unknown flag: ${bad}`);
-  }
-}
-
 export {
-  resolveExtraPositionals,
-  assertKnownFlags
+  resolveExtraPositionals
 };

package/dist/{chunk-QVYVUCWD.js → chunk-HB7FJOY4.js}

@@ -7,7 +7,7 @@ var __dirname = __hf_dirname(__filename);
 
 // src/utils/producer.ts
 async function loadProducer() {
-  return await import("./src-X426BZAG.js");
+  return await import("./src-KS3AWFGT.js");
 }
 
 export {

package/dist/{chunk-QFN7NVWM.js → chunk-ICKDMTLA.js}

@@ -8,7 +8,7 @@ import {
   flush,
   shouldTrack,
   trackEvent
-} from "./chunk-OSSHSIMD.js";
+} from "./chunk-ZF7SXQJ7.js";
 import {
   getPowerState
 } from "./chunk-GQJZORQP.js";

package/dist/{chunk-XONFUK3M.js → chunk-IEIJRMLZ.js}

@@ -41,7 +41,7 @@ import {
   readDataDurationSeconds,
   resolveMediaDuration,
   rewriteAssetPath
-} from "./chunk-ZLW2V65P.js";
+} from "./chunk-BSQ7XANM.js";
 import {
   Parser,
   parseHTML
@@ -3834,12 +3834,13 @@ function parseHtmlStructure(source) {
 function findHtmlTag(tags) {
   return tags.find((tag) => tag.name === "html") ?? null;
 }
+var hasCompositionMarker = (tag) => Boolean(
+  readDecodedAttr(tag.raw, "data-composition-id") || readAttr(tag.raw, "data-width") || readAttr(tag.raw, "data-height")
+);
 function findRootTag(source, parsedTags) {
   const tags = parsedTags ?? parseHtmlStructure(source).tags;
   const bodyTag = tags.find((tag) => tag.name === "body");
-  if (bodyTag && (readDecodedAttr(bodyTag.raw, "data-composition-id") || readAttr(bodyTag.raw, "data-width") || readAttr(bodyTag.raw, "data-height"))) {
-    return bodyTag;
-  }
+  if (bodyTag && hasCompositionMarker(bodyTag)) return bodyTag;
   const bodyStart = bodyTag ? bodyTag.index + bodyTag.raw.length : 0;
   const bodyEnd = bodyTag?.closeIndex ?? source.length;
   const bodyTags = tags.filter((tag) => tag.index >= bodyStart && tag.index < bodyEnd);
@@ -3847,7 +3848,8 @@ function findRootTag(source, parsedTags) {
   for (const tag of bodyTags) {
     if (tag.index < skipBefore) continue;
     if (["script", "style", "meta", "link", "title"].includes(tag.name)) continue;
-    if (tag.name === "svg" && !readDecodedAttr(tag.raw, "data-composition-id") && !readAttr(tag.raw, "data-width") && !readAttr(tag.raw, "data-height")) {
+    if ((tag.name === "html" || tag.name === "head") && !hasCompositionMarker(tag)) continue;
+    if (tag.name === "svg" && !hasCompositionMarker(tag)) {
       skipBefore = tag.endIndex ?? Infinity;
       continue;
     }
@@ -4469,7 +4471,8 @@ function buildLintContext(html, options = {}) {
       content: style.content,
       raw: style.content,
       index: -1,
-      file: style.file ?? style.href
+      file: style.file ?? style.href,
+      rootRelativePath: style.rootRelativePath
     }))
   ];
   const scripts = structure.scripts;
@@ -4858,7 +4861,7 @@ var coreRules = [
   },
   // root_missing_composition_id + root_missing_dimensions
   // fallow-ignore-next-line complexity
-  ({ rootTag }) => {
+  ({ rootTag, options }) => {
     const findings = [];
     if (!rootTag || !readDecodedAttr(rootTag.raw, "data-composition-id")) {
       findings.push({
@@ -4870,7 +4873,7 @@ var coreRules = [
         snippet: truncateSnippet(rootTag?.raw || "")
       });
     }
-    if (!rootTag || !readAttr(rootTag.raw, "data-width") || !readAttr(rootTag.raw, "data-height")) {
+    if (!options.isSubComposition && (!rootTag || !readAttr(rootTag.raw, "data-width") || !readAttr(rootTag.raw, "data-height"))) {
       findings.push({
         code: "root_missing_dimensions",
         severity: "error",
@@ -6331,6 +6334,24 @@ function extractCssUrlReferences(css) {
   }
   return out;
 }
+function folderDepth(filePath) {
+  if (/^(?:[a-z]:)?[\\/]/i.test(filePath)) return 0;
+  let depth = 0;
+  for (const segment of filePath.split(/[\\/]/).slice(0, -1)) {
+    if (segment === "..") depth = Math.max(0, depth - 1);
+    else if (segment && segment !== ".") depth += 1;
+  }
+  return depth;
+}
+function climbsAboveRoot(fileDepth, path) {
+  let depth = fileDepth;
+  for (const segment of path.split("/")) {
+    if (segment === "..") depth -= 1;
+    else if (segment && segment !== ".") depth += 1;
+    if (depth < 0) return true;
+  }
+  return false;
+}
 function extractCssSelectors(css) {
   const out = [];
   const noComments = css.replace(/\/\*[\s\S]*?\*\//g, "");
@@ -6644,42 +6665,31 @@ var compositionRules = [
     }
     return findings;
   },
-  // invalid_parent_traversal_in_asset_path — catches `../` traversal in src,
-  // href, inline-style url(), and <style> url() asset references on
-  // compositions. Sub-compositions live under compositions/ but are served
-  // with the project root as their base URL, so any `../`-traversing path
-  // climbs above the project root and 404s in Studio preview. Renders
-  // tolerate it because the server-side bundler rewrites `../foo` against
-  // each sub-composition's source path; the runtime now mirrors that fallback
-  // (see rewriteSubCompositionAssetPaths in runtime/compositionLoader.ts), but
-  // the authoring-time signal is still wrong — flag it at lint time so the
-  // baked path is plain root-relative and matches what the bundler emits.
-  //
-  // Mirrors the runtime fallback's surface: `[src]` / `[href]` attribute
-  // values, `[style]` inline url(), and `<style>` block url() references.
-  // Skips absolute URLs (http(s)://, //, data:, /-prefixed root-relative),
-  // hash anchors, and plain relative paths (`assets/x.mp4`) — only `../`
-  // traversal is flagged. Subsumes the older `../capture/`-specific rule.
+  // invalid_parent_traversal_in_asset_path — a `../` path in src, href or a CSS url() that leaves
+  // the project once resolved from the file's own folder, as the bundler, producer and runtime
+  // resolve it. "../assets/x" from compositions/ stays inside and passes.
   // fallow-ignore-next-line complexity
   ({ tags, styles, rawSource, options }) => {
     if (isRegistrySourceFile(options.filePath) || isRegistryInstalledFile(rawSource)) return [];
     const offenders = [];
-    const collect = (value) => {
-      if (!value) return;
-      const trimmed = value.trim();
-      if (!trimmed.startsWith("../") && trimmed !== "..") return;
-      offenders.push(trimmed);
+    const fileDepth = folderDepth(options.compSrcPath ?? "index.html");
+    const collect = (value, depth = fileDepth) => {
+      const trimmed = value?.trim() ?? "";
+      if (/^(?:[a-z][a-z0-9+.-]*:|[\\/#])/i.test(trimmed)) return;
+      const path = (trimmed.split(/[?#]/, 1)[0] ?? "").replace(/\\|%2f/gi, "/").replace(/%2e/gi, ".");
+      if (climbsAboveRoot(depth, path)) offenders.push(trimmed);
     };
     for (const tag of tags) {
-      collect(readAttr(tag.raw, "src"));
-      collect(readAttr(tag.raw, "href"));
+      collect(readDecodedAttr(tag.raw, "src"));
+      collect(readDecodedAttr(tag.raw, "href"));
       const styleAttr = readJsonAttr(tag.raw, "style");
       if (styleAttr) {
         for (const url of extractCssUrlReferences(styleAttr)) collect(url);
       }
     }
     for (const style of styles) {
-      for (const url of extractCssUrlReferences(style.content)) collect(url);
+      const depth = style.rootRelativePath ? folderDepth(style.rootRelativePath) : fileDepth;
+      for (const url of extractCssUrlReferences(style.content)) collect(url, depth);
     }
     if (offenders.length === 0) return [];
     const prefixCounts = /* @__PURE__ */ new Map();
@@ -6692,8 +6702,8 @@ var compositionRules = [
       {
         code: "invalid_parent_traversal_in_asset_path",
         severity: "error",
-        message: `Found ${offenders.length} asset path(s) traversing above the project root with "../" (${prefixSummary}). Renders rewrite this against each sub-composition's source path, but Studio preview and other live consumers resolve against the project root and 404.`,
-        fixHint: 'Use plain root-relative paths (e.g. "assets/...", "capture/...", "fonts/...") \u2014 compositions are served with the project root as their base URL, so paths must be root-relative, not relative to the compositions/ directory.'
+        message: `Found ${offenders.length} asset path(s) traversing above the project root with "../" (${prefixSummary}), resolved from the folder of the file that holds them. Render and preview clamp them to the project root or resolve them outside it, so they load a different file than written, or none.`,
+        fixHint: `Point the path at a file inside the project: from compositions/scene.html, "../assets/x.png" and "assets/x.png" both reach the project's assets folder.`
       }
     ];
   },
@@ -10403,7 +10413,7 @@ function collectExternalStyles(projectDir, html, compSrcPath) {
     document,
     compSrcPath
   )) {
-    styles.push({ href, content, file: join2(projectDir, rootRelativePath) });
+    styles.push({ href, content, file: join2(projectDir, rootRelativePath), rootRelativePath });
   }
   return styles;
 }
@@ -10455,6 +10465,7 @@ async function lintProject(projectDir, entryFile, hostOptions = {}) {
   const rootResult = await lintHyperframeHtml(rootHtml, {
     ...hostOptions,
     filePath: indexPath,
+    compSrcPath: rootFile,
     externalStyles: collectExternalStyles(projectDir, rootHtml, rootCompSrcPath)
   });
   results.push({ file: rootFile, result: rootResult, contentHash: contentDigest(rootHtml) });
@@ -10488,6 +10499,7 @@ async function lintProject(projectDir, entryFile, hostOptions = {}) {
         ...hostOptions,
         filePath,
         isSubComposition: true,
+        compSrcPath,
         externalStyles: collectExternalStyles(projectDir, html, compSrcPath)
       });
       results.push({

package/dist/{chunk-PAGIICKN.js → chunk-IHTRYDFN.js}

@@ -14,7 +14,7 @@ import {
 } from "./chunk-AWDFDFI3.js";
 import {
   isBlockedNetworkHost
-} from "./chunk-33RZPZ4K.js";
+} from "./chunk-UXO2L7HJ.js";
 import {
   DOMParser,
   parseHTML

package/dist/chunk-IR35BCLK.js

@@ -0,0 +1,13 @@
+import { createRequire as __hf_createRequire } from "node:module";
+import { fileURLToPath as __hf_fileURLToPath } from "node:url";
+import { dirname as __hf_dirname } from "node:path";
+var require = __hf_createRequire(import.meta.url);
+var __filename = __hf_fileURLToPath(import.meta.url);
+var __dirname = __hf_dirname(__filename);
+
+// src/whisper/transcriptFile.ts
+var TRANSCRIPT_FILE = "transcript.json";
+
+export {
+  TRANSCRIPT_FILE
+};

package/dist/{chunk-KDPYVTEU.js → chunk-KBB4RG6F.js}

@@ -4,6 +4,9 @@ import { dirname as __hf_dirname } from "node:path";
 var require = __hf_createRequire(import.meta.url);
 var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
+import {
+  TRANSCRIPT_FILE
+} from "./chunk-IR35BCLK.js";
 
 // src/whisper/parakeet.ts
 import { execFileSync } from "child_process";
@@ -11,6 +14,7 @@ import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync
 import { homedir, tmpdir } from "os";
 import { basename, extname, join } from "path";
 var PARAKEET_MODEL_LABEL = "parakeet-tdt-0.6b-v3";
+var PARAKEET_INSTALL_COMMAND = "hyperframes models install parakeet";
 var SHERPA_RESULT_PREFIX = "HYPERFRAMES_PARAKEET_RESULT:";
 var SHERPA_ERROR_PREFIX = "HYPERFRAMES_PARAKEET_ERROR:";
 var SHERPA_WINDOW_PREFIX = "HYPERFRAMES_PARAKEET_WINDOW:";
@@ -204,7 +208,7 @@ function transcribeWithParakeet(inputPath, dir, options) {
 }
 function writeParakeetTranscript(dir, words) {
   mkdirSync(dir, { recursive: true });
-  const transcriptPath = join(dir, "transcript.json");
+  const transcriptPath = join(dir, TRANSCRIPT_FILE);
   writeFileSync(transcriptPath, JSON.stringify(words, null, 2));
   const durationSeconds = words.length > 0 ? words[words.length - 1].end : 0;
   return {
@@ -219,6 +223,7 @@ function writeParakeetTranscript(dir, words) {
 
 export {
   PARAKEET_MODEL_LABEL,
+  PARAKEET_INSTALL_COMMAND,
   SHERPA_RESULT_PREFIX,
   SHERPA_ERROR_PREFIX,
   SHERPA_WINDOW_PREFIX,

package/dist/{chunk-ZQQ3SEIE.js → chunk-KIFHYXPB.js}

@@ -9,7 +9,7 @@ import {
   formatPreviewProxyBox,
   hdrToSdrToneMapFilter,
   parseFirstFrameColour
-} from "./chunk-4M4EC7JX.js";
+} from "./chunk-VRW6EBHV.js";
 import {
   decodeAuthoredAttribute,
   scanHtmlOpeningTags
@@ -30,7 +30,7 @@ import {
 } from "./chunk-PJ3HDUCY.js";
 import {
   rewriteAssetPath
-} from "./chunk-ZLW2V65P.js";
+} from "./chunk-BSQ7XANM.js";
 
 // ../studio-server/dist/chunk-RN33UALN.js
 import { statSync } from "fs";
@@ -336,7 +336,7 @@ async function scanProjectMediaCodecMap(projectDir, htmlSources, options = {}) {
   return map;
 }
 
-// ../studio-server/dist/chunk-6EFY2WPN.js
+// ../studio-server/dist/chunk-2VZGTTEG.js
 import { spawn } from "child_process";
 import { createHash, randomUUID } from "crypto";
 import { existsSync as existsSync2, renameSync, statSync as statSync2, unlinkSync as unlinkSync2, utimesSync } from "fs";
@@ -547,31 +547,67 @@ function getCanonicalProxyCachePath(source, variant, box) {
     `${key}${PROXY_VARIANT_CONFIG[variant].extension}`
   );
 }
+var ProxyDroppedError = class extends ProxyTranscodeError {
+  constructor() {
+    super("media proxy copy dropped: every caller left before it started", null, "");
+    this.name = "ProxyDroppedError";
+  }
+};
 var activeTranscodes = 0;
 var waitQueue = [];
-function acquireSlot() {
+function enqueue(job) {
+  const firstNormal = job.priority ? waitQueue.findIndex((queued) => !queued.priority) : -1;
+  if (firstNormal === -1) waitQueue.push(job);
+  else waitQueue.splice(firstNormal, 0, job);
+}
+function dequeue(job) {
+  const index = waitQueue.indexOf(job);
+  if (index !== -1) waitQueue.splice(index, 1);
+}
+function acquireSlot(job) {
+  if (activeTranscodes < MAX_CONCURRENT_TRANSCODES) {
+    activeTranscodes++;
+    return Promise.resolve();
+  }
   return new Promise((resolveSlot, reject) => {
-    const tryAcquire = () => {
-      if (activeTranscodes < MAX_CONCURRENT_TRANSCODES) {
+    job.queued = {
+      start: () => {
+        job.queued = void 0;
         activeTranscodes++;
         resolveSlot();
-      } else {
-        if (waitQueue.length >= MAX_QUEUED_TRANSCODES) {
-          reject(new ProxyCapacityError());
-          return;
-        }
-        waitQueue.push(tryAcquire);
+      },
+      drop: () => {
+        job.queued = void 0;
+        dequeue(job);
+        forget(job);
+        reject(new ProxyDroppedError());
       }
     };
-    tryAcquire();
+    enqueue(job);
   });
 }
+function queueIsFull() {
+  return activeTranscodes >= MAX_CONCURRENT_TRANSCODES && waitQueue.length >= MAX_QUEUED_TRANSCODES;
+}
 function releaseSlot() {
   activeTranscodes--;
-  const next = waitQueue.shift();
-  if (next) next();
+  waitQueue.shift()?.queued?.start();
+}
+function prioritize(job) {
+  if (job.priority) return;
+  job.priority = true;
+  if (!job.queued) return;
+  dequeue(job);
+  enqueue(job);
+}
+function leave(job) {
+  job.callers--;
+  if (job.callers === 0) job.queued?.drop();
 }
 var inFlight = /* @__PURE__ */ new Map();
+function forget(job) {
+  if (inFlight.get(job.cachePath)?.job === job) inFlight.delete(job.cachePath);
+}
 function maintainProxyCache(cacheDir) {
   try {
     cleanupProxyCache(cacheDir, { protectedPaths: new Set(inFlight.keys()) });
@@ -730,8 +766,8 @@ async function runFfmpeg(sourcePath, outputPath, variant, box) {
     });
   });
 }
-async function transcodeToCache(projectDir, absoluteSourcePath, cachePath, variant, box) {
-  await acquireSlot();
+async function transcodeToCache(job, projectDir, absoluteSourcePath, cachePath, variant, box) {
+  await acquireSlot(job);
   try {
     if (existsSync2(cachePath)) return cachePath;
     const cacheDir = dirname(cachePath);
@@ -749,14 +785,15 @@ async function transcodeToCache(projectDir, absoluteSourcePath, cachePath, varia
     releaseSlot();
   }
 }
-var settledProxyCount = 0;
+var proxyActivity = 0;
 function proxyActivityMark(projectDir) {
-  if (!existsSync2(projectDir)) return String(settledProxyCount);
+  if (!existsSync2(projectDir)) return String(proxyActivity);
   const cacheDir = join2(realpath(projectDir), CACHE_DIR_NAME) + sep2;
   for (const cachePath of inFlight.keys()) if (cachePath.startsWith(cacheDir)) return null;
-  return String(settledProxyCount);
+  return String(proxyActivity);
 }
-async function resolveProxy(projectDir, absoluteSourcePath, variant = "h264", box) {
+async function resolveProxy(projectDir, absoluteSourcePath, variant = "h264", box, options = {}) {
+  options.signal?.throwIfAborted();
   const source = canonicalizeProxySource(projectDir, absoluteSourcePath);
   const cachePath = getCanonicalProxyCachePath(source, variant, box);
   if (existsSync2(cachePath)) {
@@ -769,17 +806,48 @@ async function resolveProxy(projectDir, absoluteSourcePath, variant = "h264", bo
     if (rememberedFailure.expiresAt > Date.now()) throw rememberedFailure.error;
     failedTranscodes.delete(cachePath);
   }
-  const existing = inFlight.get(cachePath);
-  if (existing) return existing;
-  const promise = transcodeToCache(source.projectDir, source.sourcePath, cachePath, variant, box).catch((err) => {
-    if (!(err instanceof ProxyCapacityError)) rememberFailure(cachePath, err);
-    throw err;
-  }).finally(() => {
-    inFlight.delete(cachePath);
-    settledProxyCount += 1;
+  let entry = inFlight.get(cachePath);
+  if (!entry) {
+    if (!options.priority && queueIsFull()) {
+      proxyActivity += 1;
+      throw new ProxyCapacityError();
+    }
+    const job = {
+      cachePath,
+      priority: options.priority === true,
+      callers: 0
+    };
+    const promise = transcodeToCache(
+      job,
+      source.projectDir,
+      source.sourcePath,
+      cachePath,
+      variant,
+      box
+    ).catch((err) => {
+      if (!(err instanceof ProxyDroppedError)) rememberFailure(cachePath, err);
+      throw err;
+    }).finally(() => {
+      forget(job);
+      proxyActivity += 1;
+    });
+    entry = { promise, job };
+    inFlight.set(cachePath, entry);
+  }
+  if (options.priority) prioritize(entry.job);
+  return joinJob(entry.promise, entry.job, options.signal);
+}
+function joinJob(promise, job, signal) {
+  job.callers++;
+  if (!signal) return promise;
+  return new Promise((resolveJoin, rejectJoin) => {
+    const onAbort = () => {
+      leave(job);
+      rejectJoin(signal.reason);
+    };
+    signal.addEventListener("abort", onAbort, { once: true });
+    promise.finally(() => signal.removeEventListener("abort", onAbort)).then(resolveJoin, rejectJoin);
   });
-  inFlight.set(cachePath, promise);
-  return promise;
 }
 
 export {

package/dist/{chunk-TAMQYQGJ.js → chunk-LAFJSYDL.js}

@@ -27,7 +27,7 @@ import {
 } from "./chunk-GMECXFAN.js";
 import {
   ITEM_TYPE_DIRS
-} from "./chunk-4M4EC7JX.js";
+} from "./chunk-VRW6EBHV.js";
 import {
   realProjectRoot
 } from "./chunk-OFQWTKPW.js";