ice-web-components 1.0.0

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

@@ -0,0 +1,8 @@
+import { ICETextField } from './ICETextField';
+/**
+ * 多行文本框：与 ICETextField 同语义（取值约定 / change 事件 / 错误态 / 焦点），
+ * 差别是允许换行（Enter 插入 `\n`）且默认更高。
+ */
+export declare class ICETextArea extends ICETextField {
+    constructor(props?: any);
+}

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

@@ -0,0 +1,80 @@
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 单行文本输入：聚焦边框、错误态、表单取值约定与键盘输入；
+ * 子类通过覆盖 `__allowNewline()` 等钩子扩展（见 ICETextArea）。
+ */
+export declare class ICETextField extends ICEWidget {
+    private textNode;
+    private value;
+    private placeholder;
+    private maxLength;
+    private __bound;
+    /**
+     * 鼠标是否正按在组件上。
+     *
+     * 为什么需要它：`mousedown` 的默认动作会（在 canvas 这种不可聚焦元素上）把焦点挪到 body，
+     * 于是「按下时就挂原生输入」会被紧接着的 blur 当成失焦、刚挂上就被拆掉。
+     * 所以鼠标路径改成**松开鼠标之后再挂**（键盘 Tab 进来时没有这个手势，照常立即挂）。
+     */
+    private __pointerDown;
+    /** 子类扩展点：是否允许多行（Enter 插入换行）。 */
+    protected allowNewline: boolean;
+    /** 聚焦期间挂载的原生输入替身（浏览器环境才有；见 ICENativeInput） */
+    private nativeInput;
+    constructor(props?: any);
+    getValue(): string;
+    getFormValue(): any;
+    setFormValue(value: any): void;
+    setValue(value: string): this;
+    getPlaceholder(): string;
+    setPlaceholder(placeholder: string): this;
+    focus(): this;
+    blur(): this;
+    /** 文本输入由控件自己的 keydown 处理（见 __onGlobalKeyDown）；Enter/Space 不额外触发 click。 */
+    activate(): void;
+    protected afterAddHandler(): void;
+    private __bindGlobalEvents;
+    private __onGlobalMouseDown;
+    /** 松开鼠标：这时候再挂原生输入，就不会被 mousedown 的默认焦点转移打掉。 */
+    private __onGlobalMouseUp;
+    private __onGlobalKeyDown;
+    private __emitChange;
+    /**
+     * 挂载原生输入替身（见 `ICENativeInput`）。
+     *
+     * 只在浏览器环境挂：没有 `document`（Node / 小程序）时直接返回，输入走原来的 keydown 路径。
+     * 组件的包围盒在「还没渲染过」（单测）时拿不到，这里兜底成 (0,0) —— 定位不准也只影响
+     * 光标的落点，不影响输入本身。
+     */
+    private __mountNativeInput;
+    /**
+     * 替身失焦时的处理。
+     *
+     * DOM 层失焦**不等于**组件失焦：`mousedown` / `click` 的默认动作、focus 管理器重新聚焦、
+     * 浏览器的一些内部行为都可能让替身瞬间丢焦点（QA 里表现为「点了输入框，输入框却立刻丢焦点，
+     * 字打不进去」）。所以这里只看**组件自己**的状态：
+     * - 组件仍然聚焦 → 把 DOM 焦点抢回来（不是我们想失焦，是别人捣乱）；
+     * - 组件已经失焦（例如点到了别的控件、焦点管理器清了焦点）→ 什么都不用做，
+     *   因为那条路径已经由 `__applyFocusState` 收起替身了。
+     */
+    private __handleNativeBlur;
+    private __unmountNativeInput;
+    /** 原生输入回写：**同值不重复触发 change**（IME 收尾时会再补一次同值事件）。 */
+    private __applyNativeValue;
+    private __isPointInside;
+    /** 当前显示的文本（含聚焦时的光标占位）。 */
+    getFieldText(): string;
+    /** 子类改动了显示相关状态后，重新渲染字段。 */
+    protected refresh(): void;
+    /**
+     * 子类扩展点：把真实值转成显示文本（密码掩码）。
+     * 光标仍然按真实值长度渲染在末尾。
+     */
+    protected formatDisplayValue(value: string): string;
+    private __normalize;
+    /** 基类在焦点变化后回调：同步边框与光标显示。 */
+    protected __applyFocusState(): void;
+    /** 校验失败时边框标红（错误文案由 ICEFormItem 渲染在下方）。 */
+    protected __applyValidateState(): void;
+    private __sync;
+}

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

