@pdfme/pdf-lib 1.18.4 → 5.4.0-dev.21

package/__tests__/core/writers/PDFWriter.spec.ts

@@ -0,0 +1,144 @@
+import pako from 'pako';
+import {
+  mergeIntoTypedArray,
+  PDFContext,
+  PDFName,
+  PDFRef,
+  PDFWriter,
+  typedArrayFor,
+} from '../../../src/index';
+
+const contentStreamText = `
+  BT
+    /F1 24 Tf
+    100 100 Td
+    (Hello World and stuff!) Tj
+  ET
+`;
+
+const encodedContentStream = pako.deflate(typedArrayFor(contentStreamText));
+
+const pdfBytes = mergeIntoTypedArray(
+  `%PDF-1.7
+%
+
+9000 0 obj
+<<
+/Filter /FlateDecode
+/Length 67
+>>
+stream
+`,
+  encodedContentStream,
+  `
+endstream
+endobj
+
+9001 0 obj
+<<
+/Type /Font
+/Subtype /Type1
+/Name /F1
+/BaseFont /Helvetica
+/Encoding /MacRomanEncoding
+>>
+endobj
+
+9002 0 obj
+<<
+/Type /Page
+/MediaBox [ 0 0 612 792 ]
+/Contents 9000 0 R
+/Resources <<
+/Font <<
+/F1 9001 0 R
+>>
+>>
+/Parent 9003 0 R
+>>
+endobj
+
+9003 0 obj
+<<
+/Type /Pages
+/Kids [ 9002 0 R ]
+/Count 1
+>>
+endobj
+
+9004 0 obj
+<<
+/Type /Catalog
+/Pages 9003 0 R
+>>
+endobj
+
+xref
+0 1
+0000000000 65535 f 
+9000 5
+0000000016 00000 n 
+0000000158 00000 n 
+0000000270 00000 n 
+0000000411 00000 n 
+0000000477 00000 n 
+
+trailer
+<<
+/Size 9005
+/Root 9004 0 R
+>>
+
+startxref
+533
+%%EOF`,
+);
+
+describe(`PDFWriter`, () => {
+  it(`serializes PDFContext objects using Indirect Objects and a Cross Reference table`, async () => {
+    const context = PDFContext.create();
+
+    const contentStream = context.flateStream(contentStreamText);
+    const contentStreamRef = PDFRef.of(9000);
+    context.assign(contentStreamRef, contentStream);
+
+    const fontDict = context.obj({
+      Type: 'Font',
+      Subtype: 'Type1',
+      Name: 'F1',
+      BaseFont: 'Helvetica',
+      Encoding: 'MacRomanEncoding',
+    });
+    const fontDictRef = context.register(fontDict);
+
+    const page = context.obj({
+      Type: 'Page',
+      MediaBox: [0, 0, 612, 792],
+      Contents: contentStreamRef,
+      Resources: { Font: { F1: fontDictRef } },
+    });
+    const pageRef = context.register(page);
+
+    const pages = context.obj({
+      Type: 'Pages',
+      Kids: [pageRef],
+      Count: 1,
+    });
+    const pagesRef = context.register(pages);
+    page.set(PDFName.of('Parent'), pagesRef);
+
+    const catalog = context.obj({
+      Type: 'Catalog',
+      Pages: pagesRef,
+    });
+    context.trailerInfo.Root = context.register(catalog);
+
+    const buffer = await PDFWriter.forContext(
+      context,
+      Infinity,
+    ).serializeToBuffer();
+
+    expect(buffer.length).toBe(pdfBytes.length);
+    expect(buffer).toEqual(pdfBytes);
+  });
+});

package/__tests__/index.test.ts

@@ -0,0 +1,12 @@
+import { PDFDocument } from '../src';
+
+describe('pdf-lib basic functionality', () => {
+  test('should create a new PDF document', async () => {
+    const pdfDoc = await PDFDocument.create();
+    expect(pdfDoc).toBeDefined();
+  });
+
+  test('should export main classes', () => {
+    expect(PDFDocument).toBeDefined();
+  });
+});

package/__tests__/utils/base64.spec.ts

