krz/hutch

an ios client for sourcehut

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

v3.5.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(role: .destructive) {
 755                                    pendingDeletion = entry
 756                                } label: {
 757                                    Label("Delete", systemImage: "trash")
 758                                }
 759
 760                                Button {
 761                                    editingACL = entry
 762                                } label: {
 763                                    Label("Edit", systemImage: "pencil")
 764                                }
 765                                .tint(.blue)
 766                            }
 767                        }
 768                        .themedRow()
 769                    }
 770                } header: {
 771                    Text("User ACLs")
 772                } footer: {
 773                    Text("Each ACL must include all five permission flags.")
 774                }
 775            }
 776            .themedList()
 777            .navigationTitle("ACLs")
 778            .navigationBarTitleDisplayMode(.inline)
 779            .toolbar {
 780                ToolbarItem(placement: .topBarTrailing) {
 781                    Button {
 782                        showCreateACL = true
 783                    } label: {
 784                        Image(systemName: "plus")
 785                    }
 786                    .disabled(viewModel.isSavingACL)
 787                }
 788            }
 789            .task {
 790                await viewModel.loadACLs()
 791            }
 792            .srhtErrorBanner(error: $bindableViewModel.error)
 793            .sheet(isPresented: $showCreateACL) {
 794                TrackerACLEditorSheet(
 795                    title: "Add ACL",
 796                    submitTitle: "Save",
 797                    isSaving: viewModel.isSavingACL,
 798                    error: viewModel.error,
 799                    initialUsername: "",
 800                    initialPermissions: viewModel.defaultACL.permissions
 801                ) { username, permissions in
 802                    await viewModel.addOrUpdateACL(username: username, permissions: permissions)
 803                }
 804            }
 805            .sheet(item: $editingACL) { entry in
 806                TrackerACLEditorSheet(
 807                    title: "Update ACL",
 808                    submitTitle: "Save",
 809                    isSaving: viewModel.isSavingACL,
 810                    error: viewModel.error,
 811                    initialUsername: entry.entity.canonicalName,
 812                    initialPermissions: entry.permissions
 813                ) { username, permissions in
 814                    await viewModel.addOrUpdateACL(username: username, permissions: permissions)
 815                }
 816            }
 817            .sheet(isPresented: $editingDefaultACL) {
 818                TrackerDefaultACLEditorSheet(
 819                    isSaving: viewModel.isSavingACL,
 820                    error: viewModel.error,
 821                    initialPermissions: viewModel.defaultACL.permissions
 822                ) { permissions in
 823                    await viewModel.updateDefaultACL(permissions)
 824                }
 825            }
 826            .alert("Remove Access?", isPresented: Binding(
 827                get: { pendingDeletion != nil },
 828                set: { isPresented in
 829                    if !isPresented {
 830                        pendingDeletion = nil
 831                    }
 832                }
 833            )) {
 834                Button("Cancel", role: .cancel) {
 835                    // no-op: .cancel role handles alert dismissal
 836                }
 837                Button("Delete", role: .destructive) {
 838                    guard let pendingDeletion else { return }
 839                    Task {
 840                        await viewModel.deleteACL(pendingDeletion)
 841                        self.pendingDeletion = nil
 842                    }
 843                }
 844            } message: {
 845                if let pendingDeletion {
 846                    Text("\(pendingDeletion.entity.canonicalName) will fall back to the tracker default ACL.")
 847                }
 848            }
 849        }
 850    }
 851}
 852
 853private struct TrackerPermissionSummary: View {
 854    let permissions: TrackerACLPermissions
 855
 856    var body: some View {
 857        Text(summary)
 858            .font(.caption)
 859            .foregroundStyle(.secondary)
 860    }
 861
 862    private var summary: String {
 863        let items = [
 864            permissions.browse ? "browse" : nil,
 865            permissions.submit ? "submit" : nil,
 866            permissions.comment ? "comment" : nil,
 867            permissions.edit ? "edit" : nil,
 868            permissions.triage ? "triage" : nil
 869        ].compactMap { $0 }
 870        return items.isEmpty ? "No permissions" : items.joined(separator: ", ")
 871    }
 872}
 873
 874private struct TrackerACLEditorSheet: View {
 875    let title: String
 876    let submitTitle: String
 877    let isSaving: Bool
 878    let error: String?
 879    let initialUsername: String
 880    let initialPermissions: TrackerACLPermissions
 881    let onSave: (String, TrackerACLPermissions) async -> Bool
 882
 883    @Environment(\.dismiss) private var dismiss
 884    @State private var username: String
 885    @State private var browse: Bool
 886    @State private var submit: Bool
 887    @State private var comment: Bool
 888    @State private var edit: Bool
 889    @State private var triage: Bool
 890
 891    init(
 892        title: String,
 893        submitTitle: String,
 894        isSaving: Bool,
 895        error: String?,
 896        initialUsername: String,
 897        initialPermissions: TrackerACLPermissions,
 898        onSave: @escaping (String, TrackerACLPermissions) async -> Bool
 899    ) {
 900        self.title = title
 901        self.submitTitle = submitTitle
 902        self.isSaving = isSaving
 903        self.error = error
 904        self.initialUsername = initialUsername
 905        self.initialPermissions = initialPermissions
 906        self.onSave = onSave
 907        _username = State(initialValue: initialUsername)
 908        _browse = State(initialValue: initialPermissions.browse)
 909        _submit = State(initialValue: initialPermissions.submit)
 910        _comment = State(initialValue: initialPermissions.comment)
 911        _edit = State(initialValue: initialPermissions.edit)
 912        _triage = State(initialValue: initialPermissions.triage)
 913    }
 914
 915    var body: some View {
 916        NavigationStack {
 917            Form {
 918                Section("User") {
 919                    TextField("Username or ~username", text: $username)
 920                        .autocorrectionDisabled()
 921                        .textInputAutocapitalization(.never)
 922                        .themedRow()
 923                }
 924
 925                permissionSection
 926
 927                if let error, !error.isEmpty {
 928                    Section {
 929                        Text(error)
 930                            .foregroundStyle(.red)
 931                            .themedRow()
 932                    }
 933                }
 934            }
 935            .themedList()
 936            .navigationTitle(title)
 937            .navigationBarTitleDisplayMode(.inline)
 938            .toolbar {
 939                ToolbarItem(placement: .cancellationAction) {
 940                    Button("Cancel") { dismiss() }
 941                }
 942                ToolbarItem(placement: .confirmationAction) {
 943                    Button {
 944                        Task {
 945                            let didSave = await onSave(username, permissions)
 946                            if didSave {
 947                                dismiss()
 948                            }
 949                        }
 950                    } label: {
 951                        if isSaving {
 952                            ProgressView()
 953                                .controlSize(.small)
 954                        } else {
 955                            Text(submitTitle)
 956                        }
 957                    }
 958                    .disabled(username.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty || isSaving)
 959                }
 960            }
 961        }
 962    }
 963
 964    private var permissionSection: some View {
 965        Section("Permissions") {
 966            Toggle("Browse", isOn: $browse)
 967                .themedRow()
 968            Toggle("Submit", isOn: $submit)
 969                .themedRow()
 970            Toggle("Comment", isOn: $comment)
 971                .themedRow()
 972            Toggle("Edit", isOn: $edit)
 973                .themedRow()
 974            Toggle("Triage", isOn: $triage)
 975                .themedRow()
 976        }
 977    }
 978
 979    private var permissions: TrackerACLPermissions {
 980        TrackerACLPermissions(
 981            browse: browse,
 982            submit: submit,
 983            comment: comment,
 984            edit: edit,
 985            triage: triage
 986        )
 987    }
 988}
 989
 990private struct TrackerDefaultACLEditorSheet: View {
 991    let isSaving: Bool
 992    let error: String?
 993    let initialPermissions: TrackerACLPermissions
 994    let onSave: (TrackerACLPermissions) async -> Bool
 995
 996    @Environment(\.dismiss) private var dismiss
 997    @State private var browse: Bool
 998    @State private var submit: Bool
 999    @State private var comment: Bool
1000    @State private var edit: Bool
1001    @State private var triage: Bool
1002
1003    init(
1004        isSaving: Bool,
1005        error: String?,
1006        initialPermissions: TrackerACLPermissions,
1007        onSave: @escaping (TrackerACLPermissions) async -> Bool
1008    ) {
1009        self.isSaving = isSaving
1010        self.error = error
1011        self.initialPermissions = initialPermissions
1012        self.onSave = onSave
1013        _browse = State(initialValue: initialPermissions.browse)
1014        _submit = State(initialValue: initialPermissions.submit)
1015        _comment = State(initialValue: initialPermissions.comment)
1016        _edit = State(initialValue: initialPermissions.edit)
1017        _triage = State(initialValue: initialPermissions.triage)
1018    }
1019
1020    var body: some View {
1021        NavigationStack {
1022            Form {
1023                Section("Permissions") {
1024                    Toggle("Browse", isOn: $browse)
1025                        .themedRow()
1026                    Toggle("Submit", isOn: $submit)
1027                        .themedRow()
1028                    Toggle("Comment", isOn: $comment)
1029                        .themedRow()
1030                    Toggle("Edit", isOn: $edit)
1031                        .themedRow()
1032                    Toggle("Triage", isOn: $triage)
1033                        .themedRow()
1034                }
1035
1036                if let error, !error.isEmpty {
1037                    Section {
1038                        Text(error)
1039                            .foregroundStyle(.red)
1040                            .themedRow()
1041                    }
1042                }
1043            }
1044            .themedList()
1045            .navigationTitle("Default ACL")
1046            .navigationBarTitleDisplayMode(.inline)
1047            .toolbar {
1048                ToolbarItem(placement: .cancellationAction) {
1049                    Button("Cancel") { dismiss() }
1050                }
1051                ToolbarItem(placement: .confirmationAction) {
1052                    Button {
1053                        Task {
1054                            let didSave = await onSave(
1055                                TrackerACLPermissions(
1056                                    browse: browse,
1057                                    submit: submit,
1058                                    comment: comment,
1059                                    edit: edit,
1060                                    triage: triage
1061                                )
1062                            )
1063                            if didSave {
1064                                dismiss()
1065                            }
1066                        }
1067                    } label: {
1068                        if isSaving {
1069                            ProgressView()
1070                                .controlSize(.small)
1071                        } else {
1072                            Text("Save")
1073                        }
1074                    }
1075                    .disabled(isSaving)
1076                }
1077            }
1078        }
1079    }
1080}
1081
1082struct TrackerLabelManagementSheet: View {
1083    let viewModel: TrackerManagementViewModel
1084
1085    @Bindable private var bindableViewModel: TrackerManagementViewModel
1086    @State private var showCreateLabel = false
1087    @State private var editingLabel: TicketLabel?
1088    @State private var pendingDeletion: TicketLabel?
1089
1090    init(viewModel: TrackerManagementViewModel) {
1091        self.viewModel = viewModel
1092        self._bindableViewModel = Bindable(viewModel)
1093    }
1094
1095    var body: some View {
1096        NavigationStack {
1097            List {
1098                Section {
1099                    Text("Labels are managed here and reused throughout the tracker.")
1100                        .font(.footnote)
1101                        .foregroundStyle(.secondary)
1102                        .themedRow()
1103                }
1104
1105                if viewModel.isLoadingLabels {
1106                    HStack {
1107                        Spacer()
1108                        ProgressView()
1109                        Spacer()
1110                    }
1111                    .themedRow()
1112                } else if viewModel.labels.isEmpty {
1113                    ContentUnavailableView(
1114                        "No Labels",
1115                        systemImage: "tag",
1116                        description: Text("Create labels for triage and organization.")
1117                    )
1118                    .themedRow()
1119                } else {
1120                    ForEach(viewModel.labels) { label in
1121                        Button {
1122                            editingLabel = label
1123                        } label: {
1124                            TrackerLabelManagementRow(label: label)
1125                        }
1126                        .buttonStyle(.plain)
1127                        .swipeActions(edge: .trailing, allowsFullSwipe: false) {
1128                            Button {
1129                                editingLabel = label
1130                            } label: {
1131                                Label("Edit", systemImage: "pencil")
1132                            }
1133                            .tint(.blue)
1134
1135                            Button(role: .destructive) {
1136                                pendingDeletion = label
1137                            } label: {
1138                                Label("Delete", systemImage: "trash")
1139                            }
1140                        }
1141                    }
1142                    .themedRow()
1143                }
1144            }
1145            .themedList()
1146            .navigationTitle("Labels")
1147            .navigationBarTitleDisplayMode(.inline)
1148            .toolbar {
1149                ToolbarItem(placement: .topBarTrailing) {
1150                    Button {
1151                        showCreateLabel = true
1152                    } label: {
1153                        Image(systemName: "plus")
1154                    }
1155                    .disabled(viewModel.isSavingLabel)
1156                }
1157            }
1158            .task {
1159                await viewModel.loadLabels()
1160            }
1161            .srhtErrorBanner(error: $bindableViewModel.error)
1162            .sheet(isPresented: $showCreateLabel) {
1163                TrackerLabelEditorSheet(
1164                    title: "New Label",
1165                    submitTitle: "Create",
1166                    isSaving: viewModel.isSavingLabel,
1167                    error: viewModel.error,
1168                    initialLabel: nil
1169                ) { name, foreground, background in
1170                    await viewModel.createLabel(
1171                        name: name,
1172                        foregroundColor: foreground,
1173                        backgroundColor: background
1174                    )
1175                }
1176            }
1177            .sheet(item: $editingLabel) { label in
1178                TrackerLabelEditorSheet(
1179                    title: "Update Label",
1180                    submitTitle: "Save",
1181                    isSaving: viewModel.isSavingLabel,
1182                    error: viewModel.error,
1183                    initialLabel: label
1184                ) { name, foreground, background in
1185                    await viewModel.updateLabel(
1186                        label,
1187                        name: name,
1188                        foregroundColor: foreground,
1189                        backgroundColor: background
1190                    )
1191                }
1192            }
1193            .alert("Delete Label?", isPresented: Binding(
1194                get: { pendingDeletion != nil },
1195                set: { isPresented in
1196                    if !isPresented {
1197                        pendingDeletion = nil
1198                    }
1199                }
1200            )) {
1201                Button("Cancel", role: .cancel) {
1202                    // no-op: .cancel role handles alert dismissal
1203                }
1204                Button("Delete", role: .destructive) {
1205                    guard let pendingDeletion else { return }
1206                    Task {
1207                        await viewModel.deleteLabel(pendingDeletion)
1208                        self.pendingDeletion = nil
1209                    }
1210                }
1211            } message: {
1212                if let pendingDeletion {
1213                    Text("\(pendingDeletion.name)” will be removed from this tracker and from any tickets using it.")
1214                }
1215            }
1216        }
1217    }
1218}
1219
1220private struct TrackerLabelManagementRow: View {
1221    let label: TicketLabel
1222
1223    var body: some View {
1224        VStack(alignment: .leading, spacing: 8) {
1225            HStack(alignment: .top, spacing: 12) {
1226                LabelPill(label: label)
1227                Spacer()
1228                Image(systemName: "chevron.right")
1229                    .font(.caption.weight(.semibold))
1230                    .foregroundStyle(.tertiary)
1231            }
1232
1233            HStack(spacing: 12) {
1234                colorSwatch(hex: label.backgroundColor, title: "Background")
1235                colorSwatch(hex: label.foregroundColor, title: "Text")
1236            }
1237        }
1238        .padding(.vertical, 4)
1239    }
1240
1241    private func colorSwatch(hex: String, title: String) -> some View {
1242        HStack(spacing: 6) {
1243            Circle()
1244                .fill(Color(hex: hex) ?? .clear)
1245                .frame(width: 10, height: 10)
1246                .overlay {
1247                    Circle()
1248                        .stroke(Color.secondary.opacity(0.2), lineWidth: 1)
1249                }
1250
1251            Text("\(title): \(hex.uppercased())")
1252                .font(.caption)
1253                .foregroundStyle(.secondary)
1254        }
1255    }
1256}
1257
1258private struct TrackerLabelEditorSheet: View {
1259    let title: String
1260    let submitTitle: String
1261    let isSaving: Bool
1262    let error: String?
1263    let initialLabel: TicketLabel?
1264    let onSave: (String, String, String) async -> Bool
1265
1266    @Environment(\.dismiss) private var dismiss
1267    @State private var name: String
1268    @State private var foregroundColor: Color
1269    @State private var backgroundColor: Color
1270
1271    init(
1272        title: String,
1273        submitTitle: String,
1274        isSaving: Bool,
1275        error: String?,
1276        initialLabel: TicketLabel?,
1277        onSave: @escaping (String, String, String) async -> Bool
1278    ) {
1279        self.title = title
1280        self.submitTitle = submitTitle
1281        self.isSaving = isSaving
1282        self.error = error
1283        self.initialLabel = initialLabel
1284        self.onSave = onSave
1285        _name = State(initialValue: initialLabel?.name ?? "")
1286        _foregroundColor = State(initialValue: Color(hex: initialLabel?.foregroundColor ?? "#ffffff") ?? .white)
1287        _backgroundColor = State(initialValue: Color(hex: initialLabel?.backgroundColor ?? "#000000") ?? .black)
1288    }
1289
1290    var body: some View {
1291        NavigationStack {
1292            Form {
1293                Section("Details") {
1294                    TextField("Label name", text: $name)
1295                        .themedRow()
1296                    ColorPicker("Foreground", selection: $foregroundColor, supportsOpacity: false)
1297                        .themedRow()
1298                    ColorPicker("Background", selection: $backgroundColor, supportsOpacity: false)
1299                        .themedRow()
1300                }
1301
1302                Section("Preview") {
1303                    LabelPill(
1304                        label: TicketLabel(
1305                            id: initialLabel?.id ?? -1,
1306                            name: name.isEmpty ? "Preview" : name,
1307                            backgroundColor: backgroundColor.hexString,
1308                            foregroundColor: foregroundColor.hexString
1309                        )
1310                    )
1311                    .themedRow()
1312                }
1313
1314                if let error, !error.isEmpty {
1315                    Section {
1316                        Text(error)
1317                            .foregroundStyle(.red)
1318                            .themedRow()
1319                    }
1320                }
1321            }
1322            .themedList()
1323            .navigationTitle(title)
1324            .navigationBarTitleDisplayMode(.inline)
1325            .toolbar {
1326                ToolbarItem(placement: .cancellationAction) {
1327                    Button("Cancel") { dismiss() }
1328                }
1329                ToolbarItem(placement: .confirmationAction) {
1330                    Button {
1331                        Task {
1332                            let didSave = await onSave(
1333                                name,
1334                                foregroundColor.hexString,
1335                                backgroundColor.hexString
1336                            )
1337                            if didSave {
1338                                dismiss()
1339                            }
1340                        }
1341                    } label: {
1342                        if isSaving {
1343                            ProgressView()
1344                                .controlSize(.small)
1345                        } else {
1346                            Text(submitTitle)
1347                        }
1348                    }
1349                    .disabled(name.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty || isSaving)
1350                }
1351            }
1352        }
1353    }
1354}