ice-web-components 1.0.0

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

@@ -0,0 +1,73 @@
+import { ICEButton } from './ICEButton';
+import { ICEPanel } from './ICEPanel';
+import { ICEOverlayManager } from '../core/ICEOverlayManager';
+import { ICEFocusManager } from '../core/ICEFocusManager';
+import type { ICEEasing, ICEFrameDriver } from '../util/ICEAnimation';
+/**
+ * 模态对话框：全屏遮罩 + 居中面板 + 焦点陷阱。
+ *
+ * - 遮罩铺满可见区域且可交互 —— 引擎按 zIndex 命中，模态打开时点击不会穿透到下面的组件；
+ * - 焦点被限制在对话框内（`ICEFocusManager.setFocusScope`），打开时聚焦第一个可聚焦控件，
+ *   关闭后恢复打开前的焦点；
+ * - 关闭途径：遮罩点击（`maskClosable`）、Esc（`closeOnEsc`）、确定/取消按钮、显式 `close()`。
+ */
+export declare type ICEModalCloseReason = 'mask' | 'esc' | 'confirm' | 'cancel' | 'api';
+export interface ICEModalOptions {
+    title?: string;
+    /** 正文文本或内容工厂 */
+    content?: string | (() => any);
+    width?: number;
+    /** 面板高度（不传按内容估算） */
+    height?: number;
+    confirmText?: string;
+    cancelText?: string;
+    showFooter?: boolean;
+    /**
+     * `onConfirm` 之后是否自动关闭（默认 true）。
+     *
+     * 异步场景（提交前要跑异步校验 / 等接口）传 `false`：回调里自己做异步操作，
+     * 成功后再调 `modal.close()`，失败时弹窗留在原地展示错误。
+     */
+    closeOnConfirm?: boolean;
+    maskClosable?: boolean;
+    closeOnEsc?: boolean;
+    confirmLoading?: boolean;
+    onConfirm?: () => void;
+    onCancel?: () => void;
+    onClose?: (reason: ICEModalCloseReason) => void;
+    manager?: ICEOverlayManager;
+    focusManager?: ICEFocusManager;
+    animation?: {
+        duration?: number;
+        delay?: number;
+        easing?: ICEEasing;
+        driver?: ICEFrameDriver;
+    };
+}
+export declare class ICEModal {
+    private ice;
+    private options;
+    private manager;
+    private focus;
+    private handle;
+    private mask;
+    private dialog;
+    private confirmButton;
+    private cancelButton;
+    private previousFocus;
+    /** 显式关闭时暂存的关闭原因（浮层回调只有 api/esc/outside/exclusive，认不出 confirm/cancel） */
+    private pendingReason;
+    constructor(ice: any, options?: ICEModalOptions);
+    isOpen(): boolean;
+    getMask(): ICEPanel | null;
+    getDialog(): ICEPanel | null;
+    getConfirmButton(): ICEButton | null;
+    getCancelButton(): ICEButton | null;
+    open(): this;
+    close(reason?: ICEModalCloseReason): this;
+    private __handleClosed;
+    private __createDialog;
+    private __visibleWorldRect;
+}
+/** 便捷入口：`ICEModal.open(ice, options)` 等价于 new ICEModal(ice, options).open()。 */
+export declare function openModal(ice: any, options?: ICEModalOptions): ICEModal;

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

