x-next 1.11.0 → 1.11.1

package/AI_CODING.md

@@ -2,7 +2,7 @@
 
 本规范供业务仓库的 AI Coding Agent 与协作者使用。x-next 是 Vue 3 + TypeScript 组件库；模型没有预先学过它也可以通过已安装包的手册、公开类型和可运行示例完成接入。
 
-本文件规定查阅和交付流程，实际 API 与可复制 SFC 在独立的 `AI_USAGE/` 中。先读 `AI_USAGE/index.md` 与 `core.md`，再读目标组件/场景。内容从已校验的完整手册生成，保留同版本约束，不需要特定 MCP、插件或付费工具；文档站组件说明保持完整。
+本文件规定查阅和交付流程，实际 API 与可复制 SFC 在独立的 `AI_USAGE/` 中。先读 `AI_USAGE/index.md` 与 `core.md`，再读目标组件/场景。AI 片段与完整手册来自独立维护的 AI 内容源，按实现核实并校验同版本公开类型，不需要特定 MCP、插件或付费工具；文档站组件说明独立保留，不用人用说明覆盖 AI 内容。
 
 ## 建立项目入口
 
@@ -30,6 +30,7 @@ node -p "require.resolve('x-next/AI_USAGE/components/select.md')"
 - 初次接入读 AI_USAGE/index.md 和 core.md，再只读所需 components/*.md 或 recipes/*.md；组件页包含真实说明、模型/事件/样式和完整 SFC，要保留行为限制。不要把完整 AI_USAGE.md 或整个目录加入上下文，也不要把内容全集复制到 AGENTS.md。旧包没有独立目录时才按标题/行段读取原完整手册。
 - 已读内容仍在当前上下文，且安装包及相关本地构建未变时，不重复读取；升级、软链 dist 重建、遇到新 API 或上下文压缩后丢失具体契约时，补读受影响章节。在任务交接中记录版本、相关组件和已查依据。
 - 以同版本 AI 内容、公开 `.d.ts` 和实际加载实现为依据，不套用 Arco/AntDV/Element 的 prop、v-model、事件载荷或服务方法。精选页没有某组件时，查 AI_USAGE/catalog.md 中的公开导出/类型及组件文档，不能据此认定组件不存在；缺什么补查什么，不猜 API。
+- 区分组件行为与示例业务处理、命令式服务与模板组件。清空归一化、异步处理、格式化作用范围等看具体约束；人用文档/JSDoc 与运行行为有冲突时记录冲突并核对实现，不因它来自官方注释就覆盖已验证结论。类型检查不能证明所有行为说明正确。
 - 使用局部具名导入后，模板用对应局部名称；仅 import 不会全局注册 `<x-*>`。根 `Dialog` 是服务，模板组件为 `DialogComponent`。原生属性、受控值、清空值、事件、插槽和实例方法逐项查实际契约，不用未知 attrs、any、ts-ignore 或关闭严格模板检查掩盖错误。
 - 样式遵循项目已有方案：全量样式或所需组件的公开按需入口。路径查手册，不按组件名猜；旧版的内部样式依赖按其版本核实。通过 props、slots、公开主题变量定制，不在业务侧 patch 组件内部实现，不依赖内部结构类名。
 - 只在需求范围内选组件，不自动迁移既有原生 table、输入框或编辑器交互。手写通用控件前先查库现有能力；深度绑定编辑器状态的块手柄、斜杠菜单等保留在编辑器。
@@ -39,6 +40,22 @@ node -p "require.resolve('x-next/AI_USAGE/components/select.md')"
 
 这段规则把模型的默认动作改成“定位当前版本 → 检索章节 → 核实 API → 写代码 → 验收”。它不要求模型事先知道 x-next，也不要求仅因规则存在就扩大组件迁移范围。
 
+## 把示例用于实际任务
+
+先选语义合适的组件，再从最接近需求的完整 SFC 起步。保留初始化、事件与样式，只替换业务数据；确认基本交互后再添加远程请求、自定义插槽或主题。组件已有的状态、清空、键盘和校验能力优先复用；复杂业务规则由业务适配，避免为适配库而隐蔽修改数据语义。
+
+| 场景 | 最少参考内容 | 实施时确认 |
+| --- | --- | --- |
+| 文本与多选表单 | core、Input、Textarea、Select；可直接取 form-on-demand 场景 | 原生属性落点、单/多值类型、清空值与事件、禁用和校验 |
+| 日期/时间字段 | DatePicker 或 TimePicker | 组件清空是 undefined；示例的 '' 是业务适配，范围模型单独核实 |
+| 保存后提示 | Message 或 Notification | 服务句柄在页面卸载清理，模板组件默认值不与服务混用 |
+| 数据趋势/占比 | BarChart / LineChart / PieChart 中所需一种 | 类目比较/时间趋势/占比的选择；formatter 与图例行为各自核实 |
+| 上传接口接入 | Upload | Promise / 回调模式选定，非 2xx、业务错误、取消和重试分别处理 |
+
+代码能编译后，再检查一次真实业务状态变化：输入后模型是否更新、清空后保存值是否正确、请求失败是否保留可重试入口、离开页面是否清理。这比为了覆盖更多 API 一次引入大量组件更容易验证与维护。
+
+实际解析的软链包、package.json 的依赖范围、锁文件解析版本是不同证据；软链联调还需确认 dist 已构建。若它们不一致，先标明本次验证的是哪份内容，不能用本地新能力断言旧版安装也可用。
+
 ## 按任务查阅和验证
 
 新包使用下面这几个独立路径：

package/AI_USAGE/catalog.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # 公开组件与服务导航
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 从当前构建的根公共声明生成，包含 100 个具名组件/服务导出（含子组件和别名，不等于组件族数量）。本页导航不宣称每项有精选示例。运行时仅从 `x-next` 导入，不深导入这些声明路径；未列出的 hooks、指令和类型继续查 [公共入口声明](../dist/index.d.ts)。
 

package/AI_USAGE/components/alert.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Alert AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`Alert`；模型：v-model:visible；已核对事件：close。
 

package/AI_USAGE/components/bar-chart.md

@@ -1,17 +1,19 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # BarChart AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`BarChart`；模型：无；已核对事件：barClick、legendChange。
 
 按需样式：`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` 变成堆叠并显示合计。轻量迷你走势用 TrendChart，需要坐标轴与读数用本组件。
+[组件文档与 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 处理且不画柱体。
 
-`tooltip` 默认开启，`legend` 开启后点击图例可隐藏系列并触发 `legendChange`；点击柱体触发 `barClick`，命中具体柱体时带 `seriesIndex` / `value`，未命中时为 `null`。`valueFormatter` 统一控制提示、图例与数值轴的数字格式。
+`tooltip` 默认开启，`legend` 开启后点击图例可隐藏系列并触发 `legendChange`。默认图例只显示色块和系列名，不显示数值；`valueFormatter` 作用于默认提示与数值轴，`labels.yFormatter` 可单独覆盖数值轴，不改变图例。
+
+SVG 点击的 x 落在横向类目范围内才触发 `barClick`；直接命中柱体时带 `seriesIndex` / `value`，该范围内未命中柱体则这两个字段为 `null`。x 在类目范围外不触发；不要把此逻辑当成完整二维绘图区边界判断。
 
 ```vue
 <script setup lang="ts">

package/AI_USAGE/components/button.md

@@ -1,13 +1,13 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Button AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`Button`；模型：无；已核对事件：click。
 
 按需样式：`x-next/style/button`（包含 base.css、button.css）。代码块未单独引样式时在应用入口加载全量样式，或按实际所有组件加载 JS 入口；不要仅因复制一个组件页就漏掉其中的 Button 等组合依赖。
 
-[组件文档与 live demo](https://x-next.yjmf.com/components/button)。`type` 默认 `'default'`，视觉主按钮用 `'primary'`；`htmlType` 默认 `'button'`，原生提交用 `'submit'`。独立使用时尺寸回退为 `'medium'`，`disabled` / `loading` 默认关闭。
+[组件文档与 live demo](https://x-next.yjmf.com/components/button)。`type` 默认 `'default'`，视觉主按钮用 `'primary'`；`htmlType` 默认 `'button'`，原生提交用 `'submit'`。尺寸优先级为显式 `size` → ButtonGroup → ConfigProvider → `'medium'`；Button 不通过 FormItem 继承尺寸。`disabled` / `loading` 默认关闭。
 
 `click` 载荷为 `MouseEvent`，禁用或加载中不会触发。`default`、`prefix`、`suffix`、`icon` 插槽可组合内容；异步业务自行维护 `loading`。
 

package/AI_USAGE/components/checkbox.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Checkbox AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`Checkbox`；模型：v-model；已核对事件：change。
 

package/AI_USAGE/components/color-picker.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # ColorPicker AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`ColorPicker`；模型：v-model、v-model:show；已核对事件：change、showChange、clear、confirm。
 

package/AI_USAGE/components/config-provider.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # ConfigProvider AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`ConfigProvider`；模型：无；已核对事件：未在精选映射登记事件；其他 API 见下方用法。
 

package/AI_USAGE/components/date-picker.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # DatePicker AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`DatePicker`；模型：v-model、v-model:popup-visible；已核对事件：change。
 

package/AI_USAGE/components/dialog.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Dialog AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`DialogComponent, Dialog`；模型：v-model；已核对事件：close、closed。
 

package/AI_USAGE/components/dropdown.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Dropdown AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`Dropdown`；模型：v-model:popup-visible；已核对事件：select、popupVisibleChange。
 

package/AI_USAGE/components/empty.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Empty AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`Empty`；模型：无；已核对事件：未在精选映射登记事件；其他 API 见下方用法。
 

package/AI_USAGE/components/input.md

@@ -1,13 +1,13 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Input AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`Input`；模型：v-model；已核对事件：input、change、clear。
 
 按需样式：`x-next/style/form-input`（包含 base.css、button.css、form-input.css）。代码块未单独引样式时在应用入口加载全量样式，或按实际所有组件加载 JS 入口；不要仅因复制一个组件页就漏掉其中的 Button 等组合依赖。
 
-[组件文档与 live demo](https://x-next.yjmf.com/components/input)。`v-model` 为字符串，`input` 随输入触发，`change` 在失焦或回车时触发，`clear` 通知清空；readonly 是组件 prop。原生 id、name、aria、required 用 `inputAttrs`，外部 class / style 落在容器。内部装饰用 prefix / suffix，外侧标签用 prepend / append。
+[组件文档与 live demo](https://x-next.yjmf.com/components/input)。`v-model` 为字符串，`input` 随输入触发；失焦、回车或清空时，值相对聚焦时/上次 change 的记录发生变化才触发 `change(value, event)`。`clear(event)` 通知清空按钮操作；readonly 是组件 prop。原生 id、name、aria、required 用 `inputAttrs`，外部 class / style 落在容器。内部装饰用 prefix / suffix，外侧标签用 prepend / append。
 
 ```vue
 <script setup lang="ts">

package/AI_USAGE/components/line-chart.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # LineChart AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`LineChart`；模型：无；已核对事件：lineClick、legendChange。
 
@@ -11,7 +11,9 @@
 
 **缺测要显式表达**：把没有数据的点写成 `null`，默认会在该处**断开**折线（不会画成跌到 0）；确需连线时传 `:connect-nulls="true"`。数值轴对纯正数数据保持 0 基线，出现负值才向下扩展；`min` / `max` 可锁定区间。`smooth` 默认开启，`show-points` 默认 `'auto'`（点数少时常显）。
 
-`tooltip` 默认开启，`legend` 开启后点击图例可隐藏系列并触发 `legendChange`（数值轴会按剩余可见系列重算）；点击触发 `lineClick`，命中数据点时带 `seriesIndex` / `value`。`valueFormatter` 同时作用于提示与图例，`labels.yFormatter` 只作用于数值轴。
+`tooltip` 默认开启，`legend` 开启后点击图例可隐藏系列并触发 `legendChange`（数值轴会按剩余可见系列重算）。默认图例只显示色块和系列名，不显示数值；`valueFormatter` 作用于默认提示与数值轴，`labels.yFormatter` 可单独覆盖数值轴。
+
+SVG 点击的 x 落在横向类目范围内才触发 `lineClick`。直接命中圆点时带该点的 `seriesIndex` / `value`；未直接命中时取对应类目中 y 距离最近的可见数据点，只有没有候选点时这两个字段才为 `null`，不是“点空白必为 null”。x 在类目范围外不触发；这不是完整二维绘图区边界判断。
 
 ```vue
 <script setup lang="ts">
@@ -19,7 +21,7 @@ import { ref } from 'vue';
 import { LineChart } from 'x-next';
 import 'x-next/dist/style.css';
 const categories = ref(['09-28', '09-29', '09-30', '10-01', '10-02']);
-// 10-01 当天缺测：null 会让折线在该处断开
+// 09-30 当天缺测：null 会让折线在该处断开
 const series = ref([
   { name: '请求量', data: [820, 932, null, 934, 1290] },
   { name: '错误数', data: [12, 18, null, 9, 22] },

package/AI_USAGE/components/message-box.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # MessageBox AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`MessageBox`；模型：无；已核对事件：未在精选映射登记事件；其他 API 见下方用法。
 

package/AI_USAGE/components/message.md

@@ -1,13 +1,13 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Message AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`Message, MessageComponent`；模型：无；已核对事件：未在精选映射登记事件；其他 API 见下方用法。
 
 按需样式：`x-next/style/message`（包含 base.css、message.css）。代码块未单独引样式时在应用入口加载全量样式，或按实际所有组件加载 JS 入口；不要仅因复制一个组件页就漏掉其中的 Button 等组合依赖。
 
-[组件文档与 live demo](https://x-next.yjmf.com/components/message)。`Message(options)` 或 `.success()` / `.error()` / `.loading()` 等显示提示。默认 `type='info'`、`duration=3000` 毫秒、`position='top'`、`showClose=false`；`duration=0` 持续显示，内容用 `message` 或 `content`。
+[组件文档与 live demo](https://x-next.yjmf.com/components/message)。`Message(options)` 或 `.success()` / `.error()` / `.loading()` 等显示提示。服务默认 `type='info'`、`duration=3000` 毫秒、`position='top'`、`showClose=false`；`duration=0` 持续显示，内容用 `message` 或 `content`。根入口的 `MessageComponent` 是模板组件，默认 `type='success'`，不要把服务默认值套给组件；需要统一效果时显式传 `type`。
 
 返回句柄只有 `close()`；同一容器和位置下再次传相同 `id` 更新消息，没有句柄 `update()`。`onClose(id?)` 在自动或手动关闭时触发；自定义内容可用 VNode / 渲染函数。页面只清理自己持有的句柄。
 

package/AI_USAGE/components/notification.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Notification AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`Notification, NotificationComponent`；模型：无；已核对事件：未在精选映射登记事件；其他 API 见下方用法。
 
@@ -9,6 +9,8 @@
 
 [组件文档与 live demo](https://x-next.yjmf.com/components/notification)。`Notification(options)` 或 `.success()` 等显示通知。服务默认 `type='info'`、`duration=3000` 毫秒、`position='top-right'`、`offset=20`、`showClose=true`；四角位置可选，`duration=0` 持续显示。
 
+根入口 `NotificationComponent` 是模板组件，默认 `offset=0`，与命令式服务不同；模板组件和服务选项按各自公开类型使用。
+
 `title` 和 `message` / `content` 是内容，`footer` / `icon` 可用 VNode 或渲染函数。返回句柄只有 `close()`；同一容器与位置下复用 `id` 更新。`onClick()` 无参数，`onClose(id?)` 接收标识；`.remove(id)` / `.clear(position?)` 是服务级方法。
 
 ```vue

package/AI_USAGE/components/pagination.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Pagination AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`Pagination`；模型：v-model:current、v-model:page-size；已核对事件：change、pageSizeChange。
 

package/AI_USAGE/components/pie-chart.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # PieChart AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`PieChart`；模型：无；已核对事件：itemClick、legendChange。
 

package/AI_USAGE/components/popconfirm.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Popconfirm AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`Popconfirm`；模型：v-model；已核对事件：ok、cancel。
 

package/AI_USAGE/components/popover.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Popover AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`Popover`；模型：v-model:popup-visible；已核对事件：popupVisibleChange。
 
@@ -9,7 +9,7 @@
 
 [组件文档与 live demo](https://x-next.yjmf.com/components/popover)。使用 `v-model:popup-visible`；默认 `trigger='click'`、`position='bottom'`、`showArrow=false`、`defaultPopupVisible=false`、`unmountOnClose=true`。默认插槽是触发器，`title` / `content` 插槽放浮层内容。
 
-`popup-visible-change(visible)` 返回布尔值，`show` / `hide` 无参数。点击触发器或外部默认可以关闭；`popupContainer` 和 `renderToBody` 决定宿主，局部主题下按实际挂载位置核对样式。
+`popup-visible-change(visible)` 返回布尔值，`show` / `hide` 无参数。点击触发器或外部默认可以关闭；`popupContainer` 和 `renderToBody` 决定宿主，用于定位、滚动及裁剪。通过 ConfigProvider 配置的主题会由 Trigger 同步到浮层根，默认挂到 body 也生效；任意业务 CSS 变量或仅在局部 DOM 调用 applyThemeColor 不等于该注入协议，仍要核对实际继承。
 
 ```vue
 <script setup lang="ts">

package/AI_USAGE/components/progress.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Progress AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`Progress`；模型：无；已核对事件：未在精选映射登记事件；其他 API 见下方用法。
 
@@ -9,7 +9,7 @@
 
 [组件文档与 live demo](https://x-next.yjmf.com/components/progress)。`percent` 为 **0 到 1** 的比例，默认 `0`，不是 0 到 100；超出范围会裁剪，非有限值显示为 0。默认 `type='line'`、`showText=true`、`animation=false`，`steps>0` 使用分段模式。
 
-无模型和业务 change 事件，由业务更新 `percent`。`status` 为 normal、success、warning、danger，未设置时达到 1 自动为 success；`text` 插槽提供 `{ percent }`。
+无模型和业务 change 事件，由业务更新 `percent`。`status` 为 `'normal' | 'success' | 'warning' | 'strong' | 'danger'`，未设置时达到 1 自动为 success；显式 status 优先，`strong` 不表示完成。`text` 插槽提供 `{ percent }`。
 
 ```vue
 <script setup lang="ts">
@@ -24,6 +24,7 @@ function advance() { percent.value = Math.min(1, percent.value + 0.25); }
     <Progress :percent="percent">
       <template #text="scope">已完成 {{ Math.round(scope.percent * 100) }}%</template>
     </Progress>
+    <Progress :percent="percent" status="strong" />
     <Button :disabled="percent >= 1" @click="advance">推进任务</Button>
   </div>
 </template>

package/AI_USAGE/components/radio.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Radio AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`Radio`；模型：v-model；已核对事件：change。
 

package/AI_USAGE/components/rate.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Rate AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`Rate`；模型：v-model；已核对事件：change。
 

package/AI_USAGE/components/select.md

@@ -1,13 +1,13 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Select AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`Select`；模型：v-model、v-model:popup-visible；已核对事件：change、popupVisibleChange。
 
 按需样式：`x-next/style/form-select`（包含 base.css、empty.css、form-checkbox.css、form-select.css、scrollbar-v2.css、spin.css、trigger.css）。代码块未单独引样式时在应用入口加载全量样式，或按实际所有组件加载 JS 入口；不要仅因复制一个组件页就漏掉其中的 Button 等组合依赖。
 
-[组件文档与 live demo](https://x-next.yjmf.com/components/select)。`v-model` 返回选项的 `value`；单选通常为标量，多选为数组，也支持对象值。`multiple=false`、`allowClear=false`；单选搜索默认关闭，多选默认开启。`options` 使用可变数组，常用字段是 `label`、`value`、`disabled`。
+[组件文档与 live demo](https://x-next.yjmf.com/components/select)。`v-model` 返回选项的 `value`；单选通常为标量，多选为数组，也支持对象值。`multiple=false`、`allowClear=false`；单选搜索默认关闭，多选默认开启。`options` 是选项对象数组，常用字段是 `label`、`value`、`disabled`。静态数组可直接传入；动态选项用 `ref` / `reactive` 等响应式状态更新，支持替换数组，不要求原地修改；公开类型不接受 readonly 数组时先复制成普通数组。
 
 `change(value)` 返回新值，`clear(event)` 返回 `Event`；单选清空通常为 `''`，多选为 `[]`，已选禁用项可能保留。`v-model:popup-visible` 控制弹层，`option` / `empty` / `header` / `footer` 等插槽见组件文档。
 

package/AI_USAGE/components/slider.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Slider AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`Slider`；模型：v-model；已核对事件：change。
 

package/AI_USAGE/components/steps.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Steps AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`Steps`；模型：v-model:current；已核对事件：change。
 

package/AI_USAGE/components/switch.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Switch AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`Switch`；模型：v-model；已核对事件：change。
 
@@ -9,7 +9,7 @@
 
 [组件文档与 live demo](https://x-next.yjmf.com/components/switch)。普通 `v-model` 支持 `boolean | string | number`；`checkedValue=true`、`uncheckedValue=false`、`defaultChecked=false`，默认 `type='circle'`。`disabled` / `loading` 阻止切换。
 
-`change(value, event)` 返回新值和 `Event`；`beforeChange(newValue)` 可返回布尔值或 Promise，`false` 或拒绝阻止切换。`checked` / `unchecked` 插槽及 `checkedText` / `uncheckedText` 显示两态文案，line 类型不显示文案。
+`change(value, event)` 返回新值和 `Event`；`beforeChange(newValue)` 可返回布尔值或 Promise，`false` 或拒绝阻止切换。`checked` / `unchecked` 插槽及 `checkedText` / `uncheckedText` 显示两态文案；`type='line'` 或有效尺寸为 `'mini'`（含继承尺寸）时均不显示文案。
 
 ```vue
 <script setup lang="ts">

package/AI_USAGE/components/tabs.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Tabs AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`Tabs`；模型：v-model:active-key；已核对事件：change。
 

package/AI_USAGE/components/textarea.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Textarea AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`Textarea`；模型：v-model；已核对事件：input、change、clear。
 

package/AI_USAGE/components/time-picker.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # TimePicker AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`TimePicker`；模型：v-model、v-model:popup-visible；已核对事件：change。
 
@@ -9,7 +9,7 @@
 
 [组件文档与 live demo](https://x-next.yjmf.com/components/time-picker)。默认 `type='time'`、`allowClear=true`、`disableConfirm=false`，默认格式为 `'HH:mm:ss'`。`format` 同时决定显示与输出；`step` 用 `{ hour, minute, second }`，各步长默认 `1`。
 
-`change(timeString, time)` 是确认值变化，`select` 是面板选择；字符串载荷为 `string | (string | undefined)[] | undefined`，第二参数为 `unknown`。清空归一化为 `''`；支持 `prefix` / `suffix-icon` / `extra` 插槽及 `disabledHours` 等限制。
+`change(timeString, time)` 是确认值变化，`select` 是面板选择；字符串载荷为 `string | (string | undefined)[] | undefined`，第二参数为 `unknown`。清空发出 `update:modelValue(undefined)` 和 `change(undefined, undefined)`；本例的业务 `update()` 才归一化为 `''` 保持单值字符串受控。支持 `prefix` / `suffix-icon` / `extra` 插槽及 `disabledHours` 等限制。
 
 ```vue
 <script setup lang="ts">

package/AI_USAGE/components/upload.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Upload AI 使用
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 先读 [通用接入](../core.md)。公开导出：`Upload`；模型：v-model:file-list；已核对事件：change、success、error、remove、exceed、reject、progress。
 
@@ -9,9 +9,9 @@
 
 [组件文档与 live demo](https://x-next.yjmf.com/components/upload)。`action` 是上传地址，也可用 `customRequest` 接管请求；两者都没提供时组件不会发起上传。`name` 是 FormData 字段名，默认 `'file'`；`method` 默认 `'post'`，`withCredentials` 默认 `false`。
 
-**接入已有上传方法的推荐写法**：`customRequest` 返回 Promise 时组件自动接管状态，resolve 即成功（结果写入 `file.response`，可用 `responseUrlKey` 提取 url，字符串支持 `data.url` 嵌套路径）、reject 即失败并出现重试入口，无需手动调用 `onSuccess` / `onError`。axios、flyio、fetch 或任何返回 Promise 的方法都适用。返回值是 fetch `Response` 时组件读取响应体；非 2xx 按失败处理，`error.status` 为状态码。需要进度与取消时，把 option 的 `signal`（取消 / 移除 / 卸载时触发）与 `onProgress`（0 ~ 1）透传给底层请求。返回 `{ abort }` 并手动回调的旧写法仍然支持。
+**接入已有上传方法的推荐写法**：`customRequest` 返回 Promise 时组件自动接管状态，通常 resolve 成功（结果写入 `file.response`，可用 `responseUrlKey` 提取 url，字符串支持 `data.url` 嵌套路径）、reject 失败并出现重试入口，无需手动调用 `onSuccess` / `onError`。axios、flyio、fetch 或任何返回 Promise 的方法都适用。fetch `Response` 为非 2xx 时，即使 Promise resolve 也按失败处理，`error.status` 为状态码；成功响应仅对 JSON/text 内容类型解析，二进制等其他类型保留 Response 本体，不自动转为 Blob。需要进度与取消时，把 option 的 `signal`（取消 / 移除 / 卸载时触发）与 `onProgress`（0 ~ 1）透传给底层请求。返回 `{ abort }` 并手动回调的旧写法仍然支持。
 
-列表默认非受控，用 `defaultFileList` 给初值；需要外部驱动时用 `v-model:file-list`，列表项以 `uid` 为稳定标识。`listType` 取 `'text' | 'picture' | 'picture-card'`。`limit` 为数量上限，超出会触发 `exceed`，超出部分不进入列表；`beforeUpload` 返回 `false` 拦截、返回新 `File` 替换，支持 Promise。
+列表默认非受控，用 `defaultFileList` 给初值；需要外部驱动时用 `v-model:file-list`，列表项以 `uid` 为稳定标识。`listType` 取 `'text' | 'picture' | 'picture-card'`。`limit` 为数量上限，超出会触发 `exceed`，超出部分不进入列表。`beforeUpload` 返回 `false`、抛错或 Promise reject 都会拒绝入列并触发 `reject`；返回 `File` 替换文件，返回 `Blob` / string 则用原文件名生成新 File。string 是文件内容而非下载 URL；以上返回形式支持 Promise。
 
 `change({ file, fileList })` 覆盖加入、进度、成功、失败和移除；`success` / `error` / `remove` / `progress` 是更细粒度的补充。`autoUpload=false` 时文件先以 `init` 入列，再用组件 `submit()` 上传、`abort()` 取消、`retry()` 重试。图片卡场景可加 `image-preview` 用内置 `ImagePreview` 看图。
 

package/AI_USAGE/core.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # x-next AI 通用接入
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 ```sh
 npm install x-next
@@ -22,7 +22,7 @@ createApp(App).mount('#app');
 接入时遵循这些约定：
 
 - **按组件路由传原生属性**：Checkbox / Select 用已核实的 `id/name/aria-*` 属性对象 `v-bind`；Input 用 `inputAttrs`，Textarea 用 `textareaAttrs`。Textarea 的 readonly 也放在 `textareaAttrs` 中。组件 props 和事件直接绑定，不把未知组件 API 塞进 attrs。
-- **保持受控值稳定**：`v-model` 要初始化为明确的布尔值、字符串、数字或数组。非受控初始化用 `defaultValue` / `defaultChecked`；把受控值改成 `undefined` 可能切换到内部状态。清空日期、时间统一保存 `''`。
+- **保持受控值稳定**：`v-model` 要初始化为明确的布尔值、字符串、数字或数组。非受控初始化用组件实际支持的 `defaultValue` / `defaultChecked`；把受控值改成 `undefined` 可能切换到内部状态。DatePicker / TimePicker 清空实际发出 `undefined`，下方单值字符串示例在业务回调中保存 `''` 以保持受控；这不是组件自动归一化，也不能直接套用于范围模型。
 - **选择正确的弹层宿主**：Select、DatePicker、TimePicker、Popover、Dropdown 用 `popupContainer`；Dialog、Message、MessageBox、Notification、Popconfirm 用 `renderTo`。容器须已挂载；局部容器要留意定位、滚动和裁剪。ConfigProvider 的主题会同步到 Trigger 浮层及组件形态 Dialog / Drawer；单独调用 applyThemeColor 或独立创建命令式实例时，仍需按实际 DOM 宿主处理主题。
 - **优先用公开主题变量**：参考[样式与主题](https://x-next.yjmf.com/guide/theme)。暗色容器上的 alias 链会重新声明；`themeColor` 写入的内联 primary alias 有覆盖边界，按主题文档设置相关公开 alias。
 - **约束业务全局 CSS**：reset 用 `:where(...)` 降低优先级并限定作用域；宽泛的原生元素选择器可能覆盖组件样式。自定义内容用插槽和公开属性，不依赖内部结构类名。

package/AI_USAGE/index.md

@@ -1,7 +1,7 @@
-<!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/. -->
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # x-next AI 按需入口
 
-适用版本：x-next@1.11.0；来源指纹：`eec9ec4e05970a1f3325c873b8858e1fcb84282fa4c09d4eda8d5044c833f82a`。
+适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
 
 AI 专用资料，与文档站独立分发。先读 [core.md](./core.md)，再只读本任务需要的组件页；每页提供真实约束、公共导出、模型/事件/样式和完整 Vue SFC。代码与同版本完整手册同源并严格检查；本索引不塞入完整示例。