ice-web-components 1.0.0

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

@@ -0,0 +1,28 @@
+import { ICEWidget } from '../core/ICEWidget';
+import { ICELabel } from './ICELabel';
+export declare type ICEAlertType = 'info' | 'success' | 'warning' | 'error';
+/**
+ * 提示条：info / success / warning / error 四种状态 + 类型图标，可关闭。
+ */
+export declare class ICEAlert extends ICEWidget {
+    private titleNode;
+    private messageNode;
+    private type;
+    private closable;
+    private closed;
+    private closeButton;
+    private iconNode;
+    private onCloseCallback;
+    constructor(props?: any);
+    setTitle(title: string): this;
+    setMessage(message: string): this;
+    getType(): ICEAlertType;
+    getIconNode(): ICELabel | null;
+    getTitleNode(): any;
+    private static __iconOf;
+    /** 关闭（隐藏整棵子树）并回调 onClose；重复调用只生效一次。 */
+    close(): this;
+    isClosed(): boolean;
+    isClosable(): boolean;
+    getCloseButton(): ICEWidget | null;
+}

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

@@ -0,0 +1,69 @@
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 锚点导航（Ant Anchor）：一列锚点，点击滚到目标位置，滚动时自动高亮当前项。
+ *
+ * 与 `ICEScrollPane` 配合使用：`target` 传滚动容器，`items[].top` 是该段落在
+ * **内容坐标系**里的纵向位置。滚动事件由 `ICEScrollPane` 的 `scroll` 事件驱动。
+ */
+export interface ICEAnchorItem {
+    key: string;
+    label: string;
+    /** 目标位置（内容坐标系里的 y） */
+    top: number;
+}
+export interface ICEAnchorOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    /** 跟随的滚动容器 */
+    target: any;
+    items: ICEAnchorItem[];
+    /** 初始活动项，默认第一项 */
+    activeKey?: string;
+    left?: number;
+    top?: number;
+    width?: number;
+    itemHeight?: number;
+    fontSize?: number;
+    /** 用户点击 / 键盘切换锚点时的回调（滚动带出来的高亮不回调） */
+    onChange?: (key: string) => void;
+}
+export declare class ICEAnchor extends ICEWidget {
+    private target;
+    private items;
+    private activeKey;
+    private itemHeight;
+    private fontSize;
+    private onChange;
+    private itemNodes;
+    private labelNodes;
+    private barNodes;
+    private bound;
+    /**
+     * 点击锚点后由我们自己触发的那次滚动位置。
+     *
+     * 目标滚不到底时（最后一节下面没有内容了）滚动会被夹取，随后的 `scroll` 事件
+     * 会把活动项算回「上一个够得着的锚点」—— 表现为「点了最后一个锚点，高亮又跳回去」。
+     * 这里把这一次事件认出来并忽略，用户后续真正滚动时（位置不同）再恢复跟随。
+     */
+    private ignoreNextScroll;
+    constructor(props: ICEAnchorOptions);
+    getActiveKey(): string | null;
+    getLabelTexts(): string[];
+    getItemNode(key: string): ICEWidget | null;
+    getLabelColor(key: string): string;
+    /** 程序式切换活动项（默认不滚动，传 scroll: true 才滚）。 */
+    setActiveKey(key: string, options?: {
+        scroll?: boolean;
+    }): this;
+    getItems(): ICEAnchorItem[];
+    setItems(items: ICEAnchorItem[]): this;
+    protected afterAddHandler(): void;
+    /** 键盘 ↑/↓：移动活动项并滚动过去。 */
+    private __onKeyDown;
+    /** 点击 / 键盘选中：滚动 + 回调。 */
+    private __select;
+    /** 滚动带出来的高亮：取最后一个「已经越过」的锚点。 */
+    private __syncFromScroll;
+    private __syncActive;
+    private __render;
+}

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

