huibo-ui 0.4.0 → 0.6.0

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

@@ -14,7 +14,10 @@ export declare class Message {
     /** 显示时间（毫秒），0 为不自动关闭 */
     duration: number;
     visible: boolean;
+    private autoCloseTimer?;
+    private removeTimer?;
     componentDidLoad(): void;
     private close;
+    disconnectedCallback(): void;
     render(): any;
 }

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

@@ -5,6 +5,8 @@ import { Placement } from '../../utils/popup-manager';
  * - 触发器 role=button + aria-haspopup=dialog + aria-expanded + aria-describedby
  * - 浮层 role=dialog + aria-live=polite（确认文屏幕阅读器实时播报）
  * - 键盘：trigger Enter/Space 打开；Esc=取消关闭；打开时自动聚焦确认按钮
+ *
+ * 进出场动画：用 leaving state 延迟卸载。
  */
 export declare class Popconfirm {
     el: HTMLElement;
@@ -15,18 +17,20 @@ export declare class Popconfirm {
     disabled: boolean;
     icon: string;
     visible: boolean;
+    leaving: boolean;
     popupStyle: Record<string, string>;
     private triggerRef?;
     private popupRef?;
     private confirmBtnRef?;
+    private leave;
     private show;
     private hide;
-    /** 键盘：Esc 取消关闭（Enter 由聚焦的确认按钮原生处理） */
+    disconnectedCallback(): void;
     private handleKeydown;
-    /** 触发器键盘：Enter/Space 打开 */
     private handleTriggerKeydown;
     private updatePosition;
     private handleConfirm;
     private handleCancel;
+    private get shouldRender();
     render(): any;
 }

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

@@ -5,6 +5,8 @@ import { Placement } from '../../utils/popup-manager';
  * - 触发器 role=button + aria-haspopup=dialog + aria-expanded
  * - 浮层 role=dialog + aria-labelledby（title）
  * - 键盘：trigger 上 Enter/Space 打开/关闭；Esc 关闭
+ *
+ * 进出场动画：用 leaving state 延迟卸载，让 fade-out 有机会播放。
  */
 export declare class Popover {
     el: HTMLElement;
@@ -14,14 +16,17 @@ export declare class Popover {
     trigger: 'hover' | 'click';
     disabled: boolean;
     visible: boolean;
+    leaving: boolean;
     popupStyle: Record<string, string>;
     private triggerRef?;
     private popupRef?;
+    private leave;
     private show;
     private hide;
     private toggle;
-    /** 触发器键盘：Enter/Space 切换；Esc 关闭（click 触发模式） */
+    disconnectedCallback(): void;
     private handleKeydown;
     private updatePosition;
+    private get shouldRender();
     render(): any;
 }

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

@@ -49,6 +49,11 @@ export declare class Radio {
      */
     hbChange: EventEmitter<string | number | boolean>;
     isChecked: boolean;
+    /**
+     * P7：实例级稳定 inputId，在类字段初始化一次。
+     * 修复前每次 render 用 Math.random() 生成新 id，破坏 SSR 水合与外部 getElementById 缓存。
+     */
+    private stableInputId;
     handleValueChange(): void;
     componentDidLoad(): void;
     private updateChecked;

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

@@ -22,6 +22,12 @@ export declare class Segmented {
     /** 选中值变化事件 */
     hbChange: EventEmitter<string>;
     componentWillLoad(): void;
+    /**
+     * 受控同步：父组件后续修改 modelValue 时，重新计算 activeIndex。
+     * 修复 B3——修复前 activeIndex 仅在 componentWillLoad 算一次，
+     * 导致受控用法下 roving tabindex 与键盘导航依赖的 activeIndex 失同步。
+     */
+    handleModelValueChange(): void;
     private syncActiveIndex;
     private handleSelect;
     /** 键盘导航：radiogroup 模式，←→/Home/End 移动并选中（跳过禁用项） */

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

@@ -70,12 +70,34 @@ export declare class Select {
      * 多选时最多显示多少个tag
      */
     maxCollapseTags?: number;
+    /**
+     * V1：是否开启虚拟滚动（1000+ 选项时推荐）。默认 false。
+     * 开启后下拉仅渲染可见窗口内的选项，DOM 节点数恒定。
+     */
+    virtual: boolean;
+    /**
+     * V1：下拉最大高度(px)。virtual=true 时必填（定义视口高度）。默认 256。
+     */
+    dropdownMaxHeight: number;
+    /**
+     * V1：虚拟滚动每项预估高度(px)。默认 34。
+     */
+    virtualItemHeight: number;
     isOpen: boolean;
     inputValue: string;
     searchValue: string;
     filteredOptions: SelectOption[];
     /** 键盘高亮的选项索引（-1 表示无） */
     activeOptionIndex: number;
+    /** V1：下拉滚动位置(px)，驱动虚拟滚动可见窗口重算 */
+    dropdownScrollTop: number;
+    /** V1：下拉滚动回调 */
+    private handleDropdownScroll;
+    /**
+     * O4：实例级稳定 id，用于 combobox 的 aria-controls / aria-activedescendant 关联，
+     * 让读屏在键盘导航时播报当前高亮项。
+     */
+    private listboxId;
     /**
      * 值改变事件
      */
@@ -102,5 +124,7 @@ export declare class Select {
      */
     private get createOption();
     private handleCreate;
+    /** 渲染单个选项 <li>（普通 + 虚拟滚动共用，V1 提取） */
+    private renderOption;
     render(): any;
 }

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

@@ -8,16 +8,33 @@ export interface TableColumn {
     width?: string;
     /** 最小列宽 */
     minWidth?: string;
-    /** 是否可排序 */
+    /** 是否可排序（true=按字段值排序） */
     sortable?: boolean;
+    /** 排序函数（接收两行，返回数字）。优先级高于 sortable，启用自定义排序（T2） */
+    sorter?: (a: Record<string, any>, b: Record<string, any>) => number;
+    /** 受控排序方向（设置后 Table 不再内部切换该列，由外部控制，T2） */
+    sortOrder?: SortDirection;
     /** 对齐方式 */
     align?: 'left' | 'center' | 'right';
     /** 固定列：left / right / true（等同 left） */
     fixed?: 'left' | 'right' | boolean;
     /** 单元格文本格式化（框架无关，返回纯文本字符串） */
     formatter?: (row: Record<string, any>, index: number) => string;
+    /** 自定义单元格渲染（返回字符串或内联 JSX，T7）。优先级高于 formatter */
+    render?: (row: Record<string, any>, index: number) => any;
     /** 该列是否可（行内）编辑；需同时开启 Table.editable 才生效 */
     editable?: boolean;
+    /** 筛选项（非空时表头显示筛选下拉；与 onFilter 配合，T3） */
+    filters?: {
+        label: string;
+        value: string | number;
+    }[];
+    /** 受控筛选值（设置后由外部控制，T3） */
+    filteredValue?: (string | number)[];
+    /** 筛选函数 (row, filterValue) => boolean（T3） */
+    onFilter?: (row: Record<string, any>, filterValue: string | number) => boolean;
+    /** 超出省略号 */
+    ellipsis?: boolean;
 }
 /**
  * 行操作按钮配置（框架无关）。
@@ -35,6 +52,24 @@ export interface TableAction {
     disabled?: (row: Record<string, any>, index: number) => boolean;
 }
 export type SortDirection = 'ascending' | 'descending' | null;
+/**
+ * 内置分页配置（T1）。传入 pagination 对象即启用内置分页，
+ * Table 自动切片 data 并在底部渲染 <hb-pagination>。
+ */
+export interface TablePagination {
+    /** 当前页（从 1 开始，受控） */
+    current?: number;
+    /** 默认当前页（非受控） */
+    defaultCurrent?: number;
+    /** 每页条数（受控） */
+    pageSize?: number;
+    /** 默认每页条数（非受控，默认 10） */
+    defaultPageSize?: number;
+    /** 可选每页条数 */
+    pageSizes?: number[];
+    /** 是否显示总数 */
+    showTotal?: boolean;
+}
 /**
  * 树形数据配置。
  * `children` 指定子节点在每行数据中的字段名（默认 'children'），
@@ -86,6 +121,13 @@ export declare class Table {
     treeProps?: TableTreeProps;
     /** 是否开启行内编辑模式（默认关闭）。需列配置 column.editable=true 才对该列生效 */
     editable: boolean;
+    /**
+     * 内置分页配置（T1）。传入后 Table 自动对 data 切片并在底部渲染 <hb-pagination>。
+     * 不传则不分页（向后兼容）。
+     */
+    pagination?: TablePagination;
+    /** 行 className（函数，按行返回附加 class，T8） */
+    rowClassName?: (row: Record<string, any>, index: number) => string;
     sortProp: string;
     sortDirection: SortDirection;
     currentRow: number;
@@ -99,6 +141,12 @@ export declare class Table {
         rowKey: string | number;
         prop: string;
     } | null;
+    /** T1 分页：内部当前页（非受控时用） */
+    internalPage: number;
+    /** T1 分页：内部每页条数（非受控时用） */
+    internalPageSize: number;
+    /** T3 筛选：内部筛选状态 { prop: 选中的 value 列表 }（非受控时用） */
+    internalFilters: Record<string, (string | number)[]>;
     /** 排序变化事件 */
     hbSortChange: EventEmitter<{
         prop: string;
@@ -128,16 +176,24 @@ export declare class Table {
         prop: string;
         value: any;
     }>;
+    /** T1 分页变化事件 { current, pageSize } */
+    hbPageChange: EventEmitter<{
+        current: number;
+        pageSize: number;
+    }>;
+    /** T3 筛选变化事件 { prop, values } */
+    hbFilterChange: EventEmitter<{
+        prop: string;
+        values: (string | number)[];
+    }>;
     handleDataChange(): void;
+    handlePaginationChange(): void;
     /** 树形模式是否启用（显式传入 treeProps 即启用） */
     private get isTreeMode();
     /** 子节点字段名（treeProps.children 缺省回退 'children'） */
     private get childrenField();
     /**
      * 把树拍平成可见行列表：仅保留「祖先链路全部已展开」的后代。
-     * @param list  当前层级的数组
-     * @param level 当前层级（根 = 0）
-     * @param parentKeyPath 父级 key 路径，用于构造深层稳定 key（避免不同分支同 index 撞 key）
      */
     private flattenTree;
     /** 树形展开/收起切换 */
@@ -158,8 +214,39 @@ export declare class Table {
     private get visibleRange();
     /** 虚拟滚动：撑高容器总高度 */
     private get virtualTotalHeight();
+    /**
+     * T2：解析某列的有效排序方向。
+     * 受控（col.sortOrder 设置）→ 用该值；否则用内部 state（sortProp/sortDirection）。
+     */
+    private effectiveSortOrder;
     private handleSort;
+    /**
+     * T2 增强的排序数据：支持 col.sorter 自定义排序函数 + 受控 sortOrder。
+     * 多列排序不支持（与 antd 行为一致，取首个有效排序列）。
+     */
     private get sortedData();
+    /**
+     * T3 筛选：应用所有列的 onFilter。
+     * 受控（col.filteredValue 已定义）→ 用该值；否则用内部 internalFilters[prop]。
+     */
+    private get filteredData();
+    /**
+     * T1 分页：取当前页数据切片（仅当 pagination 配置时）。
+     * 在 sorted+filtered 之后切片。
+     */
+    private get pagedData();
+    /** T1：当前页（受控优先） */
+    private get currentPage();
+    /** T1：当前每页条数（受控优先） */
+    private get currentPageSize();
+    /** T1：分页切换 */
+    private handlePageChange;
+    /** T1：每页条数切换 */
+    private handlePageSizeChange;
+    /** T3：筛选下拉切换某项 */
+    private handleFilterToggle;
+    /** T3：清空某列筛选 */
+    private handleFilterReset;
     private get isAllSelected();
     private get isIndeterminate();
     private toggleRow;
@@ -168,17 +255,31 @@ export declare class Table {
     private handleRowClick;
     private handleAction;
     private get hasActions();
-    /** 计算固定列的 sticky 偏移（左侧/右侧累计宽度） */
-    private get fixedOffsets();
+    /** T3：某列是否有激活筛选 */
+    private isColumnFiltered;
+    /**
+     * 计算固定列的 sticky 偏移（左侧/右侧累计宽度）。
+     * P1 优化：缓存结果，仅当 columns 引用变化时重算。
+     */
+    private _fixedOffsetsCache;
+    private _fixedOffsetsColumnsRef;
+    private getFixedOffsets;
     private cellStyle;
+    /**
+     * 渲染单元格内容（T7：优先 col.render，其次 formatter，最后原值）。
+     */
+    private renderCell;
     /**
      * 渲染单行（普通 + 虚拟滚动 + 树形 共用）。
-     * - 普通模式：rowIndex 为在 sortedData 中的全局索引。
-     * - 树形模式：fr.level 决定缩进，第一列渲染展开箭头，key 取 fr.key。
-     * fr 为可选；未传时按普通模式渲染。
      */
     private renderRow;
+    /**
+     * T3：渲染表头某列的筛选下拉。
+     */
+    private renderColumnFilter;
     /** 渲染表头（普通 + 虚拟滚动共用，表头始终固定不随滚） */
     private renderHeader;
+    /** T1：渲染内置分页底部栏 */
+    private renderPagination;
     render(): any;
 }

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

@@ -16,11 +16,17 @@ export declare class Tabs {
         key: string;
         label: string;
     }[];
+    /**
+     * P5：监听 slot 内 <hb-tab-pane> 的增删/属性变化，动态反映到 tabs 列表。
+     * 修复前 collectTabs 仅在 componentDidLoad 跑一次，运行时增删 pane 不生效（正确性 bug）。
+     */
+    private paneObserver?;
     /** 标签切换事件 */
     hbTabChange: EventEmitter<string>;
     /** 标签关闭事件 */
     hbTabRemove: EventEmitter<string>;
     componentDidLoad(): void;
+    disconnectedCallback(): void;
     handleModelValueChange(): void;
     private collectTabs;
     private updatePaneVisibility;

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

@@ -8,6 +8,8 @@ import { Placement } from '../../utils/popup-manager';
  * - 浮层 role=tooltip
  * - hover 触发时：focus 也显示（键盘用户可见，关键修复）
  * - click 触发时：Enter/Space 切换；任意模式 Esc 关闭
+ *
+ * 进出场动画：用 leaving state 延迟卸载，让 fade-out 有机会播放。
  */
 export declare class Tooltip {
     el: HTMLElement;
@@ -22,15 +24,19 @@ export declare class Tooltip {
     /** 是否显示箭头 */
     showArrow: boolean;
     visible: boolean;
+    leaving: boolean;
     popupStyle: Record<string, string>;
     private triggerRef?;
     private popupRef?;
     private hideTimer?;
+    private leave;
     private show;
     private hide;
     private toggle;
+    disconnectedCallback(): void;
     /** 键盘：Esc 关闭；click 模式 Enter/Space 切换 */
     private handleKeydown;
     private updatePosition;
+    private get shouldRender();
     render(): any;
 }

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

@@ -49,6 +49,12 @@ export declare class Tree {
     internalExpanded: string[] | null;
     internalSelected: string[] | null;
     internalChecked: string[] | null;
+    /**
+     * 键盘焦点节点 key（与 selectedKeys 解耦）。
+     * A2：roving tabindex 跟随 focusKey，而非 selectedKeys——否则键盘移动焦点会误改选中态。
+     * 默认指向 selectedKeys 末位（首次 Tab 进入时落在选中项）。
+     */
+    focusKey: string | null;
     /**
      * 选中节点变化事件（detail: 选中节点 key 数组）
      */
@@ -108,6 +114,24 @@ export declare class Tree {
      * 用于渲染层暴露三方态（aria-checked="mixed" + class）。
      */
     private computeIndeterminateKeys;
+    /**
+     * 构建当前可见节点的扁平列表（仅含已展开父节点的后代），用于键盘线性导航。
+     * 每项记录 { node, level, parentKey }，遵循 WAI-ARIA Tree View 模式。
+     */
+    private getFlattenedVisibleNodes;
+    /**
+     * Tree 键盘导航（WAI-ARIA Tree View 模式，A2 修复）：
+     * - ↑↓：在可见节点间线性移动焦点
+     * - →：展开；已展开则进入第一个子节点；叶子节点无操作
+     * - ←：折叠；已折叠则移到父节点；根节点无操作
+     * - Enter/Space：选中当前焦点节点
+     * - Home/End：跳到首个/末个可见节点
+     *
+     * 焦点管理用 roving tabindex：焦点移到谁，谁就是 selectedKeys（驱动 tabindex=0）。
+     */
+    private handleTreeKeydown;
+    /** 把键盘焦点移到 node：仅更新 focusKey（驱动 roving tabindex），不改选中态。 */
+    private focusNode;
     private renderNode;
     render(): any;
 }

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

@@ -43,6 +43,8 @@ export declare class TreeSelect {
     internalExpanded: string[];
     internalSelected: string[];
     internalChecked: string[];
+    /** 键盘焦点节点 key（A2：roving tabindex，与选中态解耦） */
+    focusKey: string | null;
     /**
      * 值变化事件（单选为 string，多选为 string[]）
      */
@@ -53,9 +55,24 @@ export declare class TreeSelect {
     hbVisibleChange: EventEmitter<boolean>;
     private clickOutside;
     componentWillLoad(): void;
+    /**
+     * 受控同步：父组件后续修改 modelValue 时，重算 internalSelected/internalChecked。
+     * 修复 B4——修复前仅 componentWillLoad 同步一次，受控改值后选中/勾选状态不更新。
+     */
+    handleModelValueChange(): void;
     componentDidLoad(): void;
     disconnectedCallback(): void;
     private syncFromModelValue;
+    /**
+     * 构建当前可见节点的扁平列表（仅含已展开父节点的后代），用于键盘线性导航（A2）。
+     */
+    private getFlattenedVisibleNodes;
+    /**
+     * Tree 键盘导航（WAI-ARIA Tree View 模式，A2 修复）：
+     * ↑↓ 线性移动、→ 展开/进子、← 折叠/回父、Enter/Space 选中、Home/End 跳首尾。
+     * 焦点（focusKey）与选中态（internalSelected/internalChecked）解耦。
+     */
+    private handleTreeKeydown;
     private collectExpandableKeys;
     private findTitle;
     private getDisplayText;

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

@@ -18,7 +18,13 @@ export declare class Watermark {
     fontColor: string;
     /** 字号 */
     fontSize: number;
-    private get backgroundImage();
+    /**
+     * P6：SVG data-URI 缓存。仅当依赖 props 变化时重算（escapeXml + encodeURIComponent 较重）。
+     * 修复前是 getter，每次 render 重编，父组件频繁重渲染时浪费明显。
+     */
+    private _bgImageCache;
+    private _bgImageKey;
+    private getBackgroundImage;
     private escapeXml;
     private get layerStyle();
     render(): any;