huibo-ui 0.3.0 → 0.4.0

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

@@ -6,145 +6,123 @@ export interface CascaderOption {
     disabled?: boolean;
     leaf?: boolean;
 }
+export type ValuePath = (string | number)[];
 /**
  * Cascader 级联选择器组件
- * 当一个数据集合有清晰的层级结构时，可通过级联选择器逐级查看并选择
+ * 当一个数据集合有清晰的层级结构时，可通过级联选择器逐级查看并选择。
+ * 支持单选 / 多选（multiple）、可选任意层级（checkStrictly）、搜索（filterable）、动态加载（lazy）。
  */
 export declare class Cascader {
     el: HTMLElement;
     /**
-     * 选中项绑定值
-     */
-    modelValue?: (string | number)[];
-    /**
-     * 可选项数据源
+     * 选中项绑定值。单选为一维路径数组（如 ['zhejiang','hangzhou']），
+     * 多选（multiple）为二维数组（如 [['zhejiang','ningbo'], ['jiangsu']]）。
      */
+    modelValue?: ValuePath | ValuePath[];
+    /** 可选项数据源 */
     options: CascaderOption[];
-    /**
-     * 输入框占位文本
-     */
+    /** 输入框占位文本 */
     placeholder: string;
-    /**
-     * 是否禁用
-     * @default false
-     */
+    /** 是否禁用 */
     disabled: boolean;
-    /**
-     * 输入框尺寸
-     */
+    /** 输入框尺寸 */
     size: 'large' | 'default' | 'small';
-    /**
-     * 是否可清空
-     * @default false
-     */
+    /** 是否可清空 */
     clearable: boolean;
-    /**
-     * 是否显示完整路径
-     * @default true
-     */
+    /** 是否显示完整路径（单选输入框 / 多选 tag 文本） */
     showAllLevels: boolean;
-    /**
-     * 输入框的原生属性
-     */
+    /** 输入框原生属性 */
     name?: string;
-    /**
-     * 输入框的原生属性
-     */
+    /** 输入框原生属性 */
     inputId?: string;
-    /**
-     * 分隔符
-     * @default ' / '
-     */
+    /** 路径分隔符 */
     separator: string;
-    /**
-     * 是否动态加载子节点
-     * @default true
-     */
+    /** modelValue 是否输出完整路径（保留 AntD 兼容位） */
     emitPath: boolean;
     /**
-     * 是否可搜索（filterable）
-     * 开启后下拉顶部渲染搜索输入框，输入时按 label（含所有子级）扁平化过滤，
-     * 匹配项以完整路径展示，点击即选中其完整路径。
-     * @default false
+     * 是否可搜索（filterable）。下拉顶部渲染搜索框，输入时按 label 扁平化过滤，
+     * 匹配项以完整路径展示，点击即选中（单选）或 toggle 勾选（多选）。
      */
     filterable: boolean;
     /**
-     * 是否开启动态加载（lazy load）。开启后，展开含 children=undefined 的节点时，
-     * 调用 load(node) 获取其子级并填充进 options，加载中显示 loading 态。
-     * @default false
+     * 是否开启动态加载（lazy）。展开 children=undefined 的节点时调用 load(node) 填充子级。
      */
     lazy: boolean;
-    /**
-     * 动态加载子节点的函数（仅在 lazy=true 时生效）。
-     * 接收被展开的节点，返回其子节点数组（Promise）。
-     * 加载结果会以不可变方式合并进 options 树（替换该节点 children）。
-     */
+    /** 动态加载函数（仅 lazy=true 生效） */
     load?: (node: CascaderOption) => Promise<CascaderOption[]>;
-    isOpen: boolean;
-    inputValue: string;
-    searchValue: string;
     /**
-     * 正在动态加载子级的节点 value 集合（用于渲染 loading 态）。
+     * 是否开启多选。开启后 modelValue 为二维数组，每条为一个选中路径；
+     * 菜单项前渲染 checkbox，输入框以 tag 列表展示选中项。
      */
-    loadingKeys: Set<string | number>;
+    multiple: boolean;
     /**
-     * 扁平化搜索结果：每一项是一个从根到匹配节点的完整路径（用于点击选中）。
-     * 仅在 filterable 且 searchValue 非空时使用。
+     * 是否严格的选中行为（父子不关联）。
+     * 单选：点击任意层级（含非叶子）即选中该路径；
+     * 多选：勾选独立，不向下联动选中叶子、取消也不联动。
      */
-    filteredPaths: CascaderOption[][];
-    activePath: (string | number)[];
+    checkStrictly: boolean;
     /**
-     * 值改变事件
+     * 多选时输入框最多展示的 tag 数量，超出折叠为 +N（可选）。
      */
-    hbChange: EventEmitter<(string | number)[] | undefined>;
-    /**
-     * 展开节点发生变化时触发
-     */
-    hbExpandChange: EventEmitter<(string | number)[]>;
+    maxTagCount?: number;
+    isOpen: boolean;
+    inputValue: string;
+    searchValue: string;
+    /** 正在动态加载子级的节点 value 集合 */
+    loadingKeys: Set<string | number>;
+    /** 扁平化搜索结果：每项为根到匹配节点的完整路径 */
+    filteredPaths: CascaderOption[][];
+    activePath: ValuePath;
+    /** 值改变事件：单选 emit 一维路径或 undefined；多选 emit 二维数组（可能为 []） */
+    hbChange: EventEmitter<ValuePath | ValuePath[] | undefined>;
+    /** 展开节点变化时触发 */
+    hbExpandChange: EventEmitter<ValuePath>;
     private clickOutside;
     componentDidLoad(): void;
-    /** 关闭下拉并清空搜索态（filterable 模式下避免重开时残留搜索结果） */
     private closeAndClearSearch;
     disconnectedCallback(): void;
     handleValueChange(): void;
     private updateInputValue;
     private findOptionByValue;
+    /** 取多选 modelValue 为二维数组（非多选模式或形状不符时返回 []） */
+    private getMultiModel;
+    /** 两条 value 路径是否完全相等 */
+    private pathEquals;
+    /** 收集某节点子树下的全部叶子 value 路径（用于父子联动计算） */
+    private collectLeafValuePaths;
+    /**
+     * 多选模式下某节点的勾选三态。
+     * checkStrictly：该节点路径是否在 modelValue（checked / unchecked）。
+     * 默认：按叶子计算 —— 全部叶子入选=checked，部分=indeterminate，无=unchecked。
+     */
+    private getCheckState;
+    /** 多选：toggle 某节点勾选（按 checkStrictly 决定是否联动叶子） */
+    private handleCheck;
+    /** 多选输入框 tag 数据：每条选中路径 → 展示文本 + 路径 */
+    private getDisplayTags;
+    /** 多选：删除单个 tag（移除对应路径） */
+    private handleTagRemove;
+    private hasValue;
     private handleInputClick;
-    /** 搜索输入：仅更新 searchValue，过滤在 render 前的 @State 派生 */
-    private handleSearchInput;
     /**
-     * 扁平化全树搜索：把 options 深度遍历，收集所有「节点 label 含关键字」的完整路径。
-     * 一个节点的完整路径 = 从根到该节点（含自身）的 CascaderOption 数组。
-     * 关键字为空时返回空数组（交由正常级联视图渲染）。
-     *
-     * 注意：这里按 label 子串匹配（大小写不敏感），匹配任意层级的节点，
-     * 并保留其祖先链以便点击时还原完整路径。
+     * 键盘交互（对齐 antd / WAI-ARIA combobox）：
+     * Enter/Space/ArrowDown 在关闭时打开；Escape 关闭；ArrowRight/ArrowLeft 跨级导航。
      */
+    private handleKeyDown;
+    private handleSearchInput;
     private collectFilteredPaths;
-    /** 从扁平搜索结果路径中点击叶子（或非叶子）项：直接以该路径的 value 数组作为选中值 */
+    /** 搜索结果点击：单选选中（叶子或 checkStrictly 任意层），多选 toggle 该路径 */
     private handleSearchSelect;
     private handleClear;
+    /** 菜单项点击（label 区）：多选→叶子 toggle/非叶子展开；单选→handleSelect */
+    private handleItemClick;
+    /** 单选：选中（叶子或 checkStrictly 任意层）或展开 / lazy 加载 */
     private handleSelect;
-    /**
-     * 动态加载某节点的子级。不可变地合并进 options 树（替换该节点 children）。
-     * 加载中：把节点 value 加入 loadingKeys（渲染 loading 态）；
-     * 加载完成：写入 children（新数组，触发 @Watch/重渲染），移出 loadingKeys。
-     * 若 load 返回空数组，把 children 设为 [] 以标记该节点为叶子（避免重复加载）。
-     */
     private loadChildren;
-    /**
-     * 不可变地替换 options 树中 value===targetValue 节点的 children 字段。
-     * 返回一棵全新的 options 树（不修改原数组与原节点对象）。
-     */
     private replaceOptionChildren;
     render(): any;
     private renderCascaderMenus;
-    /** lazy 加载中渲染的面板：一个 loading 占位提示 */
     private renderLoadingMenu;
-    /**
-     * 渲染扁平化搜索结果：每一项展示完整路径（label 用 separator 连接），点击选中完整路径。
-     * 无匹配时渲染空状态。
-     */
     private renderSearchResults;
     private renderMenu;
 }

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

