x-next 1.11.1 → 1.13.0

package/AI_USAGE/catalog.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # 公开组件与服务导航
 
-适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
+适用版本：x-next@1.13.0；来源指纹：`18e9b8eefa53b4bd91134fb4486778509ccf3a8d614a1bd387a6d469b623ddcf`。
 
 从当前构建的根公共声明生成，包含 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 script/ai-usage/content.md and script/ai-usage/. -->
 # Alert AI 使用
 
-适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
+适用版本：x-next@1.13.0；来源指纹：`18e9b8eefa53b4bd91134fb4486778509ccf3a8d614a1bd387a6d469b623ddcf`。
 
 先读 [通用接入](../core.md)。公开导出：`Alert`；模型：v-model:visible；已核对事件：close。
 

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.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
+适用版本：x-next@1.13.0；来源指纹：`18e9b8eefa53b4bd91134fb4486778509ccf3a8d614a1bd387a6d469b623ddcf`。
 
 先读 [通用接入](../core.md)。公开导出：`BarChart`；模型：无；已核对事件：barClick、legendChange。
 

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.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
+适用版本：x-next@1.13.0；来源指纹：`18e9b8eefa53b4bd91134fb4486778509ccf3a8d614a1bd387a6d469b623ddcf`。
 
 先读 [通用接入](../core.md)。公开导出：`Button`；模型：无；已核对事件：click。
 

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.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
+适用版本：x-next@1.13.0；来源指纹：`18e9b8eefa53b4bd91134fb4486778509ccf3a8d614a1bd387a6d469b623ddcf`。
 
 先读 [通用接入](../core.md)。公开导出：`Checkbox`；模型：v-model；已核对事件：change。
 

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.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
+适用版本：x-next@1.13.0；来源指纹：`18e9b8eefa53b4bd91134fb4486778509ccf3a8d614a1bd387a6d469b623ddcf`。
 
 先读 [通用接入](../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 script/ai-usage/content.md and script/ai-usage/. -->
 # ConfigProvider AI 使用
 
-适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
+适用版本：x-next@1.13.0；来源指纹：`18e9b8eefa53b4bd91134fb4486778509ccf3a8d614a1bd387a6d469b623ddcf`。
 
 先读 [通用接入](../core.md)。公开导出：`ConfigProvider`；模型：无；已核对事件：未在精选映射登记事件；其他 API 见下方用法。
 

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.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
+适用版本：x-next@1.13.0；来源指纹：`18e9b8eefa53b4bd91134fb4486778509ccf3a8d614a1bd387a6d469b623ddcf`。
 
 先读 [通用接入](../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 script/ai-usage/content.md and script/ai-usage/. -->
 # Dialog AI 使用
 
-适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
+适用版本：x-next@1.13.0；来源指纹：`18e9b8eefa53b4bd91134fb4486778509ccf3a8d614a1bd387a6d469b623ddcf`。
 
 先读 [通用接入](../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 script/ai-usage/content.md and script/ai-usage/. -->
 # Dropdown AI 使用
 
-适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
+适用版本：x-next@1.13.0；来源指纹：`18e9b8eefa53b4bd91134fb4486778509ccf3a8d614a1bd387a6d469b623ddcf`。
 
 先读 [通用接入](../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 script/ai-usage/content.md and script/ai-usage/. -->
 # Empty AI 使用
 
-适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
+适用版本：x-next@1.13.0；来源指纹：`18e9b8eefa53b4bd91134fb4486778509ccf3a8d614a1bd387a6d469b623ddcf`。
 
 先读 [通用接入](../core.md)。公开导出：`Empty`；模型：无；已核对事件：未在精选映射登记事件；其他 API 见下方用法。
 

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.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
+适用版本：x-next@1.13.0；来源指纹：`18e9b8eefa53b4bd91134fb4486778509ccf3a8d614a1bd387a6d469b623ddcf`。
 
 先读 [通用接入](../core.md)。公开导出：`Input`；模型：v-model；已核对事件：input、change、clear。
 

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.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
+适用版本：x-next@1.13.0；来源指纹：`18e9b8eefa53b4bd91134fb4486778509ccf3a8d614a1bd387a6d469b623ddcf`。
 
 先读 [通用接入](../core.md)。公开导出：`LineChart`；模型：无；已核对事件：lineClick、legendChange。
 

package/AI_USAGE/components/message-box.md

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

package/AI_USAGE/components/message.md

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

package/AI_USAGE/components/notification.md

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

package/AI_USAGE/components/pagination.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Pagination AI 使用
 
-适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
+适用版本：x-next@1.13.0；来源指纹：`18e9b8eefa53b4bd91134fb4486778509ccf3a8d614a1bd387a6d469b623ddcf`。
 
 先读 [通用接入](../core.md)。公开导出：`Pagination`；模型：v-model:current、v-model:page-size；已核对事件：change、pageSizeChange。
 
@@ -9,7 +9,11 @@
 
 [组件文档与 live demo](https://x-next.yjmf.com/components/pagination)。`total` 必填且表示记录总数。使用 `v-model:current` 和 `v-model:page-size`；默认非受控值为页码 `1`、每页 `10`，`showTotal` / `showPageSize` / `showJumper` 默认关闭，`autoAdjust=true`。
 
-`change(current)` 和 `page-size-change(pageSize)` 各返回一个数字；不会请求数据。页码按总数裁剪，每页条数应为正数。`total` 插槽提供总数，`page-item` 提供页码；改变条数后的业务重新查询需自行实现。
+`change(current)` 和 `page-size-change(pageSize)` 各返回一个数字；不会请求数据。页码按总数裁剪并取整，每页条数必须为正安全整数；非法值回退到有效 `defaultPageSize` 或 10。`total=0` 保留第 1 页，开启 `hideOnSinglePage` 可隐藏整个分页。`total` 插槽提供总数，`page-item` 提供页码；改变条数后的业务重新查询需自行实现。
+
+默认 `autoAdjust=true`：改变条数时保留旧页第一条记录所在页，再裁剪到新总页数；总页数减少时修正越界页码。业务在同一批更新中主动改变 `current` 时优先使用业务值。下面示例主动返回第一页并关闭自动调整，这是业务适配，不是组件默认行为。受控组件只在父级接受更新后显示新状态；simple 输入清空或父级拒绝提交时恢复实际当前页，普通 jumper 提交后清空。
+
+`pageSizeProps` 只提供 Select 附加能力，例如搜索、加载、弹层、标签格式化；分页维护 `modelValue/options/size/disabled/multiple/allowClear/allowCreate/fieldNames`，不支持多选、清空或创建条数。`pageSizeOptions` 过滤非法值并去重排序、并入当前条数。分页没有记录 loading prop，业务加载时可绑定 `disabled`；选择器的 `pageSizeProps.loading` 只表示选择器加载。
 
 ```vue
 <script setup lang="ts">
@@ -24,7 +28,7 @@ function resized(size: number) { current.value = 1; feedback.value = `每页 ${s
 </script>
 <template>
   <Pagination v-model:current="current" v-model:page-size="pageSize" :total="95" show-total show-page-size
-    :page-size-options="[10, 20, 50]" @change="changed" @page-size-change="resized" />
+    :auto-adjust="false" :page-size-options="[10, 20, 50]" @change="changed" @page-size-change="resized" />
   <p role="status">{{ feedback }}；每页 {{ pageSize }} 条</p>
 </template>
 ```

package/AI_USAGE/components/pie-chart.md

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

package/AI_USAGE/components/popconfirm.md

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

package/AI_USAGE/components/popover.md

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

package/AI_USAGE/components/progress.md

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

package/AI_USAGE/components/radio.md

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

package/AI_USAGE/components/rate.md

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

package/AI_USAGE/components/select.md

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

package/AI_USAGE/components/slider.md

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

package/AI_USAGE/components/steps.md

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

package/AI_USAGE/components/switch.md

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

package/AI_USAGE/components/tabs.md

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

package/AI_USAGE/components/upload.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Upload AI 使用
 
-适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
+适用版本：x-next@1.13.0；来源指纹：`18e9b8eefa53b4bd91134fb4486778509ccf3a8d614a1bd387a6d469b623ddcf`。
 
 先读 [通用接入](../core.md)。公开导出：`Upload`；模型：v-model:file-list；已核对事件：change、success、error、remove、exceed、reject、progress。
 

package/AI_USAGE/core.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # x-next AI 通用接入
 
-适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
+适用版本：x-next@1.13.0；来源指纹：`18e9b8eefa53b4bd91134fb4486778509ccf3a8d614a1bd387a6d469b623ddcf`。
 
 ```sh
 npm install x-next

package/AI_USAGE/index.md

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

package/AI_USAGE/recipes/form-on-demand.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # 按需样式与表单接入
 
-适用版本：x-next@1.11.1；来源指纹：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
+适用版本：x-next@1.13.0；来源指纹：`18e9b8eefa53b4bd91134fb4486778509ccf3a8d614a1bd387a6d469b623ddcf`。
 
 先读 [通用接入](../core.md)，相关组件规则：[config-provider](../components/config-provider.md)、[input](../components/input.md)、[textarea](../components/textarea.md)、[select](../components/select.md)、[checkbox](../components/checkbox.md)。
 

package/AI_USAGE.md

@@ -1,9 +1,9 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/manifest.js. -->
 # x-next AI 使用手册
 
-适用版本：**x-next@1.11.1**。Vue：`^3.5.0`；Node：`>=20.19.0`。
+适用版本：**x-next@1.13.0**。Vue：`^3.5.0`；Node：`>=20.19.0`。
 
-来源指纹（精选示例、映射、样式依赖、版本与公开类型声明）：`ad9d8731c632355a30f4f53643b1e2bcd861a36f1ed67631339334be1eda0b76`。
+来源指纹（精选示例、映射、样式依赖、版本与公开类型声明）：`18e9b8eefa53b4bd91134fb4486778509ccf3a8d614a1bd387a6d469b623ddcf`。
 
 本手册覆盖 30 个常用组件与服务；包内还有更多导出可用，只是未在此逐个展开。按业务需要选择即可，不必全部使用。
 
@@ -731,7 +731,11 @@ function select(value: unknown, _event: Event) {
 
 [组件文档与 live demo](https://x-next.yjmf.com/components/pagination)。`total` 必填且表示记录总数。使用 `v-model:current` 和 `v-model:page-size`；默认非受控值为页码 `1`、每页 `10`，`showTotal` / `showPageSize` / `showJumper` 默认关闭，`autoAdjust=true`。
 
-`change(current)` 和 `page-size-change(pageSize)` 各返回一个数字；不会请求数据。页码按总数裁剪，每页条数应为正数。`total` 插槽提供总数，`page-item` 提供页码；改变条数后的业务重新查询需自行实现。
+`change(current)` 和 `page-size-change(pageSize)` 各返回一个数字；不会请求数据。页码按总数裁剪并取整，每页条数必须为正安全整数；非法值回退到有效 `defaultPageSize` 或 10。`total=0` 保留第 1 页，开启 `hideOnSinglePage` 可隐藏整个分页。`total` 插槽提供总数，`page-item` 提供页码；改变条数后的业务重新查询需自行实现。
+
+默认 `autoAdjust=true`：改变条数时保留旧页第一条记录所在页，再裁剪到新总页数；总页数减少时修正越界页码。业务在同一批更新中主动改变 `current` 时优先使用业务值。下面示例主动返回第一页并关闭自动调整，这是业务适配，不是组件默认行为。受控组件只在父级接受更新后显示新状态；simple 输入清空或父级拒绝提交时恢复实际当前页，普通 jumper 提交后清空。
+
+`pageSizeProps` 只提供 Select 附加能力，例如搜索、加载、弹层、标签格式化；分页维护 `modelValue/options/size/disabled/multiple/allowClear/allowCreate/fieldNames`，不支持多选、清空或创建条数。`pageSizeOptions` 过滤非法值并去重排序、并入当前条数。分页没有记录 loading prop，业务加载时可绑定 `disabled`；选择器的 `pageSizeProps.loading` 只表示选择器加载。
 
 ```vue
 <script setup lang="ts">
@@ -746,7 +750,7 @@ function resized(size: number) { current.value = 1; feedback.value = `每页 ${s
 </script>
 <template>
   <Pagination v-model:current="current" v-model:page-size="pageSize" :total="95" show-total show-page-size
-    :page-size-options="[10, 20, 50]" @change="changed" @page-size-change="resized" />
+    :auto-adjust="false" :page-size-options="[10, 20, 50]" @change="changed" @page-size-change="resized" />
   <p role="status">{{ feedback }}；每页 {{ pageSize }} 条</p>
 </template>
 ```

package/CHANGELOG.md

@@ -2,6 +2,46 @@
 
 本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [Unreleased]
+
+## [1.13.0] - 2026-10-07
+
+### 新增
+
+- Network 导出 `NetworkSize` / `NetworkSlotProps`，补齐严格插槽类型、状态播报、颜色、模式切换和真实刷新示例。
+- Pagination 补齐本地化控件名称、窄屏换行与页码滚动；组件文档扩充为 14 组可交互示例及完整 SFC。
+
+### 修复
+
+- Button 统一五档尺寸和圆角，补齐 square 形状、link 布局及状态色、无边框状态、键盘焦点和减少动效；纯图标与圆形加载保持居中，单按钮组保留外侧圆角。
+- Button 的 mini / small 使用紧凑行高，huge 调整为 38px / 16px / 500 字重；补齐对应 live demo、完整 SFC 和样式行为回归。
+- Select 多选 option 增加与单选共用的最小高度，默认均为 36px，避免内嵌 Checkbox 的较小文字行高导致选项、选中背景与点击区域收缩；保留文字与复选框垂直居中，自定义内容仍可自然撑高。
+- Network 修复离线事件被旧探测吞掉、过期请求回写、降级监听恢复、模式切换漏报、超时与下载指标计算；恢复 offline / unknown 自定义颜色，避免紧凑尺寸指标重叠。
+- Pagination 修复条数变化与总页数缩减时的重复/错误调整、跳转提交清空、非法配置、条数 Select 协议、活动页样式合并与键盘焦点丢失；提高亮暗主题当前页和焦点对比。
+- Pagination 焦点圈空间计入正常布局，修复 Table 内嵌单页分页出现多余横向和纵向滚动条；上一页/下一页统一为公开 chevron 图标，四档图标尺寸调整为 16 / 18 / 20 / 22px。
+
+### 工程与验证
+
+- 扩充 Network / Pagination 行为回归、颜色门禁与发布包真实浏览器消费检查，覆盖 Table 内嵌分页、传统滚动条、亮暗主题及窄屏；重新生成并校验随包 AI 手册。
+
+## [1.12.0] - 2026-10-07
+
+### 新增
+
+- Table 支持按 `sortable.sortPriority` 配置多列排序，并在 `change` 的 `extra.sorters` 中报告全部条件；未声明优先级的列继续使用单列排序。
+- Table 新增可选 `keyboardNavigation`，支持方向键、Home / End 和虚拟窗口导航；拖拽手柄支持 Alt + 方向键移动及触屏拖动。
+- 虚拟列表持续测量动态行高，异步详情变化后自动更新滚动范围；补齐 Table 排序、键盘、动态高度与组合场景 live demo 和完整 SFC。
+
+### 修复
+
+- Table 默认加载动画统一为标准主题色圆环，默认主题下为蓝色；保留对象形式的 Spin 自定义配置，并提供可切换加载态的文档示例。
+- Table 默认展开 / 收起图标统一为标准 Plus / Minus；修复筛选、排序、分页拖拽、树选择、懒加载、合并单元格及受控状态的审查问题。
+- 修复固定列和多层表头对齐、吸顶、虚拟滚动、总结行、选中背景与数字滚动高度；补齐内部 DOM 事件类型与无障碍交互。
+
+### 工程与验证
+
+- 补充 Table 与动态虚拟行高回归，更新审查记录；随版本重新生成并校验 AI 手册。
+
 ## [1.11.1] - 2026-10-07
 
 ### 修复

package/dist/components/network/Network.vue.d.ts

@@ -1,11 +1,12 @@
-import { PropType } from 'vue';
-import { NetworkSize } from './props';
+import { PropType, SlotsType } from 'vue';
+import { NetworkSize, NetworkSlotProps } from './props';
 import { NetworkQuality, NetworkStatus } from './utils.ts';
 type StatusColorMap = Partial<Record<NetworkQuality, string>>;
 declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
     size: {
         type: PropType<NetworkSize>;
         default: string;
+        validator: (value: string) => boolean;
     };
     /**
      * @zh 兼容旧版强/弱信号颜色配置
@@ -98,6 +99,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     size: {
         type: PropType<NetworkSize>;
         default: string;
+        validator: (value: string) => boolean;
     };
     /**
      * @zh 兼容旧版强/弱信号颜色配置
@@ -168,11 +170,13 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     onProbe?: ((status: NetworkStatus) => any) | undefined;
 }>, {
     size: NetworkSize;
-    ariaLive: "off" | "polite" | "assertive";
     showTooltip: boolean;
     showMetrics: boolean;
     signalStrengthColor: [string, string];
     statusColors: Partial<Record<NetworkQuality, string>>;
     timeout: number;
-}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+    ariaLive: "off" | "polite" | "assertive";
+}, SlotsType<{
+    default: NetworkSlotProps;
+}>, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 export default _default;

package/dist/components/network/index.d.ts

@@ -3,6 +3,7 @@ export declare const Network: {
         size: {
             type: import('vue').PropType<import('./props').NetworkSize>;
             default: string;
+            validator: (value: string) => boolean;
         };
         signalStrengthColor: {
             type: import('vue').PropType<[string, string]>;
@@ -68,13 +69,15 @@ export declare const Network: {
         probe: (status: import('./utils').NetworkStatus) => true;
     }, import('vue').PublicProps, {
         size: import('./props').NetworkSize;
-        ariaLive: "off" | "polite" | "assertive";
         showTooltip: boolean;
         showMetrics: boolean;
         signalStrengthColor: [string, string];
         statusColors: Partial<Record<import('./utils').NetworkQuality, string>>;
         timeout: number;
-    }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
+        ariaLive: "off" | "polite" | "assertive";
+    }, true, {}, import('vue').SlotsType<{
+        default: import('./props').NetworkSlotProps;
+    }>, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
         P: {};
         B: {};
         D: {};
@@ -85,6 +88,7 @@ export declare const Network: {
         size: {
             type: import('vue').PropType<import('./props').NetworkSize>;
             default: string;
+            validator: (value: string) => boolean;
         };
         signalStrengthColor: {
             type: import('vue').PropType<[string, string]>;
@@ -145,12 +149,12 @@ export declare const Network: {
         refresh: () => Promise<import('./utils').NetworkStatus>;
     }, {}, {}, {}, {
         size: import('./props').NetworkSize;
-        ariaLive: "off" | "polite" | "assertive";
         showTooltip: boolean;
         showMetrics: boolean;
         signalStrengthColor: [string, string];
         statusColors: Partial<Record<import('./utils').NetworkQuality, string>>;
         timeout: number;
+        ariaLive: "off" | "polite" | "assertive";
     }>;
     __isFragment?: never;
     __isTeleport?: never;
@@ -159,6 +163,7 @@ export declare const Network: {
     size: {
         type: import('vue').PropType<import('./props').NetworkSize>;
         default: string;
+        validator: (value: string) => boolean;
     };
     signalStrengthColor: {
         type: import('vue').PropType<[string, string]>;
@@ -224,14 +229,17 @@ export declare const Network: {
     probe: (status: import('./utils').NetworkStatus) => true;
 }, string, {
     size: import('./props').NetworkSize;
-    ariaLive: "off" | "polite" | "assertive";
     showTooltip: boolean;
     showMetrics: boolean;
     signalStrengthColor: [string, string];
     statusColors: Partial<Record<import('./utils').NetworkQuality, string>>;
     timeout: number;
-}, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & {
+    ariaLive: "off" | "polite" | "assertive";
+}, {}, string, import('vue').SlotsType<{
+    default: import('./props').NetworkSlotProps;
+}>, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & {
     install(app: import('vue').App): void;
 };
+export type { NetworkSize, NetworkSlotProps } from './props';
 export type { NetworkEventListenerCallback, NetworkOptions, NetworkQuality, NetworkStatus, NetworkStatusReason, NetworkStatusSource, } from './utils';
 export { Network as default };

package/dist/components/network/props.d.ts

@@ -1 +1,6 @@
+import { NetworkStatus } from './utils';
 export type NetworkSize = 'mini' | 'small' | 'medium' | 'large';
+export interface NetworkSlotProps extends Pick<NetworkStatus, 'quality' | 'online' | 'latency' | 'downloadSpeed' | 'speedSource' | 'source' | 'reason'> {
+    status: NetworkStatus;
+    refresh: () => Promise<NetworkStatus>;
+}

package/dist/components/network/utils.d.ts

@@ -25,10 +25,9 @@ export declare class Network {
     private options;
     private timer;
     private initialTimer;
-    private connection;
-    /** 不支持 addEventListener 时保存 connection.onchange 的原处理器，销毁时归还 */
-    private previousConnectionOnChange;
+    private unsubscribeConnection;
     private controller;
+    private cancelProbe;
     private destroyed;
     private pendingRefresh;
     private sequence;
@@ -38,6 +37,7 @@ export declare class Network {
     checkNetworkQuality(): NetworkQuality;
     getSnapshot(): NetworkStatus;
     refresh(reason?: NetworkStatusReason): Promise<NetworkStatus>;
+    private refreshAfterBrowserChange;
     private resolveStatus;
     private pingNetworkQuality;
     private boot;

package/dist/components/pagination/page-item-ellipsis.vue.d.ts

@@ -23,8 +23,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         modifier: (className: string) => string;
         is: (className: string) => string;
     };
-    cls: import('vue').ComputedRef<string[]>;
+    cls: import('vue').ComputedRef<(string | {
+        [x: string]: boolean;
+    })[]>;
     nextPage: import('vue').ComputedRef<number>;
+    mergedDisabled: import('vue').ComputedRef<boolean>;
     handleClick: (e: MouseEvent | KeyboardEvent) => void;
     handleKeyDown: (e: KeyboardEvent) => void;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, "click"[], "click", import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{