krz/hutch

an ios client for sourcehut

clone: git clone https://gitbay.org/krz/hutch.git

v3.9.0: Hutch/Views/Tickets/TrackerManagementView.swift · raw

   1import SwiftUI
   2
   3private struct TrackerQueryResponse: Decodable, Sendable {
   4    let tracker: TrackerSummary?
   5}
   6
   7private struct TrackerACLQueryResponse: Decodable, Sendable {
   8    let tracker: TrackerACLQueryPayload?
   9}
  10
  11private struct TrackerACLQueryPayload: Decodable, Sendable {
  12    let defaultACL: DefaultTrackerACL
  13    let acls: TrackerACLPage
  14}
  15
  16private struct TrackerACLPage: Decodable, Sendable {
  17    let results: [TrackerACL]
  18    let cursor: String?
  19}
  20
  21private struct TrackerLabelQueryResponse: Decodable, Sendable {
  22    let tracker: TrackerLabelQueryPayload?
  23}
  24
  25private struct TrackerLabelQueryPayload: Decodable, Sendable {
  26    let labels: TrackerLabelPage
  27}
  28
  29private struct TrackerLabelPage: Decodable, Sendable {
  30    let results: [TicketLabel]
  31    let cursor: String?
  32}
  33
  34private struct UpdateTrackerResponse: Decodable, Sendable {
  35    let updateTracker: TrackerSummary
  36}
  37
  38private struct DeleteTrackerResponse: Decodable, Sendable {
  39    let deleteTracker: DeletedTracker
  40}
  41
  42private struct DeletedTracker: Decodable, Sendable {
  43    let id: Int
  44}
  45
  46private struct UpdateUserACLResponse: Decodable, Sendable {
  47    let updateUserACL: TrackerACL
  48}
  49
  50private struct UpdateTrackerACLResponse: Decodable, Sendable {
  51    let updateTrackerACL: DefaultTrackerACL
  52}
  53
  54private struct DeleteTrackerACLResponse: Decodable, Sendable {
  55    let deleteACL: TrackerACL
  56}
  57
  58private struct CreateTrackerLabelResponse: Decodable, Sendable {
  59    let createLabel: TicketLabel
  60}
  61
  62private struct UpdateTrackerLabelResponse: Decodable, Sendable {
  63    let updateLabel: TicketLabel
  64}
  65
  66private struct DeleteTrackerLabelResponse: Decodable, Sendable {
  67    let deleteLabel: TicketLabel
  68}
  69
  70private struct TrackerUserLookupResponse: Decodable, Sendable {
  71    let user: UserIdPayload?
  72}
  73
  74private struct UserIdPayload: Decodable, Sendable {
  75    let id: Int
  76}
  77
  78@Observable
  79@MainActor
  80final class TrackerManagementViewModel {
  81    private(set) var tracker: TrackerSummary
  82    private(set) var acls: [TrackerACL] = []
  83    private(set) var defaultACL = DefaultTrackerACL(
  84        browse: true,
  85        submit: true,
  86        comment: true,
  87        edit: false,
  88        triage: false
  89    )
  90    private(set) var labels: [TicketLabel] = []
  91
  92    private(set) var isSavingTracker = false
  93    private(set) var isDeletingTracker = false
  94    private(set) var isLoadingACLs = false
  95    private(set) var isSavingACL = false
  96    private(set) var isDeletingACL = false
  97    private(set) var isLoadingLabels = false
  98    private(set) var isSavingLabel = false
  99    private(set) var isDeletingLabel = false
 100
 101    var error: String?
 102    var didDeleteTracker = false
 103
 104    private let client: SRHTClient
 105
 106    init(tracker: TrackerSummary, client: SRHTClient) {
 107        self.tracker = tracker
 108        self.client = client
 109    }
 110
 111    private static let trackerQuery = """
 112    query tracker($rid: ID!) {
 113        tracker(rid: $rid) {
 114            id
 115            rid
 116            name
 117            description
 118            visibility
 119            updated
 120            owner { canonicalName }
 121        }
 122    }
 123    """
 124
 125    private static let trackerACLsQuery = """
 126    query trackerACLs($rid: ID!, $cursor: Cursor) {
 127        tracker(rid: $rid) {
 128            defaultACL {
 129                browse
 130                submit
 131                comment
 132                edit
 133                triage
 134            }
 135            acls(cursor: $cursor) {
 136                results {
 137                    id
 138                    created
 139                    entity { canonicalName }
 140                    browse
 141                    submit
 142                    comment
 143                    edit
 144                    triage
 145                }
 146                cursor
 147            }
 148        }
 149    }
 150    """
 151
 152    private static let trackerLabelsQuery = """
 153    query trackerLabels($rid: ID!, $cursor: Cursor) {
 154        tracker(rid: $rid) {
 155            labels(cursor: $cursor) {
 156                results {
 157                    id
 158                    name
 159                    backgroundColor
 160                    foregroundColor
 161                }
 162                cursor
 163            }
 164        }
 165    }
 166    """
 167
 168    private static let updateTrackerMutation = """
 169    mutation updateTracker($id: Int!, $input: TrackerInput!) {
 170        updateTracker(id: $id, input: $input) {
 171            id
 172            rid
 173            name
 174            description
 175            visibility
 176            updated
 177            owner { canonicalName }
 178        }
 179    }
 180    """
 181
 182    private static let deleteTrackerMutation = """
 183    mutation deleteTracker($id: Int!) {
 184        deleteTracker(id: $id) {
 185            id
 186        }
 187    }
 188    """
 189
 190    private static let updateUserACLMutation = """
 191    mutation updateUserACL($trackerId: Int!, $userId: Int!, $input: ACLInput!) {
 192        updateUserACL(trackerId: $trackerId, userId: $userId, input: $input) {
 193            id
 194            created
 195            entity { canonicalName }
 196            browse
 197            submit
 198            comment
 199            edit
 200            triage
 201        }
 202    }
 203    """
 204
 205    private static let updateTrackerACLMutation = """
 206    mutation updateTrackerACL($trackerId: Int!, $input: ACLInput!) {
 207        updateTrackerACL(trackerId: $trackerId, input: $input) {
 208            browse
 209            submit
 210            comment
 211            edit
 212            triage
 213        }
 214    }
 215    """
 216
 217    private static let deleteACLMutation = """
 218    mutation deleteACL($id: Int!) {
 219        deleteACL(id: $id) {
 220            id
 221            created
 222            entity { canonicalName }
 223            browse
 224            submit
 225            comment
 226            edit
 227            triage
 228        }
 229    }
 230    """
 231
 232    private static let createLabelMutation = """
 233    mutation createLabel($trackerId: Int!, $name: String!, $foregroundColor: String!, $backgroundColor: String!) {
 234        createLabel(trackerId: $trackerId, name: $name, foregroundColor: $foregroundColor, backgroundColor: $backgroundColor) {
 235            id
 236            name
 237            backgroundColor
 238            foregroundColor
 239        }
 240    }
 241    """
 242
 243    private static let updateLabelMutation = """
 244    mutation updateLabel($id: Int!, $input: UpdateLabelInput!) {
 245        updateLabel(id: $id, input: $input) {
 246            id
 247            name
 248            backgroundColor
 249            foregroundColor
 250        }
 251    }
 252    """
 253
 254    private static let deleteLabelMutation = """
 255    mutation deleteLabel($id: Int!) {
 256        deleteLabel(id: $id) {
 257            id
 258            name
 259            backgroundColor
 260            foregroundColor
 261        }
 262    }
 263    """
 264
 265    private static let userLookupQuery = """
 266    query userLookup($username: String!) {
 267        user(username: $username) {
 268            id
 269        }
 270    }
 271    """
 272
 273    func refreshTracker() async {
 274        do {
 275            let result = try await client.execute(
 276                service: .todo,
 277                query: Self.trackerQuery,
 278                variables: ["rid": tracker.rid],
 279                responseType: TrackerQueryResponse.self
 280            )
 281            if let tracker = result.tracker {
 282                self.tracker = tracker
 283            }
 284        } catch {
 285            self.error = error.userFacingMessage
 286        }
 287    }
 288
 289    func updateTracker(name: String, description: String, visibility: Visibility) async -> TrackerSummary? {
 290        guard !isSavingTracker else { return nil }
 291        let trimmedName = name.trimmingCharacters(in: .whitespacesAndNewlines)
 292        guard !trimmedName.isEmpty else {
 293            error = "Enter a tracker name."
 294            return nil
 295        }
 296
 297        isSavingTracker = true
 298        error = nil
 299        defer { isSavingTracker = false }
 300
 301        var input: [String: any Sendable] = [
 302            "name": trimmedName,
 303            "visibility": visibility.rawValue
 304        ]
 305        let trimmedDescription = description.trimmingCharacters(in: .whitespacesAndNewlines)
 306        input["description"] = trimmedDescription.isEmpty ? "" : trimmedDescription
 307
 308        do {
 309            let result = try await client.execute(
 310                service: .todo,
 311                query: Self.updateTrackerMutation,
 312                variables: [
 313                    "id": tracker.id,
 314                    "input": input
 315                ],
 316                responseType: UpdateTrackerResponse.self
 317            )
 318            tracker = result.updateTracker
 319            return result.updateTracker
 320        } catch {
 321            self.error = "Couldn’t update the tracker. \(error.userFacingMessage)"
 322            return nil
 323        }
 324    }
 325
 326    func deleteTracker() async -> Bool {
 327        guard !isDeletingTracker else { return false }
 328        isDeletingTracker = true
 329        error = nil
 330        defer { isDeletingTracker = false }
 331
 332        do {
 333            _ = try await client.execute(
 334                service: .todo,
 335                query: Self.deleteTrackerMutation,
 336                variables: ["id": tracker.id],
 337                responseType: DeleteTrackerResponse.self
 338            )
 339            didDeleteTracker = true
 340            return true
 341        } catch {
 342            self.error = "Couldn’t delete the tracker. \(error.userFacingMessage)"
 343            return false
 344        }
 345    }
 346
 347    func loadACLs() async {
 348        guard !isLoadingACLs else { return }
 349        isLoadingACLs = true
 350        error = nil
 351        defer { isLoadingACLs = false }
 352
 353        do {
 354            let result = try await client.execute(
 355                service: .todo,
 356                query: Self.trackerACLsQuery,
 357                variables: ["rid": tracker.rid],
 358                responseType: TrackerACLQueryResponse.self
 359            )
 360            defaultACL = result.tracker?.defaultACL ?? defaultACL
 361            acls = result.tracker?.acls.results ?? []
 362        } catch {
 363            self.error = error.userFacingMessage
 364        }
 365    }
 366
 367    func updateDefaultACL(_ permissions: TrackerACLPermissions) async -> Bool {
 368        guard !isSavingACL else { return false }
 369        isSavingACL = true
 370        error = nil
 371        defer { isSavingACL = false }
 372
 373        do {
 374            let result = try await client.execute(
 375                service: .todo,
 376                query: Self.updateTrackerACLMutation,
 377                variables: [
 378                    "trackerId": tracker.id,
 379                    "input": permissions.graphQLInput
 380                ],
 381                responseType: UpdateTrackerACLResponse.self
 382            )
 383            defaultACL = result.updateTrackerACL
 384            await loadACLs()
 385            return true
 386        } catch {
 387            self.error = error.userFacingMessage
 388            return false
 389        }
 390    }
 391
 392    func addOrUpdateACL(username: String, permissions: TrackerACLPermissions) async -> Bool {
 393        guard !isSavingACL else { return false }
 394        let normalizedUsername = Self.normalizedUsername(username)
 395        guard !normalizedUsername.isEmpty else {
 396            error = "Enter a SourceHut username."
 397            return false
 398        }
 399
 400        isSavingACL = true
 401        error = nil
 402        defer { isSavingACL = false }
 403
 404        do {
 405            let userResult = try await client.execute(
 406                service: .todo,
 407                query: Self.userLookupQuery,
 408                variables: ["username": normalizedUsername],
 409                responseType: TrackerUserLookupResponse.self
 410            )
 411            guard let userId = userResult.user?.id else {
 412                error = "That user couldn’t be found."
 413                return false
 414            }
 415
 416            let result = try await client.execute(
 417                service: .todo,
 418                query: Self.updateUserACLMutation,
 419                variables: [
 420                    "trackerId": tracker.id,
 421                    "userId": userId,
 422                    "input": permissions.graphQLInput
 423                ],
 424                responseType: UpdateUserACLResponse.self
 425            )
 426            if let index = acls.firstIndex(where: { $0.id == result.updateUserACL.id }) {
 427                acls[index] = result.updateUserACL
 428            } else {
 429                acls.append(result.updateUserACL)
 430                acls.sort { $0.entity.canonicalName.localizedCaseInsensitiveCompare($1.entity.canonicalName) == .orderedAscending }
 431            }
 432            await loadACLs()
 433            return true
 434        } catch {
 435            self.error = error.userFacingMessage
 436            return false
 437        }
 438    }
 439
 440    func deleteACL(_ entry: TrackerACL) async {
 441        guard !isDeletingACL else { return }
 442        isDeletingACL = true
 443        error = nil
 444        defer { isDeletingACL = false }
 445
 446        do {
 447            _ = try await client.execute(
 448                service: .todo,
 449                query: Self.deleteACLMutation,
 450                variables: ["id": entry.id],
 451                responseType: DeleteTrackerACLResponse.self
 452            )
 453            acls.removeAll { $0.id == entry.id }
 454            await loadACLs()
 455        } catch {
 456            self.error = error.userFacingMessage
 457        }
 458    }
 459
 460    func loadLabels() async {
 461        guard !isLoadingLabels else { return }
 462        isLoadingLabels = true
 463        error = nil
 464        defer { isLoadingLabels = false }
 465
 466        do {
 467            let result = try await client.execute(
 468                service: .todo,
 469                query: Self.trackerLabelsQuery,
 470                variables: ["rid": tracker.rid],
 471                responseType: TrackerLabelQueryResponse.self
 472            )
 473            labels = result.tracker?.labels.results ?? []
 474        } catch {
 475            self.error = error.userFacingMessage
 476        }
 477    }
 478
 479    func createLabel(name: String, foregroundColor: String, backgroundColor: String) async -> Bool {
 480        guard !isSavingLabel else { return false }
 481        let trimmedName = name.trimmingCharacters(in: .whitespacesAndNewlines)
 482        guard !trimmedName.isEmpty else {
 483            error = "Enter a label name."
 484            return false
 485        }
 486        guard Self.isValidHexColor(foregroundColor), Self.isValidHexColor(backgroundColor) else {
 487            error = "Label colors must use #RRGGBB format."
 488            return false
 489        }
 490
 491        isSavingLabel = true
 492        error = nil
 493        defer { isSavingLabel = false }
 494
 495        do {
 496            _ = try await client.execute(
 497                service: .todo,
 498                query: Self.createLabelMutation,
 499                variables: [
 500                    "trackerId": tracker.id,
 501                    "name": trimmedName,
 502                    "foregroundColor": foregroundColor,
 503                    "backgroundColor": backgroundColor
 504                ],
 505                responseType: CreateTrackerLabelResponse.self
 506            )
 507            await loadLabels()
 508            return true
 509        } catch {
 510            self.error = error.userFacingMessage
 511            return false
 512        }
 513    }
 514
 515    func updateLabel(
 516        _ label: TicketLabel,
 517        name: String,
 518        foregroundColor: String,
 519        backgroundColor: String
 520    ) async -> Bool {
 521        guard !isSavingLabel else { return false }
 522        let trimmedName = name.trimmingCharacters(in: .whitespacesAndNewlines)
 523        guard !trimmedName.isEmpty else {
 524            error = "Enter a label name."
 525            return false
 526        }
 527        guard Self.isValidHexColor(foregroundColor), Self.isValidHexColor(backgroundColor) else {
 528            error = "Label colors must use #RRGGBB format."
 529            return false
 530        }
 531
 532        isSavingLabel = true
 533        error = nil
 534        defer { isSavingLabel = false }
 535
 536        var input: [String: any Sendable] = [:]
 537        if trimmedName != label.name {
 538            input["name"] = trimmedName
 539        }
 540        if foregroundColor.caseInsensitiveCompare(label.foregroundColor) != .orderedSame {
 541            input["foregroundColor"] = foregroundColor
 542        }
 543        if backgroundColor.caseInsensitiveCompare(label.backgroundColor) != .orderedSame {
 544            input["backgroundColor"] = backgroundColor
 545        }
 546
 547        guard !input.isEmpty else { return true }
 548
 549        do {
 550            _ = try await client.execute(
 551                service: .todo,
 552                query: Self.updateLabelMutation,
 553                variables: [
 554                    "id": label.id,
 555                    "input": input
 556                ],
 557                responseType: UpdateTrackerLabelResponse.self
 558            )
 559            await loadLabels()
 560            return true
 561        } catch {
 562            self.error = error.userFacingMessage
 563            return false
 564        }
 565    }
 566
 567    func deleteLabel(_ label: TicketLabel) async {
 568        guard !isDeletingLabel else { return }
 569        isDeletingLabel = true
 570        error = nil
 571        defer { isDeletingLabel = false }
 572
 573        do {
 574            _ = try await client.execute(
 575                service: .todo,
 576                query: Self.deleteLabelMutation,
 577                variables: ["id": label.id],
 578                responseType: DeleteTrackerLabelResponse.self
 579            )
 580            labels.removeAll { $0.id == label.id }
 581            await loadLabels()
 582        } catch {
 583            self.error = error.userFacingMessage
 584        }
 585    }
 586
 587    static func normalizedUsername(_ value: String) -> String {
 588        let trimmed = value.trimmingCharacters(in: .whitespacesAndNewlines)
 589        guard !trimmed.isEmpty else { return "" }
 590        return trimmed.hasPrefix("~") ? String(trimmed.dropFirst()) : trimmed
 591    }
 592
 593    static func isValidHexColor(_ value: String) -> Bool {
 594        let trimmed = value.trimmingCharacters(in: .whitespacesAndNewlines)
 595        guard trimmed.count == 7, trimmed.first == "#" else { return false }
 596        return trimmed.dropFirst().allSatisfy { $0.isHexDigit }
 597    }
 598}
 599
 600private extension TrackerACLPermissions {
 601    var graphQLInput: [String: any Sendable] {
 602        [
 603            "browse": browse,
 604            "submit": submit,
 605            "comment": comment,
 606            "edit": edit,
 607            "triage": triage
 608        ]
 609    }
 610}
 611
 612struct TrackerEditorSheet: View {
 613    let title: String
 614    let confirmationTitle: String
 615    let isSaving: Bool
 616    let error: String?
 617    let initialName: String
 618    let initialDescription: String
 619    let initialVisibility: Visibility
 620    let onSave: (String, String, Visibility) async -> Bool
 621
 622    @Environment(\.dismiss) private var dismiss
 623    @State private var name: String
 624    @State private var description: String
 625    @State private var visibility: Visibility
 626
 627    init(
 628        title: String,
 629        confirmationTitle: String,
 630        isSaving: Bool,
 631        error: String?,
 632        initialName: String,
 633        initialDescription: String,
 634        initialVisibility: Visibility,
 635        onSave: @escaping (String, String, Visibility) async -> Bool
 636    ) {
 637        self.title = title
 638        self.confirmationTitle = confirmationTitle
 639        self.isSaving = isSaving
 640        self.error = error
 641        self.initialName = initialName
 642        self.initialDescription = initialDescription
 643        self.initialVisibility = initialVisibility
 644        self.onSave = onSave
 645        _name = State(initialValue: initialName)
 646        _description = State(initialValue: initialDescription)
 647        _visibility = State(initialValue: initialVisibility)
 648    }
 649
 650    var body: some View {
 651        NavigationStack {
 652            Form {
 653                Section("Tracker Details") {
 654                    TextField("Tracker name", text: $name)
 655                        .textInputAutocapitalization(.never)
 656                        .autocorrectionDisabled()
 657                        .themedRow()
 658                    TextField("Short description (optional)", text: $description, axis: .vertical)
 659                        .lineLimit(2...4)
 660                        .themedRow()
 661                    Picker("Visibility", selection: $visibility) {
 662                        Text("Public").tag(Visibility.publicVisibility)
 663                        Text("Unlisted").tag(Visibility.unlisted)
 664                        Text("Private").tag(Visibility.privateVisibility)
 665                    }
 666                    .themedRow()
 667                }
 668
 669                if let error, !error.isEmpty {
 670                    Section {
 671                        Text(error)
 672                            .foregroundStyle(.red)
 673                            .themedRow()
 674                    }
 675                }
 676            }
 677            .themedList()
 678            .navigationTitle(title)
 679            .navigationBarTitleDisplayMode(.inline)
 680            .toolbar {
 681                ToolbarItem(placement: .cancellationAction) {
 682                    Button("Cancel") { dismiss() }
 683                }
 684                ToolbarItem(placement: .confirmationAction) {
 685                    Button {
 686                        Task {
 687                            let didSave = await onSave(name, description, visibility)
 688                            if didSave {
 689                                dismiss()
 690                            }
 691                        }
 692                    } label: {
 693                        if isSaving {
 694                            ProgressView()
 695                                .controlSize(.small)
 696                        } else {
 697                            Text(confirmationTitle)
 698                        }
 699                    }
 700                    .disabled(name.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty || isSaving)
 701                }
 702            }
 703        }
 704    }
 705}
 706
 707struct TrackerACLManagementSheet: View {
 708    let viewModel: TrackerManagementViewModel
 709
 710    @Bindable private var bindableViewModel: TrackerManagementViewModel
 711    @State private var editingACL: TrackerACL?
 712    @State private var editingDefaultACL = false
 713    @State private var pendingDeletion: TrackerACL?
 714    @State private var showCreateACL = false
 715
 716    init(viewModel: TrackerManagementViewModel) {
 717        self.viewModel = viewModel
 718        self._bindableViewModel = Bindable(viewModel)
 719    }
 720
 721    var body: some View {
 722        NavigationStack {
 723            List {
 724                Section("Default Access") {
 725                    TrackerPermissionSummary(permissions: viewModel.defaultACL.permissions)
 726                        .themedRow()
 727                    Button("Update Default ACL") {
 728                        editingDefaultACL = true
 729                    }
 730                    .disabled(viewModel.isSavingACL)
 731                    .themedRow()
 732                }
 733
 734                Section {
 735                    if viewModel.isLoadingACLs {
 736                        HStack {
 737                            Spacer()
 738                            ProgressView()
 739                            Spacer()
 740                        }
 741                        .themedRow()
 742                    } else if viewModel.acls.isEmpty {
 743                        Text("No tracker-specific ACLs yet.")
 744                            .foregroundStyle(.secondary)
 745                            .themedRow()
 746                    } else {
 747                        ForEach(viewModel.acls) { entry in
 748                            VStack(alignment: .leading, spacing: 6) {
 749                                Text(entry.entity.canonicalName)
 750                                    .font(.subheadline.weight(.medium))
 751                                TrackerPermissionSummary(permissions: entry.permissions)
 752                            }
 753                            .swipeActions(edge: .trailing, allowsFullSwipe: false) {
 754                                Button {
 755                                    pendingDeletion = entry
 756                                } label: {
 757                                    Label("Delete", systemImage: "trash")
 758                                }
 759                                .tint(.red)
 760
 761                                Button {
 762                                    editingACL = entry
 763                                } label: {
 764                                    Label("Edit", systemImage: "pencil")
 765                                }
 766                                .tint(.blue)
 767                            }
 768                        }
 769                        .themedRow()
 770                    }
 771                } header: {
 772                    Text("User ACLs")
 773                } footer: {
 774                    Text("Each ACL must include all five permission flags.")
 775                }
 776            }
 777            .themedList()
 778            .navigationTitle("ACLs")
 779            .navigationBarTitleDisplayMode(.inline)
 780            .toolbar {
 781                ToolbarItem(placement: .topBarTrailing) {
 782                    Button {
 783                        showCreateACL = true
 784                    } label: {
 785                        Image(systemName: "plus")
 786                    }
 787                    .disabled(viewModel.isSavingACL)
 788                }
 789            }
 790            .task {
 791                await viewModel.loadACLs()
 792            }
 793            .srhtErrorBanner(error: $bindableViewModel.error)
 794            .sheet(isPresented: $showCreateACL) {
 795                TrackerACLEditorSheet(
 796                    title: "Add ACL",
 797                    submitTitle: "Save",
 798                    isSaving: viewModel.isSavingACL,
 799                    error: viewModel.error,
 800                    initialUsername: "",
 801                    initialPermissions: viewModel.defaultACL.permissions
 802                ) { username, permissions in
 803                    await viewModel.addOrUpdateACL(username: username, permissions: permissions)
 804                }
 805            }
 806            .sheet(item: $editingACL) { entry in
 807                TrackerACLEditorSheet(
 808                    title: "Update ACL",
 809                    submitTitle: "Save",
 810                    isSaving: viewModel.isSavingACL,
 811                    error: viewModel.error,
 812                    initialUsername: entry.entity.canonicalName,
 813                    initialPermissions: entry.permissions
 814                ) { username, permissions in
 815                    await viewModel.addOrUpdateACL(username: username, permissions: permissions)
 816                }
 817            }
 818            .sheet(isPresented: $editingDefaultACL) {
 819                TrackerDefaultACLEditorSheet(
 820                    isSaving: viewModel.isSavingACL,
 821                    error: viewModel.error,
 822                    initialPermissions: viewModel.defaultACL.permissions
 823                ) { permissions in
 824                    await viewModel.updateDefaultACL(permissions)
 825                }
 826            }
 827            .alert("Remove Access?", isPresented: Binding(
 828                get: { pendingDeletion != nil },
 829                set: { isPresented in
 830                    if !isPresented {
 831                        pendingDeletion = nil
 832                    }
 833                }
 834            )) {
 835                Button("Cancel", role: .cancel) {
 836                    // no-op: .cancel role handles alert dismissal
 837                }
 838                Button("Delete", role: .destructive) {
 839                    guard let pendingDeletion else { return }
 840                    Task {
 841                        await viewModel.deleteACL(pendingDeletion)
 842                        self.pendingDeletion = nil
 843                    }
 844                }
 845            } message: {
 846                if let pendingDeletion {
 847                    Text("\(pendingDeletion.entity.canonicalName) will fall back to the tracker default ACL.")
 848                }
 849            }
 850        }
 851    }
 852}
 853
 854private struct TrackerPermissionSummary: View {
 855    let permissions: TrackerACLPermissions
 856
 857    var body: some View {
 858        Text(summary)
 859            .font(.caption)
 860            .foregroundStyle(.secondary)
 861    }
 862
 863    private var summary: String {
 864        let items = [
 865            permissions.browse ? "browse" : nil,
 866            permissions.submit ? "submit" : nil,
 867            permissions.comment ? "comment" : nil,
 868            permissions.edit ? "edit" : nil,
 869            permissions.triage ? "triage" : nil
 870        ].compactMap { $0 }
 871        return items.isEmpty ? "No permissions" : items.joined(separator: ", ")
 872    }
 873}
 874
 875private struct TrackerACLEditorSheet: View {
 876    let title: String
 877    let submitTitle: String
 878    let isSaving: Bool
 879    let error: String?
 880    let initialUsername: String
 881    let initialPermissions: TrackerACLPermissions
 882    let onSave: (String, TrackerACLPermissions) async -> Bool
 883
 884    @Environment(\.dismiss) private var dismiss
 885    @State private var username: String
 886    @State private var browse: Bool
 887    @State private var submit: Bool
 888    @State private var comment: Bool
 889    @State private var edit: Bool
 890    @State private var triage: Bool
 891
 892    init(
 893        title: String,
 894        submitTitle: String,
 895        isSaving: Bool,
 896        error: String?,
 897        initialUsername: String,
 898        initialPermissions: TrackerACLPermissions,
 899        onSave: @escaping (String, TrackerACLPermissions) async -> Bool
 900    ) {
 901        self.title = title
 902        self.submitTitle = submitTitle
 903        self.isSaving = isSaving
 904        self.error = error
 905        self.initialUsername = initialUsername
 906        self.initialPermissions = initialPermissions
 907        self.onSave = onSave
 908        _username = State(initialValue: initialUsername)
 909        _browse = State(initialValue: initialPermissions.browse)
 910        _submit = State(initialValue: initialPermissions.submit)
 911        _comment = State(initialValue: initialPermissions.comment)
 912        _edit = State(initialValue: initialPermissions.edit)
 913        _triage = State(initialValue: initialPermissions.triage)
 914    }
 915
 916    var body: some View {
 917        NavigationStack {
 918            Form {
 919                Section("User") {
 920                    TextField("Username or ~username", text: $username)
 921                        .autocorrectionDisabled()
 922                        .textInputAutocapitalization(.never)
 923                        .themedRow()
 924                }
 925
 926                permissionSection
 927
 928                if let error, !error.isEmpty {
 929                    Section {
 930                        Text(error)
 931                            .foregroundStyle(.red)
 932                            .themedRow()
 933                    }
 934                }
 935            }
 936            .themedList()
 937            .navigationTitle(title)
 938            .navigationBarTitleDisplayMode(.inline)
 939            .toolbar {
 940                ToolbarItem(placement: .cancellationAction) {
 941                    Button("Cancel") { dismiss() }
 942                }
 943                ToolbarItem(placement: .confirmationAction) {
 944                    Button {
 945                        Task {
 946                            let didSave = await onSave(username, permissions)
 947                            if didSave {
 948                                dismiss()
 949                            }
 950                        }
 951                    } label: {
 952                        if isSaving {
 953                            ProgressView()
 954                                .controlSize(.small)
 955                        } else {
 956                            Text(submitTitle)
 957                        }
 958                    }
 959                    .disabled(username.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty || isSaving)
 960                }
 961            }
 962        }
 963    }
 964
 965    private var permissionSection: some View {
 966        Section("Permissions") {
 967            Toggle("Browse", isOn: $browse)
 968                .themedRow()
 969            Toggle("Submit", isOn: $submit)
 970                .themedRow()
 971            Toggle("Comment", isOn: $comment)
 972                .themedRow()
 973            Toggle("Edit", isOn: $edit)
 974                .themedRow()
 975            Toggle("Triage", isOn: $triage)
 976                .themedRow()
 977        }
 978    }
 979
 980    private var permissions: TrackerACLPermissions {
 981        TrackerACLPermissions(
 982            browse: browse,
 983            submit: submit,
 984            comment: comment,
 985            edit: edit,
 986            triage: triage
 987        )
 988    }
 989}
 990
 991private struct TrackerDefaultACLEditorSheet: View {
 992    let isSaving: Bool
 993    let error: String?
 994    let initialPermissions: TrackerACLPermissions
 995    let onSave: (TrackerACLPermissions) async -> Bool
 996
 997    @Environment(\.dismiss) private var dismiss
 998    @State private var browse: Bool
 999    @State private var submit: Bool
1000    @State private var comment: Bool
1001    @State private var edit: Bool
1002    @State private var triage: Bool
1003
1004    init(
1005        isSaving: Bool,
1006        error: String?,
1007        initialPermissions: TrackerACLPermissions,
1008        onSave: @escaping (TrackerACLPermissions) async -> Bool
1009    ) {
1010        self.isSaving = isSaving
1011        self.error = error
1012        self.initialPermissions = initialPermissions
1013        self.onSave = onSave
1014        _browse = State(initialValue: initialPermissions.browse)
1015        _submit = State(initialValue: initialPermissions.submit)
1016        _comment = State(initialValue: initialPermissions.comment)
1017        _edit = State(initialValue: initialPermissions.edit)
1018        _triage = State(initialValue: initialPermissions.triage)
1019    }
1020
1021    var body: some View {
1022        NavigationStack {
1023            Form {
1024                Section("Permissions") {
1025                    Toggle("Browse", isOn: $browse)
1026                        .themedRow()
1027                    Toggle("Submit", isOn: $submit)
1028                        .themedRow()
1029                    Toggle("Comment", isOn: $comment)
1030                        .themedRow()
1031                    Toggle("Edit", isOn: $edit)
1032                        .themedRow()
1033                    Toggle("Triage", isOn: $triage)
1034                        .themedRow()
1035                }
1036
1037                if let error, !error.isEmpty {
1038                    Section {
1039                        Text(error)
1040                            .foregroundStyle(.red)
1041                            .themedRow()
1042                    }
1043                }
1044            }
1045            .themedList()
1046            .navigationTitle("Default ACL")
1047            .navigationBarTitleDisplayMode(.inline)
1048            .toolbar {
1049                ToolbarItem(placement: .cancellationAction) {
1050                    Button("Cancel") { dismiss() }
1051                }
1052                ToolbarItem(placement: .confirmationAction) {
1053                    Button {
1054                        Task {
1055                            let didSave = await onSave(
1056                                TrackerACLPermissions(
1057                                    browse: browse,
1058                                    submit: submit,
1059                                    comment: comment,
1060                                    edit: edit,
1061                                    triage: triage
1062                                )
1063                            )
1064                            if didSave {
1065                                dismiss()
1066                            }
1067                        }
1068                    } label: {
1069                        if isSaving {
1070                            ProgressView()
1071                                .controlSize(.small)
1072                        } else {
1073                            Text("Save")
1074                        }
1075                    }
1076                    .disabled(isSaving)
1077                }
1078            }
1079        }
1080    }
1081}
1082
1083struct TrackerLabelManagementSheet: View {
1084    let viewModel: TrackerManagementViewModel
1085
1086    @Bindable private var bindableViewModel: TrackerManagementViewModel
1087    @State private var showCreateLabel = false
1088    @State private var editingLabel: TicketLabel?
1089    @State private var pendingDeletion: TicketLabel?
1090
1091    init(viewModel: TrackerManagementViewModel) {
1092        self.viewModel = viewModel
1093        self._bindableViewModel = Bindable(viewModel)
1094    }
1095
1096    var body: some View {
1097        NavigationStack {
1098            List {
1099                Section {
1100                    Text("Labels are managed here and reused throughout the tracker.")
1101                        .font(.footnote)
1102                        .foregroundStyle(.secondary)
1103                        .themedRow()
1104                }
1105
1106                if viewModel.isLoadingLabels {
1107                    HStack {
1108                        Spacer()
1109                        ProgressView()
1110                        Spacer()
1111                    }
1112                    .themedRow()
1113                } else if viewModel.labels.isEmpty {
1114                    ContentUnavailableView(
1115                        "No Labels",
1116                        systemImage: "tag",
1117                        description: Text("Create labels for triage and organization.")
1118                    )
1119                    .themedRow()
1120                } else {
1121                    ForEach(viewModel.labels) { label in
1122                        Button {
1123                            editingLabel = label
1124                        } label: {
1125                            TrackerLabelManagementRow(label: label)
1126                        }
1127                        .buttonStyle(.plain)
1128                        .swipeActions(edge: .trailing, allowsFullSwipe: false) {
1129                            Button {
1130                                editingLabel = label
1131                            } label: {
1132                                Label("Edit", systemImage: "pencil")
1133                            }
1134                            .tint(.blue)
1135
1136                            Button {
1137                                pendingDeletion = label
1138                            } label: {
1139                                Label("Delete", systemImage: "trash")
1140                            }
1141                            .tint(.red)
1142                        }
1143                    }
1144                    .themedRow()
1145                }
1146            }
1147            .themedList()
1148            .navigationTitle("Labels")
1149            .navigationBarTitleDisplayMode(.inline)
1150            .toolbar {
1151                ToolbarItem(placement: .topBarTrailing) {
1152                    Button {
1153                        showCreateLabel = true
1154                    } label: {
1155                        Image(systemName: "plus")
1156                    }
1157                    .disabled(viewModel.isSavingLabel)
1158                }
1159            }
1160            .task {
1161                await viewModel.loadLabels()
1162            }
1163            .srhtErrorBanner(error: $bindableViewModel.error)
1164            .sheet(isPresented: $showCreateLabel) {
1165                TrackerLabelEditorSheet(
1166                    title: "New Label",
1167                    submitTitle: "Create",
1168                    isSaving: viewModel.isSavingLabel,
1169                    error: viewModel.error,
1170                    initialLabel: nil
1171                ) { name, foreground, background in
1172                    await viewModel.createLabel(
1173                        name: name,
1174                        foregroundColor: foreground,
1175                        backgroundColor: background
1176                    )
1177                }
1178            }
1179            .sheet(item: $editingLabel) { label in
1180                TrackerLabelEditorSheet(
1181                    title: "Update Label",
1182                    submitTitle: "Save",
1183                    isSaving: viewModel.isSavingLabel,
1184                    error: viewModel.error,
1185                    initialLabel: label
1186                ) { name, foreground, background in
1187                    await viewModel.updateLabel(
1188                        label,
1189                        name: name,
1190                        foregroundColor: foreground,
1191                        backgroundColor: background
1192                    )
1193                }
1194            }
1195            .alert("Delete Label?", isPresented: Binding(
1196                get: { pendingDeletion != nil },
1197                set: { isPresented in
1198                    if !isPresented {
1199                        pendingDeletion = nil
1200                    }
1201                }
1202            )) {
1203                Button("Cancel", role: .cancel) {
1204                    // no-op: .cancel role handles alert dismissal
1205                }
1206                Button("Delete", role: .destructive) {
1207                    guard let pendingDeletion else { return }
1208                    Task {
1209                        await viewModel.deleteLabel(pendingDeletion)
1210                        self.pendingDeletion = nil
1211                    }
1212                }
1213            } message: {
1214                if let pendingDeletion {
1215                    Text("\(pendingDeletion.name)” will be removed from this tracker and from any tickets using it.")
1216                }
1217            }
1218        }
1219    }
1220}
1221
1222private struct TrackerLabelManagementRow: View {
1223    let label: TicketLabel
1224
1225    var body: some View {
1226        VStack(alignment: .leading, spacing: 8) {
1227            HStack(alignment: .top, spacing: 12) {
1228                LabelPill(label: label)
1229                Spacer()
1230                Image(systemName: "chevron.right")
1231                    .font(.caption.weight(.semibold))
1232                    .foregroundStyle(.tertiary)
1233            }
1234
1235            HStack(spacing: 12) {
1236                colorSwatch(hex: label.backgroundColor, title: "Background")
1237                colorSwatch(hex: label.foregroundColor, title: "Text")
1238            }
1239        }
1240        .padding(.vertical, 4)
1241    }
1242
1243    private func colorSwatch(hex: String, title: String) -> some View {
1244        HStack(spacing: 6) {
1245            Circle()
1246                .fill(Color(hex: hex) ?? .clear)
1247                .frame(width: 10, height: 10)
1248                .overlay {
1249                    Circle()
1250                        .stroke(Color.secondary.opacity(0.2), lineWidth: 1)
1251                }
1252
1253            Text("\(title): \(hex.uppercased())")
1254                .font(.caption)
1255                .foregroundStyle(.secondary)
1256        }
1257    }
1258}
1259
1260private struct TrackerLabelEditorSheet: View {
1261    let title: String
1262    let submitTitle: String
1263    let isSaving: Bool
1264    let error: String?
1265    let initialLabel: TicketLabel?
1266    let onSave: (String, String, String) async -> Bool
1267
1268    @Environment(\.dismiss) private var dismiss
1269    @State private var name: String
1270    @State private var foregroundColor: Color
1271    @State private var backgroundColor: Color
1272
1273    init(
1274        title: String,
1275        submitTitle: String,
1276        isSaving: Bool,
1277        error: String?,
1278        initialLabel: TicketLabel?,
1279        onSave: @escaping (String, String, String) async -> Bool
1280    ) {
1281        self.title = title
1282        self.submitTitle = submitTitle
1283        self.isSaving = isSaving
1284        self.error = error
1285        self.initialLabel = initialLabel
1286        self.onSave = onSave
1287        _name = State(initialValue: initialLabel?.name ?? "")
1288        _foregroundColor = State(initialValue: Color(hex: initialLabel?.foregroundColor ?? "#ffffff") ?? .white)
1289        _backgroundColor = State(initialValue: Color(hex: initialLabel?.backgroundColor ?? "#000000") ?? .black)
1290    }
1291
1292    var body: some View {
1293        NavigationStack {
1294            Form {
1295                Section("Details") {
1296                    TextField("Label name", text: $name)
1297                        .themedRow()
1298                    ColorPicker("Foreground", selection: $foregroundColor, supportsOpacity: false)
1299                        .themedRow()
1300                    ColorPicker("Background", selection: $backgroundColor, supportsOpacity: false)
1301                        .themedRow()
1302                }
1303
1304                Section("Preview") {
1305                    LabelPill(
1306                        label: TicketLabel(
1307                            id: initialLabel?.id ?? -1,
1308                            name: name.isEmpty ? "Preview" : name,
1309                            backgroundColor: backgroundColor.hexString,
1310                            foregroundColor: foregroundColor.hexString
1311                        )
1312                    )
1313                    .themedRow()
1314                }
1315
1316                if let error, !error.isEmpty {
1317                    Section {
1318                        Text(error)
1319                            .foregroundStyle(.red)
1320                            .themedRow()
1321                    }
1322                }
1323            }
1324            .themedList()
1325            .navigationTitle(title)
1326            .navigationBarTitleDisplayMode(.inline)
1327            .toolbar {
1328                ToolbarItem(placement: .cancellationAction) {
1329                    Button("Cancel") { dismiss() }
1330                }
1331                ToolbarItem(placement: .confirmationAction) {
1332                    Button {
1333                        Task {
1334                            let didSave = await onSave(
1335                                name,
1336                                foregroundColor.hexString,
1337                                backgroundColor.hexString
1338                            )
1339                            if didSave {
1340                                dismiss()
1341                            }
1342                        }
1343                    } label: {
1344                        if isSaving {
1345                            ProgressView()
1346                                .controlSize(.small)
1347                        } else {
1348                            Text(submitTitle)
1349                        }
1350                    }
1351                    .disabled(name.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty || isSaving)
1352                }
1353            }
1354        }
1355    }
1356}