@@ -0,0 +1,71 @@
+import { ICEPanel } from './ICEPanel';
+import { ICEWidget } from '../core/ICEWidget';
+import { ICEOverlayManager } from '../core/ICEOverlayManager';
+/**
+ * 自动完成（Ant AutoComplete）：文本输入 + 候选下拉。
+ *
+ * - 组合 `ICETextField`（输入与取值/表单语义）与浮层里的候选列表；
+ * - 输入即过滤（label/value 包含匹配，忽略大小写），无候选时下拉收起；
+ * - 点击候选写入输入框并回调 onSelect；键盘 ↑/↓ 移动高亮、Enter 选中、Esc 关闭。
+ */
+export interface ICEAutoCompleteOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    options: string[];
+    value?: string;
+    placeholder?: string;
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+    optionHeight?: number;
+    onSelect?: (value: string) => void;
+    onChange?: (text: string) => void;
+    /** 复用外部浮层管理器（测试注入） */
+    manager?: ICEOverlayManager;
+}
+export declare class ICEAutoComplete extends ICEWidget {
+    private allOptions;
+    private field;
+    private manager;
+    private handle;
+    private panel;
+    private visibleOptions;
+    private optionNodes;
+    private activeIndex;
+    private optionHeight;
+    private onSelectCallback;
+    private onChangeCallback;
+    private running;
+    private __panelBound;
+    constructor(props: ICEAutoCompleteOptions);
+    protected afterAddHandler(): void;
+    getValue(): string;
+    setValue(value: string): this;
+    getFormValue(): any;
+    setFormValue(value: any): void;
+    getFieldText(): string;
+    setValidateStatus(status: any): this;
+    getValidateStatus(): any;
+    isOpen(): boolean;
+    getVisibleOptions(): string[];
+    getActiveIndex(): number;
+    getOptionNode(value: string): ICEWidget | null;
+    /** 当前候选浮层（未打开时为 null）。 */
+    getPanel(): ICEPanel | null;
+    activate(): void;
+    private __overlayManager;
+    /** 按当前文本刷新候选与下拉。 */
+    private __refresh;
+    close(): this;
+    /** 点外关闭：点在输入框（本组件）与候选面板之外就收起下拉。 */
+    /** 点击落在候选面板上（但事件被派发给了锚点）时，按位置选中。 */
+    private __onAnchorClick;
+    private __onGlobalMouseDown;
+    private __onKeyDown;
+    private __onPanelClick;
+    private __worldBox;
+    private __pick;
+    private __createPanel;
+    private __buildOptions;
+}

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

@@ -0,0 +1,11 @@
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 文字头像：取首字母/汉字，背景色可配，自带描边把相邻头像分开。
+ */
+export declare class ICEAvatar extends ICEWidget {
+    private circle;
+    private textNode;
+    constructor(props?: any);
+    setText(text: string): this;
+    getText(): string;
+}

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

@@ -0,0 +1,40 @@
+import { ICEAvatar } from './ICEAvatar';
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 头像组（Ant Avatar.Group 的最小版）。
+ *
+ * - 头像横向**重叠**排布（每个左移 `overlap`），靠 ICEAvatar 自带的描边把相邻头像分开；
+ * - 超过 `max` 个时折叠：只显示前 max 个，末尾补一个 `+N` 头像；
+ * - 组件宽度按「最后一个头像的右边缘」算，方便直接放进工具栏/表格单元格。
+ */
+export interface ICEAvatarGroupItem {
+    text: string;
+    backgroundColor?: string;
+}
+export interface ICEAvatarGroupOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    avatars: ICEAvatarGroupItem[];
+    size?: number;
+    max?: number;
+    /** 相邻头像的重叠像素；默认 size / 4 */
+    overlap?: number;
+    left?: number;
+    top?: number;
+}
+export declare class ICEAvatarGroup extends ICEWidget {
+    private avatars;
+    private size;
+    private max;
+    private overlap;
+    private avatarNodes;
+    private restNode;
+    constructor(props: ICEAvatarGroupOptions);
+    getCount(): number;
+    getVisibleCount(): number;
+    getRestCount(): number;
+    getAvatarNodes(): ICEAvatar[];
+    getRestNode(): ICEAvatar | null;
+    setAvatars(avatars: ICEAvatarGroupItem[]): this;
+    private __render;
+}

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

