pdf-oxide 0.3.24 → 0.3.28

package/lib/managers/accessibility-manager.js

@@ -0,0 +1,224 @@
+/**
+ * AccessibilityManager - PDF Accessibility Operations
+ *
+ * Provides accessibility analysis and remediation capabilities including:
+ * - Tagged PDF detection
+ * - Structure tree extraction
+ * - Auto-tagging
+ * - Alt text management
+ * - Language and title metadata
+ *
+ * @since 1.0.0
+ */
+import { EventEmitter } from 'events';
+import { mapFfiErrorCode, AccessibilityException } from '../errors.js';
+// =============================================================================
+// AccessibilityManager
+// =============================================================================
+/**
+ * Manager for PDF accessibility operations.
+ *
+ * Provides methods for inspecting and improving the accessibility of
+ * PDF documents, including tagged PDF detection, structure tree analysis,
+ * auto-tagging, and alt text management.
+ *
+ * @example
+ * ```typescript
+ * const accessibility = new AccessibilityManager(document);
+ *
+ * // Check if document is tagged
+ * const tagged = await accessibility.isTagged();
+ *
+ * // Auto-tag an untagged document
+ * if (!tagged) {
+ *   const result = await accessibility.autoTag('en');
+ *   console.log(`Tagged ${result.elementsTagged} elements`);
+ * }
+ *
+ * // Set alt text on images
+ * await accessibility.setAltText(0, 1, 'Company logo');
+ * ```
+ */
+export class AccessibilityManager extends EventEmitter {
+    constructor(document) {
+        super();
+        if (!document) {
+            throw new Error('Document cannot be null or undefined');
+        }
+        this.document = document;
+        try {
+            this.native = require('../../index.node');
+        }
+        catch {
+            this.native = null;
+        }
+    }
+    // ===========================================================================
+    // Accessibility Analysis
+    // ===========================================================================
+    /**
+     * Checks whether the PDF document is tagged.
+     *
+     * A tagged PDF contains a structure tree that defines the logical
+     * reading order and semantic structure of the content.
+     *
+     * @returns True if the document is tagged
+     * @throws AccessibilityException if the check fails
+     */
+    async isTagged() {
+        if (!this.native?.pdf_accessibility_is_tagged) {
+            throw new AccessibilityException('Native accessibility not available: pdf_accessibility_is_tagged not found');
+        }
+        const errorCode = Buffer.alloc(4);
+        const result = this.native.pdf_accessibility_is_tagged(this.document._handle ?? this.document, errorCode);
+        const code = errorCode.readInt32LE(0);
+        if (code !== 0) {
+            throw mapFfiErrorCode(code, 'Failed to check if document is tagged');
+        }
+        this.emit('tagged-checked', { isTagged: result });
+        return !!result;
+    }
+    /**
+     * Gets the full structure tree of the document.
+     *
+     * Returns the hierarchical structure tree that defines the logical
+     * organization and reading order of the document content.
+     *
+     * @returns The document structure tree
+     * @throws AccessibilityException if the extraction fails
+     */
+    async getStructureTree() {
+        if (!this.native?.pdf_accessibility_get_structure_tree) {
+            throw new AccessibilityException('Native accessibility not available: pdf_accessibility_get_structure_tree not found');
+        }
+        const errorCode = Buffer.alloc(4);
+        const resultPtr = this.native.pdf_accessibility_get_structure_tree(this.document._handle ?? this.document, errorCode);
+        const code = errorCode.readInt32LE(0);
+        if (code !== 0) {
+            throw mapFfiErrorCode(code, 'Failed to get structure tree');
+        }
+        try {
+            const tree = typeof resultPtr === 'string'
+                ? JSON.parse(resultPtr)
+                : resultPtr;
+            this.emit('structure-tree-retrieved', { totalElements: tree.totalElements });
+            // Free native handle if needed
+            if (this.native.pdf_structure_tree_free && typeof resultPtr !== 'string') {
+                this.native.pdf_structure_tree_free(resultPtr);
+            }
+            return tree;
+        }
+        catch {
+            return {
+                isTagged: false,
+                elements: [],
+                totalElements: 0,
+            };
+        }
+    }
+    /**
+     * Automatically tags an untagged PDF document.
+     *
+     * Uses heuristic analysis to detect document structure and apply
+     * appropriate tags for headings, paragraphs, images, tables, and lists.
+     *
+     * @param language - Optional BCP-47 language tag (e.g., 'en', 'fr', 'de')
+     * @returns Result of the auto-tagging operation
+     * @throws AccessibilityException if auto-tagging fails
+     */
+    async autoTag(language) {
+        if (!this.native?.pdf_accessibility_auto_tag) {
+            throw new AccessibilityException('Native accessibility not available: pdf_accessibility_auto_tag not found');
+        }
+        const errorCode = Buffer.alloc(4);
+        const resultPtr = this.native.pdf_accessibility_auto_tag(this.document._handle ?? this.document, language ?? null, errorCode);
+        const code = errorCode.readInt32LE(0);
+        if (code !== 0) {
+            throw mapFfiErrorCode(code, 'Failed to auto-tag document');
+        }
+        let result;
+        try {
+            result = typeof resultPtr === 'string'
+                ? JSON.parse(resultPtr)
+                : resultPtr ?? { success: true, elementsTagged: 0, imagesFound: 0, headingsDetected: 0, warnings: [] };
+        }
+        catch {
+            result = { success: true, elementsTagged: 0, imagesFound: 0, headingsDetected: 0, warnings: [] };
+        }
+        this.emit('auto-tagged', { language, elementsTagged: result.elementsTagged });
+        return result;
+    }
+    // ===========================================================================
+    // Alt Text Management
+    // ===========================================================================
+    /**
+     * Sets alt text for a structure element identified by page and MCID.
+     *
+     * @param page - Zero-based page index
+     * @param mcid - Marked content identifier of the element
+     * @param text - Alt text to set
+     * @throws AccessibilityException if the operation fails
+     */
+    async setAltText(page, mcid, text) {
+        if (!this.native?.pdf_accessibility_set_alt_text) {
+            throw new AccessibilityException('Native accessibility not available: pdf_accessibility_set_alt_text not found');
+        }
+        const errorCode = Buffer.alloc(4);
+        this.native.pdf_accessibility_set_alt_text(this.document._handle ?? this.document, page, mcid, text, errorCode);
+        const code = errorCode.readInt32LE(0);
+        if (code !== 0) {
+            throw mapFfiErrorCode(code, `Failed to set alt text on page ${page}, mcid ${mcid}`);
+        }
+        this.emit('alt-text-set', { page, mcid, text });
+    }
+    // ===========================================================================
+    // Document-Level Accessibility Metadata
+    // ===========================================================================
+    /**
+     * Sets the document language.
+     *
+     * @param lang - BCP-47 language tag (e.g., 'en', 'en-US', 'fr')
+     * @throws AccessibilityException if the operation fails
+     */
+    async setLanguage(lang) {
+        if (!this.native?.pdf_accessibility_set_language) {
+            throw new AccessibilityException('Native accessibility not available: pdf_accessibility_set_language not found');
+        }
+        const errorCode = Buffer.alloc(4);
+        this.native.pdf_accessibility_set_language(this.document._handle ?? this.document, lang, errorCode);
+        const code = errorCode.readInt32LE(0);
+        if (code !== 0) {
+            throw mapFfiErrorCode(code, `Failed to set document language to '${lang}'`);
+        }
+        this.emit('language-set', { lang });
+    }
+    /**
+     * Sets the document title for accessibility.
+     *
+     * @param title - Document title
+     * @throws AccessibilityException if the operation fails
+     */
+    async setTitle(title) {
+        if (!this.native?.pdf_accessibility_set_title) {
+            throw new AccessibilityException('Native accessibility not available: pdf_accessibility_set_title not found');
+        }
+        const errorCode = Buffer.alloc(4);
+        this.native.pdf_accessibility_set_title(this.document._handle ?? this.document, title, errorCode);
+        const code = errorCode.readInt32LE(0);
+        if (code !== 0) {
+            throw mapFfiErrorCode(code, 'Failed to set document title');
+        }
+        this.emit('title-set', { title });
+    }
+    // ===========================================================================
+    // Cleanup
+    // ===========================================================================
+    /**
+     * Releases resources held by this manager.
+     */
+    destroy() {
+        this.removeAllListeners();
+    }
+}
+export default AccessibilityManager;
+//# sourceMappingURL=accessibility-manager.js.map

