Cursor rule

1---
2description: SmartUI 组件目录结构及修改范围
3globs: packages/**/*
4alwaysApply: false
5---
6 
7# 组件目录与修改范围
8 
9## 修改范围
10 
11- **仅修改 `packages/` 下代码**；`example/` 为打包产物目录，勿直接改。
12- 开发时只改动 packages 内组件与 demo，打包会把 packages 下 demo 打到 example/dist。
13 
14## 单组件目录结构
15 
16| 路径 | 说明 |
17|------|------|
18| `demo/` | 组件 demo 入口，含 index.wxml/ts/less/json |
19| `test/` | 测试用例，至少含 demo.spec.ts，可选 index.spec.ts |
20| `index.json` | 基础配置，子组件在 `usingComponents` 中声明 |
21| `index.less` | 样式，会自动加载 |
22| `index.ts` | 主逻辑，使用 SmartComponent 封装 |
23| `index.wxml` | 模板 |
24| `index.wxs` | 可选，模板内计算逻辑，**仅 ES5** |
25| `README.md` / `README.en.md` | 文档 |
26 
27## index.json 与子组件
28 
29- 声明 `"component": true`。
30- 依赖子组件用相对路径，例如：`"smart-icon": "../icon/index"`。
31 
32## 组件封装方式
33 
34- 使用 `SmartComponent`（来自 `../common/component`）。
35- 选项映射：`data`、`props`→properties、`watch`→observers、`mixins`→behaviors、`created`→attached、`mounted`→ready、`destroyed`→detached。
36- 常用从 `../mixins/` 或 `../common/` 引入能力。
37