@@ -0,0 +1,152 @@
+import { ICEWidget } from '../core/ICEWidget';
+import { ICEFrameDriver } from '../util/ICEAnimation';
+/**
+ * 格子图（tile map）：**一个节点画完整块网格**。
+ *
+ * 棋盘类界面（俄罗斯方块 / 贪吃蛇 / 扫雷 / 座位图 / 热力图 / 仓库货位图）如果「一格一个
+ * 组件」，200 格就是 200 个节点、每次变化全量 setState —— 脏矩形再聪明也架不住节点多。
+ * 这个组件把整块网格收进一个组件的 `doRender()`：底板由 ICEWidget 自己画（它继承的是矩形
+ * 容器），格子和高亮由这里用引擎的 ctx 直接绘制。
+ *
+ * 约定：
+ * - `setTiles` 的长度不对**直接抛**（这是编程错误，不该静默画错图）；
+ * - 数据没变不置 dirty —— 游戏每帧调它也不会白刷；
+ * - 未知调色板 key 不画（留空），所以用 `null` 表示空格最省事；
+ * - `pulse()` 用 tween 把透明度从 1 拉到 0，消行 / 吃到食物这种「闪一下」直接用它。
+ */
+/** 单个格子的绘制样式。 */
+export interface ICETileMapCellStyle {
+    fillStyle: string;
+    strokeStyle?: string;
+    lineWidth?: number;
+    radius?: number;
+    /** 有标签时用来画格子里的数字 / 文字（不填就用组件默认值） */
+    fontSize?: number;
+    fontWeight?: string;
+    fontFamily?: string;
+    textColor?: string;
+}
+/** 调色板：key → 样式。 */
+export declare type ICETileMapPalette = Record<string, ICETileMapCellStyle>;
+/** 常驻高亮（描边层，比如幽灵落点）。 */
+export interface ICETileMapHighlight {
+    row: number;
+    col: number;
+    fillStyle?: string;
+    strokeStyle?: string;
+    lineWidth?: number;
+    radius?: number;
+}
+/** 瞬时脉冲（填充层，跟随 tween 淡出）。 */
+export interface ICETileMapPulse {
+    row: number;
+    col: number;
+    /** 覆盖脉冲颜色（默认取 `pulseColor` 选项） */
+    color?: string;
+}
+export interface ICETileMapOptions {
+    id?: string;
+    left?: number;
+    top?: number;
+    rows: number;
+    cols: number;
+    /** 每格边长（含间隙），默认 20 */
+    cellSize?: number;
+    /** 格子之间的间隙，默认 2（均分在格子两边） */
+    gap?: number;
+    /** 格子圆角默认值，默认 4 */
+    cellRadius?: number;
+    /** 整块棋盘的宽高（默认 cols*cellSize / rows*cellSize；给大了就留白，便于居中摆放） */
+    width?: number;
+    height?: number;
+    palette?: ICETileMapPalette;
+    /** 脉冲默认颜色 */
+    pulseColor?: string;
+    /** 高亮默认描边色 */
+    highlightColor?: string;
+    /** 标签默认字号 / 颜色（格子样式里可以逐项覆盖） */
+    labelFontSize?: number;
+    labelColor?: string;
+    [key: string]: any;
+}
+export declare class ICETileMap extends ICEWidget {
+    private rows;
+    private cols;
+    private cellSize;
+    private gap;
+    private cellRadius;
+    private palette;
+    private tiles;
+    /** 标签层：和 tiles 一一对应的文字（2048 的数字、扫雷的雷数都靠它） */
+    private labels;
+    /** 数据签名：用来跳过「值没变」的重复设置 */
+    private tileKey;
+    private labelKey;
+    private highlights;
+    private pulses;
+    private pulseAlpha;
+    private pulseHandle;
+    private pulseColor;
+    private highlightColor;
+    private labelFontSize;
+    private labelColor;
+    /** 自绘流程执行次数（浏览器里由 render() 驱动；单测可直接调 paintBoard()） */
+    private paintCount;
+    constructor(props: ICETileMapOptions);
+    getRows(): number;
+    getCols(): number;
+    getCellSize(): number;
+    getGap(): number;
+    /** 格子在组件内的矩形（gap 均分在两边）。 */
+    getCellRect(row: number, col: number): {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    /** 组件内坐标 → 格子（边界外返回 null；落在间隙里算最近的格子）。 */
+    getCellAt(x: number, y: number): {
+        row: number;
+        col: number;
+    } | null;
+    /** 设置格子数据：一维（长度 = rows*cols）或二维（rows 行）；数字会被当成字符串 key。 */
+    setTiles(tiles: Array<string | number | null> | Array<Array<string | number | null>>): this;
+    getTiles(): Array<string | null>;
+    /** 设置标签层（和 tiles 一样长度，值可以是任意字符串）。 */
+    setLabels(labels: Array<string | number | null> | Array<Array<string | number | null>>): this;
+    getLabels(): Array<string | null>;
+    setPalette(palette: ICETileMapPalette): this;
+    /** 调色板拷贝（改返回值不会影响组件内部）。 */
+    getPalette(): ICETileMapPalette;
+    /** 某个 key 对应的样式（未知 key 返回 null = 不绘制）。 */
+    resolveCellStyle(key: string | null): ICETileMapCellStyle | null;
+    setHighlights(highlights: ICETileMapHighlight[]): this;
+    getHighlights(): ICETileMapHighlight[];
+    /** 闪一下（消行 / 吃到食物）：用 tween 把 alpha 从 1 拉到 0，结束后自动清空。 */
+    pulse(cells: ICETileMapPulse[], options?: {
+        duration?: number;
+        color?: string;
+        driver?: ICEFrameDriver;
+    }): this;
+    getPulses(): ICETileMapPulse[];
+    getPulseAlpha(): number;
+    getPaintCount(): number;
+    /** 自绘整块网格。浏览器里由 `doRender()` 自动调用；单测可以直接调来数自绘次数。 */
+    paintBoard(): void;
+    protected doRender(): void;
+    protected initEvents(): void;
+    /**
+     * 请求重画。
+     *
+     * 只置组件自己的 `dirty` 是**不够的**：引擎的渲染循环看的是 `ice.dirty`
+     * （`CanvasRenderer.frameEvtHandler` 里 `if (this.ice.dirty)` 才排队），组件的 `dirty`
+     * 只决定「这一趟要不要重画我」。自绘动画（比如 `pulse` 的 tween 每帧回调）如果只置自己的
+     * dirty，画面根本不会逐帧更新 —— 表现为白色脉冲**卡在格子上不动**，直到下一次别的原因触发重绘。
+     */
+    private requestPaint;
+    private __normalize;
+    /** 把标签居中画在格子里（字体 / 颜色优先取格子样式，其次取组件默认）。 */
+    private __drawLabel;
+    private __drawRect;
+    private __cellFromEvent;
+}

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

@@ -0,0 +1,81 @@
+import { ICEPanel } from './ICEPanel';
+import { ICEWidget } from '../core/ICEWidget';
+import { ICEScrollPane } from './ICEScrollPane';
+import { ICEOverlayManager } from '../core/ICEOverlayManager';
+/**
+ * 时间选择器（Ant TimePicker 的最小版）。
+ *
+ * - 字段区显示所选时间，未选显示 placeholder，错误态边框标红；
+ * - 浮层是「时/分/秒」三列（`format: 'HH:mm'` 时只有两列），列内用 `ICEScrollPane` 滚动，
+ *   打开时自动滚到当前取值；
+ * - 取值受步进控制（`hourStep` / `minuteStep` / `secondStep`）；
+ * - 点某个取值 → 只改该单位 → 回写值 + 关闭 + `onChange`（与 `ICEDatePicker` 的交互一致）；
+ * - 关闭策略与 Select 系列一致：浮层 closeOnOutsideClick:false，由组件自己判断点外 + Esc。
+ */
+export declare type ICETimeUnit = 'hour' | 'minute' | 'second';
+export declare type ICETimePickerFormat = 'HH:mm:ss' | 'HH:mm';
+export declare type ICETimePickerPlacement = 'bottomLeft' | 'bottomRight';
+export interface ICETimePickerOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    value?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    /** 值格式：HH:mm:ss（默认）或 HH:mm */
+    format?: ICETimePickerFormat;
+    hourStep?: number;
+    minuteStep?: number;
+    secondStep?: number;
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+    placement?: ICETimePickerPlacement;
+    onChange?: (value: string) => void;
+    manager?: ICEOverlayManager;
+}
+export declare class ICETimePicker extends ICEWidget {
+    private value?;
+    private placeholder;
+    private disabled;
+    private format;
+    private steps;
+    private placement;
+    private manager;
+    private onChangeCallback;
+    private handle;
+    private panel;
+    private fieldLabel;
+    private columnNodes;
+    private optionNodes;
+    private running;
+    constructor(props?: ICETimePickerOptions);
+    protected afterAddHandler(): void;
+    getValue(): string | undefined;
+    setValue(value: string | null | undefined): this;
+    getFormValue(): any;
+    setFormValue(value: any): void;
+    getUnits(): ICETimeUnit[];
+    /** 某一列的候选取值（补零字符串，受对应 step 控制）。 */
+    getColumnValues(unit: ICETimeUnit): string[];
+    getFieldLabel(): string;
+    isOpen(): boolean;
+    getPanel(): ICEPanel | null;
+    getColumnNode(unit: ICETimeUnit): ICEScrollPane | null;
+    getOptionNode(unit: ICETimeUnit, value: string): ICEWidget | null;
+    activate(): void;
+    toggle(): this;
+    open(): this;
+    close(): this;
+    protected __applyValidateState(): void;
+    /** 解析当前值（未选/非法时全部按 0 起算）。 */
+    private __parse;
+    private __format;
+    private __pick;
+    private __onClick;
+    private __onKeyDown;
+    private __onGlobalMouseDown;
+    private __worldBox;
+    private __syncField;
+    private __renderPanel;
+}

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