@@ -32,6 +32,7 @@ export declare class ColorPicker {
     hue: number;
     saturation: number;
     value: number;
+    alpha: number;
     /**
      * 值改变事件
      */
@@ -45,15 +46,25 @@ export declare class ColorPicker {
     private handleDocumentClick;
     handleValueChange(): void;
     private handleTriggerClick;
+    /** 键盘交互：Escape 关闭面板（对齐 antd / WAI-ARIA） */
+    private handleKeyDown;
+    /** 把 3 位简写 hex 规范化为 6 位，避免后续 hexToRgb 解析失败 */
+    private normalizeHex;
     private handleColorSelect;
     private handleSaturationClick;
     private handleHueClick;
     private handleInputChange;
+    /** 透明度条点击/拖动：X 轴映射到 alpha 0-100 */
+    private handleAlphaClick;
     private handleRgbInputChange;
     private hexToRgb;
     private rgbToHsv;
     private hsvToRgb;
     private hsvToHex;
     private updateHSVFromColor;
+    /** 按当前 colorFormat 输出最终颜色字符串（对齐 antd 的 format 行为） */
+    private getFormattedValue;
+    /** HSV → HSL（HSL 字符串输出用） */
+    private hsvToHsl;
     render(): any;
 }

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

@@ -20,10 +20,13 @@ export declare class DatePicker {
     /** 显示在输入框中的格式 */
     valueFormat?: string;
     /**
-     * 日期选择器类型
-     * 当前仅支持 'date'，更多类型将在后续版本实现
+     * 日期选择器类型：
+     * - 'date'：日选择（默认）
+     * - 'month'：月选择（month 视图网格，emit YYYY-MM）
+     * - 'year'：年选择（year 视图网格，emit YYYY）
+     * 注：'datetime'/'week' 请用独立的 DateTimePicker 组件 / 后续补全。
      */
-    type: "date";
+    type: 'date' | 'month' | 'year';
     /**
      * 禁用日期判定函数。返回 true 的日期在日历中不可选（加 disabled 态、不可点击、aria-disabled）。
      * @param date 当前日期格子的 Date 对象
@@ -36,6 +39,8 @@ export declare class DatePicker {
     isOpen: boolean;
     inputValue: string;
     selectedDate?: Date;
+    /** month/year 模式的面板锚点（不随选择改变，仅导航用） */
+    panelViewDate: Date;
     /** 值改变事件 */
     hbChange: EventEmitter<string | Date>;
     private clickOutside;
@@ -46,7 +51,13 @@ export declare class DatePicker {
     private handleInputClick;
     private handleClear;
     private handleDateSelect;
+    /** type='month'：选某月 → 锚定到该月 1 号，emit YYYY-MM */
+    private handleMonthSelect;
+    /** type='year'：选某年 → 锚定到该年 1 月 1 日，emit YYYY */
+    private handleYearSelect;
     private changeMonth;
+    /** month/year 面板导航：month ±1 年、year ±12 年 */
+    private changePanelView;
     /** 判断某日期是否被 disabledDate 禁用 */
     private isDateDisabled;
     render(): any;

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

@@ -8,7 +8,12 @@ export interface DropdownItem {
 }
 /**
  * Dropdown 下拉菜单组件
- * 将动作或菜单折叠到下拉菜单中
+ * 将动作或菜单折叠到下拉菜单中。
+ *
+ * 无障碍（对齐 WAI-ARIA menu / antd）：
+ * - 触发器 role=button + aria-haspopup=menu + aria-expanded
+ * - 菜单 role=menu，菜单项 role=menuitem + aria-disabled
+ * - 键盘：trigger 上 Enter/Space/↓ 打开；菜单内 ↑↓ 导航、Enter/Space 选中、Esc 关闭
  */
 export declare class Dropdown {
     el: HTMLElement;
@@ -19,14 +24,22 @@ export declare class Dropdown {
     /** 是否禁用 */
     disabled: boolean;
     isOpen: boolean;
+    /** 键盘高亮项索引（-1 表示无） */
+    activeIndex: number;
     /** 命令事件 */
     hbCommand: EventEmitter<string>;
     private clickOutside;
     componentDidLoad(): void;
     disconnectedCallback(): void;
+    private open;
+    private close;
     private show;
     private hide;
     private toggle;
     private handleSelect;
+    /** 触发器键盘：Enter/Space/↓ 打开 */
+    private handleTriggerKeydown;
+    /** 菜单键盘：↑↓ 导航、Enter/Space 选中、Esc 关闭、Home/End 跳首尾 */
+    private handleMenuKeydown;
     render(): any;
 }

package/dist/types/components/Form/FormItem.d.ts

@@ -18,8 +18,18 @@ export declare class FormItem {
     size: 'large' | 'default' | 'small';
     errors: string[];
     isvalidating: boolean;
+    /** hb-form 在 componentWillLoad 注册的事件监听；FormItem 在 componentDidLoad 派发，
+     *  但 componentWillLoad 早于子组件的 componentDidLoad，因此注册一定先到。
+     *  这里还监听 hbFieldReset，便于 Form.resetFields 主动广播。 */
     componentDidLoad(): void;
+    disconnectedCallback(): void;
+    /** 子控件 hbChange 时，若当前有错误则重新校验以尽早清除错误提示 */
+    private handleChildChange;
     private get formRules();
+    /** 是否渲染必填星号：显式 required 或任一规则带 required（对齐 antd 自动推断） */
+    private get isRequired();
+    /** 继承父 hb-form 的 labelPosition（FormItem 自身无此 prop，避免与 Form 冲突时以 Form 为准） */
+    private get resolvedLabelPosition();
     /**
      * 验证此字段
      */

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

@@ -50,7 +50,11 @@ export declare class ImagePreview {
     private handleReset;
     private handleRotateLeft;
     private handleRotateRight;
-    /** 滚轮缩放 */
+    /**
+     * 滚轮缩放（平滑 + 像素级响应）：
+     * 按 deltaY 的绝对值映射缩放因子（小滚幅小步、大滚幅大步），
+     * 并夹取到 [minZoom, maxZoom]，避免抖动与越界。
+     */
     private handleWheel;
     /** 点击遮罩空白处关闭 */
     private handleOverlayClick;

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

@@ -122,6 +122,15 @@ export declare class Input {
     handleValueChange(): void;
     componentDidLoad(): void;
     private updateClearVisible;
+    /**
+     * textarea 自适应高度（autosize）。
+     * - autosize=false 或非 textarea：跳过。
+     * - autosize=true：按内容自适应。
+     * - autosize={minRows,maxRows}：在最小/最大行数间夹取。
+     * 算法：先把 height 置 auto 让浏览器按内容重排，再读 scrollHeight，
+     *      减去 padding 后按行高换算成行数，最后按 min/max 夹取并写回 height。
+     */
+    private resizeTextarea;
     private handleInput;
     private handleChange;
     private handleFocus;

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

@@ -1,6 +1,14 @@
+/** 响应式栅格配置（对齐 antd：可传 number 或 {span,offset,push,pull}） */
+export interface ColResponsive {
+    span?: number;
+    offset?: number;
+    push?: number;
+    pull?: number;
+}
 /**
  * Layout 布局组件
- * 通过基础的 24 分栏，迅速简便地创建布局
+ * 通过基础的 24 分栏，迅速简便地创建布局。
+ * 支持响应式：xs/sm/md/lg/xl 在对应断点应用各自的 span/offset/push/pull。
  */
 export declare class Layout {
     /**
@@ -24,25 +32,27 @@ export declare class Layout {
      */
     pull: number;
     /**
-     * <768px 响应式栅格数或者栅格属性对象
+     * <576px 响应式栅格数或者栅格属性对象
+     */
+    xs?: number | ColResponsive;
+    /**
+     * ≥576px 响应式栅格数或者栅格属性对象
      */
-    xs?: number | object;
+    sm?: number | ColResponsive;
     /**
      * ≥768px 响应式栅格数或者栅格属性对象
      */
-    sm?: number | object;
+    md?: number | ColResponsive;
     /**
      * ≥992px 响应式栅格数或者栅格属性对象
      */
-    md?: number | object;
+    lg?: number | ColResponsive;
     /**
      * ≥1200px 响应式栅格数或者栅格属性对象
      */
-    lg?: number | object;
-    /**
-     * ≥1920px 响应式栅格数或者栅格属性对象
-     */
-    xl?: number | object;
+    xl?: number | ColResponsive;
+    /** 把响应式 prop（number 或对象）规范化为 {span,offset,push,pull} */
+    private normalizeResponsive;
     private getColClass;
     render(): any;
 }

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

@@ -21,11 +21,14 @@ export declare class Pagination {
     /** 是否显示每页条数选择器 */
     showPageSize: boolean;
     internalCurrent: number;
+    /** 内部每页条数：pageSize 变更时同步；size 切换后立即生效重算 totalPages */
+    internalPageSize: number;
     /** 当前页改变事件 */
     hbCurrentChange: EventEmitter<number>;
     /** 每页条数改变事件 */
     hbSizeChange: EventEmitter<number>;
     handleCurrentPageChange(): void;
+    handlePageSizeChange(): void;
     componentDidLoad(): void;
     private get totalPages();
     private handlePageClick;

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

@@ -1,4 +1,11 @@
 import { Placement } from '../../utils/popup-manager';
+/**
+ * Popconfirm 气泡确认框
+ * 无障碍（对齐 antd / WAI-ARIA）：
+ * - 触发器 role=button + aria-haspopup=dialog + aria-expanded + aria-describedby
+ * - 浮层 role=dialog + aria-live=polite（确认文屏幕阅读器实时播报）
+ * - 键盘：trigger Enter/Space 打开；Esc=取消关闭；打开时自动聚焦确认按钮
+ */
 export declare class Popconfirm {
     el: HTMLElement;
     title: string;
@@ -11,8 +18,13 @@ export declare class Popconfirm {
     popupStyle: Record<string, string>;
     private triggerRef?;
     private popupRef?;
+    private confirmBtnRef?;
     private show;
     private hide;
+    /** 键盘：Esc 取消关闭（Enter 由聚焦的确认按钮原生处理） */
+    private handleKeydown;
+    /** 触发器键盘：Enter/Space 打开 */
+    private handleTriggerKeydown;
     private updatePosition;
     private handleConfirm;
     private handleCancel;

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

@@ -1,4 +1,11 @@
 import { Placement } from '../../utils/popup-manager';
+/**
+ * Popover 气泡卡片
+ * 无障碍（对齐 antd / WAI-ARIA）：
+ * - 触发器 role=button + aria-haspopup=dialog + aria-expanded
+ * - 浮层 role=dialog + aria-labelledby（title）
+ * - 键盘：trigger 上 Enter/Space 打开/关闭；Esc 关闭
+ */
 export declare class Popover {
     el: HTMLElement;
     title: string;
@@ -13,6 +20,8 @@ export declare class Popover {
     private show;
     private hide;
     private toggle;
+    /** 触发器键盘：Enter/Space 切换；Esc 关闭（click 触发模式） */
+    private handleKeydown;
     private updatePosition;
     render(): any;
 }

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

@@ -55,6 +55,13 @@ export declare class Rate {
     componentDidLoad(): void;
     handleValueChange(): void;
     private handleClick;
+    /**
+     * 键盘调节评分（对齐 WAI-ARIA slider / antd Rate）：
+     * - ArrowRight/ArrowUp：增加（allowHalf 时步进 0.5，否则 1）
+     * - ArrowLeft/ArrowDown：减少
+     * - Home：归 0；End：满分
+     */
+    private handleKeydown;
     private handleMouseEnter;
     private handleMouseLeave;
     private getDisplayValue;

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

@@ -1,9 +1,15 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 /**
  * Segmented 分段控制器组件
- * 类似 iOS 分段控件，选中项有高亮滑块背景
+ * 类似 iOS 分段控件，选中项有高亮滑块背景。
+ *
+ * 无障碍（对齐 WAI-ARIA radiogroup / antd Segmented）：
+ * - 容器 role=radiogroup
+ * - 选项 role=radio + aria-checked + tabindex（仅选中项 tabindex=0，roving）
+ * - 键盘：←→ 在选项间移动并选中、Home/End 跳首尾
  */
 export declare class Segmented {
+    el: HTMLElement;
     /** 当前选中值 */
     modelValue: string;
     /** 是否撑满宽度 */
@@ -12,9 +18,14 @@ export declare class Segmented {
     size: 'large' | 'default' | 'small';
     /** 选项数组 */
     options: SegmentedOption[];
+    activeIndex: number;
     /** 选中值变化事件 */
     hbChange: EventEmitter<string>;
+    componentWillLoad(): void;
+    private syncActiveIndex;
     private handleSelect;
+    /** 键盘导航：radiogroup 模式，←→/Home/End 移动并选中（跳过禁用项） */
+    private handleKeydown;
     render(): any;
 }
 export interface SegmentedOption {

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

@@ -96,5 +96,11 @@ export declare class Select {
     private handleClear;
     private handleSearch;
     private isSelected;
+    /**
+     * allowCreate + filterable：当用户输入的文本在已有选项中不存在时，
+     * 渲染一个"创建 xxx"项。返回待创建的文本（已 trim）；无需创建返回 null。
+     */
+    private get createOption();
+    private handleCreate;
     render(): any;
 }

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

@@ -1,7 +1,12 @@
 import { EventEmitter } from '../../stencil-public-runtime';
+/** 刻度定义：值 →（可选）标签 */
+export interface SliderMark {
+    value: number;
+    label?: string;
+}
 /**
  * Slider 滑块组件
- * 通过拖动滑块在一个固定区间内进行选择
+ * 通过拖动滑块在一个固定区间内进行选择，支持单滑块/双滑块（range）/竖向/刻度。
  */
 export declare class Slider {
     el: HTMLElement;
@@ -52,12 +57,20 @@ export declare class Slider {
      * 高度，竖向模式时必填
      */
     height?: string;
+    /**
+     * 刻度标记（对齐 antd marks）
+     */
+    marks?: SliderMark[] | Record<number, string>;
     dragging: boolean;
     currentValue: number | number[];
     tooltipVisible: boolean;
     tooltipValue: number;
+    /** range 模式下当前拖动的是哪个手柄（0/1），用于 tooltip 定位与渲染 */
+    activeHandle: 0 | 1;
     private sliderRef?;
     private isDragging;
+    /** 拖动期间锁定的手柄索引（鼠标按下时确定） */
+    private dragHandle;
     /**
      * 值改变事件
      */
@@ -68,14 +81,27 @@ export declare class Slider {
     hbInput: EventEmitter<number | number[]>;
     componentDidLoad(): void;
     disconnectedCallback(): void;
+    /** 外部更新 modelValue 时同步内部 currentValue（对齐 antd 受控语义） */
+    handleModelChange(): void;
+    /** range 模式下确保 currentValue 为 [min, max] 形状的有序数组 */
+    private normalizeInitial;
     private addEventListeners;
     private removeEventListeners;
     private getPercentage;
     private getValueFromPercentage;
+    /** 鼠标按下时根据落点决定拖哪个手柄（range：更近的那个） */
+    private resolveHandle;
     private handleMouseDown;
     private handleMouseMove;
     private handleMouseUp;
     private handleDrag;
+    /** 键盘可访问：方向键调整当前手柄，对齐 WAI-ARIA slider pattern */
+    private handleKeyDown;
     private formatValue;
+    /** 规范化 marks 为 [{value,label}] 数组 */
+    private get markList();
     render(): any;
+    /** 触屏支持：把 touch 事件映射到 mouse 同等逻辑（移动端可用） */
+    private handleTouchStart;
+    private dragFromTouch;
 }

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

@@ -1,15 +1,23 @@
+export type StepStatus = 'wait' | 'process' | 'finish' | 'error';
+interface StepMeta {
+    title: string;
+    description?: string;
+    /** 自定义图标名/标记（'hb-icon' name 或文本）。undefined 表示用默认序号/状态图标 */
+    icon?: string;
+    /** 子项显式状态覆盖（不指定则按 active 自动推导） */
+    status?: StepStatus;
+}
 export declare class Steps {
     el: HTMLElement;
     active: number;
-    processStatus: 'wait' | 'process' | 'finish' | 'error';
+    processStatus: StepStatus;
     alignCenter: boolean;
     direction: 'horizontal' | 'vertical';
-    steps: {
-        title: string;
-        description?: string;
-    }[];
+    steps: StepMeta[];
     componentDidLoad(): void;
     private getStatus;
-    private getIcon;
+    /** 渲染图标：子项自定义 icon 优先；否则按状态（finish=✓、error=✕、其余=序号） */
+    private renderIcon;
     render(): any;
 }
+export {};

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

@@ -1,7 +1,13 @@
 import { Placement } from '../../utils/popup-manager';
 /**
  * Tooltip 文字提示组件
- * 鼠标悬停或点击时显示提示文字
+ * 鼠标悬停或点击时显示提示文字。
+ *
+ * 无障碍（对齐 antd / WAI-ARIA）：
+ * - 触发器 aria-describedby 关联浮层 id（屏幕阅读器读出 content）
+ * - 浮层 role=tooltip
+ * - hover 触发时：focus 也显示（键盘用户可见，关键修复）
+ * - click 触发时：Enter/Space 切换；任意模式 Esc 关闭
  */
 export declare class Tooltip {
     el: HTMLElement;
@@ -23,6 +29,8 @@ export declare class Tooltip {
     private show;
     private hide;
     private toggle;
+    /** 键盘：Esc 关闭；click 模式 Enter/Space 切换 */
+    private handleKeydown;
     private updatePosition;
     render(): any;
 }