From af5f3e5fabd4822766ef9c8662d6242d6c69fca9 Mon Sep 17 00:00:00 2001
From: Vance Ingalls <vance@heygen.com>
Date: Fri, 3 Jul 2026 23:07:38 -0700
Subject: [PATCH] chore: release v0.7.31

---
 .claude-plugin/plugin.json               |  2 +-
 .codex-plugin/plugin.json                |  2 +-
 .cursor-plugin/plugin.json               |  2 +-
 docs/changelog.mdx                       | 14 ++++++++++++++
 packages/aws-lambda/package.json         |  2 +-
 packages/cli/package.json                |  2 +-
 packages/core/package.json               |  2 +-
 packages/engine/package.json             |  2 +-
 packages/gcp-cloud-run/package.json      |  2 +-
 packages/lint/package.json               |  2 +-
 packages/parsers/package.json            |  2 +-
 packages/player/package.json             |  2 +-
 packages/producer/package.json           |  2 +-
 packages/sdk/package.json                |  2 +-
 packages/shader-transitions/package.json |  2 +-
 packages/studio-server/package.json      |  2 +-
 packages/studio/package.json             |  2 +-
 releases/v0.7.31.md                      | 13 +++++++++++++
 18 files changed, 43 insertions(+), 16 deletions(-)
 create mode 100644 releases/v0.7.31.md

diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 7cacd8e0d..9f3d027ca 100644
--- a/.claude-plugin/plugin.json
+++ b/.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-to-video capture for HyperFrames.",
-  "version": "0.7.30",
+  "version": "0.7.31",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com",
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
index e657b62fc..59babf9f8 100644
--- a/.codex-plugin/plugin.json
+++ b/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "hyperframes",
-  "version": "0.7.30",
+  "version": "0.7.31",
   "description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website-to-video capture for HyperFrames.",
   "author": {
     "name": "HeyGen",
diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json
index 3ce6a4c53..314dc94a8 100644
--- a/.cursor-plugin/plugin.json
+++ b/.cursor-plugin/plugin.json
@@ -2,7 +2,7 @@
   "$schema": "https://cursor.com/schemas/cursor-plugin/plugin.json",
   "name": "hyperframes",
   "displayName": "HyperFrames by HeyGen",
-  "version": "0.7.30",
+  "version": "0.7.31",
   "description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website-to-video capture for HyperFrames.",
   "author": {
     "name": "HeyGen",
diff --git a/docs/changelog.mdx b/docs/changelog.mdx
index 3a551f5c6..12ab100cd 100644
--- a/docs/changelog.mdx
+++ b/docs/changelog.mdx
@@ -8,6 +8,20 @@ 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.7.31"
+  description="Released - 2026-07-04"
+  tags={["Release", "Core,cli"]}
+>
+This release makes Figma imports first-class citizens of the shared media inventory: every `hyperframes figma asset` import now regenerates `.media/index.md` (byte-identical with media-use's format), carries `--description`/`--entity` metadata into the manifest, index, and alt text, and the reuse path correctly upserts metadata and dedupes against any prior format/scale/version tuple. media-use's entity lookups now match figma-imported brand marks across the icon/image boundary.
+
+## Features
+
+- **Core,cli:** Media-use interop — shared index.md regen + description/entity on figma imports ([3900caaaa](https://github.com/heygen-com/hyperframes/commit/3900caaaa94443efb01597dac26df1533f8add35), [#1927](https://github.com/heygen-com/hyperframes/pull/1927))
+
+[View the full commit range](https://github.com/heygen-com/hyperframes/compare/v0.7.30...v0.7.31).
+</Update>
+
 <Update
   label="HyperFrames v0.7.30"
   description="Released - 2026-07-04"
diff --git a/packages/aws-lambda/package.json b/packages/aws-lambda/package.json
index e0ded4e6f..302f7ffe7 100644
--- a/packages/aws-lambda/package.json
+++ b/packages/aws-lambda/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/aws-lambda",
-  "version": "0.7.30",
+  "version": "0.7.31",
   "description": "AWS Lambda adapter for HyperFrames distributed rendering — handler, client-side SDK, and CDK construct.",
   "repository": {
     "type": "git",
diff --git a/packages/cli/package.json b/packages/cli/package.json
index c0b647ea6..6b928b11e 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/cli",
-  "version": "0.7.30",
+  "version": "0.7.31",
   "description": "HyperFrames CLI — create, preview, and render HTML video compositions",
   "repository": {
     "type": "git",
diff --git a/packages/core/package.json b/packages/core/package.json
index deb13eadc..6ba28f4d2 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/core",
-  "version": "0.7.30",
+  "version": "0.7.31",
   "description": "",
   "repository": {
     "type": "git",
diff --git a/packages/engine/package.json b/packages/engine/package.json
index 2c997ab12..c03093c21 100644
--- a/packages/engine/package.json
+++ b/packages/engine/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/engine",
-  "version": "0.7.30",
+  "version": "0.7.31",
   "description": "Seekable web page to video rendering engine (Puppeteer + FFmpeg)",
   "repository": {
     "type": "git",
diff --git a/packages/gcp-cloud-run/package.json b/packages/gcp-cloud-run/package.json
index 3975e8b9f..d193c4871 100644
--- a/packages/gcp-cloud-run/package.json
+++ b/packages/gcp-cloud-run/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/gcp-cloud-run",
-  "version": "0.7.30",
+  "version": "0.7.31",
   "description": "Google Cloud Run + Workflows adapter for HyperFrames distributed rendering — request handler, client-side SDK, and Terraform module.",
   "repository": {
     "type": "git",
diff --git a/packages/lint/package.json b/packages/lint/package.json
index 1a123c4be..18d6fc930 100644
--- a/packages/lint/package.json
+++ b/packages/lint/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/lint",
-  "version": "0.7.30",
+  "version": "0.7.31",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/parsers/package.json b/packages/parsers/package.json
index 477cdbaea..6632c44d0 100644
--- a/packages/parsers/package.json
+++ b/packages/parsers/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/parsers",
-  "version": "0.7.30",
+  "version": "0.7.31",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/player/package.json b/packages/player/package.json
index 85cd9c0cf..cdab0057f 100644
--- a/packages/player/package.json
+++ b/packages/player/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/player",
-  "version": "0.7.30",
+  "version": "0.7.31",
   "description": "Embeddable web component for HyperFrames compositions",
   "repository": {
     "type": "git",
diff --git a/packages/producer/package.json b/packages/producer/package.json
index bc0828054..5788c6962 100644
--- a/packages/producer/package.json
+++ b/packages/producer/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/producer",
-  "version": "0.7.30",
+  "version": "0.7.31",
   "description": "HTML-to-video rendering engine using Chrome's BeginFrame API",
   "repository": {
     "type": "git",
diff --git a/packages/sdk/package.json b/packages/sdk/package.json
index 810d45e98..3044f016f 100644
--- a/packages/sdk/package.json
+++ b/packages/sdk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/sdk",
-  "version": "0.7.30",
+  "version": "0.7.31",
   "description": "Headless, framework-neutral HyperFrames composition editing engine",
   "repository": {
     "type": "git",
diff --git a/packages/shader-transitions/package.json b/packages/shader-transitions/package.json
index 56dadc472..a03ac06d9 100644
--- a/packages/shader-transitions/package.json
+++ b/packages/shader-transitions/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/shader-transitions",
-  "version": "0.7.30",
+  "version": "0.7.31",
   "description": "WebGL shader transitions for HyperFrames compositions",
   "repository": {
     "type": "git",
diff --git a/packages/studio-server/package.json b/packages/studio-server/package.json
index eb84caf87..5d7443e8d 100644
--- a/packages/studio-server/package.json
+++ b/packages/studio-server/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio-server",
-  "version": "0.7.30",
+  "version": "0.7.31",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
diff --git a/packages/studio/package.json b/packages/studio/package.json
index 476a2d88e..1f73b035b 100644
--- a/packages/studio/package.json
+++ b/packages/studio/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio",
-  "version": "0.7.30",
+  "version": "0.7.31",
   "description": "",
   "repository": {
     "type": "git",
diff --git a/releases/v0.7.31.md b/releases/v0.7.31.md
new file mode 100644
index 000000000..596622e6c
--- /dev/null
+++ b/releases/v0.7.31.md
@@ -0,0 +1,13 @@
+# HyperFrames v0.7.31
+
+Released on 2026-07-04.
+
+This release makes Figma imports first-class citizens of the shared media inventory: every `hyperframes figma asset` import now regenerates `.media/index.md` (byte-identical with media-use's format), carries `--description`/`--entity` metadata into the manifest, index, and alt text, and the reuse path correctly upserts metadata and dedupes against any prior format/scale/version tuple. media-use's entity lookups now match figma-imported brand marks across the icon/image boundary.
+
+## Features
+
+- **Core,cli:** Media-use interop — shared index.md regen + description/entity on figma imports ([3900caaaa](https://github.com/heygen-com/hyperframes/commit/3900caaaa94443efb01597dac26df1533f8add35), [#1927](https://github.com/heygen-com/hyperframes/pull/1927))
+
+## Full changelog
+
+https://github.com/heygen-com/hyperframes/compare/v0.7.30...v0.7.31