@@ -0,0 +1,39 @@
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 回到顶部（Ant BackTop）：一个小圆按钮，滚动超过阈值才出现。
+ *
+ * 用法是把滚动容器交给它：`new ICEBackTop({ target: scrollPane })`。
+ * 依赖 `ICEScrollPane` 的 `scroll` 事件（滚动位置变化时派发），
+ * 点击后把目标滚回 `(0, 0)` 并回调 `onClick`。
+ */
+export interface ICEBackTopOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    /** 跟随的滚动容器（实现 getScroll / setScroll / on('scroll') 即可） */
+    target: any;
+    /** 超过多少滚动量才出现，默认 200 */
+    visibilityHeight?: number;
+    /** 圆按钮直径，默认 36 */
+    size?: number;
+    /** 图标字形，默认 ↑ */
+    icon?: string;
+    left?: number;
+    top?: number;
+    onClick?: () => void;
+}
+export declare class ICEBackTop extends ICEWidget {
+    private target;
+    private visibilityHeight;
+    private visible;
+    private onClick;
+    private iconNode;
+    constructor(props: ICEBackTopOptions);
+    isVisible(): boolean;
+    /** 当前按钮底色（悬停态取主色 hover）。 */
+    getButtonColor(): string;
+    setTarget(target: any): this;
+    protected __applyHoverState(): void;
+    /** 可见时才动手：隐藏状态下点击（或键盘激活）应当是空操作。 */
+    private __click;
+    private __syncVisibility;
+}

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

@@ -0,0 +1,17 @@
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 徽标：数字/文字胶囊；`dot` 是红点模式，`count` 超过阈值自动显示 `99+`。
+ */
+export declare class ICEBadge extends ICEWidget {
+    private textNode;
+    private dot;
+    /** `solid` = Bootstrap `.text-bg-*` 实底（默认）；`soft` = subtle 浅底 */
+    private variant;
+    constructor(props?: any);
+    setText(text: string): this;
+    /** 是否红点模式（只有圆点、没有文字）。 */
+    isDot(): boolean;
+    getText(): string;
+    /** 计数文案：超过 overflowCount（默认 99）显示 `N+`。 */
+    private static __countText;
+}

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

@@ -0,0 +1,82 @@
+import { ICEWidget } from '../core/ICEWidget';
+import { ICELabel } from './ICELabel';
+/**
+ * 面包屑（Ant Breadcrumb）：一行「路径 + 分隔符」，最后一项是当前页。
+ *
+ * - 宽度按内容自适应（中文按 1em 估算，不会把文字压出色块外）；
+ * - 除最后一项外都可点击，点击触发 `navigate` 事件（载荷 `{ item, index }`）与 `onNavigate`；
+ * - `maxItems` 超长时把中间项折叠成「…」，点击省略号展开（Ant 的折叠语义：
+ *   `maxItems` 只数真实项，省略号不占额度）。
+ */
+export interface ICEBreadcrumbItem {
+    /** 业务键（可选，便于回调里定位） */
+    key?: string;
+    label: string;
+    /** 业务路由（组件不自己跳转，交给 onNavigate 决定） */
+    href?: string;
+    disabled?: boolean;
+}
+export interface ICEBreadcrumbOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    items: ICEBreadcrumbItem[];
+    /** 分隔符，默认 `›` */
+    separator?: string;
+    /** 最多显示多少**真实项**（超过则中间折叠为省略号）；不传或 ≤ 0 表示不折叠 */
+    maxItems?: number;
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+    fontSize?: number;
+    /** 点击非当前项的回调（与 `navigate` 事件同义） */
+    onNavigate?: (item: ICEBreadcrumbItem, index: number) => void;
+}
+/** 面包屑项：悬停时文字转主色（文字样式落在内层 ICEText 上）。 */
+declare class ICEBreadcrumbItemNode extends ICEWidget {
+    private label;
+    private textNode;
+    private restColor;
+    private hoverColor;
+    constructor(props: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+        text: string;
+        fontSize: number;
+        fillStyle: string;
+        fontWeight: string;
+        clickable: boolean;
+    });
+    getLabel(): ICELabel;
+    getText(): string;
+    protected __applyHoverState(): void;
+}
+export declare class ICEBreadcrumb extends ICEWidget {
+    private items;
+    private separator;
+    private maxItems;
+    private fontSize;
+    private onNavigate;
+    /** 用户点过省略号：本次数据下不再自动折叠 */
+    private userExpanded;
+    private collapsed;
+    private itemNodes;
+    private separatorNodes;
+    constructor(props: ICEBreadcrumbOptions);
+    /** 当前显示的标签（折叠时中间会多出一个 `…`）。 */
+    getLabelTexts(): string[];
+    getItemNodes(): ICEBreadcrumbItemNode[];
+    getSeparatorNodes(): ICELabel[];
+    getItems(): ICEBreadcrumbItem[];
+    isCollapsed(): boolean;
+    /** 展开被折叠的中间项。 */
+    expand(): this;
+    setItems(items: ICEBreadcrumbItem[]): this;
+    /** 当前可见序列：真实项，或「首项 + 省略号 + 末尾 maxItems-1 项」。 */
+    private __displayed;
+    private __render;
+    private __navigate;
+}
+export {};

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

