生态概览
TechUI 并非一个单体庞大的库,而是一个由模块化、分层级的 Npm 包组成的精细生态系统。
这种设计遵循“关注点分离”原则:
- 如果您只需要基础组件,无需加载沉重的科幻引擎。
- 如果您只需要处理颜色数据,无需引入 Vue 框架代码。
我们将整个生态划分为以下六大板块,您可以根据需求按需查阅。
组件库
TechUI 的核心交互层,包含从原子级元素到旗舰级解决方案的完整梯队。
| 包名 (Package) | 描述 | 许可证 |
|---|---|---|
| @techui/prime | 旗舰版。集成了 Base 的稳健、Admin 的业务与 Scifi 的视觉。 支持 Wasm 核心与重许可机制。 | 💎 付费 |
| @techui/admin | 业务中台。提供标准的表格、表单、弹窗与布局容器, 构建复杂后台系统的骨架。 | 🆓 免费 |
| @techui/base | 底层基石。最纯粹的 Vue3 原子组件库,包含 TuiAdaptive 适配引擎,是上层库的共同依赖。 | 🆓 免费 |
| @techui/scifi | 科幻视觉。基于动态 SVG 引擎的装饰组件库, 为大屏应用提供电影级的视觉特效。 | 🆓 免费 |
图标和字体
视觉资产层,致力于在“高清显示”与“加载性能”之间寻找完美平衡。
- @techui/icons: 采用极致压缩的 Woff2 WebFont 方案。包含 TechUI 原创的默认库与 IBM Carbon 的深度定制库。内置交互式预览工具。
- @techui/fonts: 排版美学资源包。提供“按需引入”的中文字体(如霞鹜文楷、思源黑体)与“组合引入”的英文数字字体(Scifi Fonts)。
样式和主题
视觉管理层,通过数据驱动的方式管控整个应用的设计语言。
- @techui/themes: 数据驱动的主题系统。支持运行时切换,通过双通道(CSS 变量 + JS 状态)同时驱动 DOM 元素与 Canvas 图表(ECharts)。
- @techui/colors: 色彩语义系统。基于 HSL 模型构建,提供 V1(UI 设计)和 V2(数据可视化)两套色板,支持自然语义调用。
- @techui/lessmixins: CSS 加速器。提供大量 Less 简写语法(如
.bd,.wh)与通用布局封装,显著提升样式编写效率。
工具库
逻辑支撑层,为上层业务提供轻量、高性能的底层函数。
- @techui/utils: TechUI 的“瑞士军刀”。封装了 DOM 操作、本地存储管理、严格类型检测以及生态核心方法(如主题注册
tTheme)。
多语言
国际化层,助力应用走向全球。
- @techui/locales: 高性能 i18n 资源包。支持代码分割与按需加载,自动侦测环境并仅加载用户所需的语言切片(CN/HK/EN)。
第三方库
依赖治理层,确保生态系统的长期稳定性。
- @techui/libs: 依赖集成港。收录并锁定了
dayjs,chroma.js,async-validator等核心第三方依赖的版本,部分库包含针对 TechUI 的源码级定制。
安全与特殊库
这类库不提供直接的 UI 界面或通用工具函数,而是作为 TechUI 商业授权体系的底层安全依赖存在。它们通常处理加密、验证与授权逻辑。
- @techui/prime-keychain: 核心密钥串。这是 Prime 旗舰版的“实体公钥”。它不包含任何可视组件,而是存储了经过混淆的公钥分片与 Wasm 验证种子。作为双因子解密机制的关键一环,它必须与您的 Client Key(私有凭证)同时存在,才能激活 Prime 的完整功能。(🔒 专有协议)