Repository Public
1// Author: Simon-Pierre Boucher — contact@spboucher.ai2// File: Features/Tasks/TasksScreen.swift3// Description: Tasks across all notes: list grouped by due date, quick add, due date and priority, completion, link back to the note and block a task comes from. Everything works offline through the task outbox of SPNotesCore; operations the server refused are shown with retry and discard.4import SwiftUI5import SPNotesCore6import SPNotesAPI7import SPNotesSync8import SPNotesEditor9import SPNotesDesign1011@Observable final class TasksModel {12 private(set) var tasks: [TaskItem] = []13 private(set) var pendingIds: Set<String> = []14 private(set) var rejected: [PendingTaskOperation] = []15 private(set) var isLoaded = false16 /// The server is a 2.x one (no task sync): the screen says so instead of failing on every write.17 private(set) var unsupported = false18 var filter: TaskFilter = .open { didSet { if filter != oldValue { Task { await load() } } } }19 var openCount: Int { openTotal }20 private var openTotal = 021 @ObservationIgnored weak var env: AppEnvironment?22 @ObservationIgnored let repo: TasksRepository23 @ObservationIgnored private var watcher: Task<Void, Never>?2425 init(repositories: NotesRepositories) { repo = repositories.tasks }2627 func start() async {28 await load()29 watcher = Task { [weak self] in guard let self else { return }; for await _ in await self.repo.changes() { await self.load() } }30 }3132 func load() async {33 tasks = Self.sorted((try? await repo.list(filter)) ?? [])34 openTotal = filter == .open ? tasks.count : ((try? await repo.list(.open))?.count ?? 0)35 let ops = (try? await repo.pendingOperations()) ?? []36 pendingIds = Set(ops.filter { $0.state != .rejected }.map(\.taskId)); rejected = ops.filter { $0.state == .rejected }37 isLoaded = true38 env?.platform.tasksChanged(tasks)39 }4041 /// Open tasks first by due date (none last), then by priority, then newest.42 static func sorted(_ list: [TaskItem]) -> [TaskItem] {43 func rank(_ p: String?) -> Int { p == "high" ? 0 : p == "low" ? 2 : 1 }44 return list.sorted { a, b in45 if (a.status == "done") != (b.status == "done") { return b.status == "done" }46 if a.dueAt != b.dueAt { return (a.dueAt ?? .distantFuture) < (b.dueAt ?? .distantFuture) }47 if rank(a.priority) != rank(b.priority) { return rank(a.priority) < rank(b.priority) }48 return a.createdAt > b.createdAt49 }50 }5152 enum Bucket: String, CaseIterable, Identifiable { case overdue = "En retard", today = "Aujourd'hui", week = "Cette semaine", later = "Plus tard", none = "Sans échéance", done = "Terminées"; var id: String { rawValue } }53 static func bucket(_ t: TaskItem, now: Date = Date()) -> Bucket {54 if t.status == "done" { return .done }55 guard let due = t.dueAt else { return .none }56 let cal = Calendar.current; let day = Self.localDay(due); let today = cal.startOfDay(for: now)57 if day < today { return .overdue }58 if day == today { return .today }59 return day < cal.date(byAdding: .day, value: 7, to: today)! ? .week : .later60 }61 /// A bare day is stored at noon UTC: its calendar day is the UTC one (REPOSITORIES.md); a real date-time is local.62 static func localDay(_ due: Date) -> Date {63 var utc = Calendar(identifier: .gregorian); utc.timeZone = TimeZone(identifier: "UTC")!64 let c = utc.dateComponents([.year, .month, .day, .hour, .minute, .second], from: due)65 if c.hour == 12, c.minute == 0, c.second == 0 { return Calendar.current.startOfDay(for: Calendar.current.date(from: DateComponents(year: c.year, month: c.month, day: c.day)) ?? due) }66 return Calendar.current.startOfDay(for: due)67 }68 func grouped(now: Date = Date()) -> [(Bucket, [TaskItem])] { Bucket.allCases.compactMap { b in let items = tasks.filter { Self.bucket($0, now: now) == b }; return items.isEmpty ? nil : (b, items) } }6970 // MARK: Actions (offline-first: the local copy changes at once, the outbox sends)7172 private func perform(_ work: () async throws -> Void) async {73 do { try await work(); unsupported = false; await load(); env?.syncMonitor.localChange() }74 catch RepositoryError.unsupported { unsupported = true; env?.toasts.show("Le serveur ne synchronise pas encore les tâches (version 2.x).", isError: true) }75 catch { env?.toasts.show((error as? RepositoryError)?.errorDescription ?? "La tâche n'a pas pu être enregistrée.", isError: true) }76 }77 /// Quick add. « demain », « !haute » and a trailing date are not parsed: the title is what was typed.78 @discardableResult func add(_ title: String, dueDay: String? = nil, priority: TaskLevel = .medium, pageId: String? = nil, blockId: String? = nil) async -> String? {79 let t = title.trimmingCharacters(in: .whitespacesAndNewlines); guard !t.isEmpty else { return nil }80 var id: String?81 await perform { id = try await repo.create(title: t, dueDay: dueDay, priority: priority, pageId: pageId, blockId: blockId).id }82 return id83 }84 func setDone(_ task: TaskItem, _ done: Bool) async {85 await perform { _ = try await repo.setDone(id: task.id, done) }86 // a task anchored to a check box of a note: the box is ticked too when the note is open (API-NEXT §4.2)87 if let page = task.pageId, let block = task.blockId, let s = env?.existingSession(page), let range = s.editor.textView.rangeOfBlock(id: block), s.editor.textView.taskItem(at: range.location)?.checked != done { s.editor.textView.toggleCheckbox(at: range.location) }88 }89 func setPriority(_ task: TaskItem, _ p: TaskLevel) async { await perform { _ = try await repo.update(id: task.id, TaskEdit(priority: p)) } }90 func setDue(_ task: TaskItem, day: Date?) async {91 let value: PatchValue<Date> = day.map { d in92 let c = Calendar.current.dateComponents([.year, .month, .day], from: d); var utc = Calendar(identifier: .gregorian); utc.timeZone = TimeZone(identifier: "UTC")!93 return .value(utc.date(from: DateComponents(year: c.year, month: c.month, day: c.day, hour: 12)) ?? d)94 } ?? .null95 await perform { _ = try await repo.update(id: task.id, TaskEdit(dueAt: value)) }96 }97 func rename(_ task: TaskItem, to title: String) async { let t = title.trimmingCharacters(in: .whitespaces); guard !t.isEmpty, t != task.title else { return }; await perform { _ = try await repo.update(id: task.id, TaskEdit(title: t)) } }98 func delete(_ task: TaskItem) async { await perform { try await repo.delete(id: task.id) } }99 func retry(_ op: PendingTaskOperation) async { await perform { try await repo.retry(operation: op.id) } }100 func discard(_ op: PendingTaskOperation) async { await perform { try await repo.discard(operation: op.id) } }101}102103struct TasksScreen: View {104 @Environment(AppEnvironment.self) private var env105 @Bindable var model: TasksModel106 let router: FeatureRouting107 @State private var draft = ""108 @State private var draftDue: Date?109 @State private var draftPriority: TaskLevel = .medium110 @FocusState private var addFocused: Bool111112 var body: some View {113 VStack(spacing: 0) {114 VStack(alignment: .leading, spacing: NVSpace.md) {115 PanelHeader(title: "Tâches", subtitle: subtitle) {116 Picker("Afficher", selection: $model.filter) { Text("À faire").tag(TaskFilter.open); Text("Terminées").tag(TaskFilter.done); Text("Toutes").tag(TaskFilter.all) }.pickerStyle(.segmented).labelsHidden().fixedSize()117 }118 quickAdd119 }120 .padding(.horizontal, NVSpace.xl).padding(.top, NVSpace.xl).padding(.bottom, NVSpace.md)121 Divider().overlay(NVColor.line)122 ScrollView {123 LazyVStack(alignment: .leading, spacing: NVSpace.lg, pinnedViews: []) {124 if !model.rejected.isEmpty { rejectedBox }125 if model.tasks.isEmpty, model.isLoaded {126 NVEmptyState(systemImage: "checklist", title: model.filter == .done ? "Aucune tâche terminée" : "Rien à faire", message: "Ajoute une tâche ci-dessus, ou coche « Convertir en tâche » dans la boîte de réception. Les tâches sont enregistrées sur ce Mac et envoyées quand le serveur est joignable.").padding(.top, NVSpace.xxxl)127 }128 ForEach(Array(model.grouped().enumerated()), id: \.element.0) { index, group in129 VStack(alignment: .leading, spacing: NVSpace.xs) {130 HStack { GroupLabel(group.0.rawValue); Text("\(group.1.count)").nvFont(.micro).foregroundStyle(NVColor.fgMuted) }131 VStack(spacing: 0) { ForEach(group.1) { t in TaskRow(task: t, pending: model.pendingIds.contains(t.id), model: model, router: router); if t.id != group.1.last?.id { Divider().overlay(NVColor.line).padding(.leading, NVSpace.xxl + NVSpace.sm) } } }.nvCard(radius: NVRadius.md)132 }133 .nvBlockReveal(index: index)134 }135 }136 .padding(NVSpace.xl).frame(maxWidth: NVSpace.readingMeasure + NVSpace.huge, alignment: .leading).frame(maxWidth: .infinity)137 }138 }139 .background(NVColor.bg)140 .task { await model.load() }141 .accessibilityIdentifier("tasks-screen")142 }143144 private var subtitle: String {145 let n = model.openCount, pending = model.pendingIds.count146 return (n == 0 ? "Aucune tâche ouverte" : n == 1 ? "1 tâche ouverte" : "\(n) tâches ouvertes") + (pending > 0 ? " · \(pending) à envoyer" : "")147 }148149 private var quickAdd: some View {150 HStack(spacing: NVSpace.sm) {151 Image(systemName: "plus.circle.fill").foregroundStyle(NVColor.accent).accessibilityHidden(true)152 TextField("Ajouter une tâche…", text: $draft).textFieldStyle(.plain).nvFont(.body).focused($addFocused).onSubmit(add).accessibilityIdentifier("task-add-field")153 DueMenu(date: $draftDue)154 PriorityMenu(priority: $draftPriority)155 Button("Ajouter", action: add).buttonStyle(.borderedProminent).controlSize(.small).disabled(draft.trimmingCharacters(in: .whitespaces).isEmpty).accessibilityIdentifier("task-add")156 }157 .fieldSurface(focused: addFocused)158 }159 private func add() {160 let title = draft; let due = draftDue.map { TaskLevel.dayString($0) }; let p = draftPriority161 draft = ""; draftDue = nil; draftPriority = .medium162 Task { await model.add(title, dueDay: due, priority: p) }163 }164165 private var rejectedBox: some View {166 VStack(alignment: .leading, spacing: NVSpace.sm) {167 Label(model.rejected.count == 1 ? "1 opération a été refusée par le serveur" : "\(model.rejected.count) opérations ont été refusées par le serveur", systemImage: "xmark.octagon").nvFont(.uiStrong).foregroundStyle(NVColor.dangerText)168 ForEach(model.rejected) { op in169 HStack(spacing: NVSpace.sm) {170 VStack(alignment: .leading, spacing: NVSpace.xxs) { Text(op.verb == "delete" ? "Suppression" : op.verb == "create" ? "Création" : "Modification").nvFont(.ui); if let e = op.lastError { Text(e).nvFont(.micro).foregroundStyle(NVColor.fgMuted).lineLimit(2) } }171 Spacer()172 Button("Réessayer") { Task { await model.retry(op) } }; Button("Abandonner", role: .destructive) { Task { await model.discard(op) } }173 }.controlSize(.small)174 }175 }176 .padding(NVSpace.md).background(NVColor.danger.opacity(0.08), in: NVRadius.shape(NVRadius.md)).accessibilityIdentifier("tasks-rejected")177 }178}179180private struct TaskRow: View {181 let task: TaskItem, pending: Bool182 let model: TasksModel183 let router: FeatureRouting184 @State private var hovering = false185 @State private var editing = false186 @State private var title = ""187 private var done: Bool { task.status == "done" }188 var body: some View {189 HStack(alignment: .firstTextBaseline, spacing: NVSpace.md) {190 Button { Task { await model.setDone(task, !done) } } label: {191 Image(systemName: done ? "checkmark.circle.fill" : "circle").font(.system(size: NVFont.Style.body.size() + NVSpace.xxs)).foregroundStyle(done ? NVColor.accent : NVColor.lineStrong)192 }.buttonStyle(.plain).accessibilityLabel(done ? "Rouvrir la tâche" : "Terminer la tâche").accessibilityIdentifier("task-toggle")193 VStack(alignment: .leading, spacing: NVSpace.xs) {194 if editing { TextField("Titre", text: $title).textFieldStyle(.plain).nvFont(.body).onSubmit { editing = false; Task { await model.rename(task, to: title) } }.onExitCommand { editing = false } }195 else { Text(task.title).nvFont(.body).foregroundStyle(done ? NVColor.fgMuted : NVColor.fg).strikethrough(done).lineLimit(3).onTapGesture(count: 2) { title = task.title; editing = true } }196 HStack(spacing: NVSpace.sm) {197 if let due = task.dueAt { let late = !done && TasksModel.bucket(task) == .overdue; NVChip(Styler.dueLabel(TasksModel.localDay(due)), systemImage: "calendar", tone: late ? .danger : .neutral) }198 if let p = task.priority.flatMap(TaskLevel.init(rawValue:)), p != .medium { NVChip(p.label, systemImage: "flag", tone: p == .high ? .danger : .neutral) }199 if let page = task.pageId { Button { router.openPage(id: page, blockId: task.blockId) } label: { Label(Format.title(task.pageTitle ?? "Note d'origine"), systemImage: "doc.text").nvFont(.micro).lineLimit(1) }.buttonStyle(.link).help("Ouvrir la note à cette tâche") }200 if pending { Label("à envoyer", systemImage: "arrow.up.circle").nvFont(.micro).foregroundStyle(NVColor.fgMuted).accessibilityIdentifier("task-pending") }201 }202 }203 Spacer(minLength: NVSpace.sm)204 Menu {205 Menu("Échéance") {206 Button("Aujourd'hui") { Task { await model.setDue(task, day: Date()) } }207 Button("Demain") { Task { await model.setDue(task, day: Calendar.current.date(byAdding: .day, value: 1, to: Date())) } }208 Button("Dans une semaine") { Task { await model.setDue(task, day: Calendar.current.date(byAdding: .day, value: 7, to: Date())) } }209 Divider(); Button("Aucune") { Task { await model.setDue(task, day: nil) } }210 }211 Menu("Priorité") { ForEach([TaskLevel.high, .medium, .low], id: \.self) { p in Button(p.label) { Task { await model.setPriority(task, p) } } } }212 Button("Renommer") { title = task.title; editing = true }213 Divider()214 Button("Supprimer", role: .destructive) { Task { await model.delete(task) } }215 } label: { Image(systemName: "ellipsis").foregroundStyle(NVColor.fgMuted) }.menuStyle(.borderlessButton).menuIndicator(.hidden).fixedSize().opacity(hovering || editing ? 1 : 0.35).accessibilityLabel("Actions de la tâche")216 }217 .padding(.horizontal, NVSpace.md).padding(.vertical, NVSpace.sm + NVSpace.xxs)218 .background(hovering ? NVColor.bgHover.opacity(0.6) : .clear)219 .onHover { hovering = $0 }220 .accessibilityElement(children: .contain).accessibilityIdentifier("task-row")221 }222}223224struct DueMenu: View {225 @Binding var date: Date?226 var body: some View {227 Menu {228 Button("Aujourd'hui") { date = Date() }; Button("Demain") { date = Calendar.current.date(byAdding: .day, value: 1, to: Date()) }; Button("Dans une semaine") { date = Calendar.current.date(byAdding: .day, value: 7, to: Date()) }229 Divider(); Button("Aucune échéance") { date = nil }230 } label: { Label(date.map { Styler.dueLabel($0) } ?? "Échéance", systemImage: "calendar").nvFont(.ui) }231 .menuStyle(.borderlessButton).fixedSize().foregroundStyle(date == nil ? NVColor.fgMuted : NVColor.accent)232 }233}234struct PriorityMenu: View {235 @Binding var priority: TaskLevel236 var body: some View {237 Menu { ForEach([TaskLevel.high, .medium, .low], id: \.self) { p in Button(p.label) { priority = p } } } label: { Label(priority.label, systemImage: "flag").nvFont(.ui) }238 .menuStyle(.borderlessButton).fixedSize().foregroundStyle(priority == .high ? NVColor.dangerText : NVColor.fgMuted)239 }240}241242/// The task priority of the API (SPNotesDocument has a type of the same name for the `taskItem` attribute).243typealias TaskLevel = SPNotesAPI.TaskPriority244extension SPNotesAPI.TaskPriority {245 var label: String { switch self { case .high: "Haute"; case .medium: "Moyenne"; case .low: "Basse" } }246 /// `YYYY-MM-DD` of a local calendar day.247 static func dayString(_ date: Date) -> String { let c = Calendar.current.dateComponents([.year, .month, .day], from: date); return String(format: "%04d-%02d-%02d", c.year ?? 0, c.month ?? 1, c.day ?? 1) }248}249