@@ -0,0 +1,25 @@
+import { ICEWidget } from '../core/ICEWidget';
+export declare type ICEButtonVariant = 'primary' | 'default' | 'text' | 'link';
+export declare type ICEButtonSize = 'small' | 'middle' | 'large';
+/**
+ * 按钮：`primary` / `default` / `text` / `link` 变体，`danger` 与三种尺寸，
+ * 自带 hover / 焦点 / 禁用态，点击时触发 `click`。
+ */
+export declare class ICEButton extends ICEWidget {
+    /** 调用方显式设过 ariaLabel 之后，setText 不再覆盖它 */
+    private explicitAriaLabel;
+    private label;
+    private variant;
+    private size;
+    private danger;
+    private pressed;
+    constructor(props?: any);
+    /** 覆盖可读名称（之后 setText 不会再把名字改回去）。 */
+    setAriaLabel(label: string): this;
+    setText(text: string): this;
+    getText(): string;
+    protected initEvents(): void;
+    setEnabled(enabled: boolean): this;
+    protected __applyHoverState(): void;
+    private __sync;
+}

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

@@ -0,0 +1,84 @@
+import { ICEWidget } from '../core/ICEWidget';
+/** `YYYY-MM-DD`（本地时区，日期选择器统一用这个字符串形态）。 */
+export declare function formatCalendarDate(date: Date): string;
+export interface ICECalendarCell {
+    date: string;
+    day: number;
+    /** 是否属于当前显示的月份 */
+    inMonth: boolean;
+}
+/**
+ * 生成月视图网格（固定 6 行 × 7 列 = 42 格，前后用相邻月份补齐）。
+ * 默认周一开头（与 `ICEDatePicker` 一致）。
+ */
+export declare function buildMonthGrid(month: string, options?: {
+    weekStart?: number;
+}): ICECalendarCell[];
+/**
+ * 日历（Ant Calendar 的最小版）：月视图 + 日期选择。
+ *
+ * - 标题「YYYY 年 M 月」+ 上/下月切换（回调 `onChangeMonth`）；
+ * - 6×7 网格：相邻月份补齐的格子弱化显示，点击仍然可选；
+ * - 选中日期实底高亮，今天带主色描边（`today` 可注入，便于测试与「业务今天」）；
+ * - 键盘：←/→ 按天、↑/↓ 按周移动选中，PageUp/PageDown 切月。
+ */
+export interface ICECalendarOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    /** 选中日期 `YYYY-MM-DD` */
+    value?: string;
+    /** 当前显示的月份 `YYYY-MM`，默认取 value 所在月 / 今天所在月 */
+    month?: string;
+    /** 「今天」的日期（不传取系统时间；传了便于测试与业务定制） */
+    today?: string;
+    width?: number;
+    height?: number;
+    left?: number;
+    top?: number;
+    onSelect?: (date: string) => void;
+    onChangeMonth?: (month: string) => void;
+}
+export declare class ICECalendar extends ICEWidget {
+    private value;
+    private visibleMonth;
+    private today;
+    private onSelect;
+    private onChangeMonth;
+    private cellHeight;
+    private headerHeight;
+    private weekHeight;
+    private titleNode;
+    private weekdayNodes;
+    private cellNodes;
+    private cellLabels;
+    private cellNodeMap;
+    private bound;
+    constructor(props?: ICECalendarOptions);
+    getValue(): string | null;
+    setValue(value: any, options?: {
+        silent?: boolean;
+    }): this;
+    getFormValue(): any;
+    setFormValue(value: any): void;
+    getVisibleMonth(): string;
+    setVisibleMonth(month: string, options?: {
+        silent?: boolean;
+    }): this;
+    prevMonth(): this;
+    nextMonth(): this;
+    getTitleText(): string;
+    getWeekdayTexts(): string[];
+    getCellNodes(): ICEWidget[];
+    getCellNode(date: string): ICEWidget | null;
+    getCellBackground(date: string): string;
+    getCellTextColor(date: string): string;
+    isToday(date: string): boolean;
+    /** 程序式选中（不发事件）。 */
+    selectDate(date: string): this;
+    getPrevButton(): ICEWidget | null;
+    getNextButton(): ICEWidget | null;
+    protected afterAddHandler(): void;
+    private __shiftSelected;
+    private __onKeyDown;
+    private __render;
+}

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