@@ -0,0 +1,62 @@
+import { ICEButton } from './ICEButton';
+import { ICEContainer } from '../core/ICEContainer';
+/**
+ * 分页器：页码 + 上一页/下一页 + 可选「共 N 条」与每页条数切换。
+ *
+ * - 页码按钮就是 `ICEButton`，所以天然可聚焦（Tab / Enter 可操作，见 ICEFocusManager）；
+ * - 页数多时用省略号收口：始终显示首页、末页与当前页附近的窗口（最多 `maxPageButtons` 个页码位）；
+ * - `setCurrent` / `setPageSize` 会夹取并重排，变更后回调 `onChange(page, pageSize)`。
+ */
+export interface ICEPaginationOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    total?: number;
+    pageSize?: number;
+    current?: number;
+    width?: number;
+    left?: number;
+    top?: number;
+    /** 页码位上限（含省略号，默认 7） */
+    maxPageButtons?: number;
+    showTotal?: boolean;
+    showSizeChanger?: boolean;
+    pageSizeOptions?: number[];
+    size?: 'default' | 'small';
+    onChange?: (page: number, pageSize: number) => void;
+}
+export declare class ICEPagination extends ICEContainer {
+    private total;
+    private pageSize;
+    private current;
+    private maxPageButtons;
+    private showTotal;
+    private showSizeChanger;
+    private pageSizeOptions;
+    private size;
+    private onChange;
+    private prevButton;
+    private nextButton;
+    private pageButtons;
+    private sizeChanger;
+    constructor(props?: ICEPaginationOptions);
+    getTotal(): number;
+    getPageCount(): number;
+    getCurrent(): number;
+    getPageSize(): number;
+    getPrevButton(): ICEButton | null;
+    getNextButton(): ICEButton | null;
+    getPageButton(page: number): ICEButton | null;
+    getSizeChanger(): ICEButton | null;
+    setTotal(total: number): this;
+    /** 设置当前页（自动夹取到 [1, pageCount]），变化时回调 onChange。 */
+    setCurrent(page: number, options?: {
+        silent?: boolean;
+    }): this;
+    /** 设置每页条数（重算页数并把 current 夹取到合法范围），变化时回调 onChange。 */
+    setPageSize(pageSize: number, options?: {
+        silent?: boolean;
+    }): this;
+    private __render;
+    /** 页码窗口：1 … n-1 [n n+1 n+2] … last（-1 表示省略号） */
+    private __pageWindow;
+}

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

@@ -0,0 +1,7 @@
+import { ICEContainer } from '../core/ICEContainer';
+/**
+ * 面板：带填充、描边、圆角与阴影的基础容器，业务页面的“卡片底座”。
+ */
+export declare class ICEPanel extends ICEContainer {
+    constructor(props?: any);
+}

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

@@ -0,0 +1,18 @@
+import { ICEButton } from './ICEButton';
+import { ICETextField } from './ICETextField';
+/**
+ * 密码框：显示掩码（• 数量 = 真实长度），`getValue()` / 表单取值仍是明文。
+ *
+ * `showToggle: true` 时右侧出现眼睛按钮，可在明文/掩码之间切换（便于用户核对输入）。
+ */
+export declare class ICEPasswordField extends ICETextField {
+    private visible;
+    private toggleButton;
+    private showToggle;
+    constructor(props?: any);
+    /** 明文 / 掩码。 */
+    isVisible(): boolean;
+    setVisible(visible: boolean): this;
+    getToggleButton(): ICEButton | null;
+    protected formatDisplayValue(value: string): string;
+}

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

@@ -0,0 +1,21 @@
+import { ICEPopover, ICEPopoverOptions } from './ICEPopover';
+/**
+ * 气泡确认框：点击目标弹出「标题 + 说明 + 取消/确定」的小卡片。
+ *
+ * 复用 ICEPopover 的触发与定位；确认/取消后自动关闭并回调。
+ */
+export interface ICEPopconfirmOptions extends ICEPopoverOptions {
+    description?: string;
+    confirmText?: string;
+    cancelText?: string;
+    /** 危险操作：确认按钮用 error 色 */
+    danger?: boolean;
+    onConfirm?: () => void;
+    onCancel?: () => void;
+}
+export declare class ICEPopconfirm extends ICEPopover {
+    private confirmOptions;
+    constructor(ice: any, target: any, options?: ICEPopconfirmOptions);
+    protected __createContent(): any;
+}
+export declare function attachPopconfirm(ice: any, target: any, options?: ICEPopconfirmOptions): ICEPopconfirm;

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

