SPB Git

Repository Public

MaintenanceView.swift 11.8 KB 235 lines swift

1import MCCCore2import SwiftUI3import UniformTypeIdentifiers45/// Maintenance calendar (month / week / agenda) and maintenance notes.6struct MaintenanceView: View {7    @Environment(AppModel.self) private var app8    @Environment(\.mccTheme) private var theme9    @SceneStorage("mcc.maintenance.mode") private var modeRaw = MaintenanceMode.month.rawValue10    @SceneStorage("mcc.maintenance.node") private var nodeFilterRaw = ""11    @State private var anchor = Date()12    @State private var selectedDay = Date()13    @State private var selection: OccurrenceRef?14    @State private var editor: WindowEditorContext?15    @State private var quickNote = false16    @State private var warnings: [String] = []17    @State private var highlightedNote: String?18    @State private var exportError: APIError?19    @State private var isExporting = false2021    private var mode: MaintenanceMode { MaintenanceMode(rawValue: modeRaw) ?? .month }22    private var nodeFilter: String? { nodeFilterRaw.isEmpty ? nil : nodeFilterRaw }23    private var calendar: Calendar { CalendarMath.calendar() }24    private var interval: DateWindow? { MaintenanceLogic.interval(mode: mode, anchor: anchor, calendar: calendar, nodeID: nodeFilter) }25    private var resource: Resource<API.MaintenanceOccurrenceList>? { interval.map { app.session.maintenance.occurrences[$0] } }26    private var nodes: [API.Node] {27        (app.session.nodes.list.value ?? []).filter { $0.retiredAt == nil }.sorted { $0.alias.localizedStandardCompare($1.alias) == .orderedAscending }28    }2930    var body: some View {31        Page(title: tr("nav.maintenance"), subtitle: mode.isCalendar ? MaintenanceLogic.periodTitle(mode: mode, anchor: anchor, calendar: calendar) : tr("maintenance.notes.subtitle"),32             scrolls: false) {33            controls34        } content: {35            VStack(alignment: .leading, spacing: Tokens.Space.s3) {36                if !warnings.isEmpty { warningBanner }37                if let exportError { InlineErrorView(exportError).padding(.horizontal, Tokens.Space.s7) }38                if mode == .notes {39                    MaintenanceNotesMode(nodeFilter: nodeFilter, highlightedNoteID: $highlightedNote) { quickNote = true }40                } else {41                    HStack(spacing: 0) {42                        calendarArea43                            .padding(.horizontal, Tokens.Space.s7)44                            .padding(.bottom, Tokens.Space.s5)45                            .frame(maxWidth: .infinity, maxHeight: .infinity, alignment: .topLeading)46                        if let selection {47                            MaintenanceDetailPanel(ref: selection, listed: listed(selection), onEdit: { editor = .edit($0) }, onClose: { self.selection = nil })48                                .frame(width: 380)49                                .id(selection.id)50                        }51                    }52                }53            }54        }55        .task(id: interval) { if let r = resource { await r.load() } }56        .task {57            await app.session.nodes.list.loadIfNeeded(maxAge: 60)58            consumeRequests()59        }60        .onChange(of: app.quickNoteRequested) { _, _ in consumeRequests() }61        .onChange(of: app.focus) { _, _ in consumeRequests() }62        .sheet(item: $editor) { ctx in63            MaintenanceWindowSheet(context: ctx) { saved in64                warnings = saved.warnings ?? []65                anchor = saved.startsAt66                selectedDay = saved.startsAt67                selection = OccurrenceRef(windowID: saved.id, start: saved.startsAt, end: saved.endsAt)68            }69        }70        .sheet(isPresented: $quickNote) { QuickNoteSheet(presetNodeID: nodeFilter, presetWindowID: selection?.windowID) }71    }7273    // MARK: Header controls7475    private var controls: some View {76        HStack(spacing: Tokens.Space.s3) {77            if mode.isCalendar {78                ControlGroup {79                    Button { navigate(-1) } label: { Label(tr("maintenance.nav.previous"), systemImage: "chevron.left") }80                        .keyboardShortcut("[", modifiers: .command).help(tr("maintenance.nav.previous"))81                        .accessibilityIdentifier("maintenance-previous")82                    Button(tr("maintenance.today")) { anchor = Date(); selectedDay = Date() }83                        .keyboardShortcut("t", modifiers: .command)84                        .accessibilityIdentifier("maintenance-today")85                    Button { navigate(1) } label: { Label(tr("maintenance.nav.next"), systemImage: "chevron.right") }86                        .keyboardShortcut("]", modifiers: .command).help(tr("maintenance.nav.next"))87                        .accessibilityIdentifier("maintenance-next")88                }89                .fixedSize()90            }91            Picker(tr("maintenance.mode"), selection: $modeRaw) {92                ForEach(MaintenanceMode.allCases) { Text($0.title).tag($0.rawValue) }93            }94            .pickerStyle(.segmented).labelsHidden().fixedSize()95            .accessibilityLabel(tr("maintenance.mode"))96            .accessibilityIdentifier("maintenance-mode")97            Picker(tr("maintenance.filter.node"), selection: $nodeFilterRaw) {98                Text(tr("maintenance.filter.all_nodes")).tag("")99                ForEach(nodes, id: \.id) { Text($0.alias).tag($0.id) }100            }101            .labelsHidden().frame(maxWidth: 170)102            .accessibilityLabel(tr("maintenance.filter.node"))103            .accessibilityIdentifier("maintenance-node-filter")104            Menu {105                Button(tr("maintenance.quick_note.title")) { quickNote = true }.mutation(app, permission: "maintenance.write")106                Button(tr("maintenance.export")) { export() }.disabled(isExporting || interval == nil)107                Button(tr("action.refresh")) { Task { await resource?.load() } }108            } label: {109                Label(tr("maintenance.more_actions"), systemImage: "ellipsis.circle")110            }111            .menuStyle(.borderlessButton).fixedSize()112            .accessibilityIdentifier("maintenance-more")113            Button { editor = .create(day: mode == .agenda ? nil : selectedDay, nodeID: nodeFilter) } label: { Label(tr("maintenance.new_window"), systemImage: "plus") }114                .buttonStyle(.borderedProminent)115                .mutation(app, permission: "maintenance.write")116                .accessibilityIdentifier("maintenance-new-window")117        }118    }119120    private var warningBanner: some View {121        HStack(alignment: .top) {122            InfoBanner(tone: .warning, title: tr("maintenance.warnings.title"), message: warnings.joined(separator: "\n"))123            Button { warnings = [] } label: { Image(systemName: "xmark") }124                .buttonStyle(.borderless).accessibilityLabel(tr("action.close"))125        }126        .padding(.horizontal, Tokens.Space.s7)127        .accessibilityIdentifier("maintenance-warnings")128    }129130    // MARK: Calendar131132    @ViewBuilder private var calendarArea: some View {133        if let r = resource {134            if let list = r.value {135                VStack(alignment: .leading, spacing: Tokens.Space.s2) {136                    if r.isShowingStaleData, let at = r.receivedAt { StaleDataBanner(receivedAt: at, state: r.state) }137                    if list.truncated {138                        InfoBanner(tone: .info, title: tr("maintenance.truncated"), message: tr("maintenance.truncated.help"))139                    }140                    switch mode {141                    case .month:142                        MaintenanceMonthView(anchor: anchor, calendar: calendar, occurrences: list.items, selectedDay: $selectedDay, selection: selection,143                                             onSelect: select, onCreate: { editor = .create(day: $0, nodeID: nodeFilter) }, onMoveAnchor: { anchor = $0 })144                    case .week:145                        MaintenanceWeekView(anchor: anchor, calendar: calendar, occurrences: list.items, selectedDay: $selectedDay, selection: selection,146                                            onSelect: select, onCreate: { editor = .create(day: $0, nodeID: nodeFilter) })147                    case .agenda:148                        MaintenanceAgendaView(calendar: calendar, occurrences: list.items, selection: selection, onSelect: select)149                    case .notes:150                        EmptyView()151                    }152                    HStack(spacing: Tokens.Space.s3) {153                        if r.state.isLoading { ProgressView().controlSize(.small) }154                        Text(tr("maintenance.footer.count", list.items.count)).font(.caption).foregroundStyle(theme.textTertiary)155                        if let at = r.receivedAt { Text(tr("maintenance.footer.received", Format.time(at, seconds: true))).font(.caption).foregroundStyle(theme.textTertiary) }156                    }157                    .accessibilityElement(children: .combine)158                }159            } else {160                ResourceView(r) { _ in EmptyView() }161            }162        }163    }164165    private func listed(_ ref: OccurrenceRef) -> API.MaintenanceOccurrence? {166        resource?.value?.items.first { OccurrenceRef($0).id == ref.id }167    }168169    private func select(_ o: API.MaintenanceOccurrence) { selection = OccurrenceRef(o) }170171    private func navigate(_ n: Int) {172        anchor = MaintenanceLogic.shift(anchor, mode: mode, by: n, calendar: calendar)173        if mode != .agenda, !calendar.isDate(selectedDay, equalTo: anchor, toGranularity: mode == .month ? .month : .weekOfYear) { selectedDay = anchor }174    }175176    // MARK: Requests from outside (⇧⌘N, search results, notifications, deep links)177178    private func consumeRequests() {179        if app.quickNoteRequested {180            app.quickNoteRequested = false181            if app.mutationBlocker(permission: "maintenance.write") == nil { quickNote = true }182        }183        switch app.focus {184        case .maintenanceWindow(let id):185            app.focus = nil186            Task {187                let r = app.session.maintenance.window[id]188                await r.load()189                if mode == .notes { modeRaw = MaintenanceMode.month.rawValue }190                if let w = r.value {191                    // An active or upcoming occurrence of a recurring window, when one is known, rather than the first.192                    let known = app.session.maintenance.upcoming.value?.items.first { $0.window.id == id }193                    let start = known?.occurrenceStart ?? w.startsAt, end = known?.occurrenceEnd ?? w.endsAt194                    anchor = start195                    selectedDay = start196                    selection = OccurrenceRef(windowID: id, start: start, end: end)197                } else {198                    selection = OccurrenceRef(windowID: id, start: anchor, end: anchor)   // the panel shows why it cannot load199                }200            }201        case .maintenanceNote(let id):202            app.focus = nil203            modeRaw = MaintenanceMode.notes.rawValue204            highlightedNote = id205        default:206            break207        }208    }209210    // MARK: Export211212    private func export() {213        guard let interval else { return }214        let panel = NSSavePanel()215        panel.nameFieldStringValue = "maclustr-maintenance.ics"216        panel.allowedContentTypes = [UTType(filenameExtension: "ics") ?? .data]217        panel.canCreateDirectories = true218        panel.title = tr("maintenance.export")219        guard panel.runModal() == .OK, let url = panel.url else { return }220        isExporting = true221        exportError = nil222        Task {223            defer { isExporting = false }224            do {225                let data = try await app.session.maintenance.exportICS(from: interval.from, to: interval.to, nodeID: interval.nodeID)226                try data.write(to: url, options: .atomic)227            } catch let e as APIError {228                exportError = e229            } catch {230                exportError = APIError(code: "client.file", message: error.localizedDescription)231            }232        }233    }234}235
Files main
Menu

Theme