x-next 1.12.0 → 1.14.0

package/AI_USAGE/components/bar-chart.md

@@ -1,12 +1,14 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # BarChart AI 使用
 
-适用版本：x-next@1.12.0；来源指纹：`9f9adf42b42dc1e551f500aabdcb7fb07b69a93ea44ff3dc1d16dab1a4c85843`。
+适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
 
-先读 [通用接入](../core.md)。公开导出：`BarChart`；模型：无；已核对事件：barClick、legendChange。
+先读 [通用接入](../core.md)。公开导出：`BarChart`；主要模型：无。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./bar-chart-api.md)，包含本组件族全部子组件和别名。
 
 按需样式：`x-next/style/bar-chart`（包含 base.css、bar-chart.css、spin.css）。代码块未单独引样式时在应用入口加载全量样式，或按实际所有组件加载 JS 入口；不要仅因复制一个组件页就漏掉其中的 Button 等组合依赖。
 
+## 已核验行为与示例
+
 [组件文档与 live demo](https://x-next.yjmf.com/components/bar-chart)。按天 / 小时聚合的柱状趋势图：`categories` 是类目轴标签，`series` 是数据系列（`{ name, data, color }`），两者按下标对应。单系列就是普通柱状图；多系列默认并排，加 `stack` 变成堆叠。默认提示在当前类目有效条目多于一项时显示合计，与 stack 无直接关联；多系列时零值条目会过滤，隐藏系列不参与提示。轻量迷你走势用 TrendChart，需要坐标轴与读数用本组件。
 
 数值轴自动取 1/2/5 步长的整洁刻度（所以刻度行数可能少于 `grid.horizontalLinesNumber`）；传 `max` 可锁定上界。`loading` 显示加载遮罩；数据全为 0 时显示空态，可用 `empty` 插槽替换。`null` / 负数按 0 处理且不画柱体。
@@ -45,4 +47,296 @@ function onBarClick(data: { label: string; total: number; value: number | null }
 </template>
 ```
 
-返回 [AI 索引](../index.md)。精选示例不是完整 API 表，新能力先查同版本公开类型与组件文档。
+## 场景用法
+
+以下示例从本地 `src/docs/components/bar-chart.md` 显式导入到独立 AI 源，补齐局部注册、状态和样式后进行严格模板检查。上方已核验行为优先；原始 prop 默认值、包装透传和示例业务适配分别查 [完整 API](./bar-chart-api.md) 与场景说明。类型通过不代表所有散文和交互已验证。
+
+### 用途与选型
+
+用于展示按天（或任意时间粒度）聚合的指标趋势，支持单系列柱状、多系列并排与堆叠，内置悬浮提示、图例联动和键盘导航。
+
+
+### 何时使用
+
+- 需要在时间轴上比较各周期的高低，且起点为零（计数、访问量、消费金额这类可加量）。
+- 数据按天 / 小时聚合，关注的是分布形态与峰值位置，而不是精确到小数点的读数。
+- 单系列看趋势，多系列看结构（并排比较或堆叠看总量与构成）。
+
+
+### 与其它图表的分工
+
+| 场景 | 选择 |
+| --- | --- |
+| 随时间看变化趋势 | [LineChart 折线图](./line-chart.md) |
+| 看占比构成 | [PieChart 饼图](./pie-chart.md) |
+| 卡片角落的一行迷你走势，不需要坐标轴和读数 | [TrendChart 迷你趋势图](./trend-chart.md) |
+| 需要坐标轴刻度、悬浮读数、多系列对比或堆叠 | BarChart（本页） |
+
+完整的选择指引见[图表总览](./charts.md)。
+
+
+### 基础用法
+
+`categories` 与每个系列 `data` 按下标一一对应，数值上限由组件自动取整到 5、10、15 这类整洁刻度。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { BarChart } from 'x-next';
+import { ref } from 'vue';
+
+const categories = ref(['09-28', '09-29', '09-30', '10-01', '10-02']);
+const views = ref([86, 142, 98, 210, 176]);
+</script>
+<template>
+<BarChart
+    :categories="categories"
+    :series="[{ name: '浏览量', data: views }]"
+    ariaLabel="近 30 天每日浏览量"
+  />
+</template>
+```
+
+### 完整日期与窄容器
+
+调整预览宽度或切换长类目名称。标签会按可用空间抽稀，优先保留末位，并在边缘收边；单个超长标签会省略，悬停省略文字可读完整内容。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { ref } from 'vue';
+import { BarChart } from 'x-next';
+
+const width = ref(320);
+const categories = Array.from({ length: 30 }, (_, index) =>
+  new Date(Date.UTC(2026, 8, 6 + index)).toISOString().slice(0, 10),
+);
+const series = [{ name: '浏览量', data: Array.from({ length: 30 }, (_, index) => 8 + index % 19) }];
+</script>
+<template>
+<label>宽度 <input v-model.number="width" type="range" min="240" max="966" /></label>
+  <div :style="{ width: `${width}px`, maxWidth: '100%' }">
+    <BarChart :categories="categories" :series="series" />
+  </div>
+</template>
+```
+
+### 多系列与堆叠
+
+多系列默认并排比较；打开 `stack` 后自下而上堆叠，提示中会给出各类目合计，适合看「总量 + 构成」。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { BarChart } from 'x-next';
+const formatMoney = (value: number) => `¥${value.toFixed(2)}`;
+
+import { ref } from 'vue';
+
+const categories = ref(['09-28', '09-29', '09-30']);
+const series = ref([
+  { name: '李守东', data: [43.38, 12.4, 30.05] },
+  { name: '唐忠阳', data: [18.29, 26.1, 8.6] },
+  { name: '许宇', data: [58.59, 31.2, 24.4] },
+]);
+</script>
+<template>
+<BarChart
+    :categories="categories"
+    :series="series"
+    stack
+    :value-formatter="formatMoney"
+    ariaLabel="近 30 天各用户消费金额"
+  />
+</template>
+```
+
+### 图例联动
+
+开启 `legend` 后点击图例项可临时隐藏某个系列，数值轴会按剩余可见系列重新计算。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { BarChart } from 'x-next';
+import { ref } from 'vue';
+
+const categories = ref(['09-28', '09-29', '09-30']);
+const series = ref([
+  { name: '李守东', data: [43.38, 12.4, 30.05] },
+  { name: '唐忠阳', data: [18.29, 26.1, 8.6] },
+]);
+const visibleIndexes = ref([0, 1]);
+const onLegendChange = (indexes: number[]) => {
+  visibleIndexes.value = indexes;
+};
+</script>
+<template>
+<BarChart
+    :categories="categories"
+    :series="series"
+    legend
+    @legend-change="onLegendChange"
+  />
+  <p>当前可见系列：{{ visibleIndexes.length }}</p>
+</template>
+```
+
+### 坐标轴与网格
+
+`labels` 控制轴标签的显示与格式化，`grid` 控制横向网格线，`max` 可以锁定数值轴上界。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { BarChart } from 'x-next';
+import { ref } from 'vue';
+
+const categories = ref(Array.from({ length: 24 }, (_, i) => `${String(i).padStart(2, '0')}:00`));
+const requests = ref([12, 8, 6, 5, 4, 7, 18, 42, 76, 120, 143, 138, 126, 151, 164, 149, 132, 118, 96, 74, 52, 38, 26, 17]);
+</script>
+<template>
+<BarChart
+    :categories="categories"
+    :series="[{ name: '请求次数', data: requests }]"
+    :max="200"
+    :grid="{ horizontalLinesNumber: 5 }"
+    :labels="{
+      xFormatter: (label: string) => label.replace(':00', ''),
+      yFormatter: (value: number) => `${value}`,
+    }"
+  />
+</template>
+```
+
+### 自定义提示与点击事件
+
+`tooltip` 插槽可完全接管浮层内容；点击柱体触发 `bar-click`，未命中柱体（如零值类目）时 `seriesIndex` 与 `value` 为 `null`。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { BarChart } from 'x-next';
+import { ref } from 'vue';
+
+const categories = ref(['09-28', '09-29', '09-30']);
+const series = ref([
+  { name: '李守东', data: [43.38, 12.4, 30.05] },
+  { name: '唐忠阳', data: [18.29, 26.1, 8.6] },
+]);
+const clickLog = ref('尚未点击柱体');
+const onBarClick = (data: { label: string; total: number; value: number | null }) => {
+  clickLog.value = `${data.label}：合计 ${data.total}`;
+};
+</script>
+<template>
+<BarChart
+    :categories="categories"
+    :series="series"
+    stack
+    @bar-click="onBarClick"
+  >
+    <template #tooltip="{ label, total, items, formatValue }">
+      <div style="font-weight: 500">{{ label }}</div>
+      <div v-for="item in items" :key="item.seriesIndex">
+        <span>{{ item.name }}</span>
+        <span>{{ formatValue(item.value) }}</span>
+      </div>
+      <div>合计 {{ formatValue(total) }}</div>
+    </template>
+  </BarChart>
+  <p>{{ clickLog }}</p>
+</template>
+```
+
+### 数据粒度切换
+
+粒度和主题切换这类外部状态改变时重新传入 `categories` / `series` 即可，组件会重新测量并按新宽度抽稀 x 轴标签。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { RadioGroup, Radio, BarChart } from 'x-next';
+import { computed, ref } from 'vue';
+
+const granularity = ref('day');
+const dayCategories = ['09-28', '09-29', '09-30'];
+const dayValues = [86, 142, 98];
+const hourCategories = ['00:00', '01:00', '02:00', '03:00'];
+const hourValues = [12, 8, 6, 5];
+
+const categories = computed(() => (granularity.value === 'day' ? dayCategories : hourCategories));
+const values = computed(() => (granularity.value === 'day' ? dayValues : hourValues));
+</script>
+<template>
+<RadioGroup v-model="granularity" type="button">
+    <Radio value="day">按天</Radio>
+    <Radio value="hour">按小时</Radio>
+  </RadioGroup>
+  <BarChart
+    :categories="categories"
+    :series="[{ name: '浏览量', data: values }]"
+  />
+</template>
+```
+
+### 自定义颜色与柱形
+
+`series[].color` 覆盖单系列的取色，`bar` 插槽可以完全自绘柱体（例如渐变色块）。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { BarChart } from 'x-next';
+import { ref } from 'vue';
+
+const categories = ref(['09-28', '09-29', '09-30', '10-01']);
+const values = ref([86, 142, 98, 210]);
+</script>
+<template>
+<BarChart
+    :categories="categories"
+    :series="[{ name: '浏览量', data: values, color: '#16a34a' }]"
+    :bar-radius="8"
+    :bar-width="18"
+  />
+</template>
+```
+
+### 加载与空数据
+
+`loading` 覆盖加载遮罩；全部为 0 或没有系列时显示空态，可用 `empty` 插槽替换。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { BarChart } from 'x-next';
+import { ref } from 'vue';
+
+const loading = ref(true);
+const categories = ref(['09-28', '09-29', '09-30']);
+const series = ref([{ name: '浏览量', data: [86, 142, 98] }]);
+</script>
+<template>
+<BarChart
+    :categories="categories"
+    :series="series"
+    :loading="loading"
+  >
+    <template #empty>暂无该时段数据</template>
+  </BarChart>
+</template>
+```
+
+### 交互说明
+
+- **数值轴刻度**：默认按 1 / 2 / 5 步长取整，刻度值始终是 `0.5`、`80`、`1,500,000` 这类可读值；因此实际刻度行数可能少于 `horizontalLinesNumber`。传 `max` 后按锁定值均分。
+- **缺测与零值**：`null`、`undefined` 与负数按 0 处理且不渲染柱体（避免出现贴底假柱），全部为 0 时显示空态。
+- **堆叠间隙**：堆叠分段之间保留 1px 间隙，基线不缩，柱体始终坐落在轴线上。
+- **x 轴标签**：按当前宽度和文字宽度自动抽稀，优先保留末位；收边后再次检查间距。空间不足时省略其他标签，单个超长标签以省略号显示并提供完整文字提示；连省略号也放不下时不绘制标签。
+- **键盘导航**：绘图区可聚焦，左右方向键移动读数、Home / End 跳到首尾、Esc 关闭提示；键盘导航时通过 `aria-live` 播报，鼠标悬浮不播报。
+- **性能**：整块画布只挂一个 mousemove 与一个提示节点，不为每个柱体创建浮层或监听器。
+
+
+
+返回 [AI 索引](../index.md)。先查本页与 [本地 API](./bar-chart-api.md)；需要更深类型时查 [公开组件导航](../catalog.md)，不默认上网查找本包用法。

package/AI_USAGE/components/boxicons.md

@@ -0,0 +1,147 @@
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
+# Boxicons AI 用法
+
+适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+
+先读 [通用接入](../core.md)。本地组件文档导入的选型和配套资源用法。
+
+### 用途与选型
+
+Boxicons 是三风格单色图标库，x-next 接入为 `boxicons-basic:*`、`boxicons-filled:*`、`boxicons-brands:*` 三个命名空间，调用方式与通用图标一致。来源见 [Boxicons 官网](https://boxicons.com)，数据同步自 `@boxicons/core@1.0.6`。
+
+
+### 何时使用
+
+- 通用图标（Lucide）覆盖不到、但 Boxicons 有的场景：`filled` 实心风格适合强调型入口，`basic` 轮廓风格适合通用操作。
+- 需要品牌 Logo 图标时用 `brands`，例如 GitHub、社交与支付渠道标识。
+- 不需要默认引入：Boxicons 数据与主包隔离，只有显式注册才会进入业务产物。
+
+
+### 图标浏览器
+
+点击任意图标在页面底部打开详情栏，可复制组件代码、名称或 SVG。三个风格包按需懒加载，首次切换风格或搜索命中其他风格时会加载对应数据。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { Icon } from 'x-next';
+import { ref } from 'vue';
+import { registerBoxiconsFilled } from 'x-next/icons/boxicons/filled';
+
+// 显式注册一次；不注册时图标名不存在，与默认图标源完全隔离
+registerBoxiconsFilled();
+
+const visible = ref(true);
+</script>
+<template>
+<Icon name="boxicons-filled:home" :size="20" />
+  <Icon name="boxicons-filled:rocket" :size="20" color="var(--x-color-primary-6)" />
+  <Icon v-if="visible" name="boxicons-filled:bell" :size="20" />
+</template>
+```
+
+### 尺寸、颜色和旋转
+
+Boxicons 是填充型单色图标，颜色跟随 `color`（CSS 为 `fill: currentcolor`），`strokeWidth` 对它不起作用。本节示例使用本页默认加载的 Basic 风格；Filled、Brands 的样式可在上方图标浏览器切换预览。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { Icon } from 'x-next';
+
+import { registerBoxiconsBasic } from 'x-next/icons/boxicons/basic';
+registerBoxiconsBasic();
+</script>
+<template>
+<Icon name="boxicons-basic:home" :size="18" />
+  <Icon name="boxicons-basic:home" :size="26" color="var(--x-color-primary-6)" />
+  <Icon name="boxicons-basic:heart" :size="32" color="var(--x-color-danger-6)" />
+  <Icon name="boxicons-basic:star" :size="32" color="var(--x-color-warning-6)" :rotate="18" />
+</template>
+```
+
+### 组件组合
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { Button, Icon, Tag, Input } from 'x-next';
+
+import { registerBoxiconsBasic } from 'x-next/icons/boxicons/basic';
+registerBoxiconsBasic();
+</script>
+<template>
+<Button type="primary">
+    <template #icon>
+      <Icon name="boxicons-basic:rocket" />
+    </template>
+    发布
+  </Button>
+
+  <Tag color="blue">
+    <Icon name="boxicons-basic:star" />
+    收藏
+  </Tag>
+
+  <Input placeholder="搜索" style="width: 220px">
+    <template #prefix>
+      <Icon name="boxicons-basic:search" />
+    </template>
+  </Input>
+</template>
+```
+
+### 注册与按需导入
+
+Boxicons 不进入默认图标源，也不会自动注册。按风格从子路径导入并注册，未使用的风格不会进入业务产物：
+
+| 导出 | 说明 |
+| --- | --- |
+| `registerBoxiconsBasic()` | 注册 1884 个 Basic 轮廓图标 |
+| `registerBoxiconsFilled()` | 注册 1884 个 Filled 实心图标 |
+| `registerBoxiconsBrands()` | 注册 295 个 Brands 品牌图标 |
+| `registerBoxicons()` | 一次注册全部三个风格包 |
+| `boxiconsPackCounts` | 各风格图标数量 |
+| `boxiconsBasicNames` / `boxiconsFilledNames` / `boxiconsBrandsNames` | 各风格名称清单（`readonly string[]`，不包含 SVG 数据，可安全用于搜索、菜单） |
+| `boxiconsBasicIcons` / `boxiconsFilledIcons` / `boxiconsBrandsIcons` | 名称到 SVG 的映射 |
+| `BoxiconsPack` | `'basic' \| 'filled' \| 'brands'` |
+
+注册是按包幂等的；只需要一两个图标时，也可以从本页复制 SVG 后用 `addIcon` 注册，不必引入整个风格包。
+
+
+### 从 Boxicons 官网迁移
+
+官网 webfont 类名与 x-next 名称一一对应（去掉 `bx-` 前缀）：
+
+| 官网用法 | x-next 用法 |
+| --- | --- |
+| `<i class="bx bx-home"></i>` | `<x-icon name="boxicons-basic:home" />` |
+| `<i class="bxf bx-home"></i>` | `<x-icon name="boxicons-filled:home" />` |
+| `<i class="bxl bx-github"></i>` | `<x-icon name="boxicons-basic:gear" />` |
+
+
+### 体积说明
+
+Boxicons 是大图标集，接入方式围绕“按需”设计：
+
+| 风格 | 图标数 | ESM minified | gzip |
+| --- | --- | --- | --- |
+| basic | 1884 | 899 KB | 225 KB |
+| filled | 1884 | 747 KB | 180 KB |
+| brands | 295 | 278 KB | 106 KB |
+| 合计 | 4063 | ≈ 1.9 MB | ≈ 511 KB |
+
+- 主入口（`import { Button } from 'x-next'`）体积不受影响，`dist/index.cjs`、`dist/index.umd.js` 不包含 Boxicons 数据。
+- 发布包解压后会包含这些数据（约 +3.9MB），但只有显式 `import 'x-next/icons/boxicons/*'` 的模块会进入业务产物。
+- 本页图标浏览器同样按风格懒加载：首次打开只加载 Basic，切换到 Filled、Brands 或搜索出其他风格结果时再加载。
+
+
+### 来源与授权
+
+图标来自 [`@boxicons/core@1.0.6`](https://www.npmjs.com/package/@boxicons/core)（MIT），官方站点 [https://boxicons.com](https://boxicons.com)，仓库 [box-icons/boxicons-core](https://github.com/box-icons/boxicons-core)。完整许可原文见 `src/packages/icons/public/boxicons/LICENSE.md`。
+
+Brands 图标是第三方商标图形，MIT 许可覆盖图标文件本身，商标使用需遵循各自品牌方的规范。
+
+
+
+返回 [AI 索引](../index.md)。

package/AI_USAGE/components/button-api.md

@@ -0,0 +1,144 @@
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
+# Button 完整公开 API
+
+适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+
+从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
+
+## Button API
+
+公开声明：`dist/components/button/index.d.ts`。 类型中的 undefined 表示可省略；原始 prop 默认值不等于继承配置或服务默认值。
+
+### Props
+
+| 名称 | 用途 | 公开类型 | 必填 | 声明默认值 |
+| --- | --- | --- | --- | --- |
+| disabled | 是否禁用 | undefined &#124; false &#124; true | 否 | false |
+| block | 是否撑满父容器 | undefined &#124; false &#124; true | 否 | false（Vue Boolean 转换） |
+| loading | 是否展示加载状态；加载中会拦截点击 | undefined &#124; false &#124; true | 否 | false（Vue Boolean 转换） |
+| loadingFill | 加载时居中覆盖内容并保持尺寸；结束后恢复文字和插槽 | undefined &#124; false &#124; true | 否 | false |
+| debounce | 点击后保持 loading 态的时间，单位 ms，用于防重复点击 | undefined &#124; number | 否 | 0 |
+| shape | 胶囊形、圆形或直角；未设置时使用默认圆角 | undefined &#124; "round" &#124; "circle" &#124; "square" | 否 | undefined |
+| link | 是否展示为链接按钮样式 | undefined &#124; false &#124; true | 否 | false |
+| type | 按钮类型 | undefined &#124; "default" &#124; "primary" &#124; "dashed" &#124; "outline" &#124; "text" | 否 | "default" |
+| htmlType | 原生按钮类型；模板中使用 html-type | undefined &#124; "button" &#124; "submit" &#124; "reset" | 否 | "button" |
+| status | 按钮状态 | undefined &#124; "default" &#124; "success" &#124; "warning" &#124; "strong" &#124; "info" &#124; "danger" | 否 | "default" |
+| plain | 是否朴素样式 | undefined &#124; false &#124; true | 否 | false |
+| size | 按钮尺寸 | undefined &#124; "mini" &#124; "small" &#124; "medium" &#124; "large" &#124; "huge" | 否 | undefined |
+| border | 是否显示边框 | undefined &#124; false &#124; true | 否 | true |
+| narrow | 是否使用窄按钮，无内边距 | undefined &#124; false &#124; true | 否 | false |
+
+### Events
+
+| 事件 | 用途 | 监听器签名（即事件参数） |
+| --- | --- | --- |
+| click | 点击按钮且按钮未禁用、未加载时触发 | undefined &#124; (...args: any[]) => any |
+
+### Slots
+
+| 名称 | 用途 | 公开类型 |
+| --- | --- | --- |
+| default | 按钮内容 | () => any |
+| prefix | 前置内容 | () => any |
+| suffix | 后置内容 | () => any |
+| icon | 图标内容，会渲染在文字前；仅有此插槽时按钮等宽高，请设置 aria-label | any |
+
+### 实例方法
+
+没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+
+### 关联类型定义
+
+以下摘自本组件族声明，供查阅嵌套配置；运行时和值类型均以根入口可导出项为准。
+
+```typescript-reference
+type ButtonSize = 'mini' | 'small' | 'medium' | 'large' | 'huge';
+
+type ButtonStatus = 'default' | 'success' | 'warning' | 'strong' | 'danger' | 'info';
+
+type ButtonTypes = 'primary' | 'default' | 'dashed' | 'outline' | 'text';
+
+type ButtonHtmlType = 'button' | 'submit' | 'reset';
+
+type ButtonShape = 'round' | 'circle' | 'square';
+
+type ButtonProps = {
+    disabled?: boolean;
+    block?: boolean;
+    loading?: boolean;
+    loadingFill?: boolean;
+    debounce?: number;
+    shape?: ButtonShape;
+    link?: boolean;
+    type?: ButtonTypes;
+    htmlType?: ButtonHtmlType;
+    status?: ButtonStatus;
+    plain?: boolean;
+    size?: ButtonSize;
+    border?: boolean;
+    narrow?: boolean;
+};
+```
+
+
+## ButtonGroup API
+
+公开声明：`dist/components/button/index.d.ts`。 类型中的 undefined 表示可省略；原始 prop 默认值不等于继承配置或服务默认值。
+
+### Props
+
+| 名称 | 用途 | 公开类型 | 必填 | 声明默认值 |
+| --- | --- | --- | --- | --- |
+| type | 子按钮默认类型 | undefined &#124; "default" &#124; "primary" &#124; "dashed" &#124; "outline" &#124; "text" | 否 | 未声明 |
+| status | 子按钮默认状态 | undefined &#124; "default" &#124; "success" &#124; "warning" &#124; "strong" &#124; "info" &#124; "danger" | 否 | 未声明 |
+| shape | 子按钮默认形状 | undefined &#124; "round" &#124; "circle" &#124; "square" | 否 | 未声明 |
+| size | 子按钮默认尺寸 | undefined &#124; "mini" &#124; "small" &#124; "medium" &#124; "large" &#124; "huge" | 否 | 未声明 |
+| disabled | 是否禁用所有子按钮 | undefined &#124; false &#124; true | 否 | false（Vue Boolean 转换） |
+
+### Events
+
+未声明组件 emits；原生事件与包装透传按本页用法核实。
+
+### Slots
+
+公开类型未逐项声明插槽；本页场景说明列出实际使用的插槽，不将任意插槽视为已支持。
+
+### 实例方法
+
+没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+
+### 关联类型定义
+
+以下摘自本组件族声明，供查阅嵌套配置；运行时和值类型均以根入口可导出项为准。
+
+```typescript-reference
+type ButtonSize = 'mini' | 'small' | 'medium' | 'large' | 'huge';
+
+type ButtonStatus = 'default' | 'success' | 'warning' | 'strong' | 'danger' | 'info';
+
+type ButtonTypes = 'primary' | 'default' | 'dashed' | 'outline' | 'text';
+
+type ButtonHtmlType = 'button' | 'submit' | 'reset';
+
+type ButtonShape = 'round' | 'circle' | 'square';
+
+type ButtonProps = {
+    disabled?: boolean;
+    block?: boolean;
+    loading?: boolean;
+    loadingFill?: boolean;
+    debounce?: number;
+    shape?: ButtonShape;
+    link?: boolean;
+    type?: ButtonTypes;
+    htmlType?: ButtonHtmlType;
+    status?: ButtonStatus;
+    plain?: boolean;
+    size?: ButtonSize;
+    border?: boolean;
+    narrow?: boolean;
+};
+```
+
+
+返回 [Button 用法](./button.md)。