feat(ipad): W1-W3 — adaptive split-view layout + finding fixes

T-iPad-2: AdaptiveRootView/LayoutPolicy (sole size-class decision), SplitRootView (NavigationSplitView sidebar+detail), StackRootView (iPhone path verbatim, zero regression); privacy shade hoisted to shared ZStack top for both branches T-iPad-3: KeyBarVisibility predicate (hide when hardware keyboard present), pointer context menu (copy/new-in-cwd/kill, all via existing channels) T-iPad-4: Projects multi-column grid on iPad (idiom-gated), adaptive sheet detents T-iPad-5 findings (4/4 fixed): kill onKillSession thread-through + AppCoordinator.killCurrentSession; split route-gated to .sessions (iPad first-run pairing); continue-last banner in split sidebar; iPad XCUITest deferred (covered by SidebarSelectionTests) Verified: iPhone 16 277 + iPad Pro 11 278 tests green; packages 261 + integration 10; zero changes under ios/Packages, src/, public/
2026-07-05 19:58:30 +02:00
parent 77502ec4fe
commit 823432b1c8
18 changed files with 1594 additions and 84 deletions
--- a/ios/App/WebTerm/Wiring/SplitRootView.swift
+++ b/ios/App/WebTerm/Wiring/SplitRootView.swift
@@ -0,0 +1,110 @@
+import SwiftUI
+
+/// T-iPad-2 · regular 宽度（iPad 全屏 / 大分屏 / Stage Manager 大窗）的分栏根
+/// 视图。左 sidebar = 会话列表（复用 `SessionListScreen` **不改一行** + 与
+/// stack 同款的「项目」leading 工具栏入口）；右 detail = `TerminalContainerView`
+/// （终端 + gate/digest 叠层，复用不动），无打开会话时给「选择或新建会话」占位。
+///
+/// 设计要点：
+/// - **detail 复用 `TerminalContainerView`**：终端组装与它挂 push destination 还是
+///   split detail 无关，只换外层容器、内容零改（PLAN_IOS_IPAD §1）。
+/// - **选中态经 `AppCoordinator` 单一真值**：sidebar 触发面全部走
+///   `selectSidebarItem` / `open`（同 stack 的既有路由），不新开会话生命周期。
+/// - **detail 终端仍带 `.id(controller.id)`**：换会话时新 controller → 新
+///   SwiftTerm 视图（回放 ring buffer），identity 稳定复用 T-iOS-29 语义。
+/// - **隐私遮罩不在这里**：它在 `AdaptiveRootView` 的 ZStack 顶层，两分支共享，
+///   故 detail 终端字节同样在 `scenePhase != .active` 时被遮（安全不变式）。
+struct SplitRootView: View {
+    @Bindable var coordinator: AppCoordinator
+
+    var body: some View {
+        NavigationSplitView {
+            sidebar
+        } detail: {
+            detail
+        }
+    }
+
+    // MARK: - Sidebar（会话列表 + 项目入口，复用 SessionListScreen）
+
+    private var sidebar: some View {
+        SessionListScreen(
+            viewModel: coordinator.sessionList,
+            onOpen: { request in
+                // 分栏只是又一个触发面：映射到同一 selectSidebarItem 路由。
+                coordinator.selectSidebarItem(sidebarItem(for: request))
+            },
+            onAddHost: { coordinator.presentAddHost() }
+        )
+        .safeAreaInset(edge: .bottom) { continueLastBanner }
+        .toolbar { projectsToolbarItem }
+    }
+
+    /// 与 `StackRootView.continueLastBanner` 同款「继续上次会话」（冷启动第 5 步）
+    /// —— 分栏 sidebar 也提供，iPad 用户不丢该入口（T-iPad-5 finding）。
+    @ViewBuilder private var continueLastBanner: some View {
+        if coordinator.continueLastSessionId != nil {
+            Button {
+                coordinator.openContinueLast()
+            } label: {
+                Label(RootCopy.continueLast, systemImage: "arrow.uturn.forward.circle.fill")
+                    .frame(maxWidth: .infinity)
+            }
+            .buttonStyle(.borderedProminent)
+            .padding(.horizontal, RootMetrics.bannerHorizontalPadding)
+            .padding(.vertical, RootMetrics.bannerVerticalPadding)
+            .background(.thinMaterial)
+        }
+    }
+
+    /// 列表的 `OpenRequest` → sidebar 选中项（sessionId 有无 = 采纳既有 / 新建）。
+    private func sidebarItem(for request: SessionListViewModel.OpenRequest) -> SidebarItem {
+        request.sessionId.map(SidebarItem.session) ?? .newSession
+    }
+
+    /// 与 `StackRootView.projectsToolbarItem` 同款（leading 位、同 disabled 条件、
+    /// 复用 `presentProjects`）—— iPad 上 Projects 本期仍走既有 sheet（大屏化留
+    /// 给 T-iPad-4）。
+    @ToolbarContentBuilder private var projectsToolbarItem: some ToolbarContent {
+        ToolbarItem(placement: .topBarLeading) {
+            Button {
+                coordinator.presentProjects()
+            } label: {
+                Label(RootCopy.projects, systemImage: "folder")
+            }
+            .disabled(coordinator.sessionList.activeHost == nil)
+            .accessibilityIdentifier("sessions.projectsButton")
+        }
+    }
+
+    // MARK: - Detail（终端或占位）
+
+    @ViewBuilder private var detail: some View {
+        if let controller = coordinator.terminalController {
+            NavigationStack {
+                TerminalContainerView(
+                    controller: controller,
+                    onNewSessionInCwd: { coordinator.openNewSessionInCurrentCwd() },
+                    onKillSession: { coordinator.killCurrentSession() } // T-iPad-3
+                )
+                .id(controller.id) // T-iOS-29 · identity per controller
+            }
+        } else {
+            placeholder
+        }
+    }
+
+    private var placeholder: some View {
+        ContentUnavailableView {
+            Label(SplitCopy.placeholderTitle, systemImage: "sidebar.left")
+        } description: {
+            Text(SplitCopy.placeholderHint)
+        }
+    }
+}
+
+/// split 专属用户可见文案（「项目」标签复用 `RootCopy.projects`，DRY）。
+private enum SplitCopy {
+    static let placeholderTitle = "选择或新建会话"
+    static let placeholderHint = "从左侧选择一个运行中的会话，或新建一个开始工作。"
+}