Skip to content

Commit 4843d37

Browse files
committed
Merge main into feat/keyframes-cli
2 parents 055a8f7 + 9c4d9e5 commit 4843d37

1,737 files changed

Lines changed: 124705 additions & 114093 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.claude-plugin/plugin.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "hyperframes",
33
"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.",
4-
"version": "0.6.114",
4+
"version": "0.7.22",
55
"author": {
66
"name": "HeyGen",
77
"email": "[email protected]",

‎.codex-plugin/plugin.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "hyperframes",
3-
"version": "0.6.114",
3+
"version": "0.7.22",
44
"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.",
55
"author": {
66
"name": "HeyGen",

‎.codex/hooks.json‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
{
2+
"hooks": {
3+
"PreToolUse": [
4+
{
5+
"matcher": "Bash",
6+
"hooks": [
7+
{
8+
"type": "command",
9+
"command": "node -e \"\nconst chunks = [];\nprocess.stdin.on('data', d => chunks.push(d));\nprocess.stdin.on('end', () => {\n const input = JSON.parse(Buffer.concat(chunks).toString());\n const cmd = input.tool_input?.command || '';\n if (!/git\\\\s+commit\\\\b/.test(cmd)) process.exit(0);\n const { execSync } = require('child_process');\n const cwd = execSync('git rev-parse --show-toplevel', { encoding: 'utf8' }).trim();\n const steps = [\n ['bun run build', 'Build'],\n ['bun run lint', 'Lint'],\n ['bun run --filter \\'*\\' typecheck 2>&1 | grep -v \\'vitest\\\\|test\\\\.ts\\' || true', 'Typecheck'],\n ];\n const failures = [];\n for (const [script, label] of steps) {\n try { execSync(script, { cwd, stdio: 'pipe' }); }\n catch (e) {\n failures.push(label + ':\\\\n' + (e.stdout?.toString() || e.message).slice(0, 400));\n }\n }\n if (failures.length > 0) {\n process.stdout.write(JSON.stringify({\n continue: false,\n stopReason: '\\u274c Pre-commit checks failed:\\\\n\\\\n' + failures.join('\\\\n\\\\n') + '\\\\n\\\\nFix the issues above before committing.',\n }));\n }\n});\"",
10+
"timeout": 180,
11+
"statusMessage": "Running build + lint + typecheck before commit…"
12+
}
13+
]
14+
}
15+
]
16+
}
17+
}

‎.cursor-plugin/plugin.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
"$schema": "https://cursor.com/schemas/cursor-plugin/plugin.json",
33
"name": "hyperframes",
44
"displayName": "HyperFrames by HeyGen",
5-
"version": "0.6.114",
5+
"version": "0.7.22",
66
"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.",
77
"author": {
88
"name": "HeyGen",

‎.fallowrc.jsonc‎

Lines changed: 157 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,8 @@
2929
// Worker entry points loaded dynamically by their *Pool.ts companions.
3030
"packages/producer/src/services/pngDecodeBlitWorker.ts",
3131
"packages/producer/src/services/shaderTransitionWorker.ts",
32+
// Off-main-thread /health endpoint, spawned by path from healthWorker.ts.
33+
"packages/producer/src/services/healthWorkerThread.ts",
3234
// Test fixture worker, spawned by path via the pools' workerEntryPath
3335
// option from the crash-recovery tests; has no import-graph referrer.
3436
"packages/producer/src/services/__fixtures__/crashOnMessageWorker.mjs",
@@ -59,6 +61,9 @@
5961
// prose), not import-graph reachable.
6062
"skills/motion-graphics/grounding/**",
6163
"skills/motion-graphics/categories/**",
64+
// Agent-invoked reference materials (template + motion-primitive HTML, catalogs),
65+
// forked by path by the frame-worker per SKILL.md prose, not import-graph reachable.
66+
"skills/music-to-video/references/**",
6267
// Bundled @font-face data (read at runtime via fs.readFileSync, invisible
6368
// to the import graph) + its manual rebuild tool.
6469
"skills/**/fonts/**",
@@ -137,13 +142,13 @@
137142
"createFailedCaptureCalibrationEstimate",
138143
],
139144
},
140-
// gsapParser.ts is a public-API barrel that re-exports constants, types,
141-
// and utilities from gsapConstants, gsapSerialize, and springEase. The
142-
// re-exports are intentional public API consumed by callers outside the
145+
// gsapParserExports.ts is the public-API barrel that re-exports constants,
146+
// types, and utilities from gsapConstants, gsapSerialize, and springEase.
147+
// The re-exports are intentional public API consumed by callers outside the
143148
// changed-file set (e.g. studio, aws-lambda) and therefore appear unused
144149
// to fallow's static analysis of the PR diff.
145150
{
146-
"file": "packages/core/src/parsers/gsapParser.ts",
151+
"file": "packages/parsers/src/gsapParserExports.ts",
147152
"exports": [
148153
"PROPERTY_GROUPS",
149154
"classifyPropertyGroup",
@@ -160,14 +165,20 @@
160165
// Shared test helpers consumed by gsapParser.test.ts (same file,
161166
// fallow doesn't trace intra-file test consumption).
162167
{
163-
"file": "packages/core/src/parsers/gsapParser.test-helpers.ts",
168+
"file": "packages/parsers/src/gsapParser.test-helpers.ts",
164169
"exports": [
165170
"expectKeyframe",
166171
"expectKeyframesFormat",
167172
"convertAndReparse",
168173
"parseSplitAndAssert",
169174
],
170175
},
176+
// hfIds: EXCLUDED_TAGS is consumed by tests (htmlParser.test.ts) and
177+
// hfIdPersist.ts but fallow's static analyzer may not trace all consumers.
178+
{
179+
"file": "packages/parsers/src/hfIds.ts",
180+
"exports": ["EXCLUDED_TAGS", "mintHfId"],
181+
},
171182
// Shared timeline components extracted for downstream PRs in the
172183
// razor-blade stack (#1330, #1331). Consumers live on those branches.
173184
{
@@ -239,6 +250,52 @@
239250
// require intrusive middleware changes beyond this PR's scope.
240251
"minLines": 6,
241252
"ignore": [
253+
// gsapParser.ts: recast/babel GSAP writer — intentional duplication between
254+
// recast and acorn parallel implementations (pre-existing, moved from core).
255+
"packages/parsers/src/gsapParser.ts",
256+
// hfIds.ts: 7-line clone with sdk/engine/mutate.ts — pre-existing duplication
257+
// from when hfIds lived in packages/core/src/parsers/. Moving the file to the
258+
// new package makes fallow see it as a fresh finding; the underlying clone
259+
// predates this refactor.
260+
"packages/parsers/src/hfIds.ts",
261+
// Parser test files: parallel arrange/act/assert test cases — pre-existing
262+
// duplication moved from packages/core/src/parsers/.
263+
"packages/parsers/src/gsapParser.test.ts",
264+
"packages/parsers/src/gsapParser.test-helpers.ts",
265+
"packages/parsers/src/gsapWriter.parity.test.ts",
266+
"packages/parsers/src/gsapWriterParity.corpus.test.ts",
267+
"packages/parsers/src/gsapWriterParity.acorn.test.ts",
268+
"packages/parsers/src/htmlParser.roundtrip.test.ts",
269+
"packages/parsers/src/htmlParser.test.ts",
270+
// @hyperframes/studio-server test files: parallel arrange/act/assert test cases
271+
// (pre-existing structure from when studio-api lived in packages/core/src/studio-api/).
272+
"packages/studio-server/src/routes/files.test.ts",
273+
"packages/studio-server/src/routes/render.test.ts",
274+
"packages/studio-server/src/routes/lint.test.ts",
275+
"packages/studio-server/src/routes/preview.test.ts",
276+
"packages/studio-server/src/routes/projects.test.ts",
277+
"packages/studio-server/src/helpers/backupJournal.test.ts",
278+
"packages/studio-server/src/helpers/finiteMutation.test.ts",
279+
"packages/studio-server/src/helpers/hfIdPersist.test.ts",
280+
"packages/studio-server/src/helpers/manualEditsRenderScript.test.ts",
281+
"packages/studio-server/src/helpers/mediaValidation.test.ts",
282+
"packages/studio-server/src/helpers/previewAdapter.test.ts",
283+
"packages/studio-server/src/helpers/safePath.test.ts",
284+
"packages/studio-server/src/helpers/sourceMutation.test.ts",
285+
"packages/studio-server/src/helpers/studioMotionRenderScript.test.ts",
286+
"packages/studio-server/src/helpers/subComposition.test.ts",
287+
// @hyperframes/lint rule test files: parallel arrange/act/assert test cases
288+
// (pre-existing structure from when lint lived in packages/core/src/lint/).
289+
"packages/lint/src/rules/adapters.test.ts",
290+
"packages/lint/src/rules/captions.test.ts",
291+
"packages/lint/src/rules/composition.test.ts",
292+
"packages/lint/src/rules/core.test.ts",
293+
"packages/lint/src/rules/fonts.test.ts",
294+
"packages/lint/src/rules/gsap.test.ts",
295+
"packages/lint/src/rules/media.test.ts",
296+
"packages/lint/src/rules/slideshow.test.ts",
297+
"packages/lint/src/rules/textures.test.ts",
298+
"packages/lint/src/hyperframeLinter.test.ts",
242299
// slideshowPanelHelpers.ts: setSlideNotes/addFragment/addHotspot share an
243300
// intentional parallel shape (signature + mapSlidesIn → exists-check →
244301
// map/append); the per-slide mutation differs, so a shared abstraction
@@ -247,34 +304,76 @@
247304
// SlideshowPanel.test.ts: parallel arrange/act/assert test cases — collapsing
248305
// them would hurt readability of what each case verifies.
249306
"packages/studio/src/components/panels/SlideshowPanel.test.ts",
307+
// hyperframes-player.test.ts: parallel arrange/act/assert test cases verifying
308+
// distinct behaviors (same-origin vs realm media, audio-locked permutations,
309+
// seek bridge variants). Each case is self-contained for readability;
310+
// extracting the iframe / mock-audio setup helpers would over-couple
311+
// unrelated scenarios under a shared fixture.
312+
"packages/player/src/hyperframes-player.test.ts",
250313
// present.ts mirrors play.ts's server startup + console-output block. The
251314
// shared low-level pieces (resolve*/injectRuntime/listenOnFreePort) are in
252315
// utils/compositionServer.ts; the remaining clone is per-command logging text
253316
// (different labels/help lines) — extracting it would over-abstract.
254317
"packages/cli/src/commands/present.ts",
318+
// skillsManifest.test.ts: parallel arrange/act/assert cases for locateInstall
319+
// (project vs global scope, per-agent host conventions, claude-code priority).
320+
// Each case seeds a dir then asserts the resolved location/agent; collapsing
321+
// the shared seed/assert shape would obscure what each scope/host verifies.
322+
"packages/cli/src/utils/skillsManifest.test.ts",
323+
// skills.test.ts: parallel prune cases (removed-in-global vs project, non-slug
324+
// rejection, --source/--dir plumbing) share a mock-checkSkills → runSkillsUpdate
325+
// → assert-remove-spawn shape; each verifies a distinct prune behavior, so
326+
// extracting the shared scaffold would obscure what each case asserts.
327+
"packages/cli/src/commands/skills.test.ts",
328+
// layout-audit.browser.test.ts: parallel arrange/act/assert cases per audit
329+
// rule (overflow / overlap / occlusion) that each install their own mocked
330+
// geometry + computed-style before asserting. The clone groups are this
331+
// pre-existing per-rule scaffold; adding a clip-path case shifts lines and
332+
// re-flags it. Collapsing the per-rule installers would obscure each case.
333+
"packages/cli/src/commands/layout-audit.browser.test.ts",
255334
],
256335
},
257336
"health": {
258-
// executeGsapMutation (introduced by Phase 3b / acorn-parser stack, already
259-
// merged to origin/main via #1338) has CRITICAL cyclomatic complexity (58)
260-
// that pre-dates this PR's scope. Excluding files.ts from health analysis
261-
// avoids the inherited-fingerprint line-shift problem that suppression
262-
// comments would cause (any inserted line shifts subsequent function line
263-
// numbers, breaking fallow's inherited-detection fingerprint).
264-
//
265337
// useGsapTweenCache.ts: pre-existing large React-effect hooks (the populate
266338
// and runtime-scan effects, the per-element animations memo) whose
267339
// complexity pre-dates the computed-timeline work. Exempted at file level
268-
// for the same reason as files.ts rather than refactored as scope creep.
269-
//
270-
// gsapParser.ts: the recast/babel GSAP writer is a 2500-line legacy parser
271-
// restored as the default server writer by WS-3.F rework (acorn is now
272-
// flag-gated behind STUDIO_SDK_CUTOVER_ENABLED). Its complexity pre-dates
273-
// this PR and was present on all ancestor branches; the file-level exemption
274-
// avoids the line-shift fingerprint problem for inherited findings.
340+
// rather than refactored as scope creep.
275341
"ignore": [
276-
"packages/core/src/studio-api/routes/files.ts",
277-
"packages/core/src/parsers/gsapParser.ts",
342+
// timeline.ts: collectRuntimeTimelinePayload (CRITICAL) pre-dates this PR;
343+
// only an import line changed here (slideshow/sceneId → slideshow/index),
344+
// but the line-shift fingerprint makes fallow re-flag inherited complexity.
345+
"packages/core/src/runtime/timeline.ts",
346+
// sceneId.ts: trivial 5-cyclomatic guard, moved verbatim from
347+
// packages/core/src/slideshow/ into parsers; flagged only because the move
348+
// makes fallow treat it as a fresh finding.
349+
"packages/parsers/src/slideshow/sceneId.ts",
350+
// assetPaths.ts / rewriteSubCompPaths.ts: pure URL/asset-path helpers moved
351+
// verbatim from packages/core/src/compiler/ into parsers. The move makes
352+
// fallow score them as fresh (high CRAP = inherited complexity with no
353+
// coverage mapping yet); the logic is unchanged.
354+
"packages/parsers/src/assetPaths.ts",
355+
"packages/parsers/src/rewriteSubCompPaths.ts",
356+
// gsapParser.ts: the recast/babel GSAP writer is a 2500-line legacy parser;
357+
// moved from packages/core/src/parsers/ — same complexity rationale.
358+
"packages/parsers/src/gsapParser.ts",
359+
// htmlParser.ts has pre-existing complexity (moved from packages/core).
360+
"packages/parsers/src/htmlParser.ts",
361+
// studio-server files: pre-existing complexity (moved from packages/core/src/studio-api/).
362+
// files.ts: executeGsapMutationRecast/Acorn are CRITICAL; excluded as files.ts
363+
// was already in health.ignore at the old path (packages/core/src/studio-api/routes/files.ts).
364+
"packages/studio-server/src/routes/files.ts",
365+
"packages/studio-server/src/routes/render.ts",
366+
"packages/studio-server/src/routes/thumbnail.ts",
367+
"packages/studio-server/src/helpers/manualEditsRenderScript.ts",
368+
"packages/studio-server/src/helpers/studioMotionRenderScript.ts",
369+
"packages/studio-server/src/helpers/subComposition.ts",
370+
// lint rule implementations and project linter: pre-existing complexity
371+
// (moved from packages/core/src/lint/). File-level exemption avoids the
372+
// line-shift fingerprint problem for inherited findings.
373+
"packages/lint/src/rules/media.ts",
374+
"packages/lint/src/rules/textures.ts",
375+
"packages/lint/src/rules/gsap.ts",
376+
"packages/lint/src/project.ts",
278377
// SlideshowPanel.tsx: top-level editor panel that wires several independent
279378
// sections (slides/inspector/branches/hotspot). Its cyclomatic count comes
280379
// from that fan-out; splitting it would scatter shared state without
@@ -287,6 +386,43 @@
287386
// body is linear validation that reads clearly inline.
288387
"packages/cli/src/commands/play.ts",
289388
"packages/cli/src/commands/present.ts",
389+
// sync-agent-dirs.ts: a build-time codegen that regex-parses upstream
390+
// agents.ts. parseAgents/resolveGlobalExpr are branchy by nature (literal
391+
// vs base-var args, validation throws) but small and well-tested via the
392+
// generated table's shape test; this is dev tooling, not shipped runtime.
393+
"packages/cli/scripts/sync-agent-dirs.ts",
394+
// Files modified only for import-path updates (one-line changes to switch
395+
// from @hyperframes/core/* subpaths to the new packages). Their complexity
396+
// is pre-existing; the line-shift fingerprint problem makes fallow treat
397+
// the violations as new even though no logic changed.
398+
"packages/cli/src/server/studioServer.ts",
399+
"packages/core/src/core.types.ts",
400+
"packages/core/src/generators/hyperframes.ts",
401+
"packages/producer/src/services/htmlCompiler.ts",
402+
"packages/studio/src/hooks/gsapRuntimeBridge.ts",
403+
"packages/studio/src/hooks/gsapShared.ts",
404+
"packages/studio/src/hooks/gsapDragPositionCommit.ts",
405+
"packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts",
406+
"packages/studio/vite.config.ts",
407+
"packages/cli/src/commands/lint.ts",
408+
"packages/cli/src/commands/preview.ts",
409+
"packages/cli/src/commands/publish.ts",
410+
"packages/cli/src/server/studioServer.ts",
411+
// set-version.ts: compareSemver helper has pre-existing complexity from
412+
// semver string parsing logic; line-shift fingerprint problem from new
413+
// packages added to PACKAGES array makes fallow treat it as new.
414+
"scripts/set-version.ts",
415+
// gsapRuntimeReaders.ts: pre-existing complexity in readAllAnimatedProperties;
416+
// line-shift fingerprint from import-path updates triggers the violation.
417+
"packages/studio/src/hooks/gsapRuntimeReaders.ts",
418+
// In-page audit scripts: single large browser-side IIFE wrappers
419+
// (auditLayout/__contrastAudit) with pre-existing CRITICAL helpers
420+
// (textOverflowFixHint, selectorFor, the WCAG walk). Adding the small
421+
// clip-path probe helpers shifts every function below it, so the line-shift
422+
// fingerprint re-flags inherited complexity even though the new helpers are
423+
// all at the lowest tier (<=5 cyclomatic).
424+
"packages/cli/src/commands/layout-audit.browser.js",
425+
"packages/cli/src/commands/contrast-audit.browser.js",
290426
],
291427
},
292428
}

0 commit comments

Comments
 (0)