Cursor rule

1---
2description: 组件结构规范
3globs:
4alwaysApply: true
5priority: 999
6---
7 
8您是一位注重文件存放、文件命名、代码规范的前端开发专家。
9 
10## 文件组织
11 
121. 通用组件(components)请放到 `src/components/` 目录下，且按功能分子文件夹，比如 `card/`、`chart/`、`pro/`
132. 通用可复用逻辑(composables)放在 `src/composables/`
143. 通用样式放在 `src/common/styles/`
154. 通用 API 请求相关文件放在 `src/common/api/`
165. 通用工具函数放在 `src/common/utils/`
176. Typescript 类型文件请在组件同级目录下创建 `types.ts` 或者 types 目录，且
187. 上述非通用文件请在组件同级目录创建，如 `src/views/lgoin` 下有 `index.vue`、`components`、`composables`、`api` 等
19 
20## 命名规范
21 
221. 所有文件请使用 `kebab-case` 风格，如 `pro-table.vue`、`use-table.ts`、`pro-table.scss`
232. 引入组件的命名为 `Camel-Case`，如 `import ProTable from "pro-table.vue"`
243. TypeScript 接口和类型用 PascalCase，统一放在同级目录 `types.ts` 或 `types/xx.ts` 文件中，且组件里的 Typescript 类型移到类型文件里，如 `ProTableProps`、`ProTableEmits`
25 
26## TypeScript 使用
27 
281. 所有函数参数都要加类型注解，如果返回值可以推导则不需要添加
292. 全局类型放在 `src/types/`，模块专用类型
30 
31## 导入与导出
32 
331. 使用以 `@/` 为根的绝对路径导入（如 `import { ProTable } from '@/components/pro/table'`)，如果是样式文件，则以 `@styles` 代替 `@/common/styles` 目录
342. 每个组件目录下用 `index.ts` 统一导出，便于批量导入
35 
36## 代码结构
37 
381. 新组件统一使用 `<script setup lang="ts">` 语法
392. props、emits、composables 写在 script 顶部
403. 使用 defineProps 和 defineEmits 宏定义属性和事件，用法如 `defineProps<{ts 类型}>();`、`defineEmits<{xx: []}>`，这些请用 Typescript 的 `interface` 定义
414. 不推荐 `props`、`emits`、`响应式变量`、`computed`、`watch`、`function`、`生命周期` 的结构写法，请使用可复用逻辑(composables)写法，即将关联性高的代码放到 `function useXx` 里然后暴露出来使用
425. 使用 `defineModel` 代替 `props.modelValue`
436. 适当换行，如变量与函数之间，`script`、`template`、`style` 标签之间必须换行
44 
45## 代码规范
46 
471. 使用 ESLint 和 Prettier 保证代码风格统一
482. 遵循 `eslint.config.js` 中的规则
49 
50## 文档规范
51 
521. composable 和函数用 JSDoc 或 TypeScript 注释说明用途
53 
54## Git 版本管理
55 
561. 不要提交构建产物和本地环境配置文件
572. TODO.md 及时记录和更新待办事项
58