ice-web-components 1.0.0

package/dist/types/components/ICESlider.d.ts

@@ -0,0 +1,63 @@
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 滑块：单值 / 区间双滑块，支持 `step` 量化与方向键微调。
+ */
+export declare class ICESlider extends ICEWidget {
+    private model;
+    private track;
+    private fill;
+    private thumb;
+    private upperThumb;
+    private range;
+    private rangeValue;
+    private step;
+    private activeThumb;
+    private dragThumb;
+    private minValue;
+    private maxValue;
+    private dragging;
+    private __bound;
+    constructor(props?: any);
+    /** 是否区间模式（双滑块）。 */
+    isRange(): boolean;
+    setValue(value: number): this;
+    getValue(): number;
+    /** 区间取值 [下界, 上界]；单值模式返回 null。 */
+    getRangeValue(): [number, number] | null;
+    /** 设置区间：各自夹取到 [min,max]，反序时自动交换。 */
+    setRangeValue(value: [number, number] | number[]): this;
+    getThumbs(): any[];
+    /** 当前操作中的滑块（键盘调整 / 拖动高亮用）。 */
+    getActiveThumb(): 'lower' | 'upper';
+    setActiveThumb(thumb: 'lower' | 'upper'): this;
+    /**
+     * 按比例（0..1）落值。
+     *
+     * - 单值模式：直接设置；
+     * - 区间模式：`thumb` 省略时取「离哪个滑块近」，拖动过程中由调用方传入锁定的滑块，
+     *   两个滑块互相夹取、不会穿过（与 Ant Range 一致）。
+     */
+    setValueFromRatio(ratio: number, thumb?: 'lower' | 'upper'): this;
+    getFormValue(): any;
+    setFormValue(value: any): void;
+    protected afterAddHandler(): void;
+    private __bindGlobalEvents;
+    private __onGlobalMouseDown;
+    private __onGlobalMouseMove;
+    private __onGlobalMouseUp;
+    /** 方向键按 step 调值（区间模式调当前滑块，默认下界）。 */
+    private __onKeyDown;
+    private __isPointInside;
+    private __updateFromEvent;
+    protected __applyHoverState(): void;
+    /** 按 step 相对 min 量化；step ≤ 0 时保持连续取值。 */
+    private __quantize;
+    /** 把任意入参整理成 [下界, 上界]（量化 + 夹取 + 反序交换）。 */
+    private __normalizeRange;
+    private __ratio;
+    private __thumbStyle;
+    private __thumbLeft;
+    private __upperThumbLeft;
+    private __fillWidth;
+    private __sync;
+}

package/dist/types/components/ICESpace.d.ts

@@ -0,0 +1,51 @@
+import { ICEContainer } from '../core/ICEContainer';
+/**
+ * 间距容器（Ant Space / Flex 的最小版）：按固定间距排列一组子组件。
+ *
+ * - `direction: 'horizontal'`（默认）横向排列，`'vertical'` 纵向排列；
+ * - `size` 是子项间距（默认 8）；
+ * - 交叉轴对齐 `align: 'start' | 'center' | 'end'`；
+ * - `wrap: true` 时横向超出容器宽度换行；
+ * - 不传 width / height 时按内容自适应，加了子项就自动重排。
+ *
+ * 注：布局本身由本组件完成（不是引擎的 `ICEFlowLayout`）——因为 Space 需要同时处理
+ * 交叉轴对齐与「按内容回写自身尺寸」，这两件事引擎布局器不管。
+ */
+export interface ICESpaceOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    direction?: 'horizontal' | 'vertical';
+    /** 子项间距，默认 8 */
+    size?: number;
+    align?: 'start' | 'center' | 'end';
+    wrap?: boolean;
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+}
+export declare class ICESpace extends ICEContainer {
+    private items;
+    private direction;
+    private gap;
+    private align;
+    private wrap;
+    private autoWidth;
+    private autoHeight;
+    constructor(props?: ICESpaceOptions);
+    /** 子项列表（按加入顺序）。 */
+    getItems(): any[];
+    setSize(size: number): this;
+    getSize(): number;
+    setAlign(align: 'start' | 'center' | 'end'): this;
+    /** 加入一个子项并立即重排。 */
+    addItem(child: any): this;
+    /** 直接 `addChild` 也当作子项处理（保持容器语义）。 */
+    addChild(child: any, markDirty?: boolean): void;
+    removeItem(child: any): this;
+    revalidate(): this;
+    /** 交叉轴偏移。 */
+    private __crossOffset;
+    private __layout;
+    private __markDirty;
+}

