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