@yh-ui/components 0.1.16 → 0.1.21

package/README.md

@@ -4,25 +4,212 @@
   <img src="https://raw.githubusercontent.com/1079161148/yh-ui/main/docs/public/logo.svg" width="120" height="120" alt="YH-UI Logo">
 </p>
 
-YH-UI 核心组件库，基于 Vue 3.5+ 构建的高性能、可扩展的企业级 UI 解决方案。
+<h3 align="center">YH-UI 核心组件库</h3>
+
+<p align="center">
+  基于 Vue 3.5+ 的企业级 UI 组件集合 · 77+ 组件（含 16 个 AI 组件）· 完整 TypeScript · 原生 Tree-shaking
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@yh-ui/components">
+    <img src="https://img.shields.io/npm/v/@yh-ui/components.svg?style=flat-square&colorB=409eff" alt="npm version">
+  </a>
+  <a href="https://www.npmjs.com/package/@yh-ui/components">
+    <img src="https://img.shields.io/npm/dm/@yh-ui/components.svg?style=flat-square&colorB=409eff" alt="npm downloads">
+  </a>
+  <a href="https://github.com/1079161148/yh-ui/blob/main/LICENSE">
+    <img src="https://img.shields.io/npm/l/@yh-ui/components.svg?style=flat-square" alt="license">
+  </a>
+</p>
 
 ---
 
 ## ✨ 特性
 
-- **61+ 企业级组件**：覆盖绝大部分业务场景。
-- **Composition API**：深度使用 Vue 3 组合式 API，逻辑清晰且极致轻量。
-- **TypeScript**：全量类型定义，提供完美的开发提示。
-- **Tree-shaking**：原生 ES Modules 支持，按需构建。
+- 🧩 **77+ 企业级组件** — 覆盖基础 UI、数据展示、表单交互、反馈提示、布局、高级业务等全场景
+- 🤖 **16 个 AI 组件** — 业内首创完整 AI UI 套件（聊天气泡、发送器、思维链、文件卡片等）
+- 📊 **工业级 Table** — 虚拟滚动、列拖拽、多选、排序过滤、打印/导出 CSV/XLSX/PDF，媲美 vxe-table
+- 🔒 **完整 TypeScript** — 全量类型定义，精确的 props/emits/slots 类型推导
+- ⚡ **极致轻量** — 原生 ES Module，按需导入，完美 Tree-shaking
+- 🌐 **SSR 完全兼容** — Nuxt 3 生产级验证，所有组件 SSR/Hydration 安全
+- 🎨 **主题响应** — 自动响应 `@yh-ui/theme` 的主题变量，支持运行时切换
+- ♿ **无障碍访问** — 关键组件通过 WCAG 2.1 AA 验证
+
+---
 
 ## 📦 安装
 
 ```bash
-# pnpm
+# 推荐：安装主包（含样式）
+pnpm add @yh-ui/yh-ui
+
+# 或单独安装组件包（需自行引入依赖）
 pnpm add @yh-ui/components
 ```
 
