mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-09-03 12:54:29 +00:00
Vance Ingalls
d0abe90a82
## Summary Studio manual geometry edits now persist as a project-local manifest instead of being baked into composition source on each gesture. The manifest lives at: ```text .hyperframes/studio-manual-edits.json ``` It is the source of truth for manual drag, resize, rotation, inspector geometry edits, group moves, and selected-layer reset. ## Architecture - **Manifest-backed edits**: each edit stores a kind (`path-offset`, `box-size`, `rotation`), a source-scoped target, and the edit values. - **Source-scoped resolution**: targets include `sourceFile`, `id`, `selector`, and `selectorIndex`, so duplicate selectors in nested compositions resolve against the owning source file. - **Additive CSS layer**: move uses CSS `translate`, resize writes stable dimensions/flex sizing, and rotation uses CSS `rotate` over the authored base. - **Shared replay runtime**: Studio preview, thumbnails, frame capture, producer renders, and CLI Studio renders/thumbnails all use the same core manual-edit render script. - **Animation-safe replay**: Studio reapplies the manual layer after load, refresh, timeline seeks, player operations, playback frames, thumbnail seeks, and render seeks instead of rewriting GSAP timelines. - **History and handoff**: the manifest is a normal project file, so undo/redo and agent edits can preserve, modify, or remove manual visual edits explicitly. ## User Impact Users can move, resize, rotate, group-move, and reset supported layers from the canvas or inspector, then refresh, capture thumbnails/screenshots, play animated compositions, and render videos without manual edits drifting away from the edited state. ## Main Files - `packages/studio/src/components/editor/manualEdits.ts` - `packages/studio/src/components/editor/DomEditOverlay.tsx` - `packages/studio/src/components/editor/PropertyPanel.tsx` - `packages/studio/src/App.tsx` - `packages/core/src/studio-api/helpers/manualEditsRenderScript.ts` - `packages/studio/vite.config.ts` - `packages/cli/src/server/studioServer.ts` - `packages/core/src/compiler/htmlBundler.ts` - `packages/producer/src/services/htmlCompiler.ts` - `packages/core/src/studio-api/routes/thumbnail.ts` - `packages/producer/src/services/fileServer.ts` - `packages/producer/src/services/renderOrchestrator.ts` ## Test Plan ```bash volta run --node 22.20.0 bun run build volta run --node 22.20.0 bun run --filter @hyperframes/core test -- src/studio-api/helpers/manualEditsRenderScript.test.ts volta run --node 22.20.0 bun run --filter @hyperframes/core typecheck volta run --node 22.20.0 bun run --filter @hyperframes/studio typecheck volta run --node 22.20.0 bun run --filter @hyperframes/cli typecheck volta run --node 22.20.0 bunx oxlint <changed files> volta run --node 22.20.0 bunx oxfmt --check <changed files> git diff --check ```
154 lines
5.4 KiB
JSON
154 lines
5.4 KiB
JSON
{
|
|
"name": "@hyperframes/core",
|
|
"version": "0.4.43",
|
|
"description": "",
|
|
"repository": {
|
|
"type": "git",
|
|
"url": "https://github.com/heygen-com/hyperframes",
|
|
"directory": "packages/core"
|
|
},
|
|
"files": [
|
|
"dist",
|
|
"docs",
|
|
"schemas",
|
|
"README.md"
|
|
],
|
|
"type": "module",
|
|
"main": "./src/index.ts",
|
|
"types": "./src/index.ts",
|
|
"exports": {
|
|
".": {
|
|
"import": "./src/index.ts",
|
|
"types": "./src/index.ts"
|
|
},
|
|
"./lint": {
|
|
"import": "./src/lint/index.ts",
|
|
"types": "./src/lint/index.ts"
|
|
},
|
|
"./compiler": {
|
|
"import": "./src/compiler/index.ts",
|
|
"types": "./src/compiler/index.ts"
|
|
},
|
|
"./runtime": "./dist/hyperframe.runtime.iife.js",
|
|
"./runtime/lottie-readiness": {
|
|
"import": "./src/runtime/adapters/lottieReadiness.ts",
|
|
"types": "./src/runtime/adapters/lottieReadiness.ts"
|
|
},
|
|
"./studio-api": {
|
|
"import": "./src/studio-api/index.ts",
|
|
"types": "./src/studio-api/index.ts"
|
|
},
|
|
"./studio-api/screenshot-clip": {
|
|
"import": "./src/studio-api/helpers/screenshotClip.ts",
|
|
"types": "./src/studio-api/helpers/screenshotClip.ts"
|
|
},
|
|
"./studio-api/manual-edits-render-script": {
|
|
"import": "./src/studio-api/helpers/manualEditsRenderScript.ts",
|
|
"types": "./src/studio-api/helpers/manualEditsRenderScript.ts"
|
|
},
|
|
"./text": {
|
|
"import": "./src/text/index.ts",
|
|
"types": "./src/text/index.ts"
|
|
},
|
|
"./registry": {
|
|
"import": "./src/registry/index.ts",
|
|
"types": "./src/registry/index.ts"
|
|
},
|
|
"./schemas/registry.json": "./schemas/registry.json",
|
|
"./schemas/registry-item.json": "./schemas/registry-item.json"
|
|
},
|
|
"publishConfig": {
|
|
"access": "public",
|
|
"exports": {
|
|
".": {
|
|
"import": "./dist/index.js",
|
|
"types": "./dist/index.d.ts"
|
|
},
|
|
"./lint": {
|
|
"import": "./dist/lint/index.js",
|
|
"types": "./dist/lint/index.d.ts"
|
|
},
|
|
"./compiler": {
|
|
"import": "./dist/compiler/index.js",
|
|
"types": "./dist/compiler/index.d.ts"
|
|
},
|
|
"./runtime": "./dist/hyperframe.runtime.iife.js",
|
|
"./runtime/lottie-readiness": {
|
|
"import": "./dist/runtime/adapters/lottieReadiness.js",
|
|
"types": "./dist/runtime/adapters/lottieReadiness.d.ts"
|
|
},
|
|
"./studio-api": {
|
|
"import": "./dist/studio-api/index.js",
|
|
"types": "./dist/studio-api/index.d.ts"
|
|
},
|
|
"./studio-api/screenshot-clip": {
|
|
"import": "./dist/studio-api/helpers/screenshotClip.js",
|
|
"types": "./dist/studio-api/helpers/screenshotClip.d.ts"
|
|
},
|
|
"./studio-api/manual-edits-render-script": {
|
|
"import": "./dist/studio-api/helpers/manualEditsRenderScript.js",
|
|
"types": "./dist/studio-api/helpers/manualEditsRenderScript.d.ts"
|
|
},
|
|
"./text": {
|
|
"import": "./dist/text/index.js",
|
|
"types": "./dist/text/index.d.ts"
|
|
},
|
|
"./registry": {
|
|
"import": "./dist/registry/index.js",
|
|
"types": "./dist/registry/index.d.ts"
|
|
},
|
|
"./schemas/registry.json": "./schemas/registry.json",
|
|
"./schemas/registry-item.json": "./schemas/registry-item.json"
|
|
},
|
|
"main": "./dist/index.js",
|
|
"types": "./dist/index.d.ts"
|
|
},
|
|
"scripts": {
|
|
"build": "bun run build:hyperframes-runtime && tsc",
|
|
"test": "vitest run",
|
|
"test:watch": "vitest",
|
|
"test:coverage": "vitest run --coverage",
|
|
"typecheck": "tsc --noEmit",
|
|
"lint:runtime-preview-guards": "tsx scripts/lint-runtime-preview-guards.ts",
|
|
"build:hyperframes-runtime": "tsx scripts/build-hyperframes-runtime-artifact.ts",
|
|
"build:hyperframes-runtime:modular": "SANDBOX_RUNTIME_VARIANT=modular tsx scripts/build-hyperframes-runtime-artifact.ts",
|
|
"build:hyperframe-runtime": "tsx scripts/build-hyperframes-runtime-artifact.ts",
|
|
"test:hyperframe-runtime-contract": "tsx scripts/test-hyperframe-runtime-contract.ts",
|
|
"test:hyperframe-runtime-behavior": "tsx scripts/test-hyperframe-runtime-behavior.ts",
|
|
"test:hyperframe-runtime-seek": "tsx scripts/test-hyperframe-runtime-seek.ts",
|
|
"test:hyperframe-runtime-duration-guards": "tsx scripts/test-hyperframe-runtime-duration-guards.ts",
|
|
"test:hyperframe-runtime-parity": "tsx scripts/test-hyperframe-runtime-parity.ts",
|
|
"test:hyperframe-runtime-security": "tsx scripts/test-hyperframe-runtime-security.ts",
|
|
"test:hyperframe-linter": "tsx scripts/test-hyperframe-linter.ts",
|
|
"test:hyperframe-runtime-ci": "bun run build:hyperframes-runtime && bun run test:hyperframe-runtime-contract && bun run test:hyperframe-runtime-behavior && bun run test:hyperframe-runtime-seek && bun run test:hyperframe-runtime-duration-guards && bun run test:hyperframe-runtime-parity && bun run test:hyperframe-runtime-security",
|
|
"check:hyperframe-html": "tsx scripts/check-hyperframe-static.ts",
|
|
"debug:timeline": "tsx scripts/debug-timeline.ts",
|
|
"prepublishOnly": "echo skip"
|
|
},
|
|
"dependencies": {
|
|
"@chenglou/pretext": "^0.0.5",
|
|
"postcss": "^8.5.8"
|
|
},
|
|
"devDependencies": {
|
|
"@types/jsdom": "^28.0.0",
|
|
"@types/node": "^24.10.13",
|
|
"@vitest/coverage-v8": "^3.2.4",
|
|
"jsdom": "^29.0.0",
|
|
"tsx": "^4.21.0",
|
|
"typescript": "^5.0.0",
|
|
"vitest": "^3.2.4"
|
|
},
|
|
"peerDependencies": {
|
|
"hono": "^4.0.0"
|
|
},
|
|
"peerDependenciesMeta": {
|
|
"hono": {
|
|
"optional": true
|
|
}
|
|
},
|
|
"optionalDependencies": {
|
|
"esbuild": "^0.25.12",
|
|
"linkedom": "^0.18.12"
|
|
}
|
|
}
|