pdf-oxide 0.3.24 → 0.3.29

package/lib/builders/annotation-builder.d.ts

@@ -0,0 +1,199 @@
+/**
+ * Builder for creating PDF annotations
+ *
+ * Configures annotation properties like content, appearance, author, and behavior.
+ *
+ * @example
+ * ```typescript
+ * import { AnnotationBuilder } from 'pdf_oxide';
+ *
+ * const annotation = AnnotationBuilder.create()
+ *   .type('highlight')
+ *   .content('Important section')
+ *   .author('Reviewer')
+ *   .color([1, 1, 0]) // Yellow
+ *   .build();
+ *
+ * pdf.addAnnotation(annotation);
+ * ```
+ */
+interface AnnotationBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface Annotation {
+    type: string;
+    content: string;
+    author?: string;
+    subject?: string;
+    color: number[];
+    opacity: number;
+    bounds?: AnnotationBounds;
+    creationDate: Date;
+    modificationDate: Date;
+    flags: number;
+    reply?: string;
+}
+export declare class AnnotationBuilder {
+    private _type;
+    private _content;
+    private _author?;
+    private _subject?;
+    private _color;
+    private _opacity;
+    private _bounds?;
+    private _creationDate;
+    private _modificationDate;
+    private _flags;
+    private _reply?;
+    /**
+     * Creates a new AnnotationBuilder instance
+     * @private
+     */
+    private constructor();
+    /**
+     * Creates a new AnnotationBuilder instance
+     * @returns New builder instance
+     */
+    static create(): AnnotationBuilder;
+    /**
+     * Creates a text annotation (comment/note)
+     * @returns This builder for chaining
+     */
+    asText(): this;
+    /**
+     * Creates a highlight annotation
+     * @returns This builder for chaining
+     */
+    asHighlight(): this;
+    /**
+     * Creates an underline annotation
+     * @returns This builder for chaining
+     */
+    asUnderline(): this;
+    /**
+     * Creates a strikeout annotation
+     * @returns This builder for chaining
+     */
+    asStrikeout(): this;
+    /**
+     * Creates a squiggly (wavy underline) annotation
+     * @returns This builder for chaining
+     */
+    asSquiggly(): this;
+    /**
+     * Sets the annotation type
+     * @param type - Annotation type ('text', 'highlight', 'underline', 'strikeout', 'squiggly')
+     * @returns This builder for chaining
+     */
+    type(type: string): this;
+    /**
+     * Sets the annotation content/text
+     * @param content - The annotation content
+     * @returns This builder for chaining
+     */
+    content(content: string): this;
+    /**
+     * Sets the author of the annotation
+     * @param author - The author name
+     * @returns This builder for chaining
+     */
+    author(author: string): this;
+    /**
+     * Sets the subject/title of the annotation
+     * @param subject - The annotation subject
+     * @returns This builder for chaining
+     */
+    subject(subject: string): this;
+    /**
+     * Sets the color of the annotation (RGB, normalized 0-1)
+     * @param rgb - RGB color array [r, g, b] with values 0-1
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * builder.color([1, 1, 0]); // Yellow
+     * builder.color([1, 0, 0]); // Red
+     * builder.color([0, 1, 0]); // Green
+     * ```
+     */
+    color(rgb: number[]): this;
+    /**
+     * Sets the color using common color names
+     * @param colorName - Color name (e.g., 'red', 'yellow', 'green', 'blue')
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * builder.colorName('yellow');
+     * builder.colorName('red');
+     * ```
+     */
+    colorName(colorName: string): this;
+    /**
+     * Sets the opacity/transparency (0-1)
+     * @param opacity - Opacity value (0=transparent, 1=opaque)
+     * @returns This builder for chaining
+     */
+    opacity(opacity: number): this;
+    /**
+     * Sets the bounding box for the annotation
+     * @param bounds - Bounding box {x, y, width, height}
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * builder.bounds({x: 100, y: 200, width: 150, height: 30});
+     * ```
+     */
+    bounds(bounds: AnnotationBounds): this;
+    /**
+     * Sets the creation date
+     * @param date - The creation date
+     * @returns This builder for chaining
+     */
+    creationDate(date: Date): this;
+    /**
+     * Sets the modification date
+     * @param date - The modification date
+     * @returns This builder for chaining
+     */
+    modificationDate(date: Date): this;
+    /**
+     * Sets the annotation to be printed
+     * @returns This builder for chaining
+     */
+    printable(): this;
+    /**
+     * Sets the annotation to NOT be printed
+     * @returns This builder for chaining
+     */
+    notPrintable(): this;
+    /**
+     * Sets whether the annotation is locked (read-only)
+     * @param locked - Whether to lock the annotation
+     * @returns This builder for chaining
+     */
+    locked(locked: boolean): this;
+    /**
+     * Sets a reply to this annotation
+     * @param replyContent - Content of the reply
+     * @returns This builder for chaining
+     */
+    reply(replyContent: string): this;
+    /**
+     * Builds and returns the annotation object
+     * @returns Immutable annotation object
+     */
+    build(): Annotation;
+}
+/**
+ * Create a new AnnotationBuilder with static factory
+ * @deprecated Use AnnotationBuilder.create() instead
+ * @returns New builder instance
+ */
+export declare function createAnnotationBuilder(): AnnotationBuilder;
+export {};
+//# sourceMappingURL=annotation-builder.d.ts.map

