focus-enginelisted

# Focus Engine Focus behavior for SwiftUI and UIKit apps targeting iOS 26+, iPadOS, macOS, tvOS, and visionOS connected-input paths. Covers keyboard focus, directional focus, scene-focused values, focus restoration, and UIKit focus guides. `focusSection()` guidance in this skill applies to macOS and tvOS. visionOS gaze-driven hover is an input affordance, not focus. Accessibility-specific focus for VoiceOver and Switch Control lives in the `ios-accessibility` skill. When a request mixes focus with accessibility or spatial input, keep the boundary explicit: - Use this skill for keyboard, remote, game-controller, and scene focus behavior. - For visionOS, describe gaze, direct touch, and pointer targeting as hover/input affordances, not focus. - For VoiceOver, Switch Control, Voice Control, or accessibility element ordering, give only a brief handoff to `ios-accessibility`. ## Contents - [SwiftUI FocusState](#swiftui-focusstate) - [Default Focus](#default-focus) - [Focused Values and Scene Values](#focused-values-and-scene-values) - [Focusable Interactions](#focusable-interactions) - [Focus Sections](#focus-sections) - [Focus Restoration](#focus-restoration) - [UIKit Focus Guides](#uikit-focus-guides) - [Common Mistakes](#common-mistakes) - [Review Checklist](#review-checklist) - [References](#references) ## SwiftUI FocusState Use `@FocusState` to read and write focus placement inside a scene. Use `Bool` for a single target or an optional `Hashable` enum for multiple targe