hyperframes 0.8.42 → 0.8.44

package/dist/fontLocalizeCli.js

@@ -50279,7 +50279,7 @@ function resolveAliasDisplayName(alias) {
   if (!slug) return void 0;
   return CANONICAL_FONT_DISPLAY_NAMES[slug];
 }
-var recast, import_parser2, CANVAS_DIMENSIONS, VALID_CANVAS_RESOLUTIONS, RESOLUTION_ALIASES, ASPECT_AGNOSTIC_RESOLUTION_ALIASES, PROPERTY_GROUPS, PROP_TO_GROUP, COMPOSITION_ATTRIBUTES, CANONICAL_AUTHORED_TIMING_ATTRIBUTES, DERIVED_TIMING_ATTRIBUTES, LEGACY_TIMING_ATTRIBUTES, OK, FONT_ALIAS_MAP, FONT_ALIAS_KEYS, CANONICAL_FONT_DISPLAY_NAMES;
+var recast, import_parser2, CANVAS_DIMENSIONS, VALID_CANVAS_RESOLUTIONS, RESOLUTION_ALIASES, ASPECT_AGNOSTIC_RESOLUTION_ALIASES, PROPERTY_GROUPS, PROP_TO_GROUP, COMPOSITION_ATTRIBUTES, CANONICAL_AUTHORED_TIMING_ATTRIBUTES, DERIVED_TIMING_ATTRIBUTES, LEGACY_TIMING_ATTRIBUTES, OK, HTML_BODY_CSS_WIDTH_FIRST_RE, HTML_BODY_CSS_HEIGHT_FIRST_RE, VIEWPORT_META_SIZE_RE, FONT_ALIAS_MAP, FONT_ALIAS_KEYS, CANONICAL_FONT_DISPLAY_NAMES;
 var init_dist = __esm({
   "../parsers/dist/index.js"() {
     "use strict";
@@ -50355,6 +50355,9 @@ var init_dist = __esm({
       COMPOSITION_ATTRIBUTES.legacyTrack
     ]);
     OK = { ok: true };
+    HTML_BODY_CSS_WIDTH_FIRST_RE = /(html\s*,\s*body\s*\{[^}]*?width:\s*)(\d+)px([^}]*?height:\s*)(\d+)px/i;
+    HTML_BODY_CSS_HEIGHT_FIRST_RE = /(html\s*,\s*body\s*\{[^}]*?height:\s*)(\d+)px([^}]*?width:\s*)(\d+)px/i;
+    VIEWPORT_META_SIZE_RE = /(<meta[^>]*name=["']viewport["'][^>]*content=["']width=)(\d+)(,\s*height=)(\d+)/i;
     FONT_ALIAS_MAP = {
       // ── Canonical bundled fonts (self-referencing) ────────────────────────
       inter: "inter",
@@ -60402,6 +60405,31 @@ function getEncoderPreset(quality, format = "mp4", hdr) {
   }
   return { ...base2, pixelFormat: "yuv420p" };
 }
+function resolveLockedGopSize(options) {
+  if (options.lockGopForChunkConcat !== true) return null;
+  if (typeof options.gopSize !== "number" || !Number.isFinite(options.gopSize) || options.gopSize <= 0) {
+    throw new Error(
+      `[chunkEncoder] lockGopForChunkConcat=true requires a positive integer gopSize (received ${String(options.gopSize)})`
+    );
+  }
+  return Math.floor(options.gopSize);
+}
+function appendLockedGopArgs(args, gopSize) {
+  args.push(
+    "-g",
+    String(gopSize),
+    "-keyint_min",
+    String(gopSize),
+    "-sc_threshold",
+    "0",
+    "-force_key_frames",
+    `expr:eq(mod(n,${gopSize}),0)`
+  );
+}
+function lockedGopCodecParams(codec, gopSize) {
+  const shared = "scenecut=0:open-gop=0:repeat-headers=1";
+  return codec === "h264" ? shared : `keyint=${gopSize}:min-keyint=${gopSize}:${shared}`;
+}
 function buildEncoderArgs(options, inputArgs, outputPath, gpuEncoder = null) {
   const {
     fps,
@@ -60469,36 +60497,15 @@ function buildEncoderArgs(options, inputArgs, outputPath, gpuEncoder = null) {
       args.push("-c:v", encoderName, "-preset", preset2);
       if (bitrate) args.push("-b:v", bitrate);
       else args.push("-crf", String(quality));
-      const lockGop = options.lockGopForChunkConcat === true;
-      let gop = 0;
-      if (lockGop) {
-        if (typeof options.gopSize !== "number" || !Number.isFinite(options.gopSize) || options.gopSize <= 0) {
-          throw new Error(
-            `[chunkEncoder] lockGopForChunkConcat=true requires a positive integer gopSize (received ${String(options.gopSize)})`
-          );
-        }
-        gop = Math.floor(options.gopSize);
-        args.push(
-          "-g",
-          String(gop),
-          "-keyint_min",
-          String(gop),
-          "-sc_threshold",
-          "0",
-          "-force_key_frames",
-          `expr:eq(mod(n,${gop}),0)`
-        );
-      }
+      const gop = resolveLockedGopSize(options);
+      const lockGop = gop !== null;
+      if (gop !== null) appendLockedGopArgs(args, gop);
       if (codec === "h264" || codec === "h265" && lockGop) {
         args.push("-bf", "0");
       }
       const xParamsFlag = codec === "h264" ? "-x264-params" : "-x265-params";
       const colorParams = codec === "h265" && options.hdr ? getHdrEncoderColorParams(options.hdr.transfer).x265ColorParams : "colorprim=bt709:transfer=bt709:colormatrix=bt709";
-      let gopParams = "";
-      if (lockGop) {
-        const shared = "scenecut=0:open-gop=0:repeat-headers=1";
-        gopParams = codec === "h264" ? shared : `keyint=${gop}:min-keyint=${gop}:${shared}`;
-      }
+      const gopParams = gop !== null ? lockedGopCodecParams(codec, gop) : "";
       const joinParams = (...parts) => parts.filter((p) => p.length > 0).join(":");
       if (preset2 === "ultrafast") {
         args.push(xParamsFlag, joinParams("aq-mode=3", colorParams, gopParams));
@@ -60517,15 +60524,10 @@ function buildEncoderArgs(options, inputArgs, outputPath, gpuEncoder = null) {
     args.push("-deadline", preset2 === "ultrafast" ? "realtime" : "good");
     args.push("-row-mt", "1");
     appendVp9CpuUsedArg(args, vp9CpuUsed);
-    const lockGopVp9 = options.lockGopForChunkConcat === true;
-    if (lockGopVp9) {
-      if (typeof options.gopSize !== "number" || !Number.isFinite(options.gopSize) || options.gopSize <= 0) {
-        throw new Error(
-          `[chunkEncoder] lockGopForChunkConcat=true requires a positive integer gopSize (received ${String(options.gopSize)})`
-        );
-      }
-      const gop = Math.floor(options.gopSize);
-      args.push("-g", String(gop), "-keyint_min", String(gop), "-auto-alt-ref", "0");
+    const vp9Gop = resolveLockedGopSize(options);
+    const lockGopVp9 = vp9Gop !== null;
+    if (vp9Gop !== null) {
+      args.push("-g", String(vp9Gop), "-keyint_min", String(vp9Gop), "-auto-alt-ref", "0");
     }
     if (pixelFormat === "yuva420p") {
       if (!lockGopVp9) {
@@ -61072,15 +61074,18 @@ function buildStreamingArgs(options, outputPath, gpuEncoder = null) {
       args.push("-c:v", encoderName, "-preset", preset2);
       if (bitrate) args.push("-b:v", bitrate);
       else args.push("-crf", String(quality));
-      if (codec === "h264") {
+      const lockedGop = resolveLockedGopSize(options);
+      if (lockedGop !== null) appendLockedGopArgs(args, lockedGop);
+      if (codec === "h264" || lockedGop !== null) {
         args.push("-bf", "0");
       }
       const xParamsFlag = codec === "h264" ? "-x264-params" : "-x265-params";
       const colorParams = options.rawInputFormat && options.hdr ? getHdrEncoderColorParams(options.hdr.transfer).x265ColorParams : "colorprim=bt709:transfer=bt709:colormatrix=bt709";
+      const gopParams = lockedGop !== null ? `:${lockedGopCodecParams(codec, lockedGop)}` : "";
       if (preset2 === "ultrafast") {
-        args.push(xParamsFlag, `aq-mode=3:${colorParams}`);
+        args.push(xParamsFlag, `aq-mode=3:${colorParams}${gopParams}`);
       } else {
-        args.push(xParamsFlag, `aq-mode=3:aq-strength=0.8:deblock=1,1:${colorParams}`);
+        args.push(xParamsFlag, `aq-mode=3:aq-strength=0.8:deblock=1,1:${colorParams}${gopParams}`);
       }
       if (codec === "h265") {
         args.push("-tag:v", "hvc1");
@@ -61311,6 +61316,7 @@ var init_streamingEncoder = __esm({
     init_dist2();
     init_vp9Options();
     init_renderProvenance();
+    init_chunkEncoder();
   }
 });
 
@@ -69424,6 +69430,56 @@ function findVisibleMarkupCommentLeak(source) {
   }
   return null;
 }
+function readHtmlBodyCssSize(source) {
+  const widthFirst = source.match(HTML_BODY_CSS_WIDTH_FIRST_RE);
+  if (widthFirst) {
+    const [, , width = "", , height = ""] = widthFirst;
+    return { width, height };
+  }
+  const heightFirst = source.match(HTML_BODY_CSS_HEIGHT_FIRST_RE);
+  if (heightFirst) {
+    const [, , height = "", , width = ""] = heightFirst;
+    return { width, height };
+  }
+  return null;
+}
+function readViewportMetaSize(source) {
+  const match = source.match(VIEWPORT_META_SIZE_RE);
+  if (!match) return null;
+  const [, , width = "", , height = ""] = match;
+  return { width, height };
+}
+function describeSizeMismatch(label, size, dataWidth, dataHeight) {
+  if (!size || size.width === dataWidth && size.height === dataHeight) return null;
+  return `${label} is ${size.width}x${size.height}`;
+}
+function describeRootDimensionsDrift(source, dataWidth, dataHeight) {
+  const bodyCssMismatch = describeSizeMismatch(
+    "html/body CSS",
+    readHtmlBodyCssSize(source),
+    dataWidth,
+    dataHeight
+  );
+  const viewportMismatch = describeSizeMismatch(
+    "the viewport meta",
+    readViewportMetaSize(source),
+    dataWidth,
+    dataHeight
+  );
+  if (!bodyCssMismatch && !viewportMismatch) return null;
+  const declared = `Root composition declares data-width="${dataWidth}" data-height="${dataHeight}"`;
+  if (!bodyCssMismatch) {
+    return {
+      message: `${declared}, but ${viewportMismatch}. The viewport meta has no effect on capture \u2014 the renderer sizes the viewport from the root's own data-width/data-height \u2014 so this is stale metadata, not a clipping risk.`,
+      fixHint: "update the meta viewport to match, or scaffold with `hyperframes init --resolution portrait`"
+    };
+  }
+  const mismatches = viewportMismatch ? `${bodyCssMismatch} and ${viewportMismatch}` : bodyCssMismatch;
+  return {
+    message: `${declared}, but ${mismatches}. The scaffolded body clips the composition at its old size.`,
+    fixHint: "update html/body CSS and the meta viewport to match, or scaffold with `hyperframes init --resolution portrait`"
+  };
+}
 function tweensVolumeInSameCall(script, id) {
   const selector = new RegExp(`#${escapeRegExp3(id)}(?![\\w-])`, "g");
   for (let hit = selector.exec(script); hit; hit = selector.exec(script)) {
@@ -70920,6 +70976,7 @@ var init_dist3 = __esm({
     "use strict";
     init_esm6();
     import_postcss_selector_parser = __toESM(require_dist(), 1);
+    init_dist();
     init_colorGradingContract();
     init_dist();
     init_esm10();
@@ -71031,6 +71088,39 @@ var init_dist3 = __esm({
         }
         return findings;
       },
+      // root_dimensions_mismatch
+      //
+      // Render size and the runtime's forced #root size both read the root's own
+      // data-width/data-height, so they stay correct. But editing only those two
+      // attributes — rather than scaffolding with `hyperframes init --resolution`,
+      // which rewrites the scaffold's other copies of the resolution too — leaves
+      // the `html, body` CSS and the `<meta viewport>` at the old value, and a
+      // stale body with `overflow: hidden` visually clips the correctly-sized
+      // root. `hyperframes check`'s layout audits can't see it: they measure
+      // against the root's own (already-correct) rect, not the body's.
+      //
+      // Sub-compositions are exempt: loadExternalCompositions (packages/core/src/
+      // runtime/compositionLoader.ts) mounts only the matched <template>/<body>
+      // subtree, so a sub-comp's own <html>/<head>/<meta viewport> never reach
+      // the rendering document, even when it's a full standalone document.
+      ({ rootTag, source, options }) => {
+        if (!rootTag || options.isSubComposition) return [];
+        const dataWidth = readAttr(rootTag.raw, "data-width");
+        const dataHeight = readAttr(rootTag.raw, "data-height");
+        if (!dataWidth || !dataHeight) return [];
+        const drift = describeRootDimensionsDrift(source, dataWidth, dataHeight);
+        if (!drift) return [];
+        return [
+          {
+            code: "root_dimensions_mismatch",
+            severity: "warning",
+            message: drift.message,
+            elementId: readAttr(rootTag.raw, "id") || void 0,
+            fixHint: drift.fixHint,
+            snippet: truncateSnippet(rootTag.raw)
+          }
+        ];
+      },
       // unbalanced_style_tags
       ({ source }) => {
         let opens = 0;
@@ -87124,6 +87214,9 @@ function aggregateDrawElement(perfs, de) {
     preInversionWorkers: de.preInversionWorkers,
     compositionElementCount: de.compositionElementCount,
     compositionElementCountSource: de.compositionElementCountSource,
+    compositionElementTags: de.compositionElementTags,
+    arollVideoCount: de.arollVideoCount,
+    heygenVideoCount: de.heygenVideoCount,
     shortBand: de.shortBand,
     parallelRouter: de.parallelRouter ?? "none",
     preRouterWorkers: de.preRouterWorkers,
@@ -96743,16 +96836,31 @@ function envInt(name, fallback) {
   const parsed = Number(raw);
   return Number.isInteger(parsed) ? parsed : fallback;
 }
-function countElementTags(html) {
+var MAX_REPORTED_ELEMENT_TAGS = 50;
+function scanElementTags(html) {
   let markup = html;
   for (let previous = ""; markup !== previous; ) {
     previous = markup;
     markup = markup.replace(/<(script|style)\b[^>]*>[\s\S]*?<\/\1>/gi, "");
   }
-  const matches2 = markup.match(
-    /<\/[a-zA-Z]|<(?:img|br|hr|input|source|track|area|base|col|embed|link|meta|param|wbr)\b|<[a-zA-Z][-a-zA-Z0-9]*\b[^>]*\/>/gi
+  let total = 0;
+  const counts = /* @__PURE__ */ new Map();
+  for (const m of markup.matchAll(
+    /<\/([a-zA-Z][-a-zA-Z0-9]*)|<(img|br|hr|input|source|track|area|base|col|embed|link|meta|param|wbr)\b|<([a-zA-Z][-a-zA-Z0-9]*)\b[^>]*\/>/gi
+  )) {
+    total++;
+    const tag = (m[1] ?? m[2] ?? m[3] ?? "").toLowerCase();
+    counts.set(tag, (counts.get(tag) ?? 0) + 1);
+  }
+  const ranked = [...counts.entries()].sort((a, b) => b[1] - a[1]);
+  const byTag = Object.fromEntries(
+    ranked.slice(0, MAX_REPORTED_ELEMENT_TAGS)
   );
-  return matches2 === null ? 0 : matches2.length;
+  const otherCount = ranked.slice(MAX_REPORTED_ELEMENT_TAGS).reduce((sum, [, count]) => sum + count, 0);
+  if (otherCount > 0) byTag.other = (byTag.other ?? 0) + otherCount;
+  const arollVideoCount = markup.match(/<video\b[^>]*\bdata-aroll=["']true["'][^>]*>/gi)?.length ?? 0;
+  const heygenVideoCount = markup.match(/<video\b[^>]*\bdata-media-source=["']heygen["'][^>]*>/gi)?.length ?? 0;
+  return { total, byTag, arollVideoCount, heygenVideoCount };
 }
 async function resolveCompositionElementCount(probeSession, html) {
   if (probeSession?.isInitialized) {
@@ -96768,7 +96876,14 @@ async function resolveCompositionElementCount(probeSession, html) {
     } catch {
     }
   }
-  return { count: countElementTags(html), source: "static" };
+  const scan = scanElementTags(html);
+  return {
+    count: scan.total,
+    source: "static",
+    byTag: scan.byTag,
+    arollVideoCount: scan.arollVideoCount,
+    heygenVideoCount: scan.heygenVideoCount
+  };
 }
 function mergeWorkerInitObservability(perfs) {
   let initDurationMs;
@@ -97426,7 +97541,13 @@ async function executeRenderPipeline(input) {
     const deSingleMinFrames = Number.isFinite(deSingleMinFramesNum) ? deSingleMinFramesNum : 900;
     const deShortBandMinFrames = envInt("HF_DE_SHORT_MIN_FRAMES", 250);
     const deShortBandMaxElements = envInt("HF_DE_SHORT_MAX_ELEMENTS", 2500);
-    const { count: compositionElementCount, source: compositionElementCountSource } = await resolveCompositionElementCount(probeSession, compiled.html);
+    const {
+      count: compositionElementCount,
+      source: compositionElementCountSource,
+      byTag: compositionElementTags,
+      arollVideoCount,
+      heygenVideoCount
+    } = await resolveCompositionElementCount(probeSession, compiled.html);
     const deShortBandEnabled = deShortBandMaxElements > 0;
     const deShortBandOpen = deShortBandEnabled && deShortBandMinFrames > 0 && compositionElementCountSource === "live" && compositionElementCount <= deShortBandMaxElements;
     const deShortBandRoute = process.env.HF_DE_SHORT_BAND_ROUTE === "true";
@@ -97620,6 +97741,9 @@ async function executeRenderPipeline(input) {
       // perf shift can be split into "the new band did it" vs "unchanged".
       compositionElementCount,
       compositionElementCountSource,
+      compositionElementTags,
+      arollVideoCount,
+      heygenVideoCount,
       deShortBand,
       // Same rationale as the counters above: carried on live capture
       // observability, not only the success-path perfSummary, so a crash /
@@ -98284,6 +98408,9 @@ async function executeRenderPipeline(input) {
         preInversionWorkers: deWorkerInversion ? preRoutingWorkerCount : void 0,
         compositionElementCount,
         compositionElementCountSource,
+        compositionElementTags,
+        arollVideoCount,
+        heygenVideoCount,
         shortBand: deShortBand,
         parallelRouter: deParallelRouter,
         preRouterWorkers: deParallelRouter ? preRoutingWorkerCount : void 0,
@@ -99706,8 +99833,8 @@ async function runFontLocalize(io, localize) {
 }
 
 // src/version.ts
-var VERSION = true ? "0.8.42" : "0.0.0-dev";
-var PRODUCER_VERSION = true ? "0.8.42" : "0.0.0-dev";
+var VERSION = true ? "0.8.44" : "0.0.0-dev";
+var PRODUCER_VERSION = true ? "0.8.44" : "0.0.0-dev";
 
 // src/fontLocalizeCli.ts
 async function readStdin() {