pdf-oxide 0.3.24

package/src/tests/advanced-features.test.ts

@@ -0,0 +1,414 @@
+/**
+ * Comprehensive test suite for Phase 5 Advanced Features.
+ * Tests: AnnotationsAdvancedManager, LayoutAnalysisManager, DOMAdvancedManager, XFAManager, SearchAdvancedManager
+ */
+
+import { describe, it, expect, beforeEach } from '@jest/globals';
+
+import AnnotationsAdvancedManager from '../managers/annotations-advanced-manager';
+import LayoutAnalysisManager from '../managers/layout-analysis-manager';
+import DOMAdvancedManager from '../managers/dom-advanced-manager';
+import XFAManager from '../managers/xfa-manager';
+import SearchAdvancedManager from '../managers/search-advanced-manager';
+
+describe('Phase 5 Advanced Features', () => {
+  describe('AnnotationsAdvancedManager', () => {
+    let manager: AnnotationsAdvancedManager;
+
+    beforeEach(() => {
+      manager = new AnnotationsAdvancedManager();
+    });
+
+    it('should add ink annotation', () => {
+      const result = manager.addInkAnnotation(0, [[10, 20], [30, 40]]);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should add polygon annotation', () => {
+      const result = manager.addPolygonAnnotation(0, [[10, 20], [30, 40], [50, 60]]);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should add polyline annotation', () => {
+      const result = manager.addPolylineAnnotation(0, [[10, 20], [30, 40]]);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should add file attachment', () => {
+      const result = manager.addFileAttachment(0, '/file.txt', 'Description');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should add sound annotation', () => {
+      const result = manager.addSoundAnnotation(0, '/sound.mp3');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should add movie annotation', () => {
+      const result = manager.addMovieAnnotation(0, '/movie.mp4');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get annotation appearance', () => {
+      const result = manager.getAnnotationAppearance('anno_1');
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should set annotation appearance', () => {
+      const result = manager.setAnnotationAppearance('anno_1', { color: 'red' });
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get annotation popup', () => {
+      const result = manager.getAnnotationPopup('anno_1');
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should set annotation popup', () => {
+      const result = manager.setAnnotationPopup('anno_1', 'Popup text');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get annotation flags', () => {
+      const result = manager.getAnnotationFlags('anno_1');
+      expect(typeof result).toBe('number');
+    });
+
+    it('should set annotation flags', () => {
+      const result = manager.setAnnotationFlags('anno_1', 4);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should group annotations', () => {
+      const result = manager.groupAnnotations(['anno_1', 'anno_2']);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should ungroup annotations', () => {
+      const result = manager.ungroupAnnotations('group_1');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get annotation rotation point', () => {
+      const result = manager.getAnnotationRotationPoint('anno_1');
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should set annotation rotation', () => {
+      const result = manager.setAnnotationRotation('anno_1', 45);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get annotation transparency', () => {
+      const result = manager.getAnnotationTransparency('anno_1');
+      expect(typeof result).toBe('number');
+    });
+
+    it('should set annotation transparency', () => {
+      const result = manager.setAnnotationTransparency('anno_1', 0.5);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should animate annotation', () => {
+      const result = manager.animateAnnotation('anno_1');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get 3D annotation', () => {
+      const result = manager.getAnnotation3D('anno_1');
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should get all annotation metadata', () => {
+      const result = manager.getAllAnnotationMetadata();
+      expect(typeof result).toBe('object');
+    });
+
+    it('should export annotations to XFDF', () => {
+      const result = manager.exportAnnotationsXFDF('/output.xfdf');
+      expect(typeof result).toBe('boolean');
+    });
+  });
+
+  describe('LayoutAnalysisManager', () => {
+    let manager: LayoutAnalysisManager;
+
+    beforeEach(() => {
+      manager = new LayoutAnalysisManager();
+    });
+
+    it('should detect columns', () => {
+      const result = manager.detectColumns();
+      expect(Array.isArray(result)).toBe(true);
+    });
+
+    it('should detect tables', () => {
+      const result = manager.detectTables();
+      expect(Array.isArray(result)).toBe(true);
+    });
+
+    it('should get table structure', () => {
+      const result = manager.getTableStructure(0);
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should extract table data', () => {
+      const result = manager.extractTableData(0);
+      expect(result === null || Array.isArray(result)).toBe(true);
+    });
+
+    it('should detect headers', () => {
+      const result = manager.detectHeaders();
+      expect(Array.isArray(result)).toBe(true);
+    });
+
+    it('should detect footers', () => {
+      const result = manager.detectFooters();
+      expect(Array.isArray(result)).toBe(true);
+    });
+
+    it('should detect page margins', () => {
+      const result = manager.detectPageMargins();
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should get text flow', () => {
+      const result = manager.getTextFlow();
+      expect(Array.isArray(result)).toBe(true);
+    });
+
+    it('should analyze page layout', () => {
+      const result = manager.analyzePageLayout();
+      expect(typeof result).toBe('object');
+    });
+
+    it('should detect reading order', () => {
+      const result = manager.detectReadingOrder();
+      expect(Array.isArray(result)).toBe(true);
+    });
+
+    it('should get layout regions', () => {
+      const result = manager.getLayoutRegions();
+      expect(Array.isArray(result)).toBe(true);
+    });
+
+    it('should export layout analysis', () => {
+      const result = manager.exportLayoutAnalysis('/output.json');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should detect images', () => {
+      const result = manager.detectImages();
+      expect(Array.isArray(result)).toBe(true);
+    });
+
+    it('should detect graphics', () => {
+      const result = manager.detectGraphics();
+      expect(Array.isArray(result)).toBe(true);
+    });
+
+    it('should detect form fields', () => {
+      const result = manager.detectFormFields();
+      expect(Array.isArray(result)).toBe(true);
+    });
+
+    it('should get layout statistics', () => {
+      const result = manager.getLayoutStatistics();
+      expect(typeof result).toBe('object');
+    });
+
+    it('should validate layout', () => {
+      const result = manager.validateLayout();
+      expect(typeof result).toBe('boolean');
+    });
+  });
+
+  describe('DOMAdvancedManager', () => {
+    let manager: DOMAdvancedManager;
+
+    beforeEach(() => {
+      manager = new DOMAdvancedManager();
+    });
+
+    it('should create DOM tree', () => {
+      const result = manager.createDOMTree();
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should traverse DOM', () => {
+      const result = manager.traverseDOM();
+      expect(Array.isArray(result)).toBe(true);
+    });
+
+    it('should find DOM element', () => {
+      const result = manager.findDOMElement('tag', 'text');
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should modify DOM element', () => {
+      const result = manager.modifyDOMElement('elem_1', { text: 'new' });
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should insert DOM element', () => {
+      const result = manager.insertDOMElement('parent_1', { text: 'new' });
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should delete DOM element', () => {
+      const result = manager.deleteDOMElement('elem_1');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should clone DOM element', () => {
+      const result = manager.cloneDOMElement('elem_1');
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should get DOM attributes', () => {
+      const result = manager.getDOMAttributes('elem_1');
+      expect(typeof result).toBe('object');
+    });
+
+    it('should set DOM attributes', () => {
+      const result = manager.setDOMAttributes('elem_1', { attr: 'value' });
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get DOM text', () => {
+      const result = manager.getDOMText('elem_1');
+      expect(result === null || typeof result === 'string').toBe(true);
+    });
+
+    it('should set DOM text', () => {
+      const result = manager.setDOMText('elem_1', 'new text');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should export DOM', () => {
+      const result = manager.exportDOM('/output.xml');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should import DOM', () => {
+      const result = manager.importDOM('/input.xml');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should validate DOM structure', () => {
+      const result = manager.validateDOMStructure();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get DOM statistics', () => {
+      const result = manager.getDOMStatistics();
+      expect(typeof result).toBe('object');
+    });
+  });
+
+  describe('XFAManager', () => {
+    let manager: XFAManager;
+
+    beforeEach(() => {
+      manager = new XFAManager();
+    });
+
+    it('should get XFA form', () => {
+      const result = manager.getXFAForm();
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should check if XFA form', () => {
+      const result = manager.isXFAForm();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should extract XFA data', () => {
+      const result = manager.extractXFAData();
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should set XFA data', () => {
+      const result = manager.setXFAData({ field: 'value' });
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should export XFA template', () => {
+      const result = manager.exportXFATemplate('/output.xml');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should import XFA template', () => {
+      const result = manager.importXFATemplate('/input.xml');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should validate XFA form', () => {
+      const result = manager.validateXFAForm();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should convert XFA to AcroForm', () => {
+      const result = manager.convertXFAToAcroForm();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get XFA field value', () => {
+      const result = manager.getXFAFieldValue('field');
+      expect(result === null || typeof result === 'string').toBe(true);
+    });
+
+    it('should set XFA field value', () => {
+      const result = manager.setXFAFieldValue('field', 'value');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get XFA field properties', () => {
+      const result = manager.getXFAFieldProperties('field');
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should reset XFA form', () => {
+      const result = manager.resetXFAForm();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get XFA calculations', () => {
+      const result = manager.getXFACalculations();
+      expect(typeof result).toBe('object');
+    });
+  });
+
+  describe('SearchAdvancedManager', () => {
+    let manager: SearchAdvancedManager;
+
+    beforeEach(() => {
+      manager = new SearchAdvancedManager();
+    });
+
+    it('should search with regex', () => {
+      const result = manager.searchWithRegex(r'\d+');
+      expect(Array.isArray(result)).toBe(true);
+    });
+
+    it('should search with wildcards', () => {
+      const result = manager.searchWithWildcards('test*');
+      expect(Array.isArray(result)).toBe(true);
+    });
+
+    it('should search within region', () => {
+      const result = manager.searchWithinRegion('text', 0, 0, 100, 100);
+      expect(Array.isArray(result)).toBe(true);
+    });
+
+    it('should search with options', () => {
+      const result = manager.searchWithOptions('text', { case_sensitive: true });
+      expect(Array.isArray(result)).toBe(true);
+    });
+
+    it('should get search statistics', () => {
+      const result = manager.getSearchStatistics();
+      expect(typeof result).toBe('object');
+    });
+  });
+});

