[Discussion] Rax Core result format

[SoloJiang]

背景

目前 rax 核心包会导出多种格式文件，但实际使用到的比较少，同时由于 rollup 版本升级导致原先 dist/rax.js IIFE 格式的导出形式和之前存在差异，不能直接在 cjs 的模块系统中使用（可在构建结束添加导出代码，以前也是通过添加导出代码 run 起来的）。

当下打出的产物如下：

- dist
  - rax.js
  - rax.min.js
  - rax.umd.js
  - rax.umd.js 
  - rax.mjs.js
- lib (多文件)
- es（多文件、esm 导出规范）

lib 和 es 目录是通过 babel 单文件编译的。

同时 rax core 的入口文件为根目录下 index.js：

if (process.env.NODE_ENV === 'production') {
  module.exports = require('./dist/rax.min.js');
} else {
  module.exports = require('./lib/index.js');
}

同时，dist/rax.min.js 和 lib/index.js 是否是 esmodule 导出的标识也是不一样的（前者没有），这会导致某些构建场景下存在不一致性，导致报错。

React 是怎么做的

目前 React 没有多文件导出形式，全部都是编译成单文件，同时提供两种格式的产物，分别是 cjs 和 umd，发到 cdn 上的版本是 umd，通过 npm 引用的形式是 cjs：https://unpkg.com/browse/react@17.0.2/

入口文件为：

'use strict';

if (process.env.NODE_ENV === 'production') {
  module.exports = require('./cjs/react.production.min.js');
} else {
  module.exports = require('./cjs/react.development.js');
}

即统一使用 cjs 的形式。

后续变更方案（待讨论）

• rax core 也只提供单文件编译产物，同时走 npm 引用的时候，生产环境和开发环境引用的格式相同
• 面向未来相比 React 的产物，应该多一份 esm 的产物形式，所以最终产物结构为：

• lib（cjs）
  • rax.js
  • rax.min.js
  • ...
• dist（umd）
  • rax.js
  • rax.min.js
• es（esm）
  • rax.js
  • rax.min.js
• index.js

index.js 中导出 cjs 产物：

'use strict';

if (process.env.NODE_ENV === 'production') {
  module.exports = require('./lib/rax.min.js');
} else {
  module.exports = require('./lib/rax.js');
}

cdnjs 上同时上传 lib/es/dist 目录（需要给 cdnjs/packages 提 PR）

[SoloJiang]

• 这里可能造成的影响是，g.alicdn 上 rax 的地址发生变更，会对简单写 https://g.alicdn.com/code/lib/rax/${version}/rax.js 的人造成影响，但我理解可以接受？
• 需要考虑 compat 文件怎么导出？现在用法是 alias: rax => rax/lib/compat

[SoloJiang]

• lib/es/dist 下针对 compat 模式再打出一个 compat.js
• 或者直接把抽离的 API 再合入 rax core（会导致 core 体积变大）

[imsobear]

单文件的话全部放在 dist 目录下是不是更好？

[imsobear]

「或者直接把抽离的 API 再合入 rax core（会导致 core 体积变大）」大多少，之前有聊过把这块直接放到 core 里，不强行分开了

[SoloJiang]

全部放在 dist 目录下可能存在的问题： compat 文件现在的 alias 是这么做的： alias: rax => rax/lib/compat 可能会有 break

[SoloJiang]

「或者直接把抽离的 API 再合入 rax core（会导致 core 体积变大）」大多少，之前有聊过把这块直接放到 core 里，不强行分开了

gzipped 之后 1kb 左右

[SoloJiang]

最终结论：

• 全部格式文件输出到 dist 目录
• lib 目录下单独编译 compat 文件进行兜底

[SoloJiang]

2219