arthub-table 0.2.72 → 0.2.73-next.0

package/dist/types/adapters/columnAdapter.d.ts

@@ -51,6 +51,7 @@ export interface ITableHeader {
     showFilterIcon?: boolean;
     /** 筛选命中该列时为 true：筛选图标常驻显示且显示激活色 */
     filterIconActive?: boolean;
+    viewerConfig?: Record<string, any>;
 }
 /**
  * AssetMatrix ViewerNames 到 DataGrid ColumnType 的映射表

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

@@ -1130,6 +1130,7 @@ declare class DataGrid {
     _configHeight?: number | string;
     private _baseColumnWidths;
     private _lastRawColumns;
+    private _frozenDegradedKeys;
     private _columnsChangedSinceLastLoad;
     fixedLeftWidth: number;
     fixedRightWidth: number;
@@ -1664,6 +1665,27 @@ declare class DataGrid {
     /**
      * 事件相关------------------------------------------------------->
      */
+    /**
+     * 冻结预算：计算当前视口下应被降级的 fixedLeft 列 key 集合。
+     * 预算口径 = this.width - originFixedWidth（行头区） - 右冻结区（含 SCROLLER_TRACK_SIZE），
+     * 与原 loadColumns 超宽校验口径严格一致；从左到右保留放得下的冻结列。
+     * this.width <= 0（构造早期/隐藏态）返回空集，交给 getTableSize cap 兜底。
+     */
+    private _computeDegradedKeys;
+    /** 列宽口径与 _baseColumnWidths 快照一致：嵌套列取子列宽之和 */
+    private _frozenBudgetColWidth;
+    /**
+     * 冻结预算降级：放不下的 fixedLeft 列克隆并去除冻结标记（不污染外部列配置），
+     * 本次渲染作为普通列参与横向滚动——能显示多少显示多少。
+     * 降级集合变化且非空时触发 onFrozenColumnOverflow，通知业务修正持久化配置。
+     */
+    private _applyFrozenBudget;
+    /**
+     * resize 链路：容器宽度变化后重新评估冻结预算。
+     * 降级集合有变化（变宽恢复冻结 / 变窄降级更多）时从原始列配置重建列，
+     * 调用方（resize / 构造）随后会 header.paint()，无需在此重绘。
+     */
+    private _reevaluateFrozenBudget;
     updateColumns(columns: Column[]): void;
     loadColumns(columns: Column[]): void;
     /**

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

@@ -3,7 +3,7 @@
  * Displays task names with tree hierarchy, expand/collapse buttons,
  * task icons, child count badges, and error/warning indicators
  */
-import type { CellViewer, ViewerRenderContext, TextViewerWithSwitcherData } from './types';
+import type { CellViewer, TextViewerWithSwitcherData, ViewerRenderContext } from './types';
 /**
  * TextViewerWithSwitcher renders task names with tree hierarchy
  * Supports expand/collapse, task icons, child count, error indicators
@@ -23,6 +23,7 @@ declare class TextViewerWithSwitcher implements CellViewer<TextViewerWithSwitche
     private _sm;
     private arrowColoredCanvas;
     private arrowColoredColor;
+    private childCountIconColoredCanvases;
     constructor();
     /**
      * Preload SVG icons
@@ -108,6 +109,10 @@ declare class TextViewerWithSwitcher implements CellViewer<TextViewerWithSwitche
      * Calculate right reserved width for totalNum, downstream, and error icons
      */
     private calcRightReservedWidth;
+    private normalizeOpacity;
+    private normalizeChildCountTextPart;
+    private resolveChildCountRender;
+    private calcChildCountRenderWidth;
     /**
      * Draw right area: totalNum icon, downstream indicator, error/warning icon
      */
@@ -122,6 +127,9 @@ declare class TextViewerWithSwitcher implements CellViewer<TextViewerWithSwitche
      * @returns New right X position (moving leftward)
      */
     private drawTotalNum;
+    private drawCustomTotalNum;
+    private drawChildCountTextPart;
+    private drawChildCountIcon;
     /**
      * Draw downstream node indicator (icon_history1.svg, colored #ffb74d, 16x16)
      * @returns New right X position (moving leftward)

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

@@ -660,6 +660,26 @@ export interface ModuleViewerData extends CellViewerData {
 /**
  * Text viewer with switcher data (tree expand/collapse + task name)
  */
