Repository Public
1import MCCCore2import SwiftUI34/// Create or edit a maintenance window. Dates are entered in the window's own time zone.5struct MaintenanceWindowEditor: View {6 @Environment(\.dismiss) private var dismiss7 @Environment(\.mccTheme) private var theme8 @Session private var session9 let windowID: String?10 let day: Date?11 let nodeID: String?1213 @State private var draft: WindowDraft?14 @State private var runner = MutationRunner()15 @State private var loadError: APIError?16 @State private var pickingZone = false17 @State private var showProblems = false1819 var body: some View {20 Group {21 if draft != nil {22 form23 } else if let loadError {24 ErrorStateView(error: loadError) { Task { await prepare() } }25 } else {26 ProgressView(tr("state.loading")).frame(maxWidth: .infinity, maxHeight: .infinity)27 }28 }29 .background(theme.canvas.ignoresSafeArea())30 .navigationTitle(tr(windowID == nil ? "maintenance.editor.new" : "maintenance.editor.edit"))31 .navigationBarTitleDisplayMode(.inline)32 .toolbar {33 ToolbarItem(placement: .cancellationAction) { Button(tr("common.cancel")) { dismiss() }.accessibilityIdentifier("window-editor-cancel") }34 ToolbarItem(placement: .confirmationAction) {35 Button(tr("common.save")) { save() }36 .disabled(draft == nil || runner.isRunning || !session.canMutate)37 .accessibilityIdentifier("window-save")38 }39 }40 .task { await prepare() }41 .accessibilityIdentifier("screen-window-editor")42 }4344 private func prepare() async {45 guard draft == nil else { return }46 loadError = nil47 async let nodes: Void = session.nodes.list.loadIfNeeded(maxAge: 60)48 if let windowID {49 let r = session.maintenance.window[windowID]50 await r.loadIfNeeded()51 if let w = r.value { draft = WindowDraft(window: w) } else { loadError = r.state.error ?? .offline }52 } else {53 draft = WindowDraft(day: day, nodeID: nodeID)54 }55 await nodes56 }5758 private func save() {59 guard let d = draft else { return }60 guard d.canSave else { showProblems = true; return }61 Task {62 let ok: API.MaintenanceWindow? = await runner.run {63 if let windowID { return try await session.maintenance.updateWindow(id: windowID, d.updateRequest()) }64 return try await session.maintenance.createWindow(d.createRequest())65 }66 if ok != nil { dismiss() }67 }68 }6970 private func invalid(_ field: String) -> Bool { runner.error?.invalidFields.contains(field) ?? false }7172 private func title(_ key: String, field: String, problem: WindowDraft.Problem? = nil) -> some View {73 let bad = invalid(field) || (showProblems && problem.map { draft?.problems.contains($0) ?? false } == true)74 return HStack(spacing: Tokens.Space.s2) {75 Text(tr(key))76 if bad { Image(systemName: "exclamationmark.triangle.fill").foregroundStyle(StatusTone.critical.color(theme)).accessibilityLabel(tr("maintenance.editor.invalid")) }77 }78 }7980 @ViewBuilder private var form: some View {81 let d = Binding(get: { draft ?? WindowDraft(day: nil, nodeID: nil) }, set: { draft = $0 })82 let zone = d.wrappedValue.zone83 Form {84 if let e = runner.error {85 Section { InlineErrorView(e).accessibilityIdentifier("window-editor-error") }.listRowBackground(Color.clear)86 }87 if showProblems, !d.wrappedValue.problems.isEmpty {88 Section {89 ForEach(d.wrappedValue.problems, id: \.self) { p in90 Label(trDynamic("maintenance.problem." + p.rawValue), systemImage: "exclamationmark.triangle")91 .foregroundStyle(StatusTone.warning.color(theme))92 }93 }94 .accessibilityIdentifier("window-editor-problems")95 }96 Section {97 TextField(tr("maintenance.field.title"), text: d.title)98 .frame(minHeight: Tokens.Size.touchMin)99 .accessibilityIdentifier("window-title")100 TextField(tr("maintenance.field.description"), text: d.description, axis: .vertical)101 .lineLimit(2...6)102 .accessibilityIdentifier("window-description")103 Picker(tr("maintenance.field.category"), selection: d.category) {104 ForEach(API.MaintenanceCategory.allCases, id: \.self) { Label($0.label, systemImage: $0.symbol).tag($0) }105 }106 .accessibilityIdentifier("window-category")107 } header: { title("maintenance.editor.what", field: "title", problem: .titleMissing) }108109 Section {110 DatePicker(tr("maintenance.field.start"), selection: Binding(get: { d.wrappedValue.startsAt }, set: { d.wrappedValue.setStart($0) }))111 .environment(\.timeZone, zone)112 .accessibilityIdentifier("window-start")113 DatePicker(tr("maintenance.field.end"), selection: d.endsAt)114 .environment(\.timeZone, zone)115 .accessibilityIdentifier("window-end")116 Button { pickingZone = true } label: {117 HStack {118 Text(tr("maintenance.field.timezone")).foregroundStyle(theme.textPrimary)119 Spacer(minLength: Tokens.Space.s3)120 Text(d.wrappedValue.timezone).foregroundStyle(theme.textSecondary).multilineTextAlignment(.trailing)121 Image(systemName: "chevron.right").font(.footnote.weight(.semibold)).foregroundStyle(theme.textTertiary).accessibilityHidden(true)122 }123 .frame(minHeight: Tokens.Size.touchMin - Tokens.Space.s4)124 .contentShape(Rectangle())125 }126 .buttonStyle(.plain)127 .accessibilityIdentifier("window-timezone")128 } header: { title("maintenance.editor.when", field: "ends_at", problem: .endNotAfterStart) } footer: {129 Text(tr("maintenance.editor.zone_help", MaintenanceLogic.abbreviation(zone, at: d.wrappedValue.startsAt)))130 }131132 Section {133 Picker(tr("maintenance.field.recurrence"), selection: d.recurrence) {134 ForEach(API.MaintenanceRecurrence.allCases, id: \.self) { Text($0.label).tag($0) }135 }136 .accessibilityIdentifier("window-recurrence")137 if d.wrappedValue.recurrence != .none {138 Toggle(tr("maintenance.editor.has_until"), isOn: d.hasUntil).accessibilityIdentifier("window-has-until")139 if d.wrappedValue.hasUntil {140 DatePicker(tr("maintenance.field.until"), selection: d.until, displayedComponents: .date)141 .environment(\.timeZone, zone)142 .accessibilityIdentifier("window-until")143 }144 }145 } header: { title("maintenance.field.recurrence", field: "recurrence_until", problem: .untilBeforeStart) }146147 Section {148 if let nodes = session.nodes.list.value {149 ForEach(nodes.filter { $0.retiredAt == nil }.sorted { $0.alias.localizedStandardCompare($1.alias) == .orderedAscending }, id: \.id) { n in150 let on = d.wrappedValue.nodeIDs.contains(n.id)151 Button {152 if on { d.wrappedValue.nodeIDs.remove(n.id) } else { d.wrappedValue.nodeIDs.insert(n.id) }153 } label: {154 HStack {155 Image(systemName: on ? "checkmark.circle.fill" : "circle").foregroundStyle(on ? theme.accent : theme.textTertiary).accessibilityHidden(true)156 Text(n.alias).foregroundStyle(theme.textPrimary)157 Spacer(minLength: Tokens.Space.s3)158 Text(n.freshness.label).font(.footnote).foregroundStyle(theme.textTertiary)159 }160 .frame(minHeight: Tokens.Size.touchMin - Tokens.Space.s4)161 .contentShape(Rectangle())162 }163 .buttonStyle(.plain)164 .accessibilityAddTraits(on ? [.isSelected] : [])165 .accessibilityIdentifier("window-scope-" + n.alias)166 }167 } else if let e = session.nodes.list.state.error {168 InlineErrorView(e)169 } else {170 ProgressView()171 }172 } header: { title("maintenance.window.scope", field: "scope") } footer: {173 Text(tr("maintenance.editor.scope_selected", d.wrappedValue.nodeIDs.count))174 }175176 Section {177 Toggle(tr("maintenance.flag.mode"), isOn: d.setMaintenanceMode).accessibilityIdentifier("window-flag-mode")178 Toggle(tr("maintenance.flag.silence"), isOn: d.silenceAlerts).accessibilityIdentifier("window-flag-silence")179 } footer: { Text(tr("maintenance.editor.flags_help")) }180 }181 .scrollContentBackground(.hidden)182 .scrollDismissesKeyboard(.interactively)183 .navigationDestination(isPresented: $pickingZone) {184 TimeZonePicker(selected: d.wrappedValue.timezone) { id in185 d.wrappedValue.setTimezone(id)186 pickingZone = false187 }188 }189 }190}191192/// Searchable list of the system's time zones.193private struct TimeZonePicker: View {194 @Environment(\.mccTheme) private var theme195 let selected: String196 let pick: (String) -> Void197 @State private var query = ""198199 var body: some View {200 let now = Date()201 List(MaintenanceLogic.filterZones([TimeZone.current.identifier, "UTC"] + TimeZone.knownTimeZoneIdentifiers.filter { $0 != TimeZone.current.identifier && $0 != "UTC" }, query: query), id: \.self) { id in202 Button { pick(id) } label: {203 HStack {204 VStack(alignment: .leading, spacing: Tokens.Space.s1) {205 Text(id.replacingOccurrences(of: "_", with: " ")).foregroundStyle(theme.textPrimary)206 if let tz = TimeZone(identifier: id) {207 Text(MaintenanceLogic.abbreviation(tz, at: now)).font(.footnote).foregroundStyle(theme.textSecondary)208 }209 }210 Spacer(minLength: Tokens.Space.s3)211 if id == selected { Image(systemName: "checkmark").foregroundStyle(theme.accent).accessibilityHidden(true) }212 }213 .frame(minHeight: Tokens.Size.touchMin - Tokens.Space.s4)214 .contentShape(Rectangle())215 }216 .buttonStyle(.plain)217 .listRowBackground(theme.surface)218 .accessibilityAddTraits(id == selected ? [.isSelected] : [])219 .accessibilityIdentifier("timezone-row")220 }221 .scrollContentBackground(.hidden)222 .background(theme.canvas.ignoresSafeArea())223 .searchable(text: $query, placement: .navigationBarDrawer(displayMode: .always), prompt: tr("maintenance.editor.zone_search"))224 .autocorrectionDisabled()225 .navigationTitle(tr("maintenance.field.timezone"))226 .navigationBarTitleDisplayMode(.inline)227 .accessibilityIdentifier("screen-timezone-picker")228 }229}230231/// Write or edit a note. A quick note (opened from the toolbar or ⇧⌘N) must be attached to a node or to a window.232struct NoteEditorSheet: View {233 @Environment(\.dismiss) private var dismiss234 @Environment(\.mccTheme) private var theme235 @Session private var session236 let context: NoteContext237 @State private var draft: NoteDraft238 @State private var runner = MutationRunner()239 @FocusState private var focused: Bool240241 init(context: NoteContext) {242 self.context = context243 _draft = State(initialValue: NoteDraft(context: context))244 }245246 var body: some View {247 Form {248 if let e = runner.error {249 Section { InlineErrorView(e).accessibilityIdentifier("note-editor-error") }.listRowBackground(Color.clear)250 }251 if draft.needsTarget { target } else { attachedTo }252 Section(tr("notes.field.body")) {253 TextEditor(text: $draft.body)254 .font(.body)255 .frame(minHeight: 180)256 .focused($focused)257 .accessibilityLabel(tr("notes.field.body"))258 .accessibilityIdentifier("note-body")259 Toggle(isOn: $draft.pinned) { Label(tr("notes.field.pinned"), systemImage: "pin") }260 .accessibilityIdentifier("note-pinned")261 }262 }263 .scrollContentBackground(.hidden)264 .scrollDismissesKeyboard(.interactively)265 .background(theme.canvas.ignoresSafeArea())266 .navigationTitle(tr(draft.isEditing ? "notes.editor.edit" : draft.needsTarget ? "commands.quick_note" : "notes.editor.new"))267 .navigationBarTitleDisplayMode(.inline)268 .toolbar {269 ToolbarItem(placement: .cancellationAction) { Button(tr("common.cancel")) { dismiss() }.accessibilityIdentifier("note-editor-cancel") }270 ToolbarItem(placement: .confirmationAction) {271 Button(tr("common.save")) { save() }272 .disabled(!draft.canSave || runner.isRunning || !session.canMutate)273 .accessibilityIdentifier("note-save")274 }275 }276 .task {277 if draft.needsTarget {278 async let a: Void = session.nodes.list.loadIfNeeded(maxAge: 60)279 async let b: Void = session.maintenance.upcoming.loadIfNeeded(maxAge: 60)280 _ = await (a, b)281 } else {282 focused = true283 }284 }285 .accessibilityIdentifier("screen-note-editor")286 }287288 private func save() {289 let d = draft290 // Only what changed is sent; nothing changed means nothing to save.291 let body = d.updateBody == context.body.trimmingCharacters(in: .whitespacesAndNewlines) ? nil : d.updateBody292 let pinned = d.pinned == context.pinned ? nil : d.pinned293 if d.isEditing, body == nil, pinned == nil { dismiss(); return }294 Task {295 let saved: API.MaintenanceNote? = await runner.run {296 if let id = d.noteID { return try await session.maintenance.updateNote(id: id, body: body, pinned: pinned) }297 return try await session.maintenance.createNote(d.createRequest())298 }299 if saved != nil { dismiss() }300 }301 }302303 @ViewBuilder private var attachedTo: some View {304 Section(tr("notes.field.about")) {305 if let id = draft.nodeID { InfoRow(tr("notes.target.node"), session.nodes.alias(id)) }306 if let id = draft.windowID { InfoRow(tr("notes.target.window"), session.maintenance.window.existing(id)?.value?.title ?? tr("maintenance.window.title")) }307 if let o = draft.occurrence { InfoRow(tr("maintenance.field.occurrence"), Format.dateTime(o)) }308 }309 }310311 @ViewBuilder private var target: some View {312 Section {313 Picker(tr("notes.field.about"), selection: $draft.target) {314 ForEach(NoteDraft.Target.allCases) { Text($0.title).tag($0) }315 }316 .pickerStyle(.segmented)317 .accessibilityIdentifier("note-target-kind")318 switch draft.target {319 case .node:320 if let nodes = session.nodes.list.value {321 Picker(tr("notes.target.node"), selection: $draft.nodeID) {322 Text(tr("notes.target.choose")).tag(String?.none)323 ForEach(nodes.filter { $0.retiredAt == nil }.sorted { $0.alias.localizedStandardCompare($1.alias) == .orderedAscending }, id: \.id) {324 Text($0.alias).tag(Optional($0.id))325 }326 }327 .accessibilityIdentifier("note-target-node")328 } else if let e = session.nodes.list.state.error { InlineErrorView(e) } else { ProgressView() }329 case .window:330 if let list = session.maintenance.upcoming.value {331 if list.items.isEmpty {332 Text(tr("overview.maintenance.none")).foregroundStyle(theme.textSecondary)333 } else {334 Picker(tr("notes.target.window"), selection: Binding(get: { draft.windowID.map { OccurrenceKey(windowID: $0, occurrence: draft.occurrence) } },335 set: { draft.windowID = $0?.windowID; draft.occurrence = $0?.occurrence })) {336 Text(tr("notes.target.choose")).tag(OccurrenceKey?.none)337 ForEach(list.items, id: \.occurrenceID) { o in338 Text(o.window.title + " · " + Format.dateTime(o.occurrenceStart)).tag(Optional(OccurrenceKey(windowID: o.window.id, occurrence: o.occurrenceStart)))339 }340 }341 .accessibilityIdentifier("note-target-window")342 }343 } else if let e = session.maintenance.upcoming.state.error { InlineErrorView(e) } else { ProgressView() }344 }345 } header: { Text(tr("notes.field.about")) } footer: { Text(tr("notes.target.help")) }346 }347}348349private struct OccurrenceKey: Hashable {350 var windowID: String351 var occurrence: Date?352}353