x-next 1.13.0 → 1.15.0

package/AI_USAGE/components/line-chart-api.md

@@ -0,0 +1,197 @@
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
+# LineChart 完整公开 API
+
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
+
+从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
+
+## LineChart API
+
+公开声明：`dist/components/line-chart/index.d.ts`。 类型中的 undefined 表示可省略；原始 prop 默认值不等于继承配置或服务默认值。
+
+### Props
+
+| 名称 | 用途 | 公开类型 | 必填 | 声明默认值 |
+| --- | --- | --- | --- | --- |
+| categories | 类目轴标签，与各系列 data 下标对应 | undefined &#124; (string &#124; number)[] | 否 | [] |
+| series | 数据系列，必填 | undefined &#124; LineChartSeries[] | 是 | [] |
+| stack | 是否堆叠；面积时变为堆叠面积 | undefined &#124; false &#124; true | 否 | false |
+| area | 是否绘制面积填充 | undefined &#124; false &#124; true | 否 | false |
+| smooth | 平滑曲线 | undefined &#124; false &#124; true | 否 | true |
+| connectNulls | 缺测是否跨过连接 | undefined &#124; false &#124; true | 否 | false |
+| showPoints | 数据点显示策略 | undefined &#124; false &#124; true &#124; "auto" | 否 | "auto" |
+| height | 图表高度，数字按 px | undefined &#124; string &#124; number | 否 | 280 |
+| width | 图表宽度，数字按 px | undefined &#124; string &#124; number | 否 | "100%" |
+| max | 数值轴上界；传入后锁定刻度 | undefined &#124; number | 否 | 未声明 |
+| min | 数值轴下界；负值数据自动扩展 | undefined &#124; number | 否 | 未声明 |
+| padding | 绘制边距，1-4 个非负数字字符串或单个数字 | undefined &#124; string &#124; number | 否 | "8" |
+| grid | 网格线配置 | undefined &#124; LineChartGridOptions | 否 | null |
+| labels | 轴标签配置 | undefined &#124; LineChartLabelsOptions | 否 | null |
+| tooltip | 悬浮提示 | undefined &#124; false &#124; true | 否 | true |
+| legend | 图例，点击可隐藏/显示系列 | undefined &#124; false &#124; true | 否 | false |
+| valueFormatter | 数值格式化，用于提示、图例与数值轴 | undefined &#124; (value: number) => string | 否 | 工厂函数（每个实例初始化；有效值见行为说明） |
+| loading | 加载中 | undefined &#124; false &#124; true &#124; { [x: string]: unknown; } | 否 | false |
+| ariaLabel | 无障碍名称；设置后画布带 role="img" | undefined &#124; string | 否 | 未声明 |
+
+### Events
+
+| 事件 | 用途 | 监听器签名（即事件参数） |
+| --- | --- | --- |
+| line-click | 见场景用法与类型 | undefined &#124; (data: LineChartClickData) => any |
+| legend-change | 见场景用法与类型 | undefined &#124; (visibleIndexes: number[]) => any |
+
+### Slots
+
+| 名称 | 用途 | 公开类型 |
+| --- | --- | --- |
+| tooltip | 自定义悬浮提示内容 | undefined &#124; (props: LineChartTooltipSlotProps) => unknown |
+| legend | 自定义图例 | undefined &#124; (props: { series: LineChartSeries[]; hiddenIndexes: number[]; }) => unknown |
+| point | 自定义数据点渲染 | undefined &#124; (props: { seriesIndex: number; index: number; value: number; x: number; y: number; color: string; }) => unknown |
+| empty | 自定义空态内容 | undefined &#124; () => unknown |
+
+### 实例方法
+
+没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+
+### 关联类型定义
+
+以下摘自本组件族声明，供查阅嵌套配置；运行时和值类型均以根入口可导出项为准。
+
+```typescript-reference
+interface LineChartSeries {
+    /** 系列名，用于悬浮提示与图例 */
+    name?: string;
+    /** 该系列按 categories 顺序排列的值 */
+    data: Array<number | null | undefined>;
+    /** 该系列的颜色，支持 CSS 变量及 fallback；默认取内置分类色板（按系列下标循环） */
+    color?: CSSColor;
+}
+
+interface LineChartGridOptions {
+    /** 是否显示横向网格线，默认 true */
+    horizontalLines?: boolean;
+    /** 横向网格线数量（含基线），默认 4 */
+    horizontalLinesNumber?: number;
+}
+
+interface LineChartLabelsOptions {
+    /** 是否显示类目标签，默认 true */
+    xVisible?: boolean;
+    /** 是否显示数值轴标签，默认 true */
+    yVisible?: boolean;
+    /** 类目标签格式化 */
+    xFormatter?: (label: string, index: number) => string;
+    /** 数值轴刻度格式化 */
+    yFormatter?: (value: number) => string;
+    /** 轴标签字号，默认 12 */
+    fontSize?: number;
+    /** 轴标签颜色，支持 CSS 变量及 fallback；默认取组件文字 token */
+    color?: CSSColor;
+}
+
+interface LineChartTooltipItem {
+    /** 系列下标 */
+    seriesIndex: number;
+    /** 系列名，未提供时为 undefined */
+    name?: string;
+    /**
+     * 该系列在当前类目的值；缺测时为 null
+     */
+    value: number | null;
+    /**
+     * 该系列生效的颜色：业务传入值原样返回，未传入时是内置色板的
+     * `var(--x-chart-color-series-N)` 引用，可直接用于 style 背景色。
+     */
+    color: string;
+}
+
+interface LineChartActiveData {
+    /** 类目下标 */
+    index: number;
+    /** 类目标签（已应用 labels.xFormatter） */
+    label: string;
+    /** 各类目的系列值 */
+    items: LineChartTooltipItem[];
+    /** 所有系列的合计值；stack 时为堆叠总值 */
+    total: number;
+}
+
+interface LineChartClickData extends LineChartActiveData {
+    /** 命中的系列下标；点击落在空白或该点缺测时为 null */
+    seriesIndex: number | null;
+    /** 命中的数据点值；未命中时为 null */
+    value: number | null;
+}
+
+interface LineChartTooltipSlotProps extends LineChartActiveData {
+    /** 组件当前的数值格式化函数，供自定义内容保持一致 */
+    formatValue: (value: number) => string;
+}
+
+interface LineChartPlot {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+}
+
+interface LineChartPointGeometry {
+    /** 类目下标 */
+    index: number;
+    /** 系列下标 */
+    seriesIndex: number;
+    /** 数据点的值 */
+    value: number;
+    x: number;
+    y: number;
+}
+
+interface LineChartSeriesPath {
+    /** 系列下标 */
+    seriesIndex: number;
+    /** 折线路径（平滑时为三次贝塞尔）；缺测断点会切成多段 */
+    d: string;
+    /** 面积填充路径；未开启 area 时为空串 */
+    areaD: string;
+    /** 该系列的数据点，供数据点渲染与交互命中 */
+    points: LineChartPointGeometry[];
+}
+
+interface BuildLineChartSeriesParams {
+    /** values[seriesIndex][categoryIndex]；缺测为 null */
+    values: Array<Array<number | null>>;
+    /**
+     * 面积填充的下边界（堆叠面积用）：
+     * 逐系列给出，形状与 values 相同；省略时填充到 baseline 水平线。
+     */
+    lower?: Array<Array<number | null>>;
+    plot: LineChartPlot;
+    /** 数值域下界（负值场景下为负数） */
+    domainMin: number;
+    /** 数值域上界 */
+    domainMax: number;
+    /** 是否平滑 */
+    smooth: boolean;
+    /** 缺测点是否跨过（连到下一个有效点） */
+    connectNulls: boolean;
+    /** 是否绘制面积填充 */
+    area: boolean;
+    /** 面积基线的 y（未给 lower 时使用） */
+    baseline: number;
+}
+
+interface StackedLineChartLayer {
+    seriesIndex: number;
+    /** 本层的值（缺测为 0） */
+    values: number[];
+    /** 本层下界（下方所有层的累加） */
+    base: number[];
+    /** 本层上界（base + values） */
+    top: number[];
+}
+```
+
+
+返回 [LineChart 用法](./line-chart.md)。

