swiftui-ui-patterns

用途：为构建和重构 SwiftUI 视图、组件提供最佳实践与示例驱动指导，覆盖标签页架构设计、表单、加载状态、可访问性等。\n\n主要能力：既有项目流程要求先定位功能或屏幕及其主要交互模型（列表、详情、编辑器、设置、标签页），用 rg "TabView(" 等方法在仓库中找相近示例并阅读最接近的 SwiftUI 视图，再应用本地约定。新项目脚手架从 references/app-scaffolding-wiring.md 开始接线 TabView + NavigationStack + sheets，基于骨架添加最小 AppTab 与 RouterPath，并按需选择 TabView、NavigationStack、Sheets 等组件参考。\n\n通用规则：使用现代 SwiftUI 状态（@State、@Binding、@Observable、@Environment），避免不必要的 view model；优先组合、保持视图小而专注；用 async/await 配合 .task 并显式处理加载与错误状态；仅在编辑旧文件时保留旧模式；遵循项目格式化与风格指南。Sheets 优先用 .sheet(item:) 而非 .sheet(isPresented:)，避免在 sheet body 内用 if let，sheet 应自己持有动作并在内部调用 dismiss()，不转发 onCancel/onConfirm 闭包。\n\n用法：新视图流程为定义状态与归属位置、确定通过 @Environment 注入的依赖、勾勒层级并抽取子视图、按需用 .task 实现异步加载与显式状态枚举、交互 UI 添加可访问性标签或标识符、构建验证并更新调用点。组件参考以 references/components-index.md 为入口，新增参考时创建 references/<component>.md 并更新索引。\n\n限制：资料未提供官方文档、版本要求、收费或价格信息。