@rightkit/document-core 0.1.1 → 0.2.0

package/dist/state/browserQa.js

@@ -1,303 +0,0 @@
-/**
- * Fixture documents + IPC-boundary fallbacks for browser QA mode (`VITE_RIGHTKIT_BROWSER_QA=1`,
- * `?qa=1&doc=<key>`) — the headless-Chrome harness `scripts/qa-browser-functional.mjs` drives, and
- * the manual escape hatch for poking the app in a plain browser tab outside Tauri. `qaOcrLines`
- * lives here; the PDF-edit-command mocks (`inspect_pdf_page`/`compose_pdf_preview`/
- * `prepare_pdf_save`/`commit_pdf_save`/`list_pdf_fonts`, plus the in-memory PDF "disk" and the
- * `window.__viewrightQa` assertion surface) live in the sibling `browserQaPdf.ts` instead, since
- * they need their own save-token/sha bookkeeping this file has no reason to carry.
- *
- * PDF coverage split: annotation editing (FreeText/Ink/Highlight/Stamp, via pdf.js's own
- * `AnnotationEditorLayer`/`saveDocument()`) + two-phase Save/Save As is fully exercised in browser
- * QA against `browserQaPdf.ts`'s mocks. Existing-text/add-text editing (`inspect_pdf_page`'s
- * `islands`) stays native-only — browser QA has no Rust content-stream walker, so that path is only
- * reachable/non-crashing here, never a real edit round trip.
- */
-import { baseName, formatFromPath } from "../documents/types.js";
-import { hostAppName } from "../appName.js";
-// 2-page PDF (generated by hand, ~1.4 KB): page 1 carries an external URI link annotation
-// (https://example.com/from-pdf) and an internal GoTo link to page 2. Exercises the viewer's
-// annotation/link layer in browser QA, where no Tauri stream token exists.
-const QA_LINK_PDF = "data:application/pdf;base64,JVBERi0xLjcKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgPj4KZW5kb2JqCjIgMCBvYmoKPDwgL1R5cGUgL1BhZ2VzIC9LaWRzIFszIDAgUiA2IDAgUl0gL0NvdW50IDIgPj4KZW5kb2JqCjMgMCBvYmoKPDwgL1R5cGUgL1BhZ2UgL1BhcmVudCAyIDAgUiAvTWVkaWFCb3ggWzAgMCA2MTIgNzkyXSAvUmVzb3VyY2VzIDw8IC9Gb250IDw8IC9GMSA5IDAgUiA+PiA+PiAvQ29udGVudHMgNCAwIFIgL0Fubm90cyBbNyAwIFIgOCAwIFJdID4+CmVuZG9iago0IDAgb2JqCjw8IC9MZW5ndGggMTUxID4+CnN0cmVhbQpCVCAvRjEgMjQgVGYgNzIgNzAwIFRkIChQYWdlIDE6IGV4dGVybmFsIGxpbmsgYmVsb3cpIFRqIEVUCkJUIC9GMSAxOCBUZiA3MiA2NDAgVGQgKFZpc2l0IGV4YW1wbGUuY29tKSBUaiBFVApCVCAvRjEgMTggVGYgNzIgNTgwIFRkIChHbyB0byBwYWdlIDIpIFRqIEVUCmVuZHN0cmVhbQplbmRvYmoKNSAwIG9iago8PCAvcGxhY2Vob2xkZXIgdHJ1ZSA+PgplbmRvYmoKNiAwIG9iago8PCAvVHlwZSAvUGFnZSAvUGFyZW50IDIgMCBSIC9NZWRpYUJveCBbMCAwIDYxMiA3OTJdIC9SZXNvdXJjZXMgPDwgL0ZvbnQgPDwgL0YxIDkgMCBSID4+ID4+IC9Db250ZW50cyAxMCAwIFIgPj4KZW5kb2JqCjcgMCBvYmoKPDwgL1R5cGUgL0Fubm90IC9TdWJ0eXBlIC9MaW5rIC9SZWN0IFs3MCA2MzAgMjYwIDY2NV0gL0JvcmRlciBbMCAwIDFdIC9BIDw8IC9TIC9VUkkgL1VSSSAoaHR0cHM6Ly9leGFtcGxlLmNvbS9mcm9tLXBkZikgPj4gPj4KZW5kb2JqCjggMCBvYmoKPDwgL1R5cGUgL0Fubm90IC9TdWJ0eXBlIC9MaW5rIC9SZWN0IFs3MCA1NzAgMjIwIDYwNV0gL0JvcmRlciBbMCAwIDFdIC9EZXN0IFs2IDAgUiAvWFlaIG51bGwgbnVsbCBudWxsXSA+PgplbmRvYmoKOSAwIG9iago8PCAvVHlwZSAvRm9udCAvU3VidHlwZSAvVHlwZTEgL0Jhc2VGb250IC9IZWx2ZXRpY2EgPj4KZW5kb2JqCjEwIDAgb2JqCjw8IC9MZW5ndGggNTkgPj4Kc3RyZWFtCkJUIC9GMSAyNCBUZiA3MiA3MDAgVGQgKFBhZ2UgMjogaW50ZXJuYWwgbGluayB0YXJnZXQpIFRqIEVUCmVuZHN0cmVhbQplbmRvYmoKeHJlZgowIDExCjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwMDAwOSAwMDAwMCBuIAowMDAwMDAwMDU4IDAwMDAwIG4gCjAwMDAwMDAxMjEgMDAwMDAgbiAKMDAwMDAwMDI2OSAwMDAwMCBuIAowMDAwMDAwNDcxIDAwMDAwIG4gCjAwMDAwMDA1MTAgMDAwMDAgbiAKMDAwMDAwMDYzNyAwMDAwMCBuIAowMDAwMDAwNzc4IDAwMDAwIG4gCjAwMDAwMDA5MDAgMDAwMDAgbiAKMDAwMDAwMDk3MCAwMDAwMCBuIAp0cmFpbGVyCjw8IC9TaXplIDExIC9Sb290IDEgMCBSID4+CnN0YXJ0eHJlZgoxMDgwCiUlRU9GCg==";
-// Keep PDF xref offsets intact while exercising URL schemes accepted/rejected by pdf.js.
-function qaPdfUriAsset(uri) {
-    const original = "https://example.com/from-pdf";
-    if (uri.length > original.length)
-        throw new Error("QA PDF URI must fit existing annotation");
-    const bytes = atob(QA_LINK_PDF.split(",")[1]);
-    return `data:application/pdf;base64,${btoa(bytes.replace(original, uri.padEnd(original.length, " ")))}`;
-}
-// Browser QA has no Rust OCR backend, so the IPC-boundary fixture keeps the scanned-page UI
-// deterministic while exercising the same positioned-line shape as native recognition.
-export function qaOcrLines() {
-    return [
-        {
-            text: "Requerimento de licença",
-            rect: { x: 0.12, y: 0.14, width: 0.42, height: 0.035 },
-            confidence: 0.98,
-        },
-        {
-            text: "Nome do requerente",
-            rect: { x: 0.12, y: 0.22, width: 0.34, height: 0.035 },
-            confidence: 0.96,
-        },
-        {
-            text: "Data de nascimento",
-            rect: { x: 0.12, y: 0.3, width: 0.31, height: 0.035 },
-            confidence: null,
-        },
-        {
-            text: "Assinatura do requerente",
-            rect: { x: 0.12, y: 0.38, width: 0.39, height: 0.035 },
-            confidence: 0.94,
-        },
-    ];
-}
-const qaDocs = {
-    mdx: {
-        path: `D:\\${hostAppName()} QA\\runtime.mdx`,
-        lastView: "preview",
-        content: `# MDX consolidation
-
-Needle one. Needle two.
-
-<button onClick={(event) => { event.currentTarget.textContent = "Clicked"; }}>Press</button>
-`,
-    },
-    md: {
-        path: `D:\\${hostAppName()} QA\\source-notes.md`,
-        lastView: "source",
-        content: `# Source editor QA
-
-This markdown file exists only in browser QA mode.
-
-- The gutter should be subtle.
-- Markdown source should remain readable.
-- Find should navigate without leaving stale highlights.
-
-\`\`\`ts
-const product = "${hostAppName()}";
-console.log(product);
-\`\`\`
-
-| Very wide protected table with SupercalifragilisticexpialidociousSupercalifragilisticexpialidociousSupercalifragilisticexpialidocious | Column two | Column three | Column four | Column five | Column six | Column seven | Column eight |
-| --- | --- | --- | --- | --- | --- | --- | --- |
-| This oversized fixture must remain inside its editor rail | Two | Three | Four | Five | Six | Seven | Eight |
-
-\`\`\`ts
-const oversizedCodeFixture = "SupercalifragilisticexpialidociousSupercalifragilisticexpialidociousSupercalifragilisticexpialidociousSupercalifragilisticexpialidociousSupercalifragilisticexpialidocious";
-\`\`\`
-${Array.from({ length: 72 }, (_, index) => `\n\n## Outer scroll fixture ${index + 1}\nThis real Markdown line proves visible-line tracking & Back to top use document scroll owner.`).join("")}
-`,
-    },
-    mdMermaid: {
-        path: `D:\\${hostAppName()} QA\\wide-mermaid.md`,
-        lastView: "preview",
-        content: `# Media Console Mermaid QA
-
-Visual Plan:
-
-\`\`\`mermaid
-flowchart LR
-  ui["React/Vite UI"] --> shell["Tauri shell commands"]
-  shell --> supervisor["Rust EngineSupervisor"]
-  supervisor <--> protocol["media-console-protocol frames"]
-  protocol <--> engine["media-console-engine sidecar"]
-  engine --> core["media-console-core"]
-  core --> store["manifest/job/artifact store"]
-  engine --> runners["Rust-owned runner adapters"]
-  runners --> providers["provider/runner boundaries"]
-\`\`\`
-
-The diagram above should scroll horizontally inside its card without clipping labels, nodes, or arrowheads.
-`,
-    },
-    html: {
-        path: `D:\\${hostAppName()} QA\\local-preview.html`,
-        lastView: "interactive",
-        content: `<!doctype html>
-<html lang="en">
-<head>
-  <meta charset="utf-8" />
-  <title>${hostAppName()} HTML QA</title>
-  <style>
-    body { margin: 0; font-family: Inter, system-ui, sans-serif; color: #25221d; background: #faf7ef; }
-    main { max-width: 760px; margin: 9vh auto; padding: 32px; border: 1px solid #ded4c2; background: white; }
-    h1 { font-family: "Source Serif 4", Georgia, serif; font-size: 48px; margin: 0 0 12px; }
-    code { color: #8f4d2e; }
-  </style>
-</head>
-<body>
-  <main>
-    <h1>Local HTML preview</h1>
-    <p>This page checks ${hostAppName()}'s rendered preview and source drawer.</p>
-    <p><code>data-mode="qa"</code> should be easy to read in source.</p>
-    <p>A <a href="https://example.com/">sample link</a> to click.</p>
-    <table>
-      <thead><tr><th>Name</th><th>Value</th></tr></thead>
-      <tbody>
-        <tr><td>alpha</td><td>one</td></tr>
-        <tr><td>beta</td><td>two</td></tr>
-      </tbody>
-    </table>
-  </main>
-</body>
-</html>
-`,
-    },
-    htmlSource: {
-        path: `D:\\${hostAppName()} QA\\vite-source-shell.html`,
-        lastView: "interactive",
-        content: `<!doctype html>
-<html lang="en">
-<head><meta charset="utf-8" /><title>Vite source shell</title></head>
-<body>
-  <div id="vr-boot">Loading…</div>
-  <script src="/boot.js"></script>
-  <script type="module" src="/src/main.tsx"></script>
-</body>
-</html>
-`,
-    },
-    txt: {
-        path: `D:\\${hostAppName()} QA\\scratch.txt`,
-        lastView: "preview",
-        content: "Plain text QA\n\nThis surface should not show a source gutter.\nSpellcheck and find should still work.",
-    },
-    pdf: {
-        path: `D:\\${hostAppName()} QA\\linked.pdf`,
-        content: "",
-        assetUrl: QA_LINK_PDF,
-    },
-    "pdf-malicious": {
-        path: `D:\\${hostAppName()} QA\\malicious-link.pdf`,
-        content: "",
-        assetUrl: qaPdfUriAsset("ftp://evil.example/steal.pdf"),
-    },
-    "pdf-script": {
-        path: `D:\\${hostAppName()} QA\\script-link.pdf`,
-        content: "",
-        assetUrl: qaPdfUriAsset("javascript:alert\\(1\\)"),
-    },
-    image: {
-        path: `D:\\${hostAppName()} QA\\sample.svg`,
-        content: `data:image/svg+xml,${encodeURIComponent(`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 640 360"><rect width="640" height="360" fill="#f7f3ec"/><circle cx="180" cy="180" r="96" fill="#1a6ed4"/><rect x="320" y="96" width="188" height="168" rx="18" fill="#16213f"/><text x="320" y="310" font-family="monospace" font-size="30" fill="#16213f">ViewRight image QA</text></svg>`)}`,
-    },
-};
-function qaDocKey() {
-    if (typeof window === "undefined")
-        return null;
-    const raw = new URLSearchParams(window.location.search).get("doc") ?? "";
-    return raw in qaDocs ? raw : null;
-}
-/// Manual-QA-only escape hatch (not used by the automated `qa:functional:browser` suite): loads a
-/// real file straight off disk through Vite dev server's `/@fs/` route, keyed by `?doc=corpus&file=
-/// <name>` against `VR_CORPUS_DIR` (default `.qa-corpus/`, same env var the Rust corpus harness in
-/// `commands/corpus_qa.rs` uses). Lets a real-world PDF corpus be opened and observed (lazy-render,
-/// network panel, memory) via the ordinary QA-mode app shell without any native file dialog.
-function qaCorpusFileName() {
-    if (typeof window === "undefined")
-        return null;
-    const params = new URLSearchParams(window.location.search);
-    if (params.get("doc") !== "corpus")
-        return null;
-    return params.get("file");
-}
-function qaCorpusPath(file) {
-    return `D:\\${hostAppName()} QA\\corpus\\${file}`;
-}
-function qaDocxCorpusFileName() {
-    if (typeof window === "undefined")
-        return null;
-    const params = new URLSearchParams(window.location.search);
-    const file = params.get("file");
-    return params.get("doc") === "docx-corpus" && file && /^[^/\\]+\.docx$/.test(file) ? file : null;
-}
-const QA_DOCX_CORPUS_PREFIX = `D:\\${hostAppName()} QA\\docx-corpus\\`;
-export function qaDialogPath() {
-    const docxCorpusFile = qaDocxCorpusFileName();
-    if (docxCorpusFile)
-        return QA_DOCX_CORPUS_PREFIX + docxCorpusFile;
-    const corpusFile = qaCorpusFileName();
-    if (corpusFile)
-        return qaCorpusPath(corpusFile);
-    return qaDocKey() === "md" ? qaDocs.mdMermaid.path : qaDocs[qaDocKey() ?? "md"].path;
-}
-export function qaInitialOpenPath() {
-    const docxCorpusFile = qaDocxCorpusFileName();
-    if (docxCorpusFile)
-        return QA_DOCX_CORPUS_PREFIX + docxCorpusFile;
-    const corpusFile = qaCorpusFileName();
-    if (corpusFile)
-        return qaCorpusPath(corpusFile);
-    const key = qaDocKey();
-    return key ? qaDocs[key].path : null;
-}
-async function bytesToBase64PdfUrl(bytes) {
-    const blob = new Blob([bytes], { type: "application/pdf" });
-    const reader = new FileReader();
-    return new Promise((resolvePromise, reject) => {
-        reader.onload = () => resolvePromise(reader.result);
-        reader.onerror = () => reject(reader.error);
-        reader.readAsDataURL(blob);
-    });
-}
-export async function qaDocumentForPath(path) {
-    if (path.startsWith(QA_DOCX_CORPUS_PREFIX)) {
-        const file = path.slice(QA_DOCX_CORPUS_PREFIX.length);
-        if (!/^[^/\\]+\.docx$/.test(file))
-            return null;
-        const res = await fetch(`/qa-docx-corpus/${encodeURIComponent(file)}`);
-        if (!res.ok)
-            return null;
-        const bytes = await res.arrayBuffer();
-        const content = await new Promise((resolvePromise, reject) => {
-            const reader = new FileReader();
-            reader.onload = () => resolvePromise(String(reader.result).split(",", 2)[1] ?? "");
-            reader.onerror = () => reject(reader.error);
-            reader.readAsDataURL(new Blob([bytes]));
-        });
-        return {
-            path,
-            displayName: baseName(path),
-            format: "docx",
-            content,
-            encoding: "UTF-8",
-            fingerprint: { mtimeMs: 1, size: bytes.byteLength },
-        };
-    }
-    const corpusPrefix = `D:\\${hostAppName()} QA\\corpus\\`;
-    if (path.startsWith(corpusPrefix)) {
-        const file = path.slice(corpusPrefix.length);
-        const dir = import.meta.env?.VITE_VR_CORPUS_DIR ?? "/Volumes/D/claude/viewright/.qa-corpus";
-        const res = await fetch(`/@fs/${dir}/${encodeURIComponent(file)}`);
-        if (!res.ok)
-            return null;
-        const bytes = await res.arrayBuffer();
-        const format = formatFromPath(path);
-        const assetUrl = format === "pdf" ? await bytesToBase64PdfUrl(bytes) : undefined;
-        return {
-            path,
-            displayName: baseName(path),
-            format,
-            content: format === "pdf" ? "" : new TextDecoder().decode(bytes),
-            assetUrl,
-            encoding: "UTF-8",
-            fingerprint: { mtimeMs: 1, size: bytes.byteLength },
-        };
-    }
-    const doc = Object.values(qaDocs).find((entry) => entry.path === path);
-    if (!doc)
-        return null;
-    return {
-        path: doc.path,
-        displayName: baseName(doc.path),
-        format: formatFromPath(doc.path),
-        content: doc.content,
-        assetUrl: doc.assetUrl,
-        lastView: doc.lastView,
-        viewMeta: doc.viewMeta,
-        encoding: "UTF-8",
-        fingerprint: { mtimeMs: 1, size: doc.content.length },
-    };
-}

