AppkitPro

Run the structured review pass, which checks the AppKit-SwiftUI seam across five areas: magnification, hosting, performance, input, and accessibility. Findings are reported by file with the rule name and a before/after fix, prioritized with seam defects first.

Use setMagnification(_:centeredAt:) exactly once per tick, clamped between minMagnification and maxMagnification, and never mutate magnification directly mid-gesture. Convert event locations into the flipped document view's coordinate space before doing zoom-center or hit math.

Use NSHostingView when SwiftUI chrome lives inside an AppKit hierarchy, updating it by reassigning rootView. Use NSViewRepresentable when an AppKit view lives inside SwiftUI, keeping updateNSView idempotent and routing callbacks through the Coordinator.

The hosting view forwards hits by default. Subclass NSHostingView and override hitTest to return nil so the overlay stays transparent to input, letting the AppKit container own routing for drag zones, resize edges, and content clicks.

Use detach-and-snapshot: cards offscreen or below a zoom threshold show a cheap bitmap with the live view removed from the hierarchy. Re-render at 1:1 backing scale only at gesture-end, and batch mode transitions in one CATransaction with actions disabled.

It covers the AppKit layer and the AppKit-SwiftUI seam only; pure SwiftUI views belong to a SwiftUI-focused review, and actor or Sendable design belongs to a concurrency-focused one. It reports genuine defects with concrete fixes rather than style preferences.