hyperframes 0.8.106 → 0.8.108

package/dist/{chunk-JXXE3SWC.js → chunk-C6XQER6H.js}

@@ -12,12 +12,12 @@ import {
   iterateFontFamilyDeclarations,
   normalizeSystemFontPrimaryFamilies,
   resolveFontFamilyDeclarationFamilies
-} from "./chunk-R5RF3LGS.js";
+} from "./chunk-XMAL2A7Y.js";
 import {
   EncoderInterruptedError,
   encoderFailureError,
   prepareAnimatedGifInputs
-} from "./chunk-32Y3HRS3.js";
+} from "./chunk-XIGK4LNU.js";
 import {
   createStudioPositionSeekReapplyScript
 } from "./chunk-KC5XXX3X.js";
@@ -145,7 +145,7 @@ import {
   validateEngineConfigSnapshot,
   verifyDiskDrawElementSamples,
   writeCapturedFrame
-} from "./chunk-VW5OMJNG.js";
+} from "./chunk-QB6OM2BP.js";
 import {
   HF_VFX_ATTR,
   MEDIA_START_BASIS_ATTR,
@@ -162,7 +162,7 @@ import {
   resolveAbsoluteMediaStartSeconds,
   resolveAuthoredTimingWindow,
   toFps
-} from "./chunk-TEXPOC5V.js";
+} from "./chunk-B25H4M4V.js";
 import {
   CANVAS_DIMENSIONS,
   HTML_BODY_CSS_HEIGHT_FIRST_RE,
@@ -173,7 +173,7 @@ import {
   isAspectAgnosticResolutionAlias,
   normalizeResolutionFlag,
   suggestMatchingPreset
-} from "./chunk-TLYU5625.js";
+} from "./chunk-UUDQD62L.js";
 import {
   assignBundledRuntimeCompositionIds,
   buildVariablesByCompScript,
@@ -186,7 +186,7 @@ import {
   inlineSubCompositions,
   prepareFlattenedInnerRoot,
   styleElementsFor
-} from "./chunk-TH4APNRP.js";
+} from "./chunk-X763EUBO.js";
 import {
   HF_COLOR_GRADING_ATTR,
   MAX_AUDIO_GAIN,
@@ -207,7 +207,7 @@ import {
   resolveNaturalMediaTimelineDurationFromValues,
   shouldClampResolvedMediaDuration,
   sourceTimeAt
-} from "./chunk-FOKUJKBN.js";
+} from "./chunk-YLVI7VL5.js";
 import {
   chromeMajorCeiling
 } from "./chunk-TWWSYAKJ.js";