@@ -0,0 +1,33 @@
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 时间线（Ant Timeline）：竖线 + 节点圆点 + 标题/描述/时间。
+ */
+export interface ICETimelineItem {
+    title: string;
+    description?: string;
+    time?: string;
+    color?: string;
+}
+export interface ICETimelineOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    items: ICETimelineItem[];
+    left?: number;
+    top?: number;
+    width?: number;
+    itemHeight?: number;
+}
+export declare class ICETimeline extends ICEWidget {
+    private items;
+    private itemHeight;
+    private itemNodes;
+    private dots;
+    constructor(props: ICETimelineOptions);
+    getItemNodes(): ICEWidget[];
+    getDotColor(index: number): string;
+    /** 替换数据并重排（内容随选中项变化时用）。 */
+    setItems(items: ICETimelineItem[]): this;
+    /** 宽度变化时重排（理由同 ICEDescriptions：引擎只回调 __afterStateMerge）。 */
+    protected __afterStateMerge(sizeChanged: boolean): void;
+    private __render;
+}

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

@@ -0,0 +1,55 @@
+import { ICEOverlayManager } from '../core/ICEOverlayManager';
+import type { ICEOverlayPlacement } from '../util/ICEOverlayPosition';
+/** tooltip 文本字号与左右内边距（面板宽度按它估算） */
+export declare const ICE_TOOLTIP_FONT_SIZE = 12;
+export declare const ICE_TOOLTIP_PADDING_X = 8;
+/** 气泡面板宽度：按文字估算（中文 1em、拉丁 0.6em），避免长中文被压出色块外面。 */
+export declare function tooltipPanelWidth(title: string): number;
+/**
+ * 工具提示：鼠标悬停在目标组件上、延时后弹出的小浮层。
+ *
+ * - 悬停检测复用 `ICEWidget` 的 hover 状态（ICEHoverManager 命中后调 `setHovered`，
+ *   本组件监听目标的 `hoverchange` 事件）；
+ * - 弹出/关闭都有延时（Ant 的 mouseEnterDelay / mouseLeaveDelay 语义），进入延时期内离开则不弹；
+ * - 浮层定位、点外关闭、z 序全部交给 `ICEOverlayManager`（工具层，恒在组件之上）；
+ * - 浮层关闭时内容会被销毁，所以内容每次弹出都新建（`title` 字符串自动包成小面板，
+ *   或用 `content: () => component` 自定义）。
+ */
+export interface ICETooltipOptions {
+    /** 文本内容（自动包成深色小气泡） */
+    title?: string;
+    /** 自定义内容工厂：每次弹出调用一次 */
+    content?: () => any;
+    placement?: ICEOverlayPlacement;
+    /** 与目标的间距（默认 8） */
+    offset?: number;
+    mouseEnterDelay?: number;
+    mouseLeaveDelay?: number;
+    enterAnimation?: 'none' | 'fade' | 'scale';
+    /** 复用外部浮层管理器（测试注入） */
+    manager?: ICEOverlayManager;
+}
+export declare class ICETooltip {
+    private ice;
+    private target;
+    private options;
+    private manager;
+    private handle;
+    private enterTimer;
+    private leaveTimer;
+    private running;
+    constructor(ice: any, target: any, options?: ICETooltipOptions);
+    /** 绑定目标的 hover 事件（幂等）。 */
+    start(): this;
+    destroy(): this;
+    isOpen(): boolean;
+    /** 立即弹出（不走进入延时）。 */
+    show(): this;
+    /** 立即关闭。 */
+    hide(): this;
+    private __onHoverChange;
+    private __createContent;
+    private __clearTimers;
+}
+/** 便捷绑定：`attachTooltip(ice, target, options)`。 */
+export declare function attachTooltip(ice: any, target: any, options?: ICETooltipOptions): ICETooltip;

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