package/lib/builders/annotation-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-builder.d.ts","sourceRoot":"","sources":["../../src/builders/annotation-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,UAAU,gBAAgB;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,YAAY,EAAE,IAAI,CAAC;IACnB,gBAAgB,EAAE,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,OAAO,CAAC,CAAmB;IACnC,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,MAAM,CAAC,CAAS;IAExB;;;OAGG;IACH,OAAO;IAEP;;;OAGG;IACH,MAAM,CAAC,MAAM,IAAI,iBAAiB;IAIlC;;;OAGG;IACH,MAAM,IAAI,IAAI;IAKd;;;OAGG;IACH,WAAW,IAAI,IAAI;IAKnB;;;OAGG;IACH,WAAW,IAAI,IAAI;IAKnB;;;OAGG;IACH,WAAW,IAAI,IAAI;IAKnB;;;OAGG;IACH,UAAU,IAAI,IAAI;IAKlB;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IASxB;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQ9B;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ5B;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQ9B;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI;IAW1B;;;;;;;;;;OAUG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAyBlC;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQ9B;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAYtC;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAQ9B;;;;OAIG;IACH,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAQlC;;;OAGG;IACH,SAAS,IAAI,IAAI;IAKjB;;;OAGG;IACH,YAAY,IAAI,IAAI;IAKpB;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAY7B;;;;OAIG;IACH,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAQjC;;;OAGG;IACH,KAAK,IAAI,UAAU;CAmBpB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CAE3D"}

package/lib/builders/annotation-builder.js

