fix(cli): sweep_static geometry fingerprint now covers SVG stroke/dash motion

[miga-heygen]

Read after #3707 — this PR is stacked on magi/fix-sweep-static-text-fingerprint and adds one channel to the motion classifier that PR introduces.

Summary

hyperframes check's seek-audit fires sweep_static ("Timeline did not advance under seek") when the per-sample motion signature is byte-identical across the whole run. An SVG stroke-dasharray / stroke-dashoffset "draw the line in" entrance — the standard way to animate a connector or diagram line — moves no bounding box and no opacity, so a genuinely animating composition using it was flagged as a frozen timeline.

With #3707 the signature has a single owner (packages/cli/src/commands/motion-signature.browser.js, ELEMENT_CHANNELS), shared by the frozen-sweep guard and keepsMoving liveness. This PR:

• Appends strokeDashChannel to ELEMENT_CHANNELS. Hashes the computed dash pattern and offset for SVG geometry elements (SVGGeometryElement: path/circle/ellipse/rect/line/polyline/polygon) with a painted stroke. none and all-zero patterns (which render solid), unpainted strokes (none, transparent, zero width, stroke-opacity: 0) and non-SVG elements contribute "", so ordinary compositions gain no payload.
• Widens isVisibleElement for stroked geometry with one degenerate bbox axis. Chromium's getBoundingClientRect for SVG shapes is the object bounding box without the stroke: a straight horizontal or vertical connector reports 0 height or 0 width regardless of stroke-width, so the box gate dropped exactly the most common shape for this animation. A stroked shape with one non-degenerate axis now counts as visible. As a consequence motion-sample's visible bit for such connectors is corrected too (it previously reported them invisible).
• Treats <defs>, <clipPath>, <mask>, <pattern>, <marker> and <symbol> as never-painted subtrees in the existing hidden-subtree walk (the same container list layout-audit.browser.js skips for connectors). display is not inherited — a child of a display:none parent computes display: block — so descendants are excluded only through the ancestor walk, which now also starts at these containers rather than relying on one engine's empty-box behaviour for their descendants. The match is namespaced (instanceof SVGElement), so an HTML element that merely shares a name is not pruned.

Test plan

• motion-signature.browser.test.ts (happy-dom, 43 passing): dash-offset moves on a 290×0 connector change the signature, and so does a stroke-dasharray change at a fixed offset (both the exact sweep and the quantized liveness signature); identical scene hashes identically; dash motion under a display:none ancestor and inside <defs> / <clipPath> / <mask> / <pattern> / <marker> / <symbol> is ignored; one table row per channel guard — stroke-opacity: 0, stroke: rgba(0, 0, 0, 0), stroke-width: 0, stroke-dasharray: 0 and 0 0 (solid) — leaves the signature unchanged under a moving offset; a dashed stroke inherited by a <g> / <text> (not SVGGeometryElement) is not signed; a fade inside an HTML element named <defs> still changes the signature. A source-parity test extracts UNPAINTED_SVG_CONTAINERS and layout-audit's CONNECTOR_SKIP_CONTAINERS from the two files and asserts the name sets are equal (case-insensitive), so the hand-kept copy cannot drift silently. Fixtures use the real Chromium bbox of a horizontal stroked path (height 0) so they pin the widened gate, not the pre-existing box path.
• motion-signature.browser.chromium.test.ts (real Chromium, 44 passing): a stroke-dashoffset draw-in and a fixed-offset stroke-dasharray change on a straight connector each change both the sweep and the liveness signature; dash motion under display:none and inside all six unpainted containers leaves both identical; the same five guard rows as the happy-dom suite (against Blink's computed values — stroke: transparent computes to rgba(0, 0, 0, 0)) and the <g> / <text> case leave both identical; a fade inside an HTML <defs> element changes both signatures.
• motion-sample.browser.test.ts (happy-dom, 8 passing) unchanged.
• Real-Chromium probes confirmed: straight <path> reports a 290×0 box; display:none descendants compute display: inline; descendants of all six containers (<defs>, <clipPath>, <mask>, <pattern>, <marker>, <symbol>) report 0×0 while checkVisibility returns true for them, so the container rule is what excludes them by intent rather than the box gate; computed stroke-dashoffset is rounded (144.99999999px → 145px), so the signature cannot vary on its own at a fixed seek.
• Review passes on the diff surfaced and fixed: stroke: transparent / stroke-opacity: 0 counting as painted; stroke-dasharray: 0 (solid) counting as a pattern; tag-name matching hitting HTML unknown elements (replaced by instanceof SVGGeometryElement).
• Review passes on the container rule surfaced and fixed: <mask> / <pattern> / <marker> missing from the never-painted set although they meet its definition (and the widened bbox gate would otherwise admit a straight connector inside them); the tag-name match lacking a namespace guard.
• Mutation check on the guards: hashing the offset only, dropping the transparent-colour guard, the stroke-width > 0 guard, or the all-zero-is-solid guard, widening the element filter to SVGElement, and removing a name from UNPAINTED_SVG_CONTAINERS each fail exactly their own row(s) in both suites.
• oxlint, oxfmt --check, and tsc --noEmit clean for packages/cli. The happy-dom suites cannot be collected directly in the local sandbox under bun (No such built-in module: node: from the @vitest-environment happy-dom loader); they were run with --environment node plus a setup file that populates globals from a happy-dom Window, and pass. CI runs them as-is.

Deliberately out of scope: dashing on <text> / <use> (no channel today); other "moves nothing else" SVG reveals (fill-opacity, stroke-opacity, gradient stop-opacity); animation of the content of a <mask> / <pattern> / <clipPath> / <marker> referenced by an otherwise static element (it changes pixels through the referencing element, whose own channels do not move — and Blink gives that content 0×0 boxes, so it was never signed); and pathLength attribute animation (rescales the dash pattern with no computed-style change) — this closes the stroke/dash gap only.

[miga-heygen]

Addressed in b8abfc7.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
hyperframes	🟢 Ready	View Preview	Sep 14, 2026, 6:29 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

[miga-heygen]

Rebased onto bfaf6eb as 582018d.

[miga-heygen]

Rebased onto 09418ae as 5f4196b.

[miga-heygen]

Updated as 95624bc: SVG container set and guard.

[miga-heygen]

Addressed in 434d1e0.