@@ -216,7 +216,7 @@ import {
   lintHyperframeHtml,
   readProjectFile,
   resolveProjectRelativeSrc
-} from "./chunk-UVUAU3CH.js";
+} from "./chunk-ONY5CJXS.js";
 import {
   CSS_URL_RE,
   checkSubCompositionUsability,
@@ -8042,7 +8042,7 @@ function appendAutoDetectedVideoAudio(composition, extracted) {
   for (const ext of extracted) {
     if (!ext.metadata.hasAudio) continue;
     const video = composition.videos.find((v) => v.id === ext.videoId);
-    if (!video || !video.hasAudio || existingAudioSrcs.has(video.src)) continue;
+    if (!video || !video.hasAudio || video.hidden || existingAudioSrcs.has(video.src)) continue;
     composition.audios.push({
       id: `${video.id}-audio`,
       src: video.src,
@@ -9850,6 +9850,7 @@ async function padOrTrimAudioToVideoFrameCount(input) {
   } finally {
     for (const path of plan2.cleanupPaths) rmSync7(path, { force: true });
   }
+  let loweredDb = 0;
   if (probeTruePeak) {
     const correction = await enforceAacTruePeak({
       audioPath: input.outputPath,
@@ -9869,13 +9870,15 @@ async function padOrTrimAudioToVideoFrameCount(input) {
         failureReason: correction.failureReason
       };
     }
+    loweredDb = correction.loweredDb ?? 0;
   }
   return {
     success: true,
     outputPath: input.outputPath,
     targetDurationSeconds,
     sourceDurationSeconds: audioInfo.durationSeconds,
-    operation: plan2.operation
+    operation: plan2.operation,
+    ...loweredDb > 0 ? { audioLoweredDb: loweredDb } : {}
   };
 }
 async function enforceAacTruePeak(input) {
@@ -9896,8 +9899,9 @@ async function enforceAacTruePeak(input) {
         return { success: false, error: "audioPadTrim: FFmpeg reported an invalid true peak" };
       }
       if (truePeakDbfs <= AAC_DELIVERY_TRUE_PEAK_DBFS) {
-        if (measuredPath === correctedPath) renameSync3(correctedPath, input.audioPath);
-        return { success: true };
+        if (measuredPath !== correctedPath) return { success: true };
+        renameSync3(correctedPath, input.audioPath);
+        return { success: true, loweredDb: Number((-attenuationDb).toFixed(2)) };
       }
       if (pass === MAX_TRUE_PEAK_CORRECTION_PASSES) break;
       attenuationDb += correctionTargetDbfs - truePeakDbfs;
@@ -10069,6 +10073,15 @@ async function runFfprobeJson(args, signal) {
 }
 
 // ../producer/src/services/render/stages/assembleStage.ts
+function recordLimiterAttenuation(job, audioLoweredDb) {
+  if (audioLoweredDb === void 0) return;
+  job.audioLoweredDb = audioLoweredDb;
+  const ceiling = `\u2212${Math.abs(AAC_DELIVERY_TRUE_PEAK_DBFS)} dBTP`;
+  (job.config.logger ?? defaultLogger).info(
+    `Audio lowered by ${audioLoweredDb.toFixed(1)} dB to stay under ${ceiling}`,
+    { audioLoweredDb }
+  );
+}
 async function runAssembleStage(input) {
   const {
     job,
@@ -10098,6 +10111,7 @@ async function runAssembleStage(input) {
     if (!normalizeResult.success) {
       throw encoderFailureError("Audio duration normalization failed", normalizeResult);
     }
+    recordLimiterAttenuation(job, normalizeResult.audioLoweredDb);
     if (isHls) {
       await runHlsPackaging(input, normalizeResult.outputPath);
     } else {
@@ -14130,7 +14144,7 @@ function startServer(options = {}) {
   });
   async function shutdown(signal) {
     log.info(`Received ${signal}, shutting down`);
-    const { drainBrowserPool } = await import("./src-QX5PPANW.js");
+    const { drainBrowserPool } = await import("./src-6R4DC2YI.js");
     await drainBrowserPool().catch(() => {
     });
     const handle = await Promise.race([
@@ -15253,7 +15267,7 @@ async function buildLocalExecutionPlan(projectDir, config, executionPlanDir, opt
   if (probeResult.fileServer) closeFileServerSafely(probeResult.fileServer, "plan", log);
   if (probeResult.probeSession) {
     try {
-      const { closeCaptureSession: closeCaptureSession2 } = await import("./src-QX5PPANW.js");
+      const { closeCaptureSession: closeCaptureSession2 } = await import("./src-6R4DC2YI.js");
       await closeCaptureSession2(probeResult.probeSession);
     } catch (err) {
       log.warn("[plan] probe session close failed", {

package/dist/{chunk-Y2CZEJPK.js → chunk-CFC3EEDQ.js}

@@ -19,10 +19,10 @@ import {
 import {
   formatVariableValidationIssue,
   validateVariables
-} from "./chunk-TEXPOC5V.js";
+} from "./chunk-B25H4M4V.js";
 import {
   extractCompositionMetadata
-} from "./chunk-TLYU5625.js";
+} from "./chunk-UUDQD62L.js";
 
 // src/utils/variables.ts
 import { readFileSync } from "fs";

package/dist/{chunk-PB2OX2JY.js → chunk-D7SCIX4D.js}

@@ -13,7 +13,7 @@ import {
 } from "./chunk-TVCRUG2S.js";
 import {
   getFreeDiskMb
-} from "./chunk-PUB5XZYL.js";
+} from "./chunk-SIVCJJHE.js";
 import {
   ensureBrowser,
   findBrowser

package/dist/{chunk-AXWBDWAV.js → chunk-FZGUZIK5.js}

@@ -7,7 +7,7 @@ var __dirname = __hf_dirname(__filename);
 import {
   getMimeType,
   injectMediaCodecMapIntoHtml
-} from "./chunk-UUE5BZGE.js";
+} from "./chunk-SQ42NHXP.js";
 import {
   PROXY_VARIANT_CONFIG,
   ProxyCapacityError,
@@ -18,10 +18,10 @@ import {
   recordProxyRequest,
   resolveProxy,
   resolveProxyVariantRequest
-} from "./chunk-O5TBFZ7X.js";
+} from "./chunk-OVRFBUXU.js";
 import {
   resolveAutoProxy
-} from "./chunk-HUHJYNST.js";
+} from "./chunk-LAQEZHOH.js";
 
 // src/utils/staticProjectServer.ts
 import { createServer } from "http";

package/dist/{chunk-4WAMN4IF.js → chunk-GYYFNAVA.js}

@@ -13,7 +13,7 @@ function resolveLocalBrowserGpuMode(browserGpuArg, envMode = process.env.PRODUCE
   return "auto";
 }
 async function resolveCaptureBrowserGpuMode(requestedMode, chromePath) {
-  const { resolveBrowserGpuMode } = await import("./src-QX5PPANW.js");
+  const { resolveBrowserGpuMode } = await import("./src-6R4DC2YI.js");
   return resolveBrowserGpuMode(requestedMode, { chromePath });
 }
 

package/dist/{chunk-TYA65W4U.js → chunk-HQGJLZB6.js}

@@ -8,14 +8,14 @@ import {
   DEFAULT_REGISTRY_URL,
   fetchItemFile,
   validRegistryItem
-} from "./chunk-6CN2QLB5.js";
+} from "./chunk-AWUZ3AUD.js";
 import {
   publishRegistryFile,
   registryTargetPath
 } from "./chunk-GMECXFAN.js";
 import {
   validateVariables
-} from "./chunk-TEXPOC5V.js";
+} from "./chunk-B25H4M4V.js";
 import {
   realProjectRoot
 } from "./chunk-OFQWTKPW.js";

package/dist/{chunk-LAHK4P7Q.js → chunk-J7XPPADY.js}

@@ -12,7 +12,7 @@ import {
 } from "./chunk-ZTZA4UWZ.js";
 import {
   getSystemMeta
-} from "./chunk-PUB5XZYL.js";
+} from "./chunk-SIVCJJHE.js";
 import {
   getInvocationId
 } from "./chunk-54HJ63Q2.js";
@@ -23,7 +23,7 @@ import {
   evaluateCanary,
   findCanary,
   parseCanaryOverride
-} from "./chunk-TEXPOC5V.js";
+} from "./chunk-B25H4M4V.js";
 import {
   hostAnswers
 } from "./chunk-K4WIOZFP.js";
@@ -37,7 +37,7 @@ import {
 } from "./chunk-XUXGIA7H.js";
 import {
   VERSION
-} from "./chunk-6LPWMCPY.js";
+} from "./chunk-NROJESOK.js";
 
 // src/telemetry/transport.ts
 import { spawn } from "child_process";

package/dist/{chunk-I77CAR4W.js → chunk-KVOWTRD5.js}

@@ -16,7 +16,7 @@ import {
 import {
   DEFAULT_VP9_CPU_USED,
   renderProvenanceArgs
-} from "./chunk-VW5OMJNG.js";
+} from "./chunk-QB6OM2BP.js";
 import {
   loadOptionalPackage
 } from "./chunk-XT5P4QMO.js";
@@ -202,7 +202,7 @@ function inferInputKind(inputPath) {
 }
 async function probeMedia(inputPath) {
   const isImage = inferInputKind(inputPath) === "image";
-  const engine = await import("./src-QX5PPANW.js");
+  const engine = await import("./src-6R4DC2YI.js");
   const meta = await engine.extractMediaMetadata(inputPath);
   if (isImage) {
     return { width: meta.width, height: meta.height, fps: 0, frameCount: 1 };

package/dist/{chunk-GVZYTDOD.js → chunk-KZ5OSG4G.js}

@@ -6,7 +6,7 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   updateNoticesSuppressed
-} from "./chunk-4NJZZHYT.js";
+} from "./chunk-RPMXMOFU.js";
 import {
   hostAnswers
 } from "./chunk-K4WIOZFP.js";

package/dist/{chunk-IBCGKQB5.js → chunk-KZJ6V7RT.js}

@@ -7,14 +7,14 @@ var __dirname = __hf_dirname(__filename);
 import {
   trackLintReport,
   trackLintRuleStreak
-} from "./chunk-2LCIQS3K.js";
+} from "./chunk-VBXJSCHR.js";
 import {
   shouldTrack
-} from "./chunk-LAHK4P7Q.js";
+} from "./chunk-J7XPPADY.js";
 import {
   LINT_RULE_COUNT,
   LINT_RULE_GROUP_COUNTS
-} from "./chunk-UVUAU3CH.js";
+} from "./chunk-ONY5CJXS.js";
 
 // src/telemetry/lintStreaks.ts
 import { createHash } from "crypto";

package/dist/{chunk-HUHJYNST.js → chunk-LAQEZHOH.js}

@@ -12,7 +12,7 @@ import {
 } from "./chunk-HVW7ABXD.js";
 import {
   DEFAULT_REGISTRY_URL
-} from "./chunk-6CN2QLB5.js";
+} from "./chunk-AWUZ3AUD.js";
 
 // src/utils/projectConfig.ts
 import { readFileSync, writeFileSync } from "fs";

package/dist/{chunk-HFFR7TN7.js → chunk-LPXM5L6S.js}

@@ -17,7 +17,7 @@ import {
 } from "./chunk-TVCRUG2S.js";
 import {
   stoppedByCancelSignal
-} from "./chunk-TMLEIURT.js";
+} from "./chunk-QRXICW5Q.js";
 
 // src/whisper/transcribe.ts
 import { execFileSync } from "child_process";
@@ -392,6 +392,7 @@ export {
   whisperModelSlowdownFactor,
   resolveWhisperTimeoutMs,
   resolveAudioPreparationTimeoutMs,
+  getMediaDurationSeconds,
   getPreparedWavDurationSeconds,
   detectSpeechOnset,
   isPcm16kMono,

package/dist/{chunk-2IZZZJDZ.js → chunk-LTYI4E42.js}

@@ -7,16 +7,16 @@ var __dirname = __hf_dirname(__filename);
 import {
   parseFeedbackRating,
   trackRenderFeedback
-} from "./chunk-2LCIQS3K.js";
+} from "./chunk-VBXJSCHR.js";
 import {
   shouldTrack
-} from "./chunk-LAHK4P7Q.js";
+} from "./chunk-J7XPPADY.js";
 import {
   c
 } from "./chunk-ZTZA4UWZ.js";
 import {
   detectAgentRuntime
-} from "./chunk-PUB5XZYL.js";
+} from "./chunk-SIVCJJHE.js";
 import {
   readConfig,
   writeConfig
@@ -83,7 +83,7 @@ async function maybePromptRenderFeedback(opts) {
 async function getDoctorSummary() {
   try {
     const [{ getSystemMeta }, { findFFmpeg }] = await Promise.all([
-      import("./system-OAB2LYBV.js"),
+      import("./system-YMANAUAM.js"),
       import("./ffmpeg-QIUFEFTY.js")
     ]);
     const sys = getSystemMeta();

package/dist/{chunk-J3Q3YC6P.js → chunk-LZPAZZZP.js}

@@ -1278,7 +1278,7 @@ async function withFigmaErrors(command, fn) {
   } catch (err) {
     if (err instanceof Error) {
       try {
-        const { trackCommandFailure } = await import("./events-AVPSJNYU.js");
+        const { trackCommandFailure } = await import("./events-7JVV4746.js");
         trackCommandFailure(
           command,
           err,

package/dist/{chunk-5TBFBLIX.js → chunk-MGTECHI3.js}

@@ -6,10 +6,10 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   getMimeType
-} from "./chunk-UUE5BZGE.js";
+} from "./chunk-SQ42NHXP.js";
 import {
   injectTagsAtHeadStart
-} from "./chunk-FOKUJKBN.js";
+} from "./chunk-YLVI7VL5.js";
 
 // src/utils/compositionServer.ts
 import { createHash } from "crypto";

package/dist/{chunk-4I6AQUWG.js → chunk-NGVH2QYT.js}

@@ -6,19 +6,19 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   serveStaticProjectHtml
-} from "./chunk-AXWBDWAV.js";
+} from "./chunk-FZGUZIK5.js";
 import {
   AUDIT_SEEK_OPTIONS,
   installPageFunctionGuard,
   seekCompositionTimeline,
   waitForCompositionFonts
-} from "./chunk-XZSH5GS7.js";
+} from "./chunk-RSL3XFMO.js";
 import {
   resolveDiagnosticNavigationTimeoutMs
-} from "./chunk-IQ4UCWV7.js";
+} from "./chunk-TIZQC44K.js";
 import {
   resolveProject
-} from "./chunk-FTXU3TQ4.js";
+} from "./chunk-US7SWKGC.js";
 import {
   c
 } from "./chunk-ZTZA4UWZ.js";
@@ -32,7 +32,7 @@ import {
 import {
   printDeprecationNotice,
   withMeta
-} from "./chunk-4NJZZHYT.js";
+} from "./chunk-RPMXMOFU.js";
 import {
   normalizeErrorMessage
 } from "./chunk-KNU5COPB.js";
@@ -665,7 +665,7 @@ async function collectTweenBoundaries(page) {
   });
 }
 async function bundleProjectHtml(projectDir) {
-  const { bundleToSingleHtml } = await import("./compiler-QMEZK6CU.js");
+  const { bundleToSingleHtml } = await import("./compiler-YYOV2BJ7.js");
   return bundleToSingleHtml(projectDir);
 }
 async function alignViewportToComposition(page, url) {
@@ -687,13 +687,13 @@ async function alignViewportToComposition(page, url) {
 async function runLayoutAudit(projectDir, opts) {
   const { ensureBrowser } = await import("./manager-NEVLEZK3.js");
   const puppeteer = await import("puppeteer-core");
-  const { buildChromeArgs } = await import("./src-QX5PPANW.js");
+  const { buildChromeArgs } = await import("./src-6R4DC2YI.js");
   const {
     assertWebGpuAdapterAvailable,
     compositionRequiresWebGpu,
     resolveCaptureBrowserGpuMode,
     resolveLocalBrowserGpuMode
-  } = await import("./gpuPolicy-BQFPO7UA.js");
+  } = await import("./gpuPolicy-KSWTVU5C.js");
   const html = await bundleProjectHtml(projectDir);
   const server = await serveStaticProjectHtml(
     projectDir,

package/dist/{chunk-M4KS6MJN.js → chunk-NJLFRKHX.js}

@@ -8,19 +8,19 @@ import {
   isAllowedHtmlAttribute,
   isSafeAttributeValue,
   sanitizeRichTextChildren
-} from "./chunk-TEXPOC5V.js";
+} from "./chunk-B25H4M4V.js";
 import {
   removeElementWithGsapCascade
-} from "./chunk-TLYU5625.js";
+} from "./chunk-UUDQD62L.js";
 import {
   EXCLUDED_TAGS,
   ensureHfIds,
   mintHfId,
   walkCompositionDescendants
-} from "./chunk-TH4APNRP.js";
+} from "./chunk-X763EUBO.js";
 import {
   require_dist
-} from "./chunk-UVUAU3CH.js";
+} from "./chunk-ONY5CJXS.js";
 import {
   readClipTiming,
   readMediaOffsetSeconds,

package/dist/{chunk-6LPWMCPY.js → chunk-NROJESOK.js}

@@ -6,8 +6,8 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 
 // src/version.ts
-var VERSION = true ? "0.8.106" : "0.0.0-dev";
-var PRODUCER_VERSION = true ? "0.8.106" : "0.0.0-dev";
+var VERSION = true ? "0.8.108" : "0.0.0-dev";
+var PRODUCER_VERSION = true ? "0.8.108" : "0.0.0-dev";
 
 export {
   VERSION,

package/dist/{chunk-UVUAU3CH.js → chunk-ONY5CJXS.js}

@@ -4006,6 +4006,28 @@ function readAttr(tagSource, attr) {
   const match = tagSource.match(new RegExp(`(?<![\\w-])${escaped}\\s*=\\s*["']([^"']+)["']`, "i"));
   return match?.[1] || null;
 }
+function hasAttrName(tagSource, attr) {
+  const escaped = attr.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const attrs = tagSource.replace(/^<\s*[a-z][\w:-]*/i, "");
+  return new RegExp(`(?:^|\\s)${escaped}(?:\\s*=|\\s|/?>)`, "i").test(attrs);
+}
+function isAudibleVideoTag(tagSource) {
+  if (hasAttrName(tagSource, "muted")) return false;
+  if (!hasAttrName(tagSource, "data-has-audio")) return true;
+  const declared = readAttr(tagSource, "data-has-audio");
+  return declared === "true";
+}
+function mediaTimeWindow(tagSource) {
+  const start = Number(readAttr(tagSource, "data-start"));
+  const duration = Number(readAttr(tagSource, "data-duration"));
+  if (!readAttr(tagSource, "data-start") || !readAttr(tagSource, "data-duration")) return null;
+  if (!Number.isFinite(start) || !Number.isFinite(duration)) return null;
+  return { start, end: start + duration };
+}
+function mediaWindowsOverlap(a, b) {
+  if (!a || !b) return true;
+  return a.start < b.end && b.start < a.end;
+}
 function readDecodedAttr(tagSource, attr) {
   if (!tagSource) return null;
   let value = null;
@@ -5243,11 +5265,6 @@ function tweensVolumeInSameCall(script, id) {
 function escapeRegExp(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function hasAttrName(tagSource, attr) {
-  const escaped = escapeRegExp(attr);
-  const attrs = tagSource.replace(/^<\s*[a-z][\w:-]*/i, "");
-  return new RegExp(`(?:^|\\s)${escaped}(?:\\s*=|\\s|/?>)`, "i").test(attrs);
-}
 var IMAGE_SRC_EXT = /* @__PURE__ */ new Set([
   "jpg",
   "jpeg",
@@ -5648,14 +5665,15 @@ var mediaRules = [
       if (tag.name !== "video") continue;
       const hasMuted = hasAttrName(tag.raw, "muted");
       const hasDeclaredAudio = readAttr(tag.raw, "data-has-audio") === "true";
-      if (!hasMuted && !hasDeclaredAudio && readAttr(tag.raw, "data-start")) {
+      const declaresAudioState = hasAttrName(tag.raw, "data-has-audio");
+      if (!hasMuted && !declaresAudioState && readAttr(tag.raw, "data-start")) {
         const elementId = readAttr(tag.raw, "id") || void 0;
         findings.push({
           code: "video_missing_muted",
           severity: "error",
-          message: `<video${elementId ? ` id="${elementId}"` : ""}> has data-start but is not muted. Mark audible videos with data-has-audio="true"; otherwise keep video muted and use a separate <audio> element for sound.`,
+          message: `<video${elementId ? ` id="${elementId}"` : ""}> has data-start but declares neither muted nor data-has-audio. If the file has sound, add data-has-audio="true" (the sound stays on this clip). If it is silent, add muted.`,
           elementId,
-          fixHint: 'Add the `muted` attribute for silent video, or add data-has-audio="true" when the video track should contribute audio.',
+          fixHint: 'Add data-has-audio="true" when the file has sound (recommended \u2014 keeps picture and sound on one clip), or add `muted` for silent footage.',
           snippet: truncateSnippet(tag.raw)
         });
       }
@@ -5881,31 +5899,31 @@ var mediaRules = [
   // <audio> pointing to the same file, which causes double playback at runtime
   ({ tags }) => {
     const findings = [];
-    const videoSources = /* @__PURE__ */ new Map();
-    const audioSources = /* @__PURE__ */ new Map();
+    const videos = [];
+    const audios = [];
     for (const tag of tags) {
       if (!readAttr(tag.raw, "data-start")) continue;
       const src = readAttr(tag.raw, "src");
       if (!src) continue;
-      const elementId = readAttr(tag.raw, "id") || void 0;
+      const source = { id: readAttr(tag.raw, "id") || void 0, raw: tag.raw };
       if (tag.name === "video") {
-        const isMuted = hasAttrName(tag.raw, "muted");
-        if (!isMuted) {
-          videoSources.set(src, { id: elementId, raw: tag.raw });
-        }
+        if (isAudibleVideoTag(tag.raw)) videos.push([src, source]);
       } else if (tag.name === "audio") {
-        audioSources.set(src, { id: elementId, raw: tag.raw });
+        audios.push([src, source]);
       }
     }
-    for (const [src, audioInfo] of audioSources) {
-      const videoInfo = videoSources.get(src);
-      if (!videoInfo) continue;
+    for (const [src, audioInfo] of audios) {
+      const match = videos.find(
+        ([videoSrc, video]) => videoSrc === src && mediaWindowsOverlap(mediaTimeWindow(video.raw), mediaTimeWindow(audioInfo.raw))
+      );
+      if (!match) continue;
+      const videoInfo = match[1];
       findings.push({
         code: "video_audio_double_source",
         severity: "error",
-        message: `<audio${audioInfo.id ? ` id="${audioInfo.id}"` : ""}> and <video${videoInfo.id ? ` id="${videoInfo.id}"` : ""}> both point to the same source. The unmuted video already provides audio \u2014 the duplicate <audio> will cause double playback and echo.`,
+        message: `<audio${audioInfo.id ? ` id="${audioInfo.id}"` : ""}> and <video${videoInfo.id ? ` id="${videoInfo.id}"` : ""}> both point to the same source at the same time. The unmuted video already provides audio \u2014 the duplicate <audio> will cause double playback and echo.`,
         elementId: audioInfo.id,
-        fixHint: "Either mute the video (add `muted` attribute) and keep the separate <audio>, or remove the <audio> element and let the video provide its own audio track.",
+        fixHint: "Remove the <audio> element and let the video carry its own sound (recommended), or mute the video (add `muted`) and keep the separate <audio> when picture and sound must be cut independently.",
         snippet: truncateSnippet(audioInfo.raw)
       });
     }
@@ -6014,7 +6032,7 @@ function findCarveUngroupedSourcesFindings(ctx) {
 var AUDIO_GROUP_TIMING_ATTRS = ["data-start", "data-duration", "data-track-index"];
 function findAudioGroupNoMembersFindings(ctx) {
   const memberGroupIds = new Set(
-    ctx.tags.filter((tag) => tag.name === "audio").map((tag) => readAttr(tag.raw, "data-audio-group")).filter((id) => Boolean(id))
+    ctx.tags.filter((tag) => tag.name === "audio" || tag.name === "video" && isAudibleVideoTag(tag.raw)).map((tag) => readAttr(tag.raw, "data-audio-group")).filter((id) => Boolean(id))
   );
   if (memberGroupIds.size === 0) return [];
   const mayHaveCrossFileMembers = ctx.tags.some(
@@ -10404,7 +10422,10 @@ function lintProjectAudioFiles(projectDir, htmlSources) {
   }
   if (audioFiles.length === 0) return findings;
   const hasAudioElement = htmlSources.some(({ html }) => /<audio\b/i.test(html));
-  if (!hasAudioElement) {
+  const hasAudibleVideo = htmlSources.some(
+    ({ html }) => (html.match(/<video\b[^>]*>/gi) ?? []).some(isAudibleVideoTag)
+  );
+  if (!hasAudioElement && !hasAudibleVideo) {
     findings.push({
       code: "audio_file_without_element",
       severity: "warning",
@@ -10554,10 +10575,11 @@ function lintDuplicateAudioTracks(htmlSources) {
   const tracks = [];
   const seen = /* @__PURE__ */ new Set();
   for (const { html } of htmlSources) {
-    const audioTagRe = /<audio\b[^>]*>/gi;
+    const soundTagRe = /<(?:audio|video)\b[^>]*>/gi;
     let match;
-    while ((match = audioTagRe.exec(html)) !== null) {
+    while ((match = soundTagRe.exec(html)) !== null) {
       const tag = match[0];
+      if (/^<video/i.test(tag) && !isAudibleVideoTag(tag)) continue;
       const trackStr = extractAttr(tag, "data-track-index");
       const startStr = extractAttr(tag, "data-start");
       const durStr = extractAttr(tag, "data-duration");
@@ -10581,7 +10603,7 @@ function lintDuplicateAudioTracks(htmlSources) {
         findings.push({
           code: "duplicate_audio_track",
           severity: "warning",
-          message: `Multiple <audio> elements on track ${a.trackIndex} overlap (${a.src} at ${a.start}-${Number.isFinite(a.end) ? a.end.toFixed(1) : "end"}s, ${b.src} at ${b.start}-${Number.isFinite(b.end) ? b.end.toFixed(1) : "end"}s). This causes layered audio playback.`,
+          message: `Multiple audible <audio>/<video> elements on track ${a.trackIndex} overlap (${a.src} at ${a.start}-${Number.isFinite(a.end) ? a.end.toFixed(1) : "end"}s, ${b.src} at ${b.start}-${Number.isFinite(b.end) ? b.end.toFixed(1) : "end"}s). This causes layered audio playback.`,
           fixHint: "Use non-overlapping time windows or different track indices."
         });
       }

package/dist/{chunk-O5TBFZ7X.js → chunk-OVRFBUXU.js}

@@ -8,7 +8,7 @@ import {
   firstFrameColourArgs,
   hdrToSdrToneMapFilter,
   parseFirstFrameColour
-} from "./chunk-TEXPOC5V.js";
+} from "./chunk-B25H4M4V.js";
 import {
   mkdirWithinProject,
   realProjectRoot,
@@ -21,7 +21,7 @@ import {
   isUnresolvedAssetPlaceholder,
   maskNonScannableRanges,
   resolveLocalAssetCandidates
-} from "./chunk-UVUAU3CH.js";
+} from "./chunk-ONY5CJXS.js";
 import {
   findFfBinary
 } from "./chunk-PJ3HDUCY.js";

package/dist/{chunk-6F6EEQNB.js → chunk-PSGDNMM6.js}

@@ -6,7 +6,7 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   resolveWritePath
-} from "./chunk-4Z5O7BTD.js";
+} from "./chunk-WEATBQTR.js";
 
 // src/cloud/download.ts
 import {