@@ -0,0 +1,61 @@
+import fs from 'fs';
+import { decodeFromBase64DataUri } from '../../src/utils';
+
+const pdfBytes = fs.readFileSync(`${__dirname}/data/simple.pdf`);
+const pdfBase64Bytes = fs.readFileSync(`${__dirname}/data/simple.pdf.base64`);
+
+// Jest stalls when comparing large arrays, so we'll use this instead
+const arraysAreEqual = (a: Uint8Array, b: Uint8Array) => {
+  if (a.length !== b.length) return false;
+  for (let idx = 0, len = a.length; idx < len; idx++) {
+    if (a[idx] !== b[idx]) return false;
+  }
+  return true;
+};
+
+describe(`decodeFromBase64DataUri`, () => {
+  it(`can decode plain base64 strings`, () => {
+    const uri = String(pdfBase64Bytes);
+    expect(arraysAreEqual(decodeFromBase64DataUri(uri), pdfBytes)).toBe(true);
+  });
+
+  it(`can decode complete data URIs`, () => {
+    const uri = `data:application/pdf;base64,${pdfBase64Bytes}`;
+    expect(arraysAreEqual(decodeFromBase64DataUri(uri), pdfBytes)).toBe(true);
+  });
+
+  it(`can decode partial data URIs (1)`, () => {
+    const uri = `data:application/pdf;,${pdfBase64Bytes}`;
+    expect(arraysAreEqual(decodeFromBase64DataUri(uri), pdfBytes)).toBe(true);
+  });
+
+  it(`can decode partial data URIs (2)`, () => {
+    const uri = `data:;,${pdfBase64Bytes}`;
+    expect(arraysAreEqual(decodeFromBase64DataUri(uri), pdfBytes)).toBe(true);
+  });
+
+  it(`can decode partial data URIs (3)`, () => {
+    const uri = `data:application/pdf;,${pdfBase64Bytes}`;
+    expect(arraysAreEqual(decodeFromBase64DataUri(uri), pdfBytes)).toBe(true);
+  });
+
+  it(`can decode partial data URIs (4)`, () => {
+    const uri = `:;,${pdfBase64Bytes}`;
+    expect(arraysAreEqual(decodeFromBase64DataUri(uri), pdfBytes)).toBe(true);
+  });
+
+  it(`can decode partial data URIs (5)`, () => {
+    const uri = `;,${pdfBase64Bytes}`;
+    expect(arraysAreEqual(decodeFromBase64DataUri(uri), pdfBytes)).toBe(true);
+  });
+
+  it(`can decode partial data URIs (6)`, () => {
+    const uri = `,${pdfBase64Bytes}`;
+    expect(arraysAreEqual(decodeFromBase64DataUri(uri), pdfBytes)).toBe(true);
+  });
+
+  it(`can throws an error when it fails to parse the URI`, () => {
+    const uri = {} as any;
+    expect(() => decodeFromBase64DataUri(uri)).toThrow();
+  });
+});

package/__tests__/utils/data/simple.pdf

