hyperframes 0.1.13 → 0.1.14

package/dist/cli.js

@@ -422,7 +422,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.1.13" : "0.0.0-dev";
+    VERSION = true ? "0.1.14" : "0.0.0-dev";
   }
 });
 
@@ -2682,7 +2682,7 @@ import { join as join2 } from "path";
 import { get as httpsGet } from "https";
 import { pipeline } from "stream/promises";
 function downloadFile(url, dest) {
-  return new Promise((resolve21, reject) => {
+  return new Promise((resolve22, reject) => {
     const follow = (u) => {
       httpsGet(u, (res) => {
         if (res.statusCode === 301 || res.statusCode === 302) {
@@ -2697,7 +2697,7 @@ function downloadFile(url, dest) {
           return;
         }
         const file = createWriteStream(dest);
-        pipeline(res, file).then(resolve21).catch(reject);
+        pipeline(res, file).then(resolve22).catch(reject);
       }).on("error", reject);
     };
     follow(url);
@@ -2854,7 +2854,7 @@ var init_manager = __esm({
   "src/whisper/manager.ts"() {
     "use strict";
     MODELS_DIR = join2(homedir2(), ".cache", "hyperframes", "whisper", "models");
-    DEFAULT_MODEL = "base.en";
+    DEFAULT_MODEL = "small.en";
     BUILD_DIR = join2(homedir2(), ".cache", "hyperframes", "whisper", "whisper.cpp");
     WHISPER_REPO = "https://github.com/ggml-org/whisper.cpp.git";
   }
@@ -3143,6 +3143,169 @@ Examples:
   }
 });
 
+// src/whisper/normalize.ts
+var normalize_exports = {};
+__export(normalize_exports, {
+  detectFormat: () => detectFormat,
+  loadTranscript: () => loadTranscript,
+  patchCaptionHtml: () => patchCaptionHtml
+});
+import { readFileSync as readFileSync3, readdirSync as readdirSync2, writeFileSync as writeFileSync2 } from "fs";
+import { extname, join as join4 } from "path";
+function detectFormat(filePath) {
+  const ext = extname(filePath).toLowerCase();
+  if (ext === ".srt") return "srt";
+  if (ext === ".vtt") return "vtt";
+  if (ext === ".json") return detectJsonFormat(JSON.parse(readFileSync3(filePath, "utf-8")));
+  throw new Error(`Unsupported transcript file extension: ${ext}. Use .json, .srt, or .vtt`);
+}
+function detectJsonFormat(raw) {
+  if (raw && typeof raw === "object" && !Array.isArray(raw)) {
+    const obj = raw;
+    if (obj.transcription && Array.isArray(obj.transcription)) return "whisper-cpp";
+    if (obj.words && Array.isArray(obj.words)) return "openai";
+  }
+  if (Array.isArray(raw) && raw[0]?.text !== void 0 && raw[0]?.start !== void 0) {
+    return "words-json";
+  }
+  throw new Error(
+    "Unrecognized JSON transcript format. Expected whisper.cpp (transcription[].tokens), OpenAI API (words[]), or normalized ([{text, start, end}])."
+  );
+}
+function parseWhisperCpp(data) {
+  const words = [];
+  const transcription = data.transcription;
+  for (const seg of transcription ?? []) {
+    for (const token of seg.tokens ?? []) {
+      const text = (token.text ?? "").trim();
+      if (!text || text.startsWith("[_") || text.startsWith("[BLANK")) continue;
+      const isPunctuation = /^[.,!?;:'")\]}>…–—-]+$/.test(text);
+      const lastWord = words[words.length - 1];
+      if (isPunctuation && lastWord) {
+        lastWord.text += text;
+        lastWord.end = round3((token.offsets?.to ?? 0) / 1e3);
+        continue;
+      }
+      words.push({
+        text,
+        start: round3((token.offsets?.from ?? 0) / 1e3),
+        end: round3((token.offsets?.to ?? 0) / 1e3)
+      });
+    }
+  }
+  return words;
+}
+function parseOpenAI(data) {
+  const rawWords = data.words ?? [];
+  return rawWords.map((w) => ({
+    text: (w.word ?? w.text ?? "").trim(),
+    start: round3(w.start ?? 0),
+    end: round3(w.end ?? 0)
+  })).filter((w) => w.text.length > 0);
+}
+function parseSrt(content) {
+  const blocks = content.trim().split(/\n\n+/);
+  const words = [];
+  for (const block of blocks) {
+    const lines = block.trim().split("\n");
+    const timeLine = lines.find((l) => l.includes("-->"));
+    if (!timeLine) continue;
+    const [startStr, endStr] = timeLine.split("-->").map((s) => s.trim());
+    if (!startStr || !endStr) continue;
+    const text = lines.slice(lines.indexOf(timeLine) + 1).join(" ").replace(/<[^>]+>/g, "").trim();
+    if (!text) continue;
+    words.push({
+      text,
+      start: parseSrtTimestamp(startStr),
+      end: parseSrtTimestamp(endStr)
+    });
+  }
+  return words;
+}
+function parseVtt(content) {
+  const body = content.replace(/^WEBVTT[^\n]*\n/, "").replace(/^[A-Z-]+:.*\n/gm, "");
+  const blocks = body.trim().split(/\n\n+/);
+  const words = [];
+  for (const block of blocks) {
+    const lines = block.trim().split("\n");
+    const timeLine = lines.find((l) => l.includes("-->"));
+    if (!timeLine) continue;
+    const [startStr, endStr] = timeLine.split("-->").map((s) => s.trim());
+    if (!startStr || !endStr) continue;
+    const text = lines.slice(lines.indexOf(timeLine) + 1).join(" ").replace(/<[^>]+>/g, "").trim();
+    if (!text) continue;
+    words.push({
+      text,
+      start: parseVttTimestamp(startStr),
+      end: parseVttTimestamp(endStr)
+    });
+  }
+  return words;
+}
+function parseSrtTimestamp(ts) {
+  const m = ts.match(/(\d+):(\d+):(\d+)[,.](\d+)/);
+  if (!m) return 0;
+  return parseInt(m[1], 10) * 3600 + parseInt(m[2], 10) * 60 + parseInt(m[3], 10) + parseInt(m[4].padEnd(3, "0"), 10) / 1e3;
+}
+function parseVttTimestamp(ts) {
+  const parts = ts.split(":");
+  if (parts.length === 3) return parseSrtTimestamp(ts);
+  if (parts.length === 2) {
+    const [min, secMs] = parts;
+    const [sec, ms] = (secMs ?? "0.0").split(".");
+    return parseInt(min, 10) * 60 + parseInt(sec, 10) + parseInt((ms ?? "0").padEnd(3, "0"), 10) / 1e3;
+  }
+  return 0;
+}
+function round3(n) {
+  return Math.round(n * 1e3) / 1e3;
+}
+function loadTranscript(filePath) {
+  const ext = extname(filePath).toLowerCase();
+  const content = readFileSync3(filePath, "utf-8");
+  if (ext === ".srt") return { words: parseSrt(content), format: "srt" };
+  if (ext === ".vtt") return { words: parseVtt(content), format: "vtt" };
+  const parsed = JSON.parse(content);
+  const format = detectJsonFormat(parsed);
+  const words = format === "whisper-cpp" ? parseWhisperCpp(parsed) : format === "openai" ? parseOpenAI(parsed) : parsed.map((w) => ({
+    text: w.text.trim(),
+    start: round3(w.start),
+    end: round3(w.end)
+  }));
+  return { words, format };
+}
+function patchCaptionHtml(dir, words) {
+  if (words.length === 0) return;
+  const wordsJson = JSON.stringify(words, null, 2).replace(/\n/g, "\n          ");
+  let htmlFiles;
+  try {
+    htmlFiles = readdirSync2(dir, { withFileTypes: true, recursive: true }).filter((e) => e.isFile() && e.name.endsWith(".html")).map((e) => join4(e.parentPath ?? e.path, e.name));
+  } catch {
+    return;
+  }
+  for (const file of htmlFiles) {
+    let content = readFileSync3(file, "utf-8");
+    const scriptBlocks = content.match(/<script>[\s\S]*?<\/script>/g) ?? [];
+    let scriptMatch = null;
+    let transcriptMatch = null;
+    for (const block of scriptBlocks) {
+      scriptMatch = scriptMatch ?? block.match(/const script = \[[\s\S]*?\];/);
+      transcriptMatch = transcriptMatch ?? block.match(/const TRANSCRIPT = \[[\s\S]*?\];/);
+    }
+    const match = scriptMatch ?? transcriptMatch;
+    if (match) {
+      const varName = scriptMatch ? "script" : "TRANSCRIPT";
+      content = content.replace(match[0], `const ${varName} = ${wordsJson};`);
+      writeFileSync2(file, content, "utf-8");
+    }
+  }
+}
+var init_normalize = __esm({
+  "src/whisper/normalize.ts"() {
+    "use strict";
+  }
+});
+
 // ../core/src/parsers/gsapParser.ts
 function parseObjectLiteral(str) {
   const result = {};
@@ -3533,6 +3696,19 @@ function lintHyperframeHtml(html, options = {}) {
       )
     });
   }
+  const clipIds = /* @__PURE__ */ new Map();
+  const clipClasses = /* @__PURE__ */ new Map();
+  for (const tag of tags) {
+    const classAttr = readAttr(tag.raw, "class") || "";
+    const classes = classAttr.split(/\s+/).filter(Boolean);
+    if (!classes.includes("clip")) continue;
+    const id = readAttr(tag.raw, "id");
+    const info = { tag: tag.name, id: id || "", classes: classAttr };
+    if (id) clipIds.set(`#${id}`, info);
+    for (const cls of classes) {
+      if (cls !== "clip") clipClasses.set(`.${cls}`, info);
+    }
+  }
   const classUsage = countClassUsage(tags);
   for (const script of scripts) {
     const localTimelineCompId = readRegisteredTimelineCompositionId(script.content);
@@ -3575,24 +3751,39 @@ ${right.raw}`)
         });
       }
     }
+    for (const win of gsapWindows) {
+      const sel = win.targetSelector;
+      const clipInfo = clipIds.get(sel) || clipClasses.get(sel);
+      if (!clipInfo) continue;
+      const elDesc = `<${clipInfo.tag}${clipInfo.id ? ` id="${clipInfo.id}"` : ""} class="${clipInfo.classes}">`;
+      pushFinding({
+        code: "gsap_animates_clip_element",
+        severity: "error",
+        message: `GSAP animation targets a clip element. Selector "${sel}" resolves to element ${elDesc}. The framework manages clip visibility \u2014 animate an inner wrapper instead.`,
+        selector: sel,
+        elementId: clipInfo.id || void 0,
+        fixHint: "Wrap content in a child <div> and target that with GSAP.",
+        snippet: truncateSnippet(win.raw)
+      });
+    }
     if (!localTimelineCompId || localTimelineCompId === rootCompositionId) {
       continue;
     }
-    for (const window3 of gsapWindows) {
-      if (!isSuspiciousGlobalSelector(window3.targetSelector)) {
+    for (const win of gsapWindows) {
+      if (!isSuspiciousGlobalSelector(win.targetSelector)) {
         continue;
       }
-      const className = getSingleClassSelector(window3.targetSelector);
+      const className = getSingleClassSelector(win.targetSelector);
       if (className && (classUsage.get(className) || 0) < 2) {
         continue;
       }
       pushFinding({
         code: "unscoped_gsap_selector",
         severity: "warning",
-        message: `Timeline "${localTimelineCompId}" uses unscoped selector "${window3.targetSelector}" that will target elements in ALL compositions when bundled, causing data loss (opacity, transforms, etc.).`,
-        selector: window3.targetSelector,
-        fixHint: `Scope the selector: \`[data-composition-id="${localTimelineCompId}"] ${window3.targetSelector}\` or use a unique id.`,
-        snippet: truncateSnippet(window3.raw)
+        message: `Timeline "${localTimelineCompId}" uses unscoped selector "${win.targetSelector}" that will target elements in ALL compositions when bundled, causing data loss (opacity, transforms, etc.).`,
+        selector: win.targetSelector,
+        fixHint: `Scope the selector: \`[data-composition-id="${localTimelineCompId}"] ${win.targetSelector}\` or use a unique id.`,
+        snippet: truncateSnippet(win.raw)
       });
     }
   }
@@ -3845,6 +4036,58 @@ ${right.raw}`)
       }
     }
   }
+  for (const script of scripts) {
+    const content = script.content;
+    const hasExitTween = /\.to\s*\([^,]+,\s*\{[^}]*opacity\s*:\s*0/.test(content);
+    const hasHardKill = /\.set\s*\([^,]+,\s*\{[^}]*(?:visibility\s*:\s*["']hidden["']|opacity\s*:\s*0)/.test(content);
+    const hasCaptionLoop = /forEach|\.forEach\s*\(/.test(content) && /createElement|caption|group|cg-/.test(content);
+    if (hasCaptionLoop && hasExitTween && !hasHardKill) {
+      pushFinding({
+        code: "caption_exit_missing_hard_kill",
+        severity: "warning",
+        message: "Caption exit animations (tl.to with opacity: 0) detected without a hard tl.set kill. Exit tweens can fail when karaoke word-level tweens conflict, leaving captions stuck on screen.",
+        fixHint: 'Add `tl.set(groupEl, { opacity: 0, visibility: "hidden" }, group.end)` after every exit tl.to animation as a deterministic kill.'
+      });
+    }
+  }
+  for (const style of styles) {
+    const content = style.content;
+    const captionBlocks = content.matchAll(
+      /(\.caption[-_]?(?:group|container|text|line|word)|#caption[-_]?container)\s*\{([^}]+)\}/gi
+    );
+    for (const [, selector, body] of captionBlocks) {
+      if (!body) continue;
+      const hasNowrap = /white-space\s*:\s*nowrap/i.test(body);
+      const hasMaxWidth = /max-width/i.test(body);
+      if (hasNowrap && !hasMaxWidth) {
+        pushFinding({
+          code: "caption_text_overflow_risk",
+          severity: "warning",
+          selector: (selector ?? "").trim(),
+          message: `Caption selector "${(selector ?? "").trim()}" has white-space: nowrap but no max-width. Long phrases will clip off-screen.`,
+          fixHint: "Add max-width: 1600px (landscape) or max-width: 900px (portrait) and overflow: hidden."
+        });
+      }
+    }
+  }
+  for (const style of styles) {
+    const content = style.content;
+    const captionBlocks = content.matchAll(
+      /(\.caption[-_]?(?:group|container|text|line)|#caption[-_]?container)\s*\{([^}]+)\}/gi
+    );
+    for (const [, selector, body] of captionBlocks) {
+      if (!body) continue;
+      if (/position\s*:\s*relative/i.test(body)) {
+        pushFinding({
+          code: "caption_container_relative_position",
+          severity: "warning",
+          selector: (selector ?? "").trim(),
+          message: `Caption selector "${(selector ?? "").trim()}" uses position: relative which causes overflow and breaks caption stacking.`,
+          fixHint: "Use position: absolute for all caption elements."
+        });
+      }
+    }
+  }
   {
     const externalScriptRe = /<script\b[^>]*\bsrc=["'](https?:\/\/[^"']+)["'][^>]*>/gi;
     let match;
@@ -3863,11 +4106,13 @@ ${right.raw}`)
     }
   }
   const errorCount = findings.filter((finding) => finding.severity === "error").length;
-  const warningCount = findings.length - errorCount;
+  const warningCount = findings.filter((finding) => finding.severity === "warning").length;
+  const infoCount = findings.filter((finding) => finding.severity === "info").length;
   return {
     ok: errorCount === 0,
     errorCount,
     warningCount,
+    infoCount,
     findings
   };
 }
@@ -4243,30 +4488,33 @@ var init_lint = __esm({
 });
 
 // src/utils/lintProject.ts
