@embedpdf/engines 1.0.5 → 1.0.6

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { SearchTarget, PdfImage, ImageConversionTypes, PdfEngine, Logger, Task, PdfErrorReason, PdfFileUrl, PdfUrlOptions, PdfDocumentObject, PdfFile, PdfFileLoader, PdfSignatureObject, PdfBookmarkObject, PdfPageObject, Rotation, PdfRenderOptions, PdfTask, Rect, PdfAnnotationObject, PdfAnnotationTransformation, PdfTextRectObject, PdfAttachmentObject, PdfWidgetAnnoObject, FormFieldValue, PdfPageFlattenFlag, PdfPageFlattenResult, PdfInkListObject, PdfStampAnnoObjectContents, Position, PdfPageGeometry, PdfGlyphObject, MatchFlag, SearchAllPagesResult, PdfEngineMethodName, PdfEngineMethodArgs, TaskReturn, PdfEngineMethodReturnType, PdfMetadataObject, PdfBookmarksObject } from '@embedpdf/models';
+import { SearchTarget, PdfImage, ImageConversionTypes, PdfEngine, Logger, Task, PdfErrorReason, PdfFileUrl, PdfUrlOptions, PdfDocumentObject, PdfFile, PdfFileLoader, PdfSignatureObject, PdfBookmarkObject, PdfPageObject, Rotation, PdfRenderOptions, PdfTask, Rect, PdfAnnotationObject, PdfAnnotationTransformation, PdfTextRectObject, PdfAttachmentObject, PdfWidgetAnnoObject, FormFieldValue, PdfPageFlattenFlag, PdfPageFlattenResult, PageTextSlice, PdfInkListObject, PdfStampAnnoObjectContents, Position, PdfPageGeometry, PdfGlyphObject, MatchFlag, SearchAllPagesResult, PdfEngineMethodName, PdfEngineMethodArgs, TaskReturn, PdfEngineMethodReturnType, PdfMetadataObject, PdfBookmarksObject } from '@embedpdf/models';
 import { WrappedPdfiumModule, PdfiumRuntimeMethods, PdfiumModule } from '@embedpdf/pdfium';
 
 /**
@@ -269,6 +269,12 @@ declare class PdfiumEngine<T = Blob> implements PdfEngine<T> {
      * @public
      */
     extractText(doc: PdfDocumentObject, pageIndexes: number[]): Task<any, PdfErrorReason> | Task<string, PdfErrorReason>;
+    /**
+     * {@inheritDoc @embedpdf/models!PdfEngine.getTextSlices}
+     *
+     * @public
+     */
+    getTextSlices(doc: PdfDocumentObject, slices: PageTextSlice[]): PdfTask<string[]>;
     /**
      * {@inheritDoc @embedpdf/models!PdfEngine.merge}
      *
@@ -1431,6 +1437,12 @@ declare class WebWorkerEngine implements PdfEngine {
      * @public
      */
     extractText(doc: PdfDocumentObject, pageIndexes: number[]): WorkerTask<string>;
