pdf-oxide 0.3.24 → 0.3.29

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

@@ -0,0 +1,143 @@
+/**
+ * Manager for PDF page-level operations
+ *
+ * Provides methods to query page count, dimensions, and validate indices.
+ *
+ * @example
+ * ```typescript
+ * import { PageManager } from 'pdf_oxide';
+ *
+ * const doc = PdfDocument.open('document.pdf');
+ * const pageManager = new PageManager(doc);
+ *
+ * console.log(`Document has ${pageManager.getPageCount()} pages`);
+ *
+ * if (pageManager.isValidPageIndex(5)) {
+ *   const info = pageManager.getPageInfo(5);
+ *   console.log(`Page 5: ${info.width} x ${info.height} points`);
+ * }
+ * ```
+ */
+export interface PageInfo {
+    index: number;
+    width: number;
+    height: number;
+}
+export interface PageRange {
+    firstPage: number;
+    lastPage: number;
+}
+export interface PageStatistics {
+    count: number;
+    minWidth: number;
+    maxWidth: number;
+    minHeight: number;
+    maxHeight: number;
+    averageWidth: number;
+    averageHeight: number;
+    hasVariableSizes: boolean;
+}
+export declare class PageManager {
+    private _document;
+    private _cache;
+    /**
+     * Creates a new PageManager for the given document
+     * @param document - The PDF document
+     * @throws Error if document is null or undefined
+     */
+    constructor(document: any);
+    /**
+     * Clears the page cache
+     */
+    clearCache(): void;
+    /**
+     * Gets the total number of pages in the document
+     * @returns Number of pages
+     */
+    getPageCount(): number;
+    /**
+     * Checks if a page index is valid for this document
+     * @param pageIndex - Page index to validate (0-based)
+     * @returns True if the page index is valid
+     */
+    isValidPageIndex(pageIndex: number): boolean;
+    /**
+     * Gets information about a specific page
+     * @param pageIndex - Page index (0-based)
+     * @returns PageInfo object with page dimensions
+     * @throws Error if page index is invalid
+     *
+     * @example
+     * ```typescript
+     * const info = manager.getPageInfo(0);
+     * console.log(`Page 0: ${info.width} x ${info.height} points`);
+     * ```
+     */
+    getPageInfo(pageIndex: number): PageInfo;
+    /**
+     * Gets information about all pages in the document
+     * @returns Array of PageInfo objects
+     *
+     * @example
+     * ```typescript
+     * const pages = manager.getAllPageInfo();
+     * pages.forEach(page => {
+     *   console.log(`Page ${page.index}: ${page.width} x ${page.height}`);
+     * });
+     * ```
+     */
+    getAllPageInfo(): PageInfo[];
+    /**
+     * Checks if the document has no pages
+     * @returns True if the document has no pages
+     */
+    isEmpty(): boolean;
+    /**
+     * Checks if the document has more than one page
+     * @returns True if document has multiple pages
+     */
+    hasMultiplePages(): boolean;
+    /**
+     * Gets the valid page range
+     * @returns Object with firstPage and lastPage indices
+     *
+     * @example
+     * ```typescript
+     * const range = manager.getPageRange();
+     * console.log(`Page range: ${range.firstPage} to ${range.lastPage}`);
+     * ```
+     */
+    getPageRange(): PageRange;
+    /**
+     * Gets page dimension statistics
+     * @returns Statistics about page dimensions
+     *
+     * @example
+     * ```typescript
+     * const stats = manager.getPageStatistics();
+     * console.log(`Average width: ${stats.averageWidth}`);
+     * console.log(`Pages vary in size: ${stats.hasVariableSizes}`);
+     * ```
+     */
+    getPageStatistics(): PageStatistics;
+    /**
+     * Gets pages within a specific size range
+     * @param minWidth - Minimum width
+     * @param maxWidth - Maximum width
+     * @param minHeight - Minimum height
+     * @param maxHeight - Maximum height
+     * @returns Matching PageInfo objects
+     */
+    getPagesInSizeRange(minWidth: number, maxWidth: number, minHeight: number, maxHeight: number): PageInfo[];
+    /**
+     * Gets landscape pages
+     * @returns Array of landscape PageInfo objects
+     */
+    getLandscapePages(): PageInfo[];
+    /**
+     * Gets portrait pages
+     * @returns Array of portrait PageInfo objects
+     */
+    getPortraitPages(): PageInfo[];
+}
+//# sourceMappingURL=page-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"page-manager.d.ts","sourceRoot":"","sources":["../../src/managers/page-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,MAAM,CAAmB;IAEjC;;;;OAIG;gBACS,QAAQ,EAAE,GAAG;IAQzB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;;OAGG;IACH,YAAY,IAAI,MAAM;IAetB;;;;OAIG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAO5C;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ;IA4BxC;;;;;;;;;;;OAWG;IACH,cAAc,IAAI,QAAQ,EAAE;IAgB5B;;;OAGG;IACH,OAAO,IAAI,OAAO;IAIlB;;;OAGG;IACH,gBAAgB,IAAI,OAAO;IAI3B;;;;;;;;;OASG;IACH,YAAY,IAAI,SAAS;IAQzB;;;;;;;;;;OAUG;IACH,iBAAiB,IAAI,cAAc;IAuCnC;;;;;;;OAOG;IACH,mBAAmB,CACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,QAAQ,EAAE;IAQb;;;OAGG;IACH,iBAAiB,IAAI,QAAQ,EAAE;IAK/B;;;OAGG;IACH,gBAAgB,IAAI,QAAQ,EAAE;CAI/B"}

