Merge remote-tracking branch 'origin/main' into fix/studio-step-list-hold

# Conflicts:
#	packages/studio/src/hooks/gsapRuntimeKeyframes.ts

Author: miguel-heygen

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "hyperframes",
   "description": "HyperFrames by HeyGen. Write HTML, render video. Compositions, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.8.123",
+  "version": "0.8.125",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com",

.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "hyperframes",
   "description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.8.123",
+  "version": "0.8.125",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com",

.cursor-plugin/plugin.json

@@ -3,7 +3,7 @@
   "name": "hyperframes",
   "displayName": "HyperFrames by HeyGen",
   "description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.8.123",
+  "version": "0.8.125",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com"

.github/workflows/ci.yml

@@ -987,6 +987,11 @@ jobs:
             node packages/studio/tests/e2e/thumbnail-save.mjs || rc=1
           STUDIO_URL="http://localhost:5316/#project/timeline-trim-snap" \
             node packages/studio/tests/e2e/timeline-trim-snap.mjs || rc=1
+          rm -rf packages/studio/data/projects/timeline-trim-snap
+          cp -R packages/studio/tests/e2e/fixtures/timeline-trim-snap \
+            packages/studio/data/projects/timeline-trim-snap
+          STUDIO_URL="http://localhost:5316/#project/timeline-trim-snap" \
+            node packages/studio/tests/e2e/timeline-snap-release.mjs || rc=1
           exit "$rc"
       - name: Measure the caret of a text edited in place
         if: success() || failure()

docs/changelog.mdx

@@ -8,6 +8,53 @@ Recent HyperFrames releases, including user-facing features, fixes, and migratio
 
 {/* New release entries are prepended by `bun run changelog:draft <version> --write`. */}
 
