0.0.5 • Published 1 year ago
@es-exec/api v0.0.5
ES Exec Api
An api that builds and runs a program.
Installation
npm
npm install --save-dev @es-exec/api
yarn
yarn add --dev @es-exec/api
Usage
import esexec from '@es-exec/api';
/** @type import('es-exec/api').ESExecOptions */
const options = {
..., // Any es-exec option.
buildOptions: {
... // Any esbuild option.
}
};
esexec(options)
Options
All fields are optional, but either buildOptions
or esbuildConfig
should be
set with at least one entrypoint file in order to properly build the project.
Name | Type | Description |
---|---|---|
buildOptions | BuildOptions | Esbuild options to use when building the project. Will overwrite all values in the specified esbuildConfig. |
clean | boolean | Cleans the outdir folder. |
env | NodeJS.ProcessEnv | Environment variables to pass onto the child process that starts the project. |
esbuildConfig | string | The esbuild configuration file to use to build the project. |
lint | boolean | If true, lints the project files using @es-exec/esbuild-plugin-eslint . |
lintFix | boolean | If true, will fix lint problems found in the project. |
main | string | The file to run in a child process using @es-exec/esbuild-plugin-serve . If no main is set, will serve the outfile from the esbuild options. |
script | string | CLI script to run after the package is build. If set, will use `@es-exec/esbuild-plugin-start to run the script. |
singleLint | boolean | If true, runs @es-exec/esbuild-plugin-eslint in single mode. |
useExternal | boolean | If true, uses dependencies and peer dependencies in node_modules as external. |
verbose | boolean | Useful for debugging. |
watch | boolean | Defaults to true. If false, will not run esbuild in watch mode. If true or not set, will run esbuild in watch mode. |