通用的 React 组件库、React Hooks 及 Utils 函数库
标准的 Lerna Monorepo 结构，支持 React 组件库、React Hooks 类库以及其它更多 TypeScript 类库开发。
推荐按需 fork 项目或从 Template 创建自己的项目。
https://fe-ground.eleven.net.cn/
-
lerna + yarn workspaces 的
monorepo多包结构 —— yarn workspaces 处理多包的依赖，其它的交给 lerna -
umijs dumi 集中编译所有包的 doc 文档、测试 demo
-
umijs father-build 独立编译各子包
-
patch-package 调整 node_modules 包源码（因为给开源包贡献代码周期太长了）
-
修改了 father-build（v1.19.6）的源码，调整 @babel/plugin-transform-runtime，增加 corejs 配置，以便自动导入 ES API 垫片（如：
includes()、Object.assign()等各类新 API 可直接使用，编译时会自动被导入垫片） -
yarn workspaces 中使用
patch-package的问题讨论：
-
yarn run create # 自动初始化创建 React Component/React Hooks/Util Function/New Package
yarn docs:start # 启动文档调试、测试 demo
yarn docs:build # 打包文档、测试 demo
yarn test # 运行所有 packages jest test
yarn test:watch # 运行所有 packages jest test，watch 模式
yarn test:coverage # 查看所有 packages 测试覆盖率
# 更多命令（直接传子包目录名，即可单独运行子包，示例如下）
# yarn test --components # 仅运行 components 目录子包 jest test
# yarn test:watch --components # 仅运行 components 目录子包 jest test，watch 模式
# yarn test:coverage --components # 仅查看 components 目录子包测试覆盖率
yarn watch # 监听所有 packages 编译
# 更多命令（直接传子包目录名，即可单独编译子包）
# yarn watch --components # 仅监听 components 目录子包编译
# yarn watch --hooks # 仅监听 hooks 目录子包编译
# yarn watch --utils # 仅监听 utils 目录子包编译
yarn build # 打包所有 packages
# 更多命令（直接传子包目录名，即可单独编译子包）
# yarn build --components # 仅打包 components 目录子包
# yarn build --hooks # 仅打包 hooks 目录子包
# yarn build --utils # 仅打包 utils 目录子包
yarn lint # 运行 eslint
yarn lint:fix # 运行 eslint fix
yarn commit # 交互式 commit message
yarn pub # publish packages（发布所有变更的 package）
# 更多发布命令
yarn pub from-git # 从上一次中断的位置继续发布（例如：因无权限而导致的发布失败了，添加权限后可通过此命令继续发布，避免造成版本号再次提升）
yarn pub from-package # 将本地领先版本的包全部发布一次（适用场景：某些原因，可能本地的包版本被提升，但未发布，或者，直接手动修改大版本号后发布）封装了运行脚本扩展支持更多参数，运行 test/watch/build 命令时，参数传入子包目录名称，即可仅运行该子包，以提升某些场景下的编译性能及操作便利。
例如：运行 yarn build --components，仅会打包 components 目录下的子包。
仅在十分确定某个改动只会影响某个子包时，才单独运行、调试某个子包。一般情况下不需要担心编译性能，因此可以放心编译全部包。
├── .umi/ # umijs 缓存目录（dumi 文档工具基于 umijs 生态）
├── docs/ # 文档
│ ├── contribution/ # 贡献代码
│ ├── guide/ # 指南
│ └── index.md # 首页
├── node_modules/ # 公共依赖（dumi、father-build、@umijs/test 等）
├── packages/ # 源码
│ ├── components/ # react components
│ │ ├── es/ # components 编译产物 - es modules
│ │ ├── lib/ # components 编译产物 - cjs modules
│ │ ├── node_modules/ # 子包依赖（如 @babel/runtime-corejs3 等）
│ │ ├── src/ # components 源码
│ │ │ ├── ...
│ │ │ ├── LayoutPercent/ # 百分比布局容器组件
│ │ │ │ ├── __tests__/ # jest 单元测试
│ │ │ │ ├── demos/ # 测试 demo
│ │ │ │ │ ├── demo1.style.less # 测试代码的样式
│ │ │ │ │ └── demo1.tsx # demo 测试
│ │ │ │ ├── style/ # 组件样式
│ │ │ │ │ ├── index.less # 组件样式入口（less）
│ │ │ │ │ └── index.ts # 组件样式入口（ts）
│ │ │ │ ├── index.md # API 文档
│ │ │ │ └── index.ts # 组件源码
│ │ │ ├── ...
│ │ │ └── index.less # components 样式文件入口
│ │ │ └── index.ts # components 入口
│ │ ├── .fatherrc.ts # father-build 配置（集成根目录的 .fatherrc.ts 配置）
│ │ ├── README.md
│ │ ├── package.json
│ │ ├── tsconfig.json
│ │ └── typings.d.ts # 全局类型定义
│ ├── hooks/ # react hooks
│ │ ├── dist/ # hooks 编译产物
│ │ ├── node_modules/ # 子包依赖（如 @babel/runtime-corejs3 等）
│ │ ├── src/ # hooks 源码
│ │ │ ├── ...
│ │ │ ├── useCountDown/ # 倒计时 hooks
│ │ │ │ ├── __tests__/ # jest 单元测试
│ │ │ │ ├── demos/ # 测试 demo
│ │ │ │ ├── index.md # API 文档
│ │ │ │ └── index.ts # 源码
│ │ │ ├── ...
│ │ │ └── index.ts # hooks 入口
│ │ ├── README.md
│ │ ├── package.json
│ │ ├── tsconfig.json
│ │ └── typings.d.ts
│ └── utils/ # 通用 utils
│ ├── dist/ # utils 编译产物
│ ├── node_modules/ # 子包依赖（如 @babel/runtime-corejs3 等）
│ ├── src/ # utils 源码
│ │ ├── ...
│ │ ├── compareVersion/ # 版本号比较
│ │ │ ├── __tests__/ # jest 单元测试
│ │ │ ├── demos/ # 测试 demo
│ │ │ ├── index.md # API 文档
│ │ │ └── index.ts # 源码
│ │ ├── ...
│ │ └── index.ts # utils 入口
│ ├── README.md
│ ├── package.json
│ ├── tsconfig.json
│ └── typings.d.ts
├── patches/ # patch-package 修改 node_modules 包源码
│ └── father-build+1.19.6.patch # 修改 father-build 源码
├── scripts/ # node 脚本
├── .editorconfig
├── .eslintignore
├── .eslintrc.js
├── .fatherrc.ts # father-build 配置（会被子 package 中的 .fatherrc.ts 继承）
├── .gitignore
├── .prettierignore
├── .prettierrc
├── .umirc.ts # 文档使用 dumi 编译、打包
├── .yarnrc
├── lerna.json
├── package.json
├── README.md
├── tsconfig.json
└── yarn.lock # 请勿手动删除，高危预警！若没有特殊需求，通常可以通过
yarn run create来新建。
-
目录结构方面，你可以有多种选择
默认生成的是较为通用的目录结构，
__tests__单元测试目录和src目录是平级的，这是编写 SDK 较为常用的方式。若你的 SDK 代码结构是类似
packages/components、packages/utils这种，内部的组件、函数相互独立，且数量众多，那么，推荐你参照 components、utils 目录的结构风格，略加修改即可。 -
API 文档
若需要编写的文档并不多，那么直接在
src/README.md中编写即可，否则请参照packages/components、packages/utils或阅读 dumi 的文档规则去编写。
提供了 yarn run create 命令一键生成基础代码（React Component/React Hooks/Util Function/New Package），如图：
使用 yarn workspaces 管理包依赖，推荐按如下方式操作：
-
给单个 package 安装依赖
例如，需要在
@e.fe/utils中安装lodash，终端命令示例如下：# 若执行命令提示类似的错误 ☞ error An unexpected error occurred: "expected workspace package to exist for \"@babel/template\"". # 请尝试将 yarn 降级到 v1.18.0，或 npx [email protected] # https://github.com/yarnpkg/yarn/issues/7807 npx [email protected] workspace @e.fe/utils add lodash
若无法使用上述方式安装，可以在子包的
package.json中填写依赖，到根目录执行yarn安装。请勿在子包目录下直接安装依赖包，这会导致依赖包出现在子包的
node_modules中，虽然并不会导致运行、编译出错（正常情况下，依赖包都应该出现在根目录的node_modules中）。 -
给所有 package 安装相同的依赖
所有子包都需要的依赖，不能在 Root 安装，否则，依赖无法出现在 package 的
dependencies、devDependencies中，包发布以后安装、使用会遇到问题。例如，所有 package 都需要依赖
@babel/runtime-corejs3，终端命令示例如下：yarn workspaces run add @babel/runtime-corejs3
-
给 Root 安装依赖
Root 一般是安装项目的开发工具等，所有 package 都需要的依赖不能在此处安装，在根目录执行命令需带上
-W，例如需要安装lerna，终端命令示例如下：yarn add lerna -W -D
依赖包的卸载、更新，将 add 更换为 remove、upgrade 即可。
-
dependencies、peerDependencies中的依赖，均会自动被列入到 rollup 编译的 external（babel 编译模式不会）。 -
支持 lerna 结构，根目录配置
.fatherrc.ts，即可运行编译所有 package。 -
package 目录配置的
.fatherrc.ts会继承根目录的.fatherrc.ts。