ice-web-components 1.0.0

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

@@ -0,0 +1,21 @@
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 复选框：点击或 Enter/Space 切换勾选，触发 `change`，可直接进表单。
+ */
+export declare class ICECheckBox extends ICEWidget {
+    private model;
+    private box;
+    private mark;
+    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;
+}

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

@@ -0,0 +1,75 @@
+import { ICEWidget } from '../core/ICEWidget';
+import { ICECheckBox } from './ICECheckBox';
+/**
+ * 多选组（Ant Checkbox.Group）：一组可多选的选项，值是 `string[]`（按选项顺序）。
+ *
+ * - 整行可点（点文字也能勾选）；
+ * - `max` 限制最多勾选几项，超出时忽略并触发 `exceed`（载荷 `{ value, max }`）；
+ * - 键盘：方向键移动活动项、Space 切换；
+ * - 表单：值为数组，`setFormValue` 兼容单值 / 空值；
+ * - 事件：值变化触发 `change`（载荷 `{ value }`）并调用 `onChange`。
+ */
+export interface ICECheckboxGroupOption {
+    value: string;
+    label?: string;
+    disabled?: boolean;
+}
+export interface ICECheckboxGroupOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    options: ICECheckboxGroupOption[];
+    /** 已选值（按选项顺序归一化） */
+    value?: string[];
+    direction?: 'horizontal' | 'vertical';
+    itemGap?: number;
+    /** 最多可勾选数量，不传表示不限 */
+    max?: number;
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+    fontSize?: number;
+    onChange?: (value: string[]) => void;
+}
+export declare class ICECheckboxGroup extends ICEWidget {
+    private options;
+    private selected;
+    private direction;
+    private itemGap;
+    private fontSize;
+    private itemHeight;
+    private max;
+    private onChange;
+    private itemNodes;
+    private checkboxNodes;
+    private labelNodes;
+    private activeIndex;
+    private bound;
+    constructor(props: ICECheckboxGroupOptions);
+    /** 已选值（按选项顺序）。 */
+    getValue(): string[];
+    getCheckedCount(): number;
+    isChecked(value: string): boolean;
+    /** 程序式设值：只发 `change` 事件，不回调 `onChange`。 */
+    setValue(value: string[]): this;
+    /** 全选（受 `max` 限制）。 */
+    checkAll(): this;
+    clear(): this;
+    getFormValue(): any;
+    setFormValue(value: any): void;
+    getOptionNodes(): ICEWidget[];
+    getItemNode(value: string): ICEWidget | null;
+    getCheckboxNode(value: string): ICECheckBox | null;
+    getLabelTexts(): string[];
+    getActiveIndex(): number;
+    setOptions(options: ICECheckboxGroupOption[]): this;
+    protected afterAddHandler(): void;
+    /** 去掉未知值 / 重复值 / 禁用值，并按选项顺序排列。 */
+    private __normalize;
+    private __onKeyDown;
+    private __moveActive;
+    /** 切换一个选项；`user` 为 true 时回调 onChange。 */
+    private __toggle;
+    private __syncSelection;
+    private __render;
+}

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

@@ -0,0 +1,49 @@
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 折叠面板（Ant Collapse / Swing 无直接对应物）。
+ *
+ * - 每项 = 标题行（▸/▾ + 标题）+ 展开时的内容区；内容支持纯文本或组件工厂；
+ * - `accordion: true` 时同时只展开一个；展开/收起会重排并回调 onExpand(keys)；
+ * - 标题行是独立命中区（点标题只切换展开，不触发内容交互）。
+ */
+export interface ICECollapseItem {
+    key: string;
+    title: string;
+    content?: string | (() => any);
+    disabled?: boolean;
+}
+export interface ICECollapseOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    items: ICECollapseItem[];
+    activeKeys?: string[];
+    accordion?: boolean;
+    left?: number;
+    top?: number;
+    width?: number;
+    headerHeight?: number;
+    contentHeight?: number;
+    onChange?: (keys: string[]) => void;
+    onExpand?: (keys: string[]) => void;
+}
+export declare class ICECollapse extends ICEWidget {
+    private items;
+    private active;
+    private accordion;
+    private headerHeight;
+    private contentHeight;
+    private expandCallback;
+    private headerNodes;
+    private contentNodes;
+    private offsetMap;
+    constructor(props: ICECollapseOptions);
+    getActiveKeys(): string[];
+    setActiveKeys(keys: string[]): this;
+    getHeaderNode(key: string): ICEWidget | null;
+    getContentNode(key: string): ICEWidget | null;
+    getItemTop(key: string): number;
+    private __toggle;
+    private __render;
+    /** 宽度变化时重排标题/内容宽度（引擎只回调 __afterStateMerge）。 */
+    protected __afterStateMerge(sizeChanged: boolean): void;
+}

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