-import { existsSync as existsSync5, readFileSync as readFileSync3, readdirSync as readdirSync2 } from "fs";
-import { join as join4, resolve } from "path";
+import { existsSync as existsSync5, readFileSync as readFileSync4, readdirSync as readdirSync3 } from "fs";
+import { join as join5, resolve } from "path";
 function lintProject(project) {
   const results = [];
   let totalErrors = 0;
   let totalWarnings = 0;
-  const rootHtml = readFileSync3(project.indexPath, "utf-8");
+  let totalInfos = 0;
+  const rootHtml = readFileSync4(project.indexPath, "utf-8");
   const rootResult = lintHyperframeHtml(rootHtml, { filePath: project.indexPath });
   results.push({ file: "index.html", result: rootResult });
   totalErrors += rootResult.errorCount;
   totalWarnings += rootResult.warningCount;
+  totalInfos += rootResult.infoCount;
   const compositionsDir = resolve(project.dir, "compositions");
   if (existsSync5(compositionsDir)) {
-    const files = readdirSync2(compositionsDir).filter((f) => f.endsWith(".html"));
+    const files = readdirSync3(compositionsDir).filter((f) => f.endsWith(".html"));
     for (const file of files) {
-      const filePath = join4(compositionsDir, file);
-      const html = readFileSync3(filePath, "utf-8");
+      const filePath = join5(compositionsDir, file);
+      const html = readFileSync4(filePath, "utf-8");
       const result = lintHyperframeHtml(html, { filePath });
       results.push({ file: `compositions/${file}`, result });
       totalErrors += result.errorCount;
       totalWarnings += result.warningCount;
+      totalInfos += result.infoCount;
     }
   }
-  return { results, totalErrors, totalWarnings };
+  return { results, totalErrors, totalWarnings, totalInfos };
 }
 function shouldBlockRender(strictErrors, strictAll, totalErrors, totalWarnings) {
   return strictErrors && totalErrors > 0 || strictAll && (totalErrors > 0 || totalWarnings > 0);
@@ -4279,14 +4527,20 @@ var init_lintProject = __esm({
 });
 
 // src/utils/lintFormat.ts
-function formatLintFindings({ results, totalErrors, totalWarnings }, options = {}) {
-  const { showElementId = true, showSummary = false, errorsFirst = false } = options;
+function formatLintFindings({ results, totalErrors, totalWarnings, totalInfos }, options = {}) {
+  const {
+    showElementId = true,
+    showSummary = false,
+    errorsFirst = false,
+    verbose = false
+  } = options;
   const lines = [];
   const multiFile = results.length > 1;
   for (const { file, result } of results) {
     if (result.findings.length === 0) continue;
     const format = (finding) => {
-      const prefix = finding.severity === "error" ? c.error("\u2717") : c.warn("\u26A0");
+      if (!verbose && finding.severity === "info") return;
+      const prefix = finding.severity === "error" ? c.error("\u2717") : finding.severity === "warning" ? c.warn("\u26A0") : c.dim("\u2139");
       const fileLabel = multiFile ? c.dim(`[${file}] `) : "";
       const loc = showElementId && finding.elementId ? ` ${c.accent(`[${finding.elementId}]`)}` : "";
       lines.push(`  ${prefix} ${fileLabel}${c.bold(finding.code)}${loc}: ${finding.message}`);
@@ -4295,6 +4549,9 @@ function formatLintFindings({ results, totalErrors, totalWarnings }, options = {
     if (errorsFirst) {
       for (const f of result.findings) if (f.severity === "error") format(f);
       for (const f of result.findings) if (f.severity === "warning") format(f);
+      if (verbose) {
+        for (const f of result.findings) if (f.severity === "info") format(f);
+      }
     } else {
       for (const f of result.findings) format(f);
     }
@@ -4302,7 +4559,9 @@ function formatLintFindings({ results, totalErrors, totalWarnings }, options = {
   if (showSummary) {
     const icon = totalErrors > 0 ? c.error("\u25C7") : c.success("\u25C7");
     lines.push("");
-    lines.push(`${icon}  ${totalErrors} error(s), ${totalWarnings} warning(s)`);
+    const summaryParts = [`${totalErrors} error(s)`, `${totalWarnings} warning(s)`];
+    if (verbose && totalInfos > 0) summaryParts.push(`${totalInfos} info(s)`);
+    lines.push(`${icon}  ${summaryParts.join(", ")}`);
   }
   return lines;
 }
@@ -4357,19 +4616,19 @@ var init_fileWatcher = __esm({
 });
 
 // ../core/src/studio-api/helpers/safePath.ts
-import { resolve as resolve2, sep, join as join5 } from "path";
-import { readdirSync as readdirSync3 } from "fs";
+import { resolve as resolve2, sep, join as join6 } from "path";
+import { readdirSync as readdirSync4 } from "fs";
 function isSafePath(base, resolved) {
   const norm = resolve2(base) + sep;
   return resolved.startsWith(norm) || resolved === resolve2(base);
 }
 function walkDir(dir, prefix = "") {
   const files = [];
-  for (const entry of readdirSync3(dir, { withFileTypes: true })) {
+  for (const entry of readdirSync4(dir, { withFileTypes: true })) {
     if (IGNORE_DIRS.has(entry.name)) continue;
     const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
     if (entry.isDirectory()) {
-      files.push(...walkDir(join5(dir, entry.name), rel));
+      files.push(...walkDir(join6(dir, entry.name), rel));
     } else {
       files.push(rel);
     }
@@ -4414,7 +4673,7 @@ var init_projects = __esm({
 });
 
 // ../core/src/studio-api/routes/files.ts
-import { existsSync as existsSync6, readFileSync as readFileSync4, writeFileSync as writeFileSync2, mkdirSync as mkdirSync4 } from "fs";
+import { existsSync as existsSync6, readFileSync as readFileSync5, writeFileSync as writeFileSync3, mkdirSync as mkdirSync4 } from "fs";
 import { resolve as resolve3, dirname as dirname2 } from "path";
 function registerFileRoutes(api, adapter2) {
   api.get("/projects/:id/files/*", async (c2) => {
@@ -4425,7 +4684,7 @@ function registerFileRoutes(api, adapter2) {
     if (!isSafePath(project.dir, file) || !existsSync6(file)) {
       return c2.text("not found", 404);
     }
-    const content = readFileSync4(file, "utf-8");
+    const content = readFileSync5(file, "utf-8");
     return c2.json({ filename: filePath, content });
   });
   api.put("/projects/:id/files/*", async (c2) => {
@@ -4439,7 +4698,7 @@ function registerFileRoutes(api, adapter2) {
     const dir = dirname2(file);
     if (!existsSync6(dir)) mkdirSync4(dir, { recursive: true });
     const body = await c2.req.text();
-    writeFileSync2(file, body, "utf-8");
+    writeFileSync3(file, body, "utf-8");
     return c2.json({ ok: true });
   });
 }
@@ -4489,18 +4748,18 @@ var init_mime = __esm({
 });
 
 // ../core/src/studio-api/helpers/subComposition.ts
-import { existsSync as existsSync7, readFileSync as readFileSync5 } from "fs";
-import { join as join6 } from "path";
+import { existsSync as existsSync7, readFileSync as readFileSync6 } from "fs";
+import { join as join7 } from "path";
 function buildSubCompositionHtml(projectDir, compPath, runtimeUrl, baseHref) {
-  const compFile = join6(projectDir, compPath);
+  const compFile = join7(projectDir, compPath);
   if (!existsSync7(compFile)) return null;
-  const rawComp = readFileSync5(compFile, "utf-8");
+  const rawComp = readFileSync6(compFile, "utf-8");
   const templateMatch = rawComp.match(/<template[^>]*>([\s\S]*)<\/template>/i);
   const content = templateMatch?.[1] ?? rawComp;
-  const indexPath = join6(projectDir, "index.html");
+  const indexPath = join7(projectDir, "index.html");
   let headContent = "";
   if (existsSync7(indexPath)) {
-    const indexHtml = readFileSync5(indexPath, "utf-8");
+    const indexHtml = readFileSync6(indexPath, "utf-8");
     const headMatch = indexHtml.match(/<head[^>]*>([\s\S]*?)<\/head>/i);
     headContent = headMatch?.[1] ?? "";
   }
@@ -4534,7 +4793,7 @@ var init_subComposition = __esm({
 });
 
 // ../core/src/studio-api/routes/preview.ts
-import { existsSync as existsSync8, readFileSync as readFileSync6, statSync } from "fs";
+import { existsSync as existsSync8, readFileSync as readFileSync7, statSync } from "fs";
 import { resolve as resolve4 } from "path";
 function registerPreviewRoutes(api, adapter2) {
   api.get("/projects/:id/preview", async (c2) => {
@@ -4545,7 +4804,7 @@ function registerPreviewRoutes(api, adapter2) {
       if (!bundled) {
         const indexPath = resolve4(project.dir, "index.html");
         if (!existsSync8(indexPath)) return c2.text("not found", 404);
-        bundled = readFileSync6(indexPath, "utf-8");
+        bundled = readFileSync7(indexPath, "utf-8");
       }
       if (!bundled.includes("hyperframe.runtime") && !bundled.includes("hyperframes-preview-runtime")) {
         const runtimeTag = `<script src="${adapter2.runtimeUrl}"></script>`;
@@ -4560,7 +4819,7 @@ ${runtimeTag}`;
       return c2.html(bundled);
     } catch {
       const file = resolve4(project.dir, "index.html");
-      if (existsSync8(file)) return c2.html(readFileSync6(file, "utf-8"));
+      if (existsSync8(file)) return c2.html(readFileSync7(file, "utf-8"));
       return c2.text("not found", 404);
     }
   });
@@ -4591,7 +4850,7 @@ ${runtimeTag}`;
     }
     const contentType = getMimeType(subPath);
     const isText2 = /\.(html|css|js|json|svg|txt|md)$/i.test(subPath);
-    const buffer = isText2 ? Buffer.from(readFileSync6(file, "utf-8"), "utf-8") : readFileSync6(file);
+    const buffer = isText2 ? Buffer.from(readFileSync7(file, "utf-8"), "utf-8") : readFileSync7(file);
     const totalSize2 = buffer.length;
     const rangeHeader = c2.req.header("Range");
     if (rangeHeader) {
@@ -4631,8 +4890,8 @@ var init_preview = __esm({
 });
 
 // ../core/src/studio-api/routes/lint.ts
-import { readFileSync as readFileSync7 } from "fs";
-import { join as join7 } from "path";
+import { readFileSync as readFileSync8 } from "fs";
+import { join as join8 } from "path";
 function registerLintRoutes(api, adapter2) {
   api.get("/projects/:id/lint", async (c2) => {
     const project = await adapter2.resolveProject(c2.req.param("id"));
@@ -4641,7 +4900,7 @@ function registerLintRoutes(api, adapter2) {
       const htmlFiles = walkDir(project.dir).filter((f) => f.endsWith(".html"));
       const allFindings = [];
       for (const file of htmlFiles) {
-        const content = readFileSync7(join7(project.dir, file), "utf-8");
+        const content = readFileSync8(join8(project.dir, file), "utf-8");
         const result = await adapter2.lint(content, { filePath: file });
         if (result?.findings) {
           for (const f of result.findings) {
@@ -4665,8 +4924,8 @@ var init_lint2 = __esm({
 
 // ../core/src/studio-api/routes/render.ts
 import { streamSSE } from "hono/streaming";
-import { existsSync as existsSync9, readFileSync as readFileSync8, mkdirSync as mkdirSync5, unlinkSync, readdirSync as readdirSync4, statSync as statSync2 } from "fs";
-import { join as join8 } from "path";
+import { existsSync as existsSync9, readFileSync as readFileSync9, mkdirSync as mkdirSync5, unlinkSync, readdirSync as readdirSync5, statSync as statSync2 } from "fs";
+import { join as join9 } from "path";
 function registerRenderRoutes(api, adapter2) {
   const renderJobs = /* @__PURE__ */ new Map();
   const TTL_MS = 3e5;
@@ -4703,7 +4962,7 @@ function registerRenderRoutes(api, adapter2) {
     const rendersDir = adapter2.rendersDir(project);
     if (!existsSync9(rendersDir)) mkdirSync5(rendersDir, { recursive: true });
     const ext = format === "webm" ? ".webm" : ".mp4";
-    const outputPath = join8(rendersDir, `${jobId}${ext}`);
+    const outputPath = join9(rendersDir, `${jobId}${ext}`);
     const jobState = adapter2.startRender({
       project,
       outputPath,
@@ -4764,7 +5023,7 @@ function registerRenderRoutes(api, adapter2) {
     const isWebm = job.outputPath.endsWith(".webm");
     const contentType = isWebm ? "video/webm" : "video/mp4";
     const filename = job.outputPath.split("/").pop() ?? `render.mp4`;
-    const content = readFileSync8(job.outputPath);
+    const content = readFileSync9(job.outputPath);
     return new Response(content, {
       headers: {
         "Content-Type": contentType,
@@ -4783,7 +5042,7 @@ function registerRenderRoutes(api, adapter2) {
     const isWebm = job.outputPath.endsWith(".webm");
     const contentType = isWebm ? "video/webm" : "video/mp4";
     const filename = job.outputPath.split("/").pop() ?? `render.mp4`;
-    const content = readFileSync8(job.outputPath);
+    const content = readFileSync9(job.outputPath);
     return new Response(content, {
       headers: {
         "Content-Type": contentType,
@@ -4797,7 +5056,7 @@ function registerRenderRoutes(api, adapter2) {
       if (state.id === jobId && state.outputPath) {
         const dir = state.outputPath.replace(/\/[^/]+$/, "");
         for (const ext of [".mp4", ".webm", ".meta.json"]) {
-          const fp = join8(dir, `${jobId}${ext}`);
+          const fp = join9(dir, `${jobId}${ext}`);
           if (existsSync9(fp)) unlinkSync(fp);
         }
         break;
@@ -4806,21 +5065,41 @@ function registerRenderRoutes(api, adapter2) {
     renderJobs.delete(jobId);
     return c2.json({ deleted: true });
   });
+  api.get("/projects/:id/renders/file/*", async (c2) => {
+    const project = await adapter2.resolveProject(c2.req.param("id"));
+    if (!project) return c2.json({ error: "not found" }, 404);
+    const filename = c2.req.path.split("/renders/file/")[1];
+    if (!filename) return c2.json({ error: "missing filename" }, 400);
+    const rendersDir = adapter2.rendersDir(project);
+    const fp = join9(rendersDir, filename);
+    if (!existsSync9(fp)) return c2.json({ error: "not found" }, 404);
+    const isWebm = fp.endsWith(".webm");
+    const contentType = isWebm ? "video/webm" : "video/mp4";
+    const content = readFileSync9(fp);
+    return new Response(content, {
+      headers: {
+        "Content-Type": contentType,
+        "Content-Disposition": `inline; filename="${filename}"`,
+        "Accept-Ranges": "bytes",
+        "Content-Length": String(content.length)
+      }
+    });
+  });
   api.get("/projects/:id/renders", async (c2) => {
     const project = await adapter2.resolveProject(c2.req.param("id"));
     if (!project) return c2.json({ error: "not found" }, 404);
     const rendersDir = adapter2.rendersDir(project);
     if (!existsSync9(rendersDir)) return c2.json({ renders: [] });
-    const files = readdirSync4(rendersDir).filter((f) => f.endsWith(".mp4") || f.endsWith(".webm")).map((f) => {
-      const fp = join8(rendersDir, f);
+    const files = readdirSync5(rendersDir).filter((f) => f.endsWith(".mp4") || f.endsWith(".webm")).map((f) => {
+      const fp = join9(rendersDir, f);
       const stat = statSync2(fp);
       const rid = f.replace(/\.(mp4|webm)$/, "");
-      const metaPath = join8(rendersDir, `${rid}.meta.json`);
+      const metaPath = join9(rendersDir, `${rid}.meta.json`);
       let status = "complete";
       let durationMs;
       if (existsSync9(metaPath)) {
         try {
-          const meta = JSON.parse(readFileSync8(metaPath, "utf-8"));
+          const meta = JSON.parse(readFileSync9(metaPath, "utf-8"));
           if (meta.status === "failed") status = "failed";
           if (meta.durationMs) durationMs = meta.durationMs;
         } catch {
@@ -4841,7 +5120,7 @@ function registerRenderRoutes(api, adapter2) {
           id: file.id,
           status: file.status,
           progress: 100,
-          outputPath: join8(rendersDir, file.filename),
+          outputPath: join9(rendersDir, file.filename),
           createdAt: file.createdAt
         });
       }
@@ -4856,8 +5135,8 @@ var init_render = __esm({
 });
 
 // ../core/src/studio-api/routes/thumbnail.ts
-import { existsSync as existsSync10, readFileSync as readFileSync9, writeFileSync as writeFileSync3, mkdirSync as mkdirSync6 } from "fs";
-import { join as join9 } from "path";
+import { existsSync as existsSync10, readFileSync as readFileSync10, writeFileSync as writeFileSync4, mkdirSync as mkdirSync6 } from "fs";
+import { join as join10 } from "path";
 function registerThumbnailRoutes(api, adapter2) {
   api.get("/projects/:id/thumbnail/*", async (c2) => {
     if (!adapter2.generateThumbnail) {
@@ -4876,9 +5155,9 @@ function registerThumbnailRoutes(api, adapter2) {
     let compW = vpWidth || 1920;
     let compH = vpHeight || 1080;
     if (!vpWidth) {
-      const htmlFile = join9(project.dir, compPath);
+      const htmlFile = join10(project.dir, compPath);
       if (existsSync10(htmlFile)) {
-        const html = readFileSync9(htmlFile, "utf-8");
+        const html = readFileSync10(htmlFile, "utf-8");
         const wMatch = html.match(/data-width=["'](\d+)["']/);
         const hMatch = html.match(/data-height=["'](\d+)["']/);
         if (wMatch?.[1]) compW = parseInt(wMatch[1]);
@@ -4886,11 +5165,11 @@ function registerThumbnailRoutes(api, adapter2) {
       }
     }
     const previewUrl = compPath === "index.html" ? `http://${c2.req.header("host")}/api/projects/${project.id}/preview` : `http://${c2.req.header("host")}/api/projects/${project.id}/preview/comp/${compPath}`;
-    const cacheDir = join9(project.dir, ".thumbnails");
+    const cacheDir = join10(project.dir, ".thumbnails");
     const cacheKey = `${compPath.replace(/\//g, "_")}_${seekTime.toFixed(2)}.jpg`;
-    const cachePath = join9(cacheDir, cacheKey);
+    const cachePath = join10(cacheDir, cacheKey);
     if (existsSync10(cachePath)) {
-      return new Response(new Uint8Array(readFileSync9(cachePath)), {
+      return new Response(new Uint8Array(readFileSync10(cachePath)), {
         headers: { "Content-Type": "image/jpeg", "Cache-Control": "public, max-age=60" }
       });
     }
@@ -4907,7 +5186,7 @@ function registerThumbnailRoutes(api, adapter2) {
         return c2.json({ error: "Thumbnail generation returned null" }, 500);
       }
       if (!existsSync10(cacheDir)) mkdirSync6(cacheDir, { recursive: true });
-      writeFileSync3(cachePath, buffer);
+      writeFileSync4(cachePath, buffer);
       return new Response(new Uint8Array(buffer), {
         headers: { "Content-Type": "image/jpeg", "Cache-Control": "public, max-age=60" }
       });
@@ -4971,7 +5250,7 @@ __export(manager_exports2, {
 import { execSync } from "child_process";
 import { existsSync as existsSync11, rmSync as rmSync3 } from "fs";
 import { homedir as homedir4 } from "os";
-import { join as join10 } from "path";
+import { join as join11 } from "path";
 import { Browser, detectBrowserPlatform, getInstalledBrowsers, install } from "@puppeteer/browsers";
 function setBrowserPath(path) {
   _browserPathOverride = path;
@@ -5056,7 +5335,7 @@ var init_manager2 = __esm({
   "src/browser/manager.ts"() {
     "use strict";
     CHROME_VERSION = "131.0.6778.85";
-    CACHE_DIR = join10(homedir4(), ".cache", "hyperframes", "chrome");
+    CACHE_DIR = join11(homedir4(), ".cache", "hyperframes", "chrome");
     SYSTEM_CHROME_PATHS = process.platform === "darwin" ? ["/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"] : [
       "/usr/bin/google-chrome",
       "/usr/bin/google-chrome-stable",
@@ -5174,8 +5453,8 @@ var init_config2 = __esm({
 });
 
 // ../engine/src/services/browserManager.ts
-import { existsSync as existsSync12, readdirSync as readdirSync5 } from "fs";
-import { join as join11 } from "path";
+import { existsSync as existsSync12, readdirSync as readdirSync6 } from "fs";
+import { join as join12 } from "path";
 import { homedir as homedir5 } from "os";
 async function getPuppeteer() {
   if (_puppeteer) return _puppeteer;
@@ -5196,16 +5475,16 @@ function resolveHeadlessShellPath(config) {
   if (process.env.PRODUCER_HEADLESS_SHELL_PATH) {
     return process.env.PRODUCER_HEADLESS_SHELL_PATH;
   }
-  const baseDir = join11(homedir5(), ".cache", "puppeteer", "chrome-headless-shell");
+  const baseDir = join12(homedir5(), ".cache", "puppeteer", "chrome-headless-shell");
   if (!existsSync12(baseDir)) return void 0;
   try {
-    const versions = readdirSync5(baseDir).sort().reverse();
+    const versions = readdirSync6(baseDir).sort().reverse();
     for (const version of versions) {
       const candidates = [
-        join11(baseDir, version, "chrome-headless-shell-linux64", "chrome-headless-shell"),
-        join11(baseDir, version, "chrome-headless-shell-mac-arm64", "chrome-headless-shell"),
-        join11(baseDir, version, "chrome-headless-shell-mac-x64", "chrome-headless-shell"),
-        join11(baseDir, version, "chrome-headless-shell-win64", "chrome-headless-shell.exe")
+        join12(baseDir, version, "chrome-headless-shell-linux64", "chrome-headless-shell"),
+        join12(baseDir, version, "chrome-headless-shell-mac-arm64", "chrome-headless-shell"),
+        join12(baseDir, version, "chrome-headless-shell-mac-x64", "chrome-headless-shell"),
+        join12(baseDir, version, "chrome-headless-shell-win64", "chrome-headless-shell.exe")
       ];
       for (const binary of candidates) {
         if (existsSync12(binary)) return binary;
@@ -5990,6 +6269,69 @@ var init_gsap = __esm({
   }
 });
 
+// ../../node_modules/.bun/@chenglou+pretext@0.0.3/node_modules/@chenglou/pretext/dist/bidi.js
+var init_bidi = __esm({
+  "../../node_modules/.bun/@chenglou+pretext@0.0.3/node_modules/@chenglou/pretext/dist/bidi.js"() {
+    "use strict";
+  }
+});
+
+// ../../node_modules/.bun/@chenglou+pretext@0.0.3/node_modules/@chenglou/pretext/dist/analysis.js
+var arabicScriptRe, combiningMarkRe, decimalDigitRe;
+var init_analysis = __esm({
+  "../../node_modules/.bun/@chenglou+pretext@0.0.3/node_modules/@chenglou/pretext/dist/analysis.js"() {
+    "use strict";
+    arabicScriptRe = new RegExp("\\p{Script=Arabic}", "u");
+    combiningMarkRe = new RegExp("\\p{M}", "u");
+    decimalDigitRe = new RegExp("\\p{Nd}", "u");
+  }
+});
+
+// ../../node_modules/.bun/@chenglou+pretext@0.0.3/node_modules/@chenglou/pretext/dist/measurement.js
+var emojiPresentationRe;
+var init_measurement = __esm({
+  "../../node_modules/.bun/@chenglou+pretext@0.0.3/node_modules/@chenglou/pretext/dist/measurement.js"() {
+    "use strict";
+    init_analysis();
+    emojiPresentationRe = new RegExp("\\p{Emoji_Presentation}", "u");
+  }
+});
+
+// ../../node_modules/.bun/@chenglou+pretext@0.0.3/node_modules/@chenglou/pretext/dist/line-break.js
+var init_line_break = __esm({
+  "../../node_modules/.bun/@chenglou+pretext@0.0.3/node_modules/@chenglou/pretext/dist/line-break.js"() {
+    "use strict";
+    init_measurement();
+  }
+});
+
+// ../../node_modules/.bun/@chenglou+pretext@0.0.3/node_modules/@chenglou/pretext/dist/layout.js
+var init_layout = __esm({
+  "../../node_modules/.bun/@chenglou+pretext@0.0.3/node_modules/@chenglou/pretext/dist/layout.js"() {
+    "use strict";
+    init_bidi();
+    init_analysis();
+    init_measurement();
+    init_line_break();
+  }
+});
+
+// ../core/src/text/fitTextFontSize.ts
+var init_fitTextFontSize = __esm({
+  "../core/src/text/fitTextFontSize.ts"() {
+    "use strict";
+    init_layout();
+  }
+});
+
+// ../core/src/text/index.ts
+var init_text = __esm({
+  "../core/src/text/index.ts"() {
+    "use strict";
+    init_fitTextFontSize();
+  }
+});
+
 // ../core/src/index.ts
 var init_src = __esm({
   "../core/src/index.ts"() {
@@ -6007,6 +6349,7 @@ var init_src = __esm({
     init_hyperframesRuntime_engine();
     init_parityContract();
     init_gsap();
+    init_text();
   }
 });
 
@@ -6174,8 +6517,8 @@ var init_screenshotService = __esm({
 });
 
 // ../engine/src/services/frameCapture.ts
-import { existsSync as existsSync13, mkdirSync as mkdirSync7, writeFileSync as writeFileSync4 } from "fs";
-import { join as join12 } from "path";
+import { existsSync as existsSync13, mkdirSync as mkdirSync7, writeFileSync as writeFileSync5 } from "fs";
+import { join as join13 } from "path";
 async function createCaptureSession(serverUrl, outputDir, options, onBeforeCapture = null, config) {
   if (!existsSync13(outputDir)) mkdirSync7(outputDir, { recursive: true });
   const headlessShell = resolveHeadlessShellPath(config);
@@ -6336,13 +6679,13 @@ async function initializeSession(session) {
 }
 async function captureFrameErrorDiagnostics(session, frameIndex, time, error) {
   try {
-    const diagnosticsDir = join12(session.outputDir, "diagnostics");
+    const diagnosticsDir = join13(session.outputDir, "diagnostics");
     if (!existsSync13(diagnosticsDir)) mkdirSync7(diagnosticsDir, { recursive: true });
-    const base = join12(diagnosticsDir, `frame-error-${frameIndex}`);
+    const base = join13(diagnosticsDir, `frame-error-${frameIndex}`);
     await session.page.screenshot({ path: `${base}.png`, type: "png", fullPage: true });
     const html = await session.page.content();
-    writeFileSync4(`${base}.html`, html, "utf-8");
-    writeFileSync4(
+    writeFileSync5(`${base}.html`, html, "utf-8");
+    writeFileSync5(
       `${base}.json`,
       JSON.stringify(
         {
@@ -6436,8 +6779,8 @@ async function captureFrame(session, frameIndex, time) {
   );
   const ext = options.format === "png" ? "png" : "jpg";
   const frameName = `frame_${String(frameIndex).padStart(6, "0")}.${ext}`;
-  const framePath = join12(outputDir, frameName);
-  writeFileSync4(framePath, buffer);
+  const framePath = join13(outputDir, frameName);
+  writeFileSync5(framePath, buffer);
   return { frameIndex, time: quantizedTime, path: framePath, captureTimeMs };
 }
 async function captureFrameToBuffer(session, frameIndex, time) {
@@ -6497,7 +6840,7 @@ var init_frameCapture = __esm({
 // ../engine/src/utils/gpuEncoder.ts
 import { spawn } from "child_process";
 async function detectGpuEncoder() {
-  return new Promise((resolve21) => {
+  return new Promise((resolve22) => {
     const ffmpeg = spawn("ffmpeg", ["-encoders"], {
       stdio: ["pipe", "pipe", "pipe"]
     });
@@ -6506,13 +6849,13 @@ async function detectGpuEncoder() {
       stdout2 += data.toString();
     });
     ffmpeg.on("close", () => {
-      if (stdout2.includes("h264_nvenc")) resolve21("nvenc");
-      else if (stdout2.includes("h264_videotoolbox")) resolve21("videotoolbox");
-      else if (stdout2.includes("h264_vaapi")) resolve21("vaapi");
-      else if (stdout2.includes("h264_qsv")) resolve21("qsv");
-      else resolve21(null);
+      if (stdout2.includes("h264_nvenc")) resolve22("nvenc");
+      else if (stdout2.includes("h264_videotoolbox")) resolve22("videotoolbox");
+      else if (stdout2.includes("h264_vaapi")) resolve22("vaapi");
+      else if (stdout2.includes("h264_qsv")) resolve22("qsv");
+      else resolve22(null);
     });
-    ffmpeg.on("error", () => resolve21(null));
+    ffmpeg.on("error", () => resolve22(null));
   });
 }
 async function getCachedGpuEncoder() {
@@ -6551,7 +6894,7 @@ async function runFfmpeg(args, opts) {
   const signal = opts?.signal;
   const timeout = opts?.timeout ?? DEFAULT_TIMEOUT;
   const onStderr = opts?.onStderr;
-  return new Promise((resolve21) => {
+  return new Promise((resolve22) => {
     const ffmpeg = spawn2("ffmpeg", args);
     let stderr = "";
     const onAbort = () => {
@@ -6577,7 +6920,7 @@ async function runFfmpeg(args, opts) {
     ffmpeg.on("close", (code) => {
       clearTimeout(timer);
       if (signal) signal.removeEventListener("abort", onAbort);
-      resolve21({
+      resolve22({
         success: !signal?.aborted && code === 0,
         exitCode: code,
         stderr,
@@ -6587,7 +6930,7 @@ async function runFfmpeg(args, opts) {
     ffmpeg.on("error", (err) => {
       clearTimeout(timer);
       if (signal) signal.removeEventListener("abort", onAbort);
-      resolve21({
+      resolve22({
         success: false,
         exitCode: null,
         stderr: err.message,
@@ -6606,8 +6949,8 @@ var init_runFfmpeg = __esm({
 
 // ../engine/src/services/chunkEncoder.ts
 import { spawn as spawn3 } from "child_process";
-import { copyFileSync, existsSync as existsSync14, mkdirSync as mkdirSync8, readdirSync as readdirSync6, statSync as statSync3, writeFileSync as writeFileSync5 } from "fs";
-import { join as join13, dirname as dirname4 } from "path";
+import { copyFileSync, existsSync as existsSync14, mkdirSync as mkdirSync8, readdirSync as readdirSync7, statSync as statSync3, writeFileSync as writeFileSync6 } from "fs";
+import { join as join14, dirname as dirname4 } from "path";
 function getEncoderPreset(quality, format = "mp4") {
   const base = ENCODER_PRESETS[quality];
   if (format === "webm") {
@@ -6690,7 +7033,7 @@ async function encodeFramesFromDir(framesDir, framePattern, outputPath, options,
   const startTime = Date.now();
   const outputDir = dirname4(outputPath);
   if (!existsSync14(outputDir)) mkdirSync8(outputDir, { recursive: true });
-  const files = readdirSync6(framesDir).filter((f) => f.match(/\.(jpg|jpeg|png)$/i));
+  const files = readdirSync7(framesDir).filter((f) => f.match(/\.(jpg|jpeg|png)$/i));
   const frameCount = files.length;
   if (frameCount === 0) {
     return {
@@ -6706,10 +7049,10 @@ async function encodeFramesFromDir(framesDir, framePattern, outputPath, options,
   if (options.useGpu) {
     gpuEncoder = await getCachedGpuEncoder();
   }
-  const inputPath = join13(framesDir, framePattern);
+  const inputPath = join14(framesDir, framePattern);
   const inputArgs = ["-framerate", String(options.fps), "-i", inputPath];
   const args = buildEncoderArgs(options, inputArgs, outputPath, gpuEncoder);
-  return new Promise((resolve21) => {
+  return new Promise((resolve22) => {
     const ffmpeg = spawn3("ffmpeg", args);
     let stderr = "";
     const onAbort = () => {
@@ -6734,7 +7077,7 @@ async function encodeFramesFromDir(framesDir, framePattern, outputPath, options,
       if (signal) signal.removeEventListener("abort", onAbort);
       const durationMs = Date.now() - startTime;
       if (signal?.aborted) {
-        resolve21({
+        resolve22({
           success: false,
           outputPath,
           durationMs,
@@ -6745,7 +7088,7 @@ async function encodeFramesFromDir(framesDir, framePattern, outputPath, options,
         return;
       }
       if (code !== 0) {
-        resolve21({
+        resolve22({
           success: false,
           outputPath,
           durationMs,
@@ -6756,12 +7099,12 @@ async function encodeFramesFromDir(framesDir, framePattern, outputPath, options,
         return;
       }
       const fileSize = existsSync14(outputPath) ? statSync3(outputPath).size : 0;
-      resolve21({ success: true, outputPath, durationMs, framesEncoded: frameCount, fileSize });
+      resolve22({ success: true, outputPath, durationMs, framesEncoded: frameCount, fileSize });
     });
     ffmpeg.on("error", (err) => {
       clearTimeout(timer);
       if (signal) signal.removeEventListener("abort", onAbort);
-      resolve21({
+      resolve22({
         success: false,
         outputPath,
         durationMs: Date.now() - startTime,
@@ -6774,7 +7117,7 @@ async function encodeFramesFromDir(framesDir, framePattern, outputPath, options,
 }
 async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, options, chunkSizeFrames, signal) {
   const start = Date.now();
-  const files = readdirSync6(framesDir).filter((f) => f.match(/\.(jpg|jpeg|png)$/i)).sort();
+  const files = readdirSync7(framesDir).filter((f) => f.match(/\.(jpg|jpeg|png)$/i)).sort();
   if (files.length === 0) {
     return {
       success: false,
@@ -6787,7 +7130,7 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
   }
   const chunkSize = Math.max(30, Math.floor(chunkSizeFrames));
   const chunkCount = Math.ceil(files.length / chunkSize);
-  const chunkDir = join13(dirname4(outputPath), "chunk-encode");
+  const chunkDir = join14(dirname4(outputPath), "chunk-encode");
   if (!existsSync14(chunkDir)) mkdirSync8(chunkDir, { recursive: true });
   const chunkPaths = [];
   for (let i = 0; i < chunkCount; i++) {
@@ -6804,8 +7147,8 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
     const startNumber = i * chunkSize;
     const framesInChunk = Math.min(chunkSize, files.length - startNumber);
     const ext = outputPath.endsWith(".webm") ? ".webm" : ".mp4";
-    const chunkPath = join13(chunkDir, `chunk_${String(i).padStart(4, "0")}${ext}`);
-    const inputPath = join13(framesDir, framePattern);
+    const chunkPath = join14(chunkDir, `chunk_${String(i).padStart(4, "0")}${ext}`);
+    const inputPath = join14(framesDir, framePattern);
     const inputArgs = [
       "-framerate",
       String(options.fps),
@@ -6819,18 +7162,18 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
     let gpuEncoder = null;
     if (options.useGpu) gpuEncoder = await getCachedGpuEncoder();
     const args = buildEncoderArgs(options, inputArgs, chunkPath, gpuEncoder);
-    const chunkResult = await new Promise((resolve21) => {
+    const chunkResult = await new Promise((resolve22) => {
       const ffmpeg = spawn3("ffmpeg", args);
       let stderr = "";
       ffmpeg.stderr.on("data", (d) => {
         stderr += d.toString();
       });
       ffmpeg.on("close", (code) => {
-        if (code === 0) resolve21({ success: true });
-        else resolve21({ success: false, error: `Chunk ${i} encode failed: ${stderr.slice(-400)}` });
+        if (code === 0) resolve22({ success: true });
+        else resolve22({ success: false, error: `Chunk ${i} encode failed: ${stderr.slice(-400)}` });
       });
       ffmpeg.on("error", (err) => {
-        resolve21({ success: false, error: `Chunk ${i} encode error: ${err.message}` });
+        resolve22({ success: false, error: `Chunk ${i} encode error: ${err.message}` });
       });
     });
     if (!chunkResult.success) {
@@ -6845,9 +7188,9 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
     }
     chunkPaths.push(chunkPath);
   }
-  const concatListPath = join13(chunkDir, "concat-list.txt");
+  const concatListPath = join14(chunkDir, "concat-list.txt");
   const concatInput = chunkPaths.map((path) => `file '${path.replace(/'/g, "'\\''")}'`).join("\n");
-  writeFileSync5(concatListPath, concatInput, "utf-8");
+  writeFileSync6(concatListPath, concatInput, "utf-8");
   const concatArgs = [
     "-f",
     "concat",
@@ -6860,18 +7203,18 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
     "-y",
     outputPath
   ];
-  const concatResult = await new Promise((resolve21) => {
+  const concatResult = await new Promise((resolve22) => {
     const ffmpeg = spawn3("ffmpeg", concatArgs);
     let stderr = "";
     ffmpeg.stderr.on("data", (d) => {
       stderr += d.toString();
     });
     ffmpeg.on("close", (code) => {
-      if (code === 0) resolve21({ success: true });
-      else resolve21({ success: false, error: `Chunk concat failed: ${stderr.slice(-400)}` });
+      if (code === 0) resolve22({ success: true });
+      else resolve22({ success: false, error: `Chunk concat failed: ${stderr.slice(-400)}` });
     });
     ffmpeg.on("error", (err) => {
-      resolve21({ success: false, error: `Chunk concat error: ${err.message}` });
+      resolve22({ success: false, error: `Chunk concat error: ${err.message}` });
     });
   });
   if (!concatResult.success) {
@@ -6976,16 +7319,16 @@ function createFrameReorderBuffer(startFrame, endFrame) {
     }
   };
   return {
-    waitForFrame: (frame) => new Promise((resolve21) => {
-      waiters.push({ frame, resolve: resolve21 });
+    waitForFrame: (frame) => new Promise((resolve22) => {
+      waiters.push({ frame, resolve: resolve22 });
       resolveWaiters();
     }),
     advanceTo: (frame) => {
       nextFrame = frame;
       resolveWaiters();
     },
-    waitForAllDone: () => new Promise((resolve21) => {
-      waiters.push({ frame: endFrame, resolve: resolve21 });
+    waitForAllDone: () => new Promise((resolve22) => {
+      waiters.push({ frame: endFrame, resolve: resolve22 });
       resolveWaiters();
     })
   };
@@ -7085,7 +7428,7 @@ async function spawnStreamingEncoder(outputPath, options, signal, config) {
   let stderr = "";
   let exitCode = null;
   let exitPromiseResolve = null;
-  const exitPromise = new Promise((resolve21) => exitPromiseResolve = resolve21);
+  const exitPromise = new Promise((resolve22) => exitPromiseResolve = resolve22);
   ffmpeg.stderr?.on("data", (data) => {
     stderr += data.toString();
   });
@@ -7129,8 +7472,8 @@ Process error: ${err.message}`;
       clearTimeout(timer);
       if (signal) signal.removeEventListener("abort", onAbort);
       if (ffmpeg.stdin && !ffmpeg.stdin.destroyed) {
-        await new Promise((resolve21) => {
-          ffmpeg.stdin.end(() => resolve21());
+        await new Promise((resolve22) => {
+          ffmpeg.stdin.end(() => resolve22());
         });
       }
       await exitPromise;
@@ -11020,8 +11363,8 @@ var init_custom_element_registry = __esm({
         } : (element) => element.localName === localName;
         registry.set(localName, { Class, check });
         if (waiting.has(localName)) {
-          for (const resolve21 of waiting.get(localName))
-            resolve21(Class);
+          for (const resolve22 of waiting.get(localName))
+            resolve22(Class);
           waiting.delete(localName);
         }
         ownerDocument.querySelectorAll(
@@ -11061,13 +11404,13 @@ var init_custom_element_registry = __esm({
        */
       whenDefined(localName) {
         const { registry, waiting } = this;
-        return new Promise((resolve21) => {
+        return new Promise((resolve22) => {
           if (registry.has(localName))
-            resolve21(registry.get(localName).Class);
+            resolve22(registry.get(localName).Class);
           else {
             if (!waiting.has(localName))
               waiting.set(localName, []);
-            waiting.get(localName).push(resolve21);
+            waiting.get(localName).push(resolve22);
           }
         });
       }
@@ -13754,7 +14097,7 @@ var init_matches = __esm({
 
 // ../../node_modules/.bun/linkedom@0.18.12/node_modules/linkedom/esm/interface/text.js
 var Text3;
-var init_text = __esm({
+var init_text2 = __esm({
   "../../node_modules/.bun/linkedom@0.18.12/node_modules/linkedom/esm/interface/text.js"() {
     "use strict";
     init_constants2();
@@ -13807,7 +14150,7 @@ var init_parent_node = __esm({
     init_node3();
     init_utils();
     init_node2();
-    init_text();
+    init_text2();
     init_node_list();
     init_mutation_observer();
     init_custom_element_registry();
@@ -14593,7 +14936,7 @@ var init_element = __esm({
     init_shadow_root();
     init_node_list();
     init_attr();
-    init_text();
+    init_text2();
     init_text_escaper();
     attributesHandler = {
       get(target, key2) {
@@ -15157,7 +15500,7 @@ var init_facades = __esm({
     init_element();
     init_node2();
     init_shadow_root();
-    init_text();
+    init_text2();
     init_element2();
     init_object();
     illegalConstructor = () => {
@@ -19290,7 +19633,7 @@ var init_document = __esm({
     init_named_node_map();
     init_node_list();
     init_range();
-    init_text();
+    init_text2();
     init_tree_walker();
     query = (method, ownerDocument, selectors) => {
       let { [NEXT]: next, [END]: end } = ownerDocument;
@@ -19721,7 +20064,7 @@ var init_parse_json = __esm({
     init_cdata_section();
     init_comment();
     init_document_type();
-    init_text();
+    init_text2();
     init_document2();
     init_element3();
     init_element2();
@@ -19770,7 +20113,7 @@ var init_esm10 = __esm({
 // ../engine/src/utils/ffprobe.ts
 import { spawn as spawn5 } from "child_process";
 function runFfprobe(args) {
-  return new Promise((resolve21, reject) => {
+  return new Promise((resolve22, reject) => {
     const proc = spawn5("ffprobe", args);
     let stdout2 = "";
     let stderr = "";
@@ -19784,7 +20127,7 @@ function runFfprobe(args) {
       if (code !== 0) {
         reject(new Error(`[FFmpeg] ffprobe exited with code ${code}: ${stderr}`));
       } else {
-        resolve21(stdout2);
+        resolve22(stdout2);
       }
     });
     proc.on("error", (err) => {
@@ -19949,13 +20292,13 @@ var init_ffprobe = __esm({
 // ../engine/src/utils/urlDownloader.ts
 import { createWriteStream as createWriteStream2, existsSync as existsSync16, mkdirSync as mkdirSync10 } from "fs";
 import { createHash } from "crypto";
-import { join as join14, extname } from "path";
+import { join as join15, extname as extname2 } from "path";
 import { Readable } from "stream";
 import { finished } from "stream/promises";
 function getFilenameFromUrl(url) {
   const hash = createHash("md5").update(url).digest("hex").slice(0, 12);
   const urlObj = new URL(url);
-  const ext = extname(urlObj.pathname) || ".mp4";
+  const ext = extname2(urlObj.pathname) || ".mp4";
   return `download_${hash}${ext}`;
 }
 async function downloadToTemp(url, destDir, timeoutMs = 3e5) {
@@ -19971,7 +20314,7 @@ async function downloadToTemp(url, destDir, timeoutMs = 3e5) {
     mkdirSync10(destDir, { recursive: true });
   }
   const filename = getFilenameFromUrl(url);
-  const localPath = join14(destDir, filename);
+  const localPath = join15(destDir, filename);
   if (existsSync16(localPath)) {
     downloadPathCache.set(url, localPath);
     return localPath;
@@ -20020,8 +20363,8 @@ var init_urlDownloader = __esm({
 
 // ../engine/src/services/videoFrameExtractor.ts
 import { spawn as spawn6 } from "child_process";
-import { existsSync as existsSync17, mkdirSync as mkdirSync11, readdirSync as readdirSync7, rmSync as rmSync4 } from "fs";
-import { join as join15 } from "path";
+import { existsSync as existsSync17, mkdirSync as mkdirSync11, readdirSync as readdirSync8, rmSync as rmSync4 } from "fs";
+import { join as join16 } from "path";
 function parseVideoElements(html) {
   const videos = [];
   const { document: document2 } = parseHTML(html);
@@ -20066,11 +20409,11 @@ function parseVideoElements(html) {
 async function extractVideoFramesRange(videoPath, videoId, startTime, duration, options, signal, config) {
   const ffmpegProcessTimeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG2.ffmpegProcessTimeout;
   const { fps, outputDir, quality = 95, format = "jpg" } = options;
-  const videoOutputDir = join15(outputDir, videoId);
+  const videoOutputDir = join16(outputDir, videoId);
   if (!existsSync17(videoOutputDir)) mkdirSync11(videoOutputDir, { recursive: true });
   const metadata = await extractVideoMetadata(videoPath);
   const framePattern = `frame_%05d.${format}`;
-  const outputPattern = join15(videoOutputDir, framePattern);
+  const outputPattern = join16(videoOutputDir, framePattern);
   const args = [
     "-ss",
     String(startTime),
@@ -20085,7 +20428,7 @@ async function extractVideoFramesRange(videoPath, videoId, startTime, duration,
   ];
   if (format === "png") args.push("-compression_level", "6");
   args.push("-y", outputPattern);
-  return new Promise((resolve21, reject) => {
+  return new Promise((resolve22, reject) => {
     const ffmpeg = spawn6("ffmpeg", args);
     let stderr = "";
     const onAbort = () => {
@@ -20116,11 +20459,11 @@ async function extractVideoFramesRange(videoPath, videoId, startTime, duration,
         return;
       }
       const framePaths = /* @__PURE__ */ new Map();
-      const files = readdirSync7(videoOutputDir).filter((f) => f.startsWith("frame_") && f.endsWith(`.${format}`)).sort();
+      const files = readdirSync8(videoOutputDir).filter((f) => f.startsWith("frame_") && f.endsWith(`.${format}`)).sort();
       files.forEach((file, index) => {
-        framePaths.set(index, join15(videoOutputDir, file));
+        framePaths.set(index, join16(videoOutputDir, file));
       });
-      resolve21({
+      resolve22({
         videoId,
         srcPath: videoPath,
         outputDir: videoOutputDir,
@@ -20155,10 +20498,10 @@ async function extractAllVideoFrames(videos, baseDir, options, signal, config) {
       try {
         let videoPath = video.src;
         if (!videoPath.startsWith("/") && !isHttpUrl(videoPath)) {
-          videoPath = join15(baseDir, videoPath);
+          videoPath = join16(baseDir, videoPath);
         }
         if (isHttpUrl(videoPath)) {
-          const downloadDir = join15(options.outputDir, "_downloads");
+          const downloadDir = join16(options.outputDir, "_downloads");
           mkdirSync11(downloadDir, { recursive: true });
           videoPath = await downloadToTemp(videoPath, downloadDir);
         }
@@ -20419,7 +20762,7 @@ var init_videoFrameInjector = __esm({
 
 // ../engine/src/services/audioMixer.ts
 import { existsSync as existsSync18, mkdirSync as mkdirSync12, rmSync as rmSync5 } from "fs";
-import { join as join16, dirname as dirname6 } from "path";
+import { join as join17, dirname as dirname6 } from "path";
 function parseAudioElements(html) {
   const elements = [];
   const { document: document2 } = parseHTML(html);
@@ -20647,7 +20990,7 @@ async function processCompositionAudio(elements, baseDir, workDir, outputPath, t
       try {
         let srcPath = element.src;
         if (!srcPath.startsWith("/") && !isHttpUrl(srcPath)) {
-          srcPath = join16(baseDir, srcPath);
+          srcPath = join17(baseDir, srcPath);
         }
         if (isHttpUrl(srcPath)) {
           try {
@@ -20670,7 +21013,7 @@ async function processCompositionAudio(elements, baseDir, workDir, outputPath, t
         }
         let audioSrcPath = srcPath;
         if (element.type === "video") {
-          const extractedPath = join16(workDir, `${element.id}-extracted.wav`);
+          const extractedPath = join17(workDir, `${element.id}-extracted.wav`);
           const extractResult = await extractAudioFromVideo(
             srcPath,
             extractedPath,
@@ -20687,7 +21030,7 @@ async function processCompositionAudio(elements, baseDir, workDir, outputPath, t
           }
           audioSrcPath = extractedPath;
         } else {
-          const trimmedPath = join16(workDir, `${element.id}-trimmed.wav`);
+          const trimmedPath = join17(workDir, `${element.id}-trimmed.wav`);
           const prepResult = await prepareAudioTrack(
             srcPath,
             trimmedPath,
@@ -20740,9 +21083,9 @@ var init_audioMixer = __esm({
 
 // ../engine/src/services/parallelCoordinator.ts
 import { cpus as cpus2, freemem, totalmem as totalmem2 } from "os";
-import { existsSync as existsSync19, mkdirSync as mkdirSync13, readdirSync as readdirSync8 } from "fs";
+import { existsSync as existsSync19, mkdirSync as mkdirSync13, readdirSync as readdirSync9 } from "fs";
 import { copyFile, rename } from "fs/promises";
-import { join as join17 } from "path";
+import { join as join18 } from "path";
 function calculateOptimalWorkers(totalFrames, requested, config) {
   const effectiveMaxWorkers = (() => {
     const concurrency = config?.concurrency ?? DEFAULT_CONFIG2.concurrency;
@@ -20785,7 +21128,7 @@ function distributeFrames(totalFrames, workerCount, workDir) {
       workerId: i,
       startFrame,
       endFrame,
-      outputDir: join17(workDir, `worker-${i}`)
+      outputDir: join18(workDir, `worker-${i}`)
     });
   }
   return tasks;
@@ -20890,10 +21233,10 @@ async function mergeWorkerFrames(workDir, tasks, outputDir) {
     if (!existsSync19(task.outputDir)) {
       continue;
     }
-    const files = readdirSync8(task.outputDir).filter((f) => f.startsWith("frame_") && (f.endsWith(".jpg") || f.endsWith(".png"))).sort();
+    const files = readdirSync9(task.outputDir).filter((f) => f.startsWith("frame_") && (f.endsWith(".jpg") || f.endsWith(".png"))).sort();
     const copyTasks = files.map(async (file) => {
-      const sourcePath = join17(task.outputDir, file);
-      const targetPath = join17(outputDir, file);
+      const sourcePath = join18(task.outputDir, file);
+      const targetPath = join18(outputDir, file);
       try {
         await rename(sourcePath, targetPath);
       } catch {
@@ -20930,8 +21273,8 @@ var init_parallelCoordinator = __esm({
 // ../engine/src/services/fileServer.ts
 import { Hono as Hono2 } from "hono";
 import { serve } from "@hono/node-server";
-import { readFileSync as readFileSync10, existsSync as existsSync20, statSync as statSync5 } from "fs";
-import { join as join18, extname as extname2 } from "path";
+import { readFileSync as readFileSync11, existsSync as existsSync20, statSync as statSync5 } from "fs";
+import { join as join19, extname as extname3 } from "path";
 function stripEmbeddedRuntimeScripts(html) {
   if (!html) return html;
   const scriptRe = /<script\b[^>]*>[\s\S]*?<\/script>/gi;
@@ -21000,32 +21343,32 @@ function createFileServer(options) {
     let requestPath = c2.req.path;
     if (requestPath === "/") requestPath = "/index.html";
     const relativePath = requestPath.replace(/^\//, "");
-    const compiledPath = compiledDir ? join18(compiledDir, relativePath) : null;
+    const compiledPath = compiledDir ? join19(compiledDir, relativePath) : null;
     const hasCompiledFile = Boolean(
       compiledPath && existsSync20(compiledPath) && statSync5(compiledPath).isFile()
     );
-    const filePath = hasCompiledFile ? compiledPath : join18(projectDir, relativePath);
+    const filePath = hasCompiledFile ? compiledPath : join19(projectDir, relativePath);
     if (!existsSync20(filePath) || !statSync5(filePath).isFile()) {
       return c2.text("Not found", 404);
     }
-    const ext = extname2(filePath).toLowerCase();
+    const ext = extname3(filePath).toLowerCase();
     const contentType = MIME_TYPES2[ext] || "application/octet-stream";
     if (ext === ".html") {
-      const rawHtml = readFileSync10(filePath, "utf-8");
+      const rawHtml = readFileSync11(filePath, "utf-8");
       const html = relativePath === "index.html" ? injectScriptsIntoHtml(rawHtml, headScripts, bodyScripts, stripEmbeddedRuntime) : rawHtml;
       return c2.text(html, 200, { "Content-Type": contentType });
     }
-    const content = readFileSync10(filePath);
+    const content = readFileSync11(filePath);
     return new Response(content, {
       status: 200,
       headers: { "Content-Type": contentType }
     });
   });
-  return new Promise((resolve21) => {
+  return new Promise((resolve22) => {
     const server = serve({ fetch: app.fetch, port }, (info) => {
       const actualPort = info.port;
       const url = `http://localhost:${actualPort}`;
-      resolve21({
+      resolve22({
         url,
         port: actualPort,
         close: () => server.close()
@@ -21219,8 +21562,8 @@ var init_staticGuard = __esm({
 });
 
 // ../core/src/compiler/htmlBundler.ts
-import { readFileSync as readFileSync11, existsSync as existsSync21 } from "fs";
-import { join as join19, resolve as resolve7, isAbsolute, sep as sep2 } from "path";
+import { readFileSync as readFileSync12, existsSync as existsSync21 } from "fs";
+import { join as join20, resolve as resolve7, isAbsolute, sep as sep2 } from "path";
 import * as cheerio from "cheerio";
 import { transformSync } from "esbuild";
 function safePath(projectDir, relativePath) {
@@ -21284,7 +21627,7 @@ function isRelativeUrl(url) {
 function safeReadFile(filePath) {
   if (!existsSync21(filePath)) return null;
   try {
-    return readFileSync11(filePath, "utf-8");
+    return readFileSync12(filePath, "utf-8");
   } catch {
     return null;
   }
@@ -21292,7 +21635,7 @@ function safeReadFile(filePath) {
 function safeReadFileBuffer(filePath) {
   if (!existsSync21(filePath)) return null;
   try {
-    return readFileSync11(filePath);
+    return readFileSync12(filePath);
   } catch {
     return null;
   }
@@ -21479,9 +21822,9 @@ function stripJsCommentsParserSafe(source) {
   }
 }
 async function bundleToSingleHtml(projectDir, options) {
-  const indexPath = join19(projectDir, "index.html");
+  const indexPath = join20(projectDir, "index.html");
   if (!existsSync21(indexPath)) throw new Error("index.html not found in project directory");
-  const rawHtml = readFileSync11(indexPath, "utf-8");
+  const rawHtml = readFileSync12(indexPath, "utf-8");
   const compiled = await compileHtml(rawHtml, projectDir, options?.probeMediaDuration);
   const staticGuard = validateHyperframeHtmlContract(compiled);
   if (!staticGuard.isValid) {
@@ -21586,6 +21929,64 @@ async function bundleToSingleHtml(projectDir, options) {
     }
     $(hostEl).removeAttr("data-composition-src");
   });
+  $("template[id]").each((_2, templateEl) => {
+    const templateId = $(templateEl).attr("id") || "";
+    const match = templateId.match(/^(.+)-template$/);
+    if (!match) return;
+    const compId = match[1];
+    const hostSelector = `[data-composition-id="${compId}"]:not([data-composition-src])`;
+    const $candidates = $(hostSelector).filter((__, el) => $(el).parents().length > 0);
+    const $host = $candidates.first();
+    if ($host.length === 0) return;
+    if ($host.children().length > 0) return;
+    const templateHtml = $(templateEl).html() || "";
+    const $inner = cheerio.load(templateHtml, { xml: false });
+    const $innerRoot = $inner(`[data-composition-id="${compId}"]`).first();
+    if ($innerRoot.length > 0) {
+      $innerRoot.find("style").each((__, styleEl) => {
+        compStyleChunks.push($inner(styleEl).html() || "");
+        $inner(styleEl).remove();
+      });
+      $innerRoot.find("script").each((__, scriptEl) => {
+        const externalSrc = ($inner(scriptEl).attr("src") || "").trim();
+        if (externalSrc) {
+          if (!compExternalScriptSrcs.includes(externalSrc)) {
+            compExternalScriptSrcs.push(externalSrc);
+          }
+        } else {
+          compScriptChunks.push(
+            `(function(){ try { ${$inner(scriptEl).html() || ""} } catch (_err) { console.error('[HyperFrames] composition script error:', _err); } })();`
+          );
+        }
+        $inner(scriptEl).remove();
+      });
+      const innerW = $innerRoot.attr("data-width");
+      const innerH = $innerRoot.attr("data-height");
+      if (innerW && !$host.attr("data-width")) $host.attr("data-width", innerW);
+      if (innerH && !$host.attr("data-height")) $host.attr("data-height", innerH);
+      $host.html($innerRoot.html() || "");
+    } else {
+      $inner("style").each((__, styleEl) => {
+        compStyleChunks.push($inner(styleEl).html() || "");
+        $inner(styleEl).remove();
+      });
+      $inner("script").each((__, scriptEl) => {
+        const externalSrc = ($inner(scriptEl).attr("src") || "").trim();
+        if (externalSrc) {
+          if (!compExternalScriptSrcs.includes(externalSrc)) {
+            compExternalScriptSrcs.push(externalSrc);
+          }
+        } else {
+          compScriptChunks.push(
+            `(function(){ try { ${$inner(scriptEl).html() || ""} } catch (_err) { console.error('[HyperFrames] composition script error:', _err); } })();`
+          );
+        }
+        $inner(scriptEl).remove();
+      });
+      $host.html($inner.html() || "");
+    }
+    $(templateEl).remove();
+  });
   for (const extSrc of compExternalScriptSrcs) {
     if (!$(`script[src="${extSrc}"]`).length) {
       $("body").append(`<script src="${extSrc}"></script>`);
@@ -21651,7 +22052,7 @@ var init_compiler = __esm({
 
 // ../producer/src/services/hyperframeRuntimeLoader.ts
 import { createHash as createHash2 } from "crypto";
-import { existsSync as existsSync22, readFileSync as readFileSync12 } from "fs";
+import { existsSync as existsSync22, readFileSync as readFileSync13 } from "fs";
 import { dirname as dirname7, resolve as resolve8 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 function resolveHyperframeManifestPath() {
@@ -21680,7 +22081,7 @@ function resolveVerifiedHyperframeRuntime() {
       `[HyperframeRuntimeLoader] Missing manifest at ${manifestPath}. Build core runtime artifacts before rendering.`
     );
   }
-  const manifestRaw = readFileSync12(manifestPath, "utf8");
+  const manifestRaw = readFileSync13(manifestPath, "utf8");
   const manifest = JSON.parse(manifestRaw);
   const runtimeFileName = manifest.artifacts?.iife;
   if (!runtimeFileName || !manifest.sha256) {
@@ -21692,7 +22093,7 @@ function resolveVerifiedHyperframeRuntime() {
   if (!existsSync22(runtimePath)) {
     throw new Error(`[HyperframeRuntimeLoader] Missing runtime artifact at ${runtimePath}.`);
   }
-  const runtimeSource = readFileSync12(runtimePath, "utf8");
+  const runtimeSource = readFileSync13(runtimePath, "utf8");
   const runtimeSha = createHash2("sha256").update(runtimeSource, "utf8").digest("hex");
   if (runtimeSha !== manifest.sha256) {
     throw new Error(
@@ -21731,8 +22132,8 @@ var init_hyperframeRuntimeLoader = __esm({
 // ../producer/src/services/fileServer.ts
 import { Hono as Hono3 } from "hono";
 import { serve as serve2 } from "@hono/node-server";
-import { readFileSync as readFileSync13, existsSync as existsSync23, statSync as statSync6 } from "fs";
-import { join as join20, extname as extname3 } from "path";
+import { readFileSync as readFileSync14, existsSync as existsSync23, statSync as statSync6 } from "fs";
+import { join as join21, extname as extname4 } from "path";
 function stripEmbeddedRuntimeScripts3(html) {
   if (!html) return html;
   const scriptRe = /<script\b[^>]*>[\s\S]*?<\/script>/gi;
@@ -21801,33 +22202,33 @@ function createFileServer2(options) {
     let requestPath = c2.req.path;
     if (requestPath === "/") requestPath = "/index.html";
     const relativePath = requestPath.replace(/^\//, "");
-    const compiledPath = compiledDir ? join20(compiledDir, relativePath) : null;
+    const compiledPath = compiledDir ? join21(compiledDir, relativePath) : null;
     const hasCompiledFile = Boolean(
       compiledPath && existsSync23(compiledPath) && statSync6(compiledPath).isFile()
     );
-    const filePath = hasCompiledFile ? compiledPath : join20(projectDir, relativePath);
+    const filePath = hasCompiledFile ? compiledPath : join21(projectDir, relativePath);
     if (!existsSync23(filePath) || !statSync6(filePath).isFile()) {
       return c2.text("Not found", 404);
     }
-    const ext = extname3(filePath).toLowerCase();
+    const ext = extname4(filePath).toLowerCase();
     const contentType = MIME_TYPES3[ext] || "application/octet-stream";
     if (ext === ".html") {
-      const rawHtml = readFileSync13(filePath, "utf-8");
+      const rawHtml = readFileSync14(filePath, "utf-8");
       const isIndex = relativePath === "index.html";
       const html = isIndex ? injectScriptsIntoHtml2(rawHtml, headScripts, bodyScripts, stripEmbeddedRuntime) : rawHtml;
       return c2.text(html, 200, { "Content-Type": contentType });
     }
-    const content = readFileSync13(filePath);
+    const content = readFileSync14(filePath);
     return new Response(content, {
       status: 200,
       headers: { "Content-Type": contentType }
     });
   });
-  return new Promise((resolve21) => {
+  return new Promise((resolve22) => {
     const server = serve2({ fetch: app.fetch, port }, (info) => {
       const actualPort = info.port;
       const url = `http://localhost:${actualPort}`;
-      resolve21({
+      resolve22({
         url,
         port: actualPort,
         close: () => server.close()
@@ -22269,8 +22670,8 @@ var init_deterministicFonts = __esm({
 });
 
 // ../producer/src/services/htmlCompiler.ts
-import { readFileSync as readFileSync14, existsSync as existsSync24, mkdirSync as mkdirSync14 } from "fs";
-import { join as join21, dirname as dirname8, resolve as resolve9 } from "path";
+import { readFileSync as readFileSync15, existsSync as existsSync24, mkdirSync as mkdirSync14 } from "fs";
+import { join as join22, dirname as dirname8, resolve as resolve9 } from "path";
 function dedupeElementsById(elements) {
   const deduped = /* @__PURE__ */ new Map();
   for (const element of elements) {
@@ -22288,7 +22689,7 @@ async function resolveMediaDuration(src, mediaStart, baseDir, downloadDir, tagNa
       return { duration: 0, resolvedPath: src };
     }
   } else if (!filePath.startsWith("/")) {
-    filePath = join21(baseDir, filePath);
+    filePath = join22(baseDir, filePath);
   }
   if (!existsSync24(filePath)) {
     return { duration: 0, resolvedPath: filePath };
@@ -22361,7 +22762,7 @@ async function parseSubCompositions(html, projectDir, downloadDir, parentOffset
     if (!existsSync24(filePath)) {
       continue;
     }
-    const rawSubHtml = readFileSync14(filePath, "utf-8");
+    const rawSubHtml = readFileSync15(filePath, "utf-8");
     const nestedVisited = new Set(visited);
     nestedVisited.add(filePath);
     workItems.push({ srcPath, absoluteStart, absoluteEnd, filePath, rawSubHtml, nestedVisited });
@@ -22556,7 +22957,7 @@ function inlineSubCompositions(html, subCompositions, projectDir) {
     if (!compHtml) {
       const filePath = resolve9(projectDir, srcPath);
       if (existsSync24(filePath)) {
-        compHtml = readFileSync14(filePath, "utf-8");
+        compHtml = readFileSync15(filePath, "utf-8");
       }
     }
     if (!compHtml) {
@@ -22676,7 +23077,7 @@ ${html}
 </html>`;
 }
 async function compileForRender(projectDir, htmlPath, downloadDir) {
-  const rawHtml = readFileSync14(htmlPath, "utf-8");
+  const rawHtml = readFileSync15(htmlPath, "utf-8");
   const { html: compiledHtml, unresolvedCompositions } = await compileHtmlFile(
     rawHtml,
     projectDir,
@@ -22905,12 +23306,12 @@ import {
   existsSync as existsSync25,
   mkdirSync as mkdirSync15,
   rmSync as rmSync6,
-  readFileSync as readFileSync15,
-  writeFileSync as writeFileSync6,
+  readFileSync as readFileSync16,
+  writeFileSync as writeFileSync7,
   copyFileSync as copyFileSync2,
   appendFileSync
 } from "fs";
-import { join as join22, dirname as dirname9, resolve as resolve10 } from "path";
+import { join as join23, dirname as dirname9, resolve as resolve10 } from "path";
 import { randomUUID as randomUUID2 } from "crypto";
 import { freemem as freemem2 } from "os";
 import { fileURLToPath as fileURLToPath3 } from "url";
@@ -22966,13 +23367,13 @@ function installDebugLogger(logPath, log = defaultLogger) {
   };
 }
 function writeCompiledArtifacts(compiled, workDir, includeSummary) {
-  const compileDir = join22(workDir, "compiled");
+  const compileDir = join23(workDir, "compiled");
   mkdirSync15(compileDir, { recursive: true });
-  writeFileSync6(join22(compileDir, "index.html"), compiled.html, "utf-8");
+  writeFileSync7(join23(compileDir, "index.html"), compiled.html, "utf-8");
   for (const [srcPath, html] of compiled.subCompositions) {
-    const outPath = join22(compileDir, srcPath);
+    const outPath = join23(compileDir, srcPath);
     mkdirSync15(dirname9(outPath), { recursive: true });
-    writeFileSync6(outPath, html, "utf-8");
+    writeFileSync7(outPath, html, "utf-8");
   }
   if (includeSummary) {
     const summary = {
@@ -22995,7 +23396,7 @@ function writeCompiledArtifacts(compiled, workDir, includeSummary) {
       })),
       subCompositions: Array.from(compiled.subCompositions.keys())
     };
-    writeFileSync6(join22(compileDir, "summary.json"), JSON.stringify(summary, null, 2), "utf-8");
+    writeFileSync7(join23(compileDir, "summary.json"), JSON.stringify(summary, null, 2), "utf-8");
   }
 }
 function createRenderJob(config) {
@@ -23040,8 +23441,8 @@ function extractStandaloneEntryFromIndex(indexHtml, entryFile) {
 async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSignal) {
   const moduleDir = dirname9(fileURLToPath3(import.meta.url));
   const producerRoot = process.env.PRODUCER_RENDERS_DIR ? resolve10(process.env.PRODUCER_RENDERS_DIR, "..") : resolve10(moduleDir, "../..");
-  const debugDir = join22(producerRoot, ".debug");
-  const workDir = job.config.debug ? join22(debugDir, job.id) : join22(dirname9(outputPath), `work-${job.id}`);
+  const debugDir = join23(producerRoot, ".debug");
+  const workDir = job.config.debug ? join23(debugDir, job.id) : join23(dirname9(outputPath), `work-${job.id}`);
   const pipelineStart = Date.now();
   const log = job.config.logger ?? defaultLogger;
   let fileServer = null;
@@ -23049,7 +23450,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
   let lastBrowserConsole = [];
   let restoreLogger = null;
   const perfStages = {};
-  const perfOutputPath = join22(workDir, "perf-summary.json");
+  const perfOutputPath = join23(workDir, "perf-summary.json");
   const cfg = { ...job.config.producerConfig ?? resolveConfig() };
   const outputFormat = job.config.format ?? "mp4";
   const isWebm = outputFormat === "webm";
@@ -23069,26 +23470,26 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
     assertNotAborted();
     if (!existsSync25(workDir)) mkdirSync15(workDir, { recursive: true });
     if (job.config.debug) {
-      const logPath = join22(workDir, "render.log");
+      const logPath = join23(workDir, "render.log");
       restoreLogger = installDebugLogger(logPath, log);
     }
     const entryFile = job.config.entryFile || "index.html";
-    let htmlPath = join22(projectDir, entryFile);
+    let htmlPath = join23(projectDir, entryFile);
     if (!existsSync25(htmlPath)) {
       throw new Error(`Entry file not found: ${htmlPath}`);
     }
     assertNotAborted();
-    const rawEntry = readFileSync15(htmlPath, "utf-8");
+    const rawEntry = readFileSync16(htmlPath, "utf-8");
     if (entryFile !== "index.html" && rawEntry.trimStart().startsWith("<template")) {
-      const wrapperPath = join22(workDir, "standalone-entry.html");
-      const projectIndexPath = join22(projectDir, "index.html");
+      const wrapperPath = join23(workDir, "standalone-entry.html");
+      const projectIndexPath = join23(projectDir, "index.html");
       if (!existsSync25(projectIndexPath)) {
         throw new Error(
           `Template entry file "${entryFile}" requires a project index.html to extract its render shell.`
         );
       }
       const standaloneHtml = extractStandaloneEntryFromIndex(
-        readFileSync15(projectIndexPath, "utf-8"),
+        readFileSync16(projectIndexPath, "utf-8"),
         entryFile
       );
       if (!standaloneHtml) {
@@ -23096,7 +23497,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
           `Entry file "${entryFile}" is not mounted from index.html via data-composition-src, so it cannot be rendered independently.`
         );
       }
-      writeFileSync6(wrapperPath, standaloneHtml, "utf-8");
+      writeFileSync7(wrapperPath, standaloneHtml, "utf-8");
       htmlPath = wrapperPath;
       log.info("Extracted standalone entry from index.html host context", {
         entryFile
@@ -23105,7 +23506,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
     const stage1Start = Date.now();
     updateJobStatus(job, "preprocessing", "Compiling composition", 5, onProgress);
     const compileStart = Date.now();
-    let compiled = await compileForRender(projectDir, htmlPath, join22(workDir, "downloads"));
+    let compiled = await compileForRender(projectDir, htmlPath, join23(workDir, "downloads"));
     assertNotAborted();
     perfStages.compileOnlyMs = Date.now() - compileStart;
     writeCompiledArtifacts(compiled, workDir, Boolean(job.config.debug));
@@ -23134,7 +23535,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
         reasons.push(`${compiled.unresolvedCompositions.length} unresolved composition(s)`);
       fileServer = await createFileServer2({
         projectDir,
-        compiledDir: join22(workDir, "compiled"),
+        compiledDir: join23(workDir, "compiled"),
         port: 0
       });
       assertNotAborted();
@@ -23147,7 +23548,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
       };
       probeSession = await createCaptureSession(
         fileServer.url,
-        join22(workDir, "probe"),
+        join23(workDir, "probe"),
         captureOpts,
         null,
         cfg
@@ -23179,7 +23580,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
             compiled,
             resolutions,
             projectDir,
-            join22(workDir, "downloads")
+            join23(workDir, "downloads")
           );
           assertNotAborted();
           composition.videos = compiled.videos;
@@ -23276,7 +23677,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
       const extractionResult = await extractAllVideoFrames(
         composition.videos,
         projectDir,
-        { fps: job.config.fps, outputDir: join22(workDir, "video-frames") },
+        { fps: job.config.fps, outputDir: join23(workDir, "video-frames") },
         abortSignal
       );
       assertNotAborted();
@@ -23308,13 +23709,13 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
     }
     const stage3Start = Date.now();
     updateJobStatus(job, "preprocessing", "Processing audio tracks", 20, onProgress);
-    const audioOutputPath = join22(workDir, "audio.aac");
+    const audioOutputPath = join23(workDir, "audio.aac");
     let hasAudio = false;
     if (composition.audios.length > 0) {
       const audioResult = await processCompositionAudio(
         composition.audios,
         projectDir,
-        join22(workDir, "audio-work"),
+        join23(workDir, "audio-work"),
         audioOutputPath,
         job.duration,
         abortSignal
@@ -23330,12 +23731,12 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
     if (!fileServer) {
       fileServer = await createFileServer2({
         projectDir,
-        compiledDir: join22(workDir, "compiled"),
+        compiledDir: join23(workDir, "compiled"),
         port: 0
       });
       assertNotAborted();
     }
-    const framesDir = join22(workDir, "captured-frames");
+    const framesDir = join23(workDir, "captured-frames");
     if (!existsSync25(framesDir)) mkdirSync15(framesDir, { recursive: true });
     const captureOptions = {
       width,
@@ -23346,7 +23747,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
     };
     const workerCount = calculateOptimalWorkers(job.totalFrames, job.config.workers, cfg);
     const videoExt = isWebm ? ".webm" : ".mp4";
-    const videoOnlyPath = join22(workDir, `video-only${videoExt}`);
+    const videoOnlyPath = join23(workDir, `video-only${videoExt}`);
     const preset = getEncoderPreset(job.config.quality, outputFormat);
     job.framesRendered = 0;
     let streamingEncoder = null;
@@ -23615,7 +24016,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
     job.perfSummary = perfSummary;
     if (job.config.debug) {
       try {
-        writeFileSync6(perfOutputPath, JSON.stringify(perfSummary, null, 2), "utf-8");
+        writeFileSync7(perfOutputPath, JSON.stringify(perfSummary, null, 2), "utf-8");
       } catch (err) {
         log.debug("Failed to write perf summary", {
           perfOutputPath,
@@ -23625,7 +24026,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
     }
     if (job.config.debug) {
       if (existsSync25(outputPath)) {
-        const debugOutput = join22(workDir, isWebm ? "output.webm" : "output.mp4");
+        const debugOutput = join23(workDir, isWebm ? "output.webm" : "output.mp4");
         copyFileSync2(outputPath, debugOutput);
       }
     } else {
@@ -23762,8 +24163,8 @@ var init_config3 = __esm({
 });
 
 // ../producer/src/services/hyperframeLint.ts
-import { existsSync as existsSync26, readFileSync as readFileSync16, statSync as statSync7 } from "fs";
-import { resolve as resolve11, join as join23 } from "path";
+import { existsSync as existsSync26, readFileSync as readFileSync17, statSync as statSync7 } from "fs";
+import { resolve as resolve11, join as join24 } from "path";
 function isStringRecord(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
     return false;
@@ -23805,13 +24206,13 @@ function readProjectEntryFile(projectDir, preferredEntryFile) {
     if (existsSync26(absoluteEntryPath) && statSync7(absoluteEntryPath).isFile()) {
       return {
         entryFile,
-        html: readFileSync16(absoluteEntryPath, "utf-8"),
+        html: readFileSync17(absoluteEntryPath, "utf-8"),
         source: "projectDir"
       };
     }
   }
   return {
-    error: `No HTML entry file found in project directory: ${join23(absProjectDir, preferredEntryFile || "index.html")}`
+    error: `No HTML entry file found in project directory: ${join24(absProjectDir, preferredEntryFile || "index.html")}`
   };
 }
 function prepareHyperframeLintBody(body) {
@@ -23858,11 +24259,11 @@ var init_hyperframeLint = __esm({
 });
 
 // ../producer/src/utils/paths.ts
-import { resolve as resolve12, basename, join as join24 } from "path";
+import { resolve as resolve12, basename, join as join25 } from "path";
 function resolveRenderPaths(projectDir, outputPath, rendersDir = DEFAULT_RENDERS_DIR) {
   const absoluteProjectDir = resolve12(projectDir);
   const projectName = basename(absoluteProjectDir);
-  const resolvedOutputPath = outputPath ?? join24(rendersDir, `${projectName}.mp4`);
+  const resolvedOutputPath = outputPath ?? join25(rendersDir, `${projectName}.mp4`);
   const absoluteOutputPath = resolve12(resolvedOutputPath);
   return { absoluteProjectDir, absoluteOutputPath };
 }
@@ -23880,11 +24281,11 @@ import {
   mkdirSync as mkdirSync16,
   statSync as statSync8,
   mkdtempSync,
-  writeFileSync as writeFileSync7,
+  writeFileSync as writeFileSync8,
   rmSync as rmSync7,
   createReadStream
 } from "fs";
-import { resolve as resolve13, dirname as dirname10, join as join25 } from "path";
+import { resolve as resolve13, dirname as dirname10, join as join26 } from "path";
 import { tmpdir } from "os";
 import { parseArgs as parseArgs2 } from "util";
 import crypto from "crypto";
@@ -23936,8 +24337,8 @@ async function prepareRenderBody(body) {
     }
   }
   const tempRoot = process.env.PRODUCER_TMP_PROJECT_DIR || tmpdir();
-  const tempProjectDir = mkdtempSync(join25(tempRoot, "producer-project-"));
-  writeFileSync7(join25(tempProjectDir, "index.html"), htmlContent, "utf-8");
+  const tempProjectDir = mkdtempSync(join26(tempRoot, "producer-project-"));
+  writeFileSync8(join26(tempProjectDir, "index.html"), htmlContent, "utf-8");
   return {
     prepared: {
       input: {
@@ -24390,8 +24791,8 @@ __export(studioServer_exports, {
 });
 import { Hono as Hono5 } from "hono";
 import { streamSSE as streamSSE3 } from "hono/streaming";
-import { existsSync as existsSync28, readFileSync as readFileSync17, writeFileSync as writeFileSync8, statSync as statSync9 } from "fs";
-import { resolve as resolve14, join as join26, basename as basename2 } from "path";
+import { existsSync as existsSync28, readFileSync as readFileSync18, writeFileSync as writeFileSync9, statSync as statSync9 } from "fs";
+import { resolve as resolve14, join as join27, basename as basename2 } from "path";
 function resolveDistDir() {
   const builtPath = resolve14(__dirname, "studio");
   if (existsSync28(resolve14(builtPath, "index.html"))) return builtPath;
@@ -24472,7 +24873,7 @@ function createStudioServer(options) {
       return lintHyperframeHtml2(html, opts);
     },
     runtimeUrl: "/api/runtime.js",
-    rendersDir: () => join26(projectDir, "renders"),
+    rendersDir: () => join27(projectDir, "renders"),
     startRender(opts) {
       const state = {
         id: opts.jobId,
@@ -24505,7 +24906,7 @@ function createStudioServer(options) {
           state.status = "complete";
           state.progress = 100;
           const metaPath = opts.outputPath.replace(/\.(mp4|webm)$/, ".meta.json");
-          writeFileSync8(
+          writeFileSync9(
             metaPath,
             JSON.stringify({ status: "complete", durationMs: Date.now() - startTime })
           );
@@ -24514,7 +24915,7 @@ function createStudioServer(options) {
           state.error = err instanceof Error ? err.message : String(err);
           try {
             const metaPath = opts.outputPath.replace(/\.(mp4|webm)$/, ".meta.json");
-            writeFileSync8(metaPath, JSON.stringify({ status: "failed" }));
+            writeFileSync9(metaPath, JSON.stringify({ status: "failed" }));
           } catch {
           }
         }
@@ -24555,7 +24956,7 @@ function createStudioServer(options) {
   const app = new Hono5();
   app.get("/api/runtime.js", (c2) => {
     if (!existsSync28(runtimePath)) return c2.text("runtime not built", 404);
-    return c2.body(readFileSync17(runtimePath, "utf-8"), 200, {
+    return c2.body(readFileSync18(runtimePath, "utf-8"), 200, {
       "Content-Type": "text/javascript",
       "Cache-Control": "no-store"
     });
@@ -24588,7 +24989,7 @@ function createStudioServer(options) {
   app.get("/assets/*", (c2) => {
     const filePath = resolve14(studioDir, c2.req.path.slice(1));
     if (!existsSync28(filePath) || !statSync9(filePath).isFile()) return c2.text("not found", 404);
-    const content = readFileSync17(filePath);
+    const content = readFileSync18(filePath);
     return new Response(content, {
       headers: { "Content-Type": getMimeType(filePath), "Cache-Control": "no-store" }
     });
@@ -24596,7 +24997,7 @@ function createStudioServer(options) {
   app.get("/icons/*", (c2) => {
     const filePath = resolve14(studioDir, c2.req.path.slice(1));
     if (!existsSync28(filePath) || !statSync9(filePath).isFile()) return c2.text("not found", 404);
-    const content = readFileSync17(filePath);
+    const content = readFileSync18(filePath);
     return new Response(content, {
       headers: { "Content-Type": getMimeType(filePath), "Cache-Control": "no-store" }
     });
@@ -24606,7 +25007,7 @@ function createStudioServer(options) {
     if (!existsSync28(indexPath)) {
       return c2.text("Studio not found. Rebuild with: pnpm run build", 500);
     }
-    return c2.html(readFileSync17(indexPath, "utf-8"));
+    return c2.html(readFileSync18(indexPath, "utf-8"));
   });
   return { app, watcher };
 }
@@ -24628,7 +25029,7 @@ __export(dev_exports, {
 });
 import { spawn as spawn7 } from "child_process";
 import { existsSync as existsSync29, lstatSync, symlinkSync, unlinkSync as unlinkSync2, readlinkSync, mkdirSync as mkdirSync17 } from "fs";
-import { resolve as resolve15, dirname as dirname11, basename as basename3, join as join27 } from "path";
+import { resolve as resolve15, dirname as dirname11, basename as basename3, join as join28 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 import { createRequire } from "module";
 async function serveWithPortFallback(fetch3, startPort, maxAttempts = 10) {
@@ -24667,9 +25068,9 @@ async function serveWithPortFallback(fetch3, startPort, maxAttempts = 10) {
 async function runDevMode(dir, projectName) {
   const thisFile = fileURLToPath4(import.meta.url);
   const repoRoot = resolve15(dirname11(thisFile), "..", "..", "..", "..");
-  const projectsDir = join27(repoRoot, "packages", "studio", "data", "projects");
+  const projectsDir = join28(repoRoot, "packages", "studio", "data", "projects");
   const pName = projectName ?? basename3(dir);
-  const symlinkPath = join27(projectsDir, pName);
+  const symlinkPath = join28(projectsDir, pName);
   mkdirSync17(projectsDir, { recursive: true });
   let createdSymlink = false;
   if (dir !== symlinkPath) {
@@ -24693,7 +25094,7 @@ async function runDevMode(dir, projectName) {
   Wt2(c.bold("hyperframes dev"));
   const s = be();
   s.start("Starting studio...");
-  const studioPkgDir = join27(repoRoot, "packages", "studio");
+  const studioPkgDir = join28(repoRoot, "packages", "studio");
   const child = spawn7("pnpm", ["exec", "vite"], {
     cwd: studioPkgDir,
     stdio: ["ignore", "pipe", "pipe"]
@@ -24732,13 +25133,13 @@ async function runDevMode(dir, projectName) {
       }
     });
   }
-  return new Promise((resolve21) => {
-    child.on("close", () => resolve21());
+  return new Promise((resolve22) => {
+    child.on("close", () => resolve22());
   });
 }
 function hasLocalStudio(dir) {
   try {
-    const req = createRequire(join27(dir, "package.json"));
+    const req = createRequire(join28(dir, "package.json"));
     req.resolve("@hyperframes/studio/package.json");
     return true;
   } catch {
@@ -24746,11 +25147,11 @@ function hasLocalStudio(dir) {
   }
 }
 async function runLocalStudioMode(dir, projectName) {
-  const req = createRequire(join27(dir, "package.json"));
+  const req = createRequire(join28(dir, "package.json"));
   const studioPkgPath = dirname11(req.resolve("@hyperframes/studio/package.json"));
   const pName = projectName ?? basename3(dir);
-  const projectsDir = join27(studioPkgPath, "data", "projects");
-  const symlinkPath = join27(projectsDir, pName);
+  const projectsDir = join28(studioPkgPath, "data", "projects");
+  const symlinkPath = join28(projectsDir, pName);
   mkdirSync17(projectsDir, { recursive: true });
   let createdSymlink = false;
   if (dir !== symlinkPath) {
@@ -24803,8 +25204,8 @@ async function runLocalStudioMode(dir, projectName) {
       }
     });
   }
-  return new Promise((resolve21) => {
-    child.on("close", () => resolve21());
+  return new Promise((resolve22) => {
+    child.on("close", () => resolve22());
   });
 }
 async function runEmbeddedMode(dir, startPort, projectName) {
@@ -24867,7 +25268,7 @@ var init_dev = __esm({
         const startPort = parseInt(args.port ?? "3002", 10);
         const isImplicitCwd = !rawArg || rawArg === "." || rawArg === "./";
         const projectName = isImplicitCwd ? basename3(process.env.PWD ?? dir) : basename3(dir);
-        const indexPath = join27(dir, "index.html");
+        const indexPath = join28(dir, "index.html");
         if (existsSync29(indexPath)) {
           const project = { dir, name: projectName, indexPath };
           const lintResult = lintProject(project);
@@ -25023,7 +25424,7 @@ __export(render_exports, {
 });
 import { existsSync as existsSync31, mkdirSync as mkdirSync18, statSync as statSync11 } from "fs";
 import { cpus as cpus3, freemem as freemem3 } from "os";
-import { resolve as resolve17, dirname as dirname12, join as join28 } from "path";
+import { resolve as resolve17, dirname as dirname12, join as join29 } from "path";
 function defaultWorkerCount() {
   return Math.max(1, Math.min(Math.floor(CPU_CORE_COUNT / 2), 4));
 }
@@ -25240,7 +25641,7 @@ Examples:
         const now = /* @__PURE__ */ new Date();
         const datePart = now.toISOString().slice(0, 10);
         const timePart = now.toTimeString().slice(0, 8).replace(/:/g, "-");
-        const outputPath = args.output ? resolve17(args.output) : join28(rendersDir, `${project.name}_${datePart}_${timePart}${ext}`);
+        const outputPath = args.output ? resolve17(args.output) : join29(rendersDir, `${project.name}_${datePart}_${timePart}${ext}`);
         mkdirSync18(dirname12(outputPath), { recursive: true });
         const useDocker = args.docker ?? false;
         const useGpu = args.gpu ?? false;
@@ -25350,17 +25751,17 @@ __export(transcribe_exports, {
   transcribe: () => transcribe
 });
 import { execFileSync as execFileSync3 } from "child_process";
-import { existsSync as existsSync32, readFileSync as readFileSync18, mkdirSync as mkdirSync19, unlinkSync as unlinkSync3 } from "fs";
-import { join as join29, extname as extname4 } from "path";
+import { existsSync as existsSync32, readFileSync as readFileSync19, mkdirSync as mkdirSync19, unlinkSync as unlinkSync3 } from "fs";
+import { join as join30, extname as extname5 } from "path";
 import { tmpdir as tmpdir2 } from "os";
 function isAudioFile(filePath) {
-  return AUDIO_EXTENSIONS.has(extname4(filePath).toLowerCase());
+  return AUDIO_EXTENSIONS.has(extname5(filePath).toLowerCase());
 }
 function isVideoFile(filePath) {
-  return VIDEO_EXTENSIONS.has(extname4(filePath).toLowerCase());
+  return VIDEO_EXTENSIONS.has(extname5(filePath).toLowerCase());
 }
 function extractAudio(videoPath) {
-  const wavPath = join29(tmpdir2(), `hyperframes-audio-${Date.now()}.wav`);
+  const wavPath = join30(tmpdir2(), `hyperframes-audio-${Date.now()}.wav`);
   execFileSync3(
     "ffmpeg",
     ["-i", videoPath, "-vn", "-ar", "16000", "-ac", "1", "-f", "wav", "-y", wavPath],
@@ -25383,10 +25784,10 @@ function isWav16kMono(filePath) {
   }
 }
 function prepareAudio(audioPath) {
-  if (extname4(audioPath).toLowerCase() === ".wav" && isWav16kMono(audioPath)) {
+  if (extname5(audioPath).toLowerCase() === ".wav" && isWav16kMono(audioPath)) {
     return audioPath;
   }
-  const wavPath = join29(tmpdir2(), `hyperframes-audio-${Date.now()}.wav`);
+  const wavPath = join30(tmpdir2(), `hyperframes-audio-${Date.now()}.wav`);
   execFileSync3(
     "ffmpeg",
     ["-i", audioPath, "-ar", "16000", "-ac", "1", "-f", "wav", "-y", wavPath],
@@ -25403,7 +25804,7 @@ async function transcribe(inputPath, outputDir, options) {
     onProgress: options?.onProgress
   });
   let wavPath;
-  const ext = extname4(inputPath).toLowerCase();
+  const ext = extname5(inputPath).toLowerCase();
   if (isAudioFile(inputPath)) {
     options?.onProgress?.("Preparing audio...");
     wavPath = prepareAudio(inputPath);
@@ -25419,28 +25820,28 @@ async function transcribe(inputPath, outputDir, options) {
     throw new Error(`Unsupported file type: ${ext}`);
   }
   options?.onProgress?.("Transcribing...");
-  const outputBase = join29(outputDir, "transcript");
+  const outputBase = join30(outputDir, "transcript");
   mkdirSync19(outputDir, { recursive: true });
-  execFileSync3(
-    whisper.executablePath,
-    [
-      "--model",
-      modelPath,
-      "--output-json-full",
-      "--output-file",
-      outputBase,
-      "--dtw",
-      model,
-      "--suppress-nst",
-      wavPath
-    ],
-    { stdio: "ignore", timeout: 3e5 }
-  );
+  const whisperArgs = [
+    "--model",
+    modelPath,
+    "--output-json-full",
+    "--output-file",
+    outputBase,
+    "--dtw",
+    model,
+    "--suppress-nst"
+  ];
+  if (options?.language) {
+    whisperArgs.push("--language", options.language);
+  }
+  whisperArgs.push(wavPath);
+  execFileSync3(whisper.executablePath, whisperArgs, { stdio: "ignore", timeout: 3e5 });
   const transcriptPath = `${outputBase}.json`;
   if (!existsSync32(transcriptPath)) {
     throw new Error("Whisper did not produce output. Check the input file.");
   }
-  const transcript = JSON.parse(readFileSync18(transcriptPath, "utf-8"));
+  const transcript = JSON.parse(readFileSync19(transcriptPath, "utf-8"));
   const segments = transcript.transcription ?? [];
   let wordCount = 0;
   let maxEnd = 0;
@@ -25483,11 +25884,11 @@ import {
   mkdirSync as mkdirSync20,
   copyFileSync as copyFileSync3,
   cpSync as cpSync2,
-  writeFileSync as writeFileSync9,
-  readFileSync as readFileSync19,
-  readdirSync as readdirSync9
+  writeFileSync as writeFileSync10,
+  readFileSync as readFileSync20,
+  readdirSync as readdirSync10
 } from "fs";
-import { resolve as resolve18, basename as basename5, join as join30, dirname as dirname13 } from "path";
+import { resolve as resolve18, basename as basename5, join as join31, dirname as dirname13 } from "path";
 import { fileURLToPath as fileURLToPath5 } from "url";
 import { execFileSync as execFileSync4, spawn as spawn8 } from "child_process";
 async function installSkills(interactive) {
@@ -25622,9 +26023,9 @@ function getBundledSkillsDir() {
   return resolveAssetDir(["..", "..", "..", "..", "skills"], ["skills"]);
 }
 function patchVideoSrc(dir, videoFilename, durationSeconds) {
-  const htmlFiles = readdirSync9(dir, { withFileTypes: true, recursive: true }).filter((e) => e.isFile() && e.name.endsWith(".html")).map((e) => join30(e.parentPath ?? e.path, e.name));
+  const htmlFiles = readdirSync10(dir, { withFileTypes: true, recursive: true }).filter((e) => e.isFile() && e.name.endsWith(".html")).map((e) => join31(e.parentPath ?? e.path, e.name));
   for (const file of htmlFiles) {
-    let content = readFileSync19(file, "utf-8");
+    let content = readFileSync20(file, "utf-8");
     if (videoFilename) {
       content = content.replaceAll("__VIDEO_SRC__", videoFilename);
     } else {
@@ -25635,49 +26036,14 @@ function patchVideoSrc(dir, videoFilename, durationSeconds) {
     }
     const dur = durationSeconds ? String(Math.round(durationSeconds * 100) / 100) : "10";
     content = content.replaceAll("__VIDEO_DURATION__", dur);
-    writeFileSync9(file, content, "utf-8");
+    writeFileSync10(file, content, "utf-8");
   }
 }
-function patchTranscript(dir, transcriptPath) {
-  const raw = JSON.parse(readFileSync19(transcriptPath, "utf-8"));
-  const words = [];
-  for (const seg of raw.transcription ?? []) {
-    for (const token of seg.tokens ?? []) {
-      const text = (token.text ?? "").trim();
-      if (!text || text.startsWith("[_") || text.startsWith("[BLANK")) continue;
-      const isPunctuation = /^[.,!?;:'")\]}>…–—-]+$/.test(text);
-      const lastWord = words[words.length - 1];
-      if (isPunctuation && lastWord) {
-        lastWord.text += text;
-        lastWord.end = Math.round((token.offsets?.to ?? 0) / 1e3 * 1e3) / 1e3;
-        continue;
-      }
-      words.push({
-        text,
-        start: Math.round((token.offsets?.from ?? 0) / 1e3 * 1e3) / 1e3,
-        end: Math.round((token.offsets?.to ?? 0) / 1e3 * 1e3) / 1e3
-      });
-    }
-  }
+async function patchTranscript(dir, transcriptPath) {
+  const { loadTranscript: loadTranscript2, patchCaptionHtml: patchCaptionHtml2 } = await Promise.resolve().then(() => (init_normalize(), normalize_exports));
+  const { words } = loadTranscript2(transcriptPath);
   if (words.length === 0) return;
-  const wordsJson = JSON.stringify(words, null, 10).replace(/^\[/, "[").replace(/\n {10}/g, "\n          ");
-  const htmlFiles = readdirSync9(dir, { withFileTypes: true, recursive: true }).filter((e) => e.isFile() && e.name.endsWith(".html")).map((e) => join30(e.parentPath ?? e.path, e.name));
-  for (const file of htmlFiles) {
-    let content = readFileSync19(file, "utf-8");
-    const scriptBlocks = content.match(/<script>[\s\S]*?<\/script>/g) ?? [];
-    let scriptMatch = null;
-    let transcriptMatch = null;
-    for (const block of scriptBlocks) {
-      scriptMatch = scriptMatch ?? block.match(/const script = \[[\s\S]*?\];/);
-      transcriptMatch = transcriptMatch ?? block.match(/const TRANSCRIPT = \[[\s\S]*?\];/);
-    }
-    const match = scriptMatch ?? transcriptMatch;
-    if (match) {
-      const varName = scriptMatch ? "script" : "TRANSCRIPT";
-      content = content.replace(match[0], `const ${varName} = ${wordsJson};`);
-      writeFileSync9(file, content, "utf-8");
-    }
-  }
+  patchCaptionHtml2(dir, words);
 }
 async function handleVideoFile(videoPath, destDir, interactive) {
   const probed = probeVideo(videoPath);
@@ -25766,7 +26132,7 @@ function scaffoldProject(destDir, name, templateId, localVideoName, durationSeco
   const templateDir = getStaticTemplateDir(templateId);
   cpSync2(templateDir, destDir, { recursive: true });
   patchVideoSrc(destDir, localVideoName, durationSeconds);
-  writeFileSync9(
+  writeFileSync10(
     resolve18(destDir, "meta.json"),
     JSON.stringify(
       {
@@ -25781,8 +26147,8 @@ function scaffoldProject(destDir, name, templateId, localVideoName, durationSeco
   );
   const sharedDir = getSharedTemplateDir();
   if (existsSync33(sharedDir)) {
-    for (const entry of readdirSync9(sharedDir, { withFileTypes: true })) {
-      const src = join30(sharedDir, entry.name);
+    for (const entry of readdirSync10(sharedDir, { withFileTypes: true })) {
+      const src = join31(sharedDir, entry.name);
       const dest = resolve18(destDir, entry.name);
       if (entry.isFile() || entry.isSymbolicLink()) {
         copyFileSync3(src, dest);
@@ -25793,7 +26159,7 @@ function scaffoldProject(destDir, name, templateId, localVideoName, durationSeco
   if (existsSync33(skillsSrcDir)) {
     const projectSkills = ["hyperframes-compose", "hyperframes-captions"];
     for (const skill of projectSkills) {
-      const src = join30(skillsSrcDir, skill);
+      const src = join31(skillsSrcDir, skill);
       if (existsSync33(src)) {
         const dest = resolve18(destDir, ".claude", "skills", skill);
         mkdirSync20(dest, { recursive: true });
@@ -25890,6 +26256,14 @@ Examples:
           type: "boolean",
           description: "Skip whisper transcription"
         },
+        model: {
+          type: "string",
+          description: "Whisper model for transcription (e.g. tiny.en, base.en, small.en, medium.en, large)"
+        },
+        language: {
+          type: "string",
+          description: "Language code for transcription (e.g. en, es, ja). Filters out non-target speech."
+        },
         "non-interactive": {
           type: "boolean",
           description: "Disable interactive prompts (for CI/agents)"
@@ -25902,6 +26276,8 @@ Examples:
         const skipSkills = args["skip-skills"] === true;
         const skipTranscribe = args["skip-transcribe"] === true;
         const nonInteractive = args["non-interactive"] === true;
+        const modelFlag = args.model;
+        const languageFlag = args.language;
         const interactive = !nonInteractive && process.stdout.isTTY === true;
         if (!interactive) {
           const resolvedTemplate = templateFlag ?? "blank";
@@ -25913,7 +26289,7 @@ Examples:
           const templateId2 = resolvedTemplate;
           const name2 = args.name ?? "my-video";
           const destDir2 = resolve18(name2);
-          if (existsSync33(destDir2) && readdirSync9(destDir2).length > 0) {
+          if (existsSync33(destDir2) && readdirSync10(destDir2).length > 0) {
             console.error(c.error(`Directory already exists and is not empty: ${name2}`));
             process.exit(1);
           }
@@ -25949,10 +26325,13 @@ Examples:
             try {
               const { ensureWhisper: ensureWhisper2, ensureModel: ensureModel2 } = await Promise.resolve().then(() => (init_manager(), manager_exports));
               await ensureWhisper2();
-              await ensureModel2();
+              await ensureModel2(modelFlag);
               console.log("Transcribing...");
               const { transcribe: runTranscribe } = await Promise.resolve().then(() => (init_transcribe(), transcribe_exports));
-              const result = await runTranscribe(sourceFilePath2, destDir2);
+              const result = await runTranscribe(sourceFilePath2, destDir2, {
+                model: modelFlag,
+                language: languageFlag
+              });
               console.log(
                 `Transcribed: ${result.wordCount} words (${result.durationSeconds.toFixed(1)}s)`
               );
@@ -25965,13 +26344,13 @@ Examples:
           trackInitTemplate(templateId2);
           const transcriptFile2 = resolve18(destDir2, "transcript.json");
           if (existsSync33(transcriptFile2)) {
-            patchTranscript(destDir2, transcriptFile2);
+            await patchTranscript(destDir2, transcriptFile2);
           }
           if (!skipSkills) {
             await installSkills(false);
           }
           console.log(c.success(`Created ${c.accent(name2 + "/")}`));
-          for (const f of readdirSync9(destDir2).filter((f2) => !f2.startsWith("."))) {
+          for (const f of readdirSync10(destDir2).filter((f2) => !f2.startsWith("."))) {
             console.log(`  ${c.accent(f)}`);
           }
           console.log();
@@ -26012,7 +26391,7 @@ Examples:
           name = nameResult;
         }
         const destDir = resolve18(name);
-        if (existsSync33(destDir) && readdirSync9(destDir).length > 0) {
+        if (existsSync33(destDir) && readdirSync10(destDir).length > 0) {
           const overwrite = await Rt({
             message: `Directory ${c.accent(name)} already exists and is not empty. Overwrite?`,
             initialValue: false
@@ -26105,12 +26484,14 @@ Examples:
               await ensureWhisper2({
                 onProgress: (msg) => spin.message(msg)
               });
-              await ensureModel2(void 0, {
+              await ensureModel2(modelFlag, {
                 onProgress: (msg) => spin.message(msg)
               });
               spin.message("Transcribing audio...");
               const { transcribe: runTranscribe } = await Promise.resolve().then(() => (init_transcribe(), transcribe_exports));
               const transcribeResult = await runTranscribe(sourceFilePath, destDir, {
+                model: modelFlag,
+                language: languageFlag,
                 onProgress: (msg) => spin.message(msg)
               });
               spin.stop(
@@ -26155,7 +26536,7 @@ Examples:
         if (!skipSkills) {
           await installSkills(true);
         }
-        const files = readdirSync9(destDir);
+        const files = readdirSync10(destDir);
         Vt2(files.map((f) => c.accent(f)).join("\n"), c.success(`Created ${name}/`));
         R2.message(
           `${c.dim("Tip:")} Open this project with ${c.accent("Claude Code")}, ${c.accent("Cursor")}, or your preferred AI agent.
@@ -26178,40 +26559,87 @@ var init_lint3 = __esm({
     "use strict";
     init_dist();
     init_colors();
-    init_project();
-    init_lintProject();
     init_lintFormat();
+    init_lintProject();
+    init_project();
     init_updateCheck();
     lint_default = defineCommand({
-      meta: { name: "lint", description: "Validate a composition for common mistakes" },
+      meta: {
+        name: "lint",
+        description: "Validate a composition for common mistakes"
+      },
       args: {
-        dir: { type: "positional", description: "Project directory", required: false },
-        json: { type: "boolean", description: "Output findings as JSON", default: false }
+        dir: {
+          type: "positional",
+          description: "Project directory",
+          required: false
+        },
+        json: {
+          type: "boolean",
+          description: "Output findings as JSON",
+          default: false
+        },
+        verbose: {
+          type: "boolean",
+          description: "Show info-level findings (hidden by default)",
+          default: false
+        }
       },
       async run({ args }) {
-        const project = resolveProject(args.dir);
-        const lintResult = lintProject(project);
-        if (args.json) {
-          const combined = {
-            ok: lintResult.totalErrors === 0,
-            errorCount: lintResult.totalErrors,
-            warningCount: lintResult.totalWarnings,
-            findings: lintResult.results.flatMap((r) => r.result.findings)
-          };
-          console.log(JSON.stringify(withMeta(combined), null, 2));
-          process.exit(combined.ok ? 0 : 1);
-        }
-        const fileCount = lintResult.results.length;
-        const fileLabel = fileCount === 1 ? lintResult.results[0].file : `${fileCount} files`;
-        console.log(`${c.accent("\u25C6")}  Linting ${c.accent(project.name + "/" + fileLabel)}`);
-        console.log();
-        if (lintResult.totalErrors === 0 && lintResult.totalWarnings === 0) {
-          console.log(`${c.success("\u25C7")}  ${c.success("0 errors, 0 warnings")}`);
-          return;
+        try {
+          const project = resolveProject(args.dir);
+          const lintResult = lintProject(project);
+          if (args.json) {
+            const allFindings = lintResult.results.flatMap((r) => r.result.findings);
+            const combined = {
+              ok: lintResult.totalErrors === 0,
+              errorCount: lintResult.totalErrors,
+              warningCount: lintResult.totalWarnings,
+              infoCount: lintResult.totalInfos,
+              findings: args.verbose ? allFindings : allFindings.filter((f) => f.severity !== "info"),
+              filesScanned: lintResult.results.length
+            };
+            console.log(JSON.stringify(withMeta(combined), null, 2));
+            process.exit(combined.ok ? 0 : 1);
+          }
+          const fileCount = lintResult.results.length;
+          const fileLabel = fileCount === 1 ? lintResult.results[0]?.file ?? "index.html" : `${fileCount} files`;
+          console.log(`${c.accent("\u25C6")}  Linting ${c.accent(`${project.name}/${fileLabel}`)}`);
+          console.log();
+          if (lintResult.totalErrors === 0 && lintResult.totalWarnings === 0) {
+            console.log(`${c.success("\u25C7")}  ${c.success("0 errors, 0 warnings")}`);
+            return;
+          }
+          const lines = formatLintFindings(lintResult, {
+            showElementId: true,
+            showSummary: true,
+            verbose: args.verbose
+          });
+          for (const line of lines) console.log(line);
+          process.exit(lintResult.totalErrors > 0 ? 1 : 0);
+        } catch (err) {
+          const message = err instanceof Error ? err.message : String(err);
+          if (args.json) {
+            console.log(
+              JSON.stringify(
+                withMeta({
+                  ok: false,
+                  error: message,
+                  findings: [],
+                  errorCount: 0,
+                  warningCount: 0,
+                  infoCount: 0,
+                  filesScanned: 0
+                }),
+                null,
+                2
+              )
+            );
+            process.exit(1);
+          }
+          console.error(message);
+          process.exit(1);
         }
-        const lines = formatLintFindings(lintResult, { showElementId: true, showSummary: true });
-        for (const line of lines) console.log(line);
-        process.exit(lintResult.totalErrors > 0 ? 1 : 0);
       }
     });
   }
@@ -26235,12 +26663,12 @@ var info_exports = {};
 __export(info_exports, {
   default: () => info_default
 });
-import { readFileSync as readFileSync20, readdirSync as readdirSync10, statSync as statSync12 } from "fs";
-import { join as join31 } from "path";
+import { readFileSync as readFileSync21, readdirSync as readdirSync11, statSync as statSync12 } from "fs";
+import { join as join32 } from "path";
 function totalSize(dir) {
   let total = 0;
-  for (const entry of readdirSync10(dir, { withFileTypes: true })) {
-    const path = join31(dir, entry.name);
+  for (const entry of readdirSync11(dir, { withFileTypes: true })) {
+    const path = join32(dir, entry.name);
     if (entry.isDirectory()) {
       total += totalSize(path);
     } else {
@@ -26268,7 +26696,7 @@ var init_info = __esm({
       },
       async run({ args }) {
         const project = resolveProject(args.dir);
-        const html = readFileSync20(project.indexPath, "utf-8");
+        const html = readFileSync21(project.indexPath, "utf-8");
         ensureDOMParser();
         const parsed = parseHtml(html);
         const tracks = new Set(parsed.elements.map((el) => el.zIndex));
@@ -26319,7 +26747,7 @@ var compositions_exports = {};
 __export(compositions_exports, {
   default: () => compositions_default
 });
-import { readFileSync as readFileSync21 } from "fs";
+import { readFileSync as readFileSync22 } from "fs";
 function parseCompositions(html) {
   const parser = new DOMParser();
   const doc = parser.parseFromString(html, "text/html");
@@ -26376,7 +26804,7 @@ var init_compositions = __esm({
       },
       async run({ args }) {
         const project = resolveProject(args.dir);
-        const html = readFileSync21(project.indexPath, "utf-8");
+        const html = readFileSync22(project.indexPath, "utf-8");
         ensureDOMParser();
         const compositions = parseCompositions(html);
         if (compositions.length === 0) {
@@ -26413,7 +26841,7 @@ __export(benchmark_exports, {
   default: () => benchmark_default
 });
 import { existsSync as existsSync34, statSync as statSync13 } from "fs";
-import { resolve as resolve19, join as join32 } from "path";
+import { resolve as resolve19, join as join33 } from "path";
 var DEFAULT_CONFIGS, benchmark_default;
 var init_benchmark = __esm({
   "src/commands/benchmark.ts"() {
@@ -26483,7 +26911,7 @@ var init_benchmark = __esm({
           s?.start(`Benchmarking ${config.label}...`);
           for (let i = 0; i < runsPerConfig; i++) {
             s?.message(`${config.label} \u2014 run ${i + 1}/${runsPerConfig}`);
-            const outputPath = join32(
+            const outputPath = join33(
               benchDir,
               `${config.label.replace(/[^a-zA-Z0-9]/g, "_")}_run${i}.mp4`
             );
@@ -26701,20 +27129,151 @@ Run ${c.accent("hyperframes browser --help")} for usage.`
   }
 });
 
+// src/commands/transcribe.ts
+var transcribe_exports2 = {};
+__export(transcribe_exports2, {
+  default: () => transcribe_default
+});
+import { existsSync as existsSync35, writeFileSync as writeFileSync11 } from "fs";
+import { resolve as resolve20, join as join34, extname as extname6 } from "path";
+async function importTranscript(inputPath, dir, json) {
+  const { loadTranscript: loadTranscript2, patchCaptionHtml: patchCaptionHtml2 } = await Promise.resolve().then(() => (init_normalize(), normalize_exports));
+  const { words, format } = loadTranscript2(inputPath);
+  if (words.length === 0) {
+    console.error(c.error("No words found in transcript."));
+    process.exit(1);
+  }
+  const outPath = join34(dir, "transcript.json");
+  writeFileSync11(outPath, JSON.stringify(words, null, 2));
+  patchCaptionHtml2(dir, words);
+  if (json) {
+    console.log(
+      JSON.stringify({ ok: true, format, wordCount: words.length, transcriptPath: outPath })
+    );
+  } else {
+    console.log(
+      `${c.success("\u25C7")}  Imported ${c.accent(String(words.length))} words from ${c.accent(format)} format \u2192 ${c.accent("transcript.json")}`
+    );
+  }
+}
+async function transcribeAudio(inputPath, dir, opts) {
+  const { transcribe: transcribe2 } = await Promise.resolve().then(() => (init_transcribe(), transcribe_exports));
+  const { loadTranscript: loadTranscript2, patchCaptionHtml: patchCaptionHtml2 } = await Promise.resolve().then(() => (init_normalize(), normalize_exports));
+  const model = opts.model ?? DEFAULT_MODEL;
+  const spin = opts.json ? null : be();
+  spin?.start(`Transcribing with ${c.accent(model)}...`);
+  try {
+    const result = await transcribe2(inputPath, dir, {
+      model,
+      language: opts.language,
+      onProgress: spin ? (msg) => spin.message(msg) : void 0
+    });
+    const { words } = loadTranscript2(result.transcriptPath);
+    writeFileSync11(result.transcriptPath, JSON.stringify(words, null, 2));
+    patchCaptionHtml2(dir, words);
+    if (opts.json) {
+      console.log(
+        JSON.stringify({
+          ok: true,
+          model,
+          wordCount: words.length,
+          durationSeconds: result.durationSeconds,
+          transcriptPath: result.transcriptPath
+        })
+      );
+    } else {
+      spin.stop(
+        c.success(
+          `Transcribed ${c.accent(String(words.length))} words (${result.durationSeconds.toFixed(1)}s)`
+        )
+      );
+    }
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    if (opts.json) {
+      console.log(JSON.stringify({ ok: false, error: message }));
+    } else {
+      spin.stop(c.error(`Transcription failed: ${message}`));
+    }
+    process.exit(1);
+  }
+}
+var transcribe_default;
+var init_transcribe2 = __esm({
+  "src/commands/transcribe.ts"() {
+    "use strict";
+    init_dist();
+    init_dist3();
+    init_colors();
+    init_manager();
+    transcribe_default = defineCommand({
+      meta: {
+        name: "transcribe",
+        description: "Transcribe audio/video to word-level timestamps, or import an existing transcript"
+      },
+      args: {
+        input: {
+          type: "positional",
+          description: "Audio/video file to transcribe, or transcript file to import (.json, .srt, .vtt)",
+          required: true
+        },
+        dir: {
+          type: "string",
+          description: "Project directory (default: current directory)",
+          alias: "d"
+        },
+        model: {
+          type: "string",
+          description: `Whisper model (default: ${DEFAULT_MODEL}). Options: tiny.en, base.en, small.en, medium.en, large-v3`,
+          alias: "m"
+        },
+        language: {
+          type: "string",
+          description: "Language code (e.g. en, es, ja). Filters out non-target language speech.",
+          alias: "l"
+        },
+        json: {
+          type: "boolean",
+          description: "Output result as JSON",
+          default: false
+        }
+      },
+      async run({ args }) {
+        const inputPath = resolve20(args.input);
+        if (!existsSync35(inputPath)) {
+          console.error(c.error(`File not found: ${args.input}`));
+          process.exit(1);
+        }
+        const dir = resolve20(args.dir ?? ".");
+        const ext = extname6(inputPath).toLowerCase();
+        const isImport = ext === ".json" || ext === ".srt" || ext === ".vtt";
+        if (isImport) {
+          return importTranscript(inputPath, dir, args.json);
+        }
+        return transcribeAudio(inputPath, dir, {
+          model: args.model,
+          language: args.language,
+          json: args.json
+        });
+      }
+    });
+  }
+});
+
 // src/commands/docs.ts
 var docs_exports = {};
 __export(docs_exports, {
   default: () => docs_default
 });
-import { readFileSync as readFileSync22, existsSync as existsSync35 } from "fs";
-import { resolve as resolve20, dirname as dirname14, join as join33 } from "path";
+import { readFileSync as readFileSync23, existsSync as existsSync36 } from "fs";
+import { resolve as resolve21, dirname as dirname14, join as join35 } from "path";
 import { fileURLToPath as fileURLToPath6 } from "url";
 function docsDir() {
   const thisFile = fileURLToPath6(import.meta.url);
   const dir = dirname14(thisFile);
-  const devPath = resolve20(dir, "..", "docs");
-  const builtPath = resolve20(dir, "docs");
-  return existsSync35(devPath) ? devPath : builtPath;
+  const devPath = resolve21(dir, "..", "docs");
+  const builtPath = resolve21(dir, "docs");
+  return existsSync36(devPath) ? devPath : builtPath;
 }
 function formatInlineCode(line) {
   return line.replace(/`([^`]+)`/g, (_match, code) => c.accent(code));
@@ -26805,12 +27364,12 @@ var init_docs = __esm({
           }
           process.exit(1);
         }
-        const filePath = join33(docsDir(), entry.file);
-        if (!existsSync35(filePath)) {
+        const filePath = join35(docsDir(), entry.file);
+        if (!existsSync36(filePath)) {
           console.error(c.error(`Doc file not found: ${filePath}`));
           process.exit(1);
         }
-        const content = readFileSync22(filePath, "utf-8");
+        const content = readFileSync23(filePath, "utf-8");
         console.log();
         renderMarkdown(content);
       }
@@ -27211,6 +27770,7 @@ var subCommands = {
   benchmark: () => Promise.resolve().then(() => (init_benchmark(), benchmark_exports)).then((m) => m.default),
   browser: () => Promise.resolve().then(() => (init_browser(), browser_exports)).then((m) => m.default),
   skills: () => Promise.resolve().then(() => (init_install_skills(), install_skills_exports)).then((m) => m.default),
+  transcribe: () => Promise.resolve().then(() => (init_transcribe2(), transcribe_exports2)).then((m) => m.default),
   docs: () => Promise.resolve().then(() => (init_docs(), docs_exports)).then((m) => m.default),
   doctor: () => Promise.resolve().then(() => (init_doctor(), doctor_exports)).then((m) => m.default),
   upgrade: () => Promise.resolve().then(() => (init_upgrade(), upgrade_exports)).then((m) => m.default),