web-terminal/ios/App/WebTermTests/TimelineSheetTests.swift

import Foundation
import SwiftUI
import Testing
import WireProtocol
@testable import WebTerm

/// T-iOS-24 · Timeline sheet（完整时间线钻取）。
///
/// 覆盖面（Steps 测试先行）：
/// - `/live-sessions/:id/events` 全量渲染管线：呈现顺序**逐行镜像 web**
///   （public/timeline.ts:174-189 render()——`slice(0, maxEvents)` 先截断
///   再 reverse，newest-first 展示）；
/// - class → 图标映射逐字镜像 web `timelineIcon`（public/timeline.ts:88-96），
///   颜色为语义映射（web CSS 未定义 tl-icon-* 颜色——iOS 对齐
///   SessionListScreen 的状态色约定）；未知 class 走 fallback（防御纵深，
///   服务器是不可信输入源——即使 APIClient.decodeList 已丢弃未知类）；
/// - timeline disabled（服务器回 `[]`，src/server.ts:589-591）→ 空态而非错误；
/// - fetch 失败 → 显式可重试错误态（retry 后可达 .loaded）；
/// - digest「展开」入口的装配缝：`forSession` 工厂（sessionId 未知 → 不出
///   sheet；已知 → 原样传给 events source）。
@MainActor
@Suite("TimelineSheet")
struct TimelineSheetTests {
    // MARK: - Fixtures

    private static func event(
        at: Int, cls: String = "tool", label: String = "ran Bash"
    ) -> TimelineEvent {
        TimelineEvent(at: at, class: cls, toolName: nil, label: label)
    }

    private struct FetchError: Error {}

    /// 记录 source 收到的 sessionId（@Sendable 闭包内可变状态 → actor）。
    private actor SourceRecorder {
        private(set) var ids: [UUID] = []
        func record(_ id: UUID) { ids = ids + [id] }
    }

    // MARK: - Phase 状态机

    @Test("初始 phase = .loading（load 前不渲染内容）")
    func initialPhaseIsLoading() {
        let vm = TimelineViewModel(fetch: { [] })

        #expect(vm.phase == .loading)
    }

    @Test("load 成功：服务器 oldest-first → 展示 newest-first（镜像 web reverse）")
    func loadReversesToNewestFirst() async {
        let oldestFirst = [
            Self.event(at: 1, label: "ran Bash"),
            Self.event(at: 2, cls: "waiting", label: "waiting for approval"),
            Self.event(at: 3, cls: "done", label: "finished"),
        ]
        let vm = TimelineViewModel(fetch: { oldestFirst })

        await vm.load()

        #expect(vm.phase == .loaded(Array(oldestFirst.reversed())))
    }

    @Test("超过 maxEvents：镜像 web slice(0,50) 再 reverse——先截前 50 条再反转")
    func loadCapsThenReversesLikeWeb() async throws {
        let sixty = (1...60).map { Self.event(at: $0) }
        let vm = TimelineViewModel(fetch: { sixty })

        await vm.load()

        guard case .loaded(let shown) = vm.phase else {
            Issue.record("期望 .loaded，实际 \(vm.phase)")
            return
        }
        #expect(shown.count == TimelineViewModel.maxEvents)
        #expect(shown.first?.at == 50) // slice(0,50) 的最新一条
        #expect(shown.last?.at == 1)   // 反转后最旧的在末尾
    }

    @Test("maxEvents 钉住 web parity 值 50（public/timeline.ts:20）")
    func maxEventsMirrorsWebDefault() {
        #expect(TimelineViewModel.maxEvents == 50)
    }

    @Test("服务器回空数组（timeline disabled）→ .empty，绝不是 .failed")
    func emptyArrayIsEmptyStateNotError() async {
        let vm = TimelineViewModel(fetch: { [] })

        await vm.load()

        #expect(vm.phase == .empty)
    }

    @Test("fetch 抛错 → .failed（显式可重试错误态）")
    func fetchFailureBecomesFailedPhase() async {
        let vm = TimelineViewModel(fetch: { throw FetchError() })

        await vm.load()

        #expect(vm.phase == .failed)
    }

