tcdona_unilib - 统一依赖聚合层

一个统一的依赖管理库，支持通过子路径导入，保持 tree-shaking 能力。

特性

- ✅ ESM 模块（type: module）
- ✅ 子路径导入支持（如 import from 'tcdona_unilib/zod'）
- ✅ Tree-shaking 优化
- ✅ 完整的类型支持
- ✅ 统一的版本管理

安装

``bash
npm install tcdona_unilib


or

yarn add tcdona_unilib

or

pnpm add tcdona_unilib
`

使用

$3

`typescript
// 导入单个库
import { z } from "tcdona_unilib/zod"
import { nanoid } from "tcdona_unilib/nanoid"
import dayjs from "tcdona_unilib/dayjs"
import { defineConfig } from "tcdona_unilib/vite"

// 导入所有库
import * as tcdona_unilib from "tcdona_unilib"
`

支持的库

| 库名 | 导入方式 | 用途 |
| ---------- | -------------------------- | ---------- |
| neverthrow | tcdona_unilib/neverthrow | 错误处理 |
| zx | tcdona_unilib/zx | Shell 脚本 |
| dayjs | tcdona_unilib/dayjs | 日期时间 |
| big.js | tcdona_unilib/big.js | 精确算术 |
| es-toolkit | tcdona_unilib/estk | ES 工具集 |

项目结构

`
tcdona_unilib/
├── package.json # 统一依赖声明
├── tsconfig.json # TypeScript 配置
├── index.ts # 全量导出入口
├── neverthrow.ts # 子路径模块
├── zod.ts
├── ... (其他 20 个库)
└── README.md
`

配置原理

- exports 字段: 定义子路径映射关系，支持 tcdona_unilib/zod 导入方式
- type: module: 启用 ESM 模块系统
- Tree-shaking: 每个模块仅做简单转发，构建工具可自动优化

添加新库

要添加新库，只需：

1. 在 package.json 的 dependencies 中添加库及版本
2. 在 exports 中添加路径映射
3. 创建对应的 *.ts 转发文件：
`typescript
export { method } from "your-library"
`
禁止用 export *
4. 在 index.ts 中添加导出行

版本管理

所有依赖版本统一在 package.json` 中管理，确保项目内一致性。