SPB Git

Repository Public

PagesPanel.swift 7.3 KB 156 lines swift

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
Files main
Menu

Theme