SPB Git

Repository Public

MaintenanceNotesViews.swift 23.6 KB 487 lines swift

1import MCCCore2import SwiftUI34/// What the note editor sheet is doing.5enum NoteEditorContext: Identifiable, Hashable {6    case create(NoteTarget)7    case edit(API.MaintenanceNote)8    var id: String {9        switch self {10        case .create(let t): "new-\(t.windowID ?? "-")-\(t.nodeID ?? "-")-\(t.occurrence.map { String(Int($0.timeIntervalSince1970)) } ?? "-")"11        case .edit(let n): "edit-\(n.id)"12        }13    }14}1516/// One note: author, timestamps, pin state (icon + text), plain-text body, and its actions.17struct MaintenanceNoteRow: View {18    @Environment(AppModel.self) private var app19    @Environment(\.mccTheme) private var theme20    let note: API.MaintenanceNote21    var highlighted = false22    var showsTarget = true23    var windowTitle: String?24    let onEdit: () -> Void25    @State private var confirmsDelete = false2627    private var targetText: String? {28        var parts: [String] = []29        if let alias = note.nodeAlias ?? note.nodeId.flatMap({ app.session.nodes.alias($0) }) { parts.append(tr("maintenance.note.target.node", alias)) }30        if let windowTitle { parts.append(tr("maintenance.note.target.window", windowTitle)) }31        else if note.windowId != nil && note.nodeId == nil { parts.append(tr("maintenance.note.target.window_generic")) }32        if let o = note.occurrence { parts.append(tr("maintenance.note.target.occurrence", Format.dateTime(o))) }33        return parts.isEmpty ? nil : parts.joined(separator: " · ")34    }3536    private var stamp: String {37        var s = "\(note.authorDisplayName) · \(Format.dateTime(note.createdAt))"38        if let e = note.editedAt { s += " · " + tr("maintenance.note.edited", Format.dateTime(e)) }39        return s40    }4142    var body: some View {43        VStack(alignment: .leading, spacing: Tokens.Space.s2) {44            HStack(alignment: .firstTextBaseline, spacing: Tokens.Space.s2) {45                if note.pinned {46                    Label(tr("maintenance.note.pinned"), systemImage: "pin.fill").font(.caption.weight(.medium)).foregroundStyle(theme.accent)47                }48                Text(stamp).font(.caption).foregroundStyle(theme.textSecondary).lineLimit(2)49                Spacer(minLength: 0)50                Menu {51                    Button(tr("action.edit"), action: onEdit).mutation(app, permission: "maintenance.write")52                    Button(note.pinned ? tr("maintenance.note.unpin") : tr("maintenance.note.pin")) { togglePin() }53                        .mutation(app, permission: "maintenance.write")54                    Divider()55                    Button(tr("action.delete"), role: .destructive) { confirmsDelete = true }.mutation(app, permission: "maintenance.write")56                } label: {57                    Image(systemName: "ellipsis.circle")58                }59                .menuStyle(.borderlessButton)60                .menuIndicator(.hidden)61                .fixedSize()62                .accessibilityLabel(tr("maintenance.note.actions"))63            }64            Text(verbatim: note.body)65                .font(.callout)66                .foregroundStyle(theme.textPrimary)67                .textSelection(.enabled)68                .frame(maxWidth: .infinity, alignment: .leading)69                .fixedSize(horizontal: false, vertical: true)70            if showsTarget, let targetText {71                Text(targetText).font(.caption).foregroundStyle(theme.textTertiary)72            }73        }74        .padding(Tokens.Space.s3)75        .background(highlighted ? theme.accentMuted : theme.raised, in: RoundedRectangle(cornerRadius: Tokens.Radius.md, style: .continuous))76        .overlay(RoundedRectangle(cornerRadius: Tokens.Radius.md, style: .continuous)77            .strokeBorder(highlighted ? theme.accent : theme.borderSubtle, lineWidth: highlighted ? 2 : 1))78        .contextMenu {79            Button(tr("action.edit"), action: onEdit).mutation(app, permission: "maintenance.write")80            Button(note.pinned ? tr("maintenance.note.unpin") : tr("maintenance.note.pin")) { togglePin() }.mutation(app, permission: "maintenance.write")81            Button(tr("action.copy")) {82                NSPasteboard.general.clearContents()83                NSPasteboard.general.setString(note.body, forType: .string)84            }85            Button(tr("action.delete"), role: .destructive) { confirmsDelete = true }.mutation(app, permission: "maintenance.write")86        }87        .confirmationDialog(tr("maintenance.note.delete.title"), isPresented: $confirmsDelete) {88            Button(tr("action.delete"), role: .destructive) {89                Task { await app.perform { try await app.session.maintenance.deleteNote(id: note.id) } }90            }91            Button(tr("action.cancel"), role: .cancel) {}92        } message: {93            Text(tr("maintenance.note.delete.message"))94        }95        .accessibilityElement(children: .contain)96        .accessibilityLabel(tr("maintenance.note.a11y", note.authorDisplayName, Format.dateTime(note.createdAt)))97        .accessibilityValue((note.pinned ? tr("maintenance.note.pinned") + ". " : "") + note.body)98        .accessibilityIdentifier("maintenance-note-\(note.id)")99    }100101    private func togglePin() {102        Task { await app.perform { _ = try await app.session.maintenance.updateNote(id: note.id, pinned: !note.pinned) } }103    }104}105106/// The notes of one target (window, occurrence, node) or of a search: pinned first, with an inline composer.107struct MaintenanceNotesList: View {108    @Environment(AppModel.self) private var app109    @Environment(\.mccTheme) private var theme110    let query: NotesQuery111    /// Target of the notes written with the inline composer; nil hides the composer.112    var target: NoteTarget?113    var highlightedNoteID: String?114    var showsTarget = false115    /// Keeps only the notes of this occurrence (client-side) when set.116    var occurrenceFilter: Date?117    var windowTitles: [String: String] = [:]118    @State private var draft = ""119    @State private var draftPinned = false120    @State private var isSaving = false121    @State private var editor: NoteEditorContext?122    @FocusState private var composing: Bool123124    private var resource: Resource<[API.MaintenanceNote]> { app.session.maintenance.notes[query] }125126    var body: some View {127        VStack(alignment: .leading, spacing: Tokens.Space.s3) {128            if target != nil { composer }129            content130        }131        .task(id: query) { await resource.load() }132        .sheet(item: $editor) { NoteEditorSheet(context: $0) }133    }134135    @ViewBuilder private var content: some View {136        let r = resource137        if let all = r.value {138            let notes = MaintenanceLogic.sorted(occurrenceFilter.map { o in all.filter { $0.occurrence == o } } ?? all)139            if r.isShowingStaleData, let at = r.receivedAt { StaleDataBanner(receivedAt: at, state: r.state) }140            if notes.isEmpty {141                Text(query.text == nil ? tr("maintenance.notes.empty") : tr("maintenance.notes.empty_search"))142                    .font(.callout).foregroundStyle(theme.textSecondary)143                    .frame(maxWidth: .infinity, alignment: .leading)144                    .accessibilityIdentifier("maintenance-notes-empty")145            } else {146                ForEach(notes, id: \.id) { note in147                    MaintenanceNoteRow(note: note, highlighted: note.id == highlightedNoteID, showsTarget: showsTarget,148                                       windowTitle: note.windowId.flatMap { windowTitles[$0] }) { editor = .edit(note) }149                        .id(note.id)150                }151            }152        } else {153            switch r.state {154            case .unavailable(let reason, let e):155                UnavailableStateView(reason: reason, error: e) { Task { await r.load() } }.frame(minHeight: 160)156            case .failed(let e):157                ErrorStateView(error: e) { Task { await r.load() } }.frame(minHeight: 160)158            default:159                ProgressView().controlSize(.small).frame(maxWidth: .infinity, alignment: .leading)160            }161        }162    }163164    private var composer: some View {165        VStack(alignment: .leading, spacing: Tokens.Space.s2) {166            TextEditor(text: $draft)167                .font(.callout)168                .focused($composing)169                .frame(minHeight: 54, maxHeight: 120)170                .scrollContentBackground(.hidden)171                .padding(Tokens.Space.s2)172                .background(theme.inset, in: RoundedRectangle(cornerRadius: Tokens.Radius.md))173                .overlay(RoundedRectangle(cornerRadius: Tokens.Radius.md).strokeBorder(composing ? theme.focusRing : theme.border, lineWidth: composing ? 2 : 1))174                .accessibilityLabel(tr("maintenance.note.new"))175                .accessibilityIdentifier("maintenance-note-composer")176            HStack {177                Toggle(tr("maintenance.note.pin"), isOn: $draftPinned).toggleStyle(.checkbox).font(.callout)178                Spacer()179                if isSaving { ProgressView().controlSize(.small) }180                Button(tr("maintenance.note.add")) { save() }181                    .keyboardShortcut(.return, modifiers: .command)182                    .disabled(draft.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty || isSaving)183                    .mutation(app, permission: "maintenance.write")184                    .accessibilityIdentifier("maintenance-note-add")185            }186        }187        .disabled(app.mutationBlocker(permission: "maintenance.write") != nil)188        .help(app.mutationBlocker(permission: "maintenance.write") ?? "")189    }190191    private func save() {192        guard let target else { return }193        let body = draft.trimmingCharacters(in: .whitespacesAndNewlines)194        guard !body.isEmpty else { return }195        isSaving = true196        Task {197            let ok = await app.perform {198                _ = try await app.session.maintenance.createNote(.init(windowId: target.windowID, nodeId: target.nodeID, occurrence: target.occurrence,199                                                                       body: body, pinned: draftPinned))200            }201            isSaving = false202            if ok { draft = ""; draftPinned = false }203        }204    }205}206207/// Create or edit a note in a sheet (⌘↩ saves, ⎋ cancels). The body is plain text.208struct NoteEditorSheet: View {209    @Environment(AppModel.self) private var app210    @Environment(\.mccTheme) private var theme211    @Environment(\.dismiss) private var dismiss212    let context: NoteEditorContext213    @State private var text = ""214    @State private var pinned = false215    @State private var error: APIError?216    @State private var isSaving = false217    @State private var loaded = false218    @FocusState private var focused: Bool219220    private var isEdit: Bool { if case .edit = context { return true }; return false }221222    var body: some View {223        VStack(alignment: .leading, spacing: Tokens.Space.s4) {224            Text(isEdit ? tr("maintenance.note.edit.title") : tr("maintenance.note.new")).font(.title3.weight(.semibold)).foregroundStyle(theme.textPrimary)225                .accessibilityAddTraits(.isHeader)226            TextEditor(text: $text)227                .font(.body)228                .focused($focused)229                .frame(minHeight: 160)230                .scrollContentBackground(.hidden)231                .padding(Tokens.Space.s2)232                .background(theme.inset, in: RoundedRectangle(cornerRadius: Tokens.Radius.md))233                .overlay(RoundedRectangle(cornerRadius: Tokens.Radius.md).strokeBorder(theme.border))234                .accessibilityLabel(tr("maintenance.note.body"))235                .accessibilityIdentifier("maintenance-note-editor")236            Toggle(tr("maintenance.note.pin"), isOn: $pinned).toggleStyle(.checkbox)237            if let error { InlineErrorView(error) }238            HStack {239                Spacer()240                Button(tr("action.cancel"), role: .cancel) { dismiss() }.keyboardShortcut(.cancelAction)241                Button(tr("action.save")) { save() }242                    .keyboardShortcut(.return, modifiers: .command)243                    .buttonStyle(.borderedProminent)244                    .disabled(text.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty || isSaving)245                    .mutation(app, permission: "maintenance.write")246                    .accessibilityIdentifier("maintenance-note-save")247            }248        }249        .padding(Tokens.Space.s6)250        .frame(width: 480)251        .background(theme.surface)252        .onAppear {253            guard !loaded else { return }254            loaded = true255            if case .edit(let n) = context { text = n.body; pinned = n.pinned }256            focused = true257        }258    }259260    private func save() {261        let body = text.trimmingCharacters(in: .whitespacesAndNewlines)262        isSaving = true263        error = nil264        Task {265            defer { isSaving = false }266            do {267                switch context {268                case .create(let t):269                    _ = try await app.session.maintenance.createNote(.init(windowId: t.windowID, nodeId: t.nodeID, occurrence: t.occurrence, body: body, pinned: pinned))270                case .edit(let n):271                    _ = try await app.session.maintenance.updateNote(id: n.id, body: body == n.body ? nil : body, pinned: pinned == n.pinned ? nil : pinned)272                }273                dismiss()274            } catch {275                let e = APIError.from(error)276                if !e.isPasskeyCancelled { self.error = e }277            }278        }279    }280}281282/// Quick add (⇧⌘N): write a note and attach it to a node and/or a maintenance window.283struct QuickNoteSheet: View {284    @Environment(AppModel.self) private var app285    @Environment(\.mccTheme) private var theme286    @Environment(\.dismiss) private var dismiss287    var presetNodeID: String?288    var presetWindowID: String?289    @State private var text = ""290    @State private var pinned = false291    @State private var nodeID = ""292    @State private var windowID = ""293    @State private var error: APIError?294    @State private var isSaving = false295    @FocusState private var focused: Bool296297    private var nodes: [API.Node] { (app.session.nodes.list.value ?? []).filter { $0.retiredAt == nil }.sorted { $0.alias.localizedStandardCompare($1.alias) == .orderedAscending } }298    /// Windows offered as a target: one entry per window among the upcoming occurrences.299    private var windows: [API.MaintenanceWindow] {300        var seen = Set<String>()301        return (app.session.maintenance.upcoming.value?.items ?? []).map(\.window).filter { seen.insert($0.id).inserted }302    }303    private var canSave: Bool {304        !text.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty && !(nodeID.isEmpty && windowID.isEmpty) && !isSaving305    }306307    var body: some View {308        VStack(alignment: .leading, spacing: Tokens.Space.s4) {309            Text(tr("maintenance.quick_note.title")).font(.title3.weight(.semibold)).foregroundStyle(theme.textPrimary).accessibilityAddTraits(.isHeader)310            TextEditor(text: $text)311                .font(.body)312                .focused($focused)313                .frame(minHeight: 130)314                .scrollContentBackground(.hidden)315                .padding(Tokens.Space.s2)316                .background(theme.inset, in: RoundedRectangle(cornerRadius: Tokens.Radius.md))317                .overlay(RoundedRectangle(cornerRadius: Tokens.Radius.md).strokeBorder(theme.border))318                .accessibilityLabel(tr("maintenance.note.body"))319                .accessibilityIdentifier("quick-note-body")320            Form {321                Picker(tr("maintenance.quick_note.node"), selection: $nodeID) {322                    Text(tr("maintenance.quick_note.none")).tag("")323                    ForEach(nodes, id: \.id) { Text($0.alias).tag($0.id) }324                }325                .accessibilityIdentifier("quick-note-node")326                Picker(tr("maintenance.quick_note.window"), selection: $windowID) {327                    Text(tr("maintenance.quick_note.none")).tag("")328                    ForEach(windows, id: \.id) { w in Text("\(w.title) — \(Format.dateTime(w.startsAt))").tag(w.id) }329                }330                .accessibilityIdentifier("quick-note-window")331                Toggle(tr("maintenance.note.pin"), isOn: $pinned)332            }333            if nodeID.isEmpty && windowID.isEmpty {334                Text(tr("maintenance.quick_note.target_required")).font(.caption).foregroundStyle(theme.textSecondary)335            }336            if let error { InlineErrorView(error) }337            HStack {338                Spacer()339                Button(tr("action.cancel"), role: .cancel) { dismiss() }.keyboardShortcut(.cancelAction)340                Button(tr("action.save")) { save() }341                    .keyboardShortcut(.return, modifiers: .command)342                    .buttonStyle(.borderedProminent)343                    .disabled(!canSave)344                    .mutation(app, permission: "maintenance.write")345                    .accessibilityIdentifier("quick-note-save")346            }347        }348        .padding(Tokens.Space.s6)349        .frame(width: 520)350        .background(theme.surface)351        .task {352            nodeID = presetNodeID ?? ""353            windowID = presetWindowID ?? ""354            focused = true355            await app.session.nodes.list.loadIfNeeded(maxAge: 60)356            await app.session.maintenance.upcoming.loadIfNeeded(maxAge: 60)357        }358    }359360    private func save() {361        let body = text.trimmingCharacters(in: .whitespacesAndNewlines)362        isSaving = true363        error = nil364        Task {365            defer { isSaving = false }366            do {367                _ = try await app.session.maintenance.createNote(.init(windowId: windowID.isEmpty ? nil : windowID, nodeId: nodeID.isEmpty ? nil : nodeID,368                                                                       body: body, pinned: pinned))369                dismiss()370            } catch {371                let e = APIError.from(error)372                if !e.isPasskeyCancelled { self.error = e }373            }374        }375    }376}377378/// "Notes" mode: every note, server-side search (debounced), node filter, quick add.379struct MaintenanceNotesMode: View {380    @Environment(AppModel.self) private var app381    @Environment(\.mccTheme) private var theme382    let nodeFilter: String?383    @Binding var highlightedNoteID: String?384    let onQuickAdd: () -> Void385    @State private var searchText = ""386    @State private var appliedText: String?387388    private var query: NotesQuery { NotesQuery(text: appliedText, nodeID: nodeFilter) }389    private var windowTitles: [String: String] {390        var out: [String: String] = [:]391        for o in app.session.maintenance.upcoming.value?.items ?? [] { out[o.window.id] = o.window.title }392        for r in app.session.maintenance.occurrences.all { for o in r.value?.items ?? [] { out[o.window.id] = o.window.title } }393        return out394    }395396    var body: some View {397        VStack(alignment: .leading, spacing: Tokens.Space.s4) {398            HStack(spacing: Tokens.Space.s3) {399                HStack(spacing: Tokens.Space.s2) {400                    Image(systemName: "magnifyingglass").foregroundStyle(theme.textSecondary).accessibilityHidden(true)401                    TextField(tr("maintenance.notes.search"), text: $searchText)402                        .textFieldStyle(.plain)403                        .accessibilityIdentifier("maintenance-notes-search")404                    if !searchText.isEmpty {405                        Button { searchText = "" } label: { Image(systemName: "xmark.circle.fill") }406                            .buttonStyle(.borderless).accessibilityLabel(tr("maintenance.notes.search.clear"))407                    }408                }409                .padding(.horizontal, Tokens.Space.s3)410                .padding(.vertical, Tokens.Space.s2)411                .background(theme.inset, in: RoundedRectangle(cornerRadius: Tokens.Radius.md))412                .overlay(RoundedRectangle(cornerRadius: Tokens.Radius.md).strokeBorder(theme.border))413                .frame(maxWidth: 420)414                Spacer()415                Button(action: onQuickAdd) { Label(tr("maintenance.quick_note.title"), systemImage: "note.text.badge.plus") }416                    .mutation(app, permission: "maintenance.write")417                    .accessibilityIdentifier("maintenance-quick-note")418            }419            ScrollViewReader { proxy in420                ScrollView {421                    MaintenanceNotesList(query: query, target: nil, highlightedNoteID: highlightedNoteID, showsTarget: true, windowTitles: windowTitles)422                        .frame(maxWidth: 820, alignment: .leading)423                        .frame(maxWidth: .infinity, alignment: .leading)424                        .padding(.bottom, Tokens.Space.s7)425                }426                .onChange(of: highlightedNoteID) { _, id in if let id { proxy.scrollTo(id, anchor: .center) } }427            }428        }429        .padding(.horizontal, Tokens.Space.s7)430        .task(id: searchText) {431            // Debounce: one request once typing pauses.432            let t = searchText.trimmingCharacters(in: .whitespacesAndNewlines)433            if !t.isEmpty { try? await Task.sleep(for: .milliseconds(300)) }434            if Task.isCancelled { return }435            appliedText = t.isEmpty ? nil : t436        }437        .task { await app.session.maintenance.upcoming.loadIfNeeded(maxAge: 60) }438    }439}440441/// Maintenance of one node, embedded in the node detail window: its upcoming / active windows and its notes.442struct NodeMaintenancePanel: View {443    @Environment(AppModel.self) private var app444    @Environment(\.mccTheme) private var theme445    let nodeID: String446    @State private var from = Calendar.current.startOfDay(for: Date())447    @State private var editor: WindowEditorContext?448449    private var interval: DateWindow { DateWindow(from: from, to: from.addingTimeInterval(60 * 86_400), nodeID: nodeID) }450    private var resource: Resource<API.MaintenanceOccurrenceList> { app.session.maintenance.occurrences[interval] }451452    var body: some View {453        VStack(alignment: .leading, spacing: Tokens.Space.s5) {454            VStack(alignment: .leading, spacing: Tokens.Space.s3) {455                SectionTitle(tr("maintenance.node.windows")) {456                    HStack(spacing: Tokens.Space.s3) {457                        Button(tr("maintenance.node.open_calendar")) { app.show(.maintenance) }.buttonStyle(.textLink)458                        Button { editor = .create(day: nil, nodeID: nodeID) } label: { Label(tr("maintenance.new_window"), systemImage: "plus") }459                            .mutation(app, permission: "maintenance.write")460                    }461                }462                ResourceView(resource) { list in463                    if list.items.isEmpty {464                        Text(tr("maintenance.node.no_windows")).font(.callout).foregroundStyle(theme.textSecondary)465                    } else {466                        VStack(alignment: .leading, spacing: Tokens.Space.s2) {467                            ForEach(list.items, id: \.occurrenceID) { o in468                                Button { app.show(.maintenance, focus: .maintenanceWindow(o.window.id)) } label: {469                                    AgendaRow(occurrence: o, compact: true)470                                }471                                .buttonStyle(.plain)472                            }473                            if list.truncated { Text(tr("maintenance.truncated")).font(.caption).foregroundStyle(theme.textTertiary) }474                        }475                    }476                }477            }478            VStack(alignment: .leading, spacing: Tokens.Space.s3) {479                SectionTitle(tr("maintenance.node.notes"))480                MaintenanceNotesList(query: NotesQuery(nodeID: nodeID), target: NoteTarget(nodeID: nodeID))481            }482        }483        .task(id: interval) { await resource.load() }484        .sheet(item: $editor) { MaintenanceWindowSheet(context: $0) { _ in } }485    }486}487
Files main
Menu

Theme