@@ -0,0 +1,201 @@
+%PDF-2.0
+
+1 0 obj
+<<
+  /Type /Catalog
+  /Metadata 2 0 R
+  /Pages 3 0 R
+>>
+endobj
+
+2 0 obj
+<<
+  /Length 2351
+  /Type /Metadata
+  /Subtype /XML
+>>
+stream
+<x:xmpmeta xmlns:x='adobe:ns:meta/' x:xmptk='Insert XMP tool name here.'>
+  <rdf:RDF xmlns:rdf='http://www.w3.org/1999/02/22-rdf-syntax-ns#'>
+    <rdf:Description rdf:about="" xmlns:pdf="http://ns.adobe.com/pdf/1.3/">
+      <pdf:Producer>Datalogics - example producer program name here</pdf:Producer>
+      <pdf:Copyright>Copyright 2017 PDF Association</pdf:Copyright>
+      <pdf:Keywords>PDF 2.0 sample example</pdf:Keywords>
+    </rdf:Description>
+    <rdf:Description rdf:about="" xmlns:xap="http://ns.adobe.com/xap/1.0/">
+      <xap:CreateDate>2017-05-24T10:30:11Z</xap:CreateDate>
+      <xap:MetadataDate>2017-07-11T07:55:11Z</xap:MetadataDate>
+      <xap:ModifyDate>2017-07-11T07:55:11Z</xap:ModifyDate>
+      <xap:CreatorTool>Datalogics - example creator tool name here</xap:CreatorTool>
+    </rdf:Description>
+    <rdf:Description rdf:about="" xmlns:dc="http://purl.org/dc/elements/1.1/">
+      <dc:format>application/pdf</dc:format>
+      <dc:title>
+        <rdf:Alt>
+          <rdf:li xml:lang="x-default">A simple PDF 2.0 example file</rdf:li>
+        </rdf:Alt>
+      </dc:title>
+      <dc:creator>
+        <rdf:Seq>
+          <rdf:li>Datalogics Incorporated</rdf:li>
+        </rdf:Seq>
+      </dc:creator>
+      <dc:description>
+        <rdf:Alt>
+          <rdf:li xml:lang="x-default">Demonstration of a simple PDF 2.0 file.</rdf:li>
+        </rdf:Alt>
+      </dc:description>
+      <dc:rights>
+        <rdf:Alt>
+          <rdf:li xml:lang="x-default">Copyright 2017 PDF Association. Licensed to the public under Creative Commons Attribution-ShareAlike 4.0 International license.</rdf:li>
+        </rdf:Alt>
+      </dc:rights>
+    </rdf:Description>
+    <rdf:Description rdf:about="" xmlns:xapRights="http://ns.adobe.com/xap/1.0/rights/">
+      <xapRights:Marked>True</xapRights:Marked>
+    </rdf:Description>
+    <rdf:Description rdf:about="" xmlns:cc="http://creativecommons.org/ns#">
+      <cc:license rdf:resource="https://creativecommons.org/licenses/sa/4.0/" />
+    </rdf:Description>
+    <rdf:Description rdf:about="" xmlns:xapMM="http://ns.adobe.com/xap/1.0/mm/">
+      <xapMM:DocumentID>uuid:3eef2166-8332-abb4-3d31-77334578873f</xapMM:DocumentID>
+      <xapMM:InstanceID>uuid:991bcce7-ee70-11a3-91aa-77bbe2181fd8</xapMM:InstanceID>
+    </rdf:Description>
+  </rdf:RDF>
+</x:xmpmeta>
+endstream
+endobj
+
+3 0 obj
+<<
+  /Type /Pages
+  /Kids [4 0 R]
+  /Count 1
+>>
+endobj
+
+4 0 obj
+<<
+  /Type /Page
+  /Parent 3 0 R
+  /MediaBox [0 0 612 396]
+  /Contents [5 0 R 6 0 R]
+  /Resources <<
+    /Font << /F1 7 0 R >>
+  >>
+>>
+endobj
+
+5 0 obj
+<< /Length 744 >>
+stream
+% Save the current graphic state
+q 
+
+% Draw a black line segment, using the default line width.
+150 250 m
+150 350 l
+S
+
+% Draw a thicker, dashed line segment.
+4 w % Set line width to 4 points
+[4 6] 0 d % Set dash pattern to 4 units on, 6 units off
+150 250 m
+400 250 l
+S
+[] 0 d % Reset dash pattern to a solid line
+1 w % Reset line width to 1 unit
+
+% Draw a rectangle with a 1-unit red border, filled with light blue.
+1.0 0.0 0.0 RG % Red for stroke color
+0.5 0.75 1.0 rg % Light blue for fill color
+200 300 50 75 re
+B
+
+% Draw a curve filled with gray and with a colored border.
+0.5 0.1 0.2 RG
+0.7 g
+300 300 m
+300 400 400 400 400 300 c
+b
+
+% Restore the graphic state to what it was at the beginning of this stream
+Q
+
+endstream
+endobj
+
+6 0 obj
+<< /Length 166 >>
+stream
+% A text block that shows "Hello World"
+% No color is set, so this defaults to black in DeviceGray colorspace
+BT
+  /F1 24 Tf
+  100 100 Td
+  (Hello World) Tj
+ET
+endstream
+endobj
+
+7 0 obj
+<<
+  /Type /Font
+  /Subtype /Type1
+  /BaseFont /Helvetica
+  /FirstChar 33
+  /LastChar 126
+  /Widths 8 0 R
+  /FontDescriptor 9 0 R
+>>
+endobj
+
+8 0 obj
+[ 278 355 556 556 889 667 222 333 333 389 584 278 333 278 278 556
+  556 556 556 556 556 556 556 556 556 278 278 584 584 584 556 1015
+  667 667 722 722 667 611 778 722 278 500 667 556 833 722 778 667
+  778 722 667 611 722 667 944 667 667 611 278 278 278 469 556 222
+  556 556 500 556 556 278 556 556 222 222 500 222 833 556 556 556
+  556 333 500 278 556 500 722 500 500 500 334 260 334 584 ]
+endobj
+
+% This FontDescriptor contains only the required entries for PDF 2.0
+% for unembedded standard 14 fonts that contain Latin characters
+9 0 obj
+<<
+  /Type /FontDescriptor
+  /FontName /Helvetica
+  /Flags 32
+  /FontBBox [ -166 -225 1000 931 ]
+  /ItalicAngle 0
+  /Ascent 718
+  /Descent -207
+  /CapHeight 718
+  /StemV 88
+  /MissingWidth 0  
+>>
+endobj
+
+% The object cross-reference table. The first entry
+% denotes the start of PDF data in this file.
+xref
+0 10
+0000000000 65535 f
+0000000012 00000 n
+0000000092 00000 n
+0000002543 00000 n
+0000002615 00000 n
+0000002778 00000 n
+0000003583 00000 n
+0000003807 00000 n
+0000003968 00000 n
+0000004520 00000 n
+trailer
+<<
+  /Size 10
+  /Root 1 0 R
+  /ID [ <31c7a8a269e4c59bc3cd7df0dabbf388><31c7a8a269e4c59bc3cd7df0dabbf388> ]
+>>
+startxref
+4847
+%%EOF

package/__tests__/utils/data/simple.pdf.base64