@@ -0,0 +1,52 @@
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 颜色选择器（Ant ColorPicker 的色板网格最小版）。
+ *
+ * - 按 `colors` 渲染色块网格（`columns` 控制列数），选中色块带描边环；
+ * - 点击色块回写 value 并回调 `onChange`；`disabled` 时忽略交互且不可聚焦；
+ * - 键盘 ↑/↓/←/→ 在网格里移动选择；
+ * - 表单集成：`getFormValue` / `setFormValue`，错误态边框标红。
+ */
+export interface ICEColorPickerOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    colors?: string[];
+    columns?: number;
+    value?: string;
+    swatchSize?: number;
+    gap?: number;
+    disabled?: boolean;
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+    onChange?: (color: string) => void;
+}
+export declare class ICEColorPicker extends ICEWidget {
+    private colors;
+    private columns;
+    private value?;
+    private swatchSize;
+    private gap;
+    private padding;
+    private disabled;
+    private onChange;
+    private cells;
+    private running;
+    constructor(props?: ICEColorPickerOptions);
+    protected afterAddHandler(): void;
+    getValue(): string | undefined;
+    setValue(hex: string): this;
+    isSelected(hex: string): boolean;
+    getSwatchNodes(): ICEWidget[];
+    getSwatchNode(color: string): ICEWidget | null;
+    getRowCount(): number;
+    getFormValue(): any;
+    setFormValue(value: any): void;
+    protected __applyValidateState(): void;
+    private __pick;
+    private __onKeyDown;
+    private __render;
+    private static __resolveSwatchSize;
+    private static __defaultPalette;
+}

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

@@ -0,0 +1,36 @@
+import { ICEButton } from './ICEButton';
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 评论（Ant Comment 的最小版）：文字头像 + 作者 + 时间 + 正文 + 操作按钮 + 嵌套回复。
+ *
+ * 布局自上而下：头像在左，右侧依次是「作者 · 时间」「正文」「操作」「回复（缩进）」。
+ * 高度按内容自动累加（正文单行 20px，多行请自行用 content 组件工厂）。
+ */
+export interface ICECommentAction {
+    key: string;
+    text: string;
+}
+export interface ICECommentOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    author: string;
+    content: string;
+    time?: string;
+    /** 文字头像（默认取 author 首字） */
+    avatarText?: string;
+    avatarColor?: string;
+    actions?: ICECommentAction[];
+    onAction?: (key: string) => void;
+    replies?: ICECommentOptions[];
+    left?: number;
+    top?: number;
+    width?: number;
+    indent?: number;
+}
+export declare class ICEComment extends ICEWidget {
+    private actionButtons;
+    private replyNodes;
+    constructor(props: ICECommentOptions);
+    getActionButton(key: string): ICEButton | null;
+    getReplyNodes(): ICEComment[];
+}

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

