@libpdf/core 0.2.7 → 0.2.9

package/dist/index.d.mts

@@ -182,6 +182,8 @@ declare class PdfName implements PdfPrimitive {
   static readonly Length: PdfName;
   static readonly Filter: PdfName;
   static readonly FlateDecode: PdfName;
+  /** Cached serialized form (e.g. "/Type"). Computed lazily on first toBytes(). */
+  private cachedBytes;
   private constructor();
   /**
    * Get or create an interned PdfName for the given string.
@@ -1631,6 +1633,11 @@ declare class Operator {
    * Create an operator with operands.
    */
   static of(op: Op, ...operands: Operand[]): Operator;
+  /**
+   * Write operator bytes directly into a shared ByteWriter.
+   * Avoids intermediate allocations compared to toBytes().
+   */
+  writeTo(writer: ByteWriter): void;
   /**
    * Serialize to bytes for content stream output.
    * Format: "operand1 operand2 ... operator"
@@ -1642,7 +1649,9 @@ declare class Operator {
    */
   toString(): string;
   /**
-   * Get byte length when serialized (for pre-allocation).
+   * Get byte length when serialized.
+   *
+   * Should be avoided in performance-critical paths, use {@link writeTo} instead.
    */
   byteLength(): number;
 }
@@ -4966,6 +4975,8 @@ interface ExtractedChar {
   fontName: string;
   /** Y coordinate of the text baseline */
   baseline: number;
+  /** Index in the content stream extraction order (0-based) */
+  sequenceIndex?: number;
 }
 /**
  * A span of text with the same font and size on the same line.
@@ -8727,6 +8738,24 @@ interface SaveOptions {
    * @default false
    */
   subsetFonts?: boolean;
+  /**
+   * Compress uncompressed streams with FlateDecode (default: true).
+   *
+   * When enabled, streams without a /Filter entry will be compressed
+   * before writing. Streams that already have filters (including image
+   * formats like DCTDecode/JPXDecode) are left unchanged.
+   */
+  compressStreams?: boolean;
+  /**
+   * Minimum stream size in bytes to attempt compression (default: 512).
+   *
+   * Streams smaller than this threshold are written uncompressed.
+   * Deflate initialization has a fixed overhead that dominates for small
+   * payloads, and tiny streams rarely achieve meaningful compression.
+   *
+   * Set to 0 to compress all streams regardless of size.
+   */
+  compressionThreshold?: number;
 }
 /**
  * Options for adding a new page.