@@ -0,0 +1 @@
+JVBERi0yLjANCg0KMSAwIG9iag0KPDwNCiAgL1R5cGUgL0NhdGFsb2cNCiAgL01ldGFkYXRhIDIgMCBSDQogIC9QYWdlcyAzIDAgUg0KPj4NCmVuZG9iag0KDQoyIDAgb2JqDQo8PA0KICAvTGVuZ3RoIDIzNTENCiAgL1R5cGUgL01ldGFkYXRhDQogIC9TdWJ0eXBlIC9YTUwNCj4+DQpzdHJlYW0NCjx4OnhtcG1ldGEgeG1sbnM6eD0nYWRvYmU6bnM6bWV0YS8nIHg6eG1wdGs9J0luc2VydCBYTVAgdG9vbCBuYW1lIGhlcmUuJz4NCiAgPHJkZjpSREYgeG1sbnM6cmRmPSdodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjJz4NCiAgICA8cmRmOkRlc2NyaXB0aW9uIHJkZjphYm91dD0iIiB4bWxuczpwZGY9Imh0dHA6Ly9ucy5hZG9iZS5jb20vcGRmLzEuMy8iPg0KICAgICAgPHBkZjpQcm9kdWNlcj5EYXRhbG9naWNzIC0gZXhhbXBsZSBwcm9kdWNlciBwcm9ncmFtIG5hbWUgaGVyZTwvcGRmOlByb2R1Y2VyPg0KICAgICAgPHBkZjpDb3B5cmlnaHQ+Q29weXJpZ2h0IDIwMTcgUERGIEFzc29jaWF0aW9uPC9wZGY6Q29weXJpZ2h0Pg0KICAgICAgPHBkZjpLZXl3b3Jkcz5QREYgMi4wIHNhbXBsZSBleGFtcGxlPC9wZGY6S2V5d29yZHM+DQogICAgPC9yZGY6RGVzY3JpcHRpb24+DQogICAgPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eGFwPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIj4NCiAgICAgIDx4YXA6Q3JlYXRlRGF0ZT4yMDE3LTA1LTI0VDEwOjMwOjExWjwveGFwOkNyZWF0ZURhdGU+DQogICAgICA8eGFwOk1ldGFkYXRhRGF0ZT4yMDE3LTA3LTExVDA3OjU1OjExWjwveGFwOk1ldGFkYXRhRGF0ZT4NCiAgICAgIDx4YXA6TW9kaWZ5RGF0ZT4yMDE3LTA3LTExVDA3OjU1OjExWjwveGFwOk1vZGlmeURhdGU+DQogICAgICA8eGFwOkNyZWF0b3JUb29sPkRhdGFsb2dpY3MgLSBleGFtcGxlIGNyZWF0b3IgdG9vbCBuYW1lIGhlcmU8L3hhcDpDcmVhdG9yVG9vbD4NCiAgICA8L3JkZjpEZXNjcmlwdGlvbj4NCiAgICA8cmRmOkRlc2NyaXB0aW9uIHJkZjphYm91dD0iIiB4bWxuczpkYz0iaHR0cDovL3B1cmwub3JnL2RjL2VsZW1lbnRzLzEuMS8iPg0KICAgICAgPGRjOmZvcm1hdD5hcHBsaWNhdGlvbi9wZGY8L2RjOmZvcm1hdD4NCiAgICAgIDxkYzp0aXRsZT4NCiAgICAgICAgPHJkZjpBbHQ+DQogICAgICAgICAgPHJkZjpsaSB4bWw6bGFuZz0ieC1kZWZhdWx0Ij5BIHNpbXBsZSBQREYgMi4wIGV4YW1wbGUgZmlsZTwvcmRmOmxpPg0KICAgICAgICA8L3JkZjpBbHQ+DQogICAgICA8L2RjOnRpdGxlPg0KICAgICAgPGRjOmNyZWF0b3I+DQogICAgICAgIDxyZGY6U2VxPg0KICAgICAgICAgIDxyZGY6bGk+RGF0YWxvZ2ljcyBJbmNvcnBvcmF0ZWQ8L3JkZjpsaT4NCiAgICAgICAgPC9yZGY6U2VxPg0KICAgICAgPC9kYzpjcmVhdG9yPg0KICAgICAgPGRjOmRlc2NyaXB0aW9uPg0KICAgICAgICA8cmRmOkFsdD4NCiAgICAgICAgICA8cmRmOmxpIHhtbDpsYW5nPSJ4LWRlZmF1bHQiPkRlbW9uc3RyYXRpb24gb2YgYSBzaW1wbGUgUERGIDIuMCBmaWxlLjwvcmRmOmxpPg0KICAgICAgICA8L3JkZjpBbHQ+DQogICAgICA8L2RjOmRlc2NyaXB0aW9uPg0KICAgICAgPGRjOnJpZ2h0cz4NCiAgICAgICAgPHJkZjpBbHQ+DQogICAgICAgICAgPHJkZjpsaSB4bWw6bGFuZz0ieC1kZWZhdWx0Ij5Db3B5cmlnaHQgMjAxNyBQREYgQXNzb2NpYXRpb24uIExpY2Vuc2VkIHRvIHRoZSBwdWJsaWMgdW5kZXIgQ3JlYXRpdmUgQ29tbW9ucyBBdHRyaWJ1dGlvbi1TaGFyZUFsaWtlIDQuMCBJbnRlcm5hdGlvbmFsIGxpY2Vuc2UuPC9yZGY6bGk+DQogICAgICAgIDwvcmRmOkFsdD4NCiAgICAgIDwvZGM6cmlnaHRzPg0KICAgIDwvcmRmOkRlc2NyaXB0aW9uPg0KICAgIDxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSIiIHhtbG5zOnhhcFJpZ2h0cz0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL3JpZ2h0cy8iPg0KICAgICAgPHhhcFJpZ2h0czpNYXJrZWQ+VHJ1ZTwveGFwUmlnaHRzOk1hcmtlZD4NCiAgICA8L3JkZjpEZXNjcmlwdGlvbj4NCiAgICA8cmRmOkRlc2NyaXB0aW9uIHJkZjphYm91dD0iIiB4bWxuczpjYz0iaHR0cDovL2NyZWF0aXZlY29tbW9ucy5vcmcvbnMjIj4NCiAgICAgIDxjYzpsaWNlbnNlIHJkZjpyZXNvdXJjZT0iaHR0cHM6Ly9jcmVhdGl2ZWNvbW1vbnMub3JnL2xpY2Vuc2VzL3NhLzQuMC8iIC8+DQogICAgPC9yZGY6RGVzY3JpcHRpb24+DQogICAgPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eGFwTU09Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9tbS8iPg0KICAgICAgPHhhcE1NOkRvY3VtZW50SUQ+dXVpZDozZWVmMjE2Ni04MzMyLWFiYjQtM2QzMS03NzMzNDU3ODg3M2Y8L3hhcE1NOkRvY3VtZW50SUQ+DQogICAgICA8eGFwTU06SW5zdGFuY2VJRD51dWlkOjk5MWJjY2U3LWVlNzAtMTFhMy05MWFhLTc3YmJlMjE4MWZkODwveGFwTU06SW5zdGFuY2VJRD4NCiAgICA8L3JkZjpEZXNjcmlwdGlvbj4NCiAgPC9yZGY6UkRGPg0KPC94OnhtcG1ldGE+DQplbmRzdHJlYW0NCmVuZG9iag0KDQozIDAgb2JqDQo8PA0KICAvVHlwZSAvUGFnZXMNCiAgL0tpZHMgWzQgMCBSXQ0KICAvQ291bnQgMQ0KPj4NCmVuZG9iag0KDQo0IDAgb2JqDQo8PA0KICAvVHlwZSAvUGFnZQ0KICAvUGFyZW50IDMgMCBSDQogIC9NZWRpYUJveCBbMCAwIDYxMiAzOTZdDQogIC9Db250ZW50cyBbNSAwIFIgNiAwIFJdDQogIC9SZXNvdXJjZXMgPDwNCiAgICAvRm9udCA8PCAvRjEgNyAwIFIgPj4NCiAgPj4NCj4+DQplbmRvYmoNCg0KNSAwIG9iag0KPDwgL0xlbmd0aCA3NDQgPj4NCnN0cmVhbQ0KJSBTYXZlIHRoZSBjdXJyZW50IGdyYXBoaWMgc3RhdGUNCnEgDQoNCiUgRHJhdyBhIGJsYWNrIGxpbmUgc2VnbWVudCwgdXNpbmcgdGhlIGRlZmF1bHQgbGluZSB3aWR0aC4NCjE1MCAyNTAgbQ0KMTUwIDM1MCBsDQpTDQoNCiUgRHJhdyBhIHRoaWNrZXIsIGRhc2hlZCBsaW5lIHNlZ21lbnQuDQo0IHcgJSBTZXQgbGluZSB3aWR0aCB0byA0IHBvaW50cw0KWzQgNl0gMCBkICUgU2V0IGRhc2ggcGF0dGVybiB0byA0IHVuaXRzIG9uLCA2IHVuaXRzIG9mZg0KMTUwIDI1MCBtDQo0MDAgMjUwIGwNClMNCltdIDAgZCAlIFJlc2V0IGRhc2ggcGF0dGVybiB0byBhIHNvbGlkIGxpbmUNCjEgdyAlIFJlc2V0IGxpbmUgd2lkdGggdG8gMSB1bml0DQoNCiUgRHJhdyBhIHJlY3RhbmdsZSB3aXRoIGEgMS11bml0IHJlZCBib3JkZXIsIGZpbGxlZCB3aXRoIGxpZ2h0IGJsdWUuDQoxLjAgMC4wIDAuMCBSRyAlIFJlZCBmb3Igc3Ryb2tlIGNvbG9yDQowLjUgMC43NSAxLjAgcmcgJSBMaWdodCBibHVlIGZvciBmaWxsIGNvbG9yDQoyMDAgMzAwIDUwIDc1IHJlDQpCDQoNCiUgRHJhdyBhIGN1cnZlIGZpbGxlZCB3aXRoIGdyYXkgYW5kIHdpdGggYSBjb2xvcmVkIGJvcmRlci4NCjAuNSAwLjEgMC4yIFJHDQowLjcgZw0KMzAwIDMwMCBtDQozMDAgNDAwIDQwMCA0MDAgNDAwIDMwMCBjDQpiDQoNCiUgUmVzdG9yZSB0aGUgZ3JhcGhpYyBzdGF0ZSB0byB3aGF0IGl0IHdhcyBhdCB0aGUgYmVnaW5uaW5nIG9mIHRoaXMgc3RyZWFtDQpRDQoNCmVuZHN0cmVhbQ0KZW5kb2JqDQoNCjYgMCBvYmoNCjw8IC9MZW5ndGggMTY2ID4+DQpzdHJlYW0NCiUgQSB0ZXh0IGJsb2NrIHRoYXQgc2hvd3MgIkhlbGxvIFdvcmxkIg0KJSBObyBjb2xvciBpcyBzZXQsIHNvIHRoaXMgZGVmYXVsdHMgdG8gYmxhY2sgaW4gRGV2aWNlR3JheSBjb2xvcnNwYWNlDQpCVA0KICAvRjEgMjQgVGYNCiAgMTAwIDEwMCBUZA0KICAoSGVsbG8gV29ybGQpIFRqDQpFVA0KZW5kc3RyZWFtDQplbmRvYmoNCg0KNyAwIG9iag0KPDwNCiAgL1R5cGUgL0ZvbnQNCiAgL1N1YnR5cGUgL1R5cGUxDQogIC9CYXNlRm9udCAvSGVsdmV0aWNhDQogIC9GaXJzdENoYXIgMzMNCiAgL0xhc3RDaGFyIDEyNg0KICAvV2lkdGhzIDggMCBSDQogIC9Gb250RGVzY3JpcHRvciA5IDAgUg0KPj4NCmVuZG9iag0KDQo4IDAgb2JqDQpbIDI3OCAzNTUgNTU2IDU1NiA4ODkgNjY3IDIyMiAzMzMgMzMzIDM4OSA1ODQgMjc4IDMzMyAyNzggMjc4IDU1Ng0KICA1NTYgNTU2IDU1NiA1NTYgNTU2IDU1NiA1NTYgNTU2IDU1NiAyNzggMjc4IDU4NCA1ODQgNTg0IDU1NiAxMDE1DQogIDY2NyA2NjcgNzIyIDcyMiA2NjcgNjExIDc3OCA3MjIgMjc4IDUwMCA2NjcgNTU2IDgzMyA3MjIgNzc4IDY2Nw0KICA3NzggNzIyIDY2NyA2MTEgNzIyIDY2NyA5NDQgNjY3IDY2NyA2MTEgMjc4IDI3OCAyNzggNDY5IDU1NiAyMjINCiAgNTU2IDU1NiA1MDAgNTU2IDU1NiAyNzggNTU2IDU1NiAyMjIgMjIyIDUwMCAyMjIgODMzIDU1NiA1NTYgNTU2DQogIDU1NiAzMzMgNTAwIDI3OCA1NTYgNTAwIDcyMiA1MDAgNTAwIDUwMCAzMzQgMjYwIDMzNCA1ODQgXQ0KZW5kb2JqDQoNCiUgVGhpcyBGb250RGVzY3JpcHRvciBjb250YWlucyBvbmx5IHRoZSByZXF1aXJlZCBlbnRyaWVzIGZvciBQREYgMi4wDQolIGZvciB1bmVtYmVkZGVkIHN0YW5kYXJkIDE0IGZvbnRzIHRoYXQgY29udGFpbiBMYXRpbiBjaGFyYWN0ZXJzDQo5IDAgb2JqDQo8PA0KICAvVHlwZSAvRm9udERlc2NyaXB0b3INCiAgL0ZvbnROYW1lIC9IZWx2ZXRpY2ENCiAgL0ZsYWdzIDMyDQogIC9Gb250QkJveCBbIC0xNjYgLTIyNSAxMDAwIDkzMSBdDQogIC9JdGFsaWNBbmdsZSAwDQogIC9Bc2NlbnQgNzE4DQogIC9EZXNjZW50IC0yMDcNCiAgL0NhcEhlaWdodCA3MTgNCiAgL1N0ZW1WIDg4DQogIC9NaXNzaW5nV2lkdGggMCAgDQo+Pg0KZW5kb2JqDQoNCiUgVGhlIG9iamVjdCBjcm9zcy1yZWZlcmVuY2UgdGFibGUuIFRoZSBmaXJzdCBlbnRyeQ0KJSBkZW5vdGVzIHRoZSBzdGFydCBvZiBQREYgZGF0YSBpbiB0aGlzIGZpbGUuDQp4cmVmDQowIDEwDQowMDAwMDAwMDAwIDY1NTM1IGYNCjAwMDAwMDAwMTIgMDAwMDAgbg0KMDAwMDAwMDA5MiAwMDAwMCBuDQowMDAwMDAyNTQzIDAwMDAwIG4NCjAwMDAwMDI2MTUgMDAwMDAgbg0KMDAwMDAwMjc3OCAwMDAwMCBuDQowMDAwMDAzNTgzIDAwMDAwIG4NCjAwMDAwMDM4MDcgMDAwMDAgbg0KMDAwMDAwMzk2OCAwMDAwMCBuDQowMDAwMDA0NTIwIDAwMDAwIG4NCnRyYWlsZXINCjw8DQogIC9TaXplIDEwDQogIC9Sb290IDEgMCBSDQogIC9JRCBbIDwzMWM3YThhMjY5ZTRjNTliYzNjZDdkZjBkYWJiZjM4OD48MzFjN2E4YTI2OWU0YzU5YmMzY2Q3ZGYwZGFiYmYzODg+IF0NCj4+DQpzdGFydHhyZWYNCjQ4NDcNCiUlRU9GDQo=

