pdfkit 0.12.0 → 0.12.1

package/js/pdfkit.js

@@ -9,8 +9,8 @@ var events = require('events');
 var LineBreaker = require('linebreak');
 var PNG = require('png-js');
 
-/*
-PDFAbstractReference - abstract class for PDF reference
+/*
+PDFAbstractReference - abstract class for PDF reference
 */
 class PDFAbstractReference {
   toString() {
@@ -19,8 +19,8 @@ class PDFAbstractReference {
 
 }
 
-/*
-PDFTree - abstract base class for name and number tree objects
+/*
+PDFTree - abstract base class for name and number tree objects
 */
 
 class PDFTree {
@@ -78,9 +78,9 @@ class PDFTree {
 
 }
 
-/*
-PDFObject - converts JavaScript types into their corresponding PDF types.
-By Devon Govett
+/*
+PDFObject - converts JavaScript types into their corresponding PDF types.
+By Devon Govett
 */
 
 const pad = (str, length) => (Array(length + 1).join('0') + str).slice(-length);
@@ -193,9 +193,9 @@ class PDFObject {
 
 }
 
-/*
-PDFReference - represents a reference to another object in the PDF object heirarchy
-By Devon Govett
+/*
+PDFReference - represents a reference to another object in the PDF object heirarchy
+By Devon Govett
 */
 
 class PDFReference extends PDFAbstractReference {
@@ -280,9 +280,9 @@ class PDFReference extends PDFAbstractReference {
 
 }
 
-/*
-PDFPage - represents a single page in the PDF document
-By Devon Govett
+/*
+PDFPage - represents a single page in the PDF document
+By Devon Govett
 */
 const DEFAULT_MARGINS = {
   top: 72,
@@ -427,8 +427,8 @@ class PDFPage {
 
 }
 
-/*
-PDFNameTree - represents a name tree object
+/*
+PDFNameTree - represents a name tree object
 */
 
 class PDFNameTree extends PDFTree {
@@ -446,11 +446,11 @@ class PDFNameTree extends PDFTree {
 
 }
 
-/**
- * Check if value is in a range group.
- * @param {number} value
- * @param {number[]} rangeGroup
- * @returns {boolean}
+/**
+ * Check if value is in a range group.
+ * @param {number} value
+ * @param {number[]} rangeGroup
+ * @returns {boolean}
  */
 function inRange(value, rangeGroup) {
   if (value < rangeGroup[0]) return false;
@@ -478,18 +478,18 @@ function inRange(value, rangeGroup) {
   return false;
 }
 
-/**
- * A.1 Unassigned code points in Unicode 3.2
- * @link https://tools.ietf.org/html/rfc3454#appendix-A.1
+/**
+ * A.1 Unassigned code points in Unicode 3.2
+ * @link https://tools.ietf.org/html/rfc3454#appendix-A.1
  */
 
 const unassigned_code_points = [0x0221, 0x0221, 0x0234, 0x024f, 0x02ae, 0x02af, 0x02ef, 0x02ff, 0x0350, 0x035f, 0x0370, 0x0373, 0x0376, 0x0379, 0x037b, 0x037d, 0x037f, 0x0383, 0x038b, 0x038b, 0x038d, 0x038d, 0x03a2, 0x03a2, 0x03cf, 0x03cf, 0x03f7, 0x03ff, 0x0487, 0x0487, 0x04cf, 0x04cf, 0x04f6, 0x04f7, 0x04fa, 0x04ff, 0x0510, 0x0530, 0x0557, 0x0558, 0x0560, 0x0560, 0x0588, 0x0588, 0x058b, 0x0590, 0x05a2, 0x05a2, 0x05ba, 0x05ba, 0x05c5, 0x05cf, 0x05eb, 0x05ef, 0x05f5, 0x060b, 0x060d, 0x061a, 0x061c, 0x061e, 0x0620, 0x0620, 0x063b, 0x063f, 0x0656, 0x065f, 0x06ee, 0x06ef, 0x06ff, 0x06ff, 0x070e, 0x070e, 0x072d, 0x072f, 0x074b, 0x077f, 0x07b2, 0x0900, 0x0904, 0x0904, 0x093a, 0x093b, 0x094e, 0x094f, 0x0955, 0x0957, 0x0971, 0x0980, 0x0984, 0x0984, 0x098d, 0x098e, 0x0991, 0x0992, 0x09a9, 0x09a9, 0x09b1, 0x09b1, 0x09b3, 0x09b5, 0x09ba, 0x09bb, 0x09bd, 0x09bd, 0x09c5, 0x09c6, 0x09c9, 0x09ca, 0x09ce, 0x09d6, 0x09d8, 0x09db, 0x09de, 0x09de, 0x09e4, 0x09e5, 0x09fb, 0x0a01, 0x0a03, 0x0a04, 0x0a0b, 0x0a0e, 0x0a11, 0x0a12, 0x0a29, 0x0a29, 0x0a31, 0x0a31, 0x0a34, 0x0a34, 0x0a37, 0x0a37, 0x0a3a, 0x0a3b, 0x0a3d, 0x0a3d, 0x0a43, 0x0a46, 0x0a49, 0x0a4a, 0x0a4e, 0x0a58, 0x0a5d, 0x0a5d, 0x0a5f, 0x0a65, 0x0a75, 0x0a80, 0x0a84, 0x0a84, 0x0a8c, 0x0a8c, 0x0a8e, 0x0a8e, 0x0a92, 0x0a92, 0x0aa9, 0x0aa9, 0x0ab1, 0x0ab1, 0x0ab4, 0x0ab4, 0x0aba, 0x0abb, 0x0ac6, 0x0ac6, 0x0aca, 0x0aca, 0x0ace, 0x0acf, 0x0ad1, 0x0adf, 0x0ae1, 0x0ae5, 0x0af0, 0x0b00, 0x0b04, 0x0b04, 0x0b0d, 0x0b0e, 0x0b11, 0x0b12, 0x0b29, 0x0b29, 0x0b31, 0x0b31, 0x0b34, 0x0b35, 0x0b3a, 0x0b3b, 0x0b44, 0x0b46, 0x0b49, 0x0b4a, 0x0b4e, 0x0b55, 0x0b58, 0x0b5b, 0x0b5e, 0x0b5e, 0x0b62, 0x0b65, 0x0b71, 0x0b81, 0x0b84, 0x0b84, 0x0b8b, 0x0b8d, 0x0b91, 0x0b91, 0x0b96, 0x0b98, 0x0b9b, 0x0b9b, 0x0b9d, 0x0b9d, 0x0ba0, 0x0ba2, 0x0ba5, 0x0ba7, 0x0bab, 0x0bad, 0x0bb6, 0x0bb6, 0x0bba, 0x0bbd, 0x0bc3, 0x0bc5, 0x0bc9, 0x0bc9, 0x0bce, 0x0bd6, 0x0bd8, 0x0be6, 0x0bf3, 0x0c00, 0x0c04, 0x0c04, 0x0c0d, 0x0c0d, 0x0c11, 0x0c11, 0x0c29, 0x0c29, 0x0c34, 0x0c34, 0x0c3a, 0x0c3d, 0x0c45, 0x0c45, 0x0c49, 0x0c49, 0x0c4e, 0x0c54, 0x0c57, 0x0c5f, 0x0c62, 0x0c65, 0x0c70, 0x0c81, 0x0c84, 0x0c84, 0x0c8d, 0x0c8d, 0x0c91, 0x0c91, 0x0ca9, 0x0ca9, 0x0cb4, 0x0cb4, 0x0cba, 0x0cbd, 0x0cc5, 0x0cc5, 0x0cc9, 0x0cc9, 0x0cce, 0x0cd4, 0x0cd7, 0x0cdd, 0x0cdf, 0x0cdf, 0x0ce2, 0x0ce5, 0x0cf0, 0x0d01, 0x0d04, 0x0d04, 0x0d0d, 0x0d0d, 0x0d11, 0x0d11, 0x0d29, 0x0d29, 0x0d3a, 0x0d3d, 0x0d44, 0x0d45, 0x0d49, 0x0d49, 0x0d4e, 0x0d56, 0x0d58, 0x0d5f, 0x0d62, 0x0d65, 0x0d70, 0x0d81, 0x0d84, 0x0d84, 0x0d97, 0x0d99, 0x0db2, 0x0db2, 0x0dbc, 0x0dbc, 0x0dbe, 0x0dbf, 0x0dc7, 0x0dc9, 0x0dcb, 0x0dce, 0x0dd5, 0x0dd5, 0x0dd7, 0x0dd7, 0x0de0, 0x0df1, 0x0df5, 0x0e00, 0x0e3b, 0x0e3e, 0x0e5c, 0x0e80, 0x0e83, 0x0e83, 0x0e85, 0x0e86, 0x0e89, 0x0e89, 0x0e8b, 0x0e8c, 0x0e8e, 0x0e93, 0x0e98, 0x0e98, 0x0ea0, 0x0ea0, 0x0ea4, 0x0ea4, 0x0ea6, 0x0ea6, 0x0ea8, 0x0ea9, 0x0eac, 0x0eac, 0x0eba, 0x0eba, 0x0ebe, 0x0ebf, 0x0ec5, 0x0ec5, 0x0ec7, 0x0ec7, 0x0ece, 0x0ecf, 0x0eda, 0x0edb, 0x0ede, 0x0eff, 0x0f48, 0x0f48, 0x0f6b, 0x0f70, 0x0f8c, 0x0f8f, 0x0f98, 0x0f98, 0x0fbd, 0x0fbd, 0x0fcd, 0x0fce, 0x0fd0, 0x0fff, 0x1022, 0x1022, 0x1028, 0x1028, 0x102b, 0x102b, 0x1033, 0x1035, 0x103a, 0x103f, 0x105a, 0x109f, 0x10c6, 0x10cf, 0x10f9, 0x10fa, 0x10fc, 0x10ff, 0x115a, 0x115e, 0x11a3, 0x11a7, 0x11fa, 0x11ff, 0x1207, 0x1207, 0x1247, 0x1247, 0x1249, 0x1249, 0x124e, 0x124f, 0x1257, 0x1257, 0x1259, 0x1259, 0x125e, 0x125f, 0x1287, 0x1287, 0x1289, 0x1289, 0x128e, 0x128f, 0x12af, 0x12af, 0x12b1, 0x12b1, 0x12b6, 0x12b7, 0x12bf, 0x12bf, 0x12c1, 0x12c1, 0x12c6, 0x12c7, 0x12cf, 0x12cf, 0x12d7, 0x12d7, 0x12ef, 0x12ef, 0x130f, 0x130f, 0x1311, 0x1311, 0x1316, 0x1317, 0x131f, 0x131f, 0x1347, 0x1347, 0x135b, 0x1360, 0x137d, 0x139f, 0x13f5, 0x1400, 0x1677, 0x167f, 0x169d, 0x169f, 0x16f1, 0x16ff, 0x170d, 0x170d, 0x1715, 0x171f, 0x1737, 0x173f, 0x1754, 0x175f, 0x176d, 0x176d, 0x1771, 0x1771, 0x1774, 0x177f, 0x17dd, 0x17df, 0x17ea, 0x17ff, 0x180f, 0x180f, 0x181a, 0x181f, 0x1878, 0x187f, 0x18aa, 0x1dff, 0x1e9c, 0x1e9f, 0x1efa, 0x1eff, 0x1f16, 0x1f17, 0x1f1e, 0x1f1f, 0x1f46, 0x1f47, 0x1f4e, 0x1f4f, 0x1f58, 0x1f58, 0x1f5a, 0x1f5a, 0x1f5c, 0x1f5c, 0x1f5e, 0x1f5e, 0x1f7e, 0x1f7f, 0x1fb5, 0x1fb5, 0x1fc5, 0x1fc5, 0x1fd4, 0x1fd5, 0x1fdc, 0x1fdc, 0x1ff0, 0x1ff1, 0x1ff5, 0x1ff5, 0x1fff, 0x1fff, 0x2053, 0x2056, 0x2058, 0x205e, 0x2064, 0x2069, 0x2072, 0x2073, 0x208f, 0x209f, 0x20b2, 0x20cf, 0x20eb, 0x20ff, 0x213b, 0x213c, 0x214c, 0x2152, 0x2184, 0x218f, 0x23cf, 0x23ff, 0x2427, 0x243f, 0x244b, 0x245f, 0x24ff, 0x24ff, 0x2614, 0x2615, 0x2618, 0x2618, 0x267e, 0x267f, 0x268a, 0x2700, 0x2705, 0x2705, 0x270a, 0x270b, 0x2728, 0x2728, 0x274c, 0x274c, 0x274e, 0x274e, 0x2753, 0x2755, 0x2757, 0x2757, 0x275f, 0x2760, 0x2795, 0x2797, 0x27b0, 0x27b0, 0x27bf, 0x27cf, 0x27ec, 0x27ef, 0x2b00, 0x2e7f, 0x2e9a, 0x2e9a, 0x2ef4, 0x2eff, 0x2fd6, 0x2fef, 0x2ffc, 0x2fff, 0x3040, 0x3040, 0x3097, 0x3098, 0x3100, 0x3104, 0x312d, 0x3130, 0x318f, 0x318f, 0x31b8, 0x31ef, 0x321d, 0x321f, 0x3244, 0x3250, 0x327c, 0x327e, 0x32cc, 0x32cf, 0x32ff, 0x32ff, 0x3377, 0x337a, 0x33de, 0x33df, 0x33ff, 0x33ff, 0x4db6, 0x4dff, 0x9fa6, 0x9fff, 0xa48d, 0xa48f, 0xa4c7, 0xabff, 0xd7a4, 0xd7ff, 0xfa2e, 0xfa2f, 0xfa6b, 0xfaff, 0xfb07, 0xfb12, 0xfb18, 0xfb1c, 0xfb37, 0xfb37, 0xfb3d, 0xfb3d, 0xfb3f, 0xfb3f, 0xfb42, 0xfb42, 0xfb45, 0xfb45, 0xfbb2, 0xfbd2, 0xfd40, 0xfd4f, 0xfd90, 0xfd91, 0xfdc8, 0xfdcf, 0xfdfd, 0xfdff, 0xfe10, 0xfe1f, 0xfe24, 0xfe2f, 0xfe47, 0xfe48, 0xfe53, 0xfe53, 0xfe67, 0xfe67, 0xfe6c, 0xfe6f, 0xfe75, 0xfe75, 0xfefd, 0xfefe, 0xff00, 0xff00, 0xffbf, 0xffc1, 0xffc8, 0xffc9, 0xffd0, 0xffd1, 0xffd8, 0xffd9, 0xffdd, 0xffdf, 0xffe7, 0xffe7, 0xffef, 0xfff8, 0x10000, 0x102ff, 0x1031f, 0x1031f, 0x10324, 0x1032f, 0x1034b, 0x103ff, 0x10426, 0x10427, 0x1044e, 0x1cfff, 0x1d0f6, 0x1d0ff, 0x1d127, 0x1d129, 0x1d1de, 0x1d3ff, 0x1d455, 0x1d455, 0x1d49d, 0x1d49d, 0x1d4a0, 0x1d4a1, 0x1d4a3, 0x1d4a4, 0x1d4a7, 0x1d4a8, 0x1d4ad, 0x1d4ad, 0x1d4ba, 0x1d4ba, 0x1d4bc, 0x1d4bc, 0x1d4c1, 0x1d4c1, 0x1d4c4, 0x1d4c4, 0x1d506, 0x1d506, 0x1d50b, 0x1d50c, 0x1d515, 0x1d515, 0x1d51d, 0x1d51d, 0x1d53a, 0x1d53a, 0x1d53f, 0x1d53f, 0x1d545, 0x1d545, 0x1d547, 0x1d549, 0x1d551, 0x1d551, 0x1d6a4, 0x1d6a7, 0x1d7ca, 0x1d7cd, 0x1d800, 0x1fffd, 0x2a6d7, 0x2f7ff, 0x2fa1e, 0x2fffd, 0x30000, 0x3fffd, 0x40000, 0x4fffd, 0x50000, 0x5fffd, 0x60000, 0x6fffd, 0x70000, 0x7fffd, 0x80000, 0x8fffd, 0x90000, 0x9fffd, 0xa0000, 0xafffd, 0xb0000, 0xbfffd, 0xc0000, 0xcfffd, 0xd0000, 0xdfffd, 0xe0000, 0xe0000, 0xe0002, 0xe001f, 0xe0080, 0xefffd]; // prettier-ignore-end
 
 const isUnassignedCodePoint = character => inRange(character, unassigned_code_points); // prettier-ignore-start
 
-/**
- * B.1 Commonly mapped to nothing
- * @link https://tools.ietf.org/html/rfc3454#appendix-B.1
+/**
+ * B.1 Commonly mapped to nothing
+ * @link https://tools.ietf.org/html/rfc3454#appendix-B.1
  */
 
 
@@ -497,9 +497,9 @@ const commonly_mapped_to_nothing = [0x00ad, 0x00ad, 0x034f, 0x034f, 0x1806, 0x18
 
 const isCommonlyMappedToNothing = character => inRange(character, commonly_mapped_to_nothing); // prettier-ignore-start
 
-/**
- * C.1.2 Non-ASCII space characters
- * @link https://tools.ietf.org/html/rfc3454#appendix-C.1.2
+/**
+ * C.1.2 Non-ASCII space characters
+ * @link https://tools.ietf.org/html/rfc3454#appendix-C.1.2
  */
 
 
@@ -543,9 +543,9 @@ const isNonASCIISpaceCharacter = character => inRange(character, non_ASCII_space
 
 
 const non_ASCII_controls_characters = [
-/**
- * C.2.2 Non-ASCII control characters
- * @link https://tools.ietf.org/html/rfc3454#appendix-C.2.2
+/**
+ * C.2.2 Non-ASCII control characters
+ * @link https://tools.ietf.org/html/rfc3454#appendix-C.2.2
  */
 0x0080, 0x009f
 /* [CONTROL CHARACTERS] */
@@ -581,9 +581,9 @@ const non_ASCII_controls_characters = [
 /* [MUSICAL CONTROL CHARACTERS] */
 ];
 const non_character_codepoints = [
-/**
- * C.4 Non-character code points
- * @link https://tools.ietf.org/html/rfc3454#appendix-C.4
+/**
+ * C.4 Non-character code points
+ * @link https://tools.ietf.org/html/rfc3454#appendix-C.4
  */
 0xfdd0, 0xfdef
 /* [NONCHARACTER CODE POINTS] */
@@ -620,23 +620,23 @@ const non_character_codepoints = [
 , 0x10fffe, 0x10ffff
 /* [NONCHARACTER CODE POINTS] */
 ];
-/**
- * 2.3.  Prohibited Output
+/**
+ * 2.3.  Prohibited Output
  */
 
 const prohibited_characters = [
-/**
- * C.2.1 ASCII control characters
- * @link https://tools.ietf.org/html/rfc3454#appendix-C.2.1
+/**
+ * C.2.1 ASCII control characters
+ * @link https://tools.ietf.org/html/rfc3454#appendix-C.2.1
  */
 0, 0x001f
 /* [CONTROL CHARACTERS] */
 , 0x007f, 0x007f
 /* DELETE */
 ,
-/**
- * C.8 Change display properties or are deprecated
- * @link https://tools.ietf.org/html/rfc3454#appendix-C.8
+/**
+ * C.8 Change display properties or are deprecated
+ * @link https://tools.ietf.org/html/rfc3454#appendix-C.8
  */
 0x0340, 0x0340
 /* COMBINING GRAVE TONE MARK */
@@ -669,28 +669,28 @@ const prohibited_characters = [
 , 0x206f, 0x206f
 /* NOMINAL DIGIT SHAPES */
 ,
-/**
- * C.7 Inappropriate for canonical representation
- * @link https://tools.ietf.org/html/rfc3454#appendix-C.7
+/**
+ * C.7 Inappropriate for canonical representation
+ * @link https://tools.ietf.org/html/rfc3454#appendix-C.7
  */
 0x2ff0, 0x2ffb
 /* [IDEOGRAPHIC DESCRIPTION CHARACTERS] */
 ,
-/**
- * C.5 Surrogate codes
- * @link https://tools.ietf.org/html/rfc3454#appendix-C.5
+/**
+ * C.5 Surrogate codes
+ * @link https://tools.ietf.org/html/rfc3454#appendix-C.5
  */
 0xd800, 0xdfff,
-/**
- * C.3 Private use
- * @link https://tools.ietf.org/html/rfc3454#appendix-C.3
+/**
+ * C.3 Private use
+ * @link https://tools.ietf.org/html/rfc3454#appendix-C.3
  */
 0xe000, 0xf8ff
 /* [PRIVATE USE, PLANE 0] */
 ,
-/**
- * C.6 Inappropriate for plain text
- * @link https://tools.ietf.org/html/rfc3454#appendix-C.6
+/**
+ * C.6 Inappropriate for plain text
+ * @link https://tools.ietf.org/html/rfc3454#appendix-C.6
  */
 0xfff9, 0xfff9
 /* INTERLINEAR ANNOTATION ANCHOR */
@@ -703,18 +703,18 @@ const prohibited_characters = [
 , 0xfffd, 0xfffd
 /* REPLACEMENT CHARACTER */
 ,
-/**
- * C.9 Tagging characters
- * @link https://tools.ietf.org/html/rfc3454#appendix-C.9
+/**
+ * C.9 Tagging characters
+ * @link https://tools.ietf.org/html/rfc3454#appendix-C.9
  */
 0xe0001, 0xe0001
 /* LANGUAGE TAG */
 , 0xe0020, 0xe007f
 /* [TAGGING CHARACTERS] */
 ,
-/**
- * C.3 Private use
- * @link https://tools.ietf.org/html/rfc3454#appendix-C.3
+/**
+ * C.3 Private use
+ * @link https://tools.ietf.org/html/rfc3454#appendix-C.3
  */
 0xf0000, 0xffffd
 /* [PRIVATE USE, PLANE 15] */
@@ -724,9 +724,9 @@ const prohibited_characters = [
 
 const isProhibitedCharacter = character => inRange(character, non_ASCII_space_characters) || inRange(character, prohibited_characters) || inRange(character, non_ASCII_controls_characters) || inRange(character, non_character_codepoints); // prettier-ignore-start
 
-/**
- * D.1 Characters with bidirectional property "R" or "AL"
- * @link https://tools.ietf.org/html/rfc3454#appendix-D.1
+/**
+ * D.1 Characters with bidirectional property "R" or "AL"
+ * @link https://tools.ietf.org/html/rfc3454#appendix-D.1
  */
 
 
@@ -734,9 +734,9 @@ const bidirectional_r_al = [0x05be, 0x05be, 0x05c0, 0x05c0, 0x05c3, 0x05c3, 0x05
 
 const isBidirectionalRAL = character => inRange(character, bidirectional_r_al); // prettier-ignore-start
 
-/**
- * D.2 Characters with bidirectional property "L"
- * @link https://tools.ietf.org/html/rfc3454#appendix-D.2
+/**
+ * D.2 Characters with bidirectional property "L"
+ * @link https://tools.ietf.org/html/rfc3454#appendix-D.2
  */
 
 
@@ -744,15 +744,15 @@ const bidirectional_l = [0x0041, 0x005a, 0x0061, 0x007a, 0x00aa, 0x00aa, 0x00b5,
 
 const isBidirectionalL = character => inRange(character, bidirectional_l);
 
-/**
- * non-ASCII space characters [StringPrep, C.1.2] that can be
- * mapped to SPACE (U+0020)
+/**
+ * non-ASCII space characters [StringPrep, C.1.2] that can be
+ * mapped to SPACE (U+0020)
  */
 
 const mapping2space = isNonASCIISpaceCharacter;
-/**
- * the "commonly mapped to nothing" characters [StringPrep, B.1]
- * that can be mapped to nothing.
+/**
+ * the "commonly mapped to nothing" characters [StringPrep, B.1]
+ * that can be mapped to nothing.
  */
 
 const mapping2nothing = isCommonlyMappedToNothing; // utils
@@ -762,12 +762,12 @@ const getCodePoint = character => character.codePointAt(0);
 const first = x => x[0];
 
 const last = x => x[x.length - 1];
-/**
- * Convert provided string into an array of Unicode Code Points.
- * Based on https://stackoverflow.com/a/21409165/1556249
- * and https://www.npmjs.com/package/code-point-at.
- * @param {string} input
- * @returns {number[]}
+/**
+ * Convert provided string into an array of Unicode Code Points.
+ * Based on https://stackoverflow.com/a/21409165/1556249
+ * and https://www.npmjs.com/package/code-point-at.
+ * @param {string} input
+ * @returns {number[]}
  */
 
 
@@ -793,12 +793,12 @@ function toCodePoints(input) {
 
   return codepoints;
 }
-/**
- * SASLprep.
- * @param {string} input
- * @param {Object} opts
- * @param {boolean} opts.allowUnassigned
- * @returns {string}
+/**
+ * SASLprep.
+ * @param {string} input
+ * @param {Object} opts
+ * @param {boolean} opts.allowUnassigned
+ * @returns {string}
  */
 
 
@@ -842,10 +842,10 @@ function saslprep(input, opts = {}) {
   if (hasBidiRAL && hasBidiL) {
     throw new Error('String must not contain RandALCat and LCat at the same time,' + ' see https://tools.ietf.org/html/rfc3454#section-6');
   }
-  /**
-   * 4.2 If a string contains any RandALCat character, a RandALCat
-   * character MUST be the first character of the string, and a
-   * RandALCat character MUST be the last character of the string.
+  /**
+   * 4.2 If a string contains any RandALCat character, a RandALCat
+   * character MUST be the first character of the string, and a
+   * RandALCat character MUST be the last character of the string.
    */
 
 
@@ -859,9 +859,9 @@ function saslprep(input, opts = {}) {
   return normalized_input;
 }
 
-/*
-   PDFSecurity - represents PDF security settings
-   By Yang Liu <hi@zesik.com>
+/*
+   PDFSecurity - represents PDF security settings
+   By Yang Liu <hi@zesik.com>
  */
 
 class PDFSecurity {
@@ -4482,9 +4482,9 @@ class PNGImage {
 
 }
 
-/*
-PDFImage - embeds images in PDF documents
-By Devon Govett
+/*
+PDFImage - embeds images in PDF documents
+By Devon Govett
 */
 
 class PDFImage {
@@ -4957,9 +4957,9 @@ function _objectSpread2(target) {
   return target;
 }
 
-/*
-PDFStructureContent - a reference to a marked structure content
-By Ben Schmidt
+/*
+PDFStructureContent - a reference to a marked structure content
+By Ben Schmidt
 */
 class PDFStructureContent {
   constructor(pageRef, mcid) {
@@ -4975,9 +4975,9 @@ class PDFStructureContent {
 
 }
 
-/*
-PDFStructureElement - represents an element in the PDF logical structure tree
-By Ben Schmidt
+/*
+PDFStructureElement - represents an element in the PDF logical structure tree
+By Ben Schmidt
 */
 
 class PDFStructureElement {
@@ -5191,8 +5191,8 @@ class PDFStructureElement {
 
 }
 
-/*
-PDFNumberTree - represents a number tree object
+/*
+PDFNumberTree - represents a number tree object
 */
 
 class PDFNumberTree extends PDFTree {
@@ -5436,9 +5436,9 @@ const FORMAT_DEFAULT = {
   }
 };
 var AcroFormMixin = {
-  /**
-   * Must call if adding AcroForms to a document. Must also call font() before
-   * this method to set the default font.
+  /**
+   * Must call if adding AcroForms to a document. Must also call font() before
+   * this method to set the default font.
    */
   initForm() {
     if (!this._font) {
@@ -5464,8 +5464,8 @@ var AcroFormMixin = {
     return this;
   },
 
-  /**
-   * Called automatically by document.js
+  /**
+   * Called automatically by document.js
    */
   endAcroForm() {
     if (this._root.data.AcroForm) {
@@ -5499,12 +5499,12 @@ var AcroFormMixin = {
     return this;
   },
 
-  /**
-   * Creates and adds a form field to the document. Form fields are intermediate
-   * nodes in a PDF form that are used to specify form name heirarchy and form
-   * value defaults.
-   * @param {string} name - field name (T attribute in field dictionary)
-   * @param {object} options  - other attributes to include in field dictionary
+  /**
+   * Creates and adds a form field to the document. Form fields are intermediate
+   * nodes in a PDF form that are used to specify form name heirarchy and form
+   * value defaults.
+   * @param {string} name - field name (T attribute in field dictionary)
+   * @param {object} options  - other attributes to include in field dictionary
    */
   formField(name, options = {}) {
     let fieldDict = this._fieldDict(name, null, options);
@@ -5516,16 +5516,16 @@ var AcroFormMixin = {
     return fieldRef;
   },
 
-  /**
-   * Creates and adds a Form Annotation to the document. Form annotations are
-   * called Widget annotations internally within a PDF file.
-   * @param {string} name - form field name (T attribute of widget annotation
-   * dictionary)
-   * @param {number} x
-   * @param {number} y
-   * @param {number} w
-   * @param {number} h
-   * @param {object} options
+  /**
+   * Creates and adds a Form Annotation to the document. Form annotations are
+   * called Widget annotations internally within a PDF file.
+   * @param {string} name - form field name (T attribute of widget annotation
+   * dictionary)
+   * @param {number} x
+   * @param {number} y
+   * @param {number} w
+   * @param {number} h
+   * @param {object} options
    */
   formAnnotation(name, type, x, y, w, h, options = {}) {
     let fieldDict = this._fieldDict(name, type, options);
@@ -5811,17 +5811,17 @@ var AcroFormMixin = {
 };
 
 var AttachmentsMixin = {
-  /**
-   * Embed contents of `src` in PDF
-   * @param {Buffer | ArrayBuffer | string} src input Buffer, ArrayBuffer, base64 encoded string or path to file
-   * @param {object} options
-   *  * options.name: filename to be shown in PDF, will use `src` if none set
-   *  * options.type: filetype to be shown in PDF
-   *  * options.description: description to be shown in PDF
-   *  * options.hidden: if true, do not add attachment to EmbeddedFiles dictionary. Useful for file attachment annotations
-   *  * options.creationDate: override creation date
-   *  * options.modifiedDate: override modified date
-   * @returns filespec reference
+  /**
+   * Embed contents of `src` in PDF
+   * @param {Buffer | ArrayBuffer | string} src input Buffer, ArrayBuffer, base64 encoded string or path to file
+   * @param {object} options
+   *  * options.name: filename to be shown in PDF, will use `src` if none set
+   *  * options.type: filetype to be shown in PDF
+   *  * options.description: description to be shown in PDF
+   *  * options.hidden: if true, do not add attachment to EmbeddedFiles dictionary. Useful for file attachment annotations
+   *  * options.creationDate: override creation date
+   *  * options.modifiedDate: override modified date
+   * @returns filespec reference
    */
   file(src, options = {}) {
     options.name = options.name || src;
@@ -5934,9 +5934,9 @@ function isEqual(a, b) {
   return true;
 }
 
-/*
-PDFDocument - represents an entire PDF document
-By Devon Govett
+/*
+PDFDocument - represents an entire PDF document
+By Devon Govett
 */
 
 class PDFDocument extends stream.Readable {