@nice2dev/ui-tools 1.0.10

package/dist/pdf-tools.d.ts

@@ -0,0 +1,1003 @@
+/**
+ * @file pdf-tools.ts
+ * @module @nice2dev/ui-tools
+ * @description PRO-14.1 — PDF Tools
+ *
+ * Types for PDF tools: viewer, editor, annotations, forms, merge/split,
+ * compress, signatures, redaction, OCR, comparison, and conversion.
+ */
+/** PDF document state */
+export type PDFDocumentState = 'loading' | 'loaded' | 'error' | 'empty';
+/** Page rotation angle */
+export type PageRotation = 0 | 90 | 180 | 270;
+/** Page fit mode */
+export type PageFitMode = 'page-width' | 'page-height' | 'page-fit' | 'actual-size' | 'percentage';
+/** Annotation type */
+export type PDFAnnotationType = 'highlight' | 'underline' | 'strikeout' | 'squiggly' | 'freetext' | 'note' | 'ink' | 'line' | 'rectangle' | 'ellipse' | 'polygon' | 'polyline' | 'stamp' | 'caret' | 'link' | 'fileattachment' | 'sound' | 'movie' | 'widget' | 'redact';
+/** PDF viewer configuration */
+export interface PDFViewerConfig {
+    /** Document source */
+    source: PDFSource;
+    /** Initial page number */
+    initialPage?: number;
+    /** Initial zoom level */
+    initialZoom?: number;
+    /** Fit mode */
+    fitMode?: PageFitMode;
+    /** Page layout */
+    pageLayout?: PageLayout;
+    /** Scroll mode */
+    scrollMode?: ScrollMode;
+    /** Spread mode */
+    spreadMode?: SpreadMode;
+    /** Rotation */
+    rotation?: PageRotation;
+    /** Enable text selection */
+    textSelection?: boolean;
+    /** Enable text search */
+    searchEnabled?: boolean;
+    /** Enable annotations */
+    annotationsEnabled?: boolean;
+    /** Enable forms */
+    formsEnabled?: boolean;
+    /** Enable printing */
+    printEnabled?: boolean;
+    /** Enable download */
+    downloadEnabled?: boolean;
+    /** Enable fullscreen */
+    fullscreenEnabled?: boolean;
+    /** Show toolbar */
+    showToolbar?: boolean;
+    /** Show sidebar */
+    showSidebar?: boolean;
+    /** Sidebar tab */
+    sidebarTab?: SidebarTab;
+    /** Theme */
+    theme?: 'light' | 'dark' | 'auto';
+    /** Password for encrypted PDFs */
+    password?: string;
+    /** CORS proxy URL */
+    corsProxy?: string;
+    /** Worker source */
+    workerSrc?: string;
+    /** CMap URL */
+    cMapUrl?: string;
+}
+/** PDF source */
+export interface PDFSource {
+    type: 'url' | 'base64' | 'file' | 'arraybuffer' | 'blob';
+    url?: string;
+    data?: string | ArrayBuffer | Blob | File;
+    filename?: string;
+    httpHeaders?: Record<string, string>;
+    withCredentials?: boolean;
+}
+/** Page layout mode */
+export type PageLayout = 'single' | 'continuous' | 'two-column' | 'two-column-continuous';
+/** Scroll mode */
+export type ScrollMode = 'vertical' | 'horizontal' | 'wrapped' | 'page';
+/** Spread mode */
+export type SpreadMode = 'none' | 'odd' | 'even';
+/** Sidebar tab */
+export type SidebarTab = 'thumbnails' | 'outline' | 'attachments' | 'annotations' | 'layers';
+/** PDF document metadata */
+export interface PDFDocumentInfo {
+    /** Number of pages */
+    numPages: number;
+    /** Document title */
+    title?: string;
+    /** Document author */
+    author?: string;
+    /** Document subject */
+    subject?: string;
+    /** Document keywords */
+    keywords?: string;
+    /** Creator application */
+    creator?: string;
+    /** Producer application */
+    producer?: string;
+    /** Creation date */
+    creationDate?: Date;
+    /** Modification date */
+    modDate?: Date;
+    /** PDF version */
+    pdfVersion?: string;
+    /** Is encrypted */
+    isEncrypted?: boolean;
+    /** Permissions */
+    permissions?: PDFPermissions;
+    /** File size in bytes */
+    fileSize?: number;
+    /** Is linearized (fast web view) */
+    isLinearized?: boolean;
+    /** Is tagged (accessibility) */
+    isTagged?: boolean;
+    /** Is AcroForm present */
+    hasAcroForm?: boolean;
+    /** Is XFA form */
+    isXFA?: boolean;
+    /** Custom metadata */
+    metadata?: Record<string, string>;
+}
+/** PDF permissions */
+export interface PDFPermissions {
+    printing?: 'none' | 'low-resolution' | 'high-resolution';
+    modification?: boolean;
+    copying?: boolean;
+    annotating?: boolean;
+    formFilling?: boolean;
+    contentAccessibility?: boolean;
+    documentAssembly?: boolean;
+}
+/** PDF page info */
+export interface PDFPageInfo {
+    pageNumber: number;
+    width: number;
+    height: number;
+    rotation: PageRotation;
+    userUnit?: number;
+    mediaBox?: PDFRect;
+    cropBox?: PDFRect;
+    bleedBox?: PDFRect;
+    trimBox?: PDFRect;
+    artBox?: PDFRect;
+}
+/** PDF rectangle */
+export interface PDFRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** PDF outline item (bookmark) */
+export interface PDFOutlineItem {
+    title: string;
+    destination?: PDFDestination;
+    action?: PDFAction;
+    color?: PDFColor;
+    bold?: boolean;
+    italic?: boolean;
+    items?: PDFOutlineItem[];
+    count?: number;
+    expanded?: boolean;
+}
+/** PDF destination */
+export interface PDFDestination {
+    pageNumber: number;
+    type: 'XYZ' | 'Fit' | 'FitH' | 'FitV' | 'FitR' | 'FitB' | 'FitBH' | 'FitBV';
+    left?: number;
+    top?: number;
+    right?: number;
+    bottom?: number;
+    zoom?: number;
+}
+/** PDF action */
+export interface PDFAction {
+    type: 'GoTo' | 'GoToR' | 'GoToE' | 'Launch' | 'URI' | 'Named' | 'JavaScript' | 'SubmitForm' | 'ResetForm';
+    destination?: PDFDestination;
+    url?: string;
+    filename?: string;
+    newWindow?: boolean;
+    namedAction?: string;
+    script?: string;
+}
+/** PDF color */
+export interface PDFColor {
+    r: number;
+    g: number;
+    b: number;
+    a?: number;
+}
+/** PDF attachment */
+export interface PDFAttachment {
+    filename: string;
+    description?: string;
+    creationDate?: Date;
+    modificationDate?: Date;
+    size?: number;
+    mimeType?: string;
+    content?: ArrayBuffer;
+}
+/** Text search options */
+export interface PDFSearchOptions {
+    query: string;
+    caseSensitive?: boolean;
+    wholeWord?: boolean;
+    regex?: boolean;
+    highlightAll?: boolean;
+    pageRange?: {
+        start: number;
+        end: number;
+    };
+}
+/** Text search result */
+export interface PDFSearchResult {
+    pageNumber: number;
+    matchIndex: number;
+    text: string;
+    rect: PDFRect;
+    context?: string;
+}
+/** PDF editor configuration */
+export interface PDFEditorConfig extends PDFViewerConfig {
+    /** Save mode */
+    saveMode?: 'download' | 'callback' | 'auto';
+    /** Auto-save interval (ms) */
+    autoSaveInterval?: number;
+    /** Enable undo/redo */
+    undoEnabled?: boolean;
+    /** Max undo steps */
+    maxUndoSteps?: number;
+    /** Enable page manipulation */
+    pageManipulation?: boolean;
+    /** Enable content editing */
+    contentEditing?: boolean;
+    /** Enable image editing */
+    imageEditing?: boolean;
+    /** Default font */
+    defaultFont?: string;
+    /** Default font size */
+    defaultFontSize?: number;
+    /** Default text color */
+    defaultTextColor?: string;
+}
+/** PDF edit operation */
+export type PDFEditOperation = PDFTextEditOperation | PDFImageEditOperation | PDFPageOperation | PDFAnnotationOperation | PDFFormOperation;
+/** Text edit operation */
+export interface PDFTextEditOperation {
+    type: 'text-add' | 'text-edit' | 'text-delete';
+    pageNumber: number;
+    rect?: PDFRect;
+    text?: string;
+    style?: PDFTextStyle;
+    contentId?: string;
+}
+/** Text style */
+export interface PDFTextStyle {
+    fontFamily?: string;
+    fontSize?: number;
+    fontWeight?: 'normal' | 'bold';
+    fontStyle?: 'normal' | 'italic';
+    color?: string;
+    backgroundColor?: string;
+    textAlign?: 'left' | 'center' | 'right' | 'justify';
+    lineHeight?: number;
+    letterSpacing?: number;
+}
+/** Image edit operation */
+export interface PDFImageEditOperation {
+    type: 'image-add' | 'image-edit' | 'image-delete';
+    pageNumber: number;
+    rect?: PDFRect;
+    imageData?: string | ArrayBuffer;
+    imageUrl?: string;
+    contentId?: string;
+    opacity?: number;
+}
+/** Page operation */
+export interface PDFPageOperation {
+    type: 'page-add' | 'page-delete' | 'page-rotate' | 'page-move' | 'page-crop' | 'page-resize';
+    pageNumber: number;
+    targetPageNumber?: number;
+    rotation?: PageRotation;
+    cropRect?: PDFRect;
+    newSize?: {
+        width: number;
+        height: number;
+    };
+    insertPosition?: 'before' | 'after';
+    blankPage?: boolean;
+}
+/** Annotation operation */
+export interface PDFAnnotationOperation {
+    type: 'annotation-add' | 'annotation-edit' | 'annotation-delete';
+    annotation?: PDFAnnotation;
+    annotationId?: string;
+}
+/** Form operation */
+export interface PDFFormOperation {
+    type: 'form-field-add' | 'form-field-edit' | 'form-field-delete' | 'form-fill';
+    field?: PDFFormField;
+    fieldName?: string;
+    value?: unknown;
+}
+/** PDF annotation */
+export interface PDFAnnotation {
+    id: string;
+    type: PDFAnnotationType;
+    pageNumber: number;
+    rect: PDFRect;
+    contents?: string;
+    author?: string;
+    creationDate?: Date;
+    modificationDate?: Date;
+    color?: string;
+    opacity?: number;
+    flags?: AnnotationFlags;
+    borderStyle?: AnnotationBorder;
+    appearance?: AnnotationAppearance;
+    popup?: PopupAnnotation;
+    replies?: PDFAnnotation[];
+    state?: AnnotationState;
+    stateModel?: AnnotationStateModel;
+    subject?: string;
+    richContents?: string;
+    quadPoints?: QuadPoint[];
+    inkList?: InkPath[];
+    vertices?: Point[];
+    lineStart?: Point;
+    lineEnd?: Point;
+    lineEndingStyles?: LineEndingStyles;
+    stampName?: string;
+    fileAttachment?: PDFAttachment;
+    soundContent?: SoundContent;
+    linkDest?: PDFDestination;
+    linkAction?: PDFAction;
+}
+/** Annotation flags */
+export interface AnnotationFlags {
+    invisible?: boolean;
+    hidden?: boolean;
+    print?: boolean;
+    noZoom?: boolean;
+    noRotate?: boolean;
+    noView?: boolean;
+    readOnly?: boolean;
+    locked?: boolean;
+    toggleNoView?: boolean;
+    lockedContents?: boolean;
+}
+/** Annotation border */
+export interface AnnotationBorder {
+    width?: number;
+    style?: 'solid' | 'dashed' | 'beveled' | 'inset' | 'underline';
+    dashArray?: number[];
+    cloudIntensity?: number;
+}
+/** Annotation appearance */
+export interface AnnotationAppearance {
+    normal?: string | ArrayBuffer;
+    rollover?: string | ArrayBuffer;
+    down?: string | ArrayBuffer;
+}
+/** Popup annotation */
+export interface PopupAnnotation {
+    rect: PDFRect;
+    open?: boolean;
+}
+/** Annotation state */
+export type AnnotationState = 'Marked' | 'Unmarked' | 'Accepted' | 'Rejected' | 'Cancelled' | 'Completed' | 'None';
+/** Annotation state model */
+export type AnnotationStateModel = 'Marked' | 'Review';
+/** Quad point for text markup */
+export interface QuadPoint {
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    x3: number;
+    y3: number;
+    x4: number;
+    y4: number;
+}
+/** Ink path */
+export interface InkPath {
+    points: Point[];
+}
+/** Point */
+export interface Point {
+    x: number;
+    y: number;
+}
+/** Line ending styles */
+export interface LineEndingStyles {
+    start?: LineEndingStyle;
+    end?: LineEndingStyle;
+}
+/** Line ending style */
+export type LineEndingStyle = 'None' | 'Square' | 'Circle' | 'Diamond' | 'OpenArrow' | 'ClosedArrow' | 'Butt' | 'ROpenArrow' | 'RClosedArrow' | 'Slash';
+/** Sound content */
+export interface SoundContent {
+    data: ArrayBuffer;
+    sampling?: number;
+    bits?: number;
+    channels?: number;
+    encoding?: 'Raw' | 'Signed' | 'muLaw' | 'ALaw';
+}
+/** Annotation tool */
+export interface AnnotationTool {
+    type: PDFAnnotationType;
+    color?: string;
+    opacity?: number;
+    thickness?: number;
+    fontSize?: number;
+    fontFamily?: string;
+    stampName?: string;
+}
+/** PDF form field */
+export interface PDFFormField {
+    name: string;
+    type: PDFFormFieldType;
+    pageNumber: number;
+    rect: PDFRect;
+    value?: unknown;
+    defaultValue?: unknown;
+    options?: FormFieldOption[];
+    maxLength?: number;
+    multiline?: boolean;
+    password?: boolean;
+    readonly?: boolean;
+    required?: boolean;
+    noExport?: boolean;
+    hidden?: boolean;
+    tooltip?: string;
+    alternateFieldName?: string;
+    mappingName?: string;
+    appearance?: FormFieldAppearance;
+    actions?: FormFieldActions;
+    validation?: FormFieldValidation;
+}
+/** Form field type */
+export type PDFFormFieldType = 'text' | 'checkbox' | 'radio' | 'select' | 'listbox' | 'button' | 'signature' | 'barcode';
+/** Form field option */
+export interface FormFieldOption {
+    label: string;
+    value: string;
+    selected?: boolean;
+}
+/** Form field appearance */
+export interface FormFieldAppearance {
+    backgroundColor?: string;
+    borderColor?: string;
+    borderWidth?: number;
+    borderStyle?: 'solid' | 'dashed' | 'beveled' | 'inset' | 'underline';
+    textColor?: string;
+    fontSize?: number;
+    fontFamily?: string;
+    textAlign?: 'left' | 'center' | 'right';
+    rotation?: PageRotation;
+}
+/** Form field actions */
+export interface FormFieldActions {
+    keystroke?: PDFAction;
+    format?: PDFAction;
+    validate?: PDFAction;
+    calculate?: PDFAction;
+    mouseUp?: PDFAction;
+    mouseDown?: PDFAction;
+    mouseEnter?: PDFAction;
+    mouseExit?: PDFAction;
+    focus?: PDFAction;
+    blur?: PDFAction;
+}
+/** Form field validation */
+export interface FormFieldValidation {
+    type?: 'none' | 'number' | 'percent' | 'date' | 'time' | 'custom';
+    min?: number;
+    max?: number;
+    pattern?: string;
+    customScript?: string;
+    errorMessage?: string;
+}
+/** Form data */
+export interface PDFFormData {
+    fields: Record<string, unknown>;
+    format?: 'fdf' | 'xfdf' | 'json';
+}
+/** Form submission */
+export interface PDFFormSubmission {
+    url: string;
+    method?: 'GET' | 'POST';
+    format?: 'fdf' | 'xfdf' | 'html' | 'pdf';
+    fields?: string[];
+    includeAnnotations?: boolean;
+    includeNoValueFields?: boolean;
+    excludeNonUserAnnotations?: boolean;
+    excudeHiddenFields?: boolean;
+    canonical?: boolean;
+}
+/** PDF merge configuration */
+export interface PDFMergeConfig {
+    sources: PDFMergeSource[];
+    outputFilename?: string;
+    outlines?: 'none' | 'preserve' | 'merge';
+    annotations?: boolean;
+    formFields?: boolean;
+    links?: boolean;
+    metadata?: PDFMergeMetadata;
+}
+/** PDF merge source */
+export interface PDFMergeSource {
+    source: PDFSource;
+    pageRange?: PDFPageRange;
+    rotation?: PageRotation;
+    password?: string;
+}
+/** Page range */
+export interface PDFPageRange {
+    type: 'all' | 'range' | 'pages';
+    start?: number;
+    end?: number;
+    pages?: number[];
+    reverse?: boolean;
+}
+/** Merge metadata */
+export interface PDFMergeMetadata {
+    title?: string;
+    author?: string;
+    subject?: string;
+    keywords?: string;
+    creator?: string;
+}
+/** PDF split configuration */
+export interface PDFSplitConfig {
+    source: PDFSource;
+    splitType: PDFSplitType;
+    pageRanges?: PDFPageRange[];
+    fixedPages?: number;
+    bookmarkLevel?: number;
+    filenamePattern?: string;
+    outputFormat?: 'pdf' | 'zip';
+}
+/** Split type */
+export type PDFSplitType = 'range' | 'each-page' | 'fixed-pages' | 'bookmarks' | 'blank-pages' | 'custom';
+/** Split result */
+export interface PDFSplitResult {
+    files: PDFSplitFile[];
+    totalPages: number;
+    totalFiles: number;
+}
+/** Split file */
+export interface PDFSplitFile {
+    filename: string;
+    pages: number[];
+    data?: ArrayBuffer;
+    url?: string;
+    size?: number;
+}
+/** PDF compression configuration */
+export interface PDFCompressConfig {
+    source: PDFSource;
+    quality: CompressionQuality;
+    options?: CompressionOptions;
+}
+/** Compression quality preset */
+export type CompressionQuality = 'low' | 'medium' | 'high' | 'maximum' | 'custom';
+/** Compression options */
+export interface CompressionOptions {
+    imageCompression?: ImageCompressionOptions;
+    fontOptimization?: FontOptimizationOptions;
+    removeObjects?: RemoveObjectsOptions;
+    linearize?: boolean;
+    cleanupOptions?: CleanupOptions;
+}
+/** Image compression options */
+export interface ImageCompressionOptions {
+    enabled: boolean;
+    maxResolution?: number;
+    colorResolution?: number;
+    grayscaleResolution?: number;
+    monochromeResolution?: number;
+    jpegQuality?: number;
+    convertToJpeg?: boolean;
+    removeAlphaChannel?: boolean;
+    downsample?: 'none' | 'average' | 'bicubic' | 'subsample';
+}
+/** Font optimization options */
+export interface FontOptimizationOptions {
+    enabled: boolean;
+    subset?: boolean;
+    flatten?: boolean;
+    convertToOutlines?: boolean;
+    removeUnusedFonts?: boolean;
+}
+/** Remove objects options */
+export interface RemoveObjectsOptions {
+    removeAnnotations?: boolean;
+    removeBookmarks?: boolean;
+    removeEmbeddedContent?: boolean;
+    removeFormFields?: boolean;
+    removeJavaScript?: boolean;
+    removeLinks?: boolean;
+    removeMetadata?: boolean;
+    removePieceInfo?: boolean;
+    removeThumbnails?: boolean;
+    removeUnusedResources?: boolean;
+}
+/** Cleanup options */
+export interface CleanupOptions {
+    removeUnusedObjects?: boolean;
+    compressObjectStreams?: boolean;
+    removeInvalidLinks?: boolean;
+    removeUnusedNamedDests?: boolean;
+    flattenFields?: boolean;
+}
+/** Compression result */
+export interface PDFCompressResult {
+    originalSize: number;
+    compressedSize: number;
+    compressionRatio: number;
+    data?: ArrayBuffer;
+    url?: string;
+    statistics?: CompressionStatistics;
+}
+/** Compression statistics */
+export interface CompressionStatistics {
+    imagesCompressed: number;
+    fontsOptimized: number;
+    objectsRemoved: number;
+    savingsPerCategory: Record<string, number>;
+}
+/** Digital signature configuration */
+export interface PDFSignatureConfig {
+    certificate: SignatureCertificate;
+    appearance?: SignatureAppearance;
+    location?: string;
+    reason?: string;
+    contactInfo?: string;
+    permissions?: SignaturePermissions;
+    timestamp?: TimestampConfig;
+    ltv?: boolean;
+    certification?: boolean;
+}
+/** Signature certificate */
+export interface SignatureCertificate {
+    type: 'pfx' | 'p12' | 'pkcs11' | 'windows' | 'mac';
+    data?: ArrayBuffer;
+    password?: string;
+    alias?: string;
+    pin?: string;
+    library?: string;
+    tokenSlot?: number;
+}
+/** Signature appearance */
+export interface SignatureAppearance {
+    pageNumber: number;
+    rect: PDFRect;
+    showName?: boolean;
+    showDate?: boolean;
+    showReason?: boolean;
+    showLocation?: boolean;
+    showLogo?: boolean;
+    logo?: string | ArrayBuffer;
+    backgroundColor?: string;
+    textColor?: string;
+    fontSize?: number;
+    fontFamily?: string;
+    format?: string;
+    customImage?: string | ArrayBuffer;
+}
+/** Signature permissions */
+export interface SignaturePermissions {
+    allowFilling?: boolean;
+    allowAnnotations?: boolean;
+    allowAssembly?: boolean;
+    preventChanges?: boolean;
+}
+/** Timestamp configuration */
+export interface TimestampConfig {
+    url: string;
+    username?: string;
+    password?: string;
+    hashAlgorithm?: 'SHA-256' | 'SHA-384' | 'SHA-512';
+}
+/** Signature validation result */
+export interface SignatureValidationResult {
+    valid: boolean;
+    signerName?: string;
+    signatureDate?: Date;
+    certificateInfo?: CertificateInfo;
+    validationStatus: ValidationStatus;
+    timestampInfo?: TimestampInfo;
+    modifications?: DocumentModification[];
+}
+/** Validation status */
+export interface ValidationStatus {
+    integrityValid: boolean;
+    signerIdentityValid: boolean;
+    timestampValid?: boolean;
+    certificateValid: boolean;
+    chainValid: boolean;
+    revocationChecked: boolean;
+    errors?: string[];
+    warnings?: string[];
+}
+/** Certificate info */
+export interface CertificateInfo {
+    subject: string;
+    issuer: string;
+    serialNumber: string;
+    notBefore: Date;
+    notAfter: Date;
+    thumbprint: string;
+    algorithm: string;
+    keyUsage?: string[];
+    extendedKeyUsage?: string[];
+}
+/** Timestamp info */
+export interface TimestampInfo {
+    time: Date;
+    serialNumber?: string;
+    issuer?: string;
+    accuracy?: number;
+}
+/** Document modification */
+export interface DocumentModification {
+    type: 'content' | 'form' | 'annotation' | 'appearance' | 'other';
+    pageNumber?: number;
+    description: string;
+    allowed: boolean;
+}
+/** Redaction configuration */
+export interface PDFRedactionConfig {
+    source: PDFSource;
+    redactions: RedactionMark[];
+    options?: RedactionOptions;
+}
+/** Redaction mark */
+export interface RedactionMark {
+    type: 'area' | 'text' | 'search';
+    pageNumber: number;
+    rect?: PDFRect;
+    quadPoints?: QuadPoint[];
+    searchTerm?: string;
+    searchOptions?: PDFSearchOptions;
+    overlayText?: string;
+    overlayColor?: string;
+    fillColor?: string;
+    repeat?: boolean;
+}
+/** Redaction options */
+export interface RedactionOptions {
+    removeContent?: boolean;
+    removeMetadata?: boolean;
+    removeLinks?: boolean;
+    removeJavaScript?: boolean;
+    flattenAnnotations?: boolean;
+    sanitize?: boolean;
+}
+/** Redaction preview */
+export interface RedactionPreview {
+    marks: RedactionPreviewMark[];
+    totalMarks: number;
+    affectedPages: number[];
+}
+/** Redaction preview mark */
+export interface RedactionPreviewMark {
+    id: string;
+    pageNumber: number;
+    rect: PDFRect;
+    redactedText?: string;
+}
+/** OCR configuration */
+export interface PDFOCRConfig {
+    source: PDFSource;
+    language: string | string[];
+    outputType: OCROutputType;
+    options?: OCROptions;
+}
+/** OCR output type */
+export type OCROutputType = 'searchable-pdf' | 'searchable-pdf-exact' | 'text' | 'hocr' | 'alto';
+/** OCR options */
+export interface OCROptions {
+    pageRange?: PDFPageRange;
+    dpi?: number;
+    imagePreprocessing?: ImagePreprocessing;
+    forceOCR?: boolean;
+    ocrEngine?: 'tesseract' | 'cloud' | 'custom';
+    engineConfig?: Record<string, unknown>;
+    confidence?: number;
+    detectOrientation?: boolean;
+    deskew?: boolean;
+    cleanupImages?: boolean;
+}
+/** Image preprocessing */
+export interface ImagePreprocessing {
+    binarize?: boolean;
+    denoise?: boolean;
+    deskew?: boolean;
+    contrast?: number;
+    rotation?: number;
+}
+/** OCR result */
+export interface PDFOCRResult {
+    pages: OCRPageResult[];
+    totalWords: number;
+    averageConfidence: number;
+    data?: ArrayBuffer;
+    url?: string;
+}
+/** OCR page result */
+export interface OCRPageResult {
+    pageNumber: number;
+    text: string;
+    words: OCRWord[];
+    lines: OCRLine[];
+    blocks: OCRBlock[];
+    confidence: number;
+    orientation?: number;
+}
+/** OCR word */
+export interface OCRWord {
+    text: string;
+    rect: PDFRect;
+    confidence: number;
+    font?: string;
+    fontSize?: number;
+}
+/** OCR line */
+export interface OCRLine {
+    text: string;
+    rect: PDFRect;
+    words: OCRWord[];
+    baseline?: {
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+    };
+}
+/** OCR block */
+export interface OCRBlock {
+    type: 'text' | 'image' | 'table' | 'separator' | 'equation';
+    rect: PDFRect;
+    lines?: OCRLine[];
+    confidence?: number;
+}
+/** PDF comparison configuration */
+export interface PDFCompareConfig {
+    source1: PDFSource;
+    source2: PDFSource;
+    compareType: CompareType;
+    options?: CompareOptions;
+}
+/** Compare type */
+export type CompareType = 'text' | 'visual' | 'both';
+/** Compare options */
+export interface CompareOptions {
+    pageRange1?: PDFPageRange;
+    pageRange2?: PDFPageRange;
+    ignoreCase?: boolean;
+    ignoreWhitespace?: boolean;
+    ignoreFormatting?: boolean;
+    ignoreHeaders?: boolean;
+    ignoreFooters?: boolean;
+    ignorePageNumbers?: boolean;
+    tolerance?: number;
+    highlightColor?: {
+        added: string;
+        removed: string;
+        changed: string;
+    };
+    outputFormat?: 'side-by-side' | 'overlay' | 'inline';
+}
+/** Compare result */
+export interface PDFCompareResult {
+    identical: boolean;
+    differences: ComparisonDifference[];
+    pageComparisons: PageComparison[];
+    summary: ComparisonSummary;
+    diffDocument?: ArrayBuffer;
+}
+/** Comparison difference */
+export interface ComparisonDifference {
+    type: 'added' | 'removed' | 'changed' | 'moved';
+    pageNumber1?: number;
+    pageNumber2?: number;
+    rect1?: PDFRect;
+    rect2?: PDFRect;
+    content1?: string;
+    content2?: string;
+    category?: 'text' | 'image' | 'annotation' | 'form' | 'structure';
+}
+/** Page comparison */
+export interface PageComparison {
+    pageNumber1?: number;
+    pageNumber2?: number;
+    status: 'matched' | 'added' | 'removed' | 'different';
+    differences: ComparisonDifference[];
+    similarity?: number;
+}
+/** Comparison summary */
+export interface ComparisonSummary {
+    totalDifferences: number;
+    additions: number;
+    removals: number;
+    changes: number;
+    pagesIdentical: number;
+    pagesDifferent: number;
+    pagesAdded: number;
+    pagesRemoved: number;
+}
+/** PDF conversion configuration */
+export interface PDFConvertConfig {
+    source: ConvertSource;
+    outputFormat: ConvertOutputFormat;
+    options?: ConvertOptions;
+}
+/** Convert source */
+export interface ConvertSource {
+    type: ConvertInputFormat;
+    data: PDFSource | string | ArrayBuffer;
+}
+/** Input format */
+export type ConvertInputFormat = 'pdf' | 'image' | 'html' | 'word' | 'excel' | 'powerpoint' | 'text' | 'markdown' | 'epub';
+/** Output format */
+export type ConvertOutputFormat = 'pdf' | 'pdf-a' | 'pdf-x' | 'image-png' | 'image-jpeg' | 'image-tiff' | 'image-svg' | 'word' | 'excel' | 'powerpoint' | 'html' | 'text' | 'markdown';
+/** Convert options */
+export interface ConvertOptions {
+    pageRange?: PDFPageRange;
+    pdfVersion?: '1.4' | '1.5' | '1.6' | '1.7' | '2.0';
+    pdfAConformance?: 'PDF/A-1a' | 'PDF/A-1b' | 'PDF/A-2a' | 'PDF/A-2b' | 'PDF/A-2u' | 'PDF/A-3a' | 'PDF/A-3b' | 'PDF/A-3u';
+    pdfXConformance?: 'PDF/X-1a' | 'PDF/X-3' | 'PDF/X-4';
+    htmlOptions?: HTMLConvertOptions;
+    imageOptions?: ImageConvertOptions;
+    officeOptions?: OfficeConvertOptions;
+}
+/** HTML convert options */
+export interface HTMLConvertOptions {
+    encoding?: string;
+    embedImages?: boolean;
+    embedFonts?: boolean;
+    preserveLayout?: boolean;
+    singlePage?: boolean;
+    cssStyles?: 'inline' | 'external' | 'embedded';
+}
+/** Image convert options */
+export interface ImageConvertOptions {
+    resolution?: number;
+    quality?: number;
+    colorSpace?: 'rgb' | 'cmyk' | 'grayscale' | 'bitonal';
+    transparent?: boolean;
+    antialiasing?: boolean;
+    multiPage?: boolean;
+    compression?: 'none' | 'lzw' | 'jpeg' | 'zip' | 'ccitt';
+}
+/** Office convert options */
+export interface OfficeConvertOptions {
+    preserveFormatting?: boolean;
+    embedFonts?: boolean;
+    includeComments?: boolean;
+    includeMarkup?: boolean;
+}
+/** Convert result */
+export interface PDFConvertResult {
+    format: ConvertOutputFormat;
+    files: ConvertedFile[];
+    warnings?: string[];
+}
+/** Converted file */
+export interface ConvertedFile {
+    filename: string;
+    data?: ArrayBuffer;
+    url?: string;
+    size: number;
+    mimeType: string;
+}
+/** Thumbnail configuration */
+export interface PDFThumbnailConfig {
+    source: PDFSource;
+    size?: {
+        width: number;
+        height: number;
+    };
+    scale?: number;
+    format?: 'png' | 'jpeg' | 'webp';
+    quality?: number;
+    pageRange?: PDFPageRange;
+    transparent?: boolean;
+    background?: string;
+}
+/** Thumbnail result */
+export interface PDFThumbnailResult {
+    thumbnails: PageThumbnail[];
+}
+/** Page thumbnail */
+export interface PageThumbnail {
+    pageNumber: number;
+    width: number;
+    height: number;
+    data?: string;
+    url?: string;
+}
+//# sourceMappingURL=pdf-tools.d.ts.map