Repository Public
1// ORIX Docs2// File: App/Sources/Sidebar/PagesPanel.swift3// Description: The pages panel: lazily rendered page thumbnails, cached per layout generation and refreshed off the main thread4// (debounced, visible pages only), with page numbers and navigation.5//6// Author: Simon-Pierre Boucher7// Contact: contact@spboucher.ai8import SwiftUI9import DocModel10import DocLayout1112/// Renders and caches page thumbnails. A thumbnail belongs to a layout generation; after an edit the visible ones are rendered13/// again once typing pauses, the others when they scroll into view. The previous image stays on screen meanwhile.14@Observable15final class PageThumbnailStore {16 struct Entry { let image: CGImage; let generation: Int }17 private struct Rendered: @unchecked Sendable { let image: CGImage? }1819 private(set) var entries: [Int: Entry] = [:]20 @ObservationIgnored weak var session: DocumentSession?21 @ObservationIgnored private var generation = 022 @ObservationIgnored private var visible = Set<Int>()23 @ObservationIgnored private var inFlight: [Int: Int] = [:]24 @ObservationIgnored private var debounce: Task<Void, Never>?25 /// Keeps the layout the current generation was counted for alive, so its identity cannot be reused by the next one.26 @ObservationIgnored private var heldLayout: DocumentLayout?2728 /// Thumbnail width in pixels (two per point at the sidebar's width).29 static let pixelWidth: CGFloat = 23230 static let refreshDelay: Duration = .milliseconds(500)31 static let cacheLimit = 1603233 func layoutChanged(_ layout: DocumentLayout) {34 heldLayout = layout35 generation += 136 entries = entries.filter { $0.key < layout.pageCount }37 scheduleRefresh()38 }3940 func appeared(_ page: Int) {41 visible.insert(page)42 guard let entry = entries[page] else { render(page); return }43 if entry.generation != generation { scheduleRefresh() }44 }4546 func disappeared(_ page: Int) { visible.remove(page) }4748 private func scheduleRefresh() {49 debounce?.cancel()50 debounce = Task { [weak self] in51 try? await Task.sleep(for: PageThumbnailStore.refreshDelay)52 guard !Task.isCancelled, let self else { return }53 for page in self.visible.sorted() where self.entries[page]?.generation != self.generation { self.render(page) }54 }55 }5657 private func render(_ page: Int) {58 guard let session, inFlight[page] != generation else { return }59 let layout = session.layout60 guard layout.pages.indices.contains(page) else { return }61 let doc = session.doc, images = session.images, requested = generation62 let scale = PageThumbnailStore.pixelWidth / max(1, layout.pages[page].size.width)63 inFlight[page] = requested64 Task { [weak self] in65 let rendered = await Task.detached(priority: .utility) {66 Rendered(image: PDFPublisher.bitmap(page: page, doc: doc, layout: layout, scale: scale, images: images))67 }.value68 guard let self else { return }69 if self.inFlight[page] == requested { self.inFlight[page] = nil }70 guard let image = rendered.image, requested >= (self.entries[page]?.generation ?? -1) else { return }71 self.entries[page] = Entry(image: image, generation: requested)72 self.trim()73 }74 }7576 /// Bounds memory on long documents: the thumbnails farthest from the visible pages go first.77 private func trim() {78 guard entries.count > PageThumbnailStore.cacheLimit, let lo = visible.min(), let hi = visible.max() else { return }79 let far = entries.keys.filter { !visible.contains($0) }.sorted { max(lo - $0, $0 - hi) > max(lo - $1, $1 - hi) }80 for page in far.prefix(entries.count - PageThumbnailStore.cacheLimit) { entries[page] = nil }81 }82}8384struct PagesPanel: View {85 @Bindable var session: DocumentSession86 @State private var store = PageThumbnailStore()8788 var body: some View {89 let _ = session.selectionRevision90 let layout = session.layout91 let current = session.currentPage92 VStack(spacing: 0) {93 SidebarSectionHeader(title: "Pages") {94 Text("\(layout.pageCount) pages").accessibilityIdentifier("pages-count")95 }96 .padding(.horizontal, ORIX.Space.m).frame(height: 30)97 ScrollViewReader { proxy in98 ScrollView {99 LazyVGrid(columns: [GridItem(.flexible(), spacing: ORIX.Space.m), GridItem(.flexible(), spacing: ORIX.Space.m)], spacing: ORIX.Space.m) {100 ForEach(layout.pages.indices, id: \.self) { index in101 let page = layout.pages[index]102 PageThumbnail(index: index, label: page.numberText.isEmpty ? String(index + 1) : page.numberText, size: page.size,103 image: store.entries[index]?.image, isCurrent: index == current) { session.revealPage(index) }104 .id(index)105 .onAppear { store.appeared(index) }106 .onDisappear { store.disappeared(index) }107 }108 }109 .padding(.horizontal, ORIX.Space.m).padding(.top, 2).padding(.bottom, ORIX.Space.m)110 }111 .onChange(of: current) { _, page in withAnimation(ORIX.Motion.quick) { proxy.scrollTo(page) } }112 }113 }114 .onAppear { store.session = session; store.layoutChanged(layout) }115 .onChange(of: ObjectIdentifier(layout)) { _, _ in store.layoutChanged(session.layout) }116 .accessibilityIdentifier("pages-panel")117 }118}119120private struct PageThumbnail: View {121 let index: Int122 let label: String123 let size: CGSize124 let image: CGImage?125 let isCurrent: Bool126 let action: () -> Void127 @State private var hover = false128129 var body: some View {130 Button(action: action) {131 VStack(spacing: 5) {132 ZStack {133 Rectangle().fill(Color.white)134 if let image { Image(decorative: image, scale: 2).resizable().interpolation(.high) }135 }136 .aspectRatio(max(0.1, size.width / max(1, size.height)), contentMode: .fit)137 .clipShape(RoundedRectangle(cornerRadius: 2))138 .overlay(RoundedRectangle(cornerRadius: 2).strokeBorder(isCurrent ? ORIX.Palette.accent : ORIX.Palette.hairline, lineWidth: isCurrent ? 2 : 1))139 .shadow(color: .black.opacity(hover ? 0.18 : 0.08), radius: hover ? 5 : 2, y: 1)140 Text(label)141 .font(.system(size: 10.5, weight: isCurrent ? .semibold : .regular).monospacedDigit())142 .padding(.horizontal, 7).padding(.vertical, 1.5)143 .foregroundStyle(isCurrent ? Color.white : ORIX.Palette.textSecondary)144 .background(Capsule().fill(isCurrent ? AnyShapeStyle(ORIX.Palette.accent) : AnyShapeStyle(Color.clear)))145 .lineLimit(1)146 }147 .contentShape(Rectangle())148 }149 .buttonStyle(.plain)150 .onHover { hover = $0 }151 .accessibilityLabel(Text("Page \(label)"))152 .accessibilityAddTraits(isCurrent ? .isSelected : [])153 .accessibilityIdentifier("page-thumbnail-\(index + 1)")154 }155}156