@a2simcode/ui 0.0.55 → 0.0.57

package/.cursor/skills/ui-component-helper/README.md

@@ -1,43 +1,43 @@
-# UI Component Helper Skill
-
-这是一个 Cursor AI 技能文件，用于帮助在使用 `@a2simcode/ui` 和 `@a2simcode/dui` 组件的项目中获取组件的使用说明、Props 定义和示例。
-
-## 安装方式
-
-### 方式一：复制到项目本地（推荐）
-
-1. 在你的项目根目录创建 `.cursor/skills/ui-component-helper/` 目录
-2. 将 `node_modules/@a2simcode/ui/.cursor/skills/ui-component-helper/SKILL.md` 复制到 `.cursor/skills/ui-component-helper/SKILL.md`
-
-```bash
-mkdir -p .cursor/skills/ui-component-helper
-cp node_modules/@a2simcode/ui/.cursor/skills/ui-component-helper/SKILL.md .cursor/skills/ui-component-helper/SKILL.md
-```
-
-### 方式二：使用符号链接
-
-```bash
-mkdir -p .cursor/skills
-ln -s ../../node_modules/@a2simcode/ui/.cursor/skills/ui-component-helper .cursor/skills/ui-component-helper
-```
-
-## 使用方法
-
-安装后，当你询问组件用法时，Cursor AI 会自动使用此技能来查找：
-
-- 组件的 Props、Events、Slots 定义（从 Meta 数据文件）
-- 组件的使用文档（从 Markdown 文档）
-- 组件的代码示例（从示例文件）
-
-## 示例问题
-
-- "j-button 组件有哪些属性？"
-- "怎么使用 j-table 组件？"
-- "d-drag 组件的 API 是什么？"
-- "给我一个 input 组件的示例"
-
-## 注意事项
-
-- 此技能会自动从 `node_modules/@a2simcode/ui` 和 `node_modules/@a2simcode/dui` 中查找文档
-- 如果文档不存在于 node_modules 中，会尝试从项目源码路径查找（适用于开发环境）
-- 确保已安装 `@a2simcode/ui` 或 `@a2simcode/dui` 包
+# UI Component Helper Skill
+
+这是一个 Cursor AI 技能文件，用于帮助在使用 `@a2simcode/ui` 和 `@a2simcode/dui` 组件的项目中获取组件的使用说明、Props 定义和示例。
+
+## 安装方式
+
+### 方式一：复制到项目本地（推荐）
+
+1. 在你的项目根目录创建 `.cursor/skills/ui-component-helper/` 目录
+2. 将 `node_modules/@a2simcode/ui/.cursor/skills/ui-component-helper/SKILL.md` 复制到 `.cursor/skills/ui-component-helper/SKILL.md`
+
+```bash
+mkdir -p .cursor/skills/ui-component-helper
+cp node_modules/@a2simcode/ui/.cursor/skills/ui-component-helper/SKILL.md .cursor/skills/ui-component-helper/SKILL.md
+```
+
+### 方式二：使用符号链接
+
+```bash
+mkdir -p .cursor/skills
+ln -s ../../node_modules/@a2simcode/ui/.cursor/skills/ui-component-helper .cursor/skills/ui-component-helper
+```
+
+## 使用方法
+
+安装后，当你询问组件用法时，Cursor AI 会自动使用此技能来查找：
+
+- 组件的 Props、Events、Slots 定义（从 Meta 数据文件）
+- 组件的使用文档（从 Markdown 文档）
+- 组件的代码示例（从示例文件）
+
+## 示例问题
+
+- "j-button 组件有哪些属性？"
+- "怎么使用 j-table 组件？"
+- "d-drag 组件的 API 是什么？"
+- "给我一个 input 组件的示例"
+
+## 注意事项
+
+- 此技能会自动从 `node_modules/@a2simcode/ui` 和 `node_modules/@a2simcode/dui` 中查找文档
+- 如果文档不存在于 node_modules 中，会尝试从项目源码路径查找（适用于开发环境）
+- 确保已安装 `@a2simcode/ui` 或 `@a2simcode/dui` 包