package/__tests__/utils/pdfDocEncoding.spec.ts

@@ -0,0 +1,82 @@
+import { range, pdfDocEncodingDecode } from '../../src/utils';
+
+type Mapping = [number, string];
+
+const identityMapping = (code: number): Mapping => [
+  code,
+  String.fromCodePoint(code),
+];
+
+// Define mappings (see "Table D.2 – PDFDocEncoding Character Set" of the PDF spec)
+const mappings: Mapping[] = [
+  ...range(0x00, 0x15 + 1).map(identityMapping),
+  [0x16, '\u0017'],
+  [0x17, '\u0017'],
+  [0x18, '\u02D8'],
+  [0x19, '\u02C7'],
+  [0x1a, '\u02C6'],
+  [0x1b, '\u02D9'],
+  [0x1c, '\u02DD'],
+  [0x1d, '\u02DB'],
+  [0x1e, '\u02DA'],
+  [0x1f, '\u02DC'],
+  ...range(0x20, 0x7e + 1).map(identityMapping),
+  [0x7f, '\uFFFD'],
+  [0x80, '\u2022'],
+  [0x81, '\u2020'],
+  [0x82, '\u2021'],
+  [0x83, '\u2026'],
+  [0x84, '\u2014'],
+  [0x85, '\u2013'],
+  [0x86, '\u0192'],
+  [0x87, '\u2044'],
+  [0x88, '\u2039'],
+  [0x89, '\u203A'],
+  [0x8a, '\u2212'],
+  [0x8b, '\u2030'],
+  [0x8c, '\u201E'],
+  [0x8d, '\u201C'],
+  [0x8e, '\u201D'],
+  [0x8f, '\u2018'],
+  [0x90, '\u2019'],
+  [0x91, '\u201A'],
+  [0x92, '\u2122'],
+  [0x93, '\uFB01'],
+  [0x94, '\uFB02'],
+  [0x95, '\u0141'],
+  [0x96, '\u0152'],
+  [0x97, '\u0160'],
+  [0x98, '\u0178'],
+  [0x99, '\u017D'],
+  [0x9a, '\u0131'],
+  [0x9b, '\u0142'],
+  [0x9c, '\u0153'],
+  [0x9d, '\u0161'],
+  [0x9e, '\u017E'],
+  [0x9f, '\uFFFD'],
+  [0xa0, '\u20AC'],
+  ...range(0xa1, 0xac + 1).map(identityMapping),
+  [0xad, '\uFFFD'],
+  ...range(0xae, 0xff + 1).map(identityMapping),
+];
+
+describe(`pdfDocEncodingDecode`, () => {
+  it(`maps all PDFDocEncoding codes from 0-255 to the correct Unicode code points`, () => {
+    // Make sure we have defined mappings for all codes from 0-255
+    expect(mappings.map(([code]) => code).sort((a, b) => a - b)).toEqual(
+      range(0, 256),
+    );
+
+    // Now make sure that `pdfDocEncodingDecode` decodes everything correctly
+    mappings.forEach(([input1, expected1]) => {
+      const actual1 = pdfDocEncodingDecode(Uint8Array.of(input1));
+      expect(actual1).toBe(expected1);
+    });
+
+    // Let's do it again but all at once instead of passing each code separately
+    const input2 = Uint8Array.from(mappings.map(([code]) => code));
+    const expected2 = mappings.map(([, str]) => str).join('');
+    const actual2 = pdfDocEncodingDecode(input2);
+    expect(actual2).toEqual(expected2);
+  });
+});