@@ -0,0 +1,90 @@
+import { ICEPanel } from './ICEPanel';
+import { ICEWidget } from '../core/ICEWidget';
+import { ICEOverlayManager } from '../core/ICEOverlayManager';
+/**
+ * 日期选择器（Ant DatePicker 的最小版）。
+ *
+ * - 字段区显示所选日期（可自定义 `format`），未选显示 placeholder，错误态边框标红；
+ * - 日历浮层：月份标题 + ‹/› 切月 + 周标题（周一开头）+ 6×7 网格（含上下月补位）；
+ *   今天、选中日分别高亮；
+ * - 值统一是 `YYYY-MM-DD` 字符串（可序列化、可直接进表单）；
+ * - 关闭策略与 Select 系列一致：浮层 closeOnOutsideClick:false，由组件自己判断点外 + Esc。
+ */
+export declare type ICEDatePickerPlacement = 'bottomLeft' | 'bottomRight';
+export interface ICEDatePickerOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    value?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    /** 显示格式（默认原样显示 YYYY-MM-DD） */
+    format?: (value: string) => string;
+    /** 注入「今天」，便于测试与演示 */
+    today?: string;
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+    cellSize?: number;
+    placement?: ICEDatePickerPlacement;
+    onChange?: (value: string) => void;
+    manager?: ICEOverlayManager;
+}
+export interface ICEDateCell {
+    date: string;
+    day: number;
+    inMonth: boolean;
+    isToday: boolean;
+    isSelected: boolean;
+}
+export declare class ICEDatePicker extends ICEWidget {
+    private value;
+    private placeholder;
+    private disabled;
+    private formatFn;
+    private today;
+    private cellSize;
+    private placement;
+    private manager;
+    private onChangeCallback;
+    private handle;
+    private panel;
+    private fieldLabel;
+    private monthLabel;
+    private grid;
+    private dayNodes;
+    private viewYear;
+    private viewMonth;
+    private running;
+    constructor(props?: ICEDatePickerOptions);
+    protected afterAddHandler(): void;
+    getValue(): string | null;
+    setValue(value: string | null): this;
+    getFormValue(): any;
+    setFormValue(value: any): void;
+    getFieldLabel(): string;
+    isOpen(): boolean;
+    getPanel(): ICEPanel | null;
+    getViewMonth(): {
+        year: number;
+        month: number;
+    };
+    setViewMonth(year: number, month: number): this;
+    prevMonth(): this;
+    nextMonth(): this;
+    getDayNode(date: string): ICEWidget | null;
+    /** 当前视图月的 6×7 网格（周一开头，含上下月补位）。 */
+    getDayCells(): ICEDateCell[];
+    activate(): void;
+    toggle(): this;
+    open(): this;
+    close(): this;
+    private __setViewFromValue;
+    private __pick;
+    private __onClick;
+    private __onKeyDown;
+    private __onGlobalMouseDown;
+    private __worldBox;
+    private __syncField;
+    private __renderPanel;
+}

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

@@ -0,0 +1,40 @@
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 描述列表（Ant Descriptions）：成对的「标签 / 值」，支持单列与多列。
+ * 常用于详情页（订单信息、用户资料）。
+ */
+export interface ICEDescriptionsItem {
+    label: string;
+    value: string;
+}
+export interface ICEDescriptionsOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    items: ICEDescriptionsItem[];
+    column?: number;
+    left?: number;
+    top?: number;
+    width?: number;
+    itemHeight?: number;
+    labelWidth?: number;
+}
+export declare class ICEDescriptions extends ICEWidget {
+    private items;
+    private column;
+    private itemHeight;
+    private labelWidth;
+    private rowNodes;
+    constructor(props: ICEDescriptionsOptions);
+    getRowNodes(): ICEWidget[];
+    /** 替换数据并重排（列表内容随选中项变化时用）。 */
+    setItems(items: ICEDescriptionsItem[]): this;
+    /**
+     * 宽度变化时重排内部布局。
+     *
+     * `__render()` 只在构造与 setItems 时跑，而「窗口缩放 / 分栏拖动」只改 `state.width` ——
+     * 引擎在 setState 后只回调 `__afterStateMerge`，不补这次重排的话列宽会停留在旧值
+     * （值列宽度算成 0，文字直接消失）。
+     */
+    protected __afterStateMerge(sizeChanged: boolean): void;
+    private __render;
+}

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

@@ -0,0 +1,59 @@
+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';
+/**
+ * 抽屉：从屏幕某一边滑入的面板（带遮罩与焦点陷阱）。
+ *
+ * 与 ICEModal 同源（遮罩 + 焦点范围 + 关闭途径），差别只在：
+ * - 面板贴边（right / left / top / bottom）并沿该方向占满整条边；
+ * - 入场动效是与方向一致的滑入（A5 的 `slideIn`）。
+ */
+export declare type ICEDrawerPlacement = 'right' | 'left' | 'top' | 'bottom';
+export declare type ICEDrawerCloseReason = 'mask' | 'esc' | 'close' | 'api';
+export interface ICEDrawerOptions {
+    title?: string;
+    content?: string | (() => any);
+    placement?: ICEDrawerPlacement;
+    /** left/right 方向的宽度（默认 360） */
+    width?: number;
+    /** top/bottom 方向的高度（默认 240） */
+    height?: number;
+    closable?: boolean;
+    maskClosable?: boolean;
+    closeOnEsc?: boolean;
+    onClose?: (reason: ICEDrawerCloseReason) => void;
+    manager?: ICEOverlayManager;
+    focusManager?: ICEFocusManager;
+    animation?: {
+        duration?: number;
+        delay?: number;
+        easing?: ICEEasing;
+        driver?: ICEFrameDriver;
+    };
+}
+export declare class ICEDrawer {
+    private ice;
+    private options;
+    private manager;
+    private focus;
+    private handle;
+    private mask;
+    private panel;
+    private closeButton;
+    private previousFocus;
+    private pendingReason;
+    constructor(ice: any, options?: ICEDrawerOptions);
+    isOpen(): boolean;
+    getMask(): ICEPanel | null;
+    getPanel(): ICEPanel | null;
+    getCloseButton(): ICEButton | null;
+    open(): this;
+    close(reason?: ICEDrawerCloseReason): this;
+    private __handleClosed;
+    private __createPanel;
+    private __visibleWorldRect;
+}
+/** 便捷入口：`openDrawer(ice, options)`。 */
+export declare function openDrawer(ice: any, options?: ICEDrawerOptions): ICEDrawer;

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

