SPB Git

Repository Public

TasksScreen.swift 24.1 KB 462 lines swift

1// SP Notes iOS2// File: Features/Tasks/TasksScreen.swift3// Description: The global task list: quick add, groups by due day, complete / reopen, priority and due date, delete with undo,4//              the note a task comes from (opened at its block), what waits to be sent and what the server refused, and the5//              1.0 reminders (read-only). Works entirely offline.6//7// Author: Simon-Pierre Boucher8// Contact: contact@spboucher.ai9import SPNotesCore10import SPNotesDesign11import SwiftUI1213struct TasksReloadKey: Equatable { var tasks: Int; var queue: Int; var reminders: Int; var reset: Int; var cache: Int }1415extension AppModel {16    /// What makes a task screen read the store again (scoped: never the notes being typed).17    var tasksReloadKey: TasksReloadKey {18        TasksReloadKey(tasks: feed.entities("task"), queue: feed.entityQueue, reminders: feed.reminders, reset: feed.resetGeneration, cache: feed.cache)19    }20}2122struct TasksScreen: View {23    @Environment(AppModel.self) private var app24    @Environment(ShellState.self) private var shell25    @State private var model: TasksModel?26    @State private var draft = ""27    @State private var draftDue: TaskDue.Day?28    @State private var draftPriority = TaskPriority.medium29    @State private var editing: TaskItem?30    @FocusState private var addFocused: Bool3132    var body: some View {33        Group {34            if let model { content(model) } else { ProgressView() }35        }36        .background(NVColor.bg)37        .navigationTitle("Tâches")38        .navigationBarTitleDisplayMode(.inline)39        .task {40            if model == nil { model = TasksModel(app: app) }41        }42        .task(id: app.tasksReloadKey) { await model?.load() }43    }4445    @ViewBuilder private func content(_ model: TasksModel) -> some View {46        List {47            Section {48                hero(model)49                if model.phase != .unsupported { quickAdd(model) }50            }51            .listRowSeparator(.hidden)52            .listRowBackground(Color.clear)53            .listRowInsets(EdgeInsets(top: NVSpace.sm, leading: NVSpace.lg, bottom: NVSpace.sm, trailing: NVSpace.lg))5455            if model.phase == .unsupported { unsupported }56            if !model.rejected.isEmpty { rejected(model) }5758            ForEach(model.groups) { group in59                Section {60                    ForEach(group.tasks) { task in row(task, model: model) }61                } header: { header(group.kind.title, count: group.tasks.count, tone: group.kind == .overdue ? .danger : .neutral) }62            }63            if !model.reminders.isEmpty {64                Section {65                    ForEach(model.reminders) { entry in reminderRow(entry) }66                } header: { header(String(localized: "Rappels"), count: model.reminders.count, tone: .neutral) } footer: {67                    Text("Les rappels se règlent dans leur note.").font(.footnote).foregroundStyle(NVColor.fgMuted)68                }69            }70            if model.phase == .ready, model.groups.isEmpty, model.reminders.isEmpty {71                Section {72                    NVEmptyState(systemImage: "checklist", title: model.doneCount > 0 ? String(localized: "Tout est fait") : String(localized: "Aucune tâche"),73                                 message: String(localized: "Ajoute une tâche ci-dessus : elle est enregistrée sur cet appareil à l’instant, même hors ligne."))74                        .frame(maxWidth: .infinity)75                        .accessibilityIdentifier("tasks-empty")76                }77                .listRowBackground(Color.clear)78                .listRowSeparator(.hidden)79            }80        }81        .listStyle(.plain)82        .listSectionSpacing(.compact)83        .environment(\.defaultMinListHeaderHeight, 0)84        .scrollContentBackground(.hidden)85        .scrollDismissesKeyboard(.interactively)86        .refreshable { await app.syncAndWait(); await model.load() }87        .toolbar {88            ToolbarItem(placement: .topBarTrailing) {89                Menu {90                    Toggle(isOn: Binding(get: { model.showsDone }, set: { model.showsDone = $0 })) { Label("Afficher les tâches terminées", systemImage: "checkmark.circle") }91                    Button { Task { await app.syncAndWait(); await model.load() } } label: { Label("Synchroniser maintenant", systemImage: "arrow.triangle.2.circlepath") }92                } label: { Label("Options des tâches", systemImage: "ellipsis.circle") }93                .accessibilityIdentifier("tasks-options")94            }95        }96        .sheet(item: $editing) { task in97            TaskEditSheet(task: task, pageTitle: task.pageId.flatMap { model.pageTitles[$0] }) { title, due, priority in98                Task { await model.apply(task, title: title, due: due, priority: priority) }99            } onDelete: { delete(task, model: model) } onOpenNote: { open(task) }100        }101        .onChange(of: model.notice) { _, notice in102            guard let notice else { return }103            shell.show(notice)104            model.notice = nil105        }106        .accessibilityIdentifier("tasks-screen")107    }108109    // MARK: pieces110111    private func hero(_ model: TasksModel) -> some View {112        VStack(alignment: .leading, spacing: NVSpace.xs) {113            Text("Tâches").nvFont(.h1).foregroundStyle(NVColor.fg).accessibilityAddTraits(.isHeader)114            Text(TasksText.summary(open: model.openCount, overdue: model.group(.overdue).count, today: model.group(.today).count))115                .font(.subheadline).foregroundStyle(NVColor.fgMuted)116            if !model.pending.isEmpty {117                Label(TasksText.pending(model.pending.count, online: app.network.isOnline, signedIn: app.session == .signedIn), systemImage: "arrow.up.circle")118                    .font(.footnote).foregroundStyle(NVColor.fgMuted)119                    .accessibilityIdentifier("tasks-pending")120            }121        }122        .frame(maxWidth: .infinity, alignment: .leading)123        .padding(.top, NVSpace.sm)124    }125126    private func quickAdd(_ model: TasksModel) -> some View {127        VStack(alignment: .leading, spacing: NVSpace.sm) {128            HStack(spacing: NVSpace.sm) {129                Image(systemName: "plus.circle.fill").font(.title3).foregroundStyle(NVColor.accent).accessibilityHidden(true)130                TextField("Nouvelle tâche", text: $draft)131                    .focused($addFocused)132                    .submitLabel(.done)133                    .onSubmit { submit(model) }134                    .accessibilityIdentifier("task-add-field")135                if !draft.trimmingCharacters(in: .whitespaces).isEmpty {136                    Button("Ajouter") { submit(model) }137                        .font(.subheadline.weight(.semibold))138                        .frame(minHeight: 44)139                        .accessibilityIdentifier("task-add-button")140                }141            }142            if addFocused || !draft.isEmpty {143                ScrollView(.horizontal, showsIndicators: false) {144                    HStack(spacing: NVSpace.sm) {145                        let today = TaskDue.today()146                        NVChip(String(localized: "Aujourd’hui"), systemImage: "calendar", tone: .accent, isSelected: draftDue == today) { draftDue = draftDue == today ? nil : today }147                        NVChip(String(localized: "Demain"), systemImage: "calendar", tone: .accent, isSelected: draftDue == TaskDue.day(today, adding: 1)) {148                            let tomorrow = TaskDue.day(today, adding: 1)149                            draftDue = draftDue == tomorrow ? nil : tomorrow150                        }151                        NVChip(String(localized: "Priorité haute"), systemImage: "exclamationmark", tone: .danger, isSelected: draftPriority == .high) {152                            draftPriority = draftPriority == .high ? .medium : .high153                        }154                    }155                    .padding(.vertical, 2)156                }157            }158        }159        .padding(.horizontal, NVSpace.md)160        .padding(.vertical, NVSpace.sm)161        .nvCard(radius: NVRadius.lg)162    }163164    private func submit(_ model: TasksModel) {165        let title = draft166        guard !title.trimmingCharacters(in: .whitespaces).isEmpty else { return }167        let due = draftDue, priority = draftPriority168        draft = ""; draftDue = nil; draftPriority = .medium169        Task {170            if await model.add(title: title, due: due, priority: priority) != nil { Haptics.success() }171        }172    }173174    private func header(_ title: String, count: Int, tone: NVTone) -> some View {175        NVSectionHeader(title) { NVChip("\(count)", tone: tone).accessibilityLabel(TasksText.count(count)) }176            .textCase(nil)177    }178179    private func row(_ task: TaskItem, model: TasksModel) -> some View {180        TaskRow(task: task, isPending: model.pending.contains(task.id), pageTitle: task.pageId.flatMap { model.pageTitles[$0] },181                onToggle: { toggle(task, model: model) }, onOpen: { editing = task }, onOpenNote: task.pageId == nil ? nil : { open(task) })182            .listRowInsets(EdgeInsets(top: 0, leading: NVSpace.lg, bottom: 0, trailing: NVSpace.lg))183            .listRowBackground(NVColor.bg)184            .swipeActions(edge: .leading, allowsFullSwipe: true) {185                Button { toggle(task, model: model) } label: { Label(task.isDone ? "Rouvrir" : "Terminer", systemImage: task.isDone ? "arrow.uturn.backward" : "checkmark") }186                    .tint(NVColor.success)187            }188            .swipeActions(edge: .trailing, allowsFullSwipe: true) {189                Button(role: .destructive) { delete(task, model: model) } label: { Label("Supprimer", systemImage: "trash") }190                Button { Task { await model.setDue(task, TaskDue.today()) } } label: { Label("Aujourd’hui", systemImage: "calendar") }.tint(NVColor.accent)191            }192            .contextMenu {193                Button { toggle(task, model: model) } label: { Label(task.isDone ? "Rouvrir" : "Terminer", systemImage: task.isDone ? "arrow.uturn.backward" : "checkmark.circle") }194                Button { editing = task } label: { Label("Modifier…", systemImage: "pencil") }195                Menu {196                    Button { Task { await model.setDue(task, TaskDue.today()) } } label: { Label("Aujourd’hui", systemImage: "calendar") }197                    Button { Task { await model.setDue(task, TaskDue.day(TaskDue.today(), adding: 1)) } } label: { Label("Demain", systemImage: "calendar") }198                    Button { Task { await model.setDue(task, TaskDue.day(TaskDue.today(), adding: 7)) } } label: { Label("Dans une semaine", systemImage: "calendar") }199                    if task.dueAt != nil { Button { Task { await model.setDue(task, nil) } } label: { Label("Aucune échéance", systemImage: "calendar.badge.minus") } }200                } label: { Label("Échéance", systemImage: "calendar") }201                Menu {202                    ForEach(TaskPriority.allCases.reversed(), id: \.self) { priority in203                        Button { Task { await model.setPriority(task, priority) } } label: {204                            Label(TaskGrouping.priorityLabel(priority), systemImage: task.priority == priority.rawValue ? "checkmark" : "flag")205                        }206                    }207                } label: { Label("Priorité", systemImage: "flag") }208                if task.pageId != nil { Button { open(task) } label: { Label("Ouvrir la note", systemImage: "note.text") } }209                Divider()210                Button(role: .destructive) { delete(task, model: model) } label: { Label("Supprimer", systemImage: "trash") }211            }212    }213214    private func reminderRow(_ entry: ReminderEntry) -> some View {215        Button {216            if let pageId = entry.reminder.pageId { shell.open(note: pageId) }217        } label: {218            HStack(spacing: NVSpace.md) {219                Image(systemName: "bell").foregroundStyle(NVColor.fgMuted).frame(width: 28).accessibilityHidden(true)220                VStack(alignment: .leading, spacing: 3) {221                    Text(entry.reminder.title.isEmpty ? NoteTitle.display(entry.noteTitle) : entry.reminder.title).foregroundStyle(NVColor.fg).lineLimit(2)222                    HStack(spacing: NVSpace.sm) {223                        if let due = entry.reminder.dueAt { NVChip(due.formatted(date: .abbreviated, time: .shortened), systemImage: "clock", tone: due < Date() ? .danger : .neutral) }224                        if !entry.noteTitle.isEmpty, !entry.reminder.title.isEmpty { Text(NoteTitle.display(entry.noteTitle)).font(.footnote).foregroundStyle(NVColor.fgMuted).lineLimit(1) }225                    }226                }227                Spacer(minLength: 0)228                Image(systemName: "chevron.right").font(.footnote.weight(.semibold)).foregroundStyle(NVColor.fgMuted).accessibilityHidden(true)229            }230            .frame(minHeight: 44)231            .contentShape(Rectangle())232        }233        .buttonStyle(.plain)234        .disabled(entry.reminder.pageId == nil)235        .listRowBackground(NVColor.bg)236        .accessibilityElement(children: .combine)237        .accessibilityHint("Ouvre la note du rappel")238        .accessibilityIdentifier("reminder-row")239    }240241    private var unsupported: some View {242        Section {243            VStack(alignment: .leading, spacing: NVSpace.sm) {244                Label("Les tâches ne sont pas encore proposées par ton serveur", systemImage: "server.rack").font(.headline).foregroundStyle(NVColor.fg)245                Text("Cette liste demande la version 3 du serveur SP Notes. Rien n’est perdu : les cases à cocher de tes notes et tes rappels fonctionnent comme avant, et la liste s’activera d’elle-même après la mise à jour du serveur.")246                    .font(.subheadline).foregroundStyle(NVColor.fgMuted)247            }248            .padding(NVSpace.md)249            .nvCard()250            .accessibilityElement(children: .combine)251            .accessibilityIdentifier("tasks-unsupported")252        }253        .listRowSeparator(.hidden)254        .listRowBackground(Color.clear)255    }256257    private func rejected(_ model: TasksModel) -> some View {258        Section {259            ForEach(model.rejected) { item in260                VStack(alignment: .leading, spacing: NVSpace.sm) {261                    Label(item.verbLabel, systemImage: "exclamationmark.triangle.fill").font(.subheadline.weight(.semibold)).foregroundStyle(NVColor.dangerText)262                    Text(item.taskTitle).foregroundStyle(NVColor.fg)263                    if let error = item.operation.lastError, !error.isEmpty { Text(error).font(.footnote).foregroundStyle(NVColor.fgMuted) }264                    HStack(spacing: NVSpace.md) {265                        Button("Réessayer") { Task { await model.retry(item) } }.buttonStyle(.bordered).accessibilityIdentifier("task-retry")266                        Button("Abandonner", role: .destructive) { Task { await model.discard(item) } }.buttonStyle(.bordered).accessibilityIdentifier("task-discard")267                    }268                }269                .padding(.vertical, NVSpace.xs)270                .listRowBackground(NVColor.danger.opacity(0.08))271                .accessibilityIdentifier("task-rejected")272            }273        } header: { header(String(localized: "Refusées par le serveur"), count: model.rejected.count, tone: .danger) }274    }275276    // MARK: actions277278    private func toggle(_ task: TaskItem, model: TasksModel) {279        Haptics.tap()280        Task { await model.setDone(task, !task.isDone) }281    }282283    private func delete(_ task: TaskItem, model: TasksModel) {284        Task {285            guard let removed = await model.delete(task) else { return }286            shell.show(String(localized: "Tâche supprimée"), actionTitle: String(localized: "Annuler")) { Task { await model.restore(removed) } }287        }288    }289290    private func open(_ task: TaskItem) {291        guard let pageId = task.pageId else { return }292        shell.open(note: pageId, blockId: task.blockId)293    }294}295296/// Wording of the task screens (pure, tested).297enum TasksText {298    static func count(_ count: Int) -> String { count == 1 ? String(localized: "1 tâche") : String(localized: "\(count) tâches") }299300    static func summary(open: Int, overdue: Int, today: Int) -> String {301        guard open > 0 else { return String(localized: "Rien à faire pour l’instant.") }302        var parts = [open == 1 ? String(localized: "1 tâche à faire") : String(localized: "\(open) tâches à faire")]303        if today > 0 { parts.append(String(localized: "\(today) pour aujourd’hui")) }304        if overdue > 0 { parts.append(String(localized: "\(overdue) en retard")) }305        return parts.joined(separator: " · ")306    }307308    static func pending(_ count: Int, online: Bool, signedIn: Bool = true) -> String {309        let what = count == 1 ? String(localized: "1 modification à envoyer") : String(localized: "\(count) modifications à envoyer")310        if !signedIn { return what + String(localized: " — sera envoyé à la reconnexion") }311        return online ? what : what + String(localized: " — sera envoyé au retour du réseau")312    }313}314315/// One task: the check box, the title, its due day and priority, the note it comes from, and whether it waits to be sent.316struct TaskRow: View {317    let task: TaskItem318    var isPending = false319    var pageTitle: String?320    let onToggle: () -> Void321    var onOpen: (() -> Void)?322    var onOpenNote: (() -> Void)?323324    private var priority: TaskPriority { TaskPriority(rawValue: task.priority ?? "") ?? .medium }325    private var isOverdue: Bool { TaskGrouping.kind(of: task) == .overdue }326327    var body: some View {328        HStack(alignment: .center, spacing: NVSpace.sm) {329            Button(action: onToggle) {330                Image(systemName: task.isDone ? "checkmark.circle.fill" : "circle")331                    .font(.title2)332                    .foregroundStyle(task.isDone ? NVColor.success : (priority == .high ? NVColor.danger : NVColor.lineStrong))333                    .frame(width: 32, height: 44)334                    .contentShape(Rectangle())335            }336            .buttonStyle(.plain)337            .accessibilityLabel(task.isDone ? Text("Rouvrir \(task.title)") : Text("Terminer \(task.title)"))338            .accessibilityIdentifier("task-toggle")339340            Button { onOpen?() } label: {341                VStack(alignment: .leading, spacing: NVSpace.xs) {342                    Text(task.title)343                        .foregroundStyle(task.isDone ? NVColor.fgMuted : NVColor.fg)344                        .strikethrough(task.isDone, color: NVColor.fgMuted)345                        .multilineTextAlignment(.leading)346                    if hasMeta {347                        // wraps at large text sizes instead of truncating348                        ViewThatFits(in: .horizontal) {349                            HStack(spacing: NVSpace.sm) { meta }350                            VStack(alignment: .leading, spacing: NVSpace.xs) { meta }351                        }352                    }353                }354                .frame(maxWidth: .infinity, alignment: .leading)355                .padding(.vertical, NVSpace.sm)356                .contentShape(Rectangle())357            }358            .buttonStyle(.plain)359            .accessibilityElement(children: .combine)360            .accessibilityLabel(accessibilityText)361            .accessibilityIdentifier("task-row")362        }363    }364365    private var hasMeta: Bool { task.dueAt != nil || priority != .medium || isPending || pageTitle != nil }366367    @ViewBuilder private var meta: some View {368        if let due = task.dueAt { NVChip(TaskDue.label(due), systemImage: "calendar", tone: isOverdue ? .danger : .neutral) }369        if priority == .high { NVChip(String(localized: "Haute"), systemImage: "flag.fill", tone: .danger) }370        if priority == .low { NVChip(String(localized: "Basse"), systemImage: "flag", tone: .neutral) }371        if let pageTitle, let onOpenNote {372            NVChip(NoteTitle.display(pageTitle), systemImage: "note.text", tone: .accent, action: onOpenNote).accessibilityIdentifier("task-note")373        }374        if isPending {375            Image(systemName: "arrow.up.circle").font(.footnote).foregroundStyle(NVColor.fgMuted)376                .accessibilityLabel("En attente d’envoi")377                .accessibilityIdentifier("task-pending")378        }379    }380381    private var accessibilityText: String {382        var parts = [task.title]383        if task.isDone { parts.append(String(localized: "terminée")) }384        if let due = task.dueAt { parts.append((isOverdue ? String(localized: "en retard, ") : "") + TaskDue.label(due)) }385        if priority != .medium { parts.append(String(localized: "priorité \(TaskGrouping.priorityLabel(priority).lowercased())")) }386        if let pageTitle { parts.append(String(localized: "note \(NoteTitle.display(pageTitle))")) }387        if isPending { parts.append(String(localized: "en attente d’envoi")) }388        return parts.joined(separator: ", ")389    }390}391392/// Title, due day and priority of one task.393struct TaskEditSheet: View {394    let task: TaskItem395    var pageTitle: String?396    let onSave: (String, TaskDue.Day?, TaskPriority) -> Void397    let onDelete: () -> Void398    let onOpenNote: () -> Void399    @Environment(\.dismiss) private var dismiss400    @State private var title: String401    @State private var hasDue: Bool402    @State private var date: Date403    @State private var priority: TaskPriority404405    init(task: TaskItem, pageTitle: String?, onSave: @escaping (String, TaskDue.Day?, TaskPriority) -> Void, onDelete: @escaping () -> Void, onOpenNote: @escaping () -> Void) {406        self.task = task; self.pageTitle = pageTitle; self.onSave = onSave; self.onDelete = onDelete; self.onOpenNote = onOpenNote407        _title = State(initialValue: task.title)408        _hasDue = State(initialValue: task.dueAt != nil)409        _date = State(initialValue: TaskDue.pickerDate(task.dueAt.map { TaskDue.day(of: $0) } ?? TaskDue.today()))410        _priority = State(initialValue: TaskPriority(rawValue: task.priority ?? "") ?? .medium)411    }412413    var body: some View {414        NavigationStack {415            Form {416                Section("Tâche") {417                    TextField("Titre", text: $title, axis: .vertical).lineLimit(1...4).accessibilityIdentifier("task-edit-title")418                }419                Section("Échéance") {420                    Toggle("Date d’échéance", isOn: $hasDue).accessibilityIdentifier("task-edit-has-due")421                    if hasDue {422                        DatePicker("Jour", selection: $date, displayedComponents: .date).accessibilityIdentifier("task-edit-date")423                    }424                }425                Section("Priorité") {426                    Picker("Priorité", selection: $priority) {427                        ForEach(TaskPriority.allCases, id: \.self) { Text(TaskGrouping.priorityLabel($0)).tag($0) }428                    }429                    .pickerStyle(.segmented)430                    .accessibilityIdentifier("task-edit-priority")431                }432                if task.pageId != nil {433                    Section("Note d’origine") {434                        Button { dismiss(); onOpenNote() } label: { Label(NoteTitle.display(pageTitle ?? ""), systemImage: "note.text") }435                    }436                }437                Section {438                    Button(role: .destructive) { dismiss(); onDelete() } label: { Label("Supprimer la tâche", systemImage: "trash") }439                }440            }441            .scrollContentBackground(.hidden)442            .background(NVColor.bg)443            .navigationTitle("Modifier la tâche")444            .navigationBarTitleDisplayMode(.inline)445            .toolbar {446                ToolbarItem(placement: .cancellationAction) { Button("Annuler") { dismiss() } }447                ToolbarItem(placement: .confirmationAction) {448                    Button("OK") {449                        let parts = Calendar.current.dateComponents([.year, .month, .day], from: date)450                        let day = hasDue ? TaskDue.Day(year: parts.year ?? 1970, month: parts.month ?? 1, day: parts.day ?? 1) : nil451                        onSave(title, day, priority)452                        dismiss()453                    }454                    .disabled(title.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty)455                    .accessibilityIdentifier("task-edit-save")456                }457            }458        }459        .presentationDetents([.medium, .large])460    }461}462
Files main
Menu

Theme