Repository Public License
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