| 1 | # transform-es
|
| 2 |
|
| 3 | 对 ts, es6, scss, less, css 进行转换，并输出到指定目录
|
| 4 |
|
| 5 | ## install & usage
|
| 6 |
|
| 7 | `npm install --save-dev transform-es`
|
| 8 |
|
| 9 | `npx transform-es init`
|
| 10 |
|
| 11 | `npx transform-es src`
|
| 12 |
|
| 13 | ## cli
|
| 14 |
|
| 15 | > `transform-es src -d lib -t esm -c -w`
|
| 16 | >
|
| 17 | > `transform-es src -d lib -t web -c -w [-m]`
|
| 18 |
|
| 19 | > `transform-es src -d lib -t node -c -w`
|
| 20 |
|
| 21 | - `-f, --outFile` 输出到文件，只有单文件转换有效
|
| 22 | - `-d, --outDir` 输出到指定目录，默认为 lib
|
| 23 | - `-c, --clean` 转换前清空输出目录
|
| 24 | - `-w, --watch` 是否监控文件改变
|
| 25 | - `-t, --target` 指定输出目标： node|web|esm|cjs|commonjs|amd|umd|systemjs|auto 默认`web`
|
| 26 | - `--config` 配置文件 默认： `transform-es.config.js`
|
| 27 | - `--state` 传递给 transform-es.config.js 的数据
|
| 28 |
|
| 29 | ### transform-es.config.js
|
| 30 |
|
| 31 | ```js
|
| 32 | module.exports = function (options, state) {
|
| 33 | return {
|
| 34 | babel: {
|
| 35 | //...babel options
|
| 36 | decoratorsBeforeExport: true,
|
| 37 | useFlow: true,
|
| 38 | loose: true,
|
| 39 | runtimeOptions: {},
|
| 40 | presets: [],
|
| 41 | plugins: [],
|
| 42 | },
|
| 43 | eslint: {},
|
| 44 | postcss: {},
|
| 45 | };
|
| 46 | };
|
| 47 | ```
|
| 48 |
|
| 49 | ## api
|
| 50 |
|
| 51 | ```
|
| 52 | transformEs( src, dest, options );
|
| 53 | ```
|
| 54 |
|
| 55 | ## options
|
| 56 |
|
| 57 | ```
|
| 58 | {
|
| 59 | glob: ["**/*", "**/*.*", "**/.*"],
|
| 60 | clean: true, //转换前清空输出目录
|
| 61 | watch: false,
|
| 62 | ignore: null, // file => boolean
|
| 63 | filter: null,// file => boolean
|
| 64 | babel: {
|
| 65 | decoratorsBeforeExport: true,
|
| 66 | useFlow: true,
|
| 67 | loose: true,
|
| 68 | runtimeOptions: {},
|
| 69 | presets: [],
|
| 70 | plugins: [],
|
| 71 | ...presetOptions
|
| 72 | },
|
| 73 | eslint: {},
|
| 74 | postcss: {},
|
| 75 | // https://www.npmjs.com/package/gulp-dart-scss
|
| 76 | scss: {},
|
| 77 | // https://www.npmjs.com/package/gulp-less
|
| 78 | less: {},
|
| 79 | cssModule: {
|
| 80 | test: /\.module.(less|scss|css)$/,
|
| 81 | esModule: true,
|
| 82 | },
|
| 83 | raw: {
|
| 84 | test: /\.svg$/,
|
| 85 | },
|
| 86 | // (stream, options, meta) => stream
|
| 87 | transform: null
|
| 88 | }
|
| 89 | ```
|
| 90 |
|
| 91 | ## examples
|
| 92 |
|
| 93 | ```
|
| 94 | const transformEs = require('transform-es');
|
| 95 |
|
| 96 | transformEs('src', 'lib', {
|
| 97 | watch: true
|
| 98 | });
|
| 99 |
|
| 100 | ```
|