mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-09-14 18:01:20 +08:00
24edb15095
* fix(runtime): auto-infer composition duration for CSS/WAAPI/Lottie so data-duration is optional The #2 render failure bucket ("Composition has zero duration") accounts for ~27K errors / ~7K affected users over 30 days (PostHog project 356858). Root cause: only GSAP timelines got their duration auto-detected — CSS, WAAPI, and Lottie compositions had no source of truth for total duration unless the author remembered to set data-duration on the root element, and the render engine hard-failed capture when neither was present. Adds getInferredDurationSeconds() to the CSS, WAAPI, and Lottie runtime adapters (packages/core/src/runtime/adapters/*.ts) — each reports the longest finite end time it can discover from its own animations (CSS: computed timing offset by data-start; WAAPI: effect.getComputedTiming().endTime; Lottie: totalFrames/frameRate or the player's own duration). Infinite/ unbounded animations correctly return null and still require data-duration. Wires this into the runtime's existing duration-floor resolution (resolveAdapterDurationFloorSeconds in runtime/init.ts), alongside the existing media-duration and authored-composition floors, so window.__hf.duration becomes positive without any author action for finite-duration non-GSAP compositions. Three.js is unchanged — no AnimationClip/AnimationMixer inspection exists in that adapter, so data-duration remains required there. Tightens frameCapture.ts's zero-duration fast-fail gate to also check hf.duration directly (not just the two authored signals), so a composition mid-inference isn't fast-failed before its adapter-derived duration lands. Adds a new lint rule (root_composition_missing_duration_source) that errors only on genuinely non-inferable cases: no animation signal at all, Three.js without data-duration, or an infinite/unbounded CSS or WAAPI animation without data-duration. Deliberately silent on finite CSS/WAAPI/Lottie animations, since the runtime now infers those — an autofix that "inserts the inferred value" was considered and rejected: every case the rule flags has no derivable value (an infinite spinner has no finite end time; a duration-less Three.js scene has nothing to measure), so any autofix would have to fabricate a placeholder, trading a loud correct failure for a silent wrong-length render. Updates the CSS/WAAPI/Lottie/Three adapter skill docs and the hyperframes-core determinism-rules/data-attributes references to document the new optionality and the runtime mechanism backing it. Verified end-to-end against the real render pipeline (not just unit tests): a CSS-only composition with a finite 3s animation, no GSAP timeline, and no data-duration now renders a correct 3.000s MP4 via `hyperframes render` (previously: "Composition has zero duration" failure). The infinite-CSS negative control still fails fast with a clear diagnostic, matching the new lint rule. Adds a file-level fallow health exemption for lottie.ts's pre-existing `seek` handler — unrelated to this change, but its line numbers shifted when new functions were added earlier in the file, tripping fallow's inherited-finding fingerprint (documented pattern already used elsewhere in .fallowrc.jsonc for the same reason). Known limitation: the static WAAPI usage detector in the lint rule (/\.animate\(\s*[\[$A-Za-z_]/) can miss unusual call shapes; it only affects whether the "no signal at all" branch fires, and errs toward NOT flagging (reducing false positives) rather than over-flagging. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> * fix(lint): close 3 correctness gaps in root_composition_missing_duration_source - Strip JS/CSS comments before scanning for GSAP/WAAPI/Three/Lottie/CSS animation signals, so a commented-out `.animate()` call or a commented `animation: ... infinite` rule can no longer satisfy the "has a duration source" check and mask a real zero-duration render failure. - Broaden the WAAPI detection regex to also match the object-literal (PropertyIndexedKeyframes) form of `.animate()`, e.g. `el.animate({ opacity: [0,1] }, { duration: 2000 })`, which the previous character class silently missed. Corrected the adjacent comment that incorrectly claimed this shape "can't be a false negative". - Fix hasInfiniteCssAnimation to stop false-positiving on animation NAMEs that merely contain the substring "infinite" (e.g. `infinite-spin`) by anchoring the `infinite` keyword with hyphen-aware boundaries instead of a bare `\b`. Also makes the longhand `animation-name` + separately declared `animation-iteration-count: infinite` pattern detected consistently. Adds targeted unit tests for each fixed false-positive/false-negative. * fix(runtime): keep finite duration signal when an unbounded animation coexists getInferredDurationSeconds in the CSS and WAAPI adapters returned null outright whenever any animation on the composition was unbounded (infinite iteration count), even when other finite animations on the same composition could still supply a valid duration. This disagreed with the new root_composition_missing_duration_source lint rule, which treats any animation-name as sufficient — so a composition mixing a finite fadeIn with a decorative infinite spin passed lint but still failed at render with "zero duration". Unbounded animations are now skipped when computing the max end time instead of short-circuiting the whole calculation. null is only returned when every animation on the composition is unbounded, i.e. there is no finite signal to fall back on at all. Co-Authored-By: Claude <noreply@anthropic.com> * docs(skills): fix table separator width in data-attributes.md oxfmt flagged the merged Composition Root table from the post-rebase merge of the auto-infer-duration docs onto main's reformatted table — the separator row was one dash short of the header width. * fix(lint): keep infinite-CSS duration rule strict but make its message honest Post-review (Vance): after the finite+infinite adapter fix, the runtime infers a length for a mixed finite+infinite CSS composition, but this lint rule still (intentionally) errors on it — an unbounded animation makes the intended total length ambiguous, so we require explicit data-duration. Keep that strictness (lint is advisory by default; it only blocks under --strict, and data-duration is the one duration signal guaranteed correct across every adapter, known and future). But the message wrongly claimed the render "will fail" — false for the mixed case, where the runtime falls back to the finite animation. Rewrite it to describe the ambiguity honestly, correct the rule's block comment, and add a mixed finite+infinite test asserting it still errors with an honest message. --------- Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
436 lines
23 KiB
JSON
436 lines
23 KiB
JSON
{
|
|
"$schema": "https://raw.githubusercontent.com/fallow-rs/fallow/main/config-schema.json",
|
|
"entry": [
|
|
"packages/producer/src/**/*.test.ts",
|
|
"packages/aws-lambda/src/**/*.test.ts",
|
|
"packages/gcp-cloud-run/src/**/*.test.ts",
|
|
"packages/producer/src/regression-harness.ts",
|
|
"packages/producer/src/regression-harness-distributed.test.ts",
|
|
"packages/producer/src/regression-harness-lambda-local.ts",
|
|
"packages/producer/src/transparency-test.ts",
|
|
"packages/producer/src/parity-harness.ts",
|
|
"packages/producer/src/parity-fixtures.ts",
|
|
"packages/producer/src/perf-gate.ts",
|
|
"packages/producer/src/runtime-conformance.ts",
|
|
"packages/producer/src/benchmark.ts",
|
|
"packages/producer/scripts/generate-font-data.ts",
|
|
"packages/cli/scripts/generate-font-data.ts",
|
|
"packages/engine/scripts/test-fitTextFontSize-browser.ts",
|
|
"packages/aws-lambda/scripts/*.ts",
|
|
// Built as standalone IIFE for the browser-side sandbox runtime;
|
|
// referenced by file path (not import) in build-hyperframes-runtime-artifact.ts.
|
|
"packages/core/src/runtime/entry.ts",
|
|
// In-page audit scripts read as raw strings and injected via
|
|
// page.addScriptTag (see layout.ts / validate.ts) — referenced by file
|
|
// path, never imported, so they have no import-graph referrer.
|
|
"packages/cli/src/commands/layout-audit.browser.js",
|
|
"packages/cli/src/commands/contrast-audit.browser.js",
|
|
"packages/cli/src/commands/motion-sample.browser.js",
|
|
// Worker entry points loaded dynamically by their *Pool.ts companions.
|
|
"packages/producer/src/services/pngDecodeBlitWorker.ts",
|
|
"packages/producer/src/services/shaderTransitionWorker.ts",
|
|
// Off-main-thread /health endpoint, spawned by path from healthWorker.ts.
|
|
"packages/producer/src/services/healthWorkerThread.ts",
|
|
// Test fixture worker, spawned by path via the pools' workerEntryPath
|
|
// option from the crash-recovery tests; has no import-graph referrer.
|
|
"packages/producer/src/services/__fixtures__/crashOnMessageWorker.mjs",
|
|
"scripts/*.{ts,mjs,js}",
|
|
"scripts/*/run.mjs",
|
|
// Keyframe UI components — wired dynamically via EaseCurveSection/MotionPanel.
|
|
"packages/studio/src/components/editor/KeyframeDiamond.tsx",
|
|
"packages/studio/src/components/editor/SpringEaseEditor.tsx",
|
|
// NLE notice — rendered conditionally via NLELayout when timeline is first shown.
|
|
"packages/studio/src/components/nle/TimelineEditorNotice.tsx",
|
|
// Zoom hook extracted for downstream razor-blade PRs (#1330, #1331).
|
|
"packages/studio/src/player/components/useTimelineZoom.ts",
|
|
// Cached O(1) GSAP target lookup, replacing O(n²) inline checks.
|
|
// Consumers migrate in a follow-up once useDomGeometryCommits adopts it.
|
|
"packages/studio/src/hooks/gsapTargetCache.ts",
|
|
// Preview helper consumed dynamically from the studio iframe bridge.
|
|
"packages/studio/src/hooks/gsapRuntimePreview.ts",
|
|
],
|
|
"ignorePatterns": [
|
|
"docs/**",
|
|
"packages/producer/tests/**",
|
|
"packages/player/tests/**",
|
|
"packages/engine/tests/**",
|
|
"skills/**/test-corpus/**",
|
|
"skills/**/scripts/**",
|
|
// Agent-invoked motion-graphics tools co-located with their docs (run via
|
|
// `node <path>` per grounding/PROTOCOL.md / categories/maps/module.md
|
|
// prose), not import-graph reachable.
|
|
"skills/motion-graphics/grounding/**",
|
|
"skills/motion-graphics/categories/**",
|
|
// Agent-invoked reference materials (template + motion-primitive HTML, catalogs),
|
|
// forked by path by the frame-worker per SKILL.md prose, not import-graph reachable.
|
|
"skills/music-to-video/references/**",
|
|
// Bundled @font-face data (read at runtime via fs.readFileSync, invisible
|
|
// to the import graph) + its manual rebuild tool.
|
|
"skills/**/fonts/**",
|
|
// Golden snapshot files: data consumed by toMatchFileSnapshot, not importable modules.
|
|
"packages/**/__goldens__/**",
|
|
"registry/**",
|
|
"examples/**",
|
|
"packages/sdk/examples/**",
|
|
".github/workflows/fixtures/**",
|
|
// Auto-generated TS client for the HeyGen cloud API. Regenerated by
|
|
// experiment-framework/scripts/generate_hyperframes_cli_client.py via
|
|
// the sync-hyperframes-codegen.yml workflow; complexity/dead-code
|
|
// findings on this file are not actionable from this repo.
|
|
"packages/cli/src/cloud/_gen/**",
|
|
],
|
|
"ignoreExports": [
|
|
// CLI command files: every command exports a const `examples` per the
|
|
// convention documented in CLAUDE.md. This is a namespace barrel, not a
|
|
// collision.
|
|
{ "file": "packages/cli/src/commands/*.ts", "exports": ["examples"] },
|
|
// Independent ML model managers each declare their own DEFAULT_MODEL /
|
|
// MODELS_DIR / ensureModel for their model namespace.
|
|
{
|
|
"file": "packages/cli/src/{background-removal,tts,whisper}/manager.ts",
|
|
"exports": ["DEFAULT_MODEL", "MODELS_DIR", "ensureModel"],
|
|
},
|
|
// `isPathInside` is documented as exported-for-tests only in fileServer.ts;
|
|
// it has different semantics (symlink resolution) from utils/paths.ts.
|
|
{
|
|
"file": "packages/producer/src/services/fileServer.ts",
|
|
"exports": ["isPathInside"],
|
|
},
|
|
// Studio telemetry: consumed by useRenderQueue.ts / StudioFeedbackBar.tsx
|
|
// (deep relative imports) but fallow's static analyzer doesn't trace
|
|
// them. Same path-resolution quirk — trackStudioSessionStart from the
|
|
// same file resolves fine.
|
|
{
|
|
"file": "packages/studio/src/telemetry/events.ts",
|
|
"exports": ["trackStudioRenderStart", "trackStudioFeedback"],
|
|
},
|
|
// domEditingLayers: these exports are consumed via the browser iframe
|
|
// runtime context (not traceable by static import analysis from the
|
|
// studio entry point) or re-exported through the domEditing barrel but
|
|
// have no downstream consumers yet.
|
|
{
|
|
"file": "packages/studio/src/components/editor/domEditingLayers.ts",
|
|
"exports": [
|
|
"isEditableTextLeaf",
|
|
"collectDomEditTextFields",
|
|
"buildElementLabel",
|
|
"refreshDomEditSelection",
|
|
],
|
|
},
|
|
// domEditing barrel: re-exports consumed throughout the studio but
|
|
// fallow's static analyzer can't trace re-exports through barrel files.
|
|
{
|
|
"file": "packages/studio/src/components/editor/domEditing.ts",
|
|
"exports": ["*"],
|
|
},
|
|
// Exported for render.test.ts (exported-for-tests pattern).
|
|
{
|
|
"file": "packages/cli/src/commands/render.ts",
|
|
"exports": ["resolveBrowserGpuForCli", "renderLocal"],
|
|
},
|
|
// captureCost.ts: constants and helpers consumed by the runCaptureCalibration
|
|
// orchestration function and tests, but the entry-point graph doesn't
|
|
// reach them because the orchestrator's caller resolves them dynamically.
|
|
{
|
|
"file": "packages/producer/src/services/render/captureCost.ts",
|
|
"exports": [
|
|
"CAPTURE_CALIBRATION_TARGET_MS",
|
|
"MAX_MEASURED_CAPTURE_COST_MULTIPLIER",
|
|
"CAPTURE_CALIBRATION_PROTOCOL_TIMEOUT_MS",
|
|
"measureCaptureCostFromSession",
|
|
"logCaptureCalibrationResult",
|
|
"createFailedCaptureCalibrationEstimate",
|
|
],
|
|
},
|
|
// gsapParserExports.ts is the public-API barrel that re-exports constants,
|
|
// types, and utilities from gsapConstants, gsapSerialize, and springEase.
|
|
// The re-exports are intentional public API consumed by callers outside the
|
|
// changed-file set (e.g. studio, aws-lambda) and therefore appear unused
|
|
// to fallow's static analysis of the PR diff.
|
|
{
|
|
"file": "packages/parsers/src/gsapParserExports.ts",
|
|
"exports": [
|
|
"PROPERTY_GROUPS",
|
|
"classifyPropertyGroup",
|
|
"classifyTweenPropertyGroup",
|
|
"SPRING_PRESETS",
|
|
"generateSpringEaseData",
|
|
"GsapMethod",
|
|
"GsapKeyframesData",
|
|
"GsapKeyframeFormat",
|
|
"PropertyGroupName",
|
|
"SpringPreset",
|
|
],
|
|
},
|
|
// Shared test helpers consumed by gsapParser.test.ts (same file,
|
|
// fallow doesn't trace intra-file test consumption).
|
|
{
|
|
"file": "packages/parsers/src/gsapParser.test-helpers.ts",
|
|
"exports": [
|
|
"expectKeyframe",
|
|
"expectKeyframesFormat",
|
|
"convertAndReparse",
|
|
"parseSplitAndAssert",
|
|
],
|
|
},
|
|
// hfIds: EXCLUDED_TAGS is consumed by tests (htmlParser.test.ts) and
|
|
// hfIdPersist.ts but fallow's static analyzer may not trace all consumers.
|
|
{
|
|
"file": "packages/parsers/src/hfIds.ts",
|
|
"exports": ["EXCLUDED_TAGS", "mintHfId"],
|
|
},
|
|
// Shared timeline components extracted for downstream PRs in the
|
|
// razor-blade stack (#1330, #1331). Consumers live on those branches.
|
|
{
|
|
"file": "packages/studio/src/player/components/timelineCallbacks.ts",
|
|
"exports": ["*"],
|
|
},
|
|
// gsapTargetCache: cached O(1) GSAP target lookup, consumed by
|
|
// useDomEditCommits and intended to replace the local copy in
|
|
// useDomGeometryCommits once callers migrate.
|
|
{
|
|
"file": "packages/studio/src/hooks/gsapTargetCache.ts",
|
|
"exports": ["isElementGsapTargeted"],
|
|
},
|
|
// Re-exports from useDomEditCommits: barrel-style re-exports
|
|
// consumed by downstream studio code.
|
|
{
|
|
"file": "packages/studio/src/hooks/useDomEditCommits.ts",
|
|
"exports": ["GSAP_CSS_FALLBACK_BLOCKED_MESSAGE", "PersistDomEditOperations"],
|
|
},
|
|
{
|
|
"file": "packages/studio/src/utils/timelineElementSplit.ts",
|
|
"exports": ["buildPatchTarget", "readFileContent"],
|
|
},
|
|
],
|
|
"ignoreDependencies": [
|
|
// Runtime/dynamic deps not visible to static analysis: tsup `external`,
|
|
// dynamic require() resolution, peer/static-file consumption in tests,
|
|
// and bun-hoisted workspace devDeps (e.g. happy-dom in root package.json
|
|
// resolves for every workspace, so workspaces don't redeclare it).
|
|
// Required by @puppeteer/browsers and puppeteer-core at runtime; listed
|
|
// as a direct dep to guarantee installation even when transitive
|
|
// resolution fails (corrupted cache, dedup edge cases).
|
|
"debug",
|
|
"puppeteer",
|
|
"puppeteer-core",
|
|
"esbuild",
|
|
"giget",
|
|
"gsap",
|
|
"happy-dom",
|
|
"ffmpeg-static",
|
|
"ffprobe-static",
|
|
"@hyperframes/core",
|
|
"@hyperframes/studio",
|
|
"@hyperframes/producer",
|
|
"@fontsource/archivo-black",
|
|
"@fontsource/eb-garamond",
|
|
"@fontsource/ibm-plex-mono",
|
|
"@fontsource/inter",
|
|
"@fontsource/jetbrains-mono",
|
|
"@fontsource/league-gothic",
|
|
"@fontsource/montserrat",
|
|
"@fontsource/nunito",
|
|
"@fontsource/oswald",
|
|
"@fontsource/outfit",
|
|
"@fontsource/space-mono",
|
|
"@fontsource/lato",
|
|
"@fontsource/noto-sans-jp",
|
|
"@fontsource/open-sans",
|
|
"@fontsource/playfair-display",
|
|
"@fontsource/poppins",
|
|
"@fontsource/roboto",
|
|
"@fontsource/source-code-pro",
|
|
],
|
|
"duplicates": {
|
|
// Raise from the default 5 to 6 lines so trivially short Hono route-handler
|
|
// preambles (resolveProject + 404 + body-parse) are below the threshold.
|
|
// The three 5-line groups in files.ts / render.ts are structural boilerplate
|
|
// that naturally converges and is unlikely to diverge; extraction would
|
|
// require intrusive middleware changes beyond this PR's scope.
|
|
"minLines": 6,
|
|
"ignore": [
|
|
// gsapParser.ts: recast/babel GSAP writer — intentional duplication between
|
|
// recast and acorn parallel implementations (pre-existing, moved from core).
|
|
"packages/parsers/src/gsapParser.ts",
|
|
// hfIds.ts: 7-line clone with sdk/engine/mutate.ts — pre-existing duplication
|
|
// from when hfIds lived in packages/core/src/parsers/. Moving the file to the
|
|
// new package makes fallow see it as a fresh finding; the underlying clone
|
|
// predates this refactor.
|
|
"packages/parsers/src/hfIds.ts",
|
|
// Parser test files: parallel arrange/act/assert test cases — pre-existing
|
|
// duplication moved from packages/core/src/parsers/.
|
|
"packages/parsers/src/gsapParser.test.ts",
|
|
"packages/parsers/src/gsapParser.test-helpers.ts",
|
|
"packages/parsers/src/gsapWriter.parity.test.ts",
|
|
"packages/parsers/src/gsapWriterParity.corpus.test.ts",
|
|
"packages/parsers/src/gsapWriterParity.acorn.test.ts",
|
|
"packages/parsers/src/htmlParser.roundtrip.test.ts",
|
|
"packages/parsers/src/htmlParser.test.ts",
|
|
// @hyperframes/studio-server test files: parallel arrange/act/assert test cases
|
|
// (pre-existing structure from when studio-api lived in packages/core/src/studio-api/).
|
|
"packages/studio-server/src/routes/files.test.ts",
|
|
"packages/studio-server/src/routes/render.test.ts",
|
|
"packages/studio-server/src/routes/lint.test.ts",
|
|
"packages/studio-server/src/routes/preview.test.ts",
|
|
"packages/studio-server/src/routes/projects.test.ts",
|
|
"packages/studio-server/src/helpers/backupJournal.test.ts",
|
|
"packages/studio-server/src/helpers/finiteMutation.test.ts",
|
|
"packages/studio-server/src/helpers/hfIdPersist.test.ts",
|
|
"packages/studio-server/src/helpers/manualEditsRenderScript.test.ts",
|
|
"packages/studio-server/src/helpers/mediaValidation.test.ts",
|
|
"packages/studio-server/src/helpers/previewAdapter.test.ts",
|
|
"packages/studio-server/src/helpers/safePath.test.ts",
|
|
"packages/studio-server/src/helpers/sourceMutation.test.ts",
|
|
"packages/studio-server/src/helpers/studioMotionRenderScript.test.ts",
|
|
"packages/studio-server/src/helpers/subComposition.test.ts",
|
|
// @hyperframes/lint rule test files: parallel arrange/act/assert test cases
|
|
// (pre-existing structure from when lint lived in packages/core/src/lint/).
|
|
"packages/lint/src/rules/adapters.test.ts",
|
|
"packages/lint/src/rules/captions.test.ts",
|
|
"packages/lint/src/rules/composition.test.ts",
|
|
"packages/lint/src/rules/core.test.ts",
|
|
"packages/lint/src/rules/fonts.test.ts",
|
|
"packages/lint/src/rules/gsap.test.ts",
|
|
"packages/lint/src/rules/media.test.ts",
|
|
"packages/lint/src/rules/slideshow.test.ts",
|
|
"packages/lint/src/rules/textures.test.ts",
|
|
"packages/lint/src/hyperframeLinter.test.ts",
|
|
// slideshowPanelHelpers.ts: setSlideNotes/addFragment/addHotspot share an
|
|
// intentional parallel shape (signature + mapSlidesIn → exists-check →
|
|
// map/append); the per-slide mutation differs, so a shared abstraction
|
|
// would obscure more than it dedupes.
|
|
"packages/studio/src/components/panels/slideshowPanelHelpers.ts",
|
|
// SlideshowPanel.test.ts: parallel arrange/act/assert test cases — collapsing
|
|
// them would hurt readability of what each case verifies.
|
|
"packages/studio/src/components/panels/SlideshowPanel.test.ts",
|
|
// hyperframes-player.test.ts: parallel arrange/act/assert test cases verifying
|
|
// distinct behaviors (same-origin vs realm media, audio-locked permutations,
|
|
// seek bridge variants). Each case is self-contained for readability;
|
|
// extracting the iframe / mock-audio setup helpers would over-couple
|
|
// unrelated scenarios under a shared fixture.
|
|
"packages/player/src/hyperframes-player.test.ts",
|
|
// present.ts mirrors play.ts's server startup + console-output block. The
|
|
// shared low-level pieces (resolve*/injectRuntime/listenOnFreePort) are in
|
|
// utils/compositionServer.ts; the remaining clone is per-command logging text
|
|
// (different labels/help lines) — extracting it would over-abstract.
|
|
"packages/cli/src/commands/present.ts",
|
|
// skillsManifest.test.ts: parallel arrange/act/assert cases for locateInstall
|
|
// (project vs global scope, per-agent host conventions, claude-code priority).
|
|
// Each case seeds a dir then asserts the resolved location/agent; collapsing
|
|
// the shared seed/assert shape would obscure what each scope/host verifies.
|
|
"packages/cli/src/utils/skillsManifest.test.ts",
|
|
// skills.test.ts: parallel prune cases (removed-in-global vs project, non-slug
|
|
// rejection, --source/--dir plumbing) share a mock-checkSkills → runSkillsUpdate
|
|
// → assert-remove-spawn shape; each verifies a distinct prune behavior, so
|
|
// extracting the shared scaffold would obscure what each case asserts.
|
|
"packages/cli/src/commands/skills.test.ts",
|
|
// layout-audit.browser.test.ts: parallel arrange/act/assert cases per audit
|
|
// rule (overflow / overlap / occlusion) that each install their own mocked
|
|
// geometry + computed-style before asserting. The clone groups are this
|
|
// pre-existing per-rule scaffold; adding a clip-path case shifts lines and
|
|
// re-flags it. Collapsing the per-rule installers would obscure each case.
|
|
"packages/cli/src/commands/layout-audit.browser.test.ts",
|
|
],
|
|
},
|
|
"health": {
|
|
// useGsapTweenCache.ts: pre-existing large React-effect hooks (the populate
|
|
// and runtime-scan effects, the per-element animations memo) whose
|
|
// complexity pre-dates the computed-timeline work. Exempted at file level
|
|
// rather than refactored as scope creep.
|
|
"ignore": [
|
|
// timeline.ts: collectRuntimeTimelinePayload (CRITICAL) pre-dates this PR;
|
|
// only an import line changed here (slideshow/sceneId → slideshow/index),
|
|
// but the line-shift fingerprint makes fallow re-flag inherited complexity.
|
|
"packages/core/src/runtime/timeline.ts",
|
|
// sceneId.ts: trivial 5-cyclomatic guard, moved verbatim from
|
|
// packages/core/src/slideshow/ into parsers; flagged only because the move
|
|
// makes fallow treat it as a fresh finding.
|
|
"packages/parsers/src/slideshow/sceneId.ts",
|
|
// assetPaths.ts / rewriteSubCompPaths.ts: pure URL/asset-path helpers moved
|
|
// verbatim from packages/core/src/compiler/ into parsers. The move makes
|
|
// fallow score them as fresh (high CRAP = inherited complexity with no
|
|
// coverage mapping yet); the logic is unchanged.
|
|
"packages/parsers/src/assetPaths.ts",
|
|
"packages/parsers/src/rewriteSubCompPaths.ts",
|
|
// gsapParser.ts: the recast/babel GSAP writer is a 2500-line legacy parser;
|
|
// moved from packages/core/src/parsers/ — same complexity rationale.
|
|
"packages/parsers/src/gsapParser.ts",
|
|
// htmlParser.ts has pre-existing complexity (moved from packages/core).
|
|
"packages/parsers/src/htmlParser.ts",
|
|
// studio-server files: pre-existing complexity (moved from packages/core/src/studio-api/).
|
|
// files.ts: executeGsapMutationRecast/Acorn are CRITICAL; excluded as files.ts
|
|
// was already in health.ignore at the old path (packages/core/src/studio-api/routes/files.ts).
|
|
"packages/studio-server/src/routes/files.ts",
|
|
"packages/studio-server/src/routes/render.ts",
|
|
"packages/studio-server/src/routes/thumbnail.ts",
|
|
"packages/studio-server/src/helpers/manualEditsRenderScript.ts",
|
|
"packages/studio-server/src/helpers/studioMotionRenderScript.ts",
|
|
"packages/studio-server/src/helpers/subComposition.ts",
|
|
// lint rule implementations and project linter: pre-existing complexity
|
|
// (moved from packages/core/src/lint/). File-level exemption avoids the
|
|
// line-shift fingerprint problem for inherited findings.
|
|
"packages/lint/src/rules/media.ts",
|
|
"packages/lint/src/rules/textures.ts",
|
|
"packages/lint/src/rules/gsap.ts",
|
|
"packages/lint/src/project.ts",
|
|
// SlideshowPanel.tsx: top-level editor panel that wires several independent
|
|
// sections (slides/inspector/branches/hotspot). Its cyclomatic count comes
|
|
// from that fan-out; splitting it would scatter shared state without
|
|
// reducing real complexity. File-level exemption (not an inline comment)
|
|
// avoids the line-shift fingerprint problem noted above.
|
|
"packages/studio/src/components/panels/SlideshowPanel.tsx",
|
|
// play.ts / present.ts: CLI command entrypoints whose cyclomatic count is
|
|
// browser/arg validation + server wiring (same shape as preview.ts). The
|
|
// serving logic is factored into utils/compositionServer.ts; the remaining
|
|
// body is linear validation that reads clearly inline.
|
|
"packages/cli/src/commands/play.ts",
|
|
"packages/cli/src/commands/present.ts",
|
|
// sync-agent-dirs.ts: a build-time codegen that regex-parses upstream
|
|
// agents.ts. parseAgents/resolveGlobalExpr are branchy by nature (literal
|
|
// vs base-var args, validation throws) but small and well-tested via the
|
|
// generated table's shape test; this is dev tooling, not shipped runtime.
|
|
"packages/cli/scripts/sync-agent-dirs.ts",
|
|
// Files modified only for import-path updates (one-line changes to switch
|
|
// from @hyperframes/core/* subpaths to the new packages). Their complexity
|
|
// is pre-existing; the line-shift fingerprint problem makes fallow treat
|
|
// the violations as new even though no logic changed.
|
|
"packages/cli/src/server/studioServer.ts",
|
|
"packages/core/src/core.types.ts",
|
|
"packages/core/src/generators/hyperframes.ts",
|
|
"packages/producer/src/services/htmlCompiler.ts",
|
|
"packages/studio/src/hooks/gsapRuntimeBridge.ts",
|
|
"packages/studio/src/hooks/gsapShared.ts",
|
|
"packages/studio/src/hooks/gsapDragPositionCommit.ts",
|
|
"packages/studio/src/hooks/gsapKeyframeCacheHelpers.ts",
|
|
"packages/studio/vite.config.ts",
|
|
"packages/cli/src/commands/lint.ts",
|
|
"packages/cli/src/commands/preview.ts",
|
|
"packages/cli/src/commands/publish.ts",
|
|
"packages/cli/src/server/studioServer.ts",
|
|
// set-version.ts: compareSemver helper has pre-existing complexity from
|
|
// semver string parsing logic; line-shift fingerprint problem from new
|
|
// packages added to PACKAGES array makes fallow treat it as new.
|
|
"scripts/set-version.ts",
|
|
// gsapRuntimeReaders.ts: pre-existing complexity in readAllAnimatedProperties;
|
|
// line-shift fingerprint from import-path updates triggers the violation.
|
|
"packages/studio/src/hooks/gsapRuntimeReaders.ts",
|
|
// In-page audit scripts: single large browser-side IIFE wrappers
|
|
// (auditLayout/__contrastAudit) with pre-existing CRITICAL helpers
|
|
// (textOverflowFixHint, selectorFor, the WCAG walk). Adding the small
|
|
// clip-path probe helpers shifts every function below it, so the line-shift
|
|
// fingerprint re-flags inherited complexity even though the new helpers are
|
|
// all at the lowest tier (<=5 cyclomatic).
|
|
"packages/cli/src/commands/layout-audit.browser.js",
|
|
"packages/cli/src/commands/contrast-audit.browser.js",
|
|
// lottie.ts: the flagged `seek` handler (lottie-web/dotLottie dual-API
|
|
// dispatch, unchanged by the duration-auto-inference work in this PR)
|
|
// pre-dates this PR's scope. New functions added earlier in the file
|
|
// (getInferredDurationSeconds + helpers) shifted its line numbers,
|
|
// breaking fallow's inherited-detection fingerprint. File-level
|
|
// exemption avoids the line-shift problem for this inherited finding.
|
|
"packages/core/src/runtime/adapters/lottie.ts",
|
|
],
|
|
},
|
|
}
|