Repository Public
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