modern-pdf-lib 0.25.0 → 0.28.0

package/dist/{layout-DH61a1iR.cjs → layout-C4vbTlBW.cjs}

@@ -1,6 +1,5 @@
-const require_pdfPage = require('./pdfPage-Cd8jOJp6.cjs');
-const require_pdfObjects = require('./pdfObjects-1veop1_d.cjs');
-
+const require_pdfDocument = require("./pdfDocument-C_7mrBCL.cjs");
+const require_pdfObjects = require("./pdfObjects-BcPlSI0a.cjs");
 //#region src/utils/pdfValueHelpers.ts
 /**
 * @module utils/pdfValueHelpers
@@ -12,29 +11,70 @@ const require_pdfObjects = require('./pdfObjects-1veop1_d.cjs');
 * Create a {@link PdfName} from a string.
 *
 * @param value  The name value (with or without leading `/`).
+* @returns      A new {@link PdfName} instance.
+*
+* @example
+* ```ts
+* const name = asPdfName('Type');
+* ```
 */
-function asPDFName(value) {
+function asPdfName(value) {
 	return require_pdfObjects.PdfName.of(value);
 }
 /**
 * Create a {@link PdfNumber} from a numeric value.
 *
 * @param value  The number.
+* @returns      A new {@link PdfNumber} instance.
+*
+* @example
+* ```ts
+* const num = asPdfNumber(42);
+* ```
 */
-function asPDFNumber(value) {
+function asPdfNumber(value) {
 	return require_pdfObjects.PdfNumber.of(value);
 }
 /**
+* Create a {@link PdfName} from a string.
+*
+* @deprecated Use {@link asPdfName} instead. This alias uses inconsistent
+*             PascalCase `PDF` while the rest of the codebase uses `Pdf`.
+*             Will be removed in v2.0.
+* @param value  The name value (with or without leading `/`).
+* @returns      A new {@link PdfName} instance.
+*/
+function asPDFName(value) {
+	return asPdfName(value);
+}
+/**
+* Create a {@link PdfNumber} from a numeric value.
+*
+* @deprecated Use {@link asPdfNumber} instead. This alias uses inconsistent
+*             PascalCase `PDF` while the rest of the codebase uses `Pdf`.
+*             Will be removed in v2.0.
+* @param value  The number.
+* @returns      A new {@link PdfNumber} instance.
+*/
+function asPDFNumber(value) {
+	return asPdfNumber(value);
+}
+/**
 * Extract a numeric value from a {@link PdfObject}.
 *
 * Returns `undefined` if the object is not a PdfNumber.
 *
 * @param obj  The PDF object to inspect.
+* @returns    The numeric value, or `undefined` if not a PdfNumber.
+*
+* @example
+* ```ts
+* const val = asNumber(someObj); // number | undefined
+* ```
 */
 function asNumber(obj) {
 	if (obj.kind === "number") return obj.value;
 }
-
 //#endregion
 //#region src/core/enums.ts
 /**
@@ -114,7 +154,6 @@ const ParseSpeeds = {
 	Medium: 100,
 	Slow: 10
 };
-
 //#endregion
 //#region src/core/pageManipulation.ts
 /**
@@ -124,7 +163,7 @@ const ParseSpeeds = {
 * @returns     A `[width, height]` tuple in PDF points.
 */
 function resolveSize(size) {
-	const resolved = size ?? require_pdfPage.PageSizes.A4;
+	const resolved = size ?? require_pdfDocument.PageSizes.A4;
 	if (Array.isArray(resolved)) return [resolved[0], resolved[1]];
 	return [resolved.width, resolved.height];
 }
@@ -184,7 +223,7 @@ function insertPage(doc, index, size) {
 	const registry = doc.getRegistry();
 	validateInsertIndex(index, pages.length, "insertPage");
 	const [w, h] = resolveSize(size);
-	const page = new require_pdfPage.PdfPage(w, h, registry);
+	const page = new require_pdfDocument.PdfPage(w, h, registry);
 	doc.registerFontsOnPage(page);
 	pages.splice(index, 0, page);
 	return page;
@@ -351,7 +390,6 @@ function rotateAllPages(doc, angle) {
 		page.setRotation(newRotation);
 	}
 }
-
 //#endregion
 //#region src/core/layout.ts
 /**
@@ -367,7 +405,7 @@ function layoutMultilineText(text, options) {
 	const rawLines = text.split("\n");
 	const allLines = [];
 	for (const rawLine of rawLines) if (maxWidth > 0) {
-		const wrapped = require_pdfPage.wrapText(rawLine, maxWidth, font, fontSize, wordBreaks);
+		const wrapped = require_pdfDocument.wrapText(rawLine, maxWidth, font, fontSize, wordBreaks);
 		for (const line of wrapped) allLines.push({
 			text: line,
 			width: font.widthOfTextAtSize(line, fontSize)
@@ -389,7 +427,7 @@ function layoutMultilineText(text, options) {
 */
 function layoutCombedText(text, options) {
 	const { font, fontSize, cellCount, cellWidth } = options;
-	return text.slice(0, cellCount).split("").map((char, i) => {
+	return Array.from(text).slice(0, cellCount).map((char, i) => {
 		const charWidth = font.widthOfTextAtSize(char, fontSize);
 		return {
 			char,
@@ -468,150 +506,162 @@ function layoutSinglelineText(text, options) {
 		y
 	};
 }
-
 //#endregion
-Object.defineProperty(exports, 'BlendMode', {
-  enumerable: true,
-  get: function () {
-    return BlendMode;
-  }
+Object.defineProperty(exports, "BlendMode", {
+	enumerable: true,
+	get: function() {
+		return BlendMode;
+	}
 });
-Object.defineProperty(exports, 'ImageAlignment', {
-  enumerable: true,
-  get: function () {
-    return ImageAlignment;
-  }
+Object.defineProperty(exports, "ImageAlignment", {
+	enumerable: true,
+	get: function() {
+		return ImageAlignment;
+	}
 });
-Object.defineProperty(exports, 'LineCapStyle', {
-  enumerable: true,
-  get: function () {
-    return LineCapStyle;
-  }
+Object.defineProperty(exports, "LineCapStyle", {
+	enumerable: true,
+	get: function() {
+		return LineCapStyle;
+	}
 });
-Object.defineProperty(exports, 'LineJoinStyle', {
-  enumerable: true,
-  get: function () {
-    return LineJoinStyle;
-  }
+Object.defineProperty(exports, "LineJoinStyle", {
+	enumerable: true,
+	get: function() {
+		return LineJoinStyle;
+	}
 });
-Object.defineProperty(exports, 'ParseSpeeds', {
-  enumerable: true,
-  get: function () {
-    return ParseSpeeds;
-  }
+Object.defineProperty(exports, "ParseSpeeds", {
+	enumerable: true,
+	get: function() {
+		return ParseSpeeds;
+	}
 });
-Object.defineProperty(exports, 'TextAlignment', {
-  enumerable: true,
-  get: function () {
-    return TextAlignment;
-  }
+Object.defineProperty(exports, "TextAlignment", {
+	enumerable: true,
+	get: function() {
+		return TextAlignment;
+	}
 });
-Object.defineProperty(exports, 'TextRenderingMode', {
-  enumerable: true,
-  get: function () {
-    return TextRenderingMode;
-  }
+Object.defineProperty(exports, "TextRenderingMode", {
+	enumerable: true,
+	get: function() {
+		return TextRenderingMode;
+	}
 });
-Object.defineProperty(exports, 'asNumber', {
-  enumerable: true,
-  get: function () {
-    return asNumber;
-  }
+Object.defineProperty(exports, "asNumber", {
+	enumerable: true,
+	get: function() {
+		return asNumber;
+	}
 });
-Object.defineProperty(exports, 'asPDFName', {
-  enumerable: true,
-  get: function () {
-    return asPDFName;
-  }
+Object.defineProperty(exports, "asPDFName", {
+	enumerable: true,
+	get: function() {
+		return asPDFName;
+	}
 });
-Object.defineProperty(exports, 'asPDFNumber', {
-  enumerable: true,
-  get: function () {
-    return asPDFNumber;
-  }
+Object.defineProperty(exports, "asPDFNumber", {
+	enumerable: true,
+	get: function() {
+		return asPDFNumber;
+	}
 });
-Object.defineProperty(exports, 'computeFontSize', {
-  enumerable: true,
-  get: function () {
-    return computeFontSize;
-  }
+Object.defineProperty(exports, "asPdfName", {
+	enumerable: true,
+	get: function() {
+		return asPdfName;
+	}
 });
-Object.defineProperty(exports, 'cropPage', {
-  enumerable: true,
-  get: function () {
-    return cropPage;
-  }
+Object.defineProperty(exports, "asPdfNumber", {
+	enumerable: true,
+	get: function() {
+		return asPdfNumber;
+	}
 });
-Object.defineProperty(exports, 'getPageSize', {
-  enumerable: true,
-  get: function () {
-    return getPageSize;
-  }
+Object.defineProperty(exports, "computeFontSize", {
+	enumerable: true,
+	get: function() {
+		return computeFontSize;
+	}
 });
-Object.defineProperty(exports, 'insertPage', {
-  enumerable: true,
-  get: function () {
-    return insertPage;
-  }
+Object.defineProperty(exports, "cropPage", {
+	enumerable: true,
+	get: function() {
+		return cropPage;
+	}
 });
-Object.defineProperty(exports, 'layoutCombedText', {
-  enumerable: true,
-  get: function () {
-    return layoutCombedText;
-  }
+Object.defineProperty(exports, "getPageSize", {
+	enumerable: true,
+	get: function() {
+		return getPageSize;
+	}
 });
-Object.defineProperty(exports, 'layoutMultilineText', {
-  enumerable: true,
-  get: function () {
-    return layoutMultilineText;
-  }
+Object.defineProperty(exports, "insertPage", {
+	enumerable: true,
+	get: function() {
+		return insertPage;
+	}
 });
-Object.defineProperty(exports, 'layoutSinglelineText', {
-  enumerable: true,
-  get: function () {
-    return layoutSinglelineText;
-  }
+Object.defineProperty(exports, "layoutCombedText", {
+	enumerable: true,
+	get: function() {
+		return layoutCombedText;
+	}
 });
-Object.defineProperty(exports, 'movePage', {
-  enumerable: true,
-  get: function () {
-    return movePage;
-  }
+Object.defineProperty(exports, "layoutMultilineText", {
+	enumerable: true,
+	get: function() {
+		return layoutMultilineText;
+	}
 });
-Object.defineProperty(exports, 'removePage', {
-  enumerable: true,
-  get: function () {
-    return removePage;
-  }
+Object.defineProperty(exports, "layoutSinglelineText", {
+	enumerable: true,
+	get: function() {
+		return layoutSinglelineText;
+	}
 });
-Object.defineProperty(exports, 'removePages', {
-  enumerable: true,
-  get: function () {
-    return removePages;
-  }
+Object.defineProperty(exports, "movePage", {
+	enumerable: true,
+	get: function() {
+		return movePage;
+	}
 });
-Object.defineProperty(exports, 'resizePage', {
-  enumerable: true,
-  get: function () {
-    return resizePage;
-  }
+Object.defineProperty(exports, "removePage", {
+	enumerable: true,
+	get: function() {
+		return removePage;
+	}
 });
-Object.defineProperty(exports, 'reversePages', {
-  enumerable: true,
-  get: function () {
-    return reversePages;
-  }
+Object.defineProperty(exports, "removePages", {
+	enumerable: true,
+	get: function() {
+		return removePages;
+	}
 });
-Object.defineProperty(exports, 'rotateAllPages', {
-  enumerable: true,
-  get: function () {
-    return rotateAllPages;
-  }
+Object.defineProperty(exports, "resizePage", {
+	enumerable: true,
+	get: function() {
+		return resizePage;
+	}
+});
+Object.defineProperty(exports, "reversePages", {
+	enumerable: true,
+	get: function() {
+		return reversePages;
+	}
 });
-Object.defineProperty(exports, 'rotatePage', {
-  enumerable: true,
-  get: function () {
-    return rotatePage;
-  }
+Object.defineProperty(exports, "rotateAllPages", {
+	enumerable: true,
+	get: function() {
+		return rotateAllPages;
+	}
 });
-//# sourceMappingURL=layout-DH61a1iR.cjs.map
+Object.defineProperty(exports, "rotatePage", {
+	enumerable: true,
+	get: function() {
+		return rotatePage;
+	}
+});
+
+//# sourceMappingURL=layout-C4vbTlBW.cjs.map

package/dist/{layout-D6EUKSP8.mjs → layout-lO4x64kY.mjs}

@@ -1,6 +1,5 @@
-import { i as wrapText, n as PdfPage, t as PageSizes } from "./pdfPage-B_d9HmkG.mjs";
-import { i as PdfName, o as PdfNumber } from "./pdfObjects-uEsWlfzU.mjs";
-
+import { Bt as PdfPage, Vt as wrapText, zt as PageSizes } from "./pdfDocument-DRbT6HZw.mjs";
+import { i as PdfName, o as PdfNumber } from "./pdfObjects-CB7TEdbW.mjs";
 //#region src/utils/pdfValueHelpers.ts
 /**
 * @module utils/pdfValueHelpers
@@ -12,29 +11,70 @@ import { i as PdfName, o as PdfNumber } from "./pdfObjects-uEsWlfzU.mjs";
 * Create a {@link PdfName} from a string.
 *
 * @param value  The name value (with or without leading `/`).
+* @returns      A new {@link PdfName} instance.
+*
+* @example
+* ```ts
+* const name = asPdfName('Type');
+* ```
 */
-function asPDFName(value) {
+function asPdfName(value) {
 	return PdfName.of(value);
 }
 /**
 * Create a {@link PdfNumber} from a numeric value.
 *
 * @param value  The number.
+* @returns      A new {@link PdfNumber} instance.
+*
+* @example
+* ```ts
+* const num = asPdfNumber(42);
+* ```
 */
-function asPDFNumber(value) {
+function asPdfNumber(value) {
 	return PdfNumber.of(value);
 }
 /**
+* Create a {@link PdfName} from a string.
+*
+* @deprecated Use {@link asPdfName} instead. This alias uses inconsistent
+*             PascalCase `PDF` while the rest of the codebase uses `Pdf`.
+*             Will be removed in v2.0.
+* @param value  The name value (with or without leading `/`).
+* @returns      A new {@link PdfName} instance.
+*/
+function asPDFName(value) {
+	return asPdfName(value);
+}
+/**
+* Create a {@link PdfNumber} from a numeric value.
+*
+* @deprecated Use {@link asPdfNumber} instead. This alias uses inconsistent
+*             PascalCase `PDF` while the rest of the codebase uses `Pdf`.
+*             Will be removed in v2.0.
+* @param value  The number.
+* @returns      A new {@link PdfNumber} instance.
+*/
+function asPDFNumber(value) {
+	return asPdfNumber(value);
+}
+/**
 * Extract a numeric value from a {@link PdfObject}.
 *
 * Returns `undefined` if the object is not a PdfNumber.
 *
 * @param obj  The PDF object to inspect.
+* @returns    The numeric value, or `undefined` if not a PdfNumber.
+*
+* @example
+* ```ts
+* const val = asNumber(someObj); // number | undefined
+* ```
 */
 function asNumber(obj) {
 	if (obj.kind === "number") return obj.value;
 }
-
 //#endregion
 //#region src/core/enums.ts
 /**
@@ -114,7 +154,6 @@ const ParseSpeeds = {
 	Medium: 100,
 	Slow: 10
 };
-
 //#endregion
 //#region src/core/pageManipulation.ts
 /**
@@ -351,7 +390,6 @@ function rotateAllPages(doc, angle) {
 		page.setRotation(newRotation);
 	}
 }
-
 //#endregion
 //#region src/core/layout.ts
 /**
@@ -389,7 +427,7 @@ function layoutMultilineText(text, options) {
 */
 function layoutCombedText(text, options) {
 	const { font, fontSize, cellCount, cellWidth } = options;
-	return text.slice(0, cellCount).split("").map((char, i) => {
+	return Array.from(text).slice(0, cellCount).map((char, i) => {
 		const charWidth = font.widthOfTextAtSize(char, fontSize);
 		return {
 			char,
@@ -468,7 +506,7 @@ function layoutSinglelineText(text, options) {
 		y
 	};
 }
-
 //#endregion
-export { asPDFName as C, asNumber as S, LineCapStyle as _, cropPage as a, TextAlignment as b, movePage as c, resizePage as d, reversePages as f, ImageAlignment as g, BlendMode as h, layoutSinglelineText as i, removePage as l, rotatePage as m, layoutCombedText as n, getPageSize as o, rotateAllPages as p, layoutMultilineText as r, insertPage as s, computeFontSize as t, removePages as u, LineJoinStyle as v, asPDFNumber as w, TextRenderingMode as x, ParseSpeeds as y };
-//# sourceMappingURL=layout-D6EUKSP8.mjs.map
+export { asPDFName as C, asPdfNumber as E, asNumber as S, asPdfName as T, LineCapStyle as _, cropPage as a, TextAlignment as b, movePage as c, resizePage as d, reversePages as f, ImageAlignment as g, BlendMode as h, layoutSinglelineText as i, removePage as l, rotatePage as m, layoutCombedText as n, getPageSize as o, rotateAllPages as p, layoutMultilineText as r, insertPage as s, computeFontSize as t, removePages as u, LineJoinStyle as v, asPDFNumber as w, TextRenderingMode as x, ParseSpeeds as y };
+
+//# sourceMappingURL=layout-lO4x64kY.mjs.map