feat(studio): canvas chrome components (unwired)

[ukimsanov]

What

the canvas-side NLE chrome, unwired: DomEditSelectionChrome (rotated selection chrome + corner handles), domEditResizeLocal (+tests, local-space resize math), useDomEditNudge (arrow-key nudge hook), PreviewOverlays (the canvas overlay stack for the NLE shell).

Why

the visible canvas editing layer, reviewable before the overlay swap rewires DomEditOverlay onto it.

How

new files compiled against the coexistence layer; TEMP(studio-dnd) entry registrations for the unwired components, removed at the app-shell swap.

Test plan

bunx vitest run domEditResizeLocal.test.ts; tsc --noEmit; fallow audit clean.

---

Stack position 17/25 — studio NLE overhaul (CapCut-parity timeline + canvas). Graphite manages bases; merge from #2192 upward. Temporary TEMP(studio-dnd) fallow entries (unwired-component windows) are all removed by #2213 (app-shell swap), whose tree is byte-identical to the fully-verified integration branch.

[ukimsanov]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• feat(studio): assets/blocks panel behaviors + preview helpers #2216
• feat(studio): timeline visual refresh #2215
• feat(studio): clip thumbnail modules #2214
• feat(studio): app shell swap — mount EditorShell, retire the legacy engine #2213
• feat(studio): timeline glue swap — Timeline/TimelineCanvas onto the NLE engine #2212
• feat(studio): canvas glue swap — overlay, gestures, selection to final form #2211
• feat(studio): sidebar asset card (unwired) #2210
• feat(studio): NLE shell assembly (unwired) #2209
• feat(studio): canvas chrome components (unwired) #2208 👈 (View in Graphite)
• feat(studio): timeline interaction hooks and lanes component (unwired) #2207
• feat(studio): clip drag engine — preview and commit (unwired) #2206
• feat(studio): glue API coexistence layer for the NLE swap #2205
• feat(studio): NLE shell components — context provider, panes, overlays (unwired) #2204
• feat(studio): arrow-key nudge step math (unwired) #2203
• feat(studio): canvas context menu and z-order actions (unwired) #2202
• test(studio): characterization suites for resize commit and razor history #2201
• feat(studio): asset click policy and canvas nudge gate #2200
• feat(studio): timeline lane-zone model #2199
• feat(studio): timeline z-stacking sync model #2198
• feat(studio): multi-clip drag preview math #2197
• feat(studio): timeline magnetic snapping #2196
• feat(studio): timeline collision and placement model #2195
• feat(studio-server): files route extensions #2194
• feat(studio): seek-restore contract for player reloads #2193
• feat(studio): timeline leaf helpers — audio inspector, zoom math, UI prefs #2192
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[miga-heygen]

Reviewed as part of the 25-PR NLE overhaul stack. Full stack review on #2205 (the keystone). No blockers on this PR. — Miga

[vanceingalls]

R1 — Batch C (unwired chrome / assembly)

Verdict: 🟢 approve

Reviewed at 2c33b510. Focus per Phase-2 recon: canvas chrome components are unwired; useDomEditNudge cross-batch import wiring resolves; fallow entries tracked for #2213 removal.

Unwired assertion — 🟢

Grepped packages/studio/src/**/*.{ts,tsx} at this SHA for consumers of every new symbol; all resolve to sibling new files only:

• DomEditSelectionChrome — no live-tree consumer.
• useDomEditNudge — no live-tree consumer.
• nle/PreviewOverlays (new) — no consumer (wired later; the PreviewOverlays symbol exists only in this new file, find confirms no sibling with the same name).
• domEditResizeLocal — consumed only by sibling new DomEditSelectionChrome.tsx:8 (resolveRotatedResizeCursor).

Cross-batch import wiring — 🟢

useDomEditNudge.ts depends on the earlier batches; verified all imports resolve at this SHA:

• @/utils/canvasNudgeGate (from #2200) → packages/studio/src/utils/canvasNudgeGate.ts present, exports acquireCanvasNudgeKeys.
• ./domEditNudge (from #2203) → packages/studio/src/components/editor/domEditNudge.ts present, exports CANVAS_NUDGE_STEP_PX, CANVAS_NUDGE_SHIFT_STEP_PX, resolveCanvasNudgeDelta, applyManualOffsetNudgeCommit, etc.
• ./domEditOverlayGeometry, ./domEditOverlayGestures, ./domEditing — all pre-existing.

Fallow lifecycle — 🟢

Added to .fallowrc.jsonc:

• unusedExports block: DomEditSelectionChrome.tsx, useDomEditNudge.ts, nle/PreviewOverlays.tsx — 3 entries.
• duplication ignore block: DomEditOverlay.tsx, DomEditSelectionChrome.tsx — 2 entries (coexistence-window clones).
• complexity ignore block: DomEditSelectionChrome.tsx, useDomEditNudge.ts — 2 entries.

All 7 entries share the TEMP(studio-dnd) pointer at studio-dnd/pr22. DomEditSelectionChrome.tsx correctly appears in both the unusedExports block (as a new file) and the duplication ignore block (its live sibling DomEditOverlay.tsx presumably contains overlapping structure — this is exactly the coexistence-window contract).

Notes for Phase 3 cross-check

None. Behavior-preserving unwired ship.

R1 by Via