package/__tests__/utils/png.spec.ts

@@ -0,0 +1,27 @@
+import { PNG } from '../../src/utils/png';
+
+describe(`PNG`, () => {
+  it(`can load images with alpha values greater than 1`, () => {
+    // This Uint8Array contains a PNG image composed of a single pixel. It was
+    // generated with the following code in a browser:
+    // ```
+    // const ctx = c.getContext('2d');
+    // ctx.fillStyle = 'rgba(255, 120, 80, 0.5)';
+    // ctx.fillRect(0, 0, ctx.canvas.width, ctx.canvas.height);
+    // ```
+    // The pixel has the following values: R=255, G=120, B=80, A=128
+    //
+    // prettier-ignore
+    const input = new Uint8Array([
+      137, 80, 78, 71, 13, 10, 26, 10, 0, 0, 0, 13, 73, 72, 68, 82, 0, 0, 0, 1,
+      0, 0, 0, 1, 8, 6, 0, 0, 0, 31, 21, 196, 137, 0, 0, 0, 13, 73, 68, 65, 84,
+      24, 87, 99, 248, 95, 17, 208, 0, 0, 6, 137, 2, 72, 25, 58, 220, 62, 0, 0,
+      0, 0, 73, 69, 78, 68, 174, 66, 96, 130,
+    ]);
+
+    const pngImage = PNG.load(input);
+
+    expect(pngImage.rgbChannel).toEqual(new Uint8Array([255, 120, 80]));
+    expect(pngImage.alphaChannel).toEqual(new Uint8Array([128]));
+  });
+});

