pdf-oxide 0.3.38 → 0.3.39

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

@@ -23,6 +23,8 @@
  * const bytes = builder.build();            // consumes the builder
  * ```
  */
+import { Align, type Column, type SpanCell, type StreamingTableConfig, type TableMode, type TableSpec } from '../types/common.js';
+import { StreamingTable } from './streaming-table.js';
 /**
  * TTF/OTF font handle registerable with {@link DocumentBuilder}. Single-use:
  * after `registerEmbeddedFont` the native handle is moved into the builder
@@ -69,6 +71,29 @@ export declare class DocumentBuilder {
     keywords(keywords: string): this;
     /** Set the creator application name. */
     creator(creator: string): this;
+    /** Run a JavaScript script when the document is opened (/OpenAction). */
+    onOpen(script: string): this;
+    /**
+     * Enable PDF/UA-1 tagged PDF mode.
+     *
+     * When enabled, `build()` emits `/MarkInfo`, `/StructTreeRoot`, `/Lang`, and
+     * `/ViewerPreferences` in the catalog. Opt-in — no effect unless called.
+     * Bundle F-1/F-2.
+     */
+    taggedPdfUa1(): this;
+    /**
+     * Set the document's natural language tag, e.g. `"en-US"`.
+     *
+     * Emitted as `/Lang` in the catalog when `taggedPdfUa1()` is set. Bundle F-2.
+     */
+    language(lang: string): this;
+    /**
+     * Add a role-map entry: custom structure type → standard PDF structure type.
+     *
+     * Emitted in `/RoleMap` inside the StructTreeRoot when `taggedPdfUa1()` is
+     * set. Multiple calls accumulate entries. Bundle F-4.
+     */
+    roleMap(custom: string, standard: string): this;
     /**
      * Register a TTF / OTF font under `name`. CONSUMES `font` on success —
      * do not call `close()` on the font afterwards.
@@ -125,6 +150,20 @@ export declare class PageBuilder {
     linkPage(pageIndex: number): this;
     /** Link the previous text to a named destination. */
     linkNamed(destination: string): this;
+    /** Link the previous text to a JavaScript action. */
+    linkJavascript(script: string): this;
+    /** Run JavaScript when this page is opened (/AA /O). */
+    onOpen(script: string): this;
+    /** Run JavaScript when this page is closed (/AA /C). */
+    onClose(script: string): this;
+    /** Set a keystroke JS action (/AA /K) on the last form field. */
+    fieldKeystroke(script: string): this;
+    /** Set a format JS action (/AA /F) on the last form field. */
+    fieldFormat(script: string): this;
+    /** Set a validate JS action (/AA /V) on the last form field. */
+    fieldValidate(script: string): this;
+    /** Set a calculate JS action (/AA /C) on the last form field. */
+    fieldCalculate(script: string): this;
     /** Highlight the previous text with an RGB colour (channels 0-1). */
     highlight(r: number, g: number, b: number): this;
     /** Underline the previous text. */
@@ -177,12 +216,122 @@ export declare class PageBuilder {
     radioGroup(name: string, buttons: Array<[string, number, number, number, number]>, selected?: string): this;
     /** Add a clickable push button with a visible caption. */
     pushButton(name: string, x: number, y: number, w: number, h: number, caption: string): this;
+    /** Add an unsigned signature placeholder field (/FT /Sig) at the given bounds. */
+    signatureField(name: string, x: number, y: number, w: number, h: number): this;
+    /**
+     * Add a footnote: inline `refMark` emitted at the cursor position, and
+     * `noteText` placed near the page bottom with a separator artifact line.
+     */
+    footnote(refMark: string, noteText: string): this;
+    /**
+     * Lay out `text` as balanced multi-column flow.
+     * `columnCount` columns separated by `gapPt` points.
+     * Paragraphs in `text` are delimited by `"\n\n"`.
+     */
+    columns(columnCount: number, gapPt: number, text: string): this;
+    /**
+     * Emit `text` inline at the current cursor position without advancing
+     * to a new line. The cursor advances horizontally so the next `inline`
+     * call follows on the same line.
+     */
+    inline(text: string): this;
+    /** Emit `text` inline in bold weight. */
+    inlineBold(text: string): this;
+    /** Emit `text` inline in italic style. */
+    inlineItalic(text: string): this;
+    /** Emit `text` inline in an RGB colour (channels 0–1). */
+    inlineColor(r: number, g: number, b: number, text: string): this;
+    /** Advance the cursor to the start of the next line. */
+    newline(): this;
+    /**
+     * Place a 1-D barcode image on the page at `(x, y, w, h)`.
+     * `barcodeType`: 0=Code128 1=Code39 2=EAN13 3=EAN8 4=UPCA 5=ITF
+     * 6=Code93 7=Codabar.
+     */
+    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 an image with an accessibility alt text (PDF/UA-1 §Figure).
+     * `bytes` must contain raw JPEG/PNG/WebP image data.
+     */
+    imageWithAlt(bytes: Buffer | Uint8Array, x: number, y: number, w: number, h: number, altText: string): this;
+    /**
+     * Embed a decorative image as an /Artifact (no alt text, PDF/UA-1 §Artifact).
+     * `bytes` must contain raw JPEG/PNG/WebP image data.
+     */
+    imageArtifact(bytes: Buffer | Uint8Array, x: number, y: number, w: number, h: number): this;
     /** Draw a stroked rectangle outline (1pt black). */
     rect(x: number, y: number, w: number, h: number): this;
     /** Draw a filled rectangle in RGB colour (channels 0–1). */
     filledRect(x: number, y: number, w: number, h: number, r: number, g: number, b: number): this;
     /** Draw a line from `(x1, y1)` to `(x2, y2)` with 1pt black stroke. */
     line(x1: number, y1: number, x2: number, y2: number): this;
+    /**
+     * Draw a stroked rectangle outline with caller-supplied width + RGB
+     * colour (channels 0–1). Underlies the Table surface.
+     */
+    strokeRect(x: number, y: number, w: number, h: number, style?: {
+        width?: number;
+        color?: [number, number, number];
+    }): this;
+    /**
+     * Draw a straight line with caller-supplied width + RGB colour.
+     */
+    strokeLine(x1: number, y1: number, x2: number, y2: 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
+     * that does not fit is clipped to the rectangle height.
+     */
+    textInRect(x: number, y: number, w: number, h: number, text: string, align?: Align): this;
+    /**
+     * Start a new page with the *same* dimensions as the current one.
+     * Text config (font + size) carries over; the cursor resets to the
+     * top-left margin. Callers wanting header-repeat-on-break must
+     * re-emit the header explicitly.
+     */
+    newPageSameSize(): this;
+    /**
+     * Measure the width of `text` in the current font and size.
+     *
+     * Note: v0.3.39 ships a JS-side approximation (0.55em per glyph for
+     * ASCII / typical Latin-1 characters). A true per-glyph measurement
+     * FFI is pending. The result is in PDF points.
+     */
+    measure(text: string): number;
+    /**
+     * Estimate the remaining vertical space on the page at the current
+     * cursor position. v0.3.39 returns `null` when the native cursor is
+     * unknown — callers should treat `null` as "unknown; assume fresh
+     * page". A real FFI hook is pending in a follow-up release.
+     */
+    remainingSpace(): number | null;
+    /**
+     * Emit a buffered table at the current cursor. All rows are
+     * marshalled into a single FFI call — memory scales with the row
+     * count. For million-row streams use {@link streamingTable}.
+     */
+    table(spec: TableSpec): this;
+    /**
+     * Begin a streaming table. Uses the native row-at-a-time FFI
+     * (`pdf_page_builder_streaming_table_begin_v2`). Pass a `mode` in
+     * `config` to control column-sizing strategy (default: fixed widths).
+     */
+    streamingTable(config: StreamingTableConfig): StreamingTable;
+    /** @internal — open streaming table FFI handle on this page. */
+    _streamingTableBeginV2(headers: string[], widths: number[], aligns: number[], repeatHeader: boolean, mode: TableMode | undefined, maxRowspan: number): void;
+    /** @internal — push one row into the open streaming table (all rowspan=1). */
+    _streamingTablePushRow(cells: Array<string | null>): void;
+    /** @internal — push one row with per-cell rowspan values. */
+    _streamingTablePushRowV2(cells: Array<[string | null, number]>): void;
+    /** @internal — close the open streaming table. */
+    _streamingTableFinish(): void;
+    /** @internal — track the last font size for JS-side `measure()`. */
+    _lastFontSize?: number;
     /**
      * Commit the page's buffered operations to the parent builder and
      * return the parent for chaining. After `done()` this PageBuilder is
@@ -197,3 +346,5 @@ export declare class PageBuilder {
     /** Symbol.dispose support for `using`. */
     [Symbol.dispose](): void;
 }
+export { StreamingTable } from './streaming-table.js';
+export { Align, type Column, type SpanCell, type StreamingTableConfig, type TableMode, type TableSpec, };

package/lib/builders/document-builder.js

@@ -27,6 +27,8 @@
 // against `prebuilds/<triple>/pdf_oxide.node` in the published
 // package and the in-tree `build/Release/` output in dev mode.
 import { loadNative } from '../native.js';
+import { Align, } from '../types/common.js';
+import { StreamingTable } from './streaming-table.js';
 const native = loadNative();
 /**
  * TTF/OTF font handle registerable with {@link DocumentBuilder}. Single-use:
@@ -123,6 +125,41 @@ export class DocumentBuilder {
         native.documentBuilderSetCreator(this.checkUsable(), creator);
         return this;
     }
+    /** Run a JavaScript script when the document is opened (/OpenAction). */
+    onOpen(script) {
+        native.documentBuilderOnOpen(this.checkUsable(), script);
+        return this;
+    }
+    /**
+     * Enable PDF/UA-1 tagged PDF mode.
+     *
+     * When enabled, `build()` emits `/MarkInfo`, `/StructTreeRoot`, `/Lang`, and
+     * `/ViewerPreferences` in the catalog. Opt-in — no effect unless called.
+     * Bundle F-1/F-2.
+     */
+    taggedPdfUa1() {
+        native.documentBuilderTaggedPdfUa1(this.checkUsable());
+        return this;
+    }
+    /**
+     * Set the document's natural language tag, e.g. `"en-US"`.
+     *
+     * Emitted as `/Lang` in the catalog when `taggedPdfUa1()` is set. Bundle F-2.
+     */
+    language(lang) {
+        native.documentBuilderLanguage(this.checkUsable(), lang);
+        return this;
+    }
+    /**
+     * Add a role-map entry: custom structure type → standard PDF structure type.
+     *
+     * Emitted in `/RoleMap` inside the StructTreeRoot when `taggedPdfUa1()` is
+     * set. Multiple calls accumulate entries. Bundle F-4.
+     */
+    roleMap(custom, standard) {
+        native.documentBuilderRoleMap(this.checkUsable(), custom, standard);
+        return this;
+    }
     /**
      * Register a TTF / OTF font under `name`. CONSUMES `font` on success —
      * do not call `close()` on the font afterwards.
@@ -235,6 +272,7 @@ export class PageBuilder {
     /** Set font + size for subsequent text. */
     font(name, size) {
         native.pageBuilderFont(this.h(), name, size);
+        this._lastFontSize = size;
         return this;
     }
     /** Move the cursor to absolute coordinates. */
@@ -283,6 +321,41 @@ export class PageBuilder {
         native.pageBuilderLinkNamed(this.h(), destination);
         return this;
     }
+    /** Link the previous text to a JavaScript action. */
+    linkJavascript(script) {
+        native.pageBuilderLinkJavascript(this.h(), script);
+        return this;
+    }
+    /** Run JavaScript when this page is opened (/AA /O). */
+    onOpen(script) {
+        native.pageBuilderOnOpen(this.h(), script);
+        return this;
+    }
+    /** Run JavaScript when this page is closed (/AA /C). */
+    onClose(script) {
+        native.pageBuilderOnClose(this.h(), script);
+        return this;
+    }
+    /** Set a keystroke JS action (/AA /K) on the last form field. */
+    fieldKeystroke(script) {
+        native.pageBuilderFieldKeystroke(this.h(), script);
+        return this;
+    }
+    /** Set a format JS action (/AA /F) on the last form field. */
+    fieldFormat(script) {
+        native.pageBuilderFieldFormat(this.h(), script);
+        return this;
+    }
+    /** Set a validate JS action (/AA /V) on the last form field. */
+    fieldValidate(script) {
+        native.pageBuilderFieldValidate(this.h(), script);
+        return this;
+    }
+    /** Set a calculate JS action (/AA /C) on the last form field. */
+    fieldCalculate(script) {
+        native.pageBuilderFieldCalculate(this.h(), script);
+        return this;
+    }
     /** Highlight the previous text with an RGB colour (channels 0-1). */
     highlight(r, g, b) {
         native.pageBuilderHighlight(this.h(), r, g, b);
@@ -384,6 +457,88 @@ export class PageBuilder {
         native.pageBuilderPushButton(this.h(), name, x, y, w, h, caption);
         return this;
     }
+    /** Add an unsigned signature placeholder field (/FT /Sig) at the given bounds. */
+    signatureField(name, x, y, w, h) {
+        native.pageBuilderSignatureField(this.h(), name, x, y, w, h);
+        return this;
+    }
+    /**
+     * Add a footnote: inline `refMark` emitted at the cursor position, and
+     * `noteText` placed near the page bottom with a separator artifact line.
+     */
+    footnote(refMark, noteText) {
+        native.pageBuilderFootnote(this.h(), refMark, noteText);
+        return this;
+    }
+    /**
+     * Lay out `text` as balanced multi-column flow.
+     * `columnCount` columns separated by `gapPt` points.
+     * Paragraphs in `text` are delimited by `"\n\n"`.
+     */
+    columns(columnCount, gapPt, text) {
+        native.pageBuilderColumns(this.h(), columnCount, gapPt, text);
+        return this;
+    }
+    /**
+     * Emit `text` inline at the current cursor position without advancing
+     * to a new line. The cursor advances horizontally so the next `inline`
+     * call follows on the same line.
+     */
+    inline(text) {
+        native.pageBuilderInline(this.h(), text);
+        return this;
+    }
+    /** Emit `text` inline in bold weight. */
+    inlineBold(text) {
+        native.pageBuilderInlineBold(this.h(), text);
+        return this;
+    }
+    /** Emit `text` inline in italic style. */
+    inlineItalic(text) {
+        native.pageBuilderInlineItalic(this.h(), text);
+        return this;
+    }
+    /** Emit `text` inline in an RGB colour (channels 0–1). */
+    inlineColor(r, g, b, text) {
+        native.pageBuilderInlineColor(this.h(), r, g, b, text);
+        return this;
+    }
+    /** Advance the cursor to the start of the next line. */
+    newline() {
+        native.pageBuilderNewline(this.h());
+        return this;
+    }
+    // --- Barcode / QR-code placement ------------------------------------
+    /**
+     * Place a 1-D barcode image on the page at `(x, y, w, h)`.
+     * `barcodeType`: 0=Code128 1=Code39 2=EAN13 3=EAN8 4=UPCA 5=ITF
+     * 6=Code93 7=Codabar.
+     */
+    barcode1d(barcodeType, data, x, y, w, h) {
+        native.pageBuilderBarcode1d(this.h(), barcodeType, data, x, y, w, h);
+        return this;
+    }
+    /** Place a QR-code image on the page (square: `size × size` pt). */
+    barcodeQr(data, x, y, size) {
+        native.pageBuilderBarcodeQr(this.h(), data, x, y, size);
+        return this;
+    }
+    /**
+     * Embed an image with an accessibility alt text (PDF/UA-1 §Figure).
+     * `bytes` must contain raw JPEG/PNG/WebP image data.
+     */
+    imageWithAlt(bytes, x, y, w, h, altText) {
+        native.pageBuilderImageWithAlt(this.h(), bytes, x, y, w, h, altText);
+        return this;
+    }
+    /**
+     * Embed a decorative image as an /Artifact (no alt text, PDF/UA-1 §Artifact).
+     * `bytes` must contain raw JPEG/PNG/WebP image data.
+     */
+    imageArtifact(bytes, x, y, w, h) {
+        native.pageBuilderImageArtifact(this.h(), bytes, x, y, w, h);
+        return this;
+    }
     // --- Low-level graphics primitives ---------------------------------
     /** Draw a stroked rectangle outline (1pt black). */
     rect(x, y, w, h) {
@@ -400,6 +555,136 @@ export class PageBuilder {
         native.pageBuilderLine(this.h(), x1, y1, x2, y2);
         return this;
     }
+    // --- v0.3.39 primitives (#393) -------------------------------------
+    /**
+     * Draw a stroked rectangle outline with caller-supplied width + RGB
+     * colour (channels 0–1). Underlies the Table surface.
+     */
+    strokeRect(x, y, w, h, style) {
+        const width = style?.width ?? 1;
+        const [r, g, b] = style?.color ?? [0, 0, 0];
+        native.pageBuilderStrokeRect(this.h(), x, y, w, h, width, r, g, b);
+        return this;
+    }
+    /**
+     * Draw a straight line with caller-supplied width + RGB colour.
+     */
+    strokeLine(x1, y1, x2, y2, style) {
+        const width = style?.width ?? 1;
+        const [r, g, b] = style?.color ?? [0, 0, 0];
+        native.pageBuilderStrokeLine(this.h(), x1, y1, x2, y2, width, r, g, b);
+        return this;
+    }
+    /**
+     * Place wrapped text inside the rectangle (x, y, w, h) with the
+     * given horizontal alignment. Uses the current font + size. Text
+     * that does not fit is clipped to the rectangle height.
+     */
+    textInRect(x, y, w, h, text, align = Align.Left) {
+        native.pageBuilderTextInRect(this.h(), x, y, w, h, text, align);
+        return this;
+    }
+    /**
+     * Start a new page with the *same* dimensions as the current one.
+     * Text config (font + size) carries over; the cursor resets to the
+     * top-left margin. Callers wanting header-repeat-on-break must
+     * re-emit the header explicitly.
+     */
+    newPageSameSize() {
+        native.pageBuilderNewPageSameSize(this.h());
+        return this;
+    }
+    /**
+     * Measure the width of `text` in the current font and size.
+     *
+     * Note: v0.3.39 ships a JS-side approximation (0.55em per glyph for
+     * ASCII / typical Latin-1 characters). A true per-glyph measurement
+     * FFI is pending. The result is in PDF points.
+     */
+    measure(text) {
+        // Retrieve current font size if the user tracked it via `font(...)`.
+        // We have no FFI query for the size; fall back to the 10pt default.
+        const size = this._lastFontSize ?? 10;
+        // ~0.55 em is a reasonable average for proportional fonts.
+        return text.length * size * 0.55;
+    }
+    /**
+     * Estimate the remaining vertical space on the page at the current
+     * cursor position. v0.3.39 returns `null` when the native cursor is
+     * unknown — callers should treat `null` as "unknown; assume fresh
+     * page". A real FFI hook is pending in a follow-up release.
+     */
+    remainingSpace() {
+        return null;
+    }
+    /**
+     * Emit a buffered table at the current cursor. All rows are
+     * marshalled into a single FFI call — memory scales with the row
+     * count. For million-row streams use {@link streamingTable}.
+     */
+    table(spec) {
+        const columns = spec.columns;
+        if (!columns || columns.length === 0) {
+            throw new Error('table spec must contain at least one column');
+        }
+        const widths = columns.map((c) => c.width);
+        const aligns = columns.map((c) => (c.align ?? Align.Left));
+        const hasHeader = spec.hasHeader !== false;
+        const rows = spec.rows ?? [];
+        const cells = [];
+        if (hasHeader) {
+            for (const c of columns)
+                cells.push(c.header);
+        }
+        const bodyRowCount = rows.length;
+        for (const row of rows) {
+            if (row.length !== columns.length) {
+                throw new Error(`row width ${row.length} does not match column count ${columns.length}`);
+            }
+            for (const cell of row)
+                cells.push(cell ?? null);
+        }
+        const totalRows = (hasHeader ? 1 : 0) + bodyRowCount;
+        native.pageBuilderTable(this.h(), widths, aligns, totalRows, cells, hasHeader);
+        return this;
+    }
+    /**
+     * Begin a streaming table. Uses the native row-at-a-time FFI
+     * (`pdf_page_builder_streaming_table_begin_v2`). Pass a `mode` in
+     * `config` to control column-sizing strategy (default: fixed widths).
+     */
+    streamingTable(config) {
+        return new StreamingTable(this, config);
+    }
+    /** @internal — open streaming table FFI handle on this page. */
+    _streamingTableBeginV2(headers, widths, aligns, repeatHeader, mode, maxRowspan) {
+        let modeInt = 0;
+        let sampleRows = 20;
+        let minW = 0;
+        let maxW = 9999;
+        if (mode?.kind === 'sample') {
+            modeInt = 1;
+            if (mode.sampleRows != null)
+                sampleRows = mode.sampleRows;
+            if (mode.minColWidthPt != null)
+                minW = mode.minColWidthPt;
+            if (mode.maxColWidthPt != null)
+                maxW = mode.maxColWidthPt;
+        }
+        native.pageBuilderStreamingTableBeginV2(this.h(), headers, widths, aligns, repeatHeader, modeInt, sampleRows, minW, maxW, maxRowspan);
+    }
+    /** @internal — push one row into the open streaming table (all rowspan=1). */
+    _streamingTablePushRow(cells) {
+        native.pageBuilderStreamingTablePushRow(this.h(), cells);
+    }
+    /** @internal — push one row with per-cell rowspan values. */
+    _streamingTablePushRowV2(cells) {
+        native.pageBuilderStreamingTablePushRowV2(this.h(), cells);
+    }
+    /** @internal — close the open streaming table. */
+    _streamingTableFinish() {
+        native.pageBuilderStreamingTableFinish(this.h());
+    }
     /**
      * Commit the page's buffered operations to the parent builder and
      * return the parent for chaining. After `done()` this PageBuilder is
@@ -432,3 +717,8 @@ export class PageBuilder {
         this.close();
     }
 }
+export { StreamingTable } from './streaming-table.js';
+// Re-export the v0.3.39 table surface so users can `import { Align,
+// StreamingTable } from 'pdf-oxide'` without reaching into ./types or
+// ./builders/streaming-table.
+export { Align, };

package/lib/builders/index.d.ts

@@ -10,3 +10,4 @@ export * from './document-builder';
 export * from './metadata-builder';
 export * from './pdf-builder';
 export * from './search-options-builder';
+export * from './streaming-table';

package/lib/builders/index.js

@@ -10,3 +10,4 @@ export * from './document-builder.js';
 export * from './metadata-builder.js';
 export * from './pdf-builder.js';
 export * from './search-options-builder.js';
+export * from './streaming-table.js';

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

@@ -156,6 +156,8 @@ export declare class PdfBuilder {
      * ```
      */
     fromText(text: string): any;
+    fromHtmlCss(html: string, css: string, fontBytes: Buffer | Uint8Array): any;
+    fromHtmlCssWithFonts(html: string, css: string, families: string[], fonts: (Buffer | Uint8Array)[]): any;
     /**
      * Asynchronously creates a PDF document from Markdown content
      * @param markdown - Markdown formatted content

package/lib/builders/pdf-builder.js

@@ -231,6 +231,18 @@ export class PdfBuilder {
         this._applyConfiguration(pdf);
         return pdf;
     }
+    fromHtmlCss(html, css, fontBytes) {
+        const { Pdf } = require('../index.js');
+        const pdf = Pdf.fromHtmlCss(html, css, fontBytes);
+        this._applyConfiguration(pdf);
+        return pdf;
+    }
+    fromHtmlCssWithFonts(html, css, families, fonts) {
+        const { Pdf } = require('../index.js');
+        const pdf = Pdf.fromHtmlCssWithFonts(html, css, families, fonts);
+        this._applyConfiguration(pdf);
+        return pdf;
+    }
     /**
      * Asynchronously creates a PDF document from Markdown content
      * @param markdown - Markdown formatted content

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

@@ -0,0 +1,49 @@
+/**
+ * Streaming-table adapter backed by the native row-at-a-time FFI
+ * (`pdf_page_builder_streaming_table_begin_v2` / `_push_row` / `_finish`).
+ *
+ * @example
+ * ```typescript
+ * const t = page.streamingTable({
+ *   columns: [
+ *     { header: 'SKU',  width: 72 },
+ *     { header: 'Item', width: 200 },
+ *     { header: 'Qty',  width: 48, align: Align.Right },
+ *   ],
+ *   repeatHeader: true,
+ *   mode: { kind: 'sample', sampleRows: 30 },
+ * });
+ * for await (const row of readRowsFromDb()) {
+ *   t.pushRow([row.sku, row.item, String(row.qty)]);
+ * }
+ * await t.finish();
+ * ```
+ */
+import type { SpanCell, StreamingTableConfig } from '../types/common.js';
+import type { PageBuilder } from './document-builder.js';
+export declare class StreamingTable {
+    private _page;
+    private _columns;
+    private _opened;
+    private _finished;
+    /** @internal — constructed via `PageBuilder.streamingTable(...)`. */
+    constructor(page: PageBuilder, config: StreamingTableConfig);
+    /** Push a single row (all rowspan=1). Throws if `cells.length !== columns.length`. */
+    pushRow(cells: Array<string | null | undefined>): this;
+    /**
+     * Push a single row with per-cell rowspan values. Each element is either
+     * a `SpanCell` (`{ text, rowspan }`) or a plain string (rowspan=1).
+     * Requires `maxRowspan ≥ 2` in the `StreamingTableConfig`.
+     */
+    pushRowSpan(cells: Array<SpanCell | string | null | undefined>): this;
+    /**
+     * Convenience: consume a sync or async iterable and push each row.
+     */
+    pushAll(rows: Iterable<Array<string | null | undefined>> | AsyncIterable<Array<string | null | undefined>>): Promise<this>;
+    /**
+     * Close the streaming table and return the parent PageBuilder for chaining.
+     */
+    finish(): Promise<PageBuilder>;
+    /** Number of the columns this table was opened with. */
+    get columnCount(): number;
+}

package/lib/builders/streaming-table.js

@@ -0,0 +1,110 @@
+/**
+ * Streaming-table adapter backed by the native row-at-a-time FFI
+ * (`pdf_page_builder_streaming_table_begin_v2` / `_push_row` / `_finish`).
+ *
+ * @example
+ * ```typescript
+ * const t = page.streamingTable({
+ *   columns: [
+ *     { header: 'SKU',  width: 72 },
+ *     { header: 'Item', width: 200 },
+ *     { header: 'Qty',  width: 48, align: Align.Right },
+ *   ],
+ *   repeatHeader: true,
+ *   mode: { kind: 'sample', sampleRows: 30 },
+ * });
+ * for await (const row of readRowsFromDb()) {
+ *   t.pushRow([row.sku, row.item, String(row.qty)]);
+ * }
+ * await t.finish();
+ * ```
+ */
+export class StreamingTable {
+    /** @internal — constructed via `PageBuilder.streamingTable(...)`. */
+    constructor(page, config) {
+        this._opened = false;
+        this._finished = false;
+        if (!config || !Array.isArray(config.columns) || config.columns.length === 0) {
+            throw new Error('StreamingTable requires at least one column');
+        }
+        this._page = page;
+        this._columns = config.columns;
+        const headers = config.columns.map((c) => c.header ?? '');
+        const widths = config.columns.map((c) => c.width);
+        const aligns = config.columns.map((c) => (c.align ?? 0));
+        const repeat = config.repeatHeader !== false;
+        const maxRowspan = config.maxRowspan != null && config.maxRowspan >= 2 ? config.maxRowspan : 1;
+        this._page._streamingTableBeginV2(headers, widths, aligns, repeat, config.mode, maxRowspan);
+        this._opened = true;
+    }
+    /** Push a single row (all rowspan=1). Throws if `cells.length !== columns.length`. */
+    pushRow(cells) {
+        if (this._finished) {
+            throw new Error('StreamingTable already finished');
+        }
+        if (cells.length !== this._columns.length) {
+            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))));
+        return this;
+    }
+    /**
+     * Push a single row with per-cell rowspan values. Each element is either
+     * a `SpanCell` (`{ text, rowspan }`) or a plain string (rowspan=1).
+     * Requires `maxRowspan ≥ 2` in the `StreamingTableConfig`.
+     */
+    pushRowSpan(cells) {
+        if (this._finished) {
+            throw new Error('StreamingTable already finished');
+        }
+        if (cells.length !== this._columns.length) {
+            throw new Error(`row width ${cells.length} does not match column count ${this._columns.length}`);
+        }
+        const normalized = cells.map((c) => {
+            if (c == null)
+                return [null, 1];
+            if (typeof c === 'string')
+                return [c, 1];
+            return [c.text, c.rowspan];
+        });
+        this._page._streamingTablePushRowV2(normalized);
+        return this;
+    }
+    /**
+     * Convenience: consume a sync or async iterable and push each row.
+     */
+    async pushAll(rows) {
+        if (this._finished) {
+            throw new Error('StreamingTable already finished');
+        }
+        const anyRows = rows;
+        if (typeof anyRows[Symbol.asyncIterator] === 'function') {
+            for await (const row of rows) {
+                this.pushRow(row);
+            }
+        }
+        else {
+            for (const row of rows) {
+                this.pushRow(row);
+            }
+        }
+        return this;
+    }
+    /**
+     * Close the streaming table and return the parent PageBuilder for chaining.
+     */
+    async finish() {
+        if (this._finished) {
+            throw new Error('StreamingTable already finished');
+        }
+        this._finished = true;
+        if (this._opened) {
+            this._page._streamingTableFinish();
+        }
+        return this._page;
+    }
+    /** Number of the columns this table was opened with. */
+    get columnCount() {
+        return this._columns.length;
+    }
+}

package/lib/document-editor.d.ts

@@ -14,6 +14,8 @@ export declare class DocumentEditor {
     private constructor();
     /** Open a PDF file for editing. */
     static open(path: string): DocumentEditor;
+    /** Open a PDF from an in-memory buffer for editing. */
+    static openFromBytes(data: Buffer | Uint8Array): DocumentEditor;
     /** True if the editor has been closed. Subsequent calls will throw. */
     get closed(): boolean;
     private _throwIfClosed;
@@ -23,6 +25,9 @@ export declare class DocumentEditor {
     isModified(): boolean;
     setTitle(title: string): void;
     setAuthor(author: string): void;
+    setSubject(subject: string): void;
+    getKeywords(): string | null;
+    setKeywords(keywords: string): void;
     getProducer(): string;
     setProducer(producer: string): void;
     getCreationDate(): string;
@@ -39,6 +44,12 @@ export declare class DocumentEditor {
     mergeFrom(sourcePath: string): void;
     /** Flatten form fields across the entire document. */
     flattenForms(): void;
+    /**
+     * Return warnings collected during the last form-flattening save.
+     * Each entry names a widget field that had no `/AP` appearance stream;
+     * flattening it produces a blank rectangle.
+     */
+    flattenWarnings(): string[];
     /** Flatten annotations. If `pageIndex` is omitted, flattens all pages. */
     flattenAnnotations(pageIndex?: number): void;
     /** Set a form field value by fully-qualified field name. */
@@ -47,10 +58,64 @@ export declare class DocumentEditor {
     importFdfBytes(fdf: Buffer | Uint8Array): void;
     /** Import an XFDF file (bytes) into the document's form. */
     importXfdfBytes(xfdf: Buffer | Uint8Array): void;
+    /**
+     * Append every page of another PDF (supplied as bytes) to this document.
+     * Returns the number of pages added.
+     */
+    mergeFromBytes(data: Buffer | Uint8Array): number;
+    /** Embed a file attachment into the document. */
+    embedFile(name: string, data: Buffer | Uint8Array): void;
+    /** Burn in redaction annotations on a single page (zero-based). */
+    applyPageRedactions(pageIndex: number): void;
+    /** Burn in all pending redaction annotations across the document. */
+    applyAllRedactions(): void;
+    /** Rotate all pages by `degrees` (additive). */
+    rotateAllPages(degrees: number): void;
+    /** Rotate a single page by `degrees` (additive). */
+    rotatePageBy(pageIndex: number, degrees: number): void;
+    /** Get the MediaBox of a page as `{x, y, width, height}`. */
+    getPageMediaBox(pageIndex: number): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Set the MediaBox of a page. */
+    setPageMediaBox(pageIndex: number, x: number, y: number, width: number, height: number): void;
+    /** Get the CropBox of a page. Returns `{x:0,y:0,width:0,height:0}` if none set. */
+    getPageCropBox(pageIndex: number): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Set the CropBox of a page. */
+    setPageCropBox(pageIndex: number, x: number, y: number, width: number, height: number): void;
+    /**
+     * Erase rectangular regions on a page.
+     * `rects` is an array of `[x, y, w, h]` tuples.
+     */
+    eraseRegions(pageIndex: number, rects: [number, number, number, number][]): void;
+    /** Clear all pending erase-region entries for a page. */
+    clearEraseRegions(pageIndex: number): void;
+    /** Flatten form fields on a single page. */
+    flattenFormsOnPage(pageIndex: number): void;
+    /** True if the page is marked for annotation-flatten. */
+    isPageMarkedForFlatten(pageIndex: number): boolean;
+    /** Remove the flatten mark from a page. */
+    unmarkPageForFlatten(pageIndex: number): void;
+    /** True if the page is marked for redaction. */
+    isPageMarkedForRedaction(pageIndex: number): boolean;
+    /** Remove the redaction mark from a page. */
+    unmarkPageForRedaction(pageIndex: number): void;
     /** Save the document to `path`. */
     save(path: string): void;
     /** Save with AES-256 encryption (user + owner passwords). */
     saveEncrypted(path: string, userPassword: string, ownerPassword: string): void;
+    /** Save the document to an in-memory Buffer. */
+    saveToBytes(): Buffer;
+    /** Save to an in-memory Buffer with explicit compression / GC / linearize flags. */
+    saveToBytesWithOptions(compress: boolean, garbageCollect: boolean, linearize: boolean): Buffer;
     /** Release the native handle. Safe to call multiple times. */
     close(): void;
 }

package/lib/document-editor.js

@@ -48,6 +48,14 @@ export class DocumentEditor {
         const handle = native.editorOpen(path);
         return new DocumentEditor(handle);
     }
+    /** Open a PDF from an in-memory buffer for editing. */
+    static openFromBytes(data) {
+        if (!data || data.length === 0) {
+            throw new TypeError('data must be a non-empty Buffer or Uint8Array');
+        }
+        const handle = native.editorOpenFromBytes(data);
+        return new DocumentEditor(handle);
+    }
     /** True if the editor has been closed. Subsequent calls will throw. */
     get closed() {
         return this._closed;
@@ -75,18 +83,25 @@ export class DocumentEditor {
         this._throwIfClosed();
         native.editorSetAuthor(this._handle, author);
     }
+    setSubject(subject) {
+        this._throwIfClosed();
+        native.editorSetSubject(this._handle, subject);
+    }
+    getKeywords() {
+        this._throwIfClosed();
+        return native.editorGetKeywords(this._handle);
+    }
+    setKeywords(keywords) {
+        this._throwIfClosed();
+        native.editorSetKeywords(this._handle, keywords);
+    }
     getProducer() {
         this._throwIfClosed();
         return native.editorGetProducer(this._handle);
     }
     setProducer(producer) {
         this._throwIfClosed();
-        // NOTE: today this is a no-op in Rust core (src/ffi.rs:532-586).
-        // The wrapper is in place so the API surface matches
-        // Python / C# / Go.
-        if (native.editorSetProducer) {
-            native.editorSetProducer(this._handle, producer);
-        }
+        native.editorSetProducer(this._handle, producer);
     }
     getCreationDate() {
         this._throwIfClosed();
@@ -94,10 +109,7 @@ export class DocumentEditor {
     }
     setCreationDate(date) {
         this._throwIfClosed();
-        // Same Rust-core stub note as setProducer.
-        if (native.editorSetCreationDate) {
-            native.editorSetCreationDate(this._handle, date);
-        }
+        native.editorSetCreationDate(this._handle, date);
     }
     // ----- page mutations ---------------------------------------------
     /** Delete the page at `pageIndex` (zero-based). */
@@ -131,6 +143,15 @@ export class DocumentEditor {
         this._throwIfClosed();
         native.editorFlattenForms(this._handle);
     }
+    /**
+     * Return warnings collected during the last form-flattening save.
+     * Each entry names a widget field that had no `/AP` appearance stream;
+     * flattening it produces a blank rectangle.
+     */
+    flattenWarnings() {
+        this._throwIfClosed();
+        return native.editorFlattenWarnings(this._handle);
+    }
     /** Flatten annotations. If `pageIndex` is omitted, flattens all pages. */
     flattenAnnotations(pageIndex) {
         this._throwIfClosed();
@@ -156,6 +177,104 @@ export class DocumentEditor {
         this._throwIfClosed();
         native.editorImportXfdfBytes(this._handle, xfdf);
     }
+    // ----- byte-level merge / embed -----------------------------------
+    /**
+     * Append every page of another PDF (supplied as bytes) to this document.
+     * Returns the number of pages added.
+     */
+    mergeFromBytes(data) {
+        this._throwIfClosed();
+        return native.editorMergeFromBytes(this._handle, data);
+    }
+    /** Embed a file attachment into the document. */
+    embedFile(name, data) {
+        this._throwIfClosed();
+        native.editorEmbedFile(this._handle, name, data);
+    }
+    // ----- redactions -------------------------------------------------
+    /** Burn in redaction annotations on a single page (zero-based). */
+    applyPageRedactions(pageIndex) {
+        this._throwIfClosed();
+        native.editorApplyPageRedactions(this._handle, pageIndex);
+    }
+    /** Burn in all pending redaction annotations across the document. */
+    applyAllRedactions() {
+        this._throwIfClosed();
+        native.editorApplyAllRedactions(this._handle);
+    }
+    // ----- rotation (additive) ----------------------------------------
+    /** Rotate all pages by `degrees` (additive). */
+    rotateAllPages(degrees) {
+        this._throwIfClosed();
+        native.editorRotateAllPages(this._handle, degrees);
+    }
+    /** Rotate a single page by `degrees` (additive). */
+    rotatePageBy(pageIndex, degrees) {
+        this._throwIfClosed();
+        native.editorRotatePageBy(this._handle, pageIndex, degrees);
+    }
+    // ----- page boxes -------------------------------------------------
+    /** Get the MediaBox of a page as `{x, y, width, height}`. */
+    getPageMediaBox(pageIndex) {
+        this._throwIfClosed();
+        return native.editorGetPageMediaBox(this._handle, pageIndex);
+    }
+    /** Set the MediaBox of a page. */
+    setPageMediaBox(pageIndex, x, y, width, height) {
+        this._throwIfClosed();
+        native.editorSetPageMediaBox(this._handle, pageIndex, x, y, width, height);
+    }
+    /** Get the CropBox of a page. Returns `{x:0,y:0,width:0,height:0}` if none set. */
+    getPageCropBox(pageIndex) {
+        this._throwIfClosed();
+        return native.editorGetPageCropBox(this._handle, pageIndex);
+    }
+    /** Set the CropBox of a page. */
+    setPageCropBox(pageIndex, x, y, width, height) {
+        this._throwIfClosed();
+        native.editorSetPageCropBox(this._handle, pageIndex, x, y, width, height);
+    }
+    // ----- erase regions ----------------------------------------------
+    /**
+     * Erase rectangular regions on a page.
+     * `rects` is an array of `[x, y, w, h]` tuples.
+     */
+    eraseRegions(pageIndex, rects) {
+        this._throwIfClosed();
+        native.editorEraseRegions(this._handle, pageIndex, rects);
+    }
+    /** Clear all pending erase-region entries for a page. */
+    clearEraseRegions(pageIndex) {
+        this._throwIfClosed();
+        native.editorClearEraseRegions(this._handle, pageIndex);
+    }
+    // ----- form flattening on single page ------------------------------
+    /** Flatten form fields on a single page. */
+    flattenFormsOnPage(pageIndex) {
+        this._throwIfClosed();
+        native.editorFlattenFormsOnPage(this._handle, pageIndex);
+    }
+    // ----- page-mark state queries ------------------------------------
+    /** True if the page is marked for annotation-flatten. */
+    isPageMarkedForFlatten(pageIndex) {
+        this._throwIfClosed();
+        return native.editorIsPageMarkedForFlatten(this._handle, pageIndex);
+    }
+    /** Remove the flatten mark from a page. */
+    unmarkPageForFlatten(pageIndex) {
+        this._throwIfClosed();
+        native.editorUnmarkPageForFlatten(this._handle, pageIndex);
+    }
+    /** True if the page is marked for redaction. */
+    isPageMarkedForRedaction(pageIndex) {
+        this._throwIfClosed();
+        return native.editorIsPageMarkedForRedaction(this._handle, pageIndex);
+    }
+    /** Remove the redaction mark from a page. */
+    unmarkPageForRedaction(pageIndex) {
+        this._throwIfClosed();
+        native.editorUnmarkPageForRedaction(this._handle, pageIndex);
+    }
     // ----- save paths -------------------------------------------------
     /** Save the document to `path`. */
     save(path) {
@@ -170,6 +289,16 @@ export class DocumentEditor {
         this._throwIfClosed();
         native.editorSaveEncrypted(this._handle, path, userPassword, ownerPassword);
     }
+    /** Save the document to an in-memory Buffer. */
+    saveToBytes() {
+        this._throwIfClosed();
+        return native.editorSaveToBytes(this._handle);
+    }
+    /** Save to an in-memory Buffer with explicit compression / GC / linearize flags. */
+    saveToBytesWithOptions(compress, garbageCollect, linearize) {
+        this._throwIfClosed();
+        return native.editorSaveToBytesWithOptions(this._handle, compress, garbageCollect, linearize);
+    }
     // ----- lifecycle --------------------------------------------------
     /** Release the native handle. Safe to call multiple times. */
     close() {

package/lib/index.d.ts

@@ -1,8 +1,8 @@
-import { AnnotationBuilder, ConversionOptionsBuilder, DocumentBuilder, EmbeddedFont, MetadataBuilder, PageBuilder, PdfBuilder, SearchOptionsBuilder } from './builders/index';
+import { Align, AnnotationBuilder, ConversionOptionsBuilder, DocumentBuilder, EmbeddedFont, MetadataBuilder, PageBuilder, PdfBuilder, SearchOptionsBuilder, StreamingTable } from './builders/index';
 import { DocumentEditor } from './document-editor';
 import { AccessibilityException, CertificateLoadFailed, ComplianceException, EncryptionException, ErrorCategory, ErrorSeverity, InvalidStateException, IoException, mapFfiErrorCode, OcrException, OptimizationException, ParseException, PdfException, RedactionException, RenderingException, SearchException, SignatureException, SigningFailed, UnknownError, UnsupportedFeatureException, ValidationException, wrapAsyncMethod, wrapError, wrapMethod } from './errors';
 import { AnnotationManager, type BatchDocument, BatchManager, type BatchOptions, type BatchProgress, type BatchResult, type BatchStatistics, createExtractionStream, createMetadataStream, createSearchStream, ExtractionManager, ExtractionStream, LayerManager, MetadataManager, MetadataStream, OutlineManager, RenderingManager, SearchManager, SearchStream, SecurityManager } from './managers/index';
-import type { Table } from './types/common.js';
+import type { Column, SpanCell, StreamingTableConfig, Table, TableMode, TableSpec } from './types/common.js';
 import type { WorkerResult, WorkerTask } from './workers/index';
 import { WorkerPool, workerPool } from './workers/index';
 declare const OcrManager: any, OCRManager: any, OCRDetectionMode: any, ComplianceManager: any, PdfALevel: any, PdfXLevel: any, PdfUALevel: any, ComplianceIssueType: any, IssueSeverity: any, SignatureManager: any, SignatureAlgorithm: any, DigestAlgorithm: any, BarcodeManager: any, BarcodeFormat: any, BarcodeErrorCorrection: any, FormFieldManager: any, FormFieldType: any, FieldVisibility: any, ResultAccessorsManager: any, SearchResultProperties: any, FontProperties: any, ImageProperties: any, AnnotationProperties: any, ThumbnailManager: any, ThumbnailSize: any, ImageFormat: any, HybridMLManager: any, PageComplexity: any, ContentType: any, XfaManager: any, XfaFormType: any, XfaFieldType: any, CacheManager: any, EditingManager: any, AccessibilityManager: any, OptimizationManager: any, EnterpriseManager: any;
@@ -122,5 +122,5 @@ declare const SearchResult: any;
 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, Table, WorkerResult, WorkerTask, };
-export { AccessibilityException, AccessibilityManager, 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, TextSearcher, ThumbnailManager, ThumbnailSize, UnknownError, UnsupportedFeatureException, ValidationException, WorkerPool, workerPool, wrapAsyncMethod, wrapError, wrapMethod, XfaFieldType, XfaFormType, XfaManager, };
+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, };

package/lib/index.js

@@ -3,7 +3,7 @@ import { createRequire } from 'node:module';
 import { dirname } from 'node:path';
 import { arch, platform } from 'node:process';
 import { fileURLToPath } from 'node:url';
-import { AnnotationBuilder, ConversionOptionsBuilder, DocumentBuilder, EmbeddedFont, MetadataBuilder, PageBuilder, PdfBuilder, SearchOptionsBuilder, } from './builders/index.js';
+import { Align, AnnotationBuilder, ConversionOptionsBuilder, DocumentBuilder, EmbeddedFont, MetadataBuilder, PageBuilder, PdfBuilder, SearchOptionsBuilder, StreamingTable, } from './builders/index.js';
 import { DocumentEditor } from './document-editor.js';
 import { AccessibilityException, CertificateLoadFailed, ComplianceException, EncryptionException, ErrorCategory, ErrorSeverity, InvalidStateException, IoException, mapFfiErrorCode, OcrException, OptimizationException, ParseException, PdfException, RedactionException, RenderingException, SearchException, SignatureException, SigningFailed, UnknownError, UnsupportedFeatureException, ValidationException, wrapAsyncMethod, wrapError, wrapMethod, } from './errors.js';
 import { AnnotationManager, BatchManager, createExtractionStream, createMetadataStream, createSearchStream, ExtractionManager, ExtractionStream, LayerManager, MetadataManager, MetadataStream, OutlineManager, RenderingManager, SearchManager, SearchStream, SecurityManager, } from './managers/index.js';
@@ -429,6 +429,15 @@ class PdfImpl {
     static fromImageBytes(data) {
         return new PdfImpl(native.pdfFromImageBytes(data));
     }
+    static fromHtmlCss(html, css, fontBytes) {
+        return new PdfImpl(native.pdfFromHtmlCss(html, css, fontBytes));
+    }
+    static fromHtmlCssWithFonts(html, css, families, fonts) {
+        if (families.length !== fonts.length) {
+            throw new Error(`fromHtmlCssWithFonts: families.length (${families.length}) must equal fonts.length (${fonts.length})`);
+        }
+        return new PdfImpl(native.pdfFromHtmlCssWithFonts(html, css, families, fonts));
+    }
     ensureOpen() {
         if (this._closed)
             throw new Error('PDF handle is closed');
@@ -473,7 +482,9 @@ const TextSearcher = native.TextSearcher;
 // their own modules so downstream users get the full API surface.
 export { Timestamp, TimestampHashAlgorithm } from './timestamp.js';
 export { TsaClient } from './tsa-client.js';
-export { AccessibilityException, AccessibilityManager, AnnotationBuilder, AnnotationManager, AnnotationProperties, BarcodeErrorCorrection, BarcodeFormat, BarcodeManager, 
+export { AccessibilityException, AccessibilityManager, 
+// v0.3.39 — DocumentBuilder tables (#393)
+Align, AnnotationBuilder, AnnotationManager, AnnotationProperties, BarcodeErrorCorrection, BarcodeFormat, BarcodeManager, 
 // Phase 2.5: Batch Processing API
 BatchManager, CacheManager, CertificateLoadFailed, Color, ComplianceException, ComplianceIssueType, ComplianceManager, ContentType, ConversionOptions, ConversionOptionsBuilder, createExtractionStream, createMetadataStream, createSearchStream, DigestAlgorithm, 
 // Write-side fluent API
@@ -498,6 +509,8 @@ PdfDocument,
 PdfError, PdfException, PdfUALevel, PdfXLevel, Point, Rect, RedactionException, RenderingException, RenderingManager, ResultAccessorsManager, SearchException, SearchManager, SearchOptions, SearchOptionsBuilder, SearchResult, SearchResultProperties, 
 // Phase 2.4: Stream API
 SearchStream, SecurityManager, SignatureAlgorithm, SignatureException, SignatureManager, SigningFailed, 
+// v0.3.39 — managed streaming-table adapter (#393)
+StreamingTable, 
 // Utilities
 TextSearcher, ThumbnailManager, ThumbnailSize, UnknownError, UnsupportedFeatureException, ValidationException, 
 // Worker Threads API

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

@@ -718,6 +718,20 @@ export declare class SignatureManager extends EventEmitter {
     clearCache(): void;
     getCacheStats(): Record<string, any>;
     destroy(): void;
+    /**
+     * Sign a PDF from raw bytes using PEM credentials.
+     *
+     * Calls the native `signPdfBytes` FFI function (two-pass ByteRange writer).
+     * Credentials are loaded and freed within this call.
+     *
+     * @param pdfData - Buffer containing the PDF document bytes
+     * @param certPem - PEM-encoded certificate string
+     * @param keyPem  - PEM-encoded private key string
+     * @param reason  - Optional signature reason
+     * @param location - Optional signature location
+     * @returns Buffer containing the signed PDF
+     */
+    signPdfData(pdfData: Buffer, certPem: string, keyPem: string, reason?: string, location?: string): Promise<Buffer>;
     private setCached;
     private clearCachePattern;
 }

package/lib/managers/signature-manager.js

@@ -1454,6 +1454,42 @@ export class SignatureManager extends EventEmitter {
         this.resultCache.clear();
         this.removeAllListeners();
     }
+    /**
+     * Sign a PDF from raw bytes using PEM credentials.
+     *
+     * Calls the native `signPdfBytes` FFI function (two-pass ByteRange writer).
+     * Credentials are loaded and freed within this call.
+     *
+     * @param pdfData - Buffer containing the PDF document bytes
+     * @param certPem - PEM-encoded certificate string
+     * @param keyPem  - PEM-encoded private key string
+     * @param reason  - Optional signature reason
+     * @param location - Optional signature location
+     * @returns Buffer containing the signed PDF
+     */
+    async signPdfData(pdfData, certPem, keyPem, reason, location) {
+        if (!this.native?.certificateLoadFromPem) {
+            throw new SignatureException('Native signing not available: certificateLoadFromPem not found');
+        }
+        if (!this.native?.signPdfBytes) {
+            throw new SignatureException('Native signing not available: signPdfBytes not found');
+        }
+        const certHandle = this.native.certificateLoadFromPem(certPem, keyPem);
+        if (!certHandle) {
+            throw new SignatureException('Failed to load PEM certificate');
+        }
+        try {
+            const result = this.native.signPdfBytes(pdfData, certHandle, reason ?? null, location ?? null);
+            if (!result)
+                throw new SignatureException('signPdfBytes returned null');
+            return Buffer.from(result);
+        }
+        finally {
+            if (this.native?.pdf_certificate_free) {
+                this.native.pdf_certificate_free(certHandle);
+            }
+        }
+    }
     // Private helpers
     setCached(key, value) {
         this.resultCache.set(key, value);

package/lib/types/common.d.ts

@@ -103,3 +103,82 @@ export type StreamErrorCallback = (error: Error) => void;
  * Stream end callback
  */
 export type StreamEndCallback = () => void;
+/**
+ * Horizontal alignment for wrapped text and table cells.
+ * Matches the C FFI integer encoding used by
+ * `pdf_page_builder_text_in_rect` and `pdf_page_builder_table`.
+ */
+export declare enum Align {
+    Left = 0,
+    Center = 1,
+    Right = 2
+}
+/**
+ * Column descriptor for {@link TableSpec} / {@link StreamingTableConfig}.
+ */
+export interface Column {
+    /** Header label rendered in bold (used only when `hasHeader`/`repeatHeader`). */
+    header: string;
+    /** Column width in PDF points. */
+    width: number;
+    /** Cell alignment (default {@link Align.Left}). */
+    align?: Align;
+}
+/**
+ * Buffered-table spec passed to `PageBuilder.table(...)`.
+ *
+ * All rows are held in JS memory and flushed to the native
+ * `pdf_page_builder_table` call in a single step.
+ */
+export interface TableSpec {
+    /** Column layout — widths, alignments, and header labels. */
+    columns: Column[];
+    /** Body rows, each row has `columns.length` cells (nullable = empty). */
+    rows: Array<Array<string | null | undefined>>;
+    /** Promote the column headers to a styled first row. Defaults to true. */
+    hasHeader?: boolean;
+}
+/**
+ * Column-sizing strategy for streaming tables (issue #400).
+ *
+ * - `fixed` — use the `width` from each `Column` as-is (default).
+ * - `sample` — buffer the first N rows, measure content, then freeze
+ *   column widths automatically.  Supply `sampleRows`, `minColWidth`,
+ *   and `maxColWidth` to tune.
+ */
+export type TableMode = {
+    kind: 'fixed';
+} | {
+    kind: 'sample';
+    sampleRows?: number;
+    minColWidthPt?: number;
+    maxColWidthPt?: number;
+};
+/**
+ * Configuration for the managed streaming-table adapter.
+ */
+export interface StreamingTableConfig {
+    /** Column layout — widths, alignments, and header labels. */
+    columns: Column[];
+    /**
+     * Whether to repeat the header row on every page break. Defaults to true.
+     */
+    repeatHeader?: boolean;
+    /**
+     * Column-sizing mode. Defaults to `{ kind: 'fixed' }`.
+     */
+    mode?: TableMode;
+    /**
+     * Maximum rowspan a cell may carry.  0 or 1 (default) disables rowspan.
+     * Set to ≥2 to allow `pushRowSpan` cells to span multiple rows.
+     */
+    maxRowspan?: number;
+}
+/**
+ * A single cell value for `StreamingTable.pushRowSpan`.
+ * `rowspan == 1` is equivalent to a normal cell.
+ */
+export interface SpanCell {
+    text: string;
+    rowspan: number;
+}

package/lib/types/common.js

@@ -1,4 +1,17 @@
 /**
  * Common type definitions and utilities
  */
-export {};
+// ============================================================================
+// DocumentBuilder — table primitives (v0.3.39, issue #393)
+// ============================================================================
+/**
+ * Horizontal alignment for wrapped text and table cells.
+ * Matches the C FFI integer encoding used by
+ * `pdf_page_builder_text_in_rect` and `pdf_page_builder_table`.
+ */
+export var Align;
+(function (Align) {
+    Align[Align["Left"] = 0] = "Left";
+    Align[Align["Center"] = 1] = "Center";
+    Align[Align["Right"] = 2] = "Right";
+})(Align || (Align = {}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pdf-oxide",
-  "version": "0.3.38",
+  "version": "0.3.39",
   "type": "module",
   "description": "High-performance PDF parsing and text extraction library — prebuilt native bindings, no build toolchain required",
   "main": "lib/index.js",
@@ -20,7 +20,7 @@
     "check:publint": "publint",
     "check:types": "attw --pack . --ignore-rules=cjs-resolves-to-esm",
     "audit:prod": "npm audit --omit=dev --audit-level=high",
-    "test": "node --test tests/smoke.test.mjs"
+    "test": "node --test tests/smoke.test.mjs tests/feature-guard.test.mjs tests/api-coverage.test.mjs tests/html-css.test.mjs tests/document-builder.test.mjs tests/document-editor.test.mjs tests/render-options.test.mjs tests/tables.test.mjs"
   },
   "files": [
     "lib/",