package/dist/types/components/ICESpin.d.ts

@@ -0,0 +1,33 @@
+import { ICEPath } from 'ice-render';
+import { ICEWidget } from '../core/ICEWidget';
+/** 旋转弧线：用 Path2D 画一段 270° 圆弧，颜色走主色。 */
+declare class ICESpinArc extends ICEPath {
+    constructor(props?: any);
+    protected createPathObject(): any;
+}
+/**
+ * 加载指示器（Ant Spin 的最小版）：一段圆弧绕中心旋转。
+ *
+ * - 旋转复用引擎的动画系统（`transform.rotate` 0→360 循环），与蚂蚁线同一套路；
+ * - `spinning: false` 停止旋转（弧线保持显示）；`tip` 可在右侧显示提示文字。
+ */
+export interface ICESpinOptions {
+    size?: number;
+    spinning?: boolean;
+    tip?: string;
+    color?: string;
+    left?: number;
+    top?: number;
+}
+export declare class ICESpin extends ICEWidget {
+    private arc;
+    private spinning;
+    constructor(props?: ICESpinOptions);
+    protected afterAddHandler(): void;
+    isSpinning(): boolean;
+    getArcNode(): ICESpinArc;
+    setSpinning(spinning: boolean): this;
+    private __startSpin;
+    private __stopSpin;
+}
+export {};

package/dist/types/components/ICESplitter.d.ts

@@ -0,0 +1,85 @@
+import { ICEWidget } from '../core/ICEWidget';
+/** 分隔条：悬停 / 拖动时高亮（视觉状态自己维护，父组件只管拖动逻辑）。 */
+declare class ICESplitterDivider extends ICEWidget {
+    private active;
+    constructor(props?: any);
+    setActive(active: boolean): this;
+    protected __applyHoverState(): void;
+    private __sync;
+}
+/**
+ * 分隔面板（Ant Splitter）：两栏 + 可拖动的分隔条。
+ *
+ * - `direction: 'horizontal'`（默认）左右分栏，`'vertical'` 上下分栏；
+ * - `size` 是第一栏的像素尺寸，夹取范围 `[min, 容器尺寸 - dividerSize - min]`；
+ * - 拖动分隔条改变尺寸（mousedown 必须落在分隔条上），拖动中触发 `resize`
+ *   （载荷 `{ size }`）与 `onResize`；
+ * - 两栏是调用方传进来的组件，本组件只负责摆位置与改尺寸。
+ */
+export interface ICESplitterOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    /** horizontal = 左右分栏（默认），vertical = 上下分栏 */
+    direction?: 'horizontal' | 'vertical';
+    /** 第一栏尺寸（像素） */
+    size?: number;
+    /** 两栏最小尺寸，默认 40 */
+    min?: number;
+    /** 分隔条粗细，默认 6 */
+    dividerSize?: number;
+    /** 第一栏组件 */
+    first?: any;
+    /** 第二栏组件 */
+    second?: any;
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+    onResize?: (size: number) => void;
+}
+export declare class ICESplitter extends ICEWidget {
+    private direction;
+    /** 调用方要的尺寸（不被「当下容器的夹取」覆盖，容器变大后能恢复） */
+    private requestedSize;
+    private size;
+    private min;
+    private dividerSize;
+    private first;
+    private second;
+    private divider;
+    private onResize;
+    private dragging;
+    private bound;
+    private laying;
+    constructor(props: ICESplitterOptions);
+    /** 当前第一栏尺寸。 */
+    getSize(): number;
+    /** 第一栏占比（0..1）。 */
+    getRatio(): number;
+    setRatio(ratio: number): this;
+    setSize(size: number): this;
+    getDividerNode(): ICESplitterDivider;
+    getFirstNode(): any;
+    getSecondNode(): any;
+    protected afterAddHandler(): void;
+    /** 自身尺寸变化后重排两栏（引擎在 setState 尺寸变化时会调这个钩子）。 */
+    revalidate(): this;
+    /** 自身尺寸被程序式改动（setState）时也要重排两栏（引擎只回调这个钩子）。 */
+    protected __afterStateMerge(sizeChanged: boolean): void;
+    protected __applyHoverState(): void;
+    /** 拖动手柄的可视反馈。 */
+    private __syncDivider;
+    /** 第一栏可用的最大尺寸：容器减去分隔条与第二栏最小尺寸。 */
+    private __max;
+    private __total;
+    private __clamp;
+    private __layout;
+    private __onGlobalMouseDown;
+    private __onGlobalMouseMove;
+    private __onGlobalMouseUp;
+    /** 是否可拖动：分隔条自身 + 2px 容错（细条不好瞄）。 */
+    isDragging(): boolean;
+    private __isOnDivider;
+    private __updateFromEvent;
+}
+export {};