@@ -0,0 +1,63 @@
+import { ICEWidget } from '../core/ICEWidget';
+import { ICEOverlayManager } from '../core/ICEOverlayManager';
+import type { ICEOverlayPlacement } from '../util/ICEOverlayPosition';
+/**
+ * 下拉菜单：点击触发组件弹出选项列表。
+ *
+ * - 弹出/定位/点外关闭/Esc 全部复用 `ICEOverlayManager`；
+ * - 菜单项支持 disabled 与选中态（primary + ✓）；点选回调 `onSelect(item, index)`；
+ * - 键盘：↑/↓ 在可选项间移动（跳过 disabled、首尾回绕），Enter 选中并关闭。
+ *   关闭状态下不响应方向键（避免抢走页面的按键）。
+ */
+export interface ICEDropdownItem {
+    key: string;
+    label: string;
+    disabled?: boolean;
+    danger?: boolean;
+}
+export interface ICEDropdownOptions {
+    items: ICEDropdownItem[];
+    selectedKey?: string;
+    placement?: ICEOverlayPlacement;
+    width?: number;
+    itemHeight?: number;
+    offset?: number;
+    onSelect?: (item: ICEDropdownItem, index: number) => void;
+    manager?: ICEOverlayManager;
+}
+export declare class ICEDropdown {
+    private ice;
+    private target;
+    private options;
+    private manager;
+    private handle;
+    private panel;
+    private itemNodes;
+    private items;
+    private selectedKey;
+    private activeIndex;
+    private running;
+    constructor(ice: any, target: any, options: ICEDropdownOptions);
+    start(): this;
+    destroy(): this;
+    isOpen(): boolean;
+    getSelectedKey(): string | null;
+    setSelectedKey(key: string | null): this;
+    getActiveIndex(): number;
+    getItemNode(index: number): ICEWidget | null;
+    setItems(items: ICEDropdownItem[]): this;
+    open(): this;
+    close(): this;
+    toggle(): this;
+    /** 键盘：↑/↓ 移动激活项（跳过 disabled），Enter 选中。 */
+    private __onKeyDown;
+    private __moveActive;
+    private __initialActiveIndex;
+    private __onTargetClick;
+    private __createPanel;
+    /** 重建菜单项（选中态 / 激活态 / 禁用态都在这里落地）。 */
+    private __buildMenu;
+    private __select;
+}
+/** 便捷绑定：`attachDropdown(ice, target, options)`。 */
+export declare function attachDropdown(ice: any, target: any, options: ICEDropdownOptions): ICEDropdown;

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

@@ -0,0 +1,28 @@
+import { ICEButton } from './ICEButton';
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 空状态：居中的图标 + 描述 + 可选操作按钮。
+ * 常用于列表/表格无数据、搜索无结果。
+ */
+export interface ICEEmptyOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    description?: string;
+    /** 图标字形（默认 ◌） */
+    icon?: string;
+    actionText?: string;
+    onAction?: () => void;
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+}
+export declare class ICEEmpty extends ICEWidget {
+    private actionButton;
+    /** 描述文案（构造时确定；语言包切换后重建组件即变） */
+    private descriptionText;
+    constructor(props: ICEEmptyOptions);
+    getActionButton(): ICEButton | null;
+    /** 空态描述文案（测试 / QA 用；语言包切换后重建组件即变）。 */
+    getDescription(): string;
+}

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