package/lib/managers/accessibility-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility-manager.js","sourceRoot":"","sources":["../../src/managers/accessibility-manager.ts"],"names":[],"mappings":"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"}

package/lib/managers/annotation-manager.d.ts

@@ -0,0 +1,220 @@
+/**
+ * Manager for PDF page annotations (comments, highlights, etc.)
+ *
+ * Provides methods to work with annotations on PDF pages including
+ * comments, highlights, underlines, and other markup.
+ *
+ * @example
+ * ```typescript
+ * import { AnnotationManager } from 'pdf_oxide';
+ *
+ * const doc = PdfDocument.open('document.pdf');
+ * const page = doc.getPage(0);
+ * const annotationManager = new AnnotationManager(page);
+ *
+ * // Get annotations on the page
+ * const annotations = annotationManager.getAnnotations();
+ * console.log(`Page has ${annotations.length} annotations`);
+ * ```
+ */
+export interface Annotation {
+    type: string;
+    content?: string;
+    author?: string;
+    modificationDate?: Date;
+    bounds?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    opacity?: number;
+    [key: string]: any;
+}
+export interface AnnotationStatistics {
+    total: number;
+    byType: Record<string, number>;
+    byAuthor: Record<string, number>;
+    authors: string[];
+    types: string[];
+    hasComments: boolean;
+    hasHighlights: boolean;
+    averageOpacity: number;
+    recentModifications: number;
+}
+export interface AnnotationValidation {
+    isValid: boolean;
+    issues: string[];
+}
+export declare class AnnotationManager {
+    private _page;
+    private _annotationCache;
+    private _statisticsCache;
+    /**
+     * Creates a new AnnotationManager for the given page
+     * @param page - The PDF page
+     * @throws Error if page is null or undefined
+     */
+    constructor(page: any);
+    /**
+     * Clears the annotation cache
+     * Useful when page content might have changed
+     */
+    clearCache(): void;
+    /**
+     * Gets all annotations on the page
+     * Performance optimization: caches results to avoid redundant fetches
+     * @returns Array of annotations
+     *
+     * @example
+     * ```typescript
+     * const annotations = manager.getAnnotations();
+     * annotations.forEach(ann => {
+     *   console.log(`${ann.type}: ${ann.content}`);
+     * });
+     * ```
+     */
+    getAnnotations(): Annotation[];
+    /**
+     * Gets annotations by type
+     * @param type - Annotation type ('text', 'highlight', 'underline', 'strikeout', 'squiggly')
+     * @returns Matching annotations
+     *
+     * @example
+     * ```typescript
+     * const highlights = manager.getAnnotationsByType('highlight');
+     * console.log(`Page has ${highlights.length} highlights`);
+     * ```
+     */
+    getAnnotationsByType(type: string): Annotation[];
+    /**
+     * Gets number of annotations on page
+     * @returns Annotation count
+     */
+    getAnnotationCount(): number;
+    /**
+     * Gets annotations by author
+     * @param author - Author name to filter
+     * @returns Annotations by specified author
+     *
+     * @example
+     * ```typescript
+     * const johnDoeAnnotations = manager.getAnnotationsByAuthor('John Doe');
+     * ```
+     */
+    getAnnotationsByAuthor(author: string): Annotation[];
+    /**
+     * Gets unique authors of annotations
+     * @returns Array of author names
+     */
+    getAnnotationAuthors(): string[];
+    /**
+     * Gets annotations modified after a date
+     * @param date - Filter date
+     * @returns Annotations modified after date
+     *
+     * @example
+     * ```typescript
+     * const recentAnnotations = manager.getAnnotationsAfter(new Date('2024-01-01'));
+     * ```
+     */
+    getAnnotationsAfter(date: Date): Annotation[];
+    /**
+     * Gets annotations modified before a date
+     * @param date - Filter date
+     * @returns Annotations modified before date
+     */
+    getAnnotationsBefore(date: Date): Annotation[];
+    /**
+     * Gets annotations with specific content
+     * @param contentFragment - Text fragment to search for
+     * @returns Matching annotations
+     *
+     * @example
+     * ```typescript
+     * const reviewComments = manager.getAnnotationsWithContent('review');
+     * ```
+     */
+    getAnnotationsWithContent(contentFragment: string): Annotation[];
+    /**
+     * Gets highlights (most common annotation type)
+     * @returns Array of highlight annotations
+     */
+    getHighlights(): Annotation[];
+    /**
+     * Gets text comments/notes
+     * @returns Array of text annotations
+     */
+    getComments(): Annotation[];
+    /**
+     * Gets underlines
+     * @returns Array of underline annotations
+     */
+    getUnderlines(): Annotation[];
+    /**
+     * Gets strikeouts
+     * @returns Array of strikeout annotations
+     */
+    getStrikeouts(): Annotation[];
+    /**
+     * Gets squiggly underlines
+     * @returns Array of squiggly annotations
+     */
+    getSquigglies(): Annotation[];
+    /**
+     * Gets annotations statistics
+     * Performance optimization: caches computed statistics
+     * @returns Statistics about annotations
+     *
+     * @example
+     * ```typescript
+     * const stats = manager.getAnnotationStatistics();
+     * console.log(`Total: ${stats.total}, Highlights: ${stats.byType.highlight}`);
+     * ```
+     */
+    getAnnotationStatistics(): AnnotationStatistics;
+    /**
+     * Gets average opacity of annotations
+     * @returns Average opacity value (0-1)
+     * @private
+     */
+    private getAverageOpacity;
+    /**
+     * Gets annotations modified within last N days
+     * @param days - Number of days to look back
+     * @returns Recent annotations
+     *
+     * @example
+     * ```typescript
+     * const lastWeek = manager.getRecentAnnotations(7);
+     * console.log(`${lastWeek.length} annotations modified in last 7 days`);
+     * ```
+     */
+    getRecentAnnotations(days: number): Annotation[];
+    /**
+     * Generates annotation summary
+     * @returns Human-readable annotation summary
+     *
+     * @example
+     * ```typescript
+     * console.log(manager.generateAnnotationSummary());
+     * ```
+     */
+    generateAnnotationSummary(): string;
+    /**
+     * Validates annotation bounds
+     * @param annotation - Annotation to validate
+     * @returns Validation result
+     *
+     * @example
+     * ```typescript
+     * const annotation = manager.getAnnotations()[0];
+     * const validation = manager.validateAnnotation(annotation);
+     * if (!validation.isValid) {
+     *   console.log('Invalid:', validation.issues);
+     * }
+     * ```
+     */
+    validateAnnotation(annotation: any): AnnotationValidation;
+}
+//# sourceMappingURL=annotation-manager.d.ts.map