package/lib/managers/page-manager.js

@@ -0,0 +1,237 @@
+/**
+ * Manager for PDF page-level operations
+ *
+ * Provides methods to query page count, dimensions, and validate indices.
+ *
+ * @example
+ * ```typescript
+ * import { PageManager } from 'pdf_oxide';
+ *
+ * const doc = PdfDocument.open('document.pdf');
+ * const pageManager = new PageManager(doc);
+ *
+ * console.log(`Document has ${pageManager.getPageCount()} pages`);
+ *
+ * if (pageManager.isValidPageIndex(5)) {
+ *   const info = pageManager.getPageInfo(5);
+ *   console.log(`Page 5: ${info.width} x ${info.height} points`);
+ * }
+ * ```
+ */
+export class PageManager {
+    /**
+     * Creates a new PageManager for the given document
+     * @param document - The PDF document
+     * @throws Error if document is null or undefined
+     */
+    constructor(document) {
+        if (!document) {
+            throw new Error('Document is required');
+        }
+        this._document = document;
+        this._cache = new Map();
+    }
+    /**
+     * Clears the page cache
+     */
+    clearCache() {
+        this._cache.clear();
+    }
+    /**
+     * Gets the total number of pages in the document
+     * @returns Number of pages
+     */
+    getPageCount() {
+        const cacheKey = 'page:count';
+        if (this._cache.has(cacheKey)) {
+            return this._cache.get(cacheKey);
+        }
+        try {
+            const count = this._document.pageCount || 0;
+            this._cache.set(cacheKey, count);
+            return count;
+        }
+        catch (error) {
+            return 0;
+        }
+    }
+    /**
+     * Checks if a page index is valid for this document
+     * @param pageIndex - Page index to validate (0-based)
+     * @returns True if the page index is valid
+     */
+    isValidPageIndex(pageIndex) {
+        if (pageIndex < 0) {
+            return false;
+        }
+        return pageIndex < this.getPageCount();
+    }
+    /**
+     * Gets information about a specific page
+     * @param pageIndex - Page index (0-based)
+     * @returns PageInfo object with page dimensions
+     * @throws Error if page index is invalid
+     *
+     * @example
+     * ```typescript
+     * const info = manager.getPageInfo(0);
+     * console.log(`Page 0: ${info.width} x ${info.height} points`);
+     * ```
+     */
+    getPageInfo(pageIndex) {
+        const cacheKey = `page:info:${pageIndex}`;
+        if (this._cache.has(cacheKey)) {
+            return this._cache.get(cacheKey);
+        }
+        if (!this.isValidPageIndex(pageIndex)) {
+            throw new Error(`Invalid page index: ${pageIndex}`);
+        }
+        try {
+            const page = this._document.getPage(pageIndex);
+            const info = {
+                index: pageIndex,
+                width: page?.width || 0,
+                height: page?.height || 0,
+            };
+            this._cache.set(cacheKey, info);
+            return info;
+        }
+        catch (error) {
+            return {
+                index: pageIndex,
+                width: 0,
+                height: 0,
+            };
+        }
+    }
+    /**
+     * Gets information about all pages in the document
+     * @returns Array of PageInfo objects
+     *
+     * @example
+     * ```typescript
+     * const pages = manager.getAllPageInfo();
+     * pages.forEach(page => {
+     *   console.log(`Page ${page.index}: ${page.width} x ${page.height}`);
+     * });
+     * ```
+     */
+    getAllPageInfo() {
+        const cacheKey = 'page:info:all';
+        if (this._cache.has(cacheKey)) {
+            return this._cache.get(cacheKey);
+        }
+        const count = this.getPageCount();
+        const pages = [];
+        for (let i = 0; i < count; i++) {
+            pages.push(this.getPageInfo(i));
+        }
+        this._cache.set(cacheKey, pages);
+        return pages;
+    }
+    /**
+     * Checks if the document has no pages
+     * @returns True if the document has no pages
+     */
+    isEmpty() {
+        return this.getPageCount() === 0;
+    }
+    /**
+     * Checks if the document has more than one page
+     * @returns True if document has multiple pages
+     */
+    hasMultiplePages() {
+        return this.getPageCount() > 1;
+    }
+    /**
+     * Gets the valid page range
+     * @returns Object with firstPage and lastPage indices
+     *
+     * @example
+     * ```typescript
+     * const range = manager.getPageRange();
+     * console.log(`Page range: ${range.firstPage} to ${range.lastPage}`);
+     * ```
+     */
+    getPageRange() {
+        const count = this.getPageCount();
+        if (count === 0) {
+            return { firstPage: 0, lastPage: -1 };
+        }
+        return { firstPage: 0, lastPage: count - 1 };
+    }
+    /**
+     * Gets page dimension statistics
+     * @returns Statistics about page dimensions
+     *
+     * @example
+     * ```typescript
+     * const stats = manager.getPageStatistics();
+     * console.log(`Average width: ${stats.averageWidth}`);
+     * console.log(`Pages vary in size: ${stats.hasVariableSizes}`);
+     * ```
+     */
+    getPageStatistics() {
+        const pages = this.getAllPageInfo();
+        if (pages.length === 0) {
+            return {
+                count: 0,
+                minWidth: 0,
+                maxWidth: 0,
+                minHeight: 0,
+                maxHeight: 0,
+                averageWidth: 0,
+                averageHeight: 0,
+                hasVariableSizes: false,
+            };
+        }
+        const widths = pages.map(p => p.width);
+        const heights = pages.map(p => p.height);
+        const minWidth = Math.min(...widths);
+        const maxWidth = Math.max(...widths);
+        const minHeight = Math.min(...heights);
+        const maxHeight = Math.max(...heights);
+        const averageWidth = widths.reduce((a, b) => a + b, 0) / widths.length;
+        const averageHeight = heights.reduce((a, b) => a + b, 0) / heights.length;
+        return {
+            count: pages.length,
+            minWidth,
+            maxWidth,
+            minHeight,
+            maxHeight,
+            averageWidth,
+            averageHeight,
+            hasVariableSizes: minWidth !== maxWidth || minHeight !== maxHeight,
+        };
+    }
+    /**
+     * Gets pages within a specific size range
+     * @param minWidth - Minimum width
+     * @param maxWidth - Maximum width
+     * @param minHeight - Minimum height
+     * @param maxHeight - Maximum height
+     * @returns Matching PageInfo objects
+     */
+    getPagesInSizeRange(minWidth, maxWidth, minHeight, maxHeight) {
+        const pages = this.getAllPageInfo();
+        return pages.filter(p => p.width >= minWidth && p.width <= maxWidth &&
+            p.height >= minHeight && p.height <= maxHeight);
+    }
+    /**
+     * Gets landscape pages
+     * @returns Array of landscape PageInfo objects
+     */
+    getLandscapePages() {
+        const pages = this.getAllPageInfo();
+        return pages.filter(p => p.width > p.height);
+    }
+    /**
+     * Gets portrait pages
+     * @returns Array of portrait PageInfo objects
+     */
+    getPortraitPages() {
+        const pages = this.getAllPageInfo();
+        return pages.filter(p => p.height > p.width);
+    }
+}
+//# sourceMappingURL=page-manager.js.map

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

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