@@ -0,0 +1,63 @@
+import { ICEWidget } from '../core/ICEWidget';
+/**
+ * 悬浮操作按钮（Ant FloatButton）：一个圆形主按钮，点击展开一组子按钮。
+ *
+ * - 默认收起，子按钮 `display:false`（既不显示也不参与命中）；
+ * - 展开后子按钮沿 `direction`（默认向上）依次排开；
+ * - 点子按钮回调 `onItemClick(key)` 与子项自己的 `onClick`，并自动收起；
+ * - `type: 'primary' | 'default'` 决定主按钮底色。
+ */
+export interface ICEFloatButtonItem {
+    key: string;
+    /** 图标字形（★ ✓ ⚙ …） */
+    icon: string;
+    label?: string;
+    onClick?: () => void;
+}
+export interface ICEFloatButtonOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    /** 主按钮图标，默认 ＋（展开时变 ×） */
+    icon?: string;
+    /** 展开后的图标，默认 × */
+    expandedIcon?: string;
+    size?: number;
+    /** 与子按钮的间距，默认 8 */
+    gap?: number;
+    direction?: 'up' | 'down';
+    type?: 'primary' | 'default';
+    items?: ICEFloatButtonItem[];
+    left?: number;
+    top?: number;
+    onClick?: () => void;
+    onItemClick?: (key: string) => void;
+}
+export declare class ICEFloatButton extends ICEWidget {
+    private items;
+    private itemNodes;
+    private size;
+    private gap;
+    private direction;
+    private type;
+    private expanded;
+    private iconClosed;
+    private iconExpanded;
+    private iconNode;
+    private onClick;
+    private onItemClick;
+    constructor(props?: ICEFloatButtonOptions);
+    isExpanded(): boolean;
+    getItemNode(key: string): ICEWidget | null;
+    getItems(): ICEFloatButtonItem[];
+    getButtonColor(): string;
+    expand(): this;
+    collapse(): this;
+    toggle(): this;
+    /** @overwrite 键盘激活等价一次点击（展开 / 收起）。 */
+    activate(): void;
+    protected __applyHoverState(): void;
+    private __iconColor;
+    /** 子按钮只建一次，显隐靠 display（引擎的不可见组件不参与命中）。 */
+    private __renderItems;
+    private __sync;
+}

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

@@ -0,0 +1,48 @@
+import { ICEContainer } from '../core/ICEContainer';
+import { ICEFormItem } from './ICEFormItem';
+import { ICEFormModel } from '../model/ICEFormModel';
+/**
+ * 表单容器：把若干 ICEFormItem 纵向堆叠，绑上校验模型。
+ *
+ * - 值与校验都在 `ICEFormModel` 里（纯逻辑），ICEForm 负责「控件 ⇄ 模型」同步与错误渲染；
+ * - 控件触发 `change` → 写回模型并按 validateTrigger 校验 → 模型通知 → 表单项更新错误显示；
+ * - `submit()` 校验通过才回调 `onSubmit`（回调拿到当前值快照）。
+ */
+export interface ICEFormOptions {
+    /** 组件 id（引擎会用它做唯一标识，e2e/调试时可按 id 定位） */
+    id?: string;
+    width?: number;
+    gap?: number;
+    /** 复用外部模型（表单与业务共享状态） */
+    model?: ICEFormModel;
+    items?: ICEFormItem[];
+    left?: number;
+    top?: number;
+}
+export declare type ICEFormSubmitHandler = (values: Record<string, any>) => void;
+export declare class ICEForm extends ICEContainer {
+    private model;
+    private items;
+    private submitHandlers;
+    private itemGap;
+    /** reset 期间抑制「控件 change → 写回模型」，避免把初始值当成用户输入再校验一次 */
+    private muted;
+    constructor(props?: ICEFormOptions);
+    getModel(): ICEFormModel;
+    getItems(): ICEFormItem[];
+    addItems(items: ICEFormItem[]): this;
+    addItem(item: ICEFormItem): this;
+    getValues(): Record<string, any>;
+    setValues(values: Record<string, any>): this;
+    reset(): this;
+    validate(): boolean;
+    /** 同步 + 异步校验全部字段（返回是否通过）。 */
+    validateAsync(): Promise<boolean>;
+    onSubmit(handler: ICEFormSubmitHandler): this;
+    /** 校验通过才回调 onSubmit。 */
+    submit(): boolean;
+    /** 异步版提交：等异步校验通过才回调 onSubmit。 */
+    submitAsync(): Promise<boolean>;
+    private __syncErrors;
+    private __layout;
+}