pdf-oxide 0.3.24 → 0.3.29

package/lib/builders/pdf-builder.js

@@ -0,0 +1,339 @@
+/**
+ * Fluent builder for creating PDF documents with configuration
+ *
+ * Provides a fluent API for configuring PDF document metadata and options
+ * before document creation.
+ *
+ * @example
+ * ```typescript
+ * import { PdfBuilder } from 'pdf_oxide';
+ *
+ * const pdf = PdfBuilder.create()
+ *   .title('My Document')
+ *   .author('John Doe')
+ *   .subject('PDF Creation')
+ *   .keywords(['pdf', 'document', 'example'])
+ *   .fromMarkdown('# Content\n\nMarkdown text here');
+ *
+ * pdf.save('output.pdf');
+ * ```
+ */
+export class PdfBuilder {
+    /**
+     * Creates a new PdfBuilder instance
+     * @private
+     */
+    constructor() {
+        this._keywords = [];
+        this._margins = {
+            top: 36,
+            bottom: 36,
+            left: 36,
+            right: 36,
+        };
+    }
+    /**
+     * Creates a new PdfBuilder instance
+     * @returns New builder instance
+     *
+     * @example
+     * ```typescript
+     * const builder = PdfBuilder.create();
+     * ```
+     */
+    static create() {
+        return new PdfBuilder();
+    }
+    /**
+     * Sets the document title
+     * @param title - The document title
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * builder.title('My Document Title');
+     * ```
+     */
+    title(title) {
+        if (typeof title !== 'string' || title.length === 0) {
+            throw new Error('Title must be a non-empty string');
+        }
+        this._title = title;
+        return this;
+    }
+    /**
+     * Sets the document author
+     * @param author - The author name
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * builder.author('Jane Doe');
+     * ```
+     */
+    author(author) {
+        if (typeof author !== 'string' || author.length === 0) {
+            throw new Error('Author must be a non-empty string');
+        }
+        this._author = author;
+        return this;
+    }
+    /**
+     * Sets the document subject
+     * @param subject - The document subject
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * builder.subject('Technical Documentation');
+     * ```
+     */
+    subject(subject) {
+        if (typeof subject !== 'string' || subject.length === 0) {
+            throw new Error('Subject must be a non-empty string');
+        }
+        this._subject = subject;
+        return this;
+    }
+    /**
+     * Sets the document keywords
+     * @param keywords - Array of keywords
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * builder.keywords(['PDF', 'Document', 'Generation']);
+     * ```
+     */
+    keywords(keywords) {
+        if (!Array.isArray(keywords)) {
+            throw new Error('Keywords must be an array');
+        }
+        if (!keywords.every((k) => typeof k === 'string')) {
+            throw new Error('All keywords must be strings');
+        }
+        this._keywords = keywords;
+        return this;
+    }
+    /**
+     * Adds a single keyword to the document
+     * @param keyword - A keyword to add
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * builder.addKeyword('Important').addKeyword('Urgent');
+     * ```
+     */
+    addKeyword(keyword) {
+        if (typeof keyword !== 'string' || keyword.length === 0) {
+            throw new Error('Keyword must be a non-empty string');
+        }
+        this._keywords.push(keyword);
+        return this;
+    }
+    /**
+     * Sets the default page size
+     * @param pageSize - Page size name (e.g., 'Letter', 'A4', 'Legal')
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * builder.pageSize('A4');
+     * ```
+     */
+    pageSize(pageSize) {
+        const validSizes = ['Letter', 'Legal', 'A4', 'A3', 'A5', 'B4', 'B5'];
+        if (!validSizes.includes(pageSize)) {
+            throw new Error(`Invalid page size. Must be one of: ${validSizes.join(', ')}`);
+        }
+        this._pageSize = pageSize;
+        return this;
+    }
+    /**
+     * Sets page margins
+     * @param top - Top margin in points
+     * @param right - Right margin in points
+     * @param bottom - Bottom margin in points
+     * @param left - Left margin in points
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * builder.margins(36, 36, 36, 36); // 0.5 inches on all sides
+     * ```
+     */
+    margins(top, right, bottom, left) {
+        if (![top, right, bottom, left].every((m) => typeof m === 'number' && m >= 0)) {
+            throw new Error('All margins must be non-negative numbers');
+        }
+        this._margins = { top, right, bottom, left };
+        return this;
+    }
+    /**
+     * Creates a PDF document from Markdown content
+     * @param markdown - Markdown formatted content
+     * @returns The created PDF document
+     * @throws PdfError if PDF creation fails
+     *
+     * @example
+     * ```typescript
+     * const pdf = builder.fromMarkdown('# Title\n\nContent here');
+     * ```
+     */
+    fromMarkdown(markdown) {
+        // Note: Using any for Pdf type to avoid circular dependency
+        const { Pdf } = require('../index.js');
+        if (typeof markdown !== 'string') {
+            throw new Error('Markdown must be a string');
+        }
+        const pdf = Pdf.fromMarkdown(markdown);
+        this._applyConfiguration(pdf);
+        return pdf;
+    }
+    /**
+     * Creates a PDF document from HTML content
+     * @param html - HTML formatted content
+     * @returns The created PDF document
+     * @throws PdfError if PDF creation fails
+     *
+     * @example
+     * ```typescript
+     * const pdf = builder.fromHtml('<h1>Title</h1><p>Content</p>');
+     * ```
+     */
+    fromHtml(html) {
+        const { Pdf } = require('../index.js');
+        if (typeof html !== 'string') {
+            throw new Error('HTML must be a string');
+        }
+        const pdf = Pdf.fromHtml(html);
+        this._applyConfiguration(pdf);
+        return pdf;
+    }
+    /**
+     * Creates a PDF document from plain text content
+     * @param text - Plain text content
+     * @returns The created PDF document
+     * @throws PdfError if PDF creation fails
+     *
+     * @example
+     * ```typescript
+     * const pdf = builder.fromText('Plain text content');
+     * ```
+     */
+    fromText(text) {
+        const { Pdf } = require('../index.js');
+        if (typeof text !== 'string') {
+            throw new Error('Text must be a string');
+        }
+        const pdf = Pdf.fromText(text);
+        this._applyConfiguration(pdf);
+        return pdf;
+    }
+    /**
+     * Asynchronously creates a PDF document from Markdown content
+     * @param markdown - Markdown formatted content
+     * @returns Promise that resolves to the created PDF document
+     * @throws PdfError if PDF creation fails
+     *
+     * @example
+     * ```typescript
+     * const pdf = await builder.fromMarkdownAsync('# Title\n\nContent');
+     * ```
+     */
+    async fromMarkdownAsync(markdown) {
+        const { Pdf } = require('../index.js');
+        if (typeof markdown !== 'string') {
+            throw new Error('Markdown must be a string');
+        }
+        const pdf = await Pdf.fromMarkdownAsync(markdown);
+        this._applyConfiguration(pdf);
+        return pdf;
+    }
+    /**
+     * Asynchronously creates a PDF document from HTML content
+     * @param html - HTML formatted content
+     * @returns Promise that resolves to the created PDF document
+     * @throws PdfError if PDF creation fails
+     *
+     * @example
+     * ```typescript
+     * const pdf = await builder.fromHtmlAsync('<h1>Title</h1>');
+     * ```
+     */
+    async fromHtmlAsync(html) {
+        const { Pdf } = require('../index.js');
+        if (typeof html !== 'string') {
+            throw new Error('HTML must be a string');
+        }
+        const pdf = await Pdf.fromHtmlAsync(html);
+        this._applyConfiguration(pdf);
+        return pdf;
+    }
+    /**
+     * Asynchronously creates a PDF document from plain text content
+     * @param text - Plain text content
+     * @returns Promise that resolves to the created PDF document
+     * @throws PdfError if PDF creation fails
+     *
+     * @example
+     * ```typescript
+     * const pdf = await builder.fromTextAsync('Plain text');
+     * ```
+     */
+    async fromTextAsync(text) {
+        const { Pdf } = require('../index.js');
+        if (typeof text !== 'string') {
+            throw new Error('Text must be a string');
+        }
+        const pdf = await Pdf.fromTextAsync(text);
+        this._applyConfiguration(pdf);
+        return pdf;
+    }
+    /**
+     * Gets the current configuration as a plain object
+     * @returns Configuration object with title, author, subject, keywords
+     *
+     * @private
+     */
+    _getConfiguration() {
+        return {
+            title: this._title,
+            author: this._author,
+            subject: this._subject,
+            keywords: this._keywords,
+            pageSize: this._pageSize,
+            margins: this._margins,
+        };
+    }
+    /**
+     * Applies builder configuration to a PDF document
+     * @param pdf - The PDF document to configure
+     * @private
+     */
+    _applyConfiguration(pdf) {
+        // Apply metadata properties if set
+        if (this._title !== undefined) {
+            pdf.title = this._title;
+        }
+        if (this._author !== undefined) {
+            pdf.author = this._author;
+        }
+        if (this._subject !== undefined) {
+            pdf.subject = this._subject;
+        }
+        if (this._keywords.length > 0) {
+            pdf.keywords = [...this._keywords];
+        }
+    }
+}
+/**
+ * Create a new PdfBuilder with static factory
+ * @deprecated Use PdfBuilder.create() instead
+ * @returns New builder instance
+ */
+export function createPdfBuilder() {
+    return PdfBuilder.create();
+}
+//# sourceMappingURL=pdf-builder.js.map

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

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

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

