用途：这是 @expo/ui/swift-ui 与 @expo/ui/swift-ui/modifiers 的库参考，用于在 iOS 上用 Expo 渲染原生 SwiftUI 视图。适用于从 React Native 基础组件迁移到原生 SwiftUI、构建新屏幕、定位 iOS 26 特性、审查导入代码，以及排查视图不渲染、尺寸错误或忽略样式等问题。
主要能力：按级联影响分为 8 类规则——Setup 与 Host 边界、iOS 26 HIG 组合规则、Modifiers 系统（均为 CRITICAL），Layout 组件、Input 与控件、Navigation 与浮层（HIGH），Display 与反馈（MEDIUM-HIGH），State 与横切模式（MEDIUM）。关键要点包括：每个 SwiftUI 子树用 Host 包裹并以 matchContents 适配尺寸；modifier 通过 modifiers 属性传入且顺序有意义，需从 @expo/ui/swift-ui/modifiers 导入；Form、List 使用 useViewportSizeMeasurement；玻璃效果放入 GlassEffectContainer 且不叠加；iPhone 不用 Popover 而用 BottomSheet；输入控件用 useNativeState 与 worklet 写入。
使用方式：按 references/{prefix}-{slug}.md 逐个查阅规则文件，每条含原因说明、错误示例、正确示例及最小差异，必要时附替代方案、禁用场景与官方参考链接。失败点记录在 gotchas.md。
适用场景：构建 iOS 屏幕、选择容器（Form/List/ScrollView）、组合展示面（Alert、ConfirmationDialog、BottomSheet、Popover）、编写受控输入等。
限制：仅覆盖 iOS SwiftUI，不含 Android Jetpack Compose 与通用跨平台组件；不含导航路由，路由请用 expo-router；大部分规则假设 iOS 17 起，Liquid Glass 需 iOS 26 且需版本判断；不涵盖表单校验库。具体收费与价格暂未提供。