pdfdancer-client-typescript 1.0.7 → 1.0.8

package/dist/types.js

@@ -59,20 +59,64 @@ class FormFieldObject extends BaseObject {
 exports.FormFieldObject = FormFieldObject;
 class ParagraphObject extends BaseObject {
     static fromRef(_client, objectRef) {
-        return new ParagraphObject(_client, objectRef.internalId, objectRef.type, objectRef.position);
+        let paragraphObject = new ParagraphObject(_client, objectRef.internalId, objectRef.type, objectRef.position);
+        paragraphObject.setFontName(objectRef.fontName);
+        paragraphObject.setFontSize(objectRef.fontSize);
+        paragraphObject.setLineSpacings(objectRef.lineSpacings);
+        paragraphObject.setText(objectRef.text);
+        paragraphObject.setChildren(objectRef.children);
+        paragraphObject.ref = () => objectRef;
+        return paragraphObject;
     }
     edit() {
         return new paragraph_builder_1.ParagraphBuilder(this._client, this.ref());
     }
+    setFontName(fontName) {
+        this.fontName = fontName;
+    }
+    setFontSize(fontSize) {
+        this.fontSize = fontSize;
+    }
+    setLineSpacings(lineSpacings) {
+        this.lineSpacings = lineSpacings;
+    }
+    setText(text) {
+        this.text = text;
+    }
+    setChildren(children) {
+        this.children = children;
+    }
 }
 exports.ParagraphObject = ParagraphObject;
 class TextLineObject extends BaseObject {
     static fromRef(_client, objectRef) {
-        return new TextLineObject(_client, objectRef.internalId, objectRef.type, objectRef.position);
+        let textLineObject = new TextLineObject(_client, objectRef.internalId, objectRef.type, objectRef.position);
+        textLineObject.setFontName(objectRef.fontName);
+        textLineObject.setFontSize(objectRef.fontSize);
+        textLineObject.setLineSpacings(objectRef.lineSpacings);
+        textLineObject.setText(objectRef.text);
+        textLineObject.setChildren(objectRef.children);
+        textLineObject.ref = () => objectRef;
+        return textLineObject;
     }
     edit() {
         return new TextLineBuilder(this._client, this.ref());
     }
+    setFontName(fontName) {
+        this.fontName = fontName;
+    }
+    setFontSize(fontSize) {
+        this.fontSize = fontSize;
+    }
+    setLineSpacings(lineSpacings) {
+        this.lineSpacings = lineSpacings;
+    }
+    setText(text) {
+        this.text = text;
+    }
+    setChildren(children) {
+        this.children = children;
+    }
 }
 exports.TextLineObject = TextLineObject;
 class TextLineBuilder {

package/dist/types.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pdfdancer-client-typescript",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "A TypeScript client library for the PDFDancer PDF manipulation API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/__tests__/e2e/paragraph.test.ts

@@ -2,7 +2,7 @@
  * E2E tests for paragraph operations — new PDFDancer API
  */
 
-import {Color, PDFDancer} from '../../index';
+import {Color, PDFDancer, StandardFonts} from '../../index';
 import {getFontPath, readFontFixture, requireEnvAndFixture} from './test-helpers';
 import {expectWithin} from '../assertions';
 
@@ -214,4 +214,193 @@ describe('Paragraph E2E Tests (v2 API)', () => {
         expect(success).toBe(true);
         await assertNewParagraphExists(pdf);
     });
+
+    test('add paragraph with standard font - Helvetica', async () => {
+        const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
+
+        const success = await pdf.page(0).newParagraph()
+            .text('Standard Font Test\nHelvetica')
+            .font(StandardFonts.HELVETICA, 14)
+            .lineSpacing(1.2)
+            .at(100, 600)
+            .apply();
+
+        expect(success).toBe(true);
+        const lines = await pdf.page(0).selectTextLinesStartingWith('Standard Font Test');
+        expect(lines.length).toBeGreaterThanOrEqual(1);
+    });
+
+    test('add paragraph with standard font - Times Bold', async () => {
+        const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
+
+        const success = await pdf.page(0).newParagraph()
+            .text('Times Bold Test')
+            .font(StandardFonts.TIMES_BOLD, 16)
+            .color(new Color(255, 0, 0))
+            .at(100, 550)
+            .apply();
+
+        expect(success).toBe(true);
+        const lines = await pdf.page(0).selectTextLinesStartingWith('Times Bold Test');
+        expect(lines.length).toBeGreaterThanOrEqual(1);
+    });
+
+    test('add paragraph with standard font - Courier', async () => {
+        const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
+
+        const success = await pdf.page(0).newParagraph()
+            .text('Courier Monospace\nCode Example')
+            .font(StandardFonts.COURIER, 12)
+            .lineSpacing(1.5)
+            .at(100, 500)
+            .apply();
+
+        expect(success).toBe(true);
+        const lines = await pdf.page(0).selectTextLinesStartingWith('Courier Monospace');
+        expect(lines.length).toBeGreaterThanOrEqual(1);
+    });
+
+
+    test('modify paragraph without position', async () => {
+        const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
+
+        const [para] = await pdf.page(0).selectParagraphsStartingWith('The Complete');
+        let originalX = para.position.getX();
+        let originalY = para.position.getY();
+
+        await para.edit()
+            .replace('Modified with\nStandard Font')
+            .font(StandardFonts.HELVETICA_BOLD, 14)
+            .lineSpacing(1.3)
+            .apply();
+
+        const [newPara] = await pdf.page(0).selectParagraphsStartingWith('Modified with');
+        // TODO should be at the original position
+        expect(newPara.position.getX()).toBe(originalX);
+        expect(newPara.position.getY()).toBe(originalY);
+    });
+
+    test('modify paragraph without position and lineSpacing', async () => {
+        const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
+
+        const [para] = await pdf.page(0).selectParagraphsStartingWith('The Complete');
+        let originalX = para.position.getX();
+        let originalY = para.position.getY();
+
+        await para.edit()
+            .replace('Modified with\nStandard Font')
+            .font(StandardFonts.HELVETICA_BOLD, 14)
+            .apply();
+
+        const [newPara] = await pdf.page(0).selectParagraphsStartingWith('Modified with');
+        // TODO should be at the original position
+        expect(newPara.position.getX()).toBe(originalX);
+        expect(newPara.position.getY()).toBe(originalY);
+    });
+
+    test('modify paragraph only change font', async () => {
+        const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
+
+        const [para] = await pdf.page(0).selectParagraphsStartingWith('The Complete');
+        let originalX = para.position.getX();
+        let originalY = para.position.getY();
+
+        await para.edit()
+            .font(StandardFonts.HELVETICA_BOLD, 28)
+            .apply();
+
+        const [newPara] = await pdf.page(0).selectParagraphsStartingWith('The Complete');
+        // TODO should be at the original position
+        expect(newPara.position.getX()).toBe(originalX);
+        expect(newPara.position.getY()).toBe(originalY);
+    });
+
+    test('add paragraph without position', async () => {
+        const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
+
+        await expect(pdf.page(0).newParagraph()
+            .text('Courier Monospace\nCode Example')
+            .font(StandardFonts.COURIER, 12)
+            .lineSpacing(1.5)
+            .apply())
+            .rejects
+            .toThrow("Paragraph position is null, you need to specify a position for the new paragraph, using .at(x,y)");
+    });
+
+    test('modify paragraph to use standard font', async () => {
+        const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
+
+        const [para] = await pdf.page(0).selectParagraphsStartingWith('The Complete');
+
+        await para.edit()
+            .replace('Modified with\nStandard Font')
+            .font(StandardFonts.HELVETICA_BOLD, 14)
+            .lineSpacing(1.3)
+            .moveTo(100, 400)
+            .apply();
+
+        const lines = await pdf.page(0).selectTextLinesStartingWith('Modified with');
+        expect(lines.length).toBeGreaterThanOrEqual(1);
+    });
+
+    test('use all Times family standard fonts', async () => {
+        const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
+
+        const timesFonts = [
+            StandardFonts.TIMES_ROMAN,
+            StandardFonts.TIMES_BOLD,
+            StandardFonts.TIMES_ITALIC,
+            StandardFonts.TIMES_BOLD_ITALIC
+        ];
+
+        for (let i = 0; i < timesFonts.length; i++) {
+            const success = await pdf.page(0).newParagraph()
+                .text(`Times Font ${i}`)
+                .font(timesFonts[i], 12)
+                .at(50, 700 - (i * 30))
+                .apply();
+            expect(success).toBe(true);
+        }
+
+        const lines = await pdf.page(0).selectTextLinesStartingWith('Times Font');
+        expect(lines.length).toBe(4);
+    });
+
+    test('use all Helvetica family standard fonts', async () => {
+        const [baseUrl, token, pdfData] = await requireEnvAndFixture('ObviouslyAwesome.pdf');
+        const pdf = await PDFDancer.open(pdfData, token, baseUrl);
+
+        const helveticaFonts = [
+            StandardFonts.HELVETICA,
+            StandardFonts.HELVETICA_BOLD,
+            StandardFonts.HELVETICA_OBLIQUE,
+            StandardFonts.HELVETICA_BOLD_OBLIQUE
+        ];
+
+        for (let i = 0; i < helveticaFonts.length; i++) {
+            const success = await pdf.page(0).newParagraph()
+                .text(`Helvetica Font ${i}`)
+                .font(helveticaFonts[i], 12)
+                .at(200, 700 - (i * 30))
+                .apply();
+            expect(success).toBe(true);
+        }
+
+        const lines = await pdf.page(0).selectTextLinesStartingWith('Helvetica Font');
+        expect(lines.length).toBe(4);
+    });
+
+    test('Symbol and ZapfDingbats fonts are available as standard fonts', () => {
+        expect(StandardFonts.SYMBOL).toBe('Symbol');
+        expect(StandardFonts.ZAPF_DINGBATS).toBe('ZapfDingbats');
+    });
 });

