@rightkit/document-core 0.1.1 → 0.2.0

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

@@ -1,294 +0,0 @@
-/**
- * Canonical frontend model for sparse PDF edits.
- *
- * This file is the frozen cross-lane seam described in `docs/PDF-EDITOR-DISPATCH.md`
- * ("Frozen cross-lane seams"): it owns every shared frontend type — the Rust wire-model mirrors
- * (`docs/PDF-EDITOR-NOW.md` §5.1), the session/command types (§6), `PdfSavePlan` (§10.3), the typed
- * `PdfEditError` union (§11), and the *injected-bridge* function signatures other lanes accept by
- * injection ahead of the real `tauriBridge.ts` implementations landing at Dispatch D2.
- *
- * PDF pages are fixed-layout scenes, not word-processing documents. Existing content therefore
- * enters the editor as small, source-backed "islands" reported by the Rust inspector
- * (`inspect_pdf_page`, §5.2). Every edit command retains a stable source locator (§5.1) so
- * persistence (§9) can patch only changed content instead of clearing and reconstructing a page.
- *
- * This is a contract-definition file: types plus small pure helpers. Session lifecycle, draft
- * commit/cancel orchestration, and the real bridge live elsewhere (`usePdfEditSession.ts`,
- * `pdfSave.ts`, `tauriBridge.ts` — see `docs/PDF-EDITOR-NOW.md` §12).
- */
-/** Axis-aligned rectangle in PDF user-space units (origin/orientation follow the page's own
- *  coordinate system, pre-viewport-transform). Used for available-bounds checks (§8's
- *  `available.contains(run.bounds)`) and for the draft's page-slot placement (§6.1's
- *  `pdfRectToViewport(session.draft.rect, viewport)`). */
-export interface PdfRect {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
-/** A single PDF user-space point, e.g. the clicked anchor for Add Text (§6 `PdfAddText.anchor`). */
-export interface PdfPoint {
-    x: number;
-    y: number;
-}
-/** Four-number tuple shape shared by `mediaBox`, `cropBox` (§5.1), and an island's `baseline`
- *  segment — all serialize from Rust `[f64; 4]`. */
-export type PdfQuad4 = [number, number, number, number];
-/** Eight-number tuple shape for one glyph-run quadrilateral (`PdfTextIsland.quads`, §5.1),
- *  serialized from Rust `[f64; 8]` as four (x, y) corner pairs. */
-export type PdfQuad8 = [number, number, number, number, number, number, number, number];
-export interface PdfDocumentRevision {
-    documentSha256: string;
-    pageCount: number;
-    pages: PdfPageGraph[];
-}
-export interface PdfPageGraph {
-    documentSha256: string;
-    page: number;
-    mediaBox: PdfQuad4;
-    cropBox: PdfQuad4;
-    rotation: number;
-    islands: PdfTextIsland[];
-}
-/** One editable (or explicitly-rejected) same-line visual text run (§5.3). Named identically to
- *  the Rust wire struct it mirrors — this supersedes the prior DOM/occurrence-based
- *  `PdfTextIsland` from the superseded attempt; there is no backward-compat alias. */
-export interface PdfTextIsland {
-    id: string;
-    text: string;
-    quads: PdfQuad8[];
-    baseline: PdfQuad4;
-    appearance: PdfTextAppearance;
-    locator: PdfSourceLocator;
-    editable: boolean;
-    rejection: PdfEditError | null;
-}
-/** Stable identity for a piece of source content, independent of any DOM node or viewport state
- *  (§4: "pdf.js DOM nodes never identify persistent source content"). */
-export interface PdfSourceLocator {
-    documentSha256: string;
-    page: number;
-    spans: PdfSourceSpan[];
-    islandDigest: string;
-}
-/** One exact source-byte range an edit command may patch (§9.1/§9.2). `streamRef` mirrors Rust's
- *  `(u32, u16)` object/generation tuple. */
-export interface PdfSourceSpan {
-    streamRef: [number, number];
-    contentsIndex: number;
-    operatorIndex: number;
-    operandIndex: number;
-    glyphStart: number;
-    glyphEnd: number;
-    expectedText: string;
-    expectedDigest: string;
-}
-/** Not specified as a concrete Rust type in §7.2 — inferred as the two catalog origins the section
- *  narrative distinguishes ("bundled fonts such as Source Serif 4 plus eligible system fonts"). */
-export type PdfFontSource = "bundled" | "system";
-export interface PdfFontCatalogEntry {
-    id: string;
-    family: string;
-    postscriptName: string | null;
-    styles: string[];
-    embeddable: boolean;
-    subsettable: boolean;
-    source: PdfFontSource;
-}
-export type PdfColor = {
-    r: number;
-    g: number;
-    b: number;
-    alpha: number;
-};
-export type PdfTextAppearance = {
-    fontId: string;
-    family: string;
-    sizePt: number;
-    color: PdfColor;
-};
-export type PdfSourceEdit = {
-    kind: "replaceSourceText";
-    id: string;
-    locator: PdfSourceLocator;
-    before: {
-        text: string;
-        appearance: PdfTextAppearance;
-    };
-    after: {
-        text: string;
-        appearance: PdfTextAppearance;
-    };
-    availableBounds: PdfRect;
-};
-export type PdfAddText = {
-    kind: "addText";
-    id: string;
-    page: number;
-    anchor: PdfPoint;
-    text: string;
-    appearance: PdfTextAppearance;
-};
-export type PdfOcrCorrection = {
-    kind: "correctOcrText";
-    id: string;
-    page: number;
-    lineId: string;
-    rect: PdfRect;
-    text: string;
-    appearance: PdfTextAppearance;
-    coverColor: PdfColor;
-    backgroundProof: "nearUniform";
-};
-export type PdfEditCommand = PdfSourceEdit | PdfAddText | PdfOcrCorrection;
-/** Narrows `command` to `PdfSourceEdit`. Trivial given the `kind` discriminant, but kept as a named
- *  helper so call sites read intent rather than re-deriving the literal each time. */
-export declare function isPdfSourceEdit(command: PdfEditCommand): command is PdfSourceEdit;
-/** Narrows `command` to `PdfAddText`. */
-export declare function isPdfAddText(command: PdfEditCommand): command is PdfAddText;
-export declare function isPdfOcrCorrection(command: PdfEditCommand): command is PdfOcrCorrection;
-export type PdfEditSession = {
-    mode: "view" | "edit";
-    tool: "selectText" | "addText" | "highlight" | "ink" | "image";
-    selection: PdfSelection | null;
-    draft: PdfTextDraft | null;
-    sourceCommands: readonly PdfEditCommand[];
-    sourceDigest: string;
-    savedSourceDigest: string;
-    annotationDirty: boolean;
-};
-/** The currently selected existing text island (§3.2). Not specified as a concrete shape in the
- *  contract text beyond "selection"; inferred as enough identity + geometry to drive highlight
- *  rendering and to seed a draft when the user starts editing it. */
-export interface PdfSelection {
-    page: number;
-    islandId: string;
-    locator: PdfSourceLocator;
-    rect: PdfRect;
-}
-/** The in-progress edit surfaced by the page-slot editor (§6.1). Covers both existing-text edits
- *  (`kind: "sourceEdit"`, seeded from a `PdfSelection`/island) and Add Text (`kind: "addText"`,
- *  seeded from a clicked `PdfPoint`). Not given as a concrete shape in the contract text; inferred
- *  from §6.1's `session.draft.rect` / `session.draft.page` usage and §3.3's overflow behavior
- *  ("editor shows overflow on page & Save is disabled for that command"). Commit-time logic builds
- *  a `PdfSourceEdit` or `PdfAddText` from these fields. */
-export type PdfTextDraft = {
-    kind: "sourceEdit" | "addText" | "ocrEdit";
-    id: string;
-    page: number;
-    rect: PdfRect;
-    text: string;
-    appearance: PdfTextAppearance;
-    /** `sourceEdit` only: locator identifying the island being replaced. */
-    locator: PdfSourceLocator | null;
-    /** `sourceEdit` only: text/appearance snapshot at draft start, used to build the command's
-     *  `before` half and to detect a no-op commit. */
-    originalText: string | null;
-    originalAppearance: PdfTextAppearance | null;
-    /** `sourceEdit` only: verified bounds the replacement run must stay inside (§8). */
-    availableBounds: PdfRect | null;
-    /** `addText` only: the clicked PDF-space anchor point. */
-    anchor: PdfPoint | null;
-    /** `ocrEdit` only: stable recognized-line identity & locally sampled cover color. */
-    lineId?: string;
-    coverColor?: PdfColor;
-    backgroundProof?: "nearUniform";
-    /** True once the current draft geometry has been measured to exceed `availableBounds` (§3.3).
-     *  UI disables Save for this command while true; it never auto-shrinks/clips/wraps. */
-    overflow: boolean;
-};
-/** Narrows `draft` to a `sourceEdit` draft (editing an existing island). */
-export declare function isSourceEditDraft(draft: PdfTextDraft): draft is PdfTextDraft & {
-    kind: "sourceEdit";
-    locator: PdfSourceLocator;
-};
-/** Narrows `draft` to an `addText` draft (new text at a clicked point). */
-export declare function isAddTextDraft(draft: PdfTextDraft): draft is PdfTextDraft & {
-    kind: "addText";
-    anchor: PdfPoint;
-};
-/** Deterministic digest of an ordered command list. Two lists produce the same digest iff they
- *  have the same commands in the same order (object key order inside each command does not
- *  matter — `stableStringify` sorts keys). Empty history has a fixed, distinguishable digest. */
-export declare function computeSourceDigest(commands: readonly PdfEditCommand[]): string;
-/** Dirty-state derivation per §6: source edits are dirty when the live digest has diverged from
- *  the last-saved checkpoint, OR annotations changed. This is what "survives undo across save
- *  checkpoint" — a boolean "was written" flag would not, because undoing back to a *different*
- *  command list than what was saved is still dirty even though something was undone. */
-export declare function isSessionDirty(session: Pick<PdfEditSession, "sourceDigest" | "savedSourceDigest" | "annotationDirty">): boolean;
-export type PdfEditErrorCode = "stale_source" | "source_digest_mismatch" | "no_unique_match" | "unsupported_transform" | "unsupported_encoding" | "missing_glyph" | "font_embedding_denied" | "text_overflow" | "malformed_content" | "encrypted_document" | "annotation_serialization_failed" | "verification_failed" | "write_conflict";
-export declare const PDF_EDIT_ERROR_CODES: readonly PdfEditErrorCode[];
-/** Typed IPC error for every fallible PDF-edit command in this contract (§5.2, §7.2, §9.4, §10.1,
- *  §10.3). `message` carries the contextual, non-document-text detail §11 requires ("Logs include
- *  code/page/strategy but no document text"). */
-export interface PdfEditError {
-    code: PdfEditErrorCode;
-    message: string;
-}
-/** Runtime guard for `code`, primarily useful when classifying an unknown IPC rejection (mirrors
- *  the narrowing `parseHostError` does for `ClassifiedError` in tauriBridge.ts). */
-export declare function isPdfEditErrorCode(code: unknown): code is PdfEditErrorCode;
-/** Not given as a concrete Rust type in §10.1/§10.2 despite being referenced by
- *  `PreparedPdfSave.expectedText` and consumed by `verifyPdfCandidate` to check extracted text
- *  against the composed candidate. Inferred minimal shape: enough to locate which island on which
- *  page must contain which text after the isolated re-render (§10.2). */
-export interface PdfExpectedTextCheck {
-    page: number;
-    islandId: string;
-    expectedText: string;
-}
-export interface PreparePdfSaveRequest {
-    sourcePath: string;
-    expectedSourceSha256: string;
-    /** Raw invoke body per §4 — never a JSON number array. */
-    annotationPdfBytes: Uint8Array;
-    sourceCommands: readonly PdfEditCommand[];
-}
-export interface PreparedPdfSave {
-    token: string;
-    candidateSha256: string;
-    /** Raw `tauri::ipc::Response` body per §4. */
-    candidateBytes: Uint8Array;
-    affectedPages: readonly number[];
-    expectedText: readonly PdfExpectedTextCheck[];
-}
-/** Not given as a concrete Rust type anywhere in the contract — §10.3 explicitly requires "Save
- *  protocol... return a commit plan, not bare bytes" and states a successful commit "reloads
- *  active pdf.js document from committed bytes, refreshes graph/revision, clears annotation
- *  storage dirty state, & checkpoints sourceDigest." Inferred shape carries what the frontend needs
- *  to do all of that without a second round trip: the committed path/sha, which pages changed, and
- *  the fresh `PdfDocumentRevision` to refresh the graph from. */
-export interface PdfCommitResult {
-    committedPath: string;
-    committedSha256: string;
-    affectedPages: readonly number[];
-    revision: PdfDocumentRevision;
-    /** Disk commit succeeded while newer in-memory edits remain unsaved in active document. */
-    preservedUnsavedEdits?: boolean;
-}
-/** Exact shape from §10.3. Generic document saver (`useDocumentSaver.ts`, B8) updates
- *  recents/fingerprints/checkpoints only after `commit` succeeds and `didCommit` has run. */
-export type PdfSavePlan = {
-    commit(targetPath?: string): Promise<PdfCommitResult>;
-    didCommit(result: PdfCommitResult): Promise<void>;
-};
-/** §5.2 `inspect_pdf_page`. */
-export type InspectPdfPage = (path: string, page: number) => Promise<PdfPageGraph>;
-/** §7.2 `list_pdf_fonts`. */
-export type ListPdfFonts = () => Promise<PdfFontCatalogEntry[]>;
-export interface ComposePdfPreviewRequest {
-    sourcePath: string;
-    expectedSourceSha256: string;
-    sourceCommands: readonly PdfEditCommand[];
-}
-export interface ComposedPdfPreview {
-    /** Raw `tauri::ipc::Response` body per §4 — memory-only candidate bytes, never persisted. */
-    candidateBytes: Uint8Array;
-    affectedPages: readonly number[];
-}
-/** §9.4 `compose_pdf_preview`. Memory-only: no token, no retained candidate, no writes. */
-export type ComposePdfPreview = (request: ComposePdfPreviewRequest) => Promise<ComposedPdfPreview>;
-/** §10.1 `prepare_pdf_save`. */
-export type PreparePdfSave = (request: PreparePdfSaveRequest) => Promise<PreparedPdfSave>;
-/** §10.3 `commit_pdf_save`. */
-export type CommitPdfSave = (token: string, targetPath?: string) => Promise<PdfCommitResult>;

package/dist/documents/pdf/pdfEditModel.js

@@ -1,105 +0,0 @@
-/**
- * Canonical frontend model for sparse PDF edits.
- *
- * This file is the frozen cross-lane seam described in `docs/PDF-EDITOR-DISPATCH.md`
- * ("Frozen cross-lane seams"): it owns every shared frontend type — the Rust wire-model mirrors
- * (`docs/PDF-EDITOR-NOW.md` §5.1), the session/command types (§6), `PdfSavePlan` (§10.3), the typed
- * `PdfEditError` union (§11), and the *injected-bridge* function signatures other lanes accept by
- * injection ahead of the real `tauriBridge.ts` implementations landing at Dispatch D2.
- *
- * PDF pages are fixed-layout scenes, not word-processing documents. Existing content therefore
- * enters the editor as small, source-backed "islands" reported by the Rust inspector
- * (`inspect_pdf_page`, §5.2). Every edit command retains a stable source locator (§5.1) so
- * persistence (§9) can patch only changed content instead of clearing and reconstructing a page.
- *
- * This is a contract-definition file: types plus small pure helpers. Session lifecycle, draft
- * commit/cancel orchestration, and the real bridge live elsewhere (`usePdfEditSession.ts`,
- * `pdfSave.ts`, `tauriBridge.ts` — see `docs/PDF-EDITOR-NOW.md` §12).
- */
-/** Narrows `command` to `PdfSourceEdit`. Trivial given the `kind` discriminant, but kept as a named
- *  helper so call sites read intent rather than re-deriving the literal each time. */
-export function isPdfSourceEdit(command) {
-    return command.kind === "replaceSourceText";
-}
-/** Narrows `command` to `PdfAddText`. */
-export function isPdfAddText(command) {
-    return command.kind === "addText";
-}
-export function isPdfOcrCorrection(command) {
-    return command.kind === "correctOcrText";
-}
-/** Narrows `draft` to a `sourceEdit` draft (editing an existing island). */
-export function isSourceEditDraft(draft) {
-    return draft.kind === "sourceEdit";
-}
-/** Narrows `draft` to an `addText` draft (new text at a clicked point). */
-export function isAddTextDraft(draft) {
-    return draft.kind === "addText";
-}
-// ---------------------------------------------------------------------------------------------
-// Digest / dirty-state helpers (§6)
-// ---------------------------------------------------------------------------------------------
-//
-// Pure, deterministic, order-sensitive. `computeSourceDigest` is the canonical way session logic
-// (owned by usePdfEditSession.ts) derives `PdfEditSession.sourceDigest` from the current ordered
-// `sourceCommands`; order sensitivity matters because undo/redo changes the array's tail and must
-// therefore change the digest even when only the newest command differs.
-function stableStringify(value) {
-    if (value === null || typeof value !== "object") {
-        return JSON.stringify(value);
-    }
-    if (Array.isArray(value)) {
-        return `[${value.map(stableStringify).join(",")}]`;
-    }
-    const record = value;
-    const keys = Object.keys(record).sort();
-    const entries = keys.map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`);
-    return `{${entries.join(",")}}`;
-}
-/** FNV-1a over a UTF-16-code-unit string. Not cryptographic; only used to derive a short, stable,
- *  collision-resistant-enough-for-UI digest of the in-memory command list. Structurally identical
- *  to the hashing approach the superseded file used for island ids, generalized to hash any
- *  stable-stringified value. */
-function fnv1a(text) {
-    let hash = 0x811c9dc5;
-    for (let i = 0; i < text.length; i += 1) {
-        hash ^= text.charCodeAt(i);
-        hash = Math.imul(hash, 0x01000193);
-    }
-    return (hash >>> 0).toString(16).padStart(8, "0");
-}
-/** Deterministic digest of an ordered command list. Two lists produce the same digest iff they
- *  have the same commands in the same order (object key order inside each command does not
- *  matter — `stableStringify` sorts keys). Empty history has a fixed, distinguishable digest. */
-export function computeSourceDigest(commands) {
-    if (commands.length === 0)
-        return "empty";
-    return fnv1a(stableStringify(commands));
-}
-/** Dirty-state derivation per §6: source edits are dirty when the live digest has diverged from
- *  the last-saved checkpoint, OR annotations changed. This is what "survives undo across save
- *  checkpoint" — a boolean "was written" flag would not, because undoing back to a *different*
- *  command list than what was saved is still dirty even though something was undone. */
-export function isSessionDirty(session) {
-    return session.sourceDigest !== session.savedSourceDigest || session.annotationDirty;
-}
-export const PDF_EDIT_ERROR_CODES = [
-    "stale_source",
-    "source_digest_mismatch",
-    "no_unique_match",
-    "unsupported_transform",
-    "unsupported_encoding",
-    "missing_glyph",
-    "font_embedding_denied",
-    "text_overflow",
-    "malformed_content",
-    "encrypted_document",
-    "annotation_serialization_failed",
-    "verification_failed",
-    "write_conflict",
-];
-/** Runtime guard for `code`, primarily useful when classifying an unknown IPC rejection (mirrors
- *  the narrowing `parseHostError` does for `ClassifiedError` in tauriBridge.ts). */
-export function isPdfEditErrorCode(code) {
-    return typeof code === "string" && PDF_EDIT_ERROR_CODES.includes(code);
-}

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

@@ -1,100 +0,0 @@
-/** The editor tools this app exposes. "none" means the pure viewer (no AnnotationEditorLayer
- *  active) — the default, matching the view-first invariant. Values mirror pdf.js's own
- *  AnnotationEditorType numeric enum (kept here as a stable, decoupled mapping — see
- *  ANNOTATION_EDITOR_TYPE below — so this file doesn't need the real pdfjs-dist import to be
- *  unit-tested). */
-export type PdfEditorMode = "none" | "freeText" | "ink" | "highlight" | "stamp";
-export type PdfSaveFunction = () => Promise<Uint8Array | null>;
-/** Mirrors pdfjs-dist's `AnnotationEditorType` numeric values (checked against
- *  node_modules/pdfjs-dist 6.2.108). Declared locally so pure helpers below don't need to import
- *  the real (heavy) pdfjs-dist module. usePdfEditor.ts cross-checks these against the live
- *  `pdfjs.AnnotationEditorType` export at runtime instead of trusting this duplication blindly. */
-export declare const ANNOTATION_EDITOR_TYPE: {
-    readonly NONE: 0;
-    readonly FREETEXT: 3;
-    readonly HIGHLIGHT: 9;
-    readonly STAMP: 13;
-    readonly INK: 15;
-};
-export declare function modeToAnnotationEditorType(mode: PdfEditorMode): number;
-/**
- * pdf.js's low-level `TextLayer` renders into a caller-owned element, but
- * `AnnotationEditorLayer` expects the viewer-level shape `{ div }`. Keep that runtime contract
- * explicit so a raw `HTMLDivElement` or low-level `TextLayer` cannot be passed accidentally.
- */
-export declare function createPdfEditorTextLayerAdapter(div: HTMLDivElement): {
-    readonly div: HTMLDivElement;
-};
-export interface PdfEditorToolDef {
-    mode: PdfEditorMode;
-    label: string;
-    title: string;
-}
-export declare const PDF_EDITOR_TOOLS: PdfEditorToolDef[];
-/** This app's own precise contract for `AnnotationEditorUIManager.addCommands`'s single argument
- *  (pdf.js itself types it as a loose `Object` — see comment above). Field semantics reverse-
- *  engineered from `CommandManager#add` in node_modules/pdfjs-dist/build/pdf.mjs. */
-export interface PdfCommandManagerCommand {
-    /** Applies the command. Run synchronously inside `addCommands` when `mustExec` is true, and again
-     *  on every `redo()`. */
-    cmd: () => void;
-    /** Reverts the command. Run on every `undo()`. */
-    undo: () => void;
-    /** Optional side effect run immediately after `undo`/`cmd` on `undo()`/`redo()` respectively (not
-     *  on the initial `addCommands` call itself) — `CommandManager#undo`/`#redo` both call
-     *  `post?.()` right after invoking `undo`/`cmd`. */
-    post?: () => void;
-    /** When true, `cmd` runs immediately inside `addCommands` (not deferred to first redo). Every
-     *  call site inside pdf.js itself passes `true`. */
-    mustExec: boolean;
-    /** Numeric command-type tag consulted only by `overwriteIfSameType` (in-place replacement of the
-     *  current history entry) and `cleanUndoStack(type)`; pdf.js never validates or restricts this
-     *  value itself. See SOURCE_TEXT_COMMAND below for this app's reserved tag. */
-    type?: number;
-    /** When true, and the entry at the manager's current history position has a matching `type`,
-     *  `addCommands` overwrites that entry in place instead of pushing a new history entry — used by
-     *  pdf.js for live-dragging param updates (e.g. a font-size slider generating many intermediate
-     *  values that should collapse to one undo step). */
-    overwriteIfSameType?: boolean;
-    /** Only meaningful together with `overwriteIfSameType: true` — when true, an in-place overwrite
-     *  keeps the *original* entry's `undo` callback instead of replacing it with the new one. */
-    keepUndo?: boolean;
-}
-/** The subset of pdf.js's `AnnotationEditorUIManager` this app relies on for §6.2's unified
- *  document history, typed precisely (see PdfCommandManagerCommand above) so call sites do not need
- *  usePdfEditor.ts's broader `AnyUIManager` escape hatch just to push one source-text command. */
-export interface PdfCommandManagerHost {
-    addCommands: (params: PdfCommandManagerCommand) => void;
-    undo: () => void;
-    redo: () => void;
-}
-/** This app's reserved `AnnotationEditorUIManager` command-type tag (§6.2) for source-text edits.
- *  Checked against every command-type value pdf.js itself uses internally
- *  (node_modules/pdfjs-dist/build/pdf.mjs): `AnnotationEditorParamsType` tops out at 41
- *  (DRAW_STEP) and `AnnotationEditorType` tops out at 102 (COMMENT) — neither collides with
- *  0x5652 (22098). Collision would not corrupt history regardless (this app always passes
- *  `overwriteIfSameType: false`, so `type` is never compared against pdf.js's own command types),
- *  but a distinct, verified-unique value keeps entries identifiable if that ever changes. */
-export declare const SOURCE_TEXT_COMMAND = 22098;
-/** Minimal source-edit session contract `pushSourceCommand` drives: applying, reverting, and
- *  publishing one staged edit. Kept generic over the command payload (`TCommand`) so this file does
- *  not couple to whichever module currently owns the concrete PdfEditCommand/session-controller
- *  shape (§6, §12 — usePdfEditSession.ts) — matching this file's existing house style of staying
- *  dependency-free of heavier pdf.js/session types (see file header). */
-export interface PdfSourceCommandSession<TCommand> {
-    /** Applies `command` to the session's staged source-edit state (e.g. append/replace it in
-     *  `sourceCommands`, recompute `sourceDigest`). */
-    apply: (command: TCommand) => void;
-    /** Reverts the effect of `apply(command)`. */
-    revert: (command: TCommand) => void;
-    /** Runs after every apply/revert reached through undo or redo — the hook for the §9.4 in-memory
-     *  preview recompose. Not invoked by `pushSourceCommand` itself on the initial push (mirrors
-     *  `CommandManager#add`, which only calls `post` from `undo()`/`redo()`, never from `add()`). */
-    publish: () => void;
-}
-/**
- * Pushes one source-text edit onto pdf.js's shared `AnnotationEditorUIManager` command history
- * (§6.2) so source-text and annotation edits undo/redo in one chronological order instead of two
- * independent stacks. Do not maintain a second, independent undo stack for source edits.
- */
-export declare function pushSourceCommand<TCommand>(uiManager: PdfCommandManagerHost, session: PdfSourceCommandSession<TCommand>, command: TCommand): void;

package/dist/documents/pdf/pdfEditor.js

@@ -1,68 +0,0 @@
-// Stage 1 PDF editing — pure helpers shared between the toolbar and usePdfEditor. Kept dependency-
-// free of pdfjs-dist's class exports (those are only imported where the real UIManager is built) so
-// this module is trivial to unit test.
-/** Mirrors pdfjs-dist's `AnnotationEditorType` numeric values (checked against
- *  node_modules/pdfjs-dist 6.2.108). Declared locally so pure helpers below don't need to import
- *  the real (heavy) pdfjs-dist module. usePdfEditor.ts cross-checks these against the live
- *  `pdfjs.AnnotationEditorType` export at runtime instead of trusting this duplication blindly. */
-export const ANNOTATION_EDITOR_TYPE = {
-    NONE: 0,
-    FREETEXT: 3,
-    HIGHLIGHT: 9,
-    STAMP: 13,
-    INK: 15,
-};
-export function modeToAnnotationEditorType(mode) {
-    switch (mode) {
-        case "freeText":
-            return ANNOTATION_EDITOR_TYPE.FREETEXT;
-        case "ink":
-            return ANNOTATION_EDITOR_TYPE.INK;
-        case "highlight":
-            return ANNOTATION_EDITOR_TYPE.HIGHLIGHT;
-        case "stamp":
-            return ANNOTATION_EDITOR_TYPE.STAMP;
-        default:
-            return ANNOTATION_EDITOR_TYPE.NONE;
-    }
-}
-/**
- * pdf.js's low-level `TextLayer` renders into a caller-owned element, but
- * `AnnotationEditorLayer` expects the viewer-level shape `{ div }`. Keep that runtime contract
- * explicit so a raw `HTMLDivElement` or low-level `TextLayer` cannot be passed accidentally.
- */
-export function createPdfEditorTextLayerAdapter(div) {
-    return { div };
-}
-// "Sign" here is a drawn/typed/image stamp placed on the page — NOT cryptographic PKI signing,
-// which pdf.js does not implement. Keep the toolbar copy honest about that (see PdfToolbar.tsx).
-export const PDF_EDITOR_TOOLS = [
-    { mode: "freeText", label: "text", title: "Add text" },
-    { mode: "ink", label: "draw", title: "Draw (ink)" },
-    { mode: "highlight", label: "highlight", title: "Highlight" },
-    { mode: "stamp", label: "image", title: "Add image stamp" },
-];
-/** This app's reserved `AnnotationEditorUIManager` command-type tag (§6.2) for source-text edits.
- *  Checked against every command-type value pdf.js itself uses internally
- *  (node_modules/pdfjs-dist/build/pdf.mjs): `AnnotationEditorParamsType` tops out at 41
- *  (DRAW_STEP) and `AnnotationEditorType` tops out at 102 (COMMENT) — neither collides with
- *  0x5652 (22098). Collision would not corrupt history regardless (this app always passes
- *  `overwriteIfSameType: false`, so `type` is never compared against pdf.js's own command types),
- *  but a distinct, verified-unique value keeps entries identifiable if that ever changes. */
-export const SOURCE_TEXT_COMMAND = 0x5652;
-/**
- * Pushes one source-text edit onto pdf.js's shared `AnnotationEditorUIManager` command history
- * (§6.2) so source-text and annotation edits undo/redo in one chronological order instead of two
- * independent stacks. Do not maintain a second, independent undo stack for source edits.
- */
-export function pushSourceCommand(uiManager, session, command) {
-    uiManager.addCommands({
-        cmd: () => session.apply(command),
-        undo: () => session.revert(command),
-        post: () => session.publish(),
-        mustExec: true,
-        type: SOURCE_TEXT_COMMAND,
-        overwriteIfSameType: false,
-        keepUndo: false,
-    });
-}

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

@@ -1,36 +0,0 @@
-import type { PDFPageProxy } from "pdfjs-dist";
-export type OcrRect = {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-};
-export type OcrLine = {
-    text: string;
-    rect: OcrRect;
-    confidence: number | null;
-};
-/** These prefixes are a cross-language contract with src-tauri/crates/ocr/src/lib.rs; they must not drift. */
-export declare const WINDOWS_OCR_UNAVAILABLE_PREFIX = "windows-ocr-unavailable:";
-export declare const MACOS_VISION_UNAVAILABLE_PREFIX = "macos-vision-unavailable:";
-export declare const OCR_UNSUPPORTED_PLATFORM_PREFIX = "ocr-unsupported-platform:";
-/**
- * Fast eligibility check used while browsing. It reads only the streamed text layer, so opening
- * a document or changing pages never asks pdf.js to decode every page's operator list.
- */
-export declare function isTextlessPage(page: PDFPageProxy): Promise<boolean>;
-/**
- * Scanned-page recognition is offered only when there is no usable text and the page paints an
- * image: streamed text is authoritative because WKWebView's pdf.js worker can leave a parallel
- * getTextContent() request empty even while the visible streamed text layer has content, and the
- * image check prevents genuinely blank pages from being sent to OCR.
- */
-export declare function isProbablyScannedPage(page: PDFPageProxy): Promise<boolean>;
-/**
- * Rasterizes one PDF page at 300 DPI by default. 300 DPI is the standard floor for reliable text
- * recognition on scanned documents; pdf.js's default page space is 72 DPI, so the scale converts
- * directly from points to the requested pixel density.
- */
-export declare function renderPageToPng(page: PDFPageProxy, dpi?: number, rotation?: number): Promise<Blob>;
-export { ocrPage, ocrAvailable, ocrBackendMissing } from "../../state/tauriBridge.js";
-export declare function isBackendUnavailable(message: string): boolean;