ice-web-components 1.0.0

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

@@ -0,0 +1,64 @@
+import { ICEWidget } from '../core/ICEWidget';
+import { ICETree, ICETreeNode } from './ICETree';
+import { ICEOverlayManager } from '../core/ICEOverlayManager';
+/**
+ * 树选择器（Ant TreeSelect）：下拉里放一棵 ICETree，选中节点后回写值。
+ *
+ * - 字段区与 ICESelect 同构（选中标签 / placeholder + ▾），错误态边框标红；
+ * - 下拉内容直接复用 `ICETree`（层级展开、缩进、箭头命中区、选择模型都在那边）；
+ * - 浮层自己管关闭（`closeOnOutsideClick: false` + 自身命中盒）—— 浮层的命中盒判定会在
+ *   click 派发前关掉浮层，树节点就收不到点击（Select/AutoComplete 都踩过这个坑）；
+ * - 值就是节点 key，表单语义同 ICETextField（getFormValue / setFormValue）。
+ */
+export interface ICETreeSelectOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    nodes: ICETreeNode[];
+    value?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+    treeHeight?: number;
+    defaultExpandAll?: boolean;
+    onChange?: (key: string, node: ICETreeNode) => void;
+    manager?: ICEOverlayManager;
+}
+export declare class ICETreeSelect extends ICEWidget {
+    private nodes;
+    private value;
+    private placeholder;
+    private disabled;
+    private treeHeight;
+    private defaultExpandAll;
+    private manager;
+    private handle;
+    private panel;
+    private tree;
+    private fieldLabel;
+    private onChangeCallback;
+    private running;
+    constructor(props: ICETreeSelectOptions);
+    protected afterAddHandler(): void;
+    getValue(): string | null;
+    setValue(key: string | null): this;
+    getFormValue(): any;
+    setFormValue(value: any): void;
+    getFieldLabel(): string;
+    isOpen(): boolean;
+    getTree(): ICETree | null;
+    activate(): void;
+    toggle(): this;
+    open(): this;
+    close(): this;
+    private __pick;
+    private __onClick;
+    private __onKeyDown;
+    /** 点外关闭：点在自身与下拉面板之外就收起。 */
+    private __onGlobalMouseDown;
+    private __worldBox;
+    private __syncField;
+    private __findNode;
+}

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

@@ -0,0 +1,67 @@
+import { ICEWidget } from '../core/ICEWidget';
+import { ICELabel } from './ICELabel';
+/**
+ * 按宽度把文本切成若干行，超出部分用 `…` 收尾。
+ *
+ * 为什么要自己折行：画布文本**没有裁剪也不会自动换行**，业务页里长文案要么压出色块、
+ * 要么被邻居盖住。这里按「中文 1em / 其余 0.6em」的估算宽度切行，
+ * 保证每行都不超过 `maxWidth`（与 `estimateTextWidth` 同一套口径）。
+ */
+export declare function truncateTextLines(text: string, options: {
+    maxWidth: number;
+    fontSize: number;
+    maxLines?: number;
+}): string[];
+export declare type ICETypographyVariant = 'title' | 'paragraph' | 'text' | 'link';
+export declare type ICETypographyType = 'default' | 'secondary' | 'success' | 'warning' | 'danger' | 'primary';
+/**
+ * 排版文本（Ant Typography）：标题层级 / 正文 / 链接，自带省略与折行。
+ *
+ * - `variant: 'title'` + `level: 1..5`：五级标题，字号递减；
+ * - `variant: 'paragraph'`：正文，配合 `rows` 做多行折行（末行补 `…`）；
+ * - `variant: 'link'`：主色 + 可点击（触发 `click` 与 `onClick`）且可聚焦；
+ * - `type`：语义色（`secondary` / `success` / `warning` / `danger` / `primary`）；
+ * - `ellipsis: true`（或给了 `rows`）时按宽度截断——画布不会自动换行，长文案必须显式处理。
+ */
+export interface ICETypographyOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    text: string;
+    variant?: ICETypographyVariant;
+    /** 标题层级，1 最大（默认 1） */
+    level?: number;
+    type?: ICETypographyType;
+    /** 省略：true = 单行省略；配合 rows > 1 = 多行折行省略 */
+    ellipsis?: boolean;
+    rows?: number;
+    strong?: boolean;
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+    fontSize?: number;
+    onClick?: () => void;
+}
+export declare class ICETypography extends ICEWidget {
+    private text;
+    private variant;
+    private type;
+    private fontSize;
+    private rows;
+    private lineHeight;
+    private lines;
+    private labelNodes;
+    private onClick;
+    constructor(props: ICETypographyOptions);
+    getText(): string;
+    /** 当前渲染出来的行（省略/折行后的结果）。 */
+    getLines(): string[];
+    getFontSize(): number;
+    getTextColor(): string;
+    getLabelNodes(): ICELabel[];
+    setText(text: string): this;
+    setType(type: ICETypographyType): this;
+    private __color;
+    protected __applyHoverState(): void;
+    private __render;
+}

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