package/.cursor/skills/ui-component-helper/SKILL.md

@@ -1,81 +1,81 @@
----
-name: 'ui-component-helper'
-description: '获取 @a2simcode/ui 和 @a2simcode/dui 组件的使用说明、Props 定义和示例。当用户询问组件用法或编写组件代码时调用。'
----
-
-# UI Component Helper
-
-此 Skill 用于帮助用户查找和理解 `@a2simcode/ui` 和 `@a2simcode/dui` 组件的使用方法。它会结合**官方文档元数据**、**文档说明**和**组件源码**来提供最准确的信息。
-
-## 查找策略
-
-**优先级：Meta 数据 (API) > 文档说明 (Guide) > 源码 (Source)**
-
-### 路径查找策略
-
-首先尝试从 npm 包中查找（适用于通过 npm 安装的项目），如果找不到则尝试从项目源码中查找：
-
-1. **优先查找 node_modules**：
-   - UI 组件 Meta: `node_modules/@a2simcode/ui/docs/components/meta/`
-   - DUI 组件 Meta: `node_modules/@a2simcode/dui/docs-dui/components/meta/`
-   - UI 组件文档: `node_modules/@a2simcode/ui/docs/components/`
-   - DUI 组件文档: `node_modules/@a2simcode/dui/docs-dui/components/`
-   - UI 组件示例: `node_modules/@a2simcode/ui/docs/examples/`
-   - DUI 组件示例: `node_modules/@a2simcode/dui/docs-dui/examples/`
-
-2. **备选：项目源码路径**（开发环境）：
-   - UI 组件 Meta: `docs/components/meta/`
-   - DUI 组件 Meta: `docs-dui/components/meta/`
-   - UI 组件文档: `docs/components/`
-   - DUI 组件文档: `docs-dui/components/`
-   - UI 组件示例: `docs/examples/`
-   - DUI 组件示例: `docs-dui/examples/`
-
-## 核心步骤
-
-### 第一步：定位组件和 API 定义
-
-1. **识别组件名称**：如 `button` (对应 `j-button`), `drag` (对应 `d-drag`)。
-2. **查找 Meta 数据**（按优先级顺序）：
-   - 首先尝试：`node_modules/@a2simcode/ui/docs/components/meta/<component>.ts` 或 `node_modules/@a2simcode/dui/docs-dui/components/meta/<component>.ts`
-   - 如果不存在，尝试：`docs/components/meta/<component>.ts` 或 `docs-dui/components/meta/<component>.ts`
-   - **关键**：读取此文件以获取结构化的 `props`, `events` 等定义。这是回答"有哪些属性/参数"的最准确来源。
-
-### 第二步：查找文档和示例
-
-1. **查找 Markdown 文档**（按优先级顺序）：
-   - 首先尝试：`node_modules/@a2simcode/ui/docs/components/<component>.md` 或 `node_modules/@a2simcode/dui/docs-dui/components/<component>.md`
-   - 如果不存在，尝试：`docs/components/<component>.md` 或 `docs-dui/components/<component>.md`
-   - 获取组件的功能描述。
-
-2. **查找示例代码**（按优先级顺序）：
-   - 首先尝试：`node_modules/@a2simcode/ui/docs/examples/<component>/basic.vue` 或 `node_modules/@a2simcode/dui/docs-dui/examples/<component>/basic.vue`
-   - 如果不存在，尝试：`docs/examples/<component>/basic.vue` 或 `docs-dui/examples/<component>/basic.vue`
-   - 优先查看 `basic.vue` (基础用法)。
-
-### 第三步：查阅源码 (备选)
-
-- 仅当 Meta 数据和文档都缺失，或需要了解内部实现细节时，才去查看源码：
-  - UI: `node_modules/@a2simcode/ui/packages/components/` 或 `packages/components/`
-  - DUI: `node_modules/@a2simcode/dui/packages/components-dui/` 或 `packages/components-dui/`
-
-### 第四步：综合回答
-
-1. **功能概述**：基于 Markdown 文档。
-2. **API 详细说明**：基于 Meta (`.ts`) 文件中的数据，列出 Props、Events 等。
-3. **代码示例**：引用 `examples/` 中的代码。
-
-## 常用组件映射
-
-- `j-button` -> `node_modules/@a2simcode/ui/docs/components/meta/button.ts` (API) & `node_modules/@a2simcode/ui/docs/examples/button/` (示例)
-- `j-table` -> `node_modules/@a2simcode/ui/docs/components/meta/table.ts` (API) & `node_modules/@a2simcode/ui/docs/examples/table/` (示例)
-- `d-drag` -> `node_modules/@a2simcode/dui/docs-dui/components/meta/drag.ts` (API) & `node_modules/@a2simcode/dui/docs-dui/examples/drag/` (示例)
-
-## 行动指南
-
-当用户询问"怎么用 [组件名]"或"[组件名] 有哪些属性"时：
-
-1. **首选**：读取 `node_modules/@a2simcode/ui/docs/components/meta/[组件名].ts` 或 `node_modules/@a2simcode/dui/docs-dui/components/meta/[组件名].ts` 获取 API 参数（如果不存在，尝试项目源码路径）。
-2. **次选**：读取 `node_modules/@a2simcode/ui/docs/components/[组件名].md` 获取描述（如果不存在，尝试项目源码路径）。
-3. **必选**：读取 `node_modules/@a2simcode/ui/docs/examples/[组件名]/basic.vue` 获取基础示例（如果不存在，尝试项目源码路径）。
-4. **回答**：综合以上信息，清晰展示组件用法和参数表。
+---
+name: 'ui-component-helper'
+description: '获取 @a2simcode/ui 和 @a2simcode/dui 组件的使用说明、Props 定义和示例。当用户询问组件用法或编写组件代码时调用。'
+---
+
+# UI Component Helper
+
+此 Skill 用于帮助用户查找和理解 `@a2simcode/ui` 和 `@a2simcode/dui` 组件的使用方法。它会结合**官方文档元数据**、**文档说明**和**组件源码**来提供最准确的信息。
+
+## 查找策略
+
+**优先级：Meta 数据 (API) > 文档说明 (Guide) > 源码 (Source)**
+
+### 路径查找策略
+
+首先尝试从 npm 包中查找（适用于通过 npm 安装的项目），如果找不到则尝试从项目源码中查找：
+
+1. **优先查找 node_modules**：
+   - UI 组件 Meta: `node_modules/@a2simcode/ui/docs/components/meta/`
+   - DUI 组件 Meta: `node_modules/@a2simcode/dui/docs-dui/components/meta/`
+   - UI 组件文档: `node_modules/@a2simcode/ui/docs/components/`
+   - DUI 组件文档: `node_modules/@a2simcode/dui/docs-dui/components/`
+   - UI 组件示例: `node_modules/@a2simcode/ui/docs/examples/`
+   - DUI 组件示例: `node_modules/@a2simcode/dui/docs-dui/examples/`
+
+2. **备选：项目源码路径**（开发环境）：
+   - UI 组件 Meta: `docs/components/meta/`
+   - DUI 组件 Meta: `docs-dui/components/meta/`
+   - UI 组件文档: `docs/components/`
+   - DUI 组件文档: `docs-dui/components/`
+   - UI 组件示例: `docs/examples/`
+   - DUI 组件示例: `docs-dui/examples/`
+
+## 核心步骤
+
+### 第一步：定位组件和 API 定义
+
+1. **识别组件名称**：如 `button` (对应 `j-button`), `drag` (对应 `d-drag`)。
+2. **查找 Meta 数据**（按优先级顺序）：
+   - 首先尝试：`node_modules/@a2simcode/ui/docs/components/meta/<component>.ts` 或 `node_modules/@a2simcode/dui/docs-dui/components/meta/<component>.ts`
+   - 如果不存在，尝试：`docs/components/meta/<component>.ts` 或 `docs-dui/components/meta/<component>.ts`
+   - **关键**：读取此文件以获取结构化的 `props`, `events` 等定义。这是回答"有哪些属性/参数"的最准确来源。
+
+### 第二步：查找文档和示例
+
+1. **查找 Markdown 文档**（按优先级顺序）：
+   - 首先尝试：`node_modules/@a2simcode/ui/docs/components/<component>.md` 或 `node_modules/@a2simcode/dui/docs-dui/components/<component>.md`
+   - 如果不存在，尝试：`docs/components/<component>.md` 或 `docs-dui/components/<component>.md`
+   - 获取组件的功能描述。
+
+2. **查找示例代码**（按优先级顺序）：
+   - 首先尝试：`node_modules/@a2simcode/ui/docs/examples/<component>/basic.vue` 或 `node_modules/@a2simcode/dui/docs-dui/examples/<component>/basic.vue`
+   - 如果不存在，尝试：`docs/examples/<component>/basic.vue` 或 `docs-dui/examples/<component>/basic.vue`
+   - 优先查看 `basic.vue` (基础用法)。
+
+### 第三步：查阅源码 (备选)
+
+- 仅当 Meta 数据和文档都缺失，或需要了解内部实现细节时，才去查看源码：
+  - UI: `node_modules/@a2simcode/ui/packages/components/` 或 `packages/components/`
+  - DUI: `node_modules/@a2simcode/dui/packages/components-dui/` 或 `packages/components-dui/`
+
+### 第四步：综合回答
+
+1. **功能概述**：基于 Markdown 文档。
+2. **API 详细说明**：基于 Meta (`.ts`) 文件中的数据，列出 Props、Events 等。
+3. **代码示例**：引用 `examples/` 中的代码。
+
+## 常用组件映射
+
+- `j-button` -> `node_modules/@a2simcode/ui/docs/components/meta/button.ts` (API) & `node_modules/@a2simcode/ui/docs/examples/button/` (示例)
+- `j-table` -> `node_modules/@a2simcode/ui/docs/components/meta/table.ts` (API) & `node_modules/@a2simcode/ui/docs/examples/table/` (示例)
+- `d-drag` -> `node_modules/@a2simcode/dui/docs-dui/components/meta/drag.ts` (API) & `node_modules/@a2simcode/dui/docs-dui/examples/drag/` (示例)
+
+## 行动指南
+
+当用户询问"怎么用 [组件名]"或"[组件名] 有哪些属性"时：
+
+1. **首选**：读取 `node_modules/@a2simcode/ui/docs/components/meta/[组件名].ts` 或 `node_modules/@a2simcode/dui/docs-dui/components/meta/[组件名].ts` 获取 API 参数（如果不存在，尝试项目源码路径）。
+2. **次选**：读取 `node_modules/@a2simcode/ui/docs/components/[组件名].md` 获取描述（如果不存在，尝试项目源码路径）。
+3. **必选**：读取 `node_modules/@a2simcode/ui/docs/examples/[组件名]/basic.vue` 获取基础示例（如果不存在，尝试项目源码路径）。
+4. **回答**：综合以上信息，清晰展示组件用法和参数表。