@@ -0,0 +1,318 @@
+/**
+ * Builder for creating PDF annotations
+ *
+ * Configures annotation properties like content, appearance, author, and behavior.
+ *
+ * @example
+ * ```typescript
+ * import { AnnotationBuilder } from 'pdf_oxide';
+ *
+ * const annotation = AnnotationBuilder.create()
+ *   .type('highlight')
+ *   .content('Important section')
+ *   .author('Reviewer')
+ *   .color([1, 1, 0]) // Yellow
+ *   .build();
+ *
+ * pdf.addAnnotation(annotation);
+ * ```
+ */
+export class AnnotationBuilder {
+    /**
+     * Creates a new AnnotationBuilder instance
+     * @private
+     */
+    constructor() {
+        this._type = 'text';
+        this._content = '';
+        this._color = [1, 0, 0]; // Default: red (RGB normalized 0-1)
+        this._opacity = 1.0;
+        this._creationDate = new Date();
+        this._modificationDate = new Date();
+        this._flags = 0;
+    }
+    /**
+     * Creates a new AnnotationBuilder instance
+     * @returns New builder instance
+     */
+    static create() {
+        return new AnnotationBuilder();
+    }
+    /**
+     * Creates a text annotation (comment/note)
+     * @returns This builder for chaining
+     */
+    asText() {
+        this._type = 'text';
+        return this;
+    }
+    /**
+     * Creates a highlight annotation
+     * @returns This builder for chaining
+     */
+    asHighlight() {
+        this._type = 'highlight';
+        return this;
+    }
+    /**
+     * Creates an underline annotation
+     * @returns This builder for chaining
+     */
+    asUnderline() {
+        this._type = 'underline';
+        return this;
+    }
+    /**
+     * Creates a strikeout annotation
+     * @returns This builder for chaining
+     */
+    asStrikeout() {
+        this._type = 'strikeout';
+        return this;
+    }
+    /**
+     * Creates a squiggly (wavy underline) annotation
+     * @returns This builder for chaining
+     */
+    asSquiggly() {
+        this._type = 'squiggly';
+        return this;
+    }
+    /**
+     * Sets the annotation type
+     * @param type - Annotation type ('text', 'highlight', 'underline', 'strikeout', 'squiggly')
+     * @returns This builder for chaining
+     */
+    type(type) {
+        const validTypes = ['text', 'highlight', 'underline', 'strikeout', 'squiggly', 'note'];
+        if (!validTypes.includes(type)) {
+            throw new Error(`Invalid annotation type. Must be one of: ${validTypes.join(', ')}`);
+        }
+        this._type = type;
+        return this;
+    }
+    /**
+     * Sets the annotation content/text
+     * @param content - The annotation content
+     * @returns This builder for chaining
+     */
+    content(content) {
+        if (typeof content !== 'string') {
+            throw new Error('Content must be a string');
+        }
+        this._content = content;
+        return this;
+    }
+    /**
+     * Sets the author of the annotation
+     * @param author - The author name
+     * @returns This builder for chaining
+     */
+    author(author) {
+        if (typeof author !== 'string') {
+            throw new Error('Author must be a string');
+        }
+        this._author = author.length > 0 ? author : undefined;
+        return this;
+    }
+    /**
+     * Sets the subject/title of the annotation
+     * @param subject - The annotation subject
+     * @returns This builder for chaining
+     */
+    subject(subject) {
+        if (typeof subject !== 'string') {
+            throw new Error('Subject must be a string');
+        }
+        this._subject = subject.length > 0 ? subject : undefined;
+        return this;
+    }
+    /**
+     * Sets the color of the annotation (RGB, normalized 0-1)
+     * @param rgb - RGB color array [r, g, b] with values 0-1
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * builder.color([1, 1, 0]); // Yellow
+     * builder.color([1, 0, 0]); // Red
+     * builder.color([0, 1, 0]); // Green
+     * ```
+     */
+    color(rgb) {
+        if (!Array.isArray(rgb) || rgb.length !== 3) {
+            throw new Error('Color must be an array of 3 RGB values [r, g, b]');
+        }
+        if (!rgb.every((c) => typeof c === 'number' && c >= 0 && c <= 1)) {
+            throw new Error('RGB values must be numbers between 0 and 1');
+        }
+        this._color = [...rgb];
+        return this;
+    }
+    /**
+     * Sets the color using common color names
+     * @param colorName - Color name (e.g., 'red', 'yellow', 'green', 'blue')
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * builder.colorName('yellow');
+     * builder.colorName('red');
+     * ```
+     */
+    colorName(colorName) {
+        const colors = {
+            red: [1, 0, 0],
+            green: [0, 1, 0],
+            blue: [0, 0, 1],
+            yellow: [1, 1, 0],
+            cyan: [0, 1, 1],
+            magenta: [1, 0, 1],
+            white: [1, 1, 1],
+            black: [0, 0, 0],
+            gray: [0.5, 0.5, 0.5],
+            orange: [1, 0.5, 0],
+            purple: [0.5, 0, 0.5],
+        };
+        const lowerColorName = colorName.toLowerCase();
+        if (!colors[lowerColorName]) {
+            const available = Object.keys(colors).join(', ');
+            throw new Error(`Unknown color. Available colors: ${available}`);
+        }
+        this._color = [...colors[lowerColorName]];
+        return this;
+    }
+    /**
+     * Sets the opacity/transparency (0-1)
+     * @param opacity - Opacity value (0=transparent, 1=opaque)
+     * @returns This builder for chaining
+     */
+    opacity(opacity) {
+        if (typeof opacity !== 'number' || opacity < 0 || opacity > 1) {
+            throw new Error('Opacity must be a number between 0 and 1');
+        }
+        this._opacity = opacity;
+        return this;
+    }
+    /**
+     * Sets the bounding box for the annotation
+     * @param bounds - Bounding box {x, y, width, height}
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * builder.bounds({x: 100, y: 200, width: 150, height: 30});
+     * ```
+     */
+    bounds(bounds) {
+        if (typeof bounds !== 'object' || bounds === null) {
+            throw new Error('Bounds must be an object');
+        }
+        const { x, y, width, height } = bounds;
+        if (![x, y, width, height].every((v) => typeof v === 'number' && v >= 0)) {
+            throw new Error('Bounds must have numeric x, y, width, height values >= 0');
+        }
+        this._bounds = { x, y, width, height };
+        return this;
+    }
+    /**
+     * Sets the creation date
+     * @param date - The creation date
+     * @returns This builder for chaining
+     */
+    creationDate(date) {
+        if (!(date instanceof Date)) {
+            throw new Error('creationDate must be a Date object');
+        }
+        this._creationDate = new Date(date);
+        return this;
+    }
+    /**
+     * Sets the modification date
+     * @param date - The modification date
+     * @returns This builder for chaining
+     */
+    modificationDate(date) {
+        if (!(date instanceof Date)) {
+            throw new Error('modificationDate must be a Date object');
+        }
+        this._modificationDate = new Date(date);
+        return this;
+    }
+    /**
+     * Sets the annotation to be printed
+     * @returns This builder for chaining
+     */
+    printable() {
+        this._flags |= 4; // Print flag
+        return this;
+    }
+    /**
+     * Sets the annotation to NOT be printed
+     * @returns This builder for chaining
+     */
+    notPrintable() {
+        this._flags &= ~4; // Clear print flag
+        return this;
+    }
+    /**
+     * Sets whether the annotation is locked (read-only)
+     * @param locked - Whether to lock the annotation
+     * @returns This builder for chaining
+     */
+    locked(locked) {
+        if (typeof locked !== 'boolean') {
+            throw new Error('locked must be a boolean');
+        }
+        if (locked) {
+            this._flags |= 128; // Locked flag
+        }
+        else {
+            this._flags &= ~128;
+        }
+        return this;
+    }
+    /**
+     * Sets a reply to this annotation
+     * @param replyContent - Content of the reply
+     * @returns This builder for chaining
+     */
+    reply(replyContent) {
+        if (typeof replyContent !== 'string') {
+            throw new Error('Reply content must be a string');
+        }
+        this._reply = replyContent;
+        return this;
+    }
+    /**
+     * Builds and returns the annotation object
+     * @returns Immutable annotation object
+     */
+    build() {
+        if (!this._bounds && this._type !== 'text') {
+            throw new Error(`Annotation type "${this._type}" requires bounds to be set`);
+        }
+        return {
+            type: this._type,
+            content: this._content,
+            author: this._author,
+            subject: this._subject,
+            color: [...this._color],
+            opacity: this._opacity,
+            bounds: this._bounds ? { ...this._bounds } : undefined,
+            creationDate: new Date(this._creationDate),
+            modificationDate: new Date(this._modificationDate),
+            flags: this._flags,
+            reply: this._reply,
+        };
+    }
+}
+/**
+ * Create a new AnnotationBuilder with static factory
+ * @deprecated Use AnnotationBuilder.create() instead
+ * @returns New builder instance
+ */
+export function createAnnotationBuilder() {
+    return AnnotationBuilder.create();
+}
+//# sourceMappingURL=annotation-builder.js.map

