@taocompany/magic-grid 0.12.2 → 0.12.3

package/dist/token-catalog.json

@@ -1,6 +1,6 @@
 {
-  "schemaVersion": "0.12.2",
-  "generatedAt": "2026-10-21T06:34:49.495Z",
+  "schemaVersion": "0.12.3",
+  "generatedAt": "2026-10-21T08:12:11.945Z",
   "entries": [
     {
       "token": "--mg-color-bg",

package/dist/types/core.d.ts

@@ -2165,12 +2165,15 @@ export declare interface GridApi extends RowMutationGridApi {
      * 解析函数见 `DefaultSelectedRowsResolverContext`（含 `targets` / `internalRowId`）。
      * @param options.mode 默认 cover：选中当前已存在的全部目标 id；merge：与现有选区并集
      *
-     * 选区变化时 emit `selectionChanged`。
+     * 选区变化时 emit `selectionChanged`，payload **`from: 'preset'`**。
      */
     setDefaultSelectedRows(input: DefaultSelectedRowsInput, options?: ApplyDefaultSelectedRowsOptions): void;
     /** 清除待满足的 preset（如移除 `default-selected-rows` prop 时） */
     clearPendingDefaultSelectedRows(): void;
-    /** 按当前 pending preset 对 row model 再 reconcile（不修改 pending） */
+    /**
+     * 按当前 pending 再 reconcile（不修改 pending）。
+     * `data-rendered` 等路径会调用；若有推迟的 transient preset 通知则补发 `selectionChanged`（`from: 'preset'`）。
+     */
     reconcileDefaultSelectedRows(): void;
     /** 读取当前 checkbox 选中的业务 id（与 `data[rowKey]` 一致；临时行均为 `null`） */
     getSelectedRowIds(): BusinessRowId[];
@@ -4347,6 +4350,15 @@ export declare interface SelectableParams {
     isTransient: boolean;
 }
 
+export declare interface SelectionChangedEvent<TData = RowData> {
+    /** 当前选中的业务 row id（临时行为 null；不可单独用于删除临时行） */
+    selectedRowIds: BusinessRowId[];
+    /** 当前选中的完整行快照（含 internalRowId；推荐用于删除与展示） */
+    selectedRows: RowSnapshot<TData>[];
+    /** preset reconcile 来源；省略表示常规选区变更 */
+    from?: SelectionChangedFrom;
+}
+
 /**
  * 行选择列 checkbox 选中集变化时触发。MagicGrid：`@selection-changed`。
  *
@@ -4359,13 +4371,13 @@ export declare interface SelectableParams {
  *
  * 删除：`api.removeSelectedRows()` 或
  * `api.removeRows({ rowIds: generateSelectedRowIds(selectedRows) })`。
+ *
+ * ## `from`
+ *
+ * - 省略：用户交互或其它 API（如 `toggleRowSelection`）导致的选区变更。
+ * - `'preset'`：pending reconcile / promote 迁移；同一同步栈 microtask 合并；含未 promote 行时可能推迟 emit。
  */
-export declare interface SelectionChangedEvent<TData = RowData> {
-    /** 当前选中的业务 row id（临时行为 null；不可单独用于删除临时行） */
-    selectedRowIds: BusinessRowId[];
-    /** 当前选中的完整行快照（含 internalRowId；推荐用于删除与展示） */
-    selectedRows: RowSnapshot<TData>[];
-}
+declare type SelectionChangedFrom = 'preset';
 
 /** 行选择列配置 */
 export declare interface SelectionColumnOptions {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taocompany/magic-grid",
-  "version": "0.12.2",
+  "version": "0.12.3",
   "description": "A high-performance virtual table component library for Vue 3",
   "type": "module",
   "license": "MIT",