@libpdf/core 0.2.8 → 0.2.9

package/dist/index.d.mts

@@ -1633,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"
@@ -1644,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;
 }

package/dist/index.mjs

@@ -11,7 +11,7 @@ import { createCMSECDSASignature } from "pkijs";
 import { base64 } from "@scure/base";
 
 //#region package.json
-var version = "0.2.8";
+var version = "0.2.9";
 
 //#endregion
 //#region src/objects/pdf-array.ts
@@ -2083,7 +2083,6 @@ var PdfStream = class PdfStream extends PdfDict {
 *
 * This module provides type-safe creation and serialization of operators.
 */
-const encoder$1 = new TextEncoder();
 const SPACE$1 = 32;
 /** All PDF content stream operator names */
 const Op = {
@@ -2173,18 +2172,24 @@ var Operator = class Operator {
 		return new Operator(op, Object.freeze([...operands]));
 	}
 	/**
+	* Write operator bytes directly into a shared ByteWriter.
+	* Avoids intermediate allocations compared to toBytes().
+	*/
+	writeTo(writer) {
+		for (const operand of this.operands) {
+			writeOperand(writer, operand);
+			writer.writeByte(SPACE$1);
+		}
+		writer.writeAscii(this.op);
+	}
+	/**
 	* Serialize to bytes for content stream output.
 	* Format: "operand1 operand2 ... operator"
 	*/
 	toBytes() {
-		if (this.operands.length === 0) return encoder$1.encode(this.op);
-		const parts = [];
-		for (const operand of this.operands) {
-			parts.push(serializeOperand(operand));
-			parts.push(new Uint8Array([SPACE$1]));
-		}
-		parts.push(encoder$1.encode(this.op));
-		return concatBytes(parts);
+		const writer = new ByteWriter(void 0, { initialSize: 64 });
+		this.writeTo(writer);
+		return writer.toBytes();
 	}
 	/**
 	* Serialize to PDF content stream syntax string.
@@ -2194,21 +2199,25 @@ var Operator = class Operator {
 		return new TextDecoder().decode(this.toBytes());
 	}
 	/**
-	* 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() {
 		return this.toBytes().length;
 	}
 };
-/**
-* Serialize an operand to bytes.
-*/
-function serializeOperand(operand) {
-	if (typeof operand === "number") return encoder$1.encode(formatPdfNumber(operand));
-	if (typeof operand === "string") return encoder$1.encode(operand);
-	const writer = new ByteWriter();
+/** Write an operand directly into a ByteWriter. */
+function writeOperand(writer, operand) {
+	if (typeof operand === "number") {
+		writer.writeAscii(formatPdfNumber(operand));
+		return;
+	}
+	if (typeof operand === "string") {
+		writer.writeAscii(operand);
+		return;
+	}
 	operand.toBytes(writer);
-	return writer.toBytes();
 }
 
 //#endregion
@@ -2230,7 +2239,7 @@ function isInlineImageOperation(op) {
 */
 const encoder = new TextEncoder();
 const SPACE = new Uint8Array([32]);
-const NEWLINE = new Uint8Array([10]);
+const NEWLINE$1 = new Uint8Array([10]);
 /**
 * Serializes content stream operations to bytes.
 */
@@ -2244,7 +2253,7 @@ var ContentStreamSerializer = class ContentStreamSerializer {
 		const parts = [];
 		for (const op of operations) {
 			parts.push(ContentStreamSerializer.serializeOperation(op));
-			parts.push(NEWLINE);
+			parts.push(NEWLINE$1);
 		}
 		return concatBytes(parts);
 	}
@@ -2268,15 +2277,15 @@ var ContentStreamSerializer = class ContentStreamSerializer {
 	static serializeInlineImage(op) {
 		const parts = [];
 		parts.push(encoder.encode("BI"));
-		parts.push(NEWLINE);
+		parts.push(NEWLINE$1);
 		for (const [key$1, value] of op.params) {
 			parts.push(encoder.encode(`/${key$1} `));
 			parts.push(ContentStreamSerializer.serializeToken(value));
-			parts.push(NEWLINE);
+			parts.push(NEWLINE$1);
 		}
 		parts.push(encoder.encode("ID "));
 		parts.push(op.data);
-		parts.push(NEWLINE);
+		parts.push(NEWLINE$1);
 		parts.push(encoder.encode("EI"));
 		return concatBytes(parts);
 	}
@@ -22699,21 +22708,21 @@ function executeSvgPathString(options) {
 
 //#endregion
 //#region src/drawing/serialize.ts
+const NEWLINE = 10;
 /**
 * Serialize operators to bytes for content streams.
 *
-* Uses Operator.toBytes() directly to avoid UTF-8 round-trip corruption
-* of non-ASCII bytes in PdfString operands (e.g., WinAnsi-encoded text).
+* Uses Operator.writeTo() to write directly into a shared ByteWriter,
+* avoiding per-operator intermediate allocations.
 */
 function serializeOperators(ops) {
 	if (ops.length === 0) return new Uint8Array(0);
-	const newline = new Uint8Array([10]);
-	const parts = [];
+	const writer = new ByteWriter(void 0, { initialSize: ops.length * 24 });
 	for (let i = 0; i < ops.length; i++) {
-		if (i > 0) parts.push(newline);
-		parts.push(ops[i].toBytes());
+		if (i > 0) writer.writeByte(NEWLINE);
+		ops[i].writeTo(writer);
 	}
-	return concatBytes(parts);
+	return writer.toBytes();
 }
 
 //#endregion
@@ -27898,7 +27907,7 @@ var PDFPage = class PDFPage {
 	*/
 	addXObjectResource(ref) {
 		const resources = this.getResources();
-		let xobjects = resources.get("XObject");
+		let xobjects = resources.get("XObject", this.ctx.resolve.bind(this.ctx));
 		if (!(xobjects instanceof PdfDict)) {
 			xobjects = new PdfDict();
 			resources.set("XObject", xobjects);
@@ -27933,7 +27942,7 @@ var PDFPage = class PDFPage {
 		const cachedName = this._resourceCache.get(ref);
 		if (cachedName) return cachedName;
 		const resources = this.getResources();
-		let subdict = resources.get(resourceType);
+		let subdict = resources.get(resourceType, this.ctx.resolve.bind(this.ctx));
 		if (!(subdict instanceof PdfDict)) {
 			subdict = new PdfDict();
 			resources.set(resourceType, subdict);
@@ -39426,8 +39435,8 @@ function findBytesReverse(buffer, pattern) {
 * @throws {Error} if placeholders cannot be found
 */
 function findPlaceholders(buffer) {
-	const encoder$2 = new TextEncoder();
-	const byteRangeKey = encoder$2.encode("/ByteRange");
+	const encoder$1 = new TextEncoder();
+	const byteRangeKey = encoder$1.encode("/ByteRange");
 	const byteRangeKeyPos = findBytesReverse(buffer, byteRangeKey);
 	if (byteRangeKeyPos === -1) throw new Error("ByteRange placeholder not found in PDF");
 	let byteRangeStart = byteRangeKeyPos + byteRangeKey.length;
@@ -39437,7 +39446,7 @@ function findPlaceholders(buffer) {
 	while (byteRangeEnd < buffer.length && buffer[byteRangeEnd] !== 93) byteRangeEnd++;
 	if (byteRangeEnd >= buffer.length) throw new Error("ByteRange ']' not found in PDF");
 	const byteRangeLength = byteRangeEnd - byteRangeStart + 1;
-	const contentsKey = encoder$2.encode("/Contents");
+	const contentsKey = encoder$1.encode("/Contents");
 	const contentsKeyPos = findBytes(buffer, contentsKey, byteRangeKeyPos);
 	if (contentsKeyPos === -1) throw new Error("Contents placeholder not found in PDF");
 	let contentsStart = contentsKeyPos + contentsKey.length;