package/src/tests/advanced.test.ts

@@ -0,0 +1,266 @@
+/**
+ * Comprehensive test suite for Phase 3 Advanced Features.
+ * Tests: OCRManager, ComplianceManager, CacheManager
+ */
+
+import { describe, it, expect, beforeEach } from '@jest/globals';
+
+import OCRManager from '../managers/ocr-manager';
+import ComplianceManager from '../managers/compliance-manager';
+import CacheManager from '../managers/cache-manager';
+
+describe('Phase 3 Advanced Features', () => {
+  describe('OCRManager', () => {
+    let manager: OCRManager;
+
+    beforeEach(() => {
+      manager = new OCRManager();
+    });
+
+    it('should extract text with OCR as string or null', () => {
+      const result = manager.extractTextOCR();
+      expect(result === null || typeof result === 'string').toBe(true);
+    });
+
+    it('should recognize text as string or null', () => {
+      const result = manager.recognizeText();
+      expect(result === null || typeof result === 'string').toBe(true);
+    });
+
+    it('should detect language as string or null', () => {
+      const result = manager.detectLanguage();
+      expect(result === null || typeof result === 'string').toBe(true);
+    });
+
+    it('should get OCR confidence as number', () => {
+      const result = manager.getOCRConfidence();
+      expect(typeof result).toBe('number');
+    });
+
+    it('should set OCR language and return boolean', () => {
+      const result = manager.setOCRLanguage('eng');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get OCR languages as array or null', () => {
+      const result = manager.getOCRLanguages();
+      expect(result === null || Array.isArray(result)).toBe(true);
+    });
+
+    it('should recognize characters as array or null', () => {
+      const result = manager.recognizeCharacters();
+      expect(result === null || Array.isArray(result)).toBe(true);
+    });
+
+    it('should get character bounds as object or null', () => {
+      const result = manager.getCharacterBounds(0);
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should get confidence scores as array or null', () => {
+      const result = manager.getConfidenceScores();
+      expect(result === null || Array.isArray(result)).toBe(true);
+    });
+
+    it('should detect text regions as array or null', () => {
+      const result = manager.detectTextRegions();
+      expect(result === null || Array.isArray(result)).toBe(true);
+    });
+
+    it('should apply preprocessing and return boolean', () => {
+      const result = manager.applyPreprocessing('denoise');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should set OCR mode and return boolean', () => {
+      const result = manager.setOCRMode('fast');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should export OCR data and return boolean', () => {
+      const result = manager.exportOCRData('/output.json');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get OCR metrics as object or null', () => {
+      const result = manager.getOCRMetrics();
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should validate OCR result and return boolean', () => {
+      const result = manager.validateOCRResult();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should set OCR timeout and return boolean', () => {
+      const result = manager.setOCRTimeout(60);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should cancel OCR and return boolean', () => {
+      const result = manager.cancelOCR();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get OCR status as string or null', () => {
+      const result = manager.getOCRStatus();
+      expect(result === null || typeof result === 'string').toBe(true);
+    });
+
+    it('should perform batch OCR and return boolean', () => {
+      const result = manager.batchOCR([0, 1, 2]);
+      expect(typeof result).toBe('boolean');
+    });
+  });
+
+  describe('ComplianceManager', () => {
+    let manager: ComplianceManager;
+
+    beforeEach(() => {
+      manager = new ComplianceManager();
+    });
+
+    it('should validate PDF/X and return boolean', () => {
+      const result = manager.validatePDFX();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should validate PDF/UA and return boolean', () => {
+      const result = manager.validatePDFUA();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should validate PDF/A and return boolean', () => {
+      const result = manager.validatePDFA();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get compliance status as string or null', () => {
+      const result = manager.getComplianceStatus();
+      expect(result === null || typeof result === 'string').toBe(true);
+    });
+
+    it('should get compliance issues as array or null', () => {
+      const result = manager.getComplianceIssues();
+      expect(result === null || Array.isArray(result)).toBe(true);
+    });
+
+    it('should fix compliance issues and return boolean', () => {
+      const result = manager.fixComplianceIssues();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should add accessibility tags and return boolean', () => {
+      const result = manager.addAccessibilityTags();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should set language and return boolean', () => {
+      const result = manager.setLanguage('en');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should add document title and return boolean', () => {
+      const result = manager.addDocumentTitle('Document Title');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should add metadata and return boolean', () => {
+      const result = manager.addMetadata({ key: 'value' });
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should remove compliance issues and return boolean', () => {
+      const result = manager.removeComplianceIssues();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get compliance report as string or null', () => {
+      const result = manager.getComplianceReport();
+      expect(result === null || typeof result === 'string').toBe(true);
+    });
+
+    it('should export compliance report and return boolean', () => {
+      const result = manager.exportComplianceReport('/report.txt');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should set compliance mode and return boolean', () => {
+      const result = manager.setComplianceMode('PDFA');
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should validate images and return boolean', () => {
+      const result = manager.validateImages();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should validate fonts and return boolean', () => {
+      const result = manager.validateFonts();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should validate colors and return boolean', () => {
+      const result = manager.validateColors();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get compliance metrics as object or null', () => {
+      const result = manager.getComplianceMetrics();
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should auto fix compliance and return boolean', () => {
+      const result = manager.autoFixCompliance();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should reset compliance and return boolean', () => {
+      const result = manager.resetCompliance();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get compliance level as string or null', () => {
+      const result = manager.getComplianceLevel();
+      expect(result === null || typeof result === 'string').toBe(true);
+    });
+
+    it('should validate content streams and return boolean', () => {
+      const result = manager.validateContentStreams();
+      expect(typeof result).toBe('boolean');
+    });
+  });
+
+  describe('CacheManager', () => {
+    let manager: CacheManager;
+
+    beforeEach(() => {
+      manager = new CacheManager();
+    });
+
+    it('should create cache and return boolean', () => {
+      const result = manager.createCache(1000);
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get from cache as string, object or null', () => {
+      const result = manager.getFromCache('key');
+      expect(result === null || typeof result === 'string' || typeof result === 'object').toBe(true);
+    });
+
+    it('should clear cache and return boolean', () => {
+      const result = manager.clearCache();
+      expect(typeof result).toBe('boolean');
+    });
+
+    it('should get cache stats as object or null', () => {
+      const result = manager.getCacheStats();
+      expect(result === null || typeof result === 'object').toBe(true);
+    });
+
+    it('should set cache policy and return boolean', () => {
+      const result = manager.setCachePolicy('LRU');
+      expect(typeof result).toBe('boolean');
+    });
+  });
+});