package/AI_USAGE/components/line-chart.md

@@ -1,12 +1,14 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # LineChart AI 使用
 
-适用版本：x-next@1.13.0；来源指纹：`18e9b8eefa53b4bd91134fb4486778509ccf3a8d614a1bd387a6d469b623ddcf`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
-先读 [通用接入](../core.md)。公开导出：`LineChart`；模型：无；已核对事件：lineClick、legendChange。
+先读 [通用接入](../core.md)。公开导出：`LineChart`；主要模型：无。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./line-chart-api.md)，包含本组件族全部子组件和别名。
 
 按需样式：`x-next/style/line-chart`（包含 base.css、line-chart.css、spin.css）。代码块未单独引样式时在应用入口加载全量样式，或按实际所有组件加载 JS 入口；不要仅因复制一个组件页就漏掉其中的 Button 等组合依赖。
 
+## 已核验行为与示例
+
 [组件文档与 live demo](https://x-next.yjmf.com/components/line-chart)。随时间看趋势就用它：`categories` 是时间轴标签，`series` 是数据系列（`{ name, data, color }`），按下标对应。多系列默认叠放，加 `area` 填充、再加 `stack` 变堆叠面积。按类目比大小用 BarChart，看占比用 PieChart，卡片角落的迷你走势用 TrendChart——完整选择指引见[图表总览](https://x-next.yjmf.com/components/charts)。
 
 **缺测要显式表达**：把没有数据的点写成 `null`，默认会在该处**断开**折线（不会画成跌到 0）；确需连线时传 `:connect-nulls="true"`。数值轴对纯正数数据保持 0 基线，出现负值才向下扩展；`min` / `max` 可锁定区间。`smooth` 默认开启，`show-points` 默认 `'auto'`（点数少时常显）。
@@ -44,4 +46,305 @@ function onLineClick(data: { label: string; value: number | null }) {
 </template>
 ```
 
-返回 [AI 索引](../index.md)。精选示例不是完整 API 表，新能力先查同版本公开类型与组件文档。
+## 场景用法
+
+以下示例从本地 `src/docs/components/line-chart.md` 显式导入到独立 AI 源，补齐局部注册、状态和样式后进行严格模板检查。上方已核验行为优先；原始 prop 默认值、包装透传和示例业务适配分别查 [完整 API](./line-chart-api.md) 与场景说明。类型通过不代表所有散文和交互已验证。
+
+### 用途与选型
+
+用于展示指标随时间的变化趋势：支持多系列对比、面积填充、堆叠面积、平滑与缺测断点。
+
+
+### 完整日期与窄容器
+
+调整宽度或切换长类目名称。首末文字保持在绘图区内，收边后再次检查间距；超长文字以省略号显示，悬停可读完整内容。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { ref } from 'vue';
+import { LineChart } 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%' }">
+    <LineChart :categories="categories" :series="series" />
+  </div>
+</template>
+```
+
+### 何时使用
+
+- 时间轴上比较多个指标的走势（各模型的 Token 消耗、不同环境的请求量）。
+- 关注变化速率与拐点，而不是单个时间点的精确读数。
+- 需要在线性趋势里叠加一条对照线（如实际值 vs 目标值）。
+
+
+### 与其它图表的分工
+
+| 场景 | 选择 |
+| --- | --- |
+| 随时间看变化趋势 | LineChart（本页） |
+| 按类目比较大小 | [BarChart 柱状趋势图](./bar-chart.md) |
+| 看占比构成 | [PieChart 饼图](./pie-chart.md) |
+| 卡片角落的迷你走势 | [TrendChart 趋势图](./trend-chart.md) |
+
+
+### 基础用法
+
+`categories` 与每个系列 `data` 按下标一一对应；类目轴标签会按当前宽度自动抽稀，末位总是保留。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { LineChart } from 'x-next';
+import { ref } from 'vue';
+
+const categories = ref(['09-28', '09-29', '09-30', '10-01', '10-02']);
+const values = ref([820, 932, 901, 934, 1290]);
+</script>
+<template>
+<LineChart
+    :categories="categories"
+    :series="[{ name: '请求量', data: values }]"
+    ariaLabel="近 30 天请求量"
+  />
+</template>
+```
+
+### 多系列与平滑
+
+多系列默认叠放（不堆叠），颜色取自内置分类色板；`smooth` 默认为 `true`，关闭后是折线段。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { LineChart } from 'x-next';
+import { ref } from 'vue';
+
+const categories = ref(['09-28', '09-29', '09-30', '10-01', '10-02']);
+const series = ref([
+  { name: '输入 Token', data: [820, 932, 901, 934, 1290] },
+  { name: '输出 Token', data: [420, 512, 401, 634, 890] },
+]);
+</script>
+<template>
+<LineChart :categories="categories" :series="series" legend />
+</template>
+```
+
+### CSS 变量与系列颜色
+
+`series[].color` 和 `labels.color` 支持 CSS 自定义属性引用（含 fallback），以及具名颜色、hex、rgb/rgba、hsl/hsla。传入值原样用于折线、面积、数据点、图例和提示色块，变量在图表所在节点解析；变量值变化无需替换系列数据。未传颜色时使用内置主题色板。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+const area = ref(true);
+
+import { ref } from 'vue';
+import { Button, LineChart } from 'x-next';
+import type { LineChartSeries } from 'x-next';
+
+const alternateColor = ref(false);
+const series: LineChartSeries[] = [
+  { name: '访问量（PV）', data: [20, 45, 30], color: 'var(--demo-line-color, var(--x-color-primary-6))' },
+];
+</script>
+<template>
+<div :style="{ '--demo-line-color': alternateColor ? 'var(--x-color-success-6)' : 'var(--x-color-primary-6)' }">
+    <Button @click="alternateColor = !alternateColor">切换系列颜色</Button>
+    <LineChart :categories="['10-07', '10-08', '10-09']" :series="series"
+      :labels="{ color: 'var(--x-color-text-primary)' }" area legend ariaLabel="CSS 变量颜色示例" />
+  </div>
+</template>
+```
+
+### 面积图与堆叠面积
+
+`area` 打开填充；配合 `stack` 变为堆叠面积。堆叠面积适合看「总量 + 构成」——每层填充在下界与上界之间。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { LineChart } from 'x-next';
+const area = ref(true);
+const stack = ref(false);
+
+import { ref } from 'vue';
+
+const categories = ref(['09-28', '09-29', '09-30', '10-01', '10-02']);
+const series = ref([
+  { name: 'deepseek-flash', data: [43.38, 52.4, 38.05, 61.2, 55.8] },
+  { name: 'gpt-4o-mini', data: [18.29, 26.1, 12.6, 30.4, 22.1] },
+]);
+const formatMoney = (value: number) => `¥${value.toFixed(2)}`;
+</script>
+<template>
+<LineChart
+    :categories="categories"
+    :series="series"
+    area
+    stack
+    :value-formatter="formatMoney"
+    legend
+  />
+</template>
+```
+
+### 缺测处理
+
+`null` 表示该时间点没有数据。默认**断开**折线（避免把「没有调用」画成跌到 0）；`connectNulls` 打开后跨过缺测连到下一点。两者都不会在缺测处产生数据点。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { LineChart } from 'x-next';
+import { ref } from 'vue';
+
+const connectNulls = ref(false);
+const categories = ref(['09-28', '09-29', '09-30', '10-01', '10-02']);
+// 周末为 null：默认在该处断开折线
+const values = ref([820, null, null, 934, 1290]);
+</script>
+<template>
+<LineChart
+    :categories="categories"
+    :series="[{ name: '工作日请求量', data: values }]"
+    :connect-nulls="connectNulls"
+  />
+</template>
+```
+
+### 数值轴与负值
+
+正数数据保持 0 基线（不会用非零基线夸大波动）；出现负值时才向下扩展出负向刻度，零线会被强调。`min` / `max` 可锁定区间。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { LineChart } from 'x-next';
+import { ref } from 'vue';
+
+const categories = ref(['9/1', '9/5', '9/10', '9/15', '9/20', '9/25', '9/30']);
+const series = ref([
+  { name: 'p50', data: [180, 210, 195, 230, 205, 240, 220] },
+  { name: 'p95', data: [420, 680, 510, 940, 720, 1180, 860] },
+]);
+</script>
+<template>
+<LineChart
+    :categories="categories"
+    :series="series"
+    :max="1200"
+    :grid="{ horizontalLinesNumber: 5 }"
+    legend
+  />
+</template>
+```
+
+### 自定义提示与点击事件
+
+`tooltip` 插槽可完全接管浮层内容；点击触发 `line-click`，命中具体数据点时带 `seriesIndex` 与 `value`。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { LineChart } from 'x-next';
+import { ref } from 'vue';
+
+const categories = ref(['09-28', '09-29', '09-30']);
+const series = ref([
+  { name: '请求量', data: [820, 932, 901] },
+  { name: '错误数', data: [120, 132, 101] },
+]);
+const clickLog = ref('尚未点击数据点');
+const onLineClick = (data: { label: string; value: number | null }) => {
+  clickLog.value = `${data.label}：${data.value ?? '缺测'}`;
+};
+</script>
+<template>
+<LineChart
+    :categories="categories"
+    :series="series"
+    legend
+    @line-click="onLineClick"
+  >
+    <template #tooltip="{ label, items, formatValue }">
+      <div style="font-weight: 500">{{ label }}</div>
+      <div v-for="item in items" :key="item.seriesIndex">
+        <span>{{ item.name }}</span>
+        <span>{{ item.value === null ? '-' : formatValue(item.value) }}</span>
+      </div>
+    </template>
+  </LineChart>
+  <p>{{ clickLog }}</p>
+</template>
+```
+
+### 数据点与轴格式化
+
+`showPoints` 控制数据点：`true` 常显、`false` 不显示、`'auto'`（默认）在点数较少时常显。`labels.yFormatter` 只影响数值轴，`valueFormatter` 同时影响提示与图例。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { LineChart } from 'x-next';
+import { ref } from 'vue';
+
+const smooth = ref(true);
+const categories = ref(['09-28', '09-29', '09-30']);
+const series = ref([{ name: '请求量', data: [820, 932, 901] }]);
+const formatCompact = (value: number) => (value >= 1000 ? `${value / 1000}k` : `${value}`);
+</script>
+<template>
+<LineChart
+    :categories="categories"
+    :series="series"
+    :show-points="true"
+    :smooth="smooth"
+    :value-formatter="formatCompact"
+  />
+</template>
+```
+
+### 加载与空数据
+
+`loading` 覆盖加载遮罩；全部为 `null` 或没有系列时显示空态，可用 `empty` 插槽替换。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { LineChart } 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: [820, 932, 901] }]);
+</script>
+<template>
+<LineChart :categories="categories" :series="series" :loading="loading">
+    <template #empty>该时段没有调用记录</template>
+  </LineChart>
+</template>
+```
+
+### 交互说明
+
+- **数值轴**：默认按 1 / 2 / 5 步长取整（刻度始终是 `0.5`、`80` 这类可读值），因此实际刻度行数可能少于 `horizontalLinesNumber`；传 `min` / `max` 后按锁定值均分。
+- **零基线**：纯正数数据不会用非零基线；出现负值时才扩展负向刻度。
+- **缺测**：默认断线，`connectNulls` 改为跨过；两种模式都不会在缺测处产生数据点，避免鼠标命中不存在的点。
+- **堆叠**：按可见系列的顺序自下而上累加；缺测按 0 处理，保证堆叠层不出现空洞。命中的系列高亮显示，其余系列由样式淡化。
+- **x 轴标签**：按当前宽度和文字宽度自动抽稀，优先保留末位；收边后再次检查间距。空间不足时省略其他标签，单个超长标签以省略号显示并提供完整文字提示。
+- **键盘导航**：绘图区可聚焦，左右方向键移动读数、Home / End 跳到首尾、Esc 关闭提示；键盘导航时通过 `aria-live` 播报。
+- **性能**：整块画布只挂一个 mousemove 与一个提示节点，不为每个数据点创建浮层或监听器；数据点默认在点数较少时常显，长序列自动隐藏。
+
+
+
+返回 [AI 索引](../index.md)。先查本页与 [本地 API](./line-chart-api.md)；需要更深类型时查 [公开组件导航](../catalog.md)，不默认上网查找本包用法。

package/AI_USAGE/components/link-api.md

@@ -0,0 +1,42 @@
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
+# Link 完整公开 API
+
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
+
+从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
+
+## Link API
+
+公开声明：`dist/components/link/index.d.ts`。 类型中的 undefined 表示可省略；原始 prop 默认值不等于继承配置或服务默认值。
+
+### Props
+
+| 名称 | 用途 | 公开类型 | 必填 | 声明默认值 |
+| --- | --- | --- | --- | --- |
+| href | 链接地址 | undefined &#124; string | 否 | 未声明 |
+| status | 链接状态 | undefined &#124; "normal" &#124; "success" &#124; "warning" &#124; "strong" &#124; "danger" | 否 | "normal" |
+| hoverable | 鼠标悬浮时是否展示底色 | undefined &#124; false &#124; true | 否 | true |
+| icon | 是否显示默认图标 | undefined &#124; false &#124; true | 否 | false（Vue Boolean 转换） |
+| loading | 是否为加载状态，加载中不会触发点击事件 | undefined &#124; false &#124; true | 否 | false（Vue Boolean 转换） |
+| disabled | 是否禁用，禁用时不会触发点击事件 | undefined &#124; false &#124; true | 否 | false（Vue Boolean 转换） |
+| strong | 是否加粗，x-next 扩展能力 | undefined &#124; false &#124; true | 否 | false（Vue Boolean 转换） |
+
+### Events
+
+| 事件 | 用途 | 监听器签名（即事件参数） |
+| --- | --- | --- |
+| click | 点击链接或通过键盘触发动作链接时触发，禁用或加载中不会触发 | undefined &#124; (ev: MouseEvent &#124; KeyboardEvent) => any |
+
+### Slots
+
+| 名称 | 用途 | 公开类型 |
+| --- | --- | --- |
+| default | 链接文本 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+| icon | 自定义图标 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+
+### 实例方法
+
+没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+
+
+返回 [Link 用法](./link.md)。