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>

packages/engine/src/cdp-headless-experimental.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Type augmentation for Chrome's HeadlessExperimental CDP domain.
+ *
+ * Puppeteer's CDPSession.send() is typed against devtools-protocol's
+ * ProtocolMapping.Commands, which does not include HeadlessExperimental.
+ * This module augmentation adds proper types so we can call these methods
+ * without unsafe `as any` casts.
+ */
+
+/** Parameters for HeadlessExperimental.beginFrame */
+interface HeadlessExperimentalBeginFrameRequest {
+  /** Timestamp in milliseconds since epoch for the frame */
+  frameTimeTicks: number;
+  /** Interval in milliseconds between frames */
+  interval: number;
+  /** If true, do not produce display updates (warmup mode) */
+  noDisplayUpdates?: boolean;
+  /** Optional screenshot configuration */
+  screenshot?: {
+    format: "jpeg" | "png";
+    quality?: number;
+    optimizeForSpeed?: boolean;
+  };
+}
+
+/** Response from HeadlessExperimental.beginFrame */
+interface HeadlessExperimentalBeginFrameResponse {
+  /** Whether the compositor reported visual damage */
+  hasDamage: boolean;
+  /** Base64-encoded screenshot data (present only when screenshot was requested and hasDamage is true) */
+  screenshotData?: string;
+}
+
+export {};
+
+declare module "devtools-protocol/types/protocol-mapping.js" {
+  // Merge into the existing ProtocolMapping namespace
+  export namespace ProtocolMapping {
+    interface Commands {
+      "HeadlessExperimental.enable": {
+        paramsType: [];
+        returnType: void;
+      };
+      "HeadlessExperimental.disable": {
+        paramsType: [];
+        returnType: void;
+      };
+      "HeadlessExperimental.beginFrame": {
+        paramsType: [HeadlessExperimentalBeginFrameRequest];
+        returnType: HeadlessExperimentalBeginFrameResponse;
+      };
+    }
+  }
+}