pdfnative 1.0.4 → 1.1.0

package/dist/index.d.cts

@@ -149,6 +149,20 @@ interface ColumnDef {
     readonly mx: number;
     /** Max characters for header cells. */
     readonly mxH: number;
+    /**
+     * Minimum column width in points. When set, the resolved width is
+     * clamped to at least this value, redistributing the surplus across
+     * the remaining unconstrained columns (proportional to their `f`).
+     * @since 1.1.0
+     */
+    readonly minWidth?: number;
+    /**
+     * Maximum column width in points. When set, the resolved width is
+     * clamped to at most this value, redistributing the surplus across
+     * the remaining unconstrained columns (proportional to their `f`).
+     * @since 1.1.0
+     */
+    readonly maxWidth?: number;
 }
 /**
  * Options for generating a PDF in a Web Worker via `generatePDFInWorker()`.
@@ -383,6 +397,15 @@ interface WatermarkText {
     readonly opacity?: number;
     /** Rotation angle in degrees (counterclockwise). Default: -45. */
     readonly angle?: number;
+    /**
+     * Auto-fit: clamp `fontSize` so the rotated bounding box fits within the
+     * page minus a 24-pt safety margin. Default: `true` (added in v1.1.0).
+     *
+     * Set to `false` to preserve byte-stable output when callers depend on
+     * the exact `fontSize` even if it produces a watermark that overflows
+     * the page (legacy v1.0.x behaviour).
+     */
+    readonly autoFit?: boolean;
 }
 /**
  * Image watermark configuration.
@@ -752,6 +775,31 @@ interface TableBlock {
     readonly headers: readonly string[];
     readonly rows: readonly PdfRow[];
     readonly columns?: readonly ColumnDef[];
+    /**
+     * Clip cell contents to column bounds using PDF clip-path operators.
+     * When `true`, each header/data cell is wrapped in `q <rect> re W n ... Q` so
+     * over-long text cannot escape the column rectangle visually.
+     *
+     * When `false`, cells rely solely on the existing `truncate()` character cap
+     * (ColumnDef.mx / mxH) — variable-width glyphs may still overflow visually.
+     *
+     * Default: `true` (recommended for PDF/A and visual safety).
+     * @since 1.1.0
+     */
+    readonly clipCells?: boolean;
+    /**
+     * Auto-fit column widths to actual content widths, respecting per-column
+     * `minWidth` / `maxWidth` constraints. Surplus or deficit is redistributed
+     * across unconstrained columns proportional to their `f` fraction.
+     *
+     * When `false` (default), the explicit `f` fractions are used as-is.
+     *
+     * Note: byte-output is non-deterministic vs explicit widths because resolved
+     * widths depend on text content and font metrics. Use only when content-aware
+     * sizing is desired.
+     * @since 1.1.0
+     */
+    readonly autoFitColumns?: boolean;
 }
 /** List block — bullet or numbered items. */
 interface ListBlock {
@@ -1856,6 +1904,14 @@ declare const DEFAULT_COLORS: PdfColors;
 declare const DEFAULT_COLUMNS: ColumnDef[];
 /**
  * Compute column X positions and widths given columns and content width.
+ *
+ * Honours optional `minWidth` / `maxWidth` constraints (in points) by clamping
+ * each constrained column then redistributing the surplus or deficit across
+ * the unconstrained columns proportional to their fractional weight `f`.
+ * Falls back to a single uniform proration pass when all columns are
+ * constrained or the unconstrained weights sum to zero.
+ *
+ * @since 1.1.0 — added support for `minWidth` / `maxWidth` (additive).
  */
 declare function computeColumnPositions(columns: readonly ColumnDef[], marginLeft: number, contentWidth: number): {
     cx: number[];
@@ -1922,8 +1978,28 @@ declare function toWinAnsi(str: string): string;
  * Create a PDF string literal: encode to WinAnsi and escape (, ), \.
  */
 declare function pdfString(str: string): string;
-/** Truncate string to max characters, appending '..' if needed. */
+/**
+ * Truncate string to max characters, appending Unicode ellipsis (…, U+2026) if needed.
+ *
+ * The horizontal ellipsis is rendered correctly in both Latin/WinAnsi mode
+ * (mapped to byte 0x85) and Unicode/CIDFont mode. This produces typographically
+ * correct output and is ~50% narrower than ASCII "..." while remaining a single
+ * grapheme cluster.
+ *
+ * @since 1.1.0 — the ellipsis character changed from `'..'` (two ASCII dots)
+ *   to `'…'` (U+2026). Output is one character shorter for the same `max`.
+ */
 declare function truncate(str: string, max: number): string;
+/**
+ * Truncate string so that its rendered width does not exceed `maxWidthPt`,
+ * appending the Unicode ellipsis (…, U+2026) when truncation occurs.
+ *
+ * Unlike {@link truncate}, this measures actual glyph width using the encoding
+ * context — appropriate for proportional fonts and Unicode text.
+ *
+ * @since 1.1.0
+ */
+declare function truncateToWidth(str: string, maxWidthPt: number, sz: number, enc: EncodingContext): string;
 /**
  * Approximate text width in points using Helvetica character metrics.
  */
@@ -1945,8 +2021,13 @@ declare function helveticaWidth(str: string, sz: number): number;
  * Latin mode uses WinAnsi/Helvetica, Unicode mode uses CIDFont/Identity-H.
  *
  * @param fontEntries - Array of font entries (primary first). Empty = Latin mode.
+ * @param pdfA - When true and at least one font entry is registered, disables
+ *   WinAnsi/Helvetica fallback in mixed-content runs (Helvetica is unembedded
+ *   standard-14, forbidden by ISO 19005). When pdfA is true with no fontEntries,
+ *   Latin mode is used as before — strict PDF/A conformance requires the caller
+ *   to register a Latin font (e.g. Noto Sans VF).
  */
-declare function createEncodingContext(fontEntries: FontEntry[]): EncodingContext;
+declare function createEncodingContext(fontEntries: FontEntry[], pdfA?: boolean): EncodingContext;
 
 /**
  * pdfnative — Font Loader
@@ -2173,7 +2254,7 @@ declare function detectFallbackLangs(texts: string[], primaryLang: string): Set<
  * Returns the language code of the font most appropriate for rendering.
  *
  * @param cp - Unicode codepoint
- * @returns Language code ('el', 'hi', 'th', 'ja', 'ko', 'zh', 'vi', 'pl', 'tr', 'he', 'ar', 'ru', 'ka', 'hy') or null for Latin/common
+ * @returns Language code ('el', 'hi', 'th', 'ja', 'ko', 'zh', 'vi', 'pl', 'tr', 'he', 'ar', 'ru', 'ka', 'hy', 'emoji') or null for Latin/common
  */
 declare function detectCharLang(cp: number): string | null;
 
@@ -2208,6 +2289,11 @@ interface BidiRun {
 /**
  * Resolve bidirectional text into ordered runs with embedding levels.
  *
+ * Implements UAX #9 with isolate support (LRI/RLI/FSI ... PDI). When the
+ * input contains matched isolate pairs, the inner content is resolved as
+ * a sealed sub-paragraph with its own forced or auto-detected direction,
+ * preventing the outer context from leaking into it (and vice versa).
+ *
  * @param text - Input text in logical order
  * @returns Array of BidiRun objects in visual order
  */
@@ -2595,6 +2681,62 @@ declare function initNodeDecompression(): Promise<void>;
  */
 declare function inflateSync(data: Uint8Array): Uint8Array;
 
+/**
+ * pdfnative — PDF Stream Filter Decoders
+ * ========================================
+ * Pure, zero-dependency decoders for the standard PDF stream filters that
+ * are not handled by {@link inflateSync} (FlateDecode).
+ *
+ * Implemented filters (ISO 32000-1 §7.4):
+ *   - ASCIIHexDecode  (§7.4.2)
+ *   - ASCII85Decode   (§7.4.3)
+ *   - LZWDecode       (§7.4.4)  — variable-width 9..12 bit codes
+ *   - RunLengthDecode (§7.4.5)
+ *
+ * @since 1.1.0
+ */
+/**
+ * Decode an ASCIIHexDecode stream. Two hex digits encode one byte.
+ * Whitespace is ignored; `>` terminates the stream. An odd trailing digit
+ * is treated as if followed by `0` (per ISO 32000-1 §7.4.2).
+ */
+declare function decodeASCIIHex(data: Uint8Array): Uint8Array;
+/**
+ * Decode an ASCII85Decode stream (Adobe variant).
+ *
+ * Five base-85 digits in the range `!`..`u` encode four bytes. The shorthand
+ * `z` represents four zero bytes. The end-of-data marker is `~>`. Whitespace
+ * is ignored. A short final group (1..4 digits) decodes to (count-1) bytes
+ * with the missing digits taken as `u` (84) and the trailing bytes discarded.
+ */
+declare function decodeASCII85(data: Uint8Array): Uint8Array;
+/**
+ * Decode an LZWDecode stream with variable-width codes (9–12 bits) and
+ * automatic table reset on the CLEAR code (256). Terminates on the EOD
+ * code (257) per ISO 32000-1 §7.4.4. EarlyChange is fixed to 1 (the PDF
+ * default); callers that need a different value should pass it explicitly
+ * via `DecodeParms`, which is currently not honoured here (rare in PDF).
+ */
+declare function decodeLZW(data: Uint8Array): Uint8Array;
+/**
+ * Decode a RunLengthDecode stream. Each control byte `n`:
+ *   - 0..127: copy the next `n+1` bytes literally
+ *   - 128:    EOD
+ *   - 129..255: repeat the next byte `257 - n` times
+ */
+declare function decodeRunLength(data: Uint8Array): Uint8Array;
+/**
+ * Apply a single PDF stream filter by name. Returns the input unchanged
+ * for unsupported filters (callers should detect this via the return
+ * value being identical or by pre-checking against {@link KNOWN_FILTERS}).
+ *
+ * Supports: FlateDecode is NOT handled here (use `inflateSync` instead);
+ * this function dispatches the non-deflate filter family.
+ */
+declare function applyDecodeFilter(name: string, data: Uint8Array): Uint8Array;
+/** Known non-Flate decode filter names (for membership checks). */
+declare const KNOWN_DECODE_FILTERS: Set<string>;
+
 /**
  * pdfnative — Worker API
  * ========================
@@ -2635,4 +2777,4 @@ declare function createPDF(pdfParams: PdfParams, options?: {
     layoutOptions?: Partial<PdfLayoutOptions>;
 }): Promise<Uint8Array>;
 
-export { type Annotation, type Asn1Node, BAL_H, type BarcodeBlock, type BarcodeFormat, type BidiRun, type CmsSignOptions, type ColumnDef, DEFAULT_COLORS, DEFAULT_COLUMNS, DEFAULT_CW, DEFAULT_FONT_SIZES, DEFAULT_MARGINS, DEFAULT_MAX_INFLATE_OUTPUT, type DocumentBlock, type DocumentMetadata, type DocumentParams, type EcPrivateKey, type EcPublicKey, type EmbeddedFilesResult, type EncodingContext, type EncryptionOptions, FT_H, type FontData, type FontEntry, type FontLoader, type FontMetrics, type FontRun, type FormField, type FormFieldBlock, type FormFieldType, type FormWidgetResult, HEADER_H, type HeadingBlock, INFO_LN, type ImageBlock, type InternalLink, type LinkAnnotation, type LinkBlock, type ListBlock, MAX_PARSE_DEPTH, MAX_XREF_CHAIN, PAGE_SIZES, PG_H, PG_W, type PageBreakBlock, type PageTemplate, type ParagraphBlock, type PdfArray as ParsedArray, type PdfDict as ParsedDict, type ParsedImage, type PdfAConfig, type PdfAttachment, type PdfAttachmentRelationship, type PdfColor, type PdfColors, type PdfIndirectObject, type PdfInfoItem, type PdfLayoutOptions, type PdfModifier, type PdfName, type PdfParams, type PdfReader, type PdfRef, type PdfRgbString, type PdfRgbTuple, type PdfRow, type PdfSignOptions, type PdfStream, type PdfToken, type PdfTokenizer, type PdfValue, type QRErrorLevel, ROW_H, type RadioGroupContext, type RsaPrivateKey, type RsaPublicKey, type ShapedGlyph, type SignatureAlgorithm, type SpacerBlock, type StreamOptions, type SvgBlock, type SvgRenderOptions, type SvgSegment, TH_H, TITLE_LN, type TableBlock, type TextRun, type TocBlock, type TokenType, WORKER_THRESHOLD, WORKER_TIMEOUT_MS, type WatermarkImage, type WatermarkOptions, type WatermarkState, type WatermarkText, type WorkerGenerationOptions, type WorkerInputMessage, type WorkerOutputMessage, type X509Certificate, type X509Name, type XrefEntry, type XrefTable, buildAcroFormDict, buildAppearanceStreamDict, buildCmsSignedData, buildDocumentPDF, buildDocumentPDFBytes, buildDocumentPDFStream, buildEmbeddedFiles, buildFormWidget, buildImageOperators, buildImageXObject, buildInternalLinkAnnotation, buildLinkAnnotation, buildPDF, buildPDFBytes, buildPDFStream, buildRadioGroupParent, buildSMaskXObject, buildSigDict, buildWatermarkState, chunkBinaryString, clearFontCache, computeColumnPositions, concatChunks, containsArabic, containsBengali, containsDevanagari, containsHebrew, containsRTL, containsTamil, containsThai, createEncodingContext, createModifier, createPDF, createTokenizer, decodeEcPublicKey, defaultFieldHeight, derBitString, derDecode, derInteger, derOctetString, derOid, derSequence, detectCharLang, detectFallbackLangs, detectImageFormat, dictGet, dictGetArray, dictGetDict, dictGetName, dictGetNum, dictGetRef, downloadBlob, ean13CheckDigit, ecPublicKeyFromPrivate, ecdsaSign, ecdsaVerify, encodeCode128, encodeEcPublicKey, encodePDF417, encodePdfTextString, estimateCmsSize, estimateContentsSize, findStartxref, generateDataMatrix, generatePDFInWorker, generatePDFMainThread, generateQR, getMaxInflateOutputSize, getRegisteredLangs, getTrailerRef, getTrailerValue, hasFontLoader, helveticaWidth, hmacSha256, inflateSync, initCrypto, initNodeCompression, initNodeDecompression as initNodeDecompression_parser, isArmenianCodepoint, isArray, isBengaliCodepoint, isCyrillicCodepoint, isDevanagariCodepoint, isDict, isGeorgianCodepoint, isLinkAnnotation, isName, isRef, isSelfSigned, isStream, isTamilCodepoint, isValidPdfRgb, loadFontData, nameValue, needsUnicodeFont, normalizeColors, openPdf, parseCertificate, parseColor, parseImage, parseIndirectObject, parseJPEG, parsePNG, parseRsaPrivateKey, parseRsaPublicKey, parseSvgPath, parseValue, parseXrefTable, pdfString, registerFont, registerFonts, renderBarcode, renderCode128, renderDataMatrix, renderEAN13, renderPDF417, renderQR, renderSvg, resetFontRegistry, resolveBidiRuns, resolveLayout, resolvePdfAConfig, resolveTemplate, rsaSign, rsaSignHash, rsaVerify, rsaVerifyHash, setDeflateImpl, setInflateImpl, setMaxInflateOutputSize, sha384, sha512, shapeArabicText, shapeBengaliText, shapeDevanagariText, shapeTamilText, shapeThaiText, signPdfBytes, slugify, splitTextByFont, streamByteLength, toBytes, toWinAnsi, truncate, validateAttachments, validateDocumentStreamable, validateTableStreamable, validateURL, validateWatermark, verifyCertSignature, wrapText };
+export { type Annotation, type Asn1Node, BAL_H, type BarcodeBlock, type BarcodeFormat, type BidiRun, type CmsSignOptions, type ColumnDef, DEFAULT_COLORS, DEFAULT_COLUMNS, DEFAULT_CW, DEFAULT_FONT_SIZES, DEFAULT_MARGINS, DEFAULT_MAX_INFLATE_OUTPUT, type DocumentBlock, type DocumentMetadata, type DocumentParams, type EcPrivateKey, type EcPublicKey, type EmbeddedFilesResult, type EncodingContext, type EncryptionOptions, FT_H, type FontData, type FontEntry, type FontLoader, type FontMetrics, type FontRun, type FormField, type FormFieldBlock, type FormFieldType, type FormWidgetResult, HEADER_H, type HeadingBlock, INFO_LN, type ImageBlock, type InternalLink, KNOWN_DECODE_FILTERS, type LinkAnnotation, type LinkBlock, type ListBlock, MAX_PARSE_DEPTH, MAX_XREF_CHAIN, PAGE_SIZES, PG_H, PG_W, type PageBreakBlock, type PageTemplate, type ParagraphBlock, type PdfArray as ParsedArray, type PdfDict as ParsedDict, type ParsedImage, type PdfAConfig, type PdfAttachment, type PdfAttachmentRelationship, type PdfColor, type PdfColors, type PdfIndirectObject, type PdfInfoItem, type PdfLayoutOptions, type PdfModifier, type PdfName, type PdfParams, type PdfReader, type PdfRef, type PdfRgbString, type PdfRgbTuple, type PdfRow, type PdfSignOptions, type PdfStream, type PdfToken, type PdfTokenizer, type PdfValue, type QRErrorLevel, ROW_H, type RadioGroupContext, type RsaPrivateKey, type RsaPublicKey, type ShapedGlyph, type SignatureAlgorithm, type SpacerBlock, type StreamOptions, type SvgBlock, type SvgRenderOptions, type SvgSegment, TH_H, TITLE_LN, type TableBlock, type TextRun, type TocBlock, type TokenType, WORKER_THRESHOLD, WORKER_TIMEOUT_MS, type WatermarkImage, type WatermarkOptions, type WatermarkState, type WatermarkText, type WorkerGenerationOptions, type WorkerInputMessage, type WorkerOutputMessage, type X509Certificate, type X509Name, type XrefEntry, type XrefTable, applyDecodeFilter, buildAcroFormDict, buildAppearanceStreamDict, buildCmsSignedData, buildDocumentPDF, buildDocumentPDFBytes, buildDocumentPDFStream, buildEmbeddedFiles, buildFormWidget, buildImageOperators, buildImageXObject, buildInternalLinkAnnotation, buildLinkAnnotation, buildPDF, buildPDFBytes, buildPDFStream, buildRadioGroupParent, buildSMaskXObject, buildSigDict, buildWatermarkState, chunkBinaryString, clearFontCache, computeColumnPositions, concatChunks, containsArabic, containsBengali, containsDevanagari, containsHebrew, containsRTL, containsTamil, containsThai, createEncodingContext, createModifier, createPDF, createTokenizer, decodeASCII85, decodeASCIIHex, decodeEcPublicKey, decodeLZW, decodeRunLength, defaultFieldHeight, derBitString, derDecode, derInteger, derOctetString, derOid, derSequence, detectCharLang, detectFallbackLangs, detectImageFormat, dictGet, dictGetArray, dictGetDict, dictGetName, dictGetNum, dictGetRef, downloadBlob, ean13CheckDigit, ecPublicKeyFromPrivate, ecdsaSign, ecdsaVerify, encodeCode128, encodeEcPublicKey, encodePDF417, encodePdfTextString, estimateCmsSize, estimateContentsSize, findStartxref, generateDataMatrix, generatePDFInWorker, generatePDFMainThread, generateQR, getMaxInflateOutputSize, getRegisteredLangs, getTrailerRef, getTrailerValue, hasFontLoader, helveticaWidth, hmacSha256, inflateSync, initCrypto, initNodeCompression, initNodeDecompression as initNodeDecompression_parser, isArmenianCodepoint, isArray, isBengaliCodepoint, isCyrillicCodepoint, isDevanagariCodepoint, isDict, isGeorgianCodepoint, isLinkAnnotation, isName, isRef, isSelfSigned, isStream, isTamilCodepoint, isValidPdfRgb, loadFontData, nameValue, needsUnicodeFont, normalizeColors, openPdf, parseCertificate, parseColor, parseImage, parseIndirectObject, parseJPEG, parsePNG, parseRsaPrivateKey, parseRsaPublicKey, parseSvgPath, parseValue, parseXrefTable, pdfString, registerFont, registerFonts, renderBarcode, renderCode128, renderDataMatrix, renderEAN13, renderPDF417, renderQR, renderSvg, resetFontRegistry, resolveBidiRuns, resolveLayout, resolvePdfAConfig, resolveTemplate, rsaSign, rsaSignHash, rsaVerify, rsaVerifyHash, setDeflateImpl, setInflateImpl, setMaxInflateOutputSize, sha384, sha512, shapeArabicText, shapeBengaliText, shapeDevanagariText, shapeTamilText, shapeThaiText, signPdfBytes, slugify, splitTextByFont, streamByteLength, toBytes, toWinAnsi, truncate, truncateToWidth, validateAttachments, validateDocumentStreamable, validateTableStreamable, validateURL, validateWatermark, verifyCertSignature, wrapText };

package/dist/index.d.ts

@@ -149,6 +149,20 @@ interface ColumnDef {
     readonly mx: number;
     /** Max characters for header cells. */
     readonly mxH: number;
+    /**
+     * Minimum column width in points. When set, the resolved width is
+     * clamped to at least this value, redistributing the surplus across
+     * the remaining unconstrained columns (proportional to their `f`).
+     * @since 1.1.0
+     */
+    readonly minWidth?: number;
+    /**
+     * Maximum column width in points. When set, the resolved width is
+     * clamped to at most this value, redistributing the surplus across
+     * the remaining unconstrained columns (proportional to their `f`).
+     * @since 1.1.0
+     */
+    readonly maxWidth?: number;
 }
 /**
  * Options for generating a PDF in a Web Worker via `generatePDFInWorker()`.
@@ -383,6 +397,15 @@ interface WatermarkText {
     readonly opacity?: number;
     /** Rotation angle in degrees (counterclockwise). Default: -45. */
     readonly angle?: number;
+    /**
+     * Auto-fit: clamp `fontSize` so the rotated bounding box fits within the
+     * page minus a 24-pt safety margin. Default: `true` (added in v1.1.0).
+     *
+     * Set to `false` to preserve byte-stable output when callers depend on
+     * the exact `fontSize` even if it produces a watermark that overflows
+     * the page (legacy v1.0.x behaviour).
+     */
+    readonly autoFit?: boolean;
 }
 /**
  * Image watermark configuration.
@@ -752,6 +775,31 @@ interface TableBlock {
     readonly headers: readonly string[];
     readonly rows: readonly PdfRow[];
     readonly columns?: readonly ColumnDef[];
+    /**
+     * Clip cell contents to column bounds using PDF clip-path operators.
+     * When `true`, each header/data cell is wrapped in `q <rect> re W n ... Q` so
+     * over-long text cannot escape the column rectangle visually.
+     *
+     * When `false`, cells rely solely on the existing `truncate()` character cap
+     * (ColumnDef.mx / mxH) — variable-width glyphs may still overflow visually.
+     *
+     * Default: `true` (recommended for PDF/A and visual safety).
+     * @since 1.1.0
+     */
+    readonly clipCells?: boolean;
+    /**
+     * Auto-fit column widths to actual content widths, respecting per-column
+     * `minWidth` / `maxWidth` constraints. Surplus or deficit is redistributed
+     * across unconstrained columns proportional to their `f` fraction.
+     *
+     * When `false` (default), the explicit `f` fractions are used as-is.
+     *
+     * Note: byte-output is non-deterministic vs explicit widths because resolved
+     * widths depend on text content and font metrics. Use only when content-aware
+     * sizing is desired.
+     * @since 1.1.0
+     */
+    readonly autoFitColumns?: boolean;
 }
 /** List block — bullet or numbered items. */
 interface ListBlock {
@@ -1856,6 +1904,14 @@ declare const DEFAULT_COLORS: PdfColors;
 declare const DEFAULT_COLUMNS: ColumnDef[];
 /**
  * Compute column X positions and widths given columns and content width.
+ *
+ * Honours optional `minWidth` / `maxWidth` constraints (in points) by clamping
+ * each constrained column then redistributing the surplus or deficit across
+ * the unconstrained columns proportional to their fractional weight `f`.
+ * Falls back to a single uniform proration pass when all columns are
+ * constrained or the unconstrained weights sum to zero.
+ *
+ * @since 1.1.0 — added support for `minWidth` / `maxWidth` (additive).
  */
 declare function computeColumnPositions(columns: readonly ColumnDef[], marginLeft: number, contentWidth: number): {
     cx: number[];
@@ -1922,8 +1978,28 @@ declare function toWinAnsi(str: string): string;
  * Create a PDF string literal: encode to WinAnsi and escape (, ), \.
  */
 declare function pdfString(str: string): string;
-/** Truncate string to max characters, appending '..' if needed. */
+/**
+ * Truncate string to max characters, appending Unicode ellipsis (…, U+2026) if needed.
+ *
+ * The horizontal ellipsis is rendered correctly in both Latin/WinAnsi mode
+ * (mapped to byte 0x85) and Unicode/CIDFont mode. This produces typographically
+ * correct output and is ~50% narrower than ASCII "..." while remaining a single
+ * grapheme cluster.
+ *
+ * @since 1.1.0 — the ellipsis character changed from `'..'` (two ASCII dots)
+ *   to `'…'` (U+2026). Output is one character shorter for the same `max`.
+ */
 declare function truncate(str: string, max: number): string;
+/**
+ * Truncate string so that its rendered width does not exceed `maxWidthPt`,
+ * appending the Unicode ellipsis (…, U+2026) when truncation occurs.
+ *
+ * Unlike {@link truncate}, this measures actual glyph width using the encoding
+ * context — appropriate for proportional fonts and Unicode text.
+ *
+ * @since 1.1.0
+ */
+declare function truncateToWidth(str: string, maxWidthPt: number, sz: number, enc: EncodingContext): string;
 /**
  * Approximate text width in points using Helvetica character metrics.
  */
@@ -1945,8 +2021,13 @@ declare function helveticaWidth(str: string, sz: number): number;
  * Latin mode uses WinAnsi/Helvetica, Unicode mode uses CIDFont/Identity-H.
  *
  * @param fontEntries - Array of font entries (primary first). Empty = Latin mode.
+ * @param pdfA - When true and at least one font entry is registered, disables
+ *   WinAnsi/Helvetica fallback in mixed-content runs (Helvetica is unembedded
+ *   standard-14, forbidden by ISO 19005). When pdfA is true with no fontEntries,
+ *   Latin mode is used as before — strict PDF/A conformance requires the caller
+ *   to register a Latin font (e.g. Noto Sans VF).
  */
-declare function createEncodingContext(fontEntries: FontEntry[]): EncodingContext;
+declare function createEncodingContext(fontEntries: FontEntry[], pdfA?: boolean): EncodingContext;
 
 /**
  * pdfnative — Font Loader
@@ -2173,7 +2254,7 @@ declare function detectFallbackLangs(texts: string[], primaryLang: string): Set<
  * Returns the language code of the font most appropriate for rendering.
  *
  * @param cp - Unicode codepoint
- * @returns Language code ('el', 'hi', 'th', 'ja', 'ko', 'zh', 'vi', 'pl', 'tr', 'he', 'ar', 'ru', 'ka', 'hy') or null for Latin/common
+ * @returns Language code ('el', 'hi', 'th', 'ja', 'ko', 'zh', 'vi', 'pl', 'tr', 'he', 'ar', 'ru', 'ka', 'hy', 'emoji') or null for Latin/common
  */
 declare function detectCharLang(cp: number): string | null;
 
@@ -2208,6 +2289,11 @@ interface BidiRun {
 /**
  * Resolve bidirectional text into ordered runs with embedding levels.
  *
+ * Implements UAX #9 with isolate support (LRI/RLI/FSI ... PDI). When the
+ * input contains matched isolate pairs, the inner content is resolved as
+ * a sealed sub-paragraph with its own forced or auto-detected direction,
+ * preventing the outer context from leaking into it (and vice versa).
+ *
  * @param text - Input text in logical order
  * @returns Array of BidiRun objects in visual order
  */
@@ -2595,6 +2681,62 @@ declare function initNodeDecompression(): Promise<void>;
  */
 declare function inflateSync(data: Uint8Array): Uint8Array;
 
+/**
+ * pdfnative — PDF Stream Filter Decoders
+ * ========================================
+ * Pure, zero-dependency decoders for the standard PDF stream filters that
+ * are not handled by {@link inflateSync} (FlateDecode).
+ *
+ * Implemented filters (ISO 32000-1 §7.4):
+ *   - ASCIIHexDecode  (§7.4.2)
+ *   - ASCII85Decode   (§7.4.3)
+ *   - LZWDecode       (§7.4.4)  — variable-width 9..12 bit codes
+ *   - RunLengthDecode (§7.4.5)
+ *
+ * @since 1.1.0
+ */
+/**
+ * Decode an ASCIIHexDecode stream. Two hex digits encode one byte.
+ * Whitespace is ignored; `>` terminates the stream. An odd trailing digit
+ * is treated as if followed by `0` (per ISO 32000-1 §7.4.2).
+ */
+declare function decodeASCIIHex(data: Uint8Array): Uint8Array;
+/**
+ * Decode an ASCII85Decode stream (Adobe variant).
+ *
+ * Five base-85 digits in the range `!`..`u` encode four bytes. The shorthand
+ * `z` represents four zero bytes. The end-of-data marker is `~>`. Whitespace
+ * is ignored. A short final group (1..4 digits) decodes to (count-1) bytes
+ * with the missing digits taken as `u` (84) and the trailing bytes discarded.
+ */
+declare function decodeASCII85(data: Uint8Array): Uint8Array;
+/**
+ * Decode an LZWDecode stream with variable-width codes (9–12 bits) and
+ * automatic table reset on the CLEAR code (256). Terminates on the EOD
+ * code (257) per ISO 32000-1 §7.4.4. EarlyChange is fixed to 1 (the PDF
+ * default); callers that need a different value should pass it explicitly
+ * via `DecodeParms`, which is currently not honoured here (rare in PDF).
+ */
+declare function decodeLZW(data: Uint8Array): Uint8Array;
+/**
+ * Decode a RunLengthDecode stream. Each control byte `n`:
+ *   - 0..127: copy the next `n+1` bytes literally
+ *   - 128:    EOD
+ *   - 129..255: repeat the next byte `257 - n` times
+ */
+declare function decodeRunLength(data: Uint8Array): Uint8Array;
+/**
+ * Apply a single PDF stream filter by name. Returns the input unchanged
+ * for unsupported filters (callers should detect this via the return
+ * value being identical or by pre-checking against {@link KNOWN_FILTERS}).
+ *
+ * Supports: FlateDecode is NOT handled here (use `inflateSync` instead);
+ * this function dispatches the non-deflate filter family.
+ */
+declare function applyDecodeFilter(name: string, data: Uint8Array): Uint8Array;
+/** Known non-Flate decode filter names (for membership checks). */
+declare const KNOWN_DECODE_FILTERS: Set<string>;
+
 /**
  * pdfnative — Worker API
  * ========================
@@ -2635,4 +2777,4 @@ declare function createPDF(pdfParams: PdfParams, options?: {
     layoutOptions?: Partial<PdfLayoutOptions>;
 }): Promise<Uint8Array>;
 
-export { type Annotation, type Asn1Node, BAL_H, type BarcodeBlock, type BarcodeFormat, type BidiRun, type CmsSignOptions, type ColumnDef, DEFAULT_COLORS, DEFAULT_COLUMNS, DEFAULT_CW, DEFAULT_FONT_SIZES, DEFAULT_MARGINS, DEFAULT_MAX_INFLATE_OUTPUT, type DocumentBlock, type DocumentMetadata, type DocumentParams, type EcPrivateKey, type EcPublicKey, type EmbeddedFilesResult, type EncodingContext, type EncryptionOptions, FT_H, type FontData, type FontEntry, type FontLoader, type FontMetrics, type FontRun, type FormField, type FormFieldBlock, type FormFieldType, type FormWidgetResult, HEADER_H, type HeadingBlock, INFO_LN, type ImageBlock, type InternalLink, type LinkAnnotation, type LinkBlock, type ListBlock, MAX_PARSE_DEPTH, MAX_XREF_CHAIN, PAGE_SIZES, PG_H, PG_W, type PageBreakBlock, type PageTemplate, type ParagraphBlock, type PdfArray as ParsedArray, type PdfDict as ParsedDict, type ParsedImage, type PdfAConfig, type PdfAttachment, type PdfAttachmentRelationship, type PdfColor, type PdfColors, type PdfIndirectObject, type PdfInfoItem, type PdfLayoutOptions, type PdfModifier, type PdfName, type PdfParams, type PdfReader, type PdfRef, type PdfRgbString, type PdfRgbTuple, type PdfRow, type PdfSignOptions, type PdfStream, type PdfToken, type PdfTokenizer, type PdfValue, type QRErrorLevel, ROW_H, type RadioGroupContext, type RsaPrivateKey, type RsaPublicKey, type ShapedGlyph, type SignatureAlgorithm, type SpacerBlock, type StreamOptions, type SvgBlock, type SvgRenderOptions, type SvgSegment, TH_H, TITLE_LN, type TableBlock, type TextRun, type TocBlock, type TokenType, WORKER_THRESHOLD, WORKER_TIMEOUT_MS, type WatermarkImage, type WatermarkOptions, type WatermarkState, type WatermarkText, type WorkerGenerationOptions, type WorkerInputMessage, type WorkerOutputMessage, type X509Certificate, type X509Name, type XrefEntry, type XrefTable, buildAcroFormDict, buildAppearanceStreamDict, buildCmsSignedData, buildDocumentPDF, buildDocumentPDFBytes, buildDocumentPDFStream, buildEmbeddedFiles, buildFormWidget, buildImageOperators, buildImageXObject, buildInternalLinkAnnotation, buildLinkAnnotation, buildPDF, buildPDFBytes, buildPDFStream, buildRadioGroupParent, buildSMaskXObject, buildSigDict, buildWatermarkState, chunkBinaryString, clearFontCache, computeColumnPositions, concatChunks, containsArabic, containsBengali, containsDevanagari, containsHebrew, containsRTL, containsTamil, containsThai, createEncodingContext, createModifier, createPDF, createTokenizer, decodeEcPublicKey, defaultFieldHeight, derBitString, derDecode, derInteger, derOctetString, derOid, derSequence, detectCharLang, detectFallbackLangs, detectImageFormat, dictGet, dictGetArray, dictGetDict, dictGetName, dictGetNum, dictGetRef, downloadBlob, ean13CheckDigit, ecPublicKeyFromPrivate, ecdsaSign, ecdsaVerify, encodeCode128, encodeEcPublicKey, encodePDF417, encodePdfTextString, estimateCmsSize, estimateContentsSize, findStartxref, generateDataMatrix, generatePDFInWorker, generatePDFMainThread, generateQR, getMaxInflateOutputSize, getRegisteredLangs, getTrailerRef, getTrailerValue, hasFontLoader, helveticaWidth, hmacSha256, inflateSync, initCrypto, initNodeCompression, initNodeDecompression as initNodeDecompression_parser, isArmenianCodepoint, isArray, isBengaliCodepoint, isCyrillicCodepoint, isDevanagariCodepoint, isDict, isGeorgianCodepoint, isLinkAnnotation, isName, isRef, isSelfSigned, isStream, isTamilCodepoint, isValidPdfRgb, loadFontData, nameValue, needsUnicodeFont, normalizeColors, openPdf, parseCertificate, parseColor, parseImage, parseIndirectObject, parseJPEG, parsePNG, parseRsaPrivateKey, parseRsaPublicKey, parseSvgPath, parseValue, parseXrefTable, pdfString, registerFont, registerFonts, renderBarcode, renderCode128, renderDataMatrix, renderEAN13, renderPDF417, renderQR, renderSvg, resetFontRegistry, resolveBidiRuns, resolveLayout, resolvePdfAConfig, resolveTemplate, rsaSign, rsaSignHash, rsaVerify, rsaVerifyHash, setDeflateImpl, setInflateImpl, setMaxInflateOutputSize, sha384, sha512, shapeArabicText, shapeBengaliText, shapeDevanagariText, shapeTamilText, shapeThaiText, signPdfBytes, slugify, splitTextByFont, streamByteLength, toBytes, toWinAnsi, truncate, validateAttachments, validateDocumentStreamable, validateTableStreamable, validateURL, validateWatermark, verifyCertSignature, wrapText };
+export { type Annotation, type Asn1Node, BAL_H, type BarcodeBlock, type BarcodeFormat, type BidiRun, type CmsSignOptions, type ColumnDef, DEFAULT_COLORS, DEFAULT_COLUMNS, DEFAULT_CW, DEFAULT_FONT_SIZES, DEFAULT_MARGINS, DEFAULT_MAX_INFLATE_OUTPUT, type DocumentBlock, type DocumentMetadata, type DocumentParams, type EcPrivateKey, type EcPublicKey, type EmbeddedFilesResult, type EncodingContext, type EncryptionOptions, FT_H, type FontData, type FontEntry, type FontLoader, type FontMetrics, type FontRun, type FormField, type FormFieldBlock, type FormFieldType, type FormWidgetResult, HEADER_H, type HeadingBlock, INFO_LN, type ImageBlock, type InternalLink, KNOWN_DECODE_FILTERS, type LinkAnnotation, type LinkBlock, type ListBlock, MAX_PARSE_DEPTH, MAX_XREF_CHAIN, PAGE_SIZES, PG_H, PG_W, type PageBreakBlock, type PageTemplate, type ParagraphBlock, type PdfArray as ParsedArray, type PdfDict as ParsedDict, type ParsedImage, type PdfAConfig, type PdfAttachment, type PdfAttachmentRelationship, type PdfColor, type PdfColors, type PdfIndirectObject, type PdfInfoItem, type PdfLayoutOptions, type PdfModifier, type PdfName, type PdfParams, type PdfReader, type PdfRef, type PdfRgbString, type PdfRgbTuple, type PdfRow, type PdfSignOptions, type PdfStream, type PdfToken, type PdfTokenizer, type PdfValue, type QRErrorLevel, ROW_H, type RadioGroupContext, type RsaPrivateKey, type RsaPublicKey, type ShapedGlyph, type SignatureAlgorithm, type SpacerBlock, type StreamOptions, type SvgBlock, type SvgRenderOptions, type SvgSegment, TH_H, TITLE_LN, type TableBlock, type TextRun, type TocBlock, type TokenType, WORKER_THRESHOLD, WORKER_TIMEOUT_MS, type WatermarkImage, type WatermarkOptions, type WatermarkState, type WatermarkText, type WorkerGenerationOptions, type WorkerInputMessage, type WorkerOutputMessage, type X509Certificate, type X509Name, type XrefEntry, type XrefTable, applyDecodeFilter, buildAcroFormDict, buildAppearanceStreamDict, buildCmsSignedData, buildDocumentPDF, buildDocumentPDFBytes, buildDocumentPDFStream, buildEmbeddedFiles, buildFormWidget, buildImageOperators, buildImageXObject, buildInternalLinkAnnotation, buildLinkAnnotation, buildPDF, buildPDFBytes, buildPDFStream, buildRadioGroupParent, buildSMaskXObject, buildSigDict, buildWatermarkState, chunkBinaryString, clearFontCache, computeColumnPositions, concatChunks, containsArabic, containsBengali, containsDevanagari, containsHebrew, containsRTL, containsTamil, containsThai, createEncodingContext, createModifier, createPDF, createTokenizer, decodeASCII85, decodeASCIIHex, decodeEcPublicKey, decodeLZW, decodeRunLength, defaultFieldHeight, derBitString, derDecode, derInteger, derOctetString, derOid, derSequence, detectCharLang, detectFallbackLangs, detectImageFormat, dictGet, dictGetArray, dictGetDict, dictGetName, dictGetNum, dictGetRef, downloadBlob, ean13CheckDigit, ecPublicKeyFromPrivate, ecdsaSign, ecdsaVerify, encodeCode128, encodeEcPublicKey, encodePDF417, encodePdfTextString, estimateCmsSize, estimateContentsSize, findStartxref, generateDataMatrix, generatePDFInWorker, generatePDFMainThread, generateQR, getMaxInflateOutputSize, getRegisteredLangs, getTrailerRef, getTrailerValue, hasFontLoader, helveticaWidth, hmacSha256, inflateSync, initCrypto, initNodeCompression, initNodeDecompression as initNodeDecompression_parser, isArmenianCodepoint, isArray, isBengaliCodepoint, isCyrillicCodepoint, isDevanagariCodepoint, isDict, isGeorgianCodepoint, isLinkAnnotation, isName, isRef, isSelfSigned, isStream, isTamilCodepoint, isValidPdfRgb, loadFontData, nameValue, needsUnicodeFont, normalizeColors, openPdf, parseCertificate, parseColor, parseImage, parseIndirectObject, parseJPEG, parsePNG, parseRsaPrivateKey, parseRsaPublicKey, parseSvgPath, parseValue, parseXrefTable, pdfString, registerFont, registerFonts, renderBarcode, renderCode128, renderDataMatrix, renderEAN13, renderPDF417, renderQR, renderSvg, resetFontRegistry, resolveBidiRuns, resolveLayout, resolvePdfAConfig, resolveTemplate, rsaSign, rsaSignHash, rsaVerify, rsaVerifyHash, setDeflateImpl, setInflateImpl, setMaxInflateOutputSize, sha384, sha512, shapeArabicText, shapeBengaliText, shapeDevanagariText, shapeTamilText, shapeThaiText, signPdfBytes, slugify, splitTextByFont, streamByteLength, toBytes, toWinAnsi, truncate, truncateToWidth, validateAttachments, validateDocumentStreamable, validateTableStreamable, validateURL, validateWatermark, verifyCertSignature, wrapText };