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/core/src/runtime/window.d.ts

@@ -0,0 +1,66 @@
+import type { RuntimeTimelineMessage, RuntimeTimelineLike } from "./types";
+import type { HyperframePickerApi } from "../inline-scripts/pickerApi";
+import type { PlayerAPI } from "../core.types";
+
+type ThreeClockLike = {
+  elapsedTime: number;
+  oldTime: number;
+  startTime: number;
+  getElapsedTime: () => number;
+  getDelta: () => number;
+};
+
+type ThreeAnimationMixerLike = {
+  setTime?: (time: number) => void;
+  update: (deltaTime: number) => ThreeAnimationMixerLike;
+};
+
+type ThreeLike = {
+  Clock?: {
+    prototype: ThreeClockLike;
+  };
+  AnimationMixer?: {
+    prototype: ThreeAnimationMixerLike;
+  };
+};
+
+declare global {
+  interface Window {
+    __timelines: Record<string, RuntimeTimelineLike>;
+    __player?: PlayerAPI;
+    __clipManifest?: RuntimeTimelineMessage;
+    __playerReady?: boolean;
+    __renderReady?: boolean;
+    __HF_PARITY_MODE?: boolean;
+    __HF_FPS?: number;
+    __HF_MAX_DURATION_SEC?: number;
+    __hfThreeTime?: number;
+    __HF_PICKER_API?: HyperframePickerApi;
+    gsap?: {
+      timeline: (params?: { paused?: boolean }) => RuntimeTimelineLike;
+      ticker?: {
+        tick: () => void;
+      };
+    };
+    THREE?: ThreeLike;
+    /**
+     * Global lottie-web instance (set by including the lottie.min.js script).
+     * The adapter uses `lottie.getRegisteredAnimations()` for auto-discovery.
+     */
+    lottie?: {
+      loadAnimation: (params: unknown) => unknown;
+      getRegisteredAnimations: () => unknown[];
+    };
+    /**
+     * Lottie animation instances registered by compositions.
+     * The adapter seeks all instances when the player is seeked.
+     *
+     * Push your animation instance here after calling `lottie.loadAnimation()`:
+     *   window.__hfLottie = window.__hfLottie || [];
+     *   window.__hfLottie.push(anim);
+     */
+    __hfLottie?: unknown[];
+  }
+}
+
+export {};