package/dist/state/browserQaDocx.d.ts

@@ -1,3 +0,0 @@
-import type { LoadedDocument } from "../documents/types.js";
-export declare function readQaDocxDocument(doc: LoadedDocument): LoadedDocument | null;
-export declare function writeQaDocxDocument(path: string, bytes: ArrayBuffer, contentBase64: string): Promise<void>;

package/dist/state/browserQaDocx.js

@@ -1,35 +0,0 @@
-// IPC-boundary DOCX disk, confined to disposable QA profile. Readback exposes only saved bytes.
-const PREFIX = "viewright.qa.docx-disk:";
-function read(path) {
-    const raw = sessionStorage.getItem(PREFIX + path);
-    return raw ? JSON.parse(raw) : null;
-}
-function publishReadback() {
-    window.__viewrightQaDocx =
-        Object.freeze({ read });
-}
-export function readQaDocxDocument(doc) {
-    if (doc.format !== "docx")
-        return null;
-    const entry = read(doc.path);
-    if (!entry)
-        return null;
-    publishReadback();
-    return {
-        ...doc,
-        content: entry.contentBase64,
-        assetUrl: undefined,
-        fingerprint: { mtimeMs: entry.mtimeMs, size: entry.byteLength },
-    };
-}
-export async function writeQaDocxDocument(path, bytes, contentBase64) {
-    const hash = await crypto.subtle.digest("SHA-256", bytes);
-    const sourceSha256 = Array.from(new Uint8Array(hash), (byte) => byte.toString(16).padStart(2, "0")).join("");
-    sessionStorage.setItem(PREFIX + path, JSON.stringify({
-        contentBase64,
-        sourceSha256,
-        byteLength: bytes.byteLength,
-        mtimeMs: Date.now(),
-    }));
-    publishReadback();
-}