package/dist/types/components/ICEStatCard.d.ts

@@ -0,0 +1,14 @@
+import { ICEPanel } from './ICEPanel';
+/**
+ * 统计卡：图标 + 标题 + 数值 + 涨跌趋势，用于仪表盘顶部指标。
+ */
+export declare class ICEStatCard extends ICEPanel {
+    private valueNode;
+    private titleNode;
+    private trendNode;
+    private iconNode;
+    constructor(props?: any);
+    setValue(value: string | number): this;
+    setTitle(title: string): this;
+    setTrend(trend: string): this;
+}

package/dist/types/components/ICEStatistic.d.ts

@@ -0,0 +1,78 @@
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 数值格式化：精度 + 可选千分位；非数字（如「暂缺」）原样返回。
+ * 负数先取绝对值分组，再把符号补回去（`-1234567.5` → `-1,234,567.5`）。
+ */
+export declare function formatStatisticValue(value: number | string, precision?: number, group?: boolean): string;
+/**
+ * 倒计时格式：`N 天 HH:mm:ss`；不足一天时省略「N 天」。
+ * 负数按 0 处理（归零后不再显示 -00:00:01 这种反人类文案）。
+ */
+export declare function formatCountdown(ms: number): string;
+/**
+ * 统计数值（Ant Statistic）：标题 + 大号数字 + 前缀/后缀，支持千分位与精度。
+ *
+ * 传 `countdown`（剩余毫秒）时进入倒计时模式：按「N 天 HH:mm:ss」显示剩余时间，
+ * 归零触发 `finish` 事件与 `onFinish` 回调（Ant 的 `Statistic.Countdown`）。
+ */
+export interface ICEStatisticOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    title?: string;
+    value?: number | string;
+    /** 小数位数，默认 0 */
+    precision?: number;
+    /** 千分位分隔，默认 false */
+    groupSeparator?: boolean;
+    prefix?: string;
+    suffix?: string;
+    /** 数值颜色状态（默认正文色） */
+    status?: 'default' | 'primary' | 'success' | 'warning' | 'error' | 'info';
+    /** 倒计时剩余毫秒；给了就进入倒计时模式 */
+    countdown?: number;
+    /** 倒计时是否自动开始（默认 true；测试里可关掉，避免挂定时器） */
+    autoStart?: boolean;
+    /** 倒计时归零回调（与 `finish` 事件同义） */
+    onFinish?: () => void;
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+    fontSize?: number;
+}
+export declare class ICEStatistic extends ICEWidget {
+    private titleNode;
+    private valueNode;
+    private precision;
+    private group;
+    private prefix;
+    private suffix;
+    private countdownMode;
+    private remaining;
+    private running;
+    private handle;
+    private onFinish;
+    private rawValue;
+    constructor(props: ICEStatisticOptions);
+    getTitleText(): string;
+    getValueText(): string;
+    setTitle(title: string): this;
+    /** 普通模式：改数值（字符串原样显示）。 */
+    setValue(value: number | string): this;
+    getValue(): number | string;
+    isCountdown(): boolean;
+    getRemaining(): number;
+    isRunning(): boolean;
+    /**
+     * 设置剩余毫秒。≤ 0 视为归零：文案变 `00:00:00`，停止计时并触发完成回调。
+     */
+    setCountdown(ms: number): this;
+    /** 开始（或继续）倒计时。 */
+    start(): this;
+    /** 暂停倒计时（保留剩余时间）。 */
+    stop(): this;
+    private __stopTween;
+    private __syncCountdownText;
+    private __syncValueText;
+    private __finish;
+}