package/lib/builders/annotation-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-builder.js","sourceRoot":"","sources":["../../src/builders/annotation-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAuBH,MAAM,OAAO,iBAAiB;IAa5B;;;OAGG;IACH;QAhBQ,UAAK,GAAW,MAAM,CAAC;QACvB,aAAQ,GAAW,EAAE,CAAC;QAGtB,WAAM,GAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,oCAAoC;QAClE,aAAQ,GAAW,GAAG,CAAC;QAEvB,kBAAa,GAAS,IAAI,IAAI,EAAE,CAAC;QACjC,sBAAiB,GAAS,IAAI,IAAI,EAAE,CAAC;QACrC,WAAM,GAAW,CAAC,CAAC;IAOJ,CAAC;IAExB;;;OAGG;IACH,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,iBAAiB,EAAE,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,MAAM;QACJ,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,IAAY;QACf,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QACvF,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,4CAA4C,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvF,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAe;QACrB,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,MAAc;QACnB,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAe;QACrB,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,GAAa;QACjB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACjE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;OAUG;IACH,SAAS,CAAC,SAAiB;QACzB,MAAM,MAAM,GAA6B;YACvC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACd,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAChB,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACf,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACjB,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACf,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAClB,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAChB,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAChB,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;YACrB,MAAM,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;YACnB,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC;SACtB,CAAC;QAEF,MAAM,cAAc,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,oCAAoC,SAAS,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAe;QACrB,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAwB;QAC7B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QACD,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QACvC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACzE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC9E,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,IAAU;QACrB,IAAI,CAAC,CAAC,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,gBAAgB,CAAC,IAAU;QACzB,IAAI,CAAC,CAAC,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,iBAAiB,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,SAAS;QACP,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,aAAa;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,YAAY;QACV,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,mBAAmB;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,MAAe;QACpB,IAAI,OAAO,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,cAAc;QACpC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC;QACtB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAoB;QACxB,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,CAAC,KAAK,6BAA6B,CAAC,CAAC;QAC/E,CAAC;QAED,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,KAAK;YAChB,OAAO,EAAE,IAAI,CAAC,QAAQ;YACtB,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,OAAO,EAAE,IAAI,CAAC,QAAQ;YACtB,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;YACvB,OAAO,EAAE,IAAI,CAAC,QAAQ;YACtB,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS;YACtD,YAAY,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC;YAC1C,gBAAgB,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC;YAClD,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,KAAK,EAAE,IAAI,CAAC,MAAM;SACnB,CAAC;IACJ,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,iBAAiB,CAAC,MAAM,EAAE,CAAC;AACpC,CAAC"}

