<%_ name_prefix = name[0] === '@' ? name.slice(1).split('/')[0] : name.split('/')[0] _%>
<%_ name_suffix = name[0] === '@' ? name.slice(1).split('/').pop() : name.split('/').pop() _%>
<%_ name_ucamel = _.upperFirst(_.camelCase(name_suffix)) _%>
[ %>.svg)](https://npmjs.org/package/<%= name %>)
[ : name %>.svg?branch=master)](https://travis-ci.com/<%= name[0] === '@' ? name.slice(1) : name %>)
[ : name %>/badge.svg?branch=master)](https://coveralls.io/github/<%= name[0] === '@' ? name.slice(1) : name %>?branch=master)
# <%= name %>
A [web component] module: it can be integrated into a project either via [webpack] or a `
<<%= name_suffix %> class="<%= name_suffix %>">>
```
..where sourcing the `index.min.js` file takes care of again _both_ the component's script _and_ default stylesheets. There is _no_ need to explicity use a `` tag!
> Note, that `./lib/<%= name_suffix %>` needs to be provided accordingly: This can for example be ensured by creating a symbolic link to `./node_modules/<%= name %>` (or by simply copying the latter to the `./lib` folder):
```sh
ln -s ./node_modules/<%= name %> ./lib/<%= name_suffix %>
```
## Development
### Clean
```sh
npm run clean
```
### Build
```sh
npm run build
```
#### without linting and cleaning:
```sh
npm run -- build --no-lint --no-clean
```
#### with UMD bundling (incl. minimization):
```sh
npm run -- build --prepack
```
#### with UMD bundling (excl. minimization):
```sh
npm run -- build --prepack --no-minify
```
### Lint
```sh
npm run lint
```
#### with auto-fixing:
```sh
npm run -- lint --fix
```
### Test
```sh
npm run test
```
#### without linting, cleaning and (re-)building:
```sh
npm run -- test --no-lint --no-clean --no-build
```
### Cover
```sh
npm run cover
```
#### without linting, cleaning and (re-)building:
```sh
npm run -- cover --no-lint --no-clean --no-build
```
## Debugging
Connect `<%= name %>` to another project:
```sh
[<%= name %>] $ npm link # symlink global:<%= name %>
```
```sh
[a-project] $ npm link a-module # symlink node-modules:<%= name %>
```
```sh
[a-project] $ head webpack.config.js # ensure <%= name %> in entry.main
```
```
entry: {
main: [..., '<%= name %>', './source/index.js']
}
```
Disconnect `<%= name %>` from the project:
```sh
[a-project] $ npm unlink <%= name %> # delete local symlink
```
```sh
[<%= name %>] $ npm uninstall -g # delete global symlink
```
## Documentation
```sh
npm run docs
```
## Publication
```sh
npm publish
```
#### initially (if public):
```sh
npm publish --access=public
```
## Copyright
© <%= year %> [<%= author.name %>](<%= author.url %>)
[web component]: https://developer.mozilla.org/en-US/docs/Web/Web_Components
[webpack]: https://webpack.js.org