@@ -0,0 +1,97 @@
+import { ICEButton } from './ICEButton';
+import { ICEPanel } from './ICEPanel';
+import { ICEWidget } from '../core/ICEWidget';
+import { ICEOverlayManager } from '../core/ICEOverlayManager';
+import { ICEFocusManager } from '../core/ICEFocusManager';
+/**
+ * 漫游式引导（Ant Tour）：一步一步把用户带过关键界面。
+ *
+ * - 每一步有目标组件 + 标题 + 描述；目标被一圈主色边框框住，四周用遮罩压暗；
+ * - 面板显示「当前/总数」，带「上一步 / 下一步（最后一步为完成）/ 跳过」；
+ * - 键盘：→/Enter 下一步、← 上一步、Esc 跳过；
+ * - 关闭途径：完成（`finish()`，回调 `onFinish`）、跳过、Esc、`close()`。
+ */
+export interface ICETourStep {
+    target: any;
+    title: string;
+    description?: string;
+    /** 面板相对目标的位置，默认 bottom */
+    placement?: 'top' | 'bottom' | 'left' | 'right';
+}
+export interface ICETourOptions {
+    steps: ICETourStep[];
+    /** 初始步骤，默认 0 */
+    current?: number;
+    /** 面板宽度，默认 260 */
+    panelWidth?: number;
+    onNext?: (index: number) => void;
+    onPrev?: (index: number) => void;
+    onChange?: (index: number) => void;
+    onFinish?: () => void;
+    onClose?: (reason: 'skip' | 'esc' | 'api') => void;
+    manager?: ICEOverlayManager;
+    focusManager?: ICEFocusManager;
+}
+declare type ICETourCloseReason = 'skip' | 'esc' | 'api';
+export declare class ICETour {
+    private ice;
+    private options;
+    private manager;
+    private focus;
+    private handle;
+    private mask;
+    private highlight;
+    private panel;
+    private titleNode;
+    private descriptionNode;
+    private counterNode;
+    private prevButton;
+    private nextButton;
+    private skipButton;
+    private steps;
+    private current;
+    private finished;
+    private bound;
+    private pendingReason;
+    constructor(ice: any, options: ICETourOptions);
+    isOpen(): boolean;
+    isFinished(): boolean;
+    getCurrent(): number;
+    getCurrentStep(): ICETourStep | null;
+    getSteps(): ICETourStep[];
+    getPanel(): ICEPanel | null;
+    getMask(): ICEWidget | null;
+    getHighlightNode(): ICEWidget | null;
+    getTitleText(): string;
+    getDescriptionText(): string;
+    getCounterText(): string;
+    getNextButton(): ICEButton | null;
+    getPrevButton(): ICEButton | null;
+    getSkipButton(): ICEButton | null;
+    /** 当前高亮框（世界坐标）。 */
+    getHighlightBox(): {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    } | null;
+    setSteps(steps: ICETourStep[]): this;
+    open(index?: number): this;
+    close(reason?: ICETourCloseReason): this;
+    next(): this;
+    prev(): this;
+    /** 完成引导（最后一步的「下一步」/ 外部主动调用）。 */
+    finish(): this;
+    skip(): this;
+    private __goTo;
+    /** 重画当前步骤：聚光孔 + 高亮边框 + 引导面板。 */
+    private __renderStep;
+    /** 面板默认放在目标下方；下方放不下就翻到上方。 */
+    private __resolvePlacement;
+    private __bindKeyboard;
+    private __unbindKeyboard;
+    private __onKeyDown;
+    private __handleClosed;
+    private __visibleRect;
+}
+export {};

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