@@ -0,0 +1,48 @@
+import { ICEOverlayManager, ICEOverlayHandle } from '../core/ICEOverlayManager';
+import type { ICEOverlayPlacement } from '../util/ICEOverlayPosition';
+/**
+ * 卡片式浮层：点击（默认）或悬停触发，内容可以是文本或自定义组件工厂。
+ *
+ * 与 ICETooltip 的区别：
+ * - 触发方式默认是 click（可切 hover）；
+ * - 内容通常是「标题 + 正文」的卡片，也支持自定义组件；
+ * - 点击目标会 toggle；点浮层外、按 Esc 关闭（由 ICEOverlayManager 负责）。
+ */
+export interface ICEPopoverOptions {
+    title?: string;
+    /** 正文文本，或内容工厂（每次弹出新建） */
+    content?: string | (() => any);
+    trigger?: 'click' | 'hover';
+    placement?: ICEOverlayPlacement;
+    offset?: number;
+    mouseEnterDelay?: number;
+    mouseLeaveDelay?: number;
+    enterAnimation?: 'none' | 'fade' | 'scale';
+    exitAnimation?: 'none' | 'fade';
+    /** 复用外部浮层管理器（测试注入） */
+    manager?: ICEOverlayManager;
+    onOpenChange?: (open: boolean) => void;
+}
+export declare class ICEPopover {
+    protected ice: any;
+    protected target: any;
+    protected options: ICEPopoverOptions;
+    protected manager: ICEOverlayManager;
+    protected handle: ICEOverlayHandle | null;
+    private enterTimer;
+    private leaveTimer;
+    private running;
+    constructor(ice: any, target: any, options?: ICEPopoverOptions);
+    start(): this;
+    destroy(): this;
+    isOpen(): boolean;
+    show(): this;
+    hide(): this;
+    toggle(): this;
+    /** 内容面板：标题（可选）+ 正文/自定义内容。子类可覆盖做更复杂的卡片。 */
+    protected __createContent(): any;
+    private __onClick;
+    private __onHoverChange;
+    private __clearTimers;
+}
+export declare function attachPopover(ice: any, target: any, options?: ICEPopoverOptions): ICEPopover;

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

@@ -0,0 +1,37 @@
+import { ICELabel } from './ICELabel';
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 进度环/进度条。
+ *
+ * - 线形（默认）：`ICEBoundedRangeModel` 驱动填充条宽度；
+ * - 环形（`type: 'circle'`）：底环 + 进度弧（Path2D 弧线，12 点方向顺时针）+ 居中百分比；
+ *   `size` / `strokeWidth` / `showText` / `format` 可配，`status: 'success'` 走成功色。
+ */
+export declare type ICEProgressType = 'line' | 'circle';
+export declare class ICEProgressBar extends ICEWidget {
+    private model;
+    private type;
+    private track;
+    private fill;
+    private trackRing;
+    private ring;
+    private textNode;
+    private strokeWidth;
+    private showText;
+    private formatFn;
+    constructor(props?: any);
+    setValue(value: number): this;
+    getValue(): number;
+    isCircle(): boolean;
+    /** 归一化进度（0..1）。 */
+    getPercent(): number;
+    /** 进度弧扫过的比例（0..1）；线形模式同样返回归一化进度。 */
+    getSweepRatio(): number;
+    getRingNode(): any;
+    getTrackRingNode(): any;
+    getTextNode(): ICELabel | null;
+    private __ratio;
+    private __format;
+    private __fillWidth;
+    private __sync;
+}

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

@@ -0,0 +1,21 @@
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 单选框：点击或 Enter/Space 选中；同组互斥由调用方（表单/业务）维护。
+ */
+export declare class ICERadioButton extends ICEWidget {
+    private model;
+    private outer;
+    private inner;
+    constructor(props?: any);
+    isSelected(): boolean;
+    setSelected(selected: boolean): this;
+    getFormValue(): any;
+    setFormValue(value: any): void;
+    /** 键盘激活（Enter / Space）与鼠标点击同义：选中本项。 */
+    activate(): void;
+    protected initEvents(): void;
+    /** 禁用的控件不响应鼠标（与 `activate()` 的键盘路径保持一致）。 */
+    private __select;
+    protected __applyHoverState(): void;
+    private __sync;
+}

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