package/LICENSE

@@ -1,53 +1,53 @@
-专有软件许可协议
-
-版权所有 © 2024 苏州极简搭信息技术有限公司。保留所有权利。
-
-本软件及其相关文档("软件")为专有软件,受版权法和国际条约保护。
-
-许可限制:
-
-1. 本软件仅授权给获得明确书面许可的用户使用。
-
-2. 未经版权所有者事先书面同意,您不得:
-   - 复制、修改、改编或翻译本软件
-   - 对本软件进行反向工程、反编译或反汇编
-   - 出租、出借、分发、转让或再许可本软件
-   - 删除或修改本软件中的任何版权声明或其他所有权标记
-
-3. 本软件按"现状"提供,不提供任何明示或暗示的保证,包括但不限于适销性、特定用途适用性和非侵权性的保证。
-
-4. 在任何情况下,版权所有者均不对因使用或无法使用本软件而产生的任何索赔、损害或其他责任负责。
-
-5. 本许可协议受中华人民共和国法律管辖。
-
-如需获得使用许可,请联系版权所有者。
-
----
-
-PROPRIETARY SOFTWARE LICENSE
-
-Copyright © 2024 Suzhou Jijian-da Information Technology Co., Ltd. All rights reserved.
-
-This software and associated documentation files (the "Software") is proprietary 
-software protected by copyright laws and international treaties.
-
-License Restrictions:
-
-1. This Software is licensed only to users who have obtained explicit written permission.
-
-2. Without prior written consent from the copyright holder, you may not:
-   - Copy, modify, adapt, or translate the Software
-   - Reverse engineer, decompile, or disassemble the Software
-   - Rent, lease, distribute, transfer, or sublicense the Software
-   - Remove or modify any copyright notices or other proprietary markings in the Software
-
-3. The Software is provided "as is" without warranty of any kind, express or implied, 
-   including but not limited to warranties of merchantability, fitness for a particular 
-   purpose, and non-infringement.
-
-4. In no event shall the copyright holder be liable for any claims, damages, or other 
-   liability arising from the use or inability to use the Software.
-
-5. This license agreement is governed by the laws of the People's Republic of China.
-
-For licensing inquiries, please contact the copyright holder.
+专有软件许可协议
+
+版权所有 © 2024 苏州极简搭信息技术有限公司。保留所有权利。
+
+本软件及其相关文档("软件")为专有软件,受版权法和国际条约保护。
+
+许可限制:
+
+1. 本软件仅授权给获得明确书面许可的用户使用。
+
+2. 未经版权所有者事先书面同意,您不得:
+   - 复制、修改、改编或翻译本软件
+   - 对本软件进行反向工程、反编译或反汇编
+   - 出租、出借、分发、转让或再许可本软件
+   - 删除或修改本软件中的任何版权声明或其他所有权标记
+
+3. 本软件按"现状"提供,不提供任何明示或暗示的保证,包括但不限于适销性、特定用途适用性和非侵权性的保证。
+
+4. 在任何情况下,版权所有者均不对因使用或无法使用本软件而产生的任何索赔、损害或其他责任负责。
+
+5. 本许可协议受中华人民共和国法律管辖。
+
+如需获得使用许可,请联系版权所有者。
+
+---
+
+PROPRIETARY SOFTWARE LICENSE
+
+Copyright © 2024 Suzhou Jijian-da Information Technology Co., Ltd. All rights reserved.
+
+This software and associated documentation files (the "Software") is proprietary 
+software protected by copyright laws and international treaties.
+
+License Restrictions:
+
+1. This Software is licensed only to users who have obtained explicit written permission.
+
+2. Without prior written consent from the copyright holder, you may not:
+   - Copy, modify, adapt, or translate the Software
+   - Reverse engineer, decompile, or disassemble the Software
+   - Rent, lease, distribute, transfer, or sublicense the Software
+   - Remove or modify any copyright notices or other proprietary markings in the Software
+
+3. The Software is provided "as is" without warranty of any kind, express or implied, 
+   including but not limited to warranties of merchantability, fitness for a particular 
+   purpose, and non-infringement.
+
+4. In no event shall the copyright holder be liable for any claims, damages, or other 
+   liability arising from the use or inability to use the Software.
+
+5. This license agreement is governed by the laws of the People's Republic of China.
+
+For licensing inquiries, please contact the copyright holder.