@pdfme/pdf-lib 1.17.3 → 1.18.3

package/es/api/PDFPage.js

@@ -1,21 +1,21 @@
-import { __assign } from "tslib";
-import { rgb } from "./colors";
-import { drawImage, drawLine, drawLinesOfText, drawPage, drawRectangle, drawSvgPath, drawEllipse, } from "./operations";
-import { popGraphicsState, pushGraphicsState, translate, LineCapStyle, scale, } from "./operators";
-import PDFDocument from "./PDFDocument";
-import PDFEmbeddedPage from "./PDFEmbeddedPage";
-import PDFFont from "./PDFFont";
-import PDFImage from "./PDFImage";
-import { BlendMode, } from "./PDFPageOptions";
-import { degrees, toDegrees } from "./rotations";
-import { StandardFonts } from "./StandardFonts";
-import { PDFContentStream, PDFName, PDFOperator, PDFPageLeaf, PDFRef, PDFDict, PDFArray, } from "../core";
-import { assertEachIs, assertIs, assertMultiple, assertOrUndefined, breakTextIntoLines, cleanText, rectanglesAreEqual, lineSplit, assertRangeOrUndefined, assertIsOneOfOrUndefined, } from "../utils";
+import { rgb } from './colors.js';
+import { drawImage, drawLine, drawLinesOfText, drawPage, drawRectangle, drawSvgPath, drawEllipse, } from './operations.js';
+import { popGraphicsState, pushGraphicsState, translate, LineCapStyle, scale, FillRule, } from './operators.js';
+import PDFDocument from './PDFDocument.js';
+import PDFEmbeddedPage from './PDFEmbeddedPage.js';
+import PDFFont from './PDFFont.js';
+import PDFImage from './PDFImage.js';
+import { BlendMode, } from './PDFPageOptions.js';
+import { degrees, toDegrees } from './rotations.js';
+import { StandardFonts } from './StandardFonts.js';
+import { PDFContentStream, PDFName, PDFOperator, PDFPageLeaf, PDFRef, PDFDict, PDFArray, } from '../core/index.js';
+import { assertEachIs, assertIs, assertMultiple, assertOrUndefined, breakTextIntoLines, cleanText, rectanglesAreEqual, lineSplit, assertRangeOrUndefined, assertIsOneOfOrUndefined, } from '../utils/index.js';
+import { drawSvg } from './svg.js';
 /**
  * Represents a single page of a [[PDFDocument]].
  */
