@canvas-components/list-table 0.3.30 → 0.3.32

package/dist/index.cjs

@@ -24371,7 +24371,8 @@ function resolveExpandedRowHeight2(height, record, index) {
 // src/services/layout-service.ts
 var AUTO_ROW_HEIGHT_SAMPLE_COUNT = 200;
 function buildListTableRenderSnapshot(params) {
-  if (params.cache?.snapshot && params.cache.snapshot.groupIndex === params.cache.groupIndex && isSameRenderCacheInputs(params.cache.inputs, params)) {
+  if (params.cache?.snapshot && // 动画结束后的首帧必须重建，清除上一帧的位移、拖拽残影及插入线。
+  !params.cache.snapshot.swapAnimation && params.cache.snapshot.groupIndex === params.cache.groupIndex && isSameRenderCacheInputs(params.cache.inputs, params)) {
     const snapshotStartedAt2 = resolvePerformanceNow3();
     const cached = params.cache.snapshot;
     const snapshot2 = !cached.swapAnimation && cached.scroll.left === params.scroll.left && cached.scroll.top === params.scroll.top ? cached : updateListTableRenderSnapshotScroll({
@@ -30789,7 +30790,7 @@ var ListTableEventController = class {
         this.host.updateTooltip(result);
         return;
       }
-      if ((event.shiftKey || toggleColumn) && (result.area === "body" || result.area === "body-content") && typeof result.rowIndex === "number" && result.columnKey && !isSystemColumnKey(result.columnKey)) {
+      if ((event.shiftKey || toggleColumn) && (result.area === "body" || result.area === "body-content") && !(event.shiftKey && !toggleColumn && this.host.options.rowSelection?.selectRowByClick && this.host.options.rowSelection.type !== "radio") && typeof result.rowIndex === "number" && result.columnKey && !isSystemColumnKey(result.columnKey)) {
         const columnIndex = this.host.leafColumns.findIndex(
           (column) => column.key === result.columnKey
         );
@@ -30935,7 +30936,7 @@ var ListTableEventController = class {
       if ((result.area === "body-control" || result.area === "body") && result.columnKey === ROW_SELECTION_COLUMN_KEY && typeof result.rowIndex === "number") {
         const record = this.resolveBodyRecord(result.rowIndex);
         if (record) {
-          this.host.toggleRowSelection(record, result.rowIndex);
+          this.host.toggleRowSelection(record, result.rowIndex, event.shiftKey);
         }
         return;
       }
@@ -30956,9 +30957,13 @@ var ListTableEventController = class {
             }
           );
           if (canOpenEditorByDoubleClick && event.detail === 1) {
-            this.scheduleEditableCellRowSelection(record, result.rowIndex);
+            this.scheduleEditableCellRowSelection(
+              record,
+              result.rowIndex,
+              event.shiftKey
+            );
           } else if (!canOpenEditorByDoubleClick || event.detail !== 2) {
-            this.host.toggleRowSelection(record, result.rowIndex);
+            this.host.toggleRowSelection(record, result.rowIndex, event.shiftKey);
           }
         }
       }
@@ -31537,11 +31542,11 @@ var ListTableEventController = class {
     event.preventDefault();
     this.host.editingController.open(rowIndex, columnKey, event.key);
   }
-  scheduleEditableCellRowSelection(record, rowIndex) {
+  scheduleEditableCellRowSelection(record, rowIndex, shiftKey) {
     this.cancelPendingEditableCellRowSelection();
     this.pendingEditableCellRowSelectionTimer = globalThis.setTimeout(() => {
       this.pendingEditableCellRowSelectionTimer = null;
-      this.host.toggleRowSelection(record, rowIndex);
+      this.host.toggleRowSelection(record, rowIndex, shiftKey);
     }, EDITABLE_CELL_ROW_SELECTION_DELAY);
   }
   cancelPendingEditableCellRowSelection() {
@@ -33087,7 +33092,10 @@ function createListTableEventHost(core) {
     clearBodySelection: () => core.selectionController.clearBodySelection(),
     clearSelectedHeader: () => core.selectionController.clearSelectedHeader(),
     selectHeader: (columnKey, rect) => core.selectionController.selectHeader(columnKey, rect),
-    resetRangeHighlightForHeaderSelection: (shiftKey, ctrlKey) => core.selectionController.resetRangeHighlightForHeaderSelection(shiftKey, ctrlKey),
+    resetRangeHighlightForHeaderSelection: (shiftKey, ctrlKey) => core.selectionController.resetRangeHighlightForHeaderSelection(
+      shiftKey,
+      ctrlKey
+    ),
     updateRangeHighlightForBodyInteraction: (params) => core.selectionController.updateRangeHighlightForBodyInteraction(params),
     updateRangeHighlightForHeaderClick: (columnKey, shiftKey, ctrlKey) => core.selectionController.updateRangeHighlightForHeaderClick(
       columnKey,
@@ -33106,7 +33114,7 @@ function createListTableEventHost(core) {
     showCellContentPreview: (content) => core.contentActionController.showCellContentPreview(content),
     showDangerConfirmRequest: (request) => core.overlayController.showDangerConfirm(request),
     toggleSelectAllVisibleRows: () => core.rowActionController.toggleSelectAllVisibleRows(),
-    toggleRowSelection: (record, rowIndex) => core.rowActionController.toggleRowSelection(record, rowIndex),
+    toggleRowSelection: (record, rowIndex, shiftKey) => core.rowActionController.toggleRowSelection(record, rowIndex, shiftKey),
     toggleRowExpand: (rowIndex) => core.rowActionController.toggleRowExpand(rowIndex),
     expandCollapsedRange: (contentKey) => core.rowActionController.expandCollapsedRange(contentKey),
     expandCollapsedColumnRange: (contentKey) => core.rowActionController.expandCollapsedColumnRange(contentKey),
@@ -34195,14 +34203,35 @@ var ListTablePersistenceController = class {
     __publicField(this, "revision", 0);
     __publicField(this, "pendingWrite");
     __publicField(this, "restoredStorageKey");
+    __publicField(this, "restoredQueryStorageKey");
     __publicField(this, "hasRestoredPreferences", false);
     __publicField(this, "restoring", false);
+    __publicField(this, "initialActions", []);
     this.options = options;
   }
+  /** 初始化期间的重置等待缓存恢复，避免将默认列和空排序写回缓存。 */
+  runAfterInitialRestore(run) {
+    const storageKey = this.options.getOptions().storageKey;
+    if (storageKey && this.needsInitialQueryRestore()) {
+      this.initialActions.push({ storageKey, run });
+    } else {
+      run();
+    }
+  }
+  /** 销毁时丢弃等待中的交互，避免已卸载表格再次写入缓存。 */
+  dispose() {
+    this.invalidate();
+    this.initialActions = [];
+  }
   /** 缓存恢复完成之前保留上一帧，避免默认配置先于缓存绘制。 */
   isRestoring() {
     return this.restoring;
   }
+  /** 首次缓存读取被配置更新打断时，后续读取仍需恢复该表的查询状态。 */
+  needsInitialQueryRestore() {
+    const storageKey = this.options.getOptions().storageKey;
+    return Boolean(storageKey && this.restoredQueryStorageKey !== storageKey);
+  }
   /** 使尚未完成的缓存恢复失效。 */
   invalidate() {
     this.revision += 1;
@@ -34211,6 +34240,9 @@ var ListTablePersistenceController = class {
   async loadStoredConfig(options = {}) {
     const { restoreQueryState = true } = options;
     const tableOptions = this.options.getOptions();
+    this.initialActions = this.initialActions.filter(
+      (action) => action.storageKey === tableOptions.storageKey
+    );
     const revision = ++this.revision;
     this.restoring = Boolean(tableOptions.storageKey);
     if (!this.restoring) return;
@@ -34222,6 +34254,14 @@ var ListTablePersistenceController = class {
       if (revision === this.revision) {
         this.restoring = false;
         if (this.options.getOptions().storageKey === tableOptions.storageKey) {
+          if (restoreQueryState) {
+            this.restoredQueryStorageKey = tableOptions.storageKey;
+            const actions = this.initialActions;
+            this.initialActions = [];
+            actions.forEach((action) => {
+              if (action.storageKey === tableOptions.storageKey) action.run();
+            });
+          }
           this.options.requestRender();
         }
       }
@@ -34242,6 +34282,9 @@ var ListTablePersistenceController = class {
       columns: tableOptions.columns
     });
     if (!stored || !isCurrent()) {
+      if (!stored && isCurrent() && restoreQueryState) {
+        this.restoredQueryStorageKey = storageKey;
+      }
       return;
     }
     this.restoredStorageKey = storageKey;
@@ -34252,6 +34295,7 @@ var ListTablePersistenceController = class {
     if (restoreQueryState && stored.filterState) {
       this.options.setFilterState(stored.filterState);
     }
+    if (restoreQueryState) this.restoredQueryStorageKey = storageKey;
     if (stored.zoom != null) {
       const nextZoom = normalizeContextMenuZoom(stored.zoom);
       this.options.setTableZoom(nextZoom);
@@ -34308,16 +34352,19 @@ var ListTablePersistenceController = class {
     }
     this.options.refreshRuntimeColumns();
     currentOptions.ui?.onColumnSettingsChange?.(
-      cloneColumns(currentOptions.columns)
+      cloneColumns(currentOptions.columns),
+      "restore"
     );
   }
   persistColumnConfig() {
     this.invalidate();
     const tableOptions = this.options.getOptions();
     tableOptions.ui?.onColumnSettingsChange?.(
-      cloneColumns(tableOptions.columns)
+      cloneColumns(tableOptions.columns),
+      "persist"
     );
     this.restoredStorageKey = tableOptions.storageKey;
+    this.restoredQueryStorageKey = tableOptions.storageKey;
     this.hasRestoredPreferences = true;
     this.pendingWrite = Promise.resolve(
       persistListTableColumnConfig({
@@ -35549,7 +35596,35 @@ function emitSelectionChange(params) {
 
 // src/services/selection-action-service.ts
 function resolveToggleSingleSelectionAction(params) {
-  return toggleSingleRowSelection(params);
+  const single = toggleSingleRowSelection(params);
+  const { options, anchorKey, displayData } = params;
+  if (!single || options.rowSelection?.type === "radio" || anchorKey == null || !displayData) {
+    return single;
+  }
+  const targetKey = getRowKey(options, params.record, params.rowIndex);
+  const anchorIndex = displayData.findIndex(
+    (record, index) => getRowKey(options, record, index) === anchorKey
+  );
+  const targetIndex = displayData.findIndex(
+    (record, index) => getRowKey(options, record, index) === targetKey
+  );
+  if (anchorIndex < 0 || targetIndex < 0 || anchorIndex === targetIndex)
+    return single;
+  const keys = new Set(params.selectedRowKeys);
+  for (let index = Math.min(anchorIndex, targetIndex); index <= Math.max(anchorIndex, targetIndex); index += 1) {
+    const record = displayData[index];
+    if (options.rowSelection?.getCheckboxProps?.(record)?.disabled) continue;
+    const key = getRowKey(options, record, index);
+    if (single.selected) keys.delete(key);
+    else keys.add(key);
+  }
+  const nextKeys = [...keys];
+  return {
+    ...single,
+    nextKeys,
+    selectedRows: getSelectedRows(options, nextKeys),
+    multiple: true
+  };
 }
 function resolveToggleAllVisibleSelectionAction(params) {
   return toggleAllVisibleRowSelection(params);
@@ -35609,6 +35684,7 @@ function fromBoundaryRightX(columnKey, positions, widths) {
 var ListTableRowActionController = class {
   constructor(options) {
     __publicField(this, "options");
+    __publicField(this, "selectionAnchorKey");
     this.options = options;
   }
   freezeRow(rowIndex, position) {
@@ -35824,17 +35900,27 @@ var ListTableRowActionController = class {
     this.options.requestRender();
     return true;
   }
-  toggleRowSelection(record, rowIndex) {
+  toggleRowSelection(record, rowIndex, shiftKey = false) {
     const resolved = resolveToggleSingleSelectionAction({
       options: this.options.getOptions(),
       selectedRowKeys: this.options.getSelectedRowKeys(),
       record,
-      rowIndex
+      rowIndex,
+      anchorKey: shiftKey ? this.selectionAnchorKey : void 0,
+      displayData: shiftKey ? this.options.getDisplayData() : void 0
     });
     if (!resolved) {
       return;
     }
-    this.updateSelectedRowKeys(resolved.nextKeys, "single");
+    this.selectionAnchorKey = getRowKey(
+      this.options.getOptions(),
+      record,
+      rowIndex
+    );
+    this.updateSelectedRowKeys(
+      resolved.nextKeys,
+      "multiple" in resolved ? "multiple" : "single"
+    );
     this.options.getOptions().rowSelection?.onSelect?.(
       record,
       !resolved.selected,
@@ -37640,10 +37726,14 @@ var ListTableCore = class {
     if (shouldPersistColumnConfig) {
       this.persistenceController.persistColumnConfig();
     } else {
-      this.persistenceController.loadStoredConfig({ restoreQueryState: false });
+      this.persistenceController.loadStoredConfig({
+        restoreQueryState: this.persistenceController.needsInitialQueryRestore()
+      });
     }
     this.renderController.render();
-    if (shouldPersistColumnConfig && haveVisibleLeafColumnsChanged(previousLeafColumns, host.leafColumns)) {
+    if (shouldPersistColumnConfig && (haveVisibleLeafColumnsChanged(previousLeafColumns, host.leafColumns) || previousLeafColumns.some(
+      (column, index) => column.key !== host.leafColumns[index]?.key
+    ))) {
       host.rowActionController.startColumnVisibilityAnimation({
         previousLeafColumns,
         previousSegments
@@ -37684,7 +37774,9 @@ var ListTableCore = class {
    * 重置排序状态。
    */
   resetSorter() {
-    this.headerActionController.resetSort();
+    this.persistenceController.runAfterInitialRestore(
+      () => this.headerActionController.resetSort()
+    );
   }
   /** 获取当前排序状态，供外部设置面板回显。 */
   getSortState() {
@@ -37698,7 +37790,9 @@ var ListTableCore = class {
    * 重置筛选状态。
    */
   resetFilter() {
-    this.headerActionController.resetFilters();
+    this.persistenceController.runAfterInitialRestore(
+      () => this.headerActionController.resetFilters()
+    );
   }
   /** 人工重试最近一次仍有效的本地查询失败。 */
   retryQuery() {
@@ -37723,7 +37817,7 @@ var ListTableCore = class {
    * 销毁实例。
    */
   destroy() {
-    this.persistenceController.invalidate();
+    this.persistenceController.dispose();
     this.eventController.destroy();
     this.selectionController.destroy();
     this.asAssemblyHost().rowDragController.destroy();

package/dist/index.d.cts

@@ -1987,7 +1987,7 @@ interface ListTableRowSelectionChangeInfo {
     type: "single" | "all" | "invert" | "none" | "multiple";
 }
 /**
- * 行选择配置。
+ * 行选择配置。checkbox 模式支持 Shift 点击，按当前显示顺序批量切换两次点击之间的行。
  */
 interface ListTableRowSelectionOptions<RecordType> {
     type?: "checkbox" | "radio";
@@ -2130,7 +2130,7 @@ interface ListTableUiOptions<RecordType = unknown> {
     /** 恢复持久化滚动条配置后同步到适配层。 */
     onScrollbarChange?: (scrollbar: ListTableScrollbarOptions) => void;
     /** 同步恢复或内部修改后的列设置到适配层。 */
-    onColumnSettingsChange?: (columns: ListTableColumn<RecordType>[]) => void;
+    onColumnSettingsChange?: (columns: ListTableColumn<RecordType>[], source?: "restore" | "persist") => void;
     /** 同步列设置缓存开关。 */
     onColumnSettingsCacheChange?: (enabled: boolean) => void;
     /** 同步各类配置的缓存偏好。 */

package/dist/index.d.ts

@@ -1987,7 +1987,7 @@ interface ListTableRowSelectionChangeInfo {
     type: "single" | "all" | "invert" | "none" | "multiple";
 }
 /**
- * 行选择配置。
+ * 行选择配置。checkbox 模式支持 Shift 点击，按当前显示顺序批量切换两次点击之间的行。
  */
 interface ListTableRowSelectionOptions<RecordType> {
     type?: "checkbox" | "radio";
@@ -2130,7 +2130,7 @@ interface ListTableUiOptions<RecordType = unknown> {
     /** 恢复持久化滚动条配置后同步到适配层。 */
     onScrollbarChange?: (scrollbar: ListTableScrollbarOptions) => void;
     /** 同步恢复或内部修改后的列设置到适配层。 */
-    onColumnSettingsChange?: (columns: ListTableColumn<RecordType>[]) => void;
+    onColumnSettingsChange?: (columns: ListTableColumn<RecordType>[], source?: "restore" | "persist") => void;
     /** 同步列设置缓存开关。 */
     onColumnSettingsCacheChange?: (enabled: boolean) => void;
     /** 同步各类配置的缓存偏好。 */

package/dist/index.js

@@ -24349,7 +24349,8 @@ function resolveExpandedRowHeight2(height, record, index) {
 // src/services/layout-service.ts
 var AUTO_ROW_HEIGHT_SAMPLE_COUNT = 200;
 function buildListTableRenderSnapshot(params) {
-  if (params.cache?.snapshot && params.cache.snapshot.groupIndex === params.cache.groupIndex && isSameRenderCacheInputs(params.cache.inputs, params)) {
+  if (params.cache?.snapshot && // 动画结束后的首帧必须重建，清除上一帧的位移、拖拽残影及插入线。
+  !params.cache.snapshot.swapAnimation && params.cache.snapshot.groupIndex === params.cache.groupIndex && isSameRenderCacheInputs(params.cache.inputs, params)) {
     const snapshotStartedAt2 = resolvePerformanceNow3();
     const cached = params.cache.snapshot;
     const snapshot2 = !cached.swapAnimation && cached.scroll.left === params.scroll.left && cached.scroll.top === params.scroll.top ? cached : updateListTableRenderSnapshotScroll({
@@ -30767,7 +30768,7 @@ var ListTableEventController = class {
         this.host.updateTooltip(result);
         return;
       }
-      if ((event.shiftKey || toggleColumn) && (result.area === "body" || result.area === "body-content") && typeof result.rowIndex === "number" && result.columnKey && !isSystemColumnKey(result.columnKey)) {
+      if ((event.shiftKey || toggleColumn) && (result.area === "body" || result.area === "body-content") && !(event.shiftKey && !toggleColumn && this.host.options.rowSelection?.selectRowByClick && this.host.options.rowSelection.type !== "radio") && typeof result.rowIndex === "number" && result.columnKey && !isSystemColumnKey(result.columnKey)) {
         const columnIndex = this.host.leafColumns.findIndex(
           (column) => column.key === result.columnKey
         );
@@ -30913,7 +30914,7 @@ var ListTableEventController = class {
       if ((result.area === "body-control" || result.area === "body") && result.columnKey === ROW_SELECTION_COLUMN_KEY && typeof result.rowIndex === "number") {
         const record = this.resolveBodyRecord(result.rowIndex);
         if (record) {
-          this.host.toggleRowSelection(record, result.rowIndex);
+          this.host.toggleRowSelection(record, result.rowIndex, event.shiftKey);
         }
         return;
       }
@@ -30934,9 +30935,13 @@ var ListTableEventController = class {
             }
           );
           if (canOpenEditorByDoubleClick && event.detail === 1) {
-            this.scheduleEditableCellRowSelection(record, result.rowIndex);
+            this.scheduleEditableCellRowSelection(
+              record,
+              result.rowIndex,
+              event.shiftKey
+            );
           } else if (!canOpenEditorByDoubleClick || event.detail !== 2) {
-            this.host.toggleRowSelection(record, result.rowIndex);
+            this.host.toggleRowSelection(record, result.rowIndex, event.shiftKey);
           }
         }
       }
@@ -31515,11 +31520,11 @@ var ListTableEventController = class {
     event.preventDefault();
     this.host.editingController.open(rowIndex, columnKey, event.key);
   }
-  scheduleEditableCellRowSelection(record, rowIndex) {
+  scheduleEditableCellRowSelection(record, rowIndex, shiftKey) {
     this.cancelPendingEditableCellRowSelection();
     this.pendingEditableCellRowSelectionTimer = globalThis.setTimeout(() => {
       this.pendingEditableCellRowSelectionTimer = null;
-      this.host.toggleRowSelection(record, rowIndex);
+      this.host.toggleRowSelection(record, rowIndex, shiftKey);
     }, EDITABLE_CELL_ROW_SELECTION_DELAY);
   }
   cancelPendingEditableCellRowSelection() {
@@ -33065,7 +33070,10 @@ function createListTableEventHost(core) {
     clearBodySelection: () => core.selectionController.clearBodySelection(),
     clearSelectedHeader: () => core.selectionController.clearSelectedHeader(),
     selectHeader: (columnKey, rect) => core.selectionController.selectHeader(columnKey, rect),
-    resetRangeHighlightForHeaderSelection: (shiftKey, ctrlKey) => core.selectionController.resetRangeHighlightForHeaderSelection(shiftKey, ctrlKey),
+    resetRangeHighlightForHeaderSelection: (shiftKey, ctrlKey) => core.selectionController.resetRangeHighlightForHeaderSelection(
+      shiftKey,
+      ctrlKey
+    ),
     updateRangeHighlightForBodyInteraction: (params) => core.selectionController.updateRangeHighlightForBodyInteraction(params),
     updateRangeHighlightForHeaderClick: (columnKey, shiftKey, ctrlKey) => core.selectionController.updateRangeHighlightForHeaderClick(
       columnKey,
@@ -33084,7 +33092,7 @@ function createListTableEventHost(core) {
     showCellContentPreview: (content) => core.contentActionController.showCellContentPreview(content),
     showDangerConfirmRequest: (request) => core.overlayController.showDangerConfirm(request),
     toggleSelectAllVisibleRows: () => core.rowActionController.toggleSelectAllVisibleRows(),
-    toggleRowSelection: (record, rowIndex) => core.rowActionController.toggleRowSelection(record, rowIndex),
+    toggleRowSelection: (record, rowIndex, shiftKey) => core.rowActionController.toggleRowSelection(record, rowIndex, shiftKey),
     toggleRowExpand: (rowIndex) => core.rowActionController.toggleRowExpand(rowIndex),
     expandCollapsedRange: (contentKey) => core.rowActionController.expandCollapsedRange(contentKey),
     expandCollapsedColumnRange: (contentKey) => core.rowActionController.expandCollapsedColumnRange(contentKey),
@@ -34173,14 +34181,35 @@ var ListTablePersistenceController = class {
     __publicField(this, "revision", 0);
     __publicField(this, "pendingWrite");
     __publicField(this, "restoredStorageKey");
+    __publicField(this, "restoredQueryStorageKey");
     __publicField(this, "hasRestoredPreferences", false);
     __publicField(this, "restoring", false);
+    __publicField(this, "initialActions", []);
     this.options = options;
   }
+  /** 初始化期间的重置等待缓存恢复，避免将默认列和空排序写回缓存。 */
+  runAfterInitialRestore(run) {
+    const storageKey = this.options.getOptions().storageKey;
+    if (storageKey && this.needsInitialQueryRestore()) {
+      this.initialActions.push({ storageKey, run });
+    } else {
+      run();
+    }
+  }
+  /** 销毁时丢弃等待中的交互，避免已卸载表格再次写入缓存。 */
+  dispose() {
+    this.invalidate();
+    this.initialActions = [];
+  }
   /** 缓存恢复完成之前保留上一帧，避免默认配置先于缓存绘制。 */
   isRestoring() {
     return this.restoring;
   }
+  /** 首次缓存读取被配置更新打断时，后续读取仍需恢复该表的查询状态。 */
+  needsInitialQueryRestore() {
+    const storageKey = this.options.getOptions().storageKey;
+    return Boolean(storageKey && this.restoredQueryStorageKey !== storageKey);
+  }
   /** 使尚未完成的缓存恢复失效。 */
   invalidate() {
     this.revision += 1;
@@ -34189,6 +34218,9 @@ var ListTablePersistenceController = class {
   async loadStoredConfig(options = {}) {
     const { restoreQueryState = true } = options;
     const tableOptions = this.options.getOptions();
+    this.initialActions = this.initialActions.filter(
+      (action) => action.storageKey === tableOptions.storageKey
+    );
     const revision = ++this.revision;
     this.restoring = Boolean(tableOptions.storageKey);
     if (!this.restoring) return;
@@ -34200,6 +34232,14 @@ var ListTablePersistenceController = class {
       if (revision === this.revision) {
         this.restoring = false;
         if (this.options.getOptions().storageKey === tableOptions.storageKey) {
+          if (restoreQueryState) {
+            this.restoredQueryStorageKey = tableOptions.storageKey;
+            const actions = this.initialActions;
+            this.initialActions = [];
+            actions.forEach((action) => {
+              if (action.storageKey === tableOptions.storageKey) action.run();
+            });
+          }
           this.options.requestRender();
         }
       }
@@ -34220,6 +34260,9 @@ var ListTablePersistenceController = class {
       columns: tableOptions.columns
     });
     if (!stored || !isCurrent()) {
+      if (!stored && isCurrent() && restoreQueryState) {
+        this.restoredQueryStorageKey = storageKey;
+      }
       return;
     }
     this.restoredStorageKey = storageKey;
@@ -34230,6 +34273,7 @@ var ListTablePersistenceController = class {
     if (restoreQueryState && stored.filterState) {
       this.options.setFilterState(stored.filterState);
     }
+    if (restoreQueryState) this.restoredQueryStorageKey = storageKey;
     if (stored.zoom != null) {
       const nextZoom = normalizeContextMenuZoom(stored.zoom);
       this.options.setTableZoom(nextZoom);
@@ -34286,16 +34330,19 @@ var ListTablePersistenceController = class {
     }
     this.options.refreshRuntimeColumns();
     currentOptions.ui?.onColumnSettingsChange?.(
-      cloneColumns(currentOptions.columns)
+      cloneColumns(currentOptions.columns),
+      "restore"
     );
   }
   persistColumnConfig() {
     this.invalidate();
     const tableOptions = this.options.getOptions();
     tableOptions.ui?.onColumnSettingsChange?.(
-      cloneColumns(tableOptions.columns)
+      cloneColumns(tableOptions.columns),
+      "persist"
     );
     this.restoredStorageKey = tableOptions.storageKey;
+    this.restoredQueryStorageKey = tableOptions.storageKey;
     this.hasRestoredPreferences = true;
     this.pendingWrite = Promise.resolve(
       persistListTableColumnConfig({
@@ -35527,7 +35574,35 @@ function emitSelectionChange(params) {
 
 // src/services/selection-action-service.ts
 function resolveToggleSingleSelectionAction(params) {
-  return toggleSingleRowSelection(params);
+  const single = toggleSingleRowSelection(params);
+  const { options, anchorKey, displayData } = params;
+  if (!single || options.rowSelection?.type === "radio" || anchorKey == null || !displayData) {
+    return single;
+  }
+  const targetKey = getRowKey(options, params.record, params.rowIndex);
+  const anchorIndex = displayData.findIndex(
+    (record, index) => getRowKey(options, record, index) === anchorKey
+  );
+  const targetIndex = displayData.findIndex(
+    (record, index) => getRowKey(options, record, index) === targetKey
+  );
+  if (anchorIndex < 0 || targetIndex < 0 || anchorIndex === targetIndex)
+    return single;
+  const keys = new Set(params.selectedRowKeys);
+  for (let index = Math.min(anchorIndex, targetIndex); index <= Math.max(anchorIndex, targetIndex); index += 1) {
+    const record = displayData[index];
+    if (options.rowSelection?.getCheckboxProps?.(record)?.disabled) continue;
+    const key = getRowKey(options, record, index);
+    if (single.selected) keys.delete(key);
+    else keys.add(key);
+  }
+  const nextKeys = [...keys];
+  return {
+    ...single,
+    nextKeys,
+    selectedRows: getSelectedRows(options, nextKeys),
+    multiple: true
+  };
 }
 function resolveToggleAllVisibleSelectionAction(params) {
   return toggleAllVisibleRowSelection(params);
@@ -35587,6 +35662,7 @@ function fromBoundaryRightX(columnKey, positions, widths) {
 var ListTableRowActionController = class {
   constructor(options) {
     __publicField(this, "options");
+    __publicField(this, "selectionAnchorKey");
     this.options = options;
   }
   freezeRow(rowIndex, position) {
@@ -35802,17 +35878,27 @@ var ListTableRowActionController = class {
     this.options.requestRender();
     return true;
   }
-  toggleRowSelection(record, rowIndex) {
+  toggleRowSelection(record, rowIndex, shiftKey = false) {
     const resolved = resolveToggleSingleSelectionAction({
       options: this.options.getOptions(),
       selectedRowKeys: this.options.getSelectedRowKeys(),
       record,
-      rowIndex
+      rowIndex,
+      anchorKey: shiftKey ? this.selectionAnchorKey : void 0,
+      displayData: shiftKey ? this.options.getDisplayData() : void 0
     });
     if (!resolved) {
       return;
     }
-    this.updateSelectedRowKeys(resolved.nextKeys, "single");
+    this.selectionAnchorKey = getRowKey(
+      this.options.getOptions(),
+      record,
+      rowIndex
+    );
+    this.updateSelectedRowKeys(
+      resolved.nextKeys,
+      "multiple" in resolved ? "multiple" : "single"
+    );
     this.options.getOptions().rowSelection?.onSelect?.(
       record,
       !resolved.selected,
@@ -37618,10 +37704,14 @@ var ListTableCore = class {
     if (shouldPersistColumnConfig) {
       this.persistenceController.persistColumnConfig();
     } else {
-      this.persistenceController.loadStoredConfig({ restoreQueryState: false });
+      this.persistenceController.loadStoredConfig({
+        restoreQueryState: this.persistenceController.needsInitialQueryRestore()
+      });
     }
     this.renderController.render();
-    if (shouldPersistColumnConfig && haveVisibleLeafColumnsChanged(previousLeafColumns, host.leafColumns)) {
+    if (shouldPersistColumnConfig && (haveVisibleLeafColumnsChanged(previousLeafColumns, host.leafColumns) || previousLeafColumns.some(
+      (column, index) => column.key !== host.leafColumns[index]?.key
+    ))) {
       host.rowActionController.startColumnVisibilityAnimation({
         previousLeafColumns,
         previousSegments
@@ -37662,7 +37752,9 @@ var ListTableCore = class {
    * 重置排序状态。
    */
   resetSorter() {
-    this.headerActionController.resetSort();
+    this.persistenceController.runAfterInitialRestore(
+      () => this.headerActionController.resetSort()
+    );
   }
   /** 获取当前排序状态，供外部设置面板回显。 */
   getSortState() {
@@ -37676,7 +37768,9 @@ var ListTableCore = class {
    * 重置筛选状态。
    */
   resetFilter() {
-    this.headerActionController.resetFilters();
+    this.persistenceController.runAfterInitialRestore(
+      () => this.headerActionController.resetFilters()
+    );
   }
   /** 人工重试最近一次仍有效的本地查询失败。 */
   retryQuery() {
@@ -37701,7 +37795,7 @@ var ListTableCore = class {
    * 销毁实例。
    */
   destroy() {
-    this.persistenceController.invalidate();
+    this.persistenceController.dispose();
     this.eventController.destroy();
     this.selectionController.destroy();
     this.asAssemblyHost().rowDragController.destroy();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canvas-components/list-table",
-  "version": "0.3.30",
+  "version": "0.3.32",
   "description": "Framework-agnostic list table core engine.",
   "license": "MIT",
   "type": "module",
@@ -27,11 +27,11 @@
   },
   "dependencies": {
     "@ant-design/icons-svg": "4.6.0",
-    "@canvas-components/qrcode": "0.2.2",
-    "@canvas-components/utils": "0.2.8",
     "@canvas-components/barcode": "0.2.2",
     "@canvas-components/chart": "0.3.7",
-    "@canvas-components/stats": "0.1.4"
+    "@canvas-components/stats": "0.1.4",
+    "@canvas-components/qrcode": "0.2.2",
+    "@canvas-components/utils": "0.2.8"
   },
   "scripts": {
     "build": "tsup --config tsup.config.ts"