Repository Public
1import MCCCore2import SwiftUI34/// Permission the server requires for windows and notes (UI hint only; the server enforces).5enum MaintenancePermission {6 static let write = "maintenance.write"7}89/// Content of an occurrence row: title, when (window's zone, and local when different), category, status, scope,10/// notes, flags. State is always text + symbol.11struct OccurrenceSummary: View {12 @Environment(\.mccTheme) private var theme13 @Environment(\.dynamicTypeSize) private var size14 @Session private var session15 let occurrence: API.MaintenanceOccurrence1617 var body: some View {18 let w = occurrence.window19 let range = MaintenanceLogic.timeRange(start: occurrence.occurrenceStart, end: occurrence.occurrenceEnd, zoneID: w.timezone)20 let active = occurrence.active == true21 VStack(alignment: .leading, spacing: Tokens.Space.s2) {22 Label(w.title, systemImage: w.category.symbol).font(.body.weight(.medium)).foregroundStyle(theme.textPrimary)23 Text(range.zone).font(.footnote).foregroundStyle(theme.textSecondary)24 if let local = range.local {25 Text(tr("maintenance.local_time", local)).font(.footnote).foregroundStyle(theme.textTertiary)26 }27 let badges = Group {28 StatusLabel(active ? API.MaintenanceStatus.inProgress.label : w.status.label, tone: active ? .maintenance : w.status.tone)29 Text(w.category.label).font(.footnote).foregroundStyle(theme.textSecondary)30 if w.recurrence != .none {31 Label(w.recurrence.label, systemImage: "repeat").font(.footnote).foregroundStyle(theme.textSecondary)32 }33 }34 if size.isAccessibilitySize {35 VStack(alignment: .leading, spacing: Tokens.Space.s1) { badges }36 } else {37 HStack(spacing: Tokens.Space.s4) { badges }38 }39 Label(MaintenanceLogic.scopeSummary(nodeIDs: w.scope.nodeIds) { session.nodes.alias($0) }, systemImage: "desktopcomputer")40 .font(.footnote).foregroundStyle(theme.textSecondary)41 let flags = Group {42 if occurrence.noteCount > 0 {43 Label(tr("maintenance.note_count", occurrence.noteCount), systemImage: "note.text")44 }45 if w.setMaintenanceMode { Label(tr("maintenance.flag.mode.short"), systemImage: "wrench.and.screwdriver") }46 if w.silenceAlerts { Label(tr("maintenance.flag.silence.short"), systemImage: "bell.slash") }47 }48 .font(.footnote).foregroundStyle(theme.textTertiary)49 if size.isAccessibilitySize {50 VStack(alignment: .leading, spacing: Tokens.Space.s1) { flags }51 } else {52 HStack(spacing: Tokens.Space.s4) { flags }53 }54 }55 .frame(maxWidth: .infinity, alignment: .leading)56 .accessibilityElement(children: .combine)57 }58}5960struct OccurrenceRow: View {61 let occurrence: API.MaintenanceOccurrence62 var body: some View {63 RouteRow(route: .maintenanceWindow(id: occurrence.window.id, occurrence: occurrence.occurrenceStart), identifier: "occurrence-row") {64 OccurrenceSummary(occurrence: occurrence)65 }66 }67}6869/// One note with its actions (edit, pin, delete). Mutations go through the screen's `MutationRunner`.70struct NoteCard: View {71 @Environment(Navigator.self) private var nav72 @Environment(\.mccTheme) private var theme73 @Session private var session74 let note: API.MaintenanceNote75 let runner: MutationRunner76 /// Shows what the note is attached to (search results, node notes).77 var showsContext = false78 @State private var confirmDelete = false7980 private var canWrite: Bool { session.canMutate && session.can(MaintenancePermission.write) }8182 var body: some View {83 Card(padding: Tokens.Space.s4) {84 VStack(alignment: .leading, spacing: Tokens.Space.s3) {85 HStack(alignment: .firstTextBaseline) {86 if note.pinned {87 Label(tr("notes.pinned"), systemImage: "pin.fill").font(.footnote.weight(.semibold)).foregroundStyle(theme.accent)88 .accessibilityIdentifier("note-pinned-flag")89 }90 Spacer(minLength: Tokens.Space.s3)91 menu92 }93 Text(note.body).font(.body).foregroundStyle(theme.textPrimary).textSelection(.enabled)94 .frame(maxWidth: .infinity, alignment: .leading)95 .accessibilityIdentifier("note-row")96 Text(byline).font(.footnote).foregroundStyle(theme.textSecondary)97 if showsContext { context }98 }99 }100 .confirmationDialog(tr("notes.delete.title"), isPresented: $confirmDelete, titleVisibility: .visible) {101 Button(tr("common.delete"), role: .destructive) {102 Task { await runner.run { try await session.maintenance.deleteNote(id: note.id) } }103 }104 .accessibilityIdentifier("note-delete-confirm")105 Button(tr("common.cancel"), role: .cancel) {}106 } message: {107 Text(tr("notes.delete.message"))108 }109 }110111 private var byline: String {112 var parts = [note.authorDisplayName, Format.dateTime(note.createdAt)]113 if let e = note.editedAt { parts.append(tr("notes.edited", Format.dateTime(e))) }114 return parts.joined(separator: " · ")115 }116117 @ViewBuilder private var context: some View {118 VStack(alignment: .leading, spacing: Tokens.Space.s1) {119 if let alias = note.nodeAlias ?? note.nodeId.flatMap({ session.nodes.alias($0) }) {120 Label(alias, systemImage: "desktopcomputer").font(.footnote).foregroundStyle(theme.textSecondary)121 }122 if let o = note.occurrence {123 Label(tr("notes.occurrence_of", Format.dateTime(o)), systemImage: "calendar").font(.footnote).foregroundStyle(theme.textSecondary)124 }125 if let id = note.windowId {126 Button { nav.open(.maintenanceWindow(id: id, occurrence: note.occurrence)) } label: {127 Label(tr("notes.open_window"), systemImage: "calendar.badge.clock").frame(minHeight: Tokens.Size.touchMin)128 }129 .font(.callout)130 .accessibilityIdentifier("note-open-window")131 }132 }133 }134135 private var menu: some View {136 Menu {137 Button {138 nav.sheet = .noteEditor(NoteContext(noteID: note.id, windowID: note.windowId, nodeID: note.nodeId, occurrence: note.occurrence, body: note.body, pinned: note.pinned))139 } label: { Label(tr("common.edit"), systemImage: "pencil") }140 .accessibilityIdentifier("note-edit")141 Button {142 Task { await runner.run { try await session.maintenance.updateNote(id: note.id, pinned: !note.pinned) } }143 } label: { Label(tr(note.pinned ? "notes.unpin" : "notes.pin"), systemImage: note.pinned ? "pin.slash" : "pin") }144 .accessibilityIdentifier("note-pin")145 Button(role: .destructive) { confirmDelete = true } label: { Label(tr("common.delete"), systemImage: "trash") }146 .accessibilityIdentifier("note-delete")147 } label: {148 Image(systemName: "ellipsis.circle").font(.title3).touchTarget().contentShape(Rectangle())149 }150 .disabled(!canWrite || runner.isRunning)151 .accessibilityLabel(tr("notes.actions"))152 .accessibilityHint(canWrite ? "" : tr(session.canMutate ? "mutation.denied_hint" : "mutation.offline_hint"))153 .accessibilityIdentifier("note-menu")154 }155}156157/// Notes of a query, pinned first, with their explicit states and timestamp.158struct NotesBlock: View {159 @Environment(\.mccTheme) private var theme160 @Session private var session161 let query: NotesQuery162 let runner: MutationRunner163 var showsContext = false164 var emptyText: String = tr("notes.empty")165166 var body: some View {167 let resource = session.maintenance.notes[query]168 ResourceSection(resource: resource) { notes in169 if notes.isEmpty {170 Text(emptyText).font(.callout).foregroundStyle(theme.textSecondary).accessibilityIdentifier("notes-empty")171 } else {172 ForEach(MaintenanceLogic.sorted(notes), id: \.id) { NoteCard(note: $0, runner: runner, showsContext: showsContext) }173 }174 }175 .loads(resource)176 }177}178179/// Notes kept on a node (not tied to a window) and the node's upcoming windows.180struct NodeNotesScreen: View {181 @Environment(Navigator.self) private var nav182 @Environment(\.mccTheme) private var theme183 @Session private var session184 let nodeID: String185 @State private var runner = MutationRunner()186187 private var query: NotesQuery { NotesQuery(nodeID: nodeID) }188189 var body: some View {190 let alias = session.nodes.alias(nodeID)191 ScreenStack {192 SectionCard(tr("notes.node.title")) {193 MutationButton(title: tr("notes.add"), systemImage: "square.and.pencil", permission: MaintenancePermission.write, identifier: "note-add") {194 nav.sheet = .noteEditor(NoteContext(nodeID: nodeID))195 }196 } content: {197 NotesBlock(query: query, runner: runner, emptyText: tr("notes.node.empty"))198 }199 SectionCard(tr("notes.node.upcoming")) {200 ResourceSection(resource: session.maintenance.upcoming) { list in201 let mine = list.items.filter { $0.window.scope.nodeIds.contains(nodeID) }202 if mine.isEmpty {203 Text(tr("overview.maintenance.none")).font(.callout).foregroundStyle(theme.textSecondary)204 } else {205 ForEach(mine, id: \.occurrenceID) { OccurrenceRow(occurrence: $0) }206 }207 }208 }209 }210 .screen("node-notes", title: alias.map { tr("notes.node.screen_title", $0) } ?? tr("notes.node.title"), load: {211 async let a: Void = session.nodes.list.loadIfNeeded(maxAge: 60)212 async let b: Void = session.maintenance.upcoming.loadIfNeeded(maxAge: 60)213 _ = await (a, b)214 }, reload: {215 async let a: Void = session.maintenance.notes[query].load()216 async let b: Void = session.maintenance.upcoming.load()217 _ = await (a, b)218 })219 .navigationBarTitleDisplayMode(.inline)220 .mutationError(runner)221 }222}223