Repository Public
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