Fold the focus camera-tween into watchFocusTween

[rulkens]

What

The focus camera-tween was computed through an engine-injected chain:

updateSelectionFocus(ref)
  -> watchFocusTween -> runFocusTween (injected) -> makeRunFocusTween
     -> FocusTweenTable -> tweenToGalaxy / tweenToStructure / tweenToCameraSnapshot
        -> dispatch(startCameraTween) + scheduler.requestRender()

This folds all of that into the saga itself:

updateSelectionFocus(ref)
  -> watchFocusTween
     -> extractSelectionRow(ref, resolveDeps())          // ref -> row
     -> cameraRuntime()                                   // live from-pose + lens FOV (SagaContext)
     -> focusTweenDescriptor(row, from, fovY)             // pure galaxy/structure/milkyWay table
     -> put(startCameraTween(desc))

Why

• One home for the focus effect. The tween is the effect of the focus Intent; it now lives entirely in watchFocusTween as a thin resolve→build→dispatch shell, instead of being threaded through an engine-injected runner + table.
• milkyWay is no longer special. It was the odd arm going through tweenToCameraSnapshot; it's now a peer case in the pure focusTweenDescriptor table, emitting the same startCameraTween as galaxy/structure (tagged-union table dispatch, not a per-type handler set).
• No redundant render-wake. startCameraTween is a camera/* write, so watchWake/WAKE_ROUTES wakes the loop by construction (and the focus-ref write also wakes via watchSelectionWake). The explicit scheduler.requestRender() calls are gone.
• Engine/store seam, not a mirror. The genuinely-live state the saga needs (the visible from-pose + projection FOV) is read via a new cameraRuntime() reader on SagaContext — the same well-worn injection as resolveDeps / reconcile / runTierTransition. The mutable cameraRuntime Resources stay out of the timeless camera slice by design.

Deletes

makeRunFocusTween, tweenToGalaxy, tweenToStructure, the FocusTweenTable wiring in engine.ts, the orphaned TweenTarget type, and runFocusTween from SagaContext. tweenToCameraSnapshot stays for the home button (minus its redundant requestRender).

Net −433 lines.

Tests

• New focusTweenDescriptor unit tests (per-arm target/distance, yaw/pitch preserved, fresh-array copy).
• Rewritten watchFocusTween saga test (dispatches startCameraTween with the built descriptor; no-ops on non-focus write / cam-not-ready / null ref).
• SagaContext contract test updated runFocusTween -> cameraRuntime.
• npm run typecheck clean; full suite 2977 passing.

Follow-up (separate PR, by request): relocate the pure camera math (poseOf, evaluateTween, spinAutoRotate, *FocusDistance, …) into src/utils/camera/.

🤖 Generated with Claude Code

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	skymap	9928788	Commit Preview URL Branch Preview URL	Jun 20 2026, 04:39 PM