@rightkit/document-core 0.1.2 → 0.2.0

package/dist/documents/pdf/PdfViewerBody.d.ts

@@ -1,22 +0,0 @@
-import type { MutableRefObject, RefObject, WheelEventHandler } from "react";
-import type { PDFDocumentProxy } from "pdfjs-dist";
-import type { OutlineNode, Size } from "./pdfShared.js";
-import type { OcrLine } from "./pdfOcr.js";
-export declare function PdfViewerBody({ panel, outline, pdfDoc, numPages, current, rotation, base, pageSizes, scale, renderErrors, ocrLinesByPage, scrollRef, slotRefs, onSelectDestination, onSelectPage, onWheel, }: {
-    panel: null | "outline" | "thumbs";
-    outline: OutlineNode[] | null;
-    pdfDoc: PDFDocumentProxy | null;
-    numPages: number;
-    current: number;
-    rotation: number;
-    base: Size | null;
-    pageSizes: Map<number, Size>;
-    scale: number;
-    renderErrors: Map<number, string>;
-    ocrLinesByPage: ReadonlyMap<number, OcrLine[]>;
-    scrollRef: RefObject<HTMLDivElement | null>;
-    slotRefs: MutableRefObject<Map<number, HTMLDivElement>>;
-    onSelectDestination: (dest: string | unknown[] | null) => void;
-    onSelectPage: (page: number) => void;
-    onWheel?: WheelEventHandler<HTMLDivElement>;
-}): import("react").JSX.Element;

package/dist/documents/pdf/PdfViewerBody.js

@@ -1,42 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { PdfOutline } from "./PdfOutline.js";
-import { PdfThumbnails } from "./PdfThumbnails.js";
-import { PdfOcrLayer } from "./PdfOcrLayer.js";
-export function PdfViewerBody({ panel, outline, pdfDoc, numPages, current, rotation, base, pageSizes, scale, renderErrors, ocrLinesByPage, scrollRef, slotRefs, onSelectDestination, onSelectPage, onWheel, }) {
-    return (_jsxs("div", { className: "relative flex min-h-0 flex-1", children: [panel && (_jsxs("aside", { className: `no-print shrink-0 overflow-hidden border-r border-line bg-panel ${panel === "outline" ? "w-64" : "w-44"}`, children: [panel === "outline" && outline && outline.length > 0 && (_jsx("div", { className: "h-full overflow-auto py-2 text-xs", children: _jsx(PdfOutline, { nodes: outline, onSelect: onSelectDestination }) })), panel === "thumbs" && pdfDoc && (_jsx(PdfThumbnails, { pdf: pdfDoc, numPages: numPages, current: current, rotation: rotation, onSelect: onSelectPage }))] })), _jsx("div", { ref: scrollRef, role: "region", "aria-label": "PDF pages", onWheel: onWheel, className: "min-h-0 flex-1 overflow-auto bg-ink/40 outline-none", children: _jsx("div", { className: "flex min-w-full flex-col items-start gap-4 py-6", children: base &&
-                        Array.from({ length: numPages }, (_, i) => i + 1).map((n) => {
-                            const fallback = rotation % 180 !== 0 ? { w: base.h, h: base.w } : base;
-                            const sz = pageSizes.get(n) ?? fallback;
-                            return (_jsxs("div", { "data-page": n, ref: (el) => {
-                                    if (el)
-                                        slotRefs.current.set(n, el);
-                                    else
-                                        slotRefs.current.delete(n);
-                                }, className: "relative mx-auto bg-white shadow", 
-                                // T4-5 (conservative fix — see docs/PERF-AUDIT-2026-07-15.md): rather than
-                                // mounting/unmounting slot DOM nodes as the user scrolls (true windowing), keep
-                                // every slot mounted but tell the engine off-screen ones don't need layout/paint
-                                // work. `content-visibility: auto` skips style/layout/paint for subtrees the
-                                // browser judges "not relevant to the user" while still keeping the element (and
-                                // its box, since we already set an explicit width/height) in normal flow — so
-                                // `slotRefs`, `goToPage`'s `scrollIntoView`, the initial-view restore effect, and
-                                // the canvas IntersectionObserver in PdfViewer.tsx all keep working unchanged, with
-                                // zero risk to scroll-to-page/current-page tracking. True remove-from-DOM
-                                // windowing was not implemented: page heights are per-page-measured (mixed
-                                // orientation docs — see the "D1" comment in PdfViewer.tsx's renderPage) rather
-                                // than uniform, so an accurate windowed slot list needs an offset-aware version of
-                                // `thumbnailWindow()` (see @rightkit/pdf-ui) PLUS teaching
-                                // `goToPage`/the restore effect/the IntersectionObserver's `observe()` calls to
-                                // handle a target page whose slot isn't currently mounted — doable, but risky to
-                                // ship unverified (no way to interactively confirm scroll-to-page/search-jump/
-                                // outline-nav still land correctly in this pass). `content-visibility` is a no-op
-                                // in engines that don't support it (graceful degradation), so this is safe on both
-                                // WebView2 and WKWebView regardless of version.
-                                style: {
-                                    width: sz.w * scale,
-                                    height: sz.h * scale,
-                                    contentVisibility: "auto",
-                                    containIntrinsicSize: `${sz.w * scale}px ${sz.h * scale}px`,
-                                }, children: [ocrLinesByPage.has(n) && _jsx(PdfOcrLayer, { lines: ocrLinesByPage.get(n) ?? [] }), renderErrors.has(n) && (_jsxs("div", { className: "absolute inset-0 flex items-center justify-center bg-[var(--reader-surface)] p-4 text-center text-xs text-danger", children: ["Page ", n, " render error: ", renderErrors.get(n)] }))] }, n));
-                        }) }) })] }));
-}

