hyperframes 0.8.48 → 0.8.50

package/dist/fontLocalizeCli.js

@@ -55501,7 +55501,7 @@ function buildChromeArgs(options, config) {
     // frame-capture loop then blocks waiting for it, deadlocking the render.
     "--autoplay-policy=no-user-gesture-required"
   ];
-  if (browserGpuMode !== "software") {
+  if (browserGpuMode !== "software" || options.requiresWebGpu) {
     chromeArgs.push(WEBGPU_FLAG);
   }
   if (browserGpuMode === "software") {
@@ -55525,6 +55525,28 @@ function buildChromeArgs(options, config) {
   }
   return chromeArgs;
 }
+function compositionRequiresWebGpu(html) {
+  for (const [tag] of html.matchAll(/<(?:[^<>"']|"[^"]*"|'[^']*')*>/g)) {
+    if (/\bdata-composition-id\b/i.test(tag)) return /\bdata-requires-webgpu(?:\s|=|>)/i.test(tag);
+  }
+  return false;
+}
+async function assertWebGpuAdapterAvailable(page, requiresWebGpu) {
+  if (!requiresWebGpu) return;
+  const hasUsableAdapter = await page.evaluate(async (timeoutMs) => {
+    if (typeof navigator === "undefined" || !navigator.gpu) return false;
+    try {
+      const adapter2 = await Promise.race([
+        navigator.gpu.requestAdapter(),
+        new Promise((resolve18) => setTimeout(() => resolve18(null), timeoutMs))
+      ]);
+      return !!adapter2 && !adapter2.info.isFallbackAdapter;
+    } catch {
+      return false;
+    }
+  }, WEBGPU_ADAPTER_PROBE_TIMEOUT_MS);
+  if (!hasUsableAdapter) throw new WebGpuUnavailableError();
+}
 function getBrowserGpuArgs(mode, platform3) {
   if (mode === "software") {
     return ["--use-gl=angle", "--use-angle=swiftshader", "--enable-unsafe-swiftshader"];
@@ -55549,7 +55571,7 @@ function getBrowserGpuArgs(mode, platform3) {
       return ["--enable-gpu-rasterization"];
   }
 }
-var _puppeteer, CACHED_HEADLESS_SHELL_EXECUTABLES, ENABLE_BROWSER_POOL, BEGINFRAME_ONLY_FLAGS, BEGINFRAME_SCREENSHOT_PROBE_ATTEMPTS, BEGINFRAME_PROBE_TIMEOUT_MS, BEGINFRAME_PROBE_CLEANUP_TIMEOUT_MS, _autoBrowserGpuModeCache, _unverifiedHardwareGpuWarned, browserLeasePool, _cachedVramMb, CANVAS_DRAW_ELEMENT_FEATURE_FLAG, WEBGPU_FLAG;
+var _puppeteer, CACHED_HEADLESS_SHELL_EXECUTABLES, ENABLE_BROWSER_POOL, BEGINFRAME_ONLY_FLAGS, BEGINFRAME_SCREENSHOT_PROBE_ATTEMPTS, BEGINFRAME_PROBE_TIMEOUT_MS, BEGINFRAME_PROBE_CLEANUP_TIMEOUT_MS, _autoBrowserGpuModeCache, _unverifiedHardwareGpuWarned, browserLeasePool, _cachedVramMb, CANVAS_DRAW_ELEMENT_FEATURE_FLAG, WEBGPU_FLAG, WebGpuUnavailableError, WEBGPU_ADAPTER_PROBE_TIMEOUT_MS;
 var init_browserManager = __esm({
   "../engine/src/services/browserManager.ts"() {
     "use strict";
@@ -55588,6 +55610,15 @@ var init_browserManager = __esm({
     _cachedVramMb = null;
     CANVAS_DRAW_ELEMENT_FEATURE_FLAG = "--enable-features=CanvasDrawElement";
     WEBGPU_FLAG = "--enable-unsafe-webgpu";
+    WebGpuUnavailableError = class extends Error {
+      constructor() {
+        super(
+          "This composition declares data-requires-webgpu, but no hardware WebGPU adapter could be obtained on this browser launch (a software fallback adapter such as swiftshader reports one but cannot render it). Run on a host with a GPU, or remove data-requires-webgpu."
+        );
+        this.name = "WebGpuUnavailableError";
+      }
+    };
+    WEBGPU_ADAPTER_PROBE_TIMEOUT_MS = 1e4;
   }
 });
 
@@ -59198,8 +59229,9 @@ async function createCaptureSession(serverUrl, outputDir, options, onBeforeCaptu
     config
   );
   const preMode = headlessShell && isLinux && !effectiveForceScreenshot && !supersampling && !drawElementTransparent ? "beginframe" : "screenshot";
+  const requiresWebGpu = options.requiresWebGpu ?? await fetch(`${serverUrl}/index.html`, { signal: AbortSignal.timeout(5e3) }).then((res) => res.text()).then(compositionRequiresWebGpu).catch(() => false);
   const chromeArgs = buildChromeArgs(
-    { width: options.width, height: options.height, captureMode: preMode },
+    { width: options.width, height: options.height, captureMode: preMode, requiresWebGpu },
     { ...config, browserGpuMode: resolvedGpuMode }
   );
   const browserLease = await acquireBrowser(chromeArgs, config);
@@ -59210,7 +59242,8 @@ async function createCaptureSession(serverUrl, outputDir, options, onBeforeCaptu
     options,
     onBeforeCapture,
     config,
-    useDrawElement
+    useDrawElement,
+    requiresWebGpu
   });
 }
 async function constructCaptureSessionWithRollback(input) {
@@ -59259,6 +59292,7 @@ async function constructCaptureSession(input) {
     onBeforeCapture,
     config,
     useDrawElement,
+    requiresWebGpu,
     onPageCreated
   } = input;
   const { browser, captureMode } = browserLease;
@@ -59321,6 +59355,7 @@ async function constructCaptureSession(input) {
     serverUrl,
     outputDir,
     onBeforeCapture,
+    requiresWebGpu,
     isInitialized: false,
     browserConsoleBuffer: [],
     scriptLoadFailures: [],
@@ -59367,6 +59402,16 @@ function formatConsoleDiagnostic(type, text, locationUrl) {
 }
 function buildZeroDurationDiagnostic(diag) {
   const hints = [];
+  if (diag.pendingBuildReadyKeys.length > 0) {
+    hints.push(
+      `window.__hf.buildReady never resolved for: ${diag.pendingBuildReadyKeys.join(", ")}. The runtime holds render-ready until every registered buildReady promise settles \u2014 find where the composition registers that key and confirm it actually resolves.`
+    );
+  }
+  if (diag.rejectedBuildReadyKeys.length > 0) {
+    hints.push(
+      `window.__hf.buildReady rejected for: ${diag.rejectedBuildReadyKeys.join(", ")}. That key's build promise failed rather than hanging \u2014 find why it rejects.`
+    );
+  }
   if (!diag.hasPlayer) {
     hints.push("window.__player was never set \u2014 the HyperFrames runtime did not initialize.");
   }
@@ -59764,6 +59809,7 @@ async function initializeSession(session) {
       );
       throw error;
     }
+    await assertWebGpuAdapterAvailable(page, session.requiresWebGpu ?? false);
   };
   if (session.captureMode === "screenshot") {
     await gotoEntryPage();
@@ -61198,7 +61244,7 @@ var init_frameCapture = __esm({
     BEGIN_FRAME_CAPTURE_HEADROOM_INTERVALS = 10;
     BEGIN_FRAME_COMMIT_LEAD_INTERVALS = 6;
     BEGIN_FRAME_PROBE_LEAD_INTERVALS = 5;
-    HF_READY_DIAGNOSTIC_EXPR = `(function() {
+    HF_READY_DIAGNOSTIC_EXPR = `(async function() {
   var hf = window.__hf;
   var player = window.__player;
   var renderReady = !!window.__renderReady;
@@ -61207,6 +61253,26 @@ var init_frameCapture = __esm({
   var hasTimeline = !!(window.__timelines && Object.keys(window.__timelines).length > 0);
   var root = document.querySelector("[data-composition-id]");
   var declaredDuration = root ? Number(root.getAttribute("data-duration")) : -1;
+  var registry = (window.__hf && window.__hf.buildReady) || {};
+  var keys = Object.keys(registry);
+  // A microtask race mis-sorts a non-native thenable (extra adoption tick)
+  // and rejects the whole expression on a rejected entry. Settling each
+  // key onto its own record and waiting one macrotask avoids both.
+  var settled = {};
+  if (keys.length > 0) {
+    keys.forEach(function(key) {
+      Promise.resolve(registry[key]).then(
+        function() { settled[key] = "resolved"; },
+        function() { settled[key] = "rejected"; },
+      );
+    });
+    await new Promise(function(r) { setTimeout(r, 0); });
+  }
+  // A thenable resolving via its own setTimeout(0) can still misreport as
+  // pending here (macrotask registration order, not resolution order) \u2014 a
+  // narrow case that self-corrects on the next ~1s diagnostic tick.
+  var pendingBuildReadyKeys = keys.filter(function(key) { return !settled[key]; });
+  var rejectedBuildReadyKeys = keys.filter(function(key) { return settled[key] === "rejected"; });
   return {
     renderReady: renderReady,
     hasHf: !!hf,
@@ -61215,6 +61281,8 @@ var init_frameCapture = __esm({
     duration: duration,
     hasTimeline: hasTimeline,
     declaredDuration: declaredDuration,
+    pendingBuildReadyKeys: pendingBuildReadyKeys,
+    rejectedBuildReadyKeys: rejectedBuildReadyKeys,
   };
 })()`;
     LIVE_MAP_MARKERS = [
@@ -64557,6 +64625,37 @@ var init_htmlCompiler = __esm({
   }
 });
 
+// ../core/dist/compiler/scriptRuns.js
+function isClassicInline(el) {
+  const type = (el.getAttribute("type") || "").trim().toLowerCase();
+  return !type || type === "text/javascript" || type === "application/javascript";
+}
+function isSeparateExecution(el, isPinned) {
+  return el.hasAttribute("src") || isPinned(el) || (el.getAttribute("type") || "").trim().toLowerCase() === "module";
+}
+function inlineScriptRuns(scripts, isPinned = () => false) {
+  const runs = [];
+  let members = [];
+  for (const el of scripts) {
+    if (isSeparateExecution(el, isPinned)) {
+      if (members.length === 0)
+        continue;
+      runs.push({ members, anchor: el });
+      members = [];
+    } else if (isClassicInline(el)) {
+      members.push(el);
+    }
+  }
+  if (members.length > 0)
+    runs.push({ members, anchor: null });
+  return runs;
+}
+var init_scriptRuns = __esm({
+  "../core/dist/compiler/scriptRuns.js"() {
+    "use strict";
+  }
+});
+
 // ../core/dist/compiler/externalScripts.js
 function readExternalScriptAttributes(el) {
   const attributes2 = {};
@@ -65200,8 +65299,15 @@ function wrapScopedCompositionScript(source, compositionId, errorLabel = "[Hyper
       })
     : window;
   var __hfResolveGsapTarget = function(target) {
-    if (typeof target !== "string") return target;
-    return __hfQueryAll(target);
+    if (typeof target === "string") return __hfQueryAll(target);
+    if (!Array.isArray(target)) return target;
+    return target.reduce(function(resolved, item) {
+      if (typeof item === "string") {
+        return resolved.concat(Array.prototype.slice.call(__hfQueryAll(item)));
+      }
+      resolved.push(item);
+      return resolved;
+    }, []);
   };
   var __hfScopeTimeline = function(timeline) {
     if (!timeline || timeline.__hfScopedCompositionRoot === __hfFindRoot()) return timeline;
@@ -68956,6 +69062,46 @@ var require_dist = __commonJS({
   }
 });
 
+// ../parsers/dist/topLevelElements.js
+function isSubCompositionHost(node) {
+  return node.attrs["data-composition-src"] !== void 0 || node.attrs["data-composition-id"] !== void 0;
+}
+function isTimedElement(node) {
+  const { attrs } = node;
+  return attrs["data-start"] !== void 0 || attrs["data-track-index"] !== void 0 && attrs["data-duration"] !== void 0 || MEDIA_TAGS.has(node.tag.toLowerCase());
+}
+function topLevelElements(root) {
+  const rows = [];
+  const visit = (node) => {
+    if (NON_RENDERED_TAGS.has(node.tag.toLowerCase())) return;
+    if (isSubCompositionHost(node) || isTimedElement(node)) rows.push(node);
+    else node.children.forEach(visit);
+  };
+  root.children.forEach(visit);
+  return rows;
+}
+function trackKindOf(node) {
+  const explicit = node.attrs["data-track-kind"]?.trim().toLowerCase();
+  if (explicit && TRACK_KINDS.includes(explicit))
+    return { kind: explicit, source: "attribute" };
+  const tag = node.tag.toLowerCase();
+  if (tag === "video" || tag === "audio") return { kind: tag, source: "tag" };
+  if (isSubCompositionHost(node)) {
+    const legacy = node.attrs["data-composition-id"] === "captions" || /(?:^|\s)caption[-_]/.test(node.attrs.class ?? "");
+    return legacy ? { kind: "captions", source: "legacy-captions" } : { kind: "graphics", source: "sub-composition" };
+  }
+  return { kind: "graphics", source: "tag" };
+}
+var NON_RENDERED_TAGS, MEDIA_TAGS, TRACK_KINDS;
+var init_topLevelElements = __esm({
+  "../parsers/dist/topLevelElements.js"() {
+    "use strict";
+    NON_RENDERED_TAGS = /* @__PURE__ */ new Set(["script", "style", "template", "noscript", "link", "meta"]);
+    MEDIA_TAGS = /* @__PURE__ */ new Set(["video", "audio", "img"]);
+    TRACK_KINDS = ["video", "audio", "captions", "graphics"];
+  }
+});
+
 // ../parsers/dist/assetResolution.js
 function hasUnresolvedTemplatingToken(url) {
   return /<<[^<>]+>>|\{\{[^{}]+\}\}|\$\{[^{}]+\}/.test(url);
@@ -73081,6 +73227,94 @@ function extractScenesFromClips(ctx) {
   collectCompositionIdScenes(ctx, seen, scenes);
   return scenes;
 }
+function toNode(open) {
+  const attrs = {};
+  for (const name of NODE_ATTRS) attrs[name] = readDecodedAttr(open.raw, name) ?? void 0;
+  return { tag: open.name, attrs, children: [], open };
+}
+function enclosing(stack, root, index) {
+  let top = stack.at(-1);
+  while (top && stack.length > 1 && index >= top.end) {
+    stack.pop();
+    top = stack.at(-1);
+  }
+  return top?.node ?? root;
+}
+function buildTree(ctx) {
+  const { rootTag } = ctx;
+  const rootEnd = rootTag?.closeIndex;
+  if (!rootTag || rootEnd == null) return null;
+  const root = toNode(rootTag);
+  const stack = [{ node: root, end: rootEnd }];
+  for (const tag of ctx.tags.filter((t) => t.index > rootTag.index && t.index < rootEnd)) {
+    const node = toNode(tag);
+    enclosing(stack, root, tag.index).children.push(node);
+    if (tag.closeIndex != null) stack.push({ node, end: tag.closeIndex });
+  }
+  return root;
+}
+function hasNestedStructure(node) {
+  if (OPAQUE_TAGS.has(node.tag)) return null;
+  for (const child of node.children) {
+    if (NON_LAYOUT_TAGS.has(child.tag)) continue;
+    if (!INLINE_TEXT_TAGS.has(child.tag)) return child;
+    const deeper = hasNestedStructure(child);
+    if (deeper) return deeper;
+  }
+  return null;
+}
+function nestedStructureFindings(rows, severity) {
+  return rows.flatMap((row) => {
+    const nested = isSubCompositionHost(row) ? null : hasNestedStructure(row);
+    if (!nested) return [];
+    return [
+      {
+        code: "nested_structure_needs_subcomposition",
+        severity,
+        message: `${describe(row)} is a timeline element that contains nested ${describe(nested)}. The timeline shows one row per top-level element, and the root composition is built only from sub-compositions.`,
+        elementId: row.attrs.id,
+        fixHint: `Move ${describe(row)} and its contents into a sub-composition file and mount it with data-composition-src.`
+      }
+    ];
+  });
+}
+function missingDurationFindings(rows, severity) {
+  const intendedClip = (row) => !MEDIA_TAGS2.has(row.tag) || row.attrs["data-start"] !== void 0 || row.attrs["data-track-index"] !== void 0;
+  return rows.filter(
+    (row) => row.attrs["data-duration"] === void 0 && row.attrs["data-end"] === void 0 && !isSubCompositionHost(row) && intendedClip(row)
+  ).map((row) => {
+    const isMedia = MEDIA_TAGS2.has(row.tag);
+    return {
+      code: isMedia ? "media_missing_duration" : "timeline_element_missing_timing",
+      severity,
+      message: isMedia ? `${describe(row)} is media on the timeline without data-duration, so its clip has no length.` : `${describe(row)} is a timeline element without data-duration, so the timeline cannot draw where it ends.`,
+      elementId: row.attrs.id,
+      fixHint: `Add data-duration (in seconds) to ${describe(row)}.`
+    };
+  });
+}
+function captionFindings(rows, severity) {
+  const captionRows = rows.filter((row) => trackKindOf(row).kind === "captions");
+  const findings = captionRows.filter((row) => trackKindOf(row).source === "legacy-captions").map((row) => ({
+    code: "caption_track_kind_missing",
+    severity,
+    message: `${describe(row)} looks like captions but is not marked as such, so the timeline cannot group it on the caption track.`,
+    elementId: row.attrs.id,
+    fixHint: `Add data-track-kind="captions" to ${describe(row)}.`
+  }));
+  const lanes = new Set(
+    captionRows.flatMap((row) => row.attrs["data-track-index"] ?? row.attrs["data-track"] ?? [])
+  );
+  if (lanes.size > 1) {
+    findings.push({
+      code: "multiple_caption_tracks",
+      severity,
+      message: `Captions are spread across ${lanes.size} timeline tracks. Keep all captions on one track.`,
+      fixHint: "Give every caption element the same data-track-index."
+    });
+  }
+  return findings;
+}
 function dedupeKeyFor(finding) {
   return [
     finding.code,
@@ -73135,7 +73369,7 @@ async function lintHyperframeHtml(html, options = {}) {
     timings: { totalMs: performance.now() - startedAt, ...timings }
   };
 }
-var import_postcss_selector_parser, COMPOSITION_ID_IN_CSS_PATTERN, TIMELINE_REGISTRY_INIT_PATTERN, TIMELINE_REGISTRY_OBJECT_LITERAL_PATTERN, TIMELINE_REGISTRY_ASSIGN_PATTERN, WINDOW_TIMELINE_ASSIGN_PATTERN, INVALID_SCRIPT_CLOSE_PATTERN, TIMELINE_REGISTRY_KEY_PATTERN, TIMELINE_REGISTRY_OBJECT_OPEN_PATTERN, TIMELINE_REGISTRY_OBJECT_ENTRY_PATTERN, REGEX_ALLOWED_BEFORE, REGEX_ALLOWED_KEYWORDS, WORD_CHAR, CodeContext, VISIBLE_MARKUP_COMMENT_PATTERN, VISIBLE_MARKUP_COMMENT_PROTECTED_BLOCK_PATTERN, coreRules, IMAGE_SRC_EXT, VIDEO_SRC_EXT, AUDIO_SRC_EXT, SRC_KIND_NOUN, mediaRules, AUDIO_GROUP_TIMING_ATTRS, MAX_COMPOSITION_LINES, MAX_TIMED_ELEMENTS_PER_TRACK, TRACK_DENSITY_EXEMPT_TAGS, CAPTION_CUE_TOKEN, HEAVY_OVERLAY_ELEMENT_COUNT_WARN, HEAVY_OVERLAY_EXEMPT_TAGS, HEAVY_OVERLAY_CSS_PATTERN, INLINE_STYLE_DISPLAY_NONE_PATTERN, compositionRules, SCENE_BOUNDARY_EPSILON_SECONDS, UNRESOLVED_TARGET, gsapWindowsCache, CONFLICTING_TRANSLATE_PROPS, CONFLICTING_SCALE_PROPS, RELATIVE_TWEEN_VALUE, TRANSFORM_SENSITIVE_READ, TRANSFORM_INVARIANT_READ, CALLBACK_MEASUREMENT_PATTERN, NUMBER_METHODS, gsapRules, captionRules, adapterRules, TEXTURE_BASE_CLASS, TEXTURE_CLASS_PREFIX, textureRules, GENERIC_FAMILIES, fontRules, slideshowRules, RULE_GROUPS, LINT_RULE_COUNT, LINT_RULE_GROUP_COUNTS;
+var import_postcss_selector_parser, COMPOSITION_ID_IN_CSS_PATTERN, TIMELINE_REGISTRY_INIT_PATTERN, TIMELINE_REGISTRY_OBJECT_LITERAL_PATTERN, TIMELINE_REGISTRY_ASSIGN_PATTERN, WINDOW_TIMELINE_ASSIGN_PATTERN, INVALID_SCRIPT_CLOSE_PATTERN, TIMELINE_REGISTRY_KEY_PATTERN, TIMELINE_REGISTRY_OBJECT_OPEN_PATTERN, TIMELINE_REGISTRY_OBJECT_ENTRY_PATTERN, REGEX_ALLOWED_BEFORE, REGEX_ALLOWED_KEYWORDS, WORD_CHAR, CodeContext, VISIBLE_MARKUP_COMMENT_PATTERN, VISIBLE_MARKUP_COMMENT_PROTECTED_BLOCK_PATTERN, coreRules, IMAGE_SRC_EXT, VIDEO_SRC_EXT, AUDIO_SRC_EXT, SRC_KIND_NOUN, mediaRules, AUDIO_GROUP_TIMING_ATTRS, MAX_COMPOSITION_LINES, MAX_TIMED_ELEMENTS_PER_TRACK, TRACK_DENSITY_EXEMPT_TAGS, CAPTION_CUE_TOKEN, HEAVY_OVERLAY_ELEMENT_COUNT_WARN, HEAVY_OVERLAY_EXEMPT_TAGS, HEAVY_OVERLAY_CSS_PATTERN, INLINE_STYLE_DISPLAY_NONE_PATTERN, compositionRules, SCENE_BOUNDARY_EPSILON_SECONDS, UNRESOLVED_TARGET, gsapWindowsCache, CONFLICTING_TRANSLATE_PROPS, CONFLICTING_SCALE_PROPS, RELATIVE_TWEEN_VALUE, TRANSFORM_SENSITIVE_READ, TRANSFORM_INVARIANT_READ, CALLBACK_MEASUREMENT_PATTERN, NUMBER_METHODS, gsapRules, captionRules, adapterRules, TEXTURE_BASE_CLASS, TEXTURE_CLASS_PREFIX, textureRules, GENERIC_FAMILIES, fontRules, slideshowRules, INLINE_TEXT_TAGS, OPAQUE_TAGS, NON_LAYOUT_TAGS, MEDIA_TAGS2, NODE_ATTRS, describe, structureRules, RULE_GROUPS, LINT_RULE_COUNT, LINT_RULE_GROUP_COUNTS;
 var init_dist3 = __esm({
   "../lint/dist/index.js"() {
     "use strict";
@@ -73149,6 +73383,7 @@ var init_dist3 = __esm({
     init_compositionContract();
     init_composition();
     init_slideshow();
+    init_topLevelElements();
     init_esm10();
     init_esm10();
     COMPOSITION_ID_IN_CSS_PATTERN = /\[data-composition-id=["']([^"']+)["']\]/g;
@@ -76224,6 +76459,64 @@ ${other.raw}`)
         return findings;
       }
     ];
+    INLINE_TEXT_TAGS = /* @__PURE__ */ new Set([
+      "br",
+      "wbr",
+      "b",
+      "i",
+      "u",
+      "s",
+      "em",
+      "strong",
+      "small",
+      "sub",
+      "sup",
+      "mark",
+      "span",
+      "a",
+      "code",
+      "abbr"
+    ]);
+    OPAQUE_TAGS = /* @__PURE__ */ new Set([
+      "svg",
+      "canvas",
+      "picture",
+      "video",
+      "audio",
+      "select",
+      "textarea",
+      "iframe",
+      "object"
+    ]);
+    NON_LAYOUT_TAGS = /* @__PURE__ */ new Set(["style", "script", "template", "noscript"]);
+    MEDIA_TAGS2 = /* @__PURE__ */ new Set(["img", "video", "audio"]);
+    NODE_ATTRS = [
+      "id",
+      "class",
+      "data-start",
+      "data-duration",
+      "data-end",
+      "data-track",
+      "data-track-index",
+      "data-track-kind",
+      "data-composition-id",
+      "data-composition-src"
+    ];
+    describe = (node) => `<${node.tag}${node.attrs.id ? ` id="${node.attrs.id}"` : ""}>`;
+    structureRules = [
+      (ctx) => {
+        if (ctx.options.isSubComposition) return [];
+        const root = buildTree(ctx);
+        if (!root) return [];
+        const severity = ctx.options.host === "studio" ? "error" : "warning";
+        const rows = topLevelElements(root);
+        return [
+          ...nestedStructureFindings(rows, severity),
+          ...missingDurationFindings(rows, severity),
+          ...captionFindings(rows, severity)
+        ];
+      }
+    ];
     RULE_GROUPS = [
       { group: "core", rules: coreRules },
       { group: "media", rules: mediaRules },
@@ -76233,7 +76526,8 @@ ${other.raw}`)
       { group: "adapters", rules: adapterRules },
       { group: "textures", rules: textureRules },
       { group: "fonts", rules: fontRules },
-      { group: "slideshow", rules: slideshowRules }
+      { group: "slideshow", rules: slideshowRules },
+      { group: "structure", rules: structureRules }
     ];
     LINT_RULE_COUNT = RULE_GROUPS.reduce((n, g) => n + g.rules.length, 0);
     LINT_RULE_GROUP_COUNTS = Object.fromEntries(
@@ -76675,6 +76969,7 @@ var MAX_INLINE_ASSET_BYTES;
 var init_htmlBundler = __esm({
   "../core/dist/compiler/htmlBundler.js"() {
     "use strict";
+    init_scriptRuns();
     init_externalScripts();
     init_flattenedRoot();
     init_flattenedRoot();
@@ -76715,6 +77010,7 @@ var init_compiler = __esm({
     init_getVariables();
     init_htmlParityContract();
     init_htmlDocument();
+    init_scriptRuns();
     init_staticGuard();
     init_compositionScoping();
     init_inlineSubCompositions();
@@ -82515,6 +82811,7 @@ __export(src_exports, {
   TRANSITIONS: () => TRANSITIONS,
   VIDEO_FRAME_FORMATS: () => VIDEO_FRAME_FORMATS,
   VideoSourceExtractionError: () => VideoSourceExtractionError,
+  WebGpuUnavailableError: () => WebGpuUnavailableError,
   acquireBrowser: () => acquireBrowser,
   analyzeClipMediaFit: () => analyzeClipMediaFit,
   analyzeCompositionHdr: () => analyzeCompositionHdr,
@@ -82527,6 +82824,7 @@ __export(src_exports, {
   assertMediaPayload: () => assertMediaPayload,
   assertPublicHttpsUrl: () => assertPublicHttpsUrl,
   assertSwiftShader: () => assertSwiftShader,
+  assertWebGpuAdapterAvailable: () => assertWebGpuAdapterAvailable,
   augmentPageNavigationTimeoutError: () => augmentPageNavigationTimeoutError,
   augmentProtocolTimeoutError: () => augmentProtocolTimeoutError,
   beginFrameCapture: () => beginFrameCapture,
@@ -82550,6 +82848,7 @@ __export(src_exports, {
   cloneCaptureWarnings: () => cloneCaptureWarnings,
   closeCaptureSession: () => closeCaptureSession,
   completeDeferredDrawElementInit: () => completeDeferredDrawElementInit,
+  compositionRequiresWebGpu: () => compositionRequiresWebGpu,
   computeWorkerSizing: () => computeWorkerSizing,
   convertTransfer: () => convertTransfer,
   createCaptureSession: () => createCaptureSession,
@@ -89771,6 +90070,37 @@ async function ensureWoff2DataUri(cachePath, woff2Url, familyName, weight, style
   }
   return `data:font/woff2;base64,${readFileSync9(cachePath).toString("base64")}`;
 }
+var googleFontCssCache = /* @__PURE__ */ new Map();
+function raceAgainstAbort(promise, signal) {
+  if (!signal) return promise;
+  if (signal.aborted) return Promise.reject(callerAbortReason(signal));
+  return new Promise((resolve18, reject) => {
+    const onAbort = () => reject(callerAbortReason(signal));
+    signal.addEventListener("abort", onAbort, { once: true });
+    promise.then(resolve18, reject).finally(() => signal.removeEventListener("abort", onAbort));
+  });
+}
+function fetchGoogleFontCss(url, familyName, options) {
+  const key2 = `${options.failClosedFontFetch ? "closed" : "open"}:${url}`;
+  let shared = googleFontCssCache.get(key2);
+  if (!shared) {
+    shared = fetchFontResource(
+      url,
+      { headers: { "User-Agent": WOFF2_USER_AGENT } },
+      (response) => response.text(),
+      familyName,
+      "Google Fonts CSS",
+      { ...options, abortSignal: void 0 }
+    ).then((result) => {
+      if (result.ok) return { ok: true, body: result.body };
+      if (isRetryableFontFetchStatus(result.response.status)) googleFontCssCache.delete(key2);
+      return { ok: false };
+    });
+    googleFontCssCache.set(key2, shared);
+    shared.catch(() => googleFontCssCache.delete(key2));
+  }
+  return raceAgainstAbort(shared, options.abortSignal);
+}
 async function fetchGoogleFont(familyName, options, fontText) {
   const slug = fontSlug(familyName);
   const googleFamilyName = familyName.replace(/\+/g, " ");
@@ -89779,14 +90109,7 @@ async function fetchGoogleFont(familyName, options, fontText) {
   const url = `https://fonts.googleapis.com/css2?family=${encodedFamily}:ital,wght@0,100;0,200;0,300;0,400;0,500;0,600;0,700;0,800;0,900;1,400;1,700${textParam}`;
   let cssText;
   try {
-    const cssResult = await fetchFontResource(
-      url,
-      { headers: { "User-Agent": WOFF2_USER_AGENT } },
-      (response) => response.text(),
-      familyName,
-      "Google Fonts CSS",
-      options
-    );
+    const cssResult = await fetchGoogleFontCss(url, familyName, options);
     if (!cssResult.ok) {
       return [];
     }
@@ -91234,22 +91557,16 @@ function coalesceHeadStylesAndBodyScripts(html) {
     }
   }
   if (body) {
-    const bodyScripts = Array.from(body.querySelectorAll("script")).filter((el) => {
-      const src = (el.getAttribute("src") || "").trim();
-      if (src) return false;
-      const type = (el.getAttribute("type") || "").trim().toLowerCase();
-      return !type || type === "text/javascript" || type === "application/javascript";
-    });
-    if (bodyScripts.length > 0) {
-      const mergedJs = bodyScripts.map((el) => (el.textContent || "").trim()).filter(Boolean).join("\n;\n").trim();
-      for (const el of bodyScripts) {
-        el.remove();
-      }
-      if (mergedJs) {
-        const script = document2.createElement("script");
-        script.textContent = mergedJs;
-        body.appendChild(script);
-      }
+    for (const { members, anchor } of inlineScriptRuns(
+      Array.from(body.querySelectorAll("script"))
+    )) {
+      const mergedJs = members.map((el) => (el.textContent || "").trim()).filter(Boolean).join("\n;\n").trim();
+      for (const el of members) el.remove();
+      if (!mergedJs) continue;
+      const script = document2.createElement("script");
+      script.textContent = mergedJs;
+      if (anchor) anchor.before(script);
+      else body.appendChild(script);
     }
   }
   return document2.toString();
@@ -92612,7 +92929,8 @@ async function runProbeStage(input) {
       quality: captureFormat === "png" ? void 0 : 80,
       variables: job.config.variables,
       deviceScaleFactor,
-      motionBlur
+      motionBlur,
+      requiresWebGpu: compositionRequiresWebGpu(compiled.html)
     };
     const PROBE_MAX_ATTEMPTS = 2;
     for (let attempt = 1; attempt <= PROBE_MAX_ATTEMPTS; attempt++) {
@@ -98303,7 +98621,8 @@ async function executeRenderPipeline(input) {
       skipReadinessVideoIds: videoReadinessSkipIds,
       // Probe-resolved duration: drawElement self-verification derives its
       // sample frame indices from this so they land inside the drained range.
-      compositionDurationSeconds: job.duration
+      compositionDurationSeconds: job.duration,
+      requiresWebGpu: compositionRequiresWebGpu(compiled.html)
     });
     const createRenderVideoFrameInjector = () => createVideoFrameInjector(frameLookup, {
       frameDataUriCacheLimit: cfg.frameDataUriCacheLimit,
@@ -100654,8 +100973,8 @@ async function runFontLocalize(io, localize) {
 }
 
 // src/version.ts
-var VERSION = true ? "0.8.48" : "0.0.0-dev";
-var PRODUCER_VERSION = true ? "0.8.48" : "0.0.0-dev";
+var VERSION = true ? "0.8.50" : "0.0.0-dev";
+var PRODUCER_VERSION = true ? "0.8.50" : "0.0.0-dev";
 
 // src/fontLocalizeCli.ts
 async function readStdin() {