@@ -0,0 +1,74 @@
+/**
+ * Builder for text search options
+ *
+ * Configures how text search is performed in PDF documents,
+ * including case sensitivity, whole word matching, and regex support.
+ *
+ * @example
+ * ```typescript
+ * import { SearchOptionsBuilder } from 'pdf_oxide';
+ *
+ * const options = SearchOptionsBuilder.create()
+ *   .caseSensitive(false)
+ *   .wholeWords(true)
+ *   .useRegex(false)
+ *   .build();
+ *
+ * const results = doc.search('pattern', 0, options);
+ * ```
+ */
+export interface SearchOptions {
+    caseSensitive: boolean;
+    wholeWords: boolean;
+    useRegex: boolean;
+    ignoreAccents: boolean;
+    maxResults: number;
+    searchAnnotations: boolean;
+}
+export declare class SearchOptionsBuilder {
+    private _caseSensitive;
+    private _wholeWords;
+    private _useRegex;
+    private _ignoreAccents;
+    private _maxResults;
+    private _searchAnnotations;
+    /**
+     * Creates a new SearchOptionsBuilder instance
+     * @private
+     */
+    private constructor();
+    /**
+     * Creates a new SearchOptionsBuilder instance
+     * @returns New builder instance
+     */
+    static create(): SearchOptionsBuilder;
+    /**
+     * Creates options with default search settings (case-insensitive, no regex)
+     * @returns Search options with default preset
+     */
+    static default(): SearchOptions;
+    /**
+     * Creates options with strict search settings (case-sensitive, whole words, no regex)
+     * @returns Search options with strict preset
+     */
+    static strict(): SearchOptions;
+    /**
+     * Creates options with regex search settings
+     * @returns Search options with regex preset
+     */
+    static regex(): SearchOptions;
+    caseSensitive(sensitive: boolean): this;
+    wholeWords(wholeOnly: boolean): this;
+    useRegex(regex: boolean): this;
+    ignoreAccents(ignore: boolean): this;
+    maxResults(max: number): this;
+    searchAnnotations(search: boolean): this;
+    build(): SearchOptions;
+}
+/**
+ * Create a new SearchOptionsBuilder with static factory
+ * @deprecated Use SearchOptionsBuilder.create() instead
+ * @returns New builder instance
+ */
+export declare function createSearchOptionsBuilder(): SearchOptionsBuilder;
+//# sourceMappingURL=search-options-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-options-builder.d.ts","sourceRoot":"","sources":["../../src/builders/search-options-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,kBAAkB,CAAkB;IAE5C;;;OAGG;IACH,OAAO;IAEP;;;OAGG;IACH,MAAM,CAAC,MAAM,IAAI,oBAAoB;IAIrC;;;OAGG;IACH,MAAM,CAAC,OAAO,IAAI,aAAa;IAI/B;;;OAGG;IACH,MAAM,CAAC,MAAM,IAAI,aAAa;IAQ9B;;;OAGG;IACH,MAAM,CAAC,KAAK,IAAI,aAAa;IAQ7B,aAAa,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAQvC,UAAU,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAQpC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAQ9B,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAQpC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQ7B,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAQxC,KAAK,IAAI,aAAa;CAUvB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,oBAAoB,CAEjE"}