package/dist/documents/pdf/macPdfNativeBridge.d.ts

@@ -1,118 +0,0 @@
-/** Rectangle for the native PDFKit view, in window CSS pixels. */
-export interface NativePdfFrame {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
-export interface NativePdfOutlineNode {
-    title: string;
-    page: number | null;
-    children: NativePdfOutlineNode[];
-}
-export type NativePdfEditingAction = {
-    kind: "annotation";
-    mode: "freeText" | "ink" | "highlight" | "stamp";
-} | {
-    kind: "text";
-} | {
-    kind: "stamp";
-    file: File;
-} | {
-    kind: "ocr";
-} | {
-    kind: "ocr-document";
-};
-export interface NativePdfState {
-    owner: string;
-    page: number;
-    numPages: number;
-    scale: number;
-    fit: "width" | "page" | null;
-    rotation: number;
-    /** Native panel state survives pane eviction & parked-reader reuse. */
-    panel?: "outline" | "thumbs" | null;
-    locked: boolean;
-    hasOutline: boolean;
-    outline: NativePdfOutlineNode[];
-}
-export type NativePdfResourcePhase = "active" | "parked" | "released";
-export interface NativePdfResourceEvent {
-    owner: string;
-    path: string;
-    identity: string | null;
-    generation: number;
-    phase: NativePdfResourcePhase;
-    reason: string;
-    activeCount: number;
-    parkedCount: number;
-    releasedCount: number;
-}
-export interface NativePdfOpenArgs {
-    owner: string;
-    path: string;
-    frame: NativePdfFrame;
-    readerRgb?: [number, number, number];
-    initialView: {
-        page?: number;
-        scale?: number;
-        fit?: "width" | "page" | null;
-        rotation?: number;
-    };
-    password?: string;
-}
-export interface NativePdfUpdateArgs {
-    owner: string;
-    frame?: NativePdfFrame;
-    readerRgb?: [number, number, number];
-    page?: number;
-    scale?: number;
-    /** An empty string clears a fit mode. */
-    fit?: "width" | "page" | "";
-    rotation?: number;
-    /** Empty string means no side panel. */
-    panel?: "" | "thumbs" | "outline";
-    visible?: boolean;
-}
-export interface NativePdfFindArgs {
-    owner: string;
-    query?: string;
-    matchCase?: boolean;
-    wholeWord?: boolean;
-    direction?: 1 | -1;
-    index?: number;
-    clear?: boolean;
-}
-export interface NativePdfSearchResult {
-    count: number;
-    activeIndex: number;
-}
-export interface NativePdfKeyEvent {
-    /** Native key events may omit owner because window has one native PDF host. */
-    owner?: string;
-    key: string;
-    code: string;
-    metaKey: boolean;
-    ctrlKey: boolean;
-    altKey: boolean;
-    shiftKey: boolean;
-}
-export interface NativePdfError extends Error {
-    /** The shell's stable code, for example `unsupported`, `not_open`, `stale_owner`. */
-    code?: string;
-}
-export declare function nativePdfOpen(args: NativePdfOpenArgs): Promise<NativePdfState>;
-export declare function nativePdfUpdate(args: NativePdfUpdateArgs): Promise<NativePdfState>;
-export declare function nativePdfState(owner: string): Promise<NativePdfState>;
-export type NativePdfCloseReason = "terminal-close" | "reload" | "edit-handoff" | "fallback" | "open-replaced";
-export declare function nativePdfClose(owner: string, path?: string, reason?: NativePdfCloseReason): Promise<void>;
-/** Close any native reader for a path when its app tab is genuinely removed. */
-export declare function nativePdfClosePath(path: string, reason?: NativePdfCloseReason): Promise<void>;
-export declare function nativePdfSuspend(owner: string, path: string): Promise<void>;
-export declare function nativePdfFind(args: NativePdfFindArgs): Promise<NativePdfSearchResult>;
-export declare function nativePdfPrint(owner: string): Promise<boolean>;
-export declare function listenNativePdfState(onState: (state: NativePdfState) => void): Promise<() => void>;
-export declare function listenNativePdfResource(onResource: (event: NativePdfResourceEvent) => void): Promise<() => void>;
-export declare function listenNativePdfKey(onKey: (event: NativePdfKeyEvent) => void): Promise<() => void>;
-/** Release frontend observation on HMR/test reset; it does not send a native command. */
-export declare function resetNativePdfBridgeForTests(): void;

package/dist/documents/pdf/macPdfNativeBridge.js

@@ -1,134 +0,0 @@
-import { invoke } from "@tauri-apps/api/core";
-import { listen } from "@tauri-apps/api/event";
-import { getCurrentWindow } from "@tauri-apps/api/window";
-import { acquireResource, updateResource } from "../../app/resourceCensus.js";
-// The shell's rightkit_pdf_* commands and events (rightkit-tauri-shell pdf_host). Failures cross
-// IPC as `{ code, message }`, not as an Error or a string.
-const CMD = {
-    open: "rightkit_pdf_open",
-    update: "rightkit_pdf_update",
-    state: "rightkit_pdf_state",
-    close: "rightkit_pdf_close",
-    suspend: "rightkit_pdf_suspend",
-    find: "rightkit_pdf_find",
-    print: "rightkit_pdf_print",
-};
-const EVENT_STATE = "rightkit://pdf-state";
-const EVENT_RESOURCE = "rightkit://pdf-resource";
-const EVENT_KEY = "rightkit://pdf-key";
-function toError(cause) {
-    if (cause instanceof Error)
-        return cause;
-    if (cause && typeof cause === "object" && typeof cause.message === "string") {
-        const error = new Error(cause.message);
-        const code = cause.code;
-        if (typeof code === "string")
-            error.code = code;
-        return error;
-    }
-    return new Error(String(cause));
-}
-async function call(command, args) {
-    try {
-        return await invoke(command, args);
-    }
-    catch (cause) {
-        throw toError(cause);
-    }
-}
-// Native PDFKit views are window-owned. Serializing every lifecycle command prevents a queued
-// StrictMode cleanup (or a document switch) from racing a newer open and reusing an old native view.
-let queue = Promise.resolve();
-let resourceListener = null;
-let resourceEpoch = 0;
-const resourceHandles = new Map();
-// PDFKit generations survive tab reactivation, unlike React owners. Keep this listener
-// outside pane lifetime so native expiry and terminal-close events remain observable.
-function ensureResourceListener() {
-    if (!resourceListener) {
-        const epoch = resourceEpoch;
-        resourceListener = listenNativePdfResource((event) => {
-            if (epoch !== resourceEpoch)
-                return;
-            const release = resourceHandles.get(event.generation);
-            if (event.phase === "released") {
-                release?.();
-                resourceHandles.delete(event.generation);
-                return;
-            }
-            const kind = event.phase === "parked" ? "pdf-native-parked-reader" : "pdf-native-reader";
-            if (release) {
-                updateResource(release, { kind });
-            }
-            else {
-                resourceHandles.set(event.generation, acquireResource({ kind, documentPath: event.path, format: "pdf" }));
-            }
-        }).catch((error) => {
-            if (epoch === resourceEpoch)
-                resourceListener = null;
-            throw error;
-        });
-    }
-    return resourceListener;
-}
-function enqueue(task) {
-    const run = queue.then(task, task);
-    queue = run.then(() => undefined, () => undefined);
-    return run;
-}
-export function nativePdfOpen(args) {
-    return enqueue(async () => {
-        await ensureResourceListener();
-        return call(CMD.open, { ...args });
-    });
-}
-export function nativePdfUpdate(args) {
-    return enqueue(() => call(CMD.update, { ...args }));
-}
-export function nativePdfState(owner) {
-    return enqueue(() => call(CMD.state, { owner }));
-}
-export function nativePdfClose(owner, path, reason = "terminal-close") {
-    return enqueue(() => call(CMD.close, {
-        owner,
-        ...(path === undefined ? {} : { path }),
-        reason,
-    }));
-}
-/** Close any native reader for a path when its app tab is genuinely removed. */
-export function nativePdfClosePath(path, reason = "terminal-close") {
-    return nativePdfClose("", path, reason);
-}
-export function nativePdfSuspend(owner, path) {
-    return enqueue(() => call(CMD.suspend, { owner, path }));
-}
-export function nativePdfFind(args) {
-    return enqueue(() => call(CMD.find, { ...args }).then((result) => ({
-        count: result.count,
-        activeIndex: result.activeIndex ?? -1,
-    })));
-}
-export function nativePdfPrint(owner) {
-    return enqueue(() => call(CMD.print, { owner }));
-}
-export async function listenNativePdfState(onState) {
-    return listen(EVENT_STATE, (event) => onState(event.payload));
-}
-export async function listenNativePdfResource(onResource) {
-    return listen(EVENT_RESOURCE, (event) => onResource(event.payload), { target: { kind: "WebviewWindow", label: getCurrentWindow().label } });
-}
-export async function listenNativePdfKey(onKey) {
-    return listen(EVENT_KEY, (event) => onKey(event.payload));
-}
-/** Release frontend observation on HMR/test reset; it does not send a native command. */
-export function resetNativePdfBridgeForTests() {
-    queue = Promise.resolve();
-    resourceEpoch++;
-    void resourceListener?.then((unlisten) => unlisten()).catch(() => { });
-    resourceListener = null;
-    for (const release of resourceHandles.values())
-        release();
-    resourceHandles.clear();
-}
-if (import.meta.hot)
-    import.meta.hot.dispose(resetNativePdfBridgeForTests);

package/dist/documents/pdf/nearestVisiblePdfPage.d.ts

@@ -1,2 +0,0 @@
-/** Pure page-picking helper, kept free of pdf.js so it is testable without a DOM-bound viewer. */
-export declare function nearestVisiblePdfPage(root: HTMLElement, slots: ReadonlyMap<number, HTMLElement>, visiblePages: ReadonlySet<number>, fallbackPage: number): number;

package/dist/documents/pdf/nearestVisiblePdfPage.js

@@ -1,22 +0,0 @@
-/** Pure page-picking helper, kept free of pdf.js so it is testable without a DOM-bound viewer. */
-export function nearestVisiblePdfPage(root, slots, visiblePages, fallbackPage) {
-    const rootRect = root.getBoundingClientRect();
-    const centerY = rootRect.top + rootRect.height / 2;
-    let bestPage = fallbackPage;
-    let bestDistance = Number.POSITIVE_INFINITY;
-    const pages = visiblePages.size > 0 ? visiblePages : slots.keys();
-    for (const page of pages) {
-        const slot = slots.get(page);
-        if (!slot)
-            continue;
-        const rect = slot.getBoundingClientRect();
-        if (rect.bottom < rootRect.top || rect.top > rootRect.bottom)
-            continue;
-        const distance = Math.abs(rect.top + rect.height / 2 - centerY);
-        if (distance < bestDistance) {
-            bestDistance = distance;
-            bestPage = page;
-        }
-    }
-    return bestPage;
-}

package/dist/documents/pdf/pdfBench.d.ts

@@ -1,88 +0,0 @@
-import { type ResourceCensus } from "../../app/resourceCensus.js";
-export type PdfBenchLoadMode = "buffer" | "url-native" | "custom-range";
-export interface PdfBenchStreamStats {
-    readonly enabled: boolean;
-    readonly resource_bytes: number;
-    readonly head_requests: number;
-    readonly full_get_requests: number;
-    readonly range_get_requests: number;
-    readonly rejected_range_requests: number;
-    readonly full_bytes_read: number;
-    readonly range_bytes_read: number;
-    readonly total_bytes_read: number;
-    readonly max_response_bytes: number;
-}
-export interface PdfBenchProcessMemory {
-    /** RSS for the app process only; this is not total webview memory. */
-    readonly app_process_rss_bytes: number;
-    /** RSS summed across the app process tree; this is not total webview memory. */
-    readonly app_process_tree_rss_bytes: number;
-    readonly process_count: number;
-}
-export interface PdfBenchRuntimeStats {
-    readonly js_heap_used_bytes: number | null;
-    readonly js_heap_total_bytes: number | null;
-    readonly js_heap_limit_bytes: number | null;
-    readonly longtask_count: number;
-    readonly longtask_duration_ms: number;
-}
-export interface PdfBenchSnapshot {
-    readonly at_ms: number;
-    readonly stream: PdfBenchStreamStats | null;
-    readonly process_memory: PdfBenchProcessMemory | null;
-    readonly runtime: PdfBenchRuntimeStats;
-    readonly resources: ResourceCensus;
-}
-export interface PdfBenchResult {
-    readonly schema_version: 1;
-    readonly mode: PdfBenchLoadMode;
-    readonly run_id: string;
-    readonly launch_kind: string | null;
-    readonly run_index: number | null;
-    readonly run_total: number | null;
-    readonly started_at: string;
-    readonly platform: string;
-    readonly user_agent: string;
-    readonly pdfjs_version: string;
-    readonly document_ready_ms: number | null;
-    readonly first_canvas_ms: number | null;
-    readonly first_canvas_page: number | null;
-    readonly baseline_memory: PdfBenchProcessMemory | null;
-    readonly baseline_runtime: PdfBenchRuntimeStats;
-    readonly first_canvas_snapshot: PdfBenchSnapshot | null;
-    readonly late_page_target: number | null;
-    readonly late_page_request_ms: number | null;
-    readonly late_page_ms: number | null;
-    readonly late_page_snapshot: PdfBenchSnapshot | null;
-    readonly settled_snapshot: PdfBenchSnapshot | null;
-    readonly fixture_label: string | null;
-    readonly source_filename: string | null;
-    readonly fixture_bytes: number | null;
-    readonly fixture_sha256: string | null;
-    readonly fixture_identity_status: "missing" | "pending" | "matched" | "mismatch";
-    readonly error: string | null;
-}
-export declare function isPdfBenchEnabled(): boolean;
-export declare function getPdfBenchLoadMode(): PdfBenchLoadMode;
-export declare function registerPdfBenchLatePageNavigator(navigator: ((requested: number) => number | null) | null): void;
-export declare function beginPdfBench(url: string, pdfjsVersion: string, mode?: PdfBenchLoadMode): Promise<void>;
-export declare function markPdfBenchDocumentReady(url: string): void;
-export declare function markPdfBenchFirstCanvasPaint(url: string | undefined, page: number): void;
-export declare function markPdfBenchError(url: string, error: unknown): void;
-declare global {
-    interface Window {
-        vrPdfBench?: {
-            status(): unknown;
-            enable(mode?: PdfBenchLoadMode, reload?: boolean): void;
-            disable(reload?: boolean): void;
-            setMode(mode: PdfBenchLoadMode, reload?: boolean): void;
-            report(): Promise<PdfBenchResult | null>;
-            history(): PdfBenchResult[];
-            clearHistory(): void;
-            download(): Promise<unknown>;
-            autopilot(label?: string, repeats?: number): void;
-            autopilotStatus(): unknown;
-            stopAutopilot(): void;
-        };
-    }
-}