Merge foliojs/master

.babelrc

@@ -0,0 +1,8 @@
+{
+  "presets": [["env", {"modules": false, "targets": {"node": "6.10"}}]],
+  "env": {
+    "test": {
+      "presets": [["env", {"targets": {"node": "6.10"}}]]
+    }
+  }
+}

.eslintrc

@@ -0,0 +1,3 @@
+{
+  "extends": "eslint:recommended"
+}

.github/ISSUE_TEMPLATE/bug-report.md

@@ -0,0 +1,21 @@
+---
+name: Bug Report
+about: Report runtime errors or wrong PDF output
+---
+
+# Bug Report
+
+
+## Description of the problem
+
+
+## Code sample
+<!-- Post code or a link to a live example (can fork from https://repl.it/@blikblum/minimal-pdfkit) that reproduces the issue -->
+
+
+## Your environment
+
+* pdfkit version:
+* Node version:
+* Browser version (if applicable):
+* Operating System:

.github/ISSUE_TEMPLATE/feature-request.md

@@ -0,0 +1,11 @@
+---
+name: Feature Request
+about: Request new features
+---
+
+# Feature Request
+
+## Feature description
+<!-- How the feature should work? -->
+
+<!-- You have examples or an idea how it can be implemented? -->

.github/ISSUE_TEMPLATE/question.md

@@ -0,0 +1,20 @@
+---
+name: Question
+about: Ask about pdfkit
+---
+
+# Question
+
+## Description
+
+<!--- Provide your question or other information that will help in solving here -->
+
+## Code sample
+<!-- Post code or a link to a live example (can fork from https://repl.it/@blikblum/minimal-pdfkit) -->
+
+## Your environment
+
+* pdfkit version:
+* Node version:
+* Browser version (if applicable):
+* Operating System:

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,35 @@
+<!--
+Please make sure you are familiar with and follow the instructions in the
+contributing guidelines (found in the CONTRIBUTING.md file).
+
+Please fill out the information below to expedite the review and (hopefully)
+merge of your pull request!
+-->
+
+<!-- Is it a Bug fix, feature, docs update, ... -->
+
+**What kind of change does this PR introduce?**
+
+<!-- You can also link to an open issue here -->
+
+**What is the current behavior?**
+
+<!-- if this is a feature change -->
+
+**What is the new behavior?**
+
+<!-- Have you done all of these things?  -->
+
+**Checklist**:
+
+<!-- add "N/A" to the end of each line that's irrelevant to your changes -->
+<!-- to check an item, place an "x" in the box like so: "- [x] Documentation" -->
+
+- [ ] Tests (preference for unit tests)
+- [ ] Documentation
+- [ ] Update CHANGELOG.md
+- [ ] Ready to be merged <!-- In your opinion, is this ready to be merged as soon as it's reviewed? -->
+
+<!-- feel free to add additional comments -->
+
+<!-- Thank you for contributing! -->

.gitignore

@@ -10,3 +10,7 @@ demo/bundle.js
 !demo/browser.html
 dist
 *.b64.afm
+.vscode
+coverage
+tests/integration/__pdfs__
+tests/integration/pdfmake/__pdfs__

.npmignore

@@ -4,4 +4,11 @@ demo/
 lib/
 docs/
 playground/
+.vscode/
+coverage/
+tests/
 index.js
+index.html
+yarn.lock
+rollup.config.js
+.eslintrc

.prettierrc

@@ -0,0 +1,3 @@
+{    
+  "singleQuote": true
+}

CHANGELOG.md

@@ -0,0 +1,16 @@
+## pdfkit changelog
+
+### Unreleased
+
+- Fix setting printing permission
+- Fix corruption of string objects in browser
+- Add option to set default font
+- Remove call to fontkit.openSync
+- Add standalone virtual file system implementation
+
+### [v0.9.0] - 2019-1-28
+
+- Convert to code base from coffescript to ES6+
+- Fix loading grayscale / transparent PNG files
+- Reduce number of calls to async functions
+- Implement encryption / access control

CONTRIBUTING.md

@@ -0,0 +1,83 @@
+# Contributing to pdfkit
+
+## Table of Contents
+
+- [Contributing to pdfkit](#contributing-to-pdfkit)
+  - [Table of Contents](#table-of-contents)
+  - [Code Organization](#code-organization)
+  - [Setting Up the project locally](#setting-up-the-project-locally)
+  - [Running and writing tests](#running-and-writing-tests)
+  - [Submitting a Pull Request](#submitting-a-pull-request)
+
+
+## Code Organization
+
+pdfkit is organized in the following folders:
+
+- `lib`: The actual source code.
+- `js`: The built / distributable code.
+- `docs`: Code and artifacts to generate documentation.
+- `demo`: Node and browser demos.
+- `tests/unit`: Tests behavior of specific classes / methods.
+- `tests/integration`: Compare the pdf output against a reference.
+
+**Working on your first Pull Request?** You can learn how from this _free_ series [How to Contribute to an Open Source Project on GitHub](https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github)
+
+## Setting Up the project locally
+
+To install the project you need to have `node`
+
+1.  [Fork](https://help.github.com/articles/fork-a-repo/) the project, clone your fork:
+
+    ```
+    # Clone your fork
+    git clone https://github.com/<your-username>/pdfkit.git
+
+    # Navigate to the newly cloned directory
+    cd pdfkit
+    ```
+
+2.  `npm install` to install dependencies
+3.  `npm run build` to build the library
+4.  `npm run demo` to run the demo (check demo/out.pdf)
+5.  `npm run demo-browser` to run the browser demo (check demo/browser.html)
+
+> Tip: Keep your `master` branch pointing at the original repository and make
+> pull requests from branches on your fork. To do this, run:
+>
+> ```
+> git remote add upstream https://github.com/foliojs/pdfkit.git
+> git fetch upstream
+> git branch --set-upstream-to=upstream/master master
+> ```
+>
+> This will add the original repository as a "remote" called "upstream,"
+> then fetch the git information from that remote, then set your local `master`
+> branch to use the upstream master branch whenever you run `git pull`.
+> Then you can make all of your pull request branches based on this `master`
+> branch. Whenever you want to update your version of `master`, do a regular
+> `git pull`.
+
+## Running and writing tests
+
+Tests are run using [Jest](http://jestjs.io/) and are categorized as integration and unit tests. 
+
+Integration tests check the pdf output against a reference stored as snapshots. While is served well to avoid regressions it has some disadvantages like small (correct) changes requiring to update all snapshots
+
+Unit tests checks behavior os specific classes / methods isolatedly. It covers relatively small portion of code but is preferred way of writing new tests going forward
+
+Tests commands
+* `npm run test`: Run all tests
+* `npm run test:unit`: Run unit tests
+* `npm run test:integration`: Run integration tests
+
+To write new tests, look for the *.spec.js files at `test/unit` and `test/integration` as examples
+
+
+## Submitting a Pull Request
+
+Please go through existing issues and pull requests to check if somebody else is already working on it.
+
+Also, make sure to run the tests and lint the code before you commit your changes.
+
+**Preferentially, tests should be added to check the changed behavior even if is a bug fix. Unit tests are preferred over integration ones**