Add configurable workspace camera animation mode

[HendrikD2005]

Purpose

Add a configurable workspace camera animation mode so users can choose whether workspace pan and zoom changes remain immediate (Minimal) or transition smoothly (Smooth) during scroll and zoom gestures. Minimal preserves the current direct behavior. Smooth should feel comparable to canvas tools such as Miro: zooming in or out eases toward the target view instead of snapping instantly.

Agent Execution Mode

• Single-agent
• Agent team
• Audit-only
• Refactor-only
• Feature delivery
• Audit/verification-heavy
• Human-led / agent-assisted

Agent Routing Hints

• Lead agent: developer.
• Suggested specialist agents: test-engineer, performance-engineer, a11y-auditor, verifier.
• Primary area label: area: workspace.
• Expected write ownership: packages/keiko-ui/src/app/components/desktop/** and focused tests for workspace camera behavior.

Existing Capability Review

• Existing workspace UI surfaces and ADR constraints were inspected before implementation.
• The existing useWorkspace camera state and DOM workspace renderer will be reused.
• The implementation is a real capability gap: the workspace currently coalesces view updates but does not visually interpolate camera movement.
• No parallel canvas, graph, camera store, server route, or durable persistence store is introduced.

Expected Verification

• Required GitHub check: ci.
• Focused unit/component coverage for Minimal, Smooth, and reduced-motion behavior.
• Studio browser quality gate when validating visible workspace behavior.
• Studio performance awareness because the feature touches pan/zoom rendering.
• Visual regression evidence if reviewers request it for the settings or workspace surface.

Scope

• Add a workspace camera animation mode with the values Minimal and Smooth.
• Preserve current scroll and zoom behavior when Minimal is active.
• Add smooth interpolation for viewport pan and zoom changes when Smooth is active.
• Keep the canonical workspace state model owned by useWorkspace and rendered by the existing DOM workspace.
• Respect reduced-motion preferences so users who prefer less motion are not forced into animated camera transitions.
• Cover the behavior with focused tests and relevant local CI checks.

Out of Scope

• New canvas or graph substrate adoption.
• Server-side persistence, account-level preferences, or new BFF routes.
• Reworking workspace object layout, window registry, connection rendering, fit-to-view, grouping, or keyboard graph navigation.
• Large-scale visual redesign of the workspace shell.

Deliverables

• Workspace camera animation mode type/configuration and settings integration.
• Smooth camera interpolation for scroll/zoom transitions while preserving Minimal parity.
• Reduced-motion fallback that behaves like Minimal.
• Focused tests for minimal vs smooth behavior and reduced-motion behavior.
• Local verification notes for the relevant CI commands.

Acceptance Criteria

• Minimal mode keeps current workspace pan and zoom behavior immediate.
• Smooth mode eases scroll and zoom camera changes toward the target view without changing final coordinates or zoom constraints.
• Smooth zoom keeps the pointer/world-coordinate anchoring behavior consistent with the existing zoom implementation.
• Reduced-motion preferences disable camera animation even when Smooth is selected.
• The implementation extends the existing useWorkspace/Workspace.tsx substrate and does not introduce a parallel camera state owner.
• Focused tests pass locally, and the implementation remains compatible with the required ci pipeline.

Engineering Notes

• ADR-0026 establishes useWorkspace as the workspace editor, the DOM as renderer, and View { zoom, x, y } as the canonical camera record.
• ADR-0027 keeps workspace UI state ownership in keiko-ui; this feature should not add a new durable store.
• ADR-0028 should be respected if commands/events are touched; viewport animation should not alter undo semantics.
• Keep runtime dependencies minimal. Prefer requestAnimationFrame, deterministic easing, and cleanup on unmount over adding an animation library.
• The smooth path should animate display projection while preserving a single canonical target view to avoid drift, stale persistence, or inconsistent connection rendering.

[HendrikD2005]

Implementation completed locally on branch codex/fix-window-content-zoom-drag.

Summary:

• Added a browser-local workspace camera animation preference with Minimal and Smooth modes.
• Wired the setting through SettingsPanel -> AppShell -> useWorkspace.
• Preserved Minimal as the default/current behavior.
• Added requestAnimationFrame-based smooth interpolation for workspace pan/zoom targets without introducing a parallel camera state owner or new runtime dependency.
• Honored prefers-reduced-motion: reduce by falling back to immediate updates.
• Added focused tests for smooth camera motion, reduced-motion fallback, and Settings persistence/event dispatch.

Local verification:

• npm.cmd --workspace @oscharko-dev/keiko-ui run test -- useWorkspace.wheel.test.tsx passed: 6 tests.
• npm.cmd --workspace @oscharko-dev/keiko-ui run test -- SettingsPanel.test.tsx passed: 29 tests.
• npm.cmd run typecheck passed.
• npm.cmd run lint passed.

Notes:

• Full npm.cmd test was run, but the repository-wide suite is currently red on this Windows environment in unrelated filesystem/symlink/POSIX-mode and unrelated package tests.
• Full keiko-ui suite was also run; 222/223 files passed, with failures isolated to existing src/app/globals.css.test.ts CSS string/snapshot expectations, not the touched workspace/settings files.

[HendrikD2005]

Draft PR opened for this issue: #1625

Branch: codex/issue-1623-workspace-camera-animation
Commit: 816bdacb add workspace camera animation mode

Note: I created a clean issue-specific branch from origin/dev and cherry-picked only the workspace camera animation commit onto it. The PR file list now contains only the seven files in the Issue #1623 scope.

[HendrikD2005]

Updated PR #1625 per latest feedback:

• Replaced the two camera mode buttons with a 0-100 smoothness slider.
• Left label: Minimal; right label: Smooth / Sanft.
• Slider value 0 keeps immediate pan/zoom behavior.
• Moving right increases camera easing duration up to the softest setting.
• Reduced-motion users still receive immediate updates at every slider value.
• Legacy keiko.workspace.camera.animationMode = smooth is read as slider value 100.

New commit pushed: 9b787ed5 replace camera mode buttons with smoothness slider

Verification repeated:

• npm.cmd --workspace @oscharko-dev/keiko-ui run test -- useWorkspace.wheel.test.tsx passed: 6 tests.
• npm.cmd --workspace @oscharko-dev/keiko-ui run test -- SettingsPanel.test.tsx passed: 29 tests.
• npm.cmd run typecheck passed.
• npm.cmd run lint passed.

[HendrikD2005]

Look: #1623 and #1625