package/dist/state/browserQaLicense.d.ts

@@ -1,8 +0,0 @@
-export declare function qaLicenseClient(): {
-    status: () => Promise<import("@rightkit/license").LicenseView>;
-    activate: (key: string) => Promise<import("@rightkit/license").LicenseView>;
-    refresh: () => Promise<import("@rightkit/license").RefreshView>;
-    deactivate: () => Promise<import("@rightkit/license").LicenseView>;
-    requestTrial: (email: string) => Promise<import("@rightkit/license").TrialView>;
-    onChange(callback: (view: import("@rightkit/license").LicenseView) => void, onError?: (error: import("@rightkit/license").LicenseClientError) => void): Promise<import("@rightkit/license").LicenseUnlisten>;
-};

package/dist/state/browserQaLicense.js

@@ -1,7 +0,0 @@
-import { createLicenseMock } from "@rightkit/license/testing";
-// Browser-QA only (loaded through `browserQaLicenseClient()` in tauriBridge, behind BROWSER_QA_BUILD).
-// The mock is in-memory: no persistence, credentials or network. The `testing` export resolves
-// only under the `development` condition, so a release build must never reach this module.
-export function qaLicenseClient() {
-    return createLicenseMock().client;
-}

package/dist/state/browserQaPdf.d.ts