-var PDFPage = /** @class */ (function () {
-    function PDFPage(leafNode, ref, doc) {
+export default class PDFPage {
+    constructor(leafNode, ref, doc) {
         this.fontSize = 24;
         this.fontColor = rgb(0, 0, 0);
         this.lineHeight = 24;
@@ -41,11 +41,11 @@ var PDFPage = /** @class */ (function () {
      * ```
      * @param angle The angle to rotate this page.
      */
-    PDFPage.prototype.setRotation = function (angle) {
-        var degreesAngle = toDegrees(angle);
+    setRotation(angle) {
+        const degreesAngle = toDegrees(angle);
         assertMultiple(degreesAngle, 'degreesAngle', 90);
         this.node.set(PDFName.of('Rotate'), this.doc.context.obj(degreesAngle));
-    };
+    }
     /**
      * Get this page's rotation angle in degrees. For example:
      * ```js
@@ -54,10 +54,10 @@ var PDFPage = /** @class */ (function () {
      * @returns The rotation angle of the page in degrees (always a multiple of
      *          90 degrees).
      */
-    PDFPage.prototype.getRotation = function () {
-        var Rotate = this.node.Rotate();
+    getRotation() {
+        const Rotate = this.node.Rotate();
         return degrees(Rotate ? Rotate.asNumber() : 0);
-    };
+    }
     /**
      * Resize this page by increasing or decreasing its width and height. For
      * example:
@@ -94,19 +94,19 @@ var PDFPage = /** @class */ (function () {
      * @param width The new width of the page.
      * @param height The new height of the page.
      */
-    PDFPage.prototype.setSize = function (width, height) {
+    setSize(width, height) {
         assertIs(width, 'width', ['number']);
         assertIs(height, 'height', ['number']);
-        var mediaBox = this.getMediaBox();
+        const mediaBox = this.getMediaBox();
         this.setMediaBox(mediaBox.x, mediaBox.y, width, height);
-        var cropBox = this.getCropBox();
-        var bleedBox = this.getBleedBox();
-        var trimBox = this.getTrimBox();
-        var artBox = this.getArtBox();
-        var hasCropBox = this.node.CropBox();
-        var hasBleedBox = this.node.BleedBox();
-        var hasTrimBox = this.node.TrimBox();
-        var hasArtBox = this.node.ArtBox();
+        const cropBox = this.getCropBox();
+        const bleedBox = this.getBleedBox();
+        const trimBox = this.getTrimBox();
+        const artBox = this.getArtBox();
+        const hasCropBox = this.node.CropBox();
+        const hasBleedBox = this.node.BleedBox();
+        const hasTrimBox = this.node.TrimBox();
+        const hasArtBox = this.node.ArtBox();
         if (hasCropBox && rectanglesAreEqual(cropBox, mediaBox)) {
             this.setCropBox(mediaBox.x, mediaBox.y, width, height);
         }
@@ -119,7 +119,7 @@ var PDFPage = /** @class */ (function () {
         if (hasArtBox && rectanglesAreEqual(artBox, mediaBox)) {
             this.setArtBox(mediaBox.x, mediaBox.y, width, height);
         }
-    };
+    }
     /**
      * Resize this page by increasing or decreasing its width. For example:
      * ```js
@@ -132,10 +132,10 @@ var PDFPage = /** @class */ (function () {
      *
      * @param width The new width of the page.
      */
-    PDFPage.prototype.setWidth = function (width) {
+    setWidth(width) {
         assertIs(width, 'width', ['number']);
         this.setSize(width, this.getSize().height);
-    };
+    }
     /**
      * Resize this page by increasing or decreasing its height. For example:
      * ```js
@@ -148,10 +148,10 @@ var PDFPage = /** @class */ (function () {
      *
      * @param height The new height of the page.
      */
-    PDFPage.prototype.setHeight = function (height) {
+    setHeight(height) {
         assertIs(height, 'height', ['number']);
         this.setSize(this.getSize().width, height);
-    };
+    }
     /**
      * Set the MediaBox of this page. For example:
      * ```js
@@ -169,14 +169,14 @@ var PDFPage = /** @class */ (function () {
      * @param width The width of the new MediaBox.
      * @param height The height of the new MediaBox.
      */
-    PDFPage.prototype.setMediaBox = function (x, y, width, height) {
+    setMediaBox(x, y, width, height) {
         assertIs(x, 'x', ['number']);
         assertIs(y, 'y', ['number']);
         assertIs(width, 'width', ['number']);
         assertIs(height, 'height', ['number']);
-        var mediaBox = this.doc.context.obj([x, y, x + width, y + height]);
+        const mediaBox = this.doc.context.obj([x, y, x + width, y + height]);
         this.node.set(PDFName.MediaBox, mediaBox);
-    };
+    }
     /**
      * Set the CropBox of this page. For example:
      * ```js
@@ -194,14 +194,14 @@ var PDFPage = /** @class */ (function () {
      * @param width The width of the new CropBox.
      * @param height The height of the new CropBox.
      */
-    PDFPage.prototype.setCropBox = function (x, y, width, height) {
+    setCropBox(x, y, width, height) {
         assertIs(x, 'x', ['number']);
         assertIs(y, 'y', ['number']);
         assertIs(width, 'width', ['number']);
         assertIs(height, 'height', ['number']);
-        var cropBox = this.doc.context.obj([x, y, x + width, y + height]);
+        const cropBox = this.doc.context.obj([x, y, x + width, y + height]);
         this.node.set(PDFName.CropBox, cropBox);
-    };
+    }
     /**
      * Set the BleedBox of this page. For example:
      * ```js
@@ -219,14 +219,14 @@ var PDFPage = /** @class */ (function () {
      * @param width The width of the new BleedBox.
      * @param height The height of the new BleedBox.
      */
-    PDFPage.prototype.setBleedBox = function (x, y, width, height) {
+    setBleedBox(x, y, width, height) {
         assertIs(x, 'x', ['number']);
         assertIs(y, 'y', ['number']);
         assertIs(width, 'width', ['number']);
         assertIs(height, 'height', ['number']);
-        var bleedBox = this.doc.context.obj([x, y, x + width, y + height]);
+        const bleedBox = this.doc.context.obj([x, y, x + width, y + height]);
         this.node.set(PDFName.BleedBox, bleedBox);
-    };
+    }
     /**
      * Set the TrimBox of this page. For example:
      * ```js
@@ -244,14 +244,14 @@ var PDFPage = /** @class */ (function () {
      * @param width The width of the new TrimBox.
      * @param height The height of the new TrimBox.
      */
-    PDFPage.prototype.setTrimBox = function (x, y, width, height) {
+    setTrimBox(x, y, width, height) {
         assertIs(x, 'x', ['number']);
         assertIs(y, 'y', ['number']);
         assertIs(width, 'width', ['number']);
         assertIs(height, 'height', ['number']);
-        var trimBox = this.doc.context.obj([x, y, x + width, y + height]);
+        const trimBox = this.doc.context.obj([x, y, x + width, y + height]);
         this.node.set(PDFName.TrimBox, trimBox);
-    };
+    }
     /**
      * Set the ArtBox of this page. For example:
      * ```js
@@ -269,14 +269,14 @@ var PDFPage = /** @class */ (function () {
      * @param width The width of the new ArtBox.
      * @param height The height of the new ArtBox.
      */
-    PDFPage.prototype.setArtBox = function (x, y, width, height) {
+    setArtBox(x, y, width, height) {
         assertIs(x, 'x', ['number']);
         assertIs(y, 'y', ['number']);
         assertIs(width, 'width', ['number']);
         assertIs(height, 'height', ['number']);
-        var artBox = this.doc.context.obj([x, y, x + width, y + height]);
+        const artBox = this.doc.context.obj([x, y, x + width, y + height]);
         this.node.set(PDFName.ArtBox, artBox);
-    };
+    }
     /**
      * Get this page's width and height. For example:
      * ```js
@@ -288,10 +288,10 @@ var PDFPage = /** @class */ (function () {
      *
      * @returns The width and height of the page.
      */
-    PDFPage.prototype.getSize = function () {
-        var _a = this.getMediaBox(), width = _a.width, height = _a.height;
-        return { width: width, height: height };
-    };
+    getSize() {
+        const { width, height } = this.getMediaBox();
+        return { width, height };
+    }
     /**
      * Get this page's width. For example:
      * ```js
@@ -302,9 +302,9 @@ var PDFPage = /** @class */ (function () {
      *
      * @returns The width of the page.
      */
-    PDFPage.prototype.getWidth = function () {
+    getWidth() {
         return this.getSize().width;
-    };
+    }
     /**
      * Get this page's height. For example:
      * ```js
@@ -315,9 +315,9 @@ var PDFPage = /** @class */ (function () {
      *
      * @returns The height of the page.
      */
-    PDFPage.prototype.getHeight = function () {
+    getHeight() {
         return this.getSize().height;
-    };
+    }
     /**
      * Get the rectangle defining this page's MediaBox. For example:
      * ```js
@@ -335,10 +335,10 @@ var PDFPage = /** @class */ (function () {
      * @returns An object defining the lower left corner of the MediaBox and its
      *          width & height.
      */
-    PDFPage.prototype.getMediaBox = function () {
-        var mediaBox = this.node.MediaBox();
+    getMediaBox() {
+        const mediaBox = this.node.MediaBox();
         return mediaBox.asRectangle();
-    };
+    }
     /**
      * Get the rectangle defining this page's CropBox. For example:
      * ```js
@@ -355,11 +355,11 @@ var PDFPage = /** @class */ (function () {
      * @returns An object defining the lower left corner of the CropBox and its
      *          width & height.
      */
-    PDFPage.prototype.getCropBox = function () {
+    getCropBox() {
         var _a;
-        var cropBox = this.node.CropBox();
+        const cropBox = this.node.CropBox();
         return (_a = cropBox === null || cropBox === void 0 ? void 0 : cropBox.asRectangle()) !== null && _a !== void 0 ? _a : this.getMediaBox();
-    };
+    }
     /**
      * Get the rectangle defining this page's BleedBox. For example:
      * ```js
@@ -377,11 +377,11 @@ var PDFPage = /** @class */ (function () {
      * @returns An object defining the lower left corner of the BleedBox and its
      *          width & height.
      */
-    PDFPage.prototype.getBleedBox = function () {
+    getBleedBox() {
         var _a;
-        var bleedBox = this.node.BleedBox();
+        const bleedBox = this.node.BleedBox();
         return (_a = bleedBox === null || bleedBox === void 0 ? void 0 : bleedBox.asRectangle()) !== null && _a !== void 0 ? _a : this.getCropBox();
-    };
+    }
     /**
      * Get the rectangle defining this page's TrimBox. For example:
      * ```js
@@ -398,11 +398,11 @@ var PDFPage = /** @class */ (function () {
      * @returns An object defining the lower left corner of the TrimBox and its
      *          width & height.
      */
-    PDFPage.prototype.getTrimBox = function () {
+    getTrimBox() {
         var _a;
-        var trimBox = this.node.TrimBox();
+        const trimBox = this.node.TrimBox();
         return (_a = trimBox === null || trimBox === void 0 ? void 0 : trimBox.asRectangle()) !== null && _a !== void 0 ? _a : this.getCropBox();
-    };
+    }
     /**
      * Get the rectangle defining this page's ArtBox. For example:
      * ```js
@@ -417,11 +417,11 @@ var PDFPage = /** @class */ (function () {
      * @returns An object defining the lower left corner of the ArtBox and its
      *          width & height.
      */
-    PDFPage.prototype.getArtBox = function () {
+    getArtBox() {
         var _a;
-        var artBox = this.node.ArtBox();
+        const artBox = this.node.ArtBox();
         return (_a = artBox === null || artBox === void 0 ? void 0 : artBox.asRectangle()) !== null && _a !== void 0 ? _a : this.getCropBox();
-    };
+    }
     /**
      * Translate this page's content to a new location on the page. This operation
      * is often useful after resizing the page with [[setSize]]. For example:
@@ -439,17 +439,17 @@ var PDFPage = /** @class */ (function () {
      * @param x The new position on the x-axis for this page's content.
      * @param y The new position on the y-axis for this page's content.
      */
-    PDFPage.prototype.translateContent = function (x, y) {
+    translateContent(x, y) {
         assertIs(x, 'x', ['number']);
         assertIs(y, 'y', ['number']);
         this.node.normalize();
         this.getContentStream();
-        var start = this.createContentStream(pushGraphicsState(), translate(x, y));
-        var startRef = this.doc.context.register(start);
-        var end = this.createContentStream(popGraphicsState());
-        var endRef = this.doc.context.register(end);
+        const start = this.createContentStream(pushGraphicsState(), translate(x, y));
+        const startRef = this.doc.context.register(start);
+        const end = this.createContentStream(popGraphicsState());
+        const endRef = this.doc.context.register(end);
         this.node.wrapContentStreams(startRef, endRef);
-    };
+    }
     /**
      * Scale the size, content, and annotations of a page.
      *
@@ -463,13 +463,13 @@ var PDFPage = /** @class */ (function () {
      * @param y The factor by which the height for the page should be scaled
      *          (e.g. `2.0` is 200%).
      */
-    PDFPage.prototype.scale = function (x, y) {
+    scale(x, y) {
         assertIs(x, 'x', ['number']);
         assertIs(y, 'y', ['number']);
         this.setSize(this.getWidth() * x, this.getHeight() * y);
         this.scaleContent(x, y);
         this.scaleAnnotations(x, y);
-    };
+    }
     /**
      * Scale the content of a page. This is useful after resizing an existing
      * page. This scales only the content, not the annotations.
@@ -488,17 +488,17 @@ var PDFPage = /** @class */ (function () {
      * @param y The factor by which the y-axis for the content should be scaled
      *          (e.g. `2.0` is 200%).
      */
-    PDFPage.prototype.scaleContent = function (x, y) {
+    scaleContent(x, y) {
         assertIs(x, 'x', ['number']);
         assertIs(y, 'y', ['number']);
         this.node.normalize();
         this.getContentStream();
-        var start = this.createContentStream(pushGraphicsState(), scale(x, y));
-        var startRef = this.doc.context.register(start);
-        var end = this.createContentStream(popGraphicsState());
-        var endRef = this.doc.context.register(end);
+        const start = this.createContentStream(pushGraphicsState(), scale(x, y));
+        const startRef = this.doc.context.register(start);
+        const end = this.createContentStream(popGraphicsState());
+        const endRef = this.doc.context.register(end);
         this.node.wrapContentStreams(startRef, endRef);
-    };
+    }
     /**
      * Scale the annotations of a page. This is useful if you want to scale a
      * page with comments or other annotations.
@@ -515,18 +515,18 @@ var PDFPage = /** @class */ (function () {
      * @param y The factor by which the y-axis for the annotations should be
      *          scaled (e.g. `2.0` is 200%).
      */
-    PDFPage.prototype.scaleAnnotations = function (x, y) {
+    scaleAnnotations(x, y) {
         assertIs(x, 'x', ['number']);
         assertIs(y, 'y', ['number']);
-        var annots = this.node.Annots();
+        const annots = this.node.Annots();
         if (!annots)
             return;
-        for (var idx = 0; idx < annots.size(); idx++) {
-            var annot = annots.lookup(idx);
+        for (let idx = 0; idx < annots.size(); idx++) {
+            const annot = annots.lookup(idx);
             if (annot instanceof PDFDict)
                 this.scaleAnnot(annot, x, y);
         }
-    };
+    }
     /**
      * Reset the x and y coordinates of this page to `(0, 0)`. This operation is
      * often useful after calling [[translateContent]]. For example:
@@ -544,11 +544,11 @@ var PDFPage = /** @class */ (function () {
      * page.drawText('I am not shifted')
      * ```
      */
-    PDFPage.prototype.resetPosition = function () {
+    resetPosition() {
         this.getContentStream(false);
         this.x = 0;
         this.y = 0;
-    };
+    }
     /**
      * Choose a default font for this page. The default font will be used whenever
      * text is drawn on this page and no font is specified. For example:
@@ -569,12 +569,12 @@ var PDFPage = /** @class */ (function () {
      * ```
      * @param font The default font to be used when drawing text on this page.
      */
-    PDFPage.prototype.setFont = function (font) {
+    setFont(font) {
         // TODO: Reuse image Font name if we've already added this image to Resources.Fonts
         assertIs(font, 'font', [[PDFFont, 'PDFFont']]);
         this.font = font;
         this.fontKey = this.node.newFontDictionary(this.font.name, this.font.ref);
-    };
+    }
     /**
      * Choose a default font size for this page. The default font size will be
      * used whenever text is drawn on this page and no font size is specified.
@@ -589,10 +589,10 @@ var PDFPage = /** @class */ (function () {
      * @param fontSize The default font size to be used when drawing text on this
      *                 page.
      */
-    PDFPage.prototype.setFontSize = function (fontSize) {
+    setFontSize(fontSize) {
         assertIs(fontSize, 'fontSize', ['number']);
         this.fontSize = fontSize;
-    };
+    }
     /**
      * Choose a default font color for this page. The default font color will be
      * used whenever text is drawn on this page and no font color is specified.
@@ -609,10 +609,10 @@ var PDFPage = /** @class */ (function () {
      * @param fontColor The default font color to be used when drawing text on
      *                  this page.
      */
-    PDFPage.prototype.setFontColor = function (fontColor) {
+    setFontColor(fontColor) {
         assertIs(fontColor, 'fontColor', [[Object, 'Color']]);
         this.fontColor = fontColor;
-    };
+    }
     /**
      * Choose a default line height for this page. The default line height will be
      * used whenever text is drawn on this page and no line height is specified.
@@ -629,10 +629,10 @@ var PDFPage = /** @class */ (function () {
      * @param lineHeight The default line height to be used when drawing text on
      *                   this page.
      */
-    PDFPage.prototype.setLineHeight = function (lineHeight) {
+    setLineHeight(lineHeight) {
         assertIs(lineHeight, 'lineHeight', ['number']);
         this.lineHeight = lineHeight;
-    };
+    }
     /**
      * Get the default position of this page. For example:
      * ```js
@@ -640,9 +640,9 @@ var PDFPage = /** @class */ (function () {
      * ```
      * @returns The default position of the page.
      */
-    PDFPage.prototype.getPosition = function () {
+    getPosition() {
         return { x: this.x, y: this.y };
-    };
+    }
     /**
      * Get the default x coordinate of this page. For example:
      * ```js
@@ -650,9 +650,9 @@ var PDFPage = /** @class */ (function () {
      * ```
      * @returns The default x coordinate of the page.
      */
-    PDFPage.prototype.getX = function () {
+    getX() {
         return this.x;
-    };
+    }
     /**
      * Get the default y coordinate of this page. For example:
      * ```js
@@ -660,9 +660,9 @@ var PDFPage = /** @class */ (function () {
      * ```
      * @returns The default y coordinate of the page.
      */
-    PDFPage.prototype.getY = function () {
+    getY() {
         return this.y;
-    };
+    }
     /**
      * Change the default position of this page. For example:
      * ```js
@@ -678,12 +678,12 @@ var PDFPage = /** @class */ (function () {
      * @param x The new default position on the x-axis for this page.
      * @param y The new default position on the y-axis for this page.
      */
-    PDFPage.prototype.moveTo = function (x, y) {
+    moveTo(x, y) {
         assertIs(x, 'x', ['number']);
         assertIs(y, 'y', ['number']);
         this.x = x;
         this.y = y;
-    };
+    }
     /**
      * Change the default position of this page to be further down the y-axis.
      * For example:
@@ -697,10 +697,10 @@ var PDFPage = /** @class */ (function () {
      * @param yDecrease The amount by which the page's default position along the
      *                  y-axis should be decreased.
      */
-    PDFPage.prototype.moveDown = function (yDecrease) {
+    moveDown(yDecrease) {
         assertIs(yDecrease, 'yDecrease', ['number']);
         this.y -= yDecrease;
-    };
+    }
     /**
      * Change the default position of this page to be further up the y-axis.
      * For example:
@@ -714,10 +714,10 @@ var PDFPage = /** @class */ (function () {
      * @param yIncrease The amount by which the page's default position along the
      *                  y-axis should be increased.
      */
-    PDFPage.prototype.moveUp = function (yIncrease) {
+    moveUp(yIncrease) {
         assertIs(yIncrease, 'yIncrease', ['number']);
         this.y += yIncrease;
-    };
+    }
     /**
      * Change the default position of this page to be further left on the x-axis.
      * For example:
@@ -731,10 +731,10 @@ var PDFPage = /** @class */ (function () {
      * @param xDecrease The amount by which the page's default position along the
      *                  x-axis should be decreased.
      */
-    PDFPage.prototype.moveLeft = function (xDecrease) {
+    moveLeft(xDecrease) {
         assertIs(xDecrease, 'xDecrease', ['number']);
         this.x -= xDecrease;
-    };
+    }
     /**
      * Change the default position of this page to be further right on the y-axis.
      * For example:
@@ -748,10 +748,10 @@ var PDFPage = /** @class */ (function () {
      * @param xIncrease The amount by which the page's default position along the
      *                  x-axis should be increased.
      */
-    PDFPage.prototype.moveRight = function (xIncrease) {
+    moveRight(xIncrease) {
         assertIs(xIncrease, 'xIncrease', ['number']);
         this.x += xIncrease;
-    };
+    }
     /**
      * Push one or more operators to the end of this page's current content
      * stream. For example:
@@ -781,15 +781,11 @@ var PDFPage = /** @class */ (function () {
      * ```
      * @param operator The operators to be pushed.
      */
-    PDFPage.prototype.pushOperators = function () {
-        var operator = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            operator[_i] = arguments[_i];
-        }
+    pushOperators(...operator) {
         assertEachIs(operator, 'operator', [[PDFOperator, 'PDFOperator']]);
-        var contentStream = this.getContentStream();
-        contentStream.push.apply(contentStream, operator);
-    };
+        const contentStream = this.getContentStream();
+        contentStream.push(...operator);
+    }
     /**
      * Draw one or more lines of text on this page. For example:
      * ```js
@@ -827,9 +823,8 @@ var PDFPage = /** @class */ (function () {
      * @param text The text to be drawn.
      * @param options The options to be used when drawing the text.
      */
-    PDFPage.prototype.drawText = function (text, options) {
+    drawText(text, options = {}) {
         var _a, _b, _c, _d, _e, _f, _g;
-        if (options === void 0) { options = {}; }
         assertIs(text, 'text', ['string']);
         assertOrUndefined(options.color, 'options.color', [[Object, 'Color']]);
         assertRangeOrUndefined(options.opacity, 'opacity.opacity', 0, 1);
@@ -844,23 +839,23 @@ var PDFPage = /** @class */ (function () {
         assertOrUndefined(options.maxWidth, 'options.maxWidth', ['number']);
         assertOrUndefined(options.wordBreaks, 'options.wordBreaks', [Array]);
         assertIsOneOfOrUndefined(options.blendMode, 'options.blendMode', BlendMode);
-        var _h = this.setOrEmbedFont(options.font), oldFont = _h.oldFont, newFont = _h.newFont, newFontKey = _h.newFontKey;
-        var fontSize = options.size || this.fontSize;
-        var wordBreaks = options.wordBreaks || this.doc.defaultWordBreaks;
-        var textWidth = function (t) { return newFont.widthOfTextAtSize(t, fontSize); };
-        var lines = options.maxWidth === undefined
+        const { oldFont, newFont, newFontKey } = this.setOrEmbedFont(options.font);
+        const fontSize = options.size || this.fontSize;
+        const wordBreaks = options.wordBreaks || this.doc.defaultWordBreaks;
+        const textWidth = (t) => newFont.widthOfTextAtSize(t, fontSize);
+        const lines = options.maxWidth === undefined
             ? lineSplit(cleanText(text))
             : breakTextIntoLines(text, wordBreaks, options.maxWidth, textWidth);
-        var encodedLines = new Array(lines.length);
-        for (var idx = 0, len = lines.length; idx < len; idx++) {
+        const encodedLines = new Array(lines.length);
+        for (let idx = 0, len = lines.length; idx < len; idx++) {
             encodedLines[idx] = newFont.encodeText(lines[idx]);
         }
-        var graphicsStateKey = this.maybeEmbedGraphicsState({
+        const graphicsStateKey = this.maybeEmbedGraphicsState({
             opacity: options.opacity,
             blendMode: options.blendMode,
         });
-        var contentStream = this.getContentStream();
-        contentStream.push.apply(contentStream, drawLinesOfText(encodedLines, {
+        const contentStream = this.getContentStream();
+        contentStream.push(...drawLinesOfText(encodedLines, {
             color: (_a = options.color) !== null && _a !== void 0 ? _a : this.fontColor,
             font: newFontKey,
             size: fontSize,
@@ -871,6 +866,8 @@ var PDFPage = /** @class */ (function () {
             y: (_f = options.y) !== null && _f !== void 0 ? _f : this.y,
             lineHeight: (_g = options.lineHeight) !== null && _g !== void 0 ? _g : this.lineHeight,
             graphicsState: graphicsStateKey,
+            matrix: options.matrix,
+            clipSpaces: options.clipSpaces
         }));
         if (options.font) {
             if (oldFont)
@@ -878,7 +875,7 @@ var PDFPage = /** @class */ (function () {
             else
                 this.resetFont();
         }
-    };
+    }
     /**
      * Draw an image on this page. For example:
      * ```js
@@ -904,9 +901,8 @@ var PDFPage = /** @class */ (function () {
      * @param image The image to be drawn.
      * @param options The options to be used when drawing the image.
      */
-    PDFPage.prototype.drawImage = function (image, options) {
+    drawImage(image, options = {}) {
         var _a, _b, _c, _d, _e, _f, _g;
-        if (options === void 0) { options = {}; }
         // TODO: Reuse image XObject name if we've already added this image to Resources.XObjects
         assertIs(image, 'image', [[PDFImage, 'PDFImage']]);
         assertOrUndefined(options.x, 'options.x', ['number']);
@@ -918,13 +914,13 @@ var PDFPage = /** @class */ (function () {
         assertOrUndefined(options.ySkew, 'options.ySkew', [[Object, 'Rotation']]);
         assertRangeOrUndefined(options.opacity, 'opacity.opacity', 0, 1);
         assertIsOneOfOrUndefined(options.blendMode, 'options.blendMode', BlendMode);
-        var xObjectKey = this.node.newXObject('Image', image.ref);
-        var graphicsStateKey = this.maybeEmbedGraphicsState({
+        const xObjectKey = this.node.newXObject('Image', image.ref);
+        const graphicsStateKey = this.maybeEmbedGraphicsState({
             opacity: options.opacity,
             blendMode: options.blendMode,
         });
-        var contentStream = this.getContentStream();
-        contentStream.push.apply(contentStream, drawImage(xObjectKey, {
+        const contentStream = this.getContentStream();
+        contentStream.push(...drawImage(xObjectKey, {
             x: (_a = options.x) !== null && _a !== void 0 ? _a : this.x,
             y: (_b = options.y) !== null && _b !== void 0 ? _b : this.y,
             width: (_c = options.width) !== null && _c !== void 0 ? _c : image.size().width,
@@ -933,8 +929,10 @@ var PDFPage = /** @class */ (function () {
             xSkew: (_f = options.xSkew) !== null && _f !== void 0 ? _f : degrees(0),
             ySkew: (_g = options.ySkew) !== null && _g !== void 0 ? _g : degrees(0),
             graphicsState: graphicsStateKey,
+            matrix: options.matrix,
+            clipSpaces: options.clipSpaces
         }));
-    };
+    }
     /**
      * Draw an embedded PDF page on this page. For example:
      * ```js
@@ -967,9 +965,8 @@ var PDFPage = /** @class */ (function () {
      * @param embeddedPage The embedded page to be drawn.
      * @param options The options to be used when drawing the embedded page.
      */
-    PDFPage.prototype.drawPage = function (embeddedPage, options) {
+    drawPage(embeddedPage, options = {}) {
         var _a, _b, _c, _d, _e;
-        if (options === void 0) { options = {}; }
         // TODO: Reuse embeddedPage XObject name if we've already added this embeddedPage to Resources.XObjects
         assertIs(embeddedPage, 'embeddedPage', [
             [PDFEmbeddedPage, 'PDFEmbeddedPage'],
@@ -985,31 +982,31 @@ var PDFPage = /** @class */ (function () {
         assertOrUndefined(options.ySkew, 'options.ySkew', [[Object, 'Rotation']]);
         assertRangeOrUndefined(options.opacity, 'opacity.opacity', 0, 1);
         assertIsOneOfOrUndefined(options.blendMode, 'options.blendMode', BlendMode);
-        var xObjectKey = this.node.newXObject('EmbeddedPdfPage', embeddedPage.ref);
-        var graphicsStateKey = this.maybeEmbedGraphicsState({
+        const xObjectKey = this.node.newXObject('EmbeddedPdfPage', embeddedPage.ref);
+        const graphicsStateKey = this.maybeEmbedGraphicsState({
             opacity: options.opacity,
             blendMode: options.blendMode,
         });
         // prettier-ignore
-        var xScale = (options.width !== undefined ? options.width / embeddedPage.width
+        const xScale = (options.width !== undefined ? options.width / embeddedPage.width
             : options.xScale !== undefined ? options.xScale
                 : 1);
         // prettier-ignore
-        var yScale = (options.height !== undefined ? options.height / embeddedPage.height
+        const yScale = (options.height !== undefined ? options.height / embeddedPage.height
             : options.yScale !== undefined ? options.yScale
                 : 1);
-        var contentStream = this.getContentStream();
-        contentStream.push.apply(contentStream, drawPage(xObjectKey, {
+        const contentStream = this.getContentStream();
+        contentStream.push(...drawPage(xObjectKey, {
             x: (_a = options.x) !== null && _a !== void 0 ? _a : this.x,
             y: (_b = options.y) !== null && _b !== void 0 ? _b : this.y,
-            xScale: xScale,
-            yScale: yScale,
+            xScale,
+            yScale,
             rotate: (_c = options.rotate) !== null && _c !== void 0 ? _c : degrees(0),
             xSkew: (_d = options.xSkew) !== null && _d !== void 0 ? _d : degrees(0),
             ySkew: (_e = options.ySkew) !== null && _e !== void 0 ? _e : degrees(0),
             graphicsState: graphicsStateKey,
         }));
-    };
+    }
     /**
      * Draw an SVG path on this page. For example:
      * ```js
@@ -1047,9 +1044,8 @@ var PDFPage = /** @class */ (function () {
      * @param path The SVG path to be drawn.
      * @param options The options to be used when drawing the SVG path.
      */
-    PDFPage.prototype.drawSvgPath = function (path, options) {
+    drawSvgPath(path, options = {}) {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-        if (options === void 0) { options = {}; }
         assertIs(path, 'path', ['string']);
         assertOrUndefined(options.x, 'options.x', ['number']);
         assertOrUndefined(options.y, 'options.y', ['number']);
@@ -1070,7 +1066,8 @@ var PDFPage = /** @class */ (function () {
         assertIsOneOfOrUndefined(options.borderLineCap, 'options.borderLineCap', LineCapStyle);
         assertRangeOrUndefined(options.borderOpacity, 'options.borderOpacity', 0, 1);
         assertIsOneOfOrUndefined(options.blendMode, 'options.blendMode', BlendMode);
-        var graphicsStateKey = this.maybeEmbedGraphicsState({
+        assertIsOneOfOrUndefined(options.fillRule, 'options.fillRule', FillRule);
+        const graphicsStateKey = this.maybeEmbedGraphicsState({
             opacity: options.opacity,
             borderOpacity: options.borderOpacity,
             blendMode: options.blendMode,
@@ -1078,8 +1075,8 @@ var PDFPage = /** @class */ (function () {
         if (!('color' in options) && !('borderColor' in options)) {
             options.borderColor = rgb(0, 0, 0);
         }
-        var contentStream = this.getContentStream();
-        contentStream.push.apply(contentStream, drawSvgPath(path, {
+        const contentStream = this.getContentStream();
+        contentStream.push(...drawSvgPath(path, {
             x: (_a = options.x) !== null && _a !== void 0 ? _a : this.x,
             y: (_b = options.y) !== null && _b !== void 0 ? _b : this.y,
             scale: options.scale,
@@ -1091,8 +1088,11 @@ var PDFPage = /** @class */ (function () {
             borderDashPhase: (_h = options.borderDashPhase) !== null && _h !== void 0 ? _h : undefined,
             borderLineCap: (_j = options.borderLineCap) !== null && _j !== void 0 ? _j : undefined,
             graphicsState: graphicsStateKey,
+            fillRule: options.fillRule,
+            matrix: options.matrix,
+            clipSpaces: options.clipSpaces
         }));
-    };
+    }
     /**
      * Draw a line on this page. For example:
      * ```js
@@ -1108,7 +1108,7 @@ var PDFPage = /** @class */ (function () {
      * ```
      * @param options The options to be used when drawing the line.
      */
-    PDFPage.prototype.drawLine = function (options) {
+    drawLine(options) {
         var _a, _b, _c, _d, _e;
         assertIs(options.start, 'options.start', [
             [Object, '{ x: number, y: number }'],
@@ -1127,15 +1127,15 @@ var PDFPage = /** @class */ (function () {
         assertIsOneOfOrUndefined(options.lineCap, 'options.lineCap', LineCapStyle);
         assertRangeOrUndefined(options.opacity, 'opacity.opacity', 0, 1);
         assertIsOneOfOrUndefined(options.blendMode, 'options.blendMode', BlendMode);
-        var graphicsStateKey = this.maybeEmbedGraphicsState({
+        const graphicsStateKey = this.maybeEmbedGraphicsState({
             borderOpacity: options.opacity,
             blendMode: options.blendMode,
         });
         if (!('color' in options)) {
             options.color = rgb(0, 0, 0);
         }
-        var contentStream = this.getContentStream();
-        contentStream.push.apply(contentStream, drawLine({
+        const contentStream = this.getContentStream();
+        contentStream.push(...drawLine({
             start: options.start,
             end: options.end,
             thickness: (_a = options.thickness) !== null && _a !== void 0 ? _a : 1,
@@ -1144,8 +1144,10 @@ var PDFPage = /** @class */ (function () {
             dashPhase: (_d = options.dashPhase) !== null && _d !== void 0 ? _d : undefined,
             lineCap: (_e = options.lineCap) !== null && _e !== void 0 ? _e : undefined,
             graphicsState: graphicsStateKey,
+            matrix: options.matrix,
+            clipSpaces: options.clipSpaces,
         }));
-    };
+    }
     /**
      * Draw a rectangle on this page. For example:
      * ```js
@@ -1166,9 +1168,8 @@ var PDFPage = /** @class */ (function () {
      * ```
      * @param options The options to be used when drawing the rectangle.
      */
-    PDFPage.prototype.drawRectangle = function (options) {
+    drawRectangle(options = {}) {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
-        if (options === void 0) { options = {}; }
         assertOrUndefined(options.x, 'options.x', ['number']);
         assertOrUndefined(options.y, 'options.y', ['number']);
         assertOrUndefined(options.width, 'options.width', ['number']);
@@ -1191,7 +1192,7 @@ var PDFPage = /** @class */ (function () {
         assertIsOneOfOrUndefined(options.borderLineCap, 'options.borderLineCap', LineCapStyle);
         assertRangeOrUndefined(options.borderOpacity, 'options.borderOpacity', 0, 1);
         assertIsOneOfOrUndefined(options.blendMode, 'options.blendMode', BlendMode);
-        var graphicsStateKey = this.maybeEmbedGraphicsState({
+        const graphicsStateKey = this.maybeEmbedGraphicsState({
             opacity: options.opacity,
             borderOpacity: options.borderOpacity,
             blendMode: options.blendMode,
@@ -1199,8 +1200,8 @@ var PDFPage = /** @class */ (function () {
         if (!('color' in options) && !('borderColor' in options)) {
             options.color = rgb(0, 0, 0);
         }
-        var contentStream = this.getContentStream();
-        contentStream.push.apply(contentStream, drawRectangle({
+        const contentStream = this.getContentStream();
+        contentStream.push(...drawRectangle({
             x: (_a = options.x) !== null && _a !== void 0 ? _a : this.x,
             y: (_b = options.y) !== null && _b !== void 0 ? _b : this.y,
             width: (_c = options.width) !== null && _c !== void 0 ? _c : 150,
@@ -1215,8 +1216,10 @@ var PDFPage = /** @class */ (function () {
             borderDashPhase: (_m = options.borderDashPhase) !== null && _m !== void 0 ? _m : undefined,
             graphicsState: graphicsStateKey,
             borderLineCap: (_o = options.borderLineCap) !== null && _o !== void 0 ? _o : undefined,
+            matrix: options.matrix,
+            clipSpaces: options.clipSpaces,
         }));
-    };
+    }
     /**
      * Draw a square on this page. For example:
      * ```js
@@ -1236,12 +1239,11 @@ var PDFPage = /** @class */ (function () {
      * ```
      * @param options The options to be used when drawing the square.
      */
-    PDFPage.prototype.drawSquare = function (options) {
-        if (options === void 0) { options = {}; }
-        var size = options.size;
+    drawSquare(options = {}) {
+        const { size } = options;
         assertOrUndefined(size, 'size', ['number']);
-        this.drawRectangle(__assign(__assign({}, options), { width: size, height: size }));
-    };
+        this.drawRectangle({ ...options, width: size, height: size });
+    }
     /**
      * Draw an ellipse on this page. For example:
      * ```js
@@ -1261,9 +1263,8 @@ var PDFPage = /** @class */ (function () {
      * ```
      * @param options The options to be used when drawing the ellipse.
      */
-    PDFPage.prototype.drawEllipse = function (options) {
+    drawEllipse(options = {}) {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
-        if (options === void 0) { options = {}; }
         assertOrUndefined(options.x, 'options.x', ['number']);
         assertOrUndefined(options.y, 'options.y', ['number']);
         assertOrUndefined(options.xScale, 'options.xScale', ['number']);
@@ -1284,7 +1285,7 @@ var PDFPage = /** @class */ (function () {
         ]);
         assertIsOneOfOrUndefined(options.borderLineCap, 'options.borderLineCap', LineCapStyle);
         assertIsOneOfOrUndefined(options.blendMode, 'options.blendMode', BlendMode);
-        var graphicsStateKey = this.maybeEmbedGraphicsState({
+        const graphicsStateKey = this.maybeEmbedGraphicsState({
             opacity: options.opacity,
             borderOpacity: options.borderOpacity,
             blendMode: options.blendMode,
@@ -1292,8 +1293,8 @@ var PDFPage = /** @class */ (function () {
         if (!('color' in options) && !('borderColor' in options)) {
             options.color = rgb(0, 0, 0);
         }
-        var contentStream = this.getContentStream();
-        contentStream.push.apply(contentStream, drawEllipse({
+        const contentStream = this.getContentStream();
+        contentStream.push(...drawEllipse({
             x: (_a = options.x) !== null && _a !== void 0 ? _a : this.x,
             y: (_b = options.y) !== null && _b !== void 0 ? _b : this.y,
             xScale: (_c = options.xScale) !== null && _c !== void 0 ? _c : 100,
@@ -1306,8 +1307,10 @@ var PDFPage = /** @class */ (function () {
             borderDashPhase: (_k = options.borderDashPhase) !== null && _k !== void 0 ? _k : undefined,
             borderLineCap: (_l = options.borderLineCap) !== null && _l !== void 0 ? _l : undefined,
             graphicsState: graphicsStateKey,
+            matrix: options.matrix,
+            clipSpaces: options.clipSpaces,
         }));
-    };
+    }
     /**
      * Draw a circle on this page. For example:
      * ```js
@@ -1326,115 +1329,131 @@ var PDFPage = /** @class */ (function () {
      * ```
      * @param options The options to be used when drawing the ellipse.
      */
-    PDFPage.prototype.drawCircle = function (options) {
-        if (options === void 0) { options = {}; }
-        var _a = options.size, size = _a === void 0 ? 100 : _a;
+    drawCircle(options = {}) {
+        const { size = 100 } = options;
         assertOrUndefined(size, 'size', ['number']);
-        this.drawEllipse(__assign(__assign({}, options), { xScale: size, yScale: size }));
-    };
-    PDFPage.prototype.setOrEmbedFont = function (font) {
-        var oldFont = this.font;
-        var oldFontKey = this.fontKey;
+        this.drawEllipse({ ...options, xScale: size, yScale: size });
+    }
+    setOrEmbedFont(font) {
+        const oldFont = this.font;
+        const oldFontKey = this.fontKey;
         if (font)
             this.setFont(font);
         else
             this.getFont();
-        var newFont = this.font;
-        var newFontKey = this.fontKey;
-        return { oldFont: oldFont, oldFontKey: oldFontKey, newFont: newFont, newFontKey: newFontKey };
-    };
-    PDFPage.prototype.getFont = function () {
+        const newFont = this.font;
+        const newFontKey = this.fontKey;
+        return { oldFont, oldFontKey, newFont, newFontKey };
+    }
+    /**
+     * Draw an SVG on this page. For example:
+     * ```js
+     * const svg = '<svg><path d="M 0,20 L 100,160 Q 130,200 150,120 C 190,-40 200,200 300,150 L 400,90"></path></svg>'
+     *
+     * // Draw svg
+     * page.drawSvg(svg, { x: 25, y: 75 })
+     * ```
+     * @param svg The SVG to be drawn.
+     * @param options The options to be used when drawing the SVG.
+     */
+    async drawSvg(svg, options = {}) {
+        var _a, _b;
+        assertIs(svg, 'svg', ['string']);
+        assertOrUndefined(options.x, 'options.x', ['number']);
+        assertOrUndefined(options.y, 'options.y', ['number']);
+        assertOrUndefined(options.width, 'options.width', ['number']);
+        assertOrUndefined(options.height, 'options.height', ['number']);
+        await drawSvg(this, svg, {
+            x: (_a = options.x) !== null && _a !== void 0 ? _a : this.x,
+            y: (_b = options.y) !== null && _b !== void 0 ? _b : this.y,
+            fonts: options.fonts,
+            width: options.width,
+            height: options.height,
+        });
+    }
+    getFont() {
         if (!this.font || !this.fontKey) {
-            var font = this.doc.embedStandardFont(StandardFonts.Helvetica);
+            const font = this.doc.embedStandardFont(StandardFonts.Helvetica);
             this.setFont(font);
         }
         return [this.font, this.fontKey];
-    };
-    PDFPage.prototype.resetFont = function () {
+    }
+    resetFont() {
         this.font = undefined;
         this.fontKey = undefined;
-    };
-    PDFPage.prototype.getContentStream = function (useExisting) {
-        if (useExisting === void 0) { useExisting = true; }
+    }
+    getContentStream(useExisting = true) {
         if (useExisting && this.contentStream)
             return this.contentStream;
         this.contentStream = this.createContentStream();
         this.contentStreamRef = this.doc.context.register(this.contentStream);
         this.node.addContentStream(this.contentStreamRef);
         return this.contentStream;
-    };
-    PDFPage.prototype.createContentStream = function () {
-        var operators = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            operators[_i] = arguments[_i];
-        }
-        var dict = this.doc.context.obj({});
-        var contentStream = PDFContentStream.of(dict, operators);
+    }
+    createContentStream(...operators) {
+        const dict = this.doc.context.obj({});
+        const contentStream = PDFContentStream.of(dict, operators);
         return contentStream;
-    };
-    PDFPage.prototype.maybeEmbedGraphicsState = function (options) {
-        var opacity = options.opacity, borderOpacity = options.borderOpacity, blendMode = options.blendMode;
+    }
+    maybeEmbedGraphicsState(options) {
+        const { opacity, borderOpacity, blendMode } = options;
         if (opacity === undefined &&
             borderOpacity === undefined &&
             blendMode === undefined) {
             return undefined;
         }
-        var graphicsState = this.doc.context.obj({
+        const graphicsState = this.doc.context.obj({
             Type: 'ExtGState',
             ca: opacity,
             CA: borderOpacity,
             BM: blendMode,
         });
-        var key = this.node.newExtGState('GS', graphicsState);
+        const key = this.node.newExtGState('GS', graphicsState);
         return key;
-    };
-    PDFPage.prototype.scaleAnnot = function (annot, x, y) {
-        var selectors = ['RD', 'CL', 'Vertices', 'QuadPoints', 'L', 'Rect'];
-        for (var idx = 0, len = selectors.length; idx < len; idx++) {
-            var list = annot.lookup(PDFName.of(selectors[idx]));
+    }
+    scaleAnnot(annot, x, y) {
+        const selectors = ['RD', 'CL', 'Vertices', 'QuadPoints', 'L', 'Rect'];
+        for (let idx = 0, len = selectors.length; idx < len; idx++) {
+            const list = annot.lookup(PDFName.of(selectors[idx]));
             if (list instanceof PDFArray)
                 list.scalePDFNumbers(x, y);
         }
-        var inkLists = annot.lookup(PDFName.of('InkList'));
+        const inkLists = annot.lookup(PDFName.of('InkList'));
         if (inkLists instanceof PDFArray) {
-            for (var idx = 0, len = inkLists.size(); idx < len; idx++) {
-                var arr = inkLists.lookup(idx);
+            for (let idx = 0, len = inkLists.size(); idx < len; idx++) {
+                const arr = inkLists.lookup(idx);
                 if (arr instanceof PDFArray)
                     arr.scalePDFNumbers(x, y);
             }
         }
-    };
-    /**
-     * > **NOTE:** You probably don't want to call this method directly. Instead,
-     * > consider using the [[PDFDocument.addPage]] and [[PDFDocument.insertPage]]
-     * > methods, which can create instances of [[PDFPage]] for you.
-     *
-     * Create an instance of [[PDFPage]] from an existing leaf node.
-     *
-     * @param leafNode The leaf node to be wrapped.
-     * @param ref The unique reference for the page.
-     * @param doc The document to which the page will belong.
-     */
-    PDFPage.of = function (leafNode, ref, doc) {
-        return new PDFPage(leafNode, ref, doc);
-    };
-    /**
-     * > **NOTE:** You probably don't want to call this method directly. Instead,
-     * > consider using the [[PDFDocument.addPage]] and [[PDFDocument.insertPage]]
-     * > methods, which can create instances of [[PDFPage]] for you.
-     *
-     * Create an instance of [[PDFPage]].
-     *
-     * @param doc The document to which the page will belong.
-     */
-    PDFPage.create = function (doc) {
-        assertIs(doc, 'doc', [[PDFDocument, 'PDFDocument']]);
-        var dummyRef = PDFRef.of(-1);
-        var pageLeaf = PDFPageLeaf.withContextAndParent(doc.context, dummyRef);
-        var pageRef = doc.context.register(pageLeaf);
-        return new PDFPage(pageLeaf, pageRef, doc);
-    };
-    return PDFPage;
-}());
-export default PDFPage;
+    }
+}
+/**
+ * > **NOTE:** You probably don't want to call this method directly. Instead,
+ * > consider using the [[PDFDocument.addPage]] and [[PDFDocument.insertPage]]
+ * > methods, which can create instances of [[PDFPage]] for you.
+ *
+ * Create an instance of [[PDFPage]] from an existing leaf node.
+ *
+ * @param leafNode The leaf node to be wrapped.
+ * @param ref The unique reference for the page.
+ * @param doc The document to which the page will belong.
+ */
+PDFPage.of = (leafNode, ref, doc) => new PDFPage(leafNode, ref, doc);
+/**
+ * > **NOTE:** You probably don't want to call this method directly. Instead,
+ * > consider using the [[PDFDocument.addPage]] and [[PDFDocument.insertPage]]
+ * > methods, which can create instances of [[PDFPage]] for you.
+ *
+ * Create an instance of [[PDFPage]].
+ *
+ * @param doc The document to which the page will belong.
+ */
+PDFPage.create = (doc) => {
+    assertIs(doc, 'doc', [[PDFDocument, 'PDFDocument']]);
+    const dummyRef = PDFRef.of(-1);
+    const pageLeaf = PDFPageLeaf.withContextAndParent(doc.context, dummyRef);
+    const pageRef = doc.context.register(pageLeaf);
+    return new PDFPage(pageLeaf, pageRef, doc);
+};
 //# sourceMappingURL=PDFPage.js.map