@a2simcode/ui 0.0.46 → 0.0.48

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

@@ -0,0 +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` 包

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

@@ -0,0 +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. **回答**：综合以上信息，清晰展示组件用法和参数表。

package/dist/components/index.d.ts

@@ -87,6 +87,7 @@ export type { FormSchemaConfig, RuleType } from './form/src/interface';
 export type { PageSchemaConfig } from './page/src/interface';
 export type { ColumnSchemaConfig } from './table/src/interface';
 export { useLayer } from './dynamic-layer';
+export * from './inject-provide';
 declare const _default: {
     install: (app: App) => void;
 };