@@ -1,60 +0,0 @@
-/**
- * Deterministic PDF-edit-command mocks for browser QA mode (`VITE_RIGHTKIT_BROWSER_QA=1`,
- * `?qa=1&doc=pdf`). Never active in production builds — every export here is only ever reached
- * through `tauriBridge.ts`'s `isBrowserQaMode()` gate, exactly like `qaOcrLines` already is for
- * OCR (see `browserQa.ts`).
- *
- * Before this module, `requireTauriForPdfEdit` threw `unsupported_outside_tauri` for every
- * PDF-editor command (`inspect_pdf_page`, `compose_pdf_preview`, `prepare_pdf_save`,
- * `commit_pdf_save`, `list_pdf_fonts`), so Save and Edit-text had zero coverage in the automated
- * `qa:functional:browser` harness — every PDF save regression had to be found by hand in the
- * native app. This module gives the harness a real, in-memory PDF "disk" and mirrors the Rust
- * save-protocol rules (`src-tauri/crates/pdf/src/save.rs`'s `select_compose_base`, the stale-sha
- * check, single-use tokens) closely enough that ANNOTATION editing + save (stamp/ink/highlight, via
- * pdf.js's own `AnnotationEditorLayer`/`saveDocument()`) is now exercised end to end in the
- * headless browser harness. Source-TEXT editing (`inspect_pdf_page`'s `islands`) stays native-only:
- * browser QA has no Rust content-stream walker, so `qaInspectPdfPage` always reports zero editable
- * islands — good enough to keep the Edit-text UI reachable/non-crashing, not to exercise a real
- * text-replace round trip.
- */
-import type { ComposePdfPreviewRequest, ComposedPdfPreview, PdfCommitResult, PdfFontCatalogEntry, PdfPageGraph, PreparePdfSaveRequest, PreparedPdfSave } from "../documents/pdf/pdfEditModel.js";
-/** Matches `document_sha256` (`src-tauri/crates/pdf/src/model.rs`): plain SHA-256 of the whole
- *  byte sequence, lowercase hex. */
-export declare function sha256Hex(bytes: Uint8Array): Promise<string>;
-/** Exported for PdfViewer.tsx's post-commit reload only (see its own call site's comment): the
- *  `url` prop it otherwise reloads from is a static `data:` URL captured once at document-open
- *  time — unlike a real Tauri stream token, it can never reflect a later commit on its own, so the
- *  reload needs to ask this in-memory disk for the CURRENT bytes directly. Returns `null` outside
- *  QA mode or for a path never touched through the PDF-edit bridge. */
-export declare function qaCurrentPdfBytes(path: string): Promise<Uint8Array | null>;
-export declare function qaCurrentPdfAssetUrl(path: string): Promise<string | null>;
-/** Test-only: clears the in-memory QA disk and save-token registry so each test starts from a
- *  fresh fixture seed, independent of what earlier tests in the same file committed. Mirrors
- *  `resourceCensus.ts`'s `resetResourceCensusForTests` convention. */
-export declare function resetQaPdfStateForTests(): void;
-export declare function qaInspectPdfPage(path: string, page: number): Promise<PdfPageGraph>;
-export declare function qaListPdfFonts(): Promise<PdfFontCatalogEntry[]>;
-export declare function qaComposePdfPreview(request: ComposePdfPreviewRequest): Promise<ComposedPdfPreview>;
-export declare function qaPreparePdfSave(request: PreparePdfSaveRequest): Promise<PreparedPdfSave>;
-export declare function qaCommitPdfSave(token: string, targetPath?: string): Promise<PdfCommitResult>;
-export interface ViewrightQaGlobal {
-    pdfDiskBase64(path: string): string | null;
-    pdfDiskLatin1(path: string): string | null;
-    /** The PRISTINE fixture/corpus bytes for `path` (always freshly re-derived from
-     *  `qaDocumentForPath`, never from the mutable `qaDisk` — so this stays correct even after a
-     *  commit has already overwritten `qaDisk`'s entry). For asserting a save produced a real
-     *  incremental update ("committed bytes start with the ORIGINAL bytes"), since by the time a
-     *  script can read `pdfDiskLatin1` after a "Saved" toast, `qaDisk` already holds the new,
-     *  post-commit bytes. */
-    originalPdfDiskLatin1(path: string): Promise<string | null>;
-}
-declare global {
-    interface Window {
-        __viewrightQa?: ViewrightQaGlobal;
-    }
-}
-/** Registers `window.__viewrightQa` once. Callers (`tauriBridge.ts`) must gate this behind their
- *  own `isBrowserQaMode()` check — kept unconditional here (idempotent via `registered`) rather
- *  than duplicating that check locally, since importing `isBrowserQaMode` from `tauriBridge.ts`
- *  would cycle back into this module's own `./browserQa` import. */
-export declare function registerViewrightQaGlobal(): void;