package/src/__tests__/standard-fonts.test.ts

@@ -0,0 +1,87 @@
+/**
+ * Tests for StandardFonts enum.
+ */
+
+import { StandardFonts, Font } from '../models';
+
+describe('StandardFonts', () => {
+    test('should have all 14 standard PDF fonts', () => {
+        const standardFonts = Object.values(StandardFonts);
+        expect(standardFonts).toHaveLength(14);
+    });
+
+    test('should have Times family fonts', () => {
+        expect(StandardFonts.TIMES_ROMAN).toBe('Times-Roman');
+        expect(StandardFonts.TIMES_BOLD).toBe('Times-Bold');
+        expect(StandardFonts.TIMES_ITALIC).toBe('Times-Italic');
+        expect(StandardFonts.TIMES_BOLD_ITALIC).toBe('Times-BoldItalic');
+    });
+
+    test('should have Helvetica family fonts', () => {
+        expect(StandardFonts.HELVETICA).toBe('Helvetica');
+        expect(StandardFonts.HELVETICA_BOLD).toBe('Helvetica-Bold');
+        expect(StandardFonts.HELVETICA_OBLIQUE).toBe('Helvetica-Oblique');
+        expect(StandardFonts.HELVETICA_BOLD_OBLIQUE).toBe('Helvetica-BoldOblique');
+    });
+
+    test('should have Courier family fonts', () => {
+        expect(StandardFonts.COURIER).toBe('Courier');
+        expect(StandardFonts.COURIER_BOLD).toBe('Courier-Bold');
+        expect(StandardFonts.COURIER_OBLIQUE).toBe('Courier-Oblique');
+        expect(StandardFonts.COURIER_BOLD_OBLIQUE).toBe('Courier-BoldOblique');
+    });
+
+    test('should have Symbol font', () => {
+        expect(StandardFonts.SYMBOL).toBe('Symbol');
+    });
+
+    test('should have ZapfDingbats font', () => {
+        expect(StandardFonts.ZAPF_DINGBATS).toBe('ZapfDingbats');
+    });
+
+    test('should work with Font class', () => {
+        const font = new Font(StandardFonts.HELVETICA, 12);
+        expect(font.name).toBe('Helvetica');
+        expect(font.size).toBe(12);
+    });
+
+    test('should work with all standard fonts in Font class', () => {
+        for (const standardFont of Object.values(StandardFonts)) {
+            const font = new Font(standardFont, 10);
+            expect(font.name).toBe(standardFont);
+            expect(font.size).toBe(10);
+        }
+    });
+
+    test('should have correct font name formats', () => {
+        expect(StandardFonts.TIMES_BOLD_ITALIC).toMatch(/^Times-[A-Za-z]+$/);
+        expect(StandardFonts.HELVETICA_BOLD_OBLIQUE).toMatch(/^Helvetica-[A-Za-z]+$/);
+        expect(StandardFonts.COURIER_BOLD_OBLIQUE).toMatch(/^Courier-[A-Za-z]+$/);
+    });
+
+    test('should have unique font names', () => {
+        const fontNames = Object.values(StandardFonts);
+        const uniqueFontNames = new Set(fontNames);
+        expect(uniqueFontNames.size).toBe(fontNames.length);
+    });
+
+    test('enum keys should match convention', () => {
+        expect(Object.keys(StandardFonts)).toContain('TIMES_ROMAN');
+        expect(Object.keys(StandardFonts)).toContain('HELVETICA');
+        expect(Object.keys(StandardFonts)).toContain('COURIER');
+        expect(Object.keys(StandardFonts)).toContain('SYMBOL');
+        expect(Object.keys(StandardFonts)).toContain('ZAPF_DINGBATS');
+    });
+
+    test('should be compatible with string type', () => {
+        const fontName: string = StandardFonts.HELVETICA;
+        expect(typeof fontName).toBe('string');
+        expect(fontName).toBe('Helvetica');
+    });
+
+    test('standard fonts should not have spaces', () => {
+        for (const standardFont of Object.values(StandardFonts)) {
+            expect(standardFont).not.toContain(' ');
+        }
+    });
+});

