pdf-oxide 0.3.39 → 0.3.41

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

@@ -251,6 +251,12 @@ export declare class PageBuilder {
     barcode1d(barcodeType: number, data: string, x: number, y: number, w: number, h: number): this;
     /** Place a QR-code image on the page (square: `size × size` pt). */
     barcodeQr(data: string, x: number, y: number, size: number): this;
+    /**
+     * Embed a JPEG/PNG image at (x, y, w, h) in PDF points.
+     * No alt text or /Artifact wrapper. Use `imageWithAlt` or `imageArtifact`
+     * for PDF/UA-1 accessibility requirements.
+     */
+    image(bytes: Buffer | Uint8Array, x: number, y: number, w: number, h: number): this;
     /**
      * Embed an image with an accessibility alt text (PDF/UA-1 §Figure).
      * `bytes` must contain raw JPEG/PNG/WebP image data.
@@ -282,6 +288,23 @@ export declare class PageBuilder {
         width?: number;
         color?: [number, number, number];
     }): this;
+    /**
+     * Draw a dashed rectangle outline. `dash` is the on/off lengths in PDF
+     * points (e.g. `[3, 2]` → 3 pt on, 2 pt off). `phase` offsets the dash
+     * start within the pattern.
+     */
+    strokeRectDashed(x: number, y: number, w: number, h: number, dash: number[], phase?: number, style?: {
+        width?: number;
+        color?: [number, number, number];
+    }): this;
+    /**
+     * Draw a dashed straight line. `dash` / `phase` semantics are the same as
+     * {@link strokeRectDashed}.
+     */
+    strokeLineDashed(x1: number, y1: number, x2: number, y2: number, dash: number[], phase?: number, style?: {
+        width?: number;
+        color?: [number, number, number];
+    }): this;
     /**
      * Place wrapped text inside the rectangle (x, y, w, h) with the
      * given horizontal alignment. Uses the current font + size. Text
@@ -328,6 +351,14 @@ export declare class PageBuilder {
     _streamingTablePushRow(cells: Array<string | null>): void;
     /** @internal — push one row with per-cell rowspan values. */
     _streamingTablePushRowV2(cells: Array<[string | null, number]>): void;
+    /** @internal — set the batch size for the open streaming table. */
+    _streamingTableSetBatchSize(batchSize: number): void;
+    /** @internal — return pending row count from native layer. */
+    _streamingTablePendingRowCount(): number;
+    /** @internal — return batch count from native layer. */
+    _streamingTableBatchCount(): number;
+    /** @internal — flush (mark batch boundary) in native layer. */
+    _streamingTableFlush(): void;
     /** @internal — close the open streaming table. */
     _streamingTableFinish(): void;
     /** @internal — track the last font size for JS-side `measure()`. */

package/lib/builders/document-builder.js

@@ -523,6 +523,15 @@ export class PageBuilder {
         native.pageBuilderBarcodeQr(this.h(), data, x, y, size);
         return this;
     }
+    /**
+     * Embed a JPEG/PNG image at (x, y, w, h) in PDF points.
+     * No alt text or /Artifact wrapper. Use `imageWithAlt` or `imageArtifact`
+     * for PDF/UA-1 accessibility requirements.
+     */
+    image(bytes, x, y, w, h) {
+        native.pageBuilderImage(this.h(), bytes, x, y, w, h);
+        return this;
+    }
     /**
      * Embed an image with an accessibility alt text (PDF/UA-1 §Figure).
      * `bytes` must contain raw JPEG/PNG/WebP image data.
@@ -575,6 +584,27 @@ export class PageBuilder {
         native.pageBuilderStrokeLine(this.h(), x1, y1, x2, y2, width, r, g, b);
         return this;
     }
+    /**
+     * Draw a dashed rectangle outline. `dash` is the on/off lengths in PDF
+     * points (e.g. `[3, 2]` → 3 pt on, 2 pt off). `phase` offsets the dash
+     * start within the pattern.
+     */
+    strokeRectDashed(x, y, w, h, dash, phase = 0, style) {
+        const width = style?.width ?? 1;
+        const [r, g, b] = style?.color ?? [0, 0, 0];
+        native.pageBuilderStrokeRectDashed(this.h(), x, y, w, h, width, r, g, b, dash, phase);
+        return this;
+    }
+    /**
+     * Draw a dashed straight line. `dash` / `phase` semantics are the same as
+     * {@link strokeRectDashed}.
+     */
+    strokeLineDashed(x1, y1, x2, y2, dash, phase = 0, style) {
+        const width = style?.width ?? 1;
+        const [r, g, b] = style?.color ?? [0, 0, 0];
+        native.pageBuilderStrokeLineDashed(this.h(), x1, y1, x2, y2, width, r, g, b, dash, phase);
+        return this;
+    }
     /**
      * Place wrapped text inside the rectangle (x, y, w, h) with the
      * given horizontal alignment. Uses the current font + size. Text
@@ -681,6 +711,22 @@ export class PageBuilder {
     _streamingTablePushRowV2(cells) {
         native.pageBuilderStreamingTablePushRowV2(this.h(), cells);
     }
+    /** @internal — set the batch size for the open streaming table. */
+    _streamingTableSetBatchSize(batchSize) {
+        native.pageBuilderStreamingTableSetBatchSize(this.h(), batchSize);
+    }
+    /** @internal — return pending row count from native layer. */
+    _streamingTablePendingRowCount() {
+        return native.pageBuilderStreamingTablePendingRowCount(this.h());
+    }
+    /** @internal — return batch count from native layer. */
+    _streamingTableBatchCount() {
+        return native.pageBuilderStreamingTableBatchCount(this.h());
+    }
+    /** @internal — flush (mark batch boundary) in native layer. */
+    _streamingTableFlush() {
+        native.pageBuilderStreamingTableFlush(this.h());
+    }
     /** @internal — close the open streaming table. */
     _streamingTableFinish() {
         native.pageBuilderStreamingTableFinish(this.h());

package/lib/builders/streaming-table.d.ts

@@ -26,8 +26,23 @@ export declare class StreamingTable {
     private _columns;
     private _opened;
     private _finished;
+    private _rowCount;
     /** @internal — constructed via `PageBuilder.streamingTable(...)`. */
     constructor(page: PageBuilder, config: StreamingTableConfig);
+    /**
+     * Number of rows pushed since the last batch boundary.
+     * Backed by the Rust FFI layer.
+     */
+    get pendingRowCount(): number;
+    /** Number of complete batches recorded by the native layer so far. */
+    get batchCount(): number;
+    /**
+     * Explicitly mark a batch boundary in the native layer.
+     * Also triggered automatically when the configured batch size is reached.
+     */
+    flush(): this;
+    /** Total rows pushed so far (monotonically increasing). */
+    get rowCount(): number;
     /** Push a single row (all rowspan=1). Throws if `cells.length !== columns.length`. */
     pushRow(cells: Array<string | null | undefined>): this;
     /**

package/lib/builders/streaming-table.js

@@ -24,6 +24,7 @@ export class StreamingTable {
     constructor(page, config) {
         this._opened = false;
         this._finished = false;
+        this._rowCount = 0;
         if (!config || !Array.isArray(config.columns) || config.columns.length === 0) {
             throw new Error('StreamingTable requires at least one column');
         }
@@ -36,6 +37,33 @@ export class StreamingTable {
         const maxRowspan = config.maxRowspan != null && config.maxRowspan >= 2 ? config.maxRowspan : 1;
         this._page._streamingTableBeginV2(headers, widths, aligns, repeat, config.mode, maxRowspan);
         this._opened = true;
+        const batchSize = config.batchSize != null && config.batchSize > 0 ? config.batchSize : 256;
+        this._page._streamingTableSetBatchSize(batchSize);
+    }
+    /**
+     * Number of rows pushed since the last batch boundary.
+     * Backed by the Rust FFI layer.
+     */
+    get pendingRowCount() {
+        return this._page._streamingTablePendingRowCount();
+    }
+    /** Number of complete batches recorded by the native layer so far. */
+    get batchCount() {
+        return this._page._streamingTableBatchCount();
+    }
+    /**
+     * Explicitly mark a batch boundary in the native layer.
+     * Also triggered automatically when the configured batch size is reached.
+     */
+    flush() {
+        if (this._finished)
+            throw new Error('StreamingTable already finished');
+        this._page._streamingTableFlush();
+        return this;
+    }
+    /** Total rows pushed so far (monotonically increasing). */
+    get rowCount() {
+        return this._rowCount;
     }
     /** Push a single row (all rowspan=1). Throws if `cells.length !== columns.length`. */
     pushRow(cells) {
@@ -46,6 +74,7 @@ export class StreamingTable {
             throw new Error(`row width ${cells.length} does not match column count ${this._columns.length}`);
         }
         this._page._streamingTablePushRow(cells.map((c) => (c == null ? null : String(c))));
+        this._rowCount++;
         return this;
     }
     /**
@@ -68,6 +97,7 @@ export class StreamingTable {
             return [c.text, c.rowspan];
         });
         this._page._streamingTablePushRowV2(normalized);
+        this._rowCount++;
         return this;
     }
     /**

package/lib/document-editor.d.ts

@@ -112,6 +112,8 @@ export declare class DocumentEditor {
     save(path: string): void;
     /** Save with AES-256 encryption (user + owner passwords). */
     saveEncrypted(path: string, userPassword: string, ownerPassword: string): void;
+    /** Extract specific pages (by 0-based index) into a new PDF returned as a Buffer. */
+    extractPagesToBytes(pageIndices: number[]): Buffer;
     /** Save the document to an in-memory Buffer. */
     saveToBytes(): Buffer;
     /** Save to an in-memory Buffer with explicit compression / GC / linearize flags. */

package/lib/document-editor.js

@@ -289,6 +289,11 @@ export class DocumentEditor {
         this._throwIfClosed();
         native.editorSaveEncrypted(this._handle, path, userPassword, ownerPassword);
     }
+    /** Extract specific pages (by 0-based index) into a new PDF returned as a Buffer. */
+    extractPagesToBytes(pageIndices) {
+        this._throwIfClosed();
+        return native.editorExtractPagesToBytes(this._handle, pageIndices);
+    }
     /** Save the document to an in-memory Buffer. */
     saveToBytes() {
         this._throwIfClosed();

package/lib/index.d.ts

@@ -81,6 +81,26 @@ declare class PdfDocumentImpl {
     estimateRenderTime(pageIndex: number, dpi?: number): number;
     page(index: number): Page;
     [Symbol.iterator](): Iterator<Page>;
+    /**
+     * Validate PDF/A conformance at a given level.
+     * @param level - "1a"|"1b"|"2a"|"2b"|"2u"|"3a"|"3b"|"3u" (default "2b")
+     */
+    validatePdfA(level?: '1a' | '1b' | '2a' | '2b' | '2u' | '3a' | '3b' | '3u'): {
+        compliant: boolean;
+        errors: string[];
+        warnings: string[];
+    };
+    /**
+     * Convert document to PDF/A conformance in-place.
+     * @param level - "1b"|"2b"|"2u"|"3b" etc. (default "2b")
+     * @returns true if the document is fully PDF/A-compliant after conversion (false if errors remain, e.g. fonts not embeddable without the rendering feature)
+     */
+    convertToPdfA(level?: '1a' | '1b' | '2a' | '2b' | '2u' | '3a' | '3b' | '3u'): boolean;
+    /**
+     * Return the current document bytes (including any in-place modifications
+     * made by convertToPdfA).
+     */
+    toBuffer(): Buffer;
     close(): void;
     [Symbol.dispose](): void;
 }
@@ -107,6 +127,8 @@ declare class Page {
     search(query: string, caseSensitive?: boolean): any;
     toString(): string;
 }
+declare function generateBarcodeSvg(data: string, format?: number, sizePx?: number): string;
+declare function generateQrCodeSvg(data: string, errorCorrection?: number, sizePx?: number): string;
 declare const getVersion: any;
 declare const getPdfOxideVersion: any;
 declare const PdfDocument: any;
@@ -123,4 +145,4 @@ declare const TextSearcher: any;
 export { Timestamp, TimestampHashAlgorithm } from './timestamp.js';
 export { TsaClient, type TsaClientOptions } from './tsa-client.js';
 export type { BatchDocument, BatchOptions, BatchProgress, BatchResult, BatchStatistics, Column, SpanCell, StreamingTableConfig, Table, TableMode, TableSpec, WorkerResult, WorkerTask, };
-export { AccessibilityException, AccessibilityManager, Align, AnnotationBuilder, AnnotationManager, AnnotationProperties, BarcodeErrorCorrection, BarcodeFormat, BarcodeManager, BatchManager, CacheManager, CertificateLoadFailed, Color, ComplianceException, ComplianceIssueType, ComplianceManager, ContentType, ConversionOptions, ConversionOptionsBuilder, createExtractionStream, createMetadataStream, createSearchStream, DigestAlgorithm, DocumentBuilder, DocumentEditor, EditingManager, EmbeddedFont, EncryptionException, EnterpriseManager, ErrorCategory, ErrorSeverity, ExtractionManager, ExtractionStream, FieldVisibility, FontProperties, FormFieldManager, FormFieldType, getPdfOxideVersion, getVersion, HybridMLManager, ImageFormat, ImageProperties, InvalidStateException, IoException, IssueSeverity, LayerManager, MetadataBuilder, MetadataManager, MetadataStream, mapFfiErrorCode, OCRDetectionMode, OCRLanguage, OCRManager, OcrException, OcrManager, OptimizationException, OptimizationManager, OutlineManager, Page, PageBuilder, PageComplexity, PageSize, ParseException, Pdf, PdfALevel, PdfBuilder, PdfDocument, PdfError, PdfException, PdfUALevel, PdfXLevel, Point, Rect, RedactionException, RenderingException, RenderingManager, ResultAccessorsManager, SearchException, SearchManager, SearchOptions, SearchOptionsBuilder, SearchResult, SearchResultProperties, SearchStream, SecurityManager, SignatureAlgorithm, SignatureException, SignatureManager, SigningFailed, StreamingTable, TextSearcher, ThumbnailManager, ThumbnailSize, UnknownError, UnsupportedFeatureException, ValidationException, WorkerPool, workerPool, wrapAsyncMethod, wrapError, wrapMethod, XfaFieldType, XfaFormType, XfaManager, };
+export { AccessibilityException, AccessibilityManager, Align, AnnotationBuilder, AnnotationManager, AnnotationProperties, BarcodeErrorCorrection, BarcodeFormat, BarcodeManager, BatchManager, CacheManager, CertificateLoadFailed, Color, ComplianceException, ComplianceIssueType, ComplianceManager, ContentType, ConversionOptions, ConversionOptionsBuilder, createExtractionStream, createMetadataStream, createSearchStream, DigestAlgorithm, DocumentBuilder, DocumentEditor, EditingManager, EmbeddedFont, EncryptionException, EnterpriseManager, ErrorCategory, ErrorSeverity, ExtractionManager, ExtractionStream, FieldVisibility, FontProperties, FormFieldManager, FormFieldType, generateBarcodeSvg, generateQrCodeSvg, getPdfOxideVersion, getVersion, HybridMLManager, ImageFormat, ImageProperties, InvalidStateException, IoException, IssueSeverity, LayerManager, MetadataBuilder, MetadataManager, MetadataStream, mapFfiErrorCode, OCRDetectionMode, OCRLanguage, OCRManager, OcrException, OcrManager, OptimizationException, OptimizationManager, OutlineManager, Page, PageBuilder, PageComplexity, PageSize, ParseException, Pdf, PdfALevel, PdfBuilder, PdfDocument, PdfError, PdfException, PdfUALevel, PdfXLevel, Point, Rect, RedactionException, RenderingException, RenderingManager, ResultAccessorsManager, SearchException, SearchManager, SearchOptions, SearchOptionsBuilder, SearchResult, SearchResultProperties, SearchStream, SecurityManager, SignatureAlgorithm, SignatureException, SignatureManager, SigningFailed, StreamingTable, TextSearcher, ThumbnailManager, ThumbnailSize, UnknownError, UnsupportedFeatureException, ValidationException, WorkerPool, workerPool, wrapAsyncMethod, wrapError, wrapMethod, XfaFieldType, XfaFormType, XfaManager, };

package/lib/index.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT OR Apache-2.0
 // PDF Oxide Node.js bindings - Native module loader
 import { createRequire } from 'node:module';
 import { dirname } from 'node:path';
@@ -333,6 +334,57 @@ class PdfDocumentImpl {
             },
         };
     }
+    /**
+     * Validate PDF/A conformance at a given level.
+     * @param level - "1a"|"1b"|"2a"|"2b"|"2u"|"3a"|"3b"|"3u" (default "2b")
+     */
+    validatePdfA(level = '2b') {
+        this.ensureOpen();
+        const levelMap = {
+            '1b': 0,
+            '1a': 1,
+            '2b': 2,
+            '2a': 3,
+            '2u': 4,
+            '3b': 5,
+            '3a': 6,
+            '3u': 7,
+        };
+        const levelInt = levelMap[level];
+        if (levelInt === undefined)
+            throw new RangeError(`Unknown PDF/A level: "${level}"`);
+        return native.validatePdfALevel(this._handle, levelInt);
+    }
+    /**
+     * Convert document to PDF/A conformance in-place.
+     * @param level - "1b"|"2b"|"2u"|"3b" etc. (default "2b")
+     * @returns true if the document is fully PDF/A-compliant after conversion (false if errors remain, e.g. fonts not embeddable without the rendering feature)
+     */
+    convertToPdfA(level = '2b') {
+        this.ensureOpen();
+        const levelMap = {
+            '1b': 0,
+            '1a': 1,
+            '2b': 2,
+            '2a': 3,
+            '2u': 4,
+            '3b': 5,
+            '3a': 6,
+            '3u': 7,
+        };
+        const levelInt = levelMap[level];
+        if (levelInt === undefined)
+            throw new RangeError(`Unknown PDF/A level: "${level}"`);
+        return native.convertToPdfA(this._handle, levelInt);
+    }
+    /**
+     * Return the current document bytes (including any in-place modifications
+     * made by convertToPdfA).
+     */
+    toBuffer() {
+        this.ensureOpen();
+        return native.documentGetSourceBytes(this._handle);
+    }
     close() {
         if (!this._closed && this._handle) {
             native.closeDocument(this._handle);
@@ -464,6 +516,28 @@ class PdfImpl {
         this.close();
     }
 }
+// Generate a 1D barcode as a vector SVG string.
+// format: 0=Code128, 1=Code39, 2=EAN13, 3=EAN8, 4=UPCA, 5=ITF, 6=Code93, 7=Codabar.
+function generateBarcodeSvg(data, format = 0, sizePx = 300) {
+    const handle = native.generateBarcode(format, data);
+    try {
+        return native.barcodeGetSVG(handle, sizePx);
+    }
+    finally {
+        native.freeBarcode(handle);
+    }
+}
+// Generate a QR code as a vector SVG string.
+// errorCorrection: 0=Low, 1=Medium, 2=Quartile, 3=High.
+function generateQrCodeSvg(data, errorCorrection = 1, sizePx = 300) {
+    const handle = native.generateQRCode(data, errorCorrection);
+    try {
+        return native.barcodeGetSVG(handle, sizePx);
+    }
+    finally {
+        native.freeBarcode(handle);
+    }
+}
 // Export as ES module
 const getVersion = native.getVersion;
 const getPdfOxideVersion = native.getPdfOxideVersion;
@@ -492,7 +566,7 @@ DocumentBuilder,
 // Editor mutation API
 DocumentEditor, EditingManager, EmbeddedFont, EncryptionException, EnterpriseManager, 
 // Error utilities
-ErrorCategory, ErrorSeverity, ExtractionManager, ExtractionStream, FieldVisibility, FontProperties, FormFieldManager, FormFieldType, getPdfOxideVersion, 
+ErrorCategory, ErrorSeverity, ExtractionManager, ExtractionStream, FieldVisibility, FontProperties, FormFieldManager, FormFieldType, generateBarcodeSvg, generateQrCodeSvg, getPdfOxideVersion, 
 // Version info
 getVersion, HybridMLManager, ImageFormat, ImageProperties, InvalidStateException, IoException, IssueSeverity, LayerManager, MetadataBuilder, MetadataManager, MetadataStream, mapFfiErrorCode, OCRDetectionMode, OCRLanguage, OCRManager, OcrException, 
 // Managers (Phase 4+, consolidated in Phase 9)

package/lib/managers/barcode-manager.d.ts

@@ -49,6 +49,7 @@ export interface BarcodeGenerationConfig {
     format?: BarcodeFormat;
     width?: number;
     height?: number;
+    sizePx?: number;
     errorCorrection?: BarcodeErrorCorrection;
     margin?: number;
 }
@@ -68,6 +69,8 @@ export declare class BarcodeManager extends EventEmitter {
     generateQrCode(data: string, errorCorrection?: QrErrorCorrection, sizePx?: number): Promise<Buffer>;
     barcodeToPng(barcodeData: Buffer, sizePx?: number): Promise<Buffer>;
     barcodeToSvg(barcodeData: Buffer, sizePx?: number): Promise<string>;
+    generateSvg(data: string, config?: BarcodeGenerationConfig): Promise<string>;
+    generateQrSvg(data: string, errorCorrection?: QrErrorCorrection, sizePx?: number): Promise<string>;
     addBarcodeToPage(pageIndex: number, barcodeData: Buffer, x: number, y: number, width: number, height: number): Promise<boolean>;
     detectBarcodeFormat(barcodeData: Buffer): BarcodeFormat;
     decodeBarcodeData(barcodeData: Buffer): string;

package/lib/managers/barcode-manager.js

@@ -187,9 +187,36 @@ export class BarcodeManager extends EventEmitter {
         return barcodeData;
     }
     async barcodeToSvg(barcodeData, sizePx = 256) {
+        // Legacy: wraps existing PNG bytes in an SVG <image> element.
+        // For real vector SVG use generateBarcodeSvg() / generateQrCodeSvg() from the top-level API.
         const encoded = barcodeData.toString('base64');
         return `<svg xmlns="http://www.w3.org/2000/svg"><image href="data:image/png;base64,${encoded}"/></svg>`;
     }
+    async generateSvg(data, config) {
+        const format = config?.format ?? BarcodeFormat.CODE128;
+        if (this.native?.generateBarcode && this.native?.barcodeGetSVG && this.native?.freeBarcode) {
+            const handle = this.native.generateBarcode(format, data);
+            try {
+                return this.native.barcodeGetSVG(handle, config?.sizePx ?? 300);
+            }
+            finally {
+                this.native.freeBarcode(handle);
+            }
+        }
+        return '';
+    }
+    async generateQrSvg(data, errorCorrection = QrErrorCorrection.M, sizePx = 300) {
+        if (this.native?.generateQRCode && this.native?.barcodeGetSVG && this.native?.freeBarcode) {
+            const handle = this.native.generateQRCode(data, errorCorrection);
+            try {
+                return this.native.barcodeGetSVG(handle, sizePx);
+            }
+            finally {
+                this.native.freeBarcode(handle);
+            }
+        }
+        return '';
+    }
     async addBarcodeToPage(pageIndex, barcodeData, x, y, width, height) {
         try {
             if (!this.document)

package/lib/types/common.d.ts

@@ -173,6 +173,11 @@ export interface StreamingTableConfig {
      * Set to ≥2 to allow `pushRowSpan` cells to span multiple rows.
      */
     maxRowspan?: number;
+    /**
+     * Maximum rows to buffer before an automatic batch flush in the native
+     * layer. 0 or unset defaults to 256.
+     */
+    batchSize?: number;
 }
 /**
  * A single cell value for `StreamingTable.pushRowSpan`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pdf-oxide",
-  "version": "0.3.39",
+  "version": "0.3.41",
   "type": "module",
   "description": "High-performance PDF parsing and text extraction library — prebuilt native bindings, no build toolchain required",
   "main": "lib/index.js",