@libpdf/core 0.0.1-beta.14 → 0.0.1-beta.15

package/dist/index.d.mts

@@ -4842,6 +4842,23 @@ interface DrawPageOptions {
   height?: number;
   /** Opacity 0-1 (default: 1.0, fully opaque) */
   opacity?: number;
+  /**
+   * Rotation specification.
+   * Can be a simple number (degrees) or an object with angle and origin.
+   *
+   * @example
+   * ```typescript
+   * // Simple rotation (around position x, y)
+   * page.drawPage(embedded, { x: 100, y: 100, rotate: 45 });
+   *
+   * // Rotation with custom origin
+   * page.drawPage(embedded, { x: 100, y: 100, rotate: { angle: 45, origin: "center" } });
+   *
+   * // Rotation with explicit origin coordinates
+   * page.drawPage(embedded, { x: 100, y: 100, rotate: { angle: 45, origin: { x: 150, y: 150 } } });
+   * ```
+   */
+  rotate?: number | Rotation;
   /** Draw as background behind existing content (default: false = foreground) */
   background?: boolean;
 }
@@ -4956,7 +4973,7 @@ declare class PDFPage {
    * Use `{ background: true }` to draw behind existing content.
    *
    * @param embedded - The embedded page to draw
-   * @param options - Drawing options (position, scale, opacity, background)
+   * @param options - Drawing options (position, scale, rotate, opacity, background)
    *
    * @example
    * ```typescript
@@ -4973,6 +4990,15 @@ declare class PDFPage {
    *
    * // Draw as a background
    * page.drawPage(letterhead, { background: true });
+   *
+   * // Draw rotated 45 degrees counter-clockwise (around position x, y)
+   * page.drawPage(stamp, { x: 100, y: 100, rotate: 45, scale: 0.5 });
+   *
+   * // Draw rotated around the center of the embedded page
+   * page.drawPage(stamp, { x: 100, y: 100, rotate: { angle: 45, origin: "center" }, scale: 0.5 });
+   *
+   * // Draw rotated around a custom point
+   * page.drawPage(stamp, { x: 100, y: 100, rotate: { angle: 90, origin: { x: 200, y: 200 } } });
    * ```
    */
   drawPage(embedded: PDFEmbeddedPage, options?: DrawPageOptions): void;

package/dist/index.mjs

@@ -9,7 +9,7 @@ import { createCMSECDSASignature } from "pkijs";
 import { base64 } from "@scure/base";
 
 //#region package.json
-var version = "0.0.1-beta.14";
+var version = "0.0.1-beta.15";
 
 //#endregion
 //#region src/objects/pdf-array.ts
@@ -24339,7 +24339,7 @@ var PDFPage = class PDFPage {
 	* Use `{ background: true }` to draw behind existing content.
 	*
 	* @param embedded - The embedded page to draw
-	* @param options - Drawing options (position, scale, opacity, background)
+	* @param options - Drawing options (position, scale, rotate, opacity, background)
 	*
 	* @example
 	* ```typescript
@@ -24356,6 +24356,15 @@ var PDFPage = class PDFPage {
 	*
 	* // Draw as a background
 	* page.drawPage(letterhead, { background: true });
+	*
+	* // Draw rotated 45 degrees counter-clockwise (around position x, y)
+	* page.drawPage(stamp, { x: 100, y: 100, rotate: 45, scale: 0.5 });
+	*
+	* // Draw rotated around the center of the embedded page
+	* page.drawPage(stamp, { x: 100, y: 100, rotate: { angle: 45, origin: "center" }, scale: 0.5 });
+	*
+	* // Draw rotated around a custom point
+	* page.drawPage(stamp, { x: 100, y: 100, rotate: { angle: 90, origin: { x: 200, y: 200 } } });
 	* ```
 	*/
 	drawPage(embedded, options = {}) {
@@ -24377,9 +24386,40 @@ var PDFPage = class PDFPage {
 			});
 			ops.push(`/${gsName} gs`);
 		}
-		const translateX = x - embedded.box.x * scaleX;
-		const translateY = y - embedded.box.y * scaleY;
-		ops.push(`${this.formatNumber(scaleX)} 0 0 ${this.formatNumber(scaleY)} ${this.formatNumber(translateX)} ${this.formatNumber(translateY)} cm`);
+		let rotateDegrees = 0;
+		let rotateOriginX = x;
+		let rotateOriginY = y;
+		if (options.rotate !== void 0) if (typeof options.rotate === "number") rotateDegrees = options.rotate;
+		else {
+			rotateDegrees = options.rotate.angle;
+			const bounds = {
+				x,
+				y,
+				width: embedded.width * scaleX,
+				height: embedded.height * scaleY
+			};
+			const defaultOrigin = {
+				x,
+				y
+			};
+			const origin = resolveRotationOrigin(options.rotate.origin, bounds, defaultOrigin);
+			rotateOriginX = origin.x;
+			rotateOriginY = origin.y;
+		}
+		if (rotateDegrees !== 0) {
+			const radians = rotateDegrees * Math.PI / 180;
+			const cos = Math.cos(radians);
+			const sin = Math.sin(radians);
+			ops.push(`1 0 0 1 ${this.formatNumber(rotateOriginX)} ${this.formatNumber(rotateOriginY)} cm`);
+			ops.push(`${this.formatNumber(cos)} ${this.formatNumber(sin)} ${this.formatNumber(-sin)} ${this.formatNumber(cos)} 0 0 cm`);
+			const offsetX = x - rotateOriginX - embedded.box.x * scaleX;
+			const offsetY = y - rotateOriginY - embedded.box.y * scaleY;
+			ops.push(`${this.formatNumber(scaleX)} 0 0 ${this.formatNumber(scaleY)} ${this.formatNumber(offsetX)} ${this.formatNumber(offsetY)} cm`);
+		} else {
+			const translateX = x - embedded.box.x * scaleX;
+			const translateY = y - embedded.box.y * scaleY;
+			ops.push(`${this.formatNumber(scaleX)} 0 0 ${this.formatNumber(scaleY)} ${this.formatNumber(translateX)} ${this.formatNumber(translateY)} cm`);
+		}
 		ops.push(`/${xobjectName} Do`);
 		ops.push("Q");
 		const contentOps = ops.join("\n");