package/dist/types/components/ICESteps.d.ts

@@ -0,0 +1,31 @@
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 步骤条（Ant Steps）：横向序号 + 标题/描述 + 连接线，当前步骤高亮、已完成打勾。
+ */
+export interface ICEStepsItem {
+    title: string;
+    description?: string;
+}
+export interface ICEStepsOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    items: ICEStepsItem[];
+    current?: number;
+    left?: number;
+    top?: number;
+    width?: number;
+    circleSize?: number;
+    onChange?: (current: number) => void;
+}
+export declare class ICESteps extends ICEWidget {
+    private items;
+    private current;
+    private circleSize;
+    private stepNodes;
+    private onChange;
+    constructor(props: ICEStepsOptions);
+    getCurrent(): number;
+    setCurrent(current: number): this;
+    getStepNode(index: number): ICEWidget | null;
+    private __render;
+}

package/dist/types/components/ICESvgIcon.d.ts

@@ -0,0 +1,9 @@
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * SVG 路径图标：给一段 `d` 路径数据，按 `viewBox` 缩放到目标尺寸并描边。
+ */
+export declare class ICESvgIcon extends ICEWidget {
+    private pathNode;
+    constructor(props?: any);
+    setColor(color: string): this;
+}

package/dist/types/components/ICESwitch.d.ts

@@ -0,0 +1,23 @@
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 开关：点击或 Enter/Space 切换，滑块带过渡动画，触发 `change`。
+ */
+export declare class ICESwitch extends ICEWidget {
+    private model;
+    private track;
+    private knob;
+    private knobTravel;
+    constructor(props?: any);
+    isSelected(): boolean;
+    setSelected(selected: boolean): this;
+    getFormValue(): any;
+    setFormValue(value: any): void;
+    /** 键盘激活（Enter / Space）与鼠标点击同义：切换开关。 */
+    activate(): void;
+    protected initEvents(): void;
+    /** 禁用的控件不响应鼠标（与 `activate()` 的键盘路径保持一致）。 */
+    private __toggle;
+    protected __applyHoverState(): void;
+    private __sync;
+    private __knobGap;
+}

package/dist/types/components/ICETable.d.ts