+    /**
+     * {@inheritDoc @embedpdf/models!PdfEngine.getTextSlices}
+     *
+     * @public
+     */
+    getTextSlices(doc: PdfDocumentObject, slices: PageTextSlice[]): WorkerTask<string[]>;
     /**
      * {@inheritDoc @embedpdf/models!PdfEngine.getPageGlyphs}
      *

package/dist/index.js

@@ -1,4 +1,4 @@
-import { NoopLogger, PdfTaskHelper, PdfErrorCode, Task, Rotation, PdfAnnotationSubtype, PdfPageObjectType, PdfAnnotationObjectStatus, quadToRect, PDF_FORM_FIELD_TYPE, toIntRect, transformRect, toIntSize, transformSize, PdfActionType, PdfZoomMode, AppearanceMode, MatchFlag, swap, PdfPageFlattenResult } from '@embedpdf/models';
+import { NoopLogger, PdfTaskHelper, PdfErrorCode, Task, Rotation, PdfAnnotationSubtype, stripPdfUnwantedMarkers, PdfPageObjectType, PdfAnnotationObjectStatus, quadToRect, PDF_FORM_FIELD_TYPE, toIntRect, transformRect, toIntSize, transformSize, PdfActionType, PdfZoomMode, AppearanceMode, MatchFlag, swap, PdfPageFlattenResult } from '@embedpdf/models';
 import { init } from '@embedpdf/pdfium';
 
 /**
@@ -1362,6 +1362,62 @@ class PdfiumEngine {
         this.logger.perf(LOG_SOURCE$2, LOG_CATEGORY$2, `ExtractText`, 'End', doc.id);
         return PdfTaskHelper.resolve(text);
     }
+    /**
+     * {@inheritDoc @embedpdf/models!PdfEngine.getTextSlices}
+     *
+     * @public
+     */
+    getTextSlices(doc, slices) {
+        this.logger.debug(LOG_SOURCE$2, LOG_CATEGORY$2, 'getTextSlices', doc, slices);
+        this.logger.perf(LOG_SOURCE$2, LOG_CATEGORY$2, 'GetTextSlices', 'Begin', doc.id);
+        /* ⚠︎ 1 — trivial case */
+        if (slices.length === 0) {
+            this.logger.perf(LOG_SOURCE$2, LOG_CATEGORY$2, 'GetTextSlices', 'End', doc.id);
+            return PdfTaskHelper.resolve([]);
+        }
+        /* ⚠︎ 2 — document must be open */
+        const ctx = this.cache.getContext(doc.id);
+        if (!ctx) {
+            this.logger.perf(LOG_SOURCE$2, LOG_CATEGORY$2, 'GetTextSlices', 'End', doc.id);
+            return PdfTaskHelper.reject({
+                code: PdfErrorCode.DocNotOpen,
+                message: 'document does not open',
+            });
+        }
+        try {
+            /* keep caller order */
+            const out = new Array(slices.length);
+            /* group → open each page once */
+            const byPage = new Map();
+            slices.forEach((s, i) => {
+                (byPage.get(s.pageIndex) ?? byPage.set(s.pageIndex, []).get(s.pageIndex)).push({
+                    slice: s,
+                    pos: i,
+                });
+            });
+            for (const [pageIdx, list] of byPage) {
+                const pageCtx = ctx.acquirePage(pageIdx);
+                const textPagePtr = pageCtx.getTextPage();
+                for (const { slice, pos } of list) {
+                    const bufPtr = this.malloc(2 * (slice.charCount + 1)); // UTF-16 + NIL
+                    this.pdfiumModule.FPDFText_GetText(textPagePtr, slice.charIndex, slice.charCount, bufPtr);
+                    out[pos] = stripPdfUnwantedMarkers(this.pdfiumModule.pdfium.UTF16ToString(bufPtr));
+                    this.free(bufPtr);
+                }
+                pageCtx.release();
+            }
+            this.logger.perf(LOG_SOURCE$2, LOG_CATEGORY$2, 'GetTextSlices', 'End', doc.id);
+            return PdfTaskHelper.resolve(out);
+        }
+        catch (e) {
+            this.logger.error(LOG_SOURCE$2, LOG_CATEGORY$2, 'getTextSlices error', e);
+            this.logger.perf(LOG_SOURCE$2, LOG_CATEGORY$2, 'GetTextSlices', 'End', doc.id);
+            return PdfTaskHelper.reject({
+                code: PdfErrorCode.Unknown,
+                message: String(e),
+            });
+        }
+    }
     /**
      * {@inheritDoc @embedpdf/models!PdfEngine.merge}
      *
@@ -1891,14 +1947,12 @@ class PdfiumEngine {
         const runs = [];
         let current = null;
         let curObjPtr = null;
+        let bounds = null;
         /** ── main loop ──────────────────────────────────────────── */
         for (let i = 0; i < glyphs.length; i++) {
             const g = glyphs[i];
             /* 1 — find the CPDF_TextObject this glyph belongs to */
             const objPtr = this.pdfiumModule.FPDFText_GetTextObject(textPagePtr, i);
-            if (g.isEmpty) {
-                continue;
-            }
             /* 2 — start a new run when the text object changes */
             if (objPtr !== curObjPtr) {
                 curObjPtr = objPtr;
@@ -1912,6 +1966,12 @@ class PdfiumEngine {
                     charStart: i,
                     glyphs: [],
                 };
+                bounds = {
+                    minX: g.origin.x,
+                    minY: g.origin.y,
+                    maxX: g.origin.x + g.size.width,
+                    maxY: g.origin.y + g.size.height,
+                };
                 runs.push(current);
             }
             /* 3 — append the slim glyph record */
@@ -1920,16 +1980,24 @@ class PdfiumEngine {
                 y: g.origin.y,
                 width: g.size.width,
                 height: g.size.height,
-                flags: g.isSpace ? 1 : 0,
+                flags: g.isEmpty ? 2 : g.isSpace ? 1 : 0,
             });
             /* 4 — expand the run's bounding rect */
