SPB Git

Repository Public

TasksScreen.swift 16.7 KB 249 lines swift

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
Files main
Menu

Theme