huibo-ui 0.3.0 → 0.5.0

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/Dialog/Dialog.d.ts

@@ -32,11 +32,23 @@ export declare class Dialog {
     private zIndex;
     private panelRef?;
     private trap?;
-    handleVisibleChange(newVal: boolean): void;
+    /** 离场动画期间保留渲染（避免 display:none 打断 transition） */
+    leaving: boolean;
+    private leaveTimer?;
+    handleVisibleChange(newVal: boolean, oldVal: boolean): void;
     disconnectedCallback(): void;
     componentDidRender(): void;
     private handleKeyDown;
     private close;
+    /**
+     * 进入离场动画期：解锁滚动、移除监听、保留 DOM 播放动画，
+     * 结束（300ms）后重置 leaving 并 emit hbClosed。
+     * 受控关闭（父组件直接设 modelValue=false 经 @Watch）与内部关闭（ESC/遮罩/关闭按钮）
+     * 统一走这里，保证两者行为一致（都有动画 + 都 emit hbClose/hbClosed）。
+     */
+    private startLeave;
     private handleOverlayClick;
+    /** 是否应渲染弹层 DOM：打开中 或 离场动画期内 */
+    private get shouldRender();
     render(): any;
 }

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

@@ -13,6 +13,9 @@ export declare class Drawer {
     private zIndex;
     private panelRef?;
     private trap?;
+    /** 离场动画期内保留渲染 */
+    private leaving;
+    private leaveTimer?;
     hbOpen: EventEmitter<void>;
     hbClose: EventEmitter<void>;
     handleVisible(val: boolean): void;
@@ -20,5 +23,6 @@ export declare class Drawer {
     disconnectedCallback(): void;
     private handleKeyDown;
     private close;
+    private get shouldRender();
     render(): any;
 }

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

@@ -8,7 +8,14 @@ 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 关闭
+ *
+ * 进出场动画：用 leaving state 延迟卸载，让 fade-out 有机会播放。
  */
 export declare class Dropdown {
     el: HTMLElement;
@@ -19,14 +26,24 @@ export declare class Dropdown {
     /** 是否禁用 */
     disabled: boolean;
     isOpen: boolean;
+    /** 离场动画期（保留 DOM 让 fade-out 播完） */
+    leaving: boolean;
+    /** 键盘高亮项索引（-1 表示无） */
+    activeIndex: number;
     /** 命令事件 */
     hbCommand: EventEmitter<string>;
+    private leave;
     private clickOutside;
     componentDidLoad(): void;
     disconnectedCallback(): void;
+    private open;
+    private close;
     private show;
     private hide;
     private toggle;
     private handleSelect;
+    private handleTriggerKeydown;
+    private handleMenuKeydown;
+    private get shouldRender();
     render(): any;
 }

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

@@ -26,7 +26,9 @@ export declare class Form {
     disabled: boolean;
     fields: FormFieldRegistration[];
     private fieldRegistry;
+    private handleFieldRegister;
     componentWillLoad(): void;
+    disconnectedCallback(): void;
     /**
      * 验证整个表单
      * @returns 是否验证通过

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/Image/Image.d.ts

@@ -10,6 +10,12 @@ export declare class Image {
     loaded: boolean;
     error: boolean;
     previewVisible: boolean;
+    /**
+     * 换 src 时重置 loaded/error。
+     * 修复 B5——修复前换 src 不清状态：坏图换好图卡在错误占位（error 不清零），
+     * 好图换坏图 loaded 仍 true 造成短暂状态错乱。
+     */
+    handleSrcChange(): void;
     private handleLoad;
     private handleError;
     render(): any;

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/Menu/MenuItem.d.ts

@@ -3,8 +3,15 @@
  */
 export declare class MenuItem {
     el: HTMLElement;
-    /** 唯一标识 */
+    /**
+     * 唯一标识。
+     * O3：推荐用 itemKey。保留 key 作为向后兼容别名（key 是 Stencil/React 保留 prop，
+     * 通过 JSX 设置时可能被 vdom 拦截；HTML 属性 key="..." 仍可工作）。
+     */
+    itemKey: string;
     key: string;
+    /** 解析出的有效 key：itemKey 优先，回退到 key */
+    private get effectiveKey();
     /** 是否禁用 */
     disabled: boolean;
     /** 图标 */

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/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,13 @@
 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=取消关闭；打开时自动聚焦确认按钮
+ *
+ * 进出场动画：用 leaving state 延迟卸载。
+ */
 export declare class Popconfirm {
     el: HTMLElement;
     title: string;
@@ -8,13 +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;
+    disconnectedCallback(): void;
+    private handleKeydown;
+    private handleTriggerKeydown;
     private updatePosition;
     private handleConfirm;
     private handleCancel;
+    private get shouldRender();
     render(): any;
 }

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

@@ -1,4 +1,13 @@
 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 关闭
+ *
+ * 进出场动画：用 leaving state 延迟卸载，让 fade-out 有机会播放。
+ */
 export declare class Popover {
     el: HTMLElement;
     title: string;
@@ -7,12 +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;
+    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/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,20 @@ export declare class Segmented {
     size: 'large' | 'default' | 'small';
     /** 选项数组 */
     options: SegmentedOption[];
+    activeIndex: number;
     /** 选中值变化事件 */
     hbChange: EventEmitter<string>;
+    componentWillLoad(): void;
+    /**
+     * 受控同步：父组件后续修改 modelValue 时，重新计算 activeIndex。
+     * 修复 B3——修复前 activeIndex 仅在 componentWillLoad 算一次，
+     * 导致受控用法下 roving tabindex 与键盘导航依赖的 activeIndex 失同步。
+     */
+    handleModelValueChange(): void;
+    private syncActiveIndex;
     private handleSelect;
+    /** 键盘导航：radiogroup 模式，←→/Home/End 移动并选中（跳过禁用项） */
+    private handleKeydown;
     render(): any;
 }
 export interface SegmentedOption {

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

@@ -76,6 +76,11 @@ export declare class Select {
     filteredOptions: SelectOption[];
     /** 键盘高亮的选项索引（-1 表示无） */
     activeOptionIndex: number;
+    /**
+     * O4：实例级稳定 id，用于 combobox 的 aria-controls / aria-activedescendant 关联，
+     * 让读屏在键盘导航时播报当前高亮项。
+     */
+    private listboxId;
     /**
      * 值改变事件
      */
@@ -96,5 +101,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/Table/Table.d.ts

@@ -168,8 +168,14 @@ export declare class Table {
     private handleRowClick;
     private handleAction;
     private get hasActions();
-    /** 计算固定列的 sticky 偏移（左侧/右侧累计宽度） */
-    private get fixedOffsets();
+    /**
+     * 计算固定列的 sticky 偏移（左侧/右侧累计宽度）。
+     * P1 优化：缓存结果，仅当 columns 引用变化时重算。
+     * 修复前是 getter，被每个 <td>/<th> 反复调用，复杂度 O(rows×cols²)。
+     */
+    private _fixedOffsetsCache;
+    private _fixedOffsetsColumnsRef;
+    private getFixedOffsets;
     private cellStyle;
     /**
      * 渲染单行（普通 + 虚拟滚动 + 树形 共用）。

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

@@ -1,7 +1,15 @@
 import { Placement } from '../../utils/popup-manager';
 /**
  * Tooltip 文字提示组件
- * 鼠标悬停或点击时显示提示文字
+ * 鼠标悬停或点击时显示提示文字。
+ *
+ * 无障碍（对齐 antd / WAI-ARIA）：
+ * - 触发器 aria-describedby 关联浮层 id（屏幕阅读器读出 content）
+ * - 浮层 role=tooltip
+ * - hover 触发时：focus 也显示（键盘用户可见，关键修复）
+ * - click 触发时：Enter/Space 切换；任意模式 Esc 关闭
+ *
+ * 进出场动画：用 leaving state 延迟卸载，让 fade-out 有机会播放。
  */
 export declare class Tooltip {
     el: HTMLElement;
@@ -16,13 +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;
 }