@libpdf/core 0.2.6 → 0.2.8

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.
@@ -2675,6 +2677,8 @@ declare class EmbeddedFont extends PdfFont {
   private _subsetTag;
   /** Whether this font is used in a form field (prevents subsetting) */
   private _usedInForm;
+  /** Pre-allocated PDF reference (set by PDFFonts.embed()) */
+  private _ref;
   /** Cached descriptor */
   private _descriptor;
   private constructor();
@@ -2790,6 +2794,22 @@ declare class EmbeddedFont extends PdfFont {
    * Call this before re-encoding if you want a fresh subset.
    */
   resetUsage(): void;
+  /**
+   * Get the pre-allocated PDF reference for this font.
+   *
+   * Set by `PDFFonts.embed()`. At save time, the actual font objects
+   * (Type0 dict, CIDFont, FontDescriptor, font program, ToUnicode)
+   * are created and registered at this ref.
+   *
+   * @throws {Error} if the font was not embedded via `pdf.embedFont()`
+   */
+  get ref(): PdfRef;
+  /**
+   * Set the pre-allocated PDF reference.
+   *
+   * @internal Called by PDFFonts.embed()
+   */
+  setRef(ref: PdfRef): void;
   /**
    * Mark this font as used in a form field.
    *
@@ -4948,6 +4968,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.
@@ -8709,6 +8731,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.