    @Test("重试：失败后再次 load 成功 → .loaded（错误态可恢复）")
    func retryAfterFailureRecovers() async {
        let flag = SourceRecorder() // 复用 actor 当计数器：首轮抛错，次轮成功
        let events = [Self.event(at: 7)]
        let vm = TimelineViewModel(fetch: {
            if await flag.ids.isEmpty {
                await flag.record(UUID())
                throw FetchError()
            }
            return events
        })

        await vm.load()
        #expect(vm.phase == .failed)

        await vm.load() // TimelineSheet 的「重试」按钮走的就是这条路径

        #expect(vm.phase == .loaded(events))
    }

    // MARK: - digest「展开」入口的装配缝（forSession 工厂）

    @Test("forSession(nil)：会话尚未 adopted → 不构造 VM（无 sheet 可出）")
    func forSessionWithoutIdReturnsNil() {
        let vm = TimelineViewModel.forSession(nil, source: { _ in [] })

        #expect(vm == nil)
    }

    @Test("forSession(id)：load 把 sessionId 原样传给 events source")
    func forSessionPassesSessionIdThrough() async throws {
        let expected = UUID()
        let recorder = SourceRecorder()
        let events = [Self.event(at: 42)]
        let vm = try #require(TimelineViewModel.forSession(expected, source: { id in
            await recorder.record(id)
            return events
        }))

        await vm.load()

        #expect(await recorder.ids == [expected])
        #expect(vm.phase == .loaded(events))
    }

    // MARK: - class → 图标 / 颜色映射

    @Test("图标逐字镜像 web timelineIcon（public/timeline.ts:88-96）", arguments: [
        ("tool", "🔧"),
        ("waiting", "⏳"),
        ("done", "✓"),
        ("stuck", "⚠"),
        ("user", "💬"),
    ])
    func glyphMirrorsWebTimelineIcon(cls: String, expected: String) {
        #expect(TimelineClassStyle.glyph(for: cls) == expected)
    }

    @Test("未知 class → fallback 图标（服务器不可信，映射必须全函数）")
    func unknownClassFallsBackToNeutralGlyph() {
        #expect(TimelineClassStyle.glyph(for: "future-class") == TimelineClassStyle.fallbackGlyph)
        #expect(TimelineClassStyle.glyph(for: "") == TimelineClassStyle.fallbackGlyph)
    }

    @Test("颜色语义映射：全部走冻结 DS.Palette（无裸色）；未知 → textSecondary")
    func colorMappingIsSemantic() {
        // waiting/stuck 复用状态 token（与列表同义）；done 复用 statusWorking；
        // tool/user 用 timeline 专属 token —— 无一裸色（UX 一致性 finding）。
        #expect(TimelineClassStyle.color(for: "waiting") == DS.Palette.statusWaiting)
        #expect(TimelineClassStyle.color(for: "stuck") == DS.Palette.statusStuck)
        #expect(TimelineClassStyle.color(for: "done") == DS.Palette.statusWorking)
        #expect(TimelineClassStyle.color(for: "tool") == DS.Palette.timelineTool)
        #expect(TimelineClassStyle.color(for: "user") == DS.Palette.timelineUser)
        #expect(TimelineClassStyle.color(for: "future-class") == DS.Palette.textSecondary)
    }

    // MARK: - 行时间格式（镜像 web formatHHMM：24h 墙钟 HH:mm）

    @Test("timeLabel：24h HH:mm，固定时区下确定性输出")
    func timeLabelIs24HourWallClock() throws {
        let utc = try #require(TimeZone(identifier: "UTC"))
        let onePM = (13 * 3_600 + 5 * 60) * 1_000 // 1970-01-01 13:05 UTC

        #expect(TimelineRowFormat.timeLabel(atMs: 0, timeZone: utc) == "00:00")
        #expect(TimelineRowFormat.timeLabel(atMs: onePM, timeZone: utc) == "13:05")
    }

    // MARK: - 用户可见文案（中文具名常量，空态 ≠ 错误态）

    @Test("空态与错误态文案存在、非空、且互不相同")
    func emptyAndErrorCopyAreDistinct() {
        #expect(!TimelineCopy.title.isEmpty)
        #expect(!TimelineCopy.emptyTitle.isEmpty)
        #expect(!TimelineCopy.loadFailed.isEmpty)
        #expect(!TimelineCopy.retry.isEmpty)
        #expect(TimelineCopy.emptyTitle != TimelineCopy.loadFailed)
    }
}