package/lib/builders/search-options-builder.js

@@ -0,0 +1,130 @@
+/**
+ * Builder for text search options
+ *
+ * Configures how text search is performed in PDF documents,
+ * including case sensitivity, whole word matching, and regex support.
+ *
+ * @example
+ * ```typescript
+ * import { SearchOptionsBuilder } from 'pdf_oxide';
+ *
+ * const options = SearchOptionsBuilder.create()
+ *   .caseSensitive(false)
+ *   .wholeWords(true)
+ *   .useRegex(false)
+ *   .build();
+ *
+ * const results = doc.search('pattern', 0, options);
+ * ```
+ */
+export class SearchOptionsBuilder {
+    /**
+     * Creates a new SearchOptionsBuilder instance
+     * @private
+     */
+    constructor() {
+        this._caseSensitive = false;
+        this._wholeWords = false;
+        this._useRegex = false;
+        this._ignoreAccents = false;
+        this._maxResults = 1000;
+        this._searchAnnotations = false;
+    }
+    /**
+     * Creates a new SearchOptionsBuilder instance
+     * @returns New builder instance
+     */
+    static create() {
+        return new SearchOptionsBuilder();
+    }
+    /**
+     * Creates options with default search settings (case-insensitive, no regex)
+     * @returns Search options with default preset
+     */
+    static default() {
+        return SearchOptionsBuilder.create().build();
+    }
+    /**
+     * Creates options with strict search settings (case-sensitive, whole words, no regex)
+     * @returns Search options with strict preset
+     */
+    static strict() {
+        return SearchOptionsBuilder.create()
+            .caseSensitive(true)
+            .wholeWords(true)
+            .useRegex(false)
+            .build();
+    }
+    /**
+     * Creates options with regex search settings
+     * @returns Search options with regex preset
+     */
+    static regex() {
+        return SearchOptionsBuilder.create()
+            .useRegex(true)
+            .caseSensitive(false)
+            .wholeWords(false)
+            .build();
+    }
+    caseSensitive(sensitive) {
+        if (typeof sensitive !== 'boolean') {
+            throw new Error('caseSensitive must be a boolean');
+        }
+        this._caseSensitive = sensitive;
+        return this;
+    }
+    wholeWords(wholeOnly) {
+        if (typeof wholeOnly !== 'boolean') {
+            throw new Error('wholeWords must be a boolean');
+        }
+        this._wholeWords = wholeOnly;
+        return this;
+    }
+    useRegex(regex) {
+        if (typeof regex !== 'boolean') {
+            throw new Error('useRegex must be a boolean');
+        }
+        this._useRegex = regex;
+        return this;
+    }
+    ignoreAccents(ignore) {
+        if (typeof ignore !== 'boolean') {
+            throw new Error('ignoreAccents must be a boolean');
+        }
+        this._ignoreAccents = ignore;
+        return this;
+    }
+    maxResults(max) {
+        if (typeof max !== 'number' || max <= 0) {
+            throw new Error('maxResults must be a positive number');
+        }
+        this._maxResults = Math.floor(max);
+        return this;
+    }
+    searchAnnotations(search) {
+        if (typeof search !== 'boolean') {
+            throw new Error('searchAnnotations must be a boolean');
+        }
+        this._searchAnnotations = search;
+        return this;
+    }
+    build() {
+        return {
+            caseSensitive: this._caseSensitive,
+            wholeWords: this._wholeWords,
+            useRegex: this._useRegex,
+            ignoreAccents: this._ignoreAccents,
+            maxResults: this._maxResults,
+            searchAnnotations: this._searchAnnotations,
+        };
+    }
+}
+/**
+ * Create a new SearchOptionsBuilder with static factory
+ * @deprecated Use SearchOptionsBuilder.create() instead
+ * @returns New builder instance
+ */
+export function createSearchOptionsBuilder() {
+    return SearchOptionsBuilder.create();
+}
+//# sourceMappingURL=search-options-builder.js.map

package/lib/builders/search-options-builder.js.map

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