package/src/index.ts

@@ -18,6 +18,7 @@ export {
 export {
   ObjectRef,
   FormFieldRef,
+  TextObjectRef,
   Position,
   ObjectType,
   Font,
@@ -27,7 +28,8 @@ export {
   Paragraph,
   PositionMode,
   ShapeType,
-  Point
+  Point,
+  StandardFonts
 } from './models';
 
 export const VERSION = "1.0.0";

package/src/models.ts

@@ -234,6 +234,56 @@ export class FormFieldRef extends ObjectRef {
     }
 }
 
+export class TextObjectRef extends ObjectRef {
+    private _text?: string;
+    private _fontName?: string;
+    private _fontSize?: number;
+    private _lineSpacings?: number[] | null;
+    private _children?: TextObjectRef[];
+
+    constructor(
+        internalId: string,
+        position: Position,
+        type: ObjectType,
+        text?: string,
+        fontName?: string,
+        fontSize?: number,
+        lineSpacings?: number[] | null,
+        children?: TextObjectRef[]
+    ) {
+        super(internalId, position, type);
+        this._text = text;
+        this._fontName = fontName;
+        this._fontSize = fontSize;
+        this._lineSpacings = lineSpacings;
+        this._children = children;
+    }
+
+    get text(): string | undefined {
+        return this._text;
+    }
+
+    get fontName(): string | undefined {
+        return this._fontName;
+    }
+
+    get fontSize(): number | undefined {
+        return this._fontSize;
+    }
+
+    get lineSpacings(): number[] | null | undefined {
+        return this._lineSpacings;
+    }
+
+    get children(): TextObjectRef[] | undefined {
+        return this._children;
+    }
+
+    set children(value: TextObjectRef[] | undefined) {
+        this._children = value;
+    }
+}
+
 /**
  * Represents an RGB color with optional alpha channel, values from 0-255.
  */
@@ -252,6 +302,27 @@ export class Color {
     }
 }
 