package/lib/managers/annotation-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-manager.d.ts","sourceRoot":"","sources":["../../src/managers/annotation-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE;QACP,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,gBAAgB,CAAsB;IAC9C,OAAO,CAAC,gBAAgB,CAA8B;IAEtD;;;;OAIG;gBACS,IAAI,EAAE,GAAG;IAUrB;;;OAGG;IACH,UAAU,IAAI,IAAI;IAKlB;;;;;;;;;;;;OAYG;IACH,cAAc,IAAI,UAAU,EAAE;IAiB9B;;;;;;;;;;OAUG;IACH,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE;IAchD;;;OAGG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;;;;;;;;OASG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE;IASpD;;;OAGG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAahC;;;;;;;;;OASG;IACH,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,EAAE;IAW7C;;;;OAIG;IACH,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,EAAE;IAW9C;;;;;;;;;OASG;IACH,yBAAyB,CAAC,eAAe,EAAE,MAAM,GAAG,UAAU,EAAE;IAahE;;;OAGG;IACH,aAAa,IAAI,UAAU,EAAE;IAI7B;;;OAGG;IACH,WAAW,IAAI,UAAU,EAAE;IAI3B;;;OAGG;IACH,aAAa,IAAI,UAAU,EAAE;IAI7B;;;OAGG;IACH,aAAa,IAAI,UAAU,EAAE;IAI7B;;;OAGG;IACH,aAAa,IAAI,UAAU,EAAE;IAI7B;;;;;;;;;;OAUG;IACH,uBAAuB,IAAI,oBAAoB;IAqC/C;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;;;;;;;;;OAUG;IACH,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE;IAWhD;;;;;;;;OAQG;IACH,yBAAyB,IAAI,MAAM;IAwBnC;;;;;;;;;;;;;OAaG;IACH,kBAAkB,CAAC,UAAU,EAAE,GAAG,GAAG,oBAAoB;CA4B1D"}