SPB Git

Repository Public

MaintenanceEditors.swift 17.6 KB 353 lines swift

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
Files main
Menu

Theme