x-next 1.14.0 → 1.15.0

package/AI_USAGE/catalog.md

@@ -1,9 +1,9 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # 公开组件与服务导航
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
-从当前构建的根公共声明生成，包含 103 个具名组件/服务导出（含子组件和别名，不等于组件族数量），每项均有包内用法与 API 导航。运行时仅从 `x-next` 导入；未列出的 hooks、指令和类型继续查 [公共入口声明](../dist/index.d.ts)。
+从当前构建的根公共声明生成，包含 105 个具名组件/服务导出（含子组件和别名，不等于组件族数量），每项均有包内用法与 API 导航。运行时仅从 `x-next` 导入；未列出的 hooks、指令和类型继续查 [公共入口声明](../dist/index.d.ts)。
 
 | 导出 | 形式 | 本地用法 | 本地 API | 类型导航 | 样式入口 |
 | --- | --- | --- | --- | --- | --- |
@@ -104,6 +104,8 @@
 | TimeRangeSelector | 组件 | [用法](./components/time-range-selector.md) | [API](./components/time-range-selector-api.md#timerangeselector-api) | [公开声明](../dist/components/time-range-selector/index.d.ts) | x-next/style/time-range-selector |
 | Tooltip | 组件 | [用法](./components/tooltip.md) | [API](./components/tooltip-api.md#tooltip-api) | [公开声明](../dist/components/tooltip/index.d.ts) | x-next/style/tooltip |
 | Tr | 组件 | [用法](./components/table.md) | [API](./components/table-api.md#tr-api) | [公开声明](../dist/components/table/table-tr.d.ts) | x-next/style/table |
+| TreeSelect | 组件 | [用法](./components/tree-select.md) | [API](./components/tree-select-api.md#treeselect-api) | [公开声明](../dist/components/tree-select/index.d.ts) | x-next/style/tree-select |
+| TreeSelectDropdown | 组件 | [用法](./components/tree-select.md) | [API](./components/tree-select-api.md#treeselectdropdown-api) | [公开声明](../dist/components/tree-select/index.d.ts) | x-next/style/tree-select |
 | TrendChart | 组件 | [用法](./components/trend-chart.md) | [API](./components/trend-chart-api.md#trendchart-api) | [公开声明](../dist/components/trend-chart/index.d.ts) | x-next/style/base.css |
 | Trigger | 组件 | [用法](./components/trigger.md) | [API](./components/trigger-api.md#trigger-api) | [公开声明](../dist/components/trigger/index.d.ts) | x-next/style/trigger |
 | Upload | 组件 | [用法](./components/upload.md) | [API](./components/upload-api.md#upload-api) | [公开声明](../dist/components/upload/index.d.ts) | x-next/style/upload |

package/AI_USAGE/components/alert-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Alert 完整公开 API
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/alert.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Alert AI 使用
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。公开导出：`Alert`；主要模型：v-model:visible。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./alert-api.md)，包含本组件族全部子组件和别名。
 

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

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # BarChart 完整公开 API
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/bar-chart.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # BarChart AI 使用
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。公开导出：`BarChart`；主要模型：无。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./bar-chart-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/boxicons.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Boxicons AI 用法
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。本地组件文档导入的选型和配套资源用法。
 

package/AI_USAGE/components/button-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Button 完整公开 API
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/button.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Button AI 使用
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。公开导出：`Button, ButtonGroup`；主要模型：无。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./button-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/charts.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Charts AI 用法
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。本地组件文档导入的选型和配套资源用法。
 

package/AI_USAGE/components/checkbox-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Checkbox 完整公开 API
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/checkbox.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Checkbox AI 使用
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。公开导出：`Checkbox, CheckboxGroup`；主要模型：v-model。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./checkbox-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/color-picker-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # ColorPicker 完整公开 API
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/color-picker.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # ColorPicker AI 使用
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。公开导出：`ColorPicker`；主要模型：v-model、v-model:show。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./color-picker-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/config-provider-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # ConfigProvider 完整公开 API
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/config-provider.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # ConfigProvider AI 使用
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。公开导出：`ConfigProvider`；主要模型：无。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./config-provider-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/date-picker-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # DatePicker 完整公开 API
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/date-picker.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # DatePicker AI 使用
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。公开导出：`DatePicker, MonthPicker, QuarterPicker, RangePicker, WeekPicker, YearPicker`；主要模型：v-model、v-model:popup-visible。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./date-picker-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/dialog-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Dialog 完整公开 API
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/dialog.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Dialog AI 使用
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。公开导出：`Dialog, DialogComponent`；主要模型：v-model。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./dialog-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/draggable-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Draggable 完整公开 API
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/draggable.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Draggable AI 使用
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。公开导出：`Draggable`；主要模型：v-model。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./draggable-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/drawer-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Drawer 完整公开 API
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/drawer.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Drawer AI 使用
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。公开导出：`Drawer`；主要模型：v-model。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./drawer-api.md)，包含本组件族全部子组件和别名。
 
@@ -59,6 +59,35 @@ const visible = rightVisible;
 </template>
 ```
 
+### 长内容滚动
+
+默认布局由内部 Scrollbar 滚动正文，标题和底部操作区保持可见。四个方向、有无 footer 均适用；`bodyStyle` 的 padding 包含在正文高度内。`fill` 插槽替换整套布局时，滚动与标题布局由插槽内容负责。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { ref } from 'vue';
+import { Button, Drawer, Space } from 'x-next';
+
+const visible = ref(false);
+const placement = ref<'left' | 'right' | 'top' | 'bottom'>('right');
+const showFooter = ref(false);
+const placements = ['left', 'right', 'top', 'bottom'] as const;
+</script>
+<template>
+<label><input v-model="showFooter" type="checkbox" /> 显示底部操作区</label>
+  <Space>
+    <Button v-for="side in placements" :key="side" @click="placement = side; visible = true">
+      {{ side }} 长内容
+    </Button>
+  </Space>
+  <Drawer v-model="visible" title="长内容滚动" :placement="placement"
+    :width="560" :height="360" :show-footer="showFooter" :body-style="{ padding: '20px' }">
+    <p v-for="index in 40" :key="index">发布记录 {{ index }}：正文滚动后，标题和底部操作区仍可操作。</p>
+  </Drawer>
+</template>
+```
+
 ### 受控与事件
 
 ```vue

package/AI_USAGE/components/dropdown-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Dropdown 完整公开 API
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/dropdown.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Dropdown AI 使用
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。公开导出：`Dropdown, DropdownButton, DropdownGroup, DropdownOption, DropdownSubmenu`；主要模型：v-model:popup-visible。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./dropdown-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/empty-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Empty 完整公开 API
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/empty.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Empty AI 使用
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。公开导出：`Empty`；主要模型：无。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./empty-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/finicon.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Finicon AI 用法
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。本地组件文档导入的选型和配套资源用法。
 

package/AI_USAGE/components/form-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Form 完整公开 API
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/form.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Form AI 使用
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。公开导出：`Form, FormItem`；主要模型：无。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./form-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/grid-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Grid 完整公开 API
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/grid.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Grid AI 使用
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。公开导出：`Col, Grid, GridItem, Row`；主要模型：无。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./grid-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/heatmap-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Heatmap 完整公开 API
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/heatmap.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Heatmap AI 使用
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。公开导出：`Heatmap`；主要模型：无。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./heatmap-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/icon-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Icon 完整公开 API
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/icon.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Icon AI 使用
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。公开导出：`Icon`；主要模型：无。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./icon-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/image-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Image 完整公开 API
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/image.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Image AI 使用
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。公开导出：`Image, ImagePreview, ImagePreviewAction, ImagePreviewGroup`；主要模型：v-model:preview-visible。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./image-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/input-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Input 完整公开 API
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/input-number-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # InputNumber 完整公开 API
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/input-number.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # InputNumber AI 使用
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。公开导出：`InputNumber`；主要模型：v-model。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./input-number-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/input-tag-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # InputTag 完整公开 API
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/input-tag.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # InputTag AI 使用
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。公开导出：`InputTag`；主要模型：v-model、v-model:input-value。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./input-tag-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/input.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Input AI 使用
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。公开导出：`Input, InputGroup, InputPassword, InputSearch`；主要模型：v-model。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./input-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/layout-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Layout 完整公开 API
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/layout.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Layout AI 使用
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。公开导出：`Layout, LayoutContent, LayoutFooter, LayoutHeader, LayoutSidebar`；主要模型：无。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./layout-api.md)，包含本组件族全部子组件和别名。
 

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

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # LineChart 完整公开 API
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 
@@ -63,7 +63,7 @@ interface LineChartSeries {
     name?: string;
     /** 该系列按 categories 顺序排列的值 */
     data: Array<number | null | undefined>;
-    /** 该系列的颜色，默认取内置分类色板（按系列下标循环） */
+    /** 该系列的颜色，支持 CSS 变量及 fallback；默认取内置分类色板（按系列下标循环） */
     color?: CSSColor;
 }
 
@@ -85,7 +85,7 @@ interface LineChartLabelsOptions {
     yFormatter?: (value: number) => string;
     /** 轴标签字号，默认 12 */
     fontSize?: number;
-    /** 轴标签颜色，默认取组件文字 token */
+    /** 轴标签颜色，支持 CSS 变量及 fallback；默认取组件文字 token */
     color?: CSSColor;
 }
 

package/AI_USAGE/components/line-chart.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # LineChart AI 使用
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 先读 [通用接入](../core.md)。公开导出：`LineChart`；主要模型：无。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./line-chart-api.md)，包含本组件族全部子组件和别名。
 
@@ -139,6 +139,33 @@ const series = ref([
 </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` 变为堆叠面积。堆叠面积适合看「总量 + 构成」——每层填充在下界与上界之间。

package/AI_USAGE/components/link-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Link 完整公开 API
 
-适用版本：x-next@1.14.0；来源指纹：`014984639d816a2c7e25eb22690c586b0b2e8efba6846bec8a4e424db41a09e9`。
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。