@@ -0,0 +1,250 @@
+import { ICEWidget } from '../core/ICEWidget';
+import { ICECheckBox } from './ICECheckBox';
+import { ICEPagination } from './ICEPagination';
+import { ICEDropTarget } from '../util/ICEDragReorder';
+export declare type ICETableColumn = {
+    key: string;
+    title: string;
+    width?: number;
+    /** 固定列：横向滚动时钉在左边不跟着滚（宽表的常用约定） */
+    fixed?: boolean;
+    /** 拖拽缩列时的最小宽度（不传用表格的 `minColumnWidth`，默认 60） */
+    minWidth?: number;
+    align?: 'left' | 'center' | 'right';
+    /** 表头可排序：`true` 用默认比较（数值按数值、其余按字典序），或传自定义比较函数 */
+    sorter?: boolean | ((a: ICETableRow, b: ICETableRow) => number);
+    renderCell?: (value: string, row: ICETableRow, column: ICETableColumn, meta: {
+        cellWidth: number;
+        cellHeight: number;
+        align: 'left' | 'center' | 'right';
+    }) => any | null;
+};
+export declare type ICETableRow = Record<string, any>;
+/**
+ * 列宽求解（纯函数，方便单测）。
+ *
+ * 规则：
+ * - 显式 `width` 优先，且不低于 `minWidth`；
+ * - 剩下的宽度在所有「自动列」（没给 width 的）之间均分；
+ * - 均分后仍小于最小宽度的，抬到最小宽度 —— 此时**总和可能超过 totalWidth**，
+ *   这是有意的（宽表就该横向溢出，由调用方决定要不要横向滚动），不在函数里悄悄压扁。
+ */
+export declare function resolveColumnWidths(columns: Array<{
+    width?: number;
+    minWidth?: number;
+}>, totalWidth: number, defaultMinWidth?: number): number[];
+export interface ICETableSortState {
+    key: string;
+    order: 'asc' | 'desc';
+}
+export interface ICETablePaginationOptions {
+    pageSize?: number;
+    /** 初始页码（从 1 开始） */
+    page?: number;
+    showTotal?: boolean;
+    /** 换页回调（与 `pagechange` 事件同义） */
+    onChange?: (page: number, pageSize: number) => void;
+}
+export declare type ICETableSelectionMode = 'none' | 'single' | 'multiple';
+/**
+ * 表格：列定义（宽度 / 对齐 / 排序 / 自定义单元格）+ 行选择 + 分页 + 空态 + 悬停/斑马纹。
+ *
+ * - 点表头排序：升 → 降 → 恢复，`sorter` 可为布尔或自定义比较函数；
+ * - 行选择 `rowSelection: 'none' | 'single'（默认）| 'multiple'`：多选时最左侧多出
+ *   40px 选择列（表头全选 + 每行复选框），`getSelectedRows()` / `selectAll()` /
+ *   `clearSelection()` 配合批量操作；选择变化触发 `selectionchange` 与 `onSelectionChange`；
+ * - `pagination: { pageSize, page, showTotal, onChange }`：只渲染当前页并挂出 `ICEPagination`；
+ * - 没有数据时渲染 `ICEEmpty` 空态（不会留一片空白）。
+ */
+export declare class ICETable extends ICEWidget {
+    private columns;
+    /** 原始数据（排序前的顺序，用于第三次点击恢复） */
+    private sourceData;
+    /** 排序后的全量数据（分页从这里切片） */
+    private sortedData;
+    /** 当前页要渲染的行（不分页时等于 sortedData） */
+    private data;
+    private pageSize;
+    private page;
+    private paginationOptions;
+    private paginationNode;
+    private sortKey;
+    private sortOrder;
+    private rowPanels;
+    private cellNodes;
+    private selectedIndex;
+    /** 多选模式下的选中行（当前页内的下标，按行序） */
+    private selectedIndexes;
+    private selectionMode;
+    private selectionNodes;
+    private headerCheckbox;
+    private onSelectionChange;
+    /** 选择列宽度（多选时内容列整体右移这么多） */
+    private static readonly SELECTION_WIDTH;
+    /** 上一次渲染用的宽度：宽度变了要多渲染一次（否则列宽不更新） */
+    private renderedWidth;
+    /** 鼠标悬停行（-1 = 无）；只影响底色，不影响选中 */
+    private hoveredIndex;
+    private rowHeight;
+    private headerHeight;
+    private onSelect;
+    /** 拖拽缩列后的宽度覆盖（列 key → 宽度）；不动原始 columns 定义 */
+    private columnWidthOverrides;
+    /** 是否允许拖表头边界缩列 */
+    private resizable;
+    private minColumnWidth;
+    private onColumnResize;
+    /** 拖拽状态：{ key, index, startX, startWidth } */
+    private resizeState;
+    /** 可滚动模式：虚拟行（`virtual`）或存在固定列时启用；旧路径保持原样 */
+    private scrollable;
+    private virtual;
+    private bodyPane;
+    private headerPane;
+    private bodyContent;
+    private frozenLayer;
+    private frozenContent;
+    private rowWindow;
+    private virtualScrollTop;
+    private virtualScrollLeft;
+    private rowNodes;
+    private frozenRowNodes;
+    private virtualBuffer;
+    /** 可滚动模式下的内容宽度（列多到装不下时 > 视口宽度） */
+    private renderedContentWidth;
+    /** 行拖拽排序：开启后按住行上下拖就能改顺序 */
+    private rowDraggable;
+    private onRowReorder;
+    /** 拖拽状态：源行下标 + 当前落点 + 指示线节点 */
+    private dragRow;
+    private __bound;
+    constructor(props?: any);
+    setData(data: ICETableRow[]): this;
+    /** 全量行数（排序后、分页前的总数）。 */
+    getTotalRows(): number;
+    /** 总页数；不分页时为 1。 */
+    getPageCount(): number;
+    getPage(): number;
+    getPageSize(): number;
+    /** 换页：夹取到 [1, pageCount]，重新渲染并回调。 */
+    setPage(page: number): this;
+    setPageSize(pageSize: number): this;
+    /** 分页器节点（不分页 / 空数据时为 null）。 */
+    getPaginationNode(): ICEPagination | null;
+    /** 当前渲染顺序的数据（排序后）。 */
+    getRows(): ICETableRow[];
+    getSortState(): ICETableSortState | null;
+    /** 表头文案（排序中的列带 ▲/▼ 指示）。 */
+    getHeaderLabel(key: string): string;
+    /** 点表头：升序 → 降序 → 恢复原始顺序。 */
+    toggleSort(key: string): this;
+    /** 显式设置排序（`order: null` 恢复原始顺序）。 */
+    sortBy(key: string, order: 'asc' | 'desc' | null): this;
+    /** 按当前页/每页条数切出要渲染的行，并把高度（含分页器 / 空态）算好。 */
+    private __applyPage;
+    /** 分页器区域高度（分页器本体 32 + 上下留白）。 */
+    private __footerHeight;
+    setSelectedRow(index: number): this;
+    getSelectedIndex(): number;
+    getSelectionMode(): ICETableSelectionMode;
+    getSelectedIndexes(): number[];
+    /** 选中的行（多选按行序返回）。 */
+    getSelectedRows(): ICETableRow[];
+    /** 批量设置选中行（多选模式用；单选模式只认第一个）。 */
+    setSelectedIndexes(indexes: number[]): this;
+    selectAll(): this;
+    clearSelection(): this;
+    getSelectionNode(index: number): ICECheckBox | null;
+    getHeaderCheckbox(): ICECheckBox | null;
+    protected afterAddHandler(): void;
+    private __bindGlobalEvents;
+    private __onGlobalMouseDown;
+    /**
+     * 宽松数值解析：容忍千分位与常见货币/百分号（`$1,240.00`、`12%`、`-3.5`）。
+     * 解析不出来返回 null，交给字符串比较。
+     */
+    private __toNumber;
+    /** 默认比较：两侧都能解析成数字（含货币/千分位/百分号）时按数值，否则按字符串。 */
+    private __compareRows;
+    private __render;
+    /**
+     * @overwrite 宽度变化时重算列宽。
+     *
+     * `__render()` 只在 setData / 排序 / 分页时跑，而窗口缩放、分栏拖动只会改 `state.width`；
+     * 引擎在 setState 后只回调 `__afterStateMerge`（不会调 `revalidate`），所以钩子挂在这里。
+     * 不补这次渲染，列宽会停留在旧值 —— 表现为单元格文字互相重叠。
+     */
+    protected __afterStateMerge(sizeChanged: boolean): void;
+    /** 建一行（普通模式与虚拟模式共用；top 由调用方给，虚拟模式里相对滚动内容）。 */
+    /**
+     * 可滚动模式的渲染：表头与表体各自一个 `ICEScrollPane`（横向同步），
+     * 表体只渲染可视行窗口（虚拟行），有固定列时再叠一层不横向滚动的冻结层。
+     */
+    private __renderScrollable;
+    /** 按当前滚动位置重算可视行窗口：窗口外的行面板拆掉，窗口内的补上。 */
+    private __syncRowWindow;
+    /** 行被拆掉时，把它名下的单元格记录也清掉（否则 `cellNodes` 会随滚动无限增长）。 */
+    private __forgetRowCells;
+    private __createRowPanel;
+    private __placeCells;
+    private __layoutCells;
+    private __columnWidths;
+    /** 当前各列实际宽度（按列 key 给，方便断言与持久化）。 */
+    getColumnWidths(): Record<string, number>;
+    /**
+     * 手动设置某列宽度（拖拽缩列走的就是它）：宽度按 `minWidth` 夹取，改完重排整张表。
+     * 返回是否真的变了（相同宽度不会白重排）。
+     */
+    setColumnWidth(key: string, width: number): boolean;
+    isResizable(): boolean;
+    isResizing(): boolean;
+    isVirtual(): boolean;
+    isScrollable(): boolean;
+    /** 当前可视行窗口（`[start, end)`，虚拟模式专用；普通模式返回整段）。 */
+    getRowRange(): {
+        start: number;
+        end: number;
+        count: number;
+    };
+    /** 真正建出来的行数（虚拟模式下的节点数上界，QA 拿它守「不会全量渲染」）。 */
+    getRenderedRowCount(): number;
+    getScroll(): {
+        x: number;
+        y: number;
+    };
+    /** 内容总高度（虚拟模式下 = 行数 × 行高）。 */
+    getContentHeight(): number;
+    /** 固定列的总宽度（没有固定列就是 0）。 */
+    getFrozenWidth(): number;
+    setScrollTop(y: number): this;
+    setScrollLeft(x: number): this;
+    /** 把某一行滚进视口（贴顶）。 */
+    scrollToRow(index: number): this;
+    isRowDraggable(): boolean;
+    isRowDragging(): boolean;
+    /** 当前落点（拖拽中才有值；QA 用它断言指示线跟手）。 */
+    getDropTarget(): ICEDropTarget | null;
+    /**
+     * 把第 `from` 行移到落点处（拖拽松手时调用；也可以直接调它做「上移/下移」按钮）。
+     *
+     * 移动的是**当前渲染顺序**（`sortedData`）；没有激活排序时同步 `sourceData`，
+     * 这样第 n 次点表头恢复原序时拿到的是新顺序。返回是否真的动了。
+     */
+    moveRow(from: number, target: ICEDropTarget): boolean;
+    /** 指针在行区域里的纵向坐标 → 行下标（可滚动模式要把滚动偏移加回来）。 */
+    private __rowIndexAt;
+    private __startRowDrag;
+    /** 指示线挂在哪：可滚动模式挂内容盒（跟着滚动走），否则挂表格自己。 */
+    private __dropHost;
+    private __updateRowDrag;
+    private __endRowDrag;
+    /** 表头边界拖拽句柄：透明条，命中区 ±4px。 */
+    private __createResizeHandles;
+    private __startResize;
+    private __onGlobalMouseMove;
+    private __onGlobalMouseUp;
+    private __format;
+    private __syncSelection;
+    /** 广播选择变化（多选批量操作用）。 */
+    private __emitSelection;
+}