+<Update
+  label="HyperFrames v0.8.125"
+  description="Released - 2026-10-04"
+  tags={["Release", "Studio", "Core", "Skills"]}
+>
+A cropped layer's edge now stays exact while GSAP animates it, in preview and export, and undoing a resize, rotate or GSAP edit shows the change undone at once while it saves.
+
+## Fixes
+
+- **Studio:** Undo shows a resize, rotate or GSAP edit undone at once while it saves ([49333a882d34](https://github.com/heygen-com/hyperframes/commit/49333a882d343cef768f16739a84643296e9da5d), [#5022](https://github.com/heygen-com/hyperframes/pull/5022)).
+- **Core:** A cropped element's edge stays exact while GSAP tweens it ([99c389bce9fd](https://github.com/heygen-com/hyperframes/commit/99c389bce9fd893f3c0052c11f6e4844a5da33ab), [#5010](https://github.com/heygen-com/hyperframes/pull/5010)).
+
+## Docs & Examples
+
+- **Skills:** Fix wrong facts and broken paths from the doctrine audit ([0c3e244269aa](https://github.com/heygen-com/hyperframes/commit/0c3e244269aae698149214379280377a9f7a2f2b), [#5026](https://github.com/heygen-com/hyperframes/pull/5026)).
+- **Skills:** Resolve cross-skill contradictions from the doctrine audit ([173103dfdec5](https://github.com/heygen-com/hyperframes/commit/173103dfdec5738f85733e6796d56932ad2a7436), [#5028](https://github.com/heygen-com/hyperframes/pull/5028)).
+
+[View the full commit range](https://github.com/heygen-com/hyperframes/compare/v0.8.124...v0.8.125).
+</Update>
+
+<Update
+  label="HyperFrames v0.8.124"
+  description="Released - 2026-10-04"
+  tags={["Release", "Studio Server", "Studio", "CLI"]}
+>
+Undo in Studio now takes added media back with the file, snapping no longer moves a clip to a place it would not save, and motion paths animate when GSAP loads deferred. Media-use can clone, list and delete HeyGen voices.
+
+## Features
+
+- **Studio:** Make edit with framey stand out in the header ([2b82e39cd6fd](https://github.com/heygen-com/hyperframes/commit/2b82e39cd6fde19a74ce4855d5bfc05ceb42b864), [#5019](https://github.com/heygen-com/hyperframes/pull/5019)).
+- **Media Use:** Clone, list and delete HeyGen voices, and accept a host OAuth token ([2497402b270a](https://github.com/heygen-com/hyperframes/commit/2497402b270a4f613cf57abc1c29cbc260fb8c07), [#4992](https://github.com/heygen-com/hyperframes/pull/4992)).
+- **Skills:** Open Studio before every final render ([69a2169bde0c](https://github.com/heygen-com/hyperframes/commit/69a2169bde0c134f42979e1911755084b1c29962), [#4952](https://github.com/heygen-com/hyperframes/pull/4952)).
+- **Cli,studio:** Hand off on macOS now, and open the app on Windows and Linux ([6a27a34f21ef](https://github.com/heygen-com/hyperframes/commit/6a27a34f21ef178d3c5189ab8a4a9f6709c528da), [#4999](https://github.com/heygen-com/hyperframes/pull/4999)).
+
+## Fixes
+
+- **Studio Server:** Undoing a change takes the media ledger back with the film ([a2f41608993e](https://github.com/heygen-com/hyperframes/commit/a2f41608993e3fa74b81b5845d3000a7a0be698e), [#5016](https://github.com/heygen-com/hyperframes/pull/5016)).
+- **CLI:** A project .env cannot set the feedback email in another letter case ([dcc721062b51](https://github.com/heygen-com/hyperframes/commit/dcc721062b51776049d9c8fb4a0bf7fade388888), [#5018](https://github.com/heygen-com/hyperframes/pull/5018)).
+- **Studio:** A video's sound reads on its clip like an audio row ([ed5c1000b1f1](https://github.com/heygen-com/hyperframes/commit/ed5c1000b1f17e9365e9600e9e8e3993ae7a74be), [#5015](https://github.com/heygen-com/hyperframes/pull/5015)).
+- **Studio:** A snap the saved clip would miss no longer moves it ([48bfe618030d](https://github.com/heygen-com/hyperframes/commit/48bfe618030deb3ecedce23a5254d71e7cbd5426), [#5006](https://github.com/heygen-com/hyperframes/pull/5006)).
+- **Studio Server:** Motion paths animate when gsap has a query string or loads deferred ([5cee25efcb8d](https://github.com/heygen-com/hyperframes/commit/5cee25efcb8d6d771e312908f9a54d7fe2a9b3ce), [#5007](https://github.com/heygen-com/hyperframes/pull/5007)).
+- **Studio:** An audio clip's name pill draws over its waveform ([4a5e38eed64b](https://github.com/heygen-com/hyperframes/commit/4a5e38eed64bb361b078eeba9fc5d756d93aa9a2), [#5013](https://github.com/heygen-com/hyperframes/pull/5013)).
+- **Studio:** A first animation in a full-document sub-composition plays ([399f49104e24](https://github.com/heygen-com/hyperframes/commit/399f49104e24ff716e2ca51f024dd8863d9df61a), [#5008](https://github.com/heygen-com/hyperframes/pull/5008)).
+
+[View the full commit range](https://github.com/heygen-com/hyperframes/compare/v0.8.123...v0.8.124).
+</Update>
+
 <Update
   label="HyperFrames v0.8.123"
   description="Released - 2026-10-04"

gemini-extension.json

@@ -1,5 +1,5 @@
 {
   "name": "hyperframes",
-  "version": "0.8.123",
+  "version": "0.8.125",
   "description": "HyperFrames by HeyGen. Write HTML, render video. Compositions, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames."
 }

packages/aws-lambda/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/aws-lambda",
-  "version": "0.8.123",
+  "version": "0.8.125",
   "description": "AWS Lambda adapter for HyperFrames distributed rendering — handler, client-side SDK, and CDK construct.",
   "repository": {
     "type": "git",

packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/cli",
-  "version": "0.8.123",
+  "version": "0.8.125",
   "description": "HyperFrames CLI — create, preview, and render HTML video compositions",
   "license": "Apache-2.0",
   "repository": {

packages/cli/src/capture/scaffolding.test.ts

@@ -2,7 +2,7 @@ import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import * as fs from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
-import { generateProjectScaffold } from "./scaffolding.js";
+import { generateProjectScaffold, loadEnvFile } from "./scaffolding.js";
 import type { DesignTokens } from "./types.js";
 
 vi.mock("node:fs", async (importOriginal) => {
@@ -123,3 +123,26 @@ describe("generateProjectScaffold metadata", () => {
     },
   );
 });
+
+describe("loadEnvFile", () => {
+  const keys = ["hyperframes_feedback_email", "HyperFrames_Feedback_Email", "HF_SCAFFOLD_TEST_KEY"];
+  let dir: string;
+
+  beforeEach(() => {
+    dir = fs.mkdtempSync(join(tmpdir(), "hf-scaffold-env-"));
+  });
+
+  afterEach(() => {
+    for (const key of keys) delete process.env[key];
+    fs.rmSync(dir, { recursive: true, force: true });
+  });
+
+  it("never takes the feedback email from a project file, in any letter case", () => {
+    fs.writeFileSync(
+      join(dir, ".env"),
+      'hyperframes_feedback_email=a@example.com\nHyperFrames_Feedback_Email=b@example.com\nHF_SCAFFOLD_TEST_KEY="kept"\n',
+    );
+    loadEnvFile(join(dir, "out"));
+    expect(keys.map((key) => process.env[key])).toEqual([undefined, undefined, "kept"]);
+  });
+});

packages/cli/src/capture/scaffolding.ts

@@ -7,6 +7,7 @@
 
 import { existsSync, readFileSync } from "node:fs";
 import { join, resolve } from "node:path";
+import { applyDotEnv } from "../utils/dotEnv.js";
 import { writeNewFileSync } from "../utils/writeNewFile.js";
 import type { CatalogedAsset } from "./assetCataloger.js";
 import type { CaptureResult, DesignTokens } from "./types.js";
@@ -21,19 +22,7 @@ export function loadEnvFile(startDir: string): void {
     for (let i = 0; i < 5; i++) {
       const envPath = resolve(dir, ".env");
       try {
-        const envContent = readFileSync(envPath, "utf-8");
-        for (const line of envContent.split("\n")) {
-          const trimmed = line.trim();
-          if (!trimmed || trimmed.startsWith("#")) continue;
-          const eq = trimmed.indexOf("=");
-          if (eq === -1) continue;
-          const key = trimmed.slice(0, eq).trim();
-          const val = trimmed
-            .slice(eq + 1)
-            .trim()
-            .replace(/^["']|["']$/g, "");
-          if (!process.env[key]) process.env[key] = val;
-        }
+        applyDotEnv(readFileSync(envPath, "utf-8"), process.env);
         break;
       } catch {
         dir = resolve(dir, "..");