+/**
+ * Standard PDF fonts that are available in all PDF readers.
+ * These 14 fonts are guaranteed to be available without embedding.
+ */
+export enum StandardFonts {
+    TIMES_ROMAN = "Times-Roman",
+    TIMES_BOLD = "Times-Bold",
+    TIMES_ITALIC = "Times-Italic",
+    TIMES_BOLD_ITALIC = "Times-BoldItalic",
+    HELVETICA = "Helvetica",
+    HELVETICA_BOLD = "Helvetica-Bold",
+    HELVETICA_OBLIQUE = "Helvetica-Oblique",
+    HELVETICA_BOLD_OBLIQUE = "Helvetica-BoldOblique",
+    COURIER = "Courier",
+    COURIER_BOLD = "Courier-Bold",
+    COURIER_OBLIQUE = "Courier-Oblique",
+    COURIER_BOLD_OBLIQUE = "Courier-BoldOblique",
+    SYMBOL = "Symbol",
+    ZAPF_DINGBATS = "ZapfDingbats"
+}
+
 /**
  * Represents a font with name and size.
  */

package/src/paragraph-builder.ts

@@ -3,7 +3,7 @@
  */
 
 import {ValidationException} from './exceptions';
-import {Color, Font, ObjectRef, Paragraph, Position} from './models';
+import {Color, Font, ObjectRef, Paragraph, Position, TextObjectRef} from './models';
 import {PDFDancer} from "./pdfdancer_v1";
 
 // 👇 Internal view of PDFDancer methods, not exported