+            if (g.isEmpty) {
+                continue;
+            }
             const right = g.origin.x + g.size.width;
             const bottom = g.origin.y + g.size.height;
-            current.rect.width =
-                Math.max(current.rect.x + current.rect.width, right) - current.rect.x;
-            current.rect.y = Math.min(current.rect.y, g.origin.y);
-            current.rect.height =
-                Math.max(current.rect.y + current.rect.height, bottom) - current.rect.y;
+            // Update bounds
+            bounds.minX = Math.min(bounds.minX, g.origin.x);
+            bounds.minY = Math.min(bounds.minY, g.origin.y);
+            bounds.maxX = Math.max(bounds.maxX, right);
+            bounds.maxY = Math.max(bounds.maxY, bottom);
+            // Calculate final rect from bounds
+            current.rect.x = bounds.minX;
+            current.rect.y = bounds.minY;
+            current.rect.width = bounds.maxX - bounds.minX;
+            current.rect.height = bounds.maxY - bounds.minY;
         }
         return runs;
     }
@@ -4175,6 +4243,9 @@ class EngineRunner {
                 case 'extractText':
                     task = this.engine[name](...args);
                     break;
+                case 'getTextSlices':
+                    task = this.engine[name](...args);
+                    break;
                 case 'getPageGlyphs':
                     task = this.engine[name](...args);
                     break;
@@ -4935,6 +5006,26 @@ class WebWorkerEngine {
         this.proxy(task, request);
         return task;
     }
+    /**
+     * {@inheritDoc @embedpdf/models!PdfEngine.getTextSlices}
+     *
+     * @public
+     */
+    getTextSlices(doc, slices) {
+        this.logger.debug(LOG_SOURCE, LOG_CATEGORY, 'getTextSlices', doc, slices);
+        const requestId = this.generateRequestId(doc.id);
+        const task = new WorkerTask(this.worker, requestId);
+        const request = {
+            id: requestId,
+            type: 'ExecuteRequest',
+            data: {
+                name: 'getTextSlices',
+                args: [doc, slices],
+            },
+        };
+        this.proxy(task, request);
+        return task;
+    }
     /**
      * {@inheritDoc @embedpdf/models!PdfEngine.getPageGlyphs}
      *
@@ -5299,6 +5390,9 @@ function createMockPdfEngine(partialEngine) {
         extractText: (pdf, pageIndexes) => {
             return PdfTaskHelper.resolve('');
         },
+        getTextSlices: (doc, slices) => {
+            return PdfTaskHelper.resolve([]);
+        },
         getPageGlyphs: (doc, page) => {
             return PdfTaskHelper.resolve([]);
         },