arthub-table 0.1.0-beta.2 → 0.1.0-beta.21

package/dist/types/core/GroupRow.d.ts

@@ -15,6 +15,8 @@ declare class GroupRow extends Context {
     isGroupHeader: boolean;
     isSeparator: boolean;
     hoverColIndex: number;
+    /** 当 hover 列为 nested 父列时，记录鼠标所在的子列偏移索引（-1 表示不在子列上） */
+    hoverSubColIndex: number;
     /** 鼠标是否 hover 在当前组头行上 */
     isHovered: boolean;
     /** 鼠标是否 hover 在展开箭头区域附近（包括 checkbox 区域） */
@@ -24,12 +26,22 @@ declare class GroupRow extends Context {
      * Draw the group row
      */
     draw(): void;
+    /**
+     * 获取指定 groupLevel 的水平缩进量（非线性）
+     * level 0: 0px（无缩进）
+     * level 1: 18px
+     * level 2+: 18px（与 level 1 相同，避免叶子分组过度靠右）
+     */
+    private getLevelIndent;
     /**
      * Draw group header row
      */
     private drawGroupHeader;
     /**
-     * Draw expand/collapse arrow
+     * Draw expand/collapse arrow using SVG path from icon_singlearrowright.svg
+     * SVG viewBox: 0 0 32 32, rendered at 16x16 (scale 0.5)
+     * Collapsed: right arrow (original orientation)
+     * Expanded: rotated 90° clockwise → down arrow
      */
     private drawExpandArrow;
     /**
@@ -38,14 +50,13 @@ declare class GroupRow extends Context {
     private drawGroupName;
     /**
      * 解析分组名称应使用的 viewer 类型和数据
-     * 优先使用外部显式传入的 groupNameViewerType + groupNameViewerData，
-     * 否则根据 data.property 从列配置中自动推断 viewerType，用 data.value 构建 viewerData
+     * 使用外部显式传入的 groupNameViewerType + groupNameViewerData（由 AssetMatrix buildGroupNameViewerData 构建），
+     * 否则回退到文本渲染
      */
     private resolveGroupNameViewer;
     /**
      * 根据列 key 从 grid.columns 中查找列配置
      */
-    private findColumnConfigByKey;
     /**
      * 使用 viewer 绘制分组名称区域
      * 根据 viewerType 从 ViewerRegistry 获取对应的 viewer 实例来渲染，
@@ -69,32 +80,37 @@ declare class GroupRow extends Context {
      */
     private getValidationStyle;
     /**
-     * 在展开箭头左边绘制校验图标或 checkbox
-     * 参考旧表格 table-switcher-cell.ts 的 .before 布局：
-     *   .before { display: flex; gap: 5px; } 内含 checked-done + cell-switcher
+     * 在展开箭头右边绘制校验图标或 checkbox
+     * 参考旧表格 table-switcher-cell.ts 的布局：
+     *   .before (展开箭头) 在左，.middle (checkbox) 在右
      * 交互逻辑：
      * - 有 validation 数据且未 checked 且未 hover → 显示校验图标（✅）
      * - hover 展开箭头区域时 → 校验图标变成 checkbox
      * - 无 validation 数据时 hover → 显示 checkbox
-     * @returns 绘制后的 X 坐标（展开箭头的起始位置）
+     * @returns 绘制后的 X 坐标
      */
     private drawGroupValidationOrCheckbox;
     /**
-     * 在展开箭头左边内联绘制 checkbox
+     * 在展开箭头右边内联绘制 checkbox
      * @returns 绘制后的 X 坐标
      */
     private drawInlineCheckbox;
     /**
-     * 在展开箭头左边内联绘制校验图标（绿色勾选圆圈）
+     * 在展开箭头右边内联绘制校验图标（绿色勾选圆圈）
      * 与旧表格 .before 内 .checked-done { font-size: 17px; color: #00bd77; } 对齐
      * @returns 绘制后的 X 坐标
      */
     private drawInlineValidationIcon;
     /**
      * 检测点击是否在校验图标/checkbox 区域内
-     * 区域范围：展开箭头左边的校验图标/checkbox 所在位置
+     * 区域范围：展开箭头右侧的校验图标/checkbox 所在位置
      */
     private isInsideCheckboxArea;
+    /**
+     * 检测点击是否在整个 index 列区域内（序号列区域）
+     * 用于一维分组下判断鼠标是否在 index 列 hover
+     */
+    private isInsideIndexColumnArea;
     /**
      * 获取第一个有 colKey 的数据列（即第一个非系统列）
      * 用于定位分组名称的起始位置
@@ -107,6 +123,14 @@ declare class GroupRow extends Context {
     private drawInlineStatValue;
     /**
      * Draw separator row
+     *
+     * 背景色逻辑与 DOM 模式对齐：
+     * - _separatorStyle === 'gray'：最外层分组之间的间隙，使用灰色（#e6eaf0）
+     * - _separatorStyle === 'white'：内层组间间隙，使用白色（#fff）
+     * - 未设置 _separatorStyle 时（兼容旧数据）：回退到按 separateLevel 选择颜色
+     *
+     * 序号列分层背景色：与数据行 RowHeader 的分层效果一致，
+     * 根据 _parentGroupLevel 在最左侧绘制 level0/level1 的缩进色块
      */
     private drawSeparator;
     /**
@@ -118,17 +142,39 @@ declare class GroupRow extends Context {
      */
     private getColumnScreenX;
     /**
-     * 获取鼠标悬停所在的列索引（考虑固定列和滚动偏移）
+     * 获取鼠标悬停所在的列索引（考虑固定列和滚动偏移），同时更新 hoverSubColIndex
      */
     getHoverColumnIndex(mouseX: number): number;
+    /** 获取指定 nested 父列的所有子列列头 */
+    private getNestedChildHeaders;
+    /** 安全获取 canvas 元素的视口边界（测试环境中 target 可能不存在） */
+    private getCanvasRect;
     /**
      * 绘制单个统计单元格
      */
     private drawStatCell;
+    /**
+     * 绘制 nested 列的子统计单元格拆分渲染
+     */
+    private drawNestedStatCell;
     /**
      * 绘制 "数据统计" 提示文字
      */
     private drawHintText;
+    /**
+     * 绘制 "数据统计" 提示文字（指定最大宽度）
+     */
+    private drawHintTextWithMaxWidth;
+    /**
+     * 绘制刷新图标（icon_backtodefault）
+     * @param x 刷新图标区域左边界（包含 padding）
+     */
+    private drawRefreshIcon;
+    /**
+     * 绘制 loading 旋转图标（替代刷新icon位置）
+     * @param x loading 图标区域左边界（包含 padding，与刷新icon位置对齐）
+     */
+    private drawLoadingIcon;
     /**
      * 截断文字并添加省略号，不压缩文字宽度
      */
@@ -149,6 +195,25 @@ declare class GroupRow extends Context {
      * Check if mouse is inside vertical body boundary
      */
     isInsideVerticaBodyBoundary(mouseX: number, mouseY: number): boolean;
+    /**
+     * Get the group name viewer area bounds for hit testing
+     * Returns the viewer bounds (x, y, width) and the resolved viewer + data, or null if no viewer
+     */
+    private getGroupNameViewerInfo;
+    /**
+     * Check viewer hover state for group name area (e.g. person name underline on hover)
+     * Called from mouseMove to update viewer's internal hover tracking
+     */
+    private checkGroupNameViewerHover;
+    /**
+     * Handle click on group name viewer area (e.g. person name click-to-jump)
+     * Returns true if the click was handled by the viewer
+     */
+    private handleGroupNameViewerClick;
+    /**
+     * Reset group name viewer hover state (called when mouse leaves this GroupRow)
+     */
+    resetGroupNameViewerHover(): void;
     /**
      * Handle click on group row
      */
@@ -180,6 +245,12 @@ declare class GroupRow extends Context {
     mouseMove(x: number, y: number): void;
     mouseDown(_x: number, _y: number): void;
     click(x: number, y: number, clientX?: number, clientY?: number): void;
+    /** 处理 nested 子列点击 */
+    private onNestedChildClick;
+    /**
+     * 检测鼠标是否在嵌套子列的刷新图标区域内
+     */
+    private isInsideNestedRefreshIcon;
     /**
      * 从列配置中查找指定索引的列
      */

package/dist/types/core/Header.d.ts

@@ -16,6 +16,7 @@ declare class Header extends Context {
     resizeOriginalWidth: number;
     resizeStartX: number;
     isResizing: boolean;
+    resizeMousedownTime: number;
     constructor(grid: DataGrid, x: number, y: number);
     paint(): void;
     mouseDown(x: number, y: number, e?: {
@@ -25,6 +26,14 @@ declare class Header extends Context {
     }): void;
     resizing(x: number, _y: number): void;
     endResize(): void;
+    /**
+     * Double-click on column resize border: toggle between min and max width
+     * Aligned with DOM table behavior (onHeaderResizeDblclick):
+     * - If maxWidth === 'unset', do nothing
+     * - If current width < max, set to max
+     * - If current width === max, set to min (originWidth fallback)
+     */
+    private onHeaderResizeDblclick;
     /**
      * 一次性调整嵌套子列宽度：只修改被拖拽的子列和其父列
      */

package/dist/types/core/ImageManager.d.ts

@@ -25,6 +25,8 @@ declare class ImageManager {
     private linkIcon;
     private linkIconCanvas;
     private linkIconHeaderCanvas;
+    private upArrowIconCanvas;
+    private downArrowIconCanvas;
     private defaultAvatarImage;
     private constructor();
     /**
@@ -138,6 +140,22 @@ declare class ImageManager {
      * @returns HTMLCanvasElement or null if not loaded
      */
     getLinkIconForHeader(): HTMLCanvasElement | null;
+    /** Sort arrow icon color (#3f9eff blue, matching DOM version) */
+    private static SORT_ARROW_COLOR;
+    /**
+     * Load sort arrow icons (up/down) and recolor to blue (#3f9eff)
+     */
+    private loadSortArrowIcons;
+    /**
+     * Get sort up arrow icon (recolored to #3f9eff)
+     * @returns HTMLCanvasElement or null if not loaded
+     */
+    getSortUpArrowIcon(): HTMLCanvasElement | null;
+    /**
+     * Get sort down arrow icon (recolored to #3f9eff)
+     * @returns HTMLCanvasElement or null if not loaded
+     */
+    getSortDownArrowIcon(): HTMLCanvasElement | null;
     /**
      * Load default avatar (base64 PNG, used as fallback when person avatar fails to load)
      */
@@ -172,6 +190,11 @@ declare class ImageManager {
      * @returns true if image is cached
      */
     isCached(src: string): boolean;
+    /**
+     * 提取 URL 的基础部分（去掉查询参数和 hash），用于模糊匹配
+     * 例如 "https://cdn.example.com/img.jpg?sign=abc&t=123" → "https://cdn.example.com/img.jpg"
+     */
+    private getBaseUrl;
     /**
      * Clear all cached images
      */

package/dist/types/core/NestedGrid.d.ts

@@ -44,6 +44,7 @@ interface NestedGridOptions {
     parentGrid: DataGrid;
     parentCell: any;
     displayRows?: number;
+    hasMore?: boolean;
 }
 declare class NestedGrid {
     columns: NestedColumn[];
@@ -74,6 +75,7 @@ declare class NestedGrid {
     expanded: boolean;
     expandButtonHeight: number;
     expandButtonHovered: boolean;
+    hasMore: boolean;
     private redrawScheduled;
     private redrawTimer;
     selectionRange: SelectionRange | null;
@@ -85,6 +87,8 @@ declare class NestedGrid {
         enable: boolean;
         /** autofill 拖拽区域范围 */
         range: SelectionRange | null;
+        /** 是否为主动发起 autofill 的子表（区分跨子表场景中被动设置的子表） */
+        isSource: boolean;
     };
     /** 标记刚刚完成了 autofill 拖拽，用于跳过紧接着的 click 事件触发的编辑 */
     justFinishedAutofill: boolean;
@@ -220,6 +224,14 @@ declare class NestedGrid {
      */
     drawOverlays(): void;
     clearOtherNestedGridsSelection(): void;
+    /**
+     * 收集同列所有有选区的嵌套子表信息，触发 onNestedSelectionChange 回调
+     */
+    notifySelectionChange(): void;
+    /**
+     * 外部设置选区（跨子表框选时由 Events.ts 调用）
+     */
+    setExternalSelection(range: SelectionRange): void;
     /**
      * 清除当前子表格的所有选中状态
      */
@@ -253,6 +265,15 @@ declare class NestedGrid {
      * 清除 autofill 状态
      */
     clearAutofill(): void;
+    /**
+     * 外部设置 autofill 范围（跨子表 autofill 拖拽时由 Events.ts 调用）。
+     * 会同时设置 autofill.enable = true，这样绘制逻辑会渲染虚线边框和浅色高亮。
+     */
+    setExternalAutofill(range: SelectionRange): void;
+    /**
+     * 清除外部设置的 autofill 范围，同时重置 enable 标记
+     */
+    clearExternalAutofill(): void;
     /**
      * 判断某个 (row, col) 是否在选区内（矩形范围 或 散点多选）
      */

package/dist/types/core/Paint.d.ts

@@ -34,6 +34,8 @@ interface DrawRectOptions {
     shadowOffsetY?: number;
     shadowBlur?: number;
     shadowColor?: string;
+    /** Which sides to draw borders on. 'all' = strokeRect (default), 'right-bottom' = only right and bottom edges */
+    borderSides?: 'all' | 'right-bottom';
 }
 interface DrawIconOptions extends DrawTextOptions {
 }
@@ -85,6 +87,30 @@ declare class Paint {
     drawImage(img: HTMLImageElement | HTMLCanvasElement | {
         src: string;
     }, x: number, y: number, width: number, height: number): void;
+    /**
+     * 用 Canvas API 绘制 checkbox（替代 PNG 图片缩放）
+     * 精确控制线宽和尺寸，视觉效果与浏览器原生 checkbox 一致
+     *
+     * @param x - checkbox 左上角 X 坐标
+     * @param y - checkbox 左上角 Y 坐标
+     * @param size - checkbox 尺寸（宽=高），默认 14
+     * @param checked - 是否选中
+     * @param options - 可选的颜色配置
+     */
+    drawCheckbox(x: number, y: number, size?: number, checked?: boolean, options?: {
+        /** 选中时的背景色，默认 #1890ff */
+        checkedBgColor?: string;
+        /** 未选中时的边框色，默认 #d9d9d9 */
+        borderColor?: string;
+        /** 未选中时的背景色，默认 #fff */
+        bgColor?: string;
+        /** 勾选标记色，默认 #fff */
+        checkmarkColor?: string;
+        /** 圆角半径，默认 2 */
+        borderRadius?: number;
+        /** 半选状态（indeterminate），蓝色背景 + 白色横线 */
+        indeterminate?: boolean;
+    }): void;
     clearCanvas(x?: number, y?: number, width?: number, height?: number): void;
     /**
      * 计算长文本自动换行

package/dist/types/core/Row.d.ts

@@ -16,12 +16,12 @@ declare class Row extends Context {
     rowHeader: RowHeader;
     constructor(grid: DataGrid, rowIndex: number, x: number, y: number, height: number, data: RowData);
     isInVerticalAutofill(mouseX: number, mouseY: number): boolean;
-    handleCheck(checked?: boolean): void;
+    handleCheck(checked?: boolean, event?: MouseEvent): void;
     mouseDown(x: number, y: number): void;
     mouseMove(mouseX: number, mouseY: number): void;
     handleAutofill(x: number, y: number): void;
     handleStartAutofill(x: number, y: number, shiftKey?: boolean): void;
-    click(x: number, y: number): void;
+    click(x: number, y: number, event?: MouseEvent): void;
     dbClick(x: number, y: number): void;
     resizeColumn(colIndex: number, diffWidth: number): void;
     resizeRow(rowIndex: number, height: number): void;

package/dist/types/core/RowHeader.d.ts

@@ -8,6 +8,8 @@ interface RowHeaderOptions {
     checked?: boolean;
     /** 数据驱动模式下的序号值（undefined 表示不显示序号） */
     dataIndex?: number | string;
+    /** 父级分组层级（0/1/2），用于序号列分层背景色 */
+    parentGroupLevel?: number;
 }
 declare class RowHeader extends Context {
     rowIndex: number;
@@ -17,8 +19,43 @@ declare class RowHeader extends Context {
     fillColor?: string;
     borderWidth?: number;
     color?: string;
+    /** 父级分组层级（0/1/2），用于序号列分层背景色 */
+    parentGroupLevel?: number;
     constructor(grid: DataGrid, rowIndex: number, x: number, y: number, width: number, height: number, options?: RowHeaderOptions);
     handleCheck(val: boolean): void;
+    /**
+     * Get the checkbox X offset for this row header.
+     * In grouped mode, align with the leaf group header's checkbox position.
+     * Group header checkbox formula: this.x + 18 + getLevelIndent(groupLevel)
+     * where getLevelIndent(0) = 0, getLevelIndent(1+) = LEVEL0_WIDTH (6px)
+     */
+    private getCheckboxLeftOffset;
+    /**
+     * Override checkbox boundary detection to match the actual checkbox position
+     * in grouped table mode (aligned with group header checkbox).
+     */
+    isInsideCheckboxBoundary(mouseX: number, _mouseY: number): boolean;
+    /**
+     * Override index boundary detection to account for shifted checkbox position
+     * in grouped table mode.
+     */
+    isInsideIndexBoundary(mouseX: number, _mouseY: number): boolean;
+    /**
+     * Draw border lines only in the data area (right of color bars).
+     * Color bar area should NOT have cell borders to preserve visual hierarchy.
+     *
+     * NOTE: fillRect uses +0.5 Y offset (matching Cell's drawRect pattern) so that
+     * the next row's fill starts at (y + height + 0.5), only covering the bottom
+     * half of this row's bottom border — keeping the top half visible (consistent
+     * with how Cell borders work).
+     *
+     * @param ctx - Canvas context
+     * @param cellX - Cell left edge X
+     * @param cellY - Cell top edge Y (already includes +0.5 offset)
+     * @param cellWidth - Total cell width
+     * @param barWidth - Total width of color bars (left side to skip)
+     */
+    private drawDataAreaBorder;
     draw(): void;
 }
 export default RowHeader;

package/dist/types/core/StyleManager.d.ts

@@ -167,6 +167,22 @@ export interface ThemeTokens {
     bgTagDefault: string;
     /** 进度条轨道色 */
     bgProgressTrack: string;
+    /** 顶层实体行背景色（path_id.length === 2 的 Entity 行） */
+    bgTopLevelEntity: string;
+    /** 顶层实体行 hover 背景色 */
+    bgTopLevelEntityHover: string;
+    /** 需求变更-新增需求背景色 */
+    bgDemandChangeAdd: string;
+    /** 需求变更-新增需求 hover 背景色 */
+    bgDemandChangeAddHover: string;
+    /** 需求变更-取消需求背景色 */
+    bgDemandChangeCancel: string;
+    /** 需求变更-取消需求 hover 背景色 */
+    bgDemandChangeCancelHover: string;
+    /** 嵌套列父表头默认背景色（无自定义 color 时使用） */
+    bgNestedHeaderDefault: string;
+    /** 嵌套列子表头之间的分割线颜色 */
+    nestedChildDivider: string;
     /** 默认边框色 */
     borderDefault: string;
     /** 搜索匹配边框色 */
@@ -251,6 +267,10 @@ export interface ThemeTokens {
     groupLevel2Bg: string;
     /** 分组行文本色 */
     groupTextColor: string;
+    /** 分组名称文本色（对齐 DOM --am-table-cell-text-color） */
+    groupNameTextColor: string;
+    /** 分组色条右边缘竖线颜色 */
+    groupBarBorder: string;
     /** 分隔行 level0 背景 */
     separatorLevel0Bg: string;
     /** 分隔行 level1 背景 */

package/dist/types/core/constants.d.ts

@@ -1,10 +1,10 @@
 export declare const CSS_PREFIX = "xs-data-grid";
-export declare const HEADER_HEIGHT = 36;
+export declare const HEADER_HEIGHT = 34;
 export declare const FOOTER_HEIGHT = 36;
 export declare const ROW_INDEX_WIDTH = 36;
 export declare const CHECK_BOX_WIDTH = 36;
 export declare const CELL_HEIGHT = 36;
-export declare const MIN_CELL_WIDTH = 100;
+export declare const MIN_CELL_WIDTH = 50;
 export declare const MIN_CELL_HEIGHT = 36;
 export declare const SCROLLER_TRACK_SIZE = 16;
 export declare const SCROLLER_SIZE = 8;
@@ -33,6 +33,7 @@ export declare const HEADER_TEXT_COLOR: string;
 export declare const HEADER_ICON_SIZE = 14;
 export declare const HEADER_SETTINGS_ICON_SIZE = 14;
 export declare const HEADER_ICON_PADDING = 4;
+export declare const HEADER_NESTED_SETTINGS_PADDING = 8;
 export declare const HEADER_ICON_RIGHT_MARGIN = 14;
 export declare const HEADER_ICON_GAP = 0;
 export declare const HEADER_BUSINESS_ICON_SIZE = 14;

package/dist/types/core/types.d.ts

@@ -94,7 +94,7 @@ export interface ValidatorRule {
  * All supported column types, including built-in types and registered viewer types.
  * Custom viewer types can be registered via ViewerRegistry.register().
  */
-export type ColumnType = 'text' | 'number' | 'select' | 'date' | 'datetime' | 'month' | 'time' | 'image' | 'nested' | 'nested-child' | 'person' | 'progress' | 'boolean' | 'checkbox' | 'status' | 'group-header' | 'separator-row' | 'punch' | 'hyperlink' | 'file' | 'task-node' | 'module' | 'text-with-switcher' | 'upstream' | 'table-action-button' | (string & Record<string, never>);
+export type ColumnType = 'text' | 'number' | 'select' | 'date' | 'datetime' | 'month' | 'time' | 'image' | 'nested' | 'nested-child' | 'person' | 'progress' | 'boolean' | 'checkbox' | 'status' | 'group-header' | 'group-name' | 'separator-row' | 'punch' | 'hyperlink' | 'file' | 'task-node' | 'module' | 'text-with-switcher' | 'upstream' | 'table-action-button' | (string & Record<string, never>);
 export interface ColumnConfig {
     title: string;
     key: string;
@@ -116,6 +116,9 @@ export interface ColumnConfig {
     colspan?: number;
     index?: number;
     width?: number;
+    minWidth?: number;
+    maxWidth?: number | 'unset';
+    originWidth?: number;
     parentKey?: string;
     nestedKey?: string;
     nestedChildOffset?: number;
@@ -339,12 +342,18 @@ export declare const GROUP_TABLE_CONSTANTS: {
     SEPARATOR_HEIGHT: number;
     /** Default row height for normal rows */
     NORMAL_ROW_HEIGHT: number;
-    /** Indentation per group level */
+    /** @deprecated Use LEVEL0_WIDTH / LEVEL1_WIDTH instead */
     LEVEL_INDENT: number;
-    /** Arrow icon size */
+    /** Level 0 color bar width (px) — matches DOM nested div width */
+    LEVEL0_WIDTH: number;
+    /** Level 1 color bar width (px) — matches DOM nested div width */
+    LEVEL1_WIDTH: number;
+    /** Arrow icon size (16x16, matching DOM version's i.ah-icon_singlearrowright) */
     ARROW_SIZE: number;
     /** Padding for group header content */
     GROUP_PADDING: number;
+    /** 组头 checkbox 尺寸（hover 时显示） */
+    GROUP_CHECKBOX_SIZE: number;
 };
 /**
  * Group row style configuration
@@ -358,6 +367,8 @@ export interface GroupRowStyle {
     level2BgColor: string;
     /** Text color for group headers */
     textColor: string;
+    /** Border color for group color bar right edge */
+    barBorderColor: string;
     /** Font weight for group headers */
     fontWeight: string;
     /** Font size for group headers */
@@ -376,9 +387,20 @@ export interface SeparatorRowStyle {
 }
 /**
  * Default styles for grouped table
+ * 注意：使用 defaultStyleManager（静态单例，永远绑定 default 主题），
+ * 仅作为回退值。运行时应使用 getGroupStyles(grid.styleManager) 获取当前主题色。
  */
 export declare const DEFAULT_GROUP_STYLES: GroupRowStyle;
 export declare const DEFAULT_SEPARATOR_STYLES: SeparatorRowStyle;
+/**
+ * 运行时获取分组样式（根据当前主题动态计算）
+ * 在 GroupRow / RowHeader / AddTaskRow 中应优先使用此函数
+ */
+export declare function getGroupStyles(sm: import('./StyleManager').StyleManager): GroupRowStyle;
+/**
+ * 运行时获取分隔行样式（根据当前主题动态计算）
+ */
+export declare function getSeparatorStyles(sm: import('./StyleManager').StyleManager): SeparatorRowStyle;
 /**
  * 统计选项接口
  */
@@ -394,6 +416,8 @@ export interface FooterCellData {
     statisticType: string;
     /** 格式化后的显示文本，null 表示无数据 */
     value: string | null;
+    /** 是否处于 loading 状态（刷新中），控制旋转动画 */
+    loading?: boolean;
 }
 /**
  * Footer 数据，key 为列的 columnKey
@@ -419,6 +443,53 @@ export interface GroupHeaderCellClickInfo {
     clientX: number;
     /** 点击位置的 clientY */
     clientY: number;
+    /** 管线父列 key（仅 nested 子列点击时有值） */
+    moduleColKey?: string;
+    /** 单元格在视口中的边界（用于弹窗定位） */
+    cellBounds?: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+}
+/**
+ * Footer 嵌套列统计刷新回调信息
+ */
+export interface FooterStatRefreshInfo {
+    /** 嵌套子列的列标识 */
+    columnKey: string;
+    /** 列 editor 类型 */
+    editor: string;
+    /** 当前统计类型 */
+    statisticType: string;
+    /** 管线父列 key */
+    moduleColKey: string;
+    /** 点击位置的 clientX */
+    clientX: number;
+    /** 点击位置的 clientY */
+    clientY: number;
+}
+/**
+ * 组头嵌套列统计刷新回调信息
+ */
+export interface GroupHeaderStatRefreshInfo {
+    /** 嵌套子列的列标识 */
+    columnKey: string;
+    /** 列 editor 类型 */
+    editor: string;
+    /** 当前统计类型 */
+    statisticType: string;
+    /** 管线父列 key */
+    moduleColKey: string;
+    /** 分组唯一标识 */
+    groupId: string | number;
+    /** 多级分组值数组 */
+    multiValue: any[];
+    /** 点击位置的 clientX */
+    clientX: number;
+    /** 点击位置的 clientY */
+    clientY: number;
 }
 /**
  * Footer 单元格点击回调信息
@@ -436,4 +507,13 @@ export interface FooterCellClickInfo {
     clientX: number;
     /** 点击位置的 clientY */
     clientY: number;
+    /** 管线父列 key（仅 nested 子列点击时有值） */
+    moduleColKey?: string;
+    /** 单元格在视口中的边界（用于弹窗定位） */
+    cellBounds?: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
 }

package/dist/types/core/viewers/BooleanViewer.d.ts

@@ -9,6 +9,7 @@ import type { CellViewer, ViewerRenderContext, BooleanViewerData } from './types
  */
 declare class BooleanViewer implements CellViewer<BooleanViewerData> {
     readonly type = "boolean";
+    readonly hideEditIcon = true;
     /**
      * Handle click on boolean cell
      * Returns true if the click was on the checkbox/switch area

package/dist/types/core/viewers/FileViewer.d.ts

@@ -53,6 +53,7 @@ declare class FileViewer implements CellViewer<FileViewerData> {
     /**
      * 缩略图模式布局（参考 ImageViewer）：图片高度占满行高，宽度根据原图宽高比自适应
      * 如果图片尚未加载完成（不知道宽高比），先用正方形占位
+     * 如果所有图片总宽度超出可用宽度，等比缩放所有图片（与 ImageViewer.drawMultipleImages 一致）
      */
     private calculateThumbnailModeLayout;
     /**