+---
+
+## 🔨 使用方式
+
+### 方式一：全量引入（推荐新手）
+
+```ts
+import { createApp } from 'vue'
+import YhUI from '@yh-ui/yh-ui'
+import '@yh-ui/yh-ui/css'
+import App from './App.vue'
+
+const app = createApp(App)
+app.use(YhUI)
+app.mount('#app')
+```
+
+### 方式二：按需导入（推荐生产）
+
+```vue
+<script setup lang="ts">
+import { YhButton, YhInput, YhTable, YhForm, YhFormItem } from '@yh-ui/components'
+</script>
+
+<template>
+  <YhButton type="primary" size="large" :loading="submitting" @click="submit"> 提交 </YhButton>
+</template>
+```
+
+### 方式三：自动导入（零配置，极致 DX）
+
+```ts
+// vite.config.ts
+import { defineConfig } from 'vite'
+import Components from 'unplugin-vue-components/vite'
+import { YhUIResolver } from '@yh-ui/components/resolver'
+
+export default defineConfig({
+  plugins: [
+    Components({
+      resolvers: [YhUIResolver()]
+    })
+  ]
+})
+```
+
+---
+
+## 📚 组件目录
+
+### 🏗 基础组件
+
+| 组件               | 说明                             |
+| ------------------ | -------------------------------- |
+| `YhButton`         | 按钮（支持 loading、图标、组等） |
+| `YhIcon`           | 图标（整合 Iconify，20w+ 图标）  |
+| `YhLink`           | 链接                             |
+| `YhScrollbar`      | 自定义美化滚动条                 |
+| `YhConfigProvider` | 全局配置提供者                   |
+
+### 📝 表单组件
+
+| 组件                                         | 说明                               |
+| -------------------------------------------- | ---------------------------------- |
+| `YhForm` / `YhFormItem`                      | 表单容器（支持 async-validator）   |
+| `YhFormSchema`                               | JSON Schema 动态表单生成器         |
+| `YhInput`                                    | 输入框（支持插槽、字数统计、密码） |
+| `YhInputNumber`                              | 数字输入框                         |
+| `YhInputTag`                                 | 标签输入框                         |
+| `YhSelect` / `YhOption`                      | 下拉选择（支持虚拟滚动）           |
+| `YhCascader`                                 | 级联选择                           |
+| `YhCheckbox` / `YhCheckboxGroup`             | 复选框                             |
+| `YhRadio` / `YhRadioGroup` / `YhRadioButton` | 单选框                             |
+| `YhSwitch`                                   | 开关                               |
+| `YhSlider`                                   | 滑块                               |
+| `YhRate`                                     | 评分                               |
+| `YhDatePicker`                               | 日期选择器                         |
+| `YhTimePicker`                               | 时间选择器                         |
+| `YhColorPicker`                              | 颜色选择器                         |
+| `YhUpload`                                   | 文件上传                           |
+| `YhTransfer`                                 | 穿梭框                             |
+| `YhTreeSelect`                               | 树形选择器                         |
+
+### 📊 数据展示
+
+| 组件             | 说明                                 |
+| ---------------- | ------------------------------------ |
+| `YhTable`        | 工业级表格（虚拟滚动 / 拖拽 / 导出） |
+| `YhTree`         | 树形控件（虚拟滚动、拖拽排序）       |
+| `YhList`         | 列表                                 |
+| `YhCard`         | 卡片                                 |
+| `YhBadge`        | 徽标                                 |
+| `YhTag`          | 标签                                 |
+| `YhAvatar`       | 头像                                 |
+| `YhImage`        | 图片（懒加载、预览）                 |
+| `YhCalendar`     | 日历                                 |
+| `YhStatistic`    | 数据统计展示                         |
+| `YhTimeline`     | 时间轴                               |
+| `YhDescriptions` | 描述列表                             |
+| `YhChart`        | 图表（封装 ECharts）                 |
+| `YhGantt`        | 甘特图（工业级项目管理）             |
+
+### 💬 反馈组件
+
+| 组件             | 说明       |
+| ---------------- | ---------- |
+| `YhMessage`      | 全局提示   |
+| `YhNotification` | 通知消息   |
+| `YhAlert`        | 警告提示   |
+| `YhDialog`       | 对话框     |
+| `YhDrawer`       | 抽屉       |
+| `YhPopover`      | 气泡卡片   |
+| `YhTooltip`      | 文字提示   |
+| `YhPopconfirm`   | 气泡确认框 |
+| `YhLoading`      | 加载中     |
+| `YhProgress`     | 进度条     |
+| `YhSkeleton`     | 骨架屏     |
+
+### 📐 布局组件
+
+| 组件                                           | 说明       |
+| ---------------------------------------------- | ---------- |
+| `YhRow` / `YhCol`                              | 栅格布局   |
+| `YhDivider`                                    | 分割线     |
+| `YhSpace`                                      | 间距       |
+| `YhContainer`                                  | 布局容器   |
+| `YhAside` / `YhHeader` / `YhMain` / `YhFooter` | 布局子组件 |
+
+### 🧭 导航组件
+
+| 组件           | 说明     |
+| -------------- | -------- |
+| `YhMenu`       | 导航菜单 |
+| `YhTabs`       | 标签页   |
+| `YhBreadcrumb` | 面包屑   |
+| `YhPagination` | 分页     |
+| `YhSteps`      | 步骤条   |
+| `YhDropdown`   | 下拉菜单 |
+
+### 🤖 AI 组件（独家特性）
+
+| 组件               | 说明                                    |
+| ------------------ | --------------------------------------- |
+| `YhAiBubble`       | AI 对话气泡（Markdown 渲染 + 流式打字） |
+| `YhAiSender`       | 智能输入发送器（支持附件、快捷指令）    |
+| `YhAiWelcome`      | AI 欢迎界面                             |
+| `YhAiThoughtChain` | 思维链展示                              |
+| `YhAiSuggestion`   | 智能推荐提示                            |
+| `YhAiFileCard`     | 文件消息卡片                            |
+| `YhAiImageCard`    | 图片消息卡片                            |
+| `YhAiProvider`     | AI 上下文提供者                         |
+| `YhAiChatWindow`   | 完整聊天窗口（开箱即用）                |
+| ...                | 共 16 个 AI 组件                        |
+
+---
+
 ## 🔗 相关资源
 
 - [📖 官方文档](https://1079161148.github.io/yh-ui/)
+- [🚀 快速开始](https://1079161148.github.io/yh-ui/guide/quickstart)
 - [📦 GitHub 仓库](https://github.com/1079161148/yh-ui)
+- [📝 更新日志](https://github.com/1079161148/yh-ui/blob/main/CHANGELOG.md)
+
+## 📄 开源协议
+
+MIT License © 2024-present YH-UI Team

package/dist/affix/index.d.ts

@@ -1,5 +1,206 @@
 import Affix from './src/affix.vue';
-export declare const YhAffix: any;
+export declare const YhAffix: import("@yh-ui/utils").SFCWithInstall<{
+    new (...args: any[]): import("vue").CreateComponentPublicInstanceWithMixins<Readonly<import("vue").ExtractPropTypes<{
+        readonly offset: {
+            readonly type: NumberConstructor;
+            readonly default: 0;
+        };
+        readonly position: {
+            readonly type: import("vue").PropType<import("./index.js").AffixPosition>;
+            readonly default: "top";
+        };
+        readonly target: {
+            readonly type: StringConstructor;
+            readonly default: "";
+        };
+        readonly zIndex: {
+            readonly type: NumberConstructor;
+            readonly default: 100;
+        };
+        readonly teleported: {
+            readonly type: BooleanConstructor;
+            readonly default: false;
+        };
+        readonly appendTo: {
+            readonly type: import("vue").PropType<string | HTMLElement>;
+            readonly default: "body";
+        };
+        readonly affixStyle: {
+            readonly type: import("vue").PropType<import("vue").CSSProperties>;
+            readonly default: () => {};
+        };
+        readonly disabled: {
+            readonly type: BooleanConstructor;
+            readonly default: false;
+        };
+        readonly themeOverrides: {
+            readonly type: import("vue").PropType<import("@yh-ui/theme").ComponentThemeVars>;
+            readonly default: undefined;
+        };
+    }>> & Readonly<{
+        onScroll?: ((payload: {
+            scrollTop: number;
+            fixed: boolean;
+        }) => any) | undefined;
+        onChange?: ((fixed: boolean) => any) | undefined;
+    }>, {
+        update: () => void;
+        fixed: import("vue").Ref<boolean, boolean>;
+        scrollTop: import("vue").Ref<number, number>;
+    }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+        scroll: (payload: {
+            scrollTop: number;
+            fixed: boolean;
+        }) => void;
+        change: (fixed: boolean) => void;
+    }, import("vue").PublicProps, {
+        readonly disabled: boolean;
+        readonly themeOverrides: import("@yh-ui/theme").ComponentThemeVars;
+        readonly position: import("./index.js").AffixPosition;
+        readonly zIndex: number;
+        readonly offset: number;
+        readonly target: string;
+        readonly teleported: boolean;
+        readonly appendTo: string | HTMLElement;
+        readonly affixStyle: import("vue").CSSProperties;
+    }, true, {}, {}, import("vue").GlobalComponents, import("vue").GlobalDirectives, string, {}, any, import("vue").ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<import("vue").ExtractPropTypes<{
+        readonly offset: {
+            readonly type: NumberConstructor;
+            readonly default: 0;
+        };
+        readonly position: {
+            readonly type: import("vue").PropType<import("./index.js").AffixPosition>;
+            readonly default: "top";
+        };
+        readonly target: {
+            readonly type: StringConstructor;
+            readonly default: "";
+        };
+        readonly zIndex: {
+            readonly type: NumberConstructor;
+            readonly default: 100;
+        };
+        readonly teleported: {
+            readonly type: BooleanConstructor;
+            readonly default: false;
+        };
+        readonly appendTo: {
+            readonly type: import("vue").PropType<string | HTMLElement>;
+            readonly default: "body";
+        };
+        readonly affixStyle: {
+            readonly type: import("vue").PropType<import("vue").CSSProperties>;
+            readonly default: () => {};
+        };
+        readonly disabled: {
+            readonly type: BooleanConstructor;
+            readonly default: false;
+        };
+        readonly themeOverrides: {
+            readonly type: import("vue").PropType<import("@yh-ui/theme").ComponentThemeVars>;
+            readonly default: undefined;
+        };
+    }>> & Readonly<{
+        onScroll?: ((payload: {
+            scrollTop: number;
+            fixed: boolean;
+        }) => any) | undefined;
+        onChange?: ((fixed: boolean) => any) | undefined;
+    }>, {
+        update: () => void;
+        fixed: import("vue").Ref<boolean, boolean>;
+        scrollTop: import("vue").Ref<number, number>;
+    }, {}, {}, {}, {
+        readonly disabled: boolean;
+        readonly themeOverrides: import("@yh-ui/theme").ComponentThemeVars;
+        readonly position: import("./index.js").AffixPosition;
+        readonly zIndex: number;
+        readonly offset: number;
+        readonly target: string;
+        readonly teleported: boolean;
+        readonly appendTo: string | HTMLElement;
+        readonly affixStyle: import("vue").CSSProperties;
+    }>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & import("vue").ComponentOptionsBase<Readonly<import("vue").ExtractPropTypes<{
+    readonly offset: {
+        readonly type: NumberConstructor;
+        readonly default: 0;
+    };
+    readonly position: {
+        readonly type: import("vue").PropType<import("./index.js").AffixPosition>;
+        readonly default: "top";
+    };
+    readonly target: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    readonly zIndex: {
+        readonly type: NumberConstructor;
+        readonly default: 100;
+    };
+    readonly teleported: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    readonly appendTo: {
+        readonly type: import("vue").PropType<string | HTMLElement>;
+        readonly default: "body";
+    };
+    readonly affixStyle: {
+        readonly type: import("vue").PropType<import("vue").CSSProperties>;
+        readonly default: () => {};
+    };
+    readonly disabled: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    readonly themeOverrides: {
+        readonly type: import("vue").PropType<import("@yh-ui/theme").ComponentThemeVars>;
+        readonly default: undefined;
+    };
+}>> & Readonly<{
+    onScroll?: ((payload: {
+        scrollTop: number;
+        fixed: boolean;
+    }) => any) | undefined;
+    onChange?: ((fixed: boolean) => any) | undefined;
+}>, {
+    update: () => void;
+    fixed: import("vue").Ref<boolean, boolean>;
+    scrollTop: import("vue").Ref<number, number>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    scroll: (payload: {
+        scrollTop: number;
+        fixed: boolean;
+    }) => void;
+    change: (fixed: boolean) => void;
+}, string, {
+    readonly disabled: boolean;
+    readonly themeOverrides: import("@yh-ui/theme").ComponentThemeVars;
+    readonly position: import("./index.js").AffixPosition;
+    readonly zIndex: number;
+    readonly offset: number;
+    readonly target: string;
+    readonly teleported: boolean;
+    readonly appendTo: string | HTMLElement;
+    readonly affixStyle: import("vue").CSSProperties;
+}, {}, string, {}, import("vue").GlobalComponents, import("vue").GlobalDirectives, string, import("vue").ComponentProvideOptions> & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps & (new () => {
+    $slots: {
+        default?: (props: {
+            fixed: boolean;
+        }) => any;
+    };
+})> & Record<string, unknown>;
 export default YhAffix;
 export * from './src/affix';
 export type AffixInstance = InstanceType<typeof Affix>;

package/dist/affix/src/affix.vue.d.ts

@@ -1,6 +1,6 @@
 import type { CSSProperties } from 'vue';
 declare var __VLS_5: {
-    fixed: any;
+    fixed: boolean;
 };
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_5) => any;
@@ -46,16 +46,65 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
     update: () => void;
     fixed: import("vue").Ref<boolean, boolean>;
     scrollTop: import("vue").Ref<number, number>;
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, any, string, import("vue").PublicProps, any, {
-    readonly offset: number;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    scroll: (payload: {
+        scrollTop: number;
+        fixed: boolean;
+    }) => void;
+    change: (fixed: boolean) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    readonly offset: {
+        readonly type: NumberConstructor;
+        readonly default: 0;
+    };
+    readonly position: {
+        readonly type: import("vue").PropType<import("./affix").AffixPosition>;
+        readonly default: "top";
+    };
+    readonly target: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    readonly zIndex: {
+        readonly type: NumberConstructor;
+        readonly default: 100;
+    };
+    readonly teleported: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    readonly appendTo: {
+        readonly type: import("vue").PropType<string | HTMLElement>;
+        readonly default: "body";
+    };
+    readonly affixStyle: {
+        readonly type: import("vue").PropType<CSSProperties>;
+        readonly default: () => {};
+    };
+    readonly disabled: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    readonly themeOverrides: {
+        readonly type: import("vue").PropType<import("@yh-ui/theme").ComponentThemeVars>;
+        readonly default: undefined;
+    };
+}>> & Readonly<{
+    onScroll?: ((payload: {
+        scrollTop: number;
+        fixed: boolean;
+    }) => any) | undefined;
+    onChange?: ((fixed: boolean) => any) | undefined;
+}>, {
+    readonly disabled: boolean;
+    readonly themeOverrides: import("@yh-ui/theme").ComponentThemeVars;
     readonly position: import("./affix").AffixPosition;
-    readonly target: string;
     readonly zIndex: number;
+    readonly offset: number;
+    readonly target: string;
     readonly teleported: boolean;
     readonly appendTo: string | HTMLElement;
     readonly affixStyle: CSSProperties;
-    readonly disabled: boolean;
-    readonly themeOverrides: import("@yh-ui/theme").ComponentThemeVars;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/ai-action-group/__tests__/ai-action-group.test.cjs

@@ -3,6 +3,7 @@
 var _vitest = require("vitest");
 var _testUtils = require("@vue/test-utils");
 var _aiActionGroup = _interopRequireDefault(require("../src/ai-action-group.vue"));
+var _icon = require("../../icon/index.cjs");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 (0, _vitest.describe)("YhAiActionGroup", () => {
   (0, _vitest.it)("should render with base class", () => {
@@ -146,4 +147,89 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
     });
     (0, _vitest.expect)(wrapper.find(".extra-btn").exists()).toBe(true);
   });
+  (0, _vitest.it)("should handle unknown string item", () => {
+    const wrapper = (0, _testUtils.mount)(_aiActionGroup.default, {
+      props: {
+        items: ["unknown-action"]
+      }
+    });
+    (0, _vitest.expect)(wrapper.findComponent(_icon.YhIcon).props("name")).toBe("more");
+  });
+  (0, _vitest.it)("should handle object item without icon", () => {
+    const wrapper1 = (0, _testUtils.mount)(_aiActionGroup.default, {
+      props: {
+        items: [{
+          key: "copy"
+        }]
+      }
+    });
+    (0, _vitest.expect)(wrapper1.findComponent(_icon.YhIcon).props("name")).toBe("copy");
+    const wrapper2 = (0, _testUtils.mount)(_aiActionGroup.default, {
+      props: {
+        items: [{
+          key: "random"
+        }]
+      }
+    });
+    (0, _vitest.expect)(wrapper2.findComponent(_icon.YhIcon).props("name")).toBe("more");
+  });
+  (0, _vitest.it)("should render object item with label but no tooltip", () => {
+    const wrapper = (0, _testUtils.mount)(_aiActionGroup.default, {
+      props: {
+        items: [{
+          key: "edit",
+          label: "Edit",
+          tooltip: ""
+        }]
+      }
+    });
+    (0, _vitest.expect)(wrapper.find(".yh-ai-action-group__item-label").text()).toBe("Edit");
+    (0, _vitest.expect)(wrapper.findComponent({
+      name: "YhTooltip"
+    }).exists()).toBe(false);
+  });
+  (0, _vitest.it)("should render object item with label and tooltip", () => {
+    const wrapper = (0, _testUtils.mount)(_aiActionGroup.default, {
+      props: {
+        items: [{
+          key: "edit",
+          label: "Edit",
+          tooltip: "Edit Tip"
+        }]
+      }
+    });
+    (0, _vitest.expect)(wrapper.find(".yh-ai-action-group__item-label").text()).toBe("Edit");
+  });
+  (0, _vitest.it)("should render object item without label and without tooltip", () => {
+    const wrapper = (0, _testUtils.mount)(_aiActionGroup.default, {
+      props: {
+        items: [{
+          key: "edit",
+          tooltip: ""
+        }]
+      }
+    });
+    (0, _vitest.expect)(wrapper.find(".yh-ai-action-group__item-label").exists()).toBe(false);
+  });
+  (0, _vitest.it)("should handle click with string item", async () => {
+    const wrapper = (0, _testUtils.mount)(_aiActionGroup.default, {
+      props: {
+        items: ["refresh"]
+      }
+    });
+    await wrapper.find(".yh-ai-action-group__item").trigger("click");
+    (0, _vitest.expect)(wrapper.emitted("click")[0][0]).toBe("refresh");
+  });
+  (0, _vitest.it)("covers aiActionGroupEmits validators", async () => {
+    const {
+      aiActionGroupEmits
+    } = await Promise.resolve().then(() => require("../src/ai-action-group.cjs"));
+    (0, _vitest.expect)(aiActionGroupEmits.click("test", "test")).toBe(true);
+  });
+  (0, _vitest.it)("handleClick covers string input branch", () => {
+    const wrapper = (0, _testUtils.mount)(_aiActionGroup.default);
+    const vm = wrapper.vm;
+    vm.handleClick("direct-string");
+    (0, _vitest.expect)(wrapper.emitted("click")[0][0]).toBe("direct-string");
+  });
 });

package/dist/ai-action-group/__tests__/ai-action-group.test.mjs

@@ -1,6 +1,7 @@
 import { describe, it, expect } from "vitest";
 import { mount } from "@vue/test-utils";
 import AiActionGroup from "../src/ai-action-group.vue";
+import { YhIcon } from "../../icon/index.mjs";
 describe("YhAiActionGroup", () => {
   it("should render with base class", () => {
     const wrapper = mount(AiActionGroup, { props: { items: [] } });
@@ -101,4 +102,56 @@ describe("YhAiActionGroup", () => {
     });
     expect(wrapper.find(".extra-btn").exists()).toBe(true);
   });
+  it("should handle unknown string item", () => {
+    const wrapper = mount(AiActionGroup, {
+      props: { items: ["unknown-action"] }
+    });
+    expect(wrapper.findComponent(YhIcon).props("name")).toBe("more");
+  });
+  it("should handle object item without icon", () => {
+    const wrapper1 = mount(AiActionGroup, {
+      props: { items: [{ key: "copy" }] }
+    });
+    expect(wrapper1.findComponent(YhIcon).props("name")).toBe("copy");
+    const wrapper2 = mount(AiActionGroup, {
+      props: { items: [{ key: "random" }] }
+    });
+    expect(wrapper2.findComponent(YhIcon).props("name")).toBe("more");
+  });
+  it("should render object item with label but no tooltip", () => {
+    const wrapper = mount(AiActionGroup, {
+      props: { items: [{ key: "edit", label: "Edit", tooltip: "" }] }
+    });
+    expect(wrapper.find(".yh-ai-action-group__item-label").text()).toBe("Edit");
+    expect(wrapper.findComponent({ name: "YhTooltip" }).exists()).toBe(false);
+  });
+  it("should render object item with label and tooltip", () => {
+    const wrapper = mount(AiActionGroup, {
+      props: { items: [{ key: "edit", label: "Edit", tooltip: "Edit Tip" }] }
+    });
+    expect(wrapper.find(".yh-ai-action-group__item-label").text()).toBe("Edit");
+  });
+  it("should render object item without label and without tooltip", () => {
+    const wrapper = mount(AiActionGroup, {
+      props: { items: [{ key: "edit", tooltip: "" }] }
+    });
+    expect(wrapper.find(".yh-ai-action-group__item-label").exists()).toBe(false);
+  });
+  it("should handle click with string item", async () => {
+    const wrapper = mount(AiActionGroup, {
+      props: { items: ["refresh"] }
+    });
+    await wrapper.find(".yh-ai-action-group__item").trigger("click");
+    expect(wrapper.emitted("click")[0][0]).toBe("refresh");
+  });
+  it("covers aiActionGroupEmits validators", async () => {
+    const { aiActionGroupEmits } = await import("../src/ai-action-group.mjs");
+    expect(aiActionGroupEmits.click("test", "test")).toBe(true);
+  });
+  it("handleClick covers string input branch", () => {
+    const wrapper = mount(AiActionGroup);
+    const vm = wrapper.vm;
+    vm.handleClick("direct-string");
+    expect(wrapper.emitted("click")[0][0]).toBe("direct-string");
+  });
 });