@@ -0,0 +1,75 @@
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 上传选择器（Ant Upload 的最小版）。
+ *
+ * - 上：虚线拖拽区（点击唤起隐藏的 `<input type="file">`）；
+ * - 下：文件列表（名称 / 大小 / 删除）；
+ * - 校验：`accept`（扩展名或 MIME，支持 `image/*`）、`maxSize`、`maxCount`、`beforeUpload`；
+ * - 被拒时 `addFile` 返回 false 并记录原因（`getLastRejectReason()`），列表与回调都不动；
+ * - 文件对象是**纯数据**（`{uid,name,size,type,url}`），不依赖 DOM，便于测试与序列化。
+ */
+export interface ICEUploadFile {
+    uid: string;
+    name: string;
+    size?: number;
+    type?: string;
+    url?: string;
+}
+export interface ICEUploadOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    accept?: string;
+    multiple?: boolean;
+    maxCount?: number;
+    /** 单文件大小上限（字节） */
+    maxSize?: number;
+    disabled?: boolean;
+    text?: string;
+    hint?: string;
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+    rowHeight?: number;
+    beforeUpload?: (file: ICEUploadFile) => boolean | string | undefined;
+    onChange?: (files: ICEUploadFile[]) => void;
+}
+export declare class ICEUpload extends ICEWidget {
+    private files;
+    private accept;
+    private multiple;
+    private maxCount;
+    private maxSize;
+    private disabled;
+    private text;
+    private hint;
+    private rowHeight;
+    private beforeUpload;
+    private onChangeCallback;
+    private lastRejectReason;
+    private dropZone;
+    private fileNodes;
+    private inputEl;
+    private seq;
+    constructor(props?: ICEUploadOptions);
+    getFileList(): ICEUploadFile[];
+    isDisabled(): boolean;
+    getLastRejectReason(): string | null;
+    getDropZoneNode(): ICEWidget | null;
+    /** 上传区提示文案（测试 / QA 用）。 */
+    getHintText(): string;
+    getFileNode(uid: string): ICEWidget | null;
+    /** 加入一个文件（真实选择结果或调用方构造的数据）；被拒时返回 false。 */
+    addFile(file: Partial<ICEUploadFile>): boolean;
+    removeFile(uid: string): this;
+    clear(): this;
+    setDisabled(disabled: boolean): this;
+    /** 唤起系统文件选择框（无 DOM 环境返回 false）。 */
+    openPicker(): boolean;
+    activate(): void;
+    private __defaultHint;
+    private __rejectReason;
+    private __accepts;
+    private __emit;
+    private __render;
+}

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