@@ -0,0 +1,68 @@
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 穿梭框（Ant Transfer 的最小版）。
+ *
+ * - 按 `targetKeys` 把 `dataSource` 分成「源 / 目标」两栏，栏内各自可滚动；
+ * - 点行切换勾选；中间按钮把勾选项整体右移 / 左移，移动后清空勾选并回调；
+ * - 没有勾选（或只有被移动方向的非法项）时按钮不可用；
+ * - `disabled` 的行不能勾选、不会被移动；值 = `targetKeys`（字符串数组，可直接进表单）。
+ */
+export interface ICETransferItem {
+    key: string;
+    title: string;
+    description?: string;
+    disabled?: boolean;
+}
+export declare type ICETransferDirection = 'left' | 'right';
+export interface ICETransferOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    dataSource: ICETransferItem[];
+    targetKeys?: string[];
+    titles?: [string, string];
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+    rowHeight?: number;
+    onChange?: (targetKeys: string[], direction: ICETransferDirection, moveKeys: string[]) => void;
+}
+export declare class ICETransfer extends ICEWidget {
+    private dataSource;
+    private targetKeys;
+    private titles;
+    private rowHeight;
+    private onChangeCallback;
+    private checked;
+    private sourceRows;
+    private targetRows;
+    private moveRightButton;
+    private moveLeftButton;
+    constructor(props: ICETransferOptions);
+    getSourceKeys(): string[];
+    getTargetKeys(): string[];
+    setTargetKeys(keys: string[]): this;
+    getFormValue(): any;
+    setFormValue(value: any): void;
+    getCheckedKeys(): string[];
+    isChecked(key: string): boolean;
+    getSourceNode(key: string): ICEWidget | null;
+    getTargetNode(key: string): ICEWidget | null;
+    getMoveRightButton(): ICEWidget | null;
+    getMoveLeftButton(): ICEWidget | null;
+    isMoveRightEnabled(): boolean;
+    isMoveLeftEnabled(): boolean;
+    moveRight(): void;
+    moveLeft(): void;
+    activate(): void;
+    protected __applyValidateState(): void;
+    private __emit;
+    /** 只保留 dataSource 里真实存在、且未禁用的 key，去重并保持传入顺序。 */
+    private __sanitize;
+    private __movable;
+    private __toggleCheck;
+    private __render;
+    private __renderPanel;
+    private __renderRow;
+    private __renderMoveButton;
+}

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

