diff --git a/packages/auto-install/README.md b/packages/auto-install/README.md
index 4de194b12..fa723c644 100755
--- a/packages/auto-install/README.md
+++ b/packages/auto-install/README.md
@@ -28,14 +28,14 @@ npm install @rollup/plugin-inject --save-dev
Create a `rollup.config.js` [configuration file](https://www.rollupjs.org/guide/en/#configuration-files) and import the plugin:
```js
-import auto from "@rollup/plugin-auto-install";
-import resolve from "rollup-plugin-node-resolve";
+import auto from '@rollup/plugin-auto-install';
+import resolve from 'rollup-plugin-node-resolve';
export default {
- input: "src/index.js",
+ input: 'src/index.js',
output: {
- dir: "output",
- format: "cjs"
+ dir: 'output',
+ format: 'cjs'
},
plugins: [auto(), resolve()]
};
diff --git a/packages/html/README.md b/packages/html/README.md
new file mode 100644
index 000000000..3203c3f21
--- /dev/null
+++ b/packages/html/README.md
@@ -0,0 +1,153 @@
+[npm]: https://img.shields.io/npm/v/@rollup/plugin-html
+[npm-url]: https://www.npmjs.com/package/@rollup/plugin-html
+[size]: https://packagephobia.now.sh/badge?p=@rollup/plugin-html
+[size-url]: https://packagephobia.now.sh/result?p=@rollup/plugin-html
+
+[![npm][npm]][npm-url]
+[![size][size]][size-url]
+[](https://liberamanifesto.com)
+
+# @rollup/plugin-html
+
+π£ A Rollup plugin which creates HTML files to serve Rollup bundles.
+
+Please see [Supported Output Formats](#supported-output-formats) for information about using this plugin with output formats other than `esm` (`es`), `iife`, and `umd`.
+
+## Requirements
+
+This plugin requires an [LTS](https://github.com/nodejs/Release) Node version (v8.0.0+) and Rollup v1.20.0+.
+
+## Install
+
+Using npm:
+
+```console
+npm install @rollup/plugin-html --save-dev
+```
+
+## Usage
+
+Create a `rollup.config.js` [configuration file](https://www.rollupjs.org/guide/en/#configuration-files) and import the plugin:
+
+```js
+const html = require('@rollup/plugin-html');
+
+module.exports = {
+ input: 'src/index.js',
+ output: {
+ dir: 'output',
+ format: 'cjs'
+ },
+ plugins: [html()]
+};
+```
+
+Then call `rollup` either via the [CLI](https://www.rollupjs.org/guide/en/#command-line-reference) or the [API](https://www.rollupjs.org/guide/en/#javascript-api).
+
+Once run successfully, an HTML file should be written to the bundle output destination.
+
+## Options
+
+### `attributes`
+
+Type: `Object`
+Default: `{ html: { lang: 'en' }, link: null, script: null }`
+
+Specifies additional attributes for `html`, `link`, and `script` elements. For each property, provide an object with key-value pairs that represent an HTML element attribute name and value. By default, the `html` element is rendered with an attribute of `lang="en"`.
+
+_Note: If using the `es` / `esm` output format, `{ type: 'module'}` is automatically added to `attributes.script`._
+
+### `fileName`
+
+Type: `String`
+Default: `'index.html'`
+
+Specifies the name of the HTML to emit.
+
+### `publicPath`
+
+Type: `String`
+Default: `internal function`
+Returns: `String`
+
+Specifies a function that provides the rendered source for the HTML output. The function should be in the form of:
+
+```js
+const template = ({ attributes, bundle, files, publicPath, title }) => { ... }
+```
+
+- `attributes`: Corresponds to the `attributes` option passed to the plugin
+- `bundle`: An `Object` containing key-value pairs of [`AssetInfo` or `ChunkInfo`](https://rollupjs.org/guide/en/#generatebundle)
+- `files`: An `Array` of `AssetInfo` or `ChunkInfo` containing any entry (`isEntry: true`) files, and any asset (`isAsset: true`) files in the bundle that will be emitted
+- `publicPath`: Corresponds to the `publicPath` option passed to the plugin
+- `title`: Corresponds to the `title` option passed to the plugin
+
+By default this is handled internally and produces HTML in the following format:
+
+```html
+
+
+
+
+ ${title}
+ ${links}
+
+
+ ${scripts}
+
+
+```
+
+Where `${links}` represents all `
+Default: `'Rollup Bundle'`
+
+Specifies the HTML document title.
+
+## Exports
+
+### `makeHtmlAttributes(attributes)`
+
+Parameters: `attributes`, Type: `Object`
+Returns: `String`
+
+Consumes an object with key-value pairs that represent an HTML element attribute name and value. The function returns all pairs as a space-separated string of valid HTML element attributes. e.g.
+
+```js
+const { makeHtmlAttributes } = require('@rollup/plugin-html');
+
+makeHtmlAttributes({ lang: 'en', 'data-batcave': 'secret' });
+// -> 'lang="en" data-batcave="secret"'
+```
+
+## Supported Output Formats
+
+By default, this plugin supports the `esm` (`es`), `iife`, and `umd` [output formats](https://rollupjs.org/guide/en/#outputformat), as those are most commonly used as browser bundles. Other formats can be used, but will require using the [`template`](#template) option to specify a custom template function which renders the unique requirements of other formats.
+
+### `amd`
+
+Will likely require use of RequireJS semantics, which allows only for a single entry ``.
+
+## Attribution
+
+This plugin was inspired by and is based upon [mini-html-webpack-plugin](https://github.com/styleguidist/mini-html-webpack-plugin) by Juho VepsΓ€lΓ€inen and Artem Sapegin, with permission.
+
+## Meta
+
+[CONTRIBUTING](/.github/CONTRIBUTING.md)
+
+[LICENSE (MIT)](/LICENSE)
diff --git a/packages/html/lib/index.js b/packages/html/lib/index.js
new file mode 100644
index 000000000..107a4f3ed
--- /dev/null
+++ b/packages/html/lib/index.js
@@ -0,0 +1,106 @@
+const { extname } = require('path');
+
+const getFiles = (bundle) => {
+ const files = Object.values(bundle).filter(
+ (file) => file.isEntry || file.type === 'asset' || file.isAsset
+ );
+ const result = {};
+ for (const file of files) {
+ const { fileName } = file;
+ const extension = extname(fileName).substring(1);
+ result[extension] = (result[extension] || []).concat(file);
+ }
+
+ return result;
+};
+
+const makeHtmlAttributes = (attributes) => {
+ if (!attributes) {
+ return '';
+ }
+
+ const keys = Object.keys(attributes);
+ // eslint-disable-next-line no-param-reassign
+ return keys.reduce((result, key) => (result += ` ${key}="${attributes[key]}"`), '');
+};
+
+const defaultTemplate = async ({ attributes, files, publicPath, title }) => {
+ const scripts = (files.js || [])
+ .map(({ fileName }) => {
+ const attrs = makeHtmlAttributes(attributes.script);
+ return ``;
+ })
+ .join('\n');
+
+ const links = (files.css || [])
+ .map(({ fileName }) => {
+ const attrs = makeHtmlAttributes(attributes.link);
+ return ``;
+ })
+ .join('\n');
+
+ return `
+
+
+
+
+ ${title}
+ ${links}
+
+
+ ${scripts}
+
+