@@ -0,0 +1,100 @@
+import { ICEWidget } from '../core/ICEWidget';
+import { ICEScrollPane } from './ICEScrollPane';
+/**
+ * 虚拟列表：**只渲染可视区**的列表，一万条数据也只用十几个节点。
+ *
+ * 为什么要有它：`ICETable` / `ICEList` 都是「有多少行建多少节点」——几千行就开始卡，
+ * 上万行直接不能上。虚拟滚动的做法是：内容盒按「总高度」撑开（滚动条对得上），
+ * 但只把「可视区 + 缓冲」那几条真的建出来，滚动时换窗口、复用节点。
+ *
+ * ```
+ * ICEVirtualList (固定高度)
+ *   └── ICEScrollPane            滚轮 / 滚动条 / 子树裁剪都交给它
+ *         └── content (总高 = itemCount × itemHeight)
+ *               ├── item[97]  ← 只建窗口内的
+ *               ├── item[98]
+ *               └── …
+ * ```
+ *
+ * 窗口计算抽成了纯函数 `computeVirtualRange`（缓冲、贴底、空列表、越界都在那里守），
+ * 组件层只管把窗口映射成节点。
+ */
+/** 当前该渲染的区间：`[start, end)`。 */
+export interface ICEVirtualRange {
+    start: number;
+    end: number;
+    count: number;
+}
+export interface ICEVirtualWindowOptions {
+    /** 当前滚动位置，默认 0 */
+    scrollTop?: number;
+    viewportHeight: number;
+    itemHeight: number;
+    itemCount: number;
+    /** 上下各多渲染几条（默认 0），滚动时不容易看到白边 */
+    buffer?: number;
+}
+/**
+ * 纯窗口计算：给定滚动位置、视口高度、行高与总数，算出该渲染哪一段。
+ *
+ * - `end` 是**开区间**（`slice(start, end)` 语义）；
+ * - 半露出的那一条也要渲染（`scrollTop + viewportHeight - 1` 取整）；
+ * - 越界、空列表、非法入参一律返回空窗口或夹取后的结果，不抛异常、不给负数。
+ */
+export declare function computeVirtualRange(options: ICEVirtualWindowOptions): ICEVirtualRange;
+export interface ICEVirtualListOptions {
+    id?: string;
+    left?: number;
+    top?: number;
+    width?: number;
+    /** 视口高度（列表本身的尺寸，内容由它决定滚动范围） */
+    height?: number;
+    /** 每行高度（固定行高才谈得上虚拟滚动） */
+    itemHeight: number;
+    /** 上下缓冲条数，默认 2 */
+    buffer?: number;
+    items?: any[];
+    /** 渲染一条：拿到的是**数据下标**（不是节点下标），可以复用传入的 node */
+    renderItem?: (index: number, item: any, node: any) => void;
+    /** 是否显示滚动条，默认 true */
+    scrollbar?: boolean;
+    [key: string]: any;
+}
+export declare class ICEVirtualList extends ICEWidget {
+    private itemHeight;
+    private buffer;
+    private items;
+    private pane;
+    private content;
+    /** 当前渲染出来的节点：数据下标 → 节点 */
+    private nodes;
+    private scrollTop;
+    private renderItem;
+    constructor(props: ICEVirtualListOptions);
+    getItemCount(): number;
+    getItemHeight(): number;
+    getBuffer(): number;
+    getItems(): any[];
+    /** 内容总高度（撑开滚动条用）。 */
+    getContentHeight(): number;
+    getScrollTop(): number;
+    /** 当前窗口（查询前会先同步一次，保证拿到的是最新状态）。 */
+    getRange(): ICEVirtualRange;
+    /** 当前真正渲染出来的节点（按下标升序）。 */
+    getRenderedNodes(): Array<{
+        index: number;
+        node: any;
+    }>;
+    getRenderedCount(): number;
+    /** 对外暴露滚动视口（需要挂滚动监听时用）。 */
+    getScrollPane(): ICEScrollPane;
+    setItems(items: any[]): this;
+    setScrollTop(scrollTop: number): this;
+    /** 把某一条滚进视口（贴顶对齐），下标会被夹进合法范围。 */
+    scrollToIndex(index: number): this;
+    private __width;
+    private __height;
+    private __range;
+    /** 把当前窗口映射成节点：窗口外的拆掉、窗口内的补上；重复调用是幂等的。 */
+    private __syncWindow;
+}

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

@@ -0,0 +1,49 @@
+import { ICEWidget } from '../core/ICEWidget';
+import { ICELabel } from './ICELabel';
+/**
+ * 水印（Ant Watermark）：把一段旋转文字平铺在自己的区域上。
+ *
+ * - 用于「内部资料 / 草稿 / 不可外传」这类页面级标记；
+ * - 不参与交互（`interactive: false`），不会挡住底下的点击；
+ * - 裁剪在自己的区域内（`clipChildren`）：边缘瓦片被切掉半截，不会溢出到邻居身上；
+ * - 瓦片数量 = `(⌈width/gapX⌉ + 1) × (⌈height/gapY⌉ + 1)`，`gap` 不传时按文字宽度自适应；
+ * - 颜色默认半透明灰（`rgba(0,0,0,0.08)`），可用 `color` / `opacity` 调整。
+ */
+export interface ICEWatermarkOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    text: string;
+    fontSize?: number;
+    /** 文字颜色，默认 `rgba(0,0,0,0.08)` */
+    color?: string;
+    /** 整体不透明度，默认 1（颜色本身已经半透明） */
+    opacity?: number;
+    /** 旋转角度（度），默认 -22 */
+    rotate?: number;
+    /** 水平间距，默认按文字宽度 + 60 自适应 */
+    gapX?: number;
+    /** 垂直间距，默认 72 */
+    gapY?: number;
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+}
+export declare class ICEWatermark extends ICEWidget {
+    private text;
+    private fontSize;
+    private color;
+    private rotate;
+    private gapX;
+    private gapY;
+    private opacity;
+    private tiles;
+    constructor(props: ICEWatermarkOptions);
+    getText(): string;
+    getTileCount(): number;
+    getTileNodes(): ICELabel[];
+    setText(text: string): this;
+    /** 改尺寸后重排瓦片（数量跟着变）。 */
+    setSize(width: number, height: number): this;
+    private __render;
+}

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

