hyperframes 0.6.36 → 0.6.38

package/dist/cli.js

@@ -54,7 +54,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.6.36" : "0.0.0-dev";
+    VERSION = true ? "0.6.38" : "0.0.0-dev";
   }
 });
 
@@ -11365,9 +11365,173 @@ var init_env = __esm({
   }
 });
 
+// src/telemetry/platform.ts
+import { platform, release } from "os";
+import { readFileSync as readFileSync4 } from "fs";
+function detectWSL() {
+  if (platform() !== "linux") return false;
+  try {
+    const osRelease = release().toLowerCase();
+    if (osRelease.includes("microsoft") || osRelease.includes("wsl")) return true;
+    const procVersion = readFileSync4("/proc/version", "utf-8").toLowerCase();
+    return procVersion.includes("microsoft") || procVersion.includes("wsl");
+  } catch {
+    return false;
+  }
+}
+var init_platform = __esm({
+  "src/telemetry/platform.ts"() {
+    "use strict";
+  }
+});
+
+// src/telemetry/agent_runtime.ts
+import { existsSync as existsSync4, readFileSync as readFileSync5 } from "fs";
+import { platform as platform2, release as release2 } from "os";
+function detectSandboxRuntime() {
+  if (platform2() === "win32") return null;
+  if (detectWSL()) return "wsl";
+  if (isGVisor()) return "gvisor";
+  if (isDocker()) return "docker";
+  if (isFirecracker()) return "firecracker";
+  if (isKVM()) return "kvm";
+  return null;
+}
+function detectAgentRuntime() {
+  for (const rule of VENDOR_RULES) {
+    if (rule.check(process.env)) return rule.name;
+  }
+  return null;
+}
+function isGVisor() {
+  const kernel = release2();
+  if (kernel.includes("gvisor")) return true;
+  if (platform2() !== "linux") return false;
+  try {
+    const procVersion = readFileSync5("/proc/version", "utf-8");
+    return procVersion.includes("gVisor");
+  } catch {
+    return false;
+  }
+}
+function isDocker() {
+  if (existsSync4("/.dockerenv")) return true;
+  if (platform2() !== "linux") return false;
+  try {
+    const cgroup = readFileSync5("/proc/1/cgroup", "utf-8");
+    return cgroup.includes("docker") || cgroup.includes("containerd");
+  } catch {
+    return false;
+  }
+}
+function isFirecracker() {
+  if (platform2() !== "linux") return false;
+  if (!existsSync4("/dev/vsock")) return false;
+  try {
+    const sysVendor = readFileSync5("/sys/class/dmi/id/sys_vendor", "utf-8").trim();
+    if (sysVendor !== "Amazon EC2") return false;
+    const productName = readFileSync5("/sys/class/dmi/id/product_name", "utf-8").trim();
+    return productName.toLowerCase().includes("firecracker");
+  } catch {
+    return false;
+  }
+}
+function isKVM() {
+  if (platform2() !== "linux") return false;
+  try {
+    const sysVendor = readFileSync5("/sys/class/dmi/id/sys_vendor", "utf-8").trim();
+    return sysVendor === "QEMU" || sysVendor.includes("KVM");
+  } catch {
+    return false;
+  }
+}
+var VENDOR_RULES;
+var init_agent_runtime = __esm({
+  "src/telemetry/agent_runtime.ts"() {
+    "use strict";
+    init_platform();
+    VENDOR_RULES = [
+      // Anthropic Claude Code — sets CLAUDECODE=1 on every Bash/PowerShell tool
+      // spawn (Shell.ts:321) and CLAUDE_CODE_ENTRYPOINT at startup, inherited by
+      // every child (main.tsx:527). Both propagate to spawned subprocesses.
+      // Source: confirmed by @magi from Claude Code internal source.
+      {
+        name: "claude_code",
+        check: (env) => typeof env["CLAUDECODE"] === "string" || typeof env["CLAUDE_CODE_ENTRYPOINT"] === "string"
+      },
+      // OpenAI Codex (https://github.com/openai/codex).
+      // - CODEX_THREAD_ID — set unconditionally on every spawned shell command
+      //   (codex-rs/protocol/src/shell_environment.rs:6 constant, set by
+      //   codex-rs/core/src/unified_exec/process_manager.rs:1010 and
+      //   codex-rs/core/src/tools/runtimes/mod.rs:164).
+      // - CODEX_CI — hardcoded in the UNIFIED_EXEC_ENV array, always set on
+      //   every unified-exec child (process_manager.rs:70).
+      // - CODEX_SANDBOX_NETWORK_DISABLED — set when network sandbox is active
+      //   (codex-rs/core/src/sandboxing/mod.rs:135-138, default-on).
+      // CODEX_HOME is deliberately NOT used — it's a config override read at
+      // Codex startup, not propagated to spawned subprocesses.
+      {
+        name: "codex",
+        check: (env) => typeof env["CODEX_THREAD_ID"] === "string" || typeof env["CODEX_CI"] === "string" || typeof env["CODEX_SANDBOX_NETWORK_DISABLED"] === "string"
+      },
+      // Cursor IDE integrated terminal — exports TERM_PROGRAM=cursor.
+      // Cursor Background Agent env vars are not publicly documented; if a
+      // canonical marker is identified later, add it here.
+      {
+        name: "cursor",
+        check: (env) => env["TERM_PROGRAM"] === "cursor"
+      },
+      // GitHub Copilot Coding Agent — runs inside GitHub Actions and the
+      // workflow injects an additional marker to distinguish from generic CI.
+      // Not yet verified from a public-source citation in this audit; the var
+      // names below match GitHub Copilot Coding Agent documentation but
+      // should be confirmed before relying on attribution.
+      {
+        name: "copilot_agent",
+        check: (env) => env["GITHUB_ACTIONS"] === "true" && (typeof env["COPILOT_AGENT_ID"] === "string" || env["RUNNER_NAME"] === "Copilot")
+      },
+      // Replit — REPL_ID and REPLIT_USER are long-documented environment
+      // variables exposed inside every Replit workspace.
+      // Source: https://docs.replit.com/replit-workspace/configuring-the-environment
+      {
+        name: "replit",
+        check: (env) => typeof env["REPL_ID"] === "string" || typeof env["REPLIT_USER"] === "string"
+      },
+      // Nous Research Hermes Agent — cli.py:50 unconditionally executes
+      //   os.environ["HERMES_QUIET"] = "1"
+      // at module load, so the marker propagates via os.environ to every
+      // subprocess spawned by Hermes. Keying on existence (not the literal
+      // "1") so we still match if Hermes ever changes the value.
+      // Source: https://github.com/NousResearch/hermes-agent (cli.py:50)
+      {
+        name: "hermes",
+        check: (env) => typeof env["HERMES_QUIET"] === "string"
+      },
+      // openclaw — multi-channel AI gateway. When openclaw spawns a CLI
+      // subprocess it builds the child env with OPENCLAW_STATE_DIR /
+      // OPENCLAW_CONFIG_PATH / OPENCLAW_DISABLE_AUTO_UPDATE set explicitly
+      // (extensions/qa-matrix/src/runners/contract/scenario-runtime-cli.ts:344-351).
+      // We key on OPENCLAW_STATE_DIR since it's a path scope-bound to openclaw.
+      // Source: https://github.com/openclaw/openclaw
+      {
+        name: "openclaw",
+        check: (env) => typeof env["OPENCLAW_STATE_DIR"] === "string" || typeof env["OPENCLAW_CONFIG_PATH"] === "string"
+      },
+      // Pi coding agent (https://pi.dev, https://github.com/earendil-works/pi).
+      // packages/coding-agent/src/cli.ts:13 unconditionally executes
+      //   process.env.PI_CODING_AGENT = "true";
+      // at module entry, so every subprocess Pi spawns sees this marker.
+      {
+        name: "pi",
+        check: (env) => typeof env["PI_CODING_AGENT"] === "string"
+      }
+    ];
+  }
+});
+
 // src/telemetry/system.ts
-import { cpus, totalmem, platform, release } from "os";
-import { existsSync as existsSync4, readFileSync as readFileSync4, statfsSync } from "fs";
+import { cpus, totalmem, platform as platform3, release as release3 } from "os";
+import { existsSync as existsSync5, readFileSync as readFileSync6, statfsSync } from "fs";
 function bytesToMb(bytes) {
   return Math.trunc(bytes / (1024 * 1024));
 }