+export interface TextViewerChildCountTextPart {
+    text: string | number;
+    color?: string;
+    opacity?: number;
+}
+export interface TextViewerChildCountIconPart {
+    color?: string;
+    opacity?: number;
+}
+export interface TextViewerChildCountRenderResult {
+    text?: string | number | TextViewerChildCountTextPart;
+    prefix?: string | number | TextViewerChildCountTextPart;
+    icon?: TextViewerChildCountIconPart;
+}
+export type TextViewerChildCountRenderer = (params: {
+    data: CellViewerData & Record<string, any>;
+    rowData?: Record<string, any>;
+    count: number;
+    defaultText: string;
+}) => TextViewerChildCountRenderResult | string | number | null | undefined;
 export interface TextViewerWithSwitcherData extends CellViewerData {
     value: string | number | null;
     /** Display label (overrides value when present) */
@@ -682,6 +702,8 @@ export interface TextViewerWithSwitcherData extends CellViewerData {
     iconFile?: string;
     /** Child node count */
     count?: number;
+    /** Optional column-level child-count render resolver. Defaults to the existing icon + count. */
+    renderChildCount?: TextViewerChildCountRenderer;
     /** Whether the node has downstream nodes */
     hasDownstreamNode?: boolean;
     /** Rich text HTML content */

package/dist/types/index.d.ts

@@ -10,7 +10,7 @@ export { install };
 export default DataGrid;
 export type { CellData, CellStyle, RowData, ColData, DataGridOptions, Position, Size, Rect, Range, CellRange, HistoryItem, ValidatorRule, ColumnType, ColumnConfig, SelectorState, EditorState, AutofillState, RangeState, DrawOptions, TextOptions, ClipboardState, EventHandlers, Direction, ScrollDirection, GroupLevel, SeparateLevel, BaseGroupedRowData, GroupRowData, SeparateRowData, NormalRowData, GroupedTableRowData, GroupRowStyle, SeparatorRowStyle, StatisticOption, FooterCellData, FooterData, FooterCellClickInfo, } from './core/types';
 export { isGroupRow, isSeparateRow, isNormalRow, isRowSelectable, GROUP_TABLE_CONSTANTS, DEFAULT_GROUP_STYLES, DEFAULT_SEPARATOR_STYLES, } from './core/types';
-export type { CellBounds, ViewerRenderContext, ViewerDragState, CellViewer, CellViewerData, ViewerOption, ViewerStyle, TextViewerData, DropdownViewerData, ImageViewerData, PreImageViewerData, PersonViewerData, PersonInfo, ProgressViewerData, DatetimeViewerData, BooleanViewerData, StatusViewerData, StatusOption, GroupHeaderViewerData, GroupNameViewerData, GroupNameTagItem, GroupNamePersonItem, SeparatorRowViewerData, PunchViewerData, PunchValue, ModuleInfo, ModuleViewerData, TextViewerWithSwitcherData, FileItem, FileViewerData, HyperlinkTextViewerData, IUpstreamModule, IUpstreamReminderProperties, IUpstreamSyncProperty, IUpstreamFieldViewItem, UpstreamViewerData, TaskNodeItem, TaskNodeViewerData, NestedGridViewerData, NestedColumnConfig, ViewerConstructor, ViewerFactory, ViewerTypeMap, ViewerType, TypedCellData, TableActionButtonOption, TableActionButtonViewerData, } from './core/viewers/types';
+export type { CellBounds, ViewerRenderContext, ViewerDragState, CellViewer, CellViewerData, ViewerOption, ViewerStyle, TextViewerData, DropdownViewerData, ImageViewerData, PreImageViewerData, PersonViewerData, PersonInfo, ProgressViewerData, DatetimeViewerData, BooleanViewerData, StatusViewerData, StatusOption, GroupHeaderViewerData, GroupNameViewerData, GroupNameTagItem, GroupNamePersonItem, SeparatorRowViewerData, PunchViewerData, PunchValue, ModuleInfo, ModuleViewerData, TextViewerChildCountTextPart, TextViewerChildCountIconPart, TextViewerChildCountRenderResult, TextViewerChildCountRenderer, TextViewerWithSwitcherData, FileItem, FileViewerData, HyperlinkTextViewerData, IUpstreamModule, IUpstreamReminderProperties, IUpstreamSyncProperty, IUpstreamFieldViewItem, UpstreamViewerData, TaskNodeItem, TaskNodeViewerData, NestedGridViewerData, NestedColumnConfig, ViewerConstructor, ViewerFactory, ViewerTypeMap, ViewerType, TypedCellData, TableActionButtonOption, TableActionButtonViewerData, } from './core/viewers/types';
 export { isTextViewerData, isDropdownViewerData, isPersonViewerData, isProgressViewerData, isNestedGridViewerData, } from './core/viewers/types';
 export { default as ViewerRegistry, getViewerRegistry, } from './core/viewers/ViewerRegistry';
 export { registerDefaultViewers, defaultViewers } from './core/viewers/index';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arthub-table",
-  "version": "0.2.72",
+  "version": "0.2.73-next.0",
   "description": "High-performance canvas-based table/grid component for Vue 3 with TypeScript support, featuring virtual scrolling, cell viewers, grouped rows, and nested grids.",
   "main": "dist/arthub-table.common.js",
   "module": "dist/arthub-table.umd.min.js",