Compare commits
15 Commits
v4.0.1
...
v4.0.2-dev
Author | SHA1 | Date |
---|---|---|
semantic-release-bot | f61bb3b829 | |
Derrick Hammer | 9f090fb1a9 | |
Derrick Hammer | d5e6ab23ae | |
Derrick Hammer | 653edbe8ce | |
Derrick Hammer | 6b364180f0 | |
Derrick Hammer | f91e2d356f | |
Derrick Hammer | 12dbad4a51 | |
Derrick Hammer | a6c1b7eacb | |
Derrick Hammer | 3ee5097728 | |
Derrick Hammer | 0950557182 | |
Derrick Hammer | 33f9ed88be | |
Derrick Hammer | 729c37ef18 | |
Derrick Hammer | 0d2816fb8e | |
Derrick Hammer | 2e05208469 | |
Derrick Hammer | 441279e4a8 |
|
@ -0,0 +1,19 @@
|
|||
name: Build/Publish
|
||||
|
||||
on:
|
||||
workflow_dispatch:
|
||||
inputs:
|
||||
debug_enabled:
|
||||
description: Debug
|
||||
type: boolean
|
||||
default: false
|
||||
push:
|
||||
branches:
|
||||
- master
|
||||
- develop
|
||||
- develop-*
|
||||
|
||||
jobs:
|
||||
main:
|
||||
uses: lumeweb/github-node-deploy-workflow/.github/workflows/main.yml@master
|
||||
secrets: inherit
|
|
@ -0,0 +1,3 @@
|
|||
{
|
||||
"preset": ["presetter-preset-esm"]
|
||||
}
|
|
@ -0,0 +1,68 @@
|
|||
{
|
||||
"plugins": [
|
||||
[
|
||||
"@semantic-release/commit-analyzer",
|
||||
{
|
||||
"releaseRules": [
|
||||
{
|
||||
"breaking": true,
|
||||
"release": "major"
|
||||
},
|
||||
{
|
||||
"revert": true,
|
||||
"release": "patch"
|
||||
},
|
||||
{
|
||||
"type": "feat",
|
||||
"release": "minor"
|
||||
},
|
||||
{
|
||||
"type": "fix",
|
||||
"release": "patch"
|
||||
},
|
||||
{
|
||||
"type": "perf",
|
||||
"release": "patch"
|
||||
},
|
||||
{
|
||||
"type": "dep",
|
||||
"release": "patch"
|
||||
},
|
||||
{
|
||||
"type": "refactor",
|
||||
"release": "patch"
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"@semantic-release/release-notes-generator",
|
||||
[
|
||||
"@semantic-release/changelog",
|
||||
{
|
||||
"changelogFile": "CHANGELOG.md"
|
||||
}
|
||||
],
|
||||
"@semantic-release/npm",
|
||||
[
|
||||
"@semantic-release/git",
|
||||
{
|
||||
"assets": [
|
||||
"package.json",
|
||||
"CHANGELOG.md",
|
||||
"npm-shrinkwrap.json"
|
||||
]
|
||||
}
|
||||
]
|
||||
],
|
||||
"branches": [
|
||||
"master",
|
||||
{
|
||||
"name": "develop",
|
||||
"prerelease": true
|
||||
},
|
||||
{
|
||||
"name": "develop-*",
|
||||
"prerelease": true
|
||||
}
|
||||
]
|
||||
}
|
|
@ -1,3 +1,5 @@
|
|||
## [4.0.2-develop.1](https://git.lumeweb.com/LumeWeb/presetter-preset-rollup/compare/v4.0.1...v4.0.2-develop.1) (2023-06-30)
|
||||
|
||||
# Changelog
|
||||
|
||||
All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
|
||||
|
|
|
@ -0,0 +1,10 @@
|
|||
MIT License
|
||||
|
||||
Copyright (c) 2020 Alvis HT Tang
|
||||
Copyright (c) 2023 Hammer Technologies LLC
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
192
README.md
192
README.md
|
@ -1,192 +1,2 @@
|
|||
<div align="center">
|
||||
# presetter-preset-rollup
|
||||
|
||||
![Logo](https://github.com/alvis/presetter/raw/master/assets/logo.svg)
|
||||
|
||||
🏄🏻 _A collection of opinionated configurations for a building a code bundle via rollup for presetter_
|
||||
|
||||
• [Quick Start](#quick-start) • [Project Structure](#project-structure) • [Customization](#customization) • [Scripts](#script-template-summary) •
|
||||
|
||||
[![npm](https://img.shields.io/npm/v/presetter-preset-rollup?style=flat-square)](https://github.com/alvis/presetter/releases)
|
||||
[![build](https://img.shields.io/github/workflow/status/alvis/presetter/code%20test?style=flat-square)](https://github.com/alvis/presetter/actions)
|
||||
[![maintainability](https://img.shields.io/codeclimate/maintainability/alvis/presetter?style=flat-square)](https://codeclimate.com/github/alvis/presetter/maintainability)
|
||||
[![coverage](https://img.shields.io/codeclimate/coverage/alvis/presetter?style=flat-square)](https://codeclimate.com/github/alvis/presetter/test_coverage)
|
||||
[![security](https://img.shields.io/snyk/vulnerabilities/github/alvis/presetter/packages/preset-rollup/package.json.svg?style=flat-square)](https://snyk.io/test/github/alvis/presetter?targetFile=packages/preset-rollup/package.json&style=flat-square)
|
||||
[![dependencies](https://img.shields.io/librariesio/release/npm/presetter-preset-rollup?style=flat-square)](https://libraries.io/npm/presetter-preset-rollup)
|
||||
[![license](https://img.shields.io/github/license/alvis/presetter.svg?style=flat-square)](https://github.com/alvis/presetter/blob/master/LICENSE)
|
||||
|
||||
</div>
|
||||
|
||||
## Features
|
||||
|
||||
**presetter-preset-rollup** is an opinionated preset for you to setup rollup in a fraction of time you usually take via [**presetter**](https://github.com/alvis/presetter).
|
||||
|
||||
- 🗞️ Rollup 2
|
||||
- 2️⃣ Dual CJS and ESM modules export by default
|
||||
- 🍄 Common rollup packages included as one single bundle
|
||||
- `@rollup/plugin-commonjs`
|
||||
- `@rollup/plugin-graphql`
|
||||
- `@rollup/plugin-image`
|
||||
- `@rollup/plugin-json`
|
||||
- `@rollup/plugin-yaml`
|
||||
- `rollup` <~ of course including rollup itself
|
||||
- `rollup-plugin-postcss`
|
||||
- `rollup-plugin-ts`
|
||||
- `rollup-plugin-tsconfig-paths`
|
||||
- `rollup-plugin-visualizer`
|
||||
|
||||
## Quick Start
|
||||
|
||||
[**FULL DOCUMENTATION IS AVAILABLE HERE**](https://github.com/alvis/presetter/blob/master/README.md)
|
||||
|
||||
1. Bootstrap your project with `presetter-preset-esm` & `presetter-preset-rollup`
|
||||
|
||||
```shell
|
||||
npx presetter use presetter-preset presetter-preset-rollup
|
||||
```
|
||||
|
||||
That's. One command and you're set.
|
||||
|
||||
After bootstrapping, you would see a lot of configuration files generated, including a `rollup.config.ts` that has all plugins configured properly for you.
|
||||
|
||||
2. Develop and run life cycle scripts provided by the preset
|
||||
|
||||
At this point, all development packages specified in the preset are installed,
|
||||
and now you can try to run some example life cycle scripts (e.g. run prepare).
|
||||
|
||||
![Demo](https://raw.githubusercontent.com/alvis/presetter/master/assets/demo.gif)
|
||||
|
||||
**IMPORTANT**
|
||||
For NodeJS to import the correct export, remember to specify the following in your project's package.json too!
|
||||
|
||||
```json
|
||||
{
|
||||
"main": "lib/index.js",
|
||||
"module": "lib/index.mjs",
|
||||
"types": "lib/index.d.ts",
|
||||
"exports": {
|
||||
"require": "./lib/index.js",
|
||||
"import": "./lib/index.mjs"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Project Structure
|
||||
|
||||
After installation, your project file structure should resemble the following or with more configuration files if you also installed other presets such as [`presetter-preset-esm`](https://github.com/alvis/presetter/blob/master/packages/preset-essentials).
|
||||
|
||||
Implement your business logic under `source` and prepare tests under `spec`.
|
||||
|
||||
**TIPS** You can always change the source directory to other (e.g. src) by setting the `source` variable in `.presetterrc.json`. See the [customization](https://github.com/alvis/presetter/blob/master/packages/preset-rollup#customization) section below for more details.
|
||||
|
||||
```
|
||||
(root)
|
||||
├─ .git
|
||||
├─ .presetterrc.json
|
||||
├─ node_modules
|
||||
├─ source
|
||||
│ ├─ <folders>
|
||||
│ ├─ index.ts
|
||||
│ ├─ (auxiliary).ts
|
||||
├─ spec
|
||||
│ ├─ *.spec.ts
|
||||
├─ package.json
|
||||
└─ rollup.config.ts
|
||||
```
|
||||
|
||||
## Customization
|
||||
|
||||
By default, this preset exports a handy configuration for rollup for a typescript project.
|
||||
But you can further customize (either extending or replacing) the configuration by specifying the change in the config file (`.presetterrc` or `.presetterrc.json`).
|
||||
|
||||
These settings are available in the `config` field in the config file. For directories, the setting is specified in the `variable` field.
|
||||
|
||||
The structure of `.presetterrc` should follow the interface below:
|
||||
|
||||
```ts
|
||||
interface PresetterRC {
|
||||
/** name(s) of the preset e.g. presetter-preset-rollup */
|
||||
name: string | string[];
|
||||
/** additional configuration passed to the preset for generating the configuration files */
|
||||
config?: {
|
||||
// ┌─ configuration for other tools via other presets (e.g. presetter-preset-esm)
|
||||
// ...
|
||||
|
||||
/** additional configuration for rollup */
|
||||
rollup?: {
|
||||
// ┌─ any configuration supported by rollup, see https://rollupjs.org/guide/en/#configuration-files
|
||||
// ...
|
||||
|
||||
/** list of plugin and its options */
|
||||
plugins?:
|
||||
| NormalizedRollupConfig['plugins']
|
||||
| Array<
|
||||
| string
|
||||
| [name: string]
|
||||
| [
|
||||
name: string,
|
||||
options:
|
||||
| Record<string, unknown>
|
||||
| `@apply ${string}`
|
||||
| `@import ${string}`
|
||||
| null,
|
||||
]
|
||||
>;
|
||||
};
|
||||
};
|
||||
/** variables to be substituted in templates */
|
||||
variable?: {
|
||||
/** the directory containing all source code (default: source) */
|
||||
source?: string;
|
||||
/** the directory containing all output tile (default: source) */
|
||||
output?: string;
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
For generating `rollup.config.ts`, this preset also support the `@apply` and `@import` directives such that you can also import configuration from other packages or ts/js files.
|
||||
|
||||
The usage of the directives is simple. In any part of the configuration for rollup, you can simply put
|
||||
`@apply package_name` or `@import package_name` and the preset will automatically replace the content with an imported variable. For example:
|
||||
|
||||
```json
|
||||
{
|
||||
"rollup": {
|
||||
"plugins": [
|
||||
[
|
||||
"@apply rollup-plugin-postcss[default]",
|
||||
{ "plugins": "@import ./postcss.config[default.plugins]" }
|
||||
]
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
will create a `rollup.config.ts` file with the following content:
|
||||
|
||||
```ts
|
||||
import * as import0 from 'rollup-plugin-postcss';
|
||||
import * as import1 from './postcss.config';
|
||||
|
||||
export default {
|
||||
plugins: [import0.default(...[{ plugins: import1.default.plugins }])],
|
||||
};
|
||||
```
|
||||
|
||||
The syntax for both the directives is quite similar.
|
||||
Use `@apply` in a situation that you have to invoke a function from an imported package,
|
||||
such as `rollup-plugin-postcss` in the above example.
|
||||
You can also specify the arguments for the invoked function in the form of `["@apply package", options]`
|
||||
|
||||
For `@import`, use it if you want to import value from another package or ts/js file.
|
||||
For example, `@import ./postcss.config[default.plugins]` would allow you to refer `default.plugins` from `./postcss.config` in the above example.
|
||||
|
||||
In addition to the directives, to specify the plugins for rollup, you can write it in three ways similar to babel.
|
||||
|
||||
1. A object with plugin name as the key and its options as its value e.g. `{'@apply @rollup/plugin-typescript[default]': {options}}`
|
||||
2. Name of a plugin in an array e.g. `['@apply @rollup/plugin-typescript[default]']`
|
||||
3. Doublet of `[plugin name, options]` in an array e.g. `[['@apply @rollup/plugin-typescript[default]', {options}]]`
|
||||
|
||||
## Script Template Summary
|
||||
|
||||
- **`run build`**: Bundle your code via rollup
|
||||
- **`run develop`**: Continuous code build and watch
|
||||
|
|
|
@ -3,12 +3,8 @@ output:
|
|||
- file: '{output}/index.js'
|
||||
format: cjs
|
||||
sourcemap: true
|
||||
- file: '{output}/index.mjs'
|
||||
format: es
|
||||
sourcemap: true
|
||||
plugins:
|
||||
- '@apply rollup-plugin-ts[default]'
|
||||
- '@apply rollup-plugin-tsconfig-paths[default]'
|
||||
- '@apply @rollup/plugin-json[default]'
|
||||
- '@apply @rollup/plugin-node-resolve[default]'
|
||||
- - '@apply @rollup/plugin-commonjs[default]'
|
||||
- extensions:
|
||||
|
@ -16,7 +12,6 @@ plugins:
|
|||
- .jsx
|
||||
- .ts
|
||||
- .tsx
|
||||
- '@apply @rollup/plugin-json[default]'
|
||||
- '@apply @rollup/plugin-graphql[default]'
|
||||
- '@apply @rollup/plugin-image[default]'
|
||||
- '@apply @rollup/plugin-yaml[default]'
|
||||
|
|
File diff suppressed because it is too large
Load Diff
28
package.json
28
package.json
|
@ -1,6 +1,6 @@
|
|||
{
|
||||
"name": "presetter-preset-rollup",
|
||||
"version": "4.0.1",
|
||||
"name": "@lumeweb/presetter-preset-rollup",
|
||||
"version": "4.0.2-develop.1",
|
||||
"description": "An opinionated presetter preset for using rollup as a bundler",
|
||||
"keywords": [
|
||||
"presetter",
|
||||
|
@ -20,16 +20,12 @@
|
|||
"type": "module",
|
||||
"repository": {
|
||||
"type": "git",
|
||||
"url": "git+https://github.com/alvis/presetter.git"
|
||||
"url": "gitea@git.lumeweb.com:LumeWeb/presetter-preset-rollup.git"
|
||||
},
|
||||
"scripts": {
|
||||
"bootstrap": "presetter bootstrap && run prepare",
|
||||
"prepare": "presetter bootstrap",
|
||||
"build": "run build",
|
||||
"coverage": "run coverage --",
|
||||
"lint": "run lint --",
|
||||
"prepublishOnly": "run prepare && run prepublishOnly",
|
||||
"test": "run test --",
|
||||
"watch": "run watch --"
|
||||
"semantic-release": "semantic-release"
|
||||
},
|
||||
"peerDependencies": {
|
||||
"@rollup/plugin-commonjs": "^25.0.0",
|
||||
|
@ -38,18 +34,22 @@
|
|||
"@rollup/plugin-json": "^6.0.0",
|
||||
"@rollup/plugin-node-resolve": "^15.0.0",
|
||||
"@rollup/plugin-yaml": "^4.0.0",
|
||||
"presetter": "workspace:*",
|
||||
"rollup": "^3.0.0",
|
||||
"rollup-plugin-postcss": "^4.0.0",
|
||||
"rollup-plugin-ts": "^3.0.0",
|
||||
"rollup-plugin-tsconfig-paths": "^1.0.0",
|
||||
"rollup-plugin-visualizer": "^5.0.0"
|
||||
},
|
||||
"devDependencies": {
|
||||
"presetter": "workspace:*"
|
||||
"@semantic-release/changelog": "^6.0.3",
|
||||
"@semantic-release/git": "^10.0.1",
|
||||
"presetter": "^4.0.1",
|
||||
"presetter-preset-esm": "^4.0.1",
|
||||
"semantic-release": "^21.0.6"
|
||||
},
|
||||
"dependencies": {
|
||||
"presetter-types": "workspace:*",
|
||||
"presetter-types": "^4.0.1",
|
||||
"type-fest": "^3.12.0"
|
||||
},
|
||||
"publishConfig": {
|
||||
"access": "public"
|
||||
}
|
||||
}
|
||||
|
|
|
@ -66,6 +66,7 @@ export default function (): PresetAsset {
|
|||
return template(content, variable);
|
||||
/* eslint-enable @typescript-eslint/naming-convention */
|
||||
},
|
||||
'tsconfig.config.json': resolve(TEMPLATES, 'tsconfig.config.yaml'),
|
||||
},
|
||||
scripts: resolve(TEMPLATES, 'scripts.yaml'),
|
||||
noSymlinks: ['rollup.config.ts'],
|
||||
|
|
|
@ -1,5 +1,6 @@
|
|||
# replace the `prepare` template from presetter-preset
|
||||
# so that the build procedure will not be triggered upon package installation
|
||||
build: cross-env NODE_ENV=production run-s clean build:rollup
|
||||
build:rollup: rollup --config rollup.config.ts --configPlugin rollup-plugin-ts
|
||||
build: cross-env NODE_ENV=production run-s clean build:rollup-config build:rollup
|
||||
build:rollup-config: tsc -p tsconfig.config.json rollup.config.ts
|
||||
build:rollup: rollup --config rollup.config.js
|
||||
develop: cross-env NODE_ENV=development run-s "build:rollup -- --watch {@}" --
|
||||
|
|
|
@ -0,0 +1,6 @@
|
|||
extends: .
|
||||
include:
|
||||
- '.'
|
||||
compilerOptions:
|
||||
# emittance
|
||||
outDir: '.'
|
Loading…
Reference in New Issue