@hyperframes/studio-server 0.7.61 → 0.7.62

package/dist/{chunk-LVXVG4V6.js → chunk-7Q5AFHU6.js}

@@ -143,7 +143,7 @@ var BROWSER_HOSTILE_CODECS = {
 };
 var PROXY_VARIANT_CONFIG = {
   h264: { extension: ".mp4", contentType: "video/mp4" },
-  vp9: { extension: ".webm", contentType: "video/webm" }
+  vp8: { extension: ".webm", contentType: "video/webm" }
 };
 function isProxyVariant(value) {
   return Object.hasOwn(PROXY_VARIANT_CONFIG, value);
@@ -152,7 +152,7 @@ function isProxyVariantRequest(value) {
   return value === "auto" || isProxyVariant(value);
 }
 function proxyVariantFor(facts) {
-  return facts.hasAlpha ? "vp9" : "h264";
+  return facts.hasAlpha ? "vp8" : "h264";
 }
 function resolveProxyVariantRequest(request, facts) {
   const expected = proxyVariantFor(facts);
@@ -161,9 +161,6 @@ function resolveProxyVariantRequest(request, facts) {
 function decideMediaProxyEligibility(facts) {
   if (!facts) return { eligible: false, reason: "unknown_codec" };
   if (!facts.browserHostile) return { eligible: false, reason: "browser_safe_codec" };
-  if (facts.hasAlpha && facts.codecName === "vp9") {
-    return { eligible: false, reason: "proxy_target_codec" };
-  }
   return { eligible: true };
 }
 function codecFactsFor(codecName, hasAlpha) {
@@ -279,4 +276,4 @@ export {
   createMediaCodecProbeCache,
   scanProjectMediaCodecMap
 };
-//# sourceMappingURL=chunk-LVXVG4V6.js.map
+//# sourceMappingURL=chunk-7Q5AFHU6.js.map

package/dist/chunk-7Q5AFHU6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/helpers/mediaCodecMap.ts","../src/helpers/mediaMetadata.ts"],"sourcesContent":["import { existsSync, statSync } from \"node:fs\";\nimport { relative, resolve, sep } from \"node:path\";\nimport { rewriteAssetPath } from \"@hyperframes/parsers/asset-paths\";\nimport {\n  cleanAssetUrl,\n  isRemoteOrInlineUrl,\n  maskNonScannableRanges,\n  resolveLocalAssetCandidates,\n} from \"@hyperframes/parsers/asset-resolution\";\nimport { pixelFormatHasAlpha, probeMediaMetadata, type FfprobeRunner } from \"./mediaMetadata.js\";\n\n/**\n * One reusable answer to \"what codec is this asset, and is it browser-hostile?\",\n * built on top of `mediaMetadata.ts`'s ffprobe-backed prober so studio-server\n * probes each asset once instead of running a second prober.\n */\n\nexport interface AssetCodecFacts {\n  codecName: string;\n  browserHostile: boolean;\n  /** Coarse `canPlayType()` input; `null` when not applicable (safe codec) or\n   * when no representative mime exists (ProRes: browsers never decode it, so\n   * the runtime always proxies rather than probing `canPlayType`). */\n  representativeMime: string | null;\n  /** Source carries an alpha channel (ffprobe pix_fmt). Alpha sources use a\n   * VP8/WebM proxy so their transparency is preserved across Chromium builds. */\n  hasAlpha: boolean;\n}\n\n/** Server-root-relative URL pathname -> that asset's codec facts. */\nexport type MediaCodecMap = Record<string, AssetCodecFacts>;\n\n/**\n * Browser-hostile codec table v1. One exported constant so extending it is a\n * one-line change. `ffprobe` cannot emit exact RFC 6381 codec strings, so\n * these `representativeMime` values are deliberately coarse (a false\n * positive costs one proxy transcode, never correctness; a false negative is\n * rescued by the runtime's reactive zero-videoWidth swap).\n */\nexport const BROWSER_HOSTILE_CODECS: Record<string, string | null> = {\n  hevc: 'video/mp4; codecs=\"hvc1.1.6.L120.B0\"',\n  prores: null,\n  av1: 'video/mp4; codecs=\"av01.0.08M.08\"',\n  // VP9 is browser-dependent: Chrome generally decodes it while Safari\n  // support varies. Treat it as conditional so canPlayType keeps the\n  // original where supported and transparently proxies it where unsupported.\n  vp9: 'video/webm; codecs=\"vp09.00.10.08\"',\n};\n\nexport type ProxyVariant = \"h264\" | \"vp8\";\nexport type ProxyVariantRequest = ProxyVariant | \"auto\";\n\nexport const PROXY_VARIANT_CONFIG: Record<\n  ProxyVariant,\n  { extension: \".mp4\" | \".webm\"; contentType: \"video/mp4\" | \"video/webm\" }\n> = {\n  h264: { extension: \".mp4\", contentType: \"video/mp4\" },\n  vp8: { extension: \".webm\", contentType: \"video/webm\" },\n};\n\nexport function isProxyVariant(value: string): value is ProxyVariant {\n  return Object.hasOwn(PROXY_VARIANT_CONFIG, value);\n}\n\nexport function isProxyVariantRequest(value: string): value is ProxyVariantRequest {\n  return value === \"auto\" || isProxyVariant(value);\n}\n\nexport function proxyVariantFor(facts: AssetCodecFacts): ProxyVariant {\n  return facts.hasAlpha ? \"vp8\" : \"h264\";\n}\n\nexport function resolveProxyVariantRequest(\n  request: ProxyVariantRequest,\n  facts: AssetCodecFacts,\n): ProxyVariant | null {\n  const expected = proxyVariantFor(facts);\n  return request === \"auto\" || request === expected ? expected : null;\n}\n\nexport type MediaProxyIneligibilityReason = \"browser_safe_codec\" | \"unknown_codec\";\n\nexport type MediaProxyEligibility =\n  | { eligible: true }\n  | { eligible: false; reason: MediaProxyIneligibilityReason };\n\n/** Single policy gate shared by proactive scans and on-demand proxy routes. */\nexport function decideMediaProxyEligibility(facts: AssetCodecFacts | null): MediaProxyEligibility {\n  if (!facts) return { eligible: false, reason: \"unknown_codec\" };\n  if (!facts.browserHostile) return { eligible: false, reason: \"browser_safe_codec\" };\n  return { eligible: true };\n}\n\nfunction codecFactsFor(codecName: string, hasAlpha: boolean): AssetCodecFacts {\n  const isHostile = Object.hasOwn(BROWSER_HOSTILE_CODECS, codecName);\n  return {\n    codecName,\n    browserHostile: isHostile,\n    representativeMime: isHostile ? (BROWSER_HOSTILE_CODECS[codecName] ?? null) : null,\n    hasAlpha,\n  };\n}\n\n/**\n * Probe a single video asset. Best-effort: ffprobe missing, erroring, or\n * finding no video stream resolves to `null` (asset omitted by the caller),\n * never a throw. Async so a pool of probes runs concurrently (the default\n * runner is `execFile`-based).\n */\nexport async function probeAssetCodec(\n  filePath: string,\n  runner?: FfprobeRunner,\n): Promise<AssetCodecFacts | null> {\n  const metadata = runner\n    ? await probeMediaMetadata(filePath, runner)\n    : await probeMediaMetadata(filePath);\n  if (metadata.kind !== \"video\" || metadata.probeError) return null;\n  const codecName = metadata.color.codecName;\n  if (!codecName) return null;\n  return codecFactsFor(codecName, pixelFormatHasAlpha(metadata.color.pixelFormat));\n}\n\ninterface CachedAssetProbe {\n  mtimeMs: number;\n  size: number;\n  facts: AssetCodecFacts | null;\n}\n\n/** Per (path, mtime) probe cache. Construct one per project/server lifetime\n * and reuse it across scans; a fresh instance defeats the caching benefit. */\nexport type MediaCodecProbeCache = Map<string, CachedAssetProbe>;\n\nexport function createMediaCodecProbeCache(): MediaCodecProbeCache {\n  return new Map();\n}\n\n// Used when a caller doesn't pass its own cache — still correct (probes every\n// time a fresh Map would), but callers that want the mtime-cache benefit\n// across repeated scans (the studio preview route, etc.) should construct\n// and hold their own cache via `createMediaCodecProbeCache`.\nconst defaultProbeCache: MediaCodecProbeCache = new Map();\nconst MAX_PROBE_CACHE_ENTRIES = 512;\n\nfunction rememberProbeResult(\n  cache: MediaCodecProbeCache,\n  filePath: string,\n  result: CachedAssetProbe,\n): void {\n  if (!cache.has(filePath) && cache.size >= MAX_PROBE_CACHE_ENTRIES) {\n    const oldest = cache.keys().next().value;\n    if (oldest) cache.delete(oldest);\n  }\n  // Refresh insertion order so frequently used assets remain resident.\n  cache.delete(filePath);\n  cache.set(filePath, result);\n}\n\nasync function probeAssetCodecCached(\n  filePath: string,\n  cache: MediaCodecProbeCache,\n  runner?: FfprobeRunner,\n): Promise<AssetCodecFacts | null> {\n  let stat: ReturnType<typeof statSync>;\n  try {\n    stat = statSync(filePath);\n  } catch {\n    return null;\n  }\n  const cached = cache.get(filePath);\n  if (cached && cached.mtimeMs === stat.mtimeMs && cached.size === stat.size) {\n    rememberProbeResult(cache, filePath, cached);\n    return cached.facts;\n  }\n  const facts = await probeAssetCodec(filePath, runner);\n  rememberProbeResult(cache, filePath, { mtimeMs: stat.mtimeMs, size: stat.size, facts });\n  return facts;\n}\n\n/** Structurally compatible with `packages/lint/src/hevcPreviewLint.ts`'s\n * (unexported) `HtmlSourceLike`. */\nexport interface HtmlSourceLike {\n  html: string;\n  compSrcPath?: string;\n}\n\n// --- <video src> collection: shared primitives live in\n// @hyperframes/parsers/asset-resolution; the <video>-specific regex and the\n// pinned key derivation stay here.\nconst VIDEO_SRC_RE = /<video\\b[^>]*\\bsrc\\s*=\\s*[\"']([^\"']+)[\"'][^>]*>/gi;\n\n/**\n * Resolve a `<video src>` reference to an existing local file.\n *\n * `rootRelativePathname` is the map key format PINNED by this plan's Key\n * Technical Decisions: project-root-relative URL pathname, percent-decoded,\n * query-string-stripped, forward-slash separated, leading-slash prefixed\n * (e.g. \"/assets/videos/clip.mp4\"). This must match what the runtime derives\n * via `new URL(el.currentSrc || el.src, document.baseURI).pathname`, because\n * server-side scanning resolves filesystem paths while the DOM sees served\n * URLs — a documented prior source of this exact class of bug.\n */\nfunction resolveExistingLocalAsset(\n  projectDir: string,\n  url: string,\n): { resolvedPath: string; rootRelativePathname: string } | null {\n  const projectRoot = resolve(projectDir);\n  const resolvedPath = resolveLocalAssetCandidates(projectRoot, url).find((candidate) =>\n    existsSync(candidate),\n  );\n  if (!resolvedPath) return null;\n  const rootRelative = relative(projectRoot, resolvedPath).split(sep).join(\"/\");\n  return { resolvedPath, rootRelativePathname: `/${rootRelative}` };\n}\n\n/**\n * Collects local `<video src>` references, resolved to their absolute path\n * and deduped by that path, keyed by the pinned root-relative URL pathname.\n */\n// fallow-ignore-next-line complexity\nfunction collectLocalVideoAssets(\n  projectDir: string,\n  htmlSources: HtmlSourceLike[],\n): Map<string, string> {\n  const candidates = new Map<string, string>();\n\n  for (const { html, compSrcPath } of htmlSources) {\n    const scannable = maskNonScannableRanges(html);\n    const re = new RegExp(VIDEO_SRC_RE.source, VIDEO_SRC_RE.flags);\n    let match: RegExpExecArray | null;\n    while ((match = re.exec(scannable)) !== null) {\n      const src = cleanAssetUrl(match[1] ?? \"\");\n      if (!src || isRemoteOrInlineUrl(src)) continue;\n      if (/^__[A-Z_]+__$/.test(src)) continue;\n      const rootRelativeSrc = compSrcPath ? rewriteAssetPath(compSrcPath, src) : src;\n      const resolved = resolveExistingLocalAsset(projectDir, rootRelativeSrc);\n      if (!resolved) continue;\n      candidates.set(resolved.resolvedPath, resolved.rootRelativePathname);\n    }\n  }\n\n  return candidates;\n}\n\n// Bounds concurrent ffprobe child processes for projects referencing many\n// videos, mirroring `PROBE_CONCURRENCY` in `hevcPreviewLint.ts`.\nconst PROBE_CONCURRENCY = 8;\n\nexport interface ScanProjectMediaCodecMapOptions {\n  /** Persisted across calls by the caller for the mtime-cache benefit;\n   * defaults to a shared module-level cache when omitted. */\n  cache?: MediaCodecProbeCache;\n  runner?: FfprobeRunner;\n}\n\n/**\n * Scans a project's composition HTML for local `<video src>` references and\n * returns the injection map: root-relative URL pathname -> codec facts.\n * Best-effort throughout — a video whose codec can't be determined (missing\n * ffprobe, probe error, no video stream) is simply omitted, never thrown.\n */\nexport async function scanProjectMediaCodecMap(\n  projectDir: string,\n  htmlSources: HtmlSourceLike[],\n  options: ScanProjectMediaCodecMapOptions = {},\n): Promise<MediaCodecMap> {\n  const candidates = collectLocalVideoAssets(projectDir, htmlSources);\n  if (candidates.size === 0) return {};\n\n  const cache = options.cache ?? defaultProbeCache;\n  const entries = [...candidates.entries()]; // [resolvedPath, rootRelativePathname]\n  const facts = new Array<AssetCodecFacts | null>(entries.length).fill(null);\n  let nextIndex = 0;\n  const workerCount = Math.min(PROBE_CONCURRENCY, entries.length);\n  await Promise.all(\n    Array.from({ length: workerCount }, async () => {\n      while (nextIndex < entries.length) {\n        const index = nextIndex++;\n        const entry = entries[index];\n        if (!entry) break;\n        facts[index] = await probeAssetCodecCached(entry[0], cache, options.runner);\n      }\n    }),\n  );\n\n  const map: MediaCodecMap = {};\n  entries.forEach(([, pathname], index) => {\n    const entryFacts = facts[index];\n    if (entryFacts?.browserHostile) map[pathname] = entryFacts;\n  });\n  return map;\n}\n","import { execFile } from \"node:child_process\";\nimport { extname } from \"node:path\";\nimport { findFfBinary } from \"@hyperframes/parsers/ff-binaries\";\n\nexport interface FfprobeRunResult {\n  status: number | null;\n  stdout: string | Buffer;\n  stderr: string | Buffer;\n  /** Spawn-level failure (covers both `NodeJS.ErrnoException` and\n   * `ExecFileException`); only `code === \"ENOENT\"` is ever inspected. */\n  error?: { code?: string | number | null | undefined };\n}\n\n/** Injectable ffprobe runner. May be synchronous (tests) or async (the\n * default `execFile`-based runner below), so cold scans can run many probes\n * concurrently off the event loop. */\nexport type FfprobeRunner = (\n  command: string,\n  args: string[],\n  options?: { timeout?: number; maxBuffer?: number },\n) => FfprobeRunResult | Promise<FfprobeRunResult>;\n\n/** Default runner: genuinely async (`execFile`), unlike the previous\n * `spawnSync`-based one — a pool of concurrent probes actually parallelizes\n * (mirrors `execFileAsync` in packages/lint/src/hevcPreviewLint.ts). */\nconst execFileRunner: FfprobeRunner = (command, args, options) =>\n  new Promise<FfprobeRunResult>((resolvePromise) => {\n    execFile(\n      command,\n      args,\n      { timeout: options?.timeout, maxBuffer: options?.maxBuffer },\n      (error, stdout, stderr) => {\n        if (error && error.code === \"ENOENT\") {\n          resolvePromise({ status: null, stdout: \"\", stderr: \"\", error });\n          return;\n        }\n        if (error) {\n          // Nonzero exit / timeout / kill: report a nonzero status; callers\n          // only distinguish \"ok\" (0) from \"failed\" from \"ENOENT\".\n          const status = typeof error.code === \"number\" ? error.code : 1;\n          resolvePromise({ status, stdout: stdout ?? \"\", stderr: stderr ?? \"\" });\n          return;\n        }\n        resolvePromise({ status: 0, stdout: stdout ?? \"\", stderr: stderr ?? \"\" });\n      },\n    );\n  });\n\nexport type MediaDynamicRange = \"hdr\" | \"sdr\" | \"unknown\";\nexport type MediaHdrTransfer = \"pq\" | \"hlg\" | \"unknown\";\n\nexport interface MediaColorMetadata {\n  dynamicRange: MediaDynamicRange;\n  hdrTransfer: MediaHdrTransfer | null;\n  label: string;\n  isHdr: boolean;\n  codecName?: string;\n  profile?: string;\n  pixelFormat?: string;\n  colorSpace?: string;\n  colorTransfer?: string;\n  colorPrimaries?: string;\n  bitsPerRawSample?: string;\n}\n\nexport interface MediaMetadata {\n  kind: \"video\" | \"image\" | \"audio\" | \"unknown\";\n  color: MediaColorMetadata;\n  probeError?: string;\n}\n\ninterface FfprobeStream {\n  codec_type?: string;\n  codec_name?: string;\n  profile?: string;\n  pix_fmt?: string;\n  color_space?: string;\n  color_transfer?: string;\n  color_primaries?: string;\n  bits_per_raw_sample?: string;\n  disposition?: { attached_pic?: number };\n}\n\nconst VIDEO_EXT = new Set([\n  \".mp4\",\n  \".mov\",\n  \".webm\",\n  \".mkv\",\n  \".avi\",\n  \".m4v\",\n  \".mxf\",\n  \".mts\",\n  \".m2ts\",\n  \".ts\",\n]);\nconst IMAGE_EXT = new Set([\".jpg\", \".jpeg\", \".png\", \".webp\", \".avif\"]);\nconst AUDIO_EXT = new Set([\".mp3\", \".wav\", \".ogg\", \".m4a\", \".aac\"]);\n\nfunction lower(value: string | undefined): string {\n  return value?.toLowerCase() ?? \"\";\n}\n\nfunction inferKindFromPath(path: string): MediaMetadata[\"kind\"] {\n  const ext = extname(path).toLowerCase();\n  if (VIDEO_EXT.has(ext)) return \"video\";\n  if (IMAGE_EXT.has(ext)) return \"image\";\n  if (AUDIO_EXT.has(ext)) return \"audio\";\n  return \"unknown\";\n}\n\nfunction colorLabel(input: {\n  isHdr: boolean;\n  hdrTransfer: MediaHdrTransfer | null;\n  colorPrimaries: string;\n  colorSpace: string;\n  colorTransfer: string;\n}): string {\n  if (input.isHdr) {\n    if (input.hdrTransfer === \"pq\") return \"HDR PQ\";\n    if (input.hdrTransfer === \"hlg\") return \"HDR HLG\";\n    return \"HDR\";\n  }\n  if (\n    input.colorPrimaries.includes(\"bt709\") ||\n    input.colorSpace.includes(\"bt709\") ||\n    input.colorTransfer.includes(\"bt709\")\n  ) {\n    return \"SDR Rec.709\";\n  }\n  return \"SDR/unknown\";\n}\n\n// Conservative alpha-bearing pix_fmt list: yuva* (yuva420p, yuva444p10le...),\n// rgba/argb/bgra/abgr (packed RGB+alpha), gbrap* (planar GBR+alpha, ProRes\n// 4444 decodes to these), ya* (gray+alpha). Prefix match keeps bit-depth /\n// endianness suffixes covered.\nconst ALPHA_PIX_FMT_RE = /^(?:yuva|rgba|argb|bgra|abgr|gbrap|ya)/;\n\n/** True when an ffprobe `pix_fmt` carries an alpha component. */\nexport function pixelFormatHasAlpha(pixFmt: string | undefined): boolean {\n  return pixFmt !== undefined && ALPHA_PIX_FMT_RE.test(pixFmt.toLowerCase());\n}\n\nexport function classifyMediaColor(stream: FfprobeStream | null | undefined): MediaColorMetadata {\n  const colorPrimaries = lower(stream?.color_primaries);\n  const colorSpace = lower(stream?.color_space);\n  const colorTransfer = lower(stream?.color_transfer);\n  const isHdr =\n    colorPrimaries.includes(\"bt2020\") ||\n    colorSpace.includes(\"bt2020\") ||\n    colorTransfer === \"smpte2084\" ||\n    colorTransfer === \"arib-std-b67\";\n  const hdrTransfer: MediaHdrTransfer | null = isHdr\n    ? colorTransfer === \"smpte2084\"\n      ? \"pq\"\n      : colorTransfer === \"arib-std-b67\"\n        ? \"hlg\"\n        : \"unknown\"\n    : null;\n\n  return {\n    dynamicRange: stream ? (isHdr ? \"hdr\" : \"sdr\") : \"unknown\",\n    hdrTransfer,\n    label: stream\n      ? colorLabel({ isHdr, hdrTransfer, colorPrimaries, colorSpace, colorTransfer })\n      : \"Unknown\",\n    isHdr,\n    codecName: stream?.codec_name,\n    profile: stream?.profile,\n    pixelFormat: stream?.pix_fmt,\n    colorSpace: stream?.color_space,\n    colorTransfer: stream?.color_transfer,\n    colorPrimaries: stream?.color_primaries,\n    bitsPerRawSample: stream?.bits_per_raw_sample,\n  };\n}\n\nexport async function probeMediaMetadata(\n  filePath: string,\n  runner: FfprobeRunner = execFileRunner,\n): Promise<MediaMetadata> {\n  const kind = inferKindFromPath(filePath);\n  if (kind === \"audio\" || kind === \"unknown\") {\n    return { kind, color: classifyMediaColor(null) };\n  }\n\n  // The default runner degrades a missing ffprobe to \"unavailable\" without\n  // spawning; injected runners own execution and receive the normal command.\n  const ffprobePath =\n    findFfBinary(\"ffprobe\", { configuredMustExist: true }) ??\n    (runner === execFileRunner ? undefined : \"ffprobe\");\n  if (!ffprobePath) {\n    return { kind, color: classifyMediaColor(null), probeError: \"ffprobe unavailable\" };\n  }\n\n  const result = await runner(\n    ffprobePath,\n    [\n      \"-v\",\n      \"error\",\n      \"-show_entries\",\n      \"stream=codec_type,codec_name,profile,pix_fmt,color_space,color_transfer,color_primaries,bits_per_raw_sample:stream_disposition=attached_pic\",\n      \"-of\",\n      \"json\",\n      filePath,\n    ],\n    { timeout: 15_000, maxBuffer: 1024 * 1024 },\n  );\n\n  if (result.error?.code === \"ENOENT\") {\n    return { kind, color: classifyMediaColor(null), probeError: \"ffprobe unavailable\" };\n  }\n  if (result.status !== 0) {\n    return { kind, color: classifyMediaColor(null), probeError: \"ffprobe failed\" };\n  }\n\n  try {\n    const parsed = JSON.parse(String(result.stdout || \"{}\")) as { streams?: FfprobeStream[] };\n    const stream = parsed.streams?.find((item) => {\n      if (kind === \"image\") return item.codec_type === \"video\";\n      return item.codec_type === kind && item.disposition?.attached_pic !== 1;\n    });\n    return { kind, color: classifyMediaColor(stream) };\n  } catch {\n    return { kind, color: classifyMediaColor(null), probeError: \"ffprobe returned invalid json\" };\n  }\n}\n"],"mappings":";AAAA,SAAS,YAAY,gBAAgB;AACrC,SAAS,UAAU,SAAS,WAAW;AACvC,SAAS,wBAAwB;AACjC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;;;ACRP,SAAS,gBAAgB;AACzB,SAAS,eAAe;AACxB,SAAS,oBAAoB;AAuB7B,IAAM,iBAAgC,CAAC,SAAS,MAAM,YACpD,IAAI,QAA0B,CAAC,mBAAmB;AAChD;AAAA,IACE;AAAA,IACA;AAAA,IACA,EAAE,SAAS,SAAS,SAAS,WAAW,SAAS,UAAU;AAAA,IAC3D,CAAC,OAAO,QAAQ,WAAW;AACzB,UAAI,SAAS,MAAM,SAAS,UAAU;AACpC,uBAAe,EAAE,QAAQ,MAAM,QAAQ,IAAI,QAAQ,IAAI,MAAM,CAAC;AAC9D;AAAA,MACF;AACA,UAAI,OAAO;AAGT,cAAM,SAAS,OAAO,MAAM,SAAS,WAAW,MAAM,OAAO;AAC7D,uBAAe,EAAE,QAAQ,QAAQ,UAAU,IAAI,QAAQ,UAAU,GAAG,CAAC;AACrE;AAAA,MACF;AACA,qBAAe,EAAE,QAAQ,GAAG,QAAQ,UAAU,IAAI,QAAQ,UAAU,GAAG,CAAC;AAAA,IAC1E;AAAA,EACF;AACF,CAAC;AAqCH,IAAM,YAAY,oBAAI,IAAI;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AACD,IAAM,YAAY,oBAAI,IAAI,CAAC,QAAQ,SAAS,QAAQ,SAAS,OAAO,CAAC;AACrE,IAAM,YAAY,oBAAI,IAAI,CAAC,QAAQ,QAAQ,QAAQ,QAAQ,MAAM,CAAC;AAElE,SAAS,MAAM,OAAmC;AAChD,SAAO,OAAO,YAAY,KAAK;AACjC;AAEA,SAAS,kBAAkB,MAAqC;AAC9D,QAAM,MAAM,QAAQ,IAAI,EAAE,YAAY;AACtC,MAAI,UAAU,IAAI,GAAG,EAAG,QAAO;AAC/B,MAAI,UAAU,IAAI,GAAG,EAAG,QAAO;AAC/B,MAAI,UAAU,IAAI,GAAG,EAAG,QAAO;AAC/B,SAAO;AACT;AAEA,SAAS,WAAW,OAMT;AACT,MAAI,MAAM,OAAO;AACf,QAAI,MAAM,gBAAgB,KAAM,QAAO;AACvC,QAAI,MAAM,gBAAgB,MAAO,QAAO;AACxC,WAAO;AAAA,EACT;AACA,MACE,MAAM,eAAe,SAAS,OAAO,KACrC,MAAM,WAAW,SAAS,OAAO,KACjC,MAAM,cAAc,SAAS,OAAO,GACpC;AACA,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAMA,IAAM,mBAAmB;AAGlB,SAAS,oBAAoB,QAAqC;AACvE,SAAO,WAAW,UAAa,iBAAiB,KAAK,OAAO,YAAY,CAAC;AAC3E;AAEO,SAAS,mBAAmB,QAA8D;AAC/F,QAAM,iBAAiB,MAAM,QAAQ,eAAe;AACpD,QAAM,aAAa,MAAM,QAAQ,WAAW;AAC5C,QAAM,gBAAgB,MAAM,QAAQ,cAAc;AAClD,QAAM,QACJ,eAAe,SAAS,QAAQ,KAChC,WAAW,SAAS,QAAQ,KAC5B,kBAAkB,eAClB,kBAAkB;AACpB,QAAM,cAAuC,QACzC,kBAAkB,cAChB,OACA,kBAAkB,iBAChB,QACA,YACJ;AAEJ,SAAO;AAAA,IACL,cAAc,SAAU,QAAQ,QAAQ,QAAS;AAAA,IACjD;AAAA,IACA,OAAO,SACH,WAAW,EAAE,OAAO,aAAa,gBAAgB,YAAY,cAAc,CAAC,IAC5E;AAAA,IACJ;AAAA,IACA,WAAW,QAAQ;AAAA,IACnB,SAAS,QAAQ;AAAA,IACjB,aAAa,QAAQ;AAAA,IACrB,YAAY,QAAQ;AAAA,IACpB,eAAe,QAAQ;AAAA,IACvB,gBAAgB,QAAQ;AAAA,IACxB,kBAAkB,QAAQ;AAAA,EAC5B;AACF;AAEA,eAAsB,mBACpB,UACA,SAAwB,gBACA;AACxB,QAAM,OAAO,kBAAkB,QAAQ;AACvC,MAAI,SAAS,WAAW,SAAS,WAAW;AAC1C,WAAO,EAAE,MAAM,OAAO,mBAAmB,IAAI,EAAE;AAAA,EACjD;AAIA,QAAM,cACJ,aAAa,WAAW,EAAE,qBAAqB,KAAK,CAAC,MACpD,WAAW,iBAAiB,SAAY;AAC3C,MAAI,CAAC,aAAa;AAChB,WAAO,EAAE,MAAM,OAAO,mBAAmB,IAAI,GAAG,YAAY,sBAAsB;AAAA,EACpF;AAEA,QAAM,SAAS,MAAM;AAAA,IACnB;AAAA,IACA;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,EAAE,SAAS,MAAQ,WAAW,OAAO,KAAK;AAAA,EAC5C;AAEA,MAAI,OAAO,OAAO,SAAS,UAAU;AACnC,WAAO,EAAE,MAAM,OAAO,mBAAmB,IAAI,GAAG,YAAY,sBAAsB;AAAA,EACpF;AACA,MAAI,OAAO,WAAW,GAAG;AACvB,WAAO,EAAE,MAAM,OAAO,mBAAmB,IAAI,GAAG,YAAY,iBAAiB;AAAA,EAC/E;AAEA,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,OAAO,OAAO,UAAU,IAAI,CAAC;AACvD,UAAM,SAAS,OAAO,SAAS,KAAK,CAAC,SAAS;AAC5C,UAAI,SAAS,QAAS,QAAO,KAAK,eAAe;AACjD,aAAO,KAAK,eAAe,QAAQ,KAAK,aAAa,iBAAiB;AAAA,IACxE,CAAC;AACD,WAAO,EAAE,MAAM,OAAO,mBAAmB,MAAM,EAAE;AAAA,EACnD,QAAQ;AACN,WAAO,EAAE,MAAM,OAAO,mBAAmB,IAAI,GAAG,YAAY,gCAAgC;AAAA,EAC9F;AACF;;;AD3LO,IAAM,yBAAwD;AAAA,EACnE,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,KAAK;AAAA;AAAA;AAAA;AAAA,EAIL,KAAK;AACP;AAKO,IAAM,uBAGT;AAAA,EACF,MAAM,EAAE,WAAW,QAAQ,aAAa,YAAY;AAAA,EACpD,KAAK,EAAE,WAAW,SAAS,aAAa,aAAa;AACvD;AAEO,SAAS,eAAe,OAAsC;AACnE,SAAO,OAAO,OAAO,sBAAsB,KAAK;AAClD;AAEO,SAAS,sBAAsB,OAA6C;AACjF,SAAO,UAAU,UAAU,eAAe,KAAK;AACjD;AAEO,SAAS,gBAAgB,OAAsC;AACpE,SAAO,MAAM,WAAW,QAAQ;AAClC;AAEO,SAAS,2BACd,SACA,OACqB;AACrB,QAAM,WAAW,gBAAgB,KAAK;AACtC,SAAO,YAAY,UAAU,YAAY,WAAW,WAAW;AACjE;AASO,SAAS,4BAA4B,OAAsD;AAChG,MAAI,CAAC,MAAO,QAAO,EAAE,UAAU,OAAO,QAAQ,gBAAgB;AAC9D,MAAI,CAAC,MAAM,eAAgB,QAAO,EAAE,UAAU,OAAO,QAAQ,qBAAqB;AAClF,SAAO,EAAE,UAAU,KAAK;AAC1B;AAEA,SAAS,cAAc,WAAmB,UAAoC;AAC5E,QAAM,YAAY,OAAO,OAAO,wBAAwB,SAAS;AACjE,SAAO;AAAA,IACL;AAAA,IACA,gBAAgB;AAAA,IAChB,oBAAoB,YAAa,uBAAuB,SAAS,KAAK,OAAQ;AAAA,IAC9E;AAAA,EACF;AACF;AAQA,eAAsB,gBACpB,UACA,QACiC;AACjC,QAAM,WAAW,SACb,MAAM,mBAAmB,UAAU,MAAM,IACzC,MAAM,mBAAmB,QAAQ;AACrC,MAAI,SAAS,SAAS,WAAW,SAAS,WAAY,QAAO;AAC7D,QAAM,YAAY,SAAS,MAAM;AACjC,MAAI,CAAC,UAAW,QAAO;AACvB,SAAO,cAAc,WAAW,oBAAoB,SAAS,MAAM,WAAW,CAAC;AACjF;AAYO,SAAS,6BAAmD;AACjE,SAAO,oBAAI,IAAI;AACjB;AAMA,IAAM,oBAA0C,oBAAI,IAAI;AACxD,IAAM,0BAA0B;AAEhC,SAAS,oBACP,OACA,UACA,QACM;AACN,MAAI,CAAC,MAAM,IAAI,QAAQ,KAAK,MAAM,QAAQ,yBAAyB;AACjE,UAAM,SAAS,MAAM,KAAK,EAAE,KAAK,EAAE;AACnC,QAAI,OAAQ,OAAM,OAAO,MAAM;AAAA,EACjC;AAEA,QAAM,OAAO,QAAQ;AACrB,QAAM,IAAI,UAAU,MAAM;AAC5B;AAEA,eAAe,sBACb,UACA,OACA,QACiC;AACjC,MAAI;AACJ,MAAI;AACF,WAAO,SAAS,QAAQ;AAAA,EAC1B,QAAQ;AACN,WAAO;AAAA,EACT;AACA,QAAM,SAAS,MAAM,IAAI,QAAQ;AACjC,MAAI,UAAU,OAAO,YAAY,KAAK,WAAW,OAAO,SAAS,KAAK,MAAM;AAC1E,wBAAoB,OAAO,UAAU,MAAM;AAC3C,WAAO,OAAO;AAAA,EAChB;AACA,QAAM,QAAQ,MAAM,gBAAgB,UAAU,MAAM;AACpD,sBAAoB,OAAO,UAAU,EAAE,SAAS,KAAK,SAAS,MAAM,KAAK,MAAM,MAAM,CAAC;AACtF,SAAO;AACT;AAYA,IAAM,eAAe;AAarB,SAAS,0BACP,YACA,KAC+D;AAC/D,QAAM,cAAc,QAAQ,UAAU;AACtC,QAAM,eAAe,4BAA4B,aAAa,GAAG,EAAE;AAAA,IAAK,CAAC,cACvE,WAAW,SAAS;AAAA,EACtB;AACA,MAAI,CAAC,aAAc,QAAO;AAC1B,QAAM,eAAe,SAAS,aAAa,YAAY,EAAE,MAAM,GAAG,EAAE,KAAK,GAAG;AAC5E,SAAO,EAAE,cAAc,sBAAsB,IAAI,YAAY,GAAG;AAClE;AAOA,SAAS,wBACP,YACA,aACqB;AACrB,QAAM,aAAa,oBAAI,IAAoB;AAE3C,aAAW,EAAE,MAAM,YAAY,KAAK,aAAa;AAC/C,UAAM,YAAY,uBAAuB,IAAI;AAC7C,UAAM,KAAK,IAAI,OAAO,aAAa,QAAQ,aAAa,KAAK;AAC7D,QAAI;AACJ,YAAQ,QAAQ,GAAG,KAAK,SAAS,OAAO,MAAM;AAC5C,YAAM,MAAM,cAAc,MAAM,CAAC,KAAK,EAAE;AACxC,UAAI,CAAC,OAAO,oBAAoB,GAAG,EAAG;AACtC,UAAI,gBAAgB,KAAK,GAAG,EAAG;AAC/B,YAAM,kBAAkB,cAAc,iBAAiB,aAAa,GAAG,IAAI;AAC3E,YAAM,WAAW,0BAA0B,YAAY,eAAe;AACtE,UAAI,CAAC,SAAU;AACf,iBAAW,IAAI,SAAS,cAAc,SAAS,oBAAoB;AAAA,IACrE;AAAA,EACF;AAEA,SAAO;AACT;AAIA,IAAM,oBAAoB;AAe1B,eAAsB,yBACpB,YACA,aACA,UAA2C,CAAC,GACpB;AACxB,QAAM,aAAa,wBAAwB,YAAY,WAAW;AAClE,MAAI,WAAW,SAAS,EAAG,QAAO,CAAC;AAEnC,QAAM,QAAQ,QAAQ,SAAS;AAC/B,QAAM,UAAU,CAAC,GAAG,WAAW,QAAQ,CAAC;AACxC,QAAM,QAAQ,IAAI,MAA8B,QAAQ,MAAM,EAAE,KAAK,IAAI;AACzE,MAAI,YAAY;AAChB,QAAM,cAAc,KAAK,IAAI,mBAAmB,QAAQ,MAAM;AAC9D,QAAM,QAAQ;AAAA,IACZ,MAAM,KAAK,EAAE,QAAQ,YAAY,GAAG,YAAY;AAC9C,aAAO,YAAY,QAAQ,QAAQ;AACjC,cAAM,QAAQ;AACd,cAAM,QAAQ,QAAQ,KAAK;AAC3B,YAAI,CAAC,MAAO;AACZ,cAAM,KAAK,IAAI,MAAM,sBAAsB,MAAM,CAAC,GAAG,OAAO,QAAQ,MAAM;AAAA,MAC5E;AAAA,IACF,CAAC;AAAA,EACH;AAEA,QAAM,MAAqB,CAAC;AAC5B,UAAQ,QAAQ,CAAC,CAAC,EAAE,QAAQ,GAAG,UAAU;AACvC,UAAM,aAAa,MAAM,KAAK;AAC9B,QAAI,YAAY,eAAgB,KAAI,QAAQ,IAAI;AAAA,EAClD,CAAC;AACD,SAAO;AACT;","names":[]}

package/dist/{chunk-YBR7MXIO.js → chunk-IVOJZ24X.js}

@@ -1,7 +1,7 @@
 import {
   PROXY_VARIANT_CONFIG,
   probeMediaMetadata
-} from "./chunk-LVXVG4V6.js";
+} from "./chunk-7Q5AFHU6.js";
 
 // src/helpers/proxyTranscoder.ts
 import { spawn } from "child_process";
@@ -114,7 +114,7 @@ function cleanupProxyCache(cacheDir, options = {}) {
 }
 
 // src/helpers/proxyTranscoder.ts
-var PROXY_PARAMS_VERSION = "v3";
+var PROXY_PARAMS_VERSION = "v4";
 var CACHE_DIR_NAME = ".transcode-cache";
 function boundedEnvInteger(name, fallback, min, max) {
   const raw = process.env[name]?.trim();
@@ -302,10 +302,10 @@ async function runFfmpeg(sourcePath, outputPath, variant) {
   if (!ffmpegPath) {
     throw new FfmpegUnavailableError();
   }
-  if (metadata.color.isHdr && variant !== "vp9") await ensureHdrFilters(ffmpegPath);
+  if (metadata.color.isHdr && variant !== "vp8") await ensureHdrFilters(ffmpegPath);
   const evenScale = "scale=trunc(iw/2)*2:trunc(ih/2)*2";
-  const pixelFormat = variant === "vp9" ? "yuva420p" : "yuv420p";
-  const videoFilter = metadata.color.isHdr && variant !== "vp9" ? [
+  const pixelFormat = variant === "vp8" ? "yuva420p" : "yuv420p";
+  const videoFilter = metadata.color.isHdr && variant !== "vp8" ? [
     "zscale=t=linear:npl=100",
     "tonemap=hable:desat=0",
     "zscale=p=bt709:t=bt709:m=bt709:r=tv",
@@ -336,9 +336,9 @@ async function runFfmpeg(sourcePath, outputPath, variant) {
       "-movflags",
       "+faststart"
     ];
-    const vp9Args = [
+    const vp8Args = [
       "-c:v",
-      "libvpx-vp9",
+      "libvpx",
       "-b:v",
       "0",
       "-crf",
@@ -353,8 +353,6 @@ async function runFfmpeg(sourcePath, outputPath, variant) {
       "bt709",
       "-color_trc",
       "bt709",
-      "-row-mt",
-      "1",
       "-cpu-used",
       "4",
       "-auto-alt-ref",
@@ -366,7 +364,7 @@ async function runFfmpeg(sourcePath, outputPath, variant) {
       "-c:a",
       "libopus"
     ];
-    const args = [...commonArgs, ...variant === "vp9" ? vp9Args : h264Args, outputPath];
+    const args = [...commonArgs, ...variant === "vp8" ? vp8Args : h264Args, outputPath];
     const proc = spawn(ffmpegPath, args, {
       stdio: ["ignore", "ignore", "pipe"],
       timeout: TRANSCODE_TIMEOUT_MS,
@@ -456,4 +454,4 @@ export {
   clearFailedTranscodesForTest,
   resolveProxy
 };
-//# sourceMappingURL=chunk-YBR7MXIO.js.map
+//# sourceMappingURL=chunk-IVOJZ24X.js.map

package/dist/chunk-IVOJZ24X.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/helpers/proxyTranscoder.ts","../src/helpers/proxyCache.ts"],"sourcesContent":["import { spawn } from \"node:child_process\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport {\n  existsSync,\n  mkdirSync,\n  realpathSync,\n  renameSync,\n  statSync,\n  unlinkSync,\n  utimesSync,\n} from \"node:fs\";\nimport { basename, dirname, isAbsolute, join, relative, sep } from \"node:path\";\nimport { findFfBinary } from \"@hyperframes/parsers/ff-binaries\";\nimport { probeMediaMetadata } from \"./mediaMetadata.js\";\nimport { cleanupProxyCache } from \"./proxyCache.js\";\nimport { PROXY_VARIANT_CONFIG, type ProxyVariant } from \"./mediaCodecMap.js\";\n\n/**\n * Transcodes browser-hostile local video sources (HEVC, ProRes, ...) into a\n * cached, seekable authoring proxy. Consumed by the preview/play/static\n * project routes (U3/U4) to serve a `?hf-proxy=` request; never used on\n * the render path (render always sees the original file).\n *\n * IMPORTANT — request-lifecycle detachment: nothing here accepts or wires an\n * AbortSignal. `resolveProxy` returns a promise shared by every concurrent\n * caller for the same cache key (in-flight dedupe below); if a route handler\n * killed the ffmpeg child on client abort (page reload, HMR), every other\n * caller waiting on that same promise would fail too, and the next request\n * would restart a transcode that may have been minutes into a long asset.\n * Callers MUST let the child run to completion regardless of request\n * cancellation and simply let the held response also abort — the cache\n * entry still lands for the next request.\n */\n\nexport const PROXY_PARAMS_VERSION = \"v4\";\n\nconst CACHE_DIR_NAME = \".transcode-cache\";\n\nfunction boundedEnvInteger(name: string, fallback: number, min: number, max: number): number {\n  const raw = process.env[name]?.trim();\n  if (!raw) return fallback;\n  const parsed = Number(raw);\n  return Number.isSafeInteger(parsed) && parsed >= min && parsed <= max ? parsed : fallback;\n}\n\n// ffmpeg is internally multithreaded, so two concurrent proxy encodes already\n// saturate a typical laptop. Operators of shared/large machines may tune the\n// bounded values without patching the package; invalid values fail safe.\nconst MAX_CONCURRENT_TRANSCODES = boundedEnvInteger(\"HYPERFRAMES_PROXY_MAX_CONCURRENCY\", 2, 1, 16);\nconst MAX_QUEUED_TRANSCODES = boundedEnvInteger(\"HYPERFRAMES_PROXY_MAX_QUEUE\", 8, 0, 256);\n\nconst STDERR_TAIL_MAX_CHARS = 4000;\nexport const TRANSCODE_TIMEOUT_MS = 15 * 60 * 1000;\nconst FAILURE_CACHE_TTL_MS = 60 * 1000;\nconst MAX_FAILURE_CACHE_ENTRIES = 128;\nexport const DEFAULT_PROXY_WAIT_TIMEOUT_MS = 2 * 60 * 1000;\n\nexport class ProxyTranscodeError extends Error {\n  readonly exitCode: number | null;\n  readonly stderrTail: string;\n\n  constructor(message: string, exitCode: number | null, stderrTail: string) {\n    super(message);\n    this.name = \"ProxyTranscodeError\";\n    this.exitCode = exitCode;\n    this.stderrTail = stderrTail;\n  }\n}\n\n/** \"ffmpeg isn't installed\" — an environment condition, not a per-source\n * failure, so it is deliberately NOT remembered by the negative cache below\n * (installing ffmpeg mid-session must recover without a server restart). */\nclass FfmpegUnavailableError extends ProxyTranscodeError {\n  constructor() {\n    super(\"ffmpeg binary not found\", null, \"\");\n  }\n}\n\nexport class FfmpegMissingFilterError extends ProxyTranscodeError {\n  constructor() {\n    super(\n      \"HDR proxying requires ffmpeg zscale/tonemap filters (libzimg); install an ffmpeg build with libzimg support\",\n      null,\n      \"\",\n    );\n    this.name = \"FfmpegMissingFilterError\";\n  }\n}\n\nexport class ProxyCapacityError extends ProxyTranscodeError {\n  constructor() {\n    super(\"media proxy queue is full; retry shortly\", null, \"\");\n    this.name = \"ProxyCapacityError\";\n  }\n}\n\nexport class ProxySourceOutsideProjectError extends ProxyTranscodeError {\n  constructor() {\n    super(\"media proxy source must be inside the project\", null, \"\");\n    this.name = \"ProxySourceOutsideProjectError\";\n  }\n}\n\nexport class ProxyWaitTimeoutError extends ProxyTranscodeError {\n  constructor(timeoutMs: number) {\n    super(`media proxy did not become ready within ${timeoutMs}ms`, null, \"\");\n    this.name = \"ProxyWaitTimeoutError\";\n  }\n}\n\n/** Bounds one caller's wait without cancelling the shared in-flight ffmpeg\n * job. Other preview/publish callers still receive the completed cache entry. */\nexport async function waitForProxy<T>(\n  promise: Promise<T>,\n  timeoutMs = DEFAULT_PROXY_WAIT_TIMEOUT_MS,\n): Promise<T> {\n  let timer: NodeJS.Timeout | undefined;\n  try {\n    return await Promise.race([\n      promise,\n      new Promise<never>((_resolve, reject) => {\n        timer = setTimeout(() => reject(new ProxyWaitTimeoutError(timeoutMs)), timeoutMs);\n        timer.unref();\n      }),\n    ]);\n  } finally {\n    if (timer) clearTimeout(timer);\n  }\n}\n\n/**\n * Cache key inputs per the plan: source path relative to the project (so the\n * cache is portable across checkouts at different absolute locations), mtime\n * and file size (mtime alone can collide on same-second re-exports on\n * coarse-timestamp filesystems; size catches nearly all such cases at zero\n * cost), and a params version token so changing the ffmpeg recipe below\n * invalidates every cached proxy cleanly.\n */\ntype CanonicalProxySource = {\n  projectDir: string;\n  sourcePath: string;\n  relativePath: string;\n};\n\nfunction canonicalizeProxySource(\n  projectDir: string,\n  absoluteSourcePath: string,\n): CanonicalProxySource {\n  const canonicalProjectDir = realpathSync(projectDir);\n  const canonicalSourcePath = realpathSync(absoluteSourcePath);\n  const relPath = relative(canonicalProjectDir, canonicalSourcePath);\n  if (relPath === \"..\" || relPath.startsWith(`..${sep}`) || isAbsolute(relPath)) {\n    throw new ProxySourceOutsideProjectError();\n  }\n  return {\n    projectDir: canonicalProjectDir,\n    sourcePath: canonicalSourcePath,\n    relativePath: relPath.normalize(\"NFC\"),\n  };\n}\n\nfunction buildProxyCacheKey(source: CanonicalProxySource, variant: ProxyVariant): string {\n  const stat = statSync(source.sourcePath);\n  return createHash(\"sha256\")\n    .update(\n      `${source.relativePath}\\0${stat.mtimeMs}\\0${stat.size}\\0${PROXY_PARAMS_VERSION}\\0${variant}`,\n    )\n    .digest(\"hex\");\n}\n\nfunction getCanonicalProxyCachePath(source: CanonicalProxySource, variant: ProxyVariant): string {\n  const key = buildProxyCacheKey(source, variant);\n  return join(\n    source.projectDir,\n    CACHE_DIR_NAME,\n    `${key}${PROXY_VARIANT_CONFIG[variant].extension}`,\n  );\n}\n\n/**\n * Computes the absolute path a proxy for this source would live at, without\n * transcoding anything. Route handlers use this to check cache state (e.g.\n * for ETag/If-None-Match) before deciding whether to await a transcode.\n */\nexport function getProxyCachePath(\n  projectDir: string,\n  absoluteSourcePath: string,\n  variant: ProxyVariant = \"h264\",\n): string {\n  return getCanonicalProxyCachePath(\n    canonicalizeProxySource(projectDir, absoluteSourcePath),\n    variant,\n  );\n}\n\n// --- global concurrency limiter -------------------------------------------\n// ponytail: a bare counter + FIFO wait queue is the whole semaphore; no\n// dependency pulled in for this. Both element-triggered and pre-warm calls\n// go through the same `resolveProxy` entry point, so both queue here.\n\nlet activeTranscodes = 0;\nconst waitQueue: Array<() => void> = [];\n\nfunction acquireSlot(): Promise<void> {\n  return new Promise((resolveSlot, reject) => {\n    const tryAcquire = (): void => {\n      if (activeTranscodes < MAX_CONCURRENT_TRANSCODES) {\n        activeTranscodes++;\n        resolveSlot();\n      } else {\n        if (waitQueue.length >= MAX_QUEUED_TRANSCODES) {\n          reject(new ProxyCapacityError());\n          return;\n        }\n        waitQueue.push(tryAcquire);\n      }\n    };\n    tryAcquire();\n  });\n}\n\nfunction releaseSlot(): void {\n  activeTranscodes--;\n  const next = waitQueue.shift();\n  if (next) next();\n}\n\n// --- per-key in-flight dedupe ----------------------------------------------\n\nconst inFlight = new Map<string, Promise<string>>();\n\nfunction maintainProxyCache(cacheDir: string): void {\n  try {\n    cleanupProxyCache(cacheDir, { protectedPaths: new Set(inFlight.keys()) });\n  } catch (error) {\n    // Cache maintenance must never turn a playable preview into an error.\n    console.warn(\n      `[media-proxy] cache cleanup failed: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n}\n\nfunction markCacheEntryUsed(cachePath: string): void {\n  try {\n    const now = new Date();\n    utimesSync(cachePath, now, now);\n  } catch {\n    // A concurrent cleanup may have removed a stale entry after existsSync;\n    // the normal miss path below will recreate it on the next request.\n  }\n}\n\n// --- negative cache ---------------------------------------------------------\n// A source that failed to transcode fails again identically until the file\n// changes (the cache key embeds mtime+size, so a re-export invalidates this\n// naturally). Remembering the failure per key means repeated `?hf-proxy=`\n// requests for a broken asset rethrow instantly instead of respawning ffmpeg\n// on every retry the browser makes.\ninterface RememberedFailure {\n  error: ProxyTranscodeError;\n  expiresAt: number;\n}\n\nconst failedTranscodes = new Map<string, RememberedFailure>();\n\nlet hdrFilterCheck: { ffmpegPath: string; promise: Promise<void> } | undefined;\n\nfunction ensureHdrFilters(ffmpegPath: string): Promise<void> {\n  if (hdrFilterCheck?.ffmpegPath === ffmpegPath) return hdrFilterCheck.promise;\n  const promise = new Promise<void>((resolveCheck, rejectCheck) => {\n    const proc = spawn(ffmpegPath, [\"-hide_banner\", \"-filters\"], {\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n    });\n    let stdout = \"\";\n    proc.stdout?.on(\"data\", (chunk: Buffer) => {\n      stdout += chunk.toString();\n    });\n    proc.on(\"error\", () => rejectCheck(new FfmpegMissingFilterError()));\n    proc.on(\"close\", (code) => {\n      if (code !== 0 || !/\\bzscale\\b/.test(stdout) || !/\\btonemap\\b/.test(stdout)) {\n        rejectCheck(new FfmpegMissingFilterError());\n      } else {\n        resolveCheck();\n      }\n    });\n  });\n  hdrFilterCheck = { ffmpegPath, promise };\n  return promise;\n}\n\nfunction rememberFailure(cachePath: string, error: ProxyTranscodeError): void {\n  failedTranscodes.delete(cachePath);\n  failedTranscodes.set(cachePath, { error, expiresAt: Date.now() + FAILURE_CACHE_TTL_MS });\n  while (failedTranscodes.size > MAX_FAILURE_CACHE_ENTRIES) {\n    const oldest = failedTranscodes.keys().next().value;\n    if (oldest === undefined) break;\n    failedTranscodes.delete(oldest);\n  }\n}\n\n/** Test hook: forget remembered transcode failures (module state persists\n * across tests that don't reload the module). */\nexport function clearFailedTranscodesForTest(): void {\n  failedTranscodes.clear();\n}\n\nasync function runFfmpeg(\n  sourcePath: string,\n  outputPath: string,\n  variant: ProxyVariant,\n): Promise<void> {\n  const metadata = await probeMediaMetadata(sourcePath);\n  const ffmpegPath = findFfBinary(\"ffmpeg\", { configuredMustExist: true });\n  if (!ffmpegPath) {\n    throw new FfmpegUnavailableError();\n  }\n  // The HDR tonemap filters discard alpha. VP8 is the alpha-preserving proxy\n  // variant, so retain its source color values instead of making it opaque.\n  if (metadata.color.isHdr && variant !== \"vp8\") await ensureHdrFilters(ffmpegPath);\n  const evenScale = \"scale=trunc(iw/2)*2:trunc(ih/2)*2\";\n  const pixelFormat = variant === \"vp8\" ? \"yuva420p\" : \"yuv420p\";\n  const videoFilter =\n    metadata.color.isHdr && variant !== \"vp8\"\n      ? [\n          \"zscale=t=linear:npl=100\",\n          \"tonemap=hable:desat=0\",\n          \"zscale=p=bt709:t=bt709:m=bt709:r=tv\",\n          evenScale,\n          `format=${pixelFormat}`,\n        ].join(\",\")\n      : [evenScale, `format=${pixelFormat}`].join(\",\");\n\n  return new Promise((resolvePromise, reject) => {\n    const commonArgs = [\"-y\", \"-i\", sourcePath, \"-vf\", videoFilter];\n    const h264Args = [\n      \"-c:v\",\n      \"libx264\",\n      \"-profile:v\",\n      \"high\",\n      \"-pix_fmt\",\n      \"yuv420p\",\n      \"-colorspace\",\n      \"bt709\",\n      \"-color_primaries\",\n      \"bt709\",\n      \"-color_trc\",\n      \"bt709\",\n      \"-crf\",\n      \"18\",\n      \"-preset\",\n      \"veryfast\",\n      \"-c:a\",\n      \"aac\",\n      \"-movflags\",\n      \"+faststart\",\n    ];\n    const vp8Args = [\n      \"-c:v\",\n      \"libvpx\",\n      \"-b:v\",\n      \"0\",\n      \"-crf\",\n      \"23\",\n      \"-deadline\",\n      \"good\",\n      \"-pix_fmt\",\n      \"yuva420p\",\n      \"-colorspace\",\n      \"bt709\",\n      \"-color_primaries\",\n      \"bt709\",\n      \"-color_trc\",\n      \"bt709\",\n      \"-cpu-used\",\n      \"4\",\n      \"-auto-alt-ref\",\n      \"0\",\n      \"-metadata:s:v:0\",\n      \"alpha_mode=1\",\n      \"-ac\",\n      \"2\",\n      \"-c:a\",\n      \"libopus\",\n    ];\n    const args = [...commonArgs, ...(variant === \"vp8\" ? vp8Args : h264Args), outputPath];\n\n    // Hard ceiling so a hung ffmpeg can never permanently occupy one of the\n    // global transcode slots: the child is killed and the slot released via\n    // the caller's finally. Generous because long assets transcode at\n    // roughly real time; a healthy encode of any authoring asset fits.\n    const proc = spawn(ffmpegPath, args, {\n      stdio: [\"ignore\", \"ignore\", \"pipe\"],\n      timeout: TRANSCODE_TIMEOUT_MS,\n      killSignal: \"SIGKILL\",\n    });\n    let stderrTail = \"\";\n    proc.stderr?.on(\"data\", (chunk: Buffer) => {\n      stderrTail = (stderrTail + chunk.toString()).slice(-STDERR_TAIL_MAX_CHARS);\n    });\n    proc.on(\"error\", (err) => {\n      reject(new ProxyTranscodeError(`failed to spawn ffmpeg: ${err.message}`, null, stderrTail));\n    });\n    proc.on(\"close\", (code, signal) => {\n      if (code === 0) {\n        resolvePromise();\n      } else if (signal) {\n        reject(\n          new ProxyTranscodeError(\n            `ffmpeg killed by ${signal} (timeout ${TRANSCODE_TIMEOUT_MS}ms or external kill)`,\n            null,\n            stderrTail,\n          ),\n        );\n      } else {\n        reject(new ProxyTranscodeError(`ffmpeg exited with code ${code}`, code, stderrTail));\n      }\n    });\n  });\n}\n\nasync function transcodeToCache(\n  absoluteSourcePath: string,\n  cachePath: string,\n  variant: ProxyVariant,\n): Promise<string> {\n  await acquireSlot();\n  try {\n    // Another caller may have finished (or a pre-warm beat us) while queued.\n    if (existsSync(cachePath)) return cachePath;\n\n    const cacheDir = dirname(cachePath);\n    mkdirSync(cacheDir, { recursive: true });\n    const tempPath = join(cacheDir, `.tmp-${randomUUID()}-${basename(cachePath)}`);\n    try {\n      await runFfmpeg(absoluteSourcePath, tempPath, variant);\n      renameSync(tempPath, cachePath);\n      maintainProxyCache(cacheDir);\n      return cachePath;\n    } finally {\n      // No partial files: if anything above threw, remove whatever ffmpeg\n      // may have partially written under the temp name.\n      if (existsSync(tempPath)) unlinkSync(tempPath);\n    }\n  } finally {\n    releaseSlot();\n  }\n}\n\n/**\n * Resolves the cached proxy variant for `absoluteSourcePath`, transcoding it at\n * most once per cache key. Concurrent calls for the same key (including a\n * pre-warm call racing an element-triggered one) share one ffmpeg child and\n * one promise; calls for different keys queue through the global concurrency\n * limiter above. Throws `ProxyTranscodeError` on failure (missing ffmpeg or a\n * nonzero exit) — callers (route handlers) decide how to surface that (502).\n */\nexport async function resolveProxy(\n  projectDir: string,\n  absoluteSourcePath: string,\n  variant: ProxyVariant = \"h264\",\n): Promise<string> {\n  const source = canonicalizeProxySource(projectDir, absoluteSourcePath);\n  const cachePath = getCanonicalProxyCachePath(source, variant);\n  if (existsSync(cachePath)) {\n    markCacheEntryUsed(cachePath);\n    maintainProxyCache(dirname(cachePath));\n    return cachePath;\n  }\n\n  const rememberedFailure = failedTranscodes.get(cachePath);\n  if (rememberedFailure) {\n    if (rememberedFailure.expiresAt > Date.now()) throw rememberedFailure.error;\n    failedTranscodes.delete(cachePath);\n  }\n\n  const existing = inFlight.get(cachePath);\n  if (existing) return existing;\n\n  const promise = transcodeToCache(source.sourcePath, cachePath, variant)\n    .catch((err: unknown) => {\n      if (\n        err instanceof ProxyTranscodeError &&\n        !(err instanceof FfmpegUnavailableError) &&\n        !(err instanceof FfmpegMissingFilterError) &&\n        !(err instanceof ProxyCapacityError) &&\n        !(err instanceof ProxySourceOutsideProjectError)\n      ) {\n        rememberFailure(cachePath, err);\n      }\n      throw err;\n    })\n    .finally(() => {\n      inFlight.delete(cachePath);\n    });\n  inFlight.set(cachePath, promise);\n  return promise;\n}\n","import { existsSync, readdirSync, statSync, unlinkSync } from \"node:fs\";\nimport { extname, join } from \"node:path\";\nimport { PROXY_VARIANT_CONFIG } from \"./mediaCodecMap.js\";\n\nconst DEFAULT_MAX_BYTES = 10 * 1024 * 1024 * 1024;\nconst DEFAULT_STALE_TEMP_MS = 60 * 60 * 1000;\nconst DEFAULT_MIN_SWEEP_INTERVAL_MS = 5 * 60 * 1000;\nconst PROXY_EXTENSIONS: ReadonlySet<string> = new Set(\n  Object.values(PROXY_VARIANT_CONFIG).map(({ extension }) => extension),\n);\n\nexport interface ProxyCacheCleanupOptions {\n  maxBytes?: number;\n  maxIdleMs?: number;\n  staleTempMs?: number;\n  minSweepIntervalMs?: number;\n  protectedPaths?: ReadonlySet<string>;\n  now?: number;\n}\n\nexport interface ProxyCacheCleanupResult {\n  removed: string[];\n  bytesBefore: number;\n  bytesAfter: number;\n  skipped: boolean;\n}\n\ninterface CacheEntry {\n  path: string;\n  size: number;\n  modifiedAt: number;\n  protected: boolean;\n}\n\nconst lastSweepAt = new Map<string, number>();\n\nfunction positiveEnvNumber(name: string, fallback: number): number {\n  const parsed = Number(process.env[name]);\n  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;\n}\n\nfunction proxyCacheCleanupDefaults(): Required<\n  Pick<ProxyCacheCleanupOptions, \"maxBytes\" | \"maxIdleMs\" | \"staleTempMs\" | \"minSweepIntervalMs\">\n> {\n  return {\n    maxBytes: positiveEnvNumber(\"HYPERFRAMES_PROXY_CACHE_MAX_BYTES\", DEFAULT_MAX_BYTES),\n    maxIdleMs: positiveEnvNumber(\"HYPERFRAMES_PROXY_CACHE_MAX_IDLE_DAYS\", 30) * 24 * 60 * 60 * 1000,\n    staleTempMs: positiveEnvNumber(\"HYPERFRAMES_PROXY_CACHE_STALE_TEMP_MS\", DEFAULT_STALE_TEMP_MS),\n    minSweepIntervalMs: positiveEnvNumber(\n      \"HYPERFRAMES_PROXY_CACHE_SWEEP_INTERVAL_MS\",\n      DEFAULT_MIN_SWEEP_INTERVAL_MS,\n    ),\n  };\n}\n\nfunction shouldSkipSweep(cacheDir: string, now: number, minSweepIntervalMs: number): boolean {\n  const previousSweep = lastSweepAt.get(cacheDir);\n  if (previousSweep !== undefined && now - previousSweep < minSweepIntervalMs) return true;\n  lastSweepAt.set(cacheDir, now);\n  return false;\n}\n\nfunction readCacheInventory(\n  cacheDir: string,\n  protectedPaths: ReadonlySet<string>,\n  now: number,\n  staleTempMs: number,\n): { entries: CacheEntry[]; staleTemps: CacheEntry[] } {\n  const entries: CacheEntry[] = [];\n  const staleTemps: CacheEntry[] = [];\n  for (const dirent of readdirSync(cacheDir, { withFileTypes: true })) {\n    if (!dirent.isFile()) continue;\n    const path = join(cacheDir, dirent.name);\n    const stat = statSync(path);\n    const entry = {\n      path,\n      size: stat.size,\n      modifiedAt: stat.mtimeMs,\n      protected: protectedPaths.has(path),\n    };\n    if (dirent.name.startsWith(\".tmp-\")) {\n      if (now - stat.mtimeMs >= staleTempMs) staleTemps.push(entry);\n    } else if (PROXY_EXTENSIONS.has(extname(dirent.name))) {\n      entries.push(entry);\n    }\n  }\n  const oldestFirst = (a: CacheEntry, b: CacheEntry): number =>\n    a.modifiedAt - b.modifiedAt || a.path.localeCompare(b.path);\n  entries.sort(oldestFirst);\n  staleTemps.sort(oldestFirst);\n  return { entries, staleTemps };\n}\n\nfunction evictCacheEntries(\n  entries: CacheEntry[],\n  staleTemps: CacheEntry[],\n  now: number,\n  maxIdleMs: number,\n  maxBytes: number,\n): Omit<ProxyCacheCleanupResult, \"skipped\"> {\n  const bytesBefore = entries.reduce((total, entry) => total + entry.size, 0);\n  let bytesAfter = bytesBefore;\n  const removed: string[] = [];\n  const remove = (entry: CacheEntry, countsTowardBudget: boolean): void => {\n    unlinkSync(entry.path);\n    removed.push(entry.path);\n    if (countsTowardBudget) bytesAfter -= entry.size;\n  };\n\n  for (const entry of staleTemps) remove(entry, false);\n  for (const entry of entries) {\n    if (!entry.protected && now - entry.modifiedAt >= maxIdleMs) remove(entry, true);\n  }\n  for (const entry of entries) {\n    if (bytesAfter <= maxBytes) break;\n    if (!entry.protected && existsSync(entry.path)) remove(entry, true);\n  }\n  return { removed, bytesBefore, bytesAfter };\n}\n\n/**\n * Opportunistically bounds a project's transparent-proxy cache. Cleanup is\n * synchronous because callers already perform filesystem bookkeeping on the\n * preview request path, but rate limiting keeps the directory scan off the\n * hot path. Errors intentionally bubble so callers can warn without turning\n * a cache-maintenance failure into a preview failure.\n */\nexport function cleanupProxyCache(\n  cacheDir: string,\n  options: ProxyCacheCleanupOptions = {},\n): ProxyCacheCleanupResult {\n  const defaults = proxyCacheCleanupDefaults();\n  const now = options.now ?? Date.now();\n  const minSweepIntervalMs = options.minSweepIntervalMs ?? defaults.minSweepIntervalMs;\n  if (shouldSkipSweep(cacheDir, now, minSweepIntervalMs)) {\n    return { removed: [], bytesBefore: 0, bytesAfter: 0, skipped: true };\n  }\n  if (!existsSync(cacheDir)) {\n    return { removed: [], bytesBefore: 0, bytesAfter: 0, skipped: false };\n  }\n\n  const maxBytes = options.maxBytes ?? defaults.maxBytes;\n  const maxIdleMs = options.maxIdleMs ?? defaults.maxIdleMs;\n  const staleTempMs = options.staleTempMs ?? defaults.staleTempMs;\n  const protectedPaths = options.protectedPaths ?? new Set<string>();\n  const { entries, staleTemps } = readCacheInventory(cacheDir, protectedPaths, now, staleTempMs);\n  return {\n    ...evictCacheEntries(entries, staleTemps, now, maxIdleMs, maxBytes),\n    skipped: false,\n  };\n}\n"],"mappings":"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","names":["existsSync","statSync","unlinkSync","join","statSync","join","existsSync","unlinkSync"]}

package/dist/{chunk-ZUW4PULZ.js → chunk-OK7FKBKI.js}

@@ -1,12 +1,12 @@
 import {
   PROXY_PARAMS_VERSION,
   resolveProxy
-} from "./chunk-YBR7MXIO.js";
+} from "./chunk-IVOJZ24X.js";
 import {
   createMediaCodecProbeCache,
   proxyVariantFor,
   scanProjectMediaCodecMap
-} from "./chunk-LVXVG4V6.js";
+} from "./chunk-7Q5AFHU6.js";
 
 // src/helpers/mediaProxyPreview.ts
 import { resolve } from "path";
@@ -63,4 +63,4 @@ export {
   injectMediaCodecMapIntoHtml,
   injectMediaCodecMap
 };
-//# sourceMappingURL=chunk-ZUW4PULZ.js.map
+//# sourceMappingURL=chunk-OK7FKBKI.js.map

package/dist/{chunk-ZUW4PULZ.js.map → chunk-OK7FKBKI.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/helpers/mediaProxyPreview.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport type { StudioApiAdapter } from \"../types.js\";\nimport {\n  createMediaCodecProbeCache,\n  proxyVariantFor,\n  scanProjectMediaCodecMap,\n  type HtmlSourceLike,\n  type MediaCodecMap,\n  type MediaCodecProbeCache,\n} from \"./mediaCodecMap.js\";\nimport { resolveProxy, PROXY_PARAMS_VERSION } from \"./proxyTranscoder.js\";\n\n/**\n * Transparent-media-proxy wiring shared by `routes/preview.ts`\n * (docs/plans/2026-07-14-002-feat-transparent-media-proxies-plan.md, unit U3).\n * Split out of the route module to keep it under the repo's 600-line file cap.\n */\n\n/**\n * Preview-route-local adapter surface for the auto-proxy feature. Both\n * fields are optional so any existing `StudioApiAdapter` value remains\n * structurally assignable without editing the shared interface:\n * `autoProxy` defaults to true (on) when omitted — a later unit wires the\n * CLI `--no-proxy` flag / `hyperframes.json` setting through it;\n * `mediaCodecProbeCache` lets a host share one probe cache across\n * preview/play/static-server surfaces instead of each constructing its own.\n */\nexport type PreviewApiAdapter = StudioApiAdapter & {\n  autoProxy?: boolean;\n  mediaCodecProbeCache?: MediaCodecProbeCache;\n};\n\nexport function isAutoProxyEnabled(adapter: PreviewApiAdapter): boolean {\n  return adapter.autoProxy !== false;\n}\n\n/** One probe cache per server instance — construct once in `registerPreviewRoutes`\n * and reuse across every request so the mtime-cache benefit in\n * `scanProjectMediaCodecMap` actually applies. A host that wants to share the\n * cache across other surfaces (play, static project server) can pass its own\n * via `adapter.mediaCodecProbeCache`. */\nexport function resolvePreviewMediaCodecProbeCache(\n  adapter: PreviewApiAdapter,\n): MediaCodecProbeCache {\n  return adapter.mediaCodecProbeCache ?? createMediaCodecProbeCache();\n}\n\n/**\n * ETag salt for `?hf-proxy=` asset requests, mirroring `variablesEtagSalt` in\n * preview.ts: salted by the raw param value plus the transcoder's params\n * version, so a future proxy-recipe change (which bumps `PROXY_PARAMS_VERSION`)\n * or a different proxy variant invalidates cached 304s without needing to\n * touch the proxy file itself.\n */\nexport function proxyEtagSalt(raw: string | undefined): string {\n  if (raw === undefined) return \"\";\n  return `:proxy:${raw}:${PROXY_PARAMS_VERSION}`;\n}\n\n// Mirrors `injectScriptTagIntoHead` in routes/preview.ts (kept local rather\n// than imported to avoid a helpers → routes dependency edge for one\n// two-line utility).\nfunction injectScriptTagIntoHead(html: string, scriptTag: string): string {\n  if (html.includes(\"</head>\")) return html.replace(\"</head>\", `${scriptTag}\\n</head>`);\n  return `${scriptTag}\\n${html}`;\n}\n\n/**\n * Injects `window.__HF_MEDIA_CODEC_MAP__` (the U1 codec-facts scan) into\n * served composition HTML, and fire-and-forget pre-warms `resolveProxy` for\n * every browser-hostile entry so an element's proactive swap usually hits a\n * warm cache (KTD: protects the per-origin connection budget under held\n * responses). No second concurrency limiter here — the transcoder's own\n * global bound throttles both pre-warm and element-triggered calls.\n * Pre-warm failures are swallowed; an actual `?hf-proxy=` request surfaces\n * them as a 502. Alpha-bearing entries pre-warm their VP9/WebM variant.\n *\n * The single shared implementation for every auto-proxy surface — the studio\n * preview route (via `injectMediaCodecMap` below) and the CLI's composition /\n * static project servers (via the `./media-proxy-preview` subpath export).\n * Empty maps leave HTML untouched, preserving the normal no-hostile-media\n * preview path. On-demand proxy requests enforce the same eligibility gate.\n */\nexport async function injectMediaCodecMapIntoHtml(\n  html: string,\n  projectDir: string,\n  htmlSources: HtmlSourceLike[],\n  probeCache?: MediaCodecProbeCache,\n): Promise<string> {\n  let map: MediaCodecMap;\n  try {\n    map = await scanProjectMediaCodecMap(\n      projectDir,\n      htmlSources,\n      probeCache ? { cache: probeCache } : {},\n    );\n  } catch {\n    // Best-effort: a scan failure must never block serving the page.\n    return html;\n  }\n  if (Object.keys(map).length === 0) return html;\n  for (const [rootRelativePathname, facts] of Object.entries(map)) {\n    if (!facts.browserHostile) continue;\n    resolveProxy(\n      projectDir,\n      resolve(projectDir, rootRelativePathname.replace(/^\\/+/, \"\")),\n      proxyVariantFor(facts),\n    ).catch(() => {\n      // Swallowed: the pre-warm is best-effort. A real `?hf-proxy=` request\n      // for this asset re-attempts the transcode and reports failure (502).\n    });\n  }\n  // <-escape prevents a src path containing \"</script>\" from breaking out of\n  // the injected tag, mirroring injectPreviewVariables in routes/preview.ts.\n  const json = JSON.stringify(map)\n    .replace(/</g, \"\\\\u003c\")\n    .replace(/\\u2028/g, \"\\\\u2028\")\n    .replace(/\\u2029/g, \"\\\\u2029\");\n  const tag = `<script data-hf-media-codec-map>window.__HF_MEDIA_CODEC_MAP__=${json};</script>`;\n  return injectScriptTagIntoHead(html, tag);\n}\n\n/**\n * Adapter-aware wrapper used by the studio preview routes: skipped entirely\n * (no scan, no injection) when auto-proxy is off for this adapter.\n */\nexport async function injectMediaCodecMap(\n  html: string,\n  adapter: PreviewApiAdapter,\n  projectDir: string,\n  compSrcPath: string,\n  probeCache: MediaCodecProbeCache,\n): Promise<string> {\n  if (!isAutoProxyEnabled(adapter)) return html;\n  return injectMediaCodecMapIntoHtml(html, projectDir, [{ html, compSrcPath }], probeCache);\n}\n"],"mappings":";;;;;;;;;;;AAAA,SAAS,eAAe;AAgCjB,SAAS,mBAAmB,SAAqC;AACtE,SAAO,QAAQ,cAAc;AAC/B;AAOO,SAAS,mCACd,SACsB;AACtB,SAAO,QAAQ,wBAAwB,2BAA2B;AACpE;AASO,SAAS,cAAc,KAAiC;AAC7D,MAAI,QAAQ,OAAW,QAAO;AAC9B,SAAO,UAAU,GAAG,IAAI,oBAAoB;AAC9C;AAKA,SAAS,wBAAwB,MAAc,WAA2B;AACxE,MAAI,KAAK,SAAS,SAAS,EAAG,QAAO,KAAK,QAAQ,WAAW,GAAG,SAAS;AAAA,QAAW;AACpF,SAAO,GAAG,SAAS;AAAA,EAAK,IAAI;AAC9B;AAkBA,eAAsB,4BACpB,MACA,YACA,aACA,YACiB;AACjB,MAAI;AACJ,MAAI;AACF,UAAM,MAAM;AAAA,MACV;AAAA,MACA;AAAA,MACA,aAAa,EAAE,OAAO,WAAW,IAAI,CAAC;AAAA,IACxC;AAAA,EACF,QAAQ;AAEN,WAAO;AAAA,EACT;AACA,MAAI,OAAO,KAAK,GAAG,EAAE,WAAW,EAAG,QAAO;AAC1C,aAAW,CAAC,sBAAsB,KAAK,KAAK,OAAO,QAAQ,GAAG,GAAG;AAC/D,QAAI,CAAC,MAAM,eAAgB;AAC3B;AAAA,MACE;AAAA,MACA,QAAQ,YAAY,qBAAqB,QAAQ,QAAQ,EAAE,CAAC;AAAA,MAC5D,gBAAgB,KAAK;AAAA,IACvB,EAAE,MAAM,MAAM;AAAA,IAGd,CAAC;AAAA,EACH;AAGA,QAAM,OAAO,KAAK,UAAU,GAAG,EAC5B,QAAQ,MAAM,SAAS,EACvB,QAAQ,WAAW,SAAS,EAC5B,QAAQ,WAAW,SAAS;AAC/B,QAAM,MAAM,iEAAiE,IAAI;AACjF,SAAO,wBAAwB,MAAM,GAAG;AAC1C;AAMA,eAAsB,oBACpB,MACA,SACA,YACA,aACA,YACiB;AACjB,MAAI,CAAC,mBAAmB,OAAO,EAAG,QAAO;AACzC,SAAO,4BAA4B,MAAM,YAAY,CAAC,EAAE,MAAM,YAAY,CAAC,GAAG,UAAU;AAC1F;","names":[]}
+{"version":3,"sources":["../src/helpers/mediaProxyPreview.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport type { StudioApiAdapter } from \"../types.js\";\nimport {\n  createMediaCodecProbeCache,\n  proxyVariantFor,\n  scanProjectMediaCodecMap,\n  type HtmlSourceLike,\n  type MediaCodecMap,\n  type MediaCodecProbeCache,\n} from \"./mediaCodecMap.js\";\nimport { resolveProxy, PROXY_PARAMS_VERSION } from \"./proxyTranscoder.js\";\n\n/**\n * Transparent-media-proxy wiring shared by `routes/preview.ts`\n * (docs/plans/2026-07-14-002-feat-transparent-media-proxies-plan.md, unit U3).\n * Split out of the route module to keep it under the repo's 600-line file cap.\n */\n\n/**\n * Preview-route-local adapter surface for the auto-proxy feature. Both\n * fields are optional so any existing `StudioApiAdapter` value remains\n * structurally assignable without editing the shared interface:\n * `autoProxy` defaults to true (on) when omitted — a later unit wires the\n * CLI `--no-proxy` flag / `hyperframes.json` setting through it;\n * `mediaCodecProbeCache` lets a host share one probe cache across\n * preview/play/static-server surfaces instead of each constructing its own.\n */\nexport type PreviewApiAdapter = StudioApiAdapter & {\n  autoProxy?: boolean;\n  mediaCodecProbeCache?: MediaCodecProbeCache;\n};\n\nexport function isAutoProxyEnabled(adapter: PreviewApiAdapter): boolean {\n  return adapter.autoProxy !== false;\n}\n\n/** One probe cache per server instance — construct once in `registerPreviewRoutes`\n * and reuse across every request so the mtime-cache benefit in\n * `scanProjectMediaCodecMap` actually applies. A host that wants to share the\n * cache across other surfaces (play, static project server) can pass its own\n * via `adapter.mediaCodecProbeCache`. */\nexport function resolvePreviewMediaCodecProbeCache(\n  adapter: PreviewApiAdapter,\n): MediaCodecProbeCache {\n  return adapter.mediaCodecProbeCache ?? createMediaCodecProbeCache();\n}\n\n/**\n * ETag salt for `?hf-proxy=` asset requests, mirroring `variablesEtagSalt` in\n * preview.ts: salted by the raw param value plus the transcoder's params\n * version, so a future proxy-recipe change (which bumps `PROXY_PARAMS_VERSION`)\n * or a different proxy variant invalidates cached 304s without needing to\n * touch the proxy file itself.\n */\nexport function proxyEtagSalt(raw: string | undefined): string {\n  if (raw === undefined) return \"\";\n  return `:proxy:${raw}:${PROXY_PARAMS_VERSION}`;\n}\n\n// Mirrors `injectScriptTagIntoHead` in routes/preview.ts (kept local rather\n// than imported to avoid a helpers → routes dependency edge for one\n// two-line utility).\nfunction injectScriptTagIntoHead(html: string, scriptTag: string): string {\n  if (html.includes(\"</head>\")) return html.replace(\"</head>\", `${scriptTag}\\n</head>`);\n  return `${scriptTag}\\n${html}`;\n}\n\n/**\n * Injects `window.__HF_MEDIA_CODEC_MAP__` (the U1 codec-facts scan) into\n * served composition HTML, and fire-and-forget pre-warms `resolveProxy` for\n * every browser-hostile entry so an element's proactive swap usually hits a\n * warm cache (KTD: protects the per-origin connection budget under held\n * responses). No second concurrency limiter here — the transcoder's own\n * global bound throttles both pre-warm and element-triggered calls.\n * Pre-warm failures are swallowed; an actual `?hf-proxy=` request surfaces\n * them as a 502. Alpha-bearing entries pre-warm their VP8/WebM variant.\n *\n * The single shared implementation for every auto-proxy surface — the studio\n * preview route (via `injectMediaCodecMap` below) and the CLI's composition /\n * static project servers (via the `./media-proxy-preview` subpath export).\n * Empty maps leave HTML untouched, preserving the normal no-hostile-media\n * preview path. On-demand proxy requests enforce the same eligibility gate.\n */\nexport async function injectMediaCodecMapIntoHtml(\n  html: string,\n  projectDir: string,\n  htmlSources: HtmlSourceLike[],\n  probeCache?: MediaCodecProbeCache,\n): Promise<string> {\n  let map: MediaCodecMap;\n  try {\n    map = await scanProjectMediaCodecMap(\n      projectDir,\n      htmlSources,\n      probeCache ? { cache: probeCache } : {},\n    );\n  } catch {\n    // Best-effort: a scan failure must never block serving the page.\n    return html;\n  }\n  if (Object.keys(map).length === 0) return html;\n  for (const [rootRelativePathname, facts] of Object.entries(map)) {\n    if (!facts.browserHostile) continue;\n    resolveProxy(\n      projectDir,\n      resolve(projectDir, rootRelativePathname.replace(/^\\/+/, \"\")),\n      proxyVariantFor(facts),\n    ).catch(() => {\n      // Swallowed: the pre-warm is best-effort. A real `?hf-proxy=` request\n      // for this asset re-attempts the transcode and reports failure (502).\n    });\n  }\n  // <-escape prevents a src path containing \"</script>\" from breaking out of\n  // the injected tag, mirroring injectPreviewVariables in routes/preview.ts.\n  const json = JSON.stringify(map)\n    .replace(/</g, \"\\\\u003c\")\n    .replace(/\\u2028/g, \"\\\\u2028\")\n    .replace(/\\u2029/g, \"\\\\u2029\");\n  const tag = `<script data-hf-media-codec-map>window.__HF_MEDIA_CODEC_MAP__=${json};</script>`;\n  return injectScriptTagIntoHead(html, tag);\n}\n\n/**\n * Adapter-aware wrapper used by the studio preview routes: skipped entirely\n * (no scan, no injection) when auto-proxy is off for this adapter.\n */\nexport async function injectMediaCodecMap(\n  html: string,\n  adapter: PreviewApiAdapter,\n  projectDir: string,\n  compSrcPath: string,\n  probeCache: MediaCodecProbeCache,\n): Promise<string> {\n  if (!isAutoProxyEnabled(adapter)) return html;\n  return injectMediaCodecMapIntoHtml(html, projectDir, [{ html, compSrcPath }], probeCache);\n}\n"],"mappings":";;;;;;;;;;;AAAA,SAAS,eAAe;AAgCjB,SAAS,mBAAmB,SAAqC;AACtE,SAAO,QAAQ,cAAc;AAC/B;AAOO,SAAS,mCACd,SACsB;AACtB,SAAO,QAAQ,wBAAwB,2BAA2B;AACpE;AASO,SAAS,cAAc,KAAiC;AAC7D,MAAI,QAAQ,OAAW,QAAO;AAC9B,SAAO,UAAU,GAAG,IAAI,oBAAoB;AAC9C;AAKA,SAAS,wBAAwB,MAAc,WAA2B;AACxE,MAAI,KAAK,SAAS,SAAS,EAAG,QAAO,KAAK,QAAQ,WAAW,GAAG,SAAS;AAAA,QAAW;AACpF,SAAO,GAAG,SAAS;AAAA,EAAK,IAAI;AAC9B;AAkBA,eAAsB,4BACpB,MACA,YACA,aACA,YACiB;AACjB,MAAI;AACJ,MAAI;AACF,UAAM,MAAM;AAAA,MACV;AAAA,MACA;AAAA,MACA,aAAa,EAAE,OAAO,WAAW,IAAI,CAAC;AAAA,IACxC;AAAA,EACF,QAAQ;AAEN,WAAO;AAAA,EACT;AACA,MAAI,OAAO,KAAK,GAAG,EAAE,WAAW,EAAG,QAAO;AAC1C,aAAW,CAAC,sBAAsB,KAAK,KAAK,OAAO,QAAQ,GAAG,GAAG;AAC/D,QAAI,CAAC,MAAM,eAAgB;AAC3B;AAAA,MACE;AAAA,MACA,QAAQ,YAAY,qBAAqB,QAAQ,QAAQ,EAAE,CAAC;AAAA,MAC5D,gBAAgB,KAAK;AAAA,IACvB,EAAE,MAAM,MAAM;AAAA,IAGd,CAAC;AAAA,EACH;AAGA,QAAM,OAAO,KAAK,UAAU,GAAG,EAC5B,QAAQ,MAAM,SAAS,EACvB,QAAQ,WAAW,SAAS,EAC5B,QAAQ,WAAW,SAAS;AAC/B,QAAM,MAAM,iEAAiE,IAAI;AACjF,SAAO,wBAAwB,MAAM,GAAG;AAC1C;AAMA,eAAsB,oBACpB,MACA,SACA,YACA,aACA,YACiB;AACjB,MAAI,CAAC,mBAAmB,OAAO,EAAG,QAAO;AACzC,SAAO,4BAA4B,MAAM,YAAY,CAAC,EAAE,MAAM,YAAY,CAAC,GAAG,UAAU;AAC1F;","names":[]}

package/dist/{chunk-XVQX2JHE.js → chunk-VPA335OG.js}

@@ -256,14 +256,29 @@ function splitElementInHtml(source, target, splitTime, newId, fallbackTiming) {
   const clone = el.cloneNode(true);
   if (!isHTMLElement(clone)) return { html: source, matched: false, newId: null };
   clone.setAttribute("id", newId);
+  const compositionId = clone.getAttribute("data-composition-id");
+  if (compositionId) {
+    const usedCompositionIds = new Set(
+      Array.from(
+        document.querySelectorAll("[data-composition-id]"),
+        (node) => node.getAttribute("data-composition-id")
+      )
+    );
+    const base = `${compositionId}-split`;
+    let nextCompositionId = base;
+    let suffix = 2;
+    while (usedCompositionIds.has(nextCompositionId)) nextCompositionId = `${base}-${suffix++}`;
+    clone.setAttribute("data-composition-id", nextCompositionId);
+  }
   clone.removeAttribute("data-hf-id");
   for (const node of clone.querySelectorAll("[data-hf-id]")) node.removeAttribute("data-hf-id");
   setElementDuration(clone, splitTime, secondDuration);
-  const playbackStartAttr = el.hasAttribute("data-playback-start") ? "data-playback-start" : el.hasAttribute("data-media-start") ? "data-media-start" : null;
+  const playbackStartAttr = el.hasAttribute("data-playback-start") ? "data-playback-start" : el.hasAttribute("data-media-start") ? "data-media-start" : fallbackTiming?.stampPlaybackStart ? "data-playback-start" : null;
   if (playbackStartAttr) {
-    const currentTrim = parseFloat(el.getAttribute(playbackStartAttr) ?? "0") || 0;
+    const currentTrim = parseFloat(el.getAttribute(playbackStartAttr) ?? "") || fallbackTiming?.playbackStart || 0;
     const rateRaw = parseFloat(el.getAttribute("data-playback-rate") ?? "");
-    const rate = Number.isFinite(rateRaw) ? rateRaw : 1;
+    const rate = Number.isFinite(rateRaw) && rateRaw > 0 ? rateRaw : fallbackTiming?.playbackRate ?? 1;
+    el.setAttribute(playbackStartAttr, String(Math.round(currentTrim * 1e3) / 1e3));
     clone.setAttribute(
       playbackStartAttr,
       String(Math.round((currentTrim + firstDuration * rate) * 1e3) / 1e3)
@@ -419,4 +434,4 @@ export {
   wrapElementsInHtml,
   unwrapElementsFromHtml
 };
-//# sourceMappingURL=chunk-XVQX2JHE.js.map
+//# sourceMappingURL=chunk-VPA335OG.js.map

package/dist/chunk-VPA335OG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/helpers/sourceMutation.ts","../src/helpers/sourceStyleMutation.ts"],"sourcesContent":["import { parseHTML } from \"linkedom\";\nimport postcss from \"postcss\";\nimport selectorParser from \"postcss-selector-parser\";\nimport { isAllowedHtmlAttribute, isSafeAttributeValue } from \"@hyperframes/core/html-attr-safety\";\nimport { ensureHfIds } from \"@hyperframes/parsers/hf-ids\";\nimport { readClipTiming, writeClipTiming } from \"@hyperframes/core/composition-contract\";\nimport { parseStyleDecls, patchStyleAttrString } from \"./sourceStyleMutation.js\";\n\nexport interface SourceMutationTarget {\n  id?: string | null;\n  hfId?: string;\n  selector?: string;\n  selectorIndex?: number;\n}\n\nfunction parseSourceDocument(source: string): { document: Document; wrappedFragment: boolean } {\n  const hasDocumentShell = /<!doctype|<html[\\s>]/i.test(source);\n  if (hasDocumentShell) {\n    return { document: parseHTML(source).document, wrappedFragment: false };\n  }\n  return {\n    document: parseHTML(`<!DOCTYPE html><html><head></head><body>${source}</body></html>`).document,\n    wrappedFragment: true,\n  };\n}\n\nfunction duplicateCssRulesForId(document: Document, originalId: string, newId: string): void {\n  const idToken = `#${originalId}`;\n  const transform = selectorParser((selectors) => {\n    selectors.walkIds((node) => {\n      if (node.value === originalId) node.value = newId;\n    });\n  });\n  for (const styleEl of document.querySelectorAll(\"style\")) {\n    const css = styleEl.textContent ?? \"\";\n    let root: postcss.Root;\n    try {\n      root = postcss.parse(css);\n    } catch {\n      continue;\n    }\n    const clones: postcss.Rule[] = [];\n    root.walkRules((rule) => {\n      if (!rule.selector.includes(idToken)) return;\n      const newSelector = transform.processSync(rule.selector);\n      if (newSelector === rule.selector) return;\n      const clone = rule.clone({ selector: newSelector });\n      clones.push(clone);\n    });\n    if (clones.length > 0) {\n      for (const c of clones) root.append(c);\n      styleEl.textContent = root.toString();\n    }\n  }\n}\n\nfunction querySelectorAllWithTemplates(root: Document | Element, selector: string): Element[] {\n  const matches = Array.from(root.querySelectorAll(selector));\n  if (matches.length > 0) return matches;\n  // querySelectorAll doesn't traverse <template> content in linkedom.\n  // Search directly on each template element (NOT .content — removing from\n  // .content's DocumentFragment doesn't update the serialized output).\n  // Recurse so NESTED templates resolve too — ensureHfIds and the SDK's\n  // querySelectorAllDeep descend nested composition templates, so ids exist at\n  // any template depth; a one-level search here would silently no-op\n  // server-side ops on those ids while the SDK resolves them.\n  const templates = Array.from(root.querySelectorAll(\"template\"));\n  for (const tmpl of templates) {\n    const inner = querySelectorAllWithTemplates(tmpl, selector);\n    if (inner.length > 0) return inner;\n  }\n  return [];\n}\n\n// Prevent CSS attribute-selector injection via a crafted hfId: escape\n// backslashes first, then double-quotes. Keeps a malformed/hostile value from\n// breaking out of the `[data-hf-id=\"…\"]` selector once callers beyond the\n// internal mint contract (R2+ user flows) pass values here.\nfunction escapeCssAttrValue(value: string): string {\n  return value.replace(/\\\\/g, \"\\\\\\\\\").replace(/\"/g, '\\\\\"');\n}\n\nfunction findByHfId(document: Document, hfId: string): Element | null {\n  try {\n    const matches = querySelectorAllWithTemplates(\n      document,\n      `[data-hf-id=\"${escapeCssAttrValue(hfId)}\"]`,\n    );\n    if (matches.length > 1) {\n      // The mint contract guarantees uniqueness; a duplicate means upstream\n      // id drift. Don't silently patch an arbitrary one — surface it.\n      // eslint-disable-next-line no-console\n      console.warn(\n        `sourceMutation: data-hf-id \"${hfId}\" matched ${matches.length} elements; using the first. ids must be unique per document.`,\n      );\n    }\n    return matches[0] ?? null;\n  } catch {\n    // Malformed selector despite escaping — let the caller fall back.\n    return null;\n  }\n}\n\nfunction findTargetElement(document: Document, target: SourceMutationTarget): Element | null {\n  if (target.hfId) {\n    const el = findByHfId(document, target.hfId);\n    if (el) return el;\n  }\n\n  if (target.id) {\n    const byId = document.getElementById(target.id);\n    if (byId) return byId;\n  }\n\n  if (!target.selector) return null;\n  try {\n    const matches = querySelectorAllWithTemplates(document, target.selector);\n    return matches[target.selectorIndex ?? 0] ?? null;\n  } catch {\n    return null;\n  }\n}\n\nexport function removeElementFromHtml(source: string, target: SourceMutationTarget): string {\n  const { document, wrappedFragment } = parseSourceDocument(source);\n  const element = findTargetElement(document, target);\n  if (!element) return source;\n\n  element.remove();\n  return wrappedFragment ? document.body.innerHTML || \"\" : document.toString();\n}\n\nexport function isHTMLElement(el: Node): el is HTMLElement {\n  const HTMLEl = el.ownerDocument?.defaultView?.HTMLElement;\n  return HTMLEl ? el instanceof HTMLEl : el.nodeType === 1 && \"style\" in el;\n}\n\nexport interface PatchOperation {\n  type: \"inline-style\" | \"attribute\" | \"html-attribute\" | \"text-content\";\n  property: string;\n  value: string | null;\n  childSelector?: string;\n  childIndex?: number;\n}\n\ninterface ResolvedPatchOperation {\n  op: PatchOperation;\n  target: HTMLElement;\n}\n\nfunction resolveOperationTarget(parent: HTMLElement, op: PatchOperation): HTMLElement | null {\n  if (op.childSelector === undefined) return parent;\n  try {\n    const child = parent.querySelectorAll(op.childSelector)[op.childIndex ?? 0] ?? null;\n    return child && isHTMLElement(child) ? child : null;\n  } catch {\n    return null;\n  }\n}\n\n// fallow-ignore-next-line complexity\nexport function patchElementInHtml(\n  source: string,\n  target: SourceMutationTarget,\n  operations: PatchOperation[],\n): { html: string; matched: boolean } {\n  const { document, wrappedFragment } = parseSourceDocument(source);\n  const el = findTargetElement(document, target);\n  if (!el || !isHTMLElement(el)) return { html: source, matched: false };\n  const htmlEl = el;\n\n  const resolved: ResolvedPatchOperation[] = [];\n  for (const op of operations) {\n    const opTarget = resolveOperationTarget(htmlEl, op);\n    if (!opTarget) return { html: source, matched: false };\n    resolved.push({ op, target: opTarget });\n  }\n\n  for (const { op, target: opTarget } of resolved) {\n    switch (op.type) {\n      case \"inline-style\":\n        // linkedom's CSSStyleDeclaration does not support CSS custom properties\n        // (--foo) or newer individual transform properties (translate, rotate,\n        // scale) via style.setProperty(). Manipulate the style attribute string\n        // directly so all property names survive the round-trip.\n        {\n          const raw = opTarget.getAttribute(\"style\") ?? \"\";\n          const patched = patchStyleAttrString(raw, op.property, op.value);\n          opTarget.setAttribute(\"style\", patched);\n        }\n        break;\n      case \"attribute\":\n        {\n          const fullAttr = op.property.startsWith(\"data-\") ? op.property : `data-${op.property}`;\n          if (op.value != null) {\n            opTarget.setAttribute(fullAttr, op.value);\n          } else {\n            opTarget.removeAttribute(fullAttr);\n          }\n        }\n        break;\n      case \"html-attribute\":\n        if (!isAllowedHtmlAttribute(op.property)) break;\n        if (op.value != null) {\n          if (!isSafeAttributeValue(op.property, op.value)) break;\n          opTarget.setAttribute(op.property, op.value);\n        } else {\n          opTarget.removeAttribute(op.property);\n        }\n        break;\n      case \"text-content\":\n        if (op.value != null) {\n          const inner = opTarget.children.length === 1 ? opTarget.firstElementChild : null;\n          const textTarget = inner && isHTMLElement(inner) ? inner : opTarget;\n          textTarget.textContent = op.value;\n        }\n        break;\n    }\n  }\n\n  return {\n    html: wrappedFragment ? document.body.innerHTML || \"\" : document.toString(),\n    matched: true,\n  };\n}\n\nexport function probeElementInSource(source: string, target: SourceMutationTarget): boolean {\n  if (!target.id && !target.hfId && !target.selector) return false;\n  const { document } = parseSourceDocument(source);\n  const el = findTargetElement(document, target);\n  return el != null && isHTMLElement(el);\n}\n\nexport interface SplitElementResult {\n  html: string;\n  matched: boolean;\n  newId: string | null;\n}\n\nfunction resolveElementTiming(el: Element): {\n  start: number;\n  duration: number;\n} {\n  const timing = readClipTiming(el);\n  return { start: timing.start ?? 0, duration: timing.duration ?? 0 };\n}\n\nfunction setElementDuration(el: Element, start: number, duration: number): void {\n  writeClipTiming(el, {\n    start: Math.round(start * 1000) / 1000,\n    duration: Math.round(duration * 1000) / 1000,\n  });\n}\n\n// fallow-ignore-next-line complexity\nexport function splitElementInHtml(\n  source: string,\n  target: SourceMutationTarget,\n  splitTime: number,\n  newId: string,\n  fallbackTiming?: {\n    start: number;\n    duration: number;\n    playbackStart?: number;\n    playbackRate?: number;\n    stampPlaybackStart?: boolean;\n  },\n): SplitElementResult {\n  const { document, wrappedFragment } = parseSourceDocument(source);\n  const el = findTargetElement(document, target);\n  if (!el || !isHTMLElement(el)) return { html: source, matched: false, newId: null };\n\n  const timing = resolveElementTiming(el);\n  let { start, duration } = timing;\n  // GSAP-animated elements carry their timing in the script, not in data-* attrs,\n  // so the source has no authored duration. Fall back to the store's (GSAP-derived)\n  // range — the runtime windows visibility off data-start/data-duration regardless\n  // of class, so stamping both halves below makes each half show only in its window.\n  if (duration <= 0 && fallbackTiming && fallbackTiming.duration > 0) {\n    start = fallbackTiming.start;\n    duration = fallbackTiming.duration;\n  }\n  if (duration <= 0 || splitTime <= start || splitTime >= start + duration) {\n    return { html: source, matched: false, newId: null };\n  }\n\n  if (document.getElementById(newId)) {\n    let suffix = 2;\n    const base = newId;\n    while (document.getElementById(newId)) {\n      newId = `${base}-${suffix++}`;\n    }\n  }\n\n  const firstDuration = splitTime - start;\n  const secondDuration = duration - firstDuration;\n\n  const clone = el.cloneNode(true);\n  if (!isHTMLElement(clone)) return { html: source, matched: false, newId: null };\n  clone.setAttribute(\"id\", newId);\n  const compositionId = clone.getAttribute(\"data-composition-id\");\n  if (compositionId) {\n    const usedCompositionIds = new Set(\n      Array.from(document.querySelectorAll(\"[data-composition-id]\"), (node) =>\n        node.getAttribute(\"data-composition-id\"),\n      ),\n    );\n    const base = `${compositionId}-split`;\n    let nextCompositionId = base;\n    let suffix = 2;\n    while (usedCompositionIds.has(nextCompositionId)) nextCompositionId = `${base}-${suffix++}`;\n    clone.setAttribute(\"data-composition-id\", nextCompositionId);\n  }\n  clone.removeAttribute(\"data-hf-id\");\n  // Descendants carry their own data-hf-id; leaving them duplicates the id of\n  // every nested node (e.g. an inner <span>), so strip them on the clone too.\n  for (const node of clone.querySelectorAll(\"[data-hf-id]\")) node.removeAttribute(\"data-hf-id\");\n  setElementDuration(clone, splitTime, secondDuration);\n\n  // Keep the \"clip\" class — the runtime uses it to control visibility\n  // based on data-start/data-duration timing.\n\n  // Adjust media trim offset for the second half\n  const playbackStartAttr = el.hasAttribute(\"data-playback-start\")\n    ? \"data-playback-start\"\n    : el.hasAttribute(\"data-media-start\")\n      ? \"data-media-start\"\n      : fallbackTiming?.stampPlaybackStart\n        ? \"data-playback-start\"\n        : null;\n  if (playbackStartAttr) {\n    const currentTrim =\n      parseFloat(el.getAttribute(playbackStartAttr) ?? \"\") || fallbackTiming?.playbackStart || 0;\n    const rateRaw = parseFloat(el.getAttribute(\"data-playback-rate\") ?? \"\");\n    const rate =\n      Number.isFinite(rateRaw) && rateRaw > 0 ? rateRaw : (fallbackTiming?.playbackRate ?? 1);\n    el.setAttribute(playbackStartAttr, String(Math.round(currentTrim * 1000) / 1000));\n    clone.setAttribute(\n      playbackStartAttr,\n      String(Math.round((currentTrim + firstDuration * rate) * 1000) / 1000),\n    );\n  }\n\n  // Duplicate CSS rules targeting the original ID so the clone inherits the same styles.\n  const originalId = el.getAttribute(\"id\");\n  if (originalId) {\n    duplicateCssRulesForId(document, originalId, newId);\n  }\n\n  // Trim the original element's duration. A GSAP element had no data-start; stamp\n  // it so the runtime windows the first half (visibility selects on [data-start]).\n  setElementDuration(el, start, firstDuration);\n\n  // Insert clone after original\n  if (el.nextSibling) {\n    el.parentElement!.insertBefore(clone, el.nextSibling);\n  } else {\n    el.parentElement!.appendChild(clone);\n  }\n\n  const html = wrappedFragment ? document.body.innerHTML || \"\" : document.toString();\n  return {\n    // The split owns its new nodes' stable ids. Leaving the clone unstamped makes\n    // the next preview request persist different bytes after history is recorded.\n    html: ensureHfIds(html),\n    matched: true,\n    newId,\n  };\n}\n\n// --- Element grouping -------------------------------------------------------\n// A group is a real `<div data-hf-group=\"…\">` wrapping its members in the DOM.\n// Wrapping rebases each member's left/top so its absolute position is unchanged:\n// the wrapper sits at the selection bbox top-left, and each child's new left/top\n// is its old left/top minus the wrapper origin (computed client-side, where live\n// layout is available, and passed in via `rebases`). GSAP x/y, CSS translate and\n// --hf-studio-offset vars are deltas relative to flow position and stay untouched.\n\nexport interface WrapElementsResult {\n  html: string;\n  matched: boolean;\n  groupId: string | null;\n  error?: string;\n}\n\nexport interface UnwrapElementsResult {\n  html: string;\n  unwrapped: boolean;\n  /** The unwrapped wrapper's id, so callers can strip GSAP that targeted it\n   *  (the wrapper is gone; a leftover `gsap.set(\"#id\")` would throw at runtime). */\n  unwrappedGroupId?: string;\n  /** Members (id'd children) with their absolute layout centres (post un-rebase),\n   *  so the caller can BAKE the group's GSAP transform into each member before\n   *  stripping it — otherwise the group's moves are lost on ungroup. */\n  members?: Array<{ id: string; cx: number; cy: number }>;\n  /** The wrapper's layout centre — the pivot for baking the group's rotation/scale. */\n  groupCenter?: { cx: number; cy: number };\n}\n\nexport interface ElementRebase {\n  target: SourceMutationTarget;\n  left: number;\n  top: number;\n}\n\nfunction getInlineStylePx(el: Element, property: string): number {\n  const style = (isHTMLElement(el) ? el.getAttribute(\"style\") : null) ?? \"\";\n  const { props } = parseStyleDecls(style);\n  const raw = props.get(property);\n  if (!raw) return 0;\n  const n = parseFloat(raw);\n  return Number.isFinite(n) ? n : 0;\n}\n\nfunction setInlineLeftTop(el: HTMLElement, left: number, top: number): void {\n  let style = el.getAttribute(\"style\") ?? \"\";\n  style = patchStyleAttrString(style, \"left\", `${left}px`);\n  style = patchStyleAttrString(style, \"top\", `${top}px`);\n  el.setAttribute(\"style\", style);\n}\n\n// Slug the group name (\"Group 1\" → \"group-1\") into a unique, valid element id.\nfunction uniqueGroupDomId(document: Document, groupId: string): string {\n  const base =\n    groupId\n      .trim()\n      .toLowerCase()\n      .replace(/[^a-z0-9]+/g, \"-\")\n      .replace(/^-+|-+$/g, \"\") || \"group\";\n  let id = base;\n  let n = 2;\n  while (document.getElementById(id)) {\n    id = `${base}-${n}`;\n    n += 1;\n  }\n  return id;\n}\n\n// fallow-ignore-next-line complexity\nexport function wrapElementsInHtml(\n  source: string,\n  targets: SourceMutationTarget[],\n  groupId: string,\n  bbox: { left: number; top: number; width: number; height: number },\n  rebases: ElementRebase[],\n): WrapElementsResult {\n  const { document, wrappedFragment } = parseSourceDocument(source);\n  if (targets.length === 0) {\n    return { html: source, matched: false, groupId: null, error: \"no targets\" };\n  }\n\n  // Resolve + dedupe by element ref (two targets may point at the same node).\n  const els: HTMLElement[] = [];\n  const seen = new Set<Element>();\n  for (const target of targets) {\n    const el = findTargetElement(document, target);\n    if (!el || !isHTMLElement(el) || seen.has(el)) continue;\n    seen.add(el);\n    els.push(el);\n  }\n  if (els.length === 0) {\n    return { html: source, matched: false, groupId: null, error: \"no targets matched\" };\n  }\n\n  // P1: require a single common parent (LCA multi-parent wrapping is P2).\n  const parent = els[0]?.parentElement;\n  if (!parent || els.some((el) => el.parentElement !== parent)) {\n    return {\n      html: source,\n      matched: false,\n      groupId: null,\n      error: \"grouped elements must share a single parent\",\n    };\n  }\n\n  // Order members by their position in the parent (= z-order / stacking order).\n  const memberSet = new Set<Element>(els);\n  const ordered = Array.from(parent.children).filter((c): c is HTMLElement => memberSet.has(c));\n\n  // Map each member to its rebased left/top (resolved against the same document).\n  const rebaseByEl = new Map<Element, { left: number; top: number }>();\n  for (const rebase of rebases) {\n    const el = findTargetElement(document, rebase.target);\n    if (el) rebaseByEl.set(el, { left: rebase.left, top: rebase.top });\n  }\n\n  const wrapper = document.createElement(\"div\");\n  wrapper.setAttribute(\"data-hf-group\", groupId);\n  // A real `id` (slug of the group name) makes the wrapper a first-class node in the\n  // clip manifest / timeline parent-map (both keyed by id) and a clean GSAP target —\n  // without it the wrapper is invisible to the timeline and breaks child enumeration.\n  wrapper.setAttribute(\"id\", uniqueGroupDomId(document, groupId));\n  // Adopt the topmost member's stacking level. A group is one stacking unit, so a\n  // non-member interleaved between two selected members can't stay \"between\" them\n  // once they unify. Matching Figma/Sketch, the group lifts to the topmost selected\n  // layer: the wrapper goes at the LAST member's slot and carries the max member\n  // z-index — so an interleaved non-member falls below the group instead of hoisting\n  // above it, and explicit member z-indexes are honored.\n  const memberZIndexes = ordered\n    .map((el) =>\n      Number.parseInt(\n        parseStyleDecls(el.getAttribute(\"style\") ?? \"\").props.get(\"z-index\") ?? \"\",\n        10,\n      ),\n    )\n    .filter((z) => Number.isFinite(z));\n  const maxZ = memberZIndexes.length > 0 ? Math.max(...memberZIndexes) : null;\n  wrapper.setAttribute(\n    \"style\",\n    `position: absolute; left: ${bbox.left}px; top: ${bbox.top}px; width: ${bbox.width}px; height: ${bbox.height}px` +\n      (maxZ !== null ? `; z-index: ${maxZ}` : \"\"),\n  );\n\n  // Insert the wrapper at the topmost member's slot, then move members into it.\n  parent.insertBefore(wrapper, ordered[ordered.length - 1] ?? null);\n  for (const el of ordered) {\n    const rebase = rebaseByEl.get(el);\n    if (rebase) setInlineLeftTop(el, rebase.left, rebase.top);\n    wrapper.appendChild(el); // appendChild moves the node, preserving order\n  }\n\n  return {\n    html: wrappedFragment ? document.body.innerHTML || \"\" : document.toString(),\n    matched: true,\n    groupId,\n  };\n}\n\nexport function unwrapElementsFromHtml(\n  source: string,\n  groupTarget: SourceMutationTarget,\n): UnwrapElementsResult {\n  const { document, wrappedFragment } = parseSourceDocument(source);\n  const group = findTargetElement(document, groupTarget);\n  if (!group || !isHTMLElement(group)) return { html: source, unwrapped: false };\n  // Shape guard mirroring the wrap-side contract: only ever dissolve an actual\n  // group wrapper. A stale/desynced selection that resolves to a plain <div>\n  // would otherwise be unwrapped — rebasing its children by the parent's origin\n  // (silent corruption). Wrap enforces invariants; unwrap must too.\n  if (!group.hasAttribute(\"data-hf-group\")) return { html: source, unwrapped: false };\n\n  const parent = group.parentElement;\n  if (!parent) return { html: source, unwrapped: false };\n\n  // Undo the rebase: child absolute position = child (rebased) + wrapper origin.\n  const wLeft = getInlineStylePx(group, \"left\");\n  const wTop = getInlineStylePx(group, \"top\");\n  const groupCenter = {\n    cx: wLeft + getInlineStylePx(group, \"width\") / 2,\n    cy: wTop + getInlineStylePx(group, \"height\") / 2,\n  };\n\n  // Move children back to the wrapper's slot, preserving order.\n  const members: Array<{ id: string; cx: number; cy: number }> = [];\n  for (const child of Array.from(group.children)) {\n    if (isHTMLElement(child)) {\n      const newLeft = getInlineStylePx(child, \"left\") + wLeft;\n      const newTop = getInlineStylePx(child, \"top\") + wTop;\n      setInlineLeftTop(child, newLeft, newTop);\n      if (child.id) {\n        members.push({\n          id: child.id,\n          cx: newLeft + getInlineStylePx(child, \"width\") / 2,\n          cy: newTop + getInlineStylePx(child, \"height\") / 2,\n        });\n      }\n    }\n    parent.insertBefore(child, group);\n  }\n  const groupId = group.id || undefined;\n  group.remove();\n\n  return {\n    html: wrappedFragment ? document.body.innerHTML || \"\" : document.toString(),\n    unwrapped: true,\n    unwrappedGroupId: groupId,\n    members,\n    groupCenter,\n  };\n}\n","// fallow-ignore-next-line complexity\nexport function parseStyleDecls(style: string): { props: Map<string, string>; order: string[] } {\n  const props = new Map<string, string>();\n  const order: string[] = [];\n  let i = 0;\n  while (i < style.length) {\n    let depth = 0;\n    let inSingle = false;\n    let inDouble = false;\n    const start = i;\n    while (i < style.length) {\n      const ch = style[i];\n      if (ch === \"'\" && !inDouble) inSingle = !inSingle;\n      else if (ch === '\"' && !inSingle) inDouble = !inDouble;\n      else if (!inSingle && !inDouble) {\n        if (ch === \"(\") depth++;\n        else if (ch === \")\") depth = Math.max(0, depth - 1);\n        else if (ch === \";\" && depth === 0) break;\n      }\n      i++;\n    }\n    const decl = style.slice(start, i).trim();\n    i++;\n    if (!decl) continue;\n    const colon = decl.indexOf(\":\");\n    if (colon < 0) continue;\n    const key = decl.slice(0, colon).trim();\n    const val = decl.slice(colon + 1).trim();\n    if (!key) continue;\n    if (!props.has(key)) order.push(key);\n    props.set(key, val);\n  }\n  return { props, order };\n}\n\nfunction serializeStyleDecls(props: Map<string, string>, order: string[]): string {\n  return order\n    .map((k) => `${k}: ${props.get(k) ?? \"\"}`)\n    .filter((d) => d.trim())\n    .join(\"; \");\n}\n\nexport function patchStyleAttrString(\n  style: string,\n  property: string,\n  value: string | null,\n): string {\n  const { props, order } = parseStyleDecls(style);\n  if (value === null) {\n    props.delete(property);\n    const idx = order.indexOf(property);\n    if (idx >= 0) order.splice(idx, 1);\n  } else {\n    if (!props.has(property)) order.push(property);\n    props.set(property, value);\n  }\n  return serializeStyleDecls(props, order);\n}\n"],"mappings":"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","names":[]}

package/dist/helpers/mediaCodecMap.d.ts

@@ -29,7 +29,7 @@ interface AssetCodecFacts {
      * the runtime always proxies rather than probing `canPlayType`). */
     representativeMime: string | null;
     /** Source carries an alpha channel (ffprobe pix_fmt). Alpha sources use a
-     * VP9/WebM proxy so their transparency is preserved. */
+     * VP8/WebM proxy so their transparency is preserved across Chromium builds. */
     hasAlpha: boolean;
 }
 /** Server-root-relative URL pathname -> that asset's codec facts. */
@@ -42,7 +42,7 @@ type MediaCodecMap = Record<string, AssetCodecFacts>;
  * rescued by the runtime's reactive zero-videoWidth swap).
  */
 declare const BROWSER_HOSTILE_CODECS: Record<string, string | null>;
-type ProxyVariant = "h264" | "vp9";
+type ProxyVariant = "h264" | "vp8";
 type ProxyVariantRequest = ProxyVariant | "auto";
 declare const PROXY_VARIANT_CONFIG: Record<ProxyVariant, {
     extension: ".mp4" | ".webm";
@@ -52,7 +52,7 @@ declare function isProxyVariant(value: string): value is ProxyVariant;
 declare function isProxyVariantRequest(value: string): value is ProxyVariantRequest;
 declare function proxyVariantFor(facts: AssetCodecFacts): ProxyVariant;
 declare function resolveProxyVariantRequest(request: ProxyVariantRequest, facts: AssetCodecFacts): ProxyVariant | null;
-type MediaProxyIneligibilityReason = "browser_safe_codec" | "proxy_target_codec" | "unknown_codec";
+type MediaProxyIneligibilityReason = "browser_safe_codec" | "unknown_codec";
 type MediaProxyEligibility = {
     eligible: true;
 } | {

package/dist/helpers/mediaCodecMap.js

@@ -9,7 +9,7 @@ import {
   proxyVariantFor,
   resolveProxyVariantRequest,
   scanProjectMediaCodecMap
-} from "../chunk-LVXVG4V6.js";
+} from "../chunk-7Q5AFHU6.js";
 export {
   BROWSER_HOSTILE_CODECS,
   PROXY_VARIANT_CONFIG,

package/dist/helpers/mediaProxyPreview.d.ts

@@ -1,4 +1,4 @@
-export { P as PreviewApiAdapter, i as injectMediaCodecMap, e as injectMediaCodecMapIntoHtml, f as isAutoProxyEnabled, p as proxyEtagSalt, r as resolvePreviewMediaCodecProbeCache } from '../mediaProxyPreview-CeshDUjE.js';
+export { P as PreviewApiAdapter, i as injectMediaCodecMap, e as injectMediaCodecMapIntoHtml, f as isAutoProxyEnabled, p as proxyEtagSalt, r as resolvePreviewMediaCodecProbeCache } from '../mediaProxyPreview-ChE1ATG4.js';
 import './mediaCodecMap.js';
 import '@hyperframes/core';
 import '@hyperframes/parsers';

package/dist/helpers/mediaProxyPreview.js

@@ -4,9 +4,9 @@ import {
   isAutoProxyEnabled,
   proxyEtagSalt,
   resolvePreviewMediaCodecProbeCache
-} from "../chunk-ZUW4PULZ.js";
-import "../chunk-YBR7MXIO.js";
-import "../chunk-LVXVG4V6.js";
+} from "../chunk-OK7FKBKI.js";
+import "../chunk-IVOJZ24X.js";
+import "../chunk-7Q5AFHU6.js";
 export {
   injectMediaCodecMap,
   injectMediaCodecMapIntoHtml,

package/dist/helpers/proxyTranscoder.d.ts

@@ -16,7 +16,7 @@ import { ProxyVariant } from './mediaCodecMap.js';
  * cancellation and simply let the held response also abort — the cache
  * entry still lands for the next request.
  */
-declare const PROXY_PARAMS_VERSION = "v3";
+declare const PROXY_PARAMS_VERSION = "v4";
 declare const TRANSCODE_TIMEOUT_MS: number;
 declare const DEFAULT_PROXY_WAIT_TIMEOUT_MS: number;
 declare class ProxyTranscodeError extends Error {

package/dist/helpers/proxyTranscoder.js

@@ -11,8 +11,8 @@ import {
   getProxyCachePath,
   resolveProxy,
   waitForProxy
-} from "../chunk-YBR7MXIO.js";
-import "../chunk-LVXVG4V6.js";
+} from "../chunk-IVOJZ24X.js";
+import "../chunk-7Q5AFHU6.js";
 export {
   DEFAULT_PROXY_WAIT_TIMEOUT_MS,
   FfmpegMissingFilterError,

package/dist/helpers/sourceMutation.d.ts

@@ -26,6 +26,9 @@ interface SplitElementResult {
 declare function splitElementInHtml(source: string, target: SourceMutationTarget, splitTime: number, newId: string, fallbackTiming?: {
     start: number;
     duration: number;
+    playbackStart?: number;
+    playbackRate?: number;
+    stampPlaybackStart?: boolean;
 }): SplitElementResult;
 interface WrapElementsResult {
     html: string;

package/dist/helpers/sourceMutation.js

@@ -6,7 +6,7 @@ import {
   splitElementInHtml,
   unwrapElementsFromHtml,
   wrapElementsInHtml
-} from "../chunk-XVQX2JHE.js";
+} from "../chunk-VPA335OG.js";
 export {
   isHTMLElement,
   patchElementInHtml,

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Hono } from 'hono';
-import { S as StudioApiAdapter, M as MediaProcessingJobState } from './mediaProxyPreview-CeshDUjE.js';
-export { L as LintResult, P as PreviewApiAdapter, R as RenderJobState, a as ResolvedProject, b as StudioSelectionResponse, c as StudioSelectionSnapshot, d as StudioSelectionTextField } from './mediaProxyPreview-CeshDUjE.js';
+import { S as StudioApiAdapter, M as MediaProcessingJobState } from './mediaProxyPreview-ChE1ATG4.js';
+export { L as LintResult, P as PreviewApiAdapter, R as RenderJobState, a as ResolvedProject, b as StudioSelectionResponse, c as StudioSelectionSnapshot, d as StudioSelectionTextField } from './mediaProxyPreview-ChE1ATG4.js';
 export { ScreenshotClip, getElementScreenshotClip } from './helpers/screenshotClip.js';
 export { STUDIO_MANUAL_EDITS_PATH, StudioManualEditsRenderScriptOptions, createStudioManualEditsRenderBodyScript, createStudioPositionSeekReapplyScript } from './helpers/manualEditsRenderScript.js';
 export { STUDIO_MOTION_PATH, StudioMotionRenderScriptOptions, createStudioMotionRenderBodyScript } from './helpers/studioMotionRenderScript.js';