initial code (#2)

* feat: initial code port from hyperframes-internal Port all OSS-ready packages from the internal monorepo: - @hyperframes/core — shared types, HTML generation, GSAP utilities, runtime - @hyperframes/cli — CLI for creating, previewing, and rendering compositions - @hyperframes/engine — framework-agnostic rendering engine (BeginFrame + FFmpeg) - @hyperframes/producer — video rendering pipeline (Puppeteer + FFmpeg) - @hyperframes/ui-player — browser-based video player component - @hyperframes/studio — composition editor (React frontend + Hono backend) Includes regression test suite with Docker-based test harness. All HeyGen-internal references, deployment infrastructure, and proprietary assets have been removed. Package names migrated from @app/* to @hyperframes/*. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * fix: scrub internal codenames and stale references from OSS port - Replace static.heygen.ai runtime URLs in test fixtures - Remove internal CDN publish script (publish-hyperframe-runtime.ts) - Replace sandbox-studio, sandbox-interceptor, __magicEditRuntime with neutral names (studio, hyperframe-runtime, __hyperframeRuntime) - Fix stale Vault API / localhost references in docs - Remove broken deprecated_studio link Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * fix: remove remaining internal codenames and stale references - Delete stale producer README.md and PIPELINE.md (referenced nonexistent files) - Replace "Cerberus" codename with "HyperFrames" in test design reviews - Replace magic-edit postMessage identifiers with hf-preview/hf-parent - Rename debug-magic-edit-timeline.ts to debug-timeline.ts - Replace "Motion Cut" with "HyperFrames" in Timeline comments - Fix studio/CLI references to nonexistent archive package (use local data/projects/ dir, stub render proxy) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-09-12 15:20:13 +00:00 · 2026-03-21 22:43:56 -07:00
parent 10621e7903
commit 9f8e5ba5a1
401 changed files with 54545 additions and 2 deletions
@@ -0,0 +1,133 @@
+import { defineCommand } from "citty";
+import * as clack from "@clack/prompts";
+import { c } from "../ui/colors.js";
+import { formatBytes } from "../ui/format.js";
+import {
+  ensureBrowser,
+  findBrowser,
+  clearBrowser,
+  CHROME_VERSION,
+  CACHE_DIR,
+} from "../browser/manager.js";
+
+async function runEnsure(): Promise<void> {
+  clack.intro(c.bold("hyperframes browser ensure"));
+
+  const s = clack.spinner();
+  s.start("Looking for an existing browser...");
+
+  const existing = await findBrowser();
+  if (existing) {
+    s.stop(c.success("Browser found"));
+    console.log();
+    console.log(`   ${c.dim("Source:")}  ${c.bold(existing.source)}`);
+    console.log(`   ${c.dim("Path:")}    ${c.bold(existing.executablePath)}`);
+    console.log();
+    clack.outro(c.success("Ready to render."));
+    return;
+  }
+
+  s.stop("No browser found — downloading");
+
+  const downloadSpinner = clack.spinner();
+  downloadSpinner.start(
+    `Downloading Chrome Headless Shell ${c.dim("v" + CHROME_VERSION)}...`,
+  );
+
+  let lastPct = -1;
+  const result = await ensureBrowser({
+    onProgress: (downloaded, total) => {
+      if (total <= 0) return;
+      const pct = Math.floor((downloaded / total) * 100);
+      if (pct > lastPct) {
+        lastPct = pct;
+        downloadSpinner.message(
+          `Downloading Chrome Headless Shell ${c.dim("v" + CHROME_VERSION)} — ${c.progress(pct + "%")} ${c.dim("(" + formatBytes(downloaded) + " / " + formatBytes(total) + ")")}`,
+        );
+      }
+    },
+  });
+
+  downloadSpinner.stop(c.success("Download complete"));
+
+  console.log();
+  console.log(`   ${c.dim("Source:")}  ${c.bold(result.source)}`);
+  console.log(`   ${c.dim("Path:")}    ${c.bold(result.executablePath)}`);
+  console.log();
+
+  clack.outro(c.success("Ready to render."));
+}
+
+async function runPath(): Promise<void> {
+  const result = await findBrowser();
+  if (!result) {
+    // Try a full ensure (which includes download) but write only the path
+    try {
+      const ensured = await ensureBrowser();
+      process.stdout.write(ensured.executablePath + "\n");
+    } catch (err: unknown) {
+      console.error(
+        err instanceof Error ? err.message : "Failed to find browser",
+      );
+      process.exit(1);
+    }
+    return;
+  }
+  process.stdout.write(result.executablePath + "\n");
+}
+
+function runClear(): void {
+  clack.intro(c.bold("hyperframes browser clear"));
+
+  const removed = clearBrowser();
+  if (removed) {
+    clack.outro(
+      c.success("Removed cached browser from ") + c.dim(CACHE_DIR),
+    );
+  } else {
+    clack.outro(c.dim("No cached browser to remove."));
+  }
+}
+
+export default defineCommand({
+  meta: { name: "browser", description: "Manage the Chrome browser used for rendering" },
+  args: {
+    subcommand: { type: "positional", description: "Subcommand: ensure, path, clear", required: false },
+  },
+  async run({ args }) {
+    const subcommand = args.subcommand;
+
+    if (!subcommand || subcommand === "") {
+      console.log(`
+${c.bold("hyperframes browser")} ${c.dim("<subcommand>")}
+
+Manage the Chrome browser used for rendering.
+
+${c.bold("SUBCOMMANDS:")}
+  ${c.accent("ensure")}   ${c.dim("Find or download Chrome for rendering")}
+  ${c.accent("path")}     ${c.dim("Print browser executable path (for scripting)")}
+  ${c.accent("clear")}    ${c.dim("Remove cached Chrome download")}
+
+${c.bold("EXAMPLES:")}
+  ${c.accent("npx hyperframes browser ensure")}   ${c.dim("Download Chrome if needed")}
+  ${c.accent("npx hyperframes browser path")}     ${c.dim("Print path for scripts")}
+  ${c.accent("npx hyperframes browser clear")}    ${c.dim("Remove cached browser")}
+`);
+      return;
+    }
+
+    switch (subcommand) {
+      case "ensure":
+        return runEnsure();
+      case "path":
+        return runPath();
+      case "clear":
+        return runClear();
+      default:
+        console.error(
+          `${c.error("Unknown subcommand:")} ${subcommand}\n\nRun ${c.accent("hyperframes browser --help")} for usage.`,
+        );
+        process.exit(1);
+    }
+  },
+});