@@ -0,0 +1,107 @@
+import { ICEWidget } from '../core/ICEWidget';
+import { ICEScrollPane } from './ICEScrollPane';
+import { ICESelectionMode } from '../model/ICESelectionModel';
+/**
+ * 树（Swing JTree / Ant Tree 的最小可用版）。
+ *
+ * - 可见行 = 深度优先遍历、只展开 expandedKeys 里的节点；
+ * - 每层缩进 16px，有子节点的行显示 ▸ / ▾（点箭头只切换展开，不改选择）；
+ * - 选择走 `ICESelectionModel`（single / multiple）；
+ * - 键盘：↑/↓ 移动激活行、→ 展开（已展开则进入首个子节点）、← 折叠（叶子则回父节点）、
+ *   Enter/Space 选中；
+ * - 内容超出可视高度时自动套 `ICEScrollPane`。
+ */
+export interface ICETreeNode {
+    key: string;
+    label: string;
+    children?: ICETreeNode[];
+    disabled?: boolean;
+}
+export interface ICETreeOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    nodes: ICETreeNode[];
+    mode?: ICESelectionMode;
+    value?: string[];
+    expandedKeys?: string[];
+    defaultExpandAll?: boolean;
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+    itemHeight?: number;
+    indent?: number;
+    onSelect?: (keys: string[], node?: ICETreeNode) => void;
+    onExpand?: (expandedKeys: string[]) => void;
+    /** 开启节点拖拽（按住行拖：上 1/3 插前面、中 1/3 放进去、下 1/3 插后面） */
+    draggable?: boolean;
+    /** 拖拽落下后的回调（与 `nodedrop` 事件同义） */
+    onDrop?: (info: {
+        key: string;
+        targetKey: string;
+        position: string;
+        nodes: ICETreeNode[];
+    }) => void;
+}
+export declare class ICETree extends ICEWidget {
+    private nodes;
+    private model;
+    private expanded;
+    private itemHeight;
+    private indent;
+    private onSelect;
+    private onExpand;
+    private pane;
+    /** 节点拖拽：按行拖，三分法决定 before / inside / after */
+    private draggable;
+    private dragState;
+    private onDrop;
+    private content;
+    private rows;
+    private rowNodes;
+    private activeKey;
+    private running;
+    constructor(props: ICETreeOptions);
+    protected afterAddHandler(): void;
+    getExpandedKeys(): string[];
+    setExpandedKeys(keys: string[]): this;
+    expandAll(): this;
+    collapseAll(): this;
+    getSelectedKeys(): string[];
+    setSelectedKeys(keys: string[]): this;
+    getActiveKey(): string | null;
+    getRowNode(key: string): ICEWidget | null;
+    getVisibleNodes(): ICETreeNode[];
+    /** 行所在层级（0 = 根层；缩进 = depth × indent）。 */
+    getRowDepth(key: string): number;
+    getScrollPane(): ICEScrollPane | null;
+    /** 键盘：只有焦点在树上时生效。 */
+    isDraggable(): boolean;
+    isDragging(): boolean;
+    getDropTarget(): {
+        index: number;
+        position: 'before' | 'inside' | 'after';
+    } | null;
+    /**
+     * 把 `dragKey` 移到 `targetKey` 的 before / inside / after。
+     *
+     * 生效后重排整棵树并抛 `nodedrop`（带新树）。返回是否真的动了 ——
+     * 拖进自己的后代、未知 key、位置没变都返回 false（判定逻辑在纯函数 `moveTreeNode` 里）。
+     */
+    moveNode(dragKey: string, targetKey: string, position: 'before' | 'inside' | 'after'): boolean;
+    /** 指针落在第几行（把滚动偏移加回来）。 */
+    private __rowIndexAt;
+    private __onGlobalMouseDown;
+    private __onGlobalMouseMove;
+    private __onGlobalMouseUp;
+    private __updateDrag;
+    private __onKeyDown;
+    private __activeIndex;
+    private __toggleExpand;
+    private __pick;
+    /** 可见行 = 深度优先、只展开 expanded 内的分支。 */
+    private __flatten;
+    private __collectExpandableKeys;
+    private __render;
+    private __syncRows;
+}