@@ -27,7 +27,7 @@ export class ParagraphBuilder {
     private _pageIndex: number;
     private _internals: PDFDancerInternals;
 
-    constructor(private _client: PDFDancer, private objectRefOrPageIndex?: ObjectRef | number) {
+    constructor(private _client: PDFDancer, private objectRefOrPageIndex?: TextObjectRef | number) {
         if (!_client) {
             throw new ValidationException("Client cannot be null");
         }
@@ -192,9 +192,6 @@ export class ParagraphBuilder {
     }
 
     async apply() {
-        if (!this._text) {
-            throw new ValidationException("Text must be set before building paragraph");
-        }
         // Wait for all deferred operations (e.g., fontFile, images, etc.)
         if (this._pending.length) {
             await Promise.all(this._pending);
@@ -205,14 +202,24 @@ export class ParagraphBuilder {
             throw new ValidationException("Font registration is not complete");
         }
 
-        let paragraph = this.build();
-        if (this.objectRefOrPageIndex instanceof ObjectRef) {
+        if (this.objectRefOrPageIndex instanceof TextObjectRef) {
             if (!this._font || !this._textColor) {
-                return await this._internals.modifyParagraph(this.objectRefOrPageIndex, this._text);
+                return await this._internals.modifyParagraph(this.objectRefOrPageIndex, this._text!);
             } else {
+                if (!this._text && !this.objectRefOrPageIndex?.text) {
+                    throw new ValidationException("A paragraph must have text. Set the text using .text()");
+                }
+                if (!this._text) {
+                    this._text = this.objectRefOrPageIndex.text;
+                }
+                let paragraph = this.build();
+                if (!paragraph.position) {
+                    paragraph.position = this.objectRefOrPageIndex.position;
+                }
                 return await this._internals.modifyParagraph(this.objectRefOrPageIndex, paragraph);
             }
         } else {
+            let paragraph = this.build();
             return await this._internals.addParagraph(paragraph);
         }
     }

package/src/pdfdancer_v1.ts

@@ -28,7 +28,8 @@ import {
     Paragraph,
     Position,
     PositionMode,
-    ShapeType
+    ShapeType,
+    TextObjectRef
 } from './models';
 import {ParagraphBuilder} from './paragraph-builder';
 import {FormFieldObject, FormXObject, ImageObject, ParagraphObject, PathObject, TextLineObject} from "./types";
@@ -441,8 +442,8 @@ export class PDFDancer {
     /**
      * Searches for paragraph objects at the specified position.
      */
-    private async findParagraphs(position?: Position): Promise<ObjectRef[]> {
-        return this.find(ObjectType.PARAGRAPH, position);
+    private async findParagraphs(position?: Position): Promise<TextObjectRef[]> {
+        return this.find(ObjectType.PARAGRAPH, position) as Promise<TextObjectRef[]>;
     }
 
     /**
@@ -489,8 +490,8 @@ export class PDFDancer {
     /**
      * Searches for text line objects at the specified position.
      */
-    private async findTextLines(position?: Position): Promise<ObjectRef[]> {
-        return this.find(ObjectType.TEXT_LINE, position);
+    private async findTextLines(position?: Position): Promise<TextObjectRef[]> {
+        return this.find(ObjectType.TEXT_LINE, position) as Promise<TextObjectRef[]>;
     }
 
     /**
@@ -621,7 +622,7 @@ export class PDFDancer {
             throw new ValidationException("Paragraph cannot be null");
         }
         if (!paragraph.getPosition()) {
-            throw new ValidationException("Paragraph position is null");
+            throw new ValidationException("Paragraph position is null, you need to specify a position for the new paragraph, using .at(x,y)");
         }
         if (paragraph.getPosition()!.pageIndex === undefined) {
             throw new ValidationException("Paragraph position page index is null");
@@ -807,6 +808,10 @@ export class PDFDancer {
 
         const objectType = objData.type as ObjectType;
 
+        if (this._isTextObjectData(objData, objectType)) {
+            return this._parseTextObjectRef(objData);
+        }
+
         return new ObjectRef(
             objData.internalId,
             position,
@@ -814,6 +819,42 @@ export class PDFDancer {
         );
     }
 
+    private _isTextObjectData(objData: any, objectType: ObjectType): boolean {
+        return objectType === ObjectType.PARAGRAPH ||
+            objectType === ObjectType.TEXT_LINE ||
+            typeof objData.text === 'string' ||
+            typeof objData.fontName === 'string' ||
+            Array.isArray(objData.children);
+    }
+
+    private _parseTextObjectRef(objData: any, fallbackId?: string): TextObjectRef {
+        const positionData = objData.position || {};
+        const position = positionData ? this._parsePosition(positionData) : new Position();
+
+        const objectType = (objData.type as ObjectType) ?? ObjectType.TEXT_LINE;
+        const lineSpacings = Array.isArray(objData.lineSpacings) ? objData.lineSpacings : null;
+        const internalId = objData.internalId ?? fallbackId ?? '';
+
+        const textObject = new TextObjectRef(
+            internalId,
+            position,
+            objectType,
+            typeof objData.text === 'string' ? objData.text : undefined,
+            typeof objData.fontName === 'string' ? objData.fontName : undefined,
+            typeof objData.fontSize === 'number' ? objData.fontSize : undefined,
+            lineSpacings
+        );
+
+        if (Array.isArray(objData.children) && objData.children.length > 0) {
+            textObject.children = objData.children.map((childData: any, index: number) => {
+                const childFallbackId = `${internalId || 'child'}-${index}`;
+                return this._parseTextObjectRef(childData, childFallbackId);
+            });
+        }
+
+        return textObject;
+    }
+
     private _parseFormFieldRef(objData: any): FormFieldRef {
         const positionData = objData.position || {};
         const position = positionData ? this._parsePosition(positionData) : new Position();
@@ -896,11 +937,11 @@ export class PDFDancer {
         return this.toParagraphObjects(await this.findParagraphs());
     }
 
-    private toParagraphObjects(objectRefs: ObjectRef[]) {
+    private toParagraphObjects(objectRefs: TextObjectRef[]) {
         return objectRefs.map(ref => ParagraphObject.fromRef(this, ref));
     }
 
-    private toTextLineObjects(objectRefs: ObjectRef[]) {
+    private toTextLineObjects(objectRefs: TextObjectRef[]) {
         return objectRefs.map(ref => TextLineObject.fromRef(this, ref));
     }