taro-uno-ui 0.9.0-beta

package/LICENSE

@@ -0,0 +1,100 @@
+MIT License
+
+Copyright (c) 2025 Agions
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+## Enterprise License
+
+For enterprise licensing options, including:
+
+- Commercial support and maintenance
+- Custom development and features
+- Priority bug fixes and security patches
+- Dedicated deployment assistance
+- Training and consulting services
+
+Please contact us at [enterprise@taro-uno.com](mailto:enterprise@taro-uno.com)
+
+## Third-Party Licenses
+
+This project includes third-party components with their own licenses:
+
+### React and React DOM
+
+- License: MIT
+- Source: https://reactjs.org/
+
+### Taro Framework
+
+- License: MIT
+- Source: https://taro.jd.com/
+
+### TypeScript
+
+- License: Apache 2.0
+- Source: https://www.typescriptlang.org/
+
+### Vite
+
+- License: MIT
+- Source: https://vitejs.dev/
+
+### Vitest
+
+- License: MIT
+- Source: https://vitest.dev/
+
+### Storybook
+
+- License: MIT
+- Source: https://storybook.js.org/
+
+### DOMPurify
+
+- License: MPL 2.0
+- Source: https://github.com/cure53/DOMPurify
+
+### i18next
+
+- License: MIT
+- Source: https://www.i18next.com/
+
+### Other Dependencies
+
+See `package.json` for a complete list of dependencies and their respective licenses.
+
+## Trademarks
+
+Taro, React, and other mentioned products are trademarks of their respective owners.
+
+## Disclaimer
+
+THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
+INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
+OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,273 @@
+# Taro Uno
+
+Taro Uno 是一个基于 Taro 框架的跨平台组件库，提供丰富的 UI 组件和表单控件，支持微信小程序、H5、React Native 等多端开发。
+
+## 特性
+
+- **跨平台兼容**：支持微信小程序、H5、React Native 等多端环境
+- **丰富组件**：提供完整的 UI 组件和表单控件
+- **TypeScript 支持**：完整的类型定义，提供良好的开发体验
+- **主题定制**：支持自定义主题和样式变量
+- **易于扩展**：组件设计遵循可组合、可扩展原则
+- **完善文档**：详细的使用文档和示例
+
+## 安装
+
+```bash
+# 使用 npm
+npm install taro-uno-ui
+
+# 使用 yarn
+yarn add taro-uno-ui
+
+# 使用 pnpm
+pnpm add taro-uno-ui
+```
+
+## 快速开始
+
+### 引入样式
+
+在项目入口文件中引入全局样式：
+
+```tsx
+// app.tsx 或 app.jsx
+import 'taro-uno-ui/dist/style.css';
+```
+
+### 引入组件
+
+```tsx
+import React from 'react';
+import { View } from '@tarojs/components';
+import { Button, Input } from 'taro-uno-ui';
+
+const App = () => {
+  return (
+    <View>
+      <Input placeholder="请输入内容" />
+      <Button type="primary">点击我</Button>
+    </View>
+  );
+};
+
+export default App;
+```
+
+## 组件分类
+
+### 基础组件 (Basic)
+- Button - 按钮
+- Icon - 图标
+- Typography - 排版
+
+### 表单组件 (Form)
+- Input - 输入框
+- Select - 选择器
+- Checkbox - 复选框
+- Radio - 单选框
+- Switch - 开关
+- Slider - 滑块
+- Upload - 上传
+- DatePicker - 日期选择器
+- TimePicker - 时间选择器
+- Cascader - 级联选择器
+- Textarea - 多行文本输入
+
+### 布局组件 (Layout)
+- Grid - 网格
+- Space - 间距
+- Divider - 分割线
+- Container - 容器
+
+### 显示组件 (Display)
+- Card - 卡片
+- Table - 表格
+- List - 列表
+- Badge - 徽标
+- Avatar - 头像
+
+### 反馈组件 (Feedback)
+- Modal - 对话框
+- Message - 消息提示
+- Notification - 通知提醒
+- Toast - 轻提示
+- Loading - 加载
+
+### 导航组件 (Navigation)
+- Tabs - 标签页
+- Pagination - 分页
+- Steps - 步骤条
+
+## 文档
+
+### 组件文档
+
+每个组件都配有详细的中文文档，包含：
+- 功能介绍
+- 基本用法
+- API 参数说明
+- 事件说明
+- 使用示例
+
+### 文档结构
+
+组件文档位于 `docs/components/` 目录下，按组件类型分类：
+
+- `docs/components/basic/` - 基础组件文档
+- `docs/components/form/` - 表单组件文档
+- `docs/components/layout/` - 布局组件文档
+- `docs/components/display/` - 显示组件文档
+- `docs/components/feedback/` - 反馈组件文档
+- `docs/components/navigation/` - 导航组件文档
+
+### 示例代码
+
+每个组件的文档目录中包含 `examples` 文件夹，提供可运行的示例代码，方便开发者快速了解组件的使用方法。
+
+### 文档生成
+
+我们提供了自动化的文档生成工具：
+
+```bash
+# 生成所有文档
+node scripts/generate-docs.js all
+
+# 生成组件文档
+node scripts/generate-docs.js components
+
+# 生成 API 文档
+node scripts/generate-docs.js api
+
+# 生成类型文档
+node scripts/generate-docs.js types
+```
+
+### 文档验证
+
+使用文档验证工具确保文档质量：
+
+```bash
+# 验证文档
+node scripts/validate-docs.js
+
+# 更新文档
+node scripts/update-docs.js --commit
+```
+
+### 文档部署
+
+文档自动化部署到 GitHub Pages：
+- 每次代码提交自动构建和部署
+- 支持多环境部署
+- 自动生成文档统计和报告
+
+### API 文档
+
+项目使用 TypeDoc 自动生成 API 文档：
+
+```bash
+# 生成 API 文档
+npm run docs:generate
+
+# 监听模式（文件变化自动重新生成）
+npm run docs:watch
+```
+
+生成的文档位于 `docs/api/` 目录，包含：
+- 完整的类型定义
+- 组件 Props 接口
+- 工具函数文档
+- 类型别名和枚举
+
+### 本地开发
+
+```bash
+# 启动文档开发服务器
+cd docs
+pnpm install
+pnpm dev
+
+# 构建文档
+pnpm build
+```
+
+## 开发指南
+
+### 开发环境设置
+
+1. 克隆仓库
+```bash
+git clone https://github.com/agions/taro-uno.git
+cd taro-uno
+```
+
+2. 安装依赖
+```bash
+pnpm install
+```
+
+3. 启动开发服务器
+```bash
+# H5
+pnpm dev:h5
+
+# 微信小程序
+pnpm dev:weapp
+```
+
+### 构建
+
+```bash
+# 构建 H5
+pnpm build:h5
+
+# 构建微信小程序
+pnpm build:weapp
+
+# 构建所有平台
+pnpm build:all
+```
+
+### 测试
+
+```bash
+# 运行单元测试
+pnpm test
+
+# 运行 ESLint 检查
+pnpm lint
+```
+
+## 🤝 贡献指南
+
+我们欢迎所有形式的贡献！请阅读 [贡献指南](./CONTRIBUTING.md) 了解详情。
+
+### 开发流程
+
+1. Fork 本仓库
+2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
+3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
+4. 推送到分支 (`git push origin feature/AmazingFeature`)
+5. 创建 Pull Request
+
+### 代码规范
+
+- 使用 TypeScript 编写代码
+- 遵循 ESLint 和 Prettier 规范
+- 编写完整的单元测试
+- 添加详细的 JSDoc 注释
+- 遵循 Git 提交规范
+
+## 许可证
+
+本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情
+
+## 更新日志
+
+详细的更新日志请查看 [CHANGELOG.md](CHANGELOG.md)
+
+## 联系我们
+
+- GitHub: https://github.com/agions/taro-uno
+- Issues: https://github.com/agions/taro-uno/issues