@@ -0,0 +1,71 @@
+import { ICEWidget } from '../core/ICEWidget';
+import { ICERadioButton } from './ICERadioButton';
+/**
+ * 单选组（Ant Radio.Group）：一组互斥选项，整行可点，值是选项的 `value`。
+ *
+ * 与 `ICERadioButton` 的分工：单个按钮只管「选中/未选中」，**互斥与取值由本组件维护**，
+ * 因此业务代码不用再自己写「点了 A 要把 B 取消」这类同步逻辑。
+ *
+ * - 键盘：聚焦后 ←/↑ 上一项、→/↓ 下一项（自动跳过禁用项），Enter/Space 选中当前项；
+ * - 表单：实现取值约定，可直接放进 `ICEForm`；
+ * - 事件：值变化触发 `change`（载荷 `{ value }`）并调用 `onChange`。
+ */
+export interface ICERadioGroupOption {
+    value: string;
+    label?: string;
+    disabled?: boolean;
+}
+export interface ICERadioGroupOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    options: ICERadioGroupOption[];
+    /** 当前选中值（不在选项里的值会被忽略） */
+    value?: string;
+    /** 排布方向，默认 horizontal */
+    direction?: 'horizontal' | 'vertical';
+    /** 选项之间的间距，默认 16 */
+    itemGap?: number;
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+    fontSize?: number;
+    onChange?: (value: string) => void;
+}
+export declare class ICERadioGroup extends ICEWidget {
+    private options;
+    private value;
+    private direction;
+    private itemGap;
+    private fontSize;
+    private itemHeight;
+    private onChange;
+    private itemNodes;
+    private radioNodes;
+    private labelNodes;
+    private activeIndex;
+    private bound;
+    constructor(props: ICERadioGroupOptions);
+    getValue(): string | null;
+    /** 程序式改值：只发 `change` 事件，不回调 `onChange`（与库内其它控件一致）。 */
+    setValue(value: string): this;
+    getFormValue(): any;
+    setFormValue(value: any): void;
+    getOptionNodes(): ICEWidget[];
+    getItemNode(value: string): ICEWidget | null;
+    getRadioNode(value: string): ICERadioButton | null;
+    getLabelTexts(): string[];
+    /** 当前键盘活动项（不一定是选中项）。 */
+    getActiveIndex(): number;
+    setOptions(options: ICERadioGroupOption[]): this;
+    protected afterAddHandler(): void;
+    private __isKnown;
+    /** 选项 → 组内索引（跳过禁用项的下一项）。 */
+    private __nextEnabled;
+    private __onKeyDown;
+    private __moveActive;
+    /** 选中一个选项；`user` 为 true 时回调 onChange。 */
+    private __select;
+    private __syncSelection;
+    private __render;
+}

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

@@ -0,0 +1,43 @@
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 评分（Ant Rate）：N 颗星，点击设置分值、悬停预览、键盘 ←/→ 调整。
+ */
+export interface ICERateOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    count?: number;
+    value?: number;
+    disabled?: boolean;
+    size?: number;
+    color?: string;
+    left?: number;
+    top?: number;
+    onChange?: (value: number) => void;
+}
+export declare class ICERate extends ICEWidget {
+    private count;
+    private value;
+    private preview;
+    private disabled;
+    private size;
+    private color;
+    private starNodes;
+    private onChange;
+    private running;
+    constructor(props?: ICERateOptions);
+    protected afterAddHandler(): void;
+    getValue(): number;
+    setValue(value: number): this;
+    getPreviewValue(): number;
+    getStarNodes(): ICEWidget[];
+    setDisabled(disabled: boolean): this;
+    /** 把指针 x 换算成星序号（1..count）。 */
+    private __starIndexAt;
+    private __onClick;
+    private __onMouseMove;
+    private __onMouseLeave;
+    private __onKeyDown;
+    private __applyValue;
+    private __worldBox;
+    private __render;
+}

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

@@ -0,0 +1,30 @@
+import { ICEButton } from './ICEButton';
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 结果页（Ant Result）：状态图标 + 标题 + 副标题 + 操作按钮组。
+ * 用于提交成功/失败、404、无权限等场景。
+ */
+export declare type ICEResultStatus = 'success' | 'error' | 'info' | 'warning';
+export interface ICEResultAction {
+    key: string;
+    text: string;
+    primary?: boolean;
+}
+export interface ICEResultOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    status?: ICEResultStatus;
+    title?: string;
+    subtitle?: string;
+    actions?: ICEResultAction[];
+    onAction?: (key: string) => void;
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+}
+export declare class ICEResult extends ICEWidget {
+    private buttons;
+    constructor(props: ICEResultOptions);
+    getActionButton(key: string): ICEButton | null;
+}

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