@@ -0,0 +1,22 @@
+import { ICEPanel } from './ICEPanel';
+/**
+ * 卡片：面板 + 标题，并提供右上角 `extra` 插槽（放“更多/操作”）。
+ */
+export declare class ICECard extends ICEPanel {
+    private titleNode;
+    private extraNode;
+    constructor(props?: any);
+    setTitle(title: string): this;
+    /**
+     * 右上角插槽（Ant Card 的 `extra`）：放操作链接 / 按钮等。
+     *
+     * 可以传现成节点，也可以传工厂函数 —— **推荐工厂函数**：引擎按创建顺序决定 zIndex，
+     * 调用方在卡片之前 new 出来的节点会被卡片底色盖住；传函数则由卡片在构造期创建，
+     * 天然在上层。传现成节点时这里也会把整棵子树抬到卡片之上兜底。
+     */
+    setExtra(extra: any): this;
+    getExtraNode(): any;
+    getTitleNode(): any;
+    /** 整棵子树统一抬到指定 zIndex（同值不破坏子树内「先父后子」的顺序）。 */
+    private __raiseSubtree;
+}

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

@@ -0,0 +1,86 @@
+import { ICEWidget } from '../core/ICEWidget';
+import { ICEFrameDriver } from '../util/ICEAnimation';
+/**
+ * 轮播（Ant Carousel 的最小版）。
+ *
+ * - 结构：裁剪视口（`clipChildren`）里一条横向轨道，幻灯片并排；轨道 left = -index * width；
+ * - `goTo` / `next` / `prev` 切换，`loop` 控制是否循环；箭头与圆点可点，方向键 ←/→ 也可切；
+ * - 切换用可注入 frame driver 的补间（`duration: 0` 时同步落位，便于测试）；
+ * - 自动播放走可注入的调度器（`play` / `pause` / `isPlaying`）。
+ */
+export declare type ICECarouselFrameDriver = ICEFrameDriver;
+export interface ICECarouselScheduler {
+    setInterval(handler: () => void, ms: number): any;
+    clearInterval(handle: any): void;
+}
+export interface ICECarouselOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    slides?: ICEWidget[];
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+    initialIndex?: number;
+    loop?: boolean;
+    /** 切换过渡时长（毫秒）；0 = 立即落位 */
+    duration?: number;
+    /** 自动播放间隔（毫秒）；> 0 时构造后即开始播放 */
+    autoplay?: number;
+    arrows?: boolean;
+    dots?: boolean;
+    onChange?: (index: number) => void;
+    driver?: ICECarouselFrameDriver;
+    scheduler?: ICECarouselScheduler;
+}
+export declare class ICECarousel extends ICEWidget {
+    private slides;
+    private index;
+    private loop;
+    private duration;
+    private autoplayMs;
+    private showArrows;
+    private showDots;
+    private driver?;
+    private scheduler;
+    private onChangeCallback;
+    private viewport;
+    private track;
+    private prevButton;
+    private nextButton;
+    private dots;
+    private tweenHandle;
+    private timer;
+    private running;
+    constructor(props?: ICECarouselOptions);
+    protected afterAddHandler(): void;
+    getCount(): number;
+    getIndex(): number;
+    setSlides(slides: ICEWidget[]): this;
+    getSlideNode(index: number): ICEWidget | null;
+    getTrackNode(): ICEWidget | null;
+    getPrevButton(): ICEWidget | null;
+    getNextButton(): ICEWidget | null;
+    getDotNode(index: number): ICEWidget | null;
+    isPlaying(): boolean;
+    play(): this;
+    pause(): this;
+    setAutoplay(ms: number): this;
+    goTo(index: number, animate?: boolean): this;
+    next(): this;
+    prev(): this;
+    activate(): void;
+    private __clampIndex;
+    private __onKeyDown;
+    private __moveTrack;
+    private __updateControls;
+    private __render;
+    private __makeArrow;
+    /**
+     * 把一棵子树（含后代）统一抬到指定 zIndex。
+     *
+     * 整体用同一个值是有意的：同 zIndex 内按树的先父后子顺序绘制，这样既越过了根节点，
+     * 又不会打乱子树内部「先底色、后文字」的相对次序（逐个分配不同值反而会把子节点压到父节点下面）。
+     */
+    private __raiseSubtree;
+}

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

