SPB Git

Repository Public License

PageEditorView.swift 23.8 KB 496 lines swift

1// ORIX Scan2// File: App/Sources/Document/PageEditorView.swift3// Description: Non-destructive page editor: filters, adjustments, crop and perspective, rotation, straightening, before/after, quality advice.4//5// Author: Simon-Pierre Boucher6// Contact: contact@spboucher.ai7import ORIXDesign8import ORIXKit9import SwiftUI1011struct PageEditorView: View {12    enum Tool: Hashable { case filter, adjust }1314    @Environment(AppModel.self) private var model15    @Environment(\.orixAccent) private var accent16    @Environment(\.dismiss) private var dismiss17    let documentID: UUID18    let pageID: UUID19    let embedded: Bool2021    @State private var draft = PageEdit()22    @State private var loadedDraft = false23    @State private var preview: UIImage?24    @State private var original: UIImage?25    @State private var comparing = false26    @State private var split: CGFloat = 0.527    @State private var tool: Tool = .filter28    @State private var cropping = false29    @State private var quality: QualityReport?30    @State private var qualityDismissed = false31    @State private var showQualityDetails = false32    @State private var straightening = false33    @State private var saveTask: Task<Void, Never>?3435    private var page: PageRecord? { model.manifest(documentID)?.pages.first { $0.id == pageID } }36    private var pageNumber: Int { (model.manifest(documentID)?.pages.firstIndex { $0.id == pageID } ?? 0) + 1 }3738    var body: some View {39        VStack(spacing: 0) {40            if let page {41                if let quality, !quality.isClean, !qualityDismissed, !model.settings.dismissedQualityWarnings, let issue = quality.issues.first {42                    ORIXBanner(.warning, title: Text(issue.title), message: Text(issue.advice)) {43                        Menu {44                            Button("Show Details") { showQualityDetails = true }45                            Button("Dismiss") { qualityDismissed = true }46                            Button("Don't Warn Me Again") { model.settings.dismissedQualityWarnings = true }47                        } label: { Image(systemName: "ellipsis.circle").frame(width: ORIX.minimumTarget, height: ORIX.minimumTarget) }48                        .accessibilityLabel("Warning options")49                    }50                    .padding([.horizontal, .top], ORIX.Space.md)51                    .accessibilityIdentifier("editor.quality")52                }53                canvas54                if page.source.isPDF {55                    pdfControls56                } else {57                    controls58                }59            } else {60                ORIXEmptyState(systemName: "doc", title: "Page Unavailable", message: "This page is no longer part of the document.")61            }62        }63        .background(ORIX.Palette.desk)64        .modifier(StandaloneChrome(active: !embedded, title: String(localized: "Page \(pageNumber)")) { pageMenu })65        .task(id: pageID) {66            if let page, !loadedDraft { draft = page.edit; loadedDraft = true }67        }68        .task(id: "\(pageID)-\(draft.cacheKey)") { await renderPreview() }69        .task(id: "\(pageID)-\(draft.geometryKey)") { await refreshQuality() }70        .onChange(of: page?.edit) { _, new in71            // The edit changed elsewhere (workflow, rotate from the grid): follow it.72            if let new, new != draft, saveTask == nil { draft = new }73        }74        .onChange(of: draft) { _, new in scheduleSave(new) }75        .onDisappear { flushSave() }76        .fullScreenCover(isPresented: $cropping) {77            if let page { CropEditorView(documentID: documentID, page: page, quad: draft.quad ?? .full) { draft.quad = $0.isFull ? nil : $0 } }78        }79        .sheet(isPresented: $showQualityDetails) { if let quality { QualityDetailsView(report: quality) } }80    }8182    // MARK: Canvas8384    private var canvas: some View {85        GeometryReader { proxy in86            ZStack {87                if let preview {88                    Image(uiImage: preview)89                        .resizable()90                        .aspectRatio(contentMode: .fit)91                        .overlay {92                            if comparing, let original {93                                // Left of the handle shows the capture before enhancement.94                                GeometryReader { inner in95                                    Image(uiImage: original).resizable().aspectRatio(contentMode: .fill)96                                        .frame(width: inner.size.width, height: inner.size.height)97                                        .mask(alignment: .leading) { Rectangle().frame(width: inner.size.width * split) }98                                    Rectangle().fill(.white).frame(width: 2).shadow(radius: 2)99                                        .overlay {100                                            Image(systemName: "arrow.left.and.right.circle.fill").font(.title).symbolRenderingMode(.palette)101                                                .foregroundStyle(accent.primary, .white)102                                        }103                                        .position(x: inner.size.width * split, y: inner.size.height / 2)104                                    HStack {105                                        ORIXChip(Text("Before"), tint: .white).background(.black.opacity(0.55), in: Capsule())106                                        Spacer()107                                        ORIXChip(Text("After"), tint: .white).background(.black.opacity(0.55), in: Capsule())108                                    }109                                    .padding(8)110                                    Color.clear.contentShape(Rectangle())111                                        .gesture(DragGesture(minimumDistance: 0).onChanged { split = min(max($0.location.x / inner.size.width, 0.02), 0.98) })112                                        .accessibilityElement()113                                        .accessibilityLabel("Before and after comparison")114                                        .accessibilityValue(Text(split, format: .percent.precision(.fractionLength(0))))115                                        .accessibilityAdjustableAction { direction in116                                            split = min(max(split + (direction == .increment ? 0.1 : -0.1), 0.02), 0.98)117                                        }118                                }119                            }120                        }121                        .orixPage()122                        .orixScanBeam(active: straightening)123                        .padding(ORIX.Space.md)124                } else {125                    ProgressView()126                }127            }128            .frame(width: proxy.size.width, height: proxy.size.height)129        }130        .accessibilityElement(children: .contain)131        .accessibilityLabel("Page \(pageNumber) preview")132    }133134    // MARK: Controls135136    private var controls: some View {137        VStack(spacing: ORIX.Space.sm) {138            HStack(spacing: ORIX.Space.xs) {139                iconButton("Rotate Left", symbol: "rotate.left") { draft.quarterTurns = (draft.quarterTurns + 3) % 4 }140                iconButton("Rotate Right", symbol: "rotate.right") { draft.quarterTurns = (draft.quarterTurns + 1) % 4 }141                iconButton("Crop", symbol: "crop") { cropping = true }.accessibilityIdentifier("editor.crop")142                iconButton("Straighten", symbol: "level") { Task { await straighten() } }.disabled(straightening)143                Spacer()144                Toggle(isOn: $comparing.animation(ORIX.Motion.quick)) { Label("Compare", systemImage: "square.split.2x1") }145                    .toggleStyle(.button)146                    .accessibilityIdentifier("editor.compare")147                if embedded { pageMenu }148            }149            Picker("Tool", selection: $tool) {150                Text("Filter").tag(Tool.filter)151                Text("Adjust").tag(Tool.adjust)152            }153            .pickerStyle(.segmented)154            switch tool {155            case .filter:156                HStack(spacing: ORIX.Space.xs) {157                    ForEach(FilterMode.allCases) { mode in158                        Button {159                            draft.filter = mode160                            draft.shadowReduction = mode != .original161                            ORIXHaptics.tick()162                        } label: {163                            VStack(spacing: 4) {164                                Image(systemName: mode.symbol).font(.title3)165                                Text(mode.title).font(.caption2.weight(.medium)).lineLimit(1).minimumScaleFactor(0.7)166                            }167                            .frame(maxWidth: .infinity, minHeight: 56)168                            .foregroundStyle(draft.filter == mode ? Color.white : ORIX.Palette.textPrimary)169                            .background(draft.filter == mode ? AnyShapeStyle(accent.primary) : AnyShapeStyle(ORIX.Palette.surfaceRaised),170                                        in: RoundedRectangle(cornerRadius: ORIX.Radius.control, style: .continuous))171                        }172                        .buttonStyle(.plain)173                        .accessibilityAddTraits(draft.filter == mode ? .isSelected : [])174                        .accessibilityIdentifier("editor.filter.\(mode.rawValue)")175                    }176                }177            case .adjust:178                VStack(spacing: 2) {179                    slider("Brightness", value: $draft.brightness, range: -1...1)180                    slider("Contrast", value: $draft.contrast, range: -1...1)181                    slider("Sharpen", value: $draft.sharpen, range: 0...1)182                    slider("Noise Reduction", value: $draft.denoise, range: 0...1)183                    Toggle("Reduce Shadows", isOn: $draft.shadowReduction).font(.orixCallout).disabled(draft.filter == .original || draft.filter == .blackWhite)184                    Button("Reset Adjustments") {185                        draft.brightness = 0; draft.contrast = 0; draft.sharpen = 0.25; draft.denoise = 0; draft.deskewDegrees = 0186                    }187                    .font(.orixCallout)188                    .frame(minHeight: ORIX.minimumTarget)189                }190            }191        }192        .padding(ORIX.Space.md)193        .background(ORIX.Palette.surface)194    }195196    private var pdfControls: some View {197        HStack(spacing: ORIX.Space.xs) {198            iconButton("Rotate Left", symbol: "rotate.left") { draft.quarterTurns = (draft.quarterTurns + 3) % 4 }199            iconButton("Rotate Right", symbol: "rotate.right") { draft.quarterTurns = (draft.quarterTurns + 1) % 4 }200            Text("Imported PDF pages keep their original content. They can be rotated, reordered and recognized.")201                .font(.orixCaption).foregroundStyle(ORIX.Palette.textSecondary)202            Spacer(minLength: 0)203            if embedded { pageMenu }204        }205        .padding(ORIX.Space.md)206        .background(ORIX.Palette.surface)207    }208209    private func iconButton(_ title: LocalizedStringKey, symbol: String, action: @escaping () -> Void) -> some View {210        Button(action: action) {211            Image(systemName: symbol).font(.body.weight(.medium))212                .frame(width: ORIX.minimumTarget, height: ORIX.minimumTarget)213                .background(ORIX.Palette.surfaceRaised, in: RoundedRectangle(cornerRadius: ORIX.Radius.chip, style: .continuous))214        }215        .buttonStyle(.plain)216        .foregroundStyle(ORIX.Palette.textPrimary)217        .accessibilityLabel(title)218    }219220    private func slider(_ title: LocalizedStringKey, value: Binding<Double>, range: ClosedRange<Double>) -> some View {221        HStack {222            Text(title).font(.orixCallout).frame(width: 130, alignment: .leading)223            Slider(value: value, in: range) { Text(title) }224            Text(value.wrappedValue, format: .number.precision(.fractionLength(2))).font(.orixMono).frame(width: 46, alignment: .trailing)225                .foregroundStyle(ORIX.Palette.textSecondary).accessibilityHidden(true)226        }227        .frame(minHeight: ORIX.minimumTarget)228    }229230    private var pageMenu: some View {231        Menu {232            if let page, !page.source.isPDF {233                Button { flushSave(); model.request(.scan, for: .retake(document: documentID, page: pageID)) } label: { Label("Retake", systemImage: "camera") }234                Button { flushSave(); model.request(.photos, for: .retake(document: documentID, page: pageID)) } label: { Label("Replace from Photos", systemImage: "photo") }235            }236            Button { Task { await model.duplicatePage(pageID, in: documentID) } } label: { Label("Duplicate Page", systemImage: "plus.square.on.square") }237            Button { model.startRecognition(documentID, force: true, pages: [pageID]) } label: { Label("Recognize This Page", systemImage: "text.viewfinder") }238            if (model.manifest(documentID)?.pages.count ?? 0) > 1 {239                Divider()240                Button(role: .destructive) {241                    saveTask?.cancel(); saveTask = nil242                    Task { await model.deletePages([pageID], in: documentID) }243                    if !embedded { dismiss() }244                } label: { Label("Delete Page", systemImage: "trash") }245            }246        } label: {247            Image(systemName: "ellipsis.circle").frame(width: ORIX.minimumTarget, height: ORIX.minimumTarget)248        }249        .accessibilityLabel("Page options")250    }251252    // MARK: Work253254    private func renderPreview() async {255        guard let page, loadedDraft else { return }256        // Small debounce so dragging a slider does not queue a render per frame.257        try? await Task.sleep(for: .milliseconds(60))258        if Task.isCancelled { return }259        let image = await model.thumbnails.preview(for: page, in: documentID, edit: draft, maxDimension: 1800)260        if Task.isCancelled { return }261        preview = image262        var untouched = PageEdit.untouched263        untouched.quad = draft.quad264        untouched.quarterTurns = draft.quarterTurns265        untouched.deskewDegrees = draft.deskewDegrees266        original = await model.thumbnails.preview(for: page, in: documentID, edit: untouched, maxDimension: 1800)267    }268269    private func refreshQuality() async {270        guard let page, !page.source.isPDF else { quality = nil; return }271        try? await Task.sleep(for: .milliseconds(350))272        if Task.isCancelled { return }273        var probe = page274        probe.edit = draft275        quality = try? await model.processor.quality(of: probe, in: documentID)276    }277278    private func scheduleSave(_ edit: PageEdit) {279        guard loadedDraft, page?.edit != edit else { return }280        saveTask?.cancel()281        saveTask = Task {282            try? await Task.sleep(for: .milliseconds(450))283            if Task.isCancelled { return }284            await model.updateEdits(in: documentID, pages: [pageID]) { current, _ in current = edit }285            saveTask = nil286        }287    }288289    /// Saves a pending edit immediately (leaving the screen, retaking).290    private func flushSave() {291        guard saveTask != nil else { return }292        saveTask?.cancel()293        saveTask = nil294        let edit = draft295        Task { await model.updateEdits(in: documentID, pages: [pageID]) { current, _ in current = edit } }296    }297298    private func straighten() async {299        flushSave()300        straightening = true301        defer { straightening = false }302        let changed = await model.attempt { try await model.processor.deskew(documentID, pages: [pageID]) }303        await model.didChange(documentID)304        if let page { draft = page.edit }305        if changed == 0 { model.toast = String(localized: "This page is already straight") } else { ORIXHaptics.success() }306    }307}308309/// Navigation title and toolbar of the editor when it is its own screen (iPhone). Embedded in the iPad workspace it must310/// not set a title: an empty title here would replace the document's.311private struct StandaloneChrome<Menu: View>: ViewModifier {312    let active: Bool313    let title: String314    @ViewBuilder var menu: Menu315316    func body(content: Content) -> some View {317        if active {318            content319                .navigationTitle(title)320                .navigationBarTitleDisplayMode(.inline)321                .toolbar { ToolbarItem(placement: .topBarTrailing) { menu } }322                .toolbar(.hidden, for: .tabBar)323        } else {324            content325        }326    }327}328329struct QualityDetailsView: View {330    @Environment(\.dismiss) private var dismiss331    let report: QualityReport332333    var body: some View {334        NavigationStack {335            List {336                Section("Advice") {337                    ForEach(report.issues) { issue in338                        VStack(alignment: .leading, spacing: 2) {339                            Text(issue.title).font(.orixHeadline)340                            Text(issue.advice).font(.orixCallout).foregroundStyle(ORIX.Palette.textSecondary)341                        }342                    }343                }344                Section {345                    LabeledContent("Sharpness", value: report.sharpness.formatted(.number.precision(.fractionLength(0))))346                    LabeledContent("Contrast", value: report.contrast.formatted(.percent.precision(.fractionLength(0))))347                    LabeledContent("Brightness", value: report.brightness.formatted(.percent.precision(.fractionLength(0))))348                    LabeledContent("Resolution", value: "\(report.pixelWidth) × \(report.pixelHeight)")349                    if let share = report.lowConfidenceShare {350                        LabeledContent("Uncertain Lines", value: share.formatted(.percent.precision(.fractionLength(0))))351                    }352                } header: { Text("Measurements") } footer: {353                    Text("These are estimates. If the page looks right to you, you can ignore them.")354                }355            }356            .navigationTitle("Page Quality")357            .navigationBarTitleDisplayMode(.inline)358            .toolbar { ToolbarItem(placement: .confirmationAction) { Button("Done") { dismiss() } } }359        }360        .presentationDetents([.medium, .large])361    }362}363364/// Manual crop and perspective: four corner handles over the full capture.365struct CropEditorView: View {366    @Environment(AppModel.self) private var model367    @Environment(\.orixAccent) private var accent368    @Environment(\.dismiss) private var dismiss369    let documentID: UUID370    let page: PageRecord371    @State var quad: Quad372    var onDone: (Quad) -> Void373    @State private var image: UIImage?374    @State private var detecting = false375376    var body: some View {377        NavigationStack {378            GeometryReader { proxy in379                ZStack {380                    Color.black.ignoresSafeArea()381                    if let image {382                        let fitted = fit(image.size, in: CGSize(width: proxy.size.width - 48, height: proxy.size.height - 48))383                        ZStack {384                            Image(uiImage: image).resizable().frame(width: fitted.width, height: fitted.height)385                            outline(in: fitted)386                            ForEach(0..<4, id: \.self) { corner in handle(corner, in: fitted) }387                        }388                        .frame(width: fitted.width, height: fitted.height)389                    } else {390                        ProgressView().tint(.white)391                    }392                }393                .frame(width: proxy.size.width, height: proxy.size.height)394            }395            .navigationTitle("Crop")396            .navigationBarTitleDisplayMode(.inline)397            .toolbarColorScheme(.dark, for: .navigationBar, .bottomBar)398            .toolbar {399                ToolbarItem(placement: .cancellationAction) { Button("Cancel") { dismiss() } }400                ToolbarItem(placement: .confirmationAction) {401                    Button("Done") { onDone(quad.clamped()); dismiss() }.fontWeight(.semibold).disabled(!quad.isValid)402                        .accessibilityIdentifier("crop.done")403                }404                ToolbarItemGroup(placement: .bottomBar) {405                    Button { Task { await detect() } } label: { Label("Detect Edges", systemImage: "viewfinder") }.disabled(detecting)406                        .labelStyle(.titleAndIcon)407                    Spacer()408                    Button { withAnimation(ORIX.Motion.quick) { quad = .full } } label: { Label("Whole Image", systemImage: "arrow.up.left.and.arrow.down.right") }409                        .labelStyle(.titleAndIcon)410                }411            }412            .task {413                // The crop is always chosen on the full, unfiltered capture.414                image = await model.thumbnails.preview(for: page, in: documentID, edit: .untouched, maxDimension: 1800)415            }416        }417    }418419    private func fit(_ size: CGSize, in bounds: CGSize) -> CGSize {420        let scale = min(bounds.width / max(size.width, 1), bounds.height / max(size.height, 1))421        return CGSize(width: size.width * scale, height: size.height * scale)422    }423424    private func outline(in size: CGSize) -> some View {425        Path { path in426            let points = quad.corners.map { CGPoint(x: $0.x * size.width, y: $0.y * size.height) }427            path.addLines(points)428            path.closeSubpath()429        }430        .stroke(quad.isValid ? accent.secondary : ORIX.Palette.danger, style: StrokeStyle(lineWidth: 2, lineJoin: .round))431        .background {432            Path { path in433                path.addRect(CGRect(origin: .zero, size: size))434                path.addLines(quad.corners.map { CGPoint(x: $0.x * size.width, y: $0.y * size.height) })435                path.closeSubpath()436            }437            .fill(.black.opacity(0.45), style: FillStyle(eoFill: true))438        }439        .allowsHitTesting(false)440    }441442    private func point(_ corner: Int) -> CGPoint { quad.corners[corner] }443444    private func set(_ corner: Int, _ p: CGPoint) {445        let c = CGPoint(x: min(max(p.x, 0), 1), y: min(max(p.y, 0), 1))446        switch corner {447        case 0: quad.topLeft = c448        case 1: quad.topRight = c449        case 2: quad.bottomRight = c450        default: quad.bottomLeft = c451        }452    }453454    private func handle(_ corner: Int, in size: CGSize) -> some View {455        let names: [LocalizedStringKey] = ["Top left corner", "Top right corner", "Bottom right corner", "Bottom left corner"]456        return Circle()457            .fill(.white)458            .frame(width: 22, height: 22)459            .overlay(Circle().stroke(accent.secondary, lineWidth: 3))460            .frame(width: 48, height: 48)461            .contentShape(Circle())462            .position(x: point(corner).x * size.width, y: point(corner).y * size.height)463            .gesture(DragGesture(minimumDistance: 0).onChanged { value in464                set(corner, CGPoint(x: value.location.x / size.width, y: value.location.y / size.height))465            })466            .accessibilityLabel(names[corner])467            .accessibilityValue(Text("\(Int(point(corner).x * 100)) percent across, \(Int(point(corner).y * 100)) percent down"))468            .accessibilityAdjustableAction { direction in469                // VoiceOver: swipe up/down moves the corner toward or away from the center.470                let center = CGPoint(x: 0.5, y: 0.5), p = point(corner)471                let step: CGFloat = direction == .increment ? -0.03 : 0.03472                set(corner, CGPoint(x: p.x + (center.x - p.x).sign * step * -1, y: p.y + (center.y - p.y).sign * step * -1))473            }474    }475476    private func detect() async {477        detecting = true478        defer { detecting = false }479        let processor = model.processor, page = page, id = documentID480        let found: Quad? = await Task.detached {481            guard let cg = try? processor.renderedImage(page, in: id, edit: .untouched, maxDimension: 1600) else { return nil }482            return DocumentDetector.detect(in: cg)483        }.value484        if let found {485            withAnimation(ORIX.Motion.expressive) { quad = found }486            ORIXHaptics.success()487        } else {488            model.toast = String(localized: "No page outline found")489        }490    }491}492493private extension CGFloat {494    var sign: CGFloat { self < 0 ? -1 : 1 }495}496
Files main
Menu

Theme