@@ -0,0 +1,72 @@
+import { ICEContainer } from '../core/ICEContainer';
+/**
+ * 滚动视口（Swing 的 JScrollPane / Ant 的 overflow:auto 容器）。
+ *
+ * 依赖引擎的**子树裁剪**（`clipChildren`）：内容超出视口的部分被裁掉，滚出去的子组件
+ * 也命不中（命中检测同样尊重裁剪区）。
+ *
+ * 结构：
+ * ```
+ * ICEScrollPane (clipChildren: true)
+ *   ├── contentBox   位置 = (-scrollX, -scrollY)，尺寸 = 内容尺寸
+ *   │     └── 调用方的内容组件
+ *   └── scrollbarTrack + scrollbarThumb   滚动条（内容超出时才显示）
+ * ```
+ * 内容盒与滚动条都在构造期创建，保证滚动条的 zIndex 恒高于内容（引擎按 zIndex 排序渲染）。
+ */
+export interface ICEScrollPaneOptions {
+    width?: number;
+    height?: number;
+    /** 初始滚动位置 */
+    scrollX?: number;
+    scrollY?: number;
+    /** 是否显示滚动条（默认 auto：内容超出时显示） */
+    scrollbar?: boolean;
+    /** 滚轮灵敏度（每个 deltaY 像素对应的滚动量，默认 1） */
+    wheelStep?: number;
+}
+export declare class ICEScrollPane extends ICEContainer {
+    private contentBox;
+    private contentNode;
+    private scrollbarTrack;
+    private scrollbarThumb;
+    private scrollX;
+    private scrollY;
+    private contentWidth;
+    private contentHeight;
+    private explicitContentSize;
+    private scrollbarMode;
+    private wheelStep;
+    private __bound;
+    constructor(props?: ICEScrollPaneOptions & Record<string, any>);
+    /** 设置滚动内容（会替换上一个内容组件）。 */
+    setContent(node: any): this;
+    getContent(): any;
+    /** 显式设置内容尺寸（内容自己不做布局时用；设置后不再跟随内容组件尺寸）。 */
+    setContentSize(width: number, height: number): this;
+    getContentSize(): [number, number];
+    getViewportSize(): [number, number];
+    /** 可滚动范围（上界）；内容不超出时为 0。 */
+    getScrollRange(): [number, number];
+    getScroll(): [number, number];
+    /** 设置滚动位置（按可滚动范围夹取）。 */
+    setScroll(x: number, y: number): this;
+    scrollBy(dx: number, dy: number): this;
+    isScrollbarVisible(): boolean;
+    /** 滚动条滑块（测试与自定义样式用）。 */
+    getScrollbarThumb(): any;
+    protected afterAddHandler(): void;
+    private __bindGlobalEvents;
+    private __onWheel;
+    private __paneWorldBox;
+    private __syncContentSizeFromNode;
+    /**
+     * 把「内容子树」整体抬到本视口之上。
+     *
+     * 引擎按**全局 zIndex** 排序渲染（zIndex 在构造时自增），因此「先创建内容、后创建视口」
+     * 这种常见的组装顺序会让视口自己的背景盖住内容。这里给整个子树统一赋一个高于视口的
+     * zIndex：同值时引擎的稳定排序保持树的原顺序（父在前、子在后），层级不会乱。
+     */
+    private __raiseAboveSelf;
+    private __syncScrollbar;
+}

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

@@ -0,0 +1,34 @@
+import { ICEButton } from './ICEButton';
+import { ICEContainer } from '../core/ICEContainer';
+/**
+ * 分段控制器（Ant Segmented / iOS ICESegmentedControl 的最小版）：
+ * 一组互斥选项，选中项实心高亮。每个分段是 ICEButton，因此天然可聚焦（Tab/Enter 可操作）。
+ */
+export interface ICESegmentedOption {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}
+export interface ICESegmentedOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    options: ICESegmentedOption[];
+    value?: string;
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+    onChange?: (value: string) => void;
+}
+export declare class ICESegmented extends ICEContainer {
+    private options;
+    private value;
+    private heightValue;
+    private onChange;
+    private nodes;
+    constructor(props: ICESegmentedOptions);
+    getValue(): string | null;
+    setValue(value: string): this;
+    getSegmentNode(value: string): ICEButton | null;
+    private __render;
+}

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

