SPB Git

Repository Public

TimelineScreen.swift 17.9 KB 322 lines swift

1// SP Notes Core2// File: Sources/SPNotesFeatures/Knowledge/TimelineScreen.swift3// Description: The timeline screen: the journal of real events grouped by day, family filters, paging; and the time4//              machine view (date scrubber, what existed then, how exact the answer is, restore with confirmation).5//6// Author: Simon-Pierre Boucher7// Contact: contact@spboucher.ai8import SPNotesAPI9import SPNotesDesign10import SPNotesStore11import SPNotesSync12import SwiftUI1314public struct TimelineScreen: View {15    @Environment(\.featureNow) private var fixedNow16    @State private var model: TimelineModel17    @State private var machine: TimeMachineModel?18    @State private var showsMachine: Bool1920    /// - Parameter scope: `.page` / `.project` add the « Remonter le temps » tab (the time machine needs one of them).21    public init(repositories: NotesRepositories, router: (any FeatureRouter)? = nil, scope: TimelineScope = .workspace) {22        _model = State(initialValue: TimelineModel(repositories: repositories, router: router, scope: scope))23        _machine = State(initialValue: scope == .workspace ? nil : TimeMachineModel(repositories: repositories, router: router, scope: scope))24        _showsMachine = State(initialValue: false)25    }2627    public init(model: TimelineModel, timeMachine: TimeMachineModel? = nil, showsTimeMachine: Bool = false) {28        _model = State(initialValue: model)29        _machine = State(initialValue: timeMachine)30        _showsMachine = State(initialValue: showsTimeMachine && timeMachine != nil)31    }3233    public var body: some View {34        let machineShown = showsMachine && machine != nil35        FeatureScaffold(title: machineShown ? L("Remonter le temps") : L("Chronologie"), subtitle: machineShown ? L("L'état d'une page ou d'un projet à une date") : L("Ce qui s'est réellement passé"),36                        phase: machineShown ? (machine?.phase ?? .loaded) : model.phase, freshness: machineShown ? machine?.freshness : model.freshness,37                        retry: { Task { if machineShown { await machine?.load() } else { await model.load() } } },38                        actions: {39                            if machine != nil {40                                FeatureIconButton(showsMachine ? "list.bullet" : "clock.arrow.circlepath", label: showsMachine ? L("Voir le journal") : L("Remonter le temps"), tone: .accent) {41                                    showsMachine.toggle()42                                    if showsMachine, machine?.phase == .idle { Task { await machine?.load() } }43                                }44                            }45                            FeatureIconButton("arrow.clockwise", label: L("Actualiser")) { Task { if machineShown { await machine?.load() } else { await model.load() } } }46                        }) { sizeClass in47            if machineShown, let machine {48                TimeMachineView(model: machine)49            } else {50                journal(sizeClass)51            }52        }53        .task {54            if model.phase == .idle { await model.load() }55            if showsMachine, machine?.phase == .idle { await machine?.load() }56        }57    }5859    private func journal(_ sizeClass: FeatureSizeClass) -> some View {60        VStack(alignment: .leading, spacing: 0) {61            ScrollView(.horizontal, showsIndicators: false) {62                HStack(spacing: NVSpace.sm) {63                    NVChip(L("Tout"), tone: .accent, isSelected: model.families.isEmpty) { Task { await model.clearFamilies() } }64                    ForEach(KnowledgeVocabulary.eventFamilies, id: \.self) { family in65                        NVChip(KnowledgeVocabulary.familyTitle(family), tone: family == "ai" || family == "agent" ? .ai : .accent, isSelected: model.families.contains(family)) {66                            Task { await model.toggle(family: family) }67                        }68                    }69                }70                .padding(.horizontal, sizeClass.isCompact ? NVSpace.lg : NVSpace.xl)71                .padding(.bottom, NVSpace.md)72            }73            FeaturePhaseView(phase: model.phase, hasData: !model.events.isEmpty, retry: { Task { await model.load() } }) {74                NVEmptyState(systemImage: "calendar.badge.clock", title: L("Aucun événement"),75                             message: model.families.isEmpty ? L("Le journal se remplit à mesure que vous travaillez. Rien n'est inventé.") : L("Aucun événement de ce type sur la période chargée."))76            } content: {77                ScrollView {78                    LazyVStack(alignment: .leading, spacing: NVSpace.lg) {79                        ForEach(model.days) { day in80                            VStack(alignment: .leading, spacing: NVSpace.xs) {81                                Text(model.dayTitle(day, now: fixedNow ?? Date())).nvFont(.h3).foregroundStyle(NVColor.fg).accessibilityAddTraits(.isHeader)82                                VStack(alignment: .leading, spacing: 0) {83                                    ForEach(day.events) { event in84                                        TimelineEventRow(model: model, event: event)85                                        if event.id != day.events.last?.id { Divider().padding(.leading, 38) }86                                    }87                                }88                                .padding(.horizontal, NVSpace.lg)89                                .padding(.vertical, NVSpace.xs)90                                .nvCard()91                            }92                        }93                        if let failure = model.actionFailure { FeatureStatusBanner(failure: failure, freshness: nil, retry: { Task { await model.loadMore() } }) }94                        if model.canLoadMore {95                            HStack {96                                Spacer()97                                if model.isLoadingMore { NVProgressDots() } else { FeatureButton(L("Charger les événements plus anciens"), systemImage: "arrow.down") { Task { await model.loadMore() } } }98                                Spacer()99                            }100                        } else if model.freshness?.fromCache != true {101                            Text(L("Début du journal.")).nvFont(.micro).foregroundStyle(NVColor.fgMuted).frame(maxWidth: .infinity)102                        }103                    }104                    .frame(maxWidth: NVSpace.readingMeasure + 120, alignment: .leading)105                    .padding(.horizontal, sizeClass.isCompact ? NVSpace.lg : NVSpace.xl)106                    .padding(.bottom, NVSpace.xl)107                    .frame(maxWidth: .infinity, alignment: sizeClass.isCompact ? .leading : .center)108                }109            }110        }111    }112}113114struct TimelineEventRow: View {115    let model: TimelineModel116    let event: EventRecord117118    var body: some View {119        let machine = TimelineModel.isMachine(event)120        KnowledgeRow(symbol: KnowledgeVocabulary.eventSymbol(event.kind), tint: machine ? NVColor.ai : NVColor.accent,121                     title: event.summary.isEmpty ? KnowledgeVocabulary.eventTitle(event.kind) : event.summary, detail: detail,122                     action: event.pageId != nil && event.kind != EventKind.pagePurged ? { model.open(event) } : nil) {123            VStack(alignment: .trailing, spacing: NVSpace.xxs) {124                if event.actor == EventActor.ai { NVAIBadge(style: .compact) }125                else if event.actor == EventActor.agent { NVChip(L("Agent"), systemImage: "cpu", tone: .ai) }126                if TimelineModel.isBackfilled(event) { NVChip(L("Reconstitué"), systemImage: "clock.badge.questionmark") }127            }128        }129        .accessibilityHint(TimelineModel.isBackfilled(event) ? L("Événement reconstitué à partir de données antérieures, non observé en direct.") : "")130    }131132    private var detail: String {133        var parts = [model.time(event)]134        if !event.summary.isEmpty { parts.append(KnowledgeVocabulary.eventTitle(event.kind)) }135        if let title = event.pageTitle, !title.isEmpty, !event.summary.contains(title) { parts.append(title) }136        if let device = event.device, !device.isEmpty { parts.append(device) }137        return parts.joined(separator: " · ")138    }139}140141// MARK: - Time machine142143/// The state of a page / project at a date. Usable on its own (an editor's history inspector) or inside `TimelineScreen`.144public struct TimeMachineView: View {145    @Environment(\.featureSizeClass) private var sizeClass146    @Bindable var model: TimeMachineModel147    @State private var scrubbing: Double?148149    public init(model: TimeMachineModel) { self.model = model }150151    public var body: some View {152        ScrollView {153            VStack(alignment: .leading, spacing: NVSpace.lg) {154                scrubber155                if let failure = model.actionFailure { FeatureStatusBanner(failure: failure, freshness: nil) }156                if let restored = model.lastRestore {157                    Label(LF("Page restaurée (version %lld). Elle sera à jour après la prochaine synchronisation.", restored.version), systemImage: "checkmark.circle")158                        .nvFont(.ui).foregroundStyle(NVColor.successText)159                }160                if let pending = model.pendingRestore { confirmation(pending) }161                FeaturePhaseView(phase: model.phase, hasData: model.snapshot != nil, retry: { Task { await model.load() } }) {162                    EmptyView()163                } content: {164                    if let snapshot = model.snapshot { content(snapshot) }165                }166            }167            .frame(maxWidth: NVSpace.readingMeasure + 120, alignment: .leading)168            .padding(.horizontal, sizeClass.isCompact ? NVSpace.lg : NVSpace.xl)169            .padding(.bottom, NVSpace.xl)170            .frame(maxWidth: .infinity, alignment: sizeClass.isCompact ? .leading : .center)171        }172        .task { if model.phase == .idle { await model.load() } }173    }174175    private var scrubber: some View {176        VStack(alignment: .leading, spacing: NVSpace.sm) {177            HStack(alignment: .firstTextBaseline) {178                Text(FeatureFormat.dayTime(model.date)).nvFont(.h2).foregroundStyle(NVColor.fg)179                Spacer()180                if model.phase.isLoading { NVProgressDots() }181            }182            Slider(value: Binding(get: { scrubbing ?? model.fraction }, set: { scrubbing = $0; model.scrub(to: $0) }), in: 0 ... 1) { editing in183                if !editing { scrubbing = nil; Task { await model.load() } }184            }185            .accessibilityLabel(L("Date consultée"))186            .accessibilityValue(FeatureFormat.dayTime(model.date))187            HStack {188                Text(FeatureFormat.day(model.range.lowerBound)).nvFont(.micro).foregroundStyle(NVColor.fgMuted)189                Spacer()190                Text(L("Maintenant")).nvFont(.micro).foregroundStyle(NVColor.fgMuted)191            }192            if let since = model.snapshot?.journalSince {193                Text(LF("Le journal des liens et relations existe depuis le %@ ; avant cette date, seules les versions des pages sont connues.", FeatureFormat.day(since)))194                    .nvFont(.micro).foregroundStyle(NVColor.fgMuted)195            }196        }197        .padding(NVSpace.lg)198        .nvCard()199    }200201    private func confirmation(_ page: TimeMachinePage) -> some View {202        VStack(alignment: .leading, spacing: NVSpace.md) {203            Label(L("Restaurer cette version ?"), systemImage: "exclamationmark.arrow.circlepath").nvFont(.uiStrong).foregroundStyle(NVColor.fg)204            Text(LF("« %@ » reviendra à son état du %@. L'état actuel est d'abord enregistré dans l'historique : rien n'est perdu.",205                    KnowledgeVocabulary.title(page.title ?? page.currentTitle), page.versionAt.map { FeatureFormat.dayTime($0) } ?? FeatureFormat.dayTime(model.date)))206                .nvFont(.ui).foregroundStyle(NVColor.fgMuted)207            Text(TimeMachineHonesty.text(page)).nvFont(.ui).foregroundStyle(NVColor.warningText)208            HStack(spacing: NVSpace.sm) {209                FeatureButton(L("Restaurer"), systemImage: "clock.arrow.circlepath", kind: .primary) { Task { await model.confirmRestore() } }210                FeatureButton(L("Annuler")) { model.cancelRestore() }211            }212            .disabled(model.isRestoring)213        }214        .padding(NVSpace.lg)215        .frame(maxWidth: .infinity, alignment: .leading)216        .background(NVColor.accentSoft, in: NVRadius.shape(NVRadius.lg))217        .overlay(NVRadius.shape(NVRadius.lg).strokeBorder(NVColor.accent.opacity(0.4), lineWidth: 1))218        .nvPanelTransition(edge: .top)219    }220221    @ViewBuilder222    private func content(_ snapshot: TimeMachineSnapshot) -> some View {223        ForEach(snapshot.pages) { page in224            TimeMachinePageCard(model: model, page: page)225        }226        if !snapshot.relations.isEmpty {227            KnowledgeSection(title: L("Liens et relations à cette date"), count: snapshot.relations.count) {228                ForEach(snapshot.relations) { relation in229                    KnowledgeRow(symbol: relation.kind == RelationKind.relation ? "arrow.triangle.branch" : "link", tint: relation.origin == KnowledgeOrigin.ai ? NVColor.ai : NVColor.accent,230                                 title: KnowledgeVocabulary.title(relation.fromTitle) + " → " + KnowledgeVocabulary.title(relation.toTitle),231                                 detail: KnowledgeVocabulary.relationTitle(relation.relType)) {232                        if relation.origin == KnowledgeOrigin.ai { NVAIBadge(style: .compact) }233                    }234                }235            }236        }237        if !snapshot.references.isEmpty {238            KnowledgeSection(title: L("Références à cette date"), count: snapshot.references.count) {239                ForEach(snapshot.references) { reference in240                    KnowledgeRow(symbol: "book.closed", tint: NVColor.success, title: reference.title ?? reference.citeKey ?? L("Sans titre"),241                                 detail: [reference.authors?.prefix(2).joined(separator: ", "), reference.year.map(String.init)].compactMap { $0 }.joined(separator: " · "))242                }243            }244        }245        if !snapshot.removedSince.isEmpty {246            KnowledgeSection(title: L("Disparu depuis"), subtitle: L("Ce qui existait alors et n'existe plus, d'après le journal"), count: snapshot.removedSince.count, tone: .warning) {247                ForEach(snapshot.removedSince) { event in248                    KnowledgeRow(symbol: KnowledgeVocabulary.eventSymbol(event.kind), title: event.summary ?? KnowledgeVocabulary.eventTitle(event.kind),249                                 detail: KnowledgeVocabulary.eventTitle(event.kind) + " · " + FeatureFormat.dayTime(event.at))250                }251            }252        }253    }254}255256struct TimeMachinePageCard: View {257    let model: TimeMachineModel258    let page: TimeMachinePage259260    var body: some View {261        let level = TimeMachineHonesty.level(page)262        VStack(alignment: .leading, spacing: NVSpace.md) {263            HStack(alignment: .top, spacing: NVSpace.md) {264                if let icon = page.icon, !icon.isEmpty { Text(icon).font(.system(size: 20)).accessibilityHidden(true) }265                VStack(alignment: .leading, spacing: NVSpace.xxs) {266                    Text(KnowledgeVocabulary.title(page.title ?? page.currentTitle)).nvFont(.h3).foregroundStyle(page.existed ? NVColor.fg : NVColor.fgMuted)267                    if let current = page.currentTitle, let then = page.title, current != then {268                        Text(LF("Aujourd'hui : « %@ »", current)).nvFont(.ui).foregroundStyle(NVColor.fgMuted)269                    }270                }271                Spacer(minLength: NVSpace.sm)272                NVChip(chip(level), systemImage: symbol(level), tone: tone(level))273            }274            Text(TimeMachineHonesty.text(page)).nvFont(.ui).foregroundStyle(level == .approximate || level == .unknown ? NVColor.warningText : NVColor.fgMuted)275            if page.trashedAt != nil { Label(L("Dans la corbeille à cette date"), systemImage: "trash").nvFont(.ui).foregroundStyle(NVColor.fgMuted) }276            if let text = TimeMachineModel.previewText(page) {277                Text(text).nvFont(.reading).foregroundStyle(NVColor.fg).lineLimit(8)278                    .padding(NVSpace.md).frame(maxWidth: .infinity, alignment: .leading)279                    .background(NVColor.bgSunken, in: NVRadius.shape(NVRadius.md))280            }281            HStack(spacing: NVSpace.sm) {282                if let words = page.wordCount, page.existed { Text(LF("%lld mots", words)).nvFont(.micro).foregroundStyle(NVColor.fgMuted) }283                if let version = page.version { Text(LF("version %lld", version)).nvFont(.micro).foregroundStyle(NVColor.fgMuted) }284                if page.changedSince == true { Text(L("modifiée depuis")).nvFont(.micro).foregroundStyle(NVColor.fgMuted) }285            }286            HStack(spacing: NVSpace.sm) {287                if TimeMachineModel.canRestore(page) { FeatureButton(L("Restaurer…"), systemImage: "clock.arrow.circlepath") { model.requestRestore(page) } }288                FeatureButton(L("Ouvrir"), systemImage: "arrow.up.forward.square") { model.open(page) }289            }290        }291        .padding(NVSpace.lg)292        .frame(maxWidth: .infinity, alignment: .leading)293        .nvCard()294    }295296    private func chip(_ level: TimeMachineHonesty.Level) -> String {297        switch level {298        case .exact: return L("Exact")299        case .approximate: return L("Approximatif")300        case .unknown: return L("Inconnu")301        case .absent: return L("N'existait pas")302        }303    }304305    private func symbol(_ level: TimeMachineHonesty.Level) -> String {306        switch level {307        case .exact: return "checkmark.seal"308        case .approximate: return "tilde"309        case .unknown: return "questionmark"310        case .absent: return "minus.circle"311        }312    }313314    private func tone(_ level: TimeMachineHonesty.Level) -> NVTone {315        switch level {316        case .exact: return .success317        case .approximate, .unknown: return .warning318        case .absent: return .neutral319        }320    }321}322
Files main
Menu

Theme