figma-ios-selection-interaction

Figma 选择交互逻辑生成

职责范围

• ✅ 从 figma-ios-preload-data 数据包（design.json）自动识别选择交互模式（单选/多选/Toggle）
• ✅ 生成选中态变化逻辑（更新数据模型、刷新 UI）
• ✅ 生成 didSelectItemAt（列表统一 UICollectionView；不用 UITableView / didSelectRowAt）
• ✅ 生成单个按钮 Toggle 逻辑
• ✅ 集成 RxSwift 交互模式（按 host.interaction；默认也可 target-action，见 rxswift skill）
• ✅ 保持数据模型与 UI 同步
• ❌ 不处理业务逻辑（网络请求、页面跳转等，留 TODO 注释）
• ❌ 不处理动画效果（由其他 Skill 负责）
• ❌ 不从 Figma MCP / REST 再拉数据；视觉差异读 design.json（或已由 figma-ios-component-state-recognition 提取的状态）
• ❌ 不替代 figma-ios-component-state-recognition（外观 / updateAppearance）与 figma-ios-uicollectionview-codegen（CV 骨架）

---

适用场景

场景	Figma 特征	生成代码
ListView 单选	多个同类节点，只有 1 个选中	didSelectItemAt + 单选互斥逻辑
ListView 多选	多个同类节点，多个选中	didSelectItemAt + Toggle 逻辑
单个按钮 Toggle	单个节点有选中态	RxSwift tap + Toggle 逻辑
SegmentedControl	多个并列按钮，1 个选中	按钮组 + 单选互斥逻辑

---

识别规则

规则 1：ListView 单选模式

触发条件（必须全部满足）：

def is_single_selection_listview(figma_nodes):
    """
    判断是否为单选 ListView
    """
    # 1. 节点数量 ≥ 2
    if len(figma_nodes) < 2:
        return False
    
    # 2. 有选中态视觉差异（读 design.json 的 fills/strokes/font，见 component-state-recognition）
    if not has_selection_state(figma_nodes):
        return False
    
    # 3. 只有 1 个节点处于选中态
    selected_count = count_selected_nodes(figma_nodes)
    if selected_count != 1:
        return False
    
    # 4. 是 ListView（本仓统一 UICollectionView；见 listview-recognition）
    if not is_listview(figma_nodes):
        return False
    
    return True

识别结果：

{
    'interaction_mode': 'single_selection',
    'default_index': 0,  # 默认选中第一个（"绝地求生"）
    'ui_component': 'UICollectionView',
    'refresh_mode': 'reload_all'  # 刷新所有 Cell
}

---

规则 2：ListView 多选模式

触发条件（必须全部满足）：

def is_multiple_selection_listview(figma_nodes):
    """
    判断是否为多选 ListView
    """
    # 1. 节点数量 ≥ 2
    if len(figma_nodes) < 2:
        return False
    
    # 2. 有选中态视觉差异
    if not has_selection_state(figma_nodes):
        return False
    
    # 3. 多个节点处于选中态（≥ 2）
    selected_count = count_selected_nodes(figma_nodes)
    if selected_count < 2:
        return False
    
    # 4. 是 ListView
    if not is_listview(figma_nodes):
        return False
    
    return True