@@ -11376,7 +11540,7 @@ function getSystemMeta() {
   const cpuInfo = cpus();
   const firstCpu = cpuInfo[0] ?? null;
   cached = {
-    os_release: release(),
+    os_release: release3(),
     cpu_count: cpuInfo.length,
     cpu_model: firstCpu?.model?.trim() ?? null,
     cpu_speed: firstCpu?.speed ?? null,
@@ -11385,47 +11549,39 @@ function getSystemMeta() {
     is_ci: detectCI(),
     ci_name: getCIName(),
     is_wsl: detectWSL(),
-    is_tty: Boolean(process.stdout?.isTTY)
+    is_tty: Boolean(process.stdout?.isTTY),
+    sandbox_runtime: detectSandboxRuntime(),
+    agent_runtime: detectAgentRuntime()
   };
   return cached;
 }
 function detectDocker() {
   try {
-    if (existsSync4("/.dockerenv")) return true;
-    if (platform() === "linux") {
-      const cgroup = readFileSync4("/proc/1/cgroup", "utf-8");
+    if (existsSync5("/.dockerenv")) return true;
+    if (platform3() === "linux") {
+      const cgroup = readFileSync6("/proc/1/cgroup", "utf-8");
       if (cgroup.includes("docker") || cgroup.includes("containerd")) return true;
     }
   } catch {
   }
   return false;
 }
+function matchesProvider(p2) {
+  const v2 = process.env[p2.envVar];
+  if (p2.mode === "presence") return v2 != null;
+  return v2 === "true" || v2 === "1";
+}
 function detectCI() {
-  return process.env["CI"] === "true" || process.env["CI"] === "1" || process.env["CONTINUOUS_INTEGRATION"] === "true" || process.env["GITHUB_ACTIONS"] === "true" || process.env["GITLAB_CI"] === "true" || process.env["CIRCLECI"] === "true" || process.env["JENKINS_URL"] != null || process.env["BUILDKITE"] === "true" || process.env["TRAVIS"] === "true" || false;
+  return CI_PROVIDERS.some(matchesProvider);
 }
 function getCIName() {
-  if (process.env["GITHUB_ACTIONS"] === "true") return "github_actions";
-  if (process.env["GITLAB_CI"] === "true") return "gitlab_ci";
-  if (process.env["CIRCLECI"] === "true") return "circleci";
-  if (process.env["JENKINS_URL"] != null) return "jenkins";
-  if (process.env["BUILDKITE"] === "true") return "buildkite";
-  if (process.env["TRAVIS"] === "true") return "travis";
-  if (detectCI()) return "unknown";
-  return null;
-}
-function detectWSL() {
-  if (platform() !== "linux") return false;
-  try {
-    const osRelease = release().toLowerCase();
-    if (osRelease.includes("microsoft") || osRelease.includes("wsl")) return true;
-    const procVersion = readFileSync4("/proc/version", "utf-8").toLowerCase();
-    return procVersion.includes("microsoft") || procVersion.includes("wsl");
-  } catch {
-    return false;
+  for (const provider of CI_PROVIDERS) {
+    if (provider.name && matchesProvider(provider)) return provider.name;
   }
+  return detectCI() ? "unknown" : null;
 }
 function getShmSizeMb() {
-  if (platform() !== "linux") return null;
+  if (platform3() !== "linux") return null;
   try {
     const stats = statfsSync("/dev/shm");
     return bytesToMb(stats.bsize * stats.blocks);
@@ -11441,11 +11597,23 @@ function getFreeDiskMb(path2 = ".") {
     return null;
   }
 }
-var cached;
+var cached, CI_PROVIDERS;
 var init_system = __esm({
   "src/telemetry/system.ts"() {
     "use strict";
+    init_agent_runtime();
+    init_platform();
     cached = null;
+    CI_PROVIDERS = [
+      { name: "github_actions", envVar: "GITHUB_ACTIONS", mode: "truthy" },
+      { name: "gitlab_ci", envVar: "GITLAB_CI", mode: "truthy" },
+      { name: "circleci", envVar: "CIRCLECI", mode: "truthy" },
+      { name: "jenkins", envVar: "JENKINS_URL", mode: "presence" },
+      { name: "buildkite", envVar: "BUILDKITE", mode: "truthy" },
+      { name: "travis", envVar: "TRAVIS", mode: "truthy" },
+      { name: null, envVar: "CONTINUOUS_INTEGRATION", mode: "truthy" },
+      { name: null, envVar: "CI", mode: "truthy" }
+    ];
   }
 });
 
@@ -11488,32 +11656,35 @@ function trackEvent(event, properties = {}) {
       is_ci: sys.is_ci,
       ci_name: sys.ci_name ?? void 0,
       is_wsl: sys.is_wsl,
-      is_tty: sys.is_tty
+      is_tty: sys.is_tty,
+      sandbox_runtime: sys.sandbox_runtime ?? void 0,
+      agent_runtime: sys.agent_runtime ?? void 0
     },
     timestamp: (/* @__PURE__ */ new Date()).toISOString()
   });
 }
-async function flush() {
-  if (eventQueue.length === 0) {
-    return;
-  }
+function drainQueueToPayload() {
+  if (eventQueue.length === 0) return null;
   const config = readConfig();
   const batch = eventQueue.map((e3) => ({
     event: e3.event,
-    // $ip: null tells PostHog to not record the request IP for this event.
-    // Server-side "Discard client IP data" is also enabled in project settings.
     properties: { ...e3.properties, $ip: null },
     distinct_id: config.anonymousId,
     timestamp: e3.timestamp
   }));
   eventQueue = [];
+  return JSON.stringify({ api_key: POSTHOG_API_KEY, batch });
+}
+async function flush() {
+  const payload = drainQueueToPayload();
+  if (payload == null) return;
   const controller = new AbortController();
   const timeout = setTimeout(() => controller.abort(), FLUSH_TIMEOUT_MS);
   try {
     await fetch(`${POSTHOG_HOST}/batch/`, {
       method: "POST",
       headers: { "Content-Type": "application/json", Connection: "close" },
-      body: JSON.stringify({ api_key: POSTHOG_API_KEY, batch }),
+      body: payload,
       signal: controller.signal
     });
   } catch {
@@ -11522,18 +11693,8 @@ async function flush() {
   }
 }
 function flushSync() {
-  if (eventQueue.length === 0) {
-    return;
-  }
-  const config = readConfig();
-  const batch = eventQueue.map((e3) => ({
-    event: e3.event,
-    properties: { ...e3.properties, $ip: null },
-    distinct_id: config.anonymousId,
-    timestamp: e3.timestamp
-  }));
-  eventQueue = [];
-  const payload = JSON.stringify({ api_key: POSTHOG_API_KEY, batch });
+  const payload = drainQueueToPayload();
+  if (payload == null) return;
   try {
     const { spawn: spawn17 } = __require("child_process");
     const child = spawn17(
@@ -11708,8 +11869,8 @@ __export(manager_exports, {
   hasFFprobe: () => hasFFprobe
 });
 import { execFileSync } from "child_process";
-import { existsSync as existsSync5, mkdirSync as mkdirSync3, rmSync } from "fs";
-import { homedir as homedir3, platform as platform2 } from "os";
+import { existsSync as existsSync6, mkdirSync as mkdirSync3, rmSync } from "fs";
+import { homedir as homedir3, platform as platform4 } from "os";
 import { join as join5 } from "path";
 function getModelUrl(model) {
   return `https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-${model}.bin`;
@@ -11730,7 +11891,7 @@ function whichBinary(name) {
 }
 function findFromEnv() {
   const envPath = process.env["HYPERFRAMES_WHISPER_PATH"];
-  if (envPath && existsSync5(envPath)) {
+  if (envPath && existsSync6(envPath)) {
     return { executablePath: envPath, source: "env" };
   }
   return void 0;
@@ -11740,9 +11901,9 @@ function findFromSystem() {
     const path2 = whichBinary(name);
     if (path2) return { executablePath: path2, source: "system" };
   }
-  if (platform2() === "darwin") {
+  if (platform4() === "darwin") {
     for (const p2 of ["/opt/homebrew/bin/whisper-cli", "/usr/local/bin/whisper-cli"]) {
-      if (existsSync5(p2)) return { executablePath: p2, source: "system" };
+      if (existsSync6(p2)) return { executablePath: p2, source: "system" };
     }
   }
   return void 0;
@@ -11752,15 +11913,15 @@ function findBuiltBinary() {
     join5(BUILD_DIR, "build", "bin", "whisper-cli"),
     join5(BUILD_DIR, "build", "whisper-cli")
   ]) {
-    if (existsSync5(p2)) return { executablePath: p2, source: "build" };
+    if (existsSync6(p2)) return { executablePath: p2, source: "build" };
   }
   return void 0;
 }
 function buildFromSource(onProgress) {
-  if (existsSync5(BUILD_DIR) && !findBuiltBinary()) {
+  if (existsSync6(BUILD_DIR) && !findBuiltBinary()) {
     rmSync(BUILD_DIR, { recursive: true, force: true });
   }
-  if (!existsSync5(BUILD_DIR)) {
+  if (!existsSync6(BUILD_DIR)) {
     onProgress?.("Downloading whisper.cpp...");
     mkdirSync3(join5(homedir3(), ".cache", "hyperframes", "whisper"), {
       recursive: true
@@ -11803,7 +11964,7 @@ function findWhisper() {
   return findFromEnv() ?? findFromSystem() ?? findBuiltBinary();
 }
 function getInstallInstructions() {
-  if (platform2() === "darwin") {
+  if (platform4() === "darwin") {
     return "brew install whisper-cpp";
   }
   return "See https://github.com/ggml-org/whisper.cpp#building";
@@ -11820,7 +11981,7 @@ function hasCmake() {
 async function ensureWhisper(options) {
   const existing = findWhisper();
   if (existing) return existing;
-  if (platform2() === "darwin" && hasBrew()) {
+  if (platform4() === "darwin" && hasBrew()) {
     options?.onProgress?.("Installing whisper-cpp via Homebrew...");
     try {
       execFileSync("brew", ["install", "whisper-cpp"], {
@@ -11842,11 +12003,11 @@ async function ensureWhisper(options) {
 }
 async function ensureModel(model = DEFAULT_MODEL, options) {
   const modelPath2 = join5(MODELS_DIR, `ggml-${model}.bin`);
-  if (existsSync5(modelPath2)) return modelPath2;
+  if (existsSync6(modelPath2)) return modelPath2;
   mkdirSync3(MODELS_DIR, { recursive: true });
   options?.onProgress?.(`Downloading model ${model}...`);
   await downloadFile(getModelUrl(model), modelPath2);
-  if (!existsSync5(modelPath2)) {
+  if (!existsSync6(modelPath2)) {
     throw new Error(`Model download failed: ${model}`);
   }
   return modelPath2;
@@ -11885,13 +12046,13 @@ __export(normalize_exports, {
   patchCaptionHtml: () => patchCaptionHtml,
   stripBeforeOnset: () => stripBeforeOnset
 });
-import { readFileSync as readFileSync5, readdirSync, writeFileSync as writeFileSync4 } from "fs";
+import { readFileSync as readFileSync7, readdirSync, writeFileSync as writeFileSync4 } from "fs";
 import { extname, join as join6 } 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(readFileSync5(filePath, "utf-8")));
+  if (ext === ".json") return detectJsonFormat(JSON.parse(readFileSync7(filePath, "utf-8")));
   throw new Error(`Unsupported transcript file extension: ${ext}. Use .json, .srt, or .vtt`);
 }
 function detectJsonFormat(raw) {
@@ -12041,7 +12202,7 @@ function round3(n) {
 }
 function loadTranscript(filePath) {
   const ext = extname(filePath).toLowerCase();
-  const content = readFileSync5(filePath, "utf-8");
+  const content = readFileSync7(filePath, "utf-8");
   if (ext === ".srt") {
     const words2 = parseSrt(content).map((w3, i2) => ({ ...w3, id: w3.id ?? `w${i2}` }));
     return { words: words2, format: "srt" };
@@ -12073,7 +12234,7 @@ function patchCaptionHtml(dir, words) {
     return;
   }
   for (const file of htmlFiles) {
-    let content = readFileSync5(file, "utf-8");
+    let content = readFileSync7(file, "utf-8");
     const scriptBlocks = content.match(/<script>[\s\S]*?<\/script>/g) ?? [];
     let scriptMatch = null;
     let transcriptMatch = null;
@@ -12106,7 +12267,7 @@ __export(projectConfig_exports, {
   readProjectConfig: () => readProjectConfig,
   writeProjectConfig: () => writeProjectConfig
 });
-import { readFileSync as readFileSync6, writeFileSync as writeFileSync5 } from "fs";
+import { readFileSync as readFileSync8, writeFileSync as writeFileSync5 } from "fs";
 import { join as join7, resolve as resolve4 } from "path";
 function projectConfigPath(projectDir) {
   return join7(resolve4(projectDir), PROJECT_CONFIG_FILENAME);
@@ -12114,7 +12275,7 @@ function projectConfigPath(projectDir) {
 function readProjectConfig(projectDir) {
   const path2 = projectConfigPath(projectDir);
   try {
-    const parsed = JSON.parse(readFileSync6(path2, "utf-8"));
+    const parsed = JSON.parse(readFileSync8(path2, "utf-8"));
     return normalizeConfig(parsed);
   } catch {
     return void 0;
@@ -12164,7 +12325,7 @@ __export(transcribe_exports, {
   transcribe: () => transcribe
 });
 import { execFileSync as execFileSync2 } from "child_process";
-import { existsSync as existsSync6, readFileSync as readFileSync7, mkdirSync as mkdirSync4, unlinkSync as unlinkSync2 } from "fs";
+import { existsSync as existsSync7, readFileSync as readFileSync9, mkdirSync as mkdirSync4, unlinkSync as unlinkSync2 } from "fs";
 import { join as join8, extname as extname2 } from "path";
 import { tmpdir } from "os";
 function detectLanguage(whisperPath, modelPath2, wavPath) {
@@ -12200,7 +12361,7 @@ function detectSpeechOnset(wavPath) {
   const SILENCE_THRESHOLD_RATIO = 0.6;
   const MIN_INTRO_SECONDS = 3;
   try {
-    const buf = readFileSync7(wavPath);
+    const buf = readFileSync9(wavPath);
     const dataChunk = findWavDataChunk(buf);
     if (!dataChunk) return null;
     const pcm = new Int16Array(buf.buffer, buf.byteOffset + dataChunk.offset, dataChunk.size / 2);
@@ -12338,10 +12499,10 @@ async function transcribe(inputPath, outputDir, options) {
   whisperArgs.push(wavPath);
   execFileSync2(whisper.executablePath, whisperArgs, { stdio: "ignore", timeout: 3e5 });
   const transcriptPath = `${outputBase}.json`;
-  if (!existsSync6(transcriptPath)) {
+  if (!existsSync7(transcriptPath)) {
     throw new Error("Whisper did not produce output. Check the input file.");
   }
-  const transcript = JSON.parse(readFileSync7(transcriptPath, "utf-8"));
+  const transcript = JSON.parse(readFileSync9(transcriptPath, "utf-8"));
   const segments = transcript.transcription ?? [];
   let wordCount = 0;
   let maxEnd = 0;
@@ -12492,7 +12653,7 @@ var init_lint = __esm({
 });
 
 // src/utils/lintProject.ts
-import { existsSync as existsSync7, readFileSync as readFileSync8, readdirSync as readdirSync2 } from "fs";
+import { existsSync as existsSync8, readFileSync as readFileSync10, readdirSync as readdirSync2 } from "fs";
 import { dirname as dirname4, join as join9, resolve as resolve5, extname as extname3 } from "path";
 function readHtmlAttr(tag, name) {
   const escaped = name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -12514,8 +12675,8 @@ function collectExternalStyles(projectDir, html, compSrcPath) {
     if (!isLocalStylesheetHref(href)) continue;
     const rootRelative = compSrcPath ? join9(dirname4(compSrcPath), href) : href;
     const resolved = resolve5(projectDir, rootRelative);
-    if (!existsSync7(resolved)) continue;
-    styles.push({ href, content: readFileSync8(resolved, "utf-8") });
+    if (!existsSync8(resolved)) continue;
+    styles.push({ href, content: readFileSync10(resolved, "utf-8") });
   }
   return styles;
 }
@@ -12536,8 +12697,8 @@ function collectCssSources(projectDir, html, compSrcPath) {
     if (!isLocalStylesheetHref(href)) continue;
     const rootRelativePath = compSrcPath ? join9(dirname4(compSrcPath), href) : href;
     const resolved = resolve5(projectDir, rootRelativePath);
-    if (!existsSync7(resolved)) continue;
-    sources.push({ content: readFileSync8(resolved, "utf-8"), rootRelativePath });
+    if (!existsSync8(resolved)) continue;
+    sources.push({ content: readFileSync10(resolved, "utf-8"), rootRelativePath });
   }
   let tagMatch;
   const tagPattern = new RegExp(OPEN_TAG_RE.source, OPEN_TAG_RE.flags);
@@ -12566,7 +12727,7 @@ function lintProject(project) {
   let totalErrors = 0;
   let totalWarnings = 0;
   let totalInfos = 0;
-  const rootHtml = readFileSync8(project.indexPath, "utf-8");
+  const rootHtml = readFileSync10(project.indexPath, "utf-8");
   const rootResult = lintHyperframeHtml(rootHtml, {
     filePath: project.indexPath,
     externalStyles: collectExternalStyles(project.dir, rootHtml)
@@ -12577,11 +12738,11 @@ function lintProject(project) {
   totalInfos += rootResult.infoCount;
   const allHtmlSources = [{ html: rootHtml }];
   const compositionsDir = resolve5(project.dir, "compositions");
-  if (existsSync7(compositionsDir)) {
+  if (existsSync8(compositionsDir)) {
     const files = readdirSync2(compositionsDir).filter((f3) => f3.endsWith(".html"));
     for (const file of files) {
       const filePath = join9(compositionsDir, file);
-      const html = readFileSync8(filePath, "utf-8");
+      const html = readFileSync10(filePath, "utf-8");
       const compSrcPath = `compositions/${file}`;
       allHtmlSources.push({ html, compSrcPath });
       const result = lintHyperframeHtml(html, {
@@ -12654,7 +12815,7 @@ function lintAudioSrcNotFound(projectDir, htmlSources) {
       if (/^__[A-Z_]+__$/.test(src)) continue;
       const rootRelative = compSrcPath ? rewriteAssetPath(compSrcPath, src) : src;
       const resolved = resolve5(projectDir, rootRelative);
-      if (!existsSync7(resolved)) {
+      if (!existsSync8(resolved)) {
         missingSrcs.push(src);
       }
     }
@@ -12687,7 +12848,7 @@ function lintTextureMaskAssetNotFound(projectDir, htmlSources) {
           compSrcPath,
           cssSource.rootRelativePath
         );
-        if (existsSync7(resolved)) continue;
+        if (existsSync8(resolved)) continue;
         missing.set(url, resolved);
       }
     }
@@ -12709,7 +12870,7 @@ function lintMultipleRootCompositions(projectDir) {
     const rootHtmlFiles = readdirSync2(projectDir).filter((f3) => f3.endsWith(".html"));
     const rootCompositions = [];
     for (const file of rootHtmlFiles) {
-      const content = readFileSync8(join9(projectDir, file), "utf-8");
+      const content = readFileSync10(join9(projectDir, file), "utf-8");
       if (/data-composition-id/i.test(content)) {
         rootCompositions.push(file);
       }
@@ -13071,6 +13232,103 @@ var init_portUtils = __esm({
   }
 });
 
+// src/utils/orphanCleanup.ts
+import { execSync } from "child_process";
+function killOrphanedProcesses() {
+  if (process.platform === "win32") return 0;
+  let killed = 0;
+  for (const name of ["chrome-headless-shell", "chrome_headless_shell"]) {
+    killed += killOrphansByName(name);
+  }
+  killed += killOrphansByName("puppeteer_dev_chrome_profile");
+  return killed;
+}
+function killProcessTree(pid, signal = "SIGTERM") {
+  if (process.platform === "win32") return;
+  const descendants = getDescendants(pid);
+  const allPids = [...descendants.reverse(), pid];
+  for (const p2 of allPids) {
+    try {
+      process.kill(p2, signal);
+    } catch {
+    }
+  }
+  if (signal !== "SIGKILL") {
+    setTimeout(() => {
+      for (const p2 of allPids) {
+        try {
+          process.kill(p2, "SIGKILL");
+        } catch {
+        }
+      }
+    }, 500).unref();
+  }
+}
+function getDescendants(pid) {
+  let children;
+  try {
+    const raw = execSync(`pgrep -P ${pid}`, { encoding: "utf-8", timeout: 2e3 }).trim();
+    if (!raw) return [];
+    children = raw.split("\n").map((s2) => parseInt(s2, 10)).filter((n) => !isNaN(n) && n > 0);
+  } catch {
+    return [];
+  }
+  const all = [];
+  for (const child of children) {
+    all.push(child);
+    all.push(...getDescendants(child));
+  }
+  return all;
+}
+function killOrphansByName(processName) {
+  const uid = getUid();
+  const userFlag = uid !== null ? `-u ${uid} ` : "";
+  let pids;
+  try {
+    const raw = execSync(`pgrep ${userFlag}-f ${processName}`, {
+      encoding: "utf-8",
+      timeout: 3e3
+    }).trim();
+    if (!raw) return 0;
+    pids = raw.split("\n").map((s2) => parseInt(s2, 10)).filter((n) => !isNaN(n) && n > 0);
+  } catch {
+    return 0;
+  }
+  let killed = 0;
+  for (const pid of pids) {
+    if (!isOrphan(pid)) continue;
+    killProcessTree(pid);
+    killed++;
+  }
+  return killed;
+}
+function getUid() {
+  if (_cachedUid !== void 0) return _cachedUid;
+  try {
+    _cachedUid = execSync("id -u", { encoding: "utf-8", timeout: 1e3 }).trim();
+  } catch {
+    _cachedUid = null;
+  }
+  return _cachedUid;
+}
+function isOrphan(pid) {
+  try {
+    const ppid = execSync(`ps -p ${pid} -o ppid=`, {
+      encoding: "utf-8",
+      timeout: 2e3
+    }).trim();
+    return ppid === "1";
+  } catch {
+    return false;
+  }
+}
+var _cachedUid;
+var init_orphanCleanup = __esm({
+  "src/utils/orphanCleanup.ts"() {
+    "use strict";
+  }
+});
+
 // src/server/fileWatcher.ts
 import { watch } from "fs";
 function shouldWatchProjectFile(filename) {
@@ -13132,13 +13390,13 @@ var init_fileWatcher = __esm({
 });
 
 // src/server/runtimeSource.ts
-import { existsSync as existsSync8, readFileSync as readFileSync9 } from "fs";
+import { existsSync as existsSync9, readFileSync as readFileSync11 } from "fs";
 import { resolve as resolve7, dirname as dirname5 } from "path";
 async function loadRuntimeSource() {
   return await buildFromSource2() ?? await getInlinedRuntime() ?? readPrebuiltArtifact();
 }
 async function buildFromSource2() {
-  if (!existsSync8(ENTRY_TS)) return null;
+  if (!existsSync9(ENTRY_TS)) return null;
   try {
     const mod = await Promise.resolve().then(() => (init_src(), src_exports));
     if (typeof mod.loadHyperframeRuntimeSource === "function") {
@@ -13165,7 +13423,7 @@ function readPrebuiltArtifact() {
 function readFromDir(dir) {
   for (const name of ARTIFACT_NAMES) {
     const path2 = resolve7(dir, name);
-    if (existsSync8(path2)) return readFileSync9(path2, "utf-8");
+    if (existsSync9(path2)) return readFileSync11(path2, "utf-8");
   }
   return null;
 }
@@ -13383,7 +13641,7 @@ var init_mime = __esm({
 
 // ../core/src/studio-api/helpers/waveform.ts
 import { spawn as spawn3 } from "child_process";
-import { existsSync as existsSync9, writeFileSync as writeFileSync6, mkdirSync as mkdirSync5 } from "fs";
+import { existsSync as existsSync10, writeFileSync as writeFileSync6, mkdirSync as mkdirSync5 } from "fs";
 import { join as join11 } from "path";
 function buildWaveformCacheKey(assetPath) {
   return `${WAVEFORM_CACHE_VERSION}_${assetPath.replace(/[/\\]/g, "_")}.json`;
@@ -13445,10 +13703,10 @@ function decodeAudioPeaks(audioPath) {
 }
 async function generateWaveformCache(projectDir, assetPath) {
   const audioPath = join11(projectDir, assetPath);
-  if (!existsSync9(audioPath)) return;
+  if (!existsSync10(audioPath)) return;
   const cacheDir = join11(projectDir, ".waveform-cache");
   const cachePath2 = join11(cacheDir, buildWaveformCacheKey(assetPath));
-  if (existsSync9(cachePath2)) return;
+  if (existsSync10(cachePath2)) return;
   const peaks = await decodeAudioPeaks(audioPath);
   mkdirSync5(cacheDir, { recursive: true });
   writeFileSync6(cachePath2, JSON.stringify(peaks));
@@ -26303,8 +26561,8 @@ var init_sourceMutation = __esm({
 // ../core/src/studio-api/routes/files.ts
 import { bodyLimit } from "hono/body-limit";
 import {
-  existsSync as existsSync10,
-  readFileSync as readFileSync10,
+  existsSync as existsSync11,
+  readFileSync as readFileSync12,
   writeFileSync as writeFileSync8,
   mkdirSync as mkdirSync6,
   unlinkSync as unlinkSync3,
@@ -26328,14 +26586,14 @@ async function resolveProjectFile(c3, adapter2, opts) {
   if (!isSafePath(project.dir, absPath)) {
     return { error: c3.json({ error: "forbidden" }, 403) };
   }
-  if (opts?.mustExist && !existsSync10(absPath)) {
+  if (opts?.mustExist && !existsSync11(absPath)) {
     return { error: c3.json({ error: "not found" }, 404) };
   }
   return { project, filePath, absPath };
 }
 function ensureDir(filePath) {
   const dir = dirname6(filePath);
-  if (!existsSync10(dir)) mkdirSync6(dir, { recursive: true });
+  if (!existsSync11(dir)) mkdirSync6(dir, { recursive: true });
 }
 function generateCopyPath(projectDir, originalPath) {
   const ext = originalPath.includes(".") ? "." + originalPath.split(".").pop() : "";
@@ -26344,7 +26602,7 @@ function generateCopyPath(projectDir, originalPath) {
   const cleanBase = copyMatch ? base.slice(0, -copyMatch[0].length) : base;
   let num = copyMatch ? copyMatch[1] ? parseInt(copyMatch[1]) + 1 : 2 : 1;
   let candidate = num === 1 ? `${cleanBase} (copy)${ext}` : `${cleanBase} (copy ${num})${ext}`;
-  while (existsSync10(resolve9(projectDir, candidate))) {
+  while (existsSync11(resolve9(projectDir, candidate))) {
     num++;
     candidate = `${cleanBase} (copy ${num})${ext}`;
   }
@@ -26371,7 +26629,7 @@ function updateReferences(projectDir, oldPath, newPath) {
   );
   let updatedCount = 0;
   for (const file of textFiles) {
-    const content = readFileSync10(file, "utf-8");
+    const content = readFileSync12(file, "utf-8");
     if (!content.includes(oldPath)) continue;
     const updated = content.split(oldPath).join(newPath);
     if (updated !== content) {
@@ -26385,13 +26643,13 @@ function registerFileRoutes(api, adapter2) {
   api.get("/projects/:id/files/*", async (c3) => {
     const res = await resolveProjectFile(c3, adapter2);
     if ("error" in res) return res.error;
-    if (!existsSync10(res.absPath)) {
+    if (!existsSync11(res.absPath)) {
       if (c3.req.query("optional") === "1") {
         return c3.json({ filename: res.filePath, content: "" });
       }
       return c3.json({ error: "not found" }, 404);
     }
-    const content = readFileSync10(res.absPath, "utf-8");
+    const content = readFileSync12(res.absPath, "utf-8");
     return c3.json({ filename: res.filePath, content });
   });
   api.put("/projects/:id/files/*", async (c3) => {
@@ -26405,7 +26663,7 @@ function registerFileRoutes(api, adapter2) {
   api.post("/projects/:id/files/*", async (c3) => {
     const res = await resolveProjectFile(c3, adapter2);
     if ("error" in res) return res.error;
-    if (existsSync10(res.absPath)) {
+    if (existsSync11(res.absPath)) {
       return c3.json({ error: "already exists" }, 409);
     }
     ensureDir(res.absPath);
@@ -26438,14 +26696,14 @@ function registerFileRoutes(api, adapter2) {
     if (!isSafePath(project.dir, absPath)) {
       return c3.json({ error: "forbidden" }, 403);
     }
-    if (!existsSync10(absPath)) {
+    if (!existsSync11(absPath)) {
       return c3.json({ error: "not found" }, 404);
     }
     const body = await c3.req.json().catch(() => null);
     if (!body?.target) {
       return c3.json({ error: "target required" }, 400);
     }
-    const originalContent = readFileSync10(absPath, "utf-8");
+    const originalContent = readFileSync12(absPath, "utf-8");
     const patchedContent = removeElementFromHtml2(originalContent, body.target);
     if (patchedContent === originalContent) {
       return c3.json({ ok: true, changed: false, content: originalContent });
@@ -26473,7 +26731,7 @@ function registerFileRoutes(api, adapter2) {
     }
     let originalContent;
     try {
-      originalContent = readFileSync10(absPath, "utf-8");
+      originalContent = readFileSync12(absPath, "utf-8");
     } catch {
       return c3.json({ error: "not found" }, 404);
     }
@@ -26495,7 +26753,7 @@ function registerFileRoutes(api, adapter2) {
     if (!isSafePath(res.project.dir, newAbs)) {
       return c3.json({ error: "forbidden" }, 403);
     }
-    if (existsSync10(newAbs)) {
+    if (existsSync11(newAbs)) {
       return c3.json({ error: "already exists" }, 409);
     }
     ensureDir(newAbs);
@@ -26511,7 +26769,7 @@ function registerFileRoutes(api, adapter2) {
       return c3.json({ error: "path required" }, 400);
     }
     const srcAbs = resolve9(project.dir, body.path);
-    if (!isSafePath(project.dir, srcAbs) || !existsSync10(srcAbs)) {
+    if (!isSafePath(project.dir, srcAbs) || !existsSync11(srcAbs)) {
       return c3.json({ error: "not found" }, 404);
     }
     const copyPath = generateCopyPath(project.dir, body.path);
@@ -26520,7 +26778,7 @@ function registerFileRoutes(api, adapter2) {
       return c3.json({ error: "forbidden" }, 403);
     }
     ensureDir(destAbs);
-    writeFileSync8(destAbs, readFileSync10(srcAbs));
+    writeFileSync8(destAbs, readFileSync12(srcAbs));
     return c3.json({ ok: true, path: copyPath }, 201);
   });
   const MAX_UPLOAD_BYTES = 500 * 1024 * 1024;
@@ -26536,7 +26794,7 @@ function registerFileRoutes(api, adapter2) {
       const subDir = c3.req.query("dir") ?? "";
       const targetDir = subDir ? resolve9(project.dir, subDir) : project.dir;
       if (!isSafePath(project.dir, targetDir)) return c3.json({ error: "forbidden" }, 403);
-      if (subDir && !existsSync10(targetDir)) mkdirSync6(targetDir, { recursive: true });
+      if (subDir && !existsSync11(targetDir)) mkdirSync6(targetDir, { recursive: true });
       const formData = await c3.req.formData();
       const uploaded = [];
       const skipped = [];
@@ -26554,12 +26812,12 @@ function registerFileRoutes(api, adapter2) {
         if (!isSafePath(project.dir, destPath)) continue;
         let finalPath = destPath;
         let finalName = name;
-        if (existsSync10(finalPath)) {
+        if (existsSync11(finalPath)) {
           const dotIdx = name.indexOf(".", name.startsWith(".") ? 1 : 0);
           const ext = dotIdx > 0 ? name.slice(dotIdx) : "";
           const base = dotIdx > 0 ? name.slice(0, dotIdx) : name;
           let n = 2;
-          while (n < 1e4 && existsSync10(resolve9(targetDir, `${base} (${n})${ext}`))) n++;
+          while (n < 1e4 && existsSync11(resolve9(targetDir, `${base} (${n})${ext}`))) n++;
           if (n >= 1e4) {
             skipped.push(name);
             continue;
@@ -26781,7 +27039,7 @@ var init_htmlDocument = __esm({
 });
 
 // ../core/src/studio-api/helpers/subComposition.ts
-import { existsSync as existsSync11, readFileSync as readFileSync11 } from "fs";
+import { existsSync as existsSync12, readFileSync as readFileSync13 } from "fs";
 import { join as join14 } from "path";
 function isFullHtmlDocument(html) {
   return /^\s*(?:<!doctype\s|<html[\s>])/i.test(html);
@@ -26830,8 +27088,8 @@ function extractElementAttrs(el) {
 }
 function buildSubCompositionHtml(projectDir, compPath, runtimeUrl, baseHref) {
   const compFile = join14(projectDir, compPath);
-  if (!existsSync11(compFile)) return null;
-  const rawComp = readFileSync11(compFile, "utf-8");
+  if (!existsSync12(compFile)) return null;
+  const rawComp = readFileSync13(compFile, "utf-8");
   let compHeadContent = "";
   let rewrittenContent;
   let htmlAttrs = "";
@@ -26859,8 +27117,8 @@ function buildSubCompositionHtml(projectDir, compPath, runtimeUrl, baseHref) {
   }
   const indexPath = join14(projectDir, "index.html");
   let headContent = "";
-  if (existsSync11(indexPath)) {
-    const indexHtml = readFileSync11(indexPath, "utf-8");
+  if (existsSync12(indexPath)) {
+    const indexHtml = readFileSync13(indexPath, "utf-8");
     const headMatch = indexHtml.match(/<head[^>]*>([\s\S]*?)<\/head>/i);
     headContent = headMatch?.[1] ?? "";
   }
@@ -26901,7 +27159,7 @@ var init_subComposition = __esm({
 
 // ../core/src/studio-api/helpers/projectSignature.ts
 import { createHash } from "crypto";
-import { lstatSync, readFileSync as readFileSync12, readdirSync as readdirSync5 } from "fs";
+import { lstatSync, readFileSync as readFileSync14, readdirSync as readdirSync5 } from "fs";
 import { extname as extname4, isAbsolute as isAbsolute2, relative as relative2, resolve as resolve10 } from "path";
 function isPathWithin(parentDir, childPath) {
   const childRelativePath = relative2(parentDir, childPath);
@@ -26993,7 +27251,7 @@ function createProjectSignature(projectDir) {
     hash2.update("\0");
     if (entry.textContentEligible) {
       try {
-        hash2.update(readFileSync12(entry.file));
+        hash2.update(readFileSync14(entry.file));
       } catch {
         hash2.update(String(entry.mtimeMs));
       }
@@ -27238,7 +27496,7 @@ var init_studioMotionRenderScript = __esm({
 });
 
 // ../core/src/studio-api/routes/preview.ts
-import { existsSync as existsSync12, readFileSync as readFileSync13, statSync as statSync2 } from "fs";
+import { existsSync as existsSync13, readFileSync as readFileSync15, statSync as statSync2 } from "fs";
 import { join as join15, resolve as resolve11 } from "path";
 function resolveProjectSignature(adapter2, projectDir) {
   return adapter2.getProjectSignature?.(projectDir) ?? createProjectSignature(projectDir);
@@ -27258,9 +27516,9 @@ ${html}`;
 }
 function readStudioMotionManifestContent(projectDir) {
   const manifestPath = join15(projectDir, STUDIO_MOTION_PATH);
-  if (!existsSync12(manifestPath)) return "";
+  if (!existsSync13(manifestPath)) return "";
   try {
-    return readFileSync13(manifestPath, "utf-8");
+    return readFileSync15(manifestPath, "utf-8");
   } catch {
     return "";
   }
@@ -27341,12 +27599,12 @@ async function transformPreviewHtml(html, adapter2, project, activeCompositionPa
 }
 function resolveProjectMainHtml(projectDir, projectId) {
   const indexPath = join15(projectDir, "index.html");
-  if (existsSync12(indexPath)) {
-    return { html: readFileSync13(indexPath, "utf-8"), compositionPath: "index.html" };
+  if (existsSync13(indexPath)) {
+    return { html: readFileSync15(indexPath, "utf-8"), compositionPath: "index.html" };
   }
   const blockHtmlPath = join15(projectDir, `${projectId}.html`);
-  if (existsSync12(blockHtmlPath)) {
-    return { html: readFileSync13(blockHtmlPath, "utf-8"), compositionPath: `${projectId}.html` };
+  if (existsSync13(blockHtmlPath)) {
+    return { html: readFileSync15(blockHtmlPath, "utf-8"), compositionPath: `${projectId}.html` };
   }
   return null;
 }
@@ -27415,7 +27673,7 @@ ${runtimeTag}`;
       c3.req.path.replace(`/projects/${project.id}/preview/comp/`, "").split("?")[0] ?? ""
     );
     const compFile = resolve11(project.dir, compPath);
-    if (!isSafePath(project.dir, compFile) || !existsSync12(compFile) || !statSync2(compFile).isFile()) {
+    if (!isSafePath(project.dir, compFile) || !existsSync13(compFile) || !statSync2(compFile).isFile()) {
       return c3.text("not found", 404);
     }
     const etag = `"comp:${compPath}:${signature}"`;
@@ -27440,7 +27698,7 @@ ${runtimeTag}`;
       c3.req.path.replace(`/projects/${project.id}/preview/`, "").split("?")[0] ?? ""
     );
     const file = resolve11(project.dir, subPath);
-    const stat3 = existsSync12(file) ? statSync2(file) : null;
+    const stat3 = existsSync13(file) ? statSync2(file) : null;
     if (!isSafePath(project.dir, file) || !stat3?.isFile()) {
       return c3.text("not found", 404);
     }
@@ -27454,7 +27712,7 @@ ${runtimeTag}`;
         return new Response(null, { status: 304, headers: cacheHeaders });
       }
     }
-    const buffer = isText2 ? Buffer.from(readFileSync13(file, "utf-8"), "utf-8") : readFileSync13(file);
+    const buffer = isText2 ? Buffer.from(readFileSync15(file, "utf-8"), "utf-8") : readFileSync15(file);
     const totalSize2 = buffer.length;
     const rangeHeader = c3.req.header("Range");
     if (rangeHeader) {
@@ -27524,7 +27782,7 @@ var init_preview = __esm({
 });
 
 // ../core/src/studio-api/routes/lint.ts
-import { readFileSync as readFileSync14 } from "fs";
+import { readFileSync as readFileSync16 } from "fs";
 import { join as join16 } from "path";
 function registerLintRoutes(api, adapter2) {
   api.get("/projects/:id/lint", async (c3) => {
@@ -27534,7 +27792,7 @@ function registerLintRoutes(api, adapter2) {
       const htmlFiles = walkDir(project.dir).filter((f3) => f3.endsWith(".html"));
       const allFindings = [];
       for (const file of htmlFiles) {
-        const content = readFileSync14(join16(project.dir, file), "utf-8");
+        const content = readFileSync16(join16(project.dir, file), "utf-8");
         const result = await adapter2.lint(content, { filePath: file });
         if (result?.findings) {
           for (const f3 of result.findings) {
@@ -27558,7 +27816,7 @@ var init_lint2 = __esm({
 
 // ../core/src/studio-api/routes/render.ts
 import { streamSSE } from "hono/streaming";
-import { existsSync as existsSync13, readFileSync as readFileSync15, mkdirSync as mkdirSync7, unlinkSync as unlinkSync4, readdirSync as readdirSync6, statSync as statSync3 } from "fs";
+import { existsSync as existsSync14, readFileSync as readFileSync17, mkdirSync as mkdirSync7, unlinkSync as unlinkSync4, readdirSync as readdirSync6, statSync as statSync3 } from "fs";
 import { join as join17, resolve as resolve12, sep as sep2 } from "path";
 function registerRenderRoutes(api, adapter2) {
   const renderJobs = /* @__PURE__ */ new Map();
@@ -27610,7 +27868,7 @@ function registerRenderRoutes(api, adapter2) {
     const timePart = now.toTimeString().slice(0, 8).replace(/:/g, "-");
     const jobId = `${project.id}_${datePart}_${timePart}`;
     const rendersDir = adapter2.rendersDir(project);
-    if (!existsSync13(rendersDir)) mkdirSync7(rendersDir, { recursive: true });
+    if (!existsSync14(rendersDir)) mkdirSync7(rendersDir, { recursive: true });
     const ext = FORMAT_EXT2[format] ?? ".mp4";
     const outputPath = join17(rendersDir, `${jobId}${ext}`);
     const jobState = adapter2.startRender({
@@ -27663,12 +27921,12 @@ function registerRenderRoutes(api, adapter2) {
   api.get("/render/:jobId/view", (c3) => {
     const { jobId } = c3.req.param();
     const job = renderJobs.get(jobId);
-    if (!job?.outputPath || !existsSync13(job.outputPath)) {
+    if (!job?.outputPath || !existsSync14(job.outputPath)) {
       return c3.json({ error: "not found" }, 404);
     }
     const contentType = renderContentType(job.outputPath);
     const filename = job.outputPath.split("/").pop() ?? `render.mp4`;
-    const content = readFileSync15(job.outputPath);
+    const content = readFileSync17(job.outputPath);
     return new Response(content, {
       headers: {
         "Content-Type": contentType,
@@ -27681,12 +27939,12 @@ function registerRenderRoutes(api, adapter2) {
   api.get("/render/:jobId/download", (c3) => {
     const { jobId } = c3.req.param();
     const job = renderJobs.get(jobId);
-    if (!job?.outputPath || !existsSync13(job.outputPath)) {
+    if (!job?.outputPath || !existsSync14(job.outputPath)) {
       return c3.json({ error: "not found" }, 404);
     }
     const contentType = renderContentType(job.outputPath);
     const filename = job.outputPath.split("/").pop() ?? `render.mp4`;
-    const content = readFileSync15(job.outputPath);
+    const content = readFileSync17(job.outputPath);
     return new Response(content, {
       headers: {
         "Content-Type": contentType,
@@ -27701,7 +27959,7 @@ function registerRenderRoutes(api, adapter2) {
         const dir = state.outputPath.replace(/\/[^/]+$/, "");
         for (const ext of [".mp4", ".webm", ".mov", ".meta.json"]) {
           const fp = join17(dir, `${jobId}${ext}`);
-          if (existsSync13(fp)) unlinkSync4(fp);
+          if (existsSync14(fp)) unlinkSync4(fp);
         }
         break;
       }
@@ -27716,9 +27974,9 @@ function registerRenderRoutes(api, adapter2) {
     if (!filename) return c3.json({ error: "missing filename" }, 400);
     const rendersDir = adapter2.rendersDir(project);
     const fp = join17(rendersDir, filename);
-    if (!existsSync13(fp)) return c3.json({ error: "not found" }, 404);
+    if (!existsSync14(fp)) return c3.json({ error: "not found" }, 404);
     const contentType = renderContentType(fp);
-    const content = readFileSync15(fp);
+    const content = readFileSync17(fp);
     return new Response(content, {
       headers: {
         "Content-Type": contentType,
@@ -27732,7 +27990,7 @@ function registerRenderRoutes(api, adapter2) {
     const project = await adapter2.resolveProject(c3.req.param("id"));
     if (!project) return c3.json({ error: "not found" }, 404);
     const rendersDir = adapter2.rendersDir(project);
-    if (!existsSync13(rendersDir)) return c3.json({ renders: [] });
+    if (!existsSync14(rendersDir)) return c3.json({ renders: [] });
     const files = readdirSync6(rendersDir).filter((f3) => f3.endsWith(".mp4") || f3.endsWith(".webm") || f3.endsWith(".mov")).map((f3) => {
       const fp = join17(rendersDir, f3);
       const stat3 = statSync3(fp);
@@ -27740,9 +27998,9 @@ function registerRenderRoutes(api, adapter2) {
       const metaPath = join17(rendersDir, `${rid}.meta.json`);
       let status = "complete";
       let durationMs;
-      if (existsSync13(metaPath)) {
+      if (existsSync14(metaPath)) {
         try {
-          const meta = JSON.parse(readFileSync15(metaPath, "utf-8"));
+          const meta = JSON.parse(readFileSync17(metaPath, "utf-8"));
           if (meta.status === "failed") status = "failed";
           if (meta.durationMs) durationMs = meta.durationMs;
         } catch {
@@ -28365,7 +28623,7 @@ var init_manualEditsRenderScript = __esm({
 });
 
 // ../core/src/studio-api/routes/thumbnail.ts
-import { existsSync as existsSync14, readFileSync as readFileSync16, writeFileSync as writeFileSync9, mkdirSync as mkdirSync8, statSync as statSync4 } from "fs";
+import { existsSync as existsSync15, readFileSync as readFileSync18, writeFileSync as writeFileSync9, mkdirSync as mkdirSync8, statSync as statSync4 } from "fs";
 import { join as join18 } from "path";
 import { createHash as createHash2 } from "crypto";
 function registerThumbnailRoutes(api, adapter2) {
@@ -28396,9 +28654,9 @@ function registerThumbnailRoutes(api, adapter2) {
     let sourceMtime = 0;
     if (!vpWidth) {
       const htmlFile = join18(project.dir, compPath);
-      if (existsSync14(htmlFile)) {
+      if (existsSync15(htmlFile)) {
         sourceMtime = Math.round(statSync4(htmlFile).mtimeMs);
-        const html = readFileSync16(htmlFile, "utf-8");
+        const html = readFileSync18(htmlFile, "utf-8");
         const wMatch = html.match(/data-width=["'](\d+)["']/);
         const hMatch = html.match(/data-height=["'](\d+)["']/);
         if (wMatch?.[1]) compW = parseInt(wMatch[1]);
@@ -28407,15 +28665,15 @@ function registerThumbnailRoutes(api, adapter2) {
     }
     const manualEditsFile = join18(project.dir, STUDIO_MANUAL_EDITS_PATH);
     let manualEditsKey = "";
-    if (existsSync14(manualEditsFile)) {
-      const manualEditsContent = readFileSync16(manualEditsFile, "utf-8");
+    if (existsSync15(manualEditsFile)) {
+      const manualEditsContent = readFileSync18(manualEditsFile, "utf-8");
       manualEditsKey = `_${createHash2("sha1").update(manualEditsContent).digest("hex").slice(0, 16)}`;
       sourceMtime = Math.max(sourceMtime, Math.round(statSync4(manualEditsFile).mtimeMs));
     }
     const motionFile = join18(project.dir, STUDIO_MOTION_PATH);
     let motionKey = "";
-    if (existsSync14(motionFile)) {
-      const motionContent = readFileSync16(motionFile, "utf-8");
+    if (existsSync15(motionFile)) {
+      const motionContent = readFileSync18(motionFile, "utf-8");
       motionKey = `_${createHash2("sha1").update(motionContent).digest("hex").slice(0, 16)}`;
       sourceMtime = Math.max(sourceMtime, Math.round(statSync4(motionFile).mtimeMs));
     }
@@ -28425,8 +28683,8 @@ function registerThumbnailRoutes(api, adapter2) {
     const urlVersionKey = urlVersion ? `_${urlVersion.replace(/[^a-zA-Z0-9_-]+/g, "_").slice(0, 32)}` : "";
     const cacheKey = `${THUMBNAIL_CACHE_VERSION}${urlVersionKey}${manualEditsKey}${motionKey}_${format}_${compPath.replace(/\//g, "_")}_${compW}x${compH}_${sourceMtime}_${seekTime.toFixed(2)}${selectorKey}.${format === "png" ? "png" : "jpg"}`;
     const cachePath2 = join18(cacheDir, cacheKey);
-    if (existsSync14(cachePath2)) {
-      return new Response(new Uint8Array(readFileSync16(cachePath2)), {
+    if (existsSync15(cachePath2)) {
+      return new Response(new Uint8Array(readFileSync18(cachePath2)), {
         headers: { "Content-Type": contentType, "Cache-Control": "public, max-age=60" }
       });
     }
@@ -28448,7 +28706,7 @@ function registerThumbnailRoutes(api, adapter2) {
           500
         );
       }
-      if (!existsSync14(cacheDir)) mkdirSync8(cacheDir, { recursive: true });
+      if (!existsSync15(cacheDir)) mkdirSync8(cacheDir, { recursive: true });
       writeFileSync9(cachePath2, buffer);
       return new Response(new Uint8Array(buffer), {
         headers: { "Content-Type": contentType, "Cache-Control": "public, max-age=60" }
@@ -28470,7 +28728,7 @@ var init_thumbnail = __esm({
 });
 
 // ../core/src/studio-api/routes/waveform.ts
-import { existsSync as existsSync15, readFileSync as readFileSync17, writeFileSync as writeFileSync10, mkdirSync as mkdirSync9 } from "fs";
+import { existsSync as existsSync16, readFileSync as readFileSync19, writeFileSync as writeFileSync10, mkdirSync as mkdirSync9 } from "fs";
 import { join as join19 } from "path";
 function registerWaveformRoutes(api, adapter2) {
   api.get("/projects/:id/waveform/*", async (c3) => {
@@ -28480,12 +28738,12 @@ function registerWaveformRoutes(api, adapter2) {
       c3.req.path.replace(`/projects/${project.id}/waveform/`, "").split("?")[0] ?? ""
     );
     const audioPath = join19(project.dir, assetPath);
-    if (!existsSync15(audioPath)) return c3.json({ error: "file not found" }, 404);
+    if (!existsSync16(audioPath)) return c3.json({ error: "file not found" }, 404);
     const cacheDir = join19(project.dir, ".waveform-cache");
     const cachePath2 = join19(cacheDir, buildWaveformCacheKey(assetPath));
-    if (existsSync15(cachePath2)) {
+    if (existsSync16(cachePath2)) {
       try {
-        const peaks2 = JSON.parse(readFileSync17(cachePath2, "utf-8"));
+        const peaks2 = JSON.parse(readFileSync19(cachePath2, "utf-8"));
         return c3.json({ peaks: peaks2 });
       } catch {
       }
@@ -28513,15 +28771,15 @@ var init_waveform2 = __esm({
 
 // ../core/src/studio-api/routes/fonts.ts
 import { execFileSync as execFileSync4 } from "child_process";
-import { existsSync as existsSync16, readdirSync as readdirSync7, statSync as statSync5 } from "fs";
-import { homedir as homedir4, platform as platform3 } from "os";
+import { existsSync as existsSync17, readdirSync as readdirSync7, statSync as statSync5 } from "fs";
+import { homedir as homedir4, platform as platform5 } from "os";
 import { join as join20 } from "path";
 function isRecord(value) {
   return typeof value === "object" && value !== null;
 }
 function fontDirectories() {
   const home = homedir4();
-  if (platform3() === "darwin") {
+  if (platform5() === "darwin") {
     return [
       join20(home, "Library", "Fonts"),
       "/Library/Fonts",
@@ -28529,7 +28787,7 @@ function fontDirectories() {
       "/System/Library/Fonts/Supplemental"
     ];
   }
-  if (platform3() === "win32") {
+  if (platform5() === "win32") {
     return [join20(process.env.WINDIR || "C:\\Windows", "Fonts")];
   }
   return [
@@ -28551,7 +28809,7 @@ function toFamilyName(fileName) {
   return family.length >= 2 ? family : null;
 }
 function collectMacSystemProfilerFonts() {
-  if (platform3() !== "darwin") return [];
+  if (platform5() !== "darwin") return [];
   let parsed;
   try {
     const raw = execFileSync4("system_profiler", ["SPFontsDataType", "-json"], {
@@ -28586,7 +28844,7 @@ function collectMacSystemProfilerFonts() {
   return fonts;
 }
 function collectFontsFromDir(dir, depth = 0) {
-  if (!existsSync16(dir) || depth > 2) return [];
+  if (!existsSync17(dir) || depth > 2) return [];
   const fonts = [];
   for (const entry of readdirSync7(dir, { withFileTypes: true })) {
     const fullPath = join20(dir, entry.name);
@@ -28857,8 +29115,8 @@ __export(manager_exports2, {
   findBrowser: () => findBrowser,
   isLinuxArm: () => isLinuxArm
 });
-import { execSync, spawnSync as spawnSync2 } from "child_process";
-import { existsSync as existsSync17, readdirSync as readdirSync8, rmSync as rmSync4 } from "fs";
+import { execSync as execSync2, spawnSync as spawnSync2 } from "child_process";
+import { existsSync as existsSync18, readdirSync as readdirSync8, rmSync as rmSync4 } from "fs";
 import { basename as basename2 } from "path";
 import { homedir as homedir5 } from "os";
 import { join as join21 } from "path";
@@ -28866,7 +29124,7 @@ import { Browser, detectBrowserPlatform, getInstalledBrowsers, install } from "@
 function whichBinary2(name) {
   try {
     const cmd = process.platform === "win32" ? `where ${name}` : `which ${name}`;
-    const output = execSync(cmd, {
+    const output = execSync2(cmd, {
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"],
       timeout: 5e3
@@ -28879,7 +29137,7 @@ function whichBinary2(name) {
 }
 function findFromEnv2() {
   const envPath = process.env["HYPERFRAMES_BROWSER_PATH"];
-  if (envPath && existsSync17(envPath)) {
+  if (envPath && existsSync18(envPath)) {
     return { executablePath: envPath, source: "env" };
   }
   return void 0;
@@ -28889,7 +29147,7 @@ async function findFromCache() {
   if (fromPuppeteer) {
     return fromPuppeteer;
   }
-  if (existsSync17(CACHE_DIR2)) {
+  if (existsSync18(CACHE_DIR2)) {
     const installed = await getInstalledBrowsers({ cacheDir: CACHE_DIR2 });
     const match = installed.find((b2) => b2.browser === Browser.CHROMEHEADLESSSHELL);
     if (match) {
@@ -28927,7 +29185,7 @@ function compareVersionDirsDescending(a, b2) {
   return 0;
 }
 function findFromPuppeteerCache() {
-  if (!existsSync17(PUPPETEER_CACHE_DIR)) return void 0;
+  if (!existsSync18(PUPPETEER_CACHE_DIR)) return void 0;
   let versions;
   try {
     versions = [...readdirSync8(PUPPETEER_CACHE_DIR)].sort(compareVersionDirsDescending);
@@ -28952,7 +29210,7 @@ function findFromPuppeteerCache() {
       )
     ];
     for (const binary of candidates) {
-      if (existsSync17(binary)) {
+      if (existsSync18(binary)) {
         return { executablePath: binary, source: "cache" };
       }
     }
@@ -28979,7 +29237,7 @@ function _resetSystemFallbackWarnForTests() {
 }
 function findFromSystem2() {
   for (const p2 of SYSTEM_CHROME_PATHS) {
-    if (existsSync17(p2)) {
+    if (existsSync18(p2)) {
       return { executablePath: p2, source: "system" };
     }
   }
@@ -29004,7 +29262,7 @@ async function ensureLinuxArmBrowser(options) {
   void options;
   const existing = await findBrowser();
   if (existing) return existing;
-  const hasApt = existsSync17("/usr/bin/apt-get");
+  const hasApt = existsSync18("/usr/bin/apt-get");
   if (hasApt) {
     console.error(
       "\n\u{1F50D} Linux ARM64 detected \u2014 Chrome Headless Shell is not available for this platform."
@@ -29042,8 +29300,8 @@ Then re-run your command. The HYPERFRAMES_BROWSER_PATH env var persists for the
 async function ensureBrowser(options) {
   const existing = await findBrowser();
   if (existing) return existing;
-  const platform7 = detectBrowserPlatform();
-  if (!platform7) {
+  const platform9 = detectBrowserPlatform();
+  if (!platform9) {
     throw new Error(`Unsupported platform: ${process.platform} ${process.arch}`);
   }
   if (isLinuxArm()) {
@@ -29053,13 +29311,13 @@ async function ensureBrowser(options) {
     cacheDir: CACHE_DIR2,
     browser: Browser.CHROMEHEADLESSSHELL,
     buildId: CHROME_VERSION,
-    platform: platform7,
+    platform: platform9,
     downloadProgressCallback: options?.onProgress
   });
   return { executablePath: installed.executablePath, source: "download" };
 }
 function clearBrowser() {
-  if (!existsSync17(CACHE_DIR2)) {
+  if (!existsSync18(CACHE_DIR2)) {
     return false;
   }
   rmSync4(CACHE_DIR2, { recursive: true, force: true });
@@ -29230,7 +29488,7 @@ var init_config2 = __esm({
 });
 
 // ../engine/src/services/browserManager.ts
-import { existsSync as existsSync18, readdirSync as readdirSync9 } from "fs";
+import { existsSync as existsSync19, readdirSync as readdirSync9 } from "fs";
 import { join as join22 } from "path";
 import { homedir as homedir6 } from "os";
 async function getPuppeteer() {
@@ -29253,7 +29511,7 @@ function resolveHeadlessShellPath(config) {
     return process.env.PRODUCER_HEADLESS_SHELL_PATH;
   }
   const baseDir = join22(homedir6(), ".cache", "puppeteer", "chrome-headless-shell");
-  if (!existsSync18(baseDir)) return void 0;
+  if (!existsSync19(baseDir)) return void 0;
   try {
     const versions = readdirSync9(baseDir).sort().reverse();
     for (const version of versions) {
@@ -29264,7 +29522,7 @@ function resolveHeadlessShellPath(config) {
         join22(baseDir, version, "chrome-headless-shell-win64", "chrome-headless-shell.exe")
       ];
       for (const binary of candidates) {
-        if (existsSync18(binary)) return binary;
+        if (existsSync19(binary)) return binary;
       }
     }
   } catch {
@@ -29303,7 +29561,7 @@ function resolveBrowserGpuMode(mode, options = {}) {
   if (mode !== "auto") return Promise.resolve(mode);
   if (_autoBrowserGpuModeCache) return _autoBrowserGpuModeCache;
   _autoBrowserGpuModeCache = (async () => {
-    const platform7 = options.platform ?? process.platform;
+    const platform9 = options.platform ?? process.platform;
     const browserTimeout = options.browserTimeout ?? DEFAULT_CONFIG2.browserTimeout;
     const executablePath = options.chromePath ?? resolveHeadlessShellPath({});
     const probeArgs = [
@@ -29312,7 +29570,7 @@ function resolveBrowserGpuMode(mode, options = {}) {
       "--disable-dev-shm-usage",
       "--enable-webgl",
       "--ignore-gpu-blocklist",
-      ...getBrowserGpuArgs("hardware", platform7)
+      ...getBrowserGpuArgs("hardware", platform9)
     ];
     const ppt = await getPuppeteer().catch(() => null);
     if (!ppt) {
@@ -29505,7 +29763,7 @@ async function drainBrowserPool() {
   }
 }
 function buildChromeArgs(options, config) {
-  const platform7 = options.platform ?? process.platform;
+  const platform9 = options.platform ?? process.platform;
   const gpuDisabled = config?.disableGpu ?? DEFAULT_CONFIG2.disableGpu;
   const browserGpuMode = gpuDisabled ? "software" : config?.browserGpuMode ?? DEFAULT_CONFIG2.browserGpuMode;
   const chromeArgs = [
@@ -29515,7 +29773,7 @@ function buildChromeArgs(options, config) {
     CANVAS_DRAW_ELEMENT_FEATURE_FLAG,
     "--enable-webgl",
     "--ignore-gpu-blocklist",
-    ...getBrowserGpuArgs(browserGpuMode, platform7),
+    ...getBrowserGpuArgs(browserGpuMode, platform9),
     "--font-render-hinting=none",
     "--force-color-profile=srgb",
     `--window-size=${options.width},${options.height}`,
@@ -29563,14 +29821,14 @@ function buildChromeArgs(options, config) {
   }
   return chromeArgs;
 }
-function getBrowserGpuArgs(mode, platform7) {
+function getBrowserGpuArgs(mode, platform9) {
   if (mode === "software") {
     return ["--use-gl=angle", "--use-angle=swiftshader", "--enable-unsafe-swiftshader"];
   }
   if (mode === "auto") {
     return ["--use-gl=angle", "--use-angle=swiftshader", "--enable-unsafe-swiftshader"];
   }
-  switch (platform7) {
+  switch (platform9) {
     case "darwin":
       return ["--use-gl=angle", "--use-angle=metal", "--enable-gpu-rasterization"];
     case "win32":
@@ -29893,7 +30151,7 @@ var init_screenshotService = __esm({
 });
 
 // ../engine/src/services/frameCapture.ts
-import { existsSync as existsSync19, mkdirSync as mkdirSync10, writeFileSync as writeFileSync11 } from "fs";
+import { existsSync as existsSync20, mkdirSync as mkdirSync10, writeFileSync as writeFileSync11 } from "fs";
 import { join as join23 } from "path";
 async function driveWarmupTicks(options, state) {
   const sleep3 = options.sleep ?? realSleep;
@@ -29930,7 +30188,7 @@ async function waitForCloseWithTimeout(promise) {
   return !timedOut;
 }
 async function createCaptureSession(serverUrl, outputDir, options, onBeforeCapture = null, config) {
-  if (!existsSync19(outputDir)) mkdirSync10(outputDir, { recursive: true });
+  if (!existsSync20(outputDir)) mkdirSync10(outputDir, { recursive: true });
   const headlessShell = resolveHeadlessShellPath(config);
   const isLinux = process.platform === "linux";
   const forceScreenshot = config?.forceScreenshot ?? DEFAULT_CONFIG2.forceScreenshot;
@@ -30276,7 +30534,7 @@ async function initializeSession(session) {
 async function captureFrameErrorDiagnostics(session, frameIndex, time, error) {
   try {
     const diagnosticsDir = join23(session.outputDir, "diagnostics");
-    if (!existsSync19(diagnosticsDir)) mkdirSync10(diagnosticsDir, { recursive: true });
+    if (!existsSync20(diagnosticsDir)) mkdirSync10(diagnosticsDir, { recursive: true });
     const base = join23(diagnosticsDir, `frame-error-${frameIndex}`);
     await session.page.screenshot({ path: `${base}.png`, type: "png", fullPage: true });
     const html = await session.page.content();
@@ -30439,7 +30697,7 @@ async function closeCaptureSession(session) {
   session.isInitialized = false;
 }
 function prepareCaptureSessionForReuse(session, outputDir, onBeforeCapture) {
-  if (!existsSync19(outputDir)) {
+  if (!existsSync20(outputDir)) {
     mkdirSync10(outputDir, { recursive: true });
   }
   session.outputDir = outputDir;
@@ -30485,6 +30743,43 @@ var init_frameCapture = __esm({
   }
 });
 
+// ../engine/src/utils/processTracker.ts
+function trackChildProcess(proc) {
+  tracked.add(proc);
+  const remove2 = () => tracked.delete(proc);
+  proc.once("exit", remove2);
+  proc.once("error", remove2);
+}
+function killTrackedProcesses() {
+  const alive = [];
+  for (const proc of tracked) {
+    if (!proc.killed) {
+      try {
+        proc.kill("SIGTERM");
+        alive.push(proc);
+      } catch {
+      }
+    }
+  }
+  tracked.clear();
+  if (alive.length === 0) return;
+  setTimeout(() => {
+    for (const proc of alive) {
+      try {
+        proc.kill("SIGKILL");
+      } catch {
+      }
+    }
+  }, 500).unref();
+}
+var tracked;
+var init_processTracker = __esm({
+  "../engine/src/utils/processTracker.ts"() {
+    "use strict";
+    tracked = /* @__PURE__ */ new Set();
+  }
+});
+
 // ../engine/src/utils/gpuEncoder.ts
 import { spawn as spawn4 } from "child_process";
 async function detectGpuEncoder() {
@@ -30626,6 +30921,7 @@ async function runFfmpeg(args, opts) {
   const onStderr = opts?.onStderr;
   return new Promise((resolve46) => {
     const ffmpeg = spawn5("ffmpeg", args);
+    trackChildProcess(ffmpeg);
     let stderr = "";
     const onAbort = () => {
       ffmpeg.kill("SIGTERM");
@@ -30673,6 +30969,7 @@ var DEFAULT_TIMEOUT, DEFAULT_STDERR_TAIL_LINES;
 var init_runFfmpeg = __esm({
   "../engine/src/utils/runFfmpeg.ts"() {
     "use strict";
+    init_processTracker();
     DEFAULT_TIMEOUT = 3e5;
     DEFAULT_STDERR_TAIL_LINES = 15;
   }
@@ -30680,7 +30977,7 @@ var init_runFfmpeg = __esm({
 
 // ../engine/src/services/chunkEncoder.ts
 import { spawn as spawn6 } from "child_process";
-import { copyFileSync, existsSync as existsSync20, mkdirSync as mkdirSync11, readdirSync as readdirSync10, statSync as statSync6, writeFileSync as writeFileSync12 } from "fs";
+import { copyFileSync, existsSync as existsSync21, mkdirSync as mkdirSync11, readdirSync as readdirSync10, statSync as statSync6, writeFileSync as writeFileSync12 } from "fs";
 import { join as join24, dirname as dirname7 } from "path";
 function getEncoderPreset(quality, format = "mp4", hdr) {
   const base = ENCODER_PRESETS[quality];
@@ -30892,7 +31189,7 @@ function buildEncoderArgs(options, inputArgs, outputPath, gpuEncoder = null) {
 async function encodeFramesFromDir(framesDir, framePattern, outputPath, options, signal, config) {
   const startTime = Date.now();
   const outputDir = dirname7(outputPath);
-  if (!existsSync20(outputDir)) mkdirSync11(outputDir, { recursive: true });
+  if (!existsSync21(outputDir)) mkdirSync11(outputDir, { recursive: true });
   const files = readdirSync10(framesDir).filter((f3) => f3.match(/\.(jpg|jpeg|png)$/i));
   const frameCount = files.length;
   if (frameCount === 0) {
@@ -30914,6 +31211,7 @@ async function encodeFramesFromDir(framesDir, framePattern, outputPath, options,
   const args = buildEncoderArgs(options, inputArgs, outputPath, gpuEncoder);
   return new Promise((resolve46) => {
     const ffmpeg = spawn6("ffmpeg", args);
+    trackChildProcess(ffmpeg);
     let stderr = "";
     const onAbort = () => {
       ffmpeg.kill("SIGTERM");
@@ -30958,7 +31256,7 @@ async function encodeFramesFromDir(framesDir, framePattern, outputPath, options,
         });
         return;
       }
-      const fileSize = existsSync20(outputPath) ? statSync6(outputPath).size : 0;
+      const fileSize = existsSync21(outputPath) ? statSync6(outputPath).size : 0;
       resolve46({ success: true, outputPath, durationMs, framesEncoded: frameCount, fileSize });
     });
     ffmpeg.on("error", (err) => {
@@ -30991,7 +31289,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 = join24(dirname7(outputPath), "chunk-encode");
-  if (!existsSync20(chunkDir)) mkdirSync11(chunkDir, { recursive: true });
+  if (!existsSync21(chunkDir)) mkdirSync11(chunkDir, { recursive: true });
   const chunkPaths = [];
   for (let i2 = 0; i2 < chunkCount; i2++) {
     if (signal?.aborted) {
@@ -31024,6 +31322,7 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
     const args = buildEncoderArgs(options, inputArgs, chunkPath, gpuEncoder);
     const chunkResult = await new Promise((resolve46) => {
       const ffmpeg = spawn6("ffmpeg", args);
+      trackChildProcess(ffmpeg);
       let stderr = "";
       ffmpeg.stderr.on("data", (d2) => {
         stderr += d2.toString();
@@ -31065,6 +31364,7 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
   ];
   const concatResult = await new Promise((resolve46) => {
     const ffmpeg = spawn6("ffmpeg", concatArgs);
+    trackChildProcess(ffmpeg);
     let stderr = "";
     ffmpeg.stderr.on("data", (d2) => {
       stderr += d2.toString();
@@ -31087,7 +31387,7 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
       error: concatResult.error
     };
   }
-  const fileSize = existsSync20(outputPath) ? statSync6(outputPath).size : 0;
+  const fileSize = existsSync21(outputPath) ? statSync6(outputPath).size : 0;
   return {
     success: true,
     outputPath,
@@ -31098,7 +31398,7 @@ async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, op
 }
 async function muxVideoWithAudio(videoPath, audioPath, outputPath, signal, config) {
   const outputDir = dirname7(outputPath);
-  if (!existsSync20(outputDir)) mkdirSync11(outputDir, { recursive: true });
+  if (!existsSync21(outputDir)) mkdirSync11(outputDir, { recursive: true });
   const isWebm = outputPath.endsWith(".webm");
   const isMov = outputPath.endsWith(".mov");
   const args = ["-i", videoPath, "-i", audioPath, "-c:v", "copy"];
@@ -31155,6 +31455,7 @@ var ENCODER_PRESETS;
 var init_chunkEncoder = __esm({
   "../engine/src/services/chunkEncoder.ts"() {
     "use strict";
+    init_processTracker();
     init_config2();
     init_gpuEncoder();
     init_hdr();
@@ -31171,7 +31472,7 @@ var init_chunkEncoder = __esm({
 
 // ../engine/src/services/streamingEncoder.ts
 import { spawn as spawn7 } from "child_process";
-import { existsSync as existsSync21, mkdirSync as mkdirSync12, statSync as statSync7 } from "fs";
+import { existsSync as existsSync22, mkdirSync as mkdirSync12, statSync as statSync7 } from "fs";
 import { dirname as dirname8 } from "path";
 function createFrameReorderBuffer(startFrame, endFrame) {
   let cursor = startFrame;
@@ -31373,7 +31674,7 @@ function buildStreamingArgs(options, outputPath, gpuEncoder = null) {
 }
 async function spawnStreamingEncoder(outputPath, options, signal, config) {
   const outputDir = dirname8(outputPath);
-  if (!existsSync21(outputDir)) mkdirSync12(outputDir, { recursive: true });
+  if (!existsSync22(outputDir)) mkdirSync12(outputDir, { recursive: true });
   let gpuEncoder = null;
   if (options.useGpu) {
     gpuEncoder = await getCachedGpuEncoder();
@@ -31383,6 +31684,7 @@ async function spawnStreamingEncoder(outputPath, options, signal, config) {
   const ffmpeg = spawn7("ffmpeg", args, {
     stdio: ["pipe", "pipe", "pipe"]
   });
+  trackChildProcess(ffmpeg);
   let exitStatus = "running";
   let stderr = "";
   let exitCode = null;
@@ -31469,7 +31771,7 @@ Process error: ${err.message}`;
           error: formatFfmpegError(exitCode, stderr)
         };
       }
-      const fileSize = existsSync21(outputPath) ? statSync7(outputPath).size : 0;
+      const fileSize = existsSync22(outputPath) ? statSync7(outputPath).size : 0;
       return { success: true, durationMs, fileSize };
     },
     getExitStatus: () => exitStatus
@@ -31479,6 +31781,7 @@ Process error: ${err.message}`;
 var init_streamingEncoder = __esm({
   "../engine/src/services/streamingEncoder.ts"() {
     "use strict";
+    init_processTracker();
     init_gpuEncoder();
     init_runFfmpeg();
     init_hdr();
@@ -31489,7 +31792,7 @@ var init_streamingEncoder = __esm({
 
 // ../engine/src/utils/ffprobe.ts
 import { spawn as spawn8 } from "child_process";
-import { readFileSync as readFileSync18 } from "fs";
+import { readFileSync as readFileSync20 } from "fs";
 import { extname as extname5 } from "path";
 function runFfprobe(args) {
   return new Promise((resolve46, reject) => {
@@ -31583,7 +31886,7 @@ function extractPngMetadataFromBuffer(buf) {
 function extractStillImageMetadata(filePath) {
   if (extname5(filePath).toLowerCase() !== ".png") return null;
   try {
-    return extractPngMetadataFromBuffer(readFileSync18(filePath));
+    return extractPngMetadataFromBuffer(readFileSync20(filePath));
   } catch {
     return null;
   }
@@ -31770,7 +32073,7 @@ var init_ffprobe = __esm({
 });
 
 // ../engine/src/utils/urlDownloader.ts
-import { createWriteStream as createWriteStream2, existsSync as existsSync22, mkdirSync as mkdirSync13 } from "fs";
+import { createWriteStream as createWriteStream2, existsSync as existsSync23, mkdirSync as mkdirSync13 } from "fs";
 import { createHash as createHash3 } from "crypto";
 import { join as join25, extname as extname6 } from "path";
 import { Readable } from "stream";
@@ -31783,19 +32086,19 @@ function getFilenameFromUrl(url) {
 }
 async function downloadToTemp(url, destDir, timeoutMs = 3e5) {
   const cachedPath = downloadPathCache.get(url);
-  if (cachedPath && existsSync22(cachedPath)) {
+  if (cachedPath && existsSync23(cachedPath)) {
     return cachedPath;
   }
   const inFlight = inFlightDownloads.get(url);
   if (inFlight) {
     return inFlight;
   }
-  if (!existsSync22(destDir)) {
+  if (!existsSync23(destDir)) {
     mkdirSync13(destDir, { recursive: true });
   }
   const filename = getFilenameFromUrl(url);
   const localPath = join25(destDir, filename);
-  if (existsSync22(localPath)) {
+  if (existsSync23(localPath)) {
     downloadPathCache.set(url, localPath);
     return localPath;
   }
@@ -32551,7 +32854,7 @@ var init_inlineSubCompositions = __esm({
 });
 
 // ../core/src/compiler/htmlBundler.ts
-import { readFileSync as readFileSync19, existsSync as existsSync23 } from "fs";
+import { readFileSync as readFileSync21, existsSync as existsSync24 } from "fs";
 import { join as join26, resolve as resolve14, relative as relative3, dirname as dirname9, isAbsolute as isAbsolute3, sep as sep3 } from "path";
 import { transformSync } from "esbuild";
 function safePath(projectDir, relativePath) {
@@ -32599,9 +32902,9 @@ function isRelativeUrl(url) {
   return !url.startsWith("http://") && !url.startsWith("https://") && !url.startsWith("//") && !url.startsWith("data:") && !isAbsolute3(url);
 }
 function safeReadFile(filePath) {
-  if (!existsSync23(filePath)) return null;
+  if (!existsSync24(filePath)) return null;
   try {
-    return readFileSync19(filePath, "utf-8");
+    return readFileSync21(filePath, "utf-8");
   } catch {
     return null;
   }
@@ -32671,9 +32974,9 @@ ${inlined}
   return rebased;
 }
 function safeReadFileBuffer(filePath) {
-  if (!existsSync23(filePath)) return null;
+  if (!existsSync24(filePath)) return null;
   try {
-    return readFileSync19(filePath);
+    return readFileSync21(filePath);
   } catch {
     return null;
   }
@@ -32975,8 +33278,8 @@ function stripJsCommentsParserSafe(source) {
 }
 async function bundleToSingleHtml(projectDir, options) {
   const indexPath = join26(projectDir, "index.html");
-  if (!existsSync23(indexPath)) throw new Error("index.html not found in project directory");
-  const rawHtml = readFileSync19(indexPath, "utf-8");
+  if (!existsSync24(indexPath)) throw new Error("index.html not found in project directory");
+  const rawHtml = readFileSync21(indexPath, "utf-8");
   const compiled = await compileHtml(rawHtml, projectDir, options?.probeMediaDuration);
   const staticGuard = validateHyperframeHtmlContract(compiled);
   if (!staticGuard.isValid) {
@@ -33329,7 +33632,7 @@ var init_htmlTemplate = __esm({
 // ../engine/src/services/extractionCache.ts
 import { createHash as createHash4 } from "crypto";
 import { mkdirSync as mkdirSync14, readdirSync as readdirSync11, statSync as statSync8, writeFileSync as writeFileSync13 } from "fs";
-import { existsSync as existsSync24 } from "fs";
+import { existsSync as existsSync25 } from "fs";
 import { join as join27 } from "path";
 function readKeyStat(videoPath) {
   try {
@@ -33360,7 +33663,7 @@ function cacheEntryDirName(keyHash) {
 function lookupCacheEntry(rootDir, input) {
   const keyHash = computeCacheKey(input);
   const dir = join27(rootDir, cacheEntryDirName(keyHash));
-  const complete = existsSync24(join27(dir, COMPLETE_SENTINEL));
+  const complete = existsSync25(join27(dir, COMPLETE_SENTINEL));
   return { entry: { dir, keyHash }, hit: complete };
 }
 function ensureCacheEntryDir(entry) {
@@ -33401,7 +33704,7 @@ var init_extractionCache = __esm({
 
 // ../engine/src/services/videoFrameExtractor.ts
 import { spawn as spawn9 } from "child_process";
-import { existsSync as existsSync25, mkdirSync as mkdirSync15, readdirSync as readdirSync12, rmSync as rmSync5 } from "fs";
+import { existsSync as existsSync26, mkdirSync as mkdirSync15, readdirSync as readdirSync12, rmSync as rmSync5 } from "fs";
 import { isAbsolute as isAbsolute4, join as join28, posix as posix2, resolve as resolve15, sep as sep4 } from "path";
 function parseVideoElements(html) {
   const videos = [];
@@ -33473,7 +33776,7 @@ async function extractVideoFramesRange(videoPath, videoId, startTime, duration,
   const ffmpegProcessTimeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG2.ffmpegProcessTimeout;
   const { fps, outputDir, quality = 95 } = options;
   const videoOutputDir = outputDirOverride ?? join28(outputDir, videoId);
-  if (!existsSync25(videoOutputDir)) mkdirSync15(videoOutputDir, { recursive: true });
+  if (!existsSync26(videoOutputDir)) mkdirSync15(videoOutputDir, { recursive: true });
   const metadata = await extractMediaMetadata(videoPath);
   const format = resolveFrameFormat(metadata, options.format);
   const framePattern = `${FRAME_FILENAME_PREFIX}%05d.${format}`;
@@ -33499,6 +33802,7 @@ async function extractVideoFramesRange(videoPath, videoId, startTime, duration,
   args.push("-y", outputPattern);
   return new Promise((resolve46, reject) => {
     const ffmpeg = spawn9("ffmpeg", args);
+    trackChildProcess(ffmpeg);
     let stderr = "";
     const onAbort = () => {
       ffmpeg.kill("SIGTERM");
@@ -33661,7 +33965,7 @@ function resolveProjectRelativeSrc(src, baseDir, compiledDir) {
       candidates.push(join28(baseDir, stripped));
     }
   }
-  return candidates.find(existsSync25) ?? fromBase;
+  return candidates.find(existsSync26) ?? fromBase;
 }
 async function extractAllVideoFrames(videos, baseDir, options, signal, config, compiledDir) {
   const startTime = Date.now();
@@ -33695,7 +33999,7 @@ async function extractAllVideoFrames(videos, baseDir, options, signal, config, c
         mkdirSync15(downloadDir, { recursive: true });
         videoPath = await downloadToTemp(videoPath, downloadDir);
       }
-      if (!existsSync25(videoPath)) {
+      if (!existsSync26(videoPath)) {
         if (!warnedSrcs.has(video.src)) {
           warnedSrcs.add(video.src);
           process.stderr.write(
@@ -33961,6 +34265,7 @@ var init_videoFrameExtractor = __esm({
   "../engine/src/services/videoFrameExtractor.ts"() {
     "use strict";
     init_esm10();
+    init_processTracker();
     init_ffprobe();
     init_hdr();
     init_urlDownloader();
@@ -34064,7 +34369,7 @@ var init_videoFrameExtractor = __esm({
       cleanup() {
         for (const video of this.videos.values()) {
           if (video.extracted.ownedByLookup) continue;
-          if (existsSync25(video.extracted.outputDir)) {
+          if (existsSync26(video.extracted.outputDir)) {
             rmSync5(video.extracted.outputDir, { recursive: true, force: true });
           }
         }
@@ -34468,7 +34773,7 @@ var init_videoFrameInjector = __esm({
 });
 
 // ../engine/src/services/audioMixer.ts
-import { existsSync as existsSync26, mkdirSync as mkdirSync16, rmSync as rmSync6 } from "fs";
+import { existsSync as existsSync27, mkdirSync as mkdirSync16, rmSync as rmSync6 } from "fs";
 import { isAbsolute as isAbsolute5, join as join29, dirname as dirname10 } from "path";
 function parseAudioElements(html) {
   const elements = [];
@@ -34520,7 +34825,7 @@ function parseAudioElements(html) {
 async function extractAudioFromVideo(videoPath, outputPath, options, signal, config) {
   const ffmpegProcessTimeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG2.ffmpegProcessTimeout;
   const outputDir = dirname10(outputPath);
-  if (!existsSync26(outputDir)) mkdirSync16(outputDir, { recursive: true });
+  if (!existsSync27(outputDir)) mkdirSync16(outputDir, { recursive: true });
   const args = ["-i", videoPath];
   if (options?.startTime !== void 0) args.push("-ss", String(options.startTime));
   if (options?.duration !== void 0) args.push("-t", String(options.duration));
@@ -34547,7 +34852,7 @@ async function extractAudioFromVideo(videoPath, outputPath, options, signal, con
 async function prepareAudioTrack(srcPath, outputPath, mediaStart, duration, signal, config) {
   const ffmpegProcessTimeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG2.ffmpegProcessTimeout;
   const outputDir = dirname10(outputPath);
-  if (!existsSync26(outputDir)) mkdirSync16(outputDir, { recursive: true });
+  if (!existsSync27(outputDir)) mkdirSync16(outputDir, { recursive: true });
   const args = [
     "-ss",
     String(mediaStart),
@@ -34583,7 +34888,7 @@ async function prepareAudioTrack(srcPath, outputPath, mediaStart, duration, sign
 async function generateSilence(outputPath, duration, signal, config) {
   const ffmpegProcessTimeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG2.ffmpegProcessTimeout;
   const outputDir = dirname10(outputPath);
-  if (!existsSync26(outputDir)) mkdirSync16(outputDir, { recursive: true });
+  if (!existsSync27(outputDir)) mkdirSync16(outputDir, { recursive: true });
   const args = [
     "-f",
     "lavfi",
@@ -34626,7 +34931,7 @@ async function mixAudioTracks(tracks, outputPath, totalDuration, signal, config)
     };
   }
   const outputDir = dirname10(outputPath);
-  if (!existsSync26(outputDir)) mkdirSync16(outputDir, { recursive: true });
+  if (!existsSync27(outputDir)) mkdirSync16(outputDir, { recursive: true });
   const inputs = [];
   const filterParts = [];
   tracks.forEach((track, i2) => {
@@ -34687,7 +34992,7 @@ async function processCompositionAudio(elements, baseDir, workDir, outputPath, t
   const startMs = Date.now();
   const tracks = [];
   const errors = [];
-  if (!existsSync26(workDir)) mkdirSync16(workDir, { recursive: true });
+  if (!existsSync27(workDir)) mkdirSync16(workDir, { recursive: true });
   await Promise.all(
     elements.map(async (element) => {
       if (signal?.aborted) {
@@ -34709,7 +35014,7 @@ async function processCompositionAudio(elements, baseDir, workDir, outputPath, t
             return;
           }
         }
-        if (!existsSync26(srcPath)) {
+        if (!existsSync27(srcPath)) {
           errors.push(`Source not found: ${element.id} (${element.src})`);
           return;
         }
@@ -34873,7 +35178,7 @@ var init_readWebGlVendorInfoFromCanvas = __esm({
 
 // ../engine/src/services/parallelCoordinator.ts
 import { cpus as cpus2, freemem as freemem2, totalmem as totalmem2 } from "os";
-import { existsSync as existsSync27, mkdirSync as mkdirSync17, readdirSync as readdirSync13 } from "fs";
+import { existsSync as existsSync28, mkdirSync as mkdirSync17, readdirSync as readdirSync13 } from "fs";
 import { copyFile, rename } from "fs/promises";
 import { join as join30 } from "path";
 function defaultSafeMaxWorkers() {
@@ -34940,7 +35245,7 @@ function shouldVerifyWorkerGpu(workerId, config) {
 async function executeWorkerTask(task, serverUrl, captureOptions, createBeforeCaptureHook, signal, onFrameCaptured, onFrameBuffer, config) {
   const startTime = Date.now();
   let framesCaptured = 0;
-  if (!existsSync27(task.outputDir)) mkdirSync17(task.outputDir, { recursive: true });
+  if (!existsSync28(task.outputDir)) mkdirSync17(task.outputDir, { recursive: true });
   let session = null;
   let perf;
   try {
@@ -35035,11 +35340,11 @@ async function executeParallelCapture(serverUrl, workDir, tasks, captureOptions,
   return results;
 }
 async function mergeWorkerFrames(workDir, tasks, outputDir) {
-  if (!existsSync27(outputDir)) mkdirSync17(outputDir, { recursive: true });
+  if (!existsSync28(outputDir)) mkdirSync17(outputDir, { recursive: true });
   let totalFrames = 0;
   const sortedTasks = [...tasks].sort((a, b2) => a.startFrame - b2.startFrame);
   for (const task of sortedTasks) {
-    if (!existsSync27(task.outputDir)) {
+    if (!existsSync28(task.outputDir)) {
       continue;
     }
     const files = readdirSync13(task.outputDir).filter((f3) => f3.startsWith("frame_") && (f3.endsWith(".jpg") || f3.endsWith(".png"))).sort();
@@ -35083,7 +35388,7 @@ var init_parallelCoordinator = __esm({
 // ../engine/src/services/fileServer.ts
 import { Hono as Hono2 } from "hono";
 import { serve } from "@hono/node-server";
-import { readFileSync as readFileSync20, existsSync as existsSync28, statSync as statSync9 } from "fs";
+import { readFileSync as readFileSync22, existsSync as existsSync29, statSync as statSync9 } from "fs";
 import { join as join31, extname as extname7 } from "path";
 function createFileServer(options) {
   const { projectDir, compiledDir, port = 0, stripEmbeddedRuntime = true } = options;
@@ -35096,20 +35401,20 @@ function createFileServer(options) {
     const relativePath = requestPath.replace(/^\//, "");
     const compiledPath = compiledDir ? join31(compiledDir, relativePath) : null;
     const hasCompiledFile = Boolean(
-      compiledPath && existsSync28(compiledPath) && statSync9(compiledPath).isFile()
+      compiledPath && existsSync29(compiledPath) && statSync9(compiledPath).isFile()
     );
     const filePath = hasCompiledFile ? compiledPath : join31(projectDir, relativePath);
-    if (!existsSync28(filePath) || !statSync9(filePath).isFile()) {
+    if (!existsSync29(filePath) || !statSync9(filePath).isFile()) {
       return c3.text("Not found", 404);
     }
     const ext = extname7(filePath).toLowerCase();
     const contentType = MIME_TYPES2[ext] || "application/octet-stream";
     if (ext === ".html") {
-      const rawHtml = readFileSync20(filePath, "utf-8");
+      const rawHtml = readFileSync22(filePath, "utf-8");
       const html = relativePath === "index.html" ? injectScriptsIntoHtml(rawHtml, headScripts, bodyScripts, stripEmbeddedRuntime) : rawHtml;
       return c3.text(html, 200, { "Content-Type": contentType });
     }
-    const content = readFileSync20(filePath);
+    const content = readFileSync22(filePath);
     return new Response(content, {
       status: 200,
       headers: { "Content-Type": contentType }
@@ -36412,7 +36717,7 @@ var init_shaderTransitions = __esm({
 });
 
 // ../engine/src/services/hdrCapture.ts
-import { existsSync as existsSync29, readdirSync as readdirSync14 } from "fs";
+import { existsSync as existsSync30, readdirSync as readdirSync14 } from "fs";
 import { join as join32 } from "path";
 import { homedir as homedir7 } from "os";
 function linearToPQ(L2) {
@@ -36530,7 +36835,7 @@ function float16ToPqRgb(rawBuffer, bytesPerRow, width, height) {
 }
 function resolveHeadedChromePath() {
   const baseDir = join32(homedir7(), ".cache", "puppeteer", "chrome");
-  if (!existsSync29(baseDir)) return void 0;
+  if (!existsSync30(baseDir)) return void 0;
   const versions = readdirSync14(baseDir).sort().reverse();
   for (const version of versions) {
     const candidates = [
@@ -36556,7 +36861,7 @@ function resolveHeadedChromePath() {
       join32(baseDir, version, "chrome-win64", "chrome.exe")
     ];
     for (const binary of candidates) {
-      if (existsSync29(binary)) return binary;
+      if (existsSync30(binary)) return binary;
     }
   }
   return void 0;
@@ -36697,6 +37002,7 @@ __export(src_exports2, {
   injectVideoFramesBatch: () => injectVideoFramesBatch,
   isHdrColorSpace: () => isHdrColorSpace,
   isHttpUrl: () => isHttpUrl,
+  killTrackedProcesses: () => killTrackedProcesses,
   launchHdrBrowser: () => launchHdrBrowser,
   linearToHdr: () => linearToHdr,
   mergeWorkerFrames: () => mergeWorkerFrames,
@@ -36727,6 +37033,7 @@ __export(src_exports2, {
   showVideoElements: () => showVideoElements,
   spawnStreamingEncoder: () => spawnStreamingEncoder,
   syncVideoFrameVisibility: () => syncVideoFrameVisibility,
+  trackChildProcess: () => trackChildProcess,
   uploadAndReadbackHdrFrame: () => uploadAndReadbackHdrFrame
 });
 var init_src2 = __esm({
@@ -36749,6 +37056,7 @@ var init_src2 = __esm({
     init_ffprobe();
     init_urlDownloader();
     init_runFfmpeg();
+    init_processTracker();
     init_alphaBlit();
     init_layerCompositor();
     init_shaderTransitions();
@@ -36825,7 +37133,7 @@ __export(deterministicFonts_exports, {
   iterateFontFamilyDeclarations: () => iterateFontFamilyDeclarations,
   parseFontFamilyValue: () => parseFontFamilyValue
 });
-import { existsSync as existsSync30, mkdirSync as mkdirSync18, readFileSync as readFileSync21, writeFileSync as writeFileSync14 } from "fs";
+import { existsSync as existsSync31, mkdirSync as mkdirSync18, readFileSync as readFileSync23, writeFileSync as writeFileSync14 } from "fs";
 import { homedir as homedir8, tmpdir as tmpdir3 } from "os";
 import { join as join33 } from "path";
 function parseFontFamilyValue(value) {
@@ -36954,7 +37262,7 @@ function fontSlug(familyName) {
 }
 function fontCacheDir(slug) {
   const dir = join33(GOOGLE_FONTS_CACHE_DIR, slug);
-  if (!existsSync30(dir)) {
+  if (!existsSync31(dir)) {
     mkdirSync18(dir, { recursive: true });
   }
   return dir;
@@ -36998,7 +37306,7 @@ async function fetchGoogleFont(familyName, options) {
     const woff2Url = match[3] || "";
     if (!woff2Url) continue;
     const cachePath2 = cachedWoff2Path(slug, weight, style);
-    if (!existsSync30(cachePath2)) {
+    if (!existsSync31(cachePath2)) {
       const woff2What = `Google Fonts woff2 (${weight}/${style})`;
       try {
         const fontRes = await options.fetchImpl(woff2Url);
@@ -37018,7 +37326,7 @@ async function fetchGoogleFont(familyName, options) {
         continue;
       }
     }
-    const fontBytes = readFileSync21(cachePath2);
+    const fontBytes = readFileSync23(cachePath2);
     const dataUri = `data:font/woff2;base64,${fontBytes.toString("base64")}`;
     faces.push({ weight, style, dataUri });
   }
@@ -37218,7 +37526,7 @@ var init_deterministicFonts = __esm({
 
 // ../producer/src/services/hyperframeRuntimeLoader.ts
 import { createHash as createHash5 } from "crypto";
-import { existsSync as existsSync31, readFileSync as readFileSync22 } from "fs";
+import { existsSync as existsSync32, readFileSync as readFileSync24 } from "fs";
 import { dirname as dirname11, resolve as resolve16 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 function resolveHyperframeManifestPath() {
@@ -37231,7 +37539,7 @@ function resolveHyperframeManifestPath() {
     MODULE_RELATIVE_MANIFEST_PATH
   ];
   for (const candidate of candidates) {
-    if (existsSync31(candidate)) {
+    if (existsSync32(candidate)) {
       return candidate;
     }
   }
@@ -37242,12 +37550,12 @@ function getVerifiedHyperframeRuntimeSource() {
 }
 function resolveVerifiedHyperframeRuntime() {
   const manifestPath = resolveHyperframeManifestPath();
-  if (!existsSync31(manifestPath)) {
+  if (!existsSync32(manifestPath)) {
     throw new Error(
       `[HyperframeRuntimeLoader] Missing manifest at ${manifestPath}. Build core runtime artifacts before rendering.`
     );
   }
-  const manifestRaw = readFileSync22(manifestPath, "utf8");
+  const manifestRaw = readFileSync24(manifestPath, "utf8");
   const manifest = JSON.parse(manifestRaw);
   const runtimeFileName = manifest.artifacts?.iife;
   if (!runtimeFileName || !manifest.sha256) {
@@ -37256,10 +37564,10 @@ function resolveVerifiedHyperframeRuntime() {
     );
   }
   const runtimePath = resolve16(dirname11(manifestPath), runtimeFileName);
-  if (!existsSync31(runtimePath)) {
+  if (!existsSync32(runtimePath)) {
     throw new Error(`[HyperframeRuntimeLoader] Missing runtime artifact at ${runtimePath}.`);
   }
-  const runtimeSource = readFileSync22(runtimePath, "utf8");
+  const runtimeSource = readFileSync24(runtimePath, "utf8");
   const runtimeSha = createHash5("sha256").update(runtimeSource, "utf8").digest("hex");
   if (runtimeSha !== manifest.sha256) {
     throw new Error(
@@ -37298,7 +37606,7 @@ 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 readFileSync23, existsSync as existsSync32, realpathSync, statSync as statSync10 } from "fs";
+import { readFileSync as readFileSync25, existsSync as existsSync33, realpathSync, statSync as statSync10 } from "fs";
 import { join as join34, extname as extname8, resolve as resolve17, sep as sep5 } from "path";
 function isPathInside(child, parent, options = {}) {
   const { resolveSymlinks = false, pathModule } = options;
@@ -37306,8 +37614,8 @@ function isPathInside(child, parent, options = {}) {
   const separator = pathModule?.sep ?? sep5;
   const resolvedChild = resolveFn(child);
   const resolvedParent = resolveFn(parent);
-  const normalizedChild = resolveSymlinks && existsSync32(resolvedChild) ? realpathSync.native(resolvedChild) : resolvedChild;
-  const normalizedParent = resolveSymlinks && existsSync32(resolvedParent) ? realpathSync.native(resolvedParent) : resolvedParent;
+  const normalizedChild = resolveSymlinks && existsSync33(resolvedChild) ? realpathSync.native(resolvedChild) : resolvedChild;
+  const normalizedParent = resolveSymlinks && existsSync33(resolvedParent) ? realpathSync.native(resolvedParent) : resolvedParent;
   if (normalizedChild === normalizedParent) return true;
   const parentWithSep = normalizedParent.endsWith(separator) ? normalizedParent : normalizedParent + separator;
   return normalizedChild.startsWith(parentWithSep);
@@ -37474,13 +37782,13 @@ function createFileServer2(options) {
     let filePath = null;
     if (compiledDir) {
       const candidate = join34(compiledDir, relativePath);
-      if (existsSync32(candidate) && isPathInside(candidate, compiledDir) && statSync10(candidate).isFile()) {
+      if (existsSync33(candidate) && isPathInside(candidate, compiledDir) && statSync10(candidate).isFile()) {
         filePath = candidate;
       }
     }
     if (!filePath) {
       const candidate = join34(projectDir, relativePath);
-      if (existsSync32(candidate) && isPathInside(candidate, projectDir) && statSync10(candidate).isFile()) {
+      if (existsSync33(candidate) && isPathInside(candidate, projectDir) && statSync10(candidate).isFile()) {
         filePath = candidate;
       }
     }
@@ -37493,7 +37801,7 @@ function createFileServer2(options) {
     const ext = extname8(filePath).toLowerCase();
     const contentType = MIME_TYPES3[ext] || "application/octet-stream";
     if (ext === ".html") {
-      const rawHtml = readFileSync23(filePath, "utf-8");
+      const rawHtml = readFileSync25(filePath, "utf-8");
       const isIndex = relativePath === "index.html";
       let html = rawHtml;
       if (preHeadScripts.length > 0) {
@@ -37502,7 +37810,7 @@ function createFileServer2(options) {
       html = isIndex ? injectScriptsIntoHtml(html, headScripts, bodyScripts, stripEmbeddedRuntime) : html;
       return c3.text(html, 200, { "Content-Type": contentType });
     }
-    const content = readFileSync23(filePath);
+    const content = readFileSync25(filePath);
     return new Response(content, {
       status: 200,
       headers: { "Content-Type": contentType }
@@ -37847,7 +38155,7 @@ var init_paths = __esm({
 });
 
 // ../producer/src/services/render/shared.ts
-import { copyFileSync as copyFileSync2, cpSync, existsSync as existsSync33, mkdirSync as mkdirSync19, symlinkSync, writeFileSync as writeFileSync15 } from "fs";
+import { copyFileSync as copyFileSync2, cpSync, existsSync as existsSync34, mkdirSync as mkdirSync19, symlinkSync, writeFileSync as writeFileSync15 } from "fs";
 import { basename as basename4, dirname as dirname12, isAbsolute as isAbsolute6, join as join36, relative as relative4, resolve as resolve18 } from "path";
 function projectBrowserEndToCompositionTimeline(existingStart, browserStart, browserEnd) {
   return browserEnd + (existingStart - browserStart);
@@ -38034,7 +38342,7 @@ var init_shared = __esm({
       isAbsolute: isAbsolute6
     };
     materializeFileSystem = {
-      existsSync: existsSync33,
+      existsSync: existsSync34,
       mkdirSync: mkdirSync19,
       symlinkSync,
       cpSync
@@ -38570,7 +38878,7 @@ var init_urlDownloader2 = __esm({
 });
 
 // ../producer/src/services/htmlCompiler.ts
-import { readFileSync as readFileSync24, existsSync as existsSync34, mkdirSync as mkdirSync20 } from "fs";
+import { readFileSync as readFileSync26, existsSync as existsSync35, mkdirSync as mkdirSync20 } from "fs";
 import { join as join38, dirname as dirname13, resolve as resolve19 } from "path";
 function dedupeElementsById(elements) {
   const deduped = /* @__PURE__ */ new Map();
@@ -38632,7 +38940,7 @@ function detectShaderTransitionUsage(html) {
 async function resolveMediaDuration(src, mediaStart, baseDir, downloadDir, tagName19) {
   let filePath = src;
   if (isHttpUrl(src)) {
-    if (!existsSync34(downloadDir)) mkdirSync20(downloadDir, { recursive: true });
+    if (!existsSync35(downloadDir)) mkdirSync20(downloadDir, { recursive: true });
     try {
       filePath = await downloadToTemp(src, downloadDir);
     } catch {
@@ -38641,7 +38949,7 @@ async function resolveMediaDuration(src, mediaStart, baseDir, downloadDir, tagNa
   } else if (!filePath.startsWith("/")) {
     filePath = join38(baseDir, filePath);
   }
-  if (!existsSync34(filePath)) {
+  if (!existsSync35(filePath)) {
     return { duration: 0, resolvedPath: filePath };
   }
   let metadata;
@@ -38719,10 +39027,10 @@ async function parseSubCompositions(html, projectDir, downloadDir, parentOffset
     if (visited.has(filePath)) {
       continue;
     }
-    if (!existsSync34(filePath)) {
+    if (!existsSync35(filePath)) {
       continue;
     }
-    const rawSubHtml = readFileSync24(filePath, "utf-8");
+    const rawSubHtml = readFileSync26(filePath, "utf-8");
     const nestedVisited = new Set(visited);
     nestedVisited.add(filePath);
     workItems.push({ srcPath, absoluteStart, absoluteEnd, filePath, rawSubHtml, nestedVisited });
@@ -38907,8 +39215,8 @@ function inlineSubCompositions2(html, subCompositions, projectDir) {
         let compHtml = subCompositions.get(srcPath) || null;
         if (!compHtml) {
           const filePath = resolve19(projectDir, srcPath);
-          if (existsSync34(filePath)) {
-            compHtml = readFileSync24(filePath, "utf-8");
+          if (existsSync35(filePath)) {
+            compHtml = readFileSync26(filePath, "utf-8");
           }
         }
         return compHtml;
@@ -39065,7 +39373,7 @@ function collectExternalAssets(html, projectDir) {
     if (isPathInside2(absPath, absProjectDir)) {
       return null;
     }
-    if (!existsSync34(absPath)) return null;
+    if (!existsSync35(absPath)) return null;
     const safeKey = toExternalAssetKey(absPath);
     externalAssets.set(safeKey, absPath);
     return safeKey;
@@ -39115,7 +39423,7 @@ function rewriteUnresolvableGsapToCdn(html, projectDir) {
     (full, prefix, src, file, suffix) => {
       if (/^https?:\/\//i.test(src)) return full;
       const absPath = resolve19(projectDir, src);
-      if (existsSync34(absPath)) return full;
+      if (existsSync35(absPath)) return full;
       console.log(
         `[Compiler] Rewriting missing gsap script to CDN: ${src} \u2192 ${GSAP_CDN_BASE}${file}`
       );
@@ -39124,7 +39432,7 @@ function rewriteUnresolvableGsapToCdn(html, projectDir) {
   );
 }
 async function compileForRender(projectDir, htmlPath, downloadDir, options = {}) {
-  const rawHtml = rewriteUnresolvableGsapToCdn(readFileSync24(htmlPath, "utf-8"), projectDir);
+  const rawHtml = rewriteUnresolvableGsapToCdn(readFileSync26(htmlPath, "utf-8"), projectDir);
   const { html: compiledHtml, unresolvedCompositions } = await compileHtmlFile(
     rawHtml,
     projectDir,
@@ -39746,7 +40054,7 @@ var init_probeStage = __esm({
 });
 
 // ../producer/src/services/render/stages/extractVideosStage.ts
-import { existsSync as existsSync35 } from "fs";
+import { existsSync as existsSync36 } from "fs";
 import { isAbsolute as isAbsolute7, join as join41 } from "path";
 async function runExtractVideosStage(input) {
   const {
@@ -39770,7 +40078,7 @@ async function runExtractVideosStage(input) {
     await Promise.all(
       composition.videos.map(async (v2) => {
         const videoPath = isAbsolute7(v2.src) ? v2.src : resolveProjectRelativeSrc(v2.src, projectDir, compiledDir);
-        if (!existsSync35(videoPath)) return;
+        if (!existsSync36(videoPath)) return;
         const meta = await extractMediaMetadata(videoPath);
         if (isHdrColorSpace(meta.colorSpace)) {
           nativeHdrVideoIds.add(v2.id);
@@ -39788,10 +40096,10 @@ async function runExtractVideosStage(input) {
       composition.images.map(async (img) => {
         let imgPath = img.src;
         if (!imgPath.startsWith("/")) {
-          const fromCompiled = existsSync35(join41(compiledDir, imgPath)) ? join41(compiledDir, imgPath) : join41(projectDir, imgPath);
+          const fromCompiled = existsSync36(join41(compiledDir, imgPath)) ? join41(compiledDir, imgPath) : join41(projectDir, imgPath);
           imgPath = fromCompiled;
         }
-        if (!existsSync35(imgPath)) return null;
+        if (!existsSync36(imgPath)) return null;
         const meta = await extractMediaMetadata(imgPath);
         if (isHdrColorSpace(meta.colorSpace)) {
           nativeHdrImageIds.add(img.id);
@@ -40266,7 +40574,7 @@ var init_hdrImageTransferCache = __esm({
 });
 
 // ../producer/src/services/render/stages/captureHdrResources.ts
-import { mkdirSync as mkdirSync21, openSync, readFileSync as readFileSync25, statSync as statSync11 } from "fs";
+import { mkdirSync as mkdirSync21, openSync, readFileSync as readFileSync27, statSync as statSync11 } from "fs";
 import { join as join43 } from "path";
 function planHdrResources(args) {
   const { composition, nativeHdrVideoIds, nativeHdrImageIds, projectDir, compiledDir } = args;
@@ -40411,7 +40719,7 @@ function decodeHdrImageBuffers(args) {
   const out = /* @__PURE__ */ new Map();
   for (const [imageId, srcPath] of hdrImageSrcPaths) {
     try {
-      const decoded = decodePngToRgb48le(readFileSync25(srcPath));
+      const decoded = decodePngToRgb48le(readFileSync27(srcPath));
       const layout2 = prep.hdrExtractionDims.get(imageId);
       const fitInfo = prep.hdrImageFitInfo.get(imageId);
       if (layout2 && (layout2.width !== decoded.width || layout2.height !== decoded.height)) {
@@ -40849,7 +41157,7 @@ import { Worker } from "worker_threads";
 import { fileURLToPath as fileURLToPath3, pathToFileURL } from "url";
 import { dirname as dirname14, join as join45 } from "path";
 import { createRequire } from "module";
-import { existsSync as existsSync36 } from "fs";
+import { existsSync as existsSync37 } from "fs";
 import { cpus as cpus3 } from "os";
 function resolveWorkerEntry(explicit) {
   if (explicit && explicit.length > 0) {
@@ -40862,7 +41170,7 @@ function resolveWorkerEntry(explicit) {
   }
   const moduleDir = dirname14(fileURLToPath3(import.meta.url));
   const jsPath = join45(moduleDir, "shaderTransitionWorker.js");
-  if (existsSync36(jsPath)) return { path: jsPath, isTs: false };
+  if (existsSync37(jsPath)) return { path: jsPath, isTs: false };
   const tsPath = join45(moduleDir, "shaderTransitionWorker.ts");
   return { path: tsPath, isTs: true };
 }
@@ -41271,7 +41579,7 @@ var init_captureHdrHybridLoop = __esm({
 });
 
 // ../producer/src/services/render/stages/captureHdrStage.ts
-import { existsSync as existsSync37, mkdirSync as mkdirSync22 } from "fs";
+import { existsSync as existsSync38, mkdirSync as mkdirSync22 } from "fs";
 import { join as join47 } from "path";
 async function runCaptureHdrStage(input) {
   const {
@@ -41328,7 +41636,7 @@ async function runCaptureHdrStage(input) {
     nativeHdrImageIds,
     projectDir,
     compiledDir,
-    existsSync: existsSync37
+    existsSync: existsSync38
   });
   const domSession = await createCaptureSession(
     fileServer.url,
@@ -41432,7 +41740,7 @@ async function runCaptureHdrStage(input) {
       }
       const debugDumpEnabled = process.env.KEEP_TEMP === "1";
       const debugDumpDir = debugDumpEnabled ? join47(framesDir, "debug-composite") : null;
-      if (debugDumpDir && !existsSync37(debugDumpDir)) {
+      if (debugDumpDir && !existsSync38(debugDumpDir)) {
         mkdirSync22(debugDumpDir, { recursive: true });
       }
       const compositeTransfer = resolveCompositeTransfer(hasHdrContent, effectiveHdr);
@@ -41588,7 +41896,7 @@ var init_captureHdrStage = __esm({
 });
 
 // ../producer/src/services/render/stages/encodeStage.ts
-import { copyFileSync as copyFileSync3, existsSync as existsSync38, mkdirSync as mkdirSync23, readdirSync as readdirSync15 } from "fs";
+import { copyFileSync as copyFileSync3, existsSync as existsSync39, mkdirSync as mkdirSync23, readdirSync as readdirSync15 } from "fs";
 import { join as join48 } from "path";
 async function runEncodeStage(input) {
   const {
@@ -41615,7 +41923,7 @@ async function runEncodeStage(input) {
   const stage5Start = Date.now();
   if (isPngSequence) {
     updateJobStatus(job, "encoding", "Writing PNG sequence", 75, onProgress);
-    if (!existsSync38(outputPath)) mkdirSync23(outputPath, { recursive: true });
+    if (!existsSync39(outputPath)) mkdirSync23(outputPath, { recursive: true });
     const captured = readdirSync15(framesDir).filter((name) => name.endsWith(".png")).sort();
     if (captured.length === 0) {
       throw new Error(
@@ -41626,7 +41934,7 @@ async function runEncodeStage(input) {
       const dst = join48(outputPath, `frame_${String(i2 + 1).padStart(6, "0")}.png`);
       copyFileSync3(join48(framesDir, name), dst);
     });
-    if (hasAudio && audioOutputPath && existsSync38(audioOutputPath)) {
+    if (hasAudio && audioOutputPath && existsSync39(audioOutputPath)) {
       copyFileSync3(audioOutputPath, join48(outputPath, "audio.aac"));
       log2.info(`[Render] png-sequence: audio.aac sidecar written to ${outputPath}/audio.aac`);
     }
@@ -41718,9 +42026,9 @@ var init_assembleStage = __esm({
 
 // ../producer/src/services/renderOrchestrator.ts
 import {
-  existsSync as existsSync39,
+  existsSync as existsSync40,
   mkdirSync as mkdirSync24,
-  readFileSync as readFileSync26,
+  readFileSync as readFileSync28,
   readSync,
   closeSync,
   readdirSync as readdirSync16,
@@ -41833,7 +42141,7 @@ function findMissingFrameRanges(totalFrames, framesDir, frameExt) {
   let rangeStart = null;
   for (let frameIndex = 0; frameIndex < totalFrames; frameIndex++) {
     const framePath = join49(framesDir, `frame_${String(frameIndex).padStart(6, "0")}.${frameExt}`);
-    const missing = !existsSync39(framePath);
+    const missing = !existsSync40(framePath);
     if (missing && rangeStart === null) {
       rangeStart = frameIndex;
     } else if (!missing && rangeStart !== null) {
@@ -41875,7 +42183,7 @@ function countCapturedFrames(totalFrames, framesDir, frameExt) {
   let captured = 0;
   for (let frameIndex = 0; frameIndex < totalFrames; frameIndex++) {
     const framePath = join49(framesDir, `frame_${String(frameIndex).padStart(6, "0")}.${frameExt}`);
-    if (existsSync39(framePath)) captured++;
+    if (existsSync40(framePath)) captured++;
   }
   return captured;
 }
@@ -42446,28 +42754,28 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
     };
     job.startedAt = /* @__PURE__ */ new Date();
     assertNotAborted();
-    if (!existsSync39(workDir)) mkdirSync24(workDir, { recursive: true });
+    if (!existsSync40(workDir)) mkdirSync24(workDir, { recursive: true });
     if (job.config.debug) {
       const logPath = join49(workDir, "render.log");
       restoreLogger = installDebugLogger(logPath, log2);
     }
     const entryFile = job.config.entryFile || "index.html";
     let htmlPath = join49(projectDir, entryFile);
-    if (!existsSync39(htmlPath)) {
+    if (!existsSync40(htmlPath)) {
       throw new Error(`Entry file not found: ${htmlPath}`);
     }
     assertNotAborted();
-    const rawEntry = readFileSync26(htmlPath, "utf-8");
+    const rawEntry = readFileSync28(htmlPath, "utf-8");
     if (entryFile !== "index.html" && rawEntry.trimStart().startsWith("<template")) {
       const wrapperPath = join49(workDir, "standalone-entry.html");
       const projectIndexPath = join49(projectDir, "index.html");
-      if (!existsSync39(projectIndexPath)) {
+      if (!existsSync40(projectIndexPath)) {
         throw new Error(
           `Template entry file "${entryFile}" requires a project index.html to extract its render shell.`
         );
       }
       const standaloneHtml = extractStandaloneEntryFromIndex(
-        readFileSync26(projectIndexPath, "utf-8"),
+        readFileSync28(projectIndexPath, "utf-8"),
         entryFile
       );
       if (!standaloneHtml) {
@@ -42578,7 +42886,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
       assertNotAborted();
     }
     const framesDir = join49(workDir, "captured-frames");
-    if (!existsSync39(framesDir)) mkdirSync24(framesDir, { recursive: true });
+    if (!existsSync40(framesDir)) mkdirSync24(framesDir, { recursive: true });
     const captureOptions = {
       width,
       height,
@@ -42833,7 +43141,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
     job.outputPath = outputPath;
     updateJobStatus(job, "complete", "Render complete", 100, onProgress);
     const totalElapsed = Date.now() - pipelineStart;
-    const tmpPeakBytes = existsSync39(workDir) ? sampleDirectoryBytes(workDir) : 0;
+    const tmpPeakBytes = existsSync40(workDir) ? sampleDirectoryBytes(workDir) : 0;
     const perfSummary = buildRenderPerfSummary({
       job,
       workerCount,
@@ -42868,7 +43176,7 @@ async function executeRenderJob(job, projectDir, outputPath, onProgress, abortSi
       }
     }
     if (job.config.debug) {
-      if (!isPngSequence && existsSync39(outputPath)) {
+      if (!isPngSequence && existsSync40(outputPath)) {
         const debugOutput = join49(workDir, `output${videoExt}`);
         copyFileSync4(outputPath, debugOutput);
       }
@@ -42995,7 +43303,7 @@ var init_config3 = __esm({
 });
 
 // ../producer/src/services/hyperframeLint.ts
-import { existsSync as existsSync40, readFileSync as readFileSync27, statSync as statSync13 } from "fs";
+import { existsSync as existsSync41, readFileSync as readFileSync29, statSync as statSync13 } from "fs";
 import { resolve as resolve21, join as join50 } from "path";
 function isStringRecord(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
@@ -43024,7 +43332,7 @@ function pickEntryFile(files, preferredEntryFile) {
 }
 function readProjectEntryFile(projectDir, preferredEntryFile) {
   const absProjectDir = resolve21(projectDir);
-  if (!existsSync40(absProjectDir) || !statSync13(absProjectDir).isDirectory()) {
+  if (!existsSync41(absProjectDir) || !statSync13(absProjectDir).isDirectory()) {
     return { error: `Project directory not found: ${absProjectDir}` };
   }
   const entryCandidates = [preferredEntryFile, "index.html", "src/index.html"].filter(
@@ -43035,10 +43343,10 @@ function readProjectEntryFile(projectDir, preferredEntryFile) {
     if (!absoluteEntryPath.startsWith(absProjectDir)) {
       return { error: `Entry file must stay inside project directory: ${entryFile}` };
     }
-    if (existsSync40(absoluteEntryPath) && statSync13(absoluteEntryPath).isFile()) {
+    if (existsSync41(absoluteEntryPath) && statSync13(absoluteEntryPath).isFile()) {
       return {
         entryFile,
-        html: readFileSync27(absoluteEntryPath, "utf-8"),
+        html: readFileSync29(absoluteEntryPath, "utf-8"),
         source: "projectDir"
       };
     }
@@ -43133,7 +43441,7 @@ var init_semaphore = __esm({
 
 // ../producer/src/server.ts
 import {
-  existsSync as existsSync41,
+  existsSync as existsSync42,
   mkdirSync as mkdirSync25,
   statSync as statSync14,
   mkdtempSync as mkdtempSync2,
@@ -43166,11 +43474,11 @@ async function prepareRenderBody(body) {
   const projectDir = typeof body.projectDir === "string" ? body.projectDir : void 0;
   if (projectDir) {
     const absProjectDir = resolve22(projectDir);
-    if (!existsSync41(absProjectDir) || !statSync14(absProjectDir).isDirectory()) {
+    if (!existsSync42(absProjectDir) || !statSync14(absProjectDir).isDirectory()) {
       return { error: `Project directory not found: ${absProjectDir}` };
     }
     const entry = options.entryFile || "index.html";
-    if (!existsSync41(resolve22(absProjectDir, entry))) {
+    if (!existsSync42(resolve22(absProjectDir, entry))) {
       return { error: `Entry file "${entry}" not found in project directory: ${absProjectDir}` };
     }
     return { prepared: { input: { projectDir: absProjectDir, ...options } } };
@@ -43319,8 +43627,8 @@ function createRenderHandlers(options = {}) {
       log2
     );
     const outputDir = dirname16(absoluteOutputPath);
-    if (!existsSync41(outputDir)) mkdirSync25(outputDir, { recursive: true });
-    const release2 = await renderSemaphore.acquire();
+    if (!existsSync42(outputDir)) mkdirSync25(outputDir, { recursive: true });
+    const release4 = await renderSemaphore.acquire();
     log2.info("render started", {
       requestId,
       projectDir: input.projectDir,
@@ -43346,7 +43654,7 @@ function createRenderHandlers(options = {}) {
           log2.info(`render progress ${pct}%`, { requestId, stage: j3.currentStage, message });
         }
       });
-      const fileSize = existsSync41(absoluteOutputPath) ? statSync14(absoluteOutputPath).size : 0;
+      const fileSize = existsSync42(absoluteOutputPath) ? statSync14(absoluteOutputPath).size : 0;
       const durationMs = Date.now() - t0;
       const outputToken = store.register(absoluteOutputPath);
       const outputUrl = `${outputUrlPrefix}/${outputToken}`;
@@ -43388,7 +43696,7 @@ function createRenderHandlers(options = {}) {
         500
       );
     } finally {
-      release2();
+      release4();
       cleanupTempDir(cleanupProjectDir, log2);
     }
   };
@@ -43430,7 +43738,7 @@ function createRenderHandlers(options = {}) {
         log2
       );
       const outputDir = dirname16(absoluteOutputPath);
-      if (!existsSync41(outputDir)) mkdirSync25(outputDir, { recursive: true });
+      if (!existsSync42(outputDir)) mkdirSync25(outputDir, { recursive: true });
       log2.info("render-stream started", { requestId, projectDir: input.projectDir });
       const job = createRenderJob({
         fps: input.fps,
@@ -43454,7 +43762,7 @@ function createRenderHandlers(options = {}) {
           })
         });
       }
-      const release2 = await renderSemaphore.acquire();
+      const release4 = await renderSemaphore.acquire();
       try {
         await executeRenderJob(
           job,
@@ -43475,7 +43783,7 @@ function createRenderHandlers(options = {}) {
           },
           abortController.signal
         );
-        const fileSize = existsSync41(absoluteOutputPath) ? statSync14(absoluteOutputPath).size : 0;
+        const fileSize = existsSync42(absoluteOutputPath) ? statSync14(absoluteOutputPath).size : 0;
         const outputToken = store.register(absoluteOutputPath);
         const outputUrl = `${outputUrlPrefix}/${outputToken}`;
         log2.info("render-stream completed", { requestId, fileSize, perf: job.perfSummary ?? null });
@@ -43522,7 +43830,7 @@ function createRenderHandlers(options = {}) {
           })
         });
       } finally {
-        release2();
+        release4();
         c3.req.raw.signal.removeEventListener("abort", onRequestAbort);
         cleanupTempDir(cleanupProjectDir, log2);
       }
@@ -43534,7 +43842,7 @@ function createRenderHandlers(options = {}) {
     if (!artifact) {
       return c3.json({ success: false, error: "Output artifact not found or expired" }, 404);
     }
-    if (!existsSync41(artifact.path)) {
+    if (!existsSync42(artifact.path)) {
       store.delete(token);
       return c3.json({ success: false, error: "Output artifact file missing" }, 404);
     }
@@ -43688,7 +43996,7 @@ var init_planHash = __esm({
 });
 
 // ../producer/src/services/render/stages/freezePlan.ts
-import { existsSync as existsSync42, mkdirSync as mkdirSync26, readFileSync as readFileSync28, readdirSync as readdirSync17, writeFileSync as writeFileSync20 } from "fs";
+import { existsSync as existsSync43, mkdirSync as mkdirSync26, readFileSync as readFileSync30, readdirSync as readdirSync17, writeFileSync as writeFileSync20 } from "fs";
 import { join as join52, relative as relative5, resolve as resolve23 } from "path";
 function stripUndefined(value) {
   if (Array.isArray(value)) return value.map(stripUndefined);
@@ -43731,11 +44039,11 @@ function collectPlanAssetShas(planDir) {
   const assets = [];
   for (const file of files) {
     if (file.planRelativePath === COMPILED_INDEX_RELATIVE_PATH) {
-      compositionHtml = readFileSync28(file.absolutePath);
+      compositionHtml = readFileSync30(file.absolutePath);
       continue;
     }
     if (HASH_EXCLUDED_PLAN_FILES.has(file.planRelativePath)) continue;
-    const bytes = readFileSync28(file.absolutePath);
+    const bytes = readFileSync30(file.absolutePath);
     assets.push({ path: file.planRelativePath, sha256: sha256Hex(bytes) });
   }
   if (compositionHtml === null) {
@@ -43748,14 +44056,14 @@ function collectPlanAssetShas(planDir) {
 function recomputePlanHashFromPlanDir(planDir) {
   const planJsonPath = join52(planDir, "plan.json");
   const encoderJsonPath = join52(planDir, "meta", "encoder.json");
-  if (!existsSync42(planJsonPath)) {
+  if (!existsSync43(planJsonPath)) {
     throw new Error(`[freezePlan] plan.json missing: ${planJsonPath}`);
   }
-  if (!existsSync42(encoderJsonPath)) {
+  if (!existsSync43(encoderJsonPath)) {
     throw new Error(`[freezePlan] meta/encoder.json missing: ${encoderJsonPath}`);
   }
-  const planJson = JSON.parse(readFileSync28(planJsonPath, "utf-8"));
-  const encoderConfigCanonicalJson = readFileSync28(encoderJsonPath, "utf-8");
+  const planJson = JSON.parse(readFileSync30(planJsonPath, "utf-8"));
+  const encoderConfigCanonicalJson = readFileSync30(encoderJsonPath, "utf-8");
   const { compositionHtml, assets } = collectPlanAssetShas(planDir);
   return computePlanHash({
     compositionHtml,
@@ -43780,11 +44088,11 @@ async function freezePlan(input) {
     totalFrames,
     hasAudio
   } = input;
-  if (!existsSync42(planDir)) {
+  if (!existsSync43(planDir)) {
     throw new Error(`[freezePlan] planDir does not exist: ${planDir}`);
   }
   const metaDir = join52(planDir, "meta");
-  if (!existsSync42(metaDir)) mkdirSync26(metaDir, { recursive: true });
+  if (!existsSync43(metaDir)) mkdirSync26(metaDir, { recursive: true });
   writeFileSync20(
     join52(metaDir, "composition.json"),
     `${JSON.stringify(composition, null, 2)}
@@ -43926,7 +44234,7 @@ var init_runtimeEnvSnapshot = __esm({
 // ../producer/src/services/distributed/shared.ts
 import { execFile as execFileCallback } from "child_process";
 import { dirname as dirname17, join as join53 } from "path";
-import { existsSync as existsSync43, readFileSync as readFileSync29 } from "fs";
+import { existsSync as existsSync44, readFileSync as readFileSync31 } from "fs";
 import { fileURLToPath as fileURLToPath5 } from "url";
 import { promisify as promisify2 } from "util";
 async function readFfmpegVersion() {
@@ -43964,9 +44272,9 @@ function readProducerVersion() {
   let current = startDir;
   for (let i2 = 0; i2 < 10; i2++) {
     const candidate = join53(current, "package.json");
-    if (existsSync43(candidate)) {
+    if (existsSync44(candidate)) {
       try {
-        const pkg = JSON.parse(readFileSync29(candidate, "utf-8"));
+        const pkg = JSON.parse(readFileSync31(candidate, "utf-8"));
         if (pkg.name === "@hyperframes/producer" && typeof pkg.version === "string") {
           cachedProducerVersion = pkg.version;
           return pkg.version;
@@ -43997,7 +44305,7 @@ var init_shared2 = __esm({
 // ../producer/src/services/distributed/plan.ts
 import {
   cpSync as cpSync2,
-  existsSync as existsSync44,
+  existsSync as existsSync45,
   mkdirSync as mkdirSync27,
   readdirSync as readdirSync18,
   renameSync as renameSync3,
@@ -44162,7 +44470,7 @@ async function plan(projectDir, config, planDir) {
     useGpu: false,
     browserGpuMode: "software"
   });
-  if (!existsSync44(planDir)) mkdirSync27(planDir, { recursive: true });
+  if (!existsSync45(planDir)) mkdirSync27(planDir, { recursive: true });
   const log2 = config.logger ?? defaultLogger;
   const abortSignal = config.abortSignal;
   const assertNotAborted = () => {
@@ -44191,11 +44499,11 @@ async function plan(projectDir, config, planDir) {
   });
   const entryFile = config.entryFile ?? "index.html";
   const htmlPath = join54(projectDir, entryFile);
-  if (!existsSync44(htmlPath)) {
+  if (!existsSync45(htmlPath)) {
     throw new Error(`[plan] entry file not found: ${htmlPath}`);
   }
   const workDir = join54(planDir, ".plan-work");
-  if (!existsSync44(workDir)) mkdirSync27(workDir, { recursive: true });
+  if (!existsSync45(workDir)) mkdirSync27(workDir, { recursive: true });
   const compiledDir = join54(workDir, "compiled");
   mkdirSync27(compiledDir, { recursive: true });
   cpSync2(projectDir, compiledDir, {
@@ -44281,13 +44589,13 @@ async function plan(projectDir, config, planDir) {
   });
   const stagedVideoFrames = join54(compiledDir, "__hyperframes_video_frames");
   const videoFramesDst = join54(planDir, "video-frames");
-  if (existsSync44(videoFramesDst)) rmSync11(videoFramesDst, { recursive: true, force: true });
-  if (existsSync44(stagedVideoFrames)) {
+  if (existsSync45(videoFramesDst)) rmSync11(videoFramesDst, { recursive: true, force: true });
+  if (existsSync45(stagedVideoFrames)) {
     renameSync3(stagedVideoFrames, videoFramesDst);
   } else {
     mkdirSync27(videoFramesDst, { recursive: true });
   }
-  if (existsSync44(finalCompiledDir)) rmSync11(finalCompiledDir, { recursive: true, force: true });
+  if (existsSync45(finalCompiledDir)) rmSync11(finalCompiledDir, { recursive: true, force: true });
   renameSync3(compiledDir, finalCompiledDir);
   const planVideosJson = {
     videos: composition.videos,
@@ -44307,7 +44615,7 @@ async function plan(projectDir, config, planDir) {
     "utf-8"
   );
   const planAudioPath = join54(planDir, "audio.aac");
-  if (audioResult.hasAudio && existsSync44(audioResult.audioOutputPath)) {
+  if (audioResult.hasAudio && existsSync45(audioResult.audioOutputPath)) {
     renameSync3(audioResult.audioOutputPath, planAudioPath);
   }
   const maxParallel = config.maxParallelChunks ?? DEFAULT_MAX_PARALLEL_CHUNKS;
@@ -44446,13 +44754,13 @@ var init_plan = __esm({
 
 // ../producer/src/services/distributed/renderChunk.ts
 import { randomBytes } from "crypto";
-import { existsSync as existsSync45, mkdirSync as mkdirSync28, readFileSync as readFileSync30, readdirSync as readdirSync19, rmSync as rmSync12, writeFileSync as writeFileSync22 } from "fs";
+import { existsSync as existsSync46, mkdirSync as mkdirSync28, readFileSync as readFileSync32, readdirSync as readdirSync19, rmSync as rmSync12, writeFileSync as writeFileSync22 } from "fs";
 import { extname as extname9, join as join55 } from "path";
 function rebuildExtractedFramesFromPlanDir(planDir, videos) {
   const result = [];
   for (const v2 of videos) {
     const outputDir = join55(planDir, "video-frames", v2.videoId);
-    if (!existsSync45(outputDir)) {
+    if (!existsSync46(outputDir)) {
       throw new Error(
         `[renderChunk] planDir missing extracted video frames for ${JSON.stringify(v2.videoId)}: ${outputDir} not present. plan() should have written frames here; the planDir is malformed.`
       );
@@ -44485,10 +44793,10 @@ function rebuildExtractedFramesFromPlanDir(planDir, videos) {
   return result;
 }
 function hashChunkOutput(outputPath, kind) {
-  if (kind === "file") return sha256Hex(readFileSync30(outputPath));
+  if (kind === "file") return sha256Hex(readFileSync32(outputPath));
   const entries2 = readdirSync19(outputPath).filter((name) => /\.(png|jpg|jpeg)$/i.test(name)).sort();
   const lines = entries2.map(
-    (name) => `${name}\0${sha256Hex(readFileSync30(join55(outputPath, name)))}`
+    (name) => `${name}\0${sha256Hex(readFileSync32(join55(outputPath, name)))}`
   );
   return sha256Hex(lines.join("\0"));
 }
@@ -44505,21 +44813,21 @@ async function renderChunk(planDir, chunkIndex, outputChunkPath) {
   const encoderJsonPath = join55(planDir, "meta", "encoder.json");
   const chunksJsonPath = join55(planDir, "meta", "chunks.json");
   for (const required of [planJsonPath, encoderJsonPath, chunksJsonPath]) {
-    if (!existsSync45(required)) {
+    if (!existsSync46(required)) {
       throw new RenderChunkValidationError(
         MISSING_PLAN_ARTIFACT,
         `[renderChunk] planDir is missing required artifact: ${required}`
       );
     }
   }
-  const plan2 = JSON.parse(readFileSync30(planJsonPath, "utf-8"));
-  const encoder = JSON.parse(readFileSync30(encoderJsonPath, "utf-8"));
-  const chunks = JSON.parse(readFileSync30(chunksJsonPath, "utf-8"));
+  const plan2 = JSON.parse(readFileSync32(planJsonPath, "utf-8"));
+  const encoder = JSON.parse(readFileSync32(encoderJsonPath, "utf-8"));
+  const chunks = JSON.parse(readFileSync32(chunksJsonPath, "utf-8"));
   const videosJsonPath = join55(planDir, PLAN_VIDEOS_META_RELATIVE_PATH);
   let planVideos = null;
-  if (existsSync45(videosJsonPath)) {
+  if (existsSync46(videosJsonPath)) {
     try {
-      planVideos = JSON.parse(readFileSync30(videosJsonPath, "utf-8"));
+      planVideos = JSON.parse(readFileSync32(videosJsonPath, "utf-8"));
     } catch (err) {
       throw new RenderChunkValidationError(
         MISSING_PLAN_ARTIFACT,
@@ -44545,7 +44853,7 @@ async function renderChunk(planDir, chunkIndex, outputChunkPath) {
     );
   }
   const compiledDir = join55(planDir, "compiled");
-  if (!existsSync45(compiledDir)) {
+  if (!existsSync46(compiledDir)) {
     throw new RenderChunkValidationError(
       MISSING_PLAN_ARTIFACT,
       `[renderChunk] planDir missing compiled/ directory: ${compiledDir}`
@@ -44669,10 +44977,10 @@ async function renderChunk(planDir, chunkIndex, outputChunkPath) {
       const effectiveBitrate = encoder.crf != null ? void 0 : encoder.bitrate;
       const videoOnlyPath = outputChunkPath;
       if (isPngSequence) {
-        if (!existsSync45(outputChunkPath)) mkdirSync28(outputChunkPath, { recursive: true });
+        if (!existsSync46(outputChunkPath)) mkdirSync28(outputChunkPath, { recursive: true });
       } else {
         const outDir = join55(outputChunkPath, "..");
-        if (!existsSync45(outDir)) mkdirSync28(outDir, { recursive: true });
+        if (!existsSync46(outDir)) mkdirSync28(outDir, { recursive: true });
       }
       await runEncodeStage({
         job,
@@ -44993,9 +45301,9 @@ var init_audioPadTrim = __esm({
 // ../producer/src/services/distributed/assemble.ts
 import {
   cpSync as cpSync3,
-  existsSync as existsSync46,
+  existsSync as existsSync47,
   mkdirSync as mkdirSync29,
-  readFileSync as readFileSync31,
+  readFileSync as readFileSync33,
   readdirSync as readdirSync20,
   rmSync as rmSync13,
   statSync as statSync16,
@@ -45008,32 +45316,32 @@ async function assemble(planDir, chunkPaths, audioPath, outputPath, options) {
   const abortSignal = options?.abortSignal;
   const planJsonPath = join56(planDir, "plan.json");
   const chunksJsonPath = join56(planDir, "meta", "chunks.json");
-  if (!existsSync46(planJsonPath)) {
+  if (!existsSync47(planJsonPath)) {
     throw new Error(`[assemble] planDir missing plan.json: ${planJsonPath}`);
   }
-  if (!existsSync46(chunksJsonPath)) {
+  if (!existsSync47(chunksJsonPath)) {
     throw new Error(`[assemble] planDir missing meta/chunks.json: ${chunksJsonPath}`);
   }
-  const plan2 = JSON.parse(readFileSync31(planJsonPath, "utf-8"));
-  const chunks = JSON.parse(readFileSync31(chunksJsonPath, "utf-8"));
+  const plan2 = JSON.parse(readFileSync33(planJsonPath, "utf-8"));
+  const chunks = JSON.parse(readFileSync33(chunksJsonPath, "utf-8"));
   if (chunkPaths.length !== chunks.length) {
     throw new Error(
       `[assemble] chunkPaths length (${chunkPaths.length}) does not match chunks.json length (${chunks.length}). Adapters must pass one path per chunk, ordered by index.`
     );
   }
   for (const path2 of chunkPaths) {
-    if (!existsSync46(path2)) {
+    if (!existsSync47(path2)) {
       throw new Error(`[assemble] chunk path does not exist: ${path2}`);
     }
   }
   if (plan2.dimensions.format === "png-sequence") {
     return mergePngFrameDirs(chunkPaths, outputPath, plan2.totalFrames, audioPath, start);
   }
-  if (!existsSync46(dirname18(outputPath))) {
+  if (!existsSync47(dirname18(outputPath))) {
     mkdirSync29(dirname18(outputPath), { recursive: true });
   }
   const workDir = `${outputPath}.assemble-work`;
-  if (existsSync46(workDir)) rmSync13(workDir, { recursive: true, force: true });
+  if (existsSync47(workDir)) rmSync13(workDir, { recursive: true, force: true });
   mkdirSync29(workDir, { recursive: true });
   try {
     const concatListPath = join56(workDir, "concat-list.txt");
@@ -45060,7 +45368,7 @@ async function assemble(planDir, chunkPaths, audioPath, outputPath, options) {
       );
     }
     let audioForMux = null;
-    if (audioPath !== null && existsSync46(audioPath)) {
+    if (audioPath !== null && existsSync47(audioPath)) {
       const paddedAudioPath = join56(workDir, "audio-padded.aac");
       const padTrimResult = await padOrTrimAudioToVideoFrameCount({
         videoPath: concatOutputPath,
@@ -45103,7 +45411,7 @@ async function assemble(planDir, chunkPaths, audioPath, outputPath, options) {
       });
     }
   }
-  const fileSize = existsSync46(outputPath) ? statSync16(outputPath).size : 0;
+  const fileSize = existsSync47(outputPath) ? statSync16(outputPath).size : 0;
   return {
     outputPath,
     durationMs: Date.now() - start,
@@ -45112,7 +45420,7 @@ async function assemble(planDir, chunkPaths, audioPath, outputPath, options) {
   };
 }
 function mergePngFrameDirs(chunkPaths, outputPath, totalFrames, audioPath, startTimeMs) {
-  if (existsSync46(outputPath)) rmSync13(outputPath, { recursive: true, force: true });
+  if (existsSync47(outputPath)) rmSync13(outputPath, { recursive: true, force: true });
   mkdirSync29(outputPath, { recursive: true });
   let globalIdx = 0;
   for (const chunkDir of chunkPaths) {
@@ -45136,7 +45444,7 @@ function mergePngFrameDirs(chunkPaths, outputPath, totalFrames, audioPath, start
       `[assemble] png-sequence frame count mismatch: merged ${globalIdx} frames vs plan.totalFrames=${totalFrames}. Using on-disk count.`
     );
   }
-  if (audioPath !== null && existsSync46(audioPath)) {
+  if (audioPath !== null && existsSync47(audioPath)) {
     const sidecar = join56(outputPath, "audio.aac");
     cpSync3(audioPath, sidecar);
   }
@@ -45224,12 +45532,13 @@ var init_src3 = __esm({
 // src/server/studioServer.ts
 var studioServer_exports = {};
 __export(studioServer_exports, {
+  closeThumbnailBrowser: () => closeThumbnailBrowser,
   createStudioServer: () => createStudioServer,
   resolveStudioBundle: () => resolveStudioBundle
 });
 import { Hono as Hono5 } from "hono";
 import { streamSSE as streamSSE3 } from "hono/streaming";
-import { existsSync as existsSync47, readFileSync as readFileSync32, writeFileSync as writeFileSync24, statSync as statSync17 } from "fs";
+import { existsSync as existsSync48, readFileSync as readFileSync34, writeFileSync as writeFileSync24, statSync as statSync17 } from "fs";
 import { resolve as resolve24, join as join57, basename as basename5 } from "path";
 function resolveDistDir() {
   return resolveStudioBundle().dir;
@@ -45237,12 +45546,12 @@ function resolveDistDir() {
 function resolveStudioBundle() {
   const builtPath = resolve24(__dirname, "studio");
   const builtIndex = resolve24(builtPath, "index.html");
-  if (existsSync47(builtIndex)) {
+  if (existsSync48(builtIndex)) {
     return { dir: builtPath, indexPath: builtIndex, available: true, checkedPaths: [builtIndex] };
   }
   const devPath = resolve24(__dirname, "..", "..", "..", "studio", "dist");
   const devIndex = resolve24(devPath, "index.html");
-  if (existsSync47(devIndex)) {
+  if (existsSync48(devIndex)) {
     return {
       dir: devPath,
       indexPath: devIndex,
@@ -45259,9 +45568,9 @@ function resolveStudioBundle() {
 }
 function resolveRuntimePath() {
   const builtPath = resolve24(__dirname, "hyperframe-runtime.js");
-  if (existsSync47(builtPath)) return builtPath;
+  if (existsSync48(builtPath)) return builtPath;
   const iifePath = resolve24(__dirname, "hyperframe.runtime.iife.js");
-  if (existsSync47(iifePath)) return iifePath;
+  if (existsSync48(iifePath)) return iifePath;
   const devPath = resolve24(
     __dirname,
     "..",
@@ -45271,14 +45580,14 @@ function resolveRuntimePath() {
     "dist",
     "hyperframe.runtime.iife.js"
   );
-  if (existsSync47(devPath)) return devPath;
+  if (existsSync48(devPath)) return devPath;
   return builtPath;
 }
 function readStudioManualEditManifestContent(projectDir) {
   const manifestPath = join57(projectDir, STUDIO_MANUAL_EDITS_PATH2);
-  if (!existsSync47(manifestPath)) return "";
+  if (!existsSync48(manifestPath)) return "";
   try {
-    return readFileSync32(manifestPath, "utf-8");
+    return readFileSync34(manifestPath, "utf-8");
   } catch {
     return "";
   }
@@ -45319,16 +45628,6 @@ async function getThumbnailBrowser() {
         _thumbnailBrowser = null;
         _thumbnailBrowserInitializing = null;
       });
-      const onExit = async () => {
-        const { releaseBrowser: releaseBrowser2 } = await Promise.resolve().then(() => (init_src2(), src_exports2));
-        if (_thumbnailBrowser) {
-          await releaseBrowser2(_thumbnailBrowser).catch(() => {
-          });
-          _thumbnailBrowser = null;
-        }
-      };
-      process.once("SIGTERM", () => void onExit());
-      process.once("SIGINT", () => void onExit());
       return _thumbnailBrowser;
     } catch (err) {
       console.warn(
@@ -45341,6 +45640,15 @@ async function getThumbnailBrowser() {
   })();
   return _thumbnailBrowserInitializing;
 }
+async function closeThumbnailBrowser() {
+  if (!_thumbnailBrowser) return;
+  const browser = _thumbnailBrowser;
+  _thumbnailBrowser = null;
+  _thumbnailBrowserInitializing = null;
+  const { releaseBrowser: releaseBrowser2 } = await Promise.resolve().then(() => (init_src2(), src_exports2));
+  await releaseBrowser2(browser).catch(() => {
+  });
+}
 function createStudioServer(options) {
   const { projectDir, projectName } = options;
   const projectId = projectName || basename5(projectDir);
@@ -45519,19 +45827,19 @@ function createStudioServer(options) {
     async installRegistryBlock(opts) {
       const { resolveItem: resolveItem2 } = await Promise.resolve().then(() => (init_resolver(), resolver_exports));
       const { installItem: installItem2 } = await Promise.resolve().then(() => (init_installer(), installer_exports));
-      const { readFileSync: readFileSync54, writeFileSync: writeFileSync39, existsSync: existsSync80 } = await import("fs");
-      const { join: join89 } = await import("path");
+      const { readFileSync: readFileSync57, writeFileSync: writeFileSync39, existsSync: existsSync81 } = await import("fs");
+      const { join: join90 } = await import("path");
       const item = await resolveItem2(opts.blockName);
       const { written } = await installItem2(item, { destDir: opts.project.dir });
-      const indexPath = join89(opts.project.dir, "index.html");
-      if (existsSync80(indexPath)) {
-        const indexHtml = readFileSync54(indexPath, "utf-8");
+      const indexPath = join90(opts.project.dir, "index.html");
+      if (existsSync81(indexPath)) {
+        const indexHtml = readFileSync57(indexPath, "utf-8");
         const hostW = indexHtml.match(/data-width="(\d+)"/)?.[1];
         const hostH = indexHtml.match(/data-height="(\d+)"/)?.[1];
         if (hostW && hostH) {
           for (const absPath of written) {
             if (!absPath.endsWith(".html")) continue;
-            let content = readFileSync54(absPath, "utf-8");
+            let content = readFileSync57(absPath, "utf-8");
             content = content.replace(
               /(<meta\s+name="viewport"\s+content="width=)\d+(,\s*height=)\d+/i,
               `$1${hostW}$2${hostH}`
@@ -45567,7 +45875,7 @@ function createStudioServer(options) {
   });
   app.get("/api/runtime.js", (c3) => {
     const serve4 = async () => {
-      const runtimeSource = await loadRuntimeSource() ?? (existsSync47(runtimePath) ? readFileSync32(runtimePath, "utf-8") : null);
+      const runtimeSource = await loadRuntimeSource() ?? (existsSync48(runtimePath) ? readFileSync34(runtimePath, "utf-8") : null);
       if (!runtimeSource) return c3.text("runtime not available", 404);
       return c3.body(runtimeSource, 200, {
         "Content-Type": "text/javascript",
@@ -45603,8 +45911,8 @@ function createStudioServer(options) {
   });
   const serveStudioStaticFile = (c3) => {
     const filePath = resolve24(studioDir, c3.req.path.slice(1));
-    if (!existsSync47(filePath) || !statSync17(filePath).isFile()) return c3.text("not found", 404);
-    const content = readFileSync32(filePath);
+    if (!existsSync48(filePath) || !statSync17(filePath).isFile()) return c3.text("not found", 404);
+    const content = readFileSync34(filePath);
     return new Response(content, {
       headers: { "Content-Type": getMimeType(filePath), "Cache-Control": "no-store" }
     });
@@ -45624,7 +45932,7 @@ function createStudioServer(options) {
   }
   app.get("*", (c3) => {
     const indexPath = resolve24(studioDir, "index.html");
-    if (!existsSync47(indexPath)) {
+    if (!existsSync48(indexPath)) {
       return c3.html(
         `<!doctype html>
 <html>
@@ -45680,7 +45988,7 @@ function createStudioServer(options) {
         500
       );
     }
-    let html = readFileSync32(indexPath, "utf-8");
+    let html = readFileSync34(indexPath, "utf-8");
     const envScript = buildRuntimeEnvScript();
     if (envScript) {
       html = html.replace("<head>", `<head>${envScript}`);
@@ -45712,7 +46020,7 @@ __export(preview_exports, {
   examples: () => examples
 });
 import { spawn as spawn11 } from "child_process";
-import { existsSync as existsSync48, lstatSync as lstatSync2, symlinkSync as symlinkSync2, unlinkSync as unlinkSync5, readlinkSync, mkdirSync as mkdirSync30 } from "fs";
+import { existsSync as existsSync49, lstatSync as lstatSync2, symlinkSync as symlinkSync2, unlinkSync as unlinkSync5, readlinkSync, mkdirSync as mkdirSync30 } from "fs";
 import { resolve as resolve25, dirname as dirname19, basename as basename6, join as join58 } from "path";
 import { fileURLToPath as fileURLToPath6 } from "url";
 import { createRequire as createRequire2 } from "module";
@@ -45725,7 +46033,7 @@ async function runDevMode(dir, options) {
   mkdirSync30(projectsDir, { recursive: true });
   let createdSymlink = false;
   if (dir !== symlinkPath) {
-    if (existsSync48(symlinkPath)) {
+    if (existsSync49(symlinkPath)) {
       try {
         const stat3 = lstatSync2(symlinkPath);
         if (stat3.isSymbolicLink()) {
@@ -45737,7 +46045,7 @@ async function runDevMode(dir, options) {
       } catch {
       }
     }
-    if (!existsSync48(symlinkPath)) {
+    if (!existsSync49(symlinkPath)) {
       symlinkSync2(dir, symlinkPath, "dir");
       createdSymlink = true;
     }
@@ -45783,11 +46091,16 @@ async function runDevMode(dir, options) {
   if (createdSymlink) {
     process.on("exit", () => {
       try {
-        if (existsSync48(symlinkPath)) unlinkSync5(symlinkPath);
+        if (existsSync49(symlinkPath)) unlinkSync5(symlinkPath);
       } catch {
       }
     });
   }
+  const shutdown = () => {
+    if (child.pid) killProcessTree(child.pid);
+  };
+  process.once("SIGINT", shutdown);
+  process.once("SIGTERM", shutdown);
   return new Promise((resolve46) => {
     child.on("close", () => resolve46());
   });
@@ -45810,12 +46123,12 @@ async function runLocalStudioMode(dir, options) {
   mkdirSync30(projectsDir, { recursive: true });
   let createdSymlink = false;
   if (dir !== symlinkPath) {
-    if (existsSync48(symlinkPath) && lstatSync2(symlinkPath).isSymbolicLink()) {
+    if (existsSync49(symlinkPath) && lstatSync2(symlinkPath).isSymbolicLink()) {
       if (resolve25(readlinkSync(symlinkPath)) !== resolve25(dir)) {
         unlinkSync5(symlinkPath);
       }
     }
-    if (!existsSync48(symlinkPath)) {
+    if (!existsSync49(symlinkPath)) {
       symlinkSync2(dir, symlinkPath, "dir");
       createdSymlink = true;
     }
@@ -45858,11 +46171,16 @@ async function runLocalStudioMode(dir, options) {
   if (createdSymlink) {
     process.on("exit", () => {
       try {
-        if (existsSync48(symlinkPath)) unlinkSync5(symlinkPath);
+        if (existsSync49(symlinkPath)) unlinkSync5(symlinkPath);
       } catch {
       }
     });
   }
+  const shutdown = () => {
+    if (child.pid) killProcessTree(child.pid);
+  };
+  process.once("SIGINT", shutdown);
+  process.once("SIGTERM", shutdown);
   return new Promise((resolve46) => {
     child.on("close", () => resolve46());
   });
@@ -45957,11 +46275,29 @@ async function runEmbeddedMode(dir, startPort, options) {
       rl?.close();
       console.log();
       console.log(`  ${c2.dim("Shutting down studio...")}`);
-      result.server.close(() => resolveRun());
-      setTimeout(() => process.exit(0), 2e3).unref();
+      setTimeout(() => process.exit(0), 3e3).unref();
+      const cleanup = async () => {
+        const { closeThumbnailBrowser: closeThumbnailBrowser2 } = await Promise.resolve().then(() => (init_studioServer(), studioServer_exports));
+        const { drainBrowserPool: drainBrowserPool2, killTrackedProcesses: killTrackedProcesses2 } = await Promise.resolve().then(() => (init_src2(), src_exports2));
+        killTrackedProcesses2();
+        await closeThumbnailBrowser2().catch(() => {
+        });
+        await drainBrowserPool2().catch(() => {
+        });
+      };
+      cleanup().catch(() => {
+      }).finally(() => {
+        result.server.close(() => resolveRun());
+      });
     };
     process.once("SIGINT", shutdown);
     process.once("SIGTERM", shutdown);
+    Promise.resolve().then(() => (init_src2(), src_exports2)).then(({ killTrackedProcesses: killTrackedProcesses2 }) => {
+      process.once("exit", () => {
+        if (!shuttingDown) killTrackedProcesses2();
+      });
+    }).catch(() => {
+    });
   });
 }
 var examples, preview_default;
@@ -45976,6 +46312,7 @@ var init_preview2 = __esm({
     init_lintProject();
     init_lintFormat();
     init_portUtils();
+    init_orphanCleanup();
     examples = [
       ["Preview the current project", "hyperframes preview"],
       ["Preview a specific project directory", "hyperframes preview ./my-video"],
@@ -46054,12 +46391,18 @@ var init_preview2 = __esm({
 `);
           return;
         }
+        const orphansKilled = killOrphanedProcesses();
+        if (orphansKilled > 0) {
+          console.log(
+            `  ${c2.dim(`Cleaned up ${orphansKilled} orphaned process${orphansKilled === 1 ? "" : "es"} from a previous session.`)}`
+          );
+        }
         const rawArg = args.dir;
         const dir = resolve25(rawArg ?? ".");
         const isImplicitCwd = !rawArg || rawArg === "." || rawArg === "./";
         const projectName = isImplicitCwd ? basename6(process.env.PWD ?? dir) : basename6(dir);
         const indexPath = join58(dir, "index.html");
-        if (existsSync48(indexPath)) {
+        if (existsSync49(indexPath)) {
           const project = { dir, name: projectName, indexPath };
           const lintResult = lintProject(project);
           if (lintResult.totalErrors > 0 || lintResult.totalWarnings > 0) {
@@ -46104,12 +46447,12 @@ __export(init_exports, {
   injectTailwindBrowserScript: () => injectTailwindBrowserScript
 });
 import {
-  existsSync as existsSync49,
+  existsSync as existsSync50,
   mkdirSync as mkdirSync31,
   copyFileSync as copyFileSync5,
   cpSync as cpSync4,
   writeFileSync as writeFileSync25,
-  readFileSync as readFileSync33,
+  readFileSync as readFileSync35,
   readdirSync as readdirSync21
 } from "fs";
 import { resolve as resolve26, basename as basename7, join as join59, dirname as dirname20 } from "path";
@@ -46184,7 +46527,7 @@ function resolveAssetDir(devSegments, builtSegments) {
   const base = dirname20(fileURLToPath7(import.meta.url));
   const devPath = resolve26(base, ...devSegments);
   const builtPath = resolve26(base, ...builtSegments);
-  return existsSync49(devPath) ? devPath : builtPath;
+  return existsSync50(devPath) ? devPath : builtPath;
 }
 function getStaticTemplateDir(templateId) {
   return resolveAssetDir(["..", "templates", templateId], ["templates", templateId]);
@@ -46212,7 +46555,7 @@ function buildPackageScripts() {
 }
 function writeDefaultPackageJson(destDir, projectName) {
   const packageJsonPath = resolve26(destDir, "package.json");
-  if (existsSync49(packageJsonPath)) return;
+  if (existsSync50(packageJsonPath)) return;
   writeFileSync25(
     packageJsonPath,
     `${JSON.stringify(
@@ -46274,14 +46617,14 @@ ${html}`;
 }
 function writeTailwindSupport(destDir) {
   for (const file of listHtmlFiles(destDir)) {
-    const html = readFileSync33(file, "utf-8");
+    const html = readFileSync35(file, "utf-8");
     writeFileSync25(file, injectTailwindBrowserScript(html), "utf-8");
   }
 }
 function patchVideoSrc(dir, videoFilename, durationSeconds) {
   const htmlFiles = readdirSync21(dir, { withFileTypes: true, recursive: true }).filter((e3) => e3.isFile() && e3.name.endsWith(".html")).map((e3) => join59(e3.parentPath, e3.name));
   for (const file of htmlFiles) {
-    let content = readFileSync33(file, "utf-8");
+    let content = readFileSync35(file, "utf-8");
     if (videoFilename) {
       content = content.replaceAll("__VIDEO_SRC__", videoFilename);
     } else {
@@ -46386,7 +46729,7 @@ async function handleVideoFile(videoPath, destDir, interactive) {
 function applyResolutionPreset(destDir, resolution) {
   const { width, height } = CANVAS_DIMENSIONS[resolution];
   for (const file of listHtmlFiles(destDir)) {
-    let html = readFileSync33(file, "utf-8");
+    let html = readFileSync35(file, "utf-8");
     let changed = false;
     const dataWidthRe = /(data-width=)["'](\d+)["']/g;
     if (dataWidthRe.test(html)) {
@@ -46434,7 +46777,7 @@ function applyResolutionPreset(destDir, resolution) {
 async function scaffoldProject(destDir, name, templateId, localVideoName, durationSeconds, tailwind = false, resolution) {
   mkdirSync31(destDir, { recursive: true });
   const templateDir = getStaticTemplateDir(templateId);
-  if (existsSync49(join59(templateDir, "index.html"))) {
+  if (existsSync50(join59(templateDir, "index.html"))) {
     cpSync4(templateDir, destDir, { recursive: true });
   } else {
     await fetchRemoteTemplate(templateId, destDir);
@@ -46455,13 +46798,13 @@ async function scaffoldProject(destDir, name, templateId, localVideoName, durati
     ),
     "utf-8"
   );
-  if (!existsSync49(resolve26(destDir, "hyperframes.json"))) {
+  if (!existsSync50(resolve26(destDir, "hyperframes.json"))) {
     const { writeProjectConfig: writeProjectConfig2, DEFAULT_PROJECT_CONFIG: DEFAULT_PROJECT_CONFIG2 } = await Promise.resolve().then(() => (init_projectConfig(), projectConfig_exports));
     writeProjectConfig2(destDir, DEFAULT_PROJECT_CONFIG2);
   }
   writeDefaultPackageJson(destDir, name);
   const sharedDir = getSharedTemplateDir();
-  if (existsSync49(sharedDir)) {
+  if (existsSync50(sharedDir)) {
     for (const entry of readdirSync21(sharedDir, { withFileTypes: true })) {
       const src = join59(sharedDir, entry.name);
       const dest = resolve26(destDir, entry.name);
@@ -46621,7 +46964,7 @@ var init_init = __esm({
           const templateId2 = exampleFlag ?? "blank";
           const name2 = args.name ?? "my-video";
           const destDir2 = resolve26(name2);
-          if (existsSync49(destDir2) && readdirSync21(destDir2).length > 0) {
+          if (existsSync50(destDir2) && readdirSync21(destDir2).length > 0) {
             console.error(c2.error(`Directory already exists and is not empty: ${name2}`));
             process.exit(1);
           }
@@ -46635,7 +46978,7 @@ var init_init = __esm({
           }
           if (videoFlag) {
             const videoPath = resolve26(videoFlag);
-            if (!existsSync49(videoPath)) {
+            if (!existsSync50(videoPath)) {
               console.error(c2.error(`Video file not found: ${videoFlag}`));
               process.exit(1);
             }
@@ -46649,7 +46992,7 @@ var init_init = __esm({
           }
           if (audioFlag) {
             const audioPath = resolve26(audioFlag);
-            if (!existsSync49(audioPath)) {
+            if (!existsSync50(audioPath)) {
               console.error(c2.error(`Audio file not found: ${audioFlag}`));
               process.exit(1);
             }
@@ -46697,7 +47040,7 @@ var init_init = __esm({
           }
           trackInitTemplate(templateId2, { tailwind });
           const transcriptFile2 = resolve26(destDir2, "transcript.json");
-          if (existsSync49(transcriptFile2)) {
+          if (existsSync50(transcriptFile2)) {
             await patchTranscript(destDir2, transcriptFile2);
           }
           console.log(c2.success(`Created ${c2.accent(name2 + "/")}`));
@@ -46752,7 +47095,7 @@ var init_init = __esm({
           name = nameResult;
         }
         const destDir = resolve26(name);
-        if (existsSync49(destDir) && readdirSync21(destDir).length > 0) {
+        if (existsSync50(destDir) && readdirSync21(destDir).length > 0) {
           const overwrite = await ue({
             message: `Directory ${c2.accent(name)} already exists and is not empty. Overwrite?`,
             initialValue: false
@@ -46767,7 +47110,7 @@ var init_init = __esm({
         let videoDuration;
         if (videoFlag) {
           const videoPath = resolve26(videoFlag);
-          if (!existsSync49(videoPath)) {
+          if (!existsSync50(videoPath)) {
             R2.error(`File not found: ${videoFlag}`);
             me("Setup cancelled.");
             process.exit(1);
@@ -46779,7 +47122,7 @@ var init_init = __esm({
           videoDuration = result.meta.durationSeconds;
         } else if (audioFlag) {
           const audioPath = resolve26(audioFlag);
-          if (!existsSync49(audioPath)) {
+          if (!existsSync50(audioPath)) {
             R2.error(`File not found: ${audioFlag}`);
             me("Setup cancelled.");
             process.exit(1);
@@ -46880,7 +47223,7 @@ ${c2.dim("Use --example blank for offline use.")}`
         }
         trackInitTemplate(templateId, { tailwind });
         const transcriptFile = resolve26(destDir, "transcript.json");
-        if (existsSync49(transcriptFile)) {
+        if (existsSync50(transcriptFile)) {
           await patchTranscript(destDir, transcriptFile);
         }
         const files = readdirSync21(destDir);
@@ -46912,9 +47255,9 @@ ${c2.dim("Use --example blank for offline use.")}`
 
 // src/utils/clipboard.ts
 import { spawnSync as spawnSync3 } from "child_process";
-import { platform as platform4 } from "os";
+import { platform as platform6 } from "os";
 function detectProvider() {
-  const os = platform4();
+  const os = platform6();
   if (os === "darwin") {
     return { cmd: "pbcopy", args: [] };
   }
@@ -46966,7 +47309,7 @@ __export(add_exports, {
   remapTarget: () => remapTarget,
   runAdd: () => runAdd
 });
-import { existsSync as existsSync50 } from "fs";
+import { existsSync as existsSync51 } from "fs";
 import { resolve as resolve27, relative as relative7 } from "path";
 function remapTarget(item, originalTarget, paths) {
   if (item.type === "hyperframes:block") {
@@ -46992,8 +47335,8 @@ function buildSnippet(item, relativeTarget) {
 async function runAdd(opts) {
   const projectDir = resolve27(opts.projectDir);
   let config = loadProjectConfig(projectDir);
-  const hasConfig = existsSync50(projectConfigPath(projectDir));
-  if (!hasConfig && existsSync50(resolve27(projectDir, "index.html"))) {
+  const hasConfig = existsSync51(projectConfigPath(projectDir));
+  if (!hasConfig && existsSync51(resolve27(projectDir, "index.html"))) {
     writeProjectConfig(projectDir, DEFAULT_PROJECT_CONFIG);
     config = DEFAULT_PROJECT_CONFIG;
   }
@@ -47095,10 +47438,10 @@ var init_add = __esm({
         const projectDir = resolve27(args.dir ?? process.cwd());
         const json = args.json === true;
         const skipClipboard = args["no-clipboard"] === true;
-        const hasConfigBefore = existsSync50(projectConfigPath(projectDir));
+        const hasConfigBefore = existsSync51(projectConfigPath(projectDir));
         try {
           const result = await runAdd({ name: args.name, projectDir, skipClipboard });
-          const wroteConfig = !hasConfigBefore && existsSync50(projectConfigPath(projectDir));
+          const wroteConfig = !hasConfigBefore && existsSync51(projectConfigPath(projectDir));
           if (json) {
             console.log(JSON.stringify(result));
             return;
@@ -47128,7 +47471,7 @@ var init_add = __esm({
             process.exit(1);
           }
           let config = loadProjectConfig(projectDir);
-          if (!existsSync50(projectConfigPath(projectDir)) && existsSync50(resolve27(projectDir, "index.html"))) {
+          if (!existsSync51(projectConfigPath(projectDir)) && existsSync51(resolve27(projectDir, "index.html"))) {
             writeProjectConfig(projectDir, DEFAULT_PROJECT_CONFIG);
             config = DEFAULT_PROJECT_CONFIG;
           }
@@ -47348,17 +47691,17 @@ var init_format = __esm({
 });
 
 // src/utils/project.ts
-import { existsSync as existsSync51, statSync as statSync18 } from "fs";
+import { existsSync as existsSync52, statSync as statSync18 } from "fs";
 import { resolve as resolve29, basename as basename8 } from "path";
 function resolveProject(dirArg) {
   const dir = resolve29(dirArg ?? ".");
   const name = basename8(dir);
   const indexPath = resolve29(dir, "index.html");
-  if (!existsSync51(dir) || !statSync18(dir).isDirectory()) {
+  if (!existsSync52(dir) || !statSync18(dir).isDirectory()) {
     errorBox("Not a directory: " + dir);
     process.exit(1);
   }
-  if (!existsSync51(indexPath)) {
+  if (!existsSync52(indexPath)) {
     errorBox(
       "No composition found in " + dir,
       "No index.html file found.",
@@ -47381,7 +47724,7 @@ __export(play_exports, {
   default: () => play_default,
   examples: () => examples5
 });
-import { existsSync as existsSync52, readFileSync as readFileSync34 } from "fs";
+import { existsSync as existsSync53, readFileSync as readFileSync36 } from "fs";
 import { resolve as resolve30, dirname as dirname21 } from "path";
 function commandDir() {
   return dirname21(new URL(import.meta.url).pathname);
@@ -47396,7 +47739,7 @@ function resolveRuntimePath2() {
     resolve30(d2, "..", "..", "..", "core", "dist", "hyperframe.runtime.iife.js")
   ];
   for (const p2 of candidates) {
-    if (existsSync52(p2)) return p2;
+    if (existsSync53(p2)) return p2;
   }
   return null;
 }
@@ -47410,7 +47753,7 @@ function resolvePlayerPath() {
     resolve30(d2, "..", "hyperframes-player.global.js")
   ];
   for (const p2 of candidates) {
-    if (existsSync52(p2)) return p2;
+    if (existsSync53(p2)) return p2;
   }
   return null;
 }
@@ -47520,13 +47863,13 @@ var init_play = __esm({
         const { createAdaptorServer } = await import("@hono/node-server");
         const app = new Hono6();
         app.get("/player.js", (ctx) => {
-          return ctx.body(readFileSync34(playerPath, "utf-8"), 200, {
+          return ctx.body(readFileSync36(playerPath, "utf-8"), 200, {
             "Content-Type": "application/javascript",
             "Cache-Control": "no-cache"
           });
         });
         app.get("/runtime.js", (ctx) => {
-          return ctx.body(readFileSync34(runtimePath, "utf-8"), 200, {
+          return ctx.body(readFileSync36(runtimePath, "utf-8"), 200, {
             "Content-Type": "application/javascript",
             "Cache-Control": "no-cache"
           });
@@ -47535,8 +47878,8 @@ var init_play = __esm({
           const reqPath = ctx.req.path.replace("/composition/", "");
           const filePath = resolve30(project.dir, reqPath);
           if (!filePath.startsWith(project.dir)) return ctx.text("Forbidden", 403);
-          if (!existsSync52(filePath)) return ctx.text("Not found", 404);
-          const content = readFileSync34(filePath, "utf-8");
+          if (!existsSync53(filePath)) return ctx.text("Not found", 404);
+          const content = readFileSync36(filePath, "utf-8");
           if (filePath.endsWith(".html")) {
             const injected = injectRuntime(content);
             return ctx.html(injected);
@@ -47555,7 +47898,7 @@ var init_play = __esm({
             mp3: "audio/mpeg",
             wav: "audio/wav"
           };
-          return ctx.body(readFileSync34(filePath), 200, {
+          return ctx.body(readFileSync36(filePath), 200, {
             "Content-Type": types3[ext] ?? "application/octet-stream"
           });
         });
@@ -47616,7 +47959,7 @@ var init_play = __esm({
 
 // src/utils/publishProject.ts
 import { basename as basename9, join as join60, relative as relative8 } from "path";
-import { readdirSync as readdirSync22, readFileSync as readFileSync35, statSync as statSync19 } from "fs";
+import { readdirSync as readdirSync22, readFileSync as readFileSync37, statSync as statSync19 } from "fs";
 import AdmZip from "adm-zip";
 function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -47735,7 +48078,7 @@ function createPublishArchive(projectDir) {
   }
   const archive = new AdmZip();
   for (const filePath of filePaths) {
-    archive.addFile(filePath, readFileSync35(join60(projectDir, filePath)));
+    archive.addFile(filePath, readFileSync37(join60(projectDir, filePath)));
   }
   return {
     buffer: archive.toBuffer(),
@@ -47856,7 +48199,7 @@ __export(publish_exports, {
   examples: () => examples6
 });
 import { basename as basename10, resolve as resolve31 } from "path";
-import { existsSync as existsSync53 } from "fs";
+import { existsSync as existsSync54 } from "fs";
 import { join as join61 } from "path";
 var examples6, publish_default;
 var init_publish = __esm({
@@ -47893,7 +48236,7 @@ var init_publish = __esm({
         const isImplicitCwd = !rawArg || rawArg === "." || rawArg === "./";
         const projectName = isImplicitCwd ? basename10(process.env["PWD"] ?? dir) : basename10(dir);
         const indexPath = join61(dir, "index.html");
-        if (existsSync53(indexPath)) {
+        if (existsSync54(indexPath)) {
           const lintResult = lintProject({ dir, name: projectName, indexPath });
           if (lintResult.totalErrors > 0 || lintResult.totalWarnings > 0) {
             console.log();
@@ -47963,9 +48306,9 @@ var init_dom = __esm({
 });
 
 // src/utils/variables.ts
-import { readFileSync as readFileSync36 } from "fs";
+import { readFileSync as readFileSync38 } from "fs";
 import { resolve as resolve32 } from "path";
-function parseVariablesArg(inline, filePath, readFile = (p2) => readFileSync36(resolve32(p2), "utf8")) {
+function parseVariablesArg(inline, filePath, readFile = (p2) => readFileSync38(resolve32(p2), "utf8")) {
   if (inline != null && filePath != null) {
     return { ok: false, error: { kind: "conflict" } };
   }
@@ -48048,7 +48391,7 @@ function validateVariablesAgainstProject(indexPath, values) {
 function loadProjectVariableSchema(indexPath) {
   let html;
   try {
-    html = readFileSync36(indexPath, "utf8");
+    html = readFileSync38(indexPath, "utf8");
   } catch {
     return [];
   }
@@ -48176,11 +48519,11 @@ __export(ffmpeg_exports, {
   findFFmpeg: () => findFFmpeg,
   getFFmpegInstallHint: () => getFFmpegInstallHint
 });
-import { execSync as execSync2 } from "child_process";
+import { execSync as execSync3 } from "child_process";
 function findFFmpeg() {
   try {
     const cmd = process.platform === "win32" ? "where ffmpeg" : "which ffmpeg";
-    const output = execSync2(cmd, {
+    const output = execSync3(cmd, {
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"],
       timeout: 5e3
@@ -48215,7 +48558,7 @@ __export(render_exports, {
   renderLocal: () => renderLocal,
   resolveBrowserGpuForCli: () => resolveBrowserGpuForCli
 });
-import { mkdirSync as mkdirSync32, readdirSync as readdirSync23, readFileSync as readFileSync37, statSync as statSync20, writeFileSync as writeFileSync26, rmSync as rmSync14 } from "fs";
+import { mkdirSync as mkdirSync32, readdirSync as readdirSync23, readFileSync as readFileSync39, statSync as statSync20, writeFileSync as writeFileSync26, rmSync as rmSync14 } from "fs";
 import { cpus as cpus4, freemem as freemem4, tmpdir as tmpdir5 } from "os";
 import { resolve as resolve33, dirname as dirname22, join as join62, basename as basename11 } from "path";
 import { execFileSync as execFileSync6, spawn as spawn13 } from "child_process";
@@ -48276,7 +48619,7 @@ function ensureDockerImage(version, quiet) {
   const dockerfilePath = resolveDockerfilePath();
   const tmpDir = join62(tmpdir5(), `hyperframes-docker-${Date.now()}`);
   mkdirSync32(tmpDir, { recursive: true });
-  writeFileSync26(join62(tmpDir, "Dockerfile"), readFileSync37(dockerfilePath));
+  writeFileSync26(join62(tmpDir, "Dockerfile"), readFileSync39(dockerfilePath));
   try {
     execFileSync6(
       "docker",
@@ -49135,7 +49478,7 @@ var init_lint3 = __esm({
 
 // src/utils/staticProjectServer.ts
 import { createServer } from "http";
-import { existsSync as existsSync54, readFileSync as readFileSync38 } from "fs";
+import { existsSync as existsSync55, readFileSync as readFileSync40 } from "fs";
 import { isAbsolute as isAbsolute8, relative as relative9, resolve as resolve34 } from "path";
 async function serveStaticProjectHtml(projectDir, html, bindErrorMessage = "Failed to bind local HTTP server") {
   const server = createServer((req, res) => {
@@ -49152,9 +49495,9 @@ async function serveStaticProjectHtml(projectDir, html, bindErrorMessage = "Fail
       res.end();
       return;
     }
-    if (existsSync54(filePath)) {
+    if (existsSync55(filePath)) {
       res.writeHead(200, { "Content-Type": getMimeType(filePath) });
-      res.end(readFileSync38(filePath));
+      res.end(readFileSync40(filePath));
       return;
     }
     res.writeHead(404);
@@ -49330,7 +49673,7 @@ __export(layout_exports, {
   default: () => layout_default,
   examples: () => examples9
 });
-import { existsSync as existsSync55, readFileSync as readFileSync39 } from "fs";
+import { existsSync as existsSync56, readFileSync as readFileSync41 } from "fs";
 import { dirname as dirname23, join as join63 } from "path";
 import { fileURLToPath as fileURLToPath8 } from "url";
 async function getCompositionDuration2(page) {
@@ -49481,7 +49824,7 @@ function loadLayoutAuditScript() {
     join63(__dirname2, "commands", "layout-audit.browser.js")
   ];
   for (const candidate of candidates) {
-    if (existsSync55(candidate)) return readFileSync39(candidate, "utf-8");
+    if (existsSync56(candidate)) return readFileSync41(candidate, "utf-8");
   }
   throw new Error("Missing layout audit browser script");
 }
@@ -49689,7 +50032,7 @@ __export(info_exports, {
   default: () => info_default,
   examples: () => examples11
 });
-import { readFileSync as readFileSync40, readdirSync as readdirSync24, statSync as statSync21 } from "fs";
+import { readFileSync as readFileSync42, readdirSync as readdirSync24, statSync as statSync21 } from "fs";
 import { join as join64 } from "path";
 function totalSize(dir) {
   let total = 0;
@@ -49726,7 +50069,7 @@ var init_info = __esm({
       },
       async run({ args }) {
         const project = resolveProject(args.dir);
-        const html = readFileSync40(project.indexPath, "utf-8");
+        const html = readFileSync42(project.indexPath, "utf-8");
         ensureDOMParser();
         const parsed = parseHtml(html);
         const tracks = new Set(parsed.elements.map((el) => el.zIndex));
@@ -49784,7 +50127,7 @@ __export(compositions_exports, {
   examples: () => examples12,
   parseSubComposition: () => parseSubComposition
 });
-import { existsSync as existsSync56, readFileSync as readFileSync41 } from "fs";
+import { existsSync as existsSync57, readFileSync as readFileSync43 } from "fs";
 import { resolve as resolve35, dirname as dirname24 } from "path";
 function countRenderableDescendants(root) {
   return Array.from(root.querySelectorAll("*")).filter(
@@ -49818,8 +50161,8 @@ function parseCompositions(html, baseDir) {
     const compositionSrc = div.getAttribute("data-composition-src");
     if (compositionSrc) {
       const subPath = resolve35(baseDir, compositionSrc);
-      if (existsSync56(subPath)) {
-        const subHtml = readFileSync41(subPath, "utf-8");
+      if (existsSync57(subPath)) {
+        const subHtml = readFileSync43(subPath, "utf-8");
         const subInfo = parseSubComposition(subHtml, id, width, height);
         compositions.push({ ...subInfo, source: compositionSrc });
         return;
@@ -49922,7 +50265,7 @@ var init_compositions = __esm({
       },
       async run({ args }) {
         const project = resolveProject(args.dir);
-        const html = readFileSync41(project.indexPath, "utf-8");
+        const html = readFileSync43(project.indexPath, "utf-8");
         ensureDOMParser();
         const compositions = parseCompositions(html, dirname24(project.indexPath));
         if (compositions.length === 0) {
@@ -49960,7 +50303,7 @@ __export(benchmark_exports, {
   default: () => benchmark_default,
   examples: () => examples13
 });
-import { existsSync as existsSync57, statSync as statSync22 } from "fs";
+import { existsSync as existsSync58, statSync as statSync22 } from "fs";
 import { resolve as resolve36, join as join65 } from "path";
 var examples13, FPS_30, FPS_60, DEFAULT_CONFIGS, benchmark_default;
 var init_benchmark = __esm({
@@ -50053,7 +50396,7 @@ var init_benchmark = __esm({
               await producer.executeRenderJob(job, project.dir, outputPath);
               const elapsedMs = Date.now() - startTime;
               let fileSize = null;
-              if (existsSync57(outputPath)) {
+              if (existsSync58(outputPath)) {
                 const stat3 = statSync22(outputPath);
                 fileSize = stat3.size;
               }
@@ -50307,8 +50650,8 @@ __export(manager_exports3, {
   modelPath: () => modelPath,
   selectProviders: () => selectProviders
 });
-import { existsSync as existsSync58, mkdirSync as mkdirSync33 } from "fs";
-import { homedir as homedir9, platform as platform5, arch } from "os";
+import { existsSync as existsSync59, mkdirSync as mkdirSync33 } from "fs";
+import { homedir as homedir9, platform as platform7, arch } from "os";
 import { join as join66 } from "path";
 function isDevice(value) {
   return typeof value === "string" && DEVICES.includes(value);
@@ -50334,7 +50677,7 @@ function selectProviders(device = "auto") {
     }
     return { providers: ["cuda", "cpu"], label: "CUDA" };
   }
-  if (hasCoreML && platform5() === "darwin" && arch() === "arm64") {
+  if (hasCoreML && platform7() === "darwin" && arch() === "arm64") {
     return { providers: ["coreml", "cpu"], label: "CoreML" };
   }
   if (hasCUDA) return { providers: ["cuda", "cpu"], label: "CUDA" };
@@ -50343,7 +50686,7 @@ function selectProviders(device = "auto") {
 function listAvailableProviders() {
   if (_cachedProviders) return _cachedProviders;
   const out = ["cpu"];
-  if (platform5() === "darwin" && arch() === "arm64") out.push("coreml");
+  if (platform7() === "darwin" && arch() === "arm64") out.push("coreml");
   if (process.env["HYPERFRAMES_CUDA"] === "1") out.push("cuda");
   _cachedProviders = out;
   return out;
@@ -50353,11 +50696,11 @@ function modelPath(model = DEFAULT_MODEL2) {
 }
 async function ensureModel2(model = DEFAULT_MODEL2, options) {
   const dest = modelPath(model);
-  if (existsSync58(dest)) return dest;
+  if (existsSync59(dest)) return dest;
   mkdirSync33(MODELS_DIR2, { recursive: true });
   options?.onProgress?.(`Downloading ${model} weights (~168 MB)...`);
   await downloadFile(MODEL_URLS[model], dest);
-  if (!existsSync58(dest)) {
+  if (!existsSync59(dest)) {
     throw new Error(`Model download failed: ${model}`);
   }
   return dest;
@@ -50838,12 +51181,12 @@ __export(remove_background_exports, {
   examples: () => examples15
 });
 import { resolve as resolve37 } from "path";
-import { existsSync as existsSync59 } from "fs";
+import { existsSync as existsSync60 } from "fs";
 async function showInfo(json) {
   const { selectProviders: selectProviders2, listAvailableProviders: listAvailableProviders2, DEFAULT_MODEL: DEFAULT_MODEL4, MODEL_MEMORY_MB: MODEL_MEMORY_MB2, modelPath: modelPath2 } = await Promise.resolve().then(() => (init_manager3(), manager_exports3));
   const providers = listAvailableProviders2();
   const auto = selectProviders2("auto");
-  const cached2 = existsSync59(modelPath2());
+  const cached2 = existsSync60(modelPath2());
   if (json) {
     console.log(
       JSON.stringify({
@@ -51050,7 +51393,7 @@ __export(transcribe_exports2, {
   default: () => transcribe_default,
   examples: () => examples16
 });
-import { existsSync as existsSync60, writeFileSync as writeFileSync27 } from "fs";
+import { existsSync as existsSync61, writeFileSync as writeFileSync27 } from "fs";
 import { resolve as resolve38, join as join67, extname as extname11, dirname as dirname25 } from "path";
 async function importTranscript(inputPath, dir, json) {
   const { loadTranscript: loadTranscript2, patchCaptionHtml: patchCaptionHtml2 } = await Promise.resolve().then(() => (init_normalize(), normalize_exports));
@@ -51176,7 +51519,7 @@ var init_transcribe2 = __esm({
       },
       async run({ args }) {
         const inputPath = resolve38(args.input);
-        if (!existsSync60(inputPath)) {
+        if (!existsSync61(inputPath)) {
           console.error(c2.error(`File not found: ${args.input}`));
           process.exit(1);
         }
@@ -51197,7 +51540,7 @@ var init_transcribe2 = __esm({
 });
 
 // src/tts/manager.ts
-import { existsSync as existsSync61, mkdirSync as mkdirSync34 } from "fs";
+import { existsSync as existsSync62, mkdirSync as mkdirSync34 } from "fs";
 import { homedir as homedir10 } from "os";
 import { join as join68 } from "path";
 function inferLangFromVoiceId(voiceId) {
@@ -51209,7 +51552,7 @@ function isSupportedLang(value) {
 }
 async function ensureModel3(model = DEFAULT_MODEL3, options) {
   const modelPath2 = join68(MODELS_DIR3, `${model}.onnx`);
-  if (existsSync61(modelPath2)) return modelPath2;
+  if (existsSync62(modelPath2)) return modelPath2;
   const url = MODEL_URLS2[model];
   if (!url) {
     throw new Error(
@@ -51219,18 +51562,18 @@ async function ensureModel3(model = DEFAULT_MODEL3, options) {
   mkdirSync34(MODELS_DIR3, { recursive: true });
   options?.onProgress?.(`Downloading TTS model ${model} (~311 MB)...`);
   await downloadFile(url, modelPath2);
-  if (!existsSync61(modelPath2)) {
+  if (!existsSync62(modelPath2)) {
     throw new Error(`Model download failed: ${model}`);
   }
   return modelPath2;
 }
 async function ensureVoices(options) {
   const voicesPath = join68(VOICES_DIR, "voices-v1.0.bin");
-  if (existsSync61(voicesPath)) return voicesPath;
+  if (existsSync62(voicesPath)) return voicesPath;
   mkdirSync34(VOICES_DIR, { recursive: true });
   options?.onProgress?.("Downloading voice data (~27 MB)...");
   await downloadFile(VOICES_URL, voicesPath);
-  if (!existsSync61(voicesPath)) {
+  if (!existsSync62(voicesPath)) {
     throw new Error("Voice data download failed");
   }
   return voicesPath;
@@ -51303,7 +51646,7 @@ __export(synthesize_exports, {
   synthesize: () => synthesize
 });
 import { execFileSync as execFileSync7 } from "child_process";
-import { existsSync as existsSync62, writeFileSync as writeFileSync28, mkdirSync as mkdirSync35, readdirSync as readdirSync25, unlinkSync as unlinkSync6 } from "fs";
+import { existsSync as existsSync63, writeFileSync as writeFileSync28, mkdirSync as mkdirSync35, readdirSync as readdirSync25, unlinkSync as unlinkSync6 } from "fs";
 import { join as join69, dirname as dirname26, basename as basename12 } from "path";
 import { homedir as homedir11 } from "os";
 function findPython() {
@@ -51340,7 +51683,7 @@ function hasPythonPackage(python, pkg) {
   }
 }
 function ensureSynthScript() {
-  if (!existsSync62(SCRIPT_PATH)) {
+  if (!existsSync63(SCRIPT_PATH)) {
     mkdirSync35(SCRIPT_DIR, { recursive: true });
     writeFileSync28(SCRIPT_PATH, SYNTH_SCRIPT);
     const currentName = basename12(SCRIPT_PATH);
@@ -51394,7 +51737,7 @@ async function synthesize(text, outputPath, options) {
         stdio: ["pipe", "pipe", "pipe"]
       }
     );
-    if (!existsSync62(outputPath)) {
+    if (!existsSync63(outputPath)) {
       throw new Error("Synthesis completed but no output file was created");
     }
     const lines = stdout2.trim().split("\n");
@@ -51407,7 +51750,7 @@ async function synthesize(text, outputPath, options) {
       langApplied: result.langApplied
     };
   } catch (err) {
-    if (err instanceof SyntaxError && existsSync62(outputPath)) {
+    if (err instanceof SyntaxError && existsSync63(outputPath)) {
       throw new Error(
         "Speech was generated but metadata could not be read. Check the output file manually."
       );
@@ -51469,7 +51812,7 @@ __export(tts_exports, {
   default: () => tts_default,
   examples: () => examples17
 });
-import { existsSync as existsSync63, readFileSync as readFileSync42 } from "fs";
+import { existsSync as existsSync64, readFileSync as readFileSync44 } from "fs";
 import { resolve as resolve39, extname as extname12 } from "path";
 function listVoices(json) {
   const rows = BUNDLED_VOICES.map((v2) => ({ ...v2, defaultLang: inferLangFromVoiceId(v2.id) }));
@@ -51579,8 +51922,8 @@ var init_tts = __esm({
         }
         let text;
         const maybeFile = resolve39(args.input);
-        if (existsSync63(maybeFile) && extname12(maybeFile).toLowerCase() === ".txt") {
-          text = readFileSync42(maybeFile, "utf-8").trim();
+        if (existsSync64(maybeFile) && extname12(maybeFile).toLowerCase() === ".txt") {
+          text = readFileSync44(maybeFile, "utf-8").trim();
           if (!text) {
             console.error(c2.error("File is empty."));
             process.exit(1);
@@ -51672,7 +52015,7 @@ __export(docs_exports, {
   default: () => docs_default,
   examples: () => examples18
 });
-import { readFileSync as readFileSync43, existsSync as existsSync64 } from "fs";
+import { readFileSync as readFileSync45, existsSync as existsSync65 } from "fs";
 import { resolve as resolve40, dirname as dirname27, join as join70 } from "path";
 import { fileURLToPath as fileURLToPath9 } from "url";
 function docsDir() {
@@ -51680,7 +52023,7 @@ function docsDir() {
   const dir = dirname27(thisFile);
   const devPath = resolve40(dir, "..", "docs");
   const builtPath = resolve40(dir, "docs");
-  return existsSync64(devPath) ? devPath : builtPath;
+  return existsSync65(devPath) ? devPath : builtPath;
 }
 function formatInlineCode(line) {
   return line.replace(/`([^`]+)`/g, (_match, code) => c2.accent(code));
@@ -51778,11 +52121,11 @@ var init_docs = __esm({
           process.exit(1);
         }
         const filePath = join70(docsDir(), entry.file);
-        if (!existsSync64(filePath)) {
+        if (!existsSync65(filePath)) {
           console.error(c2.error(`Doc file not found: ${filePath}`));
           process.exit(1);
         }
-        const content = readFileSync43(filePath, "utf-8");
+        const content = readFileSync45(filePath, "utf-8");
         console.log();
         renderMarkdown(content);
       }
@@ -51798,13 +52141,13 @@ __export(doctor_exports, {
   examples: () => examples19,
   redactHome: () => redactHome
 });
-import { execSync as execSync3 } from "child_process";
-import { freemem as freemem5, platform as platform6 } from "os";
+import { execSync as execSync4 } from "child_process";
+import { freemem as freemem5, platform as platform8 } from "os";
 function checkFFmpeg() {
   const path2 = findFFmpeg();
   if (path2) {
     try {
-      const version = execSync3("ffmpeg -version", { encoding: "utf-8", timeout: 5e3 }).split("\n")[0] ?? "";
+      const version = execSync4("ffmpeg -version", { encoding: "utf-8", timeout: 5e3 }).split("\n")[0] ?? "";
       return { ok: true, detail: version.trim() };
     } catch {
       return { ok: true, detail: path2 };
@@ -51818,7 +52161,7 @@ function checkFFmpeg() {
 }
 function checkFFprobe() {
   try {
-    const version = execSync3("ffprobe -version", { encoding: "utf-8", timeout: 5e3 }).split("\n")[0] ?? "";
+    const version = execSync4("ffprobe -version", { encoding: "utf-8", timeout: 5e3 }).split("\n")[0] ?? "";
     return { ok: true, detail: version.trim() };
   } catch {
     return {
@@ -51841,7 +52184,7 @@ async function checkChrome() {
 }
 function checkDocker() {
   try {
-    const version = execSync3("docker --version", { encoding: "utf-8", timeout: 5e3 }).trim();
+    const version = execSync4("docker --version", { encoding: "utf-8", timeout: 5e3 }).trim();
     return { ok: true, detail: version };
   } catch {
     return {
@@ -51853,7 +52196,7 @@ function checkDocker() {
 }
 function checkDockerRunning() {
   try {
-    execSync3("docker info", { stdio: "pipe", timeout: 5e3 });
+    execSync4("docker info", { stdio: "pipe", timeout: 5e3 });
     return { ok: true, detail: "Running" };
   } catch {
     return {
@@ -51988,7 +52331,7 @@ var init_doctor = __esm({
           { name: "Memory", run: checkMemory },
           { name: "Disk", run: checkDisk }
         ];
-        if (platform6() === "linux") {
+        if (platform8() === "linux") {
           checks.push({ name: "/dev/shm", run: checkShm });
         }
         checks.push(
@@ -52246,16 +52589,18 @@ function parseViewportDimension(value) {
   if (!Number.isFinite(parsed) || parsed <= 0) return null;
   return Math.min(parsed, MAX_VIEWPORT_DIMENSION);
 }
-function resolveCompositionViewportFromHtml(html) {
+function findCompositionDimensions(html) {
   ensureDOMParser();
   const doc = new DOMParser().parseFromString(html, "text/html");
   const root = doc.querySelector("[data-composition-id][data-width][data-height]");
-  const width = parseViewportDimension(root?.getAttribute("data-width") ?? null);
-  const height = parseViewportDimension(root?.getAttribute("data-height") ?? null);
-  return {
-    width: width ?? DEFAULT_VIEWPORT.width,
-    height: height ?? DEFAULT_VIEWPORT.height
-  };
+  if (!root) return null;
+  const width = parseViewportDimension(root.getAttribute("data-width"));
+  const height = parseViewportDimension(root.getAttribute("data-height"));
+  if (width === null || height === null) return null;
+  return { width, height };
+}
+function resolveCompositionViewportFromHtml(html) {
+  return findCompositionDimensions(html) ?? DEFAULT_VIEWPORT;
 }
 var DEFAULT_VIEWPORT, MAX_VIEWPORT_DIMENSION;
 var init_compositionViewport = __esm({
@@ -52273,7 +52618,7 @@ __export(validate_exports, {
   default: () => validate_default,
   shouldIgnoreRequestFailure: () => shouldIgnoreRequestFailure
 });
-import { existsSync as existsSync65, readFileSync as readFileSync44 } from "fs";
+import { existsSync as existsSync66, readFileSync as readFileSync46 } from "fs";
 import { join as join71, dirname as dirname28 } from "path";
 import { fileURLToPath as fileURLToPath10 } from "url";
 function shouldIgnoreRequestFailure(url, errorText) {
@@ -52330,7 +52675,7 @@ function loadContrastAuditScript() {
     join71(__dirname3, "commands", "contrast-audit.browser.js")
   ];
   for (const candidate of candidates) {
-    if (existsSync65(candidate)) return readFileSync44(candidate, "utf-8");
+    if (existsSync66(candidate)) return readFileSync46(candidate, "utf-8");
   }
   throw new Error("Missing contrast audit browser script");
 }
@@ -52348,9 +52693,9 @@ async function validateInBrowser(projectDir, opts) {
       return;
     }
     const filePath = join71(projectDir, decodeURIComponent(url));
-    if (existsSync65(filePath)) {
+    if (existsSync66(filePath)) {
       res.writeHead(200, { "Content-Type": getMimeType2(filePath) });
-      res.end(readFileSync44(filePath));
+      res.end(readFileSync46(filePath));
       return;
     }
     res.writeHead(404);
@@ -52552,7 +52897,7 @@ __export(contactSheet_exports, {
   createSvgContactSheet: () => createSvgContactSheet
 });
 import sharp from "sharp";
-import { readdirSync as readdirSync26, readFileSync as readFileSync45, writeFileSync as writeFileSync29, unlinkSync as unlinkSync7, existsSync as existsSync66 } from "fs";
+import { readdirSync as readdirSync26, readFileSync as readFileSync47, writeFileSync as writeFileSync29, unlinkSync as unlinkSync7, existsSync as existsSync67 } from "fs";
 import { join as join72, extname as extname13, basename as basename13, dirname as dirname29 } from "path";
 async function createContactSheet(imagePaths, outputPath, opts = {}) {
   const {
@@ -52632,7 +52977,7 @@ async function createContactSheetPages(imagePaths, outputBasePath, opts = {}, la
   return results;
 }
 async function createScrollContactSheet(screenshotsDir, outputPath) {
-  if (!existsSync66(screenshotsDir)) return [];
+  if (!existsSync67(screenshotsDir)) return [];
   const scrollFiles = readdirSync26(screenshotsDir).filter((f3) => f3.startsWith("scroll-") && f3.endsWith(".png")).sort();
   if (scrollFiles.length === 0) return [];
   const paths = scrollFiles.map((f3) => join72(screenshotsDir, f3));
@@ -52649,7 +52994,7 @@ async function createScrollContactSheet(screenshotsDir, outputPath) {
   );
 }
 async function createSnapshotContactSheet(snapshotsDir, outputPath) {
-  if (!existsSync66(snapshotsDir)) return [];
+  if (!existsSync67(snapshotsDir)) return [];
   const snapshotFiles = readdirSync26(snapshotsDir).filter((f3) => f3.startsWith("frame-") && f3.endsWith(".png")).sort();
   if (snapshotFiles.length === 0) return [];
   const paths = snapshotFiles.map((f3) => join72(snapshotsDir, f3));
@@ -52666,7 +53011,7 @@ async function createSnapshotContactSheet(snapshotsDir, outputPath) {
   );
 }
 async function createAssetContactSheet(assetsDir, outputPath) {
-  if (!existsSync66(assetsDir)) return [];
+  if (!existsSync67(assetsDir)) return [];
   const imageExts = /* @__PURE__ */ new Set([".png", ".jpg", ".jpeg", ".webp"]);
   const assetFiles = readdirSync26(assetsDir).filter((f3) => imageExts.has(extname13(f3).toLowerCase()) && !f3.includes("contact-sheet")).sort();
   if (assetFiles.length === 0) return [];
@@ -52680,7 +53025,7 @@ async function createAssetContactSheet(assetsDir, outputPath) {
 }
 async function createSvgContactSheet(svgsDir, outputPath, assetsRootDir) {
   const dirsToScan = [svgsDir, assetsRootDir].filter(
-    (d2) => d2 !== void 0 && existsSync66(d2)
+    (d2) => d2 !== void 0 && existsSync67(d2)
   );
   if (dirsToScan.length === 0) return [];
   const seen = /* @__PURE__ */ new Set();
@@ -52703,7 +53048,7 @@ async function createSvgContactSheet(svgsDir, outputPath, assetsRootDir) {
     const svgPath = svgPaths[i2];
     const tmpPath = join72(tmpDir, `.thumb-${i2}.png`);
     try {
-      const svgBuf = readFileSync45(svgPath);
+      const svgBuf = readFileSync47(svgPath);
       const thumb = await sharp(svgBuf).resize(thumbSize, thumbSize, {
         fit: "contain",
         background: { r: 245, g: 245, b: 245, alpha: 1 }
@@ -93261,7 +93606,7 @@ __export(snapshot_exports, {
   examples: () => examples22
 });
 import { spawn as spawn15 } from "child_process";
-import { existsSync as existsSync67, mkdtempSync as mkdtempSync3, readFileSync as readFileSync46, mkdirSync as mkdirSync36, rmSync as rmSync15, writeFileSync as writeFileSync30 } from "fs";
+import { existsSync as existsSync68, mkdtempSync as mkdtempSync3, readFileSync as readFileSync48, mkdirSync as mkdirSync36, rmSync as rmSync15, writeFileSync as writeFileSync30 } from "fs";
 import { tmpdir as tmpdir6 } from "os";
 import { resolve as resolve41, join as join73, relative as relative10, isAbsolute as isAbsolute9 } from "path";
 async function extractVideoFrameToBuffer(videoPath, timeSeconds, useVp9AlphaDecoder = false) {
@@ -93306,8 +93651,8 @@ async function extractVideoFrameToBuffer(videoPath, timeSeconds, useVp9AlphaDeco
         });
       }
     );
-    if (result.code !== 0 || result.timedOut || !existsSync67(outPath)) return null;
-    return readFileSync46(outPath);
+    if (result.code !== 0 || result.timedOut || !existsSync68(outPath)) return null;
+    return readFileSync48(outPath);
   } finally {
     try {
       rmSync15(tmp, { recursive: true, force: true });
@@ -93505,7 +93850,7 @@ async function captureSnapshots(projectDir, opts) {
               const decodedPath = decodeURIComponent(url.pathname).replace(/^\//, "");
               const candidate = resolve41(projectDir, decodedPath);
               const rel = relative10(projectDir, candidate);
-              if (!rel.startsWith("..") && !isAbsolute9(rel) && existsSync67(candidate)) {
+              if (!rel.startsWith("..") && !isAbsolute9(rel) && existsSync68(candidate)) {
                 filePath = candidate;
               }
             } catch {
@@ -93656,8 +94001,8 @@ ${c2.success("\u25C7")}  ${paths.length} snapshots saved to snapshots/`);
                   paths.map(async (p2) => {
                     const filename = p2.replace("snapshots/", "");
                     const filePath = join73(snapshotDir, filename);
-                    if (!existsSync67(filePath)) return { filename, desc: "file not found" };
-                    const raw = readFileSync46(filePath);
+                    if (!existsSync68(filePath)) return { filename, desc: "file not found" };
+                    const raw = readFileSync48(filePath);
                     let imageData;
                     let mimeType = "image/png";
                     if (sharpFn) {
@@ -94851,7 +95196,7 @@ var init_designStyleExtractor = __esm({
 });
 
 // src/capture/fontMetadataExtractor.ts
-import { readdirSync as readdirSync27, readFileSync as readFileSync47, writeFileSync as writeFileSync32, existsSync as existsSync68 } from "fs";
+import { readdirSync as readdirSync27, readFileSync as readFileSync49, writeFileSync as writeFileSync32, existsSync as existsSync69 } from "fs";
 import { join as join75 } from "path";
 import * as fontkit from "fontkit";
 function isFontCollection(value) {
@@ -94860,7 +95205,7 @@ function isFontCollection(value) {
 function extractFontMetadata(fontsDir, outputPath) {
   const files = [];
   const unidentified = [];
-  if (existsSync68(fontsDir)) {
+  if (existsSync69(fontsDir)) {
     const fontFiles = readdirSync27(fontsDir).filter((f3) => /\.(woff2?|ttf|otf)$/i.test(f3));
     for (const filename of fontFiles) {
       const fullPath = join75(fontsDir, filename);
@@ -94901,7 +95246,7 @@ function readSingleFont(fullPath, filename) {
     identified: false
   };
   try {
-    const buf = readFileSync47(fullPath);
+    const buf = readFileSync49(fullPath);
     const created = fontkit.create(buf);
     const font = isFontCollection(created) ? created.fonts[0] : created;
     if (!font) return empty;
@@ -95157,7 +95502,7 @@ var init_animationCataloger = __esm({
 });
 
 // src/capture/mediaCapture.ts
-import { mkdirSync as mkdirSync38, writeFileSync as writeFileSync33, readdirSync as readdirSync28, readFileSync as readFileSync48, statSync as statSync24 } from "fs";
+import { mkdirSync as mkdirSync38, writeFileSync as writeFileSync33, readdirSync as readdirSync28, readFileSync as readFileSync50, statSync as statSync24 } from "fs";
 import { join as join76 } from "path";
 async function saveLottieAnimations(discoveredLotties, lottieDir) {
   let savedCount = 0;
@@ -95224,7 +95569,7 @@ async function renderLottiePreviews(chromeBrowser, lottieDir, outputDir) {
   for (const file of readdirSync28(lottieDir)) {
     if (!file.endsWith(".json")) continue;
     try {
-      const raw = JSON.parse(readFileSync48(join76(lottieDir, file), "utf-8"));
+      const raw = JSON.parse(readFileSync50(join76(lottieDir, file), "utf-8"));
       const fr = raw.fr || 30;
       const dur = ((raw.op || 0) - (raw.ip || 0)) / fr;
       const previewName = file.replace(".json", "-preview.png");
@@ -95234,7 +95579,7 @@ async function renderLottiePreviews(chromeBrowser, lottieDir, outputDir) {
       try {
         previewPage = await chromeBrowser.newPage();
         await previewPage.setViewport({ width: 400, height: 400 });
-        const animData = JSON.parse(readFileSync48(join76(lottieDir, file), "utf-8"));
+        const animData = JSON.parse(readFileSync50(join76(lottieDir, file), "utf-8"));
         const midFrame = Math.floor(((raw.op || 0) - (raw.ip || 0)) * 0.3);
         await previewPage.setContent(
           `<!DOCTYPE html>
@@ -95413,7 +95758,7 @@ var init_mediaCapture = __esm({
 });
 
 // src/capture/contentExtractor.ts
-import { existsSync as existsSync69, readdirSync as readdirSync29, statSync as statSync25, readFileSync as readFileSync49 } from "fs";
+import { existsSync as existsSync70, readdirSync as readdirSync29, statSync as statSync25, readFileSync as readFileSync51 } from "fs";
 import { join as join77 } from "path";
 async function detectLibraries(page, capturedShaders) {
   let detectedLibraries = [];
@@ -95546,7 +95891,7 @@ async function captionImagesWithGemini(outputDir, progress, warnings) {
           const filePath = join77(outputDir, "assets", file);
           const stat3 = statSync25(filePath);
           if (stat3.size > 4e6) return { file, caption: "" };
-          const buffer = readFileSync49(filePath);
+          const buffer = readFileSync51(filePath);
           const base64 = buffer.toString("base64");
           const ext = file.split(".").pop()?.toLowerCase() || "png";
           const mimeType = ext === "jpg" ? "image/jpeg" : `image/${ext}`;
@@ -95588,7 +95933,7 @@ async function captionImagesWithGemini(outputDir, progress, warnings) {
       if (/\.svg$/i.test(f3)) svgFiles.push({ file: f3, relPath: f3 });
     }
     const svgsSubdir = join77(assetsDir, "svgs");
-    if (existsSync69(svgsSubdir)) {
+    if (existsSync70(svgsSubdir)) {
       for (const f3 of readdirSync29(svgsSubdir)) {
         if (/\.svg$/i.test(f3)) svgFiles.push({ file: f3, relPath: `svgs/${f3}` });
       }
@@ -95602,7 +95947,7 @@ async function captionImagesWithGemini(outputDir, progress, warnings) {
         const results = await Promise.allSettled(
           batch.map(async ({ relPath }) => {
             const filePath = join77(assetsDir, relPath);
-            let svgText = readFileSync49(filePath, "utf-8");
+            let svgText = readFileSync51(filePath, "utf-8");
             if (svgText.length > MAX_SVG_CHARS) {
               svgText = svgText.slice(0, MAX_SVG_CHARS) + "\n<!-- truncated -->";
             }
@@ -95720,7 +96065,7 @@ var agentPromptGenerator_exports = {};
 __export(agentPromptGenerator_exports, {
   generateAgentPrompt: () => generateAgentPrompt
 });
-import { writeFileSync as writeFileSync34, readdirSync as readdirSync30, existsSync as existsSync70 } from "fs";
+import { writeFileSync as writeFileSync34, readdirSync as readdirSync30, existsSync as existsSync71 } from "fs";
 import { join as join78 } from "path";
 function inferColorRole(hex) {
   const r2 = parseInt(hex.slice(1, 3), 16) / 255;
@@ -95752,7 +96097,7 @@ function buildPrompt(outputDir, url, tokens, hasScreenshot, hasLottie, hasShader
   ).join(", ") || "none detected";
   function contactSheetRows(dir, baseFile, label2) {
     const fullDir = join78(outputDir, dir);
-    if (!existsSync70(fullDir)) return [];
+    if (!existsSync71(fullDir)) return [];
     const baseName = baseFile.replace(/\.jpg$/, "");
     const escapedBase = baseName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
     const paginatedRe = new RegExp(`^${escapedBase}(?:-(\\d+))?\\.jpg$`);
@@ -95784,7 +96129,7 @@ function buildPrompt(outputDir, url, tokens, hasScreenshot, hasLottie, hasShader
   tableRows.push(
     `| \`extracted/tokens.json\` | Design tokens: ${tokens.colors.length} colors, ${tokens.fonts.length} fonts, ${tokens.headings?.length ?? 0} headings, ${tokens.ctas?.length ?? 0} CTAs |`
   );
-  if (existsSync70(join78(outputDir, "extracted", "design-styles.json"))) {
+  if (existsSync71(join78(outputDir, "extracted", "design-styles.json"))) {
     tableRows.push(
       "| `extracted/design-styles.json` | Computed styles from live DOM: typography hierarchy, button/card/nav styles, spacing scale, border-radius, box shadows. Primary data source for DESIGN.md. |"
     );
@@ -95855,7 +96200,7 @@ var init_agentPromptGenerator = __esm({
 });
 
 // src/capture/scaffolding.ts
-import { existsSync as existsSync71, writeFileSync as writeFileSync35, readFileSync as readFileSync50 } from "fs";
+import { existsSync as existsSync72, writeFileSync as writeFileSync35, readFileSync as readFileSync52 } from "fs";
 import { join as join79, resolve as resolve42 } from "path";
 function loadEnvFile(startDir) {
   try {
@@ -95863,7 +96208,7 @@ function loadEnvFile(startDir) {
     for (let i2 = 0; i2 < 5; i2++) {
       const envPath = resolve42(dir, ".env");
       try {
-        const envContent = readFileSync50(envPath, "utf-8");
+        const envContent = readFileSync52(envPath, "utf-8");
         for (const line of envContent.split("\n")) {
           const trimmed = line.trim();
           if (!trimmed || trimmed.startsWith("#")) continue;
@@ -95883,7 +96228,7 @@ function loadEnvFile(startDir) {
 }
 async function generateProjectScaffold(outputDir, url, tokens, animationCatalog, hasScreenshots, hasLotties, hasShaders, catalogedAssets, progress, warnings, detectedLibraries) {
   const metaPath = join79(outputDir, "meta.json");
-  if (!existsSync71(metaPath)) {
+  if (!existsSync72(metaPath)) {
     const hostname = new URL(url).hostname.replace(/^www\./, "");
     writeFileSync35(
       metaPath,
@@ -96290,7 +96635,7 @@ var capture_exports = {};
 __export(capture_exports, {
   captureWebsite: () => captureWebsite
 });
-import { mkdirSync as mkdirSync40, writeFileSync as writeFileSync37, existsSync as existsSync72 } from "fs";
+import { mkdirSync as mkdirSync40, writeFileSync as writeFileSync37, existsSync as existsSync73 } from "fs";
 import { join as join81 } from "path";
 async function captureWebsite(opts, onProgress) {
   const {
@@ -96653,7 +96998,7 @@ ${err.stack}` : String(err);
           `Screenshot contact sheet generated (${scrollSheets.length} page${scrollSheets.length > 1 ? "s" : ""})`
         );
       const assetsImgDir = join81(outputDir, "assets");
-      if (existsSync72(assetsImgDir)) {
+      if (existsSync73(assetsImgDir)) {
         const assetSheets = await createAssetContactSheet2(
           assetsImgDir,
           join81(outputDir, "assets", "contact-sheet.jpg")
@@ -96666,7 +97011,7 @@ ${err.stack}` : String(err);
       }
       const svgsDir = join81(outputDir, "assets", "svgs");
       const assetsRootDir = join81(outputDir, "assets");
-      const svgOutputPath = existsSync72(svgsDir) ? join81(outputDir, "assets", "svgs", "contact-sheet.jpg") : join81(outputDir, "assets", "contact-sheet-svgs.jpg");
+      const svgOutputPath = existsSync73(svgsDir) ? join81(outputDir, "assets", "svgs", "contact-sheet.jpg") : join81(outputDir, "assets", "contact-sheet-svgs.jpg");
       const svgSheets = await createSvgContactSheet2(svgsDir, svgOutputPath, assetsRootDir);
       if (svgSheets.length > 0)
         progress(
@@ -96682,7 +97027,7 @@ ${err.stack}` : String(err);
       animationCatalog,
       screenshots.length > 0,
       discoveredLotties.length > 0,
-      existsSync72(join81(outputDir, "extracted", "shaders.json")),
+      existsSync73(join81(outputDir, "extracted", "shaders.json")),
       catalogedAssets,
       progress,
       warnings,
@@ -96910,7 +97255,7 @@ __export(state_exports, {
   stateFilePath: () => stateFilePath,
   writeStackOutputs: () => writeStackOutputs
 });
-import { existsSync as existsSync73, mkdirSync as mkdirSync41, readdirSync as readdirSync31, readFileSync as readFileSync51, rmSync as rmSync16, writeFileSync as writeFileSync38 } from "fs";
+import { existsSync as existsSync74, mkdirSync as mkdirSync41, readdirSync as readdirSync31, readFileSync as readFileSync53, rmSync as rmSync16, writeFileSync as writeFileSync38 } from "fs";
 import { dirname as dirname30, join as join82 } from "path";
 function stateFilePath(stackName = DEFAULT_STACK_NAME, cwd = process.cwd()) {
   return join82(cwd, STATE_DIR_NAME, `${STATE_FILE_PREFIX}${stackName}.json`);
@@ -96923,20 +97268,20 @@ function writeStackOutputs(outputs, cwd = process.cwd()) {
 }
 function readStackOutputs(stackName = DEFAULT_STACK_NAME, cwd = process.cwd()) {
   const path2 = stateFilePath(stackName, cwd);
-  if (!existsSync73(path2)) return null;
+  if (!existsSync74(path2)) return null;
   try {
-    return JSON.parse(readFileSync51(path2, "utf-8"));
+    return JSON.parse(readFileSync53(path2, "utf-8"));
   } catch {
     return null;
   }
 }
 function deleteStackOutputs(stackName = DEFAULT_STACK_NAME, cwd = process.cwd()) {
   const path2 = stateFilePath(stackName, cwd);
-  if (existsSync73(path2)) rmSync16(path2);
+  if (existsSync74(path2)) rmSync16(path2);
 }
 function listStackNames(cwd = process.cwd()) {
   const dir = join82(cwd, STATE_DIR_NAME);
-  if (!existsSync73(dir)) return [];
+  if (!existsSync74(dir)) return [];
   return readdirSync31(dir).filter((f3) => f3.startsWith(STATE_FILE_PREFIX) && f3.endsWith(".json")).map((f3) => f3.slice(STATE_FILE_PREFIX.length, -".json".length));
 }
 function requireStack(stackName, cwd = process.cwd()) {
@@ -96966,7 +97311,7 @@ var init_state = __esm({
 
 // src/commands/lambda/sam.ts
 import { execFileSync as execFileSync9, spawnSync as spawnSync4 } from "child_process";
-import { existsSync as existsSync74 } from "fs";
+import { existsSync as existsSync75 } from "fs";
 import { join as join83 } from "path";
 function assertSamAvailable() {
   try {
@@ -96988,7 +97333,7 @@ function assertAwsCliAvailable() {
 }
 function locateSamTemplate(repoRoot2) {
   const candidate = join83(repoRoot2, "examples", "aws-lambda", "template.yaml");
-  if (!existsSync74(candidate)) {
+  if (!existsSync75(candidate)) {
     throw new Error(
       `[lambda] SAM template not found at ${candidate}. If you're running from an installed package, point --sam-template at your local copy of examples/aws-lambda/template.yaml.`
     );
@@ -97083,17 +97428,17 @@ var init_sam = __esm({
 });
 
 // src/commands/lambda/repoRoot.ts
-import { existsSync as existsSync75 } from "fs";
+import { existsSync as existsSync76 } from "fs";
 import { dirname as dirname31, resolve as resolve44 } from "path";
 import { fileURLToPath as fileURLToPath11 } from "url";
 function repoRoot() {
   const override = process.env.HYPERFRAMES_REPO_ROOT;
-  if (override && existsSync75(resolve44(override, "packages", "aws-lambda", "package.json"))) {
+  if (override && existsSync76(resolve44(override, "packages", "aws-lambda", "package.json"))) {
     return override;
   }
   let dir = dirname31(fileURLToPath11(import.meta.url));
   for (let depth = 0; depth < 12; depth++) {
-    if (existsSync75(resolve44(dir, "packages", "aws-lambda", "package.json"))) {
+    if (existsSync76(resolve44(dir, "packages", "aws-lambda", "package.json"))) {
       return dir;
     }
     const parent = dirname31(dir);
@@ -97116,7 +97461,7 @@ __export(deploy_exports, {
   runDeploy: () => runDeploy
 });
 import { spawnSync as spawnSync5 } from "child_process";
-import { existsSync as existsSync76 } from "fs";
+import { existsSync as existsSync77 } from "fs";
 import { join as join84, resolve as resolve45 } from "path";
 async function runDeploy(args = {}) {
   const resolved = {
@@ -97135,7 +97480,7 @@ async function runDeploy(args = {}) {
     buildHandlerZip(root);
   } else {
     const zip = join84(root, "packages", "aws-lambda", "dist", "handler.zip");
-    if (!existsSync76(zip)) {
+    if (!existsSync77(zip)) {
       throw new Error(
         `--skip-build set but ${zip} does not exist. Run \`bun run --cwd packages/aws-lambda build:zip\` first or drop --skip-build.`
       );
@@ -97246,23 +97591,61 @@ var init_sites = __esm({
   }
 });
 
+// src/commands/lambda/_dimensions.ts
+import { readFileSync as readFileSync54 } from "fs";
+import { join as join85 } from "path";
+function warnOnDimensionMismatch(args) {
+  if (args.quiet) return;
+  if (args.outputResolution) return;
+  let html;
+  try {
+    html = readFileSync54(join85(args.projectDir, "index.html"), "utf-8");
+  } catch {
+    return;
+  }
+  const composition = findCompositionDimensions(html);
+  if (!composition) return;
+  if (composition.width === args.cliWidth && composition.height === args.cliHeight) return;
+  console.warn(
+    c2.warn(
+      `--width/--height (${args.cliWidth}\xD7${args.cliHeight}) disagrees with the composition's data-width/data-height (${composition.width}\xD7${composition.height}). The runtime lays out the page at the composition's authored dimensions, so your output will be ${composition.width}\xD7${composition.height}, not ${args.cliWidth}\xD7${args.cliHeight}.
+  To supersample to a higher resolution, pass --output-resolution (e.g. \`--output-resolution=4k\`).
+  To truly change layout dimensions, edit the composition's data-width/data-height in index.html.`
+    )
+  );
+}
+var init_dimensions = __esm({
+  "src/commands/lambda/_dimensions.ts"() {
+    "use strict";
+    init_colors();
+    init_compositionViewport();
+  }
+});
+
 // src/commands/lambda/render.ts
 var render_exports2 = {};
 __export(render_exports2, {
   runRender: () => runRender
 });
-import { existsSync as existsSync77 } from "fs";
-import { join as join85, resolve as resolvePath2 } from "path";
+import { existsSync as existsSync78 } from "fs";
+import { join as join86, resolve as resolvePath2 } from "path";
 async function loadSDK2() {
   return import("@hyperframes/aws-lambda/sdk");
 }
 async function runRender(args) {
   const stack = requireStack(args.stackName);
   const projectDir = resolvePath2(args.projectDir);
+  warnOnDimensionMismatch({
+    projectDir,
+    cliWidth: args.width,
+    cliHeight: args.height,
+    outputResolution: args.outputResolution,
+    quiet: args.json
+  });
   const variables = resolveVariablesArg(args.variables, args.variablesFile);
   if (variables && Object.keys(variables).length > 0) {
-    const indexPath = join85(projectDir, "index.html");
-    if (existsSync77(indexPath)) {
+    const indexPath = join86(projectDir, "index.html");
+    if (existsSync78(indexPath)) {
       const issues = validateVariablesAgainstProject(indexPath, variables);
       reportVariableIssues(issues, { strict: args.strictVariables ?? false, quiet: args.json });
     } else if (args.strictVariables && !args.json) {
@@ -97277,6 +97660,7 @@ async function runRender(args) {
     fps: args.fps,
     width: args.width,
     height: args.height,
+    outputResolution: args.outputResolution,
     format: args.format,
     codec: args.codec,
     quality: args.quality,
@@ -97372,6 +97756,7 @@ var init_render3 = __esm({
     "use strict";
     init_colors();
     init_variables();
+    init_dimensions();
     init_state();
   }
 });
@@ -97383,8 +97768,8 @@ __export(render_batch_exports, {
   runRenderBatch: () => runRenderBatch,
   runWithConcurrencyLimit: () => runWithConcurrencyLimit
 });
-import { existsSync as existsSync78, readFileSync as readFileSync52 } from "fs";
-import { join as join86, resolve as resolvePath3 } from "path";
+import { existsSync as existsSync79, readFileSync as readFileSync55 } from "fs";
+import { join as join87, resolve as resolvePath3 } from "path";
 async function loadSDK3() {
   return import("@hyperframes/aws-lambda/sdk");
 }
@@ -97392,7 +97777,7 @@ async function runRenderBatch(args) {
   const projectDir = resolvePath3(args.projectDir);
   const stack = requireStack(args.stackName);
   const batchPath = resolvePath3(args.batch);
-  if (!existsSync78(batchPath)) {
+  if (!existsSync79(batchPath)) {
     errorBox("Batch file not found", `No such file: ${batchPath}`);
     process.exit(1);
   }
@@ -97401,7 +97786,14 @@ async function runRenderBatch(args) {
     errorBox("Empty batch", `${batchPath} contains zero entries (every line was blank).`);
     process.exit(1);
   }
-  const schema = loadProjectVariableSchema(join86(projectDir, "index.html"));
+  warnOnDimensionMismatch({
+    projectDir,
+    cliWidth: args.width,
+    cliHeight: args.height,
+    outputResolution: args.outputResolution,
+    quiet: args.json
+  });
+  const schema = loadProjectVariableSchema(join87(projectDir, "index.html"));
   const strict = args.strictVariables ?? false;
   let hadStrictIssue = false;
   for (const { entry, lineNumber } of entries2) {
@@ -97426,6 +97818,7 @@ async function runRenderBatch(args) {
     fps: args.fps,
     width: args.width,
     height: args.height,
+    outputResolution: args.outputResolution,
     format: args.format,
     codec: args.codec,
     quality: args.quality,
@@ -97527,7 +97920,7 @@ function makePlaceholderSiteHandle(siteId, bucketName) {
   };
 }
 function parseBatchFile(path2) {
-  const raw = readFileSync52(path2, "utf8");
+  const raw = readFileSync55(path2, "utf8");
   const lines = raw.split(/\r?\n/);
   const out = [];
   for (let i2 = 0; i2 < lines.length; i2++) {
@@ -97608,6 +98001,7 @@ var init_render_batch = __esm({
     init_colors();
     init_format();
     init_variables();
+    init_dimensions();
     init_state();
     DEFAULT_MAX_CONCURRENT = 50;
   }
@@ -97720,7 +98114,7 @@ __export(policies_exports, {
   runPolicies: () => runPolicies,
   validatePolicy: () => validatePolicy
 });
-import { readFileSync as readFileSync53 } from "fs";
+import { readFileSync as readFileSync56 } from "fs";
 function allRequiredActions() {
   const set = /* @__PURE__ */ new Set();
   for (const group of Object.values(REQUIRED_ACTIONS)) {
@@ -97826,7 +98220,7 @@ async function runPolicies(args) {
   }
 }
 function validatePolicy(policyPath) {
-  const raw = readFileSync53(policyPath, "utf-8");
+  const raw = readFileSync56(policyPath, "utf-8");
   const parsed = JSON.parse(raw);
   const statements = Array.isArray(parsed.Statement) ? parsed.Statement : parsed.Statement ? [
     parsed.Statement
@@ -98014,11 +98408,20 @@ function parseEnum(raw, allowed, errorPrefix, defaultValue) {
   if (allowed.includes(s2)) return s2;
   throw new Error(`${errorPrefix} must be ${allowed.join("|")}; got ${s2}`);
 }
+function parseOutputResolution(raw) {
+  if (raw == null || raw === "") return void 0;
+  const normalized = normalizeResolutionFlag(String(raw));
+  if (normalized) return normalized;
+  throw new Error(
+    `[lambda render] --output-resolution must be one of ${VALID_CANVAS_RESOLUTIONS.join("|")} (or an alias: 1080p, 4k, uhd, hd, 1080p-portrait, portrait-1080p, 4k-portrait, 1080p-square, square-1080p, 4k-square); got ${String(raw)}`
+  );
+}
 var examples24, HELP, lambda_default, FORMATS, CODECS, QUALITIES2, CHROME_SOURCES, parseFormat, parseCodec, parseQuality, parseChromeSource;
 var init_lambda = __esm({
   "src/commands/lambda.ts"() {
     "use strict";
     init_dist();
+    init_src();
     init_colors();
     examples24 = [
       ["Deploy the Lambda render stack to AWS", "hyperframes lambda deploy"],
@@ -98030,6 +98433,10 @@ var init_lambda = __esm({
         "Render and stream progress until done",
         "hyperframes lambda render ./my-project --width 1920 --height 1080 --wait"
       ],
+      [
+        "Supersample a 1080p composition to 4K via Chrome deviceScaleFactor",
+        "hyperframes lambda render ./my-project --width 1920 --height 1080 --output-resolution 4k --wait"
+      ],
       [
         "Render with composition variables (personalised template)",
         `hyperframes lambda render ./my-template --site-id abc1234deadbeef0 --width 1920 --height 1080 --variables '{"title":"Hello Alice","accent":"#ff0000"}'`
@@ -98114,6 +98521,10 @@ ${c2.bold("REQUIREMENTS:")}
         "site-id": { type: "string", description: "Explicit site id (overrides content hash)" },
         width: { type: "string", description: "Render width in pixels" },
         height: { type: "string", description: "Render height in pixels" },
+        "output-resolution": {
+          type: "string",
+          description: "Output resolution preset that engages Chrome deviceScaleFactor supersampling. Accepts canonical names (landscape, landscape-4k, portrait, portrait-4k, square, square-4k) and aliases (1080p, 4k, uhd, hd). When set, the composition's authored data-width/data-height is supersampled to the target preset without changing the layout."
+        },
         fps: { type: "string", description: "Render fps (24 | 30 | 60)" },
         format: { type: "string", description: "mp4 | mov | png-sequence | webm (default: mp4)" },
         codec: { type: "string", description: "h264 | h265 (mp4 only)" },
@@ -98268,6 +98679,7 @@ Or, for an opt-in dev setup:
               fps: fpsRaw,
               width,
               height,
+              outputResolution: parseOutputResolution(args["output-resolution"]),
               format: parseFormat(args.format),
               codec: parseCodec(args.codec),
               quality: parseQuality(args.quality),
@@ -98319,6 +98731,7 @@ Or, for an opt-in dev setup:
               fps: fpsRaw,
               width,
               height,
+              outputResolution: parseOutputResolution(args["output-resolution"]),
               format: parseFormat(args.format),
               codec: parseCodec(args.codec),
               quality: parseQuality(args.quality),
@@ -98521,7 +98934,7 @@ __export(autoUpdate_exports, {
 import { spawn as spawn16 } from "child_process";
 import { appendFileSync as appendFileSync2, mkdirSync as mkdirSync42, openSync as openSync2 } from "fs";
 import { homedir as homedir12 } from "os";
-import { join as join87 } from "path";
+import { join as join88 } from "path";
 import { compareVersions as compareVersions2 } from "compare-versions";
 function isAutoInstallDisabled() {
   if (isDevMode()) return true;
@@ -98544,7 +98957,7 @@ function log(line) {
 }
 function launchDetachedInstall(installCommand, version) {
   mkdirSync42(CONFIG_DIR2, { recursive: true, mode: 448 });
-  const configFile = join87(CONFIG_DIR2, "config.json");
+  const configFile = join88(CONFIG_DIR2, "config.json");
   const nodeScript = `
     const { exec } = require("node:child_process");
     const { readFileSync, renameSync, writeFileSync } = require("node:fs");
@@ -98663,8 +99076,8 @@ var init_autoUpdate = __esm({
     init_config();
     init_env();
     init_installerDetection();
-    CONFIG_DIR2 = join87(homedir12(), ".hyperframes");
-    LOG_FILE = join87(CONFIG_DIR2, "auto-update.log");
+    CONFIG_DIR2 = join88(homedir12(), ".hyperframes");
+    LOG_FILE = join88(CONFIG_DIR2, "auto-update.log");
     PENDING_TIMEOUT_MS = 10 * 60 * 1e3;
   }
 });
@@ -98852,17 +99265,17 @@ var init_help = __esm({
 // src/cli.ts
 init_version();
 init_dist();
-import { dirname as dirname32, join as join88 } from "path";
+import { dirname as dirname32, join as join89 } from "path";
 import { fileURLToPath as fileURLToPath12 } from "url";
-import { existsSync as existsSync79 } from "fs";
+import { existsSync as existsSync80 } from "fs";
 (() => {
   const here = dirname32(fileURLToPath12(import.meta.url));
-  const shader = join88(here, "shaderTransitionWorker.js");
-  const png = join88(here, "pngDecodeBlitWorker.js");
-  if (!process.env.HF_SHADER_WORKER_ENTRY && existsSync79(shader)) {
+  const shader = join89(here, "shaderTransitionWorker.js");
+  const png = join89(here, "pngDecodeBlitWorker.js");
+  if (!process.env.HF_SHADER_WORKER_ENTRY && existsSync80(shader)) {
     process.env.HF_SHADER_WORKER_ENTRY = shader;
   }
-  if (!process.env.HF_PNG_DECODE_BLIT_WORKER_ENTRY && existsSync79(png)) {
+  if (!process.env.HF_PNG_DECODE_BLIT_WORKER_ENTRY && existsSync80(png)) {
     process.env.HF_PNG_DECODE_BLIT_WORKER_ENTRY = png;
   }
 })();
@@ -98874,10 +99287,10 @@ if (rootVersionRequested) {
   process.exit(0);
 }
 try {
-  const { readFileSync: readFileSync54 } = await import("fs");
+  const { readFileSync: readFileSync57 } = await import("fs");
   const { resolve: resolve46 } = await import("path");
   const envPath = resolve46(process.cwd(), ".env");
-  const envContent = readFileSync54(envPath, "utf-8");
+  const envContent = readFileSync57(envPath, "utf-8");
   for (const rawLine of envContent.split("\n")) {
     let line = rawLine.trim();
     if (!line || line.startsWith("#")) continue;