hyperframes 0.8.75 → 0.8.77

package/dist/fontLocalizeCli.js

@@ -52717,10 +52717,13 @@ function parseHTMLContent(html) {
   }
   return parseHTML(`<!DOCTYPE html><html><head></head><body>${html}</body></html>`).document;
 }
+function lowerAscii(text) {
+  return text.replace(/[A-Z]+/g, (letters) => letters.toLowerCase());
+}
 function stripEmbeddedRuntimeScripts(html) {
   if (!html)
     return html;
-  const loweredHtml = html.toLowerCase();
+  const loweredHtml = lowerAscii(html);
   let output = "";
   let cursor = 0;
   while (cursor < html.length) {
@@ -52757,22 +52760,41 @@ function findScriptStart(loweredHtml, from) {
 }
 function findTagEnd(html, from) {
   let quote;
+  let state = "tagName";
   for (let index = from; index < html.length; index += 1) {
-    const char = html[index];
+    const char = html.charAt(index);
     if (quote) {
-      if (char === quote)
-        quote = void 0;
+      quote = char === quote ? void 0 : quote;
       continue;
     }
-    if (char === '"' || char === "'") {
+    if (char === ">")
+      return index;
+    if (state === "equals" && (char === '"' || char === "'")) {
       quote = char;
+      state = "between";
       continue;
     }
-    if (char === ">")
-      return index;
+    state = nextTagState(state, char, index === from);
   }
   return -1;
 }
+function nextTagState(state, char, first) {
+  if (isHtmlWhitespace(char))
+    return stateAfterWhitespace(state);
+  if (char === "/" && !first)
+    return stateAfterSlash(state);
+  if (char === "=" && state === "name")
+    return "equals";
+  if (state === "equals")
+    return "value";
+  return state === "between" ? "name" : state;
+}
+function stateAfterWhitespace(state) {
+  return state === "tagName" || state === "value" ? "between" : state;
+}
+function stateAfterSlash(state) {
+  return state === "equals" || state === "value" ? "value" : "between";
+}
 function findScriptCloseTagEnd(loweredHtml, from) {
   let index = loweredHtml.indexOf("</script", from);
   while (index !== -1) {
@@ -52811,7 +52833,7 @@ function getScriptSource(block) {
   const startTagEnd = findTagEnd(block, 1);
   if (startTagEnd === -1)
     return "";
-  const loweredBlock = block.toLowerCase();
+  const loweredBlock = lowerAscii(block);
   const closeTagStart = loweredBlock.lastIndexOf("</script");
   const end = closeTagStart === -1 ? block.length : closeTagStart;
   return block.slice(startTagEnd + 1, end);
@@ -52826,8 +52848,8 @@ function escapeInlineScriptSource(source) {
   return escapeCaseInsensitiveToken(escapeCaseInsensitiveToken(source, "</script", "<\\/script"), "<!--", "<\\!--");
 }
 function escapeCaseInsensitiveToken(source, token, replacement) {
-  const loweredSource = source.toLowerCase();
-  const loweredToken = token.toLowerCase();
+  const loweredSource = lowerAscii(source);
+  const loweredToken = lowerAscii(token);
   let output = "";
   let cursor = 0;
   while (cursor < source.length) {
@@ -52844,16 +52866,78 @@ function escapeCaseInsensitiveToken(source, token, replacement) {
 function inlineScriptTags(scripts) {
   return scripts.map((source) => `<script>${escapeInlineScriptSource(source)}</script>`).join("\n");
 }
-function injectTagsAtHeadStart(html, tags) {
-  if (html.includes("<head")) {
-    return html.replace(/<head\b[^>]*>/i, (match) => `${match}
-${tags}`);
+function findDocumentTag(html, tag) {
+  const lowered = lowerAscii(html);
+  const unclosedRawText = /* @__PURE__ */ new Set();
+  let cursor = 0;
+  while (cursor !== -1) {
+    const open = lowered.indexOf("<", cursor);
+    if (open === -1)
+      return -1;
+    if (isTagAt(lowered, open, tag))
+      return open;
+    cursor = skipMarkup(lowered, open, unclosedRawText);
   }
-  if (html.includes("<body")) {
-    return html.replace("<body", () => `${tags}
-<body`);
+  return -1;
+}
+function isTagAt(lowered, at2, token) {
+  return lowered.startsWith(token, at2) && isTagBoundary(lowered.charAt(at2 + token.length));
+}
+function skipMarkup(lowered, open, unclosedRawText) {
+  if (lowered.startsWith("<!--", open))
+    return skipComment(lowered, open);
+  const next = lowered.charAt(open + 1);
+  if (next === "/" && !/[a-z]/.test(lowered.charAt(open + 2))) {
+    const bogusEnd = lowered.indexOf(">", open);
+    return bogusEnd === -1 ? -1 : bogusEnd + 1;
+  }
+  if (!/[a-z/]/.test(next))
+    return open + 1;
+  const tagEnd = findTagEnd(lowered, open + 1);
+  return tagEnd === -1 ? -1 : skipRawText(lowered, open, tagEnd, unclosedRawText);
+}
+function skipComment(lowered, open) {
+  if (lowered.startsWith("<!-->", open) || lowered.startsWith("<!--->", open)) {
+    return lowered.indexOf(">", open) + 1;
+  }
+  COMMENT_END.lastIndex = open + 4;
+  const end = COMMENT_END.exec(lowered);
+  return end ? end.index + end[0].length : -1;
+}
+function skipRawText(lowered, open, tagEnd, unclosedRawText) {
+  const rawText = RAW_TEXT_TAGS.find((name) => isTagAt(lowered, open, `<${name}`));
+  if (!rawText)
+    return tagEnd + 1;
+  const close = unclosedRawText.has(rawText) ? -1 : findRawTextClose(lowered, rawText, tagEnd + 1);
+  if (close !== -1)
+    return close;
+  unclosedRawText.add(rawText);
+  return lowered.charAt(tagEnd - 1) === "/" ? tagEnd + 1 : -1;
+}
+function findRawTextClose(lowered, name, from) {
+  const close = `</${name}`;
+  for (let at2 = lowered.indexOf(close, from); at2 !== -1; at2 = lowered.indexOf(close, at2 + 1)) {
+    if (isTagAt(lowered, at2, close))
+      return at2;
   }
-  return `${tags}
+  return -1;
+}
+function insertBeforeDocumentTag(html, tag, markup) {
+  const at2 = findDocumentTag(html, tag);
+  return at2 === -1 ? null : html.slice(0, at2) + markup + html.slice(at2);
+}
+function insertBeforeCloseTag(html, name, markup) {
+  return insertBeforeDocumentTag(html, `</${name}`, markup);
+}
+function injectTagsAtHeadStart(html, tags) {
+  const headOpen = findDocumentTag(html, "<head");
+  const headOpenEnd = headOpen === -1 ? -1 : findTagEnd(html, headOpen + 1);
+  if (headOpenEnd !== -1) {
+    return `${html.slice(0, headOpenEnd + 1)}
+${tags}${html.slice(headOpenEnd + 1)}`;
+  }
+  return insertBeforeDocumentTag(html, "<body", `${tags}
+`) ?? `${tags}
 ${html}`;
 }
 function injectScriptsAtHeadStart(html, scripts) {
@@ -52867,30 +52951,21 @@ function injectScriptsIntoHtml(html, headScripts, bodyScripts, stripEmbeddedRunt
   }
   if (headScripts.length > 0) {
     const headTags = inlineScriptTags(headScripts);
-    if (html.includes("</head>")) {
-      html = html.replace("</head>", () => `${headTags}
-</head>`);
-    } else if (html.includes("<body")) {
-      html = html.replace("<body", () => `${headTags}
-<body`);
-    } else {
-      html = `${headTags}
+    const withHead = insertBeforeCloseTag(html, "head", `${headTags}
+`);
+    html = withHead ?? insertBeforeDocumentTag(html, "<body", `${headTags}
+`) ?? `${headTags}
 ${html}`;
-    }
   }
   if (bodyScripts.length > 0) {
     const bodyTags = inlineScriptTags(bodyScripts);
-    if (html.includes("</body>")) {
-      html = html.replace("</body>", () => `${bodyTags}
-</body>`);
-    } else {
-      html = `${html}
+    html = insertBeforeCloseTag(html, "body", `${bodyTags}
+`) ?? `${html}
 ${bodyTags}`;
-    }
   }
   return html;
 }
-var RUNTIME_BOOTSTRAP_ATTR, RUNTIME_SRC_MARKERS, RUNTIME_INLINE_MARKERS, SIMPLE_RUNTIME_FLAG_ASSIGNMENTS;
+var RUNTIME_BOOTSTRAP_ATTR, RUNTIME_SRC_MARKERS, RUNTIME_INLINE_MARKERS, SIMPLE_RUNTIME_FLAG_ASSIGNMENTS, RAW_TEXT_TAGS, COMMENT_END;
 var init_htmlDocument = __esm({
   "../core/dist/compiler/htmlDocument.js"() {
     "use strict";
@@ -52913,6 +52988,8 @@ var init_htmlDocument = __esm({
       /^window\.__playerReady\s*=\s*(?:true|false)\s*;?$/,
       /^window\.__renderReady\s*=\s*(?:true|false)\s*;?$/
     ];
+    RAW_TEXT_TAGS = ["script", "style", "title", "textarea"];
+    COMMENT_END = /--!?>/g;
   }
 });
 
@@ -66166,6 +66243,8 @@ function readExternalScriptAttributes(el) {
     attributes2.integrity = el.getAttribute("integrity") || "";
   if (el.hasAttribute("crossorigin"))
     attributes2.crossorigin = el.getAttribute("crossorigin") || "";
+  if ((el.getAttribute("type") || "").trim().toLowerCase() === "module")
+    attributes2.type = "module";
   return attributes2;
 }
 function ensureExternalScriptTag(doc, src, attributes2 = {}) {
@@ -66181,6 +66260,8 @@ function ensureExternalScriptTag(doc, src, attributes2 = {}) {
       el.setAttribute("integrity", integrity);
     if (attributes2.crossorigin !== void 0)
       el.setAttribute("crossorigin", attributes2.crossorigin);
+    if (attributes2.type)
+      el.setAttribute("type", attributes2.type);
   }
   if (!existing.length) {
     const el = elements[0];
@@ -66194,6 +66275,80 @@ var init_externalScripts = __esm({
   }
 });
 
+// ../core/dist/compiler/importMaps.js
+function parseImportMap(json, rebase) {
+  let parsed;
+  try {
+    parsed = JSON.parse(json);
+  } catch {
+    return null;
+  }
+  if (!parsed || typeof parsed !== "object")
+    return null;
+  const { imports, scopes } = parsed;
+  return {
+    imports: rebaseEntries(imports, rebase),
+    scopes: scopes && Object.fromEntries(Object.entries(scopes).map(([prefix, entries2]) => [
+      rebase(prefix),
+      rebaseEntries(entries2, rebase) ?? {}
+    ]))
+  };
+}
+function mergeEntries(into, from, where) {
+  for (const [specifier, url] of Object.entries(from ?? {})) {
+    if (!(specifier in into))
+      into[specifier] = url;
+    else if (into[specifier] !== url) {
+      console.warn(`[HyperFrames] import map conflict for "${specifier}"${where}: keeping ${into[specifier]}, ignoring ${url}.`);
+    }
+  }
+}
+function mergeImportMapsIntoDocument(doc, maps) {
+  if (maps.length === 0)
+    return;
+  let el = doc.querySelector('script[type="importmap"]');
+  let page = {};
+  try {
+    page = el ? JSON.parse(el.textContent || "{}") : {};
+  } catch {
+    console.warn("[HyperFrames] the page's import map is not valid JSON; replacing it.");
+  }
+  const imports = { ...page.imports };
+  const scopes = { ...page.scopes };
+  for (const map of maps) {
+    mergeEntries(imports, map.imports, "");
+    for (const [prefix, entries2] of Object.entries(map.scopes ?? {})) {
+      mergeEntries(scopes[prefix] ??= {}, entries2, ` in scope ${prefix}`);
+    }
+  }
+  if (!el) {
+    el = doc.createElement("script");
+    el.setAttribute("type", "importmap");
+    doc.head.prepend(el);
+  }
+  el.textContent = JSON.stringify({
+    ...page,
+    imports,
+    ...Object.keys(scopes).length ? { scopes } : {}
+  }).replace(/</g, "\\u003c");
+}
+function emitMountedModuleScripts(doc, importMaps, moduleScripts) {
+  mergeImportMapsIntoDocument(doc, importMaps);
+  for (const content of moduleScripts) {
+    const el = doc.createElement("script");
+    el.setAttribute("type", "module");
+    el.textContent = content;
+    doc.body.appendChild(el);
+  }
+}
+var rebaseEntries;
+var init_importMaps = __esm({
+  "../core/dist/compiler/importMaps.js"() {
+    "use strict";
+    rebaseEntries = (entries2, rebase) => entries2 && Object.fromEntries(Object.entries(entries2).map(([specifier, url]) => [specifier, rebase(url)]));
+  }
+});
+
 // ../core/dist/runtime/flattenedRoot.js
 function markFlattenedInnerRoot(prepared) {
   const authoredRootId = prepared.getAttribute("id")?.trim();
@@ -66642,6 +66797,12 @@ function scopeCssToComposition(css, compositionId, scopeSelectorOverride, author
 function jsonScriptLiteral(value) {
   return JSON.stringify(value).replace(/</g, "\\u003c");
 }
+function scopedModulePrelude(timelineCompositionId, compositionSrc) {
+  return `const __hyperframes = (function(__hfBaseHyperframes, __hfTimelineCompId, __hfCompositionSrc) {
+  return ${SCOPED_HYPERFRAMES_EXPRESSION};
+})(window.__hyperframes, ${jsonScriptLiteral(timelineCompositionId)}, ${jsonScriptLiteral(compositionSrc?.trim() || null)});
+`;
+}
 function wrapScopedCompositionScript(source, compositionId, errorLabel = "[HyperFrames] composition script error:", scopeSelectorOverride, timelineCompositionId = compositionId, authoredRootId, compositionSrc) {
   const compositionIdLiteral = jsonScriptLiteral(compositionId);
   const timelineCompositionIdLiteral = jsonScriptLiteral(timelineCompositionId);
@@ -66963,19 +67124,7 @@ function wrapScopedCompositionScript(source, compositionId, errorLabel = "[Hyper
         },
       });
   var __hfBaseHyperframes = window.__hyperframes;
-  var __hfScopedHyperframes = !__hfBaseHyperframes
-    ? __hfBaseHyperframes
-    : Object.assign({}, __hfBaseHyperframes, {
-        assetUrl: function(path) {
-          var page = window.document.baseURI;
-          return new URL(path, __hfCompositionSrc ? new URL(__hfCompositionSrc, page) : page).href;
-        },
-        getVariables: function() {
-          var byComp = window.__hfVariablesByComp;
-          var scoped = byComp && __hfTimelineCompId ? byComp[__hfTimelineCompId] : null;
-          return scoped ? Object.assign({}, scoped) : {};
-        },
-      });
+  var __hfScopedHyperframes = ${SCOPED_HYPERFRAMES_EXPRESSION};
   var __hfRun = function() {
     try {
       (function(document, gsap, window, __hyperframes) {
@@ -66998,13 +67147,26 @@ function buildVariablesByCompScript(variablesByComp) {
   const json = jsonScriptLiteral(variablesByComp);
   return `window.__hfVariablesByComp = Object.assign({}, window.__hfVariablesByComp || {}, ${json});`;
 }
-var AUTHORED_ROOT_ID_ATTR, INNER_ROOT_ATTR, GLOBAL_AT_RULES;
+var AUTHORED_ROOT_ID_ATTR, INNER_ROOT_ATTR, GLOBAL_AT_RULES, SCOPED_HYPERFRAMES_EXPRESSION;
 var init_compositionScoping = __esm({
   "../core/dist/compiler/compositionScoping.js"() {
     "use strict";
     AUTHORED_ROOT_ID_ATTR = "data-hf-authored-id";
     INNER_ROOT_ATTR = "data-hf-inner-root";
     GLOBAL_AT_RULES = /* @__PURE__ */ new Set(["keyframes", "-webkit-keyframes", "font-face"]);
+    SCOPED_HYPERFRAMES_EXPRESSION = `!__hfBaseHyperframes
+    ? __hfBaseHyperframes
+    : Object.assign({}, __hfBaseHyperframes, {
+        assetUrl: function(path) {
+          var page = window.document.baseURI;
+          return new URL(path, __hfCompositionSrc ? new URL(__hfCompositionSrc, page) : page).href;
+        },
+        getVariables: function() {
+          var byComp = window.__hfVariablesByComp;
+          var scoped = byComp && __hfTimelineCompId ? byComp[__hfTimelineCompId] : null;
+          return scoped ? Object.assign({}, scoped) : {};
+        },
+      })`;
   }
 });
 
@@ -72433,6 +72595,13 @@ function parseGsapScriptAcornForWrite(script) {
   }
 }
 function parseGsapScriptAcorn(script) {
+  const parsed = parseMemo.get(script) ?? parseGsapScriptAcornUncached(script);
+  parseMemo.delete(script);
+  parseMemo.set(script, parsed);
+  if (parseMemo.size > PARSE_MEMO_ENTRIES) parseMemo.delete(parseMemo.keys().next().value);
+  return structuredClone(parsed);
+}
+function parseGsapScriptAcornUncached(script) {
   try {
     const ast = parseProgram3(script);
     const scope = collectScopeBindings(ast);
@@ -72580,7 +72749,7 @@ function extractGsapLabels(script) {
     return [];
   }
 }
-var PROPERTY_GROUPS2, PROP_TO_GROUP2, SKIP_KEYS, FUNCTION_TYPES, GSAP_METHODS, MAX_DEPTH, MAX_ITERS, SAFE_DEFAULT_NODES, SUPPORTED_PARAMS_CACHE, roundPercentage, GSAP_METHODS2, QUERY_METHODS, ITERATION_METHODS, SCOPE_NODE_TYPES, CONST_NODES, MATH_FNS, MATH_CONSTS, BUILTIN_VAR_KEYS, DROPPED_VAR_KEYS, EXTRAS_KEYS, PERCENTAGE_KEY_RE, GSAP_DEFAULT_DURATION;
+var PROPERTY_GROUPS2, PROP_TO_GROUP2, SKIP_KEYS, FUNCTION_TYPES, GSAP_METHODS, MAX_DEPTH, MAX_ITERS, SAFE_DEFAULT_NODES, SUPPORTED_PARAMS_CACHE, roundPercentage, GSAP_METHODS2, QUERY_METHODS, ITERATION_METHODS, SCOPE_NODE_TYPES, CONST_NODES, MATH_FNS, MATH_CONSTS, BUILTIN_VAR_KEYS, DROPPED_VAR_KEYS, EXTRAS_KEYS, PERCENTAGE_KEY_RE, GSAP_DEFAULT_DURATION, PARSE_MEMO_ENTRIES, parseMemo;
 var init_gsapParserAcorn = __esm({
   "../parsers/dist/gsapParserAcorn.js"() {
     "use strict";
@@ -72660,6 +72829,8 @@ var init_gsapParserAcorn = __esm({
     ]);
     PERCENTAGE_KEY_RE = /^(\d+(?:\.\d+)?)%$/;
     GSAP_DEFAULT_DURATION = 0.5;
+    PARSE_MEMO_ENTRIES = 4;
+    parseMemo = /* @__PURE__ */ new Map();
   }
 });
 
@@ -74211,6 +74382,81 @@ function collectDeclaredVariableIds(htmlTagRaw) {
   }
   return declared;
 }
+function variablesDeclarationFindings(tag, tags) {
+  const raw = readJsonAttr(tag.raw, "data-composition-variables");
+  if (!raw) return [];
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (err) {
+    const reason = err instanceof Error ? err.message : "unknown";
+    return [
+      {
+        code: "invalid_composition_variables_declaration",
+        severity: "error",
+        message: `data-composition-variables is not valid JSON (${reason}).`,
+        fixHint: `Provide a JSON array of variable declarations: data-composition-variables='[{"id":"title","type":"string","label":"Title","default":"Hello"}]'.`,
+        snippet: truncateSnippet(tag.raw)
+      }
+    ];
+  }
+  if (!Array.isArray(parsed)) {
+    return [
+      {
+        code: "invalid_composition_variables_declaration",
+        severity: "error",
+        message: "data-composition-variables must be a JSON array of variable declarations.",
+        fixHint: `Wrap declarations in [] and give each an id, type, label, and default: '[{"id":"title","type":"string","label":"Title","default":"Hello"}]'.`,
+        snippet: truncateSnippet(tag.raw)
+      }
+    ];
+  }
+  const findings = [];
+  const knownTypes = new Set(COMPOSITION_VARIABLE_TYPES2);
+  const varSrcIds = /* @__PURE__ */ new Set();
+  for (const other of tags) {
+    const bound = readAttr(other.raw, "data-var-src");
+    if (bound) varSrcIds.add(bound);
+  }
+  for (let i = 0; i < parsed.length; i += 1) {
+    const entry = parsed[i];
+    if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+      findings.push({
+        code: "invalid_composition_variables_declaration",
+        severity: "error",
+        message: `data-composition-variables entry [${i}] must be an object with id, type, label, and default.`,
+        snippet: truncateSnippet(tag.raw)
+      });
+      continue;
+    }
+    const e = entry;
+    const missing = [];
+    if (typeof e.id !== "string") missing.push("id");
+    if (typeof e.type !== "string" || !knownTypes.has(e.type)) missing.push("type");
+    if (typeof e.label !== "string") missing.push("label");
+    if (!("default" in e)) missing.push("default");
+    if (missing.length > 0) {
+      findings.push({
+        code: "invalid_composition_variables_declaration",
+        severity: "error",
+        message: `data-composition-variables entry [${i}] is missing or has invalid: ${missing.join(", ")}. Type must be one of string, number, color, boolean, enum, font, image.`,
+        snippet: truncateSnippet(tag.raw)
+      });
+      continue;
+    }
+    const id = String(e.id);
+    if ((e.type === "image" || varSrcIds.has(id)) && typeof e.default === "string" && e.default.length > 0 && !isSafeMediaUrl(e.default)) {
+      findings.push({
+        code: "unloadable_media_variable_default",
+        severity: "error",
+        message: `Variable "${id}" defaults to a URL the runtime will refuse to load, so any element bound to it renders its authored fallback src instead and the render still exits 0.`,
+        fixHint: `Media URLs must be relative, http(s), blob:, or a data:image/* URI. Copy the file into the project and reference it relatively (e.g. "assets/bg.png") rather than by absolute path.`,
+        snippet: truncateSnippet(tag.raw)
+      });
+    }
+  }
+  return findings;
+}
 function collectAllDeclaredVariableIds(tags) {
   const all = /* @__PURE__ */ new Set();
   for (const tag of tags) {
@@ -76669,84 +76915,8 @@ var init_dist3 = __esm({
       // on any structural problem. Surface JSON / shape failures so authors
       // catch them at lint time rather than wondering why their `getVariables()`
       // defaults aren't applied.
-      // fallow-ignore-next-line complexity
-      ({ tags }) => {
-        const htmlTag = findHtmlTag(tags);
-        if (!htmlTag) return [];
-        const raw = readJsonAttr(htmlTag.raw, "data-composition-variables");
-        if (!raw) return [];
-        let parsed;
-        try {
-          parsed = JSON.parse(raw);
-        } catch (err) {
-          const reason = err instanceof Error ? err.message : "unknown";
-          return [
-            {
-              code: "invalid_composition_variables_declaration",
-              severity: "error",
-              message: `data-composition-variables is not valid JSON (${reason}).`,
-              fixHint: `Provide a JSON array of variable declarations: data-composition-variables='[{"id":"title","type":"string","label":"Title","default":"Hello"}]'.`,
-              snippet: truncateSnippet(htmlTag.raw)
-            }
-          ];
-        }
-        if (!Array.isArray(parsed)) {
-          return [
-            {
-              code: "invalid_composition_variables_declaration",
-              severity: "error",
-              message: "data-composition-variables must be a JSON array of variable declarations.",
-              fixHint: `Wrap declarations in [] and give each an id, type, label, and default: '[{"id":"title","type":"string","label":"Title","default":"Hello"}]'.`,
-              snippet: truncateSnippet(htmlTag.raw)
-            }
-          ];
-        }
-        const findings = [];
-        const knownTypes = new Set(COMPOSITION_VARIABLE_TYPES2);
-        const varSrcIds = /* @__PURE__ */ new Set();
-        for (const tag of tags) {
-          const bound = readAttr(tag.raw, "data-var-src");
-          if (bound) varSrcIds.add(bound);
-        }
-        for (let i = 0; i < parsed.length; i += 1) {
-          const entry = parsed[i];
-          if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
-            findings.push({
-              code: "invalid_composition_variables_declaration",
-              severity: "error",
-              message: `data-composition-variables entry [${i}] must be an object with id, type, label, and default.`,
-              snippet: truncateSnippet(htmlTag.raw)
-            });
-            continue;
-          }
-          const e = entry;
-          const missing = [];
-          if (typeof e.id !== "string") missing.push("id");
-          if (typeof e.type !== "string" || !knownTypes.has(e.type)) missing.push("type");
-          if (typeof e.label !== "string") missing.push("label");
-          if (!("default" in e)) missing.push("default");
-          if (missing.length > 0) {
-            findings.push({
-              code: "invalid_composition_variables_declaration",
-              severity: "error",
-              message: `data-composition-variables entry [${i}] is missing or has invalid: ${missing.join(", ")}. Type must be one of string, number, color, boolean, enum, font, image.`,
-              snippet: truncateSnippet(htmlTag.raw)
-            });
-            continue;
-          }
-          const id = String(e.id);
-          if ((e.type === "image" || varSrcIds.has(id)) && typeof e.default === "string" && e.default.length > 0 && !isSafeMediaUrl(e.default)) {
-            findings.push({
-              code: "unloadable_media_variable_default",
-              severity: "error",
-              message: `Variable "${id}" defaults to a URL the runtime will refuse to load, so any element bound to it renders its authored fallback src instead and the render still exits 0.`,
-              fixHint: `Media URLs must be relative, http(s), blob:, or a data:image/* URI. Copy the file into the project and reference it relatively (e.g. "assets/bg.png") rather than by absolute path.`,
-              snippet: truncateSnippet(htmlTag.raw)
-            });
-          }
-        }
-        return findings;
-      },
+      // Checked on every element that declares: <html>, or the composition root.
+      ({ tags }) => tags.filter((tag) => readJsonAttr(tag.raw, "data-composition-variables")).flatMap((tag) => variablesDeclarationFindings(tag, tags)),
       // html_dir_attribute_breaks_render — valid non-LTR dir values on
       // <html> renders correctly in preview/snapshot but produces a fully
       // blank/black video from render, with no other lint/validate/inspect
@@ -78758,6 +78928,8 @@ function inlineSubCompositions(document2, hosts, options) {
   const scripts = [];
   const externalScriptSrcs = [];
   const scriptItems = [];
+  const importMaps = [];
+  const moduleScripts = [];
   const externalLinks = [];
   const seenLinkHrefs = /* @__PURE__ */ new Set();
   const variablesByComp = {};
@@ -78845,7 +79017,24 @@ function inlineSubCompositions(document2, hosts, options) {
     }
     for (const scriptEl of plan2.scriptSources) {
       const externalSrc = resolveSubAssetPath(scriptEl.getAttribute("src"));
-      if (externalSrc) {
+      const type = (scriptEl.getAttribute("type") || "").trim().toLowerCase();
+      if (type === "importmap") {
+        const map = parseImportMap(scriptEl.textContent || "", (url) => {
+          const authored = url.trim();
+          const rebased = resolveSubAssetPath(authored);
+          if (rebased === authored)
+            return rebased;
+          const urlLike = /^(\/|\.\.?\/|[a-z][a-z\d+.-]*:)/i.test(rebased) ? rebased : `./${rebased}`;
+          return authored.endsWith("/") && !urlLike.endsWith("/") ? `${urlLike}/` : urlLike;
+        });
+        if (map)
+          importMaps.push(map);
+        else
+          console.warn(`[HyperFrames] ${src}: import map is not valid JSON, so it is skipped.`);
+      } else if (type === "module" && !externalSrc) {
+        const prelude = scriptCompositionId ? scopedModulePrelude(runtimeCompId || scopeCompId || scriptCompositionId, src) : "";
+        moduleScripts.push(prelude + (scriptEl.textContent || ""));
+      } else if (externalSrc) {
         if (!externalScriptSrcs.includes(externalSrc)) {
           externalScriptSrcs.push(externalSrc);
         }
@@ -78916,12 +79105,22 @@ function inlineSubCompositions(document2, hosts, options) {
       queue.push({ element: nestedHost.host, ancestry: nestedAncestry });
     }
   }
-  return { styles, scripts, externalScriptSrcs, scriptItems, externalLinks, variablesByComp };
+  return {
+    styles,
+    scripts,
+    externalScriptSrcs,
+    scriptItems,
+    externalLinks,
+    variablesByComp,
+    importMaps,
+    moduleScripts
+  };
 }
 var init_inlineSubCompositions = __esm({
   "../core/dist/compiler/inlineSubCompositions.js"() {
     "use strict";
     init_externalScripts();
+    init_importMaps();
     init_rewriteSubCompPaths();
     init_getVariables();
     init_compositionScoping();
@@ -79113,6 +79312,7 @@ var init_htmlBundler = __esm({
     "use strict";
     init_scriptRuns();
     init_externalScripts();
+    init_importMaps();
     init_flattenedRoot();
     init_flattenedRoot();
     init_getVariables();
@@ -79160,6 +79360,7 @@ var init_compiler = __esm({
     init_assetPaths();
     init_mediaRenderIds();
     init_externalScripts();
+    init_importMaps();
   }
 });
 
@@ -85263,6 +85464,7 @@ __export(src_exports, {
   scaleProtocolTimeoutForComposition: () => scaleProtocolTimeoutForComposition,
   selectVerifySampleIndicesForTask: () => selectVerifySampleIndicesForTask,
   shouldClampToScreenshotForConcreteGpu: () => shouldClampToScreenshotForConcreteGpu,
+  shouldDisableBrowserPoolForParallelWorker: () => shouldDisableBrowserPoolForParallelWorker,
   showVideoElements: () => showVideoElements,
   spawnStreamingEncoder: () => spawnStreamingEncoder,
   syncVideoFrameVisibility: () => syncVideoFrameVisibility,
@@ -92371,13 +92573,19 @@ function defaultSessionFactory(input) {
   let probeSession = input.probeSession;
   return {
     create: async () => {
-      const session = probeSession ? probeSession : await openSegmentedSession({ ...input, probeSession: null });
+      const session = probeSession ?? await openSegmentedSession(input);
       if (probeSession) {
         openSegmentedSessionReuse(input, probeSession);
         probeSession = null;
       }
-      if (!session.isInitialized) await initializeSession(session);
-      await completeDeferredDrawElementInit(session);
+      try {
+        if (!session.isInitialized) await initializeSession(session);
+        await completeDeferredDrawElementInit(session);
+      } catch (error) {
+        await closeCaptureSession(session).catch(() => {
+        });
+        throw error;
+      }
       return session;
     }
   };
@@ -92388,16 +92596,19 @@ function openSegmentedSessionReuse(input, session) {
 async function openSegmentedSession(input) {
   const captureCfg = input.cfg.forceScreenshot === input.plan.forceScreenshot ? input.cfg : { ...input.cfg, forceScreenshot: input.plan.forceScreenshot };
   const videoInjector = input.createRenderVideoFrameInjector();
-  if (input.probeSession) {
-    prepareCaptureSessionForReuse(input.probeSession, input.framesDir, videoInjector);
-    return input.probeSession;
-  }
+  const captureOptions = input.buildCaptureOptions();
+  const ownBrowser = shouldDisableBrowserPoolForParallelWorker({
+    parallel: (input.workerCount ?? 1) > 1,
+    platform: process.platform,
+    deviceScaleFactor: captureOptions.deviceScaleFactor,
+    headlessShellPath: resolveHeadlessShellPath(captureCfg)
+  });
   return createCaptureSession(
     input.fileServer.url,
     input.framesDir,
-    input.buildCaptureOptions(),
+    captureOptions,
     videoInjector,
-    captureCfg
+    ownBrowser ? { ...captureCfg, enableBrowserPool: false } : captureCfg
   );
 }
 async function concatSegments(concat, segmentPaths, videoOnlyPath, abortSignal, cfg) {
@@ -92410,7 +92621,7 @@ async function concatSegments(concat, segmentPaths, videoOnlyPath, abortSignal,
 }
 async function createSegmentWorker(run, id) {
   const { input, deps } = run;
-  const factory = input.sessionFactoryForWorker?.(id) ?? input.sessionFactory ?? defaultSessionFactory(input);
+  const factory = input.sessionFactoryForWorker?.(id) ?? run.sessionFactory;
   return {
     id,
     factory,
@@ -92532,16 +92743,16 @@ async function runCaptureSegmentedStage(input) {
     segmentDir,
     skipSize: skip.size,
     workerCount: Math.max(1, input.workerCount ?? 1),
-    recycleEvery: input.browserRecycleEverySegments ?? 0
+    recycleEvery: input.browserRecycleEverySegments ?? 0,
+    sessionFactory: input.sessionFactory ?? defaultSessionFactory(input)
   };
   const queue = createSegmentQueue(pending);
   const segmentPaths = segments.map((s) => segmentOutputPath(segmentDir, s.index));
   if (pending.length === 0) return concatResumedRun(run, segmentPaths);
   let fellBackToStreaming = false;
   const workers = [];
-  for (let id = 0; id < run.workerCount; id++) workers.push(await createSegmentWorker(run, id));
   const consoleOf = () => workers[0]?.ctx.session.browserConsoleBuffer ?? [];
-  let lastBrowserConsole = consoleOf();
+  let lastBrowserConsole = [];
   const runWorkerLoop = async (worker) => {
     for (; ; ) {
       if (fellBackToStreaming) return;
@@ -92556,6 +92767,7 @@ async function runCaptureSegmentedStage(input) {
   };
   try {
     assertNotAborted();
+    for (let id = 0; id < run.workerCount; id++) workers.push(await createSegmentWorker(run, id));
     const outcomes = await Promise.allSettled(workers.map((w) => runWorkerLoop(w)));
     for (const worker of workers) dedupPerfs.push(getCapturePerfSummary(worker.ctx.session));
     const failure = outcomes.find((o) => o.status === "rejected");
@@ -95600,9 +95812,7 @@ function injectSdkPositionEditsRenderScript(html) {
   }
   const scriptBody = getPositionEditsRenderScript().replace(/<\/script/gi, "<\\/script");
   const script = `<script>${scriptBody}</script>`;
-  const bodyClose = html.search(/<\/body\s*>/i);
-  if (bodyClose < 0) return `${html}${script}`;
-  return `${html.slice(0, bodyClose)}${script}${html.slice(bodyClose)}`;
+  return insertBeforeCloseTag(html, "body", script) ?? `${html}${script}`;
 }
 var EmptyCompositionError = class extends Error {
   code = "EMPTY_COMPOSITION";
@@ -96179,6 +96389,13 @@ function inlineSubCompositions2(html, subCompositions, projectDir, variableOverr
     }
     flushInline();
   }
+  if (body) {
+    emitMountedModuleScripts(
+      document2,
+      result.importMaps,
+      result.moduleScripts
+    );
+  }
   emitRootCompositionVariableStyles(
     document2,
     result.variablesByComp,
@@ -96727,10 +96944,11 @@ async function compileForRender(projectDir, htmlPath, downloadDir, options = {})
     'data-hf-studio-motion="'
   ];
   const hasPositionEdits = HF_POSITION_ATTRS.some((attr) => assembledHtml.includes(attr));
-  const htmlWithPositionScript = hasPositionEdits ? assembledHtml.replace(
-    /<\/body>/i,
-    `<script>${createStudioPositionSeekReapplyScript()}</script></body>`
-  ) : assembledHtml;
+  const htmlWithPositionScript = hasPositionEdits ? insertBeforeCloseTag(
+    assembledHtml,
+    "body",
+    `<script>${createStudioPositionSeekReapplyScript()}</script>`
+  ) ?? assembledHtml : assembledHtml;
   const htmlWithSdkPositionScript = injectSdkPositionEditsRenderScript(htmlWithPositionScript);
   const { html: htmlWithLocalMedia, remoteMediaAssets } = await localizeRemoteMediaSources(
     htmlWithSdkPositionScript,
@@ -104295,8 +104513,8 @@ async function runFontLocalize(io, localize) {
 }
 
 // src/version.ts
-var VERSION = true ? "0.8.75" : "0.0.0-dev";
-var PRODUCER_VERSION = true ? "0.8.75" : "0.0.0-dev";
+var VERSION = true ? "0.8.77" : "0.0.0-dev";
+var PRODUCER_VERSION = true ? "0.8.77" : "0.0.0-dev";
 
 // src/fontLocalizeCli.ts
 async function readStdin() {