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 | useFlow: true,
|
37 | loose: true,
|
38 | runtimeOptions: {},
|
39 | presets: [],
|
40 | plugins: [],
|
41 | },
|
42 | eslint: {},
|
43 | postcss: {},
|
44 | };
|
45 | };
|
46 | ```
|
47 |
|
48 | ## api
|
49 |
|
50 | ```
|
51 | transformEs( src, dest, options );
|
52 | ```
|
53 |
|
54 | ## options
|
55 |
|
56 | ```
|
57 | {
|
58 | glob: ["**/*", "**/*.*", "**/.*"],
|
59 | clean: true, //转换前清空输出目录
|
60 | watch: false,
|
61 | ignore: null, // file => boolean
|
62 | filter: null,// file => boolean
|
63 | log: true, // 打印转换日志信息
|
64 | babel: {
|
65 | useFlow: true,
|
66 | loose: true,
|
67 | runtimeOptions: {},
|
68 | presets: [],
|
69 | plugins: [],
|
70 | ...presetOptions
|
71 | },
|
72 | postcss: {},
|
73 | // https://www.npmjs.com/package/gulp-dart-scss
|
74 | scss: {},
|
75 | // https://www.npmjs.com/package/gulp-less
|
76 | less: {},
|
77 | cssModule: {
|
78 | test: /\.module.(less|scss|css)$/,
|
79 | esModule: true,
|
80 | },
|
81 | raw: {
|
82 | test: /\.svg$/,
|
83 | },
|
84 | // (stream, options, meta) => stream
|
85 | transform: null
|
86 | }
|
87 | ```
|
88 |
|
89 | ## examples
|
90 |
|
91 | ```
|
92 | const transformEs = require('transform-es');
|
93 |
|
94 | transformEs('src', 'lib', {
|
95 | watch: true
|
96 | });
|
97 |
|
98 | ```
|