package/__tests__/utils/rng.spec.ts

@@ -0,0 +1,14 @@
+import { SimpleRNG } from '../../src/utils/rng';
+
+describe(`psuedo random numbers`, () => {
+  it(`generates distinct numbers`, () => {
+    const rng = SimpleRNG.withSeed(1);
+    expect(rng.nextInt()).not.toEqual(rng.nextInt());
+  });
+
+  it(`generates the same number across different SimpleRNG`, () => {
+    const rng = SimpleRNG.withSeed(1);
+    expect(rng.nextInt()).toEqual(0.7098480789645691);
+    expect(rng.nextInt()).toEqual(0.9742682568175951);
+  });
+});

package/__tests__/utils/strings.spec.ts

@@ -0,0 +1,98 @@
+import fontkit from '@pdf-lib/fontkit';
+import { FontNames } from '@pdf-lib/standard-fonts';
+import fs from 'fs';
+
+import { CustomFontEmbedder, StandardFontEmbedder } from '../../src/core';
+import { breakTextIntoLines } from '../../src/utils';
+
+const font = StandardFontEmbedder.for(FontNames.Helvetica);
+
+const textSize = 24;
+
+const computeTextWidth = (text: string) =>
+  font.widthOfTextAtSize(text, textSize);
+
+describe(`breakTextIntoLines`, () => {
+  it(`handles empty wordBreaks arrays`, () => {
+    const input = 'foobar-quxbaz';
+    const expected = ['foobar-quxbaz'];
+    const actual = breakTextIntoLines(input, [], 21, computeTextWidth);
+    expect(actual).toEqual(expected);
+  });
+
+  it(`handles trailing newlines`, () => {
+    const input = 'foo\n';
+    const expected = ['foo'];
+    const actual = breakTextIntoLines(input, [], 21, computeTextWidth);
+    expect(actual).toEqual(expected);
+  });
+
+  it(`handles trailing carriage returns`, () => {
+    const input = 'foo\r';
+    const expected = ['foo'];
+    const actual = breakTextIntoLines(input, [], 21, computeTextWidth);
+    expect(actual).toEqual(expected);
+  });
+
+  it(`always breaks lines when EOLs are encountered`, () => {
+    const input = 'foo\nbar-qux\rbaz\n';
+    const expected = ['foo', 'bar-qux', 'baz'];
+    const actual = breakTextIntoLines(input, [], 90000, computeTextWidth);
+    expect(actual).toEqual(expected);
+  });
+
+  it(`breaks at the last possible 'wordBreak' before exceeding 'maxWidth' (1)`, () => {
+    const input =
+      'Lorem Test ipsum dolor sit amet, consectetur adipiscing\nelit';
+    const expected = [
+      'Lorem T',
+      'est ipsu',
+      'm dolor s',
+      'it amet, c',
+      'onsectet',
+      'ur adipis',
+      'cing',
+      'elit',
+    ];
+    const actual = breakTextIntoLines(
+      input,
+      ['', 'Test'],
+      100,
+      computeTextWidth,
+    );
+    expect(actual).toEqual(expected);
+  });
+
+  it(`breaks at the last possible 'wordBreak' before exceeding 'maxWidth' (2)`, () => {
+    const input = 'Foo%bar%baz';
+    const expected = ['Foo%', 'bar%baz'];
+    const actual = breakTextIntoLines(input, ['%'], 100, computeTextWidth);
+    expect(actual).toEqual(expected);
+  });
+
+  it(`handles non-ascii code points and empty breaks`, async () => {
+    const sourceHansBytes = fs.readFileSync(
+      'assets/fonts/source_hans_jp/SourceHanSerifJP-Regular.otf',
+    );
+    const sourceHansFont = await CustomFontEmbedder.for(
+      fontkit,
+      sourceHansBytes,
+    );
+
+    const input =
+      '遅未亮惑職界転藤柔索名午納，問通桑転加料演載満経信回込町者訟窃。';
+    const expected = [
+      '遅未亮惑職',
+      '界転藤柔索',
+      '名午納，問',
+      '通桑転加料',
+      '演載満経信',
+      '回込町者訟',
+      '窃。',
+    ];
+    const actual = breakTextIntoLines(input, [''], 125, (text: string) =>
+      sourceHansFont.widthOfTextAtSize(text, 24),
+    );
+    expect(actual).toEqual(expected);
+  });
+});