pdfkit 0.9.1 → 0.12.1

package/.prettierignore

@@ -0,0 +1 @@
+demo/bundle.js

package/CHANGELOG.md

@@ -2,7 +2,42 @@
 
 ### Unreleased
 
-### [v0.9.1] - 2019-3-04
+### [v0.12.1] - 2021-04-02
+
+- Update crypto-js to v3.3 (fix security issue)
+- Update fontkit to 1.8.1
+
+### [v0.12.0] - 2021-04-02
+
+- Add support for Embedded Files and File Attachment Annotations
+- Accessibility support
+- Replace integration tests by visual regression tests
+- Fix access permissions in PDF version 1.7ext3
+- Fix Buffer() is deprecation warning
+- Add `forms.md` to generate documentation files
+- Fix "@" in FontName
+
+### [v0.11.0] - 2019-12-03
+
+- Fix infinite loop when an individual character is bigger than the width of the text.
+- Fix infinite loop when text is positioned after page right margin
+- Allow links in continued text to be stopped by setting link to null
+- Add support to interlaced PNG files
+- Do not emit \_interopDefault helper in commonjs build
+- Fix gradient with multiple stops (#1045)
+- Set link annotation flag to print by default
+- Add support for AcroForms
+- Drop support for (uncommon) cid less fonts on standalone build (reduces bundle size)
+
+### [v0.10.0] - 2019-06-06
+
+- Fix links to pages within the document
+- Add support for named destinations
+- Throw errors when `dash(...)` is passed invalid lengths
+- Remove PDFDocument#output method
+- Add standalone build (js/pdfkit.standalone.js)
+
+### [v0.9.1] - 2019-04-30
 
 - Fix setting printing permission
 - Fix corruption of string objects in browser
@@ -11,7 +46,7 @@
 - Add standalone virtual file system implementation
 - Add option (fontLayoutCache) to disable font layout cache
 
-### [v0.9.0] - 2019-1-28
+### [v0.9.0] - 2019-01-28
 
 - Convert to code base from coffescript to ES6+
 - Fix loading grayscale / transparent PNG files

package/README.md

@@ -4,140 +4,150 @@ A JavaScript PDF generation library for Node and the browser.
 
 ## Description
 
-PDFKit is a PDF document generation library for Node and the browser that makes creating complex, multi-page, printable 
-documents easy. The API embraces chainability, and includes both low level functions as well as abstractions for higher 
-level functionality. The PDFKit API is designed to be simple, so generating complex documents is often as simple as 
+PDFKit is a PDF document generation library for Node and the browser that makes creating complex, multi-page, printable
+documents easy. The API embraces chainability, and includes both low level functions as well as abstractions for higher
+level functionality. The PDFKit API is designed to be simple, so generating complex documents is often as simple as
 a few function calls.
 
 Check out some of the [documentation and examples](http://pdfkit.org/docs/getting_started.html) to see for yourself!
 You can also read the guide as a [self-generated PDF](http://pdfkit.org/docs/guide.pdf) with example output displayed inline.
-If you'd like to see how it was generated, check out the README in the [docs](https://github.com/devongovett/pdfkit/tree/master/docs)
+If you'd like to see how it was generated, check out the README in the [docs](https://github.com/foliojs/pdfkit/tree/master/docs)
 folder.
 
 You can also try out an interactive in-browser demo of PDFKit [here](http://pdfkit.org/demo/browser.html).
 
 ## Installation
 
-Installation uses the [npm](http://npmjs.org/) package manager.  Just type the following command after installing npm.
+Installation uses the [npm](http://npmjs.org/) package manager. Just type the following command after installing npm.
 
     npm install pdfkit
 
 ## Features
 
-* Vector graphics
-  * HTML5 canvas-like API
-  * Path operations
-  * SVG path parser for easy path creation
-  * Transformations
-  * Linear and radial gradients
-* Text
-  * Line wrapping
-  * Text alignments
-  * Bulleted lists
-* Font embedding
-  * Supports TrueType (.ttf), OpenType (.otf), WOFF, WOFF2, TrueType Collections (.ttc), and Datafork TrueType (.dfont) fonts
-  * Font subsetting
-  * See [fontkit](http://github.com/devongovett/fontkit) for more details on advanced glyph layout support.
-* Image embedding
-  * Supports JPEG and PNG files (including indexed PNGs, and PNGs with transparency)
-* Annotations
-  * Links
-  * Notes
-  * Highlights
-  * Underlines
-  * etc.
-* Outlines
-* PDF security
-  * Encryption
-  * Access privileges (printing, copying, modifying, annotating, form filling, content accessibility, document assembly)
+- Vector graphics
+  - HTML5 canvas-like API
+  - Path operations
+  - SVG path parser for easy path creation
+  - Transformations
+  - Linear and radial gradients
+- Text
+  - Line wrapping
+  - Text alignments
+  - Bulleted lists
+- Font embedding
+  - Supports TrueType (.ttf), OpenType (.otf), WOFF, WOFF2, TrueType Collections (.ttc), and Datafork TrueType (.dfont) fonts
+  - Font subsetting
+  - See [fontkit](http://github.com/foliojs/fontkit) for more details on advanced glyph layout support.
+- Image embedding
+  - Supports JPEG and PNG files (including indexed PNGs, and PNGs with transparency)
+- Annotations
+  - Links
+  - Notes
+  - Highlights
+  - Underlines
+  - etc.
+- AcroForms
+- Outlines
+- PDF security
+  - Encryption
+  - Access privileges (printing, copying, modifying, annotating, form filling, content accessibility, document assembly)
+- Accessibility support (marked content, logical structure, Tagged PDF, PDF/UA)
 
 ## Coming soon!
 
-* Patterns fills
-* Higher level APIs for creating tables and laying out content
-* More performance optimizations
-* Even more awesomeness, perhaps written by you! Please fork this repository and send me pull requests.
+- Patterns fills
+- Higher level APIs for creating tables and laying out content
+- More performance optimizations
+- Even more awesomeness, perhaps written by you! Please fork this repository and send me pull requests.
 
 ## Example
 
 ```javascript
 const PDFDocument = require('pdfkit');
+const fs = require('fs');
 
 // Create a document
-const doc = new PDFDocument;
+const doc = new PDFDocument();
 
 // Pipe its output somewhere, like to a file or HTTP response
 // See below for browser usage
 doc.pipe(fs.createWriteStream('output.pdf'));
 
 // Embed a font, set the font size, and render some text
-doc.font('fonts/PalatinoBold.ttf')
-   .fontSize(25)
-   .text('Some text with an embedded font!', 100, 100);
+doc
+  .font('fonts/PalatinoBold.ttf')
+  .fontSize(25)
+  .text('Some text with an embedded font!', 100, 100);
 
 // Add an image, constrain it to a given size, and center it vertically and horizontally
 doc.image('path/to/image.png', {
-   fit: [250, 300],
-   align: 'center',
-   valign: 'center'
+  fit: [250, 300],
+  align: 'center',
+  valign: 'center'
 });
 
 // Add another page
-doc.addPage()
-   .fontSize(25)
-   .text('Here is some vector graphics...', 100, 100);
+doc
+  .addPage()
+  .fontSize(25)
+  .text('Here is some vector graphics...', 100, 100);
 
 // Draw a triangle
-doc.save()
-   .moveTo(100, 150)
-   .lineTo(100, 250)
-   .lineTo(200, 250)
-   .fill("#FF3300");
+doc
+  .save()
+  .moveTo(100, 150)
+  .lineTo(100, 250)
+  .lineTo(200, 250)
+  .fill('#FF3300');
 
 // Apply some transforms and render an SVG path with the 'even-odd' fill rule
-doc.scale(0.6)
-   .translate(470, -380)
-   .path('M 250,75 L 323,301 131,161 369,161 177,301 z')
-   .fill('red', 'even-odd')
-   .restore();
+doc
+  .scale(0.6)
+  .translate(470, -380)
+  .path('M 250,75 L 323,301 131,161 369,161 177,301 z')
+  .fill('red', 'even-odd')
+  .restore();
 
 // Add some text with annotations
-doc.addPage()
-   .fillColor("blue")
-   .text('Here is a link!', 100, 100)
-   .underline(100, 100, 160, 27, {color: "#0000FF"})
-   .link(100, 100, 160, 27, 'http://google.com/');
+doc
+  .addPage()
+  .fillColor('blue')
+  .text('Here is a link!', 100, 100)
+  .underline(100, 100, 160, 27, { color: '#0000FF' })
+  .link(100, 100, 160, 27, 'http://google.com/');
 
 // Finalize PDF file
 doc.end();
 ```
 
 [The PDF output from this example](http://pdfkit.org/demo/out.pdf) (with a few additions) shows the power of PDFKit — producing
-complex documents with a very small amount of code.  For more, see the `demo` folder and the
+complex documents with a very small amount of code. For more, see the `demo` folder and the
 [PDFKit programming guide](http://pdfkit.org/docs/getting_started.html).
 
 ## Browser Usage
 
-There are two ways to use PDFKit in the browser.  The first is to use [Browserify](http://browserify.org/),
-which is a Node module packager for the browser with the familiar `require` syntax.  The second is to use
-a prebuilt version of PDFKit, which you can [download from Github](https://github.com/devongovett/pdfkit/releases).
+There are three ways to use PDFKit in the browser:
 
-In addition to PDFKit, you'll need somewhere to stream the output to.  HTML5 has a
+- Use [Browserify](http://browserify.org/). See demo [source code](demo/browser.js) and [build script](https://github.com/foliojs/pdfkit/blob/master/package.json#L56)
+- Use [webpack](https://webpack.js.org/). See [complete example](https://github.com/blikblum/pdfkit-webpack-example).
+- Use prebuilt version. Distributed as `pdfkit.standalone.js` file in the [releases](https://github.com/foliojs/pdfkit/releases) or in the package `js` folder.
+
+In addition to PDFKit, you'll need somewhere to stream the output to. HTML5 has a
 [Blob](https://developer.mozilla.org/en-US/docs/Web/API/Blob) object which can be used to store binary data, and
-get URLs to this data in order to display PDF output inside an iframe, or upload to a server, etc.  In order to
+get URLs to this data in order to display PDF output inside an iframe, or upload to a server, etc. In order to
 get a Blob from the output of PDFKit, you can use the [blob-stream](https://github.com/devongovett/blob-stream)
 module.
 
-The following example uses Browserify to load `PDFKit` and `blob-stream`, but if you're not using Browserify,
-you can load them in whatever way you'd like (e.g. script tags).
+The following example uses Browserify or webpack to load `PDFKit` and `blob-stream`. See [here](https://codepen.io/blikblum/pen/gJNWMg?editors=1010) and [here](https://codepen.io/blikblum/pen/YboVNq?editors=1010) for examples
+of prebuilt version usage.
 
 ```javascript
 // require dependencies
 const PDFDocument = require('pdfkit');
-const blobStream  = require('blob-stream');
+const blobStream = require('blob-stream');
 
 // create a document the same way as above
-const doc = new PDFDocument;
+const doc = new PDFDocument();
 
 // pipe the document to a blob
 const stream = doc.pipe(blobStream());