package/lib/managers/pattern-detection.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Pattern Detection Manager - TypeScript/Node.js Implementation
+ *
+ * Provides ML-powered pattern detection for PDF analysis:
+ * - Table detection and extraction
+ * - Column detection and analysis
+ * - Barcode detection and decoding
+ * - Form field detection
+ * - Layout pattern recognition
+ */
+import type { PdfDocument } from "../types/document-types.js";
+/**
+ * Represents a detected table region on a page.
+ */
+export interface TableRegion {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    readonly rowCount?: number;
+    readonly columnCount?: number;
+    readonly confidence?: number;
+}
+/**
+ * Represents a detected column region on a page.
+ */
+export interface ColumnRegion {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    readonly columnIndex?: number;
+    readonly confidence?: number;
+}
+/**
+ * Represents a detected barcode.
+ */
+export interface BarcodeRegion {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    readonly format: string;
+    readonly value: string;
+    readonly confidence?: number;
+}
+/**
+ * Represents a detected form field.
+ */
+export interface FormFieldRegion {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    readonly fieldType: string;
+    readonly fieldName?: string;
+    readonly confidence?: number;
+}
+/**
+ * Layout pattern type enumeration.
+ */
+export declare enum LayoutPatternType {
+    SINGLE_COLUMN = "single_column",
+    MULTI_COLUMN = "multi_column",
+    TABLE_BASED = "table_based",
+    FORM_BASED = "form_based",
+    MAGAZINE_STYLE = "magazine_style",
+    COMPLEX_MIXED = "complex_mixed"
+}
+/**
+ * Detected layout pattern.
+ */
+export interface LayoutPattern {
+    readonly pageIndex: number;
+    readonly patternType: LayoutPatternType;
+    readonly confidence: number;
+    readonly regions: Array<TableRegion | ColumnRegion>;
+}
+/**
+ * Pattern Detection Manager for TypeScript/Node.js
+ *
+ * Provides detection and analysis of common patterns in PDF documents.
+ */
+export declare class PatternDetectionManager {
+    private readonly document;
+    private readonly cache;
+    /**
+     * Create a new PatternDetectionManager.
+     */
+    constructor(document: PdfDocument);
+    /**
+     * Detect tables on a specific page.
+     *
+     * @param pageIndex - Index of the page to analyze
+     * @returns Array of detected table regions
+     */
+    detectTables(pageIndex: number): Promise<TableRegion[]>;
+    /**
+     * Detect columns on a specific page.
+     *
+     * @param pageIndex - Index of the page to analyze
+     * @returns Array of detected column regions
+     */
+    detectColumns(pageIndex: number): Promise<ColumnRegion[]>;
+    /**
+     * Detect barcodes on a specific page.
+     *
+     * @param pageIndex - Index of the page to analyze
+     * @returns Array of detected barcodes
+     */
+    detectBarcodes(pageIndex: number): Promise<BarcodeRegion[]>;
+    /**
+     * Detect form fields on a specific page.
+     *
+     * @param pageIndex - Index of the page to analyze
+     * @returns Array of detected form fields
+     */
+    detectFormFields(pageIndex: number): Promise<FormFieldRegion[]>;
+    /**
+     * Analyze layout pattern of a page.
+     *
+     * @param pageIndex - Index of the page to analyze
+     * @returns Detected layout pattern
+     */
+    analyzeLayoutPattern(pageIndex: number): Promise<LayoutPattern>;
+    /**
+     * Detect all patterns on a specific page.
+     *
+     * @param pageIndex - Index of the page to analyze
+     * @returns Object with all detected patterns
+     */
+    detectAllPatterns(pageIndex: number): Promise<{
+        tables: TableRegion[];
+        columns: ColumnRegion[];
+        barcodes: BarcodeRegion[];
+        formFields: FormFieldRegion[];
+        layout: LayoutPattern;
+    }>;
+    /**
+     * Analyze patterns across entire document.
+     *
+     * @returns Array of layout patterns for each page
+     */
+    analyzeDocumentPatterns(): Promise<LayoutPattern[]>;
+    /**
+     * Find pages with specific pattern type.
+     *
+     * @param patternType - Pattern type to find
+     * @returns Array of page indices with the specified pattern
+     */
+    findPagesWithPattern(patternType: LayoutPatternType): Promise<number[]>;
+    /**
+     * Get pattern statistics for the document.
+     *
+     * @returns Statistics about detected patterns
+     */
+    getPatternStatistics(): Promise<{
+        totalPages: number;
+        pagesWithTables: number;
+        pagesWithColumns: number;
+        avgTablesPerPage: number;
+        avgColumnsPerPage: number;
+    }>;
+    /**
+     * Clear the internal cache.
+     */
+    clearCache(): void;
+}
+export default PatternDetectionManager;
+//# sourceMappingURL=pattern-detection.d.ts.map

package/lib/managers/pattern-detection.d.ts.map

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