package/lib/builders/conversion-options-builder.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Builder for conversion options when converting PDF to other formats
+ *
+ * Configures how PDFs are converted to Markdown, HTML, or other text formats
+ * with options for formatting, image handling, and content extraction.
+ *
+ * @example
+ * ```typescript
+ * import { ConversionOptionsBuilder } from 'pdf_oxide';
+ *
+ * const options = ConversionOptionsBuilder.create()
+ *   .preserveFormatting(true)
+ *   .includeImages(true)
+ *   .detectHeadings(true)
+ *   .detectTables(true)
+ *   .build();
+ *
+ * const doc = PdfDocument.open('file.pdf');
+ * const markdown = doc.toMarkdown(0, options);
+ * ```
+ */
+interface PageRangeOptions {
+    start: number;
+    end: number;
+}
+export interface ConversionOptions {
+    preserveFormatting: boolean;
+    detectHeadings: boolean;
+    detectTables: boolean;
+    detectLists: boolean;
+    includeImages: boolean;
+    imageFormat: string;
+    imageQuality: number;
+    maxImageDimension: number;
+    outputEncoding: string;
+    normalizeWhitespace: boolean;
+    extractAnnotations: boolean;
+    useStructureTree: boolean;
+    pageRange?: PageRangeOptions;
+}
+export declare class ConversionOptionsBuilder {
+    private _preserveFormatting;
+    private _detectHeadings;
+    private _detectTables;
+    private _detectLists;
+    private _includeImages;
+    private _imageFormat;
+    private _imageQuality;
+    private _maxImageDimension;
+    private _outputEncoding;
+    private _normalizeWhitespace;
+    private _extractAnnotations;
+    private _useStructureTree;
+    private _pageRange?;
+    /**
+     * Creates a new ConversionOptionsBuilder instance
+     * @private
+     */
+    private constructor();
+    /**
+     * Creates a new ConversionOptionsBuilder instance
+     * @returns New builder instance
+     */
+    static create(): ConversionOptionsBuilder;
+    /**
+     * Creates options with default settings optimized for readability
+     * @returns Conversion options with default preset
+     */
+    static default(): ConversionOptions;
+    /**
+     * Creates options optimized for text-only extraction
+     * @returns Conversion options with text-only preset
+     */
+    static textOnly(): ConversionOptions;
+    /**
+     * Creates options optimized for maximum quality and detail preservation
+     * @returns Conversion options with high-quality preset
+     */
+    static highQuality(): ConversionOptions;
+    /**
+     * Creates options for fast, basic conversion
+     * @returns Conversion options with fast preset
+     */
+    static fast(): ConversionOptions;
+    preserveFormatting(preserve: boolean): this;
+    detectHeadings(detect: boolean): this;
+    detectTables(detect: boolean): this;
+    detectLists(detect: boolean): this;
+    includeImages(include: boolean): this;
+    imageFormat(format: string): this;
+    imageQuality(quality: number): this;
+    maxImageDimension(maxDimension: number): this;
+    outputEncoding(encoding: string): this;
+    normalizeWhitespace(normalize: boolean): this;
+    extractAnnotations(extract: boolean): this;
+    useStructureTree(use: boolean): this;
+    pageRange(start: number, end: number): this;
+    build(): ConversionOptions;
+}
+/**
+ * Create a new ConversionOptionsBuilder with static factory
+ * @deprecated Use ConversionOptionsBuilder.create() instead
+ * @returns New builder instance
+ */
+export declare function createConversionOptionsBuilder(): ConversionOptionsBuilder;
+export {};
+//# sourceMappingURL=conversion-options-builder.d.ts.map