package/dist/types/components/ICETabs.d.ts

@@ -0,0 +1,17 @@
+import { ICEContainer } from '../core/ICEContainer';
+/**
+ * 标签页：一组互斥按钮，`onChange` 通知切换（程序式 `setActiveIndex` 不触发回调）。
+ */
+export declare class ICETabs extends ICEContainer {
+    private buttons;
+    private activeIndex;
+    private tabs;
+    private onChangeCallback;
+    constructor(props?: any);
+    getActiveIndex(): number;
+    setActiveIndex(index: number): this;
+    getTabs(): string[];
+    /** 用户点击切页（`setActiveIndex` 是程序式设置，不触发 onChange）。 */
+    private __activate;
+    private __applyActive;
+}

package/dist/types/components/ICETag.d.ts

@@ -0,0 +1,15 @@
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 标签：默认 Bootstrap 实底（`.text-bg-*`），`variant: 'soft'` 切浅底 + 强调文字。
+ */
+export declare class ICETag extends ICEWidget {
+    private textNode;
+    private statusColors;
+    /** `solid` = Bootstrap `.text-bg-*` 实底（默认）；`soft` = subtle 浅底 + 强调文字 */
+    private variant;
+    constructor(props?: any);
+    setText(text: string): this;
+    protected __applyHoverState(): void;
+    private __mix;
+    private __hex;
+}