@@ -0,0 +1,159 @@
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 通用窗口外壳（桌面 / 多窗口场景的底座）：标题栏 + 按钮 + 客户端区域 + 缩放手柄。
+ *
+ * - **拖动**：按住标题栏移动（受 `bounds` 限制，拖不出桌面）；点在按钮上不触发拖动；
+ * - **焦点**：`active` 决定标题栏配色（XP 蓝 / 灰），点窗口任意位置会 `activate()` 并广播
+ *   `activate` 事件 —— 由外部窗口管理器据此抬 zIndex；
+ * - **最大化 / 还原**：记住还原前的盒子，按 `bounds` 铺满；`minimize()` 只广播事件，
+ *   怎么藏（隐藏 or 收到任务栏）交给调用方；
+ * - **缩放**：右下角手柄（`resizable: false` 可关），受 `minWidth` / `minHeight` 限制；
+ * - **内容**：`content` 或 `setContent()` 装进客户端区域，自动铺满。
+ *
+ * 外观默认走 Windows XP Luna 配色（可传 `appearance` 覆盖），与组件库主题无关 ——
+ * 这类“拟物外壳”本来就要固定配色。
+ */
+export declare type ICEWindowAppearance = {
+    /** 激活态标题栏渐变（两段色） */
+    titleActive?: [string, string];
+    /** 非激活态标题栏渐变 */
+    titleInactive?: [string, string];
+    titleText?: string;
+    titleTextInactive?: string;
+    body?: string;
+    border?: string;
+};
+export interface ICEWindowOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    title?: string;
+    /** 标题栏左侧的图标字形 */
+    icon?: string;
+    /** 自绘图标节点（给了它就代替 `icon` 字形），会在标题栏左侧居中 */
+    iconNode?: any;
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+    /** 拖动 / 最大化的活动范围（一般是桌面工作区） */
+    bounds?: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    titleBarHeight?: number;
+    movable?: boolean;
+    resizable?: boolean;
+    closable?: boolean;
+    minimizable?: boolean;
+    maximizable?: boolean;
+    active?: boolean;
+    minWidth?: number;
+    minHeight?: number;
+    /** 客户端内容（会铺满客户端区域） */
+    content?: any;
+    appearance?: ICEWindowAppearance;
+    onClose?: () => void;
+    onMinimize?: () => void;
+    onMaximize?: (maximized: boolean) => void;
+    onActivate?: () => void;
+    onMove?: (left: number, top: number) => void;
+    onResize?: (width: number, height: number) => void;
+}
+/** 标题栏上的小按钮（hover 亮、按下沉）。 */
+declare class ICEWindowButton extends ICEWidget {
+    private glyph;
+    private baseColor;
+    constructor(props: {
+        left: number;
+        top: number;
+        size: number;
+        text: string;
+        onClick: () => void;
+    });
+    protected __applyHoverState(): void;
+}
+export declare class ICEWindow extends ICEWidget {
+    private titleBar;
+    private titleLabel;
+    private iconNode;
+    private client;
+    private closeButton;
+    private minimizeButton;
+    private maximizeButton;
+    private resizeHandle;
+    private titleBands;
+    private appearance;
+    private titleBarHeight;
+    private active;
+    private maximized;
+    private restoreBox;
+    private bounds;
+    private minWidth;
+    private minHeight;
+    private movable;
+    private resizable;
+    private content;
+    private dragOffset;
+    private resizing;
+    private resizeStart;
+    private bound;
+    private readonly options;
+    constructor(props?: ICEWindowOptions);
+    getTitle(): string;
+    setTitle(title: string): this;
+    getTitleBar(): ICEWidget;
+    getTitleBarHeight(): number;
+    /** 客户端区域的盒子（相对窗口自身）。 */
+    getClientBox(): {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    getClientNode(): ICEWidget;
+    getCloseButton(): ICEWindowButton;
+    getMinimizeButton(): ICEWindowButton;
+    getMaximizeButton(): ICEWindowButton;
+    getResizeHandle(): ICEWidget;
+    /** 标题栏当前色（激活/非激活的中间色）——测试与主题调试用。 */
+    getTitleBarColor(): string;
+    isActive(): boolean;
+    setActive(active: boolean): this;
+    /** 激活窗口并广播（外部据此抬 zIndex）。已经激活时也会广播，方便“置顶”）。 */
+    activate(): this;
+    isMaximized(): boolean;
+    maximize(): this;
+    restore(): this;
+    setContent(node: any): this;
+    getContent(): any;
+    isDragging(): boolean;
+    isResizing(): boolean;
+    setBounds(bounds: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    }): this;
+    setSize(width: number, height: number): this;
+    protected afterAddHandler(): void;
+    revalidate(): this;
+    /** 窗口尺寸被程序式改动时（setState）也要重排内部结构。 */
+    protected __afterStateMerge(sizeChanged: boolean): void;
+    private __bounds;
+    /** 标题栏渐变（激活 / 非激活两套色）+ 标题文字色。 */
+    private __syncTitleBands;
+    /** 窗口尺寸变化后重排标题栏 / 客户端 / 按钮 / 手柄。 */
+    private __layout;
+    /** 节点在世界坐标里的盒子（窗口自身 + 到 this 为止的子级偏移）。 */
+    private __nodeBoxWorld;
+    private __pointIn;
+    private __hitOwnButton;
+    /** 窗口在父容器坐标系里的原点（拖拽时用它把世界坐标换算回去）。 */
+    private __parentOrigin;
+    private __onGlobalMouseDown;
+    private __onGlobalMouseMove;
+    private __onGlobalMouseUp;
+}
+export {};

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

@@ -0,0 +1,10 @@
+import type { ICELayoutManager } from 'ice-render';
+import { ICEWidget } from './ICEWidget';
+/**
+ * 容器基类：在此挂布局策略（`setLayout`，链式返回自身）。
+ */
+export declare class ICEContainer extends ICEWidget {
+    constructor(props?: any);
+    /** 设置布局策略（引擎 ICEGroup.setLayout 的链式版本）。 */
+    setLayout(layout: ICELayoutManager): this;
+}

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

@@ -0,0 +1,70 @@
+/**
+ * 键盘焦点与焦点环。
+ *
+ * 引擎只负责「键盘事件派发给谁」（`ice.setFocusedComponent` + DOMEventDispatcher），
+ * 上层的策略在这里：
+ * - **可聚焦集合**：`ICEWidget.isFocusable()`（控件显式声明 + 启用 + 可见），按文档序；
+ * - **Tab / Shift+Tab** 循环轮转，**Escape** 取消焦点，**Enter / Space** 激活
+ *   （调用控件的 `activate()`，勾选/开关/单选会覆盖成对应的切换动作）；
+ * - **鼠标点击**同样会聚焦：命中后沿父链上溯到最近的可聚焦控件（点标签也能聚焦按钮），
+ *   点在非控件区域则取消焦点；
+ * - **焦点环**画在 ICE 工具层（非交互、绘制在所有组件之上），外扩 2px 跟随焦点组件。
+ *
+ * 焦点环跟随组件移动：组件触发 AFTER_MOVE 时重算（拖拽、布局变化都能跟上）。
+ */
+export declare class ICEFocusManager {
+    private ice;
+    private toolNode;
+    private ring;
+    private focused;
+    /** 当前焦点的来源：鼠标点出来的焦点不画环（除非控件声明 always） */
+    private focusOrigin;
+    private bound;
+    private ringPadding;
+    /** 焦点范围（模态对话框用）：非空时 Tab 只在该子树里轮转。 */
+    private scope;
+    constructor(ice: any);
+    /** 幂等：创建焦点环（挂 ICE 工具层）并绑定键盘/鼠标事件。 */
+    start(): this;
+    /** 解绑事件、清空焦点并摘除焦点环。 */
+    stop(): this;
+    /** 当前焦点控件（无焦点返回 null）。 */
+    getFocused(): any;
+    /** 焦点环组件（测试与自定义样式用）。 */
+    getRing(): any;
+    /** 当前焦点是怎么来的（mouse / keyboard / api）。 */
+    getFocusOrigin(): 'mouse' | 'keyboard' | 'api';
+    /** 焦点环此刻是否可见（`:focus-visible` 的结果）。 */
+    isRingVisible(): boolean;
+    /** 按文档序返回当前可聚焦的控件。 */
+    getFocusables(): any[];
+    /**
+     * 限制焦点范围（模态对话框 / 抽屉的「焦点陷阱」）。
+     *
+     * 传入容器后，Tab/Shift+Tab 只在该子树内轮转；当前焦点若在范围之外会被清掉
+     * （调用方随后可 `focusNext()` 把焦点移进对话框）。传 null 恢复全场景。
+     */
+    setFocusScope(container: any): this;
+    getFocusScope(): any;
+    /**
+     * 设置焦点（传 null 取消焦点）。非可聚焦对象会被忽略成取消焦点。
+     *
+     * `options.origin` 决定要不要画焦点环：`keyboard` 画、`mouse`/`api` 默认不画
+     * （控件自己的 `shouldShowFocusRing()` 说了算）。
+     */
+    focus(component: any, options?: {
+        origin?: 'mouse' | 'keyboard' | 'api';
+    }): this;
+    /** Tab：聚焦下一个（未聚焦时聚焦第一个；到末尾回绕）。 */
+    focusNext(): this;
+    /** Shift+Tab：聚焦上一个。 */
+    focusPrev(): this;
+    private __onKeyDown;
+    private __onMouseDown;
+    /** 焦点组件移动（拖拽/布局变化）时让焦点环跟上。 */
+    private __watchMove;
+    private __onFocusedMoved;
+    private __syncRing;
+}
+/** 每个 ICE 实例一个焦点管理器（懒创建）。 */
+export declare function getICEFocusManager(ice: any): ICEFocusManager;

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

@@ -0,0 +1,26 @@
+/**
+ * ICE 内核的移动类事件为了性能不会在 mousemove 时做全量命中检测，
+ * 因此 Canvas 组件没有内置 mouseenter/mouseleave 语义。
+ *
+ * ICEHoverManager 通过事件总线的 mousemove + ice.hitTest() 自己维护当前 hover 组件，
+ * 并把状态同步到带 setHovered() 的 ICEWidget 上，实现接近 HTML 组件的 hover 效果。
+ */
+export declare class ICEHoverManager {
+    private ice;
+    private current;
+    private running;
+    private lastX;
+    private lastY;
+    private rafId;
+    private __onMouseMove;
+    private __onLeave;
+    constructor(ice: any);
+    start(): this;
+    stop(): this;
+    getHoveredComponent(): any;
+    private __schedule;
+    private __cancelRaf;
+    private __flush;
+    private __findHoverTarget;
+    private setHovered;
+}

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

@@ -0,0 +1,24 @@
+import { ICEThemeTokens } from '../theme/ICETheme';
+/** 内置 `light` / `dark`；也可以用 `registerTheme()` 注册自定义（例如 `xp`）。 */
+export declare type ICEThemeName = string;
+/**
+ * 主题管理单例（`iceUIManager`）：持有当前 token 表，组件构造时从这里取主题。
+ *
+ * - 内置 `light` / `dark`；
+ * - `registerTheme(name, tokens)` 注册自定义主题（例如库内置的 `ICE_XP_THEME`），
+ *   然后 `setTheme('xp')` 切换；
+ * - **主题在组件构造时读取一次**，要热切换就重建组件（见 docs/guides/theming.md）。
+ */
+export declare class ICEManager {
+    private themeName;
+    private themes;
+    setTheme(name: ICEThemeName): this;
+    getThemeName(): ICEThemeName;
+    /** 注册（或覆盖）一套主题 token。 */
+    registerTheme(name: string, tokens: ICEThemeTokens): this;
+    hasTheme(name: string): boolean;
+    /** 已注册的主题名（内置 + 自定义）。 */
+    getThemeNames(): string[];
+    getTheme(): ICEThemeTokens;
+}
+export declare const iceUIManager: ICEManager;