package/lib/builders/conversion-options-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversion-options-builder.d.ts","sourceRoot":"","sources":["../../src/builders/conversion-options-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,UAAU,gBAAgB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAiB;IAChC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,qBAAa,wBAAwB;IACnC,OAAO,CAAC,mBAAmB,CAAiB;IAC5C,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,kBAAkB,CAAgB;IAC1C,OAAO,CAAC,eAAe,CAAmB;IAC1C,OAAO,CAAC,oBAAoB,CAAiB;IAC7C,OAAO,CAAC,mBAAmB,CAAkB;IAC7C,OAAO,CAAC,iBAAiB,CAAiB;IAC1C,OAAO,CAAC,UAAU,CAAC,CAAmB;IAEtC;;;OAGG;IACH,OAAO;IAEP;;;OAGG;IACH,MAAM,CAAC,MAAM,IAAI,wBAAwB;IAIzC;;;OAGG;IACH,MAAM,CAAC,OAAO,IAAI,iBAAiB;IAInC;;;OAGG;IACH,MAAM,CAAC,QAAQ,IAAI,iBAAiB;IAUpC;;;OAGG;IACH,MAAM,CAAC,WAAW,IAAI,iBAAiB;IAYvC;;;OAGG;IACH,MAAM,CAAC,IAAI,IAAI,iBAAiB;IAWhC,kBAAkB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAQ3C,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAQrC,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAQnC,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAQlC,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAQrC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IASjC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQnC,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAQ7C,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQtC,mBAAmB,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAQ7C,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAQ1C,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAQpC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAQ3C,KAAK,IAAI,iBAAiB;CAiB3B;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,IAAI,wBAAwB,CAEzE"}