@libpdf/core 0.2.8 → 0.2.10

package/dist/index.d.mts

@@ -49,7 +49,10 @@ declare class ByteWriter {
   writeUtf8(str: string): void;
   /**
    * Get final bytes.
-   * Returns a copy (slice) so the internal buffer can be garbage collected.
+   *
+   * If the internal buffer is exactly the right size, returns it directly
+   * (zero-copy). Otherwise returns a trimmed copy so the oversized buffer
+   * can be garbage collected.
    *
    * Note: ByteWriter is single-use. Do not write after calling toBytes().
    */
@@ -1633,6 +1636,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"
@@ -1644,7 +1652,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;
 }