huibo-ui 0.3.0 → 0.5.0

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;
@@ -64,6 +81,15 @@ export declare class TreeSelect {
     private toggleDropdown;
     private handleNodeSelect;
     private handleNodeCheck;
+    /** 取消父级时级联取消所有后代（含禁用项，因为它们是被父带选的） */
+    private removeDescendantKeys;
+    /** 勾选父级时级联勾选所有非禁用后代 */
+    private collectCheckableDescendantKeys;
+    /** 自底向上修正祖先：所有非禁用子节点全选 → 父勾选；否则移出（部分选体现为 indeterminate） */
+    private reconcileAncestors;
+    private findAncestors;
+    /** 计算当前 checked 集合下处于「部分选中」的节点（用于三方态渲染） */
+    private computeIndeterminateKeys;
     private handleToggleExpand;
     private handleClear;
     private renderNode;

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;