@libpdf/core 0.0.1-beta.11 → 0.0.1-beta.13

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.11";
+var version = "0.0.1-beta.13";
 
 //#endregion
 //#region src/objects/pdf-array.ts
@@ -13525,6 +13525,12 @@ function getBaseFontName(name) {
 	return name.includes("+") ? name.split("+")[1] : name;
 }
 /**
+* Get basic metrics (ascent, descent, etc.) for a Standard 14 font.
+*/
+function getStandard14BasicMetrics(name) {
+	return FONT_BASIC_METRICS[getBaseFontName(name)];
+}
+/**
 * Get width for a glyph in a Standard 14 font.
 * Returns undefined if font or glyph not found.
 */
@@ -13546,6 +13552,116 @@ function getStandard14DefaultWidth(fontName) {
 	if (baseName === "ZapfDingbats") return 278;
 	return 250;
 }
+/**
+* Map common Unicode code points to glyph names.
+* This is a subset of the Adobe Glyph List.
+*/
+const CHAR_TO_GLYPH = {
+	32: "space",
+	33: "exclam",
+	34: "quotedbl",
+	35: "numbersign",
+	36: "dollar",
+	37: "percent",
+	38: "ampersand",
+	39: "quotesingle",
+	40: "parenleft",
+	41: "parenright",
+	42: "asterisk",
+	43: "plus",
+	44: "comma",
+	45: "hyphen",
+	46: "period",
+	47: "slash",
+	48: "zero",
+	49: "one",
+	50: "two",
+	51: "three",
+	52: "four",
+	53: "five",
+	54: "six",
+	55: "seven",
+	56: "eight",
+	57: "nine",
+	58: "colon",
+	59: "semicolon",
+	60: "less",
+	61: "equal",
+	62: "greater",
+	63: "question",
+	64: "at",
+	65: "A",
+	66: "B",
+	67: "C",
+	68: "D",
+	69: "E",
+	70: "F",
+	71: "G",
+	72: "H",
+	73: "I",
+	74: "J",
+	75: "K",
+	76: "L",
+	77: "M",
+	78: "N",
+	79: "O",
+	80: "P",
+	81: "Q",
+	82: "R",
+	83: "S",
+	84: "T",
+	85: "U",
+	86: "V",
+	87: "W",
+	88: "X",
+	89: "Y",
+	90: "Z",
+	91: "bracketleft",
+	92: "backslash",
+	93: "bracketright",
+	94: "asciicircum",
+	95: "underscore",
+	96: "grave",
+	97: "a",
+	98: "b",
+	99: "c",
+	100: "d",
+	101: "e",
+	102: "f",
+	103: "g",
+	104: "h",
+	105: "i",
+	106: "j",
+	107: "k",
+	108: "l",
+	109: "m",
+	110: "n",
+	111: "o",
+	112: "p",
+	113: "q",
+	114: "r",
+	115: "s",
+	116: "t",
+	117: "u",
+	118: "v",
+	119: "w",
+	120: "x",
+	121: "y",
+	122: "z",
+	123: "braceleft",
+	124: "bar",
+	125: "braceright",
+	126: "asciitilde"
+};
+/**
+* Get glyph name for a character (for Standard 14 font width lookup).
+*/
+function getGlyphName(char) {
+	const code = char.codePointAt(0);
+	if (code !== void 0 && CHAR_TO_GLYPH[code]) return CHAR_TO_GLYPH[code];
+	if (char.length === 1 && /[a-zA-Z]/.test(char)) return char;
+	return "space";
+}
 const FONT_BASIC_METRICS = {
 	Courier: {
 		ascent: 629,
@@ -20612,6 +20728,58 @@ var EmbeddedFont = class EmbeddedFont extends PdfFont {
 		return !this._usedInForm;
 	}
 	/**
+	* Get width of text in points at a given font size.
+	*
+	* Alias for getTextWidth() to match Standard14Font API.
+	*
+	* @param text - The text to measure
+	* @param size - Font size in points
+	* @returns Width in points
+	*/
+	widthOfTextAtSize(text, size) {
+		return this.getTextWidth(text, size);
+	}
+	/**
+	* Get the height of the font at a given size.
+	*
+	* This returns the full height from descender to ascender.
+	*
+	* @param size - Font size in points
+	* @returns Height in points
+	*/
+	heightAtSize(size) {
+		const desc = this.descriptor;
+		if (!desc) return size;
+		return (desc.ascent - desc.descent) * size / 1e3;
+	}
+	/**
+	* Calculate font size needed to achieve a specific text height.
+	*
+	* @param height - Desired height in points
+	* @returns Font size in points
+	*/
+	sizeAtHeight(height) {
+		const desc = this.descriptor;
+		if (!desc) return height;
+		const unitsHeight = desc.ascent - desc.descent;
+		return height * 1e3 / unitsHeight;
+	}
+	/**
+	* Calculate font size needed for text to fit a specific width.
+	*
+	* @param text - The text to measure
+	* @param width - Desired width in points
+	* @returns Font size in points
+	*/
+	sizeAtWidth(text, width) {
+		if (text.length === 0) return 0;
+		const codes = this.encodeText(text);
+		let totalWidth = 0;
+		for (const code of codes) totalWidth += this.getWidth(code);
+		if (totalWidth === 0) return 0;
+		return width * 1e3 / totalWidth;
+	}
+	/**
 	* Build a FontDescriptor from the font program.
 	*/
 	buildDescriptor() {
@@ -23428,6 +23596,57 @@ function isWordBoundary(char) {
 //#endregion
 //#region src/api/drawing/types.ts
 /**
+* Resolve a rotation origin to explicit coordinates.
+*
+* @param origin - The origin specification (coordinates or named position)
+* @param bounds - The bounding box of the object
+* @param defaultOrigin - Default origin if none specified (as coordinates)
+* @returns Explicit { x, y } coordinates
+*/
+function resolveRotationOrigin(origin, bounds, defaultOrigin) {
+	if (origin === void 0) return defaultOrigin;
+	if (typeof origin === "object") return origin;
+	const { x, y, width, height } = bounds;
+	switch (origin) {
+		case "top-left": return {
+			x,
+			y: y + height
+		};
+		case "top-center": return {
+			x: x + width / 2,
+			y: y + height
+		};
+		case "top-right": return {
+			x: x + width,
+			y: y + height
+		};
+		case "center-left": return {
+			x,
+			y: y + height / 2
+		};
+		case "center": return {
+			x: x + width / 2,
+			y: y + height / 2
+		};
+		case "center-right": return {
+			x: x + width,
+			y: y + height / 2
+		};
+		case "bottom-left": return {
+			x,
+			y
+		};
+		case "bottom-center": return {
+			x: x + width / 2,
+			y
+		};
+		case "bottom-right": return {
+			x: x + width,
+			y
+		};
+	}
+}
+/**
 * Convert LineCap to PDF numeric value.
 */
 function lineCapToNumber(cap) {
@@ -23840,116 +24059,6 @@ var PathBuilder = class {
 * Text layout utilities for measuring and wrapping text.
 */
 /**
-* Map common Unicode code points to glyph names.
-* This is a subset of the Adobe Glyph List.
-*/
-const CHAR_TO_GLYPH = {
-	32: "space",
-	33: "exclam",
-	34: "quotedbl",
-	35: "numbersign",
-	36: "dollar",
-	37: "percent",
-	38: "ampersand",
-	39: "quotesingle",
-	40: "parenleft",
-	41: "parenright",
-	42: "asterisk",
-	43: "plus",
-	44: "comma",
-	45: "hyphen",
-	46: "period",
-	47: "slash",
-	48: "zero",
-	49: "one",
-	50: "two",
-	51: "three",
-	52: "four",
-	53: "five",
-	54: "six",
-	55: "seven",
-	56: "eight",
-	57: "nine",
-	58: "colon",
-	59: "semicolon",
-	60: "less",
-	61: "equal",
-	62: "greater",
-	63: "question",
-	64: "at",
-	65: "A",
-	66: "B",
-	67: "C",
-	68: "D",
-	69: "E",
-	70: "F",
-	71: "G",
-	72: "H",
-	73: "I",
-	74: "J",
-	75: "K",
-	76: "L",
-	77: "M",
-	78: "N",
-	79: "O",
-	80: "P",
-	81: "Q",
-	82: "R",
-	83: "S",
-	84: "T",
-	85: "U",
-	86: "V",
-	87: "W",
-	88: "X",
-	89: "Y",
-	90: "Z",
-	91: "bracketleft",
-	92: "backslash",
-	93: "bracketright",
-	94: "asciicircum",
-	95: "underscore",
-	96: "grave",
-	97: "a",
-	98: "b",
-	99: "c",
-	100: "d",
-	101: "e",
-	102: "f",
-	103: "g",
-	104: "h",
-	105: "i",
-	106: "j",
-	107: "k",
-	108: "l",
-	109: "m",
-	110: "n",
-	111: "o",
-	112: "p",
-	113: "q",
-	114: "r",
-	115: "s",
-	116: "t",
-	117: "u",
-	118: "v",
-	119: "w",
-	120: "x",
-	121: "y",
-	122: "z",
-	123: "braceleft",
-	124: "bar",
-	125: "braceright",
-	126: "asciitilde"
-};
-/**
-* Get glyph name for a character.
-*/
-function getGlyphName(char) {
-	const code = char.codePointAt(0);
-	if (code !== void 0 && CHAR_TO_GLYPH[code]) return CHAR_TO_GLYPH[code];
-	if (char.length === 1 && /[a-zA-Z]/.test(char)) return char;
-	return "space";
-}
-/**
 * Measure the width of text at a given font size.
 *
 * @param text - The text to measure
@@ -24459,12 +24568,21 @@ var PDFPage = class PDFPage {
 		if (options.opacity !== void 0 || options.borderOpacity !== void 0) gsName = this.registerGraphicsStateForOpacity(options.opacity, options.borderOpacity);
 		let rotate;
 		if (options.rotate) {
-			const originX = options.rotate.origin?.x ?? options.x + options.width / 2;
-			const originY = options.rotate.origin?.y ?? options.y + options.height / 2;
+			const bounds = {
+				x: options.x,
+				y: options.y,
+				width: options.width,
+				height: options.height
+			};
+			const defaultOrigin = {
+				x: options.x + options.width / 2,
+				y: options.y + options.height / 2
+			};
+			const origin = resolveRotationOrigin(options.rotate.origin, bounds, defaultOrigin);
 			rotate = {
 				angle: options.rotate.angle,
-				originX,
-				originY
+				originX: origin.x,
+				originY: origin.y
 			};
 		}
 		const ops = drawRectangleOps({
@@ -24567,12 +24685,21 @@ var PDFPage = class PDFPage {
 		if (options.opacity !== void 0 || options.borderOpacity !== void 0) gsName = this.registerGraphicsStateForOpacity(options.opacity, options.borderOpacity);
 		let rotate;
 		if (options.rotate) {
-			const originX = options.rotate.origin?.x ?? options.x;
-			const originY = options.rotate.origin?.y ?? options.y;
+			const bounds = {
+				x: options.x - options.xRadius,
+				y: options.y - options.yRadius,
+				width: options.xRadius * 2,
+				height: options.yRadius * 2
+			};
+			const defaultOrigin = {
+				x: options.x,
+				y: options.y
+			};
+			const origin = resolveRotationOrigin(options.rotate.origin, bounds, defaultOrigin);
 			rotate = {
 				angle: options.rotate.angle,
-				originX,
-				originY
+				originX: origin.x,
+				originY: origin.y
 			};
 		}
 		const ops = drawEllipseOps({
@@ -24642,14 +24769,37 @@ var PDFPage = class PDFPage {
 		const ops = [pushGraphicsState()];
 		if (gsName) ops.push(setGraphicsState(gsName));
 		if (options.rotate) {
-			const originX = options.rotate.origin?.x ?? x;
-			const originY = options.rotate.origin?.y ?? y;
+			const textWidth = options.maxWidth ?? Math.max(...lines.map((l) => l.width));
+			let ascent;
+			let descent;
+			if (typeof font === "string") {
+				const metrics = getStandard14BasicMetrics(font);
+				ascent = metrics ? metrics.ascent * fontSize / 1e3 : fontSize * .8;
+				descent = metrics ? Math.abs(metrics.descent) * fontSize / 1e3 : fontSize * .2;
+			} else {
+				const desc = font.descriptor;
+				ascent = desc ? desc.ascent * fontSize / 1e3 : fontSize * .8;
+				descent = desc ? Math.abs(desc.descent) * fontSize / 1e3 : fontSize * .2;
+			}
+			const firstLineTop = y + ascent;
+			const lastLineBottom = y - (lines.length - 1) * lineHeight - descent;
+			const bounds = {
+				x,
+				y: lastLineBottom,
+				width: textWidth,
+				height: firstLineTop - lastLineBottom
+			};
+			const defaultOrigin = {
+				x,
+				y
+			};
+			const origin = resolveRotationOrigin(options.rotate.origin, bounds, defaultOrigin);
 			const rad = options.rotate.angle * Math.PI / 180;
 			const cos = Math.cos(rad);
 			const sin = Math.sin(rad);
-			ops.push(concatMatrix(1, 0, 0, 1, originX, originY));
+			ops.push(concatMatrix(1, 0, 0, 1, origin.x, origin.y));
 			ops.push(concatMatrix(cos, sin, -sin, cos, 0, 0));
-			ops.push(concatMatrix(1, 0, 0, 1, -originX, -originY));
+			ops.push(concatMatrix(1, 0, 0, 1, -origin.x, -origin.y));
 		}
 		ops.push(setFillColor(color));
 		ops.push(beginText());
@@ -24732,14 +24882,23 @@ var PDFPage = class PDFPage {
 			ops.push(`/${gsName} gs`);
 		}
 		if (options.rotate) {
-			const originX = options.rotate.origin?.x ?? x + width / 2;
-			const originY = options.rotate.origin?.y ?? y + height / 2;
+			const bounds = {
+				x,
+				y,
+				width,
+				height
+			};
+			const defaultOrigin = {
+				x: x + width / 2,
+				y: y + height / 2
+			};
+			const origin = resolveRotationOrigin(options.rotate.origin, bounds, defaultOrigin);
 			const rad = options.rotate.angle * Math.PI / 180;
 			const cos = Math.cos(rad);
 			const sin = Math.sin(rad);
-			ops.push(`1 0 0 1 ${this.formatNumber(originX)} ${this.formatNumber(originY)} cm`);
+			ops.push(`1 0 0 1 ${this.formatNumber(origin.x)} ${this.formatNumber(origin.y)} cm`);
 			ops.push(`${this.formatNumber(cos)} ${this.formatNumber(sin)} ${this.formatNumber(-sin)} ${this.formatNumber(cos)} 0 0 cm`);
-			ops.push(`1 0 0 1 ${this.formatNumber(-originX)} ${this.formatNumber(-originY)} cm`);
+			ops.push(`1 0 0 1 ${this.formatNumber(-origin.x)} ${this.formatNumber(-origin.y)} cm`);
 		}
 		ops.push(`${this.formatNumber(width)} 0 0 ${this.formatNumber(height)} ${this.formatNumber(x)} ${this.formatNumber(y)} cm`);
 		ops.push(`/${imageName} Do`);
@@ -26323,8 +26482,7 @@ var AnnotationFlattener = class {
 	* Wrap existing page content in q...Q and append new content.
 	*/
 	wrapAndAppendContent(page, newContent) {
-		let existing = page.get("Contents");
-		if (existing instanceof PdfRef) existing = this.registry.resolve(existing) ?? void 0;
+		const existing = page.get("Contents");
 		const prefixBytes = new Uint8Array([113, 10]);
 		const prefixStream = new PdfStream(new PdfDict(), prefixBytes);
 		const prefixRef = this.registry.register(prefixStream);
@@ -26338,10 +26496,12 @@ var AnnotationFlattener = class {
 			page.set("Contents", suffixRef);
 			return;
 		}
-		if (existing instanceof PdfArray) {
+		let resolved = existing;
+		if (existing instanceof PdfRef) resolved = this.registry.resolve(existing) ?? existing;
+		if (resolved instanceof PdfArray) {
 			const items = [];
-			for (let i = 0; i < existing.length; i++) {
-				const item = existing.at(i);
+			for (let i = 0; i < resolved.length; i++) {
+				const item = resolved.at(i);
 				if (item instanceof PdfRef) items.push(item);
 			}
 			const newArray = PdfArray.of(prefixRef, ...items, suffixRef);
@@ -39247,6 +39407,15 @@ function derToPem(der, label) {
 	return `-----BEGIN ${label}-----\n${(base64.encode(der).match(/.{1,64}/g) ?? []).join("\n")}\n-----END ${label}-----\n`;
 }
 /**
+* Check if a string is in PEM format.
+*
+* @param data - The string to check
+* @returns True if the string appears to be PEM-encoded
+*/
+function isPem(data) {
+	return /-----BEGIN [A-Z0-9 ]+-----/.test(data) && /-----END [A-Z0-9 ]+-----/.test(data);
+}
+/**
 * Normalize a PEM string for comparison by removing headers, footers, and whitespace.
 *
 * @param pem - The PEM-encoded string
@@ -39543,31 +39712,43 @@ var GoogleKmsSigner = class GoogleKmsSigner {
 		}
 	}
 	/**
-	* Load a certificate from Google Secret Manager.
+	* Loads a signing certificate from Google Secret Manager for use with KMS-based signing.
+	*
+	* This helper retrieves certificate material securely stored in Secret Manager, supporting
+	* both PEM and DER formats:
+	*   - If the secret contains PEM-encoded data, all certificates will be parsed.
+	*     The first is used as the signing cert (`cert`), and the remainder returned as
+	*     the optional `chain` (intermediates).
+	*   - If the secret contains raw DER data, it is returned as the signing cert (`cert`).
 	*
-	* The secret must contain a DER-encoded certificate. PEM format is NOT supported -
-	* convert to DER before storing in Secret Manager.
+	* Supports cross-project use: the secret may be in a different GCP project than the KMS key.
 	*
-	* Supports cross-project access: the secret can be in a different GCP project
-	* than the KMS key.
+	* - The secret should contain the certificate in binary DER (recommended) or PEM format.
+	* - Private keys must never be stored in Secret Manager.
 	*
-	* @param secretVersionName - Full resource name, e.g.
-	*   "projects/my-project/secrets/my-cert/versions/latest"
-	* @param options - Optional client configuration
-	* @throws {KmsSignerError} if @google-cloud/secret-manager is not installed
+	* @param secretVersionName Full resource name for the secret version,
+	*   e.g. "projects/my-project/secrets/my-cert/versions/latest"
+	* @param options Optional client configuration, including a SecretManagerServiceClient instance.
+	* @returns An object with `cert` (main certificate bytes) and optional `chain` (intermediates).
+	* @throws {KmsSignerError} if @google-cloud/secret-manager is not installed or retrieval fails.
 	*
 	* @example
-	* ```typescript
-	* // From same project
-	* const cert = await GoogleKmsSigner.getCertificateFromSecretManager(
+	* // Load a certificate from the same project
+	* const { cert } = await GoogleKmsSigner.getCertificateFromSecretManager(
 	*   "projects/my-project/secrets/signing-cert/versions/latest"
 	* );
 	*
-	* // From different project (cross-project access)
-	* const cert = await GoogleKmsSigner.getCertificateFromSecretManager(
-	*   "projects/shared-certs-project/secrets/signing-cert/versions/1"
+	* // Load from a different project (cross-project access)
+	* const { cert, chain } = await GoogleKmsSigner.getCertificateFromSecretManager(
+	*   "projects/shared-certs-project/secrets/org-ca-cert/versions/1"
 	* );
-	* ```
+	*
+	* // Use the result with KMS-based signing
+	* const signer = await GoogleKmsSigner.create({
+	*   keyVersionName: "...",
+	*   certificate: cert,
+	*   chain,
+	* });
 	*/
 	static async getCertificateFromSecretManager(secretVersionName, options) {
 		const secretManager = await importSecretManager();
@@ -39575,8 +39756,15 @@ var GoogleKmsSigner = class GoogleKmsSigner {
 		try {
 			const [version$1] = await client.accessSecretVersion({ name: secretVersionName });
 			if (!version$1.payload?.data) throw new KmsSignerError(`Secret is empty: ${secretVersionName}`);
-			if (typeof version$1.payload.data === "string") return new TextEncoder().encode(version$1.payload.data);
-			return new Uint8Array(version$1.payload.data);
+			let data = typeof version$1.payload.data === "string" ? version$1.payload.data : new TextDecoder().decode(version$1.payload.data);
+			if (isPem(data)) {
+				const [first, ...rest] = parsePem(data).map((block) => block.der);
+				return {
+					cert: first,
+					chain: rest
+				};
+			}
+			return { cert: new TextEncoder().encode(data) };
 		} catch (error) {
 			if (error instanceof KmsSignerError) throw error;
 			if (isGrpcError(error)) switch (error.code) {
@@ -41721,5 +41909,116 @@ var HttpTimestampAuthority = class {
 };
 
 //#endregion
-export { AnnotationFlags, CertificateChainError, CryptoKeySigner, GoogleKmsSigner, HttpTimestampAuthority, KmsSignerError, P12Signer, PDF, PDFAnnotation, PDFCaretAnnotation, PDFCircleAnnotation, PDFEmbeddedPage, PDFFileAttachmentAnnotation, PDFForm, PDFFreeTextAnnotation, PDFHighlightAnnotation, PDFImage, PDFInkAnnotation, PDFLineAnnotation, PDFLinkAnnotation, PDFMarkupAnnotation, PDFPage, PDFPolygonAnnotation, PDFPolylineAnnotation, PDFPopupAnnotation, PDFSquareAnnotation, PDFSquigglyAnnotation, PDFStampAnnotation, PDFStrikeOutAnnotation, PDFTextAnnotation, PDFTextMarkupAnnotation, PDFUnderlineAnnotation, PDFUnknownAnnotation, PathBuilder, PdfArray, PdfBool, PdfDict, PdfName, PdfNull, PdfNumber, PdfRef, PdfStream, PdfString, PermissionDeniedError, PlaceholderError, RevocationError, STANDARD_STAMPS, SecurityError, SignatureError, SignerError, StandardFonts, TextAlignment, TimestampError, black, blue, cmyk, createAnnotation, degrees, grayscale, green, isPopupAnnotation, isWidgetAnnotation, layoutJustifiedLine, layoutText, lineCapToNumber, lineJoinToNumber, measureText, parsePem, rectToQuadPoints, rectsToQuadPoints, red, rgb, version, white };
+//#region src/fonts/standard-14-font.ts
+/**
+* Standard14Font - A font wrapper for Standard 14 PDF fonts.
+*
+* This class provides width/height measurement for text using Standard 14 fonts,
+* which are built into every PDF reader and don't need embedding.
+*
+* Usage:
+* ```typescript
+* const font = Standard14Font.of("Helvetica-Bold");
+*
+* // Measure text
+* const width = font.widthOfTextAtSize("Hello", 12);
+* const height = font.heightAtSize(12);
+* ```
+*/
+/**
+* A wrapper class for Standard 14 fonts that provides measurement methods.
+*
+* Standard 14 fonts don't need to be embedded - they're built into PDF readers.
+* This class provides the same measurement API as EmbeddedFont.
+*/
+var Standard14Font = class Standard14Font {
+	/** The Standard 14 font name */
+	name;
+	/** Cached metrics */
+	metrics;
+	constructor(name) {
+		this.name = name;
+		const basicMetrics = getStandard14BasicMetrics(name);
+		if (!basicMetrics) throw new Error(`Unknown Standard 14 font: ${name}`);
+		this.metrics = {
+			ascent: basicMetrics.ascent,
+			descent: basicMetrics.descent
+		};
+	}
+	/**
+	* Create a Standard14Font instance.
+	*
+	* @param name - The Standard 14 font name (e.g., "Helvetica", "Times-Bold")
+	* @returns Standard14Font instance
+	* @throws {Error} if name is not a valid Standard 14 font
+	*
+	* @example
+	* ```typescript
+	* const helvetica = Standard14Font.of("Helvetica");
+	* const timesBold = Standard14Font.of("Times-Bold");
+	* ```
+	*/
+	static of(name) {
+		if (!isStandard14Font(name)) throw new Error(`"${name}" is not a Standard 14 font. Valid names: Helvetica, Helvetica-Bold, Helvetica-Oblique, Helvetica-BoldOblique, Times-Roman, Times-Bold, Times-Italic, Times-BoldItalic, Courier, Courier-Bold, Courier-Oblique, Courier-BoldOblique, Symbol, ZapfDingbats`);
+		return new Standard14Font(name);
+	}
+	/**
+	* Get width of text in points at a given font size.
+	*
+	* @param text - The text to measure
+	* @param size - Font size in points
+	* @returns Width in points
+	*/
+	widthOfTextAtSize(text, size) {
+		let totalWidth = 0;
+		for (const char of text) {
+			const glyphName = getGlyphName(char);
+			const width = getStandard14GlyphWidth(this.name, glyphName) ?? getStandard14DefaultWidth(this.name);
+			totalWidth += width;
+		}
+		return totalWidth * size / 1e3;
+	}
+	/**
+	* Get the height of the font at a given size.
+	*
+	* This returns the full height from descender to ascender.
+	*
+	* @param size - Font size in points
+	* @returns Height in points
+	*/
+	heightAtSize(size) {
+		return (this.metrics.ascent - this.metrics.descent) * size / 1e3;
+	}
+	/**
+	* Calculate font size needed to achieve a specific text height.
+	*
+	* @param height - Desired height in points
+	* @returns Font size in points
+	*/
+	sizeAtHeight(height) {
+		const unitsHeight = this.metrics.ascent - this.metrics.descent;
+		return height * 1e3 / unitsHeight;
+	}
+	/**
+	* Calculate font size needed for text to fit a specific width.
+	*
+	* @param text - The text to measure
+	* @param width - Desired width in points
+	* @returns Font size in points
+	*/
+	sizeAtWidth(text, width) {
+		if (text.length === 0) return 0;
+		let totalWidth = 0;
+		for (const char of text) {
+			const glyphName = getGlyphName(char);
+			const charWidth = getStandard14GlyphWidth(this.name, glyphName) ?? getStandard14DefaultWidth(this.name);
+			totalWidth += charWidth;
+		}
+		if (totalWidth === 0) return 0;
+		return width * 1e3 / totalWidth;
+	}
+};
+
+//#endregion
+export { AnnotationFlags, CertificateChainError, CryptoKeySigner, GoogleKmsSigner, HttpTimestampAuthority, KmsSignerError, P12Signer, PDF, PDFAnnotation, PDFCaretAnnotation, PDFCircleAnnotation, PDFEmbeddedPage, PDFFileAttachmentAnnotation, PDFForm, PDFFreeTextAnnotation, PDFHighlightAnnotation, PDFImage, PDFInkAnnotation, PDFLineAnnotation, PDFLinkAnnotation, PDFMarkupAnnotation, PDFPage, PDFPolygonAnnotation, PDFPolylineAnnotation, PDFPopupAnnotation, PDFSquareAnnotation, PDFSquigglyAnnotation, PDFStampAnnotation, PDFStrikeOutAnnotation, PDFTextAnnotation, PDFTextMarkupAnnotation, PDFUnderlineAnnotation, PDFUnknownAnnotation, PathBuilder, PdfArray, PdfBool, PdfDict, PdfName, PdfNull, PdfNumber, PdfRef, PdfStream, PdfString, PermissionDeniedError, PlaceholderError, RevocationError, STANDARD_STAMPS, SecurityError, SignatureError, SignerError, Standard14Font, StandardFonts, TextAlignment, TimestampError, black, blue, cmyk, createAnnotation, degrees, grayscale, green, isPopupAnnotation, isWidgetAnnotation, layoutJustifiedLine, layoutText, lineCapToNumber, lineJoinToNumber, measureText, parsePem, rectToQuadPoints, rectsToQuadPoints, red, rgb, version, white };
 //# sourceMappingURL=index.mjs.map