{"_id":"@bestzy/ui","name":"@bestzy/ui","dist-tags":{"latest":"2.1.1"},"versions":{"2.1.1":{"name":"@bestzy/ui","version":"2.1.1","description":"A lightweight, customizable Vue UI library for mobile web apps","main":"lib/index.js","module":"es/index.js","types":"lib/index.d.ts","keywords":["vue","vue3","typescript","ui","mobile","components","ui-kit","ui-library"],"author":"","license":"MIT","repository":{"type":"git","url":"git+https://github.com/your-username/components.git"},"bugs":{"url":"https://github.com/your-username/components/issues"},"homepage":"https://github.com/your-username/components#readme","peerDependencies":{"vue":"^3.0.0"},"devDependencies":{"@babel/core":"^7.22.0","@babel/preset-env":"^7.22.0","@types/node":"^20.19.0","@typescript-eslint/eslint-plugin":"^6.0.0","@typescript-eslint/parser":"^6.0.0","@vitejs/plugin-vue":"^4.0.0","@vue/test-utils":"^2.4.0","eslint":"^8.42.0","eslint-plugin-vue":"^9.15.0","husky":"^8.0.3","jsdom":"^22.0.0","less":"^4.1.3","lint-staged":"^13.2.0","prettier":"^3.0.0","typescript":"^5.0.0","vite":"^4.3.0","vitest":"^0.32.0","vue":"^3.3.0","vue-tsc":"^1.8.0"},"lint-staged":{"*.{vue,js,ts,tsx}":["eslint --fix","prettier --write"]},"sideEffects":["es/**/style/*","lib/**/style/*","*.css","*.less"],"browserslist":["Chrome >= 51","iOS >= 10"],"scripts":{"dev":"vite dev","build":"pnpm build:lib && pnpm build:site","build:lib":"vant-cli build","build:site":"vant-cli build-site","test":"vitest","test:coverage":"vitest --coverage","lint":"eslint ./packages --ext .vue,.js,.ts,.tsx --fix","type-check":"vue-tsc --noEmit","release":"vant-cli release"},"_id":"@bestzy/ui@2.1.1","_integrity":"sha512-mCzCD9UpjdbssDOQx3Ojh6ko14EQDTWljVWPzE+BCvUX04HbIvDo11UNQWsf/+j/FZm64yEY/rDlEtDxSjIGYA==","_resolved":"/private/var/folders/p0/gj7f_y1x0kg87q4s9gy1_4680000gn/T/78ec3d7383a0283d419b1ca633ea9a4d/bestzy-ui-2.1.1.tgz","_from":"file:bestzy-ui-2.1.1.tgz","_nodeVersion":"20.18.1","_npmVersion":"10.8.2","dist":{"integrity":"sha512-mCzCD9UpjdbssDOQx3Ojh6ko14EQDTWljVWPzE+BCvUX04HbIvDo11UNQWsf/+j/FZm64yEY/rDlEtDxSjIGYA==","shasum":"de06662dae6a20ec61793c69f34af33b3b7f3b06","tarball":"https://registry.npmjs.org/@bestzy/ui/-/ui-2.1.1.tgz","fileCount":3,"unpackedSize":7394,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCGeY8T5rDuUj1E1U9ocEAgJLTAvbG6daUx33X1KQOCnAIhAICrBjKIlrDz9WDX7pZATDOc5PURKoNuX+teBuy2g38Z"}]},"_npmUser":{"name":"best-zy","email":"3011543110@qq.com"},"directories":{},"maintainers":[{"name":"best-zy","email":"3011543110@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ui_2.1.1_1755940089223_0.7185142538590636"},"_hasShrinkwrap":false}},"time":{"created":"2025-08-23T09:08:09.105Z","2.1.1":"2025-08-23T09:08:09.414Z","modified":"2025-08-23T09:08:09.642Z"},"maintainers":[{"name":"best-zy","email":"3011543110@qq.com"}],"description":"A lightweight, customizable Vue UI library for mobile web apps","homepage":"https://github.com/your-username/components#readme","keywords":["vue","vue3","typescript","ui","mobile","components","ui-kit","ui-library"],"repository":{"type":"git","url":"git+https://github.com/your-username/components.git"},"bugs":{"url":"https://github.com/your-username/components/issues"},"license":"MIT","readme":"# 组件库\n\n一个轻量级、可定制的 Vue 3 移动端 UI 组件库，基于 TypeScript 开发。\n\n## 🛠️ 技术栈\n\nVue 3 - 渐进式 JavaScript 框架\nTypeScript - 类型安全的 JavaScript 超集\nVite - 现代前端构建工具\nVitest - 基于 Vite 的测试框架\nESLint + Prettier - 代码质量和格式化\nLess - CSS 预处理器\nVant CLI - 组件库构建工具\n\n## ✨ 特性\n\n- 🚀 基于 Vue 3 + TypeScript 开发\n- 📦 开箱即用的高质量组件\n- 🛠️ 完整的开发工具链\n- 🎨 支持主题定制\n- 📱 移动端优先设计\n- 💪 99% 单元测试覆盖率\n- 📖 详细的文档和示例\n- 🍭 支持 Tree Shaking\n- 🌍 支持 TypeScript\n\n## 📦 安装\n\n使用 npm 安装：\n\n```bash\nnpm install components\n```\n\n使用 yarn 安装：\n\n```bash\nyarn add components\n```\n\n使用 pnpm 安装：\n\n```bash\npnpm add components\n```\n\n## 🚀 快速开始\n\n### 完整引入\n\n```typescript\nimport { createApp } from 'vue';\nimport Components from 'components';\nimport 'components/lib/index.css';\n\nconst app = createApp();\napp.use(Components);\n```\n\n### 按需引入\n\n```typescript\nimport { createApp } from 'vue';\nimport { Button } from 'components';\nimport 'components/es/button/style';\n\nconst app = createApp();\napp.use(Button);\n```\n\n### 在组件中使用\n\n```vue\n<template>\n  <div>\n    <Button type=\"primary\" @click=\"handleClick\">\n      点击按钮\n    </Button>\n  </div>\n</template>\n\n<script setup lang=\"ts\">\nimport { Button } from 'components';\n\nconst handleClick = () => {\n  console.log('按钮被点击了！');\n};\n</script>\n```\n\n## 🔧 开发\n\n### 环境要求\n\n- Node.js >= 16\n- pnpm >= 7\n\n### 安装依赖\n\n```bash\npnpm install\n```\n\n### 开发模式\n\n启动开发服务器，实时预览组件：\n\n```bash\npnpm dev\n```\n\n### 构建\n\n构建组件库和文档：\n\n```bash\npnpm build\n```\n\n只构建组件库：\n\n```bash\npnpm build:lib\n```\n\n### 测试\n\n运行单元测试：\n\n```bash\npnpm test\n```\n\n运行测试并生成覆盖率报告：\n\n```bash\npnpm test:coverage\n```\n\n### 代码检查\n\n```bash\npnpm lint\n```\n\n### 类型检查\n\n```bash\npnpm type-check\n```\n\n## 📁 项目结构\n\n```\ncomponents/\n├── packages/                 # 组件源码\n│   ├── button/              # 按钮组件\n│   │   ├── index.ts         # 组件入口\n│   │   ├── Button.vue       # 组件实现\n│   │   ├── types.ts         # 类型定义\n│   │   └── __tests__/       # 单元测试\n│   ├── utils/               # 工具函数\n│   │   ├── dom.ts           # DOM 工具\n│   │   ├── format.ts        # 格式化工具\n│   │   └── validate.ts      # 校验工具\n│   ├── demo/                # 开发演示\n│   └── index.ts             # 组件库入口\n├── lib/                     # 构建输出 (CommonJS)\n├── es/                      # 构建输出 (ES Module)\n├── docs/                    # 文档网站\n└── tests/                   # 测试配置\n```\n\n## 🎯 开发计划\n\n- [x] ✅ 项目基础架构搭建\n- [x] ✅ TypeScript 配置\n- [x] ✅ 构建工具配置 (Vite + Vant CLI)\n- [x] ✅ 测试环境配置 (Vitest)\n- [x] ✅ 代码规范配置 (ESLint + Prettier)\n- [x] ✅ Button 组件示例\n- [ ] 🚧 更多基础组件开发\n- [ ] 📝 组件文档编写\n- [ ] 🎨 主题定制系统\n- [ ] 📱 移动端适配优化\n- [ ] 🚀 CI/CD 流程配置\n- [ ] 📦 NPM 包发布\n\n## 🤝 贡献指南\n\n欢迎提交 Issue 和 Pull Request！\n\n### 开发流程\n\n1. Fork 本仓库\n2. 创建你的特性分支 (`git checkout -b feature/AmazingFeature`)\n3. 提交你的改动 (`git commit -m 'Add some AmazingFeature'`)\n4. 推送到分支 (`git push origin feature/AmazingFeature`)\n5. 开启一个 Pull Request\n\n### 提交规范\n\n请遵循 [Conventional Commits](https://conventionalcommits.org/) 规范：\n\n- `feat:` 新功能\n- `fix:` 修复\n- `docs:` 文档\n- `style:` 代码格式\n- `refactor:` 重构\n- `test:` 测试\n- `chore:` 构建/工具\n\n## 📄 开源协议\n\n[MIT License](./LICENSE)\n\n## 🔗 相关链接\n\n- [Vue 3 官方文档](https://vuejs.org/)\n- [TypeScript 官方文档](https://typescriptlang.org/)\n- [Vite 官方文档](https://vitejs.dev/)\n- [Vitest 官方文档](https://vitest.dev/)\n\n## 💖 致谢\n\n特别感谢 [Vant](https://github.com/youzan/vant) 项目提供的设计灵感和最佳实践参考。","readmeFilename":"README.md","_rev":"1-367e1262dc737d445751ffcda8e4bba7"}