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/analytics.test.ts

@@ -0,0 +1,60 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { initRuntimeAnalytics, emitAnalyticsEvent } from "./analytics";
+
+describe("runtime analytics", () => {
+  let postMessage: ReturnType<typeof vi.fn>;
+
+  beforeEach(() => {
+    postMessage = vi.fn();
+    // Reset module state by re-init
+    initRuntimeAnalytics(postMessage);
+  });
+
+  it("emits analytics event via postMessage", () => {
+    emitAnalyticsEvent("composition_loaded");
+    expect(postMessage).toHaveBeenCalledWith({
+      source: "hf-preview",
+      type: "analytics",
+      event: "composition_loaded",
+      properties: {},
+    });
+  });
+
+  it("passes properties through", () => {
+    emitAnalyticsEvent("composition_played", { duration: 10, autoplay: true });
+    expect(postMessage).toHaveBeenCalledWith({
+      source: "hf-preview",
+      type: "analytics",
+      event: "composition_played",
+      properties: { duration: 10, autoplay: true },
+    });
+  });
+
+  it("does not throw when postMessage is not set", () => {
+    // Re-init with a function that we'll clear
+    initRuntimeAnalytics(null as unknown as (payload: unknown) => void);
+    expect(() => emitAnalyticsEvent("composition_paused")).not.toThrow();
+  });
+
+  it("does not throw when postMessage throws", () => {
+    postMessage.mockImplementation(() => {
+      throw new Error("channel closed");
+    });
+    expect(() => emitAnalyticsEvent("composition_seeked")).not.toThrow();
+  });
+
+  it("emits all event types", () => {
+    const events = [
+      "composition_loaded",
+      "composition_played",
+      "composition_paused",
+      "composition_seeked",
+      "composition_ended",
+      "element_picked",
+    ] as const;
+    for (const event of events) {
+      emitAnalyticsEvent(event);
+    }
+    expect(postMessage).toHaveBeenCalledTimes(events.length);
+  });
+});