@@ -0,0 +1,84 @@
+import { ICEPanel } from './ICEPanel';
+import { ICEWidget } from '../core/ICEWidget';
+import { ICEScrollPane } from './ICEScrollPane';
+import { ICEOverlayManager } from '../core/ICEOverlayManager';
+/**
+ * 级联选择（Ant Cascader 的最小版）。
+ *
+ * - 字段显示已选路径（`separator` 可定制），未选显示 placeholder，错误态边框标红；
+ * - 浮层按层级横向排列：点父节点展开下一列（不关闭），点叶子定值并关闭；
+ * - 值统一是最深一层的 `value`，路径可由 `getPath()` 取回（便于回显上级）；
+ * - 关闭策略与 Select 系列一致：浮层 closeOnOutsideClick:false，由组件自己判断点外 + Esc。
+ */
+export interface ICECascaderOption {
+    value: string;
+    label: string;
+    disabled?: boolean;
+    children?: ICECascaderOption[];
+}
+export declare type ICECascaderPlacement = 'bottomLeft' | 'bottomRight';
+export interface ICECascaderOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    options: ICECascaderOption[];
+    value?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    separator?: string;
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+    placement?: ICECascaderPlacement;
+    onChange?: (value: string, path: ICECascaderOption[]) => void;
+    manager?: ICEOverlayManager;
+}
+export declare class ICECascader extends ICEWidget {
+    private options;
+    private value?;
+    private placeholder;
+    private disabled;
+    private separator;
+    private placement;
+    private manager;
+    private onChangeCallback;
+    private handle;
+    private panel;
+    private fieldLabel;
+    private columns;
+    private optionNodes;
+    private activePath;
+    private running;
+    constructor(props: ICECascaderOptions);
+    protected afterAddHandler(): void;
+    getValue(): string | undefined;
+    setValue(value: string | null | undefined): this;
+    getFormValue(): any;
+    setFormValue(value: any): void;
+    /** 已选路径（根 → 叶子）；未选时为空数组。 */
+    getPath(): ICECascaderOption[];
+    getFieldLabel(): string;
+    isOpen(): boolean;
+    getPanel(): ICEPanel | null;
+    getColumnNodes(): ICEScrollPane[];
+    getColumnNode(level: number): ICEScrollPane | null;
+    getOptionNode(level: number, value: string): ICEWidget | null;
+    activate(): void;
+    toggle(): this;
+    open(): this;
+    close(): this;
+    protected __applyValidateState(): void;
+    /** 按 value 在选项树里回溯出「根 → 叶子」路径。 */
+    private __findPath;
+    /** 选项树的最大层级数（= 最多几列）。 */
+    private __maxDepth;
+    /** 单列最多几行（封顶 VISIBLE_ROWS，保证浮层高度稳定）。 */
+    private __maxRows;
+    private __pick;
+    private __onClick;
+    private __onKeyDown;
+    private __onGlobalMouseDown;
+    private __worldBox;
+    private __syncField;
+    private __renderPanel;
+}