@@ -0,0 +1,85 @@
+import { ICEWidget } from '../core/ICEWidget';
+import { ICEOverlayManager } from '../core/ICEOverlayManager';
+/**
+ * 选择器：输入框外观 + 下拉选项（单选 / 多选 / 搜索过滤）。
+ *
+ * - 字段区自绘（选中标签或 placeholder + 下拉箭头），错误态边框标红；
+ * - 下拉走 `ICEOverlayManager`（工具层、点外关闭、Esc、入场动画），并声明 `keyboardCaptured`，
+ *   打开期间方向键/Enter/字符输入由本组件处理（搜索过滤）；
+ * - 可聚焦（Tab 可达），`activate()`（Enter/Space）打开下拉开；
+ * - 表单集成：`getFormValue` / `setFormValue` 与 ICETextField 同语义。
+ */
+export interface ICESelectOption {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}
+export interface ICESelectOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    options: ICESelectOption[];
+    value?: string | string[];
+    mode?: 'single' | 'multiple';
+    showSearch?: boolean;
+    placeholder?: string;
+    disabled?: boolean;
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+    optionHeight?: number;
+    onChange?: (value: any, option: any) => void;
+    /** 是否参与键盘焦点轮转（默认 true，禁用时自动不可聚焦） */
+    focusable?: boolean;
+    manager?: ICEOverlayManager;
+}
+export declare class ICESelect extends ICEWidget {
+    private options;
+    private mode;
+    private showSearch;
+    private placeholder;
+    private disabled;
+    private selected;
+    private optionHeight;
+    private onChange;
+    private manager;
+    private handle;
+    private fieldLabel;
+    private panel;
+    private optionNodes;
+    private visible;
+    private query;
+    private activeIndex;
+    private running;
+    constructor(props: ICESelectOptions);
+    protected afterAddHandler(): void;
+    /** 供测试/外部注入浮层管理器 */
+    setOverlayManager(manager: ICEOverlayManager): this;
+    private __overlayManager;
+    getValue(): any;
+    setValue(value: any): this;
+    getFormValue(): any;
+    setFormValue(value: any): void;
+    isOpen(): boolean;
+    getFieldLabel(): string;
+    getQuery(): string;
+    getVisibleOptions(): ICESelectOption[];
+    getOptionNode(value: string): ICEWidget | null;
+    setOptions(options: ICESelectOption[]): this;
+    activate(): void;
+    toggle(): this;
+    private __onClick;
+    open(): this;
+    close(): this;
+    /** 键盘（打开期间）：搜索字符 / Backspace / ↑↓ / Enter / Esc。 */
+    private __onKeyDown;
+    private __moveActive;
+    private __setQuery;
+    private __pick;
+    private __normalizeValue;
+    /** 字段区：标签文本 / placeholder + 下拉箭头；同时处理错误态边框。 */
+    private __syncField;
+    private __createPanel;
+    /** 重建下拉内容（搜索行 + 过滤后的选项）。 */
+    private __buildPanel;
+}

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

@@ -0,0 +1,7 @@
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 分隔线：1px 的水平或垂直分隔。
+ */
+export declare class ICESeparator extends ICEWidget {
+    constructor(props?: any);
+}

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

@@ -0,0 +1,29 @@
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 骨架屏：内容加载前的灰色占位。
+ *
+ * `active` 打开时整体做呼吸（opacity 0.55 ⇄ 1 循环），加载完成后 setActive(false) 并移除。
+ */
+export interface ICESkeletonOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    rows?: number;
+    avatar?: boolean;
+    title?: boolean;
+    active?: boolean;
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+}
+export declare class ICESkeleton extends ICEWidget {
+    private placeholders;
+    private active;
+    private pulse;
+    constructor(props: ICESkeletonOptions);
+    isActive(): boolean;
+    getPlaceholderCount(): number;